@smooai/config 2.1.4 → 2.1.5

package/dist/feature-flags/index.d.mts

@@ -0,0 +1,59 @@
+/**
+ * Client-safe feature flag utilities.
+ *
+ * These functions read feature flags from build-time environment variables
+ * (NEXT_PUBLIC_FEATURE_FLAG_* or VITE_FEATURE_FLAG_*) and can be used
+ * in both server and client components.
+ *
+ * @example
+ * ```tsx
+ * // In your .smooai-config/config.ts:
+ * const config = defineConfig({
+ *     featureFlagSchema: {
+ *         aboutPage: BooleanSchema,
+ *         contactPage: BooleanSchema,
+ *     },
+ * });
+ *
+ * // In your next.config.js, inject flags as env vars:
+ * // NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE=true
+ *
+ * // In any component (server or client):
+ * import { getClientFeatureFlag } from '@smooai/config/feature-flags';
+ *
+ * if (getClientFeatureFlag('aboutPage')) {
+ *     // show the feature
+ * }
+ * ```
+ */
+/**
+ * Get a feature flag value from build-time environment variables.
+ *
+ * Checks for:
+ * 1. NEXT_PUBLIC_FEATURE_FLAG_{KEY} (Next.js)
+ * 2. VITE_FEATURE_FLAG_{KEY} (Vite)
+ *
+ * The key is converted from camelCase to UPPER_SNAKE_CASE.
+ * e.g., "aboutPage" checks NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE
+ *
+ * @param key - The camelCase feature flag key
+ * @returns true if the flag is explicitly set to "true", false otherwise
+ */
+declare function getClientFeatureFlag(key: string): boolean;
+/**
+ * Create a typed feature flag checker from a config's FeatureFlagKeys.
+ *
+ * @example
+ * ```tsx
+ * import config, { FeatureFlagKeys } from '../.smooai-config/config';
+ * import { createFeatureFlagChecker } from '@smooai/config/feature-flags';
+ *
+ * export const getFeatureFlag = createFeatureFlagChecker<typeof FeatureFlagKeys>();
+ *
+ * // Usage:
+ * getFeatureFlag('aboutPage') // typed to valid keys
+ * ```
+ */
+declare function createFeatureFlagChecker<T extends Record<string, string>>(): (key: T[keyof T]) => boolean;
+
+export { createFeatureFlagChecker, getClientFeatureFlag };

package/dist/feature-flags/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Client-safe feature flag utilities.
+ *
+ * These functions read feature flags from build-time environment variables
+ * (NEXT_PUBLIC_FEATURE_FLAG_* or VITE_FEATURE_FLAG_*) and can be used
+ * in both server and client components.
+ *
+ * @example
+ * ```tsx
+ * // In your .smooai-config/config.ts:
+ * const config = defineConfig({
+ *     featureFlagSchema: {
+ *         aboutPage: BooleanSchema,
+ *         contactPage: BooleanSchema,
+ *     },
+ * });
+ *
+ * // In your next.config.js, inject flags as env vars:
+ * // NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE=true
+ *
+ * // In any component (server or client):
+ * import { getClientFeatureFlag } from '@smooai/config/feature-flags';
+ *
+ * if (getClientFeatureFlag('aboutPage')) {
+ *     // show the feature
+ * }
+ * ```
+ */
+/**
+ * Get a feature flag value from build-time environment variables.
+ *
+ * Checks for:
+ * 1. NEXT_PUBLIC_FEATURE_FLAG_{KEY} (Next.js)
+ * 2. VITE_FEATURE_FLAG_{KEY} (Vite)
+ *
+ * The key is converted from camelCase to UPPER_SNAKE_CASE.
+ * e.g., "aboutPage" checks NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE
+ *
+ * @param key - The camelCase feature flag key
+ * @returns true if the flag is explicitly set to "true", false otherwise
+ */
+declare function getClientFeatureFlag(key: string): boolean;
+/**
+ * Create a typed feature flag checker from a config's FeatureFlagKeys.
+ *
+ * @example
+ * ```tsx
+ * import config, { FeatureFlagKeys } from '../.smooai-config/config';
+ * import { createFeatureFlagChecker } from '@smooai/config/feature-flags';
+ *
+ * export const getFeatureFlag = createFeatureFlagChecker<typeof FeatureFlagKeys>();
+ *
+ * // Usage:
+ * getFeatureFlag('aboutPage') // typed to valid keys
+ * ```
+ */
+declare function createFeatureFlagChecker<T extends Record<string, string>>(): (key: T[keyof T]) => boolean;
+
+export { createFeatureFlagChecker, getClientFeatureFlag };

