@mondaydotcomorg/z2h-cli 0.1.0

package/dist/esm/shadow/scaffold.mjs

@@ -0,0 +1,112 @@
+import path from 'node:path';
+import { ensureDir, writeFile, writeJson } from 'fs-extra';
+
+const WRAPPER_TEMPLATE = `import '@vibe/core/tokens';
+import ConsumerApp from '../../src/index';
+import React from 'react';
+import * as ReactDOM from 'react-dom/client';
+import { ErrorBoundary } from 'react-error-boundary';
+
+const roots = new Map<HTMLElement, ReactDOM.Root>();
+
+export function init() {}
+
+export function render(element: HTMLElement) {
+  const root = ReactDOM.createRoot(element);
+  root.render(
+    <ErrorBoundary fallback={<div style={{ padding: 16 }}>This app crashed.</div>}>
+      <ConsumerApp />
+    </ErrorBoundary>,
+  );
+  roots.set(element, root);
+}
+
+export function unmount({ element }: { element: HTMLElement }) {
+  const root = roots.get(element);
+  if (root) {
+    root.unmount();
+    roots.delete(element);
+  }
+}
+`;
+const tridentrcTemplate = (appName, port) => `/** @type {import("@mondaydotcomorg/trident-user-config").MicroFrontendConfig} */
+const config = {
+  appName: '${appName}',
+  port: ${port},
+};
+
+module.exports = config;
+`;
+const dtsFileTemplate = () => `
+declare module '*.module.css' {
+  const classNames: {
+    [className: string]: string;
+  };
+  export = classNames;
+}
+
+declare module '*.module.scss' {
+  const classNames: {
+    [className: string]: string;
+  };
+  export = classNames;
+}
+
+declare module '*.jpg' {
+  const e: string;
+  export default e;
+}
+declare module '*.jpeg' {
+  const e: string;
+  export default e;
+}
+declare module '*.png' {
+  const e: string;
+  export default e;
+}
+declare module '*.riv' {
+  const e: string;
+  export default e;
+}
+
+declare module '*.wasm' {
+  const e: string;
+  export default e;
+}
+`;
+const TSCONFIG_TEMPLATE = {
+    compilerOptions: {
+        target: 'es5',
+        lib: ['dom', 'dom.iterable', 'esnext'],
+        allowJs: false,
+        skipLibCheck: true,
+        esModuleInterop: true,
+        allowSyntheticDefaultImports: true,
+        strict: false,
+        module: 'esnext',
+        moduleResolution: 'bundler',
+        resolveJsonModule: true,
+        noImplicitAny: false,
+        isolatedModules: true,
+        baseUrl: 'src',
+        noEmit: true,
+        jsx: 'react-jsx',
+    },
+    include: ['src', '../src'],
+};
+/**
+ * Write every generated file under .zth/. Overwrites on every run so the
+ * shadow dir is a deterministic function of the CLI version — no drift.
+ */
+async function scaffoldShadow(paths, appName, port) {
+    await ensureDir(paths.shadowSrc);
+    await writeFile(paths.shadowWrapper, WRAPPER_TEMPLATE);
+    await writeFile(paths.shadowTridentrc, tridentrcTemplate(appName, port));
+    await writeFile(paths.shadowNvmrc, `${process.version}\n`);
+    await writeFile(paths.shadowDts, dtsFileTemplate());
+    await writeJson(paths.shadowTsconfig, TSCONFIG_TEMPLATE, { spaces: 2 });
+    // Drop a stub README so contributors who open .zth/ know what they're looking at.
+    await writeFile(path.join(paths.shadowDir, 'README.md'), '# .zth/\nGenerated by z2h-cli. Do not edit — run `z2h-cli build` or `z2h-cli dev` to refresh.\n');
+}
+
+export { scaffoldShadow };

package/dist/esm/shadow/sync.d.ts

@@ -0,0 +1,9 @@
+import type { ConsumerPaths, ConsumerPkg } from '../types';
+/**
+ * Regenerate the shadow package.json from the current CLI template and
+ * run `yarn install` at the consumer dir iff the consumer's declared deps
+ * have changed since the last install. Idempotent — safe to call on every
+ * build, dev start, or consumer package.json edit.
+ */
+export declare function syncShadow(paths: ConsumerPaths, consumerPkg: ConsumerPkg): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/esm/shadow/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/shadow/sync.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE3D;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB9F"}

