@smooai/config 3.0.0 → 3.0.1

package/dist/nextjs/withFeatureFlags.d.mts

@@ -0,0 +1,50 @@
+/**
+ * Next.js config helper that injects feature flags as NEXT_PUBLIC_ environment variables.
+ *
+ * This allows client components to read feature flags via `getClientFeatureFlag()`
+ * from `@smooai/config/feature-flags` without importing any Node.js-dependent code.
+ *
+ * @example
+ * ```ts
+ * // next.config.ts
+ * import { withFeatureFlags } from '@smooai/config/nextjs/withFeatureFlags';
+ * import defaultConfig from './.smooai-config/default';
+ * import developmentConfig from './.smooai-config/development';
+ *
+ * const nextConfig = withFeatureFlags({
+ *     default: defaultConfig,
+ *     development: developmentConfig,
+ * });
+ *
+ * export default nextConfig;
+ * ```
+ *
+ * This will set environment variables like:
+ * - NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE=true (in development)
+ * - NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE=false (in production)
+ *
+ * Then in any client component:
+ * ```tsx
+ * import { getClientFeatureFlag } from '@smooai/config/feature-flags';
+ * const isEnabled = getClientFeatureFlag('aboutPage');
+ * ```
+ */
+type NextConfig = Record<string, unknown>;
+type FeatureFlagConfig = Record<string, boolean>;
+interface WithFeatureFlagsOptions {
+    /** Default feature flag values (used in production). */
+    default: FeatureFlagConfig;
+    /** Development overrides (merged with default). */
+    development?: FeatureFlagConfig;
+    /** Additional stage-specific overrides. Key is the stage name. */
+    [stage: string]: FeatureFlagConfig | undefined;
+}
+/**
+ * Wraps a Next.js config to inject feature flags as NEXT_PUBLIC_ environment variables.
+ *
+ * Reads `NEXT_PUBLIC_SST_STAGE` (or `NODE_ENV`) to determine which config to use.
+ * Falls back to development config if stage is not 'production'.
+ */
+declare function withFeatureFlags(flagConfigs: WithFeatureFlagsOptions, nextConfig?: NextConfig): NextConfig;
+
+export { withFeatureFlags };

package/dist/nextjs/withFeatureFlags.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Next.js config helper that injects feature flags as NEXT_PUBLIC_ environment variables.
+ *
+ * This allows client components to read feature flags via `getClientFeatureFlag()`
+ * from `@smooai/config/feature-flags` without importing any Node.js-dependent code.
+ *
+ * @example
+ * ```ts
+ * // next.config.ts
+ * import { withFeatureFlags } from '@smooai/config/nextjs/withFeatureFlags';
+ * import defaultConfig from './.smooai-config/default';
+ * import developmentConfig from './.smooai-config/development';
+ *
+ * const nextConfig = withFeatureFlags({
+ *     default: defaultConfig,
+ *     development: developmentConfig,
+ * });
+ *
+ * export default nextConfig;
+ * ```
+ *
+ * This will set environment variables like:
+ * - NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE=true (in development)
+ * - NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE=false (in production)
+ *
+ * Then in any client component:
+ * ```tsx
+ * import { getClientFeatureFlag } from '@smooai/config/feature-flags';
+ * const isEnabled = getClientFeatureFlag('aboutPage');
+ * ```
+ */
+type NextConfig = Record<string, unknown>;
+type FeatureFlagConfig = Record<string, boolean>;
+interface WithFeatureFlagsOptions {
+    /** Default feature flag values (used in production). */
+    default: FeatureFlagConfig;
+    /** Development overrides (merged with default). */
+    development?: FeatureFlagConfig;
+    /** Additional stage-specific overrides. Key is the stage name. */
+    [stage: string]: FeatureFlagConfig | undefined;
+}
+/**
+ * Wraps a Next.js config to inject feature flags as NEXT_PUBLIC_ environment variables.
+ *
+ * Reads `NEXT_PUBLIC_SST_STAGE` (or `NODE_ENV`) to determine which config to use.
+ * Falls back to development config if stage is not 'production'.
+ */
+declare function withFeatureFlags(flagConfigs: WithFeatureFlagsOptions, nextConfig?: NextConfig): NextConfig;
+
+export { withFeatureFlags };

