@forgecart/cli 2.202610130131.0 → 2.202610130431.0

package/dist/src/util/dotenv.util.d.ts

@@ -1,10 +1,24 @@
 /**
- * The `.env` rules a storefront's `.env` is written and read by (#1123, #2781):
- * init's merge — the keys a run manages refreshed in place, every other line
- * verbatim — and the split `forgecart sync` carries `.env` by: the platform's
- * own `FORGECART_*` keys, which init writes and which never cross between a
- * laptop and its workspace, against the merchant's keys, which do.
+ * The env files a Next.js storefront reads, in the order `forgecart sync` names
+ * them. Each keeps its own lines: in development a key resolves from
+ * `.env.development.local`, then `.env.local`, then `.env.development`, then
+ * `.env` — in production from the `.production` pair the same way — so the files
+ * travel apart and are never flattened into one.
  */
+export declare enum StorefrontEnvFile {
+    BASE = ".env",
+    LOCAL = ".env.local",
+    DEVELOPMENT = ".env.development",
+    DEVELOPMENT_LOCAL = ".env.development.local",
+    PRODUCTION = ".env.production",
+    PRODUCTION_LOCAL = ".env.production.local"
+}
+/** Every env file a storefront reads, in {@link StorefrontEnvFile}'s order. */
+export declare const STOREFRONT_ENV_FILES: readonly StorefrontEnvFile[];
+/** Whether `name` is one of the env files a storefront reads — and so a file sync may write. */
+export declare function isStorefrontEnvFile(name: string): name is StorefrontEnvFile;
+/** The env file's text — null when there is no such file; any other failure propagates. */
+export declare function readDotenvFile(path: string): Promise<string | null>;
 /** The key `line` assigns — undefined for a comment, a blank or any other line. */
 export declare function dotenvKey(line: string): string | undefined;
 /** Whether `key` is the platform's — init's to write, never a merchant's to carry. */

package/dist/src/util/dotenv.util.js

@@ -1,14 +1,51 @@
+import { readFile } from 'node:fs/promises';
 /**
- * The `.env` rules a storefront's `.env` is written and read by (#1123, #2781):
- * init's merge — the keys a run manages refreshed in place, every other line
- * verbatim — and the split `forgecart sync` carries `.env` by: the platform's
- * own `FORGECART_*` keys, which init writes and which never cross between a
- * laptop and its workspace, against the merchant's keys, which do.
+ * The env-file rules a storefront's env files are written and read by (#1123,
+ * #2781): init's merge — the keys a run manages refreshed in place, every other
+ * line verbatim — the split `forgecart sync` carries them by: the platform's own
+ * `FORGECART_*` keys, which init writes and which never cross between a laptop
+ * and its workspace, against the merchant's keys, which do — and the env files a
+ * storefront reads, which `forgecart sync` carries file for file.
  */
 /** An assignment line: its key, then `=`. A line of any other shape is carried verbatim and never travels. */
 const ASSIGNMENT = /^([A-Za-z_]\w*)=/;
 /** The prefix every platform-owned key carries. */
 const PLATFORM_KEY_PREFIX = 'FORGECART_';
+/**
+ * The env files a Next.js storefront reads, in the order `forgecart sync` names
+ * them. Each keeps its own lines: in development a key resolves from
+ * `.env.development.local`, then `.env.local`, then `.env.development`, then
+ * `.env` — in production from the `.production` pair the same way — so the files
+ * travel apart and are never flattened into one.
+ */
+export var StorefrontEnvFile;
+(function (StorefrontEnvFile) {
+    StorefrontEnvFile["BASE"] = ".env";
+    StorefrontEnvFile["LOCAL"] = ".env.local";
+    StorefrontEnvFile["DEVELOPMENT"] = ".env.development";
+    StorefrontEnvFile["DEVELOPMENT_LOCAL"] = ".env.development.local";
+    StorefrontEnvFile["PRODUCTION"] = ".env.production";
+    StorefrontEnvFile["PRODUCTION_LOCAL"] = ".env.production.local";
+})(StorefrontEnvFile || (StorefrontEnvFile = {}));
+/** Every env file a storefront reads, in {@link StorefrontEnvFile}'s order. */
+export const STOREFRONT_ENV_FILES = Object.values(StorefrontEnvFile);
+/** The env files' names, for checking a name read from elsewhere. */
+const STOREFRONT_ENV_FILE_NAMES = new Set(STOREFRONT_ENV_FILES);
+/** Whether `name` is one of the env files a storefront reads — and so a file sync may write. */
+export function isStorefrontEnvFile(name) {
+    return STOREFRONT_ENV_FILE_NAMES.has(name);
+}
+/** The env file's text — null when there is no such file; any other failure propagates. */
+export async function readDotenvFile(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+}
 /** The key `line` assigns — undefined for a comment, a blank or any other line. */
 export function dotenvKey(line) {
     return ASSIGNMENT.exec(line)?.[1];

package/dist/src/util/dotenv.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"dotenv.util.js","sourceRoot":"","sources":["../../../src/util/dotenv.util.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dotenv.util.js","sourceRoot":"","sources":["../../../src/util/dotenv.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;;;;;;GAOG;AAEH,8GAA8G;AAC9G,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAEtC,mDAAmD;AACnD,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,kCAAa,CAAA;IACb,yCAAoB,CAAA;IACpB,qDAAgC,CAAA;IAChC,iEAA4C,CAAA;IAC5C,mDAA8B,CAAA;IAC9B,+DAA0C,CAAA;AAC5C,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,oBAAoB,GAAiC,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEnG,qEAAqE;AACrE,MAAM,yBAAyB,GAAwB,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAErF,gGAAgG;AAChG,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACpE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;AAC7C,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,GAAW;IACnD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAwB;IAC1D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,GAAG,KAAK,SAAS,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC9E,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAoC;IAChF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7F,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAClB,IAAY,EACZ,OAAoC,EACpC,SAAsB;IAEtB,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,uFAAuF;AACvF,SAAS,kBAAkB,CAAC,KAAe;IACzC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC1D,KAAK,CAAC,GAAG,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgecart/cli",
-  "version": "2.202610130131.0",
+  "version": "2.202610130431.0",
   "type": "module",
   "description": "CLI for scaffolding and operating ForgeCart channel storefronts",
   "bin": {