@featureflip/edge 0.0.0-stage → 2.14.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Canopy Labs LLC
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,89 @@
-# Temporary Holding Version
+# @featureflip/edge
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Featureflip SDK for Cloudflare Workers. It evaluates flags locally inside your Worker from a cached copy of your environment's flag config, so a request that finds a warm copy makes no network call to evaluate a flag.
+
+Cloudflare Workers is the only supported runtime.
+
+## Install
+
+```bash
+npm install @featureflip/edge
+```
+
+## Quickstart
+
+```ts
+import { createEdgeClient } from '@featureflip/edge';
+
+type Env = { FEATUREFLIP_SERVER_KEY: string };
+
+// Config only at module scope: Workers forbid I/O there, and the key lives in `env`.
+let flags: ReturnType<typeof createEdgeClient> | undefined;
+
+export default {
+  async fetch(request: Request, env: Env, ctx: ExecutionContext) {
+    flags ??= createEdgeClient({ sdkKey: env.FEATUREFLIP_SERVER_KEY });
+
+    const snapshot = await flags.load(ctx);
+    const context = { user_id: 'user-123' };
+
+    const enabled = snapshot.boolVariation('new-checkout', context, false);
+    const detail = snapshot.variationDetail('checkout-copy', context, 'control');
+    const bootstrap = snapshot.bootstrapValues(context);
+
+    return new Response(JSON.stringify({ enabled, detail, bootstrap }));
+  },
+};
+```
+
+Call `load(ctx)` once per request. After it resolves, every variation call is synchronous.
+
+## Options
+
+`sdkKey` is the only required option. Use a server SDK key, not a client key.
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `sdkKey` | none (required) | Server SDK key. Sent as `Authorization` and never logged. |
+| `baseUrl` | `https://eval.featureflip.io` | Evaluation API origin. |
+| `ttlSeconds` | `60` | Age after which a copy is refreshed in the background. |
+| `maxStaleSeconds` | `86400` | Age after which a copy is no longer served at all. |
+| `loadTimeoutMs` | `1000` | How long a load with no cached copy waits for the origin. |
+| `store` | Workers Cache API | Where fetched config is shared between isolates. |
+| `wrappers` | `[]` | `name/version` tokens for libraries that wrap this SDK. |
+| `flushBatchSize` | `100` | Events sent per `POST /v1/sdk/events` request. |
+| `fetch` | global `fetch` | `fetch` implementation, mainly for tests. |
+
+## Freshness
+
+Flag changes reach edge traffic within `ttlSeconds` (60 seconds by default). This is not the near-instant push that the server SDKs get over a streaming connection.
+
+A copy older than `ttlSeconds` is still served while a background refresh runs. So after an idle spell, the first request in gets the older copy once, because the refresh it started hasn't finished. A copy older than `maxStaleSeconds` is not served. If a config fetch fails, the SDK backs off for 15 seconds before trying the origin again, and keeps serving any copy it has.
+
+## Pass `ctx`
+
+Pass the Workers `ExecutionContext` to `load(ctx)`. It registers the background refresh and the event flush with `waitUntil`, so both finish after the response is sent.
+
+Without `ctx`, await `flush()` yourself before responding, and the background refresh may be cut off when the request ends. The SDK logs a one-time warning when it runs without `ctx`.
+
+## Cold start
+
+With no cached copy, `load` waits up to `loadTimeoutMs` for the origin. If the origin is slower, `load` resolves a snapshot with `ready === false` that serves your default values. The fetch keeps going in the background and fills the cache for the next request.
+
+## Bootstrapping the browser SDK
+
+`snapshot.bootstrapValues(context)` returns the values of client-visible flags only, for the `bootstrap` option of `@featureflip/browser`. If the server does not send the client-visibility field, it returns nothing, so no flag is exposed by mistake.
+
+## Events
+
+Evaluations are queued as events and sent with `waitUntil` when you pass `ctx`. A request's flush sends only if a batch is full or 10 seconds have passed since the last send, so a busy isolate stops posting once per request. After a `429`, a `5xx` or a network error nothing is sent for 30 seconds, and outside that window `flush()` sends straight away, capped at 5 requests a call.
+
+Delivery is best effort. The queue lives in the isolate's memory, so events still queued when Cloudflare evicts the isolate are lost.
+
+## Logging
+
+Messages go to `console.warn`. The SDK's own start with `[featureflip-edge]`, and the few from the shared evaluation core (rejected or dropped events, an ignored `wrappers` token) start with `[featureflip]`.
+
+## License
+
+Apache-2.0

package/dist/edge-sdk/src/client.d.ts

