valkyries 0.1.0

package/dist/cache-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-utils.mjs","sourceRoot":"","sources":["../cache-utils.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAa,EAAU,EAAE,CAC9D,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,SAAS,CAAC;AAEtD,MAAM,qBAAqB,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM;AAC9C,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAClC,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAc,EACd,IAAqB;IAErB,IAAI,UAA2B,CAAC;IAEhC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,oBAAoB,CAAC,mCAAmC,CAAC,CAAC;QACtE,CAAC;QACD,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;SAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,oBAAoB,CAAC,qCAAqC,CAAC,CAAC;QACxE,CAAC;QACD,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,qBAAqB,EAAE,CAAC;QAC1D,UAAU,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAA0B,EAC1B,IAAqB;IAErB,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,oBAAoB,CAAC,wBAAwB,OAAO,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,MAAM,GAAW,MAAM,CAAC;IAE5B,0EAA0E;IAC1E,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACjF,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAErC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/cache.d.mts

@@ -0,0 +1,4 @@
+import { ValkeyCacheDeletes } from "./cache/deletes.mts";
+export declare class ValkeyCache<K = string> extends ValkeyCacheDeletes<K> {
+}
+//# sourceMappingURL=cache.d.mts.map

package/dist/cache.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.mts","sourceRoot":"","sources":["../cache.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,WAAW,CAAC,CAAC,GAAG,MAAM,CAAE,SAAQ,kBAAkB,CAAC,CAAC,CAAC;CAAG"}

package/dist/cache.mjs

@@ -0,0 +1,4 @@
+import { ValkeyCacheDeletes } from "./cache/deletes.mjs";
+export class ValkeyCache extends ValkeyCacheDeletes {
+}
+//# sourceMappingURL=cache.mjs.map

package/dist/cache.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.mjs","sourceRoot":"","sources":["../cache.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,OAAO,WAAwB,SAAQ,kBAAqB;CAAG"}

package/dist/clients.d.mts

@@ -0,0 +1,51 @@
+import { GlideClient, type PubSubMsg } from "@valkey/valkey-glide";
+export type ValkeyReadFrom = "primary" | "preferReplica";
+export type ValkeyClientOptions = {
+    readFrom?: ValkeyReadFrom;
+    lazyConnect?: boolean;
+};
+export declare const urlsToClients: Map<string, GlideClient>;
+export declare const cacheValkeyClient: GlideClient;
+export declare const rateLimiterValkeyClient: GlideClient;
+export declare const dynamicConfigValkeyClient: GlideClient;
+type PubSubMessageHandler = (msg: PubSubMsg) => void;
+export declare function addPubSubMessageHandler(handler: PubSubMessageHandler): void;
+export declare function removePubSubMessageHandler(handler: PubSubMessageHandler): void;
+export declare function ensureDynamicConfigValkeySubscriptionClient(): Promise<GlideClient>;
+export declare function closeDynamicConfigValkeySubscriptionClient(): Promise<void>;
+declare function handlePubSubMessage(msg: PubSubMsg): void;
+export declare function upsertValkeyClientByUrl(url: string, options?: ValkeyClientOptions): Promise<GlideClient>;
+export declare function glideConfigFromUrl(url: string, options?: ValkeyClientOptions): {
+    addresses: {
+        host: string;
+        port: number;
+    }[];
+    useTLS: boolean;
+    credentials: {
+        password: string;
+        username?: string | undefined;
+    } | undefined;
+    readFrom: ValkeyReadFrom | undefined;
+    lazyConnect: boolean;
+};
+export declare function buildDynamicConfigSubscriptionClientConfig(url: string): {
+    pubsubSubscriptions: {
+        channelsAndPatterns: {
+            1: Set<string>;
+        };
+        callback: typeof handlePubSubMessage;
+    };
+    addresses: {
+        host: string;
+        port: number;
+    }[];
+    useTLS: boolean;
+    credentials: {
+        password: string;
+        username?: string | undefined;
+    } | undefined;
+    readFrom: ValkeyReadFrom | undefined;
+    lazyConnect: boolean;
+};
+export {};
+//# sourceMappingURL=clients.d.mts.map

