@philiprehberger/ts-feature-flag 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 philiprehberger
+
+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/README.md

@@ -0,0 +1,44 @@
+# @philiprehberger/feature-flag
+
+Simple in-memory feature flag system with percentage rollouts and targeting.
+
+## Installation
+
+```bash
+npm install @philiprehberger/feature-flag
+```
+
+## Usage
+
+```ts
+import { createFlags } from '@philiprehberger/feature-flag';
+
+const flags = createFlags({
+  newCheckout: true,
+  darkMode: { percentage: 50 },
+  betaFeature: { enabled: (ctx) => ctx.role === 'beta' },
+});
+
+flags.enabled('newCheckout');                     // true
+flags.enabled('darkMode', { userId: 'abc' });     // deterministic by userId
+flags.enabled('betaFeature', { role: 'beta' });   // true
+flags.enabled('betaFeature', { role: 'user' });   // false
+```
+
+## API
+
+| Export | Description |
+|--------|-------------|
+| `createFlags(definitions)` | Create a flags instance |
+
+### Flag Types
+
+| Type | Example | Description |
+|------|---------|-------------|
+| Boolean | `true` / `false` | Static on/off |
+| Percentage | `{ percentage: 50 }` | Deterministic rollout by userId hash |
+| Function | `{ enabled: (ctx) => ... }` | Custom targeting logic |
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+// src/flags.ts
+function hashString(str) {
+  let hash = 0;
+  for (let i = 0; i < str.length; i++) {
+    hash = (hash << 5) - hash + str.charCodeAt(i) | 0;
+  }
+  return Math.abs(hash);
+}
+function createFlags(definitions) {
+  return {
+    enabled(name, context) {
+      const flag = definitions[name];
+      if (flag === void 0) return false;
+      if (typeof flag === "boolean") return flag;
+      const def = flag;
+      if ("percentage" in def) {
+        const seed = (context == null ? void 0 : context.userId) ? String(context.userId) : (context == null ? void 0 : context.id) ? String(context.id) : String(Math.random());
+        const hash = hashString(`${String(name)}:${seed}`);
+        return hash % 100 < def.percentage;
+      }
+      if ("enabled" in def) {
+        return def.enabled(context != null ? context : {});
+      }
+      return false;
+    }
+  };
+}
+
+exports.createFlags = createFlags;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/flags.ts"],"names":[],"mappings":";;;AAEA,SAAS,WAAW,GAAA,EAAqB;AACvC,EAAA,IAAI,IAAA,GAAO,CAAA;AACX,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,QAAQ,CAAA,EAAA,EAAK;AACnC,IAAA,IAAA,GAAA,CAAS,QAAQ,CAAA,IAAK,IAAA,GAAO,GAAA,CAAI,UAAA,CAAW,CAAC,CAAA,GAAK,CAAA;AAAA,EACpD;AACA,EAAA,OAAO,IAAA,CAAK,IAAI,IAAI,CAAA;AACtB;AAEO,SAAS,YAAuC,WAAA,EAA0B;AAC/E,EAAA,OAAO;AAAA,IACL,OAAA,CAAQ,MAAe,OAAA,EAAgC;AACrD,MAAA,MAAM,IAAA,GAAO,YAAY,IAAI,CAAA;AAC7B,MAAA,IAAI,IAAA,KAAS,QAAW,OAAO,KAAA;AAE/B,MAAA,IAAI,OAAO,IAAA,KAAS,SAAA,EAAW,OAAO,IAAA;AAEtC,MAAA,MAAM,GAAA,GAAM,IAAA;AAEZ,MAAA,IAAI,gBAAgB,GAAA,EAAK;AACvB,QAAA,MAAM,QAAO,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAS,MAAA,IAClB,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,GAAA,CACrB,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAS,EAAA,IACP,MAAA,CAAO,QAAQ,EAAE,CAAA,GACjB,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA;AAC1B,QAAA,MAAM,IAAA,GAAO,WAAW,CAAA,EAAG,MAAA,CAAO,IAAI,CAAC,CAAA,CAAA,EAAI,IAAI,CAAA,CAAE,CAAA;AACjD,QAAA,OAAQ,IAAA,GAAO,MAAO,GAAA,CAAI,UAAA;AAAA,MAC5B;AAEA,MAAA,IAAI,aAAa,GAAA,EAAK;AACpB,QAAA,OAAO,GAAA,CAAI,OAAA,CAAQ,OAAA,IAAA,IAAA,GAAA,OAAA,GAAW,EAAE,CAAA;AAAA,MAClC;AAEA,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["import type { FlagDefinitions, FlagContext, Flags } from './types.js';\n\nfunction hashString(str: string): number {\n  let hash = 0;\n  for (let i = 0; i < str.length; i++) {\n    hash = ((hash << 5) - hash + str.charCodeAt(i)) | 0;\n  }\n  return Math.abs(hash);\n}\n\nexport function createFlags<T extends FlagDefinitions>(definitions: T): Flags<T> {\n  return {\n    enabled(name: keyof T, context?: FlagContext): boolean {\n      const flag = definitions[name];\n      if (flag === undefined) return false;\n\n      if (typeof flag === 'boolean') return flag;\n\n      const def = flag as { percentage: number } | { enabled: (context: FlagContext) => boolean };\n\n      if ('percentage' in def) {\n        const seed = context?.userId\n          ? String(context.userId)\n          : context?.id\n            ? String(context.id)\n            : String(Math.random());\n        const hash = hashString(`${String(name)}:${seed}`);\n        return (hash % 100) < def.percentage;\n      }\n\n      if ('enabled' in def) {\n        return def.enabled(context ?? {});\n      }\n\n      return false;\n    },\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,14 @@
+type FlagContext = Record<string, unknown>;
+type FlagDefinition = boolean | {
+    percentage: number;
+} | {
+    enabled: (context: FlagContext) => boolean;
+};
+type FlagDefinitions = Record<string, FlagDefinition>;
+interface Flags<T extends FlagDefinitions> {
+    enabled(name: keyof T, context?: FlagContext): boolean;
+}
+
+declare function createFlags<T extends FlagDefinitions>(definitions: T): Flags<T>;
+
+export { type FlagContext, type FlagDefinition, type FlagDefinitions, type Flags, createFlags };

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+type FlagContext = Record<string, unknown>;
+type FlagDefinition = boolean | {
+    percentage: number;
+} | {
+    enabled: (context: FlagContext) => boolean;
+};
+type FlagDefinitions = Record<string, FlagDefinition>;
+interface Flags<T extends FlagDefinitions> {
+    enabled(name: keyof T, context?: FlagContext): boolean;
+}
+
+declare function createFlags<T extends FlagDefinitions>(definitions: T): Flags<T>;
+
+export { type FlagContext, type FlagDefinition, type FlagDefinitions, type Flags, createFlags };

package/dist/index.js

@@ -0,0 +1,31 @@
+// src/flags.ts
+function hashString(str) {
+  let hash = 0;
+  for (let i = 0; i < str.length; i++) {
+    hash = (hash << 5) - hash + str.charCodeAt(i) | 0;
+  }
+  return Math.abs(hash);
+}
+function createFlags(definitions) {
+  return {
+    enabled(name, context) {
+      const flag = definitions[name];
+      if (flag === void 0) return false;
+      if (typeof flag === "boolean") return flag;
+      const def = flag;
+      if ("percentage" in def) {
+        const seed = (context == null ? void 0 : context.userId) ? String(context.userId) : (context == null ? void 0 : context.id) ? String(context.id) : String(Math.random());
+        const hash = hashString(`${String(name)}:${seed}`);
+        return hash % 100 < def.percentage;
+      }
+      if ("enabled" in def) {
+        return def.enabled(context != null ? context : {});
+      }
+      return false;
+    }
+  };
+}
+
+export { createFlags };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/flags.ts"],"names":[],"mappings":";AAEA,SAAS,WAAW,GAAA,EAAqB;AACvC,EAAA,IAAI,IAAA,GAAO,CAAA;AACX,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,QAAQ,CAAA,EAAA,EAAK;AACnC,IAAA,IAAA,GAAA,CAAS,QAAQ,CAAA,IAAK,IAAA,GAAO,GAAA,CAAI,UAAA,CAAW,CAAC,CAAA,GAAK,CAAA;AAAA,EACpD;AACA,EAAA,OAAO,IAAA,CAAK,IAAI,IAAI,CAAA;AACtB;AAEO,SAAS,YAAuC,WAAA,EAA0B;AAC/E,EAAA,OAAO;AAAA,IACL,OAAA,CAAQ,MAAe,OAAA,EAAgC;AACrD,MAAA,MAAM,IAAA,GAAO,YAAY,IAAI,CAAA;AAC7B,MAAA,IAAI,IAAA,KAAS,QAAW,OAAO,KAAA;AAE/B,MAAA,IAAI,OAAO,IAAA,KAAS,SAAA,EAAW,OAAO,IAAA;AAEtC,MAAA,MAAM,GAAA,GAAM,IAAA;AAEZ,MAAA,IAAI,gBAAgB,GAAA,EAAK;AACvB,QAAA,MAAM,QAAO,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAS,MAAA,IAClB,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,GAAA,CACrB,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAS,EAAA,IACP,MAAA,CAAO,QAAQ,EAAE,CAAA,GACjB,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA;AAC1B,QAAA,MAAM,IAAA,GAAO,WAAW,CAAA,EAAG,MAAA,CAAO,IAAI,CAAC,CAAA,CAAA,EAAI,IAAI,CAAA,CAAE,CAAA;AACjD,QAAA,OAAQ,IAAA,GAAO,MAAO,GAAA,CAAI,UAAA;AAAA,MAC5B;AAEA,MAAA,IAAI,aAAa,GAAA,EAAK;AACpB,QAAA,OAAO,GAAA,CAAI,OAAA,CAAQ,OAAA,IAAA,IAAA,GAAA,OAAA,GAAW,EAAE,CAAA;AAAA,MAClC;AAEA,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import type { FlagDefinitions, FlagContext, Flags } from './types.js';\n\nfunction hashString(str: string): number {\n  let hash = 0;\n  for (let i = 0; i < str.length; i++) {\n    hash = ((hash << 5) - hash + str.charCodeAt(i)) | 0;\n  }\n  return Math.abs(hash);\n}\n\nexport function createFlags<T extends FlagDefinitions>(definitions: T): Flags<T> {\n  return {\n    enabled(name: keyof T, context?: FlagContext): boolean {\n      const flag = definitions[name];\n      if (flag === undefined) return false;\n\n      if (typeof flag === 'boolean') return flag;\n\n      const def = flag as { percentage: number } | { enabled: (context: FlagContext) => boolean };\n\n      if ('percentage' in def) {\n        const seed = context?.userId\n          ? String(context.userId)\n          : context?.id\n            ? String(context.id)\n            : String(Math.random());\n        const hash = hashString(`${String(name)}:${seed}`);\n        return (hash % 100) < def.percentage;\n      }\n\n      if ('enabled' in def) {\n        return def.enabled(context ?? {});\n      }\n\n      return false;\n    },\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@philiprehberger/ts-feature-flag",
+  "version": "0.1.1",
+  "description": "Simple in-memory feature flag system with percentage rollouts and targeting",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "feature-flag",
+    "toggle",
+    "rollout",
+    "targeting",
+    "feature-toggle"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/philiprehberger/ts-feature-flag.git"
+  },
+  "homepage": "https://github.com/philiprehberger/ts-feature-flag#readme",
+  "bugs": {
+    "url": "https://github.com/philiprehberger/ts-feature-flag/issues"
+  },
+  "author": "Philip Rehberger",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "sideEffects": false
+}