@vmz/vmz 0.0.1 → 0.0.2

package/dist/locale-delivery.d.ts

@@ -0,0 +1,298 @@
+/**
+ * @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): {
+    schema: string;
+    status: string;
+    host: any;
+    applicationId: any;
+    deliveryId: any;
+    planVersion: any;
+    supportedLocales: any[];
+    defaultLocale: any;
+    fallbackDigest: string;
+    routingRealization: any;
+    bundledLocales: any[];
+    lazyLocaleChunks: any[];
+    bundledChunks: {
+        schema: string;
+        localeId: any;
+        host: any;
+        messageIds: any;
+        hash: any;
+        kind: string;
+    }[];
+    formatterDataVersion: string;
+    messageCatalogHashes: {};
+    reachableMessageIds: any;
+    diagnostics: any[];
+};
+/**
+ * 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): {
+    schema: string;
+    status: string;
+    localeId: any;
+    diagnostics: any[];
+    pack: {
+        schema: string;
+        applicationId: any;
+        planVersion: any;
+        localeId: any;
+        signature: any;
+        formatterDataVersion: any;
+        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): {
+    schema: string;
+    status: string;
+    proven: any[];
+    diagnostics: any[];
+};
+/**
+ * Server/client boundary: ErrorCode + params only (no translated strings).
+ * @param {any} payload
+ */
+export declare function assertServerErrorEnvelope(payload: any): {
+    schema: string;
+    status: string;
+    diagnostics: any[];
+    envelope?: undefined;
+} | {
+    schema: string;
+    status: string;
+    envelope: {
+        schema: string;
+        code: any;
+        params: any;
+    };
+    diagnostics: any[];
+};
+/**
+ * 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): {
+    ok: boolean;
+    diagnostics: any[];
+};
+/**
+ * Same MessageId / catalog hashes must agree across Host projections.
+ * @param {Array<ReturnType<typeof buildLocaleDeliveryResolution>>} resolutions
+ */
+export declare function assertHostMessageInvariant(resolutions: any): {
+    ok: boolean;
+    diagnostics: any[];
+};
+/**
+ * Aggregate I4 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): {
+    schema: string;
+    status: string;
+    resolutions: {
+        web: {
+            schema: string;
+            status: string;
+            host: any;
+            applicationId: any;
+            deliveryId: any;
+            planVersion: any;
+            supportedLocales: any[];
+            defaultLocale: any;
+            fallbackDigest: string;
+            routingRealization: any;
+            bundledLocales: any[];
+            lazyLocaleChunks: any[];
+            bundledChunks: {
+                schema: string;
+                localeId: any;
+                host: any;
+                messageIds: any;
+                hash: any;
+                kind: string;
+            }[];
+            formatterDataVersion: string;
+            messageCatalogHashes: {};
+            reachableMessageIds: any;
+            diagnostics: any[];
+        };
+        mini: {
+            schema: string;
+            status: string;
+            host: any;
+            applicationId: any;
+            deliveryId: any;
+            planVersion: any;
+            supportedLocales: any[];
+            defaultLocale: any;
+            fallbackDigest: string;
+            routingRealization: any;
+            bundledLocales: any[];
+            lazyLocaleChunks: any[];
+            bundledChunks: {
+                schema: string;
+                localeId: any;
+                host: any;
+                messageIds: any;
+                hash: any;
+                kind: string;
+            }[];
+            formatterDataVersion: string;
+            messageCatalogHashes: {};
+            reachableMessageIds: any;
+            diagnostics: any[];
+        };
+        native: {
+            schema: string;
+            status: string;
+            host: any;
+            applicationId: any;
+            deliveryId: any;
+            planVersion: any;
+            supportedLocales: any[];
+            defaultLocale: any;
+            fallbackDigest: string;
+            routingRealization: any;
+            bundledLocales: any[];
+            lazyLocaleChunks: any[];
+            bundledChunks: {
+                schema: string;
+                localeId: any;
+                host: any;
+                messageIds: any;
+                hash: any;
+                kind: string;
+            }[];
+            formatterDataVersion: string;
+            messageCatalogHashes: {};
+            reachableMessageIds: any;
+            diagnostics: any[];
+        };
+        server: {
+            schema: string;
+            status: string;
+            host: any;
+            applicationId: any;
+            deliveryId: any;
+            planVersion: any;
+            supportedLocales: any[];
+            defaultLocale: any;
+            fallbackDigest: string;
+            routingRealization: any;
+            bundledLocales: any[];
+            lazyLocaleChunks: any[];
+            bundledChunks: {
+                schema: string;
+                localeId: any;
+                host: any;
+                messageIds: any;
+                hash: any;
+                kind: string;
+            }[];
+            formatterDataVersion: string;
+            messageCatalogHashes: {};
+            reachableMessageIds: any;
+            diagnostics: any[];
+        };
+    };
+    nativePackProbe: {
+        schema: string;
+        status: string;
+        localeId: any;
+        diagnostics: any[];
+        pack: {
+            schema: string;
+            applicationId: any;
+            planVersion: any;
+            localeId: any;
+            signature: any;
+            formatterDataVersion: any;
+            catalogKeys: string[];
+        };
+    };
+    miniPackageProof: {
+        schema: string;
+        status: string;
+        proven: any[];
+        diagnostics: any[];
+    };
+    serverErrorEnvelope: {
+        schema: string;
+        status: string;
+        diagnostics: any[];
+        envelope?: undefined;
+    } | {
+        schema: string;
+        status: string;
+        envelope: {
+            schema: string;
+            code: any;
+            params: any;
+        };
+        diagnostics: any[];
+    };
+    formatterDataVersion: string;
+    diagnostics: any[];
+};