@featureflip/edge 0.0.0-stage → 2.14.0

package/dist/js-sdk/src/core/validate-snapshot.d.ts

@@ -0,0 +1,38 @@
+import { FlagDto, GetFlagsResponse } from './types.js';
+/**
+ * Raised when a config payload violates the wire contract.
+ *
+ * Distinct from a network or JSON-syntax failure on purpose: those self-heal on the
+ * next poll or reconnect and are correctly silent, while a contract violation means
+ * the server and SDK disagree about the shape of the data and must be surfaced. The
+ * catch sites key their diagnostics off this type, mirroring ruby's
+ * `MalformedPayloadError` (#2285).
+ */
+export declare class MalformedPayloadError extends Error {
+    constructor(message: string);
+}
+/**
+ * Assert that every enum-carrying field in a config snapshot arrived as a string.
+ *
+ * TYPE-ONLY, and that restraint is load-bearing. An *unrecognised* operator string is
+ * how a newer server ships a new operator to an older SDK; every evaluator already
+ * degrades that to no-match (#2262), so rejecting it here would break this SDK against
+ * every future server. What must be rejected is a *type* violation — `0` where `"And"`
+ * belongs — because TypeScript's types are erased at runtime and nothing else in the
+ * js core would notice: `conditionLogic: 0` fails the `=== 'And'` check and silently
+ * flips a segment from ALL of its conditions to ANY of them (#2279, #2315).
+ *
+ * Unknown *properties* are ignored, for the same forward-compatibility reason.
+ *
+ * @throws {MalformedPayloadError} on the first violation found.
+ */
+export declare function validateSnapshot(data: GetFlagsResponse): void;
+/**
+ * The single-flag variant, for the `flag.created` / `flag.updated` delta path. A
+ * malformed delta is dropped rather than upserted, which is what "never partially
+ * applied" means for a payload whose whole scope is one flag.
+ *
+ * @throws {MalformedPayloadError}
+ */
+export declare function validateFlag(flag: FlagDto): void;
+//# sourceMappingURL=validate-snapshot.d.ts.map

package/dist/js-sdk/src/core/validate-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-snapshot.d.ts","sourceRoot":"","sources":["../../../../../js-sdk/src/core/validate-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAc,MAAM,YAAY,CAAC;AAExE;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAM7D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAkBhD"}

package/dist/js-sdk/src/platform/browser.d.ts

@@ -0,0 +1,5 @@
+import { Platform } from './types.js';
+export declare function createBrowserPlatform(): Platform;
+declare function md5Bytes(input: string): Uint8Array;
+export { md5Bytes };
+//# sourceMappingURL=browser.d.ts.map

package/dist/js-sdk/src/platform/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../../../js-sdk/src/platform/browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAgB,qBAAqB,IAAI,QAAQ,CAgChD;AAmBD,iBAAS,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAmE3C;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/js-sdk/src/platform/types.d.ts

@@ -0,0 +1,31 @@
+export interface EventSourceLike {
+    addEventListener(type: string, listener: (event: {
+        data: string;
+    }) => void): void;
+    close(): void;
+    readonly readyState: number;
+}
+export interface Platform {
+    md5(input: string): Uint8Array;
+    /**
+     * May be asynchronous: the Node platform loads its ESM-only `eventsource`
+     * dependency with a dynamic `import()`, which is what keeps the SDK's
+     * `engines.node` floor at 20.19 (see platform/node.ts). Implementations that
+     * need nothing loaded — the browser's global `EventSource` — may still return
+     * the instance directly; the core awaits either shape.
+     */
+    createEventSource(url: string, headers: Record<string, string>): EventSourceLike | Promise<EventSourceLike>;
+    fetch(url: string, init?: RequestInit): Promise<Response>;
+    /** Extra headers the platform can inject (e.g. User-Agent on Node). */
+    readonly extraHeaders?: Record<string, string>;
+    /**
+     * The header that carries the SDK identity (`featureflip-js/<version>` plus any
+     * wrapper tokens). Node sets `User-Agent`; a browser cannot (the Fetch spec
+     * forbids it), so it uses `X-Featureflip-SDK`, which is also the default for a
+     * platform that does not say, because every runtime allows it.
+     */
+    readonly identityHeader?: 'User-Agent' | 'X-Featureflip-SDK';
+    /** Whether the platform's EventSource implementation supports custom headers. */
+    readonly sseSupportsHeaders?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/js-sdk/src/platform/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../js-sdk/src/platform/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAClF,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;IAC/B;;;;;;OAMG;IACH,iBAAiB,CACf,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,YAAY,GAAG,mBAAmB,CAAC;IAC7D,iFAAiF;IACjF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC"}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@featureflip/edge",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.14.0",
+  "description": "Cloudflare Workers SDK for Featureflip: local flag evaluation at the edge",
+  "keywords": [
+    "feature-flags",
+    "feature-toggles",
+    "feature-management",
+    "featureflip",
+    "cloudflare-workers",
+    "edge",
+    "typescript",
+    "sdk"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/canopy-labs/featureflip-edge.git"
+  },
+  "homepage": "https://featureflip.io/docs/sdks/edge/",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^5.20261019.1",
+    "@types/node": "^26.6.5",
+    "@typescript/typescript6": "^6.0.2",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.4",
+    "vite-plugin-dts": "^5.1.2",
+    "vitest": "^5.0.5"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "overrides": {
+    "lodash": ">=4.17.25"
+  }
+}