westyx/nexus, newest first. The Laravel service provider and the OpenFeature provider ship inside the package and share its version. Where a release broke something, its Migrating section shows the change to make. The repository’s CHANGELOG.md carries the same releases in full detail.
v0.19.1 - 2026-11-19
- OpenFeature
423 service_lockedhold: uses a timed suppression window (default 5 minutes) matchingenvironment_disabled, soevaluateAbrecovers automatically once the lockdown is lifted. - Frontend service-kind guard: adds
NexusServiceKindMismatchExceptionand enforcesservice_kind === 'frontend'in secret operations.
v0.19.0 (2026-11-19)
- HTTP 423
service_locked: addsNexusServiceLockedException;connectStream()exits immediately on423and background sync retries halt until an explicitsync()succeeds. - OpenFeature provider: suppresses repeated
evaluateAbrequests while the service is locked down, serving the cached snapshot asSTALE.
v0.18.0 - 2026-11-12
- A switched-off environment is reported by name.
403 {"error":"environment_disabled"}throwsNexusEnvironmentDisabledExceptionon every request, the stream and the token exchange. The cached snapshot keeps serving; the background refresh, the polling fallback and the stream wait five minutes between attempts, one warning is logged, and the first successful sync clears it. The OpenFeature provider serves the snapshot asSTALEmeanwhile. - Every API error carries its status and code. A status no narrower exception describes throws
NexusApiExceptionwith$operation,$status(alsogetCode()) and$errorCode. The message never carries the response body. - The startup summary.
nexus: client readynames the configs, secrets and flags the first sync delivered - never a value. A client with no logger writes it to stderr whenWESTYX_NEXUS_LOG_STARTUP=1. syncErrors()lists the resources the server did not deliver, each logged once as a warning;logSyncErrors: falsekeeps the list without the log lines.- A WIF refresh that fails while the session is still valid keeps the session and logs a warning; an
auth_expiringrefresh failure no longer ends the stream connection. - The stream’s error budget restarts after a connection that held for 30 seconds, however it ended; a connection that ends sooner counts as an error, so a flapping endpoint backs off and falls back to polling.
var_export()of a WIF client carries no session token.psr/http-factoryis required at^1.1, the first release PHP 8.4 and later load without deprecation notices.
Migrating to v0.18.0
- Code that matched the message of an unexpected status (
nexus: setSecret unexpected status 500) readsNexusApiException::$statusinstead.NexusApiExceptionextendsNexusException, so acatch (NexusException)is unaffected. - A refused token exchange other than
401throws the same exception a request would (NexusApiException,NexusNotFoundException, …) instead of a plainNexusException. - A 403
environment_disabledfromevaluateAb()isNexusEnvironmentDisabledException, notNexusAbAddonNotAvailableException. - Secret key names now appear in log output; secret values never do. A log pipeline that treated a key name as sensitive filters
nexus: client readyandnexus: the server did not deliver a resource.
v0.17.0 - 2026-09-30
- The endpoint can come from the environment. Leave
baseUrlempty andNexusConfigreadsWESTYX_SERVICE_ENDPOINT-westyx dev runsets it for the script’s service, so a locally started application needs neither an endpoint nor a key in its code. AbaseUrlyou pass always wins, and an error about the variable’s value names the variable. See Configuration. - Laravel works keyless. With no
NEXUS_API_KEYandNEXUS_WIF_ENABLEDunset, the provider uses WIF, andNEXUS_BASE_URLfalls back to the same variable - sowestyx dev run php artisan serveneeds no Nexus settings at all. See Laravel.
Migrating to v0.17.0
- A
config/nexus.phppublished earlier carries(bool) env('NEXUS_WIF_ENABLED', false)and keeps WIF off unless it is set; change that line toenv('NEXUS_WIF_ENABLED')to get the keyless default.
v0.16.0 - 2026-08-29
NexusProviderreports its own name (Nexus) onopen-feature/sdk >=2.1, the new floor.aws_iam’s signed request includesContent-Typein its signed headers onaws/aws-sdk-php >=3.386, the new floor.- Every declared dependency floor builds and passes on PHP 8.5, verified by a permanent CI leg.
v0.15.0 - 2026-08-29
var_export()prints neither the API key nor a cached secret, on the config, the cache or a live client: all three are held outside the object’s property table (aWeakMapkeyed by instance).
v0.14.0 - 2026-08-23
aws_iamworks on a non-default port. The signedX-Nexus-Server-IDcarries the port whenever it is not the scheme’s default, matching the host the backend validates against.- A failing logger cannot break an SDK call. A PSR-3 logger that throws - a Monolog handler on a full disk is the usual case - is contained. See Custom logging.
- Leaner package, and an
MITLICENSEfile. The published package carriessrc/and the Laravelconfig/only. - Raised baselines - PHPStan at level 10, PHPUnit 12, code coverage and a SonarQube job.
v0.13.0 - 2026-08-10
- The
developerprovider. A sessionwestyx dev setupalready issued is sent as the Bearer directly - no token exchange - so a laptop can authenticate to a WIF-enforced service. Probed last, behind every cloud provider. WifProvideris a backed enum, so an invalid provider is aTypeErrorat construction rather than a failure on the first request.- The credential extension point is an interface,
WifCredentialSource, which can express a credential that is not a bearer token and survivesphp artisan config:cache. - The Azure IMDS path, for an Azure VM or App Service workload with no projected token file. Needs
audience: 'api://<client-id>'. - A dumped client shows a redacted view -
var_dump,print_r,json_encodeandserializecarry no credential, and a secret parameter never reaches an exception trace.
Migrating to v0.13.0
A provider string arriving from configuration keeps working:
WifConfig::fromArray() and WifProvider::fromWire() accept it, and the Laravel service provider uses the former, so NEXUS_WIF_PROVIDER=gcp needs no change.
v0.12.0 - 2026-08-03
- Per-user targeting through OpenFeature. A boolean evaluation whose
EvaluationContextcarries atargetingKeyis evaluated for that identity through the AB Testing add-on and reportsTARGETING_MATCH. One request covers every flag in the snapshot and the results are memoised per identity. See OpenFeature. - The OpenFeature provider ships inside
westyx/nexusasWestyxNexus\OpenFeature\NexusProvider, withopen-feature/sdkas a Composersuggest. The earlierwestyx/nexus-openfeaturesub-package had no installable release, because a Composer package must sit at the root of its own repository. findFlag()returns?bool, so a flag that does not exist is distinguishable from one that is off.NexusAbAddonNotAvailableException- the 403 fromevaluateAb()has its own type.- Attribute values are strings, and are checked before the request goes out.
- Numbers resolve as numbers - the OpenFeature integer and float resolutions report
TYPE_MISMATCHinstead of coercing. - Available on Packagist -
composer require westyx/nexusworks with no repository configuration.
v0.11.0 - 2026-07-30
- Bring your own HTTP client. The SDK is built on PSR-18 and PSR-17, so it uses whatever HTTP stack your project already has; Guzzle is not required. See HTTP client.
- Laravel service provider -
composer require westyx/nexusin a Laravel app is the whole setup. See Laravel. - PSR-3 logging through the logger you pass, with values in the
$contextarray. - File-type secrets live in a private directory created
0700, with the files inside created0600andO_EXCL. - Stream deadlines - a connection deadline (10 s) and a liveness deadline (60 s) that resets on every byte.
- The cache serves what it has - a
304 Not Modifiedand a brief network failure both keep serving the last snapshot. - One status-code contract across every endpoint, with
Retry-Afterand quarantine details preserved.
v0.10.0 - 2026-07-05
- Version alignment across the Westyx Nexus SDK suite.
v0.9.0 - 2026-07-03
- The
aws_iamWIF provider for ECS/Fargate, Lambda and plain EC2: the SDK SigV4-signs an STSGetCallerIdentityrequest (never sent to AWS) and posts it to the token exchange. Requiresaws/aws-sdk-php. See Workload identity. - Security hardening - the base URL must be
https://(loopback excepted); an expired WIF session refreshes on every request path and a WIF-only client fails closed; metadata and token-exchange reads are size-bounded; auto-detection checks that the token files exist; a non-positiveexpires_inis clamped.
v0.8.2 - 2026-07-01
- The
gcpprovider fetches a Google-signed OIDC identity token from the GCE metadata server, and auto-detection follows the actual token sources.
v0.8.1 - 2026-06-17
- Documentation: the example service base URL is
https://<slug>.westyx.dev.
v0.8.0 - 2026-06-16
- An OpenFeature provider, wrapping an existing
NexusClient.
v0.6.0 - 2026-06-11
- The stream reconnects after the polling fallback, after the cooldown
sseReconnectCooldownsets.
v0.5.1 - 2026-06-03
- Requires PHP 8.3+. PHP 8.1 and 8.2 are end-of-life.
- Exception messages carry the status code, not the response body, and a file-type secret’s path is hashed.
- The stream waits out a quarantine without counting it as a transport error.
v0.5.0 - 2026-06-01
- API paths use
/v1/, and the base URL ishttps://<slug>.westyx.dev. - Quarantine handling - a
429quarantine response pauses syncing until it expires;NexusQuarantinedExceptioncarries$reasonand$expiresAt. - The write API -
setSecret,deleteSecret,deleteSecretVersionfor a secret key. - A public key receives every config and flag.
