@vmz/vmz 0.1.17 → 0.1.19

package/dist/locale-delivery.d.ts

@@ -1,111 +1,135 @@
-/**
- * @param {Record<string, string[]>} [fallback]
- */
-export declare function fallbackDigest(fallback?: {}): string;
-/**
- * Hash reachable message variants for one locale.
- * @param {Array<{ messageId: string, variants: Record<string, { template: string }> }>} messages
- * @param {string} localeId
- * @param {string[]} [reachableIds]
- */
-export declare function messageCatalogHash(messages: any, localeId: any, reachableIds: any): string;
-/**
- * Build LocaleDeliveryResolution for one Host surface.
- * @param {{
- * host: 'web'|'mini'|'native'|'server',
- * applicationId: string,
- * deliveryId: string,
- * planVersion?: string,
- * supportedLocales: string[],
- * defaultLocale: string,
- * fallback?: Record<string, string[]>,
- * routingRealization?: unknown,
- * messages: Array<{ messageId: string, variants: Record<string, { template: string }> }>,
- * reachableMessageIds?: string[],
- * bundledLocales?: string[],
- * allowFullClientBundle?: boolean,
- * }} input
- */
-export declare function buildLocaleDeliveryResolution(input: any): {
+export declare function fallbackDigest(fallback?: Record<string, string[]>): string;
+export interface DeliveryMessage {
+    messageId: string;
+    variants: Record<string, {
+        template: string;
+    }>;
+}
+/** Hash reachable message variants for one locale. */
+export declare function messageCatalogHash(messages: DeliveryMessage[], localeId: string, reachableIds?: string[]): string;
+export interface LocaleDeliveryInput {
+    host: 'web' | 'mini' | 'native' | 'server';
+    applicationId: string;
+    deliveryId: string;
+    planVersion?: string;
+    supportedLocales: string[];
+    defaultLocale: string;
+    fallback?: Record<string, string[]>;
+    routingRealization?: unknown;
+    messages: DeliveryMessage[];
+    reachableMessageIds?: string[];
+    bundledLocales?: string[];
+    allowFullClientBundle?: boolean;
+}
+/** Build LocaleDeliveryResolution for one Host surface. */
+export declare function buildLocaleDeliveryResolution(input: LocaleDeliveryInput): {
     schema: string;
     status: string;
-    host: any;
-    applicationId: any;
-    deliveryId: any;
-    planVersion: any;
-    supportedLocales: any[];
-    defaultLocale: any;
+    host: "web" | "mini" | "native" | "server";
+    applicationId: string;
+    deliveryId: string;
+    planVersion: string;
+    supportedLocales: string[];
+    defaultLocale: string;
     fallbackDigest: string;
-    routingRealization: any;
-    bundledLocales: any[];
-    lazyLocaleChunks: any[];
+    routingRealization: unknown;
+    bundledLocales: string[];
+    lazyLocaleChunks: {
+        schema: string;
+        localeId: string;
+        host: string;
+        messageIds: string[];
+        hash: string;
+        kind: string;
+    }[];
     bundledChunks: {
         schema: string;
-        localeId: any;
-        host: any;
-        messageIds: any;
-        hash: any;
+        localeId: string;
+        host: "web" | "mini" | "native" | "server";
+        messageIds: string[];
+        hash: string;
         kind: string;
     }[];
     formatterDataVersion: string;
-    messageCatalogHashes: {};
-    reachableMessageIds: any;
-    diagnostics: any[];
+    messageCatalogHashes: Record<string, string>;
+    reachableMessageIds: string[];
+    diagnostics: {
+        code: string;
+        severity: string;
+        message: string;
+    }[];
 };
-/**
- * Validate a Native optional locale pack (signed, no JS, bound to app/plan/schema).
- * @param {{
- * pack: {
- * schema?: string,
- * applicationId: string,
- * planVersion: string,
- * localeId: string,
- * signature?: string,
- * catalog?: Record<string, string>,
- * formatterDataVersion?: string,
- * entries?: Array<{ path: string, kind?: string }>,
- * executable?: boolean,
- * },
- * expectedApplicationId: string,
- * expectedPlanVersion: string,
- * }} input
- */
-export declare function validateNativeLocalePack(input: any): {
+/** Validate a Native optional locale pack (signed, no JS, bound to app/plan/schema). */
+export declare function validateNativeLocalePack(input: {
+    pack: {
+        schema?: string;
+        applicationId: string;
+        planVersion: string;
+        localeId: string;
+        signature?: string;
+        catalog?: Record<string, string>;
+        formatterDataVersion?: string;
+        entries?: Array<{
+            path: string;
+            kind?: string;
+        }>;
+        executable?: boolean;
+    };
+    expectedApplicationId: string;
+    expectedPlanVersion: string;
+}): {
     schema: string;
     status: string;
-    localeId: any;
-    diagnostics: any[];
+    localeId: string;
+    diagnostics: {
+        code: string;
+        severity: string;
+        message: string;
+    }[];
     pack: {
         schema: string;
-        applicationId: any;
-        planVersion: any;
-        localeId: any;
-        signature: any;
-        formatterDataVersion: any;
+        applicationId: string;
+        planVersion: string;
+        localeId: string;
+        signature: string;
+        formatterDataVersion: string;
         catalogKeys: string[];
     };
 };
-/**
- * Mini cross-subpackage message dependencies must be proven.
- * @param {{
- * packages: Array<{ id: string, messageIds: string[] }>,
- * edges: Array<{ fromPackage: string, toPackage: string, messageId: string }>,
- * }} input
- */
-export declare function proveMiniPackageMessages(input: any): {
+/** Mini cross-subpackage message dependencies must be proven. */
+export declare function proveMiniPackageMessages(input: {
+    packages: Array<{
+        id: string;
+        messageIds: string[];
+    }>;
+    edges: Array<{
+        fromPackage: string;
+        toPackage: string;
+        messageId: string;
+    }>;
+}): {
     schema: string;
     status: string;
-    proven: any[];
-    diagnostics: any[];
+    proven: {
+        fromPackage: string;
+        toPackage: string;
+        messageId: string;
+    }[];
+    diagnostics: {
+        code: string;
+        severity: string;
+        message: string;
+    }[];
 };
-/**
- * Server/client boundary: ErrorCode + params only (no translated strings).
- * @param {any} payload
- */
+/** Server/client boundary: ErrorCode + params only (no translated strings). */
 export declare function assertServerErrorEnvelope(payload: any): {
     schema: string;
     status: string;
-    diagnostics: any[];
+    diagnostics: {
+        code: string;
+        severity: string;
+        message: string;
+    }[];
     envelope?: undefined;
 } | {
     schema: string;
@@ -115,173 +139,244 @@ export declare function assertServerErrorEnvelope(payload: any): {
         code: any;
         params: any;
     };
-    diagnostics: any[];
+    diagnostics: {
+        code: string;
+        severity: string;
+        message: string;
+    }[];
 };
-/**
- * Final-user server formatting (mail/export/push) requires explicit LocaleContext.
- * @param {{ localeContext?: { localeId?: string, timeZone?: string }|null, purpose: string }} input
- */
-export declare function assertServerFormatContext(input: any): {
+/** Final-user server formatting (mail/export/push) requires explicit LocaleContext. */
+export declare function assertServerFormatContext(input: {
+    localeContext?: {
+        localeId?: string;
+        timeZone?: string;
+    } | null;
+    purpose: string;
+}): {
     ok: boolean;
-    diagnostics: any[];
+    diagnostics: {
+        code: string;
+        severity: string;
+        message: string;
+    }[];
 };
-/**
- * Same MessageId / catalog hashes must agree across Host projections.
- * @param {Array<ReturnType<typeof buildLocaleDeliveryResolution>>} resolutions
- */
-export declare function assertHostMessageInvariant(resolutions: any): {
+/** Same MessageId / catalog hashes must agree across Host projections. */
+export declare function assertHostMessageInvariant(resolutions: Array<ReturnType<typeof buildLocaleDeliveryResolution>>): {
     ok: boolean;
-    diagnostics: any[];
+    diagnostics: {
+        code: string;
+        severity: string;
+        message: string;
+    }[];
 };
-/**
- * Aggregate delivery proof for fixture / CLI.
- * @param {{
- * manifest: {
- * defaultLocale: string,
- * locales: Array<{ id: string }>,
- * fallback?: Record<string, string[]>,
- * routing?: unknown,
- * },
- * messages: Array<{ messageId: string, variants: Record<string, { template: string }> }>,
- * applicationId?: string,
- * planVersion?: string,
- * reachableMessageIds?: string[],
- * }} input
- */
-export declare function checkLocaleDelivery(input: any): {
+/** Aggregate delivery proof for fixture / CLI. */
+export declare function checkLocaleDelivery(input: {
+    manifest: {
+        defaultLocale: string;
+        locales: Array<{
+            id: string;
+        }>;
+        fallback?: Record<string, string[]>;
+        routing?: unknown;
+    };
+    messages: DeliveryMessage[];
+    applicationId?: string;
+    planVersion?: string;
+    reachableMessageIds?: string[];
+}): {
     schema: string;
     status: string;
     resolutions: {
         web: {
             schema: string;
             status: string;
-            host: any;
-            applicationId: any;
-            deliveryId: any;
-            planVersion: any;
-            supportedLocales: any[];
-            defaultLocale: any;
+            host: "web" | "mini" | "native" | "server";
+            applicationId: string;
+            deliveryId: string;
+            planVersion: string;
+            supportedLocales: string[];
+            defaultLocale: string;
             fallbackDigest: string;
-            routingRealization: any;
-            bundledLocales: any[];
-            lazyLocaleChunks: any[];
+            routingRealization: unknown;
+            bundledLocales: string[];
+            lazyLocaleChunks: {
+                schema: string;
+                localeId: string;
+                host: string;
+                messageIds: string[];
+                hash: string;
+                kind: string;
+            }[];
             bundledChunks: {
                 schema: string;
-                localeId: any;
-                host: any;
-                messageIds: any;
-                hash: any;
+                localeId: string;
+                host: "web" | "mini" | "native" | "server";
+                messageIds: string[];
+                hash: string;
                 kind: string;
             }[];
             formatterDataVersion: string;
-            messageCatalogHashes: {};
-            reachableMessageIds: any;
-            diagnostics: any[];
+            messageCatalogHashes: Record<string, string>;
+            reachableMessageIds: string[];
+            diagnostics: {
+                code: string;
+                severity: string;
+                message: string;
+            }[];
         };
         mini: {
             schema: string;
             status: string;
-            host: any;
-            applicationId: any;
-            deliveryId: any;
-            planVersion: any;
-            supportedLocales: any[];
-            defaultLocale: any;
+            host: "web" | "mini" | "native" | "server";
+            applicationId: string;
+            deliveryId: string;
+            planVersion: string;
+            supportedLocales: string[];
+            defaultLocale: string;
             fallbackDigest: string;
-            routingRealization: any;
-            bundledLocales: any[];
-            lazyLocaleChunks: any[];
+            routingRealization: unknown;
+            bundledLocales: string[];
+            lazyLocaleChunks: {
+                schema: string;
+                localeId: string;
+                host: string;
+                messageIds: string[];
+                hash: string;
+                kind: string;
+            }[];
             bundledChunks: {
                 schema: string;
-                localeId: any;
-                host: any;
-                messageIds: any;
-                hash: any;
+                localeId: string;
+                host: "web" | "mini" | "native" | "server";
+                messageIds: string[];
+                hash: string;
                 kind: string;
             }[];
             formatterDataVersion: string;
-            messageCatalogHashes: {};
-            reachableMessageIds: any;
-            diagnostics: any[];
+            messageCatalogHashes: Record<string, string>;
+            reachableMessageIds: string[];
+            diagnostics: {
+                code: string;
+                severity: string;
+                message: string;
+            }[];
         };
         native: {
             schema: string;
             status: string;
-            host: any;
-            applicationId: any;
-            deliveryId: any;
-            planVersion: any;
-            supportedLocales: any[];
-            defaultLocale: any;
+            host: "web" | "mini" | "native" | "server";
+            applicationId: string;
+            deliveryId: string;
+            planVersion: string;
+            supportedLocales: string[];
+            defaultLocale: string;
             fallbackDigest: string;
-            routingRealization: any;
-            bundledLocales: any[];
-            lazyLocaleChunks: any[];
+            routingRealization: unknown;
+            bundledLocales: string[];
+            lazyLocaleChunks: {
+                schema: string;
+                localeId: string;
+                host: string;
+                messageIds: string[];
+                hash: string;
+                kind: string;
+            }[];
             bundledChunks: {
                 schema: string;
-                localeId: any;
-                host: any;
-                messageIds: any;
-                hash: any;
+                localeId: string;
+                host: "web" | "mini" | "native" | "server";
+                messageIds: string[];
+                hash: string;
                 kind: string;
             }[];
             formatterDataVersion: string;
-            messageCatalogHashes: {};
-            reachableMessageIds: any;
-            diagnostics: any[];
+            messageCatalogHashes: Record<string, string>;
+            reachableMessageIds: string[];
+            diagnostics: {
+                code: string;
+                severity: string;
+                message: string;
+            }[];
         };
         server: {
             schema: string;
             status: string;
-            host: any;
-            applicationId: any;
-            deliveryId: any;
-            planVersion: any;
-            supportedLocales: any[];
-            defaultLocale: any;
+            host: "web" | "mini" | "native" | "server";
+            applicationId: string;
+            deliveryId: string;
+            planVersion: string;
+            supportedLocales: string[];
+            defaultLocale: string;
             fallbackDigest: string;
-            routingRealization: any;
-            bundledLocales: any[];
-            lazyLocaleChunks: any[];
+            routingRealization: unknown;
+            bundledLocales: string[];
+            lazyLocaleChunks: {
+                schema: string;
+                localeId: string;
+                host: string;
+                messageIds: string[];
+                hash: string;
+                kind: string;
+            }[];
             bundledChunks: {
                 schema: string;
-                localeId: any;
-                host: any;
-                messageIds: any;
-                hash: any;
+                localeId: string;
+                host: "web" | "mini" | "native" | "server";
+                messageIds: string[];
+                hash: string;
                 kind: string;
             }[];
             formatterDataVersion: string;
-            messageCatalogHashes: {};
-            reachableMessageIds: any;
-            diagnostics: any[];
+            messageCatalogHashes: Record<string, string>;
+            reachableMessageIds: string[];
+            diagnostics: {
+                code: string;
+                severity: string;
+                message: string;
+            }[];
         };
     };
     nativePackProbe: {
         schema: string;
         status: string;
-        localeId: any;
-        diagnostics: any[];
+        localeId: string;
+        diagnostics: {
+            code: string;
+            severity: string;
+            message: string;
+        }[];
         pack: {
             schema: string;
-            applicationId: any;
-            planVersion: any;
-            localeId: any;
-            signature: any;
-            formatterDataVersion: any;
+            applicationId: string;
+            planVersion: string;
+            localeId: string;
+            signature: string;
+            formatterDataVersion: string;
             catalogKeys: string[];
         };
     };
     miniPackageProof: {
         schema: string;
         status: string;
-        proven: any[];
-        diagnostics: any[];
+        proven: {
+            fromPackage: string;
+            toPackage: string;
+            messageId: string;
+        }[];
+        diagnostics: {
+            code: string;
+            severity: string;
+            message: string;
+        }[];
     };
     serverErrorEnvelope: {
         schema: string;
         status: string;
-        diagnostics: any[];
+        diagnostics: {
+            code: string;
+            severity: string;
+            message: string;
+        }[];
         envelope?: undefined;
     } | {
         schema: string;
@@ -291,8 +386,16 @@ export declare function checkLocaleDelivery(input: any): {
             code: any;
             params: any;
         };
-        diagnostics: any[];
+        diagnostics: {
+            code: string;
+            severity: string;
+            message: string;
+        }[];
     };
     formatterDataVersion: string;
-    diagnostics: any[];
+    diagnostics: {
+        code: string;
+        severity: string;
+        message: string;
+    }[];
 };