@lunora/flags 1.0.0-alpha.11 → 1.0.0-alpha.12

package/dist/index.mjs

@@ -1,2 +1,2 @@
 export { defineFlags, isFlagsDefinition } from './packem_shared/defineFlags-DAIO8cWQ.mjs';
-export { createFlags } from './packem_shared/createFlags-CEbcdnqZ.mjs';
+export { createFlags } from './packem_shared/createFlags-C71WRpQ1.mjs';

package/dist/packem_shared/{createFlags-CEbcdnqZ.mjs → createFlags-C71WRpQ1.mjs}

@@ -1,6 +1,45 @@
 import { LunoraError } from '@lunora/errors';
 import { OpenFeature, ErrorCode } from '@openfeature/server-sdk';
 
+const compareKeys = (a, b) => {
+  if (a < b) {
+    return -1;
+  }
+  return a > b ? 1 : 0;
+};
+const stableStringify = (value) => {
+  if (value === void 0) {
+    return "null";
+  }
+  if (typeof value === "bigint") {
+    throw new TypeError("stableStringify: cannot use a bigint in a cache key (query/subscription/shape args) — pass it as a string");
+  }
+  if (value === null || typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+  }
+  const proto = Object.getPrototypeOf(value);
+  if (proto !== null && proto !== Object.prototype) {
+    const name = value.constructor?.name ?? "value";
+    throw new TypeError(
+      `stableStringify: cannot use a ${name} in a cache key (query/subscription/shape args) — only plain objects, arrays, and JSON primitives are supported`
+    );
+  }
+  const record = value;
+  const keys = Object.keys(record).toSorted(compareKeys);
+  const parts = [];
+  for (const key of keys) {
+    const raw = record[key];
+    if (raw === void 0) {
+      continue;
+    }
+    parts.push(`${JSON.stringify(key)}:${stableStringify(raw)}`);
+  }
+  return `{${parts.join(",")}}`;
+};
+
 const DOMAIN = "lunora";
 let clientBinding;
 const bindClient = ({ hooks, logger, provider }) => {
@@ -27,13 +66,11 @@ const resetFlags = async () => {
   await OpenFeature.clearProviders();
 };
 const memoKey = (type, flagKey, defaultValue, context) => {
-  const contextKeys = Object.keys(context);
-  const prefix = JSON.stringify([type, flagKey, defaultValue]);
-  if (contextKeys.length === 0) {
-    return `${prefix}:[]`;
+  const prefix = stableStringify([type, flagKey, defaultValue]);
+  if (Object.keys(context).length === 0) {
+    return `${prefix}:{}`;
   }
-  const entries = contextKeys.toSorted((a, b) => a.localeCompare(b)).map((name) => [name, context[name]]);
-  return `${prefix}:${JSON.stringify(entries)}`;
+  return `${prefix}:${stableStringify(context)}`;
 };
 const resolveDetails = (client, type, flagKey, defaultValue, context) => {
   switch (type) {
@@ -65,12 +102,7 @@ const createFlags = (options) => {
   const memo = /* @__PURE__ */ new Map();
   const evaluate = (type, flagKey, defaultValue, context) => {
     const merged = resolvedTargetingKey === void 0 ? { ...context } : { targetingKey: resolvedTargetingKey, ...context };
-    const key = memoKey(type, flagKey, defaultValue, merged);
-    const cached = memo.get(key);
-    if (cached) {
-      return cached;
-    }
-    const pending = bindClient({ hooks, logger, provider }).then((client) => resolveDetails(client, type, flagKey, defaultValue, merged)).catch((error) => {
+    const failClosed = (error) => {
       return {
         errorCode: ErrorCode.GENERAL,
         errorMessage: error instanceof Error ? error.message : String(error),
@@ -79,7 +111,19 @@ const createFlags = (options) => {
         reason: "ERROR",
         value: defaultValue
       };
-    });
+    };
+    const run = () => bindClient({ hooks, logger, provider }).then((client) => resolveDetails(client, type, flagKey, defaultValue, merged)).catch(failClosed);
+    let key;
+    try {
+      key = memoKey(type, flagKey, defaultValue, merged);
+    } catch {
+      return run();
+    }
+    const cached = memo.get(key);
+    if (cached) {
+      return cached;
+    }
+    const pending = run();
     memo.set(key, pending);
     return pending;
   };

package/dist/providers/env.mjs

@@ -37,7 +37,7 @@ const envProvider = (options = {}) => {
         if (FALSE_TOKENS.has(token)) {
           return staticDetails(false);
         }
-        return parseError(defaultValue, `env flag "${flagKey}" (${nameOf(flagKey)}) is not a boolean: "${value}"`);
+        return parseError(defaultValue, `env flag "${flagKey}" (${nameOf(flagKey)}) value is not a recognized boolean`);
       },
       resolveNumberEvaluation: (flagKey, defaultValue) => {
         const value = raw(flagKey);
@@ -46,7 +46,7 @@ const envProvider = (options = {}) => {
         }
         const parsed = Number(value);
         if (value.trim() === "" || Number.isNaN(parsed)) {
-          return parseError(defaultValue, `env flag "${flagKey}" (${nameOf(flagKey)}) is not a number: "${value}"`);
+          return parseError(defaultValue, `env flag "${flagKey}" (${nameOf(flagKey)}) value is not a number`);
         }
         return staticDetails(parsed);
       },

package/dist/providers/flagship.mjs

@@ -16,6 +16,16 @@ const flagshipProvider = (options) => {
       return new FlagshipServerProvider({ binding, ...rest });
     };
   }
+  const { appId, endpoint } = options;
+  if (appId === void 0 && endpoint === void 0) {
+    throw new LunoraError(
+      "INTERNAL",
+      'flagshipProvider: HTTP mode requires either `appId` (the SDK builds the evaluation URL) or `endpoint` (a full evaluation URL). Pass exactly one, or use binding mode: `flagshipProvider({ binding: "FLAGS" })`.'
+    );
+  }
+  if (appId !== void 0 && endpoint !== void 0) {
+    throw new LunoraError("INTERNAL", "flagshipProvider: `appId` and `endpoint` are mutually exclusive in HTTP mode — pass exactly one.");
+  }
   return () => new FlagshipServerProvider(options);
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/flags",
-  "version": "1.0.0-alpha.11",
+  "version": "1.0.0-alpha.12",
   "description": "OpenFeature-based feature flags for Lunora — ctx.flags, useFlag, and a first-class Cloudflare Flagship provider with any OpenFeature provider pluggable",
   "keywords": [
     "cloudflare",
@@ -60,7 +60,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/errors": "1.0.0-alpha.3",
+    "@lunora/errors": "1.0.0-alpha.4",
     "@openfeature/server-sdk": "^1.22.0"
   },
   "peerDependencies": {