package/dist/clients.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.mts","sourceRoot":"","sources":["../clients.mts"],"names":[],"mappings":"AACA,OAAO,EAEL,WAAW,EAEX,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAM9B,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,eAAe,CAAC;AAEzD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,aAAa,0BAAiC,CAAC;AAE5D,eAAO,MAAM,iBAAiB,aAE5B,CAAC;AACH,eAAO,MAAM,uBAAuB,aAElC,CAAC;AACH,eAAO,MAAM,yBAAyB,aAEpC,CAAC;AAIH,KAAK,oBAAoB,GAAG,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;AAGrD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAE3E;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAE9E;AAED,wBAAgB,2CAA2C,IAAI,OAAO,CAAC,WAAW,CAAC,CAclF;AAED,wBAAsB,0CAA0C,IAAI,OAAO,CAAC,IAAI,CAAC,CAShF;AAED,iBAAS,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAEjD;AAED,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAQtB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;;;;;;;;;;;;EAwB5E;AAED,wBAAgB,0CAA0C,CAAC,GAAG,EAAE,MAAM;;;;;;;;;;;;;;;;;;EAUrE"}

package/dist/clients.mjs

@@ -0,0 +1,95 @@
+import { setTimeout as sleep } from "node:timers/promises";
+import { ALL_PATTERNS, GlideClient, GlideClientConfiguration, } from "@valkey/valkey-glide";
+import { config } from "./config.mjs";
+import { handleValkeyError } from "./errors.mjs";
+const CLIENT_CLOSE_SETTLE_MS = 100;
+export const urlsToClients = new Map();
+export const cacheValkeyClient = await upsertValkeyClientByUrl(config.cache_url, {
+    readFrom: "preferReplica",
+});
+export const rateLimiterValkeyClient = await upsertValkeyClientByUrl(config.rate_limiter_url, {
+    readFrom: "primary",
+});
+export const dynamicConfigValkeyClient = await upsertValkeyClientByUrl(config.dynamic_config_url, {
+    readFrom: "preferReplica",
+});
+let dynamicConfigValkeySubscriptionClientPromise = null;
+const pubSubMessageHandlers = new Set();
+export function addPubSubMessageHandler(handler) {
+    pubSubMessageHandlers.add(handler);
+}
+export function removePubSubMessageHandler(handler) {
+    pubSubMessageHandlers.delete(handler);
+}
+export function ensureDynamicConfigValkeySubscriptionClient() {
+    if (dynamicConfigValkeySubscriptionClientPromise)
+        return dynamicConfigValkeySubscriptionClientPromise;
+    const clientPromise = GlideClient.createClient(buildDynamicConfigSubscriptionClientConfig(config.dynamic_config_url)).catch((error) => {
+        dynamicConfigValkeySubscriptionClientPromise = null;
+        handleValkeyError(error);
+        throw error;
+    });
+    dynamicConfigValkeySubscriptionClientPromise = clientPromise;
+    return clientPromise;
+}
+export async function closeDynamicConfigValkeySubscriptionClient() {
+    const clientPromise = dynamicConfigValkeySubscriptionClientPromise;
+    if (!clientPromise)
+        return;
+    dynamicConfigValkeySubscriptionClientPromise = null;
+    const client = await clientPromise;
+    await client.punsubscribe(ALL_PATTERNS, 5_000);
+    client.close();
+    await sleep(CLIENT_CLOSE_SETTLE_MS);
+}
+function handlePubSubMessage(msg) {
+    for (const handler of pubSubMessageHandlers)
+        handler(msg);
+}
+export async function upsertValkeyClientByUrl(url, options) {
+    const effectiveLazyConnect = options?.lazyConnect ?? true;
+    const cacheKey = `${url}:${options?.readFrom ?? "default"}:${effectiveLazyConnect}`;
+    const existing = urlsToClients.get(cacheKey);
+    if (existing)
+        return existing;
+    const client = await GlideClient.createClient(glideConfigFromUrl(url, options));
+    urlsToClients.set(cacheKey, client);
+    return client;
+}
+export function glideConfigFromUrl(url, options) {
+    try {
+        const parsed = new URL(url);
+        return {
+            addresses: [
+                {
+                    host: parsed.hostname,
+                    port: parsed.port ? Number(parsed.port) : 6379,
+                },
+            ],
+            useTLS: parsed.protocol === "rediss:",
+            credentials: parsed.password
+                ? {
+                    ...(parsed.username ? { username: parsed.username } : {}),
+                    password: parsed.password,
+                }
+                : undefined,
+            readFrom: options?.readFrom,
+            lazyConnect: options?.lazyConnect ?? true,
+        };
+    }
+    catch (cause) {
+        throw new Error(`Invalid Valkey URL: ${url}`, { cause });
+    }
+}
+export function buildDynamicConfigSubscriptionClientConfig(url) {
+    return {
+        ...glideConfigFromUrl(url, { readFrom: "preferReplica", lazyConnect: false }),
+        pubsubSubscriptions: {
+            channelsAndPatterns: {
+                [GlideClientConfiguration.PubSubChannelModes.Pattern]: new Set(["dynamic-config:*"]),
+            },
+            callback: handlePubSubMessage,
+        },
+    };
+}
+//# sourceMappingURL=clients.mjs.map

