@commercetools/cli-topic-integration-layer 0.5.1 → 0.7.0

package/dist/lib/ilClient.js

@@ -1,21 +1,19 @@
 // Low-level HTTP client for the Commerce Integration Layer's per-project manage-surface
-// routes. Every call is parameterised by (baseUrl, projectKey, token) — the command
-// layer resolves those (`IntegrationLayerCommand.resolveIlContext`, whose token is the
-// `commercetools auth login` principal's) and this module just speaks the wire
-// protocol. The route bodies these mirror live in the integration
+// routes. Every call is parameterised by (baseUrl, projectKey, authFetch) — the command
+// layer resolves those (`IntegrationLayerCommand.resolveIlContext`), and this module just
+// speaks the wire protocol. `authFetch` is the `CtpAuthFetchFactory` fetch: it injects the
+// `manage_project` bearer and transparently refreshes/retries it, so nothing here sets an
+// Authorization header itself. The route bodies these mirror live in the integration
 // layer's `routes/manage.ts`; the request/response shapes here are extracted from the
 // `ee-ext` tooling's `remoteValidate.ts` / `push.ts` (which read them from env) and
 // the remaining manage routes (config, status, delete, subgraph).
 function apiRoot(baseUrl, projectKey) {
     return `${baseUrl.replace(/\/+$/, "")}/${encodeURIComponent(projectKey)}`;
 }
-function bearer(token) {
-    return { Authorization: `Bearer ${token}` };
-}
 /** GET the project's raw core-subgraph SDL — the compose input (`GET …/subgraph`). */
