@jewel998/config 0.1.0

package/dist/plugins/types.js

@@ -0,0 +1,13 @@
+// ═══════════════════════════════════════════════════════════════
+// Plugin System Types and Pipeline Interfaces
+// ═══════════════════════════════════════════════════════════════
+/** The fixed execution order (per Requirement 11) */
+export const PIPELINE_ORDER = [
+    "archived",
+    "prerequisites",
+    "overrides",
+    "schedule",
+    "targeting",
+    "rollout",
+];
+//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,8CAA8C;AAC9C,kEAAkE;AAalE,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,UAAU;IACV,eAAe;IACf,WAAW;IACX,UAAU;IACV,WAAW;IACX,SAAS;CACV,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,9 @@
+import type { ConfigDefinition } from "./types";
+export interface ConfigRegistry {
+    definitions: ConfigDefinition[];
+    get(key: string): ConfigDefinition | undefined;
+    add(definition: ConfigDefinition): void;
+    remove(key: string): void;
+}
+export declare const createConfigRegistry: (definitions?: ConfigDefinition[]) => ConfigRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAC/C,GAAG,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,eAAO,MAAM,oBAAoB,GAC/B,cAAa,gBAAgB,EAAO,KACnC,cAuBF,CAAC"}

package/dist/registry.js

@@ -0,0 +1,22 @@
+export const createConfigRegistry = (definitions = []) => {
+    const items = [...definitions];
+    return {
+        definitions: items,
+        get: (key) => items.find((definition) => definition.key === key),
+        add: (definition) => {
+            const existingIndex = items.findIndex((entry) => entry.key === definition.key);
+            if (existingIndex >= 0) {
+                items[existingIndex] = definition;
+                return;
+            }
+            items.push(definition);
+        },
+        remove: (key) => {
+            const index = items.findIndex((definition) => definition.key === key);
+            if (index >= 0) {
+                items.splice(index, 1);
+            }
+        },
+    };
+};
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,cAAkC,EAAE,EACpB,EAAE;IAClB,MAAM,KAAK,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;IAE/B,OAAO;QACL,WAAW,EAAE,KAAK;QAClB,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC;QACxE,GAAG,EAAE,CAAC,UAA4B,EAAE,EAAE;YACpC,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CACnC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,UAAU,CAAC,GAAG,CACxC,CAAC;YACF,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC;gBAClC,OAAO;YACT,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE;YACtB,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;YACtE,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/remote/firebase-adapter.d.ts

@@ -0,0 +1,6 @@
+import type { RemoteConfigProvider } from "./provider";
+export interface FirebaseRemoteConfigOptions {
+    fetcher?: (key: string) => Promise<unknown>;
+}
+export declare const createFirebaseRemoteConfigProvider: (options?: FirebaseRemoteConfigOptions) => RemoteConfigProvider;
+//# sourceMappingURL=firebase-adapter.d.ts.map

package/dist/remote/firebase-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-adapter.d.ts","sourceRoot":"","sources":["../../src/remote/firebase-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7C;AAED,eAAO,MAAM,kCAAkC,GAC7C,UAAS,2BAAgC,KACxC,oBAWD,CAAC"}

package/dist/remote/firebase-adapter.js

@@ -0,0 +1,12 @@
+export const createFirebaseRemoteConfigProvider = (options = {}) => ({
+    getValue: async (key) => {
+        const fetcher = options.fetcher;
+        if (!fetcher) {
+            return undefined;
+        }
+        const value = await fetcher(key);
+        return value;
+    },
+    refresh: async () => { },
+});
+//# sourceMappingURL=firebase-adapter.js.map

package/dist/remote/firebase-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-adapter.js","sourceRoot":"","sources":["../../src/remote/firebase-adapter.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAChD,UAAuC,EAAE,EACnB,EAAE,CAAC,CAAC;IAC1B,QAAQ,EAAE,KAAK,EAAK,GAAW,EAAE,EAAE;QACjC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAA0B,CAAC;QACpC,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,KAAsB,CAAC;IAChC,CAAC;IACD,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;CACxB,CAAC,CAAC"}