package/dist/clients.mjs.map

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

package/dist/config.d.mts

@@ -0,0 +1,6 @@
+export declare const config: {
+    cache_url: string;
+    rate_limiter_url: string;
+    dynamic_config_url: string;
+};
+//# sourceMappingURL=config.d.mts.map

package/dist/config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.mts","sourceRoot":"","sources":["../config.mts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM;;;;CAUlB,CAAC"}

package/dist/config.mjs

@@ -0,0 +1,10 @@
+const DEFAULT_VALKEY_URL = process.env.VALKEY_URL || `redis://${process.env.DOCKER_HOST_IP || "localhost"}:6379`;
+export const config = {
+    // used for caching; preferReplica routes writes to primary automatically
+    cache_url: process.env.VALKEY_CACHE_URL || DEFAULT_VALKEY_URL,
+    // used for rate limiting; must always read from primary to avoid replica lag
+    rate_limiter_url: process.env.VALKEY_RATE_LIMITER_URL || process.env.VALKEY_CACHE_URL || DEFAULT_VALKEY_URL,
+    // used for distributed configuration
+    dynamic_config_url: process.env.VALKEY_DYNAMIC_CONFIG_URL || DEFAULT_VALKEY_URL,
+};
+//# sourceMappingURL=config.mjs.map

package/dist/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","sourceRoot":"","sources":["../config.mts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GACtB,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,WAAW,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,WAAW,OAAO,CAAC;AAExF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,kBAAkB;IAE7D,6EAA6E;IAC7E,gBAAgB,EACd,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,kBAAkB;IAE3F,qCAAqC;IACrC,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,kBAAkB;CAChF,CAAC"}

package/dist/delete.d.mts

@@ -0,0 +1,3 @@
+import type { GlideClient } from "@valkey/valkey-glide";
+export declare const deleteKeysWithPrefix: (client: GlideClient, pattern: string) => Promise<void>;
+//# sourceMappingURL=delete.d.mts.map

package/dist/delete.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.mts","sourceRoot":"","sources":["../delete.mts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,eAAO,MAAM,oBAAoB,GAAU,QAAQ,WAAW,EAAE,SAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CAsB7F,CAAC"}

package/dist/delete.mjs

