@fireweaveai/web-sdk 2.1.0

package/dist/adapter.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Backend adapter boundary for the browser.
+ *
+ * One shape differs from the server port, and it is the difference that makes
+ * a synchronous OpenFeature provider possible: the server port has
+ * `resolve(flagKey)` — one call per control point — while this port has
+ * `prefetch(context)`, which returns EVERY decision for a context in one round
+ * trip. Evaluation then becomes a synchronous map lookup in the runtime.
+ *
+ * The reason is not performance, it is the OpenFeature web contract:
+ * `resolve*Evaluation` must return `ResolutionDetails`, not a Promise. Anything
+ * the provider needs at read time must already be in memory.
+ *
+ * Adapters translate canonical requests to the Fireweave remote protocol; they
+ * never see OpenFeature types.
+ */
+import type { CanonicalContext, DecisionReason, Exposure, FlagValueType, JsonValue, Signal } from './types.js';
+import type { FireweaveError } from './errors.js';
+export interface AdapterResolution {
+    found: boolean;
+    enabled?: boolean;
+    value?: JsonValue;
+    variant?: string;
+    flagType?: FlagValueType;
+    reason?: DecisionReason;
+    reasonCode?: string;
+    version?: number;
+    payload?: JsonValue;
+    quotaLimited?: boolean;
+}
+/** Every decision the backend returned for one context, keyed by control point. */
+export type PrefetchResult = ReadonlyMap<string, AdapterResolution>;
+export interface PrefetchOptions {
+    /** Restrict the batch to these keys; omit to let the backend return all it knows. */
+    readonly flagKeys?: readonly string[];
+    readonly signal?: AbortSignal;
+}
+export type TargetKind = 'user' | 'device';
+export interface RegisterTargetOptions {
+    readonly kind?: TargetKind;
+    readonly properties?: Record<string, JsonValue>;
+    readonly environment?: string;
+    readonly signal?: AbortSignal;
+}
+export interface RegisterTargetResult {
+    /**
+     * `false` means the target was NOT registered — rules depending on its
+     * properties will not match until a later attempt succeeds. Sign-in paths
+     * normally ignore this; a careful caller logs it, because a silently
+     * unregistered target is exactly how targeting ends up matching nobody.
+     */
+    readonly ok: boolean;
+    readonly error?: FireweaveError;
+}
+export interface AdapterRuntimeFeatures {
+    remoteEvaluation?: boolean;
+    /** Always false in the browser, structurally — see ADR-0009. */
+    localEvaluation?: boolean;
+    localOnly?: boolean;
+    exposureEmission?: boolean;
+    sideEffectFreeReads?: boolean;
+    groupAnalytics?: boolean;
+}
+export interface WebBackendAdapter {
+    readonly name: 'fireweave' | 'inmemory' | 'other';
+    /** Bring the backend to a usable state. Reject with FireweaveError on failure. */
+    initialize(signal?: AbortSignal): Promise<void>;
+    /** Fetch every decision for a context. Throws FireweaveError on transport faults. */
+    prefetch(context: CanonicalContext, options?: PrefetchOptions): Promise<PrefetchResult>;
+    /** Register a user or device for durable targeting. Resolves rather than throws. */
+    registerTarget?(targetingKey: string, options?: RegisterTargetOptions): Promise<RegisterTargetResult>;
+    recordExposure?(exposure: Exposure): void;
+    recordSignal?(signal: Signal): void;
+    /**
+     * Deliver queued telemetry.
+     *
+     * `beacon: true` asks for an unload-safe transport (`sendBeacon` /
+     * `keepalive`) because the page may be seconds from gone. Delivery is
+     * best-effort by definition on that path — neither transport reports failure.
+     */
+    flush?(options?: {
+        beacon?: boolean;
+    }): Promise<void>;
+    shutdown(): Promise<void>;
+    features(): AdapterRuntimeFeatures;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC/G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE3C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;IAClD,kFAAkF;IAClF,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACxF,oFAAoF;IACpF,cAAc,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACtG,cAAc,CAAC,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1C,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;;;;;;OAMG;IACH,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,IAAI,sBAAsB,CAAC;CACpC"}

package/dist/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":""}

package/dist/adapters/inmemory.d.ts

@@ -0,0 +1,51 @@
+/**
+ * In-memory adapter — offline evaluation for tests and conformance fixtures.
+ *
+ * Declares control points up front and serves them from memory. Fault
+ * injection exists so the conformance suite can drive the error taxonomy
+ * without a network or a stub server.
+ */
+import { type FireweaveErrorKind } from '../errors.js';
+import type { AdapterResolution, AdapterRuntimeFeatures, PrefetchOptions, PrefetchResult, WebBackendAdapter } from '../adapter.js';
+import type { CanonicalContext, Exposure, FlagValueType, JsonValue, Signal } from '../types.js';
+export interface InMemoryFlagDefinition {
+    readonly type: FlagValueType;
+    readonly enabled: boolean;
+    readonly value: JsonValue;
+    readonly variant?: string;
+    readonly payload?: JsonValue;
+    /** Only resolve for this targeting key; otherwise the control point misses. */
+    readonly matchTargetingKey?: string;
+    readonly fireweaveReason?: AdapterResolution['reason'];
+}
+export interface InMemoryFault {
+    readonly kind: FireweaveErrorKind;
+    /** Throw on initialize rather than on prefetch. */
+    readonly onInitialize?: boolean;
+}
+export interface InMemoryWebAdapterOptions {
+    readonly flags?: Record<string, InMemoryFlagDefinition>;
+    readonly fault?: InMemoryFault;
+}
+export declare class InMemoryWebAdapter implements WebBackendAdapter {
+    readonly name: "inmemory";
+    private flags;
+    private fault;
+    private readonly exposures;
+    private readonly signals;
+    private closed;
+    constructor(options?: InMemoryWebAdapterOptions);
+    setFlags(flags: Record<string, InMemoryFlagDefinition>): void;
+    setFault(fault: InMemoryFault | undefined): void;
+    initialize(_signal?: AbortSignal): Promise<void>;
+    prefetch(context: CanonicalContext, options?: PrefetchOptions): Promise<PrefetchResult>;
+    recordExposure(exposure: Exposure): void;
+    getExposures(): readonly Exposure[];
+    recordSignal(signal: Signal): void;
+    getSignals(): readonly Signal[];
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    isClosed(): boolean;
+    features(): AdapterRuntimeFeatures;
+}
+//# sourceMappingURL=inmemory.d.ts.map

package/dist/adapters/inmemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inmemory.d.ts","sourceRoot":"","sources":["../../src/adapters/inmemory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEhG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,mDAAmD;IACnD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;CAChC;AAED,qBAAa,kBAAmB,YAAW,iBAAiB;IAC1D,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAEpC,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,yBAA8B;IAKnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,IAAI;IAI7D,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI;IAI1C,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IA0B7F,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIxC,YAAY,IAAI,SAAS,QAAQ,EAAE;IAInC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIlC,UAAU,IAAI,SAAS,MAAM,EAAE;IAIzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,QAAQ,IAAI,OAAO;IAInB,QAAQ,IAAI,sBAAsB;CAUnC"}

package/dist/adapters/inmemory.js

@@ -0,0 +1,91 @@
+/**
+ * In-memory adapter — offline evaluation for tests and conformance fixtures.
+ *
+ * Declares control points up front and serves them from memory. Fault
+ * injection exists so the conformance suite can drive the error taxonomy
+ * without a network or a stub server.
+ */
+import { FireweaveError } from '../errors.js';
+export class InMemoryWebAdapter {
+    name = 'inmemory';
+    flags;
+    fault;
+    exposures = [];
+    signals = [];
+    closed = false;
+    constructor(options = {}) {
+        this.flags = new Map(Object.entries(options.flags ?? {}));
+        this.fault = options.fault;
+    }
+    setFlags(flags) {
+        this.flags = new Map(Object.entries(flags));
+    }
+    setFault(fault) {
+        this.fault = fault;
+    }
+    async initialize(_signal) {
+        if (this.fault?.onInitialize === true)
+            throw new FireweaveError(this.fault.kind);
+    }
+    async prefetch(context, options) {
+        if (this.fault !== undefined && this.fault.onInitialize !== true) {
+            throw new FireweaveError(this.fault.kind);
+        }
+        const wanted = options?.flagKeys;
+        const out = new Map();
+        for (const [key, def] of this.flags) {
+            if (wanted !== undefined && wanted.length > 0 && !wanted.includes(key))
+                continue;
+            if (def.matchTargetingKey !== undefined && context.targetingKey !== def.matchTargetingKey) {
+                out.set(key, { found: false });
+                continue;
+            }
+            const resolution = {
+                found: true,
+                enabled: def.enabled,
+                value: def.value,
+                flagType: def.type,
+            };
+            if (def.variant !== undefined)
+                resolution.variant = def.variant;
+            if (def.payload !== undefined)
+                resolution.payload = def.payload;
+            if (def.fireweaveReason !== undefined)
+                resolution.reason = def.fireweaveReason;
+            out.set(key, resolution);
+        }
+        return out;
+    }
+    recordExposure(exposure) {
+        this.exposures.push(exposure);
+    }
+    getExposures() {
+        return this.exposures;
+    }
+    recordSignal(signal) {
+        this.signals.push(signal);
+    }
+    getSignals() {
+        return this.signals;
+    }
+    async flush() {
+        // no-op: telemetry stays queryable for tests
+    }
+    async shutdown() {
+        this.closed = true;
+    }
+    isClosed() {
+        return this.closed;
+    }
+    features() {
+        return {
+            remoteEvaluation: false,
+            localEvaluation: false,
+            localOnly: true,
+            exposureEmission: true,
+            sideEffectFreeReads: true,
+            groupAnalytics: false,
+        };
+    }
+}
+//# sourceMappingURL=inmemory.js.map

package/dist/adapters/inmemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inmemory.js","sourceRoot":"","sources":["../../src/adapters/inmemory.ts"],"names":[],"mappings":"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"}

package/dist/adapters/local.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Local development adapter for the browser — the DEV substrate of a
+ * scaffolded web harness, and the exact peer of the server SDK's
+ * `FireweaveLocalAdapter`.
+ *
+ * A key present in `devFlags` resolves with reason `STATIC`; every other key
+ * misses, which the runtime turns into the caller's own default. No network,
+ * no credentials, nothing to configure.
+ *
+ * Call-site defaults stay `false` under RAMP-1. Never write `flag(key, true)`
+ * to dogfood locally — that same `true` is the production fallback when a
+ * control point is absent from the provider, so it silently ships the ON
+ * branch. Use `devFlags`.
+ */
+import type { AdapterRuntimeFeatures, PrefetchOptions, PrefetchResult, WebBackendAdapter } from '../adapter.js';
+import type { CanonicalContext } from '../types.js';
+export interface FireweaveLocalWebAdapterOptions {
+    readonly devFlags?: Record<string, boolean>;
+}
+export declare class FireweaveLocalWebAdapter implements WebBackendAdapter {
+    /** Not `inmemory` — that name belongs to the fixture adapter. */
+    readonly name: "other";
+    private readonly devFlags;
+    private closed;
+    constructor(options?: FireweaveLocalWebAdapterOptions);
+    initialize(_signal?: AbortSignal): Promise<void>;
+    /**
+     * `enabled: true` alongside `reason: 'STATIC'` is deliberate: reporting
+     * `enabled: false` for an override of `false` would make the runtime label
+     * the decision `DISABLED`, which means "exists but switched off upstream" —
+     * not what a local override expresses.
+     */
+    prefetch(_context: CanonicalContext, _options?: PrefetchOptions): Promise<PrefetchResult>;
+    shutdown(): Promise<void>;
+    isClosed(): boolean;
+    features(): AdapterRuntimeFeatures;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/adapters/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/adapters/local.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAEV,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IACnD,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,+BAAoC;IAInD,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAezF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,QAAQ,IAAI,OAAO;IAInB,QAAQ,IAAI,sBAAsB;CAYnC"}

package/dist/adapters/local.js

@@ -0,0 +1,51 @@
+export class FireweaveLocalWebAdapter {
+    /** Not `inmemory` — that name belongs to the fixture adapter. */
+    name = 'other';
+    devFlags;
+    closed = false;
+    constructor(options = {}) {
+        this.devFlags = { ...(options.devFlags ?? {}) };
+    }
+    async initialize(_signal) {
+        // Nothing to connect to.
+    }
+    /**
+     * `enabled: true` alongside `reason: 'STATIC'` is deliberate: reporting
+     * `enabled: false` for an override of `false` would make the runtime label
+     * the decision `DISABLED`, which means "exists but switched off upstream" —
+     * not what a local override expresses.
+     */
+    async prefetch(_context, _options) {
+        const out = new Map();
+        for (const [key, value] of Object.entries(this.devFlags)) {
+            out.set(key, {
+                found: true,
+                enabled: true,
+                value,
+                variant: value ? 'on' : 'off',
+                reason: 'STATIC',
+                flagType: 'boolean',
+            });
+        }
+        return out;
+    }
+    async shutdown() {
+        this.closed = true;
+    }
+    isClosed() {
+        return this.closed;
+    }
+    features() {
+        return {
+            remoteEvaluation: false,
+            localEvaluation: true,
+            localOnly: true,
+            // No exposure sink exists locally; claiming otherwise would advertise
+            // emission that silently goes nowhere.
+            exposureEmission: false,
+            sideEffectFreeReads: true,
+            groupAnalytics: false,
+        };
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/adapters/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/adapters/local.ts"],"names":[],"mappings":"AA2BA,MAAM,OAAO,wBAAwB;IACnC,iEAAiE;IACxD,IAAI,GAAG,OAAgB,CAAC;IAEhB,QAAQ,CAA0B;IAC3C,MAAM,GAAG,KAAK,CAAC;IAEvB,YAAY,UAA2C,EAAE;QACvD,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAqB;QACpC,yBAAyB;IAC3B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,QAA0B,EAAE,QAA0B;QACnE,MAAM,GAAG,GAAG,IAAI,GAAG,EAA6B,CAAC;QACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE;gBACX,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,IAAI;gBACb,KAAK;gBACL,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;gBAC7B,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO;YACL,gBAAgB,EAAE,KAAK;YACvB,eAAe,EAAE,IAAI;YACrB,SAAS,EAAE,IAAI;YACf,sEAAsE;YACtE,uCAAuC;YACvC,gBAAgB,EAAE,KAAK;YACvB,mBAAmB,EAAE,IAAI;YACzB,cAAc,EAAE,KAAK;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/adapters/remote.d.ts

@@ -0,0 +1,45 @@
+import type { AdapterRuntimeFeatures, PrefetchOptions, PrefetchResult, RegisterTargetOptions, RegisterTargetResult, WebBackendAdapter } from '../adapter.js';
+import type { CanonicalContext, Exposure, Signal } from '../types.js';
+export type FireweaveFetchLike = typeof fetch;
+export interface FireweaveRemoteWebAdapterOptions {
+    /** fw-server base URL, e.g. `https://app-server.fireweave.ai`. */
+    readonly apiUrl: string;
+    /** Fireweave project key. Public by construction — must be scoped accordingly. */
+    readonly apiKey: string;
+    /** SSRF/misconfiguration allowlist override. `['*']` opts out. */
+    readonly allowedHosts?: readonly string[];
+    readonly requestTimeoutMs?: number;
+    /** Injected fetch (tests). Defaults to the global. */
+    readonly fetch?: FireweaveFetchLike;
+}
+export declare class FireweaveRemoteWebAdapter implements WebBackendAdapter {
+    readonly name: "fireweave";
+    private readonly apiUrl;
+    private readonly apiKey;
+    private readonly allowedHosts;
+    private readonly requestTimeoutMs;
+    private readonly fetchImpl;
+    private readonly pending;
+    private ready;
+    private closed;
+    constructor(options: FireweaveRemoteWebAdapterOptions);
+    initialize(_signal?: AbortSignal): Promise<void>;
+    prefetch(context: CanonicalContext, options?: PrefetchOptions): Promise<PrefetchResult>;
+    registerTarget(targetingKey: string, options?: RegisterTargetOptions): Promise<RegisterTargetResult>;
+    recordExposure(exposure: Exposure): void;
+    recordSignal(signal: Signal): void;
+    /**
+     * `beacon: true` is the unload path. It must not await anything the browser
+     * will cancel, so it uses `sendBeacon` when available and a `keepalive`
+     * fetch otherwise, and it never re-queues on failure — there is no later.
+     */
+    flush(options?: {
+        beacon?: boolean;
+    }): Promise<void>;
+    private sendBeaconOrKeepalive;
+    shutdown(): Promise<void>;
+    features(): AdapterRuntimeFeatures;
+    private toResolution;
+    private requestJson;
+}
+//# sourceMappingURL=remote.d.ts.map

package/dist/adapters/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/adapters/remote.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAEV,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAkB,QAAQ,EAAa,MAAM,EAAE,MAAM,aAAa,CAAC;AAQjG,MAAM,MAAM,kBAAkB,GAAG,OAAO,KAAK,CAAC;AAE9C,MAAM,WAAW,gCAAgC;IAC/C,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAuDD,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IAErC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;IAC7D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,gCAAgC;IAW/C,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAyCvF,cAAc,CAClB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAkChC,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAexC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAqBlC;;;;OAIG;IACG,KAAK,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9D,OAAO,CAAC,qBAAqB;IA0BvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B,QAAQ,IAAI,sBAAsB;IAYlC,OAAO,CAAC,YAAY;YAwBN,WAAW;CAmC1B"}