@fireweaveai/deploy-sdk
v0.2.2
Published
Boot-time deploy attestation + feature-flag runtime for FireWeave-instrumented applications. Embeddable (the `.` entry is zero runtime dependencies), with optional OpenFeature + OpenTelemetry integration behind subpath entries.
Keywords
Readme
@fireweaveai/deploy-sdk
Boot-time deploy attestation + feature-flag runtime for FireWeave-instrumented
applications. Embeddable (the . entry is zero runtime dependencies), with
optional OpenFeature + OpenTelemetry integration behind subpath entries.
Install
npm install @fireweaveai/deploy-sdk # latest stable → prod cloud default
npm install @fireweaveai/deploy-sdk@staging # staging channel → staging cloud defaultWhich cloud the SDK targets by default is a property of the published
version — the stable artifact defaults to the production fw-server, the
staging artifact to the staging fw-server. No runtime environment detection is
involved.
Entry points
| Import | Purpose |
| ----------------------------------- | -------------------------------------------------------------------------------------------------- |
| @fireweaveai/deploy-sdk | Zero-dep attestation core (initFwAttestation). |
| @fireweaveai/deploy-sdk/attest | Boot-beacon env wiring + fetch transport. |
| @fireweaveai/deploy-sdk/flags | OpenFeature + OTel feature-flag runtime (prod: Fireweave remote → fw-server /v1/flags/evaluate). |
| @fireweaveai/deploy-sdk/flags/web | Browser feature-flag facade (prod: Fireweave remote web provider). |
| @fireweaveai/deploy-sdk/eject | Eject codemod (AST) helpers. |
| @fireweaveai/deploy-sdk/profile | Capability / surface-support matrix. |
Production flag backend: makeFireweaveRemoteServerProvider / makeFireweaveRemoteWebProvider speak the ADR-0005 remote protocol (FW_API_URL + FW_PROJECT_API_KEY). Compatible with @fireweaveai/sdk FireweaveRemoteAdapter. Direct PostHog providers remain exported as an advanced escape hatch only.
Attest target resolution
The fw-server base URL the boot beacon POSTs to resolves by precedence (first hit wins):
- Explicit config —
resolveBootBeaconFromEnv({ …, attestUrl }). FW_ATTEST_URLenvironment variable.- The channel-baked
DEFAULT_ATTEST_URLof the installed artifact.
Attestation stays a no-op unless a project API key (FW_PROJECT_API_KEY) is
present, regardless of which URL resolves.