-export async function fetchSubgraphSdl(baseUrl, projectKey, token) {
+export async function fetchSubgraphSdl(baseUrl, projectKey, authFetch) {
     const url = `${apiRoot(baseUrl, projectKey)}/subgraph`;
-    const res = await fetch(url, { headers: { accept: "text/plain", ...bearer(token) } });
+    const res = await authFetch(url, { headers: { accept: "text/plain" } });
     const text = await res.text();
     if (!res.ok) {
         throw new Error(`could not fetch core-subgraph SDL (${res.status}) from ${url}: ${text}`);
@@ -37,9 +35,9 @@ export async function fetchSubgraphSdl(baseUrl, projectKey, token) {
  * same `manage_project` boundary as `/subgraph`. 404 means the project has never
  * published a composable version.
  */
-export async function fetchDeployedApiSchemaSdl(baseUrl, projectKey, token) {
+export async function fetchDeployedApiSchemaSdl(baseUrl, projectKey, authFetch) {
     const url = `${apiRoot(baseUrl, projectKey)}/schema/api`;
-    const res = await fetch(url, { headers: { accept: "text/plain", ...bearer(token) } });
+    const res = await authFetch(url, { headers: { accept: "text/plain" } });
     const text = await res.text();
     if (res.status === 404) {
         throw new Error(`project '${projectKey}' has no composed schema published yet — publish one from the ` +
@@ -51,11 +49,11 @@ export async function fetchDeployedApiSchemaSdl(baseUrl, projectKey, token) {
     return text;
 }
 /** POST a candidate SDL to the composition + breaking-change gate (`POST …/extension/validate`). */
-export async function remoteValidate(baseUrl, projectKey, token, typeDefs) {
+export async function remoteValidate(baseUrl, projectKey, authFetch, typeDefs) {
     const url = `${apiRoot(baseUrl, projectKey)}/extension/validate`;
-    const res = await fetch(url, {
+    const res = await authFetch(url, {
         method: "POST",
-        headers: { "Content-Type": "application/json", ...bearer(token) },
+        headers: { "Content-Type": "application/json" },
         body: JSON.stringify({ typeDefs }),
     });
     const text = await res.text();
@@ -71,9 +69,9 @@ export async function remoteValidate(baseUrl, projectKey, token, typeDefs) {
  * came from; the Commerce Integration Layer stores it against the revision, shows it in the
  * Merchant Center, and hands it to the connector.
  */
-export async function pushBundle(baseUrl, projectKey, token, bundle, filename, sourceRevision) {
+export async function pushBundle(baseUrl, projectKey, authFetch, bundle, filename, sourceRevision) {
     const url = `${apiRoot(baseUrl, projectKey)}/extension/bundle`;
-    const res = await fetch(url, {
+    const res = await authFetch(url, {
         method: "PUT",
         headers: {
             "Content-Type": "text/javascript",
@@ -86,7 +84,6 @@ export async function pushBundle(baseUrl, projectKey, token, bundle, filename, s
             ...(sourceRevision
                 ? { "x-extension-source-revision": encodeURIComponent(sourceRevision) }
                 : {}),
-            ...bearer(token),
         },
         body: bundle,
     });
@@ -97,9 +94,9 @@ export async function pushBundle(baseUrl, projectKey, token, bundle, filename, s
     return JSON.parse(text);
 }
 /** The stored bundle's metadata, or null if none is stored (`GET …/extension/bundle/meta`). */
-export async function fetchExtensionMeta(baseUrl, projectKey, token) {
+export async function fetchExtensionMeta(baseUrl, projectKey, authFetch) {
     const url = `${apiRoot(baseUrl, projectKey)}/extension/bundle/meta`;
-    const res = await fetch(url, { headers: { accept: "application/json", ...bearer(token) } });
+    const res = await authFetch(url, { headers: { accept: "application/json" } });
     if (res.status === 404)
         return null;
     const text = await res.text();
@@ -109,18 +106,18 @@ export async function fetchExtensionMeta(baseUrl, projectKey, token) {
     return JSON.parse(text);
 }
 /** Remove the project's extension subgraph from Hive (`DELETE …/extension/subgraph`). */
-export async function deleteExtensionSubgraph(baseUrl, projectKey, token) {
+export async function deleteExtensionSubgraph(baseUrl, projectKey, authFetch) {
     const url = `${apiRoot(baseUrl, projectKey)}/extension/subgraph`;
-    const res = await fetch(url, { method: "DELETE", headers: { ...bearer(token) } });
+    const res = await authFetch(url, { method: "DELETE" });
     if (!res.ok && res.status !== 204) {
         const text = await res.text();
         throw new Error(`DELETE extension/subgraph failed (${res.status}): ${text}`);
     }
 }
 /** GET the project's extension HTTP allowlist (`GET …/extension/allowlist`). */
-export async function getAllowlist(baseUrl, projectKey, token) {
+export async function getAllowlist(baseUrl, projectKey, authFetch) {
     const url = `${apiRoot(baseUrl, projectKey)}/extension/allowlist`;
-    const res = await fetch(url, { headers: { accept: "application/json", ...bearer(token) } });
+    const res = await authFetch(url, { headers: { accept: "application/json" } });
     const text = await res.text();
     if (!res.ok) {
         throw new Error(`GET extension/allowlist failed (${res.status}): ${text}`);
@@ -135,11 +132,11 @@ export async function getAllowlist(baseUrl, projectKey, token) {
  * returns the stored list plus the config's new monotonic version. The `deny` ceiling
  * is untouched (it has no write route).
  */
-export async function putAllowlist(baseUrl, projectKey, token, patterns) {
+export async function putAllowlist(baseUrl, projectKey, authFetch, patterns) {
     const url = `${apiRoot(baseUrl, projectKey)}/extension/allowlist`;
-    const res = await fetch(url, {
+    const res = await authFetch(url, {
         method: "PUT",
-        headers: { "Content-Type": "application/json", ...bearer(token) },
+        headers: { "Content-Type": "application/json" },
         body: JSON.stringify(patterns),
     });
     const text = await res.text();
@@ -149,9 +146,9 @@ export async function putAllowlist(baseUrl, projectKey, token, patterns) {
     return JSON.parse(text);
 }
 /** List the project's extension config entries, secret values redacted (`GET …/extension/config`). */
-export async function listConfig(baseUrl, projectKey, token) {
+export async function listConfig(baseUrl, projectKey, authFetch) {
     const url = `${apiRoot(baseUrl, projectKey)}/extension/config`;
-    const res = await fetch(url, { headers: { accept: "application/json", ...bearer(token) } });
+    const res = await authFetch(url, { headers: { accept: "application/json" } });
     const text = await res.text();
     if (!res.ok) {
         throw new Error(`GET extension/config failed (${res.status}): ${text}`);
@@ -163,11 +160,11 @@ export async function listConfig(baseUrl, projectKey, token) {
  * (`PATCH …/extension/config`). An entry with `value: null` deletes that key. PATCH
  * (not PUT) so a single set/unset touches one key without clobbering the rest.
  */
-export async function patchConfig(baseUrl, projectKey, token, entries) {
+export async function patchConfig(baseUrl, projectKey, authFetch, entries) {
     const url = `${apiRoot(baseUrl, projectKey)}/extension/config`;
-    const res = await fetch(url, {
+    const res = await authFetch(url, {
         method: "PATCH",
-        headers: { "Content-Type": "application/json", ...bearer(token) },
+        headers: { "Content-Type": "application/json" },
         body: JSON.stringify(entries),
     });
     const text = await res.text();

package/dist/lib/ilClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"ilClient.js","sourceRoot":"","sources":["../../src/lib/ilClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ilClient.js","sourceRoot":"","sources":["../../src/lib/ilClient.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,wFAAwF;AACxF,0FAA0F;AAC1F,2FAA2F;AAC3F,0FAA0F;AAC1F,qFAAqF;AACrF,sFAAsF;AACtF,oFAAoF;AACpF,kEAAkE;AAwElE,SAAS,OAAO,CAAC,OAAe,EAAE,UAAkB;IAClD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;AAC5E,CAAC;AASD,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,UAAkB,EAClB,SAAoB;IAEpB,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC;IACvD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,CAAC,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAe,EACf,UAAkB,EAClB,SAAoB;IAEpB,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC;IACzD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,YAAY,UAAU,gEAAgE;YACpF,0FAA0F,CAC7F,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,iDAAiD,GAAG,CAAC,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC;IACvG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,UAAkB,EAClB,SAAoB,EACpB,QAAgB;IAEhB,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,qBAAqB,CAAC;IACjE,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;QAC/B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;KACnC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAA2B,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,UAAkB,EAClB,SAAoB,EACpB,MAAc,EACd,QAAgB,EAChB,cAAuB;IAEvB,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,mBAAmB,CAAC;IAC/D,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;QAC/B,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,cAAc,EAAE,iBAAiB;YACjC,4EAA4E;YAC5E,mEAAmE;YACnE,sBAAsB,EAAE,kBAAkB,CAAC,QAAQ,CAAC;YACpD,+EAA+E;YAC/E,+EAA+E;YAC/E,0DAA0D;YAC1D,GAAG,CAAC,cAAc;gBAChB,CAAC,CAAC,EAAE,6BAA6B,EAAE,kBAAkB,CAAC,cAAc,CAAC,EAAE;gBACvE,CAAC,CAAC,EAAE,CAAC;SACR;QACD,IAAI,EAAE,MAAM;KACb,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;AAC3C,CAAC;AAED,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAe,EACf,UAAkB,EAClB,SAAoB;IAEpB,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,wBAAwB,CAAC;IACpE,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC9E,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;AAC3C,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAe,EACf,UAAkB,EAClB,SAAoB;IAEpB,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,qBAAqB,CAAC;IACjE,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvD,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAgBD,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,UAAkB,EAClB,SAAoB;IAEpB,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,sBAAsB,CAAC;IAClE,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,UAAkB,EAClB,SAAoB,EACpB,QAAkB;IAElB,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,sBAAsB,CAAC;IAClE,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;QAC/B,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;KAC/B,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAyC,CAAC;AAClE,CAAC;AAED,sGAAsG;AACtG,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,UAAkB,EAClB,SAAoB;IAEpB,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,mBAAmB,CAAC;IAC/D,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,UAAkB,EAClB,SAAoB,EACpB,OAAuE;IAEvE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,mBAAmB,CAAC;IAC/D,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;QAC/B,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;AAC3C,CAAC"}

package/dist/lib/loadLocalEnv.d.ts

@@ -0,0 +1,49 @@
+/** Where a command's dotenv file is, and whether a missing file is an error. */
+export interface EnvFileLocation {
+    /** Absolute path to the dotenv file. */
+    path: string;
+    /** True when an explicit `--env-file` was given, so a missing file must fail loudly. */
+    required: boolean;
+}
+/**
+ * Peek argv for `--env-file <path>` / `--env-file=<path>` before oclif parses flags.
+ * Must run in `init()` so values (e.g. `INTEGRATION_LAYER_URL`, `EXTENSION_CONFIG_*`)
+ * are in `process.env` when flag `env:` bindings resolve.
+ */
+export declare function envFilePathFromArgv(argv?: readonly string[]): string | undefined;
+/**
+ * Resolve which dotenv file a command should read: an explicit `--env-file <path>`
+ * (required — a missing one is an error) or, failing that, `.env` in the cwd (optional).
+ */
+export declare function resolveEnvFileLocation(options?: {
+    argv?: readonly string[];
+    cwd?: string;
+}): EnvFileLocation;
+/**
+ * Load a dotenv file into `process.env` without overriding existing keys
+ * (Node's `process.loadEnvFile` semantics).
+ *
+ * - `--env-file <path>` (from argv): required; a missing file fails loudly.
+ * - otherwise `.env` in cwd: optional; a missing file is a no-op.
+ *
+ * Returns the absolute path that was loaded, or `undefined` when nothing was loaded.
+ */
+export declare function loadLocalEnv(options?: {
+    argv?: readonly string[];
+    cwd?: string;
+}): string | undefined;
+/**
+ * Parse a dotenv file into a plain object WITHOUT touching `process.env`. Returns an
+ * empty object when the file is absent — the caller decides whether that's an error.
+ * Used by the `serve` hot-reload path, which needs the file's current values on each
+ * change (unlike {@link loadLocalEnv}, whose "existing env wins" load can't re-apply an
+ * edited value already present in `process.env`).
+ */
+export declare function parseEnvFile(filePath: string): Record<string, string>;
+/**
+ * Watch a dotenv file for changes and invoke `onChange` (debounced) after each write.
+ * Watches the containing DIRECTORY, not the file, so it survives editors that save via
+ * atomic rename (which swaps the inode and would silently kill a file-level watch) and
+ * catches the file being created after the server starts. Returns a stop function.
+ */
+export declare function watchEnvFile(filePath: string, onChange: () => void): () => void;

package/dist/lib/loadLocalEnv.js

@@ -0,0 +1,112 @@
+import { watch } from "node:fs";
+import path from "node:path";
+import { parseEnv } from "node:util";
+import { readFileSync } from "node:fs";
+const ENV_FILE_FLAG = "--env-file";
+/**
+ * Peek argv for `--env-file <path>` / `--env-file=<path>` before oclif parses flags.
+ * Must run in `init()` so values (e.g. `INTEGRATION_LAYER_URL`, `EXTENSION_CONFIG_*`)
+ * are in `process.env` when flag `env:` bindings resolve.
+ */
+export function envFilePathFromArgv(argv = process.argv) {
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === ENV_FILE_FLAG) {
+            const next = argv[i + 1];
+            if (!next || next.startsWith("-")) {
+                throw new Error(`${ENV_FILE_FLAG} requires a path`);
+            }
+            return next;
+        }
+        if (arg.startsWith(`${ENV_FILE_FLAG}=`)) {
+            const value = arg.slice(ENV_FILE_FLAG.length + 1);
+            if (!value)
+                throw new Error(`${ENV_FILE_FLAG} requires a path`);
+            return value;
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve which dotenv file a command should read: an explicit `--env-file <path>`
+ * (required — a missing one is an error) or, failing that, `.env` in the cwd (optional).
+ */
+export function resolveEnvFileLocation(options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const fromArgv = envFilePathFromArgv(options?.argv ?? process.argv);
+    return {
+        path: path.resolve(cwd, fromArgv ?? ".env"),
+        required: fromArgv !== undefined,
+    };
+}
+/**
+ * Load a dotenv file into `process.env` without overriding existing keys
+ * (Node's `process.loadEnvFile` semantics).
+ *
+ * - `--env-file <path>` (from argv): required; a missing file fails loudly.
+ * - otherwise `.env` in cwd: optional; a missing file is a no-op.
+ *
+ * Returns the absolute path that was loaded, or `undefined` when nothing was loaded.
+ */
+export function loadLocalEnv(options) {
+    const { path: filePath, required } = resolveEnvFileLocation(options);
+    try {
+        process.loadEnvFile(filePath);
+        return filePath;
+    }
+    catch (err) {
+        const code = err.code;
+        if (!required && code === "ENOENT")
+            return undefined;
+        throw err;
+    }
+}
+/**
+ * Parse a dotenv file into a plain object WITHOUT touching `process.env`. Returns an
+ * empty object when the file is absent — the caller decides whether that's an error.
+ * Used by the `serve` hot-reload path, which needs the file's current values on each
+ * change (unlike {@link loadLocalEnv}, whose "existing env wins" load can't re-apply an
+ * edited value already present in `process.env`).
+ */
+export function parseEnvFile(filePath) {
+    let source;
+    try {
+        source = readFileSync(filePath, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return {};
+        throw err;
+    }
+    return parseEnv(source);
+}
+/**
+ * Watch a dotenv file for changes and invoke `onChange` (debounced) after each write.
+ * Watches the containing DIRECTORY, not the file, so it survives editors that save via
+ * atomic rename (which swaps the inode and would silently kill a file-level watch) and
+ * catches the file being created after the server starts. Returns a stop function.
+ */
+export function watchEnvFile(filePath, onChange) {
+    const dir = path.dirname(filePath);
+    const base = path.basename(filePath);
+    let timer;
+    let watcher;
+    try {
+        watcher = watch(dir, (_event, changed) => {
+            // `changed` is null on some platforms; fall back to firing on any dir event.
+            if (changed !== null && changed !== base)
+                return;
+            clearTimeout(timer);
+            timer = setTimeout(onChange, 50);
+        });
+    }
+    catch {
+        // A missing/unwatchable directory just means no hot-reload; not fatal.
+        return () => { };
+    }
+    return () => {
+        clearTimeout(timer);
+        watcher.close();
+    };
+}
+//# sourceMappingURL=loadLocalEnv.js.map

package/dist/lib/loadLocalEnv.js.map

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

package/dist/lib/tooling/compose.js

@@ -3,8 +3,8 @@
 //
 // `composeWithIntegrationLayer` below is the low-level half. Fetching the project's
 // subgraph SDL is a plain authenticated HTTP call, so it lives separately in
-// `../ilClient.ts`, parameterised by (baseUrl, projectKey, token) with the command
-// layer supplying the token.
+// `../ilClient.ts`, parameterised by (baseUrl, projectKey, authFetch) with the command
+// layer supplying the authenticated fetch.
 import { parse, printSchema } from "graphql";
 import { composeServices } from "@apollo/composition";
 /** The subgraph names the Commerce Integration Layer composes under — matched here so the

package/dist/lib/tooling/compose.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../../src/lib/tooling/compose.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,+FAA+F;AAC/F,EAAE;AACF,oFAAoF;AACpF,6EAA6E;AAC7E,mFAAmF;AACnF,6BAA6B;AAE7B,OAAO,EAAE,KAAK,EAAE,WAAW,EAAsB,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;mDAEmD;AACnD,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAC;AAC7D,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAc9C;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,mBAA2B,EAC3B,YAAoB,EACpB,IAA2D;IAE3D,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG;YACT,EAAE,IAAI,EAAE,yBAAyB,EAAE,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,mBAAmB,EAAE;YACxG,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE;SACnF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,6BAA8B,GAAa,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;IACxF,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzC,gFAAgF;IAChF,6EAA6E;IAC7E,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,iBAAiB,EAAE,CAAC;IAClE,OAAO;QACL,EAAE,EAAE,IAAI;QACR,SAAS;QACT,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../../src/lib/tooling/compose.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,+FAA+F;AAC/F,EAAE;AACF,oFAAoF;AACpF,6EAA6E;AAC7E,uFAAuF;AACvF,2CAA2C;AAE3C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAsB,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;mDAEmD;AACnD,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAC;AAC7D,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAc9C;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,mBAA2B,EAC3B,YAAoB,EACpB,IAA2D;IAE3D,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG;YACT,EAAE,IAAI,EAAE,yBAAyB,EAAE,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,mBAAmB,EAAE;YACxG,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE;SACnF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,6BAA8B,GAAa,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;IACxF,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzC,gFAAgF;IAChF,6EAA6E;IAC7E,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,iBAAiB,EAAE,CAAC;IAClE,OAAO;QACL,EAAE,EAAE,IAAI;QACR,SAAS;QACT,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC;AACJ,CAAC"}

package/dist/lib/tooling/extensionInputSampleObj.d.ts

@@ -0,0 +1,8 @@
+import type { ExtensionResourceTypeId } from "@commercetools/platform-sdk";
+export interface SampleContext {
+    resourceTypeId: ExtensionResourceTypeId;
+    id: string;
+    version: number;
+}
+/** Build the expanded `resource.obj` for an API-Extension resource type. */
+export declare function sampleExtensionResourceObj(resourceTypeId: ExtensionResourceTypeId, ctx: SampleContext): Record<string, unknown>;

package/dist/lib/tooling/extensionInputSampleObj.js

@@ -0,0 +1,178 @@
+import { AuthenticationModeValues, BusinessUnitTypeValues, CartOriginValues, CartStateValues, ExtensionResourceTypeIdValues, InventoryModeValues, OrderStateValues, PaymentMethodStatusValues, QuoteRequestStateValues, QuoteStateValues, RoundingModeValues, ShippingModeValues, StagedQuoteStateValues, TaxCalculationModeValues, TaxModeValues, } from "@commercetools/platform-sdk";
+const SAMPLE = {
+    productId: "sample-product-id",
+    productTypeId: "sample-product-type-id",
+    lineItemId: "sample-line-item-id",
+    cartId: "sample-cart-id",
+    sku: "SAMPLE-SKU",
+    currency: "EUR",
+    email: "sample.customer@example.com",
+    quoteRequestId: "sample-quote-request-id",
+    stagedQuoteId: "sample-staged-quote-id",
+    timestamp: "2024-01-01T00:00:00.000Z",
+};
+function sampleMoney(centAmount = 1000) {
+    return {
+        type: "centPrecision",
+        currencyCode: SAMPLE.currency,
+        centAmount,
+        fractionDigits: 2,
+    };
+}
+function sampleAddress(id = "sample-address-id") {
+    return {
+        id,
+        country: "DE",
+        city: "Berlin",
+        streetName: "Sample Street",
+        streetNumber: "1",
+        postalCode: "10115",
+    };
+}
+function sampleProductTypeRef() {
+    return { typeId: "product-type", id: SAMPLE.productTypeId };
+}
+function sampleCartLineItem() {
+    return {
+        id: SAMPLE.lineItemId,
+        productId: SAMPLE.productId,
+        productType: sampleProductTypeRef(),
+        name: { en: "Sample product" },
+        quantity: 1,
+        variant: { id: 1, sku: SAMPLE.sku },
+        price: { value: sampleMoney() },
+    };
+}
+function sampleShoppingListLineItem() {
+    return {
+        id: SAMPLE.lineItemId,
+        addedAt: SAMPLE.timestamp,
+        productId: SAMPLE.productId,
+        productType: sampleProductTypeRef(),
+        name: { en: "Sample product" },
+        published: true,
+        quantity: 1,
+        variant: { id: 1, sku: SAMPLE.sku },
+    };
+}
+function sampleCartFields(ctx) {
+    return {
+        id: ctx.id,
+        version: ctx.version,
+        currency: SAMPLE.currency,
+        lineItems: [sampleCartLineItem()],
+        customLineItems: [],
+        totalPrice: sampleMoney(),
+        taxMode: TaxModeValues.Platform,
+        priceRoundingMode: RoundingModeValues.HalfEven,
+        taxRoundingMode: RoundingModeValues.HalfEven,
+        taxCalculationMode: TaxCalculationModeValues.LineItemLevel,
+        inventoryMode: InventoryModeValues.None,
+        cartState: CartStateValues.Active,
+        shippingMode: ShippingModeValues.Single,
+        shipping: [],
+        discountCodes: [],
+        directDiscounts: [],
+        refusedGifts: [],
+        origin: CartOriginValues.Customer,
+        itemShippingAddresses: [],
+    };
+}
+const sampleObjBuilders = {
+    [ExtensionResourceTypeIdValues.Cart]: sampleCartFields,
+    [ExtensionResourceTypeIdValues.Order]: (ctx) => ({
+        ...sampleCartFields(ctx),
+        orderNumber: "SAMPLE-ORDER-001",
+        orderState: OrderStateValues.Open,
+    }),
+    [ExtensionResourceTypeIdValues.Payment]: (ctx) => ({
+        id: ctx.id,
+        version: ctx.version,
+        amountPlanned: sampleMoney(),
+        paymentMethodInfo: {
+            paymentInterface: "Sample",
+            method: "card",
+        },
+        paymentStatus: {
+            interfaceCode: "Pending",
+            interfaceText: "Pending",
+        },
+    }),
+    [ExtensionResourceTypeIdValues.PaymentMethod]: (ctx) => ({
+        id: ctx.id,
+        version: ctx.version,
+        key: "sample-payment-method",
+        name: { en: "Sample card" },
+        paymentInterface: "Sample",
+        paymentMethodStatus: PaymentMethodStatusValues.Active,
+        default: false,
+    }),
+    [ExtensionResourceTypeIdValues.Customer]: (ctx) => ({
+        id: ctx.id,
+        version: ctx.version,
+        email: SAMPLE.email,
+        firstName: "Sample",
+        lastName: "Customer",
+        authenticationMode: AuthenticationModeValues.Password,
+        addresses: [sampleAddress()],
+    }),
+    [ExtensionResourceTypeIdValues.CustomerGroup]: (ctx) => ({
+        id: ctx.id,
+        version: ctx.version,
+        key: "sample-customer-group",
+        name: "Sample customer group",
+    }),
+    [ExtensionResourceTypeIdValues.QuoteRequest]: (ctx) => ({
+        id: ctx.id,
+        version: ctx.version,
+        quoteRequestState: QuoteRequestStateValues.Submitted,
+        comment: "Sample quote request",
+        lineItems: [sampleCartLineItem()],
+    }),
+    [ExtensionResourceTypeIdValues.StagedQuote]: (ctx) => ({
+        id: ctx.id,
+        version: ctx.version,
+        stagedQuoteState: StagedQuoteStateValues.InProgress,
+        quoteRequest: {
+            typeId: ExtensionResourceTypeIdValues.QuoteRequest,
+            id: SAMPLE.quoteRequestId,
+        },
+        quotationCart: {
+            typeId: ExtensionResourceTypeIdValues.Cart,
+            id: SAMPLE.cartId,
+        },
+    }),
+    [ExtensionResourceTypeIdValues.Quote]: (ctx) => ({
+        id: ctx.id,
+        version: ctx.version,
+        quoteState: QuoteStateValues.Pending,
+        stagedQuote: {
+            typeId: ExtensionResourceTypeIdValues.StagedQuote,
+            id: SAMPLE.stagedQuoteId,
+        },
+        lineItems: [sampleCartLineItem()],
+        totalPrice: sampleMoney(),
+    }),
+    [ExtensionResourceTypeIdValues.BusinessUnit]: (ctx) => ({
+        id: ctx.id,
+        version: ctx.version,
+        key: "sample-business-unit",
+        name: "Sample business unit",
+        unitType: BusinessUnitTypeValues.Company,
+    }),
+    [ExtensionResourceTypeIdValues.ShoppingList]: (ctx) => ({
+        id: ctx.id,
+        version: ctx.version,
+        name: { en: "Sample shopping list" },
+        lineItems: [sampleShoppingListLineItem()],
+    }),
+};
+/** Build the expanded `resource.obj` for an API-Extension resource type. */
+export function sampleExtensionResourceObj(resourceTypeId, ctx) {
+    const build = sampleObjBuilders[resourceTypeId];
+    if (!build) {
+        throw new Error(`no sample builder registered for resource type '${resourceTypeId}'`);
+    }
+    return build(ctx);
+}
+//# sourceMappingURL=extensionInputSampleObj.js.map

package/dist/lib/tooling/extensionInputSampleObj.js.map

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

package/dist/lib/tooling/extensions.d.ts

@@ -1,18 +1,33 @@
 import { type GraphQLSchema } from "graphql";
+/** The per-package entry the CLI expects under each `extensions/*` when nothing overrides it. */
+export declare const DEFAULT_ENTRY_SEGMENT: string;
+/**
+ * Reduce an `--entry` flag value to the path *within each* extension package that `--all`
+ * should build — the same source name applied uniformly across every discovered folder.
+ *
+ * The single-extension flag defaults to a cwd-absolute path (`<cwd>/src/extension.ts`),
+ * which only makes sense against N packages as its relative tail, so we relativise it to
+ * the monorepo root: the default collapses back to `src/extension.ts`, and a caller who
+ * passes a repo-relative `--entry` (e.g. `src/main.ts`) round-trips unchanged. Anything
+ * that doesn't sit under the root (an absolute path elsewhere) can't name a per-package
+ * source, so we fall back to the default rather than emit a `../…` segment.
+ */
+export declare function entrySegmentFor(root: string, entry: string): string;
 /** An extension package discovered under the workspace's extensions/ directory. */
 export interface DiscoveredExtension {
     /** The package/directory name (used only for messages — the combined subgraph has one name). */
     name: string;
-    /** The extension source entry (`<dir>/src/extension.ts`). */
+    /** The extension source entry (`<dir>/<entrySegment>`, e.g. `<dir>/src/extension.ts`). */
     entry: string;
     /** The esbuild bundle output for a standalone build (`<dir>/dist/extension.js`). */
     outfile: string;
 }
 /**
- * Discover every extension package under `<root>/<dirName>` that has a
- * `src/extension.ts`. Sorted by name for stable, deterministic merge output.
+ * Discover every extension package under `<root>/<dirName>` that has an entry at
+ * `<pkg>/<entrySegment>` (default `src/extension.ts`). Sorted by name for stable,
+ * deterministic merge output.
  */
-export declare function discoverExtensions(root: string, dirName: string): Promise<DiscoveredExtension[]>;
+export declare function discoverExtensions(root: string, dirName: string, entrySegment?: string): Promise<DiscoveredExtension[]>;
 /** One extension's contribution to the combined subgraph. */
 export interface ExtensionModule {
     name: string;
@@ -65,7 +80,9 @@ export interface BundleForFlags extends CombinedBuildResult {
 /**
  * The single build step shared by `build`/`validate`/`push`: bundle either the one
  * extension in the cwd (default) or — with `--all` — every extension under
- * `<extensionsDir>/*` merged into the one combined bundle a project deploys. Throws a
+ * `<extensionsDir>/*` merged into the one combined bundle a project deploys. `--entry`
+ * carries over to `--all` as the per-package source segment (see {@link entrySegmentFor}),
+ * so a repo with a non-default entry name builds uniformly across every folder. Throws a
  * clean message when `--all` finds nothing to build.
  */
 export declare function bundleForFlags(opts: {