@fireweaveai/web-sdk-cjs 0.0.0-reserve.0 → 0.0.0-stage

package/dist/domain/validation.js

@@ -1,358 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateControlPointKey = validateControlPointKey;
-exports.matchesExpectedType = matchesExpectedType;
-exports.validateDefaultValue = validateDefaultValue;
-exports.validateTargetingKey = validateTargetingKey;
-exports.validateContext = validateContext;
-exports.canonicalizeContext = canonicalizeContext;
-exports.validateInitOptions = validateInitOptions;
-/**
- * Fireweave web SDK validation — pure, total functions per
- * spec/control-points.md "Validation, before any I/O" and spec/modes.md
- * "Initialisation validation".
- *
- * Ported from sdks/node/src/domain/validation.ts (the reference
- * implementation) — same five validators, same `Validated<T>` discipline,
- * same malformed-key → ControlPointNotFound mapping. Reimplemented here rather than
- * shared so the browser package keeps zero cross-package dependency to
- * audit — the same reasoning ADR-0009 gives for duplicating types.ts/errors.ts
- * extends to this module.
- *
- * Every read-path validator here (`validateControlPointKey`,
- * `validateDefaultValue`, `validateContext`) returns `Validated<T>` instead
- * of throwing. `FireweaveWebRuntime.evaluateSync` runs them, in the fixed
- * order the spec names — key, default-vs-type, context, lifecycle — and
- * degrades to the caller's default on the first failure; it NEVER throws
- * (spec/control-points.md "Return discipline — never throw into a read
- * path"). `validateInitOptions` is the one exception (spec/modes.md
- * "Initialisation validation"): it still returns `Validated<T>` — mode.ts is
- * what converts a failed result into the throw spec/modes.md requires.
- *
- * Note: unlike node, web's `FireweaveError` has no custom-message support —
- * messages are FIXED per kind by design, because a browser error is visible
- * in a devtools console on a machine this package does not control
- * (errors.ts's own doc comment). So every branch below that would carry a
- * distinct node message instead just uses the taxonomy's fixed message for
- * its kind.
- */
-const errors_js_1 = require("./errors.js");
-const ok = (value) => ({ ok: true, value });
-const fail = (error) => ({ ok: false, error });
-// ---------------------------------------------------------------------------
-// Rule 1 — validateControlPointKey (spec/control-points.md "Validation,
-// before any I/O": "key — non-empty, ≤256 characters, no control characters")
-// ---------------------------------------------------------------------------
-/** C0 + C1 control characters (U+0000-U+001F, U+007F-U+009F). */
-const CONTROL_CHARACTERS = new RegExp('[' + String.fromCharCode(0x00) + '-' + String.fromCharCode(0x1f) +
-    String.fromCharCode(0x7f) + '-' + String.fromCharCode(0x9f) + ']');
-const MAX_CONTROL_POINT_KEY_LENGTH = 256;
-/**
- * key — non-empty, ≤256 characters, no control characters
- * (spec/control-points.md rule 1, the first check in the fixed order).
- *
- * No taxonomy kind names "malformed key" explicitly (the return-discipline
- * table's closest row is "key unknown to the backend" → ControlPointNotFound):
- * controller-ruled interim mapping (mirrors node's domain/validation.ts
- * verbatim) — the 15-kind taxonomy in errors.schema.json is frozen at
- * exactly 15 entries, `InvalidContext` is textually scoped to the evaluation
- * *context* (not the key), and the schema already maps another non-literal
- * case — quota-limited responses — onto `ControlPointNotFound` rather than adding a
- * kind for it. `ControlPointNotFound` is therefore the least-wrong existing kind,
- * not a literal fit. Other-language implementations copying node as the
- * reference SHOULD use the same mapping rather than each independently
- * guessing a different one.
- */
-function validateControlPointKey(key) {
-    if (typeof key !== 'string' || key.length === 0) {
-        return fail(new errors_js_1.FireweaveError('ControlPointNotFound'));
-    }
-    if (key.length > MAX_CONTROL_POINT_KEY_LENGTH) {
-        return fail(new errors_js_1.FireweaveError('ControlPointNotFound'));
-    }
-    if (CONTROL_CHARACTERS.test(key)) {
-        return fail(new errors_js_1.FireweaveError('ControlPointNotFound'));
-    }
-    return ok(key);
-}
-/**
- * Whether `value` matches the shape `expected` names. Shared by
- * {@link validateDefaultValue} (the caller's default, before any read) and
- * `FireweaveWebRuntime.evaluateSync`'s post-cache-lookup check (the backend's
- * resolved value, from the prefetched cache) — same predicate, two different
- * inputs.
- */
-function matchesExpectedType(value, expected) {
-    switch (expected) {
-        case 'boolean':
-            return typeof value === 'boolean';
-        case 'string':
-            return typeof value === 'string';
-        case 'number':
-            return typeof value === 'number';
-        case 'object':
-            return typeof value === 'object' && value !== null;
-    }
-}
-/**
- * default vs type — e.g. `getBooleanValue` with a non-boolean default is
- * TypeMismatch (spec/control-points.md rule 2, checked before any read).
- */
-function validateDefaultValue(expectedType, defaultValue) {
-    if (!matchesExpectedType(defaultValue, expectedType)) {
-        return fail(new errors_js_1.FireweaveError('TypeMismatch'));
-    }
-    return ok(defaultValue);
-}
-// ---------------------------------------------------------------------------
-// validateTargetingKey (spec/control-points.md "Context": targetingKey)
-// ---------------------------------------------------------------------------
-/**
- * targetingKey: "An SDK MUST NOT invent one: a missing targeting key is
- * InvalidContext where the evaluation needs it, never a generated anonymous
- * id" (spec/control-points.md "Context"). `required` is call-site policy —
- * the remote adapter always requires one for `prefetch`/`registerTarget`; the
- * generic context pipeline ({@link validateContext}) only does when
- * `ContextPolicy.requireTargetingKey` opts in (unset by default here — web's
- * targetingKey requirement is enforced at the remote adapter, not the
- * general-purpose context validator every read runs).
- */
-function validateTargetingKey(targetingKey, required) {
-    if (required && (targetingKey === undefined || targetingKey === '')) {
-        return fail(new errors_js_1.FireweaveError('InvalidContext', { openFeatureErrorCode: 'TARGETING_KEY_MISSING' }));
-    }
-    return ok(targetingKey);
-}
-// ---------------------------------------------------------------------------
-// Rule 3 — validateContext (spec/control-points.md rule 3: "context — depth,
-// key count, value size, reserved keys (evaluation-context.schema.json)")
-// ---------------------------------------------------------------------------
-/**
- * UTF-8 byte length. `TextEncoder` rather than `Buffer.byteLength` — `Buffer`
- * does not exist in a browser at all (browser-portability.test.ts pins this).
- */
-const utf8Encoder = new TextEncoder();
-const byteLength = (s) => utf8Encoder.encode(s).length;
-/**
- * Sentinel returned (never thrown) when `deepCopyJson` walks back into an
- * object already on the current recursion path — an actual reference cycle,
- * not merely the same object shared by two sibling branches (which is legal
- * and handled by backtracking `seen.delete(...)` below). Untyped caller
- * input is `unknown`, so a circular attribute value is reachable from a
- * caller today; without this, recursion never terminates and crashes with
- * `RangeError: Maximum call stack size exceeded` — exactly the kind of throw
- * a "before any I/O" validator must not allow (spec/control-points.md
- * "Return discipline — never throw into a read path"). Module-local: never
- * returned across this file's public surface, only used to fail
- * `validateContext` closed as `InvalidContext`.
- */
-const CYCLIC = Symbol('fireweave.cyclicJson');
-function deepCopyJson(value, seen = new WeakSet()) {
-    if (value === null || typeof value === 'string' || typeof value === 'boolean' || typeof value === 'number') {
-        return value;
-    }
-    if (Array.isArray(value)) {
-        if (seen.has(value))
-            return CYCLIC;
-        seen.add(value);
-        const out = [];
-        for (const v of value) {
-            const copied = deepCopyJson(v, seen);
-            if (copied === CYCLIC)
-                return CYCLIC;
-            out.push(copied);
-        }
-        seen.delete(value);
-        return out;
-    }
-    if (typeof value === 'object') {
-        if (seen.has(value))
-            return CYCLIC;
-        seen.add(value);
-        const out = {};
-        for (const [k, v] of Object.entries(value)) {
-            if (v !== undefined) {
-                const copied = deepCopyJson(v, seen);
-                if (copied === CYCLIC)
-                    return CYCLIC;
-                out[k] = copied;
-            }
-        }
-        seen.delete(value);
-        return out;
-    }
-    return null;
-}
-/**
- * Cycle-safe defensively: `nestingDepth` only ever runs on `deepCopyJson`'s
- * own output today, which is guaranteed acyclic by construction (it builds
- * fresh containers, never back-references). Guarded anyway per the same
- * "must be genuinely total" reasoning as `deepCopyJson`. A detected cycle
- * returns `Infinity`, which always exceeds `limits.maxNestingDepth` and fails
- * closed through the existing bound check below — no new failure path.
- */
-function nestingDepth(value, seen = new WeakSet()) {
-    if (value === null || typeof value !== 'object')
-        return 0;
-    if (seen.has(value))
-        return Infinity;
-    seen.add(value);
-    let max = 0;
-    const children = Array.isArray(value) ? value : Object.values(value);
-    for (const child of children) {
-        const d = nestingDepth(child, seen);
-        if (d > max)
-            max = d;
-    }
-    seen.delete(value);
-    return max + 1;
-}
-const invalidContext = () => new errors_js_1.FireweaveError('InvalidContext');
-/** groups/groupProperties carriers: canonical fireweave.* spelling first, then the plain alias. */
-function extractSpecialKey(attributes, canonicalKey, aliasKey) {
-    if (canonicalKey in attributes)
-        return attributes[canonicalKey];
-    if (aliasKey in attributes)
-        return attributes[aliasKey];
-    return undefined;
-}
-/**
- * context — depth, key count, value size, reserved keys
- * (evaluation-context.schema.json) (spec/control-points.md rule 3). Also
- * enforces `policy.requireTargetingKey` via {@link validateTargetingKey}, and
- * — on success — extracts `groups`/`groupProperties` the same way the former
- * `canonicalizeContext` did.
- *
- * `groups`/`groupProperties` (and their `fireweave.*` aliases) are pulled out
- * BEFORE the attribute-count/size limit checks run, matching the pre-existing
- * behaviour this module replaces: they are not ordinary attributes and were
- * never counted against those limits.
- *
- * `merged` is the already-merged (global → invocation) raw input; merging
- * itself (`mergeContexts`) lives in context.ts and carries no validation
- * concerns of its own.
- */
-function validateContext(merged, policy) {
-    const { limits } = policy;
-    const rawAttributes = { ...merged.attributes };
-    const rawGroups = extractSpecialKey(rawAttributes, 'fireweave.groups', 'groups');
-    const rawGroupProperties = extractSpecialKey(rawAttributes, 'fireweave.groupProperties', 'groupProperties');
-    delete rawAttributes['fireweave.groups'];
-    delete rawAttributes['groups'];
-    delete rawAttributes['fireweave.groupProperties'];
-    delete rawAttributes['groupProperties'];
-    const copied = deepCopyJson(rawAttributes);
-    if (copied === CYCLIC) {
-        return fail(invalidContext());
-    }
-    const attributes = copied;
-    const keys = Object.keys(attributes);
-    if (keys.length > limits.maxAttributeCount) {
-        return fail(invalidContext());
-    }
-    for (const key of keys) {
-        if (byteLength(key) > limits.maxKeyBytes) {
-            return fail(invalidContext());
-        }
-    }
-    for (const key of keys) {
-        const value = attributes[key];
-        if (byteLength(JSON.stringify(value ?? null)) > limits.maxValueBytes) {
-            return fail(invalidContext());
-        }
-    }
-    for (const key of keys) {
-        const value = attributes[key];
-        if (value !== undefined && nestingDepth(value) > limits.maxNestingDepth) {
-            return fail(invalidContext());
-        }
-    }
-    const serialized = JSON.stringify({ targetingKey: merged.targetingKey, attributes });
-    if (byteLength(serialized) > limits.maxSerializedBytes) {
-        return fail(invalidContext());
-    }
-    for (const key of keys) {
-        if (policy.reservedAttributeKeys.includes(key)) {
-            return fail(invalidContext());
-        }
-    }
-    const targetingKeyResult = validateTargetingKey(merged.targetingKey, policy.requireTargetingKey);
-    if (!targetingKeyResult.ok)
-        return targetingKeyResult;
-    let groups;
-    if (rawGroups !== undefined) {
-        const g = deepCopyJson(rawGroups);
-        if (g !== CYCLIC && g !== null && typeof g === 'object' && !Array.isArray(g)) {
-            const entries = Object.entries(g);
-            if (entries.every(([, v]) => typeof v === 'string')) {
-                groups = Object.fromEntries(entries);
-            }
-        }
-    }
-    let groupProperties;
-    if (rawGroupProperties !== undefined) {
-        const gp = deepCopyJson(rawGroupProperties);
-        if (gp !== CYCLIC && gp !== null && typeof gp === 'object' && !Array.isArray(gp)) {
-            groupProperties = gp;
-        }
-    }
-    const canonical = {
-        attributes,
-        ...(merged.targetingKey !== undefined ? { targetingKey: merged.targetingKey } : {}),
-        ...(groups !== undefined ? { groups } : {}),
-        ...(groupProperties !== undefined ? { groupProperties } : {}),
-    };
-    return ok(canonical);
-}
-/**
- * Throwing wrapper around {@link validateContext}, kept for callers that
- * genuinely want a throw (`FireweaveWebRuntime.refresh`, which is already
- * inside its own try/catch feeding lifecycle state — see runtime.ts). Read
- * paths do not use this — they call {@link validateContext} directly so a
- * failure degrades instead of throwing.
- */
-function canonicalizeContext(merged, policy) {
-    const result = validateContext(merged, policy);
-    if (!result.ok)
-        throw result.error;
-    return result.value;
-}
-// ---------------------------------------------------------------------------
-// validateInitOptions (spec/modes.md "Initialisation validation")
-// ---------------------------------------------------------------------------
-/** "missing" and "blank" collapse to one check: not a non-empty string. */
-const isBlank = (value) => typeof value !== 'string' || value.trim().length === 0;
-const configError = () => new errors_js_1.FireweaveError('Configuration');
-/**
- * Initialisation-validation table (spec/modes.md), rows 1, 2 and 4:
- *  - `mode` absent or unrecognised
- *  - `mode: 'remote'` with `apiKey` or `apiUrl` missing/blank
- *  - `mode: 'local'` with credentials supplied (a config half-migrated from
- *    remote to local reads as neither, silently — reject it instead)
- *
- * Row 3 ("apiUrl fails the host allowlist") is intentionally NOT checked
- * here — mode.ts validates it directly via `assertHostAllowed` before
- * calling into the (deliberately non-throwing) runtime; see mode.ts's module
- * doc comment for why web cannot rely on the runtime the way node does.
- */
-function validateInitOptions(options) {
-    const mode = options?.mode;
-    if (mode !== 'local' && mode !== 'remote') {
-        return fail(configError());
-    }
-    // Runtime-only guard: a config object half-migrated from remote to local
-    // can carry apiKey/apiUrl even though the local-mode type declares
-    // neither — TypeScript's excess-property check only fires on a fresh
-    // object literal, not on a variable assembled elsewhere and passed in.
-    const credentials = options;
-    if (mode === 'remote') {
-        if (isBlank(credentials.apiKey) || isBlank(credentials.apiUrl)) {
-            return fail(configError());
-        }
-        return ok(options);
-    }
-    if (!isBlank(credentials.apiKey) || !isBlank(credentials.apiUrl)) {
-        return fail(configError());
-    }
-    return ok(options);
-}

