@berachain/edge-config-helpers 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Berachain Foundation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }function s(n){return n.missingContext==="closed"?!1:n.defaultReturn}function f(n){if(!_optionalChain([n, 'access', _ => _.flag, 'access', _2 => _2.chain, 'optionalAccess', _3 => _3.length]))return n.gate.defaultReturn;let t=_optionalChain([n, 'access', _4 => _4.chains, 'access', _5 => _5.find, 'call', _6 => _6(i=>i.id===n.chainId), 'optionalAccess', _7 => _7.name]);return t?n.flag.chain.includes(t):s(n.gate)}function T(n){if(!_optionalChain([n, 'access', _8 => _8.flag, 'access', _9 => _9.branch, 'optionalAccess', _10 => _10.length]))return n.gate.defaultReturn;if(!n.environment)return s(n.gate);let t=n.environment==="development"?"preview":n.environment;return n.flag.branch.includes(t)}function x(n){return _optionalChain([n, 'access', _11 => _11.flag, 'access', _12 => _12.app, 'optionalAccess', _13 => _13.length])?n.app?n.flag.app.includes(n.app):s(n.gate):n.gate.defaultReturn}function h(n){let t=n.flag[n.key];return t?n.key==="startAt"?new Date(t)<=new Date:new Date(t)>=new Date:n.defaultReturn}function C(n){let t=_nullishCoalesce(n.missingContext, () => ("open"));function i(e){return _optionalChain([n, 'access', _14 => _14.chains, 'access', _15 => _15.find, 'call', _16 => _16(a=>a.id===e), 'optionalAccess', _17 => _17.name])}function p(e){return e==="production"}function u(e,a){if(!e)return!1;if(typeof e=="boolean")return e;let r={defaultReturn:e.condition!=="OR",missingContext:t},o=f({flag:e,chainId:a.chainId,chains:n.chains,gate:r}),d=T({flag:e,environment:a.environment,gate:r}),c=x({flag:e,app:a.app,gate:r}),g=h({flag:e,key:"startAt",defaultReturn:r.defaultReturn}),l=h({flag:e,key:"endAt",defaultReturn:r.defaultReturn});return e.condition==="OR"?o||d||c||g||l:o&&d&&c&&g&&l}return{chainName:i,isProduction:p,isFlagEnabled:u}}exports.createEdgeHelpers = C;

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+export type ChainTarget<TName extends string = string> = {
+    readonly id: number;
+    readonly name: TName;
+};
+export type FlagBranch = "production" | "staging" | "preview";
+/**
+ * Structural flag value. Each deployment's generated schema should be
+ * assignable to this.
+ */
+export type DynamicEnabled<TChain extends string = string, TApp extends string = string> = boolean | {
+    chain?: readonly TChain[];
+    branch?: readonly FlagBranch[];
+    app?: readonly TApp[];
+    startAt?: string;
+    endAt?: string;
+    condition?: "AND" | "OR";
+};
+export type EdgeContext<TApp extends string = string> = {
+    chainId: number;
+    environment?: string;
+    app?: TApp;
+};
+/**
+ * What to do when a criterion is set but the current value is missing.
+ *
+ * - `open` — historical monobera behavior: a missing value does not fail an
+ *   AND gate (and does not satisfy an OR gate).
+ * - `closed` — a configured gate with no current value does not match.
+ */
+export type MissingContext = "open" | "closed";
+/**
+ * Pure edge-config evaluation. Does not read `process.env`.
+ *
+ * Call once per deployment with that deployment's chain ids and names.
+ * Pass the current chain, environment, and app on every `isFlagEnabled` call.
+ */
+export declare function createEdgeHelpers<const TChain extends string, const TApp extends string = string>(config: {
+    chains: readonly ChainTarget<TChain>[];
+    missingContext?: MissingContext;
+}): {
+    chainName: (chainId: number) => TChain | undefined;
+    isProduction: (environment: string | undefined) => boolean;
+    isFlagEnabled: (flag: DynamicEnabled<TChain, TApp> | null | undefined, current: EdgeContext<TApp>) => boolean;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9D;;;GAGG;AACH,MAAM,MAAM,cAAc,CACxB,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,IAAI,SAAS,MAAM,GAAG,MAAM,IAE1B,OAAO,GACP;IACE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,GAAG,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEN,MAAM,MAAM,WAAW,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,IAAI;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,CAAC;AAqF/C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,MAAM,SAAS,MAAM,EAC3B,KAAK,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EAClC,MAAM,EAAE;IACR,MAAM,EAAE,SAAS,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;IACvC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;yBAG6B,MAAM,KAAG,MAAM,GAAG,SAAS;gCAIpB,MAAM,GAAG,SAAS,KAAG,OAAO;0BAKvD,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,WAC5C,WAAW,CAAC,IAAI,CAAC,KACzB,OAAO;EA+CX"}

package/dist/index.mjs

@@ -0,0 +1 @@
+function s(n){return n.missingContext==="closed"?!1:n.defaultReturn}function f(n){if(!n.flag.chain?.length)return n.gate.defaultReturn;let t=n.chains.find(i=>i.id===n.chainId)?.name;return t?n.flag.chain.includes(t):s(n.gate)}function T(n){if(!n.flag.branch?.length)return n.gate.defaultReturn;if(!n.environment)return s(n.gate);let t=n.environment==="development"?"preview":n.environment;return n.flag.branch.includes(t)}function x(n){return n.flag.app?.length?n.app?n.flag.app.includes(n.app):s(n.gate):n.gate.defaultReturn}function h(n){let t=n.flag[n.key];return t?n.key==="startAt"?new Date(t)<=new Date:new Date(t)>=new Date:n.defaultReturn}function C(n){let t=n.missingContext??"open";function i(e){return n.chains.find(a=>a.id===e)?.name}function p(e){return e==="production"}function u(e,a){if(!e)return!1;if(typeof e=="boolean")return e;let r={defaultReturn:e.condition!=="OR",missingContext:t},o=f({flag:e,chainId:a.chainId,chains:n.chains,gate:r}),d=T({flag:e,environment:a.environment,gate:r}),c=x({flag:e,app:a.app,gate:r}),g=h({flag:e,key:"startAt",defaultReturn:r.defaultReturn}),l=h({flag:e,key:"endAt",defaultReturn:r.defaultReturn});return e.condition==="OR"?o||d||c||g||l:o&&d&&c&&g&&l}return{chainName:i,isProduction:p,isFlagEnabled:u}}export{C as createEdgeHelpers};

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@berachain/edge-config-helpers",
+  "version": "0.1.0",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "author": "Berachain",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "24.1.0",
+    "tsup": "8.5.1",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "3.2.6",
+    "@berachain/utils": "^0.1.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup -- --cjs --esm",
+    "clean": "git clean -xdf dist .turbo node_modules",
+    "dev": "tsup --watch",
+    "check-types": "node ../../.scripts/commands.mjs check-types:dts",
+    "test": "vitest run --root ../.. --project edge-config-helpers"
+  }
+}