package/dist/esm/shadow/sync.mjs

@@ -0,0 +1,29 @@
+import { pathExists, readFile, writeFile } from 'fs-extra';
+import { execa } from 'execa';
+import { info } from '../util/logger.mjs';
+import { buildShadowPkg, writeShadowPkg, hashConsumerDeps } from './merge-package-json.mjs';
+
+/**
+ * Regenerate the shadow package.json from the current CLI template and
+ * run `yarn install` at the consumer dir iff the consumer's declared deps
+ * have changed since the last install. Idempotent — safe to call on every
+ * build, dev start, or consumer package.json edit.
+ */
+async function syncShadow(paths, consumerPkg) {
+    const shadow = buildShadowPkg(consumerPkg);
+    await writeShadowPkg(paths.shadowPkg, shadow);
+    const newHash = hashConsumerDeps(consumerPkg);
+    const oldHash = (await pathExists(paths.shadowDepsHash)) ? await readFile(paths.shadowDepsHash, 'utf8') : null;
+    if (oldHash !== newHash) {
+        info(oldHash ? 'consumer deps changed — yarn install' : 'first run — yarn install');
+        // Yarn 4 is cache-first and non-interactive by default
+        // in non-TTY contexts, so no flags are needed
+        await execa('yarn', ['install'], {
+            cwd: paths.consumerDir,
+            stdio: 'inherit',
+        });
+        await writeFile(paths.shadowDepsHash, newHash);
+    }
+}
+
+export { syncShadow };

package/dist/esm/shadow/yarnrc.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Ensure the consumer has a `.yarnrc.yml` that pins `nodeLinker: node-modules`.
+ *
+ * Yarn 4 defaults to PnP, which trident-toolkit's webpack pipeline doesn't
+ * support cleanly (webpack expects a flat node_modules). We force the
+ * classic linker so installs produce a real `node_modules/`. Idempotent —
+ * leaves any other settings the user added alone.
+ */
+export declare function ensureYarnRc(consumerDir: string): Promise<void>;
+//# sourceMappingURL=yarnrc.d.ts.map

package/dist/esm/shadow/yarnrc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yarnrc.d.ts","sourceRoot":"","sources":["../../../src/shadow/yarnrc.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAerE"}

package/dist/esm/shadow/yarnrc.mjs

@@ -0,0 +1,27 @@
+import path from 'node:path';
+import { pathExists, writeFile, readFile } from 'fs-extra';
+import { YARNRC_LINES } from '../constants.mjs';
+
+/**
+ * Ensure the consumer has a `.yarnrc.yml` that pins `nodeLinker: node-modules`.
+ *
+ * Yarn 4 defaults to PnP, which trident-toolkit's webpack pipeline doesn't
+ * support cleanly (webpack expects a flat node_modules). We force the
+ * classic linker so installs produce a real `node_modules/`. Idempotent —
+ * leaves any other settings the user added alone.
+ */
+async function ensureYarnRc(consumerDir) {
+    const yarnrcPath = path.join(consumerDir, '.yarnrc.yml');
+    if (!(await pathExists(yarnrcPath))) {
+        await writeFile(yarnrcPath, YARNRC_LINES.join('\n\n') + '\n');
+        return;
+    }
+    const body = await readFile(yarnrcPath, 'utf8');
+    if (/^\s*nodeLinker\s*:/m.test(body)) {
+        return;
+    }
+    const prefix = body.length && !body.endsWith('\n') ? '\n' : '';
+    await writeFile(yarnrcPath, body + prefix + 'nodeLinker: node-modules\n');
+}
+
+export { ensureYarnRc };

