@zlooks.cn/registry-config 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './registry.js';
+export * from './subscriber.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './registry.js';
+export * from './subscriber.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,8 @@
+export interface RegistryBootstrap {
+    readonly host: string;
+    readonly port: number;
+}
+export declare function parseAdvertiseHost(value: unknown): string | undefined;
+export declare function parseRegistryBootstrap(environment: Readonly<Record<string, string | undefined>>): RegistryBootstrap;
+export declare function registryConfigTopic(key: string): `registry:zlooks.cn/${string}`;
+//# 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":"AAOA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAErE;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GACxD,iBAAiB,CAMnB;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,MAAM,EAAE,CAM/E"}

package/dist/registry.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+const registryBootstrapSchema = z.object({
+    REGISTRY_HOST: z.string().trim().min(1),
+    REGISTRY_PORT: z.coerce.number().int().min(1).max(65_535),
+});
+const advertiseHostSchema = z.string().trim().min(1).optional();
+export function parseAdvertiseHost(value) {
+    return advertiseHostSchema.parse(value);
+}
+export function parseRegistryBootstrap(environment) {
+    const parsed = registryBootstrapSchema.parse(environment);
+    return Object.freeze({
+        host: parsed.REGISTRY_HOST,
+        port: parsed.REGISTRY_PORT,
+    });
+}
+export function registryConfigTopic(key) {
+    const normalized = key.trim();
+    if (!normalized || normalized.includes('/')) {
+        throw new Error('Registry configuration key must be one non-empty path segment');
+    }
+    return `registry:zlooks.cn/${normalized}`;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;CAC1D,CAAC,CAAC;AAOH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAEhE,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,WAAyD;IAEzD,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC,aAAa;QAC1B,IAAI,EAAE,MAAM,CAAC,aAAa;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,sBAAsB,UAAU,EAAE,CAAC;AAC5C,CAAC"}

package/dist/subscriber.d.ts

@@ -0,0 +1,23 @@
+import { type ReadonlyRef, type TopicSubscriber } from '@hile/reactivity';
+export interface RegistryConfigSource<T> {
+    readonly topic: string;
+    parse(value: unknown): T;
+}
+type RegistryConfigSources = Readonly<Record<string, RegistryConfigSource<unknown>>>;
+type ParsedSources<Sources extends RegistryConfigSources> = {
+    readonly [Key in keyof Sources]: Sources[Key] extends RegistryConfigSource<infer Value> ? Value : never;
+};
+export interface RegistryConfigSubscriptionOptions<Sources extends RegistryConfigSources, Config> {
+    readonly sources: Sources;
+    readonly compose: (sources: ParsedSources<Sources>) => Config;
+    readonly initialTimeoutMs?: number;
+    readonly onError?: (error: unknown) => void;
+}
+export interface RegistryConfigSubscription<Config> {
+    readonly current: ReadonlyRef<Config | undefined>;
+    snapshot(): Config;
+    close(): Promise<void>;
+}
+export declare function subscribeRegistryConfig<Sources extends RegistryConfigSources, Config>(application: TopicSubscriber, options: RegistryConfigSubscriptionOptions<Sources, Config>): Promise<RegistryConfigSubscription<Config>>;
+export {};
+//# sourceMappingURL=subscriber.d.ts.map

package/dist/subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber.d.ts","sourceRoot":"","sources":["../src/subscriber.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CAC1B;AAED,KAAK,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAIrF,KAAK,aAAa,CAAC,OAAO,SAAS,qBAAqB,IAAI;IAC1D,QAAQ,EAAE,GAAG,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,oBAAoB,CAAC,MAAM,KAAK,CAAC,GACnF,KAAK,GACL,KAAK;CACV,CAAC;AAEF,MAAM,WAAW,iCAAiC,CAChD,OAAO,SAAS,qBAAqB,EACrC,MAAM;IAEN,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC;IAC9D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B,CAAC,MAAM;IAChD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,QAAQ,IAAI,MAAM,CAAC;IACnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,SAAS,qBAAqB,EACrC,MAAM,EAEN,WAAW,EAAE,eAAe,EAC5B,OAAO,EAAE,iCAAiC,CAAC,OAAO,EAAE,MAAM,CAAC,GAC1D,OAAO,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAsE7C"}

package/dist/subscriber.js

@@ -0,0 +1,84 @@
+import { reactiveConfig, shallowRef, watchSerialLatest, } from '@hile/reactivity';
+export async function subscribeRegistryConfig(application, options) {
+    const keys = Object.keys(options.sources);
+    if (keys.length === 0)
+        throw new Error('At least one Registry configuration source is required');
+    const topics = Object.fromEntries(keys.map((key) => [key, options.sources[key].topic]));
+    const raw = await reactiveConfig(application, {
+        topics,
+        required: keys,
+        onError: (error) => report(options.onError, error),
+    });
+    const current = shallowRef();
+    let closePromise;
+    let watching = true;
+    let resolveReady;
+    let rejectReady;
+    const ready = new Promise((resolve, reject) => {
+        resolveReady = resolve;
+        rejectReady = reject;
+    });
+    const timer = setTimeout(() => {
+        rejectReady(new Error('Registry configuration was not ready before the initial timeout'));
+    }, options.initialTimeoutMs ?? 10_000);
+    const stopWatch = watchSerialLatest(raw.current, (sources) => {
+        if (sources === undefined)
+            return;
+        try {
+            const parsed = Object.fromEntries(keys.map((key) => [
+                key,
+                options.sources[key].parse(sources[key]),
+            ]));
+            current.value = options.compose(parsed);
+            resolveReady();
+        }
+        catch (error) {
+            report(options.onError, error);
+            if (current.value === undefined)
+                rejectReady(error);
+        }
+    }, { immediate: true });
+    const close = () => {
+        if (closePromise)
+            return closePromise;
+        if (watching) {
+            watching = false;
+            stopWatch();
+        }
+        const operation = raw.stop().catch((error) => {
+            closePromise = undefined;
+            throw error;
+        });
+        closePromise = operation;
+        return operation;
+    };
+    try {
+        await ready;
+    }
+    catch (error) {
+        await close().catch(() => undefined);
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    return {
+        current,
+        snapshot() {
+            const snapshot = current.value;
+            if (snapshot === undefined)
+                throw new Error('Registry configuration is not ready');
+            return snapshot;
+        },
+        close,
+    };
+}
+function report(observer, error) {
+    try {
+        void Promise.resolve(observer?.(error)).catch(() => undefined);
+    }
+    catch {
+        // Observability must not replace configuration validation or lifecycle errors.
+    }
+}
+//# sourceMappingURL=subscriber.js.map

package/dist/subscriber.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@zlooks.cn/registry-config",
+  "version": "1.0.0",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "pnpm run clean && tsc -p tsconfig.json && fix-esm-import-path --preserve-import-type ./dist",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@hile/reactivity": "3.0.1",
+    "@vue/reactivity": "3.5.41",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "26.2.0",
+    "fix-esm-import-path": "1.10.3",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11"
+  },
+  "gitHead": "a3e825c2a62561f73f49a54720e286f08da63429"
+}