package/dist/feature-flags/index.js

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/feature-flags/index.ts
+var feature_flags_exports = {};
+__export(feature_flags_exports, {
+  createFeatureFlagChecker: () => createFeatureFlagChecker,
+  getClientFeatureFlag: () => getClientFeatureFlag
+});
+module.exports = __toCommonJS(feature_flags_exports);
+function toUpperSnakeCase(key) {
+  return key.replace(/([A-Z])/g, "_$1").toUpperCase();
+}
+function getClientFeatureFlag(key) {
+  const envKey = toUpperSnakeCase(key);
+  const nextValue = typeof process !== "undefined" ? process.env?.[`NEXT_PUBLIC_FEATURE_FLAG_${envKey}`] : void 0;
+  if (nextValue !== void 0) {
+    return nextValue === "true" || nextValue === "1";
+  }
+  try {
+    const viteEnv = globalThis.__VITE_ENV__;
+    const viteValue = viteEnv?.[`VITE_FEATURE_FLAG_${envKey}`];
+    if (viteValue !== void 0) {
+      return viteValue === "true" || viteValue === "1";
+    }
+  } catch {
+  }
+  return false;
+}
+function createFeatureFlagChecker() {
+  return (key) => getClientFeatureFlag(key);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createFeatureFlagChecker,
+  getClientFeatureFlag
+});
+//# sourceMappingURL=index.js.map

