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

package/dist/commands/integration-layer/extension/push.js

@@ -0,0 +1,217 @@
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { Flags } from "@oclif/core";
+import { defaultEntry, defaultOutfile } from "../../../lib/tooling/build.js";
+import { bundleForFlags } from "../../../lib/tooling/extensions.js";
+import { validateBundle, BundleValidationError } from "../../../lib/tooling/validateBundle.js";
+import { pushBundle, remoteValidate } from "../../../lib/ilClient.js";
+import { awaitBundleState } from "../../../lib/awaitBundleState.js";
+import { resolveSourceRevision } from "../../../lib/sourceRevision.js";
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+// How often to re-read the bundle's status while waiting. The extension re-reads its
+// bundle on its own ~30s poll, so a tighter interval just adds requests without
+// learning anything sooner; 5s keeps the command feeling responsive when the
+// extension happens to be mid-poll already.
+const POLL_INTERVAL_MS = 5000;
+/**
+ * Name a build the way its author recognises it: the integration layer's version
+ * number AND the source revision it was built from. The number is an internal
+ * counter — the commit is the identity. Falls back to the bare version when the
+ * push recorded no revision.
+ */
+function describeBuild(version, sourceRevision) {
+    return sourceRevision
+        ? `version ${version} (source revision ${sourceRevision})`
+        : `version ${version}`;
+}
+export default class ExtensionPush extends IntegrationLayerCommand {
+    static description = "Build + validate (local + remote) + upload the bundle, replacing the project's stored one";
+    static examples = [
+        "<%= config.bin %> integration-layer extension push",
+        "<%= config.bin %> integration-layer extension push --force",
+        "<%= config.bin %> integration-layer extension push --all",
+        "<%= config.bin %> integration-layer extension push --source-revision r48211",
+        "<%= config.bin %> integration-layer extension push --no-source-revision",
+    ];
+    static flags = {
+        entry: Flags.string({ description: "extension entry source file", default: defaultEntry() }),
+        out: Flags.string({ description: "bundle output file", default: defaultOutfile() }),
+        all: Flags.boolean({
+            description: "merge every extension under ./extensions/* into ONE combined bundle and push that single artifact (the deployed shape)",
+            default: false,
+        }),
+        "extensions-dir": Flags.string({
+            description: "directory holding the extension packages (used with --all)",
+            default: "extensions",
+        }),
+        force: Flags.boolean({
+            char: "f",
+            description: "upload despite a failing REMOTE validation (the local check always hard-fails)",
+            default: false,
+        }),
+        // Provenance. The default is auto-detection from the working copy, so a plain
+        // `push` records where the build came from with no ceremony; the flag is for a
+        // non-git VCS, a CI build id, or anything else the integrator identifies revisions
+        // by (the integration layer stores an opaque string).
+        "source-revision": Flags.string({
+            description: "version-control revision this build came from (default: detected from the git working copy; also settable via EXTENSION_SOURCE_REVISION)",
+            env: "EXTENSION_SOURCE_REVISION",
+            exclusive: ["no-source-revision"],
+        }),
+        "no-source-revision": Flags.boolean({
+            description: "push without recording any source revision",
+            default: false,
+        }),
+        // A push only STORES the bundle; the extension loads it on its own poll and
+        // reports back. Waiting for that verdict is the default because a push that
+        // reports success while the bundle can't actually run is the thing worth
+        // catching — especially in CI, where this is the difference between a green
+        // pipeline and a green pipeline that shipped a broken extension.
+        wait: Flags.boolean({
+            description: "wait for the extension to load the pushed version and report back (use --no-wait to return as soon as it is stored)",
+            default: true,
+            allowNo: true,
+        }),
+        "wait-timeout": Flags.integer({
+            description: "seconds to wait for the pushed version to be confirmed before giving up (the push still stands)",
+            default: 180,
+        }),
+    };
+    /**
+     * Report how the pushed version fared and say whether the command should fail.
+     *
+     * Only a genuine `failed` verdict is an error. Not being ABLE to find out — an
+     * older integration layer, an extension that isn't deployed, a metadata read that
+     * errored — is reported honestly and left as a success, because the push itself
+     * did land and failing it would break workflows that never had this signal.
+     */
+    reportOutcome(outcome, version) {
+        switch (outcome.kind) {
+            case "running":
+                this.log(`✓ ${describeBuild(version, outcome.meta.sourceRevision)} is running — the extension loaded it and published its schema`);
+                return false;
+            case "failed": {
+                this.logToStderr(`✗ ${describeBuild(version, outcome.meta.sourceRevision)} could not be loaded and is NOT in use.`);
+                if (outcome.meta.reason)
+                    this.logToStderr(`  reason: ${outcome.meta.reason}`);
+                const served = outcome.meta.served;
+                this.logToStderr(served == null
+                    ? "  no stored version could be loaded, so this project currently has no extension running."
+                    : `  ${describeBuild(served.version, served.sourceRevision)} is still in use; fix the bundle and push again.`);
+                return true;
+            }
+            case "superseded":
+                this.log(`⚠ another push replaced version ${version} with ${describeBuild(outcome.meta.version, outcome.meta.sourceRevision)} while waiting; not reporting on it`);
+                return false;
+            case "unknown":
+                this.log(`⚠ could not confirm version ${version}: ${outcome.reason}`);
+                this.log("  the bundle is stored; check the extension panel in the Merchant Center.");
+                return false;
+        }
+    }
+    /** True when the remote result should abort the push. */
+    reportRemote(result) {
+        if (!result.composes) {
+            this.logToStderr("✗ extension does not compose with the integration layer supergraph:");
+            for (const err of result.compositionErrors)
+                this.logToStderr(`  - ${err}`);
+        }
+        else if (result.breakingChanges.length > 0) {
+            this.logToStderr("✗ extension introduces breaking changes to the published supergraph:");
+            for (const change of result.breakingChanges) {
+                this.logToStderr(`  - [${change.type}] ${change.description}`);
+            }
+        }
+        else if (!result.comparedToPublished) {
+            this.log("✓ composes with the integration layer supergraph (breaking-change check skipped: no published baseline)");
+        }
+        else {
+            this.log("✓ composes with the integration layer supergraph and introduces no breaking changes");
+        }
+        return result.valid;
+    }
+    async run() {
+        const { flags } = await this.parse(ExtensionPush);
+        // Bundle, then VALIDATE before we touch the store. Local check first — it always
+        // hard-fails, regardless of --force.
+        let outfile;
+        let sourceFiles;
+        try {
+            ({ outfile, sourceFiles } = await bundleForFlags({
+                all: flags.all,
+                extensionsDir: flags["extensions-dir"],
+                entry: flags.entry,
+                out: flags.out,
+            }));
+        }
+        catch (err) {
+            this.error(err.message);
+        }
+        let typeDefs;
+        try {
+            const local = await validateBundle(outfile, sourceFiles);
+            typeDefs = local.typeDefs;
+            this.log(`✓ validated bundle (resolver roots: ${local.resolverTypes.join(", ") || "none"}; ` +
+                `API extensions: ${local.apiExtensionKeys.join(", ") || "none"})`);
+        }
+        catch (err) {
+            if (err instanceof BundleValidationError)
+                this.error(err.message);
+            throw err;
+        }
+        const { baseUrl, projectKey, token } = await this.resolveIlContext(flags);
+        // Remote check composes the GraphQL subgraph WITH the integration layer + checks
+        // for breaking changes. Only applies when the bundle has a subgraph — an
+        // API-extensions-only bundle has no SDL, so skip straight to the upload.
+        if (typeDefs !== null) {
+            const remote = await remoteValidate(baseUrl, projectKey, token, typeDefs);
+            const valid = this.reportRemote(remote);
+            if (!valid) {
+                if (!flags.force) {
+                    this.error("Aborting push. Re-run with --force to override the remote validation.");
+                }
+                this.logToStderr("⚠ forcing push despite failing validation (--force).");
+            }
+        }
+        const bundle = await readFile(outfile, "utf8");
+        const filename = `${basename(outfile).replace(/\.[^.]+$/, "")}.cjs`;
+        // Which of the integrator's revisions this build came from. Reported so the
+        // Merchant Center, the connector's log lines and `{ _extensionBundle }` can all
+        // name it. Detected from the working copy unless the caller said otherwise; a
+        // build outside version control simply reports none (see sourceRevision.ts).
+        const sourceRevision = flags["no-source-revision"]
+            ? undefined
+            : await resolveSourceRevision(flags["source-revision"], process.cwd());
+        if (sourceRevision) {
+            this.log(`Source revision: ${sourceRevision}`);
+        }
+        else if (!flags["no-source-revision"]) {
+            // Say so rather than staying silent: the operator console and the connector
+            // logs will show no revision for this push, and that's worth knowing now.
+            this.logToStderr("⚠ no source revision detected (not a git checkout?) — pushing without one. " +
+                "Pass --source-revision to record one explicitly.");
+        }
+        const url = `${baseUrl}/${encodeURIComponent(projectKey)}/extension/bundle`;
+        this.log(`Pushing extension bundle (${bundle.length} bytes) → ${url}`);
+        const meta = await pushBundle(baseUrl, projectKey, token, bundle, filename, sourceRevision);
+        this.log(`✓ stored revision ${meta.version} (${meta.length} bytes, filename ${meta.filename ?? filename})`);
+        if (meta.sourceRevision) {
+            this.log(`  built from ${meta.sourceRevision}`);
+        }
+        if (!flags.wait) {
+            return;
+        }
+        // Storing it isn't running it. Wait for the extension to actually load this
+        // version and say so, and fail the command if it couldn't — otherwise a bundle
+        // the sandbox refuses to run exits 0 and looks like a successful push.
+        this.log(`Waiting for the extension to load version ${meta.version}…`);
+        const outcome = await awaitBundleState(baseUrl, projectKey, token, meta.version, {
+            timeoutMs: flags["wait-timeout"] * 1000,
+            intervalMs: POLL_INTERVAL_MS,
+        });
+        if (this.reportOutcome(outcome, meta.version)) {
+            this.error("The pushed bundle could not be loaded.");
+        }
+    }
+}
+//# sourceMappingURL=push.js.map