package/dist/nextjs/withFeatureFlags.js

@@ -0,0 +1,52 @@
+"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/nextjs/withFeatureFlags.ts
+var withFeatureFlags_exports = {};
+__export(withFeatureFlags_exports, {
+  withFeatureFlags: () => withFeatureFlags
+});
+module.exports = __toCommonJS(withFeatureFlags_exports);
+function toUpperSnakeCase(key) {
+  return key.replace(/([A-Z])/g, "_$1").toUpperCase();
+}
+function withFeatureFlags(flagConfigs, nextConfig = {}) {
+  const stage = process.env.NEXT_PUBLIC_SST_STAGE ?? (process.env.NODE_ENV === "production" ? "production" : "development");
+  const defaultFlags = flagConfigs.default ?? {};
+  const stageOverrides = flagConfigs[stage] ?? {};
+  const resolvedFlags = { ...defaultFlags, ...stageOverrides };
+  const env = {};
+  for (const [key, value] of Object.entries(resolvedFlags)) {
+    const envKey = `NEXT_PUBLIC_FEATURE_FLAG_${toUpperSnakeCase(key)}`;
+    env[envKey] = String(value);
+    process.env[envKey] = String(value);
+  }
+  return {
+    ...nextConfig,
+    env: {
+      ...nextConfig.env,
+      ...env
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  withFeatureFlags
+});
+//# sourceMappingURL=withFeatureFlags.js.map

package/dist/nextjs/withFeatureFlags.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/nextjs/withFeatureFlags.ts"],"sourcesContent":["/**\n * Next.js config helper that injects feature flags as NEXT_PUBLIC_ environment variables.\n *\n * This allows client components to read feature flags via `getClientFeatureFlag()`\n * from `@smooai/config/feature-flags` without importing any Node.js-dependent code.\n *\n * @example\n * ```ts\n * // next.config.ts\n * import { withFeatureFlags } from '@smooai/config/nextjs/withFeatureFlags';\n * import defaultConfig from './.smooai-config/default';\n * import developmentConfig from './.smooai-config/development';\n *\n * const nextConfig = withFeatureFlags({\n *     default: defaultConfig,\n *     development: developmentConfig,\n * });\n *\n * export default nextConfig;\n * ```\n *\n * This will set environment variables like:\n * - NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE=true (in development)\n * - NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE=false (in production)\n *\n * Then in any client component:\n * ```tsx\n * import { getClientFeatureFlag } from '@smooai/config/feature-flags';\n * const isEnabled = getClientFeatureFlag('aboutPage');\n * ```\n */\n\ntype NextConfig = Record<string, unknown>;\ntype FeatureFlagConfig = Record<string, boolean>;\n\ninterface WithFeatureFlagsOptions {\n    /** Default feature flag values (used in production). */\n    default: FeatureFlagConfig;\n    /** Development overrides (merged with default). */\n    development?: FeatureFlagConfig;\n    /** Additional stage-specific overrides. Key is the stage name. */\n    [stage: string]: FeatureFlagConfig | undefined;\n}\n\n/**\n * Convert a camelCase 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 * Wraps a Next.js config to inject feature flags as NEXT_PUBLIC_ environment variables.\n *\n * Reads `NEXT_PUBLIC_SST_STAGE` (or `NODE_ENV`) to determine which config to use.\n * Falls back to development config if stage is not 'production'.\n */\nexport function withFeatureFlags(flagConfigs: WithFeatureFlagsOptions, nextConfig: NextConfig = {}): NextConfig {\n    const stage = process.env.NEXT_PUBLIC_SST_STAGE ?? (process.env.NODE_ENV === 'production' ? 'production' : 'development');\n\n    // Merge default with stage-specific overrides\n    const defaultFlags = flagConfigs.default ?? {};\n    const stageOverrides = flagConfigs[stage] ?? {};\n    const resolvedFlags: FeatureFlagConfig = { ...defaultFlags, ...stageOverrides };\n\n    // Inject as NEXT_PUBLIC_ env vars\n    const env: Record<string, string> = {};\n    for (const [key, value] of Object.entries(resolvedFlags)) {\n        const envKey = `NEXT_PUBLIC_FEATURE_FLAG_${toUpperSnakeCase(key)}`;\n        env[envKey] = String(value);\n        // Also set in process.env for SSR\n        process.env[envKey] = String(value);\n    }\n\n    return {\n        ...nextConfig,\n        env: {\n            ...(nextConfig.env as Record<string, string> | undefined),\n            ...env,\n        },\n    };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgDA,SAAS,iBAAiB,KAAqB;AAC3C,SAAO,IAAI,QAAQ,YAAY,KAAK,EAAE,YAAY;AACtD;AAQO,SAAS,iBAAiB,aAAsC,aAAyB,CAAC,GAAe;AAC5G,QAAM,QAAQ,QAAQ,IAAI,0BAA0B,QAAQ,IAAI,aAAa,eAAe,eAAe;AAG3G,QAAM,eAAe,YAAY,WAAW,CAAC;AAC7C,QAAM,iBAAiB,YAAY,KAAK,KAAK,CAAC;AAC9C,QAAM,gBAAmC,EAAE,GAAG,cAAc,GAAG,eAAe;AAG9E,QAAM,MAA8B,CAAC;AACrC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,aAAa,GAAG;AACtD,UAAM,SAAS,4BAA4B,iBAAiB,GAAG,CAAC;AAChE,QAAI,MAAM,IAAI,OAAO,KAAK;AAE1B,YAAQ,IAAI,MAAM,IAAI,OAAO,KAAK;AAAA,EACtC;AAEA,SAAO;AAAA,IACH,GAAG;AAAA,IACH,KAAK;AAAA,MACD,GAAI,WAAW;AAAA,MACf,GAAG;AAAA,IACP;AAAA,EACJ;AACJ;","names":[]}

package/dist/nextjs/withFeatureFlags.mjs

@@ -0,0 +1,29 @@
+import "../chunk-J5LGTIGS.mjs";
+
+// src/nextjs/withFeatureFlags.ts
+function toUpperSnakeCase(key) {
+  return key.replace(/([A-Z])/g, "_$1").toUpperCase();
+}
+function withFeatureFlags(flagConfigs, nextConfig = {}) {
+  const stage = process.env.NEXT_PUBLIC_SST_STAGE ?? (process.env.NODE_ENV === "production" ? "production" : "development");
+  const defaultFlags = flagConfigs.default ?? {};
+  const stageOverrides = flagConfigs[stage] ?? {};
+  const resolvedFlags = { ...defaultFlags, ...stageOverrides };
+  const env = {};
+  for (const [key, value] of Object.entries(resolvedFlags)) {
+    const envKey = `NEXT_PUBLIC_FEATURE_FLAG_${toUpperSnakeCase(key)}`;
+    env[envKey] = String(value);
+    process.env[envKey] = String(value);
+  }
+  return {
+    ...nextConfig,
+    env: {
+      ...nextConfig.env,
+      ...env
+    }
+  };
+}
+export {
+  withFeatureFlags
+};
+//# sourceMappingURL=withFeatureFlags.mjs.map

package/dist/nextjs/withFeatureFlags.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/nextjs/withFeatureFlags.ts"],"sourcesContent":["/**\n * Next.js config helper that injects feature flags as NEXT_PUBLIC_ environment variables.\n *\n * This allows client components to read feature flags via `getClientFeatureFlag()`\n * from `@smooai/config/feature-flags` without importing any Node.js-dependent code.\n *\n * @example\n * ```ts\n * // next.config.ts\n * import { withFeatureFlags } from '@smooai/config/nextjs/withFeatureFlags';\n * import defaultConfig from './.smooai-config/default';\n * import developmentConfig from './.smooai-config/development';\n *\n * const nextConfig = withFeatureFlags({\n *     default: defaultConfig,\n *     development: developmentConfig,\n * });\n *\n * export default nextConfig;\n * ```\n *\n * This will set environment variables like:\n * - NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE=true (in development)\n * - NEXT_PUBLIC_FEATURE_FLAG_ABOUT_PAGE=false (in production)\n *\n * Then in any client component:\n * ```tsx\n * import { getClientFeatureFlag } from '@smooai/config/feature-flags';\n * const isEnabled = getClientFeatureFlag('aboutPage');\n * ```\n */\n\ntype NextConfig = Record<string, unknown>;\ntype FeatureFlagConfig = Record<string, boolean>;\n\ninterface WithFeatureFlagsOptions {\n    /** Default feature flag values (used in production). */\n    default: FeatureFlagConfig;\n    /** Development overrides (merged with default). */\n    development?: FeatureFlagConfig;\n    /** Additional stage-specific overrides. Key is the stage name. */\n    [stage: string]: FeatureFlagConfig | undefined;\n}\n\n/**\n * Convert a camelCase 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 * Wraps a Next.js config to inject feature flags as NEXT_PUBLIC_ environment variables.\n *\n * Reads `NEXT_PUBLIC_SST_STAGE` (or `NODE_ENV`) to determine which config to use.\n * Falls back to development config if stage is not 'production'.\n */\nexport function withFeatureFlags(flagConfigs: WithFeatureFlagsOptions, nextConfig: NextConfig = {}): NextConfig {\n    const stage = process.env.NEXT_PUBLIC_SST_STAGE ?? (process.env.NODE_ENV === 'production' ? 'production' : 'development');\n\n    // Merge default with stage-specific overrides\n    const defaultFlags = flagConfigs.default ?? {};\n    const stageOverrides = flagConfigs[stage] ?? {};\n    const resolvedFlags: FeatureFlagConfig = { ...defaultFlags, ...stageOverrides };\n\n    // Inject as NEXT_PUBLIC_ env vars\n    const env: Record<string, string> = {};\n    for (const [key, value] of Object.entries(resolvedFlags)) {\n        const envKey = `NEXT_PUBLIC_FEATURE_FLAG_${toUpperSnakeCase(key)}`;\n        env[envKey] = String(value);\n        // Also set in process.env for SSR\n        process.env[envKey] = String(value);\n    }\n\n    return {\n        ...nextConfig,\n        env: {\n            ...(nextConfig.env as Record<string, string> | undefined),\n            ...env,\n        },\n    };\n}\n"],"mappings":";;;AAgDA,SAAS,iBAAiB,KAAqB;AAC3C,SAAO,IAAI,QAAQ,YAAY,KAAK,EAAE,YAAY;AACtD;AAQO,SAAS,iBAAiB,aAAsC,aAAyB,CAAC,GAAe;AAC5G,QAAM,QAAQ,QAAQ,IAAI,0BAA0B,QAAQ,IAAI,aAAa,eAAe,eAAe;AAG3G,QAAM,eAAe,YAAY,WAAW,CAAC;AAC7C,QAAM,iBAAiB,YAAY,KAAK,KAAK,CAAC;AAC9C,QAAM,gBAAmC,EAAE,GAAG,cAAc,GAAG,eAAe;AAG9E,QAAM,MAA8B,CAAC;AACrC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,aAAa,GAAG;AACtD,UAAM,SAAS,4BAA4B,iBAAiB,GAAG,CAAC;AAChE,QAAI,MAAM,IAAI,OAAO,KAAK;AAE1B,YAAQ,IAAI,MAAM,IAAI,OAAO,KAAK;AAAA,EACtC;AAEA,SAAO;AAAA,IACH,GAAG;AAAA,IACH,KAAK;AAAA,MACD,GAAI,WAAW;AAAA,MACf,GAAG;AAAA,IACP;AAAA,EACJ;AACJ;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smooai/config",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "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": {
@@ -72,6 +72,11 @@
       "import": "./dist/nextjs/getConfig.mjs",
       "require": "./dist/nextjs/getConfig.js"
     },
+    "./nextjs/withFeatureFlags": {
+      "types": "./dist/nextjs/withFeatureFlags.d.ts",
+      "import": "./dist/nextjs/withFeatureFlags.mjs",
+      "require": "./dist/nextjs/withFeatureFlags.js"
+    },
     "./feature-flags": {
       "types": "./dist/feature-flags/index.d.ts",
       "browser": {