@forgecart/cli 2.202610130131.0 → 2.202610130322.0

package/dist/src/deploy/deploy.runner.js

@@ -1,6 +1,6 @@
 import { resolve } from 'node:path';
 import { AdminApiClient } from '../admin-api/admin-api.client.js';
-import { CliCredentialCheck } from '../authorization/cli-credential-check.js';
+import { CliCredentialStep } from '../authorization/cli-credential-step.js';
 import { CliExitLadder, CliRefusal } from '../exit-ladder.js';
 import { print } from '../output.js';
 import { DeployFollowBound } from './deploy-follow-bound.js';
@@ -8,14 +8,19 @@ import { DeploymentFollow } from './deployment-follow.js';
 import { DeploymentClient } from './deployment.client.js';
 import { DeploymentEndStatus, } from './type/deploy.types.js';
 /**
- * `forgecart deploy [name]` (#411): publish what the board serves. Before
- * anything leaves the machine the run settles its four credentials — the
- * environment, then the storefront's `.env`, then its `.forgecart/config.json`,
- * exactly as `sync` reads them; a key in no source exits 3 with nothing sent.
- * Then it sends ONE `publishDeployment(type: storefront)` — the server builds
- * and ships; the CLI builds nothing — and follows the deployment to its end:
- * RUNNING prints its URL and exits 0, FAILED prints its error and exits 1.
- * Ctrl-C and `--timeout` end the following, never the publish.
+ * `forgecart deploy [name]` (#411): publish what the board serves. The run
+ * reads its four credentials through the credential step (launch#62 N3), from
+ * the environment, then the storefront's `.env`, then its
+ * `.forgecart/config.json`, exactly as `sync` reads them. When a key is in no
+ * source, the step authorizes this machine at `/authorize` and writes the four
+ * delivered keys into `.env` before any deploy request; when the admin API
+ * refuses the credentials, it authorizes the same way and deploys again on the
+ * delivered keys. Without a terminal the step prints the URL and the code,
+ * waits for the authorization's window, and exits 3. Then the run sends ONE
+ * `publishDeployment(type: storefront)` — the server builds and ships; the CLI
+ * builds nothing — and follows the deployment to its end: RUNNING prints its
+ * URL and exits 0, FAILED prints its error and exits 1. Ctrl-C and `--timeout`
+ * end the following, never the publish.
  */
 export class DeployRunner {
     name;
@@ -30,7 +35,11 @@ export class DeployRunner {
     }
     async run() {
         const storefront = this.name ? resolve(process.cwd(), this.name) : process.cwd();
-        const credentials = await CliCredentialCheck.settle(storefront);
+        const step = new CliCredentialStep({ targetDir: storefront });
+        await step.run(async (credentials) => this.deploy(credentials));
+    }
+    /** ONE publish on the settled credentials, followed to its end. */
+    async deploy(credentials) {
         const client = new DeploymentClient(new AdminApiClient(credentials, this.options.timeout));
         const bound = new DeployFollowBound(this.options.timeout);
         bound.listen();

package/dist/src/deploy/deploy.runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.runner.js","sourceRoot":"","sources":["../../../src/deploy/deploy.runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EACL,mBAAmB,GAGpB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;GASG;AACH,MAAM,OAAO,YAAY;IAMJ;IACA;IANnB;;;OAGG;IACH,YACmB,IAAwB,EACxB,OAAsB;QADtB,SAAI,GAAJ,IAAI,CAAoB;QACxB,YAAO,GAAP,OAAO,CAAe;IACtC,CAAC;IAEJ,KAAK,CAAC,GAAG;QACP,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACjF,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3F,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1D,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,IAAI,CAAC;YACH,KAAK,CAAC,oBAAoB,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;YAC9C,KAAK,CAAC,+EAA+E,CAAC,CAAC;YACvF,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACzC,KAAK,CAAC,UAAU,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QACxE,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,qGAAqG;IAC7F,MAAM,CAAC,KAA2B;QACxC,IAAI,KAAK,CAAC,MAAM,KAAK,mBAAmB,CAAC,MAAM,EAAE,CAAC;YAChD,MAAM,IAAI,UAAU,CAAC,aAAa,CAAC,KAAK,EAAE;gBACxC,0BAA0B,KAAK,CAAC,YAAY,IAAI,yCAAyC,EAAE;aAC5F,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,gBAAgB,KAAK,CAAC,GAAG,IAAI,wDAAwD,EAAE,CAAC,CAAC;IACjG,CAAC;CACF"}
+{"version":3,"file":"deploy.runner.js","sourceRoot":"","sources":["../../../src/deploy/deploy.runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAE5E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EACL,mBAAmB,GAGpB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,YAAY;IAMJ;IACA;IANnB;;;OAGG;IACH,YACmB,IAAwB,EACxB,OAAsB;QADtB,SAAI,GAAJ,IAAI,CAAoB;QACxB,YAAO,GAAP,OAAO,CAAe;IACtC,CAAC;IAEJ,KAAK,CAAC,GAAG;QACP,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACjF,MAAM,IAAI,GAAG,IAAI,iBAAiB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9D,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,mEAAmE;IAC3D,KAAK,CAAC,MAAM,CAAC,WAA2B;QAC9C,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3F,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1D,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,IAAI,CAAC;YACH,KAAK,CAAC,oBAAoB,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;YAC9C,KAAK,CAAC,+EAA+E,CAAC,CAAC;YACvF,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACzC,KAAK,CAAC,UAAU,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QACxE,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,qGAAqG;IAC7F,MAAM,CAAC,KAA2B;QACxC,IAAI,KAAK,CAAC,MAAM,KAAK,mBAAmB,CAAC,MAAM,EAAE,CAAC;YAChD,MAAM,IAAI,UAAU,CAAC,aAAa,CAAC,KAAK,EAAE;gBACxC,0BAA0B,KAAK,CAAC,YAAY,IAAI,yCAAyC,EAAE;aAC5F,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,gBAAgB,KAAK,CAAC,GAAG,IAAI,wDAAwD,EAAE,CAAC,CAAC;IACjG,CAAC;CACF"}

package/dist/src/sync/sync-dotenv.file.d.ts

@@ -1,36 +1,44 @@
-import { type CliCredentials } from '../authorization/type/cli-authorization.types.js';
-import type { SyncOutgoingEnv, SyncTakenEnv } from './type/sync.types.js';
+import { type StorefrontEnvFile } from '../util/dotenv.util.js';
+import type { SyncDotenvOutgoing, SyncDotenvTaken } from './type/sync.types.js';
 /**
- * The laptop's `.env`, as `forgecart sync` carries it (#2781). Only merchant
- * lines travel — the platform's `FORGECART_*` keys never cross — and they
- * travel under init's merge rule: a key is refreshed in place, every other line
- * is kept verbatim, nothing is deleted.
+ * One of the laptop's env files, as `forgecart sync` carries it (#2781). Only
+ * merchant lines travel — the platform's `FORGECART_*` keys never cross — and
+ * they travel under init's merge rule: a key is refreshed in place, every other
+ * line is kept verbatim, nothing is deleted.
  *
  * A push carries the merchant lines changed since they last travelled, so a
  * key the workspace changed meanwhile is not overwritten by a stale copy; a
- * pull takes the workspace's lines for every key the laptop has not changed
- * since, beside the run's four credentials — the `.env` a fresh pull writes.
- * What travelled is recorded as a digest per key, never the value.
+ * pull takes the workspace's lines of the same file for every key the laptop
+ * has not changed since. What travelled is recorded as a digest per key, never
+ * the value. A `recorded` of null is a first sync — no key counts as changed —
+ * and an empty one a file that never travelled.
  */
 export declare class SyncDotenvFile {
+    readonly file: StorefrontEnvFile;
     private readonly path;
-    constructor(storefront: string);
-    /** The merchant lines a push carries — every one changed since `recorded` — and the digests to record once they land. */
-    outgoing(recorded: Readonly<Record<string, string>> | null): Promise<SyncOutgoingEnv>;
-    /** How many of the workspace's merchant lines a pull would take — every key the laptop has not changed since `recorded`. */
-    takeable(workspaceLines: readonly string[], recorded: Readonly<Record<string, string>> | null): Promise<number>;
+    /**
+     * @param storefront the storefront directory.
+     * @param file the env file this is.
+     */
+    constructor(storefront: string, file: StorefrontEnvFile);
+    /**
+     * The merchant lines a push carries from this file — every one changed since
+     * `recorded` — and the digests to record once they land; null when the
+     * storefront holds no such file.
+     */
+    outgoing(recorded: Readonly<Record<string, string>> | null): Promise<SyncDotenvOutgoing | null>;
+    /** The workspace's merchant lines a pull would take into this file — every key the laptop has not changed since `recorded`. */
+    incoming(workspaceLines: readonly string[], recorded: Readonly<Record<string, string>> | null): Promise<string[]>;
     /**
      * Take the workspace's merchant lines — for every key the laptop has not
-     * changed since `recorded` — and the run's four credentials into `.env`,
-     * under init's merge rule. A key the laptop changed keeps the laptop's value
-     * and the digest it last travelled with, so the next push still carries it.
+     * changed since `recorded` — and the `platform` keys into this file, under
+     * init's merge rule; a file the laptop lacks is created. A key the laptop
+     * changed keeps the laptop's value and the digest it last travelled with, so
+     * the next push still carries it, and a key that did not travel keeps the
+     * digest it had — none for a key that never travelled.
      */
-    take(workspaceLines: readonly string[], credentials: CliCredentials, recorded: Readonly<Record<string, string>> | null): Promise<SyncTakenEnv>;
+    take(workspaceLines: readonly string[], platform: ReadonlyMap<string, string>, recorded: Readonly<Record<string, string>> | null): Promise<SyncDotenvTaken>;
     /** The keys whose line differs from the one that last travelled — none before a first sync. */
     private changedSince;
-    /** The four credentials as `.env` assignments, in the order init writes them. */
-    private credentialEntries;
     private digestsOf;
-    /** The `.env` text — empty when the storefront has none; any other failure propagates. */
-    private read;
 }

package/dist/src/sync/sync-dotenv.file.js

@@ -1,65 +1,80 @@
 import { createHash } from 'node:crypto';
-import { readFile, writeFile } from 'node:fs/promises';
+import { writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { CliCredentialKey, } from '../authorization/type/cli-authorization.types.js';
-import { dotenvValue, mergeDotenv, merchantAssignments } from '../util/dotenv.util.js';
+import { dotenvValue, mergeDotenv, merchantAssignments, readDotenvFile, } from '../util/dotenv.util.js';
 /**
- * The laptop's `.env`, as `forgecart sync` carries it (#2781). Only merchant
- * lines travel — the platform's `FORGECART_*` keys never cross — and they
- * travel under init's merge rule: a key is refreshed in place, every other line
- * is kept verbatim, nothing is deleted.
+ * One of the laptop's env files, as `forgecart sync` carries it (#2781). Only
+ * merchant lines travel — the platform's `FORGECART_*` keys never cross — and
+ * they travel under init's merge rule: a key is refreshed in place, every other
+ * line is kept verbatim, nothing is deleted.
  *
  * A push carries the merchant lines changed since they last travelled, so a
  * key the workspace changed meanwhile is not overwritten by a stale copy; a
- * pull takes the workspace's lines for every key the laptop has not changed
- * since, beside the run's four credentials — the `.env` a fresh pull writes.
- * What travelled is recorded as a digest per key, never the value.
+ * pull takes the workspace's lines of the same file for every key the laptop
+ * has not changed since. What travelled is recorded as a digest per key, never
+ * the value. A `recorded` of null is a first sync — no key counts as changed —
+ * and an empty one a file that never travelled.
  */
 export class SyncDotenvFile {
+    file;
     path;
-    constructor(storefront) {
-        this.path = join(storefront, '.env');
+    /**
+     * @param storefront the storefront directory.
+     * @param file the env file this is.
+     */
+    constructor(storefront, file) {
+        this.file = file;
+        this.path = join(storefront, file);
     }
-    /** The merchant lines a push carries — every one changed since `recorded` — and the digests to record once they land. */
+    /**
+     * The merchant lines a push carries from this file — every one changed since
+     * `recorded` — and the digests to record once they land; null when the
+     * storefront holds no such file.
+     */
     async outgoing(recorded) {
-        const assignments = merchantAssignments((await this.read()).split('\n'));
+        const content = await readDotenvFile(this.path);
+        if (content === null)
+            return null;
+        const assignments = merchantAssignments(content.split('\n'));
         const digests = this.digestsOf(assignments);
         const lines = [...assignments]
             .filter(([key]) => recorded?.[key] !== digests[key])
             .map(([, line]) => line);
         return { lines, digests };
     }
-    /** How many of the workspace's merchant lines a pull would take — every key the laptop has not changed since `recorded`. */
-    async takeable(workspaceLines, recorded) {
-        const changed = this.changedSince(await this.read(), recorded);
-        const keys = [...merchantAssignments(workspaceLines).keys()];
-        return keys.filter((key) => !changed.has(key)).length;
+    /** The workspace's merchant lines a pull would take into this file — every key the laptop has not changed since `recorded`. */
+    async incoming(workspaceLines, recorded) {
+        const changed = this.changedSince((await readDotenvFile(this.path)) ?? '', recorded);
+        return [...merchantAssignments(workspaceLines)]
+            .filter(([key]) => !changed.has(key))
+            .map(([, line]) => line);
     }
     /**
      * Take the workspace's merchant lines — for every key the laptop has not
-     * changed since `recorded` — and the run's four credentials into `.env`,
-     * under init's merge rule. A key the laptop changed keeps the laptop's value
-     * and the digest it last travelled with, so the next push still carries it.
+     * changed since `recorded` — and the `platform` keys into this file, under
+     * init's merge rule; a file the laptop lacks is created. A key the laptop
+     * changed keeps the laptop's value and the digest it last travelled with, so
+     * the next push still carries it, and a key that did not travel keeps the
+     * digest it had — none for a key that never travelled.
      */
-    async take(workspaceLines, credentials, recorded) {
-        const existing = await this.read();
+    async take(workspaceLines, platform, recorded) {
+        const existing = (await readDotenvFile(this.path)) ?? '';
         const changed = this.changedSince(existing, recorded);
-        const taken = [...merchantAssignments(workspaceLines)].filter(([key]) => !changed.has(key));
-        const managed = new Map([
-            ...this.credentialEntries(credentials),
-            ...taken.map(([key, line]) => [key, dotenvValue(line, key)]),
-        ]);
-        const next = mergeDotenv(existing, managed);
+        const taken = new Map([...merchantAssignments(workspaceLines)]
+            .filter(([key]) => !changed.has(key))
+            .map(([key, line]) => [key, dotenvValue(line, key)]));
+        const managed = new Map([...platform, ...taken]);
+        const next = managed.size === 0 ? existing : mergeDotenv(existing, managed);
         if (next !== existing)
             await writeFile(this.path, next, 'utf8');
         const merged = this.digestsOf(merchantAssignments(next.split('\n')));
         const digests = {};
         for (const [key, digest] of Object.entries(merged)) {
-            const recordedDigest = changed.has(key) ? recorded?.[key] : digest;
-            if (recordedDigest !== undefined)
-                digests[key] = recordedDigest;
+            const travelled = taken.has(key) ? digest : recorded?.[key];
+            if (travelled !== undefined)
+                digests[key] = travelled;
         }
-        return { taken: taken.length, digests };
+        return { taken: taken.size, digests };
     }
     /** The keys whose line differs from the one that last travelled — none before a first sync. */
     changedSince(content, recorded) {
@@ -68,28 +83,8 @@ export class SyncDotenvFile {
         const digests = this.digestsOf(merchantAssignments(content.split('\n')));
         return new Set(Object.keys(digests).filter((key) => recorded[key] !== digests[key]));
     }
-    /** The four credentials as `.env` assignments, in the order init writes them. */
-    credentialEntries(credentials) {
-        return [
-            [CliCredentialKey.CHANNEL_TOKEN, credentials.channelToken],
-            [CliCredentialKey.SHOP_API_URL, credentials.shopApiUrl],
-            [CliCredentialKey.ADMIN_SECRET, credentials.adminSecret],
-            [CliCredentialKey.ADMIN_API_URL, credentials.adminApiUrl],
-        ];
-    }
     digestsOf(assignments) {
         return Object.fromEntries([...assignments].map(([key, line]) => [key, createHash('sha256').update(line).digest('hex')]));
     }
-    /** The `.env` text — empty when the storefront has none; any other failure propagates. */
-    async read() {
-        try {
-            return await readFile(this.path, 'utf8');
-        }
-        catch (error) {
-            if (error.code === 'ENOENT')
-                return '';
-            throw error;
-        }
-    }
 }
 //# sourceMappingURL=sync-dotenv.file.js.map

package/dist/src/sync/sync-dotenv.file.js.map

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

package/dist/src/sync/sync-env-channel.d.ts

@@ -0,0 +1,47 @@
+import { type CliCredentials } from '../authorization/type/cli-authorization.types.js';
+import type { SyncEnvDigests, SyncEnvFileLines, SyncOutgoingEnv, SyncTakenEnv } from './type/sync.types.js';
+/**
+ * The laptop's side of `forgecart sync`'s env channel (#2781): EVERY env file a
+ * storefront reads — `.env`, `.env.local`, `.env.development`,
+ * `.env.development.local`, `.env.production`, `.env.production.local` — carried
+ * file for file, each one's merchant lines into the other side's file of the
+ * same name, so every key resolves in the workspace as it does on the laptop.
+ * The files are never flattened into one, and the platform's `FORGECART_*`
+ * keys never cross in any of them. What travelled is recorded per file and per
+ * key. A pull also writes the run's four credentials into `.env` — the `.env` a
+ * fresh pull writes.
+ */
+export declare class SyncEnvChannel {
+    private readonly files;
+    /** @param storefront the storefront directory. */
+    constructor(storefront: string);
+    /**
+     * The merchant lines a push carries — one entry per env file the laptop
+     * holds, its lines changed since `recorded` — and the digests to record once
+     * they land.
+     */
+    outgoing(recorded: SyncEnvDigests | null): Promise<SyncOutgoingEnv>;
+    /**
+     * The workspace's merchant lines a pull would take — one entry per env file
+     * the workspace holds, its lines for every key the laptop has not changed
+     * since `recorded`.
+     */
+    incoming(workspaceFiles: readonly SyncEnvFileLines[], recorded: SyncEnvDigests | null): Promise<SyncEnvFileLines[]>;
+    /**
+     * Take each workspace env file's merchant lines into the laptop file of the
+     * same name — created when the laptop lacks it — and the four credentials
+     * into `.env`. A file the workspace does not hold is left as it is, with the
+     * digests it last travelled with.
+     */
+    take(workspaceFiles: readonly SyncEnvFileLines[], credentials: CliCredentials, recorded: SyncEnvDigests | null): Promise<SyncTakenEnv>;
+    /** Take into one file — null for a file with neither workspace lines nor credentials to take. */
+    private takeInto;
+    /**
+     * The platform keys a pull writes into `file`: the four credentials in
+     * `.env`, in the order init writes them; none elsewhere.
+     */
+    private platformEntries;
+    /** The digests `file` last travelled with: null before a first sync, none for a file that never travelled. */
+    private recordOf;
+    private linesByFile;
+}

package/dist/src/sync/sync-env-channel.js

@@ -0,0 +1,106 @@
+import { CliCredentialKey, } from '../authorization/type/cli-authorization.types.js';
+import { STOREFRONT_ENV_FILES, StorefrontEnvFile } from '../util/dotenv.util.js';
+import { SyncDotenvFile } from './sync-dotenv.file.js';
+/**
+ * The laptop's side of `forgecart sync`'s env channel (#2781): EVERY env file a
+ * storefront reads — `.env`, `.env.local`, `.env.development`,
+ * `.env.development.local`, `.env.production`, `.env.production.local` — carried
+ * file for file, each one's merchant lines into the other side's file of the
+ * same name, so every key resolves in the workspace as it does on the laptop.
+ * The files are never flattened into one, and the platform's `FORGECART_*`
+ * keys never cross in any of them. What travelled is recorded per file and per
+ * key. A pull also writes the run's four credentials into `.env` — the `.env` a
+ * fresh pull writes.
+ */
+export class SyncEnvChannel {
+    files;
+    /** @param storefront the storefront directory. */
+    constructor(storefront) {
+        this.files = STOREFRONT_ENV_FILES.map((file) => new SyncDotenvFile(storefront, file));
+    }
+    /**
+     * The merchant lines a push carries — one entry per env file the laptop
+     * holds, its lines changed since `recorded` — and the digests to record once
+     * they land.
+     */
+    async outgoing(recorded) {
+        const files = [];
+        const digests = {};
+        for (const envFile of this.files) {
+            const outgoing = await envFile.outgoing(this.recordOf(recorded, envFile.file));
+            if (outgoing === null)
+                continue;
+            files.push({ file: envFile.file, lines: outgoing.lines });
+            digests[envFile.file] = outgoing.digests;
+        }
+        return { files, digests };
+    }
+    /**
+     * The workspace's merchant lines a pull would take — one entry per env file
+     * the workspace holds, its lines for every key the laptop has not changed
+     * since `recorded`.
+     */
+    async incoming(workspaceFiles, recorded) {
+        const workspace = this.linesByFile(workspaceFiles);
+        const files = [];
+        for (const envFile of this.files) {
+            const workspaceLines = workspace.get(envFile.file);
+            if (workspaceLines === undefined)
+                continue;
+            const lines = await envFile.incoming(workspaceLines, this.recordOf(recorded, envFile.file));
+            files.push({ file: envFile.file, lines });
+        }
+        return files;
+    }
+    /**
+     * Take each workspace env file's merchant lines into the laptop file of the
+     * same name — created when the laptop lacks it — and the four credentials
+     * into `.env`. A file the workspace does not hold is left as it is, with the
+     * digests it last travelled with.
+     */
+    async take(workspaceFiles, credentials, recorded) {
+        const workspace = this.linesByFile(workspaceFiles);
+        const digests = {};
+        let taken = 0;
+        for (const envFile of this.files) {
+            const workspaceLines = workspace.get(envFile.file);
+            const result = await this.takeInto(envFile, workspaceLines, credentials, recorded);
+            const fileDigests = result?.digests ?? recorded?.[envFile.file];
+            if (fileDigests !== undefined)
+                digests[envFile.file] = fileDigests;
+            taken += result?.taken ?? 0;
+        }
+        return { taken, digests };
+    }
+    /** Take into one file — null for a file with neither workspace lines nor credentials to take. */
+    async takeInto(envFile, workspaceLines, credentials, recorded) {
+        const platform = this.platformEntries(envFile.file, credentials);
+        if (workspaceLines === undefined && platform.size === 0)
+            return null;
+        return envFile.take(workspaceLines ?? [], platform, this.recordOf(recorded, envFile.file));
+    }
+    /**
+     * The platform keys a pull writes into `file`: the four credentials in
+     * `.env`, in the order init writes them; none elsewhere.
+     */
+    platformEntries(file, credentials) {
+        if (file !== StorefrontEnvFile.BASE)
+            return new Map();
+        return new Map([
+            [CliCredentialKey.CHANNEL_TOKEN, credentials.channelToken],
+            [CliCredentialKey.SHOP_API_URL, credentials.shopApiUrl],
+            [CliCredentialKey.ADMIN_SECRET, credentials.adminSecret],
+            [CliCredentialKey.ADMIN_API_URL, credentials.adminApiUrl],
+        ]);
+    }
+    /** The digests `file` last travelled with: null before a first sync, none for a file that never travelled. */
+    recordOf(recorded, file) {
+        if (recorded === null)
+            return null;
+        return recorded[file] ?? {};
+    }
+    linesByFile(files) {
+        return new Map(files.map(({ file, lines }) => [file, lines]));
+    }
+}
+//# sourceMappingURL=sync-env-channel.js.map

package/dist/src/sync/sync-env-channel.js.map

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

package/dist/src/sync/sync-env.runner.d.ts

@@ -1,12 +1,16 @@
 import type { SyncEnvOptions } from './type/sync.types.js';
 /**
  * `forgecart sync-env [name]` (#2781) — the workspace's side of `forgecart
- * sync`, which the admin API runs in the pod: it reads the merchant lines of the
- * storefront's `.env`, or, with `--merge`, merges the lines
- * FORGECART_SYNC_ENV_LINES carries under init's merge rule, and prints ONE JSON
- * report — the merchant lines as they stand, and how many keys the merge
- * carried in. The platform's own `FORGECART_*` keys are never read out and
- * never written: a laptop's never land, the pod's never leave.
+ * sync`, which the admin API runs in the pod. It reads EVERY env file the
+ * storefront holds — `.env`, `.env.local`, `.env.development`,
+ * `.env.development.local`, `.env.production`, `.env.production.local` — or,
+ * with `--merge`, merges the lines FORGECART_SYNC_ENV_FILES carries for each
+ * file into the storefront file of that name under init's merge rule, creating
+ * one the storefront lacks. The files stay apart, so the dev-server resolves
+ * every key as the laptop does. It prints ONE JSON report: one entry per env
+ * file the storefront holds — its merchant lines as they stand, and how many
+ * keys the merge carried in. The platform's own `FORGECART_*` keys are never
+ * read out and never written: a laptop's never land, the pod's never leave.
  */
 export declare class SyncEnvRunner {
     private readonly name;
@@ -17,13 +21,25 @@ export declare class SyncEnvRunner {
      */
     constructor(name: string | undefined, options: SyncEnvOptions);
     run(): Promise<void>;
-    /** The merchant keys the variable carries, keyed to their values — platform keys and other lines dropped. */
+    /**
+     * One env file once the run is done: the merchant keys carried for it merged
+     * in — the file created when the storefront lacks it — and its merchant lines
+     * as they then stand; null for a file the storefront does not hold.
+     */
+    private settle;
+    /** A file nothing was merged into, as it stands — null when the storefront does not hold it. */
+    private held;
+    /**
+     * The merchant keys a merge carries for each env file, keyed to their values
+     * — platform keys and other lines dropped; none for a read.
+     */
     private incoming;
-    private parseLines;
+    private managedOf;
+    private parseEntries;
+    /** One entry: an env file the storefront reads — never a path outside them — and its lines. */
+    private parseEntry;
     private malformedMessage;
     private merchantLines;
     /** The report the admin API parses: ONE line of JSON on stdout. */
     private report;
-    /** The `.env` text — empty when the storefront has none; any other failure propagates. */
-    private read;
 }