package/dist/remote/provider.d.ts

@@ -0,0 +1,6 @@
+export interface RemoteConfigProvider {
+    getValue<T>(key: string): Promise<T | undefined>;
+    refresh(): Promise<void>;
+}
+export declare const createRemoteConfigProvider: () => RemoteConfigProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/remote/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/remote/provider.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,eAAO,MAAM,0BAA0B,QAAO,oBAG5C,CAAC"}

package/dist/remote/provider.js

@@ -0,0 +1,5 @@
+export const createRemoteConfigProvider = () => ({
+    getValue: async () => undefined,
+    refresh: async () => { },
+});
+//# sourceMappingURL=provider.js.map

package/dist/remote/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/remote/provider.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAyB,EAAE,CAAC,CAAC;IACrE,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;IAC/B,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;CACxB,CAAC,CAAC"}

package/dist/retry/RetryEngine.d.ts

@@ -0,0 +1,5 @@
+import type { RetryConfig } from "../types";
+export declare const sleep: (ms: number) => Promise<void>;
+export declare const isNonRetryableError: (error: unknown) => boolean;
+export declare const withRetry: <T>(fn: () => Promise<T>, options?: RetryConfig, onRetry?: (attempt: number, error: Error, nextDelay: number) => void) => Promise<T>;
+//# sourceMappingURL=RetryEngine.d.ts.map

package/dist/retry/RetryEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryEngine.d.ts","sourceRoot":"","sources":["../../src/retry/RetryEngine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACI,CAAC;AAEpD,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,OAQpD,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,CAAC,EAC/B,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,WAAW,EACrB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,KACnE,OAAO,CAAC,CAAC,CA6BX,CAAC"}

package/dist/retry/RetryEngine.js

@@ -0,0 +1,36 @@
+import { AuthenticationError, ConfigError } from "../errors/index";
+import { DEFAULT_RETRY } from "../types";
+export const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export const isNonRetryableError = (error) => {
+    if (error instanceof AuthenticationError) {
+        return true;
+    }
+    if (error instanceof ConfigError && error.code === "REVOKED") {
+        return true;
+    }
+    return false;
+};
+export const withRetry = async (fn, options, onRetry) => {
+    const config = { ...DEFAULT_RETRY, ...options };
+    let lastError;
+    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (isNonRetryableError(error)) {
+                throw error;
+            }
+            if (attempt < config.maxRetries) {
+                const delay = Math.min(config.baseDelay * Math.pow(config.multiplier, attempt), config.maxDelay);
+                // Add jitter (±25%) to prevent thundering herd
+                const jitter = delay * (0.75 + Math.random() * 0.5);
+                onRetry?.(attempt + 1, lastError, jitter);
+                await sleep(jitter);
+            }
+        }
+    }
+    throw lastError;
+};
+//# sourceMappingURL=RetryEngine.js.map

package/dist/retry/RetryEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryEngine.js","sourceRoot":"","sources":["../../src/retry/RetryEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAAW,EAAE;IAC7D,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC5B,EAAoB,EACpB,OAAqB,EACrB,OAAoE,EACxD,EAAE;IACd,MAAM,MAAM,GAA0B,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,EAAE,CAAC;IACvE,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QAC9D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAC;YAE3B,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;gBAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,EACvD,MAAM,CAAC,QAAQ,CAChB,CAAC;gBACF,+CAA+C;gBAC/C,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;gBAEpD,OAAO,EAAE,CAAC,OAAO,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC1C,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAU,CAAC;AACnB,CAAC,CAAC"}

package/dist/transport/HttpTransport.d.ts

@@ -0,0 +1,7 @@
+import type { HttpTransport } from "../types";
+export interface TransportConfig {
+    baseUrl: string;
+    clientId: string;
+}
+export declare const createHttpTransport: (config: TransportConfig) => HttpTransport;
+//# sourceMappingURL=HttpTransport.d.ts.map

package/dist/transport/HttpTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpTransport.d.ts","sourceRoot":"","sources":["../../src/transport/HttpTransport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,eAAe,KACtB,aAyCD,CAAC"}