package/dist/feature-flags/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/feature-flags/index.ts"],"sourcesContent":["/**\n * Client-safe feature flag utilities.\n *\n * These functions read feature flags from build-time environment variables\n * (NEXT_PUBLIC_FEATURE_FLAG_* or VITE_FEATURE_FLAG_*) and can be used\n * in both server and client components.\n *\n * @example\n * ```tsx\n * // In your .smooai-config/config.ts:\n * const config = defineConfig({\n *     featureFlagSchema: {\n *         aboutPage: BooleanSchema,\n *         contactPage: BooleanSchema,\n *     },\n * });\n *\n * // In your next.config.js, inject flags as env vars:\n * // NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE=true\n *\n * // In any component (server or client):\n * import { getClientFeatureFlag } from '@smooai/config/feature-flags';\n *\n * if (getClientFeatureFlag('aboutPage')) {\n *     // show the feature\n * }\n * ```\n */\n\n/**\n * Convert a camelCase feature flag key to UPPER_SNAKE_CASE.\n * e.g., \"aboutPage\" → \"ABOUT_PAGE\"\n */\nfunction toUpperSnakeCase(key: string): string {\n    return key.replace(/([A-Z])/g, '_$1').toUpperCase();\n}\n\n/**\n * Get a feature flag value from build-time environment variables.\n *\n * Checks for:\n * 1. NEXT_PUBLIC_FEATURE_FLAG_{KEY} (Next.js)\n * 2. VITE_FEATURE_FLAG_{KEY} (Vite)\n *\n * The key is converted from camelCase to UPPER_SNAKE_CASE.\n * e.g., \"aboutPage\" checks NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE\n *\n * @param key - The camelCase feature flag key\n * @returns true if the flag is explicitly set to \"true\", false otherwise\n */\nexport function getClientFeatureFlag(key: string): boolean {\n    const envKey = toUpperSnakeCase(key);\n\n    // Check Next.js env var\n    const nextValue = typeof process !== 'undefined' ? process.env?.[`NEXT_PUBLIC_FEATURE_FLAG_${envKey}`] : undefined;\n    if (nextValue !== undefined) {\n        return nextValue === 'true' || nextValue === '1';\n    }\n\n    // Check Vite env var (available via import.meta.env in Vite)\n    // At build time, Vite replaces import.meta.env.VITE_* with literal values\n    // We use a dynamic approach for runtime compatibility\n    try {\n        const viteEnv = (globalThis as Record<string, unknown>).__VITE_ENV__ as Record<string, string> | undefined;\n        const viteValue = viteEnv?.[`VITE_FEATURE_FLAG_${envKey}`];\n        if (viteValue !== undefined) {\n            return viteValue === 'true' || viteValue === '1';\n        }\n    } catch {\n        // Vite env not available\n    }\n\n    return false;\n}\n\n/**\n * Create a typed feature flag checker from a config's FeatureFlagKeys.\n *\n * @example\n * ```tsx\n * import config, { FeatureFlagKeys } from '../.smooai-config/config';\n * import { createFeatureFlagChecker } from '@smooai/config/feature-flags';\n *\n * export const getFeatureFlag = createFeatureFlagChecker<typeof FeatureFlagKeys>();\n *\n * // Usage:\n * getFeatureFlag('aboutPage') // typed to valid keys\n * ```\n */\nexport function createFeatureFlagChecker<T extends Record<string, string>>(): (key: T[keyof T]) => boolean {\n    return (key: T[keyof T]) => getClientFeatureFlag(key as string);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiCA,SAAS,iBAAiB,KAAqB;AAC3C,SAAO,IAAI,QAAQ,YAAY,KAAK,EAAE,YAAY;AACtD;AAeO,SAAS,qBAAqB,KAAsB;AACvD,QAAM,SAAS,iBAAiB,GAAG;AAGnC,QAAM,YAAY,OAAO,YAAY,cAAc,QAAQ,MAAM,4BAA4B,MAAM,EAAE,IAAI;AACzG,MAAI,cAAc,QAAW;AACzB,WAAO,cAAc,UAAU,cAAc;AAAA,EACjD;AAKA,MAAI;AACA,UAAM,UAAW,WAAuC;AACxD,UAAM,YAAY,UAAU,qBAAqB,MAAM,EAAE;AACzD,QAAI,cAAc,QAAW;AACzB,aAAO,cAAc,UAAU,cAAc;AAAA,IACjD;AAAA,EACJ,QAAQ;AAAA,EAER;AAEA,SAAO;AACX;AAgBO,SAAS,2BAA2F;AACvG,SAAO,CAAC,QAAoB,qBAAqB,GAAa;AAClE;","names":[]}

package/dist/feature-flags/index.mjs

@@ -0,0 +1,30 @@
+import "../chunk-J5LGTIGS.mjs";
+
+// src/feature-flags/index.ts
+function toUpperSnakeCase(key) {
+  return key.replace(/([A-Z])/g, "_$1").toUpperCase();
+}
+function getClientFeatureFlag(key) {
+  const envKey = toUpperSnakeCase(key);
+  const nextValue = typeof process !== "undefined" ? process.env?.[`NEXT_PUBLIC_FEATURE_FLAG_${envKey}`] : void 0;
+  if (nextValue !== void 0) {
+    return nextValue === "true" || nextValue === "1";
+  }
+  try {
+    const viteEnv = globalThis.__VITE_ENV__;
+    const viteValue = viteEnv?.[`VITE_FEATURE_FLAG_${envKey}`];
+    if (viteValue !== void 0) {
+      return viteValue === "true" || viteValue === "1";
+    }
+  } catch {
+  }
+  return false;
+}
+function createFeatureFlagChecker() {
+  return (key) => getClientFeatureFlag(key);
+}
+export {
+  createFeatureFlagChecker,
+  getClientFeatureFlag
+};
+//# sourceMappingURL=index.mjs.map

package/dist/feature-flags/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/feature-flags/index.ts"],"sourcesContent":["/**\n * Client-safe feature flag utilities.\n *\n * These functions read feature flags from build-time environment variables\n * (NEXT_PUBLIC_FEATURE_FLAG_* or VITE_FEATURE_FLAG_*) and can be used\n * in both server and client components.\n *\n * @example\n * ```tsx\n * // In your .smooai-config/config.ts:\n * const config = defineConfig({\n *     featureFlagSchema: {\n *         aboutPage: BooleanSchema,\n *         contactPage: BooleanSchema,\n *     },\n * });\n *\n * // In your next.config.js, inject flags as env vars:\n * // NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE=true\n *\n * // In any component (server or client):\n * import { getClientFeatureFlag } from '@smooai/config/feature-flags';\n *\n * if (getClientFeatureFlag('aboutPage')) {\n *     // show the feature\n * }\n * ```\n */\n\n/**\n * Convert a camelCase feature flag key to UPPER_SNAKE_CASE.\n * e.g., \"aboutPage\" → \"ABOUT_PAGE\"\n */\nfunction toUpperSnakeCase(key: string): string {\n    return key.replace(/([A-Z])/g, '_$1').toUpperCase();\n}\n\n/**\n * Get a feature flag value from build-time environment variables.\n *\n * Checks for:\n * 1. NEXT_PUBLIC_FEATURE_FLAG_{KEY} (Next.js)\n * 2. VITE_FEATURE_FLAG_{KEY} (Vite)\n *\n * The key is converted from camelCase to UPPER_SNAKE_CASE.\n * e.g., \"aboutPage\" checks NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE\n *\n * @param key - The camelCase feature flag key\n * @returns true if the flag is explicitly set to \"true\", false otherwise\n */\nexport function getClientFeatureFlag(key: string): boolean {\n    const envKey = toUpperSnakeCase(key);\n\n    // Check Next.js env var\n    const nextValue = typeof process !== 'undefined' ? process.env?.[`NEXT_PUBLIC_FEATURE_FLAG_${envKey}`] : undefined;\n    if (nextValue !== undefined) {\n        return nextValue === 'true' || nextValue === '1';\n    }\n\n    // Check Vite env var (available via import.meta.env in Vite)\n    // At build time, Vite replaces import.meta.env.VITE_* with literal values\n    // We use a dynamic approach for runtime compatibility\n    try {\n        const viteEnv = (globalThis as Record<string, unknown>).__VITE_ENV__ as Record<string, string> | undefined;\n        const viteValue = viteEnv?.[`VITE_FEATURE_FLAG_${envKey}`];\n        if (viteValue !== undefined) {\n            return viteValue === 'true' || viteValue === '1';\n        }\n    } catch {\n        // Vite env not available\n    }\n\n    return false;\n}\n\n/**\n * Create a typed feature flag checker from a config's FeatureFlagKeys.\n *\n * @example\n * ```tsx\n * import config, { FeatureFlagKeys } from '../.smooai-config/config';\n * import { createFeatureFlagChecker } from '@smooai/config/feature-flags';\n *\n * export const getFeatureFlag = createFeatureFlagChecker<typeof FeatureFlagKeys>();\n *\n * // Usage:\n * getFeatureFlag('aboutPage') // typed to valid keys\n * ```\n */\nexport function createFeatureFlagChecker<T extends Record<string, string>>(): (key: T[keyof T]) => boolean {\n    return (key: T[keyof T]) => getClientFeatureFlag(key as string);\n}\n"],"mappings":";;;AAiCA,SAAS,iBAAiB,KAAqB;AAC3C,SAAO,IAAI,QAAQ,YAAY,KAAK,EAAE,YAAY;AACtD;AAeO,SAAS,qBAAqB,KAAsB;AACvD,QAAM,SAAS,iBAAiB,GAAG;AAGnC,QAAM,YAAY,OAAO,YAAY,cAAc,QAAQ,MAAM,4BAA4B,MAAM,EAAE,IAAI;AACzG,MAAI,cAAc,QAAW;AACzB,WAAO,cAAc,UAAU,cAAc;AAAA,EACjD;AAKA,MAAI;AACA,UAAM,UAAW,WAAuC;AACxD,UAAM,YAAY,UAAU,qBAAqB,MAAM,EAAE;AACzD,QAAI,cAAc,QAAW;AACzB,aAAO,cAAc,UAAU,cAAc;AAAA,IACjD;AAAA,EACJ,QAAQ;AAAA,EAER;AAEA,SAAO;AACX;AAgBO,SAAS,2BAA2F;AACvG,SAAO,CAAC,QAAoB,qBAAqB,GAAa;AAClE;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smooai/config",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "description": "Type-safe multi-language configuration management with schema validation, three-tier config (public, secret, feature flags), and runtime client support for TypeScript, Python, Rust, and Go.",
   "homepage": "https://github.com/SmooAI/config#readme",
   "bugs": {
@@ -47,6 +47,11 @@
       "import": "./dist/nextjs/getConfig.mjs",
       "require": "./dist/nextjs/getConfig.js"
     },
+    "./feature-flags": {
+      "types": "./dist/feature-flags/index.d.ts",
+      "import": "./dist/feature-flags/index.mjs",
+      "require": "./dist/feature-flags/index.js"
+    },
     "./react": {
       "types": "./dist/react/index.d.ts",
       "import": "./dist/react/index.mjs",