@@ -0,0 +1,23 @@
+import { handleValkeyError } from "./errors.mjs";
+export const deleteKeysWithPrefix = async (client, pattern) => {
+    const deletionPromises = [];
+    let cursor = "0";
+    do {
+        try {
+            // GlideClient scan method signature: scan(cursor: string, options?: ScanOptions)
+            /* oxlint-disable no-await-in-loop */
+            const result = await client.scan(cursor, { match: pattern });
+            cursor = result[0];
+            const keys = result[1];
+            if (keys.length > 0) {
+                deletionPromises.push(client.unlink(keys).catch(handleValkeyError));
+            }
+        }
+        catch (err) {
+            handleValkeyError(err);
+            throw err;
+        }
+    } while (cursor !== "0");
+    await Promise.all(deletionPromises);
+};
+//# sourceMappingURL=delete.mjs.map

package/dist/delete.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.mjs","sourceRoot":"","sources":["../delete.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,MAAmB,EAAE,OAAe,EAAiB,EAAE;IAChG,MAAM,gBAAgB,GAA6B,EAAE,CAAC;IACtD,IAAI,MAAM,GAAG,GAAG,CAAC;IAEjB,GAAG,CAAC;QACF,IAAI,CAAC;YACH,iFAAiF;YACjF,qCAAqC;YACrC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7D,MAAM,GAAG,MAAM,CAAC,CAAC,CAAW,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAa,CAAC;YAEnC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,iBAAiB,CAAC,GAAY,CAAC,CAAC;YAChC,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;IAEzB,MAAM,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACtC,CAAC,CAAC"}

package/dist/dynamic-config/fields.d.mts

@@ -0,0 +1,6 @@
+import type { DynamicConfigField, DynamicConfigFieldType } from "../types.mts";
+export declare function validateFieldTypes(fieldTypes: Record<string, DynamicConfigFieldType>, defaultFields: Record<string, DynamicConfigField>): void;
+export declare function processFieldValue(type: DynamicConfigFieldType, value: DynamicConfigField): DynamicConfigField;
+export declare function stringifyField(type: DynamicConfigFieldType, value: DynamicConfigField): string;
+export declare function parseField(type: DynamicConfigFieldType, value: string): DynamicConfigField;
+//# sourceMappingURL=fields.d.mts.map

package/dist/dynamic-config/fields.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.mts","sourceRoot":"","sources":["../../dynamic-config/fields.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE/E,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAClD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,QAelD;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,sBAAsB,EAC5B,KAAK,EAAE,kBAAkB,GACxB,kBAAkB,CAUpB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAK9F;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAK1F"}

package/dist/dynamic-config/fields.mjs

@@ -0,0 +1,50 @@
+export function validateFieldTypes(fieldTypes, defaultFields) {
+    for (const [name, type] of Object.entries(fieldTypes)) {
+        if (!(name in defaultFields))
+            throw new Error(`Default field ${name} is not defined`);
+        const defaultValue = defaultFields[name];
+        if (type === "string" && typeof defaultValue !== "string") {
+            throw new Error(`Default field ${name} is not of type string`);
+        }
+        if (type === "number" && typeof defaultValue !== "number") {
+            throw new Error(`Default field ${name} is not of type number`);
+        }
+        if (type === "boolean" && typeof defaultValue !== "boolean") {
+            throw new Error(`Default field ${name} is not of type boolean`);
+        }
+    }
+}
+export function processFieldValue(type, value) {
+    if (type === "string")
+        return value.toString();
+    if (type === "number")
+        return Number(value);
+    if (type === "boolean") {
+        if (typeof value === "boolean")
+            return value;
+        if (typeof value === "string")
+            return value === "1";
+        if (typeof value === "number")
+            return value === 1;
+        return Boolean(value);
+    }
+    throw new Error("Unknown field type");
+}
+export function stringifyField(type, value) {
+    const normalizedValue = processFieldValue(type, value);
+    if (type === "string" || type === "number")
+        return normalizedValue.toString();
+    if (type === "boolean")
+        return normalizedValue ? "1" : "0";
+    throw new Error("Unknown field type");
+}
+export function parseField(type, value) {
+    if (type === "string")
+        return value;
+    if (type === "number")
+        return Number(value);
+    if (type === "boolean")
+        return value === "1";
+    throw new Error("Unknown field type");
+}
+//# sourceMappingURL=fields.mjs.map

