@smooai/config 2.0.3 → 2.1.0

package/dist/vite/index.js

@@ -0,0 +1,249 @@
+"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/vite/index.ts
+var vite_exports = {};
+__export(vite_exports, {
+  ConfigProvider: () => ConfigProvider,
+  getPreloadedConfig: () => getPreloadedConfig,
+  preloadConfig: () => preloadConfig,
+  resetPreload: () => resetPreload,
+  useConfigClient: () => useConfigClient,
+  useFeatureFlag: () => useFeatureFlag,
+  usePublicConfig: () => usePublicConfig,
+  useSecretConfig: () => useSecretConfig
+});
+module.exports = __toCommonJS(vite_exports);
+
+// src/platform/client.ts
+function getEnv(key) {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env[key];
+  }
+  return void 0;
+}
+var ConfigClient = class {
+  baseUrl;
+  orgId;
+  apiKey;
+  defaultEnvironment;
+  cacheTtlMs;
+  cache = /* @__PURE__ */ new Map();
+  constructor(options = {}) {
+    const baseUrl = options.baseUrl ?? getEnv("SMOOAI_CONFIG_API_URL");
+    const apiKey = options.apiKey ?? getEnv("SMOOAI_CONFIG_API_KEY");
+    const orgId = options.orgId ?? getEnv("SMOOAI_CONFIG_ORG_ID");
+    if (!baseUrl) throw new Error("@smooai/config: baseUrl is required (or set SMOOAI_CONFIG_API_URL)");
+    if (!apiKey) throw new Error("@smooai/config: apiKey is required (or set SMOOAI_CONFIG_API_KEY)");
+    if (!orgId) throw new Error("@smooai/config: orgId is required (or set SMOOAI_CONFIG_ORG_ID)");
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+    this.apiKey = apiKey;
+    this.orgId = orgId;
+    this.defaultEnvironment = options.environment ?? getEnv("SMOOAI_CONFIG_ENV") ?? "development";
+    this.cacheTtlMs = options.cacheTtlMs ?? 0;
+  }
+  computeExpiresAt() {
+    return this.cacheTtlMs > 0 ? Date.now() + this.cacheTtlMs : 0;
+  }
+  getCached(cacheKey) {
+    const entry = this.cache.get(cacheKey);
+    if (!entry) return void 0;
+    if (entry.expiresAt > 0 && Date.now() > entry.expiresAt) {
+      this.cache.delete(cacheKey);
+      return void 0;
+    }
+    return entry.value;
+  }
+  async fetchJson(path, fetchOptions) {
+    const response = await fetch(`${this.baseUrl}${path}`, {
+      ...fetchOptions,
+      headers: { Authorization: `Bearer ${this.apiKey}`, ...fetchOptions?.headers }
+    });
+    if (!response.ok) {
+      throw new Error(`Config API error: HTTP ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+  }
+  /**
+   * Get a single config value by key.
+   * Results are cached locally after the first fetch.
+   */
+  async getValue(key, environment) {
+    const env = environment ?? this.defaultEnvironment;
+    const cacheKey = `${env}:${key}`;
+    const cached = this.getCached(cacheKey);
+    if (cached !== void 0) {
+      return cached;
+    }
+    const result = await this.fetchJson(
+      `/organizations/${this.orgId}/config/values/${encodeURIComponent(key)}?environment=${encodeURIComponent(env)}`
+    );
+    this.cache.set(cacheKey, { value: result.value, expiresAt: this.computeExpiresAt() });
+    return result.value;
+  }
+  /**
+   * Get all config values for an environment.
+   * All returned values are cached locally.
+   * @param environment - Environment name (defaults to constructor option or SMOOAI_CONFIG_ENV)
+   * @param fetchOptions - Optional fetch options (e.g., Next.js `{ next: { revalidate: 60 } }`)
+   */
+  async getAllValues(environment, fetchOptions) {
+    const env = environment ?? this.defaultEnvironment;
+    const result = await this.fetchJson(
+      `/organizations/${this.orgId}/config/values?environment=${encodeURIComponent(env)}`,
+      fetchOptions
+    );
+    const expiresAt = this.computeExpiresAt();
+    for (const [key, value] of Object.entries(result.values)) {
+      this.cache.set(`${env}:${key}`, { value, expiresAt });
+    }
+    return result.values;
+  }
+  /**
+   * Pre-populate a single cache entry (e.g., from SSR).
+   * Does not make a network request.
+   */
+  seedCache(key, value, environment) {
+    const env = environment ?? this.defaultEnvironment;
+    this.cache.set(`${env}:${key}`, { value, expiresAt: this.computeExpiresAt() });
+  }
+  /**
+   * Pre-populate multiple cache entries from a key-value map (e.g., from SSR).
+   * Does not make a network request.
+   */
+  seedCacheFromMap(values, environment) {
+    const env = environment ?? this.defaultEnvironment;
+    const expiresAt = this.computeExpiresAt();
+    for (const [key, value] of Object.entries(values)) {
+      this.cache.set(`${env}:${key}`, { value, expiresAt });
+    }
+  }
+  /**
+   * Synchronously read a value from the local cache without making a network request.
+   * Returns `undefined` if the key is not cached or has expired.
+   */
+  getCachedValue(key, environment) {
+    const env = environment ?? this.defaultEnvironment;
+    return this.getCached(`${env}:${key}`);
+  }
+  /** Clear the entire local cache. */
+  invalidateCache() {
+    this.cache.clear();
+  }
+  /** Clear cached values for a specific environment. */
+  invalidateCacheForEnvironment(environment) {
+    const prefix = `${environment}:`;
+    for (const key of this.cache.keys()) {
+      if (key.startsWith(prefix)) {
+        this.cache.delete(key);
+      }
+    }
+  }
+};
+
+// src/vite/preloadConfig.ts
+var preloadPromise = null;
+var preloadedValues = null;
+function preloadConfig(options) {
+  if (preloadPromise) return preloadPromise;
+  const client = new ConfigClient(options);
+  preloadPromise = client.getAllValues(options?.environment).then((values) => {
+    preloadedValues = values;
+    return values;
+  });
+  return preloadPromise;
+}
+function getPreloadedConfig() {
+  return preloadedValues;
+}
+function resetPreload() {
+  preloadPromise = null;
+  preloadedValues = null;
+}
+
+// src/react/ConfigProvider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var ConfigContext = (0, import_react.createContext)(null);
+function ConfigProvider({ children, ...options }) {
+  const client = (0, import_react.useMemo)(() => new ConfigClient(options), [options.baseUrl, options.apiKey, options.orgId, options.environment]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ConfigContext.Provider, { value: client, children });
+}
+function useConfigClient() {
+  const client = (0, import_react.useContext)(ConfigContext);
+  if (!client) {
+    throw new Error("useConfigClient must be used within a <ConfigProvider>");
+  }
+  return client;
+}
+
+// src/react/hooks.ts
+var import_react2 = require("react");
+function useConfigValue(key, environment) {
+  const client = useConfigClient();
+  const [value, setValue] = (0, import_react2.useState)(void 0);
+  const [isLoading, setIsLoading] = (0, import_react2.useState)(true);
+  const [error, setError] = (0, import_react2.useState)(null);
+  const [fetchCount, setFetchCount] = (0, import_react2.useState)(0);
+  const refetch = (0, import_react2.useCallback)(() => {
+    client.invalidateCache();
+    setFetchCount((c) => c + 1);
+  }, [client]);
+  (0, import_react2.useEffect)(() => {
+    let cancelled = false;
+    setIsLoading(true);
+    setError(null);
+    client.getValue(key, environment).then((result) => {
+      if (!cancelled) {
+        setValue(result);
+        setIsLoading(false);
+      }
+    }).catch((err) => {
+      if (!cancelled) {
+        setError(err instanceof Error ? err : new Error(String(err)));
+        setIsLoading(false);
+      }
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [client, key, environment, fetchCount]);
+  return { value, isLoading, error, refetch };
+}
+function usePublicConfig(key, environment) {
+  return useConfigValue(key, environment);
+}
+function useSecretConfig(key, environment) {
+  return useConfigValue(key, environment);
+}
+function useFeatureFlag(key, environment) {
+  return useConfigValue(key, environment);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConfigProvider,
+  getPreloadedConfig,
+  preloadConfig,
+  resetPreload,
+  useConfigClient,
+  useFeatureFlag,
+  usePublicConfig,
+  useSecretConfig
+});
+//# sourceMappingURL=index.js.map

package/dist/vite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vite/index.ts","../../src/platform/client.ts","../../src/vite/preloadConfig.ts","../../src/react/ConfigProvider.tsx","../../src/react/hooks.ts"],"sourcesContent":["export { preloadConfig, getPreloadedConfig, resetPreload } from './preloadConfig';\nexport { ConfigProvider, useConfigClient } from '../react/ConfigProvider';\nexport type { ConfigProviderProps } from '../react/ConfigProvider';\nexport { usePublicConfig, useSecretConfig, useFeatureFlag } from '../react/hooks';\n","/**\n * Browser/universal HTTP client for fetching config values from the Smoo AI config server.\n *\n * Environment variables (optional — used as defaults when constructor args are omitted):\n *   SMOOAI_CONFIG_API_URL  — Base URL of the config API\n *   SMOOAI_CONFIG_API_KEY  — Bearer token for authentication\n *   SMOOAI_CONFIG_ORG_ID   — Organization ID\n *   SMOOAI_CONFIG_ENV      — Default environment name (e.g. \"production\")\n */\n\nexport interface ConfigClientOptions {\n    /** Base URL of the config API server. Falls back to SMOOAI_CONFIG_API_URL env var. */\n    baseUrl?: string;\n    /** API key (M2M / client credentials token). Falls back to SMOOAI_CONFIG_API_KEY env var. */\n    apiKey?: string;\n    /** Organization ID. Falls back to SMOOAI_CONFIG_ORG_ID env var. */\n    orgId?: string;\n    /** Default environment name. Falls back to SMOOAI_CONFIG_ENV env var, then \"development\". */\n    environment?: string;\n    /** Cache TTL in milliseconds. 0 or undefined means cache never expires (manual invalidation only). */\n    cacheTtlMs?: number;\n}\n\ninterface CacheEntry {\n    value: unknown;\n    expiresAt: number; // 0 = never expires\n}\n\nfunction getEnv(key: string): string | undefined {\n    if (typeof process !== 'undefined' && process.env) {\n        return process.env[key];\n    }\n    return undefined;\n}\n\nexport class ConfigClient {\n    private baseUrl: string;\n    private orgId: string;\n    private apiKey: string;\n    private defaultEnvironment: string;\n    private cacheTtlMs: number;\n    private cache: Map<string, CacheEntry> = new Map();\n\n    constructor(options: ConfigClientOptions = {}) {\n        const baseUrl = options.baseUrl ?? getEnv('SMOOAI_CONFIG_API_URL');\n        const apiKey = options.apiKey ?? getEnv('SMOOAI_CONFIG_API_KEY');\n        const orgId = options.orgId ?? getEnv('SMOOAI_CONFIG_ORG_ID');\n\n        if (!baseUrl) throw new Error('@smooai/config: baseUrl is required (or set SMOOAI_CONFIG_API_URL)');\n        if (!apiKey) throw new Error('@smooai/config: apiKey is required (or set SMOOAI_CONFIG_API_KEY)');\n        if (!orgId) throw new Error('@smooai/config: orgId is required (or set SMOOAI_CONFIG_ORG_ID)');\n\n        this.baseUrl = baseUrl.replace(/\\/+$/, '');\n        this.apiKey = apiKey;\n        this.orgId = orgId;\n        this.defaultEnvironment = options.environment ?? getEnv('SMOOAI_CONFIG_ENV') ?? 'development';\n        this.cacheTtlMs = options.cacheTtlMs ?? 0;\n    }\n\n    private computeExpiresAt(): number {\n        return this.cacheTtlMs > 0 ? Date.now() + this.cacheTtlMs : 0;\n    }\n\n    private getCached(cacheKey: string): unknown | undefined {\n        const entry = this.cache.get(cacheKey);\n        if (!entry) return undefined;\n        if (entry.expiresAt > 0 && Date.now() > entry.expiresAt) {\n            this.cache.delete(cacheKey);\n            return undefined;\n        }\n        return entry.value;\n    }\n\n    private async fetchJson<T>(path: string, fetchOptions?: RequestInit): Promise<T> {\n        const response = await fetch(`${this.baseUrl}${path}`, {\n            ...fetchOptions,\n            headers: { Authorization: `Bearer ${this.apiKey}`, ...fetchOptions?.headers },\n        });\n        if (!response.ok) {\n            throw new Error(`Config API error: HTTP ${response.status} ${response.statusText}`);\n        }\n        return response.json() as Promise<T>;\n    }\n\n    /**\n     * Get a single config value by key.\n     * Results are cached locally after the first fetch.\n     */\n    async getValue(key: string, environment?: string): Promise<unknown> {\n        const env = environment ?? this.defaultEnvironment;\n        const cacheKey = `${env}:${key}`;\n\n        const cached = this.getCached(cacheKey);\n        if (cached !== undefined) {\n            return cached;\n        }\n\n        const result = await this.fetchJson<{ value: unknown }>(\n            `/organizations/${this.orgId}/config/values/${encodeURIComponent(key)}?environment=${encodeURIComponent(env)}`,\n        );\n        this.cache.set(cacheKey, { value: result.value, expiresAt: this.computeExpiresAt() });\n        return result.value;\n    }\n\n    /**\n     * Get all config values for an environment.\n     * All returned values are cached locally.\n     * @param environment - Environment name (defaults to constructor option or SMOOAI_CONFIG_ENV)\n     * @param fetchOptions - Optional fetch options (e.g., Next.js `{ next: { revalidate: 60 } }`)\n     */\n    async getAllValues(environment?: string, fetchOptions?: RequestInit): Promise<Record<string, unknown>> {\n        const env = environment ?? this.defaultEnvironment;\n\n        const result = await this.fetchJson<{ values: Record<string, unknown> }>(\n            `/organizations/${this.orgId}/config/values?environment=${encodeURIComponent(env)}`,\n            fetchOptions,\n        );\n\n        const expiresAt = this.computeExpiresAt();\n        for (const [key, value] of Object.entries(result.values)) {\n            this.cache.set(`${env}:${key}`, { value, expiresAt });\n        }\n\n        return result.values;\n    }\n\n    /**\n     * Pre-populate a single cache entry (e.g., from SSR).\n     * Does not make a network request.\n     */\n    seedCache(key: string, value: unknown, environment?: string): void {\n        const env = environment ?? this.defaultEnvironment;\n        this.cache.set(`${env}:${key}`, { value, expiresAt: this.computeExpiresAt() });\n    }\n\n    /**\n     * Pre-populate multiple cache entries from a key-value map (e.g., from SSR).\n     * Does not make a network request.\n     */\n    seedCacheFromMap(values: Record<string, unknown>, environment?: string): void {\n        const env = environment ?? this.defaultEnvironment;\n        const expiresAt = this.computeExpiresAt();\n        for (const [key, value] of Object.entries(values)) {\n            this.cache.set(`${env}:${key}`, { value, expiresAt });\n        }\n    }\n\n    /**\n     * Synchronously read a value from the local cache without making a network request.\n     * Returns `undefined` if the key is not cached or has expired.\n     */\n    getCachedValue(key: string, environment?: string): unknown | undefined {\n        const env = environment ?? this.defaultEnvironment;\n        return this.getCached(`${env}:${key}`);\n    }\n\n    /** Clear the entire local cache. */\n    invalidateCache(): void {\n        this.cache.clear();\n    }\n\n    /** Clear cached values for a specific environment. */\n    invalidateCacheForEnvironment(environment: string): void {\n        const prefix = `${environment}:`;\n        for (const key of this.cache.keys()) {\n            if (key.startsWith(prefix)) {\n                this.cache.delete(key);\n            }\n        }\n    }\n}\n","import { ConfigClient, type ConfigClientOptions } from '../platform/client';\n\nlet preloadPromise: Promise<Record<string, unknown>> | null = null;\nlet preloadedValues: Record<string, unknown> | null = null;\n\n/**\n * Start fetching all config values as early as possible (before React renders).\n * Call this in your entry file before `createRoot()`:\n *\n * ```ts\n * // main.tsx\n * import { preloadConfig } from '@smooai/config/vite';\n *\n * preloadConfig({ environment: 'production' });\n *\n * // ... later, React tree mounts and hooks read from the already-populated cache\n * ```\n *\n * The returned promise resolves with the fetched config values.\n * Subsequent calls return the same promise (singleton behavior).\n */\nexport function preloadConfig(options?: ConfigClientOptions): Promise<Record<string, unknown>> {\n    if (preloadPromise) return preloadPromise;\n\n    const client = new ConfigClient(options);\n    preloadPromise = client.getAllValues(options?.environment).then((values) => {\n        preloadedValues = values;\n        return values;\n    });\n    return preloadPromise;\n}\n\n/**\n * Get the preloaded config values synchronously.\n * Returns `null` if `preloadConfig()` hasn't completed yet.\n */\nexport function getPreloadedConfig(): Record<string, unknown> | null {\n    return preloadedValues;\n}\n\n/**\n * Reset preload state (primarily for testing).\n */\nexport function resetPreload(): void {\n    preloadPromise = null;\n    preloadedValues = null;\n}\n","'use client';\n\nimport { createContext, useContext, useMemo, type ReactNode } from 'react';\nimport { ConfigClient, type ConfigClientOptions } from '../platform/client';\n\nexport const ConfigContext = createContext<ConfigClient | null>(null);\n\nexport interface ConfigProviderProps extends ConfigClientOptions {\n    children: ReactNode;\n}\n\n/**\n * Provides a ConfigClient instance to all descendant components.\n *\n * ```tsx\n * <ConfigProvider baseUrl=\"https://api.smooai.dev\" apiKey=\"...\" orgId=\"...\" environment=\"production\">\n *   <App />\n * </ConfigProvider>\n * ```\n *\n * All props are optional if the corresponding environment variables are set:\n *   SMOOAI_CONFIG_API_URL, SMOOAI_CONFIG_API_KEY, SMOOAI_CONFIG_ORG_ID, SMOOAI_CONFIG_ENV\n */\nexport function ConfigProvider({ children, ...options }: ConfigProviderProps) {\n    const client = useMemo(() => new ConfigClient(options), [options.baseUrl, options.apiKey, options.orgId, options.environment]);\n\n    return <ConfigContext.Provider value={client}>{children}</ConfigContext.Provider>;\n}\n\n/**\n * Access the ConfigClient instance from the nearest ConfigProvider.\n * Throws if used outside a ConfigProvider.\n */\nexport function useConfigClient(): ConfigClient {\n    const client = useContext(ConfigContext);\n    if (!client) {\n        throw new Error('useConfigClient must be used within a <ConfigProvider>');\n    }\n    return client;\n}\n","'use client';\n\nimport { useCallback, useEffect, useState } from 'react';\nimport { useConfigClient } from './ConfigProvider';\n\ninterface UseConfigResult<T = unknown> {\n    /** The resolved config value, or undefined while loading. */\n    value: T | undefined;\n    /** True while the initial fetch is in progress. */\n    isLoading: boolean;\n    /** The error if the fetch failed. */\n    error: Error | null;\n    /** Re-fetch the value (bypasses cache). */\n    refetch: () => void;\n}\n\nfunction useConfigValue(key: string, environment?: string): UseConfigResult {\n    const client = useConfigClient();\n    const [value, setValue] = useState<unknown>(undefined);\n    const [isLoading, setIsLoading] = useState(true);\n    const [error, setError] = useState<Error | null>(null);\n    const [fetchCount, setFetchCount] = useState(0);\n\n    const refetch = useCallback(() => {\n        client.invalidateCache();\n        setFetchCount((c) => c + 1);\n    }, [client]);\n\n    useEffect(() => {\n        let cancelled = false;\n        setIsLoading(true);\n        setError(null);\n\n        client\n            .getValue(key, environment)\n            .then((result) => {\n                if (!cancelled) {\n                    setValue(result);\n                    setIsLoading(false);\n                }\n            })\n            .catch((err: unknown) => {\n                if (!cancelled) {\n                    setError(err instanceof Error ? err : new Error(String(err)));\n                    setIsLoading(false);\n                }\n            });\n\n        return () => {\n            cancelled = true;\n        };\n    }, [client, key, environment, fetchCount]);\n\n    return { value, isLoading, error, refetch };\n}\n\n/**\n * Fetch a public config value by key.\n *\n * ```tsx\n * const { value, isLoading, error } = usePublicConfig('API_URL');\n * ```\n */\nexport function usePublicConfig<T = unknown>(key: string, environment?: string): UseConfigResult<T> {\n    return useConfigValue(key, environment) as UseConfigResult<T>;\n}\n\n/**\n * Fetch a secret config value by key.\n *\n * ```tsx\n * const { value, isLoading } = useSecretConfig('DATABASE_URL');\n * ```\n */\nexport function useSecretConfig<T = unknown>(key: string, environment?: string): UseConfigResult<T> {\n    return useConfigValue(key, environment) as UseConfigResult<T>;\n}\n\n/**\n * Fetch a feature flag value by key.\n *\n * ```tsx\n * const { value: enableNewUI } = useFeatureFlag<boolean>('ENABLE_NEW_UI');\n * ```\n */\nexport function useFeatureFlag<T = unknown>(key: string, environment?: string): UseConfigResult<T> {\n    return useConfigValue(key, environment) as UseConfigResult<T>;\n}\n"],"mappings":"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","names":["import_react"]}

package/dist/vite/index.mjs

@@ -0,0 +1,27 @@
+import {
+  useFeatureFlag,
+  usePublicConfig,
+  useSecretConfig
+} from "../chunk-VL7AIM2X.mjs";
+import {
+  getPreloadedConfig,
+  preloadConfig,
+  resetPreload
+} from "../chunk-VUYQFQ63.mjs";
+import {
+  ConfigProvider,
+  useConfigClient
+} from "../chunk-N6Z4AZZA.mjs";
+import "../chunk-3B5SRHJ2.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  ConfigProvider,
+  getPreloadedConfig,
+  preloadConfig,
+  resetPreload,
+  useConfigClient,
+  useFeatureFlag,
+  usePublicConfig,
+  useSecretConfig
+};
+//# sourceMappingURL=index.mjs.map

package/dist/vite/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/vite/preloadConfig.d.mts

@@ -0,0 +1,30 @@
+import { ConfigClientOptions } from '../platform/client.mjs';
+
+/**
+ * Start fetching all config values as early as possible (before React renders).
+ * Call this in your entry file before `createRoot()`:
+ *
+ * ```ts
+ * // main.tsx
+ * import { preloadConfig } from '@smooai/config/vite';
+ *
+ * preloadConfig({ environment: 'production' });
+ *
+ * // ... later, React tree mounts and hooks read from the already-populated cache
+ * ```
+ *
+ * The returned promise resolves with the fetched config values.
+ * Subsequent calls return the same promise (singleton behavior).
+ */
+declare function preloadConfig(options?: ConfigClientOptions): Promise<Record<string, unknown>>;
+/**
+ * Get the preloaded config values synchronously.
+ * Returns `null` if `preloadConfig()` hasn't completed yet.
+ */
+declare function getPreloadedConfig(): Record<string, unknown> | null;
+/**
+ * Reset preload state (primarily for testing).
+ */
+declare function resetPreload(): void;
+
+export { getPreloadedConfig, preloadConfig, resetPreload };

package/dist/vite/preloadConfig.d.ts

@@ -0,0 +1,30 @@
+import { ConfigClientOptions } from '../platform/client.js';
+
+/**
+ * Start fetching all config values as early as possible (before React renders).
+ * Call this in your entry file before `createRoot()`:
+ *
+ * ```ts
+ * // main.tsx
+ * import { preloadConfig } from '@smooai/config/vite';
+ *
+ * preloadConfig({ environment: 'production' });
+ *
+ * // ... later, React tree mounts and hooks read from the already-populated cache
+ * ```
+ *
+ * The returned promise resolves with the fetched config values.
+ * Subsequent calls return the same promise (singleton behavior).
+ */
+declare function preloadConfig(options?: ConfigClientOptions): Promise<Record<string, unknown>>;
+/**
+ * Get the preloaded config values synchronously.
+ * Returns `null` if `preloadConfig()` hasn't completed yet.
+ */
+declare function getPreloadedConfig(): Record<string, unknown> | null;
+/**
+ * Reset preload state (primarily for testing).
+ */
+declare function resetPreload(): void;
+
+export { getPreloadedConfig, preloadConfig, resetPreload };

package/dist/vite/preloadConfig.js

@@ -0,0 +1,180 @@
+"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/vite/preloadConfig.ts
+var preloadConfig_exports = {};
+__export(preloadConfig_exports, {
+  getPreloadedConfig: () => getPreloadedConfig,
+  preloadConfig: () => preloadConfig,
+  resetPreload: () => resetPreload
+});
+module.exports = __toCommonJS(preloadConfig_exports);
+
+// src/platform/client.ts
+function getEnv(key) {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env[key];
+  }
+  return void 0;
+}
+var ConfigClient = class {
+  baseUrl;
+  orgId;
+  apiKey;
+  defaultEnvironment;
+  cacheTtlMs;
+  cache = /* @__PURE__ */ new Map();
+  constructor(options = {}) {
+    const baseUrl = options.baseUrl ?? getEnv("SMOOAI_CONFIG_API_URL");
+    const apiKey = options.apiKey ?? getEnv("SMOOAI_CONFIG_API_KEY");
+    const orgId = options.orgId ?? getEnv("SMOOAI_CONFIG_ORG_ID");
+    if (!baseUrl) throw new Error("@smooai/config: baseUrl is required (or set SMOOAI_CONFIG_API_URL)");
+    if (!apiKey) throw new Error("@smooai/config: apiKey is required (or set SMOOAI_CONFIG_API_KEY)");
+    if (!orgId) throw new Error("@smooai/config: orgId is required (or set SMOOAI_CONFIG_ORG_ID)");
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+    this.apiKey = apiKey;
+    this.orgId = orgId;
+    this.defaultEnvironment = options.environment ?? getEnv("SMOOAI_CONFIG_ENV") ?? "development";
+    this.cacheTtlMs = options.cacheTtlMs ?? 0;
+  }
+  computeExpiresAt() {
+    return this.cacheTtlMs > 0 ? Date.now() + this.cacheTtlMs : 0;
+  }
+  getCached(cacheKey) {
+    const entry = this.cache.get(cacheKey);
+    if (!entry) return void 0;
+    if (entry.expiresAt > 0 && Date.now() > entry.expiresAt) {
+      this.cache.delete(cacheKey);
+      return void 0;
+    }
+    return entry.value;
+  }
+  async fetchJson(path, fetchOptions) {
+    const response = await fetch(`${this.baseUrl}${path}`, {
+      ...fetchOptions,
+      headers: { Authorization: `Bearer ${this.apiKey}`, ...fetchOptions?.headers }
+    });
+    if (!response.ok) {
+      throw new Error(`Config API error: HTTP ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+  }
+  /**
+   * Get a single config value by key.
+   * Results are cached locally after the first fetch.
+   */
+  async getValue(key, environment) {
+    const env = environment ?? this.defaultEnvironment;
+    const cacheKey = `${env}:${key}`;
+    const cached = this.getCached(cacheKey);
+    if (cached !== void 0) {
+      return cached;
+    }
+    const result = await this.fetchJson(
+      `/organizations/${this.orgId}/config/values/${encodeURIComponent(key)}?environment=${encodeURIComponent(env)}`
+    );
+    this.cache.set(cacheKey, { value: result.value, expiresAt: this.computeExpiresAt() });
+    return result.value;
+  }
+  /**
+   * Get all config values for an environment.
+   * All returned values are cached locally.
+   * @param environment - Environment name (defaults to constructor option or SMOOAI_CONFIG_ENV)
+   * @param fetchOptions - Optional fetch options (e.g., Next.js `{ next: { revalidate: 60 } }`)
+   */
+  async getAllValues(environment, fetchOptions) {
+    const env = environment ?? this.defaultEnvironment;
+    const result = await this.fetchJson(
+      `/organizations/${this.orgId}/config/values?environment=${encodeURIComponent(env)}`,
+      fetchOptions
+    );
+    const expiresAt = this.computeExpiresAt();
+    for (const [key, value] of Object.entries(result.values)) {
+      this.cache.set(`${env}:${key}`, { value, expiresAt });
+    }
+    return result.values;
+  }
+  /**
+   * Pre-populate a single cache entry (e.g., from SSR).
+   * Does not make a network request.
+   */
+  seedCache(key, value, environment) {
+    const env = environment ?? this.defaultEnvironment;
+    this.cache.set(`${env}:${key}`, { value, expiresAt: this.computeExpiresAt() });
+  }
+  /**
+   * Pre-populate multiple cache entries from a key-value map (e.g., from SSR).
+   * Does not make a network request.
+   */
+  seedCacheFromMap(values, environment) {
+    const env = environment ?? this.defaultEnvironment;
+    const expiresAt = this.computeExpiresAt();
+    for (const [key, value] of Object.entries(values)) {
+      this.cache.set(`${env}:${key}`, { value, expiresAt });
+    }
+  }
+  /**
+   * Synchronously read a value from the local cache without making a network request.
+   * Returns `undefined` if the key is not cached or has expired.
+   */
+  getCachedValue(key, environment) {
+    const env = environment ?? this.defaultEnvironment;
+    return this.getCached(`${env}:${key}`);
+  }
+  /** Clear the entire local cache. */
+  invalidateCache() {
+    this.cache.clear();
+  }
+  /** Clear cached values for a specific environment. */
+  invalidateCacheForEnvironment(environment) {
+    const prefix = `${environment}:`;
+    for (const key of this.cache.keys()) {
+      if (key.startsWith(prefix)) {
+        this.cache.delete(key);
+      }
+    }
+  }
+};
+
+// src/vite/preloadConfig.ts
+var preloadPromise = null;
+var preloadedValues = null;
+function preloadConfig(options) {
+  if (preloadPromise) return preloadPromise;
+  const client = new ConfigClient(options);
+  preloadPromise = client.getAllValues(options?.environment).then((values) => {
+    preloadedValues = values;
+    return values;
+  });
+  return preloadPromise;
+}
+function getPreloadedConfig() {
+  return preloadedValues;
+}
+function resetPreload() {
+  preloadPromise = null;
+  preloadedValues = null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getPreloadedConfig,
+  preloadConfig,
+  resetPreload
+});
+//# sourceMappingURL=preloadConfig.js.map

package/dist/vite/preloadConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vite/preloadConfig.ts","../../src/platform/client.ts"],"sourcesContent":["import { ConfigClient, type ConfigClientOptions } from '../platform/client';\n\nlet preloadPromise: Promise<Record<string, unknown>> | null = null;\nlet preloadedValues: Record<string, unknown> | null = null;\n\n/**\n * Start fetching all config values as early as possible (before React renders).\n * Call this in your entry file before `createRoot()`:\n *\n * ```ts\n * // main.tsx\n * import { preloadConfig } from '@smooai/config/vite';\n *\n * preloadConfig({ environment: 'production' });\n *\n * // ... later, React tree mounts and hooks read from the already-populated cache\n * ```\n *\n * The returned promise resolves with the fetched config values.\n * Subsequent calls return the same promise (singleton behavior).\n */\nexport function preloadConfig(options?: ConfigClientOptions): Promise<Record<string, unknown>> {\n    if (preloadPromise) return preloadPromise;\n\n    const client = new ConfigClient(options);\n    preloadPromise = client.getAllValues(options?.environment).then((values) => {\n        preloadedValues = values;\n        return values;\n    });\n    return preloadPromise;\n}\n\n/**\n * Get the preloaded config values synchronously.\n * Returns `null` if `preloadConfig()` hasn't completed yet.\n */\nexport function getPreloadedConfig(): Record<string, unknown> | null {\n    return preloadedValues;\n}\n\n/**\n * Reset preload state (primarily for testing).\n */\nexport function resetPreload(): void {\n    preloadPromise = null;\n    preloadedValues = null;\n}\n","/**\n * Browser/universal HTTP client for fetching config values from the Smoo AI config server.\n *\n * Environment variables (optional — used as defaults when constructor args are omitted):\n *   SMOOAI_CONFIG_API_URL  — Base URL of the config API\n *   SMOOAI_CONFIG_API_KEY  — Bearer token for authentication\n *   SMOOAI_CONFIG_ORG_ID   — Organization ID\n *   SMOOAI_CONFIG_ENV      — Default environment name (e.g. \"production\")\n */\n\nexport interface ConfigClientOptions {\n    /** Base URL of the config API server. Falls back to SMOOAI_CONFIG_API_URL env var. */\n    baseUrl?: string;\n    /** API key (M2M / client credentials token). Falls back to SMOOAI_CONFIG_API_KEY env var. */\n    apiKey?: string;\n    /** Organization ID. Falls back to SMOOAI_CONFIG_ORG_ID env var. */\n    orgId?: string;\n    /** Default environment name. Falls back to SMOOAI_CONFIG_ENV env var, then \"development\". */\n    environment?: string;\n    /** Cache TTL in milliseconds. 0 or undefined means cache never expires (manual invalidation only). */\n    cacheTtlMs?: number;\n}\n\ninterface CacheEntry {\n    value: unknown;\n    expiresAt: number; // 0 = never expires\n}\n\nfunction getEnv(key: string): string | undefined {\n    if (typeof process !== 'undefined' && process.env) {\n        return process.env[key];\n    }\n    return undefined;\n}\n\nexport class ConfigClient {\n    private baseUrl: string;\n    private orgId: string;\n    private apiKey: string;\n    private defaultEnvironment: string;\n    private cacheTtlMs: number;\n    private cache: Map<string, CacheEntry> = new Map();\n\n    constructor(options: ConfigClientOptions = {}) {\n        const baseUrl = options.baseUrl ?? getEnv('SMOOAI_CONFIG_API_URL');\n        const apiKey = options.apiKey ?? getEnv('SMOOAI_CONFIG_API_KEY');\n        const orgId = options.orgId ?? getEnv('SMOOAI_CONFIG_ORG_ID');\n\n        if (!baseUrl) throw new Error('@smooai/config: baseUrl is required (or set SMOOAI_CONFIG_API_URL)');\n        if (!apiKey) throw new Error('@smooai/config: apiKey is required (or set SMOOAI_CONFIG_API_KEY)');\n        if (!orgId) throw new Error('@smooai/config: orgId is required (or set SMOOAI_CONFIG_ORG_ID)');\n\n        this.baseUrl = baseUrl.replace(/\\/+$/, '');\n        this.apiKey = apiKey;\n        this.orgId = orgId;\n        this.defaultEnvironment = options.environment ?? getEnv('SMOOAI_CONFIG_ENV') ?? 'development';\n        this.cacheTtlMs = options.cacheTtlMs ?? 0;\n    }\n\n    private computeExpiresAt(): number {\n        return this.cacheTtlMs > 0 ? Date.now() + this.cacheTtlMs : 0;\n    }\n\n    private getCached(cacheKey: string): unknown | undefined {\n        const entry = this.cache.get(cacheKey);\n        if (!entry) return undefined;\n        if (entry.expiresAt > 0 && Date.now() > entry.expiresAt) {\n            this.cache.delete(cacheKey);\n            return undefined;\n        }\n        return entry.value;\n    }\n\n    private async fetchJson<T>(path: string, fetchOptions?: RequestInit): Promise<T> {\n        const response = await fetch(`${this.baseUrl}${path}`, {\n            ...fetchOptions,\n            headers: { Authorization: `Bearer ${this.apiKey}`, ...fetchOptions?.headers },\n        });\n        if (!response.ok) {\n            throw new Error(`Config API error: HTTP ${response.status} ${response.statusText}`);\n        }\n        return response.json() as Promise<T>;\n    }\n\n    /**\n     * Get a single config value by key.\n     * Results are cached locally after the first fetch.\n     */\n    async getValue(key: string, environment?: string): Promise<unknown> {\n        const env = environment ?? this.defaultEnvironment;\n        const cacheKey = `${env}:${key}`;\n\n        const cached = this.getCached(cacheKey);\n        if (cached !== undefined) {\n            return cached;\n        }\n\n        const result = await this.fetchJson<{ value: unknown }>(\n            `/organizations/${this.orgId}/config/values/${encodeURIComponent(key)}?environment=${encodeURIComponent(env)}`,\n        );\n        this.cache.set(cacheKey, { value: result.value, expiresAt: this.computeExpiresAt() });\n        return result.value;\n    }\n\n    /**\n     * Get all config values for an environment.\n     * All returned values are cached locally.\n     * @param environment - Environment name (defaults to constructor option or SMOOAI_CONFIG_ENV)\n     * @param fetchOptions - Optional fetch options (e.g., Next.js `{ next: { revalidate: 60 } }`)\n     */\n    async getAllValues(environment?: string, fetchOptions?: RequestInit): Promise<Record<string, unknown>> {\n        const env = environment ?? this.defaultEnvironment;\n\n        const result = await this.fetchJson<{ values: Record<string, unknown> }>(\n            `/organizations/${this.orgId}/config/values?environment=${encodeURIComponent(env)}`,\n            fetchOptions,\n        );\n\n        const expiresAt = this.computeExpiresAt();\n        for (const [key, value] of Object.entries(result.values)) {\n            this.cache.set(`${env}:${key}`, { value, expiresAt });\n        }\n\n        return result.values;\n    }\n\n    /**\n     * Pre-populate a single cache entry (e.g., from SSR).\n     * Does not make a network request.\n     */\n    seedCache(key: string, value: unknown, environment?: string): void {\n        const env = environment ?? this.defaultEnvironment;\n        this.cache.set(`${env}:${key}`, { value, expiresAt: this.computeExpiresAt() });\n    }\n\n    /**\n     * Pre-populate multiple cache entries from a key-value map (e.g., from SSR).\n     * Does not make a network request.\n     */\n    seedCacheFromMap(values: Record<string, unknown>, environment?: string): void {\n        const env = environment ?? this.defaultEnvironment;\n        const expiresAt = this.computeExpiresAt();\n        for (const [key, value] of Object.entries(values)) {\n            this.cache.set(`${env}:${key}`, { value, expiresAt });\n        }\n    }\n\n    /**\n     * Synchronously read a value from the local cache without making a network request.\n     * Returns `undefined` if the key is not cached or has expired.\n     */\n    getCachedValue(key: string, environment?: string): unknown | undefined {\n        const env = environment ?? this.defaultEnvironment;\n        return this.getCached(`${env}:${key}`);\n    }\n\n    /** Clear the entire local cache. */\n    invalidateCache(): void {\n        this.cache.clear();\n    }\n\n    /** Clear cached values for a specific environment. */\n    invalidateCacheForEnvironment(environment: string): void {\n        const prefix = `${environment}:`;\n        for (const key of this.cache.keys()) {\n            if (key.startsWith(prefix)) {\n                this.cache.delete(key);\n            }\n        }\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/vite/preloadConfig.mjs

@@ -0,0 +1,13 @@
+import {
+  getPreloadedConfig,
+  preloadConfig,
+  resetPreload
+} from "../chunk-VUYQFQ63.mjs";
+import "../chunk-3B5SRHJ2.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  getPreloadedConfig,
+  preloadConfig,
+  resetPreload
+};
+//# sourceMappingURL=preloadConfig.mjs.map

package/dist/vite/preloadConfig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smooai/config",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "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": {
@@ -86,9 +86,13 @@
     "zod": "^4.0.0"
   },
   "peerDependencies": {
+    "next": ">=14.0.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
     "react": {
       "optional": true
     }
@@ -98,7 +102,7 @@
     "build:lib": "pnpm create-entry-points -i \"src/**/*.ts\" -x \"src/cli/**\" && pnpm tsup",
     "build:cli": "tsup --config tsup.cli.config.ts",
     "check-all": "pnpm run typecheck && pnpm run lint && pnpm run format:check && pnpm run test && pnpm run python:typecheck && pnpm run python:lint && pnpm run python:format:check && pnpm run rust:fmt:check && pnpm run rust:lint && pnpm run rust:test && pnpm run go:fmt:check && pnpm run go:lint && pnpm run go:test && pnpm run build",
-    "ci:publish": "pnpm build && pnpm changeset publish && pnpm run version:sync",
+    "ci:publish": "pnpm build && pnpm changeset publish",
     "format": "oxfmt --write . && pnpm run python:format && pnpm run rust:fmt && pnpm run go:fmt",
     "lint": "oxlint --ignore-pattern .sst --ignore-pattern .pulumi . && pnpm run python:lint && pnpm run rust:lint && pnpm run go:lint",
     "lint:fix": "oxlint --ignore-pattern .sst --ignore-pattern .pulumi --fix .",

package/dist/chunk-SKX7CPGS.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/react/hooks.ts","../src/react/ConfigProvider.tsx"],"sourcesContent":["'use client';\n\nimport { useCallback, useEffect, useState } from 'react';\nimport { useConfigClient } from './ConfigProvider';\n\ninterface UseConfigResult<T = unknown> {\n    /** The resolved config value, or undefined while loading. */\n    value: T | undefined;\n    /** True while the initial fetch is in progress. */\n    isLoading: boolean;\n    /** The error if the fetch failed. */\n    error: Error | null;\n    /** Re-fetch the value (bypasses cache). */\n    refetch: () => void;\n}\n\nfunction useConfigValue(key: string, environment?: string): UseConfigResult {\n    const client = useConfigClient();\n    const [value, setValue] = useState<unknown>(undefined);\n    const [isLoading, setIsLoading] = useState(true);\n    const [error, setError] = useState<Error | null>(null);\n    const [fetchCount, setFetchCount] = useState(0);\n\n    const refetch = useCallback(() => {\n        client.invalidateCache();\n        setFetchCount((c) => c + 1);\n    }, [client]);\n\n    useEffect(() => {\n        let cancelled = false;\n        setIsLoading(true);\n        setError(null);\n\n        client\n            .getValue(key, environment)\n            .then((result) => {\n                if (!cancelled) {\n                    setValue(result);\n                    setIsLoading(false);\n                }\n            })\n            .catch((err: unknown) => {\n                if (!cancelled) {\n                    setError(err instanceof Error ? err : new Error(String(err)));\n                    setIsLoading(false);\n                }\n            });\n\n        return () => {\n            cancelled = true;\n        };\n    }, [client, key, environment, fetchCount]);\n\n    return { value, isLoading, error, refetch };\n}\n\n/**\n * Fetch a public config value by key.\n *\n * ```tsx\n * const { value, isLoading, error } = usePublicConfig('API_URL');\n * ```\n */\nexport function usePublicConfig<T = unknown>(key: string, environment?: string): UseConfigResult<T> {\n    return useConfigValue(key, environment) as UseConfigResult<T>;\n}\n\n/**\n * Fetch a secret config value by key.\n *\n * ```tsx\n * const { value, isLoading } = useSecretConfig('DATABASE_URL');\n * ```\n */\nexport function useSecretConfig<T = unknown>(key: string, environment?: string): UseConfigResult<T> {\n    return useConfigValue(key, environment) as UseConfigResult<T>;\n}\n\n/**\n * Fetch a feature flag value by key.\n *\n * ```tsx\n * const { value: enableNewUI } = useFeatureFlag<boolean>('ENABLE_NEW_UI');\n * ```\n */\nexport function useFeatureFlag<T = unknown>(key: string, environment?: string): UseConfigResult<T> {\n    return useConfigValue(key, environment) as UseConfigResult<T>;\n}\n","'use client';\n\nimport { createContext, useContext, useMemo, type ReactNode } from 'react';\nimport { ConfigClient, type ConfigClientOptions } from '../platform/client';\n\nconst ConfigContext = createContext<ConfigClient | null>(null);\n\nexport interface ConfigProviderProps extends ConfigClientOptions {\n    children: ReactNode;\n}\n\n/**\n * Provides a ConfigClient instance to all descendant components.\n *\n * ```tsx\n * <ConfigProvider baseUrl=\"https://api.smooai.dev\" apiKey=\"...\" orgId=\"...\" environment=\"production\">\n *   <App />\n * </ConfigProvider>\n * ```\n *\n * All props are optional if the corresponding environment variables are set:\n *   SMOOAI_CONFIG_API_URL, SMOOAI_CONFIG_API_KEY, SMOOAI_CONFIG_ORG_ID, SMOOAI_CONFIG_ENV\n */\nexport function ConfigProvider({ children, ...options }: ConfigProviderProps) {\n    const client = useMemo(() => new ConfigClient(options), [options.baseUrl, options.apiKey, options.orgId, options.environment]);\n\n    return <ConfigContext.Provider value={client}>{children}</ConfigContext.Provider>;\n}\n\n/**\n * Access the ConfigClient instance from the nearest ConfigProvider.\n * Throws if used outside a ConfigProvider.\n */\nexport function useConfigClient(): ConfigClient {\n    const client = useContext(ConfigContext);\n    if (!client) {\n        throw new Error('useConfigClient must be used within a <ConfigProvider>');\n    }\n    return client;\n}\n"],"mappings":";;;;;AAEA,SAAS,aAAa,WAAW,gBAAgB;;;ACAjD,SAAS,eAAe,YAAY,eAA+B;AAwBxD;AArBX,IAAM,gBAAgB,cAAmC,IAAI;AAkBtD,SAAS,eAAe,EAAE,UAAU,GAAG,QAAQ,GAAwB;AAC1E,QAAM,SAAS,QAAQ,MAAM,IAAI,aAAa,OAAO,GAAG,CAAC,QAAQ,SAAS,QAAQ,QAAQ,QAAQ,OAAO,QAAQ,WAAW,CAAC;AAE7H,SAAO,oBAAC,cAAc,UAAd,EAAuB,OAAO,QAAS,UAAS;AAC5D;AAMO,SAAS,kBAAgC;AAC5C,QAAM,SAAS,WAAW,aAAa;AACvC,MAAI,CAAC,QAAQ;AACT,UAAM,IAAI,MAAM,wDAAwD;AAAA,EAC5E;AACA,SAAO;AACX;;;ADvBA,SAAS,eAAe,KAAa,aAAuC;AACxE,QAAM,SAAS,gBAAgB;AAC/B,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAkB,MAAS;AACrD,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,IAAI;AAC/C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAuB,IAAI;AACrD,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,CAAC;AAE9C,QAAM,UAAU,YAAY,MAAM;AAC9B,WAAO,gBAAgB;AACvB,kBAAc,CAAC,MAAM,IAAI,CAAC;AAAA,EAC9B,GAAG,CAAC,MAAM,CAAC;AAEX,YAAU,MAAM;AACZ,QAAI,YAAY;AAChB,iBAAa,IAAI;AACjB,aAAS,IAAI;AAEb,WACK,SAAS,KAAK,WAAW,EACzB,KAAK,CAAC,WAAW;AACd,UAAI,CAAC,WAAW;AACZ,iBAAS,MAAM;AACf,qBAAa,KAAK;AAAA,MACtB;AAAA,IACJ,CAAC,EACA,MAAM,CAAC,QAAiB;AACrB,UAAI,CAAC,WAAW;AACZ,iBAAS,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC;AAC5D,qBAAa,KAAK;AAAA,MACtB;AAAA,IACJ,CAAC;AAEL,WAAO,MAAM;AACT,kBAAY;AAAA,IAChB;AAAA,EACJ,GAAG,CAAC,QAAQ,KAAK,aAAa,UAAU,CAAC;AAEzC,SAAO,EAAE,OAAO,WAAW,OAAO,QAAQ;AAC9C;AASO,SAAS,gBAA6B,KAAa,aAA0C;AAChG,SAAO,eAAe,KAAK,WAAW;AAC1C;AASO,SAAS,gBAA6B,KAAa,aAA0C;AAChG,SAAO,eAAe,KAAK,WAAW;AAC1C;AASO,SAAS,eAA4B,KAAa,aAA0C;AAC/F,SAAO,eAAe,KAAK,WAAW;AAC1C;","names":[]}