@commercetools/cli-topic-integration-layer 0.8.0 → 0.9.0

package/README.md

@@ -30,7 +30,7 @@ commercetools integration-layer init [DIR]                  # scaffold an extens
 
 commercetools integration-layer extension build             # bundle src/extension.ts → dist [offline]
 commercetools integration-layer extension serve             # local dev server; allowlist-gated fetch when online + logged in
-commercetools integration-layer extension invoke-api-extension   # fire an API-Extension callback (sample or --input) [offline]
+commercetools integration-layer extension invoke-api-extension   # fire an API-Extension callback at the local bundle [offline], or --deployed via the IL
 
 commercetools integration-layer explore                     # local GraphQL explorer over your deployed edge
 commercetools integration-layer schema fetch                # the Project's core-subgraph SDL

package/dist/commands/integration-layer/extension/invoke-api-extension.d.ts

@@ -1,9 +1,9 @@
-import { Command } from "@oclif/core";
-export default class ExtensionInvokeApiExtension extends Command {
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ExtensionInvokeApiExtension extends IntegrationLayerCommand {
     static description: string;
     static examples: string[];
+    protected authorized: boolean;
     static flags: {
-        "env-file": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         entry: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         out: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
@@ -11,9 +11,18 @@ export default class ExtensionInvokeApiExtension extends Command {
         input: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         key: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         config: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        deployed: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    protected init(): Promise<void>;
     /** Read and validate the `--input` ExtensionInput JSON file. */
     private loadInput;
     run(): Promise<void>;
+    /**
+     * Fire the callback at the project's DEPLOYED extension via the integration layer's
+     * signing proxy, and print the connector's verdict. The IL is the only party that can
+     * sign the connector's `/api-extensions` call (the shared secret never leaves it), so
+     * the CLI hands it the payload and renders what comes back. Nothing is persisted.
+     */
+    private runDeployed;
+    /** Invoke the bundle's handlers IN-PROCESS against the supplied payload (offline). */
+    private runLocal;
 }

package/dist/commands/integration-layer/extension/invoke-api-extension.js

@@ -1,43 +1,38 @@
 import { readFile } from "node:fs/promises";
-import { Command, Flags } from "@oclif/core";
+import { Flags } from "@oclif/core";
 import { defaultEntry, defaultOutfile } from "../../../lib/tooling/build.js";
 import { bundleForFlags } from "../../../lib/tooling/extensions.js";
 import { loadBundleSource } from "../../../lib/tooling/loadBundle.js";
+import { describeResult, extractApiExtensions, handlerMatches, } from "../../../lib/tooling/apiExtensionDispatch.js";
 import { extensionConfigFromEnv, extensionConfigFromPairs } from "../../../lib/extensionConfig.js";
-import { loadLocalEnv } from "../../../lib/loadLocalEnv.js";
-function describeResult(result) {
-    if (result && typeof result === "object") {
-        if (Array.isArray(result.errors) && result.errors.length > 0) {
-            return `BLOCK — ${result.errors.map((e) => `${e.code}: ${e.message}`).join("; ")}`;
-        }
-        if (Array.isArray(result.actions) && result.actions.length > 0) {
-            return `MODIFY — ${JSON.stringify(result.actions)}`;
-        }
-    }
-    return "APPROVE";
-}
-export default class ExtensionInvokeApiExtension extends Command {
-    static description = "Fire a commercetools API-Extension callback from a supplied payload at the bundle's handlers";
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+import { invokeDeployedApiExtension } from "../../../lib/ilClient.js";
+export default class ExtensionInvokeApiExtension extends IntegrationLayerCommand {
+    static description = "Fire a commercetools API-Extension callback from a supplied payload — at the LOCAL bundle's handlers, or (with --deployed) at the project's DEPLOYED extension through the Commerce Integration Layer";
     static examples = [
         "<%= config.bin %> integration-layer extension invoke-api-extension --input ./payloads/cart-create.json",
         "<%= config.bin %> integration-layer extension invoke-api-extension --input ./payloads/order-create.json --key order-tagger",
         "<%= config.bin %> integration-layer extension invoke-api-extension --all --input ./payload.json --config MAX_QTY=5",
+        "<%= config.bin %> integration-layer extension invoke-api-extension --deployed --input ./payloads/cart-create.json",
     ];
+    // Local (in-process) invocation needs no login; --deployed resolves the context
+    // lazily and then requires a logged-in principal (see run → runDeployed).
+    authorized = false;
     static flags = {
-        "env-file": Flags.string({
-            description: "dotenv file to load before the command runs (default: .env in the cwd, if present); does not override variables already set in the environment",
-        }),
         entry: Flags.string({
-            description: "extension entry source file (with --all: the per-package source segment applied under each ./extensions/*)",
+            description: "extension entry source file (with --all: the per-package source segment applied under each ./extensions/*); local invocation only",
             default: defaultEntry(),
         }),
-        out: Flags.string({ description: "bundle output file", default: defaultOutfile() }),
+        out: Flags.string({
+            description: "bundle output file; local invocation only",
+            default: defaultOutfile(),
+        }),
         all: Flags.boolean({
-            description: "invoke the ONE combined bundle merged from every extension under ./extensions/* (the deployed shape)",
+            description: "invoke the ONE combined bundle merged from every extension under ./extensions/* (the deployed shape); local invocation only",
             default: false,
         }),
         "extensions-dir": Flags.string({
-            description: "directory holding the extension packages (used with --all)",
+            description: "directory holding the extension packages (used with --all); local invocation only",
             default: "extensions",
         }),
         input: Flags.string({
@@ -45,22 +40,20 @@ export default class ExtensionInvokeApiExtension extends Command {
             required: true,
         }),
         key: Flags.string({
-            description: "only invoke handlers with this key (repeatable)",
+            description: "only invoke handlers with this key (repeatable); local invocation only — the deployed connector returns one merged verdict",
             multiple: true,
             delimiter: ",",
         }),
         config: Flags.string({
-            description: "a ctx.config entry as KEY=VALUE (repeatable); overrides EXTENSION_CONFIG_* from the environment / .env",
+            description: "a ctx.config entry as KEY=VALUE (repeatable); overrides EXTENSION_CONFIG_* from the environment / .env; local invocation only — --deployed uses the project's stored config",
             multiple: true,
             delimiter: ",",
         }),
+        deployed: Flags.boolean({
+            description: "fire the callback at the project's DEPLOYED extension through the Commerce Integration Layer (requires `commercetools auth login`) instead of running the local bundle in-process",
+            default: false,
+        }),
     };
-    async init() {
-        // Load `.env` / `--env-file` into process.env before flags parse, so
-        // EXTENSION_CONFIG_* is visible below (an already-set shell variable still wins).
-        loadLocalEnv();
-        await super.init();
-    }
     /** Read and validate the `--input` ExtensionInput JSON file. */
     async loadInput(inputPath) {
         let parsed;
@@ -84,7 +77,62 @@ export default class ExtensionInvokeApiExtension extends Command {
         return { action: obj.action, resource };
     }
     async run() {
-        const { flags } = await this.parse(ExtensionInvokeApiExtension);
+        const { flags, metadata } = await this.parse(ExtensionInvokeApiExtension);
+        if (flags.deployed) {
+            // --deployed reaches the DEPLOYED extension through the integration layer, so the
+            // local-bundle knobs (which build/merge/configure a bundle here) are meaningless
+            // — reject them loudly rather than silently ignore. `entry`/`out`/`extensions-dir`
+            // carry defaults, so only complain when the user set them explicitly.
+            const localOnly = [];
+            if (flags.all)
+                localOnly.push("--all");
+            if (flags.config && flags.config.length > 0)
+                localOnly.push("--config");
+            if (flags.key && flags.key.length > 0)
+                localOnly.push("--key");
+            for (const name of ["entry", "out", "extensions-dir"]) {
+                if (metadata.flags[name] && !metadata.flags[name].setFromDefault)
+                    localOnly.push(`--${name}`);
+            }
+            if (localOnly.length > 0) {
+                this.error(`--deployed fires the callback at the DEPLOYED extension through the Commerce Integration Layer, ` +
+                    `so it can't be combined with the local-bundle flag(s): ${localOnly.join(", ")}. ` +
+                    `--deployed uses the deployed code and the project's stored config, and returns the ` +
+                    `connector's single merged verdict (there is no per-key breakdown).`);
+            }
+            await this.runDeployed(flags);
+            return;
+        }
+        await this.runLocal(flags);
+    }
+    /**
+     * Fire the callback at the project's DEPLOYED extension via the integration layer's
+     * signing proxy, and print the connector's verdict. The IL is the only party that can
+     * sign the connector's `/api-extensions` call (the shared secret never leaves it), so
+     * the CLI hands it the payload and renders what comes back. Nothing is persisted.
+     */
+    async runDeployed(flags) {
+        const input = await this.loadInput(flags.input);
+        const { action, resource } = input;
+        const { baseUrl, projectKey, authFetch } = await this.resolveIlContext(flags);
+        // Deployed is ALWAYS the live extension — say so before firing. It runs the real
+        // callback against the deployed connector; it just doesn't persist the write.
+        this.warn(`invoking the LIVE deployed extension for project '${projectKey}' — this runs the real ` +
+            `API-Extension callback against the deployed connector (no write is persisted to commercetools)`);
+        this.log(`Invoking the deployed extension with a ${action} on ${resource.typeId} …`);
+        const { status, result } = await invokeDeployedApiExtension(baseUrl, projectKey, authFetch, input);
+        // 200 (approve/modify) and 400 (block) are the extension's VERDICT — render them.
+        // Any other status is the connector failing to answer cleanly, not a decision.
+        if (status === 200 || status === 400) {
+            this.log(`  → ${describeResult(result)} (connector HTTP ${status})`);
+        }
+        else {
+            this.warn(`the deployed extension returned HTTP ${status} (not an approve/modify/block verdict): ` +
+                `${typeof result === "string" ? result : JSON.stringify(result)}`);
+        }
+    }
+    /** Invoke the bundle's handlers IN-PROCESS against the supplied payload (offline). */
+    async runLocal(flags) {
         // Environment / `.env` first; an explicit `--config` wins on the same key.
         const config = {
             ...extensionConfigFromEnv(),
@@ -102,10 +150,7 @@ export default class ExtensionInvokeApiExtension extends Command {
         catch (err) {
             this.error(err.message);
         }
-        const mod = loadBundleSource(await readFile(outfile, "utf8"));
-        const handlers = Array.isArray(mod.apiExtensions)
-            ? mod.apiExtensions
-            : [];
+        const handlers = extractApiExtensions(loadBundleSource(await readFile(outfile, "utf8")));
         if (handlers.length === 0) {
             this.error("this bundle declares no `apiExtensions`.");
         }
@@ -128,7 +173,7 @@ export default class ExtensionInvokeApiExtension extends Command {
         const ctx = { now: () => Date.now(), config };
         this.log(`Invoking ${selected.length} handler(s) with a ${action} on ${resourceType}`);
         for (const h of selected) {
-            if (h.resourceTypeId !== resourceType || !h.actions.includes(action)) {
+            if (!handlerMatches(h, resourceType, action)) {
                 this.log(`  · ${h.key}: skipped (does not trigger on ${resourceType}/${action})`);
                 continue;
             }

package/dist/commands/integration-layer/extension/invoke-api-extension.js.map

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

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

@@ -0,0 +1,35 @@
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ExtensionServeApiExtension extends IntegrationLayerCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        "public-url": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        port: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        entry: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        out: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "extensions-dir": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        cleanup: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    /** Apply {@link planReconcile}: delete superseded/removed Extensions, create new ones. */
+    private reconcile;
+    /** Delete every `il-localdev-*` Extension currently on the project (best-effort). */
+    private cleanupLeftovers;
+    /**
+     * Concatenate every package's `apiExtensions` into the one set a project deploys (the
+     * same flatMap `buildCombinedBundle` does), rejecting a key declared by two different
+     * extensions: a project ships one bundle, so each API-Extension key — and thus its
+     * `il-localdev-` registration — must be unique across packages.
+     */
+    private combineApiExtensions;
+    /** One-shot build + load; returns the bundle's declared handlers. */
+    private buildOnce;
+    /**
+     * esbuild-watch `entry`; on every successful (re)build load the bundle and hand the
+     * raw module to `onReload`. Resolves once the first build completes. Mirrors the
+     * `serve` command's watcher, with the same bundle options as `buildBundle`.
+     */
+    private watchEntry;
+}