@@ -0,0 +1,35 @@
+import { EdgeConfig } from './config.js';
+import { EdgeSnapshot } from './snapshot.js';
+/** The part of a Workers `ExecutionContext` the client uses. */
+export interface WaitUntilContext {
+    waitUntil(promise: Promise<unknown>): void;
+}
+export interface EdgeClient {
+    /**
+     * The snapshot to evaluate this request against. Never rejects: with no usable
+     * config it resolves to a snapshot that serves defaults (`ready === false`).
+     *
+     * Pass the request's `ctx` so the background refresh and the event flush run
+     * in `waitUntil`. As it resolves, `load(ctx)` hands `waitUntil` a flush that
+     * runs once the handler's code following `await load(ctx)` yields. That flush
+     * sends only when a batch is full or 10 s have passed since the last send, so
+     * events from busy traffic go out together rather than one POST per request.
+     * Events are best effort: anything still queued when the isolate is evicted
+     * is lost.
+     */
+    load(ctx?: WaitUntilContext): Promise<EdgeSnapshot>;
+    /**
+     * Sends queued evaluation events now, up to 5 batches. Never rejects. Await it
+     * when there is no `ctx`. Within 30 s of a failed send it resolves without
+     * sending, and the events stay queued.
+     */
+    flush(): Promise<void>;
+}
+/**
+ * A Featureflip client for Cloudflare Workers. Construct it at module scope: it
+ * does no I/O until the first `load`.
+ *
+ * @throws {Error} only when `sdkKey` is missing.
+ */
+export declare function createEdgeClient(config: EdgeConfig): EdgeClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/edge-sdk/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAsB,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAK7C,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACpD;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA4ED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE/D"}

package/dist/edge-sdk/src/config.d.ts

@@ -0,0 +1,42 @@
+import { ConfigStore } from './store.js';
+export interface EdgeConfig {
+    /** A server-side SDK key. It is sent as `Authorization` and never logged. */
+    sdkKey: string;
+    /** Evaluation API origin. Default `https://eval.featureflip.io`. */
+    baseUrl?: string;
+    /** Age after which a served copy is refreshed in the background. Default 60. */
+    ttlSeconds?: number;
+    /** Age after which a copy is no longer served at all. Default 86400 (one day). */
+    maxStaleSeconds?: number;
+    /** How long a load with no usable copy waits for the origin before serving defaults. Default 1000. */
+    loadTimeoutMs?: number;
+    /** Where fetched config is shared between isolates. Default: the Workers Cache API. */
+    store?: ConfigStore;
+    /** `name/version` tokens for libraries wrapping this SDK, sent after the SDK's own. */
+    wrappers?: string[];
+    /** Events per `POST /v1/sdk/events` request. Default 100. */
+    flushBatchSize?: number;
+    /** `fetch` implementation. Default: the global `fetch`. */
+    fetch?: typeof fetch;
+}
+export interface ResolvedEdgeConfig {
+    sdkKey: string;
+    baseUrl: string;
+    ttlSeconds: number;
+    maxStaleSeconds: number;
+    loadTimeoutMs: number;
+    store: ConfigStore | undefined;
+    wrappers: string[];
+    flushBatchSize: number;
+    fetch: typeof fetch;
+}
+export declare const DEFAULTS: {
+    readonly baseUrl: "https://eval.featureflip.io";
+    readonly ttlSeconds: 60;
+    readonly maxStaleSeconds: 86400;
+    readonly loadTimeoutMs: 1000;
+    readonly flushBatchSize: 100;
+};
+/** Throws only on a missing `sdkKey`; does no I/O. */
+export declare function resolveEdgeConfig(config: EdgeConfig): ResolvedEdgeConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/edge-sdk/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sGAAsG;IACtG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB;AAED,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,kBAAkB,CAiBxE"}

package/dist/edge-sdk/src/index.d.ts

@@ -0,0 +1,7 @@
+export { createEdgeClient } from './client.js';
+export type { EdgeClient, WaitUntilContext } from './client.js';
+export type { EdgeConfig } from './config.js';
+export type { EdgeSnapshot } from './snapshot.js';
+export type { ConfigStore, StoredConfig } from './store.js';
+export type { EvaluationContext, EvaluationDetail, EvaluationReason, FlagType, GetFlagsResponse, } from '../../js-sdk/src/core/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/edge-sdk/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,GACjB,MAAM,gCAAgC,CAAC"}

package/dist/edge-sdk/src/snapshot.d.ts