package/dist/dynamic-config/fields.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.mjs","sourceRoot":"","sources":["../../dynamic-config/fields.mts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAChC,UAAkD,EAClD,aAAiD;IAEjD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,CAAC,IAAI,IAAI,aAAa,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,CAAC;QACtF,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,IAAI,KAAK,QAAQ,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,wBAAwB,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,wBAAwB,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,YAAY,KAAK,SAAS,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,yBAAyB,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAA4B,EAC5B,KAAyB;IAEzB,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/C,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,OAAO,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,KAAK,GAAG,CAAC;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,KAAK,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAA4B,EAAE,KAAyB;IACpF,MAAM,eAAe,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,eAAe,CAAC,QAAQ,EAAE,CAAC;IAC9E,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3D,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAA4B,EAAE,KAAa;IACpE,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,KAAK,GAAG,CAAC;IAC7C,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;AACxC,CAAC"}

package/dist/dynamic-config/storage.d.mts

@@ -0,0 +1,33 @@
+import type { DynamicConfigField, DynamicConfigFieldType } from "../types.mts";
+import type { GlideClient } from "@valkey/valkey-glide";
+export declare const dynamicConfigSetFieldsScript: import("@valkey/valkey-glide").Script;
+export declare function getDynamicConfigFieldsMap(key: string, client?: GlideClient): Promise<Map<string, {
+    field: unknown;
+    value: unknown;
+}>>;
+export declare function applyFieldsFromMap({ fields, fieldsMap, fieldTypes, defaultFields, }: {
+    fields: Map<string, DynamicConfigField>;
+    fieldsMap: Map<string, {
+        field: unknown;
+        value: unknown;
+    }>;
+    fieldTypes: Record<string, DynamicConfigFieldType>;
+    defaultFields: Record<string, DynamicConfigField>;
+}): void;
+export declare function writeDynamicConfigFields({ key, args, client, }: {
+    key: string;
+    args: string[];
+    client?: GlideClient;
+}): Promise<void>;
+export declare function buildMissingDefaultWrites({ fieldsMap, fieldTypes, defaultFields, }: {
+    fieldsMap: Map<string, {
+        field: unknown;
+        value: unknown;
+    }>;
+    fieldTypes: Record<string, DynamicConfigFieldType>;
+    defaultFields: Record<string, DynamicConfigField>;
+}): {
+    toApply: [string, DynamicConfigField][];
+    writeArgs: string[];
+};
+//# sourceMappingURL=storage.d.mts.map

package/dist/dynamic-config/storage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.mts","sourceRoot":"","sources":["../../dynamic-config/storage.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,eAAO,MAAM,4BAA4B,uCAExC,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,WAAuC,GAC9C,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAW1D;AAED,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,SAAS,EACT,UAAU,EACV,aAAa,GACd,EAAE;IACD,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACxC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC3D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACnD,QASA;AAED,wBAAsB,wBAAwB,CAAC,EAC7C,GAAG,EACH,IAAI,EACJ,MAAkC,GACnC,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,iBAGA;AAED,wBAAgB,yBAAyB,CAAC,EACxC,SAAS,EACT,UAAU,EACV,aAAa,GACd,EAAE;IACD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC3D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACnD;;;EAaA"}

package/dist/dynamic-config/storage.mjs