package/dist/transport/HttpTransport.js

@@ -0,0 +1,34 @@
+/// <reference lib="dom" />
+import { AuthenticationError, ConfigError } from "../errors/index";
+export const createHttpTransport = (config) => ({
+    async request(endpoint, body) {
+        const url = `${config.baseUrl}/${endpoint}`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                data: {
+                    clientId: config.clientId,
+                    ...body,
+                },
+            }),
+        });
+        if (!response.ok) {
+            const errorBody = await response.json().catch(() => ({}));
+            const errorData = errorBody;
+            const code = errorData.error?.code ?? "NETWORK_ERROR";
+            const message = errorData.error?.message ?? `HTTP ${response.status}`;
+            if (response.status === 401) {
+                throw new AuthenticationError(message);
+            }
+            if (response.status === 429) {
+                throw new ConfigError(message, "RATE_LIMITED");
+            }
+            throw new ConfigError(message, code);
+        }
+        return (await response.json());
+    },
+});
+//# sourceMappingURL=HttpTransport.js.map

package/dist/transport/HttpTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpTransport.js","sourceRoot":"","sources":["../../src/transport/HttpTransport.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAQnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,MAAuB,EACR,EAAE,CAAC,CAAC;IACnB,KAAK,CAAC,OAAO,CACX,QAAgB,EAChB,IAA8B;QAE9B,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,QAAQ,EAAE,CAAC;QAE5C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE;oBACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,GAAG,IAAI;iBACR;aACF,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1D,MAAM,SAAS,GAAG,SAEjB,CAAC;YACF,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,IAAI,eAAe,CAAC;YACtD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,IAAI,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;YAEtE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACzC,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACjD,CAAC;YAED,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,IAAuB,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;IACtC,CAAC;CACF,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,217 @@
+import type { EvaluationContext, EvaluationPlugin } from "./plugins/types.js";
+/** Loading strategy for SDK initialization */
+export type LoadingStrategy = "optimistic" | "pessimistic" | "deferred";
+/** Fetch granularity for remote config retrieval */
+export type FetchGranularity = "batch" | "projected";
+/** Default cache TTL: 7 days in milliseconds */
+export declare const DEFAULT_CACHE_TTL: number;
+/** Default pessimistic timeout in milliseconds */
+export declare const DEFAULT_TIMEOUT = 10000;
+export interface CreateConfigOptions {
+    /** Required. The clientId token generated in the Portal. */
+    clientId: string;
+    /**
+     * Loading strategy for initialization.
+     * - "optimistic" (default): Sync return, background fetch
+     * - "pessimistic": Async, blocks until fetch completes
+     * - "deferred": Sync return, lazy fetch on first access
+     */
+    loadingStrategy?: LoadingStrategy;
+    /**
+     * Fetch granularity for remote config retrieval.
+     * - "batch" (default): Fetch all keys in one request
+     * - "projected": Fetch only requested keys on demand
+     */
+    fetchGranularity?: FetchGranularity;
+    /** Cache storage adapter. Default: memoryStorage() */
+    storage?: CacheStorage;
+    /** Retry configuration for failed fetches */
+    retry?: RetryConfig;
+    /** Timeout for pessimistic loading (ms). Default: 10000 */
+    timeout?: number;
+    /** Cloud Function base URL (override for testing/custom deployments) */
+    baseUrl?: string;
+    /** Evaluation plugins to register (tree-shakeable pipeline steps) */
+    plugins?: EvaluationPlugin[];
+    /** Evaluation context for plugin pipeline (can be updated post-init via setContext) */
+    context?: EvaluationContext;
+    /** Enable consent-aware mode (GDPR): if true and context.consentGranted !== true, returns defaults */
+    consentAware?: boolean;
+}
+export interface ConfigClient {
+    /** Get a typed config value by key. */
+    getValue<T = unknown>(key: string): T | undefined;
+    getValue<T = unknown>(key: string, defaultValue: T): T;
+    /** Get a boolean flag by key. Returns false if missing. */
+    getFlag(key: string): boolean;
+    /** Get all config key-value pairs. */
+    getAll(): Record<string, unknown>;
+    /** Force refresh from remote. Updates cache and emits 'updated'. */
+    refresh(): Promise<void>;
+    /** Update the evaluation context (used by plugins for targeting, rollout, etc.) */
+    setContext(newContext: EvaluationContext): void;
+    /** Subscribe to a lifecycle event. */
+    on<E extends ConfigEventType>(event: E, callback: ConfigEventCallback<E>): void;
+    /** Unsubscribe from a lifecycle event. */
+    off<E extends ConfigEventType>(event: E, callback: ConfigEventCallback<E>): void;
+}
+export interface RetryConfig {
+    /** Maximum number of retry attempts. Default: 3 */
+    maxRetries?: number;
+    /** Base delay in milliseconds. Default: 1000 */
+    baseDelay?: number;
+    /** Backoff multiplier. Default: 2 (exponential) */
+    multiplier?: number;
+    /** Maximum delay cap in milliseconds. Default: 30000 */
+    maxDelay?: number;
+}
+export declare const DEFAULT_RETRY: Required<RetryConfig>;
+export interface CacheStorage {
+    /** Get a value by key. Returns undefined if missing or TTL expired. */
+    get<T>(key: string): T | undefined;
+    /** Set a value with optional TTL override (ms). Default TTL: 7 days. */
+    set<T>(key: string, value: T, ttl?: number): void;
+    /** Delete a specific key from cache. */
+    delete(key: string): void;
+    /** Clear all cached values. */
+    clear(): void;
+}
+export interface CacheEntry<T = unknown> {
+    value: T;
+    expiresAt: number;
+}
+export interface BrowserStorageOptions {
+    /** localStorage key prefix. Default: "@jewel998/config" */
+    prefix?: string;
+    /** Default TTL in milliseconds. Default: 604800000 (7 days) */
+    defaultTtl?: number;
+}
+export type ConfigEventType = "ready" | "updated" | "fetchError" | "revoked";
+export interface ConfigEventPayloads {
+    ready: {
+        loadingStrategy: LoadingStrategy;
+        cachedKeys: number;
+    };
+    updated: {
+        keys: string[];
+        source: "background" | "refresh";
+    };
+    fetchError: {
+        error: Error;
+        retryCount: number;
+        willRetry: boolean;
+    };
+    revoked: {
+        clientId: string;
+        message: string;
+    };
+}
+export type ConfigEventCallback<E extends ConfigEventType> = (payload: ConfigEventPayloads[E]) => void;
+export interface LoadingContext {
+    clientId: string;
+    fetcher: ConfigFetcher;
+    cache: CacheStorage;
+    events: EventEmitterInterface;
+    retry: Required<RetryConfig>;
+    timeout: number;
+    granularity: FetchGranularity;
+}
+export interface LoadingResult {
+    initialData: Record<string, unknown>;
+    status: "ready" | "pending";
+}
+export interface LoadingStrategyHandler {
+    execute(context: LoadingContext): LoadingResult | Promise<LoadingResult>;
+}
+export interface ConfigFetcher {
+    /** Fetch all configs for the bound project+environment */
+    fetchAll(): Promise<Record<string, unknown>>;
+    /** Fetch specific keys only */
+    fetchKeys(keys: string[]): Promise<Record<string, unknown>>;
+}
+export interface HttpTransport {
+    request<T>(endpoint: string, body?: Record<string, unknown>): Promise<T>;
+}
+export interface GetConfigRequest {
+    clientId: string;
+    keys?: string[];
+}
+export interface GetConfigResponse {
+    data: Record<string, unknown>;
+    version: string;
+    timestamp: string;
+}
+export interface EventEmitterInterface {
+    on<E extends ConfigEventType>(event: E, callback: ConfigEventCallback<E>): void;
+    off<E extends ConfigEventType>(event: E, callback: ConfigEventCallback<E>): void;
+    emit<E extends ConfigEventType>(event: E, payload: ConfigEventPayloads[E]): void;
+    removeAllListeners(): void;
+}
+/** @deprecated Use CreateConfigOptions instead */
+export type ConfigScope = "tenant" | "project" | "environment";
+/** @deprecated Use LoadingStrategy instead */
+export type ConfigSourceMode = "offline" | "remote" | "hybrid";
+/** @deprecated Config definitions are no longer needed client-side */
+export interface ConfigDefinition<T = unknown> {
+    key: string;
+    defaultValue: T;
+    sourceMode: ConfigSourceMode;
+    scope: ConfigScope;
+    fallbackValue?: T;
+}
+/** @deprecated Scoping is handled by clientId */
+export interface ConfigResolveContext {
+    tenantId?: string;
+    projectId?: string;
+    environment?: string;
+}
+export interface ProjectRecord {
+    id: string;
+    name: string;
+    ownerId: string;
+    authorizedUsers: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface EnvironmentRecord {
+    id: string;
+    projectId: string;
+    name: string;
+    allowedDomains: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ClientIdRecord {
+    token: string;
+    status: "active" | "revoked";
+    createdAt: string;
+    revokedAt: string | null;
+    createdBy: string;
+    label?: string;
+}
+export interface ConfigRecord {
+    key: string;
+    value: unknown;
+    valueType: "string" | "number" | "boolean" | "json";
+    version: string;
+    publishedAt: string;
+    updatedAt: string;
+    updatedBy: string;
+}
+/** @deprecated Use ProjectRecord instead */
+export interface TenantRecord {
+    id: string;
+    name: string;
+    ownerId: string;
+    createdAt: string;
+}
+/** @deprecated Use ConfigRecord instead */
+export interface ConfigVersionRecord {
+    id: string;
+    projectId: string;
+    environmentId?: string;
+    version: string;
+    payload: Record<string, unknown>;
+    publishedAt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,14 @@
+// ═══════════════════════════════════════════════════════════════
+// Core SDK Types
+// ═══════════════════════════════════════════════════════════════
+/** Default cache TTL: 7 days in milliseconds */
+export const DEFAULT_CACHE_TTL = 7 * 24 * 60 * 60 * 1000; // 604_800_000 ms
+/** Default pessimistic timeout in milliseconds */
+export const DEFAULT_TIMEOUT = 10_000;
+export const DEFAULT_RETRY = {
+    maxRetries: 3,
+    baseDelay: 1000,
+    multiplier: 2,
+    maxDelay: 30_000,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,iBAAiB;AACjB,kEAAkE;AAUlE,gDAAgD;AAChD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,iBAAiB;AAE3E,kDAAkD;AAClD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAmGtC,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,CAAC;IACb,QAAQ,EAAE,MAAM;CACjB,CAAC"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@jewel998/config",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "sideEffects": false,
+  "description": "Free, self-hosted feature flags and remote configuration SDK",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jewel998/config.git",
+    "directory": "packages/config"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./storage": {
+      "types": "./dist/cache/memoryStorage.d.ts",
+      "import": "./dist/cache/memoryStorage.js"
+    },
+    "./management": {
+      "types": "./dist/management/index.d.ts",
+      "import": "./dist/management/index.js"
+    },
+    "./targeting": {
+      "types": "./dist/plugins/targeting/index.d.ts",
+      "import": "./dist/plugins/targeting/index.js"
+    },
+    "./rollout": {
+      "types": "./dist/plugins/rollout/index.d.ts",
+      "import": "./dist/plugins/rollout/index.js"
+    },
+    "./schedule": {
+      "types": "./dist/plugins/schedule/index.d.ts",
+      "import": "./dist/plugins/schedule/index.js"
+    },
+    "./prerequisites": {
+      "types": "./dist/plugins/prerequisites/index.d.ts",
+      "import": "./dist/plugins/prerequisites/index.js"
+    },
+    "./lifecycle": {
+      "types": "./dist/plugins/lifecycle/index.d.ts",
+      "import": "./dist/plugins/lifecycle/index.js"
+    },
+    "./overrides": {
+      "types": "./dist/plugins/overrides/index.d.ts",
+      "import": "./dist/plugins/overrides/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest run",
+    "lint": "oxlint src",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
+  }
+}