@lunora/flags 1.0.0-alpha.16 → 1.0.0-alpha.17

package/dist/index.mjs

@@ -1,2 +1 @@
-export { defineFlags, isFlagsDefinition } from './packem_shared/defineFlags-DAIO8cWQ.mjs';
-export { createFlags } from './packem_shared/createFlags-DGosFql2.mjs';
+import{defineFlags as o,isFlagsDefinition as r}from"./packem_shared/defineFlags-BO1q5hLr.mjs";import{createFlags as f}from"./packem_shared/createFlags-KrGb1nlE.mjs";export{f as createFlags,o as defineFlags,r as isFlagsDefinition};

package/dist/packem_shared/createFlags-KrGb1nlE.mjs

@@ -0,0 +1 @@
+import{LunoraError as k}from"@lunora/errors";import{OpenFeature as f,ErrorCode as E}from"@openfeature/server-sdk";const S=(e,o)=>e<o?-1:e>o?1:0,p=e=>{if(e===void 0)return"null";if(typeof e=="bigint")throw new TypeError("stableStringify: cannot use a bigint in a stable JSON cache key — pass it as a string, or use stableWireKey");if(e===null||typeof e!="object")return JSON.stringify(e);if(Array.isArray(e))return`[${e.map(c=>p(c)).join(",")}]`;const o=Object.getPrototypeOf(e);if(o!==null&&o!==Object.prototype){const c=e.constructor?.name??"value";throw new TypeError(`stableStringify: cannot use a ${c} in a stable JSON cache key — only plain objects, arrays, and JSON primitives are supported (wire-typed values key via stableWireKey)`)}const i=e,a=Object.keys(i).toSorted(S),s=[];for(const c of a){const b=i[c];b!==void 0&&s.push(`${JSON.stringify(c)}:${p(b)}`)}return`{${s.join(",")}}`},O="lunora";let u;const N=({hooks:e,logger:o,provider:i})=>(u===void 0&&(u=(async()=>{await f.setProviderAndWait(O,i());const a=f.getClient(O);return o&&a.setLogger(o),e&&e.length>0&&a.addHooks(...e),a})(),u.catch(()=>{u=void 0})),u),K=async()=>{u=void 0,await f.clearProviders()},$=(e,o,i,a)=>{const s=p([e,o,i]);return Object.keys(a).length===0?`${s}:{}`:`${s}:${p(a)}`},A=(e,o,i,a,s)=>{switch(o){case"boolean":return e.getBooleanDetails(i,a,s);case"number":return e.getNumberDetails(i,a,s);case"object":return e.getObjectDetails(i,a,s);case"string":return e.getStringDetails(i,a,s);default:throw new k("INTERNAL",`createFlags: unknown flag type "${o}"`)}},L=e=>{const{hooks:o,logger:i,provider:a,targetingKey:s}=e;let c;try{c=typeof s=="function"?s():s}catch{c=void 0}const b=new Map,g=(n,t,r,l)=>{const h=c===void 0?{...l}:{targetingKey:c,...l},w=y=>({errorCode:E.GENERAL,errorMessage:y instanceof Error?y.message:String(y),flagKey:t,flagMetadata:{},reason:"ERROR",value:r}),v=()=>N({hooks:o,logger:i,provider:a}).then(y=>A(y,n,t,r,h)).catch(w);let d;try{d=$(n,t,r,h)}catch{return v()}const j=b.get(d);if(j)return j;const m=v();return b.set(d,m),m};return{boolean:(n,t,r)=>g("boolean",n,t,r).then(l=>l.value),details:{boolean:(n,t,r)=>g("boolean",n,t,r),number:(n,t,r)=>g("number",n,t,r),object:(n,t,r)=>g("object",n,t,r),string:(n,t,r)=>g("string",n,t,r)},number:(n,t,r)=>g("number",n,t,r).then(l=>l.value),object:(n,t,r)=>g("object",n,t,r).then(l=>l.value),string:(n,t,r)=>g("string",n,t,r).then(l=>l.value)}};export{L as createFlags,K as resetFlags};

package/dist/packem_shared/defineFlags-BO1q5hLr.mjs