package/dist/esm/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Shared domain types for the Z2H CLI. Command-scoped option types live
+ * with their command; narrow single-use types stay local to their file.
+ */
+export interface ConsumerPkg {
+    name: string;
+    version?: string;
+    private?: boolean;
+    workspaces?: string[] | {
+        packages?: string[];
+    };
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    scripts?: Record<string, string>;
+    [k: string]: unknown;
+}
+export interface ShadowPkg {
+    name: string;
+    version: string;
+    private: true;
+    scripts: Record<string, string>;
+    peerDependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
+}
+export interface ShadowMetadata {
+    createdAt: string;
+    appName: string;
+    port: number;
+}
+export interface ConsumerPaths {
+    consumerDir: string;
+    consumerPkg: string;
+    consumerSrc: string;
+    consumerSrcEntry: string;
+    shadowDir: string;
+    shadowPkg: string;
+    shadowSrc: string;
+    shadowWrapper: string;
+    shadowTridentrc: string;
+    shadowNvmrc: string;
+    shadowDts: string;
+    shadowTsconfig: string;
+    shadowBuild: string;
+    shadowDepsHash: string;
+    shadowMetadata: string;
+}
+export interface PreparedShadow {
+    appName: string;
+    port: number;
+    paths: ConsumerPaths;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAGD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAGD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAGD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,CAAC;CACtB"}

package/dist/esm/types.mjs

@@ -0,0 +1 @@
+

package/dist/esm/util/app-name.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Strip any npm scope (`@scope/`) from a package name.
+ * e.g. `@trident/customer-viewer` → `customer-viewer`, `foo` → `foo`.
+ */
+export declare function cleanAppName(name: string): string;
+/**
+ * Canonical MF bundle name: the de-scoped app name with an `mf-` prefix.
+ * This matches the trident convention (shadow pkg is `@trident/mf-<app>`,
+ * emitted bundle is `MF-mf-<app>`).
+ */
+export declare function mfAppName(name: string): string;
+//# sourceMappingURL=app-name.d.ts.map

package/dist/esm/util/app-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-name.d.ts","sourceRoot":"","sources":["../../../src/util/app-name.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/esm/util/app-name.mjs

@@ -0,0 +1,17 @@
+/**
+ * Strip any npm scope (`@scope/`) from a package name.
+ * e.g. `@trident/customer-viewer` → `customer-viewer`, `foo` → `foo`.
+ */
+function cleanAppName(name) {
+    return name.replace(/^@[^/]+\//, '');
+}
+/**
+ * Canonical MF bundle name: the de-scoped app name with an `mf-` prefix.
+ * This matches the trident convention (shadow pkg is `@trident/mf-<app>`,
+ * emitted bundle is `MF-mf-<app>`).
+ */
+function mfAppName(name) {
+    return `mf-${cleanAppName(name)}`;
+}
+
+export { cleanAppName, mfAppName };

package/dist/esm/util/logger.d.ts

@@ -0,0 +1,22 @@
+export type OutputMode = 'human' | 'json';
+export declare function setOutputMode(next: OutputMode): void;
+export declare function getOutputMode(): OutputMode;
+/**
+ * Progress, info, and warnings go to stderr so stdout stays clean
+ * for machine-readable output. Always suppressed in JSON mode except
+ * when the consumer explicitly wants chatty progress (e.g. setup).
+ */
+export declare function info(msg: string): void;
+export declare function warn(msg: string): void;
+export declare function errorLog(msg: string): void;
+/**
+ * Data output. In human mode writes `human` to stdout; in JSON mode writes
+ * JSON-stringified `data` to stdout. Exactly one line of stdout per call.
+ */
+export declare function output(human: string, data: unknown): void;
+/**
+ * Emit a structured failure payload (JSON mode) or a red error line (human mode),
+ * then exit with the given code.
+ */
+export declare function fail(message: string, payload: Record<string, unknown>, exitCode?: number): never;
+//# sourceMappingURL=logger.d.ts.map

package/dist/esm/util/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/util/logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAI1C,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAEpD;AAED,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAItC;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAItC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI1C;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAMzD;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,SAAI,GAAG,KAAK,CAU3F"}

package/dist/esm/util/logger.mjs

@@ -0,0 +1,59 @@
+import pc from 'picocolors';
+
+let mode = 'human';
+function setOutputMode(next) {
+    mode = next;
+}
+function getOutputMode() {
+    return mode;
+}
+/**
+ * Progress, info, and warnings go to stderr so stdout stays clean
+ * for machine-readable output. Always suppressed in JSON mode except
+ * when the consumer explicitly wants chatty progress (e.g. setup).
+ */
+function info(msg) {
+    if (mode === 'human') {
+        process.stderr.write(pc.cyan(`[z2h-cli] ${msg}\n`));
+    }
+}
+function warn(msg) {
+    if (mode === 'human') {
+        process.stderr.write(pc.yellow(`[z2h-cli] ${msg}\n`));
+    }
+}
+function errorLog(msg) {
+    if (mode === 'human') {
+        process.stderr.write(pc.red(`[z2h-cli] ${msg}\n`));
+    }
+}
+/**
+ * Data output. In human mode writes `human` to stdout; in JSON mode writes
+ * JSON-stringified `data` to stdout. Exactly one line of stdout per call.
+ */
+function output(human, data) {
+    if (mode === 'json') {
+        process.stdout.write(`${JSON.stringify(data)}\n`);
+    }
+    else {
+        process.stdout.write(`${human}\n`);
+    }
+}
+/**
+ * Emit a structured failure payload (JSON mode) or a red error line (human mode),
+ * then exit with the given code.
+ */
+function fail(message, payload, exitCode = 1) {
+    if (mode === 'json') {
+        process.stdout.write(`${JSON.stringify({ ok: false, error: message, ...payload })}\n`);
+    }
+    else {
+        process.stderr.write(pc.red(`[z2h-cli] ${message}\n`));
+        if (typeof payload.suggestedCommand === 'string') {
+            process.stderr.write(pc.dim(`  → ${payload.suggestedCommand}\n`));
+        }
+    }
+    process.exit(exitCode);
+}
+
+export { errorLog, fail, getOutputMode, info, output, setOutputMode, warn };

package/dist/esm/util/manifest.d.ts

@@ -0,0 +1,31 @@
+export interface SharedDep {
+    name?: string;
+    globalName: string;
+    url?: string;
+    minVersion?: string;
+    dependencies: Record<string, number>;
+}
+/**
+ * Shape of the `asset-manifest.json` trident-toolkit emits alongside the
+ * bundle. We consume this file directly as the base for a Z2H registry
+ * entry — deploy.ts only overlays `version` and `url`.
+ */
+export interface AssetManifestFile {
+    sameAsHost: boolean;
+    skipTranslationFetch: boolean;
+    shared: SharedDep[];
+    entrypoints: string[];
+    nonExternalsEntrypoints?: string[];
+    scriptType?: 'module' | 'classic';
+    mfs?: string[];
+}
+export interface ManifestEntry extends AssetManifestFile {
+    version: number;
+    url: string;
+}
+export type Manifest = Record<string, ManifestEntry>;
+export declare function readManifest(): Promise<Manifest>;
+export declare function nextVersion(manifest: Manifest, app: string): number;
+export declare function upsertEntry(manifest: Manifest, app: string, entry: ManifestEntry): Manifest;
+export declare function writeManifest(manifest: Manifest): Promise<void>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/esm/util/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/util/manifest.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAErD,wBAAsB,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,CAQtD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,UAI1D;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,QAAQ,CAE3F;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrE"}

package/dist/esm/util/manifest.mjs

@@ -0,0 +1,31 @@
+import { PutObjectCommand } from '@aws-sdk/client-s3';
+import { MANIFEST_READ_URL, getS3Client, BUCKET_WRITE_NAME, MANIFEST_KEY } from './s3/client.mjs';
+
+async function readManifest() {
+    // Read via the public CDN endpoint, no AWS auth required.
+    const res = await fetch(MANIFEST_READ_URL);
+    if (!res.ok) {
+        throw new Error(`failed to read manifest from ${MANIFEST_READ_URL}: HTTP ${res.status}`);
+    }
+    return (await res.json());
+}
+function nextVersion(manifest, app) {
+    const current = manifest[app]?.version;
+    const n = current ? Number(current) : 0;
+    return (Number.isNaN(n) ? 0 : n) + 1;
+}
+function upsertEntry(manifest, app, entry) {
+    return { ...manifest, [app]: entry };
+}
+async function writeManifest(manifest) {
+    const s3 = getS3Client();
+    await s3.send(new PutObjectCommand({
+        Bucket: BUCKET_WRITE_NAME,
+        Key: MANIFEST_KEY,
+        Body: JSON.stringify(manifest, null, 2),
+        ContentType: 'application/json',
+        CacheControl: 'no-cache',
+    }));
+}
+
+export { nextVersion, readManifest, upsertEntry, writeManifest };

package/dist/esm/util/s3/client.d.ts

@@ -0,0 +1,11 @@
+import { S3Client } from '@aws-sdk/client-s3';
+export declare const BUCKET_WRITE_NAME = "prod-use1-bigbrain-zth-mf-assets";
+export declare const REGION = "us-east-1";
+export declare const BUCKET_WRITE_URL = "https://prod-use1-bigbrain-zth-mf-assets.s3.us-east-1.amazonaws.com";
+export declare const BUCKET_READ_DNS_NAME = "bigbrain-zth-mf-assets";
+export declare const BUCKET_READ_DNS_URL = "https://bigbrain-zth-mf-assets.bigbrain.me";
+export declare const MANIFEST_KEY = "mf-assets";
+export declare const MANIFEST_READ_URL = "https://bigbrain-zth-mf-assets.bigbrain.me/mf-assets";
+export declare function getS3Client(): S3Client;
+export declare function assertBucketExists(): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/esm/util/s3/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/util/s3/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,QAAQ,EAAsB,MAAM,oBAAoB,CAAC;AAErF,eAAO,MAAM,iBAAiB,qCAAqC,CAAC;AACpE,eAAO,MAAM,MAAM,cAAc,CAAC;AAClC,eAAO,MAAM,gBAAgB,wEAA4D,CAAC;AAE1F,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAC7D,eAAO,MAAM,mBAAmB,+CAAgD,CAAC;AAKjF,eAAO,MAAM,YAAY,cAAc,CAAC;AACxC,eAAO,MAAM,iBAAiB,yDAA2C,CAAC;AAI1E,wBAAgB,WAAW,IAAI,QAAQ,CAKtC;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAexD"}

package/dist/esm/util/s3/client.mjs

@@ -0,0 +1,38 @@
+import { S3Client, HeadBucketCommand, S3ServiceException } from '@aws-sdk/client-s3';
+
+const BUCKET_WRITE_NAME = 'prod-use1-bigbrain-zth-mf-assets';
+const REGION = 'us-east-1';
+const BUCKET_WRITE_URL = `https://${BUCKET_WRITE_NAME}.s3.${REGION}.amazonaws.com`;
+const BUCKET_READ_DNS_NAME = 'bigbrain-zth-mf-assets';
+const BUCKET_READ_DNS_URL = `https://${BUCKET_READ_DNS_NAME}.bigbrain.me`;
+// No `.json` extension — TridentSkeleton's `mfUrl` API appends `/mf-assets`
+// to the bucket base when fetching, so the manifest must live at this exact
+// key. See microfrontends/mf-bigbrain-zth/.../ZeroToHeroHost.tsx.
+const MANIFEST_KEY = 'mf-assets';
+const MANIFEST_READ_URL = `${BUCKET_READ_DNS_URL}/${MANIFEST_KEY}`;
+let client = null;
+function getS3Client() {
+    if (!client) {
+        client = new S3Client({ region: REGION });
+    }
+    return client;
+}
+async function assertBucketExists() {
+    try {
+        await getS3Client().send(new HeadBucketCommand({ Bucket: BUCKET_WRITE_NAME }));
+    }
+    catch (err) {
+        if (err instanceof S3ServiceException) {
+            const status = err.$metadata.httpStatusCode;
+            if (status === 404 || err.name === 'NotFound' || err.name === 'NoSuchBucket') {
+                throw new Error(`S3 bucket "${BUCKET_WRITE_NAME}" does not exist (region: ${REGION}).`);
+            }
+            if (status === 403) {
+                throw new Error(`No access to S3 bucket "${BUCKET_WRITE_NAME}" (region: ${REGION}). Check AWS credentials.`);
+            }
+        }
+        throw err;
+    }
+}
+
+export { BUCKET_READ_DNS_NAME, BUCKET_READ_DNS_URL, BUCKET_WRITE_NAME, BUCKET_WRITE_URL, MANIFEST_KEY, MANIFEST_READ_URL, REGION, assertBucketExists, getS3Client };

package/dist/esm/util/s3/upload.d.ts

@@ -0,0 +1,2 @@
+export declare function uploadDir(localDir: string, keyPrefix: string): Promise<string[]>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/esm/util/s3/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../../src/util/s3/upload.ts"],"names":[],"mappings":"AAcA,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BtF"}

package/dist/esm/util/s3/upload.mjs

@@ -0,0 +1,32 @@
+import path from 'node:path';
+import { readFile } from 'fs-extra';
+import { readdir } from 'node:fs/promises';
+import { lookup } from 'mime-types';
+import pMap from 'p-map';
+import { PutObjectCommand } from '@aws-sdk/client-s3';
+import { getS3Client, BUCKET_WRITE_NAME } from './client.mjs';
+
+// Each deploy uploads to a version-prefixed path (<app>/<version>/...), so
+// the URL itself is the cache key. Assets never need to be revalidated.
+const FOREVER = 'public, immutable';
+const UPLOAD_CONCURRENCY = 5;
+async function uploadDir(localDir, keyPrefix) {
+    const entries = await readdir(localDir, { recursive: true, withFileTypes: true });
+    const files = entries.filter(e => e.isFile()).map(e => path.relative(localDir, path.join(e.parentPath, e.name)));
+    const s3 = getS3Client();
+    await pMap(files, async (rel) => {
+        const body = await readFile(path.join(localDir, rel));
+        const contentType = lookup(rel) || 'application/octet-stream';
+        const key = `${keyPrefix}/${rel.split(path.sep).join('/')}`;
+        await s3.send(new PutObjectCommand({
+            Bucket: BUCKET_WRITE_NAME,
+            Key: key,
+            Body: body,
+            ContentType: contentType,
+            CacheControl: FOREVER,
+        }));
+    }, { concurrency: UPLOAD_CONCURRENCY });
+    return files.map(f => f.split(path.sep).join('/'));
+}
+
+export { uploadDir };

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,86 @@
+const commander = require('commander');
+const commands_dev = require('./commands/dev.js');
+const commands_build = require('./commands/build.js');
+const commands_clean = require('./commands/clean.js');
+const commands_deploy = require('./commands/deploy.js');
+const util_logger = require('./util/logger.js');
+
+async function main() {
+    const program = new commander.Command();
+    program
+        .name('z2h-cli')
+        .description([
+        'Zero-to-Hero CLI — ship LLM-generated React apps as Trident MFs.',
+        '',
+        'Each consumer dir is self-contained: a shadow at <consumer>/.zth/',
+        'wraps the consumer source as a Trident MF. Run from inside any',
+        'consumer dir (the one with your src/index.tsx).',
+        '',
+        'Exit codes:',
+        '  0  success',
+        '  1  user-resolvable error (bad cwd, invalid package.json, lock held)',
+        '  2  system error (yarn install or trident build failed)',
+    ].join('\n'))
+        .version('0.0.0');
+    program
+        .command('build')
+        .description('Build the consumer into its .zth/ shadow and copy artifacts to ./build/')
+        .option('--json', 'emit structured JSON on stdout')
+        .action(async (opts) => {
+        try {
+            await commands_build.buildCommand(opts);
+        }
+        catch (err) {
+            // fail() emits a structured JSON error on stdout in --json mode and
+            // a red line on stderr in human mode, then exits. errorLog alone is
+            // silent in JSON mode, which leaves machine consumers with no signal.
+            util_logger.fail(`build failed: ${err.message}`, { command: 'build' }, 2);
+        }
+    });
+    program
+        .command('dev')
+        .description('Start the Trident dev server against .zth/ with native Vite HMR')
+        .option('--json', 'emit structured JSON on stdout')
+        .action(async (opts) => {
+        try {
+            await commands_dev.devCommand(opts);
+        }
+        catch (err) {
+            util_logger.fail(`dev failed: ${err.message}`, { command: 'dev' }, 2);
+        }
+    });
+    program
+        .command('clean')
+        .description('Delete <consumer>/.zth/ and <consumer>/build/')
+        .option('--json', 'emit structured JSON on stdout')
+        .action(async (opts) => {
+        try {
+            await commands_clean.cleanCommand(opts);
+        }
+        catch (err) {
+            util_logger.fail(`clean failed: ${err.message}`, { command: 'clean' }, 2);
+        }
+    });
+    program
+        .command('deploy')
+        .description('Build, upload artifacts to S3, and update the Z2H manifest')
+        .option('--dry-run', 'print what would happen without uploading anything')
+        .option('--json', 'emit structured JSON on stdout')
+        .action(async (opts) => {
+        try {
+            await commands_deploy.deployCommand(opts);
+        }
+        catch (err) {
+            util_logger.fail(`deploy failed: ${err.message}`, { command: 'deploy' }, 2);
+        }
+    });
+    await program.parseAsync(process.argv);
+}
+void main()
+    .then(() => {
+    process.exit(0);
+})
+    .catch((err) => {
+    util_logger.errorLog(`main failed: ${err.message}`);
+    process.exit(1);
+});