@jewel998/config 0.1.0 → 0.1.2

package/dist/client/ConfigClient.d.ts

@@ -1,5 +1,5 @@
 import type { EvaluationContext, EvaluationPlugin } from "../plugins/types.js";
-import type { CacheStorage, ConfigClient, ConfigFetcher, EventEmitterInterface, FetchGranularity, RetryConfig } from "../types";
+import type { CacheStorage, ConfigClient, ConfigFetcher, EvaluationMode, EventEmitterInterface, FetchGranularity, RetryConfig } from "../types";
 export interface ConfigClientInternals {
     data: Record<string, unknown>;
     cache: CacheStorage;
@@ -11,6 +11,8 @@ export interface ConfigClientInternals {
     plugins?: EvaluationPlugin[];
     context?: EvaluationContext;
     consentAware?: boolean;
+    evaluationMode?: EvaluationMode;
+    onContextChange?: (ctx: EvaluationContext) => void;
 }
 export declare const buildConfigClient: (internals: ConfigClientInternals) => ConfigClient;
 //# sourceMappingURL=ConfigClient.d.ts.map

package/dist/client/ConfigClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigClient.d.ts","sourceRoot":"","sources":["../../src/client/ConfigClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG/E,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EAGZ,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACZ,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC7B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,iBAAiB,GAC5B,WAAW,qBAAqB,KAC/B,YAsNF,CAAC"}
+{"version":3,"file":"ConfigClient.d.ts","sourceRoot":"","sources":["../../src/client/ConfigClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG/E,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EAGZ,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACZ,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC7B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACpD;AAED,eAAO,MAAM,iBAAiB,GAC5B,WAAW,qBAAqB,KAC/B,YAuPF,CAAC"}

package/dist/client/ConfigClient.js

@@ -6,8 +6,16 @@ export const buildConfigClient = (internals) => {
     const plugins = internals.plugins ?? [];
     let evalContext = internals.context ?? {};
     const consentAware = internals.consentAware ?? false;
+    const evaluationMode = internals.evaluationMode ?? "server";
+    const onContextChange = internals.onContextChange;
     let data = { ...internals.data };
     let batchFetchTriggered = false;
+    // ── Request deduplication & debouncing ──
+    let inflightRefresh = null;
+    let lastFetchTime = 0;
+    let contextDebounceTimer = null;
+    const MIN_FETCH_INTERVAL = 30_000; // Don't re-fetch within 30s
+    const CONTEXT_DEBOUNCE_MS = 100; // Batch rapid setContext calls
     const triggerDeferredFetch = () => {
         if (!isDeferred || batchFetchTriggered) {
             return;
@@ -158,26 +166,35 @@ export const buildConfigClient = (internals) => {
             return { ...data };
         },
         async refresh() {
-            try {
-                const result = await withRetry(() => fetcher.fetchAll(), retry);
-                cache.set("__all__", result, DEFAULT_CACHE_TTL);
-                for (const [key, value] of Object.entries(result)) {
-                    cache.set(key, value, DEFAULT_CACHE_TTL);
+            // Deduplication: if a refresh is already in-flight, reuse it
+            if (inflightRefresh)
+                return inflightRefresh;
+            inflightRefresh = (async () => {
+                try {
+                    const result = await withRetry(() => fetcher.fetchAll(), retry);
+                    cache.set("__all__", result, DEFAULT_CACHE_TTL);
+                    for (const [key, value] of Object.entries(result)) {
+                        cache.set(key, value, DEFAULT_CACHE_TTL);
+                    }
+                    data = { ...data, ...result };
+                    lastFetchTime = Date.now();
+                    events.emit("updated", {
+                        keys: Object.keys(result),
+                        source: "refresh",
+                    });
                 }
-                data = { ...data, ...result };
-                events.emit("updated", {
-                    keys: Object.keys(result),
-                    source: "refresh",
-                });
-            }
-            catch (error) {
-                events.emit("fetchError", {
-                    error: error,
-                    retryCount: retry.maxRetries,
-                    willRetry: false,
-                });
-                throw error;
-            }
+                catch (error) {
+                    events.emit("fetchError", {
+                        error: error,
+                        retryCount: retry.maxRetries,
+                        willRetry: false,
+                    });
+                }
+                finally {
+                    inflightRefresh = null;
+                }
+            })();
+            return inflightRefresh;
         },
         on(event, callback) {
             events.on(event, callback);
@@ -187,6 +204,23 @@ export const buildConfigClient = (internals) => {
         },
         setContext(newContext) {
             evalContext = { ...newContext };
+            // Notify the transport layer of the context change
+            if (onContextChange) {
+                onContextChange(evalContext);
+            }
+            // In server mode, context change means we need fresh resolved values.
+            // Debounce rapid setContext calls (e.g., form typing, navigation)
+            if (evaluationMode === "server") {
+                if (contextDebounceTimer)
+                    clearTimeout(contextDebounceTimer);
+                contextDebounceTimer = setTimeout(() => {
+                    contextDebounceTimer = null;
+                    // Skip if we fetched very recently (stale check)
+                    if (Date.now() - lastFetchTime < MIN_FETCH_INTERVAL)
+                        return;
+                    void client.refresh();
+                }, CONTEXT_DEBOUNCE_MS);
+            }
         },
     };
     return client;

package/dist/client/ConfigClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigClient.js","sourceRoot":"","sources":["../../src/client/ConfigClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConfigClient.js","sourceRoot":"","sources":["../../src/client/ConfigClient.ts"],"names":[],"mappings":"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"}

package/dist/context/autoContext.d.ts

@@ -0,0 +1,28 @@
+import type { EvaluationContext } from "../plugins/types.js";
+/**
+ * Automatically detect browser/device attributes and merge with user-provided context.
+ *
+ * Can be called two ways:
+ * 1. No args: returns auto-detected context only
+ *    `autoContext()`
+ *
+ * 2. With user attributes: auto-detects AND merges your attributes (yours win on conflict)
+ *    `autoContext({ userId: "user_123", plan: "pro", country: "US" })`
+ *
+ * @example
+ * ```ts
+ * const flags = initFlags({
+ *   clientId: "cid_xxx",
+ *   context: autoContext({ userId: "user_123", plan: "pro" }),
+ * });
+ * ```
+ */
+export declare function autoContext(user?: {
+    userId?: string;
+    [key: string]: string | number | boolean | string[] | undefined;
+}): EvaluationContext;
+/**
+ * Deep-merge two evaluation contexts. User-provided values take precedence.
+ */
+export declare function mergeContext(auto: EvaluationContext, user: EvaluationContext): EvaluationContext;
+//# sourceMappingURL=autoContext.d.ts.map

package/dist/context/autoContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoContext.d.ts","sourceRoot":"","sources":["../../src/context/autoContext.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CACjE,GAAG,iBAAiB,CAmCpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,iBAAiB,GACtB,iBAAiB,CASnB"}

package/dist/context/autoContext.js

@@ -0,0 +1,135 @@
+// ═══════════════════════════════════════════════════════════════
+// Auto-Context Detection Helpers
+// Tree-shakeable: only included if explicitly imported by consumer
+// ═══════════════════════════════════════════════════════════════
+/**
+ * Automatically detect browser/device attributes and merge with user-provided context.
+ *
+ * Can be called two ways:
+ * 1. No args: returns auto-detected context only
+ *    `autoContext()`
+ *
+ * 2. With user attributes: auto-detects AND merges your attributes (yours win on conflict)
+ *    `autoContext({ userId: "user_123", plan: "pro", country: "US" })`
+ *
+ * @example
+ * ```ts
+ * const flags = initFlags({
+ *   clientId: "cid_xxx",
+ *   context: autoContext({ userId: "user_123", plan: "pro" }),
+ * });
+ * ```
+ */
+export function autoContext(user) {
+    const detected = {
+        attributes: {},
+    };
+    if (typeof window !== "undefined" && typeof navigator !== "undefined") {
+        const ua = navigator.userAgent;
+        detected.attributes = {
+            browser: detectBrowser(ua),
+            browserVersion: detectBrowserVersion(ua),
+            os: detectOS(ua),
+            device: detectDevice(),
+            screenWidth: window.screen?.width ?? 0,
+            screenHeight: window.screen?.height ?? 0,
+            locale: navigator.language ?? "en",
+            timezone: getTimezone(),
+        };
+    }
+    if (!user)
+        return detected;
+    // Extract userId from the user object, rest goes to attributes
+    const { userId, ...attrs } = user;
+    const userAttrs = {};
+    for (const [k, v] of Object.entries(attrs)) {
+        if (v !== undefined)
+            userAttrs[k] = v;
+    }
+    return {
+        userId,
+        attributes: {
+            ...(detected.attributes ?? {}),
+            ...userAttrs,
+        },
+    };
+}
+/**
+ * Deep-merge two evaluation contexts. User-provided values take precedence.
+ */
+export function mergeContext(auto, user) {
+    return {
+        userId: user.userId ?? auto.userId,
+        attributes: {
+            ...(auto.attributes ?? {}),
+            ...(user.attributes ?? {}),
+        },
+        consentGranted: user.consentGranted ?? auto.consentGranted,
+    };
+}
+// ═══════════════════════════════════════════════════════════════
+// Detection Helpers (lightweight, no external deps)
+// ═══════════════════════════════════════════════════════════════
+function detectBrowser(ua) {
+    if (ua.includes("Firefox/"))
+        return "Firefox";
+    if (ua.includes("Edg/"))
+        return "Edge";
+    if (ua.includes("OPR/") || ua.includes("Opera"))
+        return "Opera";
+    if (ua.includes("Chrome/") && !ua.includes("Edg/"))
+        return "Chrome";
+    if (ua.includes("Safari/") && !ua.includes("Chrome/"))
+        return "Safari";
+    return "Unknown";
+}
+function detectBrowserVersion(ua) {
+    const patterns = [
+        ["Firefox", /Firefox\/(\d+[\d.]*)/],
+        ["Edge", /Edg\/(\d+[\d.]*)/],
+        ["Opera", /OPR\/(\d+[\d.]*)/],
+        ["Chrome", /Chrome\/(\d+[\d.]*)/],
+        ["Safari", /Version\/(\d+[\d.]*)/],
+    ];
+    for (const [, regex] of patterns) {
+        const match = ua.match(regex);
+        if (match?.[1])
+            return match[1];
+    }
+    return "0";
+}
+function detectOS(ua) {
+    if (ua.includes("Windows"))
+        return "Windows";
+    if (ua.includes("Mac OS"))
+        return "macOS";
+    if (ua.includes("Linux") && !ua.includes("Android"))
+        return "Linux";
+    if (ua.includes("Android"))
+        return "Android";
+    if (/iPhone|iPad|iPod/.test(ua))
+        return "iOS";
+    if (ua.includes("CrOS"))
+        return "ChromeOS";
+    return "Unknown";
+}
+function detectDevice() {
+    if (typeof window === "undefined")
+        return "desktop";
+    const width = window.screen?.width ?? window.innerWidth;
+    const hasTouch = "ontouchstart" in window || navigator.maxTouchPoints > 0;
+    if (hasTouch && width < 768)
+        return "mobile";
+    if (hasTouch && width >= 768 && width < 1024)
+        return "tablet";
+    return "desktop";
+}
+function getTimezone() {
+    try {
+        return Intl.DateTimeFormat().resolvedOptions().timeZone;
+    }
+    catch {
+        return "UTC";
+    }
+}
+//# sourceMappingURL=autoContext.js.map

package/dist/context/autoContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoContext.js","sourceRoot":"","sources":["../../src/context/autoContext.ts"],"names":[],"mappings":"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"}

package/dist/createConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createConfig.d.ts","sourceRoot":"","sources":["../src/createConfig.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AAMjB,wBAAgB,YAAY,CAC1B,OAAO,EAAE,mBAAmB,GAAG;IAAE,eAAe,EAAE,aAAa,CAAA;CAAE,GAChE,OAAO,CAAC,YAAY,CAAC,CAAC;AACzB,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAC"}
+{"version":3,"file":"createConfig.d.ts","sourceRoot":"","sources":["../src/createConfig.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AAKjB,wBAAgB,YAAY,CAC1B,OAAO,EAAE,mBAAmB,GAAG;IAAE,eAAe,EAAE,aAAa,CAAA;CAAE,GAChE,OAAO,CAAC,YAAY,CAAC,CAAC;AACzB,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAC"}

package/dist/createConfig.js

@@ -9,7 +9,7 @@ import { executeOptimistic } from "./loading/optimistic";
 import { executePessimistic } from "./loading/pessimistic";
 import { createHttpTransport } from "./transport/HttpTransport";
 import { DEFAULT_RETRY, DEFAULT_TIMEOUT } from "./types";
-const DEFAULT_BASE_URL = "https://us-central1-jewel998-config.cloudfunctions.net";
+const DEFAULT_BASE_URL = "https://jewel998-config.web.app/api";
 export function createConfig(options) {
     // 1. Validate clientId
     if (!options.clientId) {
@@ -26,16 +26,26 @@ export function createConfig(options) {
     const retry = { ...DEFAULT_RETRY, ...options.retry };
     const timeout = options.timeout ?? DEFAULT_TIMEOUT;
     const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
-    // 4. Create internal modules
+    // Auto-detect evaluation mode from key prefix:
+    // cid_ = client key → server evaluates (frontend)
+    // svr_ = server key → client evaluates locally (backend)
+    const evaluationMode = options.clientId.startsWith("svr_")
+        ? "client"
+        : "server";
+    // 4. Maintain a mutable context reference for server mode
+    let currentContext = options.context ?? {};
+    // 5. Create internal modules
     const transport = createHttpTransport({
         baseUrl,
         clientId: options.clientId,
+        evaluationMode,
+        getContext: () => currentContext,
     });
     const events = new TypedEventEmitter();
     const fetcher = granularity === "batch"
         ? createBatchFetcher(transport)
         : createProjectedFetcher(transport);
-    // 5. Create loading context
+    // 6. Create loading context
     const context = {
         clientId: options.clientId,
         fetcher,
@@ -45,7 +55,9 @@ export function createConfig(options) {
         timeout,
         granularity,
     };
-    // 6. Execute strategy
+    // 7. In server mode, plugins are not needed (API resolves everything)
+    const plugins = evaluationMode === "client" ? options.plugins : undefined;
+    // 8. Execute strategy
     if (strategy === "pessimistic") {
         return executePessimistic(context).then((result) => {
             const client = buildConfigClient({
@@ -56,9 +68,13 @@ export function createConfig(options) {
                 retry,
                 granularity,
                 isDeferred: false,
-                plugins: options.plugins,
+                plugins,
                 context: options.context,
                 consentAware: options.consentAware,
+                evaluationMode,
+                onContextChange: (ctx) => {
+                    currentContext = ctx;
+                },
             });
             events.emit("ready", {
                 loadingStrategy: "pessimistic",
@@ -77,9 +93,13 @@ export function createConfig(options) {
             retry,
             granularity,
             isDeferred: true,
-            plugins: options.plugins,
+            plugins,
             context: options.context,
             consentAware: options.consentAware,
+            evaluationMode,
+            onContextChange: (ctx) => {
+                currentContext = ctx;
+            },
         });
         events.emit("ready", {
             loadingStrategy: "deferred",
@@ -97,9 +117,13 @@ export function createConfig(options) {
         retry,
         granularity,
         isDeferred: false,
-        plugins: options.plugins,
+        plugins,
         context: options.context,
         consentAware: options.consentAware,
+        evaluationMode,
+        onContextChange: (ctx) => {
+            currentContext = ctx;
+        },
     });
     events.emit("ready", {
         loadingStrategy: "optimistic",

package/dist/createConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"createConfig.js","sourceRoot":"","sources":["../src/createConfig.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"createConfig.js","sourceRoot":"","sources":["../src/createConfig.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,23 +1,14 @@
+export { initConfig } from "./initConfig";
+export type { InitConfigOptions, Flags } from "./initConfig";
 export { createConfig } from "./createConfig";
-export type { CacheStorage, ClientIdRecord, ConfigClient, ConfigEventCallback, ConfigEventPayloads, ConfigEventType, ConfigRecord, CreateConfigOptions, EnvironmentRecord, FetchGranularity, LoadingStrategy, ProjectRecord, RetryConfig, } from "./types";
+export type { CacheStorage, ClientIdRecord, ConfigClient, ConfigEventCallback, ConfigEventPayloads, ConfigEventType, ConfigRecord, CreateConfigOptions, EnvironmentRecord, EvaluationWarning, FetchGranularity, LoadingStrategy, ProjectRecord, RetryConfig, } from "./types";
 export type { EvaluationContext, EvaluationPlugin, PipelineStepId, PipelineStepResult, PipelineHelpers, } from "./plugins/types.js";
 export { PIPELINE_ORDER } from "./plugins/types.js";
+export { autoContext, mergeContext } from "./context/autoContext";
+export { WEBHOOK_FORMATS, WEBHOOK_FORMAT_INFO, TEMPLATE_VARIABLES, WEBHOOK_EVENT_TYPES, WEBHOOK_RESOURCE_CATEGORIES, SAMPLE_WEBHOOK_EVENT, } from "./webhook-formats";
+export type { WebhookFormat, WebhookEventType, WebhookResourceCategory, } from "./webhook-formats";
 export { memoryStorage } from "./cache/memoryStorage";
 export { browserStorage } from "./cache/browserStorage";
 export { AuthenticationError, ConfigError, InitializationError, TimeoutError, } from "./errors/index";
 export type { ConfigErrorCode } from "./errors/index";
-/** @deprecated Use createConfig() instead */
-export { createConfigClient } from "./client";
-export type { ConfigClient as LegacyConfigClient, ConfigClientOptions, } from "./client";
-/** @deprecated Tenant concept removed. Use ProjectRecord instead. */
-export type { TenantRecord } from "./types";
-/** @deprecated Use ConfigRecord instead */
-export type { ConfigVersionRecord } from "./types";
-/** @deprecated Scoping is handled by clientId */
-export type { ConfigResolveContext, ConfigDefinition } from "./types";
-/** @deprecated Use LoadingStrategy instead */
-export type { ConfigScope, ConfigSourceMode } from "./types";
-export { createConfigManager } from "./management/index";
-export type { ConfigManager, ConfigManagerOptions } from "./management/index";
-export type { ConfigManagerBackend } from "./management/manager";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,YAAY,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAMtD,6CAA6C;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,YAAY,EACV,YAAY,IAAI,kBAAkB,EAClC,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAElB,qEAAqE;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,2CAA2C;AAC3C,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,iDAAiD;AACjD,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEtE,8CAA8C;AAC9C,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,YAAY,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,19 +1,18 @@
 // ═══════════════════════════════════════════════════════════════
-// New API (v0.2.0+)
+// @jewel998/config SDK
 // ═══════════════════════════════════════════════════════════════
-// Entry point
+// Primary entry point
+export { initConfig } from "./initConfig";
+// Legacy (still works, use initConfig for new projects)
 export { createConfig } from "./createConfig";
 export { PIPELINE_ORDER } from "./plugins/types.js";
+// Context helpers (tree-shakeable)
+export { autoContext, mergeContext } from "./context/autoContext";
+// Webhook format constants (shared between portal, docs, functions)
+export { WEBHOOK_FORMATS, WEBHOOK_FORMAT_INFO, TEMPLATE_VARIABLES, WEBHOOK_EVENT_TYPES, WEBHOOK_RESOURCE_CATEGORIES, SAMPLE_WEBHOOK_EVENT, } from "./webhook-formats";
 // Cache adapters
 export { memoryStorage } from "./cache/memoryStorage";
 export { browserStorage } from "./cache/browserStorage";
 // Errors
 export { AuthenticationError, ConfigError, InitializationError, TimeoutError, } from "./errors/index";
-// ═══════════════════════════════════════════════════════════════
-// Deprecated API (kept for Phase 1 migration, remove in v1.0.0)
-// ═══════════════════════════════════════════════════════════════
-/** @deprecated Use createConfig() instead */
-export { createConfigClient } from "./client";
-// Management (Portal only — still active)
-export { createConfigManager } from "./management/index";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,oBAAoB;AACpB,kEAAkE;AAElE,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA4B9C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,SAAS;AACT,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAGxB,kEAAkE;AAClE,gEAAgE;AAChE,kEAAkE;AAElE,6CAA6C;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAkB9C,0CAA0C;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,uBAAuB;AACvB,kEAAkE;AAElE,sBAAsB;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,wDAAwD;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA6B9C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,mCAAmC;AACnC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAElE,oEAAoE;AACpE,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAO3B,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,SAAS;AACT,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/initConfig.d.ts

@@ -0,0 +1,66 @@
+import type { ConfigEventCallback, ConfigEventType } from "./types";
+import type { EvaluationContext } from "./plugins/types.js";
+export interface InitConfigOptions {
+    /** Required. API key from the portal (cid_ for client, svr_ for server). */
+    clientId: string;
+    /**
+     * Default/fallback values returned instantly before the API responds.
+     * Keys are flag names, values are what your app uses immediately (optimistic).
+     */
+    defaults?: Record<string, unknown>;
+    /** User context for targeting evaluation. Use autoContext() to auto-detect browser info. */
+    context?: EvaluationContext;
+    /**
+     * Your self-hosted API URL. Points to your Firebase deployment.
+     * Default: https://jewel998-config.web.app/api (demo instance)
+     *
+     * @example "https://your-project.web.app/api"
+     */
+    baseUrl?: string;
+    /**
+     * Polling interval in milliseconds for version checks.
+     * The SDK periodically calls /api/version (lightweight ~100 bytes)
+     * and only re-fetches full data when the version changes.
+     *
+     * Default: 300000 (5 minutes). Set to 0 to disable polling.
+     */
+    pollInterval?: number;
+}
+export interface Flags {
+    /** Get a flag value. Returns the default until the API responds, then the resolved value. */
+    get<T = unknown>(key: string): T;
+    /** Get a boolean flag. Returns false if the flag doesn't exist. */
+    flag(key: string): boolean;
+    /** Get all resolved flag values. */
+    all(): Record<string, unknown>;
+    /** Update user context. Triggers a re-fetch in client-key mode. */
+    setContext(context: EvaluationContext): void;
+    /** Force re-fetch from the API. */
+    refresh(): Promise<void>;
+    /** Subscribe to events: "ready", "updated", "fetchError" */
+    on<E extends ConfigEventType>(event: E, cb: ConfigEventCallback<E>): void;
+    /** Unsubscribe from events. */
+    off<E extends ConfigEventType>(event: E, cb: ConfigEventCallback<E>): void;
+}
+/**
+ * Initialize the feature flags SDK.
+ *
+ * Returns a Flags instance that immediately serves default values,
+ * then resolves to real values from the API in the background.
+ *
+ * @example
+ * ```ts
+ * const flags = initConfig({
+ *   clientId: "cid_xxx",
+ *   defaults: { "feature.dark_mode": false },
+ *   context: autoContext({ userId: "user_123", plan: "pro" }),
+ * });
+ *
+ * flags.get("feature.dark_mode"); // → false (instant)
+ * flags.on("updated", () => {
+ *   flags.get("feature.dark_mode"); // → true (from API)
+ * });
+ * ```
+ */
+export declare function initConfig(options: InitConfigOptions): Flags;
+//# sourceMappingURL=initConfig.d.ts.map

package/dist/initConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initConfig.d.ts","sourceRoot":"","sources":["../src/initConfig.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAEV,mBAAmB,EACnB,eAAe,EAEhB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,4FAA4F;IAC5F,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAE5B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,KAAK;IACpB,6FAA6F;IAC7F,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;IAEjC,mEAAmE;IACnE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3B,oCAAoC;IACpC,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,mEAAmE;IACnE,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE7C,mCAAmC;IACnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,4DAA4D;IAC5D,EAAE,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAE1E,+BAA+B;IAC/B,GAAG,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CAC5E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,KAAK,CA4G5D"}