@@ -0,0 +1 @@
+const e=i=>{if(typeof i.provider!="function")throw new TypeError('defineFlags: `provider` must be a function `(env) => Provider` (e.g. flagshipProvider({ binding: "FLAGS" }))');if(i.identify!==void 0&&typeof i.identify!="function")throw new TypeError("defineFlags: `identify` must be a function `(auth) => string | undefined` when provided");if(i.hooks!==void 0&&!Array.isArray(i.hooks))throw new TypeError("defineFlags: `hooks` must be an array of OpenFeature hooks when provided");return{...i,isLunoraFlags:!0}},r=i=>typeof i=="object"&&i!==null&&i.isLunoraFlags===!0;export{e as defineFlags,r as isFlagsDefinition};

package/dist/providers/env.mjs

@@ -1,75 +1 @@
-import { ErrorCode } from '@openfeature/server-sdk';
-
-const upperSnake = (flagKey) => flagKey.replaceAll(/[^a-z0-9]+/gi, "_").toUpperCase();
-const TRUE_TOKENS = /* @__PURE__ */ new Set(["1", "on", "true", "yes"]);
-const FALSE_TOKENS = /* @__PURE__ */ new Set(["0", "false", "no", "off"]);
-const staticDetails = (value) => Promise.resolve({ reason: "STATIC", value });
-const missing = (defaultValue) => Promise.resolve({ reason: "DEFAULT", value: defaultValue });
-const parseError = (defaultValue, message) => Promise.resolve({ errorCode: ErrorCode.PARSE_ERROR, errorMessage: message, reason: "ERROR", value: defaultValue });
-const envProvider = (options = {}) => {
-  const prefix = options.prefix ?? "FLAG_";
-  const nameOf = options.name ?? ((flagKey) => prefix + upperSnake(flagKey));
-  return (env) => {
-    const raw = (flagKey) => {
-      const value = env[nameOf(flagKey)];
-      if (value === void 0 || value === null) {
-        return void 0;
-      }
-      if (typeof value === "string") {
-        return value;
-      }
-      if (typeof value === "number" || typeof value === "boolean") {
-        return String(value);
-      }
-      return JSON.stringify(value);
-    };
-    return {
-      metadata: { name: "lunora-env" },
-      resolveBooleanEvaluation: (flagKey, defaultValue) => {
-        const value = raw(flagKey);
-        if (value === void 0) {
-          return missing(defaultValue);
-        }
-        const token = value.trim().toLowerCase();
-        if (TRUE_TOKENS.has(token)) {
-          return staticDetails(true);
-        }
-        if (FALSE_TOKENS.has(token)) {
-          return staticDetails(false);
-        }
-        return parseError(defaultValue, `env flag "${flagKey}" (${nameOf(flagKey)}) value is not a recognized boolean`);
-      },
-      resolveNumberEvaluation: (flagKey, defaultValue) => {
-        const value = raw(flagKey);
-        if (value === void 0) {
-          return missing(defaultValue);
-        }
-        const parsed = Number(value);
-        if (value.trim() === "" || Number.isNaN(parsed)) {
-          return parseError(defaultValue, `env flag "${flagKey}" (${nameOf(flagKey)}) value is not a number`);
-        }
-        return staticDetails(parsed);
-      },
-      resolveObjectEvaluation: (flagKey, defaultValue) => {
-        const value = raw(flagKey);
-        if (value === void 0) {
-          return missing(defaultValue);
-        }
-        try {
-          return staticDetails(JSON.parse(value));
-        } catch (error) {
-          return parseError(
-            defaultValue,
-            `env flag "${flagKey}" (${nameOf(flagKey)}) is not valid JSON: ${error instanceof Error ? error.message : String(error)}`
-          );
-        }
-      },
-      resolveStringEvaluation: (flagKey, defaultValue) => {
-        const value = raw(flagKey);
-        return value === void 0 ? missing(defaultValue) : staticDetails(value);
-      }
-    };
-  };
-};
-
-export { envProvider };
+import{ErrorCode as c}from"@openfeature/server-sdk";const m=o=>o.replaceAll(/[^a-z0-9]+/gi,"_").toUpperCase(),g=new Set(["1","on","true","yes"]),d=new Set(["0","false","no","off"]),a=o=>Promise.resolve({reason:"STATIC",value:o}),l=o=>Promise.resolve({reason:"DEFAULT",value:o}),f=(o,u)=>Promise.resolve({errorCode:c.PARSE_ERROR,errorMessage:u,reason:"ERROR",value:o}),E=(o={})=>{const u=o.prefix??"FLAG_",s=o.name??(v=>u+m(v));return v=>{const i=r=>{const e=v[s(r)];if(e!=null)return typeof e=="string"?e:typeof e=="number"||typeof e=="boolean"?String(e):JSON.stringify(e)};return{metadata:{name:"lunora-env"},resolveBooleanEvaluation:(r,e)=>{const n=i(r);if(n===void 0)return l(e);const t=n.trim().toLowerCase();return g.has(t)?a(!0):d.has(t)?a(!1):f(e,`env flag "${r}" (${s(r)}) value is not a recognized boolean`)},resolveNumberEvaluation:(r,e)=>{const n=i(r);if(n===void 0)return l(e);const t=Number(n);return n.trim()===""||Number.isNaN(t)?f(e,`env flag "${r}" (${s(r)}) value is not a number`):a(t)},resolveObjectEvaluation:(r,e)=>{const n=i(r);if(n===void 0)return l(e);try{return a(JSON.parse(n))}catch(t){return f(e,`env flag "${r}" (${s(r)}) is not valid JSON: ${t instanceof Error?t.message:String(t)}`)}},resolveStringEvaluation:(r,e)=>{const n=i(r);return n===void 0?l(e):a(n)}}}};export{E as envProvider};