package/dist/index.d.ts

@@ -1,50 +0,0 @@
-/**
- * @fireweaveai/web-sdk — Fireweave control points for the browser (ADR-0009).
- *
- * Remote-only and secret-free by construction: it never evaluates locally, has
- * no vendor SDK dependency, reads no environment, and rejects vendor/secret key
- * shapes at the door. Credentials are passed in explicitly by the embedding app.
- *
- * ```ts
- * import { initFireweave } from '@fireweaveai/web-sdk';
- *
- * const fw = await initFireweave({
- *   mode: 'remote',
- *   apiKey,
- *   apiUrl,
- *   context: { targetingKey: 'anonymous' },
- * });
- *
- * // Reads are SYNCHRONOUS — no await, safe inside render.
- * const on = fw.controlPoints.getBooleanValue('new-checkout', false);
- * ```
- *
- * `src/` is layered domain/ · application/ · infrastructure/
- * (test/unit/architecture-layers.test.ts guards the boundary): `domain/` is
- * pure data + validation with no outward imports; `application/` wires
- * domain types into the runtime/client surface, with `mode.ts` as the sole
- * composition root allowed to reach into `infrastructure/`; `infrastructure/`
- * holds the concrete adapters and the host allowlist.
- */
-export { FireweaveError, ERROR_TAXONOMY, isFireweaveError } from './domain/errors.js';
-export type { FireweaveErrorKind, FireweaveErrorOptions, OpenFeatureErrorCode, ErrorKindSpec } from './domain/errors.js';
-export type { JsonValue, FlagValueType, Decision, DecisionReason, CanonicalContext, LifecycleState, Signal, SignalKind, Exposure, ReleaseContext, ReleaseState, Capabilities, } from './domain/types.js';
-export { DEFAULT_CONTEXT_LIMITS, DEFAULT_RESERVED_ATTRIBUTE_KEYS, mergeContexts } from './domain/context.js';
-export type { ContextInput, ContextLimits, ContextPolicy } from './domain/context.js';
-export { canonicalizeContext, matchesExpectedType, validateContext, validateControlPointKey, validateDefaultValue, validateTargetingKey, validateInitOptions, } from './domain/validation.js';
-export type { Validated } from './domain/validation.js';
-export type { TargetKind } from './domain/target.js';
-export { DEFAULT_ALLOWED_HOSTS, assertHostAllowed, assertNotSecretKey, isLoopbackHostname } from './infrastructure/hosts.js';
-export type { WebBackendAdapter, AdapterResolution, AdapterRuntimeFeatures, PrefetchOptions, PrefetchResult, RegisterTargetOptions, RegisterTargetResult, } from './application/ports.js';
-export { FireweaveRemoteWebAdapter } from './infrastructure/adapters/remote.js';
-export type { FireweaveRemoteWebAdapterOptions, FireweaveFetchLike } from './infrastructure/adapters/remote.js';
-export { InMemoryWebAdapter } from './infrastructure/adapters/inmemory.js';
-export type { InMemoryWebAdapterOptions, InMemoryFlagDefinition, InMemoryFault } from './infrastructure/adapters/inmemory.js';
-export { FireweaveLocalWebAdapter } from './infrastructure/adapters/local.js';
-export type { FireweaveLocalWebAdapterOptions, LocalRegisteredTarget } from './infrastructure/adapters/local.js';
-export { FireweaveWebRuntime, DEFAULT_FLAGS_READY_TIMEOUT_MS } from './application/runtime.js';
-export type { FireweaveWebRuntimeConfig, ExpectedFlagType } from './application/runtime.js';
-export { FireweaveWebClient, WebControlPointsApi } from './application/client.js';
-export type { FireweaveWebClientOptions, ExtensionResult, EvaluateOptions } from './application/client.js';
-export { initFireweave } from './application/mode.js';
-export type { InitFireweaveOptions, InitFireweaveLocalOptions, InitFireweaveRemoteOptions } from './application/mode.js';

