@commercetools/cli-topic-integration-layer 0.2.1 → 0.2.2

package/dist/lib/awaitBundleState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"awaitBundleState.js","sourceRoot":"","sources":["../../src/lib/awaitBundleState.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,mFAAmF;AACnF,+EAA+E;AAC/E,gFAAgF;AAChF,mFAAmF;AACnF,oFAAoF;AACpF,EAAE;AACF,iFAAiF;AACjF,kEAAkE;AAClE,EAAE;AACF,4CAA4C;AAC5C,EAAE;AACF,oFAAoF;AACpF,qFAAqF;AACrF,gFAAgF;AAChF,+EAA+E;AAC/E,kFAAkF;AAClF,qFAAqF;AACrF,2CAA2C;AAC3C,kFAAkF;AAClF,iEAAiE;AAEjE,OAAO,EAAE,kBAAkB,EAAsB,MAAM,eAAe,CAAC;AAoBvE,MAAM,YAAY,GAAG,CAAC,EAAU,EAAiB,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,UAAkB,EAClB,KAAa,EACb,OAAe,EACf,OAAqB;IAErB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,MAAM,QAAQ,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAE3C,SAAS,CAAC;QACR,IAAI,IAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,8CAA+C,GAAa,CAAC,OAAO,EAAE;aAC/E,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,4DAA4D;YAC5D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,+CAA+C,EAAE,CAAC;QACtF,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,uEAAuE;YACvE,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,sDAAsD;gBAC9D,IAAI;aACL,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC7B,4EAA4E;YAC5E,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC/D,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAE7D,iBAAiB;QACjB,IAAI,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YACtB,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,2CAA2C,OAAO,WAAW,IAAI,CAAC,KAAK,CAC7E,OAAO,CAAC,SAAS,GAAG,IAAI,CACzB,GAAG;gBACJ,IAAI;aACL,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}

package/dist/lib/ilClient.d.ts

@@ -4,6 +4,16 @@ export interface ConfigEntry {
     value: string | null;
     secret: boolean;
 }
+/**
+ * Lifecycle state of a stored bundle version.
+ *
+ *  pending — stored and being handed out, but nothing has confirmed it loads.
+ *  running — an extension loaded it and published its schema. Once a version
+ *            reaches this it is never demoted.
+ *  failed  — it could not be loaded (`reason` says why). The integration layer
+ *            stops handing it out and the version beneath it takes over.
+ */
+export type ExtensionState = "pending" | "running" | "failed";
 /** The stored bundle's metadata (integration layer `ExtensionMeta`). */
 export interface ExtensionMeta {
     projectKey: string;
@@ -12,6 +22,34 @@ export interface ExtensionMeta {
     version: number;
     updatedBy?: string;
     filename?: string;
+    /**
+     * The integrator's own version-control revision the stored bundle was built from,
+     * as reported on upload. Absent for a bundle uploaded without one (e.g. by hand in
+     * the Merchant Center).
+     */
+    sourceRevision?: string;
+    /**
+     * Lifecycle state of THIS version. Absent when talking to an integration layer
+     * that predates bundle state — callers must treat `undefined` as "this deployment
+     * can't tell me", not as a failure.
+     */
+    state?: ExtensionState;
+    /** Why this version failed to load; only ever set alongside state "failed". */
+    reason?: string;
+    /**
+     * The version actually in use, which is NOT always `version`: when the newest
+     * upload failed to load, the integration layer serves the one beneath it and this
+     * reports that older one. `null` when nothing is in use. Returned by the meta read
+     * only, not by an upload's response.
+     *
+     * It carries the source revision as well as the number, because the number is the
+     * integration layer's own counter — the commit is what identifies the build to
+     * whoever pushed it.
+     */
+    served?: {
+        version: number;
+        sourceRevision?: string;
+    } | null;
 }
 export interface BreakingChange {
     type: string;
@@ -29,8 +67,14 @@ export interface RemoteValidationResult {
 export declare function fetchSubgraphSdl(baseUrl: string, projectKey: string, token: string): Promise<string>;
 /** POST a candidate SDL to the composition + breaking-change gate (`POST …/extension/validate`). */
 export declare function remoteValidate(baseUrl: string, projectKey: string, token: string, typeDefs: string): Promise<RemoteValidationResult>;
-/** Upload the built bundle, replacing the project's stored one (`PUT …/extension/bundle`). */
-export declare function pushBundle(baseUrl: string, projectKey: string, token: string, bundle: string, filename: string): Promise<ExtensionMeta>;
+/**
+ * Upload the built bundle, replacing the project's stored one (`PUT …/extension/bundle`).
+ *
+ * `sourceRevision` (optional) records which of the integrator's revisions this build
+ * came from; the integration layer stores it against the revision, shows it in the
+ * Merchant Center, and hands it to the connector.
+ */
+export declare function pushBundle(baseUrl: string, projectKey: string, token: string, bundle: string, filename: string, sourceRevision?: string): Promise<ExtensionMeta>;
 /** The stored bundle's metadata, or null if none is stored (`GET …/extension/bundle/meta`). */
 export declare function fetchExtensionMeta(baseUrl: string, projectKey: string, token: string): Promise<ExtensionMeta | null>;
 /** Remove the project's extension subgraph from Hive (`DELETE …/extension/subgraph`). */

package/dist/lib/ilClient.js

@@ -36,8 +36,14 @@ export async function remoteValidate(baseUrl, projectKey, token, typeDefs) {
     }
     return JSON.parse(text);
 }
-/** Upload the built bundle, replacing the project's stored one (`PUT …/extension/bundle`). */
-export async function pushBundle(baseUrl, projectKey, token, bundle, filename) {
+/**
+ * Upload the built bundle, replacing the project's stored one (`PUT …/extension/bundle`).
+ *
+ * `sourceRevision` (optional) records which of the integrator's revisions this build
+ * came from; the 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) {
     const url = `${apiRoot(baseUrl, projectKey)}/extension/bundle`;
     const res = await fetch(url, {
         method: "PUT",
@@ -46,6 +52,12 @@ export async function pushBundle(baseUrl, projectKey, token, bundle, filename) {
             // The route requires the original filename (percent-encoded; it carries the
             // module's type). The bundle is plain CommonJS, so name it `.cjs`.
             "x-extension-filename": encodeURIComponent(filename),
+            // Percent-encoded for the same reason as the filename: keep an arbitrary value
+            // header-safe. Omitted entirely when there's no revision to report — the route
+            // treats a missing header as "no revision", not an error.
+            ...(sourceRevision
+                ? { "x-extension-source-revision": encodeURIComponent(sourceRevision) }
+                : {}),
             ...bearer(token),
         },
         body: bundle,

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":"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"}

package/dist/lib/sourceRevision.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Longest revision the integration layer stores — it truncates past this. Applied
+ * here too so what the CLI prints is what actually gets stored, rather than a value
+ * the server silently shortens.
+ */
+export declare const MAX_SOURCE_REVISION_LENGTH = 200;
+/**
+ * Reduce a revision to printable ASCII, length-capped — matching the integration
+ * layer's own rule, so the CLI never reports a value different from the stored one.
+ * (The server sanitizes regardless; it doesn't trust its callers. This is about
+ * telling the user the truth.)
+ */
+export declare function sanitizeSourceRevision(value: string | undefined): string | undefined;
+/**
+ * The git revision describing `cwd`'s working copy, or null when it isn't a git
+ * checkout.
+ *
+ * `git describe --tags --always` gives the most human-meaningful identifier
+ * available, in decreasing order of usefulness: an exact tag (`v1.4.2`), a tag plus
+ * distance and commit (`v1.4.2-3-g1a2b3c4d`), or — with no tags at all — the bare
+ * commit (`1a2b3c4d`). That single command therefore covers "commit hash or tag"
+ * without the caller choosing.
+ *
+ * A `-dirty` suffix is appended from `git status --porcelain -- .` rather than
+ * `describe --dirty`, because `--dirty` ignores UNTRACKED files — and an untracked
+ * source file that the entry point imports is bundled into the artifact, so a build
+ * containing it is genuinely not the tagged commit. Scoped to `-- .` so it reflects
+ * the directory being pushed, not unrelated edits elsewhere in a monorepo.
+ */
+export declare function detectGitRevision(cwd: string): Promise<string | null>;
+/**
+ * The source revision to record for this push: the explicit value if the caller gave
+ * one, else whatever the working copy says, else nothing.
+ *
+ * Nothing is a legitimate outcome — a bundle built outside version control has no
+ * revision, and inventing one ("unknown", a timestamp) would put a value in the
+ * Merchant Center and in every connector log line that means nothing.
+ */
+export declare function resolveSourceRevision(explicit: string | undefined, cwd: string): Promise<string | undefined>;

package/dist/lib/sourceRevision.js

@@ -0,0 +1,95 @@
+// Where the bundle being pushed came from — the integrator's OWN version-control
+// revision, recorded against the stored bundle by the integration layer.
+//
+// The point is provenance: with this, the Merchant Center shows which revision a
+// project is running, the connector stamps it on every log line, and
+// `{ _extensionBundle { sourceRevision } }` answers it over GraphQL. So the default
+// has to be zero-effort — `extension push` reads the working copy and reports what
+// it finds, with no flag.
+//
+// GIT is auto-detected because that's what the examples and (nearly) every
+// integrator use. Any other VCS — hg, svn, Perforce, a CI build id — is supported
+// through `--source-revision` / `EXTENSION_SOURCE_REVISION` rather than a detector
+// per system: the integration layer treats the value as an OPAQUE string, so
+// whatever identifies a revision to the integrator is the right thing to send.
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const exec = promisify(execFile);
+/**
+ * Longest revision the integration layer stores — it truncates past this. Applied
+ * here too so what the CLI prints is what actually gets stored, rather than a value
+ * the server silently shortens.
+ */
+export const MAX_SOURCE_REVISION_LENGTH = 200;
+/**
+ * Reduce a revision to printable ASCII, length-capped — matching the integration
+ * layer's own rule, so the CLI never reports a value different from the stored one.
+ * (The server sanitizes regardless; it doesn't trust its callers. This is about
+ * telling the user the truth.)
+ */
+export function sanitizeSourceRevision(value) {
+    if (!value)
+        return undefined;
+    const cleaned = value
+        .replace(/[^\x20-\x7e]/g, "")
+        .trim()
+        .slice(0, MAX_SOURCE_REVISION_LENGTH);
+    return cleaned || undefined;
+}
+// Run a git command in `cwd`, or return null if git isn't available, this isn't a
+// repository, or the command has nothing to say. Provenance is a nice-to-have on a
+// push: never fail the push over it.
+async function git(args, cwd) {
+    try {
+        const { stdout } = await exec("git", args, { cwd, windowsHide: true });
+        const trimmed = stdout.trim();
+        return trimmed || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The git revision describing `cwd`'s working copy, or null when it isn't a git
+ * checkout.
+ *
+ * `git describe --tags --always` gives the most human-meaningful identifier
+ * available, in decreasing order of usefulness: an exact tag (`v1.4.2`), a tag plus
+ * distance and commit (`v1.4.2-3-g1a2b3c4d`), or — with no tags at all — the bare
+ * commit (`1a2b3c4d`). That single command therefore covers "commit hash or tag"
+ * without the caller choosing.
+ *
+ * A `-dirty` suffix is appended from `git status --porcelain -- .` rather than
+ * `describe --dirty`, because `--dirty` ignores UNTRACKED files — and an untracked
+ * source file that the entry point imports is bundled into the artifact, so a build
+ * containing it is genuinely not the tagged commit. Scoped to `-- .` so it reflects
+ * the directory being pushed, not unrelated edits elsewhere in a monorepo.
+ */
+export async function detectGitRevision(cwd) {
+    // Cheapest possible "is this a git checkout?" probe — everything below is
+    // pointless outside one, and this keeps a non-git working copy silent rather than
+    // noisy.
+    if (!(await git(["rev-parse", "--git-dir"], cwd)))
+        return null;
+    const described = await git(["describe", "--tags", "--always", "--abbrev=12"], cwd);
+    // A repository with no commits yet describes to nothing — there is no revision to
+    // report, so report none.
+    if (!described)
+        return null;
+    const dirt = await git(["status", "--porcelain", "--", "."], cwd);
+    return dirt ? `${described}-dirty` : described;
+}
+/**
+ * The source revision to record for this push: the explicit value if the caller gave
+ * one, else whatever the working copy says, else nothing.
+ *
+ * Nothing is a legitimate outcome — a bundle built outside version control has no
+ * revision, and inventing one ("unknown", a timestamp) would put a value in the
+ * Merchant Center and in every connector log line that means nothing.
+ */
+export async function resolveSourceRevision(explicit, cwd) {
+    if (explicit !== undefined)
+        return sanitizeSourceRevision(explicit);
+    return sanitizeSourceRevision((await detectGitRevision(cwd)) ?? undefined);
+}
+//# sourceMappingURL=sourceRevision.js.map

package/dist/lib/sourceRevision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceRevision.js","sourceRoot":"","sources":["../../src/lib/sourceRevision.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,yEAAyE;AACzE,EAAE;AACF,iFAAiF;AACjF,qEAAqE;AACrE,oFAAoF;AACpF,mFAAmF;AACnF,0BAA0B;AAC1B,EAAE;AACF,2EAA2E;AAC3E,kFAAkF;AAClF,mFAAmF;AACnF,6EAA6E;AAC7E,+EAA+E;AAE/E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAEjC;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAyB;IAC9D,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,OAAO,GAAG,KAAK;SAClB,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;SAC5B,IAAI,EAAE;SACN,KAAK,CAAC,CAAC,EAAE,0BAA0B,CAAC,CAAC;IACxC,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED,kFAAkF;AAClF,mFAAmF;AACnF,qCAAqC;AACrC,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,GAAW;IAC5C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,OAAO,IAAI,IAAI,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,0EAA0E;IAC1E,kFAAkF;IAClF,SAAS;IACT,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/D,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,CAAC;IACpF,kFAAkF;IAClF,0BAA0B;IAC1B,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAA4B,EAC5B,GAAW;IAEX,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACpE,OAAO,sBAAsB,CAAC,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC;AAC7E,CAAC"}

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

@@ -0,0 +1,77 @@
+import { type GraphQLSchema } from "graphql";
+/** 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`). */
+    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.
+ */
+export declare function discoverExtensions(root: string, dirName: string): Promise<DiscoveredExtension[]>;
+/** One extension's contribution to the combined subgraph. */
+export interface ExtensionModule {
+    name: string;
+    typeDefs: string;
+    resolvers: object;
+}
+/** The single subgraph all extensions merge into. */
+export interface MergedSubgraph {
+    /** Executable subgraph schema (typeDefs + wired resolvers) — for serving. */
+    schema: GraphQLSchema;
+    /** Federation SDL of the merged subgraph — for composing with the core / publishing. */
+    sdl: string;
+}
+/**
+ * Merge several extension modules into ONE federation subgraph — the single bundle a
+ * project deploys. Each extension's SDL is a self-contained subgraph (its own
+ * `type Query`, its own `@link` header), so we can't just concatenate them
+ * (`buildSubgraphSchema` would see two `type Query`). `mergeTypeDefs` folds same-named
+ * types into one — so two extensions can each contribute fields to `Query` — and dedupes
+ * the repeated `@link`.
+ *
+ * First we reject two extensions declaring the SAME field (even identically): merged into
+ * one bundle their resolvers would silently shadow each other, so it's an authoring error
+ * we name loudly rather than paper over. The merged SDL is printed with
+ * `printSubgraphSchema`, so it round-trips as the exact federation SDL the IL validates /
+ * publishes for the deployed bundle.
+ */
+export declare function mergeExtensionSubgraph(modules: ExtensionModule[]): MergedSubgraph;
+/** Result of a combined build — the same shape {@link buildBundle} returns. */
+export interface CombinedBuildResult {
+    /** Absolute path to the single combined bundle. */
+    outfile: string;
+    /** The authors' source files that went into it (for static analysis; excludes the generated entry). */
+    sourceFiles: string[];
+}
+/**
+ * Build ONE combined bundle from every discovered extension — the artifact `push`
+ * uploads. Each extension is bundled + loaded to read its `typeDefs` (merged into one
+ * SDL, so a clash fails here on the author's machine) and to be re-imported by a
+ * generated entry that, at load time, merges the resolvers (per type, then per field),
+ * concatenates `apiExtensions`, and merges `hooks`. That entry is then bundled into the
+ * final self-contained artifact — a faithful stand-in for the single deployed bundle.
+ */
+export declare function buildCombinedBundle(extensions: DiscoveredExtension[], outfile: string): Promise<CombinedBuildResult>;
+/** What {@link bundleForFlags} produced, plus a label for the command's log line. */
+export interface BundleForFlags extends CombinedBuildResult {
+    /** Human description of what was bundled (the entry, or "N extension(s) (…)"). */
+    describe: string;
+}
+/**
+ * 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
+ * clean message when `--all` finds nothing to build.
+ */
+export declare function bundleForFlags(opts: {
+    all: boolean;
+    extensionsDir: string;
+    entry: string;
+    out: string;
+    cwd?: string;
+}): Promise<BundleForFlags>;

package/dist/lib/tooling/extensions.js

@@ -0,0 +1,209 @@
+// Monorepo helpers for the "one bundle per project" model. In production a project
+// has a SINGLE extension bundle = one federation subgraph (all of a repo's extensions
+// merged), which the router then composes with the integration-layer core subgraph.
+// So a monorepo of `extensions/*` packages must:
+//   - MERGE into one subgraph for local `serve --all` (mergeExtensionSubgraph), and
+//   - BUILD into one bundle for `build/validate/push --all` (buildCombinedBundle),
+// never one-subgraph-per-extension (that's not the deployed shape).
+import { readdir, readFile, stat, writeFile, mkdtemp } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import process from "node:process";
+import { buildSubgraphSchema, printSubgraphSchema } from "@apollo/subgraph";
+import { mergeTypeDefs } from "@graphql-tools/merge";
+import { Kind, parse } from "graphql";
+import { buildBundle } from "./build.js";
+import { loadBundleSource } from "./loadBundle.js";
+/**
+ * Discover every extension package under `<root>/<dirName>` that has a
+ * `src/extension.ts`. Sorted by name for stable, deterministic merge output.
+ */
+export async function discoverExtensions(root, dirName) {
+    const base = join(root, dirName);
+    const dirents = await readdir(base, { withFileTypes: true }).catch(() => []);
+    const found = [];
+    for (const dirent of dirents) {
+        if (!dirent.isDirectory())
+            continue;
+        const entry = join(base, dirent.name, "src", "extension.ts");
+        const hasEntry = await stat(entry)
+            .then((s) => s.isFile())
+            .catch(() => false);
+        if (!hasEntry)
+            continue;
+        found.push({
+            name: dirent.name,
+            entry,
+            outfile: join(base, dirent.name, "dist", "extension.js"),
+        });
+    }
+    return found.sort((a, b) => a.name.localeCompare(b.name));
+}
+/** Collect `Type.field` keys an SDL declares on object/interface types (incl. extensions). */
+function declaredFields(sdl) {
+    const out = [];
+    for (const def of parse(sdl).definitions) {
+        if (def.kind === Kind.OBJECT_TYPE_DEFINITION ||
+            def.kind === Kind.OBJECT_TYPE_EXTENSION ||
+            def.kind === Kind.INTERFACE_TYPE_DEFINITION ||
+            def.kind === Kind.INTERFACE_TYPE_EXTENSION) {
+            for (const f of def.fields ?? [])
+                out.push({ type: def.name.value, field: f.name.value });
+        }
+    }
+    return out;
+}
+/**
+ * Merge several extension modules into ONE federation subgraph — the single bundle a
+ * project deploys. Each extension's SDL is a self-contained subgraph (its own
+ * `type Query`, its own `@link` header), so we can't just concatenate them
+ * (`buildSubgraphSchema` would see two `type Query`). `mergeTypeDefs` folds same-named
+ * types into one — so two extensions can each contribute fields to `Query` — and dedupes
+ * the repeated `@link`.
+ *
+ * First we reject two extensions declaring the SAME field (even identically): merged into
+ * one bundle their resolvers would silently shadow each other, so it's an authoring error
+ * we name loudly rather than paper over. The merged SDL is printed with
+ * `printSubgraphSchema`, so it round-trips as the exact federation SDL the IL validates /
+ * publishes for the deployed bundle.
+ */
+export function mergeExtensionSubgraph(modules) {
+    if (modules.length === 0) {
+        throw new Error("no extension exports a GraphQL subgraph (typeDefs) to merge");
+    }
+    const resolvers = {};
+    const sdls = [];
+    const owner = new Map(); // "Type.field" -> first extension that declared it
+    for (const m of modules) {
+        if (typeof m.typeDefs !== "string" || m.typeDefs.trim() === "") {
+            throw new Error(`extension '${m.name}' must export a non-empty \`typeDefs\` string`);
+        }
+        if (m.resolvers === null || typeof m.resolvers !== "object") {
+            throw new Error(`extension '${m.name}' with \`typeDefs\` must also export a \`resolvers\` object`);
+        }
+        let fields;
+        try {
+            fields = declaredFields(m.typeDefs);
+        }
+        catch (err) {
+            throw new Error(`extension '${m.name}' has invalid \`typeDefs\`: ${err.message}`);
+        }
+        for (const { type, field } of fields) {
+            const key = `${type}.${field}`;
+            const prev = owner.get(key);
+            if (prev !== undefined && prev !== m.name) {
+                throw new Error(`extensions '${prev}' and '${m.name}' both declare \`${key}\` — a project ships one bundle, so each field must be owned by a single extension`);
+            }
+            owner.set(key, m.name);
+        }
+        sdls.push(m.typeDefs);
+        // Merge resolvers per type then per field — the same shape the combined bundle uses.
+        for (const [type, fieldResolvers] of Object.entries(m.resolvers)) {
+            resolvers[type] = Object.assign(resolvers[type] ?? {}, fieldResolvers);
+        }
+    }
+    let schema;
+    try {
+        // `mergeTypeDefs` folds the per-extension subgraphs into one document. `@apollo/subgraph`
+        // types `resolvers` as its internal `GraphQLResolverMap`; cast through the param type.
+        const typeDefs = mergeTypeDefs(sdls);
+        schema = buildSubgraphSchema({ typeDefs, resolvers });
+    }
+    catch (err) {
+        throw new Error(`extensions do not merge into a single subgraph: ${err.message}`);
+    }
+    return { schema, sdl: printSubgraphSchema(schema) };
+}
+/**
+ * Build ONE combined bundle from every discovered extension — the artifact `push`
+ * uploads. Each extension is bundled + loaded to read its `typeDefs` (merged into one
+ * SDL, so a clash fails here on the author's machine) and to be re-imported by a
+ * generated entry that, at load time, merges the resolvers (per type, then per field),
+ * concatenates `apiExtensions`, and merges `hooks`. That entry is then bundled into the
+ * final self-contained artifact — a faithful stand-in for the single deployed bundle.
+ */
+export async function buildCombinedBundle(extensions, outfile) {
+    if (extensions.length === 0) {
+        throw new Error("no extensions to build");
+    }
+    // 1. Bundle + load each extension to read its exported subgraph (typeDefs/resolvers).
+    const tmp = await mkdtemp(join(tmpdir(), "il-combine-"));
+    const loaded = [];
+    for (const ext of extensions) {
+        const out = join(tmp, `${ext.name}.js`);
+        await buildBundle(ext.entry, out);
+        loaded.push({ name: ext.name, module: loadBundleSource(await readFile(out, "utf8")) });
+    }
+    // 2. Merge the subgraph-bearing extensions into one SDL (conflict detection). An
+    //    extension may be API-extensions-only (no typeDefs) — those contribute no SDL.
+    const withSubgraph = loaded.filter((l) => typeof l.module.typeDefs === "string" && l.module.typeDefs.trim() !== "");
+    const mergedSdl = withSubgraph.length > 0
+        ? mergeExtensionSubgraph(withSubgraph.map((l) => ({
+            name: l.name,
+            typeDefs: l.module.typeDefs,
+            resolvers: l.module.resolvers ?? {},
+        }))).sdl
+        : undefined;
+    // 3. Generate the combining entry: re-import each extension, merge at load time.
+    const imports = extensions
+        .map((e, i) => `import * as e${i} from ${JSON.stringify(e.entry)};`)
+        .join("\n");
+    const modulesArray = `[${extensions.map((_, i) => `e${i}`).join(", ")}]`;
+    const entrySource = `${imports}
+
+const __modules = ${modulesArray};
+
+${mergedSdl !== undefined ? `export const typeDefs = ${JSON.stringify(mergedSdl)};` : ""}
+
+const __mergeResolvers = (mods) => {
+  const out = {};
+  for (const m of mods) {
+    const r = m && m.resolvers;
+    if (!r || typeof r !== "object") continue;
+    for (const type of Object.keys(r)) {
+      out[type] = Object.assign(out[type] ?? {}, r[type]);
+    }
+  }
+  return out;
+};
+
+export const resolvers = __mergeResolvers(__modules);
+export const apiExtensions = __modules.flatMap((m) =>
+  m && Array.isArray(m.apiExtensions) ? m.apiExtensions : [],
+);
+export const hooks = Object.assign(
+  {},
+  ...__modules.map((m) => (m && m.hooks && typeof m.hooks === "object" ? m.hooks : {})),
+);
+`;
+    const entryPath = join(tmp, "combined-entry.ts");
+    await writeFile(entryPath, entrySource, "utf8");
+    // 4. Bundle the generated entry into the single artifact. Its imported author sources
+    //    feed static analysis; the generated entry itself is trusted, so drop it.
+    const { sourceFiles } = await buildBundle(entryPath, outfile);
+    const generated = resolve(entryPath);
+    return { outfile, sourceFiles: sourceFiles.filter((f) => resolve(f) !== generated) };
+}
+/**
+ * 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
+ * clean message when `--all` finds nothing to build.
+ */
+export async function bundleForFlags(opts) {
+    if (!opts.all) {
+        const { outfile, sourceFiles } = await buildBundle(opts.entry, opts.out);
+        return { outfile, sourceFiles, describe: opts.entry };
+    }
+    const extensions = await discoverExtensions(opts.cwd ?? process.cwd(), opts.extensionsDir);
+    if (extensions.length === 0) {
+        throw new Error(`no extensions found under ./${opts.extensionsDir}/*/src/extension.ts — run --all from the monorepo root`);
+    }
+    const { outfile, sourceFiles } = await buildCombinedBundle(extensions, opts.out);
+    return {
+        outfile,
+        sourceFiles,
+        describe: `${extensions.length} extension(s) (${extensions.map((e) => e.name).join(", ")})`,
+    };
+}
+//# sourceMappingURL=extensions.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commercetools/cli-topic-integration-layer",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "commercetools CLI plugin: integration-layer topic",
   "license": "MIT",
   "type": "module",
@@ -25,6 +25,7 @@
     "@apollo/gateway": "^2.14.1",
     "@apollo/subgraph": "^2.14.1",
     "@envelop/apollo-federation": "^8.1.1",
+    "@graphql-tools/merge": "^9.2.2",
     "@oclif/core": "4.2.10",
     "esbuild": "^0.28.0",
     "graphql": "^16.9.0",