valkyries 0.8.1 → 0.9.0

package/dist/clients.d.mts

@@ -47,6 +47,9 @@ export declare function buildDynamicConfigSubscriptionClientConfig(url: string):
     lazyConnect: boolean;
     inflightRequestsLimit: number;
     requestTimeout: number;
+    advancedConfiguration: {
+        connectionTimeout: number;
+    };
     pubsubSubscriptions: {
         channelsAndPatterns: {
             1: Set<string>;

package/dist/clients.d.mts.map

@@ -1 +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,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,aAAa,0BAAiC,CAAC;AAG5D,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,CA0BtB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;EA0B5E;AAED,wBAAgB,0CAA0C,CAAC,GAAG,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;EAUrE"}
+{"version":3,"file":"clients.d.mts","sourceRoot":"","sources":["../clients.mts"],"names":[],"mappings":"AACA,OAAO,EAEL,WAAW,EAEX,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAQ9B,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,eAAe,CAAC;AAEzD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,aAAa,0BAAiC,CAAC;AAG5D,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,CAqClF;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,CA0BtB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;EA0B5E;AAED,wBAAgB,0CAA0C,CAAC,GAAG,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;EAWrE"}

package/dist/clients.mjs

@@ -3,6 +3,8 @@ import { ALL_PATTERNS, GlideClient, GlideClientConfiguration, } from "@valkey/va
 import { config } from "./config.mjs";
 import { handleValkeyError } from "./errors.mjs";
 const CLIENT_CLOSE_SETTLE_MS = 100;
+const SUBSCRIPTION_CONNECTION_TIMEOUT_MS = 2_000;
+const SUBSCRIPTION_CREATION_TIMEOUT_MS = 5_000;
 export const urlsToClients = new Map();
 const urlsToClientPromises = new Map();
 export const cacheValkeyClient = await upsertValkeyClientByUrl(config.cache_url, {
@@ -22,14 +24,48 @@ export function addPubSubMessageHandler(handler) {
 export function removePubSubMessageHandler(handler) {
     pubSubMessageHandlers.delete(handler);
 }
+function reportSubscriptionError(error) {
+    try {
+        handleValkeyError(error);
+    }
+    catch (cause) {
+        // Error reporting must not replace the native failure or reject an ignored observer.
+        process.emitWarning(new AggregateError([error, cause], "DynamicConfig subscription error handler threw", {
+            cause,
+        }));
+    }
+}
 export function ensureDynamicConfigValkeySubscriptionClient() {
     if (dynamicConfigValkeySubscriptionClientPromise)
         return dynamicConfigValkeySubscriptionClientPromise;
-    const clientPromise = GlideClient.createClient(buildDynamicConfigSubscriptionClientConfig(config.dynamic_config_url)).catch((error) => {
-        dynamicConfigValkeySubscriptionClientPromise = null;
-        handleValkeyError(error);
-        throw error;
+    let expired = false;
+    let timer;
+    const deadline = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            expired = true;
+            reject(new Error("DynamicConfig subscription client creation timed out after 5000 ms"));
+        }, SUBSCRIPTION_CREATION_TIMEOUT_MS);
+    });
+    const creation = Promise.resolve()
+        .then(() => GlideClient.createClient(buildDynamicConfigSubscriptionClientConfig(config.dynamic_config_url)))
+        .then((client) => {
+        if (expired)
+            client.close();
+        return client;
     });
+    // Observe late native rejection/close failure after the deadline has already won.
+    creation.catch((error) => {
+        if (expired)
+            reportSubscriptionError(error);
+    });
+    const clientPromise = Promise.race([creation, deadline])
+        .catch((error) => {
+        if (dynamicConfigValkeySubscriptionClientPromise === clientPromise)
+            dynamicConfigValkeySubscriptionClientPromise = null;
+        reportSubscriptionError(error);
+        throw error;
+    })
+        .finally(() => clearTimeout(timer));
     dynamicConfigValkeySubscriptionClientPromise = clientPromise;
     return clientPromise;
 }
@@ -106,6 +142,7 @@ export function glideConfigFromUrl(url, options) {
 export function buildDynamicConfigSubscriptionClientConfig(url) {
     return {
         ...glideConfigFromUrl(url, { readFrom: "preferReplica", lazyConnect: false }),
+        advancedConfiguration: { connectionTimeout: SUBSCRIPTION_CONNECTION_TIMEOUT_MS },
         pubsubSubscriptions: {
             channelsAndPatterns: {
                 [GlideClientConfiguration.PubSubChannelModes.Pattern]: new Set(["dynamic-config:*"]),

package/dist/clients.mjs.map

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

package/dist/dynamic-config/bounded-field.d.mts

@@ -0,0 +1,7 @@
+import type { DynamicConfig } from "../dynamic-config.mts";
+export type BoundedPositiveIntegerLimits = {
+    defaultValue: number;
+    maxValue: number;
+};
+export declare function getBoundedPositiveIntegerField(config: Pick<DynamicConfig, "fields">, field: string, limits: BoundedPositiveIntegerLimits): number;
+//# sourceMappingURL=bounded-field.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-field.d.mts","sourceRoot":"","sources":["../../dynamic-config/bounded-field.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,MAAM,4BAA4B,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,EACrC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,4BAA4B,GACnC,MAAM,CAWR"}

package/dist/dynamic-config/bounded-field.mjs

@@ -0,0 +1,11 @@
+export function getBoundedPositiveIntegerField(config, field, limits) {
+    const value = config.fields.get(field);
+    if (typeof value === "number" &&
+        Number.isInteger(value) &&
+        value > 0 &&
+        value <= limits.maxValue) {
+        return value;
+    }
+    return limits.defaultValue;
+}
+//# sourceMappingURL=bounded-field.mjs.map

package/dist/dynamic-config/bounded-field.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-field.mjs","sourceRoot":"","sources":["../../dynamic-config/bounded-field.mts"],"names":[],"mappings":"AAIA,MAAM,UAAU,8BAA8B,CAC5C,MAAqC,EACrC,KAAa,EACb,MAAoC;IAEpC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvC,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QACvB,KAAK,GAAG,CAAC;QACT,KAAK,IAAI,MAAM,CAAC,QAAQ,EACxB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC,YAAY,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { DynamicConfigFieldRules, DynamicConfigNamespaceDefinition, DynamicConfigRegistry } from "./types.mts";
+/**
+ * Returns the definition unchanged, or throws when its field rules do not cover exactly the
+ * config's `fieldTypes`.
+ */
+export declare function defineDynamicConfigNamespace<T extends DynamicConfigNamespaceDefinition>(definition: T): T;
+/** Sets `maxValueExemption` on every field without a `maxValue`, except the named ones. */
+export declare function withMaxValueExemption<T extends Record<string, DynamicConfigFieldRules>>(fields: T, reason: string, except?: readonly string[]): T;
+/** Indexes definitions by namespace. Throws on duplicate namespaces. */
+export declare function createDynamicConfigRegistry<T extends DynamicConfigNamespaceDefinition>(entries: readonly T[]): DynamicConfigRegistry<T>;
+//# sourceMappingURL=registry.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.mts","sourceRoot":"","sources":["../../dynamic-config/registry.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EAChC,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,gCAAgC,EACrF,UAAU,EAAE,CAAC,GACZ,CAAC,CAYH;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,EACrF,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,SAAS,MAAM,EAAO,GAC7B,CAAC,CAUH;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,gCAAgC,EACpF,OAAO,EAAE,SAAS,CAAC,EAAE,GACpB,qBAAqB,CAAC,CAAC,CAAC,CAY1B"}

package/dist/dynamic-config/registry.mjs

@@ -0,0 +1,44 @@
+/**
+ * Returns the definition unchanged, or throws when its field rules do not cover exactly the
+ * config's `fieldTypes`.
+ */
+export function defineDynamicConfigNamespace(definition) {
+    const { fieldTypes } = definition.config;
+    const missing = Object.keys(fieldTypes).filter((name) => !Object.hasOwn(definition.fields, name));
+    const extra = Object.keys(definition.fields).filter((name) => !Object.hasOwn(fieldTypes, name));
+    if (missing.length === 0 && extra.length === 0)
+        return definition;
+    const details = [];
+    if (missing.length > 0)
+        details.push(`missing rules: ${missing.join(", ")}`);
+    if (extra.length > 0)
+        details.push(`extra rules: ${extra.join(", ")}`);
+    throw new Error(`DynamicConfig field rules drift for ${definition.namespace}: ${details.join("; ")}`);
+}
+/** Sets `maxValueExemption` on every field without a `maxValue`, except the named ones. */
+export function withMaxValueExemption(fields, reason, except = []) {
+    const result = Object.create(null);
+    for (const name of Object.keys(fields)) {
+        const rules = fields[name];
+        result[name] =
+            rules.maxValue === undefined && !except.includes(name)
+                ? { ...rules, maxValueExemption: reason }
+                : rules;
+    }
+    return result;
+}
+/** Indexes definitions by namespace. Throws on duplicate namespaces. */
+export function createDynamicConfigRegistry(entries) {
+    const byNamespace = new Map();
+    for (const entry of entries) {
+        if (byNamespace.has(entry.namespace)) {
+            throw new Error(`Duplicate dynamic config namespace: ${entry.namespace}`);
+        }
+        byNamespace.set(entry.namespace, entry);
+    }
+    return {
+        entries: [...entries],
+        get: (namespace) => byNamespace.get(namespace) ?? null,
+    };
+}
+//# sourceMappingURL=registry.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.mjs","sourceRoot":"","sources":["../../dynamic-config/registry.mts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAa;IAEb,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAClG,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IAChG,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAElE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvE,MAAM,IAAI,KAAK,CACb,uCAAuC,UAAU,CAAC,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,qBAAqB,CACnC,MAAS,EACT,MAAc,EACd,MAAM,GAAsB,EAAE;IAE9B,MAAM,MAAM,GAA4C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5E,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACpD,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE;gBACzC,CAAC,CAAC,KAAK,CAAC;IACd,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,2BAA2B,CACzC,OAAqB;IAErB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAa,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,uCAAuC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;QACrB,GAAG,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI;KACvD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,42 @@
+import type { DynamicConfigField, DynamicConfigFieldType } from "../types.mts";
+/** The subset of a `DynamicConfig` that namespace definitions and update validation read. */
+export type DynamicConfigSchema = {
+    fieldTypes: Record<string, DynamicConfigFieldType>;
+};
+/** Per-field update rules and display metadata. */
+export type DynamicConfigFieldRules = {
+    description?: string | undefined;
+    /** Inclusive lower bound for number fields. */
+    minValue?: number | undefined;
+    /** Inclusive upper bound for number fields. */
+    maxValue?: number | undefined;
+    /** Why a number field intentionally has no `maxValue`. */
+    maxValueExemption?: string | undefined;
+    /** Requires number fields to be safe integers. */
+    integer?: boolean | undefined;
+};
+export type DynamicConfigNamespaceDefinition<TConfig extends DynamicConfigSchema = DynamicConfigSchema> = {
+    namespace: string;
+    config: TConfig;
+    /** Rules for every field in `config.fieldTypes`, and no others. */
+    fields: Record<string, DynamicConfigFieldRules>;
+    /** Cross-field validator over the merged fields; throws to reject an update. */
+    validate?: ((next: Record<string, DynamicConfigField>) => void) | undefined;
+};
+export type DynamicConfigRegistry<T extends DynamicConfigNamespaceDefinition = DynamicConfigNamespaceDefinition> = {
+    readonly entries: readonly T[];
+    get(namespace: string): T | null;
+};
+export type DynamicConfigUpdate = {
+    /** The requested changes after type and rule checks. */
+    changes: Record<string, DynamicConfigField>;
+    /** `current` merged with `changes`. */
+    next: Record<string, DynamicConfigField>;
+    /** Whether any requested value differs from `current`. */
+    changed: boolean;
+};
+export type DynamicConfigChangedFields = Record<string, {
+    previous: unknown;
+    next: unknown;
+}>;
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../dynamic-config/types.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE/E,6FAA6F;AAC7F,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACpD,CAAC;AAEF,mDAAmD;AACnD,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,gCAAgC,CAC1C,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,IACvD;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAChD,gFAAgF;IAChF,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7E,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAC/B,CAAC,SAAS,gCAAgC,GAAG,gCAAgC,IAC3E;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IAC/B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC5C,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACzC,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC"}

package/dist/dynamic-config/types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../dynamic-config/types.mts"],"names":[],"mappings":""}

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

@@ -0,0 +1,14 @@
+import type { DynamicConfigField } from "../types.mts";
+import type { DynamicConfigChangedFields, DynamicConfigNamespaceDefinition, DynamicConfigUpdate } from "./types.mts";
+export declare class DynamicConfigValidationError extends Error {
+    name: string;
+}
+/**
+ * Validates untrusted changes against a namespace definition without writing anything.
+ * Values must already have their declared runtime type; unlike `DynamicConfig.setFields`, nothing
+ * is coerced. Runs the definition's `validate` hook on `current` merged with the changes.
+ */
+export declare function validateDynamicConfigUpdate(definition: DynamicConfigNamespaceDefinition, current: Record<string, DynamicConfigField>, changes: unknown): DynamicConfigUpdate;
+/** Shallow diff of two field snapshots. Absent keys read as `undefined`. */
+export declare function getChangedFields(previous: Record<string, unknown> | null | undefined, next: Record<string, unknown> | null | undefined): DynamicConfigChangedFields;
+//# sourceMappingURL=validation.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.mts","sourceRoot":"","sources":["../../dynamic-config/validation.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EACV,0BAA0B,EAE1B,gCAAgC,EAChC,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB,qBAAa,4BAA6B,SAAQ,KAAK;IAC5C,IAAI,SAAkC;CAChD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,gCAAgC,EAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC3C,OAAO,EAAE,OAAO,GACf,mBAAmB,CAqBrB;AA6CD,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACpD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC/C,0BAA0B,CAU5B"}

package/dist/dynamic-config/validation.mjs

@@ -0,0 +1,72 @@
+export class DynamicConfigValidationError extends Error {
+    name = "DynamicConfigValidationError";
+}
+/**
+ * Validates untrusted changes against a namespace definition without writing anything.
+ * Values must already have their declared runtime type; unlike `DynamicConfig.setFields`, nothing
+ * is coerced. Runs the definition's `validate` hook on `current` merged with the changes.
+ */
+export function validateDynamicConfigUpdate(definition, current, changes) {
+    if (changes === null || typeof changes !== "object" || Array.isArray(changes)) {
+        throw new DynamicConfigValidationError("Changes must be an object");
+    }
+    const names = Object.keys(changes);
+    if (names.length === 0) {
+        throw new DynamicConfigValidationError("Changes must not be empty");
+    }
+    // Null prototype so a declared `__proto__` field stays an own property.
+    const validated = Object.create(null);
+    let changed = false;
+    for (const name of names) {
+        const value = validateFieldValue(definition, name, changes[name]);
+        validated[name] = value;
+        if (current[name] !== value)
+            changed = true;
+    }
+    const next = { ...current, ...validated };
+    definition.validate?.(next);
+    return { changes: validated, next, changed };
+}
+function validateFieldValue(definition, name, value) {
+    const { fieldTypes } = definition.config;
+    if (!Object.hasOwn(fieldTypes, name)) {
+        throw new DynamicConfigValidationError(`Unknown field: ${name}`);
+    }
+    const type = fieldTypes[name];
+    if (type !== "number") {
+        if (typeof value !== type) {
+            throw new DynamicConfigValidationError(`Field ${name} must be a ${type}`);
+        }
+        return value;
+    }
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new DynamicConfigValidationError(`Field ${name} must be a finite number`);
+    }
+    validateNumberRules(name, value, definition.fields[name]);
+    return value;
+}
+function validateNumberRules(name, value, rules) {
+    if (rules?.integer && !Number.isSafeInteger(value)) {
+        throw new DynamicConfigValidationError(`Field ${name} must be a safe integer`);
+    }
+    if (rules?.minValue !== undefined && value < rules.minValue) {
+        throw new DynamicConfigValidationError(`Field ${name} must be greater than or equal to ${rules.minValue}`);
+    }
+    if (rules?.maxValue !== undefined && value > rules.maxValue) {
+        throw new DynamicConfigValidationError(`Field ${name} must be less than or equal to ${rules.maxValue}`);
+    }
+}
+/** Shallow diff of two field snapshots. Absent keys read as `undefined`. */
+export function getChangedFields(previous, next) {
+    const before = previous ?? {};
+    const after = next ?? {};
+    const changed = Object.create(null);
+    for (const key of new Set([...Object.keys(before), ...Object.keys(after)])) {
+        const previousValue = Object.hasOwn(before, key) ? before[key] : undefined;
+        const nextValue = Object.hasOwn(after, key) ? after[key] : undefined;
+        if (previousValue !== nextValue)
+            changed[key] = { previous: previousValue, next: nextValue };
+    }
+    return changed;
+}
+//# sourceMappingURL=validation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.mjs","sourceRoot":"","sources":["../../dynamic-config/validation.mts"],"names":[],"mappings":"AAQA,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC5C,IAAI,GAAG,8BAA8B,CAAC;CAChD;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAA4C,EAC5C,OAA2C,EAC3C,OAAgB;IAEhB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,4BAA4B,CAAC,2BAA2B,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,4BAA4B,CAAC,2BAA2B,CAAC,CAAC;IACtE,CAAC;IAED,wEAAwE;IACxE,MAAM,SAAS,GAAuC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1E,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,kBAAkB,CAAC,UAAU,EAAE,IAAI,EAAG,OAAmC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/F,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACxB,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK;YAAE,OAAO,GAAG,IAAI,CAAC;IAC9C,CAAC;IAED,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC;IAC1C,UAAU,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,kBAAkB,CACzB,UAA4C,EAC5C,IAAY,EACZ,KAAc;IAEd,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,4BAA4B,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,IAAI,OAAO,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1B,MAAM,IAAI,4BAA4B,CAAC,SAAS,IAAI,cAAc,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,KAAyB,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,4BAA4B,CAAC,SAAS,IAAI,0BAA0B,CAAC,CAAC;IAClF,CAAC;IACD,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAAY,EACZ,KAAa,EACb,KAA0C;IAE1C,IAAI,KAAK,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,4BAA4B,CAAC,SAAS,IAAI,yBAAyB,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,KAAK,EAAE,QAAQ,KAAK,SAAS,IAAI,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC5D,MAAM,IAAI,4BAA4B,CACpC,SAAS,IAAI,qCAAqC,KAAK,CAAC,QAAQ,EAAE,CACnE,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,EAAE,QAAQ,KAAK,SAAS,IAAI,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC5D,MAAM,IAAI,4BAA4B,CACpC,SAAS,IAAI,kCAAkC,KAAK,CAAC,QAAQ,EAAE,CAChE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAC9B,QAAoD,EACpD,IAAgD;IAEhD,MAAM,MAAM,GAAG,QAAQ,IAAI,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;IACzB,MAAM,OAAO,GAA+B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChE,KAAK,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3E,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,IAAI,aAAa,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC/F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { DynamicConfigField } from "../types.mts";
+type Fields = Record<string, DynamicConfigField>;
+/** Requires every number field to be finite and greater than zero. Ignores other types. */
+export declare function validatePositiveNumberFields(next: Fields): void;
+/** Requires every number field to be an integer greater than zero. Ignores other types. */
+export declare function validatePositiveIntegerFields(next: Fields): void;
+/** Requires `next[field]` to be a number within `[min, max]`. */
+export declare function validateNumberRange(next: Fields, field: string, min: number, max: number): void;
+/** Requires `next[field]` to be one of the allowed strings. */
+export declare function validateOneOf(next: Fields, field: string, allowed: readonly string[]): void;
+/** Requires the named number fields to be strictly ascending in the given order. */
+export declare function validateStrictlyAscending(next: Fields, fields: readonly string[]): void;
+export {};
+//# sourceMappingURL=validators.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.mts","sourceRoot":"","sources":["../../dynamic-config/validators.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEjD,2FAA2F;AAC3F,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO/D;AAED,2FAA2F;AAC3F,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAOhE;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAO/F;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAK3F;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CASvF"}

package/dist/dynamic-config/validators.mjs

@@ -0,0 +1,45 @@
+import { DynamicConfigValidationError } from "./validation.mjs";
+/** Requires every number field to be finite and greater than zero. Ignores other types. */
+export function validatePositiveNumberFields(next) {
+    for (const name of Object.keys(next)) {
+        const value = next[name];
+        if (typeof value === "number" && (!Number.isFinite(value) || value <= 0)) {
+            throw new DynamicConfigValidationError(`Field ${name} must be a positive finite number`);
+        }
+    }
+}
+/** Requires every number field to be an integer greater than zero. Ignores other types. */
+export function validatePositiveIntegerFields(next) {
+    for (const name of Object.keys(next)) {
+        const value = next[name];
+        if (typeof value === "number" && (!Number.isInteger(value) || value <= 0)) {
+            throw new DynamicConfigValidationError(`Field ${name} must be a positive integer`);
+        }
+    }
+}
+/** Requires `next[field]` to be a number within `[min, max]`. */
+export function validateNumberRange(next, field, min, max) {
+    const value = next[field];
+    if (typeof value !== "number" || !Number.isFinite(value) || value < min || value > max) {
+        throw new DynamicConfigValidationError(`Field ${field} must be a number between ${min} and ${max}`);
+    }
+}
+/** Requires `next[field]` to be one of the allowed strings. */
+export function validateOneOf(next, field, allowed) {
+    const value = next[field];
+    if (typeof value !== "string" || !allowed.includes(value)) {
+        throw new DynamicConfigValidationError(`Field ${field} must be one of: ${allowed.join(", ")}`);
+    }
+}
+/** Requires the named number fields to be strictly ascending in the given order. */
+export function validateStrictlyAscending(next, fields) {
+    let previous = -Infinity;
+    for (const field of fields) {
+        const value = next[field];
+        if (typeof value !== "number" || !(previous < value)) {
+            throw new DynamicConfigValidationError(`Fields must be ordered: ${fields.join(" < ")}`);
+        }
+        previous = value;
+    }
+}
+//# sourceMappingURL=validators.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validators.mjs","sourceRoot":"","sources":["../../dynamic-config/validators.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAIhE,2FAA2F;AAC3F,MAAM,UAAU,4BAA4B,CAAC,IAAY;IACvD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,4BAA4B,CAAC,SAAS,IAAI,mCAAmC,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;AACH,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,6BAA6B,CAAC,IAAY;IACxD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,4BAA4B,CAAC,SAAS,IAAI,6BAA6B,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW,EAAE,GAAW;IACvF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QACvF,MAAM,IAAI,4BAA4B,CACpC,SAAS,KAAK,6BAA6B,GAAG,QAAQ,GAAG,EAAE,CAC5D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAa,EAAE,OAA0B;IACnF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,4BAA4B,CAAC,SAAS,KAAK,oBAAoB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,yBAAyB,CAAC,IAAY,EAAE,MAAyB;IAC/E,IAAI,QAAQ,GAAG,CAAC,QAAQ,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,4BAA4B,CAAC,2BAA2B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,QAAQ,GAAG,KAAK,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/dynamic-config.d.mts

@@ -1,5 +1,11 @@
 import type { DynamicConfigOptions, DynamicConfigField, DynamicConfigFieldType } from "./types.mts";
 import { parseField, stringifyField } from "./dynamic-config/fields.mts";
+export { getBoundedPositiveIntegerField } from "./dynamic-config/bounded-field.mts";
+export type { BoundedPositiveIntegerLimits } from "./dynamic-config/bounded-field.mts";
+export { createDynamicConfigRegistry, defineDynamicConfigNamespace, withMaxValueExemption, } from "./dynamic-config/registry.mts";
+export { DynamicConfigValidationError, getChangedFields, validateDynamicConfigUpdate, } from "./dynamic-config/validation.mts";
+export { validateNumberRange, validateOneOf, validatePositiveIntegerFields, validatePositiveNumberFields, validateStrictlyAscending, } from "./dynamic-config/validators.mts";
+export type * from "./dynamic-config/types.mts";
 export declare const dynamicConfigs: DynamicConfig[];
 export declare class DynamicConfig {
     staleTtl: number;

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

@@ -1 +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;AASpG,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,YAAY,CAIhB;IACJ,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,oBAAoB,CAA4B;IACxD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqD;IAEpF,YAAY,OAAO,EAAE,oBAAoB,EAiCxC;IAEK,UAAU,kBA0Bf;IAEK,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3C;IAED,OAAO,CAAC,kBAAkB;IAI1B,cAAc,wBAAkB;IAChC,UAAU,oBAAc;IAExB,OAAO,CAAC,YAAY;IAIpB,OAAO,KAAK,oBAAoB,GAK/B;YAEa,kBAAkB;IAY1B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAM/B;IAGD,WAAW,IAAI,IAAI,CAElB;IAED,OAAO,CAAC,mBAAmB;IAgB3B,kBAAkB,SAOjB;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAUrB;IAEK,OAAO,kBAuBZ;IAED,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAM9C;IAIK,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCzE;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;CACF"}
+{"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;AASpG,OAAO,EACL,UAAU,EAEV,cAAc,EAEf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AACpF,YAAY,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,6BAA6B,EAC7B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,mBAAmB,4BAA4B,CAAC;AAKhD,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,YAAY,CAIhB;IACJ,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,oBAAoB,CAA4B;IACxD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqD;IAEpF,YAAY,OAAO,EAAE,oBAAoB,EAiCxC;IAEK,UAAU,kBA0Bf;IAEK,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3C;IAED,OAAO,CAAC,kBAAkB;IAI1B,cAAc,wBAAkB;IAChC,UAAU,oBAAc;IAExB,OAAO,CAAC,YAAY;IAIpB,OAAO,KAAK,oBAAoB,GAK/B;YAEa,kBAAkB;IAY1B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAM/B;IAGD,WAAW,IAAI,IAAI,CAElB;IAED,OAAO,CAAC,mBAAmB;IAgB3B,kBAAkB,SAOjB;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAUrB;IAEK,OAAO,kBAuBZ;IAED,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAM9C;IAIK,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCzE;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;CACF"}

package/dist/dynamic-config.mjs

@@ -3,6 +3,10 @@ import { handleValkeyError } from "./errors.mjs";
 import { config } from "./config.mjs";
 import { applyFieldsFromMap, buildMissingDefaultWrites, getDynamicConfigFieldsMap, writeDynamicConfigFields, } from "./dynamic-config/storage.mjs";
 import { parseField, processFieldValue, stringifyField, validateFieldTypes, } from "./dynamic-config/fields.mjs";
+export { getBoundedPositiveIntegerField } from "./dynamic-config/bounded-field.mjs";
+export { createDynamicConfigRegistry, defineDynamicConfigNamespace, withMaxValueExemption, } from "./dynamic-config/registry.mjs";
+export { DynamicConfigValidationError, getChangedFields, validateDynamicConfigUpdate, } from "./dynamic-config/validation.mjs";
+export { validateNumberRange, validateOneOf, validatePositiveIntegerFields, validatePositiveNumberFields, validateStrictlyAscending, } from "./dynamic-config/validators.mjs";
 const NAMESPACE = "dynamic-config";
 const isTest = process.env.NODE_ENV === "test";
 export const dynamicConfigs = [];

package/dist/dynamic-config.mjs.map

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

package/docs/api.md

@@ -6,7 +6,7 @@ This is the entry point for the public `valkyries` API. Detailed API documentati
 
 - [`ValkeyCache`](cache.md) - read-through cache helpers, direct get/set APIs, invalidation, stale refresh, and Bloom-filter integration.
 - [`ValkeyBloomFilter`](bloom-filters.md) - Bloom filter lookup, writes, readiness markers, streaming rebuilds, and key helpers.
-- [`DynamicConfig`](dynamic-config.md) - distributed runtime fields backed by Valkey hashes and pub/sub updates.
+- [`DynamicConfig`](dynamic-config.md) - distributed runtime fields backed by Valkey hashes and pub/sub updates, plus namespace registries and update validation.
 - [Channel pub/sub](channel-pubsub.md) - ephemeral, caller-managed key-scoped pub/sub.
 - [`RateLimiter`](rate-limiter.md) - sliding-window rate limiting backed by sorted sets and Lua scripts.
 - [Idempotency keys](idempotency-key.md) - consume-once values and token-fenced idempotency-key lifecycle helpers.

package/docs/dynamic-config.md

@@ -77,6 +77,8 @@ config.waitForInitialization(): Promise<void>
 
 Waits for field validation, default writes, initial field loading, pub/sub subscription, and timer creation.
 
+The shared subscription client uses a 2-second native connection timeout and a 5-second creation deadline. If creation rejects or reaches that deadline, the cached attempt is cleared and callers receive the failure; a later explicit call can start a new attempt. A client that finishes creation after the deadline is closed rather than retained. This does not automatically retry initialization or cancel an unresolved native creation operation.
+
 ## `getFields()`
 
 ```ts
@@ -149,3 +151,108 @@ import { dynamicConfigs } from "valkyries";
 ```
 
 Array of live `DynamicConfig` instances. It is used by `closeValkeyClients()` to close configs during shutdown.
+
+## `getBoundedPositiveIntegerField(config, field, limits)`
+
+```ts
+import { getBoundedPositiveIntegerField } from "valkyries/dynamic-config";
+
+const batchSize = getBoundedPositiveIntegerField(flags, "batchSize", {
+  defaultValue: 100,
+  maxValue: 1000,
+});
+```
+
+Reads a numeric field from `config.fields` and returns it only when it is an integer greater than `0` and at most `limits.maxValue`. Otherwise it returns `limits.defaultValue`.
+
+A missing field, a non-number, a non-integer, `0`, a negative number, and a value above `maxValue` all fall back to `defaultValue`. Values above `maxValue` are treated as invalid and are never clamped to the maximum.
+
+`config` only needs a `fields` map, so any `DynamicConfig` instance works.
+
+## Namespaces and Update Validation
+
+These helpers validate untrusted updates, such as admin edits, before they reach `setFields()`. They are pure: they never read or write Valkey, and they only read `config.fieldTypes`. Authorization, audit history, and response shapes stay in the application.
+
+```ts
+import {
+  createDynamicConfigRegistry,
+  defineDynamicConfigNamespace,
+  validateDynamicConfigUpdate,
+  validateStrictlyAscending,
+} from "valkyries/dynamic-config";
+
+const registry = createDynamicConfigRegistry([
+  defineDynamicConfigNamespace({
+    namespace: "limits",
+    config: limits, // a DynamicConfig
+    fields: {
+      soft: { minValue: 1, integer: true, description: "Soft limit" },
+      hard: { minValue: 1, maxValue: 1000, integer: true },
+    },
+    validate: (next) => validateStrictlyAscending(next, ["soft", "hard"]),
+  }),
+]);
+
+const entry = registry.get("limits");
+if (entry) {
+  await entry.config.waitForInitialization();
+  const update = validateDynamicConfigUpdate(entry, entry.config.getFields(), requestBody);
+  if (update.changed) await entry.config.setFields(update.changes);
+}
+```
+
+### `defineDynamicConfigNamespace(definition)`
+
+Returns `definition` unchanged. Throws when `fields` does not have exactly one entry per `config.fieldTypes` key, which catches rules that have drifted from the config schema. Definitions may carry extra application properties, such as labels or access policy. Those properties keep their types through the registry.
+
+```ts
+type DynamicConfigNamespaceDefinition = {
+  namespace: string;
+  config: { fieldTypes: Record<string, "string" | "number" | "boolean"> };
+  fields: Record<string, DynamicConfigFieldRules>;
+  validate?: (next: Record<string, string | number | boolean>) => void;
+};
+
+type DynamicConfigFieldRules = {
+  description?: string;
+  minValue?: number; // inclusive, number fields
+  maxValue?: number; // inclusive, number fields
+  maxValueExemption?: string; // why a number field has no maxValue
+  integer?: boolean; // number fields must be safe integers
+};
+```
+
+### `withMaxValueExemption(fields, reason, except?)`
+
+Returns a copy of `fields` that sets `maxValueExemption: reason` on every field without a `maxValue`, skipping the names in `except`.
+
+### `createDynamicConfigRegistry(entries)`
+
+Returns `{ entries, get(namespace) }`. `get` returns `null` for unknown namespaces. Throws on duplicate namespaces.
+
+### `validateDynamicConfigUpdate(definition, current, changes)`
+
+Validates `changes` against the definition and returns `{ changes, next, changed }`. `changes` holds the validated values, `next` is `current` merged with `changes`, and `changed` is true when any requested value differs from `current`. Throws `DynamicConfigValidationError` when:
+
+- `changes` is not a non-empty plain object
+- a field name is not in `config.fieldTypes`
+- a value does not already have the field's declared type (`boolean`, `string`, or a finite `number`)
+- a number breaks the field's `integer`, `minValue`, or `maxValue` rule
+
+After those checks it runs the definition's `validate` hook on `next`. The hook may throw any error.
+
+Unlike `setFields()`, it does not coerce values. For example, `"3"` is rejected for a number field and `"true"` is rejected for a boolean field.
+
+### `getChangedFields(previous, next)`
+
+Shallow diff of two field snapshots: `Record<string, { previous, next }>`. A missing key reads as `undefined`, and `null` or `undefined` snapshots are treated as empty.
+
+### Validators
+
+Use these inside a `validate` hook. Each one throws `DynamicConfigValidationError`.
+
+- `validatePositiveNumberFields(next)`: every number field must be finite and greater than 0.
+- `validatePositiveIntegerFields(next)`: every number field must be an integer greater than 0.
+- `validateNumberRange(next, field, min, max)`: `next[field]` must be a finite number in `[min, max]`.
+- `validateOneOf(next, field, allowed)`: `next[field]` must be one of the `allowed` strings.
+- `validateStrictlyAscending(next, fields)`: the named fields must be numbers in strictly ascending order.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valkyries",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Valkey utilities for caches, bloom filters, dynamic configuration, and rate limiting.",
   "homepage": "https://github.com/jonathanong/valkyries#readme",
   "bugs": {
@@ -70,7 +70,7 @@
     "@types/node": "^26.1.0",
     "@vitest/coverage-v8": "^5.0.0",
     "github-actionlint": "^1.7.12",
-    "oxfmt": "^0.68.0",
+    "oxfmt": "^0.70.0",
     "oxlint": "^1.65.0",
     "oxlint-tsgolint": "^7.0.2001",
     "tsx": "^4.22.1",