package/dist/index.js

@@ -1,66 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.initFireweave = exports.WebControlPointsApi = exports.FireweaveWebClient = exports.DEFAULT_FLAGS_READY_TIMEOUT_MS = exports.FireweaveWebRuntime = exports.FireweaveLocalWebAdapter = exports.InMemoryWebAdapter = exports.FireweaveRemoteWebAdapter = exports.isLoopbackHostname = exports.assertNotSecretKey = exports.assertHostAllowed = exports.DEFAULT_ALLOWED_HOSTS = exports.validateInitOptions = exports.validateTargetingKey = exports.validateDefaultValue = exports.validateControlPointKey = exports.validateContext = exports.matchesExpectedType = exports.canonicalizeContext = exports.mergeContexts = exports.DEFAULT_RESERVED_ATTRIBUTE_KEYS = exports.DEFAULT_CONTEXT_LIMITS = exports.isFireweaveError = exports.ERROR_TAXONOMY = exports.FireweaveError = void 0;
-/**
- * @fireweaveai/web-sdk — Fireweave control points for the browser (ADR-0009).
- *
- * Remote-only and secret-free by construction: it never evaluates locally, has
- * no vendor SDK dependency, reads no environment, and rejects vendor/secret key
- * shapes at the door. Credentials are passed in explicitly by the embedding app.
- *
- * ```ts
- * import { initFireweave } from '@fireweaveai/web-sdk';
- *
- * const fw = await initFireweave({
- *   mode: 'remote',
- *   apiKey,
- *   apiUrl,
- *   context: { targetingKey: 'anonymous' },
- * });
- *
- * // Reads are SYNCHRONOUS — no await, safe inside render.
- * const on = fw.controlPoints.getBooleanValue('new-checkout', false);
- * ```
- *
- * `src/` is layered domain/ · application/ · infrastructure/
- * (test/unit/architecture-layers.test.ts guards the boundary): `domain/` is
- * pure data + validation with no outward imports; `application/` wires
- * domain types into the runtime/client surface, with `mode.ts` as the sole
- * composition root allowed to reach into `infrastructure/`; `infrastructure/`
- * holds the concrete adapters and the host allowlist.
- */
-var errors_js_1 = require("./domain/errors.js");
-Object.defineProperty(exports, "FireweaveError", { enumerable: true, get: function () { return errors_js_1.FireweaveError; } });
-Object.defineProperty(exports, "ERROR_TAXONOMY", { enumerable: true, get: function () { return errors_js_1.ERROR_TAXONOMY; } });
-Object.defineProperty(exports, "isFireweaveError", { enumerable: true, get: function () { return errors_js_1.isFireweaveError; } });
-var context_js_1 = require("./domain/context.js");
-Object.defineProperty(exports, "DEFAULT_CONTEXT_LIMITS", { enumerable: true, get: function () { return context_js_1.DEFAULT_CONTEXT_LIMITS; } });
-Object.defineProperty(exports, "DEFAULT_RESERVED_ATTRIBUTE_KEYS", { enumerable: true, get: function () { return context_js_1.DEFAULT_RESERVED_ATTRIBUTE_KEYS; } });
-Object.defineProperty(exports, "mergeContexts", { enumerable: true, get: function () { return context_js_1.mergeContexts; } });
-var validation_js_1 = require("./domain/validation.js");
-Object.defineProperty(exports, "canonicalizeContext", { enumerable: true, get: function () { return validation_js_1.canonicalizeContext; } });
-Object.defineProperty(exports, "matchesExpectedType", { enumerable: true, get: function () { return validation_js_1.matchesExpectedType; } });
-Object.defineProperty(exports, "validateContext", { enumerable: true, get: function () { return validation_js_1.validateContext; } });
-Object.defineProperty(exports, "validateControlPointKey", { enumerable: true, get: function () { return validation_js_1.validateControlPointKey; } });
-Object.defineProperty(exports, "validateDefaultValue", { enumerable: true, get: function () { return validation_js_1.validateDefaultValue; } });
-Object.defineProperty(exports, "validateTargetingKey", { enumerable: true, get: function () { return validation_js_1.validateTargetingKey; } });
-Object.defineProperty(exports, "validateInitOptions", { enumerable: true, get: function () { return validation_js_1.validateInitOptions; } });
-var hosts_js_1 = require("./infrastructure/hosts.js");
-Object.defineProperty(exports, "DEFAULT_ALLOWED_HOSTS", { enumerable: true, get: function () { return hosts_js_1.DEFAULT_ALLOWED_HOSTS; } });
-Object.defineProperty(exports, "assertHostAllowed", { enumerable: true, get: function () { return hosts_js_1.assertHostAllowed; } });
-Object.defineProperty(exports, "assertNotSecretKey", { enumerable: true, get: function () { return hosts_js_1.assertNotSecretKey; } });
-Object.defineProperty(exports, "isLoopbackHostname", { enumerable: true, get: function () { return hosts_js_1.isLoopbackHostname; } });
-var remote_js_1 = require("./infrastructure/adapters/remote.js");
-Object.defineProperty(exports, "FireweaveRemoteWebAdapter", { enumerable: true, get: function () { return remote_js_1.FireweaveRemoteWebAdapter; } });
-var inmemory_js_1 = require("./infrastructure/adapters/inmemory.js");
-Object.defineProperty(exports, "InMemoryWebAdapter", { enumerable: true, get: function () { return inmemory_js_1.InMemoryWebAdapter; } });
-var local_js_1 = require("./infrastructure/adapters/local.js");
-Object.defineProperty(exports, "FireweaveLocalWebAdapter", { enumerable: true, get: function () { return local_js_1.FireweaveLocalWebAdapter; } });
-var runtime_js_1 = require("./application/runtime.js");
-Object.defineProperty(exports, "FireweaveWebRuntime", { enumerable: true, get: function () { return runtime_js_1.FireweaveWebRuntime; } });
-Object.defineProperty(exports, "DEFAULT_FLAGS_READY_TIMEOUT_MS", { enumerable: true, get: function () { return runtime_js_1.DEFAULT_FLAGS_READY_TIMEOUT_MS; } });
-var client_js_1 = require("./application/client.js");
-Object.defineProperty(exports, "FireweaveWebClient", { enumerable: true, get: function () { return client_js_1.FireweaveWebClient; } });
-Object.defineProperty(exports, "WebControlPointsApi", { enumerable: true, get: function () { return client_js_1.WebControlPointsApi; } });
-var mode_js_1 = require("./application/mode.js");
-Object.defineProperty(exports, "initFireweave", { enumerable: true, get: function () { return mode_js_1.initFireweave; } });

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

@@ -1,50 +0,0 @@
-/**
- * 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 '../../domain/errors.js';
-import type { AdapterResolution, AdapterRuntimeFeatures, PrefetchOptions, PrefetchResult, WebBackendAdapter } from '../../application/ports.js';
-import type { CanonicalContext, Exposure, FlagValueType, JsonValue, Signal } from '../../domain/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;
-}

package/dist/infrastructure/adapters/inmemory.js

@@ -1,94 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InMemoryWebAdapter = void 0;
-/**
- * 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.
- */
-const errors_js_1 = require("../../domain/errors.js");
-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 errors_js_1.FireweaveError(this.fault.kind);
-    }
-    async prefetch(context, options) {
-        if (this.fault !== undefined && this.fault.onInitialize !== true) {
-            throw new errors_js_1.FireweaveError(this.fault.kind);
-        }
-        const wanted = options?.controlPointKeys;
-        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,
-        };
-    }
-}
-exports.InMemoryWebAdapter = InMemoryWebAdapter;