package/dist/commands/integration-layer/extension/push.js.map

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

package/dist/commands/integration-layer/extension/serve.d.ts

@@ -0,0 +1,37 @@
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ExtensionServe extends IntegrationLayerCommand {
+    static description: string;
+    static examples: string[];
+    protected authorized: boolean;
+    static flags: {
+        port: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        compose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        gateway: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "extensions-dir": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    /**
+     * `--all`: merge every extension under `./extensions/*` into ONE federation subgraph —
+     * the single bundle a project deploys — and serve it behind a local federated gateway
+     * with the deployed integration layer, exactly the two-subgraph shape the router plans
+     * over (core + the combined `extensions` subgraph). Like `--gateway` it reaches the
+     * integration layer (fetches its SDL, mints an anonymous session), so it needs a
+     * `commercetools auth login`. Watches every extension and hot-reloads: any edit
+     * re-merges the combined subgraph, and a schema change recomposes + rebuilds the gateway.
+     */
+    private runAll;
+    /**
+     * Start esbuild in watch mode over the current example and feed `onBuild` a freshly
+     * loaded subgraph on every (re)build. Resolves once the initial build has produced
+     * one (so the caller can start serving); later rebuilds fire `onBuild` again.
+     */
+    private watchAndBuild;
+    /**
+     * The generic watcher underneath {@link watchAndBuild}: esbuild-watch `entry`, and on
+     * every successful (re)build load the bundle and hand the raw module to `onReload`.
+     * `--all` uses this directly (it needs the module's resolvers to merge subgraphs);
+     * single-mode wraps it to build one subgraph.
+     */
+    private watchEntry;
+}