@vmz/vmz 0.1.17 → 0.1.19

package/dist/build-assemble.js

@@ -1,7 +1,6 @@
 /**
  * B5 Assemble dispatch + B6 build-proof (per-build semantic id slots).
  */
-// @ts-nocheck
 import { mkdirSync } from 'node:fs';
 import path from 'node:path';
 import { semanticIdsForAssembly, sha256Hex, canonicalJson } from './delivery-profile.js';
@@ -14,12 +13,9 @@ import { emitWebStatic } from './static-emit.js';
 import { writePrettyJsonFile } from './pretty-json.js';
 export const BUILD_PROOF_SCHEMA = 'vmz.build.proof.v0';
 export const ASSEMBLE_MANIFEST_SCHEMA = 'vmz.assemble.manifest.v0';
-/**
- * @param {string} outDir
- * @param {any} ctx
- */
 export async function assembleDelivery(outDir, ctx) {
-    const { selection, profile } = ctx;
+    const selection = ctx.selection;
+    const profile = ctx.profile;
     const assembly = selection.assembly;
     const result = {
         schema: ASSEMBLE_MANIFEST_SCHEMA,
@@ -59,24 +55,25 @@ export async function assembleDelivery(outDir, ctx) {
     }
     if (assembly === 'server-host' || assembly === 'cdn+server') {
         const server = emitServerArtifact(outDir, {
-            profileId: selection.profileId,
-            assembly,
-            serverRuntime: selection.serverRuntime || 'node',
-            packDigest: ctx.pack?.packDigest || null,
+            profileId: String(selection.profileId ?? ''),
+            assembly: String(assembly),
+            serverRuntime: String(selection.serverRuntime || 'node'),
+            packDigest: ctx.pack?.packDigest ?? null,
         });
+        const serverArtifact = server.artifact;
         result.steps.push({
             kind: 'server-host',
             status: 'emitted',
-            digest: server.artifact.artifactDigest,
-            publicRoutes: server.artifact.publicRoutes?.length ?? 0,
-            internalCapabilities: server.artifact.internalCapabilities?.length ?? 0,
+            digest: serverArtifact.artifactDigest,
+            publicRoutes: serverArtifact.publicRoutes?.length ?? 0,
+            internalCapabilities: serverArtifact.internalCapabilities?.length ?? 0,
             httpContractDigest: server.httpContractDigest,
         });
         result.serverArtifact = {
-            digest: server.artifact.artifactDigest,
+            digest: serverArtifact.artifactDigest,
             httpContractDigest: server.httpContractDigest,
-            schema: server.artifact.schema,
-            selectedRuntime: server.artifact.selectedRuntime,
+            schema: serverArtifact.schema,
+            selectedRuntime: serverArtifact.selectedRuntime,
         };
     }
     const siteAuthoring = profile.sources || null;
@@ -87,32 +84,35 @@ export async function assembleDelivery(outDir, ctx) {
         const site = emitSiteDelivery(outDir, siteAuthoring, {
             siteId: ctx.siteId,
         });
+        const siteContract = site.contract;
         result.steps.push({
             kind: 'site-delivery',
-            digest: site.contract.contractDigest,
+            digest: siteContract.contractDigest,
         });
         result.siteDelivery = {
-            digest: site.contract.contractDigest,
-            schema: site.contract.schema,
+            digest: siteContract.contractDigest,
+            schema: siteContract.schema,
         };
         if (assembly === 'rust-embedded') {
             const pack = emitEmbeddedPackaging(outDir, {
                 siteId: ctx.siteId,
-                contractDigest: site.contract.contractDigest,
+                contractDigest: siteContract.contractDigest,
             });
+            const packIndex = pack.index;
             result.steps.push({
                 kind: 'embedded-packaging',
-                digest: pack.index.indexDigest,
-                objectCount: pack.index.objectCount,
+                digest: packIndex.indexDigest,
+                objectCount: packIndex.objectCount,
             });
             result.embeddedPackaging = {
-                digest: pack.index.indexDigest,
-                objectCount: pack.index.objectCount,
-                schema: pack.index.schema,
+                digest: packIndex.indexDigest,
+                objectCount: packIndex.objectCount,
+                schema: packIndex.schema,
             };
         }
     }
-    result.packDigest = ctx.pack?.packDigest || null;
+    const packCtx = ctx.pack;
+    result.packDigest = packCtx?.packDigest || null;
     result.assembleDigest = sha256Hex(canonicalJson({ ...result, assembleDigest: undefined }));
     const vmzDir = path.join(outDir, '_vmz');
     mkdirSync(vmzDir, { recursive: true });
@@ -120,12 +120,11 @@ export async function assembleDelivery(outDir, ctx) {
     writePrettyJsonFile(file, result);
     return { manifest: result, path: file };
 }
-/**
- * @param {string} outDir
- * @param {any} ctx
- */
 export function emitBuildProof(outDir, ctx) {
-    const semanticIds = semanticIdsForAssembly(ctx.selection.assembly);
+    const selection = ctx.selection;
+    const assemble = ctx.assemble;
+    const packCtx = ctx.pack;
+    const semanticIds = semanticIdsForAssembly(selection.assembly);
     const slots = {
         'server-host': { status: 'not-applicable' },
         'static-delivery': { status: 'not-applicable' },
@@ -134,14 +133,14 @@ export function emitBuildProof(outDir, ctx) {
     };
     for (const id of semanticIds) {
         if (id === 'static-delivery') {
-            const step = (ctx.assemble?.steps || []).find((s) => s.kind === 'web-static');
+            const step = (assemble?.steps || []).find((s) => s.kind === 'web-static');
             slots[id] = step
                 ? { status: 'emitted', detail: `digest=${String(step.digest).slice(0, 12)}` }
                 : { status: 'pending', detail: 'assembly requires static emit' };
         }
         else if (id === 'site-fallback') {
-            const siteStep = (ctx.assemble?.steps || []).find((s) => s.kind === 'site-delivery');
-            const packStep = (ctx.assemble?.steps || []).find((s) => s.kind === 'embedded-packaging');
+            const siteStep = (assemble?.steps || []).find((s) => s.kind === 'site-delivery');
+            const packStep = (assemble?.steps || []).find((s) => s.kind === 'embedded-packaging');
             if (siteStep && packStep) {
                 slots[id] = {
                     status: 'emitted',
@@ -159,7 +158,7 @@ export function emitBuildProof(outDir, ctx) {
             }
         }
         else if (id === 'server-host') {
-            const step = (ctx.assemble?.steps || []).find((s) => s.kind === 'server-host');
+            const step = (assemble?.steps || []).find((s) => s.kind === 'server-host');
             slots[id] =
                 step && step.status === 'emitted'
                     ? {
@@ -173,20 +172,20 @@ export function emitBuildProof(outDir, ctx) {
         }
         else if (id === 'asset-graph') {
             slots[id] = {
-                status: ctx.pack?.packDigest ? 'pack-digest' : 'pending',
-                detail: ctx.pack?.packDigest
-                    ? `pack=${String(ctx.pack.packDigest).slice(0, 12)} units=${ctx.pack.unitCount ?? '?'}`
+                status: packCtx?.packDigest ? 'pack-digest' : 'pending',
+                detail: packCtx?.packDigest
+                    ? `pack=${String(packCtx.packDigest).slice(0, 12)} units=${packCtx.unitCount ?? '?'}`
                     : 'pack missing',
             };
         }
     }
     const body = {
         schema: BUILD_PROOF_SCHEMA,
-        profileId: ctx.selection.profileId,
-        assembly: ctx.selection.assembly,
-        selectionDigest: ctx.selection.digest || null,
-        packDigest: ctx.pack?.packDigest || null,
-        assembleDigest: ctx.assemble?.assembleDigest || null,
+        profileId: selection.profileId,
+        assembly: selection.assembly,
+        selectionDigest: selection.digest || null,
+        packDigest: packCtx?.packDigest || null,
+        assembleDigest: assemble?.assembleDigest || null,
         release: Boolean(ctx.release),
         semanticIds,
         slots,

package/dist/bundler-adapter.d.ts

@@ -3,48 +3,49 @@
  *
  * Vite/Rolldown may call these helpers; they must not reverse the arrow.
  */
-/**
- * @typedef {object} DeploymentUnit
- * @property {string} chunkId
- * @property {string} kind
- * @property {string} source
- * @property {string} clientEntry
- * @property {string} programIr
- * @property {string[]} [dependsOn]
- * @property {string[]} [dependedBy]
- * @property {boolean} [rebuilt]
- */
-/**
- * @typedef {object} DeploymentIr
- * @property {string} schema
- * @property {DeploymentUnit[]} units
- * @property {string[]} [affectedChunks]
- * @property {string[]} [seedChunks]
- * @property {boolean} [islandHmr]
- * @property {boolean} [full]
- */
-/**
- * @param {string} outDir
- * @returns {DeploymentIr}
- */
-export declare function loadDeploymentIr(outDir: any): any;
-/**
- * Map Deployment IR → bundler entry points (absolute paths under outDir).
- * @param {string} outDir
- * @param {DeploymentIr} [ir]
- */
-export declare function planBundleInputs(outDir: any, ir?: any): any;
-/**
- * Entries that were rebuilt in the last emit (HMR / incremental pack).
- * @param {string} outDir
- * @param {DeploymentIr} [ir]
- */
-export declare function planAffectedBundleInputs(outDir: any, ir?: any): any;
-/**
- * Thin Vite plugin factory: only reads Deployment IR. No `.vmz` transform hooks.
- * @param {{ outDir?: string, root?: string }} [options]
- */
-export declare function createVitePluginVmzAdapter(options?: {}): {
+export interface DeploymentUnit {
+    chunkId: string;
+    kind: string;
+    source: string;
+    clientEntry: string;
+    programIr: string;
+    dependsOn?: string[];
+    dependedBy?: string[];
+    rebuilt?: boolean;
+}
+export interface DeploymentIr {
+    schema: string;
+    units: DeploymentUnit[];
+    affectedChunks?: string[];
+    seedChunks?: string[];
+    islandHmr?: boolean;
+    full?: boolean;
+}
+export interface VmzAdapterOptions {
+    outDir?: string;
+    root?: string;
+}
+export declare function loadDeploymentIr(outDir: string): DeploymentIr;
+/** Map Deployment IR → bundler entry points (absolute paths under outDir). */
+export declare function planBundleInputs(outDir: string, ir?: DeploymentIr): Array<{
+    chunkId: string;
+    kind: string;
+    entry: string;
+    programIr: string;
+    source: string;
+    rebuilt: boolean;
+}>;
+/** Entries that were rebuilt in the last emit (HMR / incremental pack). */
+export declare function planAffectedBundleInputs(outDir: string, ir?: DeploymentIr): {
+    chunkId: string;
+    kind: string;
+    entry: string;
+    programIr: string;
+    source: string;
+    rebuilt: boolean;
+}[];
+/** Thin Vite plugin factory: only reads Deployment IR. No `.vmz` transform hooks. */
+export declare function createVitePluginVmzAdapter(options?: VmzAdapterOptions): {
     name: string;
     buildStart(): void;
     /**
@@ -52,12 +53,9 @@ export declare function createVitePluginVmzAdapter(options?: {}): {
      */
     configResolved(): void;
 };
-/**
- * Thin Rolldown plugin factory (deployment) — same contract as Vite adapter: read Deployment IR only.
- * @param {{ outDir?: string, root?: string }} [options]
- */
-export declare function createRolldownPluginVmzAdapter(options?: {}): {
+/** Thin Rolldown plugin factory (deployment) — same contract as Vite adapter: read Deployment IR only. */
+export declare function createRolldownPluginVmzAdapter(options?: VmzAdapterOptions): {
     name: string;
     buildStart(): void;
-    options(inputOptions: any): any;
+    options(inputOptions: unknown): unknown;
 };

package/dist/bundler-adapter.js

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Bundler adapter (session) — consumes Deployment IR; does not invent VMZ semantics.
  *
@@ -6,30 +5,6 @@
  */
 import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
-/**
- * @typedef {object} DeploymentUnit
- * @property {string} chunkId
- * @property {string} kind
- * @property {string} source
- * @property {string} clientEntry
- * @property {string} programIr
- * @property {string[]} [dependsOn]
- * @property {string[]} [dependedBy]
- * @property {boolean} [rebuilt]
- */
-/**
- * @typedef {object} DeploymentIr
- * @property {string} schema
- * @property {DeploymentUnit[]} units
- * @property {string[]} [affectedChunks]
- * @property {string[]} [seedChunks]
- * @property {boolean} [islandHmr]
- * @property {boolean} [full]
- */
-/**
- * @param {string} outDir
- * @returns {DeploymentIr}
- */
 export function loadDeploymentIr(outDir) {
     const file = path.join(outDir, 'vmz-deployment.json');
     if (!existsSync(file)) {
@@ -41,11 +16,7 @@ export function loadDeploymentIr(outDir) {
     }
     return ir;
 }
-/**
- * Map Deployment IR → bundler entry points (absolute paths under outDir).
- * @param {string} outDir
- * @param {DeploymentIr} [ir]
- */
+/** Map Deployment IR → bundler entry points (absolute paths under outDir). */
 export function planBundleInputs(outDir, ir = loadDeploymentIr(outDir)) {
     return (ir.units || []).map((u) => ({
         chunkId: u.chunkId,
@@ -56,19 +27,12 @@ export function planBundleInputs(outDir, ir = loadDeploymentIr(outDir)) {
         rebuilt: Boolean(u.rebuilt),
     }));
 }
-/**
- * Entries that were rebuilt in the last emit (HMR / incremental pack).
- * @param {string} outDir
- * @param {DeploymentIr} [ir]
- */
+/** Entries that were rebuilt in the last emit (HMR / incremental pack). */
 export function planAffectedBundleInputs(outDir, ir = loadDeploymentIr(outDir)) {
     const affected = new Set(ir.affectedChunks || []);
     return planBundleInputs(outDir, ir).filter((e) => e.rebuilt || affected.has(e.chunkId));
 }
-/**
- * Thin Vite plugin factory: only reads Deployment IR. No `.vmz` transform hooks.
- * @param {{ outDir?: string, root?: string }} [options]
- */
+/** Thin Vite plugin factory: only reads Deployment IR. No `.vmz` transform hooks. */
 export function createVitePluginVmzAdapter(options = {}) {
     const outDir = options.outDir ?? 'dist';
     return {
@@ -88,10 +52,7 @@ export function createVitePluginVmzAdapter(options = {}) {
         },
     };
 }
-/**
- * Thin Rolldown plugin factory (deployment) — same contract as Vite adapter: read Deployment IR only.
- * @param {{ outDir?: string, root?: string }} [options]
- */
+/** Thin Rolldown plugin factory (deployment) — same contract as Vite adapter: read Deployment IR only. */
 export function createRolldownPluginVmzAdapter(options = {}) {
     const outDir = options.outDir ?? 'dist';
     return {

package/dist/cdn-policy.d.ts

@@ -8,94 +8,62 @@ export declare const CDN_ADAPTER_PROJECTION_SCHEMA = "vmz.cdn.adapter_projection
 export declare const CACHE_HTML = "public, max-age=0, must-revalidate";
 export declare const CACHE_ASSET_IMMUTABLE = "public, max-age=31536000, immutable";
 export declare const CACHE_META = "public, max-age=3600";
-/**
- * Build CDNPolicyManifest from StaticDeliveryManifest (+ optional redirects / locale artifact).
- * Locale-prefixed HTML gets LocaleId-encoded cache keys; Accept-Language must not steal body.
- * @param {Record<string, any>} staticManifest
- * @param {{
- *   redirects?: Array<{ from: string, to: string, status?: number, reason?: string }>,
- *   localeArtifact?: Record<string, any> | null,
- * }} [opts]
- */
-export declare function buildCdnPolicyManifest(staticManifest: any, opts?: {}): {
+export interface CdnRedirect {
+    from: string;
+    to: string;
+    status?: number;
+    reason?: string;
+}
+interface BuildCdnPolicyOpts {
+    redirects?: CdnRedirect[];
+    localeArtifact?: Record<string, unknown> | null;
+}
+export interface CdnPolicyManifest {
     schema: string;
-    applicationId: any;
+    applicationId: unknown;
     deliveryProfile: string;
     origin: string;
     spaFallback: boolean;
-    staticManifestDigest: any;
-    redirects: any[];
-    headers: ({
+    staticManifestDigest: unknown;
+    redirects: CdnRedirect[];
+    headers: Array<{
         match: string;
-        headers: {
-            'cache-control': string;
-            'x-robots-tag'?: undefined;
-        };
-    } | {
-        match: string;
-        headers: {
-            'cache-control': string;
-            'x-robots-tag': string;
-        };
-    })[];
-    errorDocuments: any;
-    routes: any[];
-    localeCache: {
-        strategy: string;
-        varyAcceptLanguage: boolean;
-        defaultLocale: any;
-        routeCount: number;
-        locales: any[];
-    };
-};
+        headers: Record<string, string | undefined>;
+    }>;
+    errorDocuments: unknown[];
+    routes: unknown[];
+    localeCache: Record<string, unknown>;
+    policyDigest?: string;
+}
+interface EmitCdnPolicyOpts {
+    redirects?: CdnRedirect[];
+}
+interface LocalStaticHostOpts {
+    host?: string;
+    port?: number;
+}
+export declare function buildCdnPolicyManifest(staticManifest: Record<string, unknown>, opts?: BuildCdnPolicyOpts): CdnPolicyManifest;
 /**
  * Write CDN policy + adapter projections under dist/_vmz.
  * @param {string} distDir
  * @param {Record<string, any>} staticManifest
  * @param {{ redirects?: Array<{ from: string, to: string, status?: number, reason?: string }> }} [opts]
  */
-export declare function emitCdnPolicy(distDir: any, staticManifest: any, opts?: {}): {
-    policy: {
-        schema: string;
-        applicationId: any;
-        deliveryProfile: string;
-        origin: string;
-        spaFallback: boolean;
-        staticManifestDigest: any;
-        redirects: any[];
-        headers: ({
-            match: string;
-            headers: {
-                'cache-control': string;
-                'x-robots-tag'?: undefined;
-            };
-        } | {
-            match: string;
-            headers: {
-                'cache-control': string;
-                'x-robots-tag': string;
-            };
-        })[];
-        errorDocuments: any;
-        routes: any[];
-        localeCache: {
-            strategy: string;
-            varyAcceptLanguage: boolean;
-            defaultLocale: any;
-            routeCount: number;
-            locales: any[];
-        };
-    };
+export declare function emitCdnPolicy(distDir: string, staticManifest: Record<string, unknown>, opts?: EmitCdnPolicyOpts): {
+    policy: CdnPolicyManifest;
     adapters: {
         'local-static': {
             schema: string;
             adapterId: string;
-            policyDigest: any;
+            policyDigest: string;
             host: string;
             spaFallback: boolean;
-            redirects: any;
-            headers: any;
-            errorDocuments: any;
+            redirects: CdnRedirect[];
+            headers: {
+                match: string;
+                headers: Record<string, string | undefined>;
+            }[];
+            errorDocuments: unknown[];
             files: {
                 _headers?: undefined;
                 _redirects?: undefined;
@@ -103,12 +71,15 @@ export declare function emitCdnPolicy(distDir: any, staticManifest: any, opts?:
         } | {
             schema: string;
             adapterId: string;
-            policyDigest: any;
+            policyDigest: string;
             host: string;
             spaFallback: boolean;
-            redirects: any;
-            headers: any;
-            errorDocuments: any;
+            redirects: CdnRedirect[];
+            headers: {
+                match: string;
+                headers: Record<string, string | undefined>;
+            }[];
+            errorDocuments: unknown[];
             files: {
                 _headers: string;
                 _redirects: string;
@@ -117,12 +88,15 @@ export declare function emitCdnPolicy(distDir: any, staticManifest: any, opts?:
         netlify: {
             schema: string;
             adapterId: string;
-            policyDigest: any;
+            policyDigest: string;
             host: string;
             spaFallback: boolean;
-            redirects: any;
-            headers: any;
-            errorDocuments: any;
+            redirects: CdnRedirect[];
+            headers: {
+                match: string;
+                headers: Record<string, string | undefined>;
+            }[];
+            errorDocuments: unknown[];
             files: {
                 _headers?: undefined;
                 _redirects?: undefined;
@@ -130,12 +104,15 @@ export declare function emitCdnPolicy(distDir: any, staticManifest: any, opts?:
         } | {
             schema: string;
             adapterId: string;
-            policyDigest: any;
+            policyDigest: string;
             host: string;
             spaFallback: boolean;
-            redirects: any;
-            headers: any;
-            errorDocuments: any;
+            redirects: CdnRedirect[];
+            headers: {
+                match: string;
+                headers: Record<string, string | undefined>;
+            }[];
+            errorDocuments: unknown[];
             files: {
                 _headers: string;
                 _redirects: string;
@@ -148,15 +125,18 @@ export declare function emitCdnPolicy(distDir: any, staticManifest: any, opts?:
  * @param {Record<string, any>} policy
  * @param {'local-static' | 'netlify'} adapterId
  */
-export declare function projectCdnAdapter(policy: any, adapterId: any): {
+export declare function projectCdnAdapter(policy: CdnPolicyManifest, adapterId: 'local-static' | 'netlify'): {
     schema: string;
     adapterId: string;
-    policyDigest: any;
+    policyDigest: string;
     host: string;
     spaFallback: boolean;
-    redirects: any;
-    headers: any;
-    errorDocuments: any;
+    redirects: CdnRedirect[];
+    headers: {
+        match: string;
+        headers: Record<string, string | undefined>;
+    }[];
+    errorDocuments: unknown[];
     files: {
         _headers?: undefined;
         _redirects?: undefined;
@@ -164,12 +144,15 @@ export declare function projectCdnAdapter(policy: any, adapterId: any): {
 } | {
     schema: string;
     adapterId: string;
-    policyDigest: any;
+    policyDigest: string;
     host: string;
     spaFallback: boolean;
-    redirects: any;
-    headers: any;
-    errorDocuments: any;
+    redirects: CdnRedirect[];
+    headers: {
+        match: string;
+        headers: Record<string, string | undefined>;
+    }[];
+    errorDocuments: unknown[];
     files: {
         _headers: string;
         _redirects: string;
@@ -182,7 +165,7 @@ export declare function projectCdnAdapter(policy: any, adapterId: any): {
  * @param {{ host?: string, port?: number }} [opts]
  * @returns {Promise<{ host: string, port: number, baseUrl: string, close: () => Promise<void> }>}
  */
-export declare function listenLocalStaticHost(distDir: any, policy: any, opts?: {}): Promise<unknown>;
+export declare function listenLocalStaticHost(distDir: string, policy: Record<string, unknown>, opts?: LocalStaticHostOpts): Promise<unknown>;
 /**
  * @param {string} distDir
  * @param {Record<string, any>} policy
@@ -194,3 +177,4 @@ export declare function createLocalStaticHandler(distDir: any, policy: any): (re
  * @param {string} pathname
  */
 export declare function matchGlob(pattern: any, pathname: any): any;
+export {};