@@ -0,0 +1,55 @@
+import { dynamicConfigValkeyClient } from "../clients.mjs";
+import { loadScript, registerScript } from "../scripts.mjs";
+import { parseField, stringifyField } from "./fields.mjs";
+export const dynamicConfigSetFieldsScript = registerScript(loadScript("dynamic-config-set-fields.lua", new URL("../", import.meta.url)));
+export async function getDynamicConfigFieldsMap(key, client = dynamicConfigValkeyClient) {
+    const fields = await client.hgetall(key);
+    const fieldsMap = new Map();
+    if (Array.isArray(fields)) {
+        for (const entry of fields) {
+            if (entry && typeof entry === "object" && "field" in entry && "value" in entry) {
+                fieldsMap.set(entry.field.toString(), entry);
+            }
+        }
+    }
+    return fieldsMap;
+}
+export function applyFieldsFromMap({ fields, fieldsMap, fieldTypes, defaultFields, }) {
+    for (const [name, type] of Object.entries(fieldTypes)) {
+        const valkeyEntry = fieldsMap.get(name);
+        const value = valkeyEntry?.value != null
+            ? parseField(type, stringifyValkeyField(valkeyEntry.value))
+            : defaultFields[name];
+        fields.set(name, value);
+    }
+}
+export async function writeDynamicConfigFields({ key, args, client = dynamicConfigValkeyClient, }) {
+    if (args.length === 0)
+        return;
+    await client.invokeScript(dynamicConfigSetFieldsScript, { keys: [key], args });
+}
+export function buildMissingDefaultWrites({ fieldsMap, fieldTypes, defaultFields, }) {
+    const toApply = [];
+    const writeArgs = [];
+    for (const [name, type] of Object.entries(fieldTypes)) {
+        const valkeyEntry = fieldsMap.get(name);
+        const value = valkeyEntry?.value != null
+            ? parseField(type, stringifyValkeyField(valkeyEntry.value))
+            : defaultFields[name];
+        if (valkeyEntry?.value == null)
+            writeArgs.push(name, stringifyField(type, value));
+        toApply.push([name, value]);
+    }
+    return { toApply, writeArgs };
+}
+function stringifyValkeyField(value) {
+    if (Buffer.isBuffer(value))
+        return value.toString();
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "bigint" || typeof value === "boolean") {
+        return String(value);
+    }
+    return JSON.stringify(value) ?? "";
+}
+//# sourceMappingURL=storage.mjs.map

package/dist/dynamic-config/storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.mjs","sourceRoot":"","sources":["../../dynamic-config/storage.mts"],"names":[],"mappings":"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"}

package/dist/dynamic-config.d.mts

@@ -0,0 +1,34 @@
+import type { DynamicConfigOptions, DynamicConfigField, DynamicConfigFieldType } from "./types.mts";
+import { parseField, stringifyField } from "./dynamic-config/fields.mts";
+export declare const dynamicConfigs: DynamicConfig[];
+export declare class DynamicConfig {
+    staleTtl: number;
+    key: string;
+    fields: Map<string, DynamicConfigField>;
+    fieldTypes: Record<string, DynamicConfigFieldType>;
+    defaultFields: Record<string, DynamicConfigField>;
+    initialization: Promise<void>;
+    private client;
+    private closed;
+    private lastRefresh;
+    private refreshTimer;
+    private readonly messageHandler;
+    constructor(options: DynamicConfigOptions);
+    initialize(): Promise<void>;
+    waitForInitialization(): Promise<void>;
+    private validateFieldTypes;
+    stringifyField: typeof stringifyField;
+    parseField: typeof parseField;
+    private getFieldsMap;
+    private applyFieldsFromMap;
+    subscribe(): Promise<void>;
+    unsubscribe(): void;
+    private handlePubSubMessage;
+    createRefreshTimer(): void;
+    close(): Promise<void>;
+    refresh(): Promise<void>;
+    getFields(): Record<string, DynamicConfigField>;
+    setFields(fields: Record<string, DynamicConfigField>): Promise<void>;
+    setField(name: string, value: DynamicConfigField): Promise<void>;
+}
+//# sourceMappingURL=dynamic-config.d.mts.map