package/dist/providers/flagship.mjs

@@ -1,32 +1 @@
-import { FlagshipServerProvider } from '@cloudflare/flagship/server';
-import { LunoraError } from '@lunora/errors';
-
-const isBindingOptions = (options) => "binding" in options && typeof options.binding === "string";
-const flagshipProvider = (options) => {
-  if (isBindingOptions(options)) {
-    const { binding: bindingName, ...rest } = options;
-    return (env) => {
-      const binding = env[bindingName];
-      if (binding === void 0 || binding === null) {
-        throw new LunoraError(
-          "INTERNAL",
-          `flagshipProvider: no binding "${bindingName}" found on env. Add a \`flagship\` binding to wrangler.jsonc, e.g. { "flagship": [{ "binding": "${bindingName}", "app_id": "your-app-id" }] }.`
-        );
-      }
-      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);
-};
-
-export { flagshipProvider };
+import{FlagshipServerProvider as a}from"@cloudflare/flagship/server";import{LunoraError as e}from"@lunora/errors";const s=n=>"binding"in n&&typeof n.binding=="string",f=n=>{if(s(n)){const{binding:i,...t}=n;return p=>{const d=p[i];if(d==null)throw new e("INTERNAL",`flagshipProvider: no binding "${i}" found on env. Add a \`flagship\` binding to wrangler.jsonc, e.g. { "flagship": [{ "binding": "${i}", "app_id": "your-app-id" }] }.`);return new a({binding:d,...t})}}const{appId:o,endpoint:r}=n;if(o===void 0&&r===void 0)throw new e("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(o!==void 0&&r!==void 0)throw new e("INTERNAL","flagshipProvider: `appId` and `endpoint` are mutually exclusive in HTTP mode — pass exactly one.");return()=>new a(n)};export{f as flagshipProvider};

package/dist/providers/memory.mjs

@@ -1,16 +1 @@
-import { TypedInMemoryProvider } from '@openfeature/server-sdk';
-
-const memoryProvider = (flags) => {
-  const configuration = {};
-  for (const [key, value] of Object.entries(flags)) {
-    configuration[key] = {
-      defaultVariant: "default",
-      disabled: false,
-      variants: { default: value }
-    };
-  }
-  const provider = new TypedInMemoryProvider(configuration);
-  return (_environment) => provider;
-};
-
-export { memoryProvider };
+import{TypedInMemoryProvider as n}from"@openfeature/server-sdk";const d=t=>{const e={};for(const[r,a]of Object.entries(t))e[r]={defaultVariant:"default",disabled:!1,variants:{default:a}};const o=new n(e);return r=>o};export{d as memoryProvider};

package/dist/web.mjs

@@ -1 +1 @@
-export { FlagshipClientProvider } from '@cloudflare/flagship/web';
+import{FlagshipClientProvider as i}from"@cloudflare/flagship/web";export{i as FlagshipClientProvider};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/flags",
-  "version": "1.0.0-alpha.16",
+  "version": "1.0.0-alpha.17",
   "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.8",
+    "@lunora/errors": "1.0.0-alpha.9",
     "@openfeature/server-sdk": "^1.22.0"
   },
   "peerDependencies": {

package/dist/packem_shared/createFlags-DGosFql2.mjs

@@ -1,144 +0,0 @@
-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 stable JSON cache key — pass it as a string, or use stableWireKey");
-  }
-  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 stable JSON cache key — only plain objects, arrays, and JSON primitives are supported (wire-typed values key via stableWireKey)`
-    );
-  }
-  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 }) => {
-  if (clientBinding === void 0) {
-    clientBinding = (async () => {
-      await OpenFeature.setProviderAndWait(DOMAIN, provider());
-      const client = OpenFeature.getClient(DOMAIN);
-      if (logger) {
-        client.setLogger(logger);
-      }
-      if (hooks && hooks.length > 0) {
-        client.addHooks(...hooks);
-      }
-      return client;
-    })();
-    clientBinding.catch(() => {
-      clientBinding = void 0;
-    });
-  }
-  return clientBinding;
-};
-const resetFlags = async () => {
-  clientBinding = void 0;
-  await OpenFeature.clearProviders();
-};
-const memoKey = (type, flagKey, defaultValue, context) => {
-  const prefix = stableStringify([type, flagKey, defaultValue]);
-  if (Object.keys(context).length === 0) {
-    return `${prefix}:{}`;
-  }
-  return `${prefix}:${stableStringify(context)}`;
-};
-const resolveDetails = (client, type, flagKey, defaultValue, context) => {
-  switch (type) {
-    case "boolean": {
-      return client.getBooleanDetails(flagKey, defaultValue, context);
-    }
-    case "number": {
-      return client.getNumberDetails(flagKey, defaultValue, context);
-    }
-    case "object": {
-      return client.getObjectDetails(flagKey, defaultValue, context);
-    }
-    case "string": {
-      return client.getStringDetails(flagKey, defaultValue, context);
-    }
-    default: {
-      throw new LunoraError("INTERNAL", `createFlags: unknown flag type "${type}"`);
-    }
-  }
-};
-const createFlags = (options) => {
-  const { hooks, logger, provider, targetingKey } = options;
-  let resolvedTargetingKey;
-  try {
-    resolvedTargetingKey = typeof targetingKey === "function" ? targetingKey() : targetingKey;
-  } catch {
-    resolvedTargetingKey = void 0;
-  }
-  const memo = /* @__PURE__ */ new Map();
-  const evaluate = (type, flagKey, defaultValue, context) => {
-    const merged = resolvedTargetingKey === void 0 ? { ...context } : { targetingKey: resolvedTargetingKey, ...context };
-    const failClosed = (error) => {
-      return {
-        errorCode: ErrorCode.GENERAL,
-        errorMessage: error instanceof Error ? error.message : String(error),
-        flagKey,
-        flagMetadata: {},
-        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;
-  };
-  return {
-    boolean: (flagKey, defaultValue, context) => evaluate("boolean", flagKey, defaultValue, context).then((details) => details.value),
-    details: {
-      boolean: (flagKey, defaultValue, context) => evaluate("boolean", flagKey, defaultValue, context),
-      number: (flagKey, defaultValue, context) => evaluate("number", flagKey, defaultValue, context),
-      object: (flagKey, defaultValue, context) => evaluate("object", flagKey, defaultValue, context),
-      string: (flagKey, defaultValue, context) => evaluate("string", flagKey, defaultValue, context)
-    },
-    number: (flagKey, defaultValue, context) => evaluate("number", flagKey, defaultValue, context).then((details) => details.value),
-    object: (flagKey, defaultValue, context) => evaluate("object", flagKey, defaultValue, context).then((details) => details.value),
-    string: (flagKey, defaultValue, context) => evaluate("string", flagKey, defaultValue, context).then((details) => details.value)
-  };
-};
-
-export { createFlags, resetFlags };

package/dist/packem_shared/defineFlags-DAIO8cWQ.mjs

@@ -1,15 +0,0 @@
-const defineFlags = (config) => {
-  if (typeof config.provider !== "function") {
-    throw new TypeError('defineFlags: `provider` must be a function `(env) => Provider` (e.g. flagshipProvider({ binding: "FLAGS" }))');
-  }
-  if (config.identify !== void 0 && typeof config.identify !== "function") {
-    throw new TypeError("defineFlags: `identify` must be a function `(auth) => string | undefined` when provided");
-  }
-  if (config.hooks !== void 0 && !Array.isArray(config.hooks)) {
-    throw new TypeError("defineFlags: `hooks` must be an array of OpenFeature hooks when provided");
-  }
-  return { ...config, isLunoraFlags: true };
-};
-const isFlagsDefinition = (value) => typeof value === "object" && value !== null && value.isLunoraFlags === true;
-
-export { defineFlags, isFlagsDefinition };