@@ -0,0 +1,61 @@
+import { EvaluationContext, EvaluationDetail, GetFlagsResponse } from '../../js-sdk/src/core/types.js';
+/**
+ * Called once per variation call with the detail it resolved to. The edge client
+ * uses it to queue evaluation events; `bootstrapValues` never calls it.
+ */
+export type EvaluationRecorder = (flagKey: string, context: EvaluationContext, detail: EvaluationDetail) => void;
+/**
+ * An immutable, evaluable view of one `GET /v1/sdk/flags` payload.
+ *
+ * Built once per fetched config and then read by every request the Worker
+ * serves, so all the indexing happens at construction. Evaluation goes through
+ * the same `resolveDetail` the JS core uses, so a flag resolves identically
+ * here and in `@featureflip/js`, reasons included.
+ */
+export declare class EdgeSnapshot {
+    /** False only for `empty()`: no config has been loaded. */
+    readonly ready: boolean;
+    /** The environment config version the snapshot was built from. */
+    readonly version: number | undefined;
+    private readonly flags;
+    private readonly flagList;
+    private readonly deps;
+    private readonly record;
+    private constructor();
+    /**
+     * Build a snapshot from a fetched config.
+     *
+     * An unevaluable flag or segment (an enum value this SDK version does not know)
+     * is dropped with a warning and the rest of the config still serves, as in the
+     * JS core (#2402).
+     *
+     * @throws {MalformedPayloadError} when the payload violates the wire contract.
+     *   The caller decides what to fall back to.
+     */
+    static fromResponse(data: GetFlagsResponse, record: EvaluationRecorder): EdgeSnapshot;
+    /** A snapshot with no flags: every read serves its default with `FlagNotFound`. */
+    static empty(record: EvaluationRecorder): EdgeSnapshot;
+    boolVariation(key: string, context: EvaluationContext, defaultValue: boolean): boolean;
+    stringVariation(key: string, context: EvaluationContext, defaultValue: string): string;
+    numberVariation(key: string, context: EvaluationContext, defaultValue: number): number;
+    /** Untyped: the served value is returned whatever its JSON type. */
+    jsonVariation<T>(key: string, context: EvaluationContext, defaultValue: T): T;
+    /** Untyped, like `jsonVariation`, with the reason and variation attached. */
+    variationDetail<T>(key: string, context: EvaluationContext, defaultValue: T): EvaluationDetail<T>;
+    /**
+     * The served value of every flag marked `clientSideVisible: true`, for handing
+     * to a browser SDK as bootstrap data. A flag without the field is treated as
+     * not visible, because a server that predates it cannot vouch for it.
+     *
+     * Prerequisites still resolve against the whole config, server-only flags
+     * included, through one memo shared across the sweep. Records nothing: these
+     * values are not reads by the Worker's own code.
+     *
+     * A flag whose evaluation resolves to reason `Error` is omitted.
+     */
+    bootstrapValues(context: EvaluationContext): Record<string, unknown>;
+    /** The shared deps plus an error hook that names the flag being read. */
+    private depsFor;
+    private evaluate;
+}
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/edge-sdk/src/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/snapshot.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAEhB,gBAAgB,EAEjB,MAAM,gCAAgC,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,gBAAgB,KACrB,IAAI,CAAC;AAEV;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAErC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,OAAO;IAyBP;;;;;;;;;OASG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,GAAG,YAAY;IAarF,mFAAmF;IACnF,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY;IAItD,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO;IAItF,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAItF,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAItF,oEAAoE;IACpE,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC;IAI7E,6EAA6E;IAC7E,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAIjG;;;;;;;;;;OAUG;IACH,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAyBpE,yEAAyE;IACzE,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,QAAQ;CAgBjB"}

package/dist/edge-sdk/src/store.d.ts

@@ -0,0 +1,21 @@
+import { GetFlagsResponse } from '../../js-sdk/src/core/types.js';
+export interface StoredConfig {
+    data: GetFlagsResponse;
+    /** Epoch milliseconds at which `data` was fetched from the evaluation API. */
+    fetchedAt: number;
+}
+export interface ConfigStore {
+    /** Never throws: any failure is a miss (and warns). */
+    get(): Promise<StoredConfig | undefined>;
+    /** Never throws: any failure warns. */
+    put(config: StoredConfig, maxStaleSeconds: number): Promise<void>;
+}
+export declare const FETCHED_AT_HEADER = "x-featureflip-fetched-at";
+/**
+ * Cache API key for one (base URL, SDK key) pair. The cache namespace is shared
+ * across every hostname on the zone, so the hashed SDK key is the only tenant
+ * isolation: the key is a SHA-256 of both inputs and the raw key never appears.
+ */
+export declare function configCacheKey(baseUrl: string, sdkKey: string): Promise<string>;
+export declare function createCacheApiStore(cacheKey: string, cache?: Cache): ConfigStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/edge-sdk/src/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,GAAG,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACzC,uCAAuC;IACvC,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAI5D;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKrF;AASD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,WAAW,CA6ChF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './edge-sdk/src/index.js'
+export {}