package/dist/dynamic-config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-config.d.mts","sourceRoot":"","sources":["../dynamic-config.mts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAQpG,OAAO,EACL,UAAU,EAEV,cAAc,EAEf,MAAM,6BAA6B,CAAC;AAIrC,eAAO,MAAM,cAAc,EAAE,aAAa,EAAO,CAAC;AAElD,qBAAa,aAAa;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAClD,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqD;gBAExE,OAAO,EAAE,oBAAoB;IAqBnC,UAAU;IAqBV,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C,OAAO,CAAC,kBAAkB;IAI1B,cAAc,wBAAkB;IAChC,UAAU,oBAAc;IAExB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,kBAAkB;IASpB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAShC,WAAW,IAAI,IAAI;IAInB,OAAO,CAAC,mBAAmB;IAe3B,kBAAkB;IASlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYhB,OAAO;IAgBb,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAUzC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB1E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGjE"}

package/dist/dynamic-config.mjs

@@ -0,0 +1,173 @@
+import { ensureDynamicConfigValkeySubscriptionClient, addPubSubMessageHandler, removePubSubMessageHandler, dynamicConfigValkeyClient, } from "./clients.mjs";
+import { handleValkeyError } from "./errors.mjs";
+import { applyFieldsFromMap, buildMissingDefaultWrites, getDynamicConfigFieldsMap, writeDynamicConfigFields, } from "./dynamic-config/storage.mjs";
+import { parseField, processFieldValue, stringifyField, validateFieldTypes, } from "./dynamic-config/fields.mjs";
+const NAMESPACE = "dynamic-config";
+const isTest = process.env.NODE_ENV === "test";
+export const dynamicConfigs = [];
+export class DynamicConfig {
+    staleTtl;
+    key;
+    fields;
+    fieldTypes;
+    defaultFields;
+    initialization;
+    client;
+    closed = false;
+    lastRefresh = 0;
+    refreshTimer = null;
+    messageHandler = (msg) => this.handlePubSubMessage(msg);
+    constructor(options) {
+        this.staleTtl = options.staleTtlSeconds || 60;
+        this.key = `${NAMESPACE}:${options.key}`;
+        this.fieldTypes = options.fieldTypes;
+        this.defaultFields = options.defaultFields;
+        this.client = options.client ?? dynamicConfigValkeyClient;
+        this.fields = new Map();
+        /* v8 ignore next 3 -- duplicate construction is guarded only outside NODE_ENV=test. */
+        if (!isTest && dynamicConfigs.some((config) => config.key === this.key)) {
+            throw new Error(`DynamicConfig already initialized: ${this.key}`);
+        }
+        dynamicConfigs.push(this);
+        this.initialization = this.initialize();
+        /* v8 ignore next -- tests run with NODE_ENV=test and do not attach startup catch handlers. */
+        if (!isTest) {
+            this.initialization.catch((err) => {
+                handleValkeyError(err);
+            });
+        }
+    }
+    async initialize() {
+        this.validateFieldTypes();
+        const fieldsMap = await this.getFieldsMap();
+        const { toApply, writeArgs } = buildMissingDefaultWrites({
+            fieldsMap,
+            fieldTypes: this.fieldTypes,
+            defaultFields: this.defaultFields,
+        });
+        await writeDynamicConfigFields({ key: this.key, args: writeArgs, client: this.client });
+        for (const [name, value] of toApply) {
+            this.fields.set(name, value);
+        }
+        // Mark initialized so the refresh timer doesn't race with initialization
+        this.lastRefresh = Date.now();
+        await this.subscribe();
+        /* v8 ignore next -- closing during the subscription await is a shutdown race guard. */
+        if (this.closed)
+            return;
+        this.createRefreshTimer();
+    }
+    async waitForInitialization() {
+        await this.initialization;
+    }
+    validateFieldTypes() {
+        validateFieldTypes(this.fieldTypes, this.defaultFields);
+    }
+    stringifyField = stringifyField;
+    parseField = parseField;
+    getFieldsMap() {
+        return getDynamicConfigFieldsMap(this.key, this.client);
+    }
+    applyFieldsFromMap(fieldsMap) {
+        applyFieldsFromMap({
+            fields: this.fields,
+            fieldsMap,
+            fieldTypes: this.fieldTypes,
+            defaultFields: this.defaultFields,
+        });
+    }
+    async subscribe() {
+        if (this.closed)
+            return;
+        await ensureDynamicConfigValkeySubscriptionClient();
+        /* v8 ignore next -- closing during the subscription await is a shutdown race guard. */
+        if (this.closed)
+            return;
+        addPubSubMessageHandler(this.messageHandler);
+    }
+    // Unsubscribe from pub/sub
+    unsubscribe() {
+        removePubSubMessageHandler(this.messageHandler);
+    }
+    handlePubSubMessage(msg) {
+        const channel = msg.channel.toString();
+        const prefix = `${this.key}:`;
+        // Only process messages for this config's key
+        if (!channel.startsWith(prefix))
+            return;
+        const fieldName = channel.slice(prefix.length);
+        const type = this.fieldTypes[fieldName];
+        if (!type)
+            return;
+        const value = parseField(type, msg.message.toString());
+        this.fields.set(fieldName, value);
+    }
+    createRefreshTimer() {
+        const refreshInterval = Math.max(this.staleTtl * 1000, 1000); // Convert to ms, minimum 1 second
+        /* v8 ignore next 3 -- interval callback is defensive background refresh plumbing. */
+        this.refreshTimer = setInterval(() => {
+            this.refresh().catch(handleValkeyError);
+        }, refreshInterval);
+        this.refreshTimer.unref(); // Do not hold the event loop open if the process wants to exit
+    }
+    close() {
+        this.closed = true;
+        this.unsubscribe();
+        if (this.refreshTimer) {
+            clearInterval(this.refreshTimer);
+            this.refreshTimer = null;
+        }
+        const idx = dynamicConfigs.indexOf(this);
+        if (idx !== -1)
+            dynamicConfigs.splice(idx, 1);
+        return Promise.resolve();
+    }
+    async refresh() {
+        if (this.closed)
+            return;
+        const now = Date.now();
+        if (now - this.lastRefresh < this.staleTtl * 1000)
+            return;
+        this.lastRefresh = now; // Optimistic claim: prevents concurrent duplicate refreshes
+        try {
+            const fieldsMap = await this.getFieldsMap();
+            this.applyFieldsFromMap(fieldsMap);
+        }
+        catch (err) {
+            /* v8 ignore next -- transient Valkey failures are environment-dependent. */
+            this.lastRefresh = 0; // Reset so the next interval can retry after a transient failure
+            /* v8 ignore next -- rethrow preserves caller-visible refresh failure semantics. */
+            throw err;
+        }
+    }
+    getFields() {
+        const result = {};
+        for (const [name, value] of this.fields.entries()) {
+            result[name] = value;
+        }
+        return result;
+    }
+    // set the fields in valkey and publish change events atomically via Lua script,
+    // then apply local state only after a successful write
+    async setFields(fields) {
+        const toApply = [];
+        const args = [];
+        for (const [name, value] of Object.entries(fields)) {
+            if (!this.fieldTypes[name]) {
+                throw new Error(`Unknown field: ${name}`);
+            }
+            const type = this.fieldTypes[name];
+            const processedValue = processFieldValue(type, value);
+            toApply.push([name, processedValue]);
+            args.push(name, stringifyField(type, processedValue));
+        }
+        await writeDynamicConfigFields({ key: this.key, args, client: this.client });
+        for (const [name, processedValue] of toApply) {
+            this.fields.set(name, processedValue);
+        }
+    }
+    setField(name, value) {
+        return this.setFields({ [name]: value });
+    }
+}
+//# sourceMappingURL=dynamic-config.mjs.map