@fireweaveai/web-sdk 2.1.0 → 2.1.1-staging.1

package/dist/domain/validation.js

@@ -0,0 +1,350 @@
+/**
+ * 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 → FlagNotFound 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.
+ */
+import { FireweaveError } from './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" → FlagNotFound):
+ * 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 `FlagNotFound` rather than adding a
+ * kind for it. `FlagNotFound` 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.
+ */
+export function validateControlPointKey(key) {
+    if (typeof key !== 'string' || key.length === 0) {
+        return fail(new FireweaveError('FlagNotFound'));
+    }
+    if (key.length > MAX_CONTROL_POINT_KEY_LENGTH) {
+        return fail(new FireweaveError('FlagNotFound'));
+    }
+    if (CONTROL_CHARACTERS.test(key)) {
+        return fail(new FireweaveError('FlagNotFound'));
+    }
+    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.
+ */
+export 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).
+ */
+export function validateDefaultValue(expectedType, defaultValue) {
+    if (!matchesExpectedType(defaultValue, expectedType)) {
+        return fail(new 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).
+ */
+export function validateTargetingKey(targetingKey, required) {
+    if (required && (targetingKey === undefined || targetingKey === '')) {
+        return fail(new 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 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.
+ */
+export 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.
+ */
+export 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 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.
+ */
+export 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);
+}
+//# sourceMappingURL=validation.js.map

package/dist/domain/validation.js.map

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

package/dist/index.d.ts

@@ -6,40 +6,46 @@
  * shapes at the door. Credentials are passed in explicitly by the embedding app.
  *
  * ```ts
- * import { OpenFeature } from '@openfeature/web-sdk';
- * import {
- *   FireweaveRemoteWebAdapter,
- *   FireweaveWebProvider,
- *   FireweaveWebRuntime,
- * } from '@fireweaveai/web-sdk';
+ * import { initFireweave } from '@fireweaveai/web-sdk';
  *
- * const runtime = new FireweaveWebRuntime(
- *   new FireweaveRemoteWebAdapter({ apiUrl, apiKey }),
- *   { globalContext: { targetingKey: 'anonymous' } }
- * );
- * await OpenFeature.setProviderAndWait(new FireweaveWebProvider(runtime));
+ * const fw = await initFireweave({
+ *   mode: 'remote',
+ *   apiKey,
+ *   apiUrl,
+ *   context: { targetingKey: 'anonymous' },
+ * });
  *
  * // Reads are SYNCHRONOUS — no await, safe inside render.
- * const on = OpenFeature.getClient().getBooleanValue('new-checkout', false);
+ * 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 './errors.js';
-export type { FireweaveErrorKind, FireweaveErrorOptions, OpenFeatureErrorCode, ErrorKindSpec, } from './errors.js';
-export type { JsonValue, FlagValueType, Decision, DecisionReason, CanonicalContext, LifecycleState, Signal, SignalKind, Exposure, ReleaseContext, ReleaseState, Capabilities, } from './types.js';
-export { DEFAULT_CONTEXT_LIMITS, DEFAULT_RESERVED_ATTRIBUTE_KEYS, canonicalizeContext, mergeContexts, } from './context.js';
-export type { ContextInput, ContextLimits } from './context.js';
-export { DEFAULT_ALLOWED_HOSTS, assertHostAllowed, assertNotSecretKey, isLoopbackHostname, } from './hosts.js';
-export type { WebBackendAdapter, AdapterResolution, AdapterRuntimeFeatures, PrefetchOptions, PrefetchResult, RegisterTargetOptions, RegisterTargetResult, TargetKind, } from './adapter.js';
-export { FireweaveRemoteWebAdapter } from './adapters/remote.js';
-export type { FireweaveRemoteWebAdapterOptions, FireweaveFetchLike, } from './adapters/remote.js';
-export { InMemoryWebAdapter } from './adapters/inmemory.js';
-export type { InMemoryWebAdapterOptions, InMemoryFlagDefinition, InMemoryFault, } from './adapters/inmemory.js';
-export { FireweaveLocalWebAdapter } from './adapters/local.js';
-export type { FireweaveLocalWebAdapterOptions } from './adapters/local.js';
-export { FireweaveWebRuntime, DEFAULT_FLAGS_READY_TIMEOUT_MS } from './runtime.js';
-export type { FireweaveWebRuntimeConfig, ExpectedFlagType } from './runtime.js';
-export { FireweaveWebProvider } from './provider.js';
-export type { FireweaveWebProviderOptions } from './provider.js';
-export { FireweaveWebClient, WebControlPointsApi, WebExposuresApi, WebSignalsApi, WebReleasesApi, DEFAULT_SIGNAL_ATTRIBUTE_ALLOWLIST, } from './client.js';
-export type { FireweaveWebClientOptions, ExtensionResult, ReleaseResult } from './client.js';
+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';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,SAAS,EACT,aAAa,EACb,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,MAAM,EACN,UAAU,EACV,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,mBAAmB,EACnB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,YAAY,EACV,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EACV,yBAAyB,EACzB,sBAAsB,EACtB,aAAa,GACd,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AACnF,YAAY,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,cAAc,EACd,kCAAkC,GACnC,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,yBAAyB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtF,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEzH,YAAY,EACV,SAAS,EACT,aAAa,EACb,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,MAAM,EACN,UAAU,EACV,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7G,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEtF,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE7H,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EAAE,gCAAgC,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEhH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,YAAY,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAE9H,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,YAAY,EAAE,+BAA+B,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAEjH,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAC/F,YAAY,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5F,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE3G,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -6,30 +6,34 @@
  * shapes at the door. Credentials are passed in explicitly by the embedding app.
  *
  * ```ts
- * import { OpenFeature } from '@openfeature/web-sdk';
- * import {
- *   FireweaveRemoteWebAdapter,
- *   FireweaveWebProvider,
- *   FireweaveWebRuntime,
- * } from '@fireweaveai/web-sdk';
+ * import { initFireweave } from '@fireweaveai/web-sdk';
  *
- * const runtime = new FireweaveWebRuntime(
- *   new FireweaveRemoteWebAdapter({ apiUrl, apiKey }),
- *   { globalContext: { targetingKey: 'anonymous' } }
- * );
- * await OpenFeature.setProviderAndWait(new FireweaveWebProvider(runtime));
+ * const fw = await initFireweave({
+ *   mode: 'remote',
+ *   apiKey,
+ *   apiUrl,
+ *   context: { targetingKey: 'anonymous' },
+ * });
  *
  * // Reads are SYNCHRONOUS — no await, safe inside render.
- * const on = OpenFeature.getClient().getBooleanValue('new-checkout', false);
+ * 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 './errors.js';
-export { DEFAULT_CONTEXT_LIMITS, DEFAULT_RESERVED_ATTRIBUTE_KEYS, canonicalizeContext, mergeContexts, } from './context.js';
-export { DEFAULT_ALLOWED_HOSTS, assertHostAllowed, assertNotSecretKey, isLoopbackHostname, } from './hosts.js';
-export { FireweaveRemoteWebAdapter } from './adapters/remote.js';
-export { InMemoryWebAdapter } from './adapters/inmemory.js';
-export { FireweaveLocalWebAdapter } from './adapters/local.js';
-export { FireweaveWebRuntime, DEFAULT_FLAGS_READY_TIMEOUT_MS } from './runtime.js';
-export { FireweaveWebProvider } from './provider.js';
-export { FireweaveWebClient, WebControlPointsApi, WebExposuresApi, WebSignalsApi, WebReleasesApi, DEFAULT_SIGNAL_ATTRIBUTE_ALLOWLIST, } from './client.js';
+export { FireweaveError, ERROR_TAXONOMY, isFireweaveError } from './domain/errors.js';
+export { DEFAULT_CONTEXT_LIMITS, DEFAULT_RESERVED_ATTRIBUTE_KEYS, mergeContexts } from './domain/context.js';
+export { canonicalizeContext, matchesExpectedType, validateContext, validateControlPointKey, validateDefaultValue, validateTargetingKey, validateInitOptions, } from './domain/validation.js';
+export { DEFAULT_ALLOWED_HOSTS, assertHostAllowed, assertNotSecretKey, isLoopbackHostname } from './infrastructure/hosts.js';
+export { FireweaveRemoteWebAdapter } from './infrastructure/adapters/remote.js';
+export { InMemoryWebAdapter } from './infrastructure/adapters/inmemory.js';
+export { FireweaveLocalWebAdapter } from './infrastructure/adapters/local.js';
+export { FireweaveWebRuntime, DEFAULT_FLAGS_READY_TIMEOUT_MS } from './application/runtime.js';
+export { FireweaveWebClient, WebControlPointsApi } from './application/client.js';
+export { initFireweave } from './application/mode.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAuBrB,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,mBAAmB,EACnB,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAapB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAMjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAO5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAGnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,cAAc,EACd,kCAAkC,GACnC,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAkBtF,OAAO,EAAE,sBAAsB,EAAE,+BAA+B,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG7G,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAY7H,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAGhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAG3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAG/F,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGlF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/{adapters → infrastructure/adapters}/inmemory.d.ts

@@ -5,9 +5,9 @@
  * 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';
+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;

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

@@ -0,0 +1 @@
+{"version":3,"file":"inmemory.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/adapters/inmemory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE1G,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 → infrastructure/adapters}/inmemory.js

@@ -5,7 +5,7 @@
  * injection exists so the conformance suite can drive the error taxonomy
  * without a network or a stub server.
  */
-import { FireweaveError } from '../errors.js';
+import { FireweaveError } from '../../domain/errors.js';
 export class InMemoryWebAdapter {
     name = 'inmemory';
     flags;

package/dist/infrastructure/adapters/inmemory.js.map

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