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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) commercetools GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# @commercetools/cli-topic-integration-layer
+
+A [commercetools CLI](https://github.com/commercetools/cli) plugin that adds the
+`integration-layer` topic. It is published to the public npm registry and installed on
+demand as a runtime oclif plugin — it is never bundled into the base `@commercetools/cli`.
+
+## Install
+
+```bash
+# Public CLI. NB: use @dev for now — the `plugins` command (@oclif/plugin-plugins)
+# is only in the CLI's dev prerelease; @latest (0.0.17) predates it. Drop to
+# @latest once plugin-plugins is promoted to the latest release.
+npm install -g @commercetools/cli@dev
+
+# Opt in to the integration-layer topic (public npm — no auth needed)
+commercetools plugins install @commercetools/cli-topic-integration-layer
+```
+
+## Commands
+
+```bash
+commercetools integration-layer init <DIR>               # scaffold an extension project [local]
+
+commercetools integration-layer extension build          # bundle src/extension.ts -> dist [local]
+commercetools integration-layer extension validate        # local checks + remote compose/breaking gate
+commercetools integration-layer extension push [--force]   # build + validate + upload the bundle
+                       [--source-revision <rev> | --no-source-revision]   # provenance; default: detected from git
+commercetools integration-layer extension status          # show the project's stored bundle
+commercetools integration-layer extension delete [--yes]   # remove the extension subgraph
+
+commercetools integration-layer schema fetch [--out f]    # print the project's core-subgraph SDL
+
+commercetools integration-layer config list               # config entries (secrets masked)
+commercetools integration-layer config get <KEY>
+commercetools integration-layer config set <KEY> <VALUE> [--secret]
+commercetools integration-layer config unset <KEY>
+```
+
+Authenticated commands present the token from `commercetools auth login` (a
+`manage_project` bearer) and resolve the integration-layer edge from
+`--integration-layer-url` / `INTEGRATION_LAYER_URL` (a region-implied URL is a TODO).
+`build` / `init` are local and need no login. See
+[`integration-layer-cli-command-structure.md`](../../integration-layer-cli-command-structure.md)
+for the full command → route mapping.
+
+## Develop
+
+This package lives in the octolog monorepo as the `integration-layer-cli` domain
+(pnpm workspace, member `app/`). From the repo root:
+
+```bash
+pnpm ilc:install     # install
+pnpm ilc:build       # tsc -> dist/
+pnpm ilc:typecheck   # tsc --noEmit (src + tests)
+pnpm ilc:lint        # eslint
+pnpm ilc:test        # vitest
+
+# Run the built command directly against the public CLI's runner:
+#   commercetools plugins link .   (from app/, after build)
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/commands/integration-layer/config/get.d.ts

@@ -0,0 +1,9 @@
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ConfigGet extends IntegrationLayerCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/integration-layer/config/get.js

@@ -0,0 +1,22 @@
+import { Args } from "@oclif/core";
+import { listConfig } from "../../../lib/ilClient.js";
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ConfigGet extends IntegrationLayerCommand {
+    static description = "Print one extension config entry (secret values masked)";
+    static examples = ["<%= config.bin %> integration-layer config get ALGOLIA_APP_ID"];
+    static args = {
+        key: Args.string({ description: "the config entry key", required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ConfigGet);
+        const { baseUrl, projectKey, token } = await this.resolveIlContext(flags);
+        const entries = await listConfig(baseUrl, projectKey, token);
+        const entry = entries.find((e) => e.key === args.key);
+        if (!entry) {
+            this.error(`No config entry '${args.key}' for '${projectKey}'.`);
+        }
+        const value = entry.secret ? "•••••• (secret)" : String(entry.value ?? "");
+        this.log(`${entry.key} = ${value}`);
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/integration-layer/config/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../../src/commands/integration-layer/config/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,uBAAuB;IAC5D,MAAM,CAAU,WAAW,GAAG,yDAAyD,CAAC;IAExF,MAAM,CAAU,QAAQ,GAAG,CAAC,+DAA+D,CAAC,CAAC;IAE7F,MAAM,CAAU,IAAI,GAAG;QACrB,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KAC1E,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,GAAG,UAAU,UAAU,IAAI,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC;IACtC,CAAC"}

package/dist/commands/integration-layer/config/list.d.ts

@@ -0,0 +1,6 @@
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ConfigList extends IntegrationLayerCommand {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/integration-layer/config/list.js

@@ -0,0 +1,20 @@
+import { listConfig } from "../../../lib/ilClient.js";
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ConfigList extends IntegrationLayerCommand {
+    static description = "List the project's extension config entries (secret values masked)";
+    static examples = ["<%= config.bin %> integration-layer config list"];
+    async run() {
+        const { flags } = await this.parse(ConfigList);
+        const { baseUrl, projectKey, token } = await this.resolveIlContext(flags);
+        const entries = await listConfig(baseUrl, projectKey, token);
+        if (entries.length === 0) {
+            this.log(`No extension config entries for '${projectKey}'.`);
+            return;
+        }
+        for (const e of entries) {
+            const value = e.secret ? "•••••• (secret)" : String(e.value ?? "");
+            this.log(`${e.key} = ${value}`);
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/integration-layer/config/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/integration-layer/config/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,uBAAuB;IAC7D,MAAM,CAAU,WAAW,GAAG,oEAAoE,CAAC;IAEnG,MAAM,CAAU,QAAQ,GAAG,CAAC,iDAAiD,CAAC,CAAC;IAE/E,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,oCAAoC,UAAU,IAAI,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACnE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC"}

package/dist/commands/integration-layer/config/set.d.ts

@@ -0,0 +1,13 @@
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ConfigSet extends IntegrationLayerCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        value: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        secret: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/integration-layer/config/set.js

@@ -0,0 +1,29 @@
+import { Args, Flags } from "@oclif/core";
+import { patchConfig } from "../../../lib/ilClient.js";
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ConfigSet extends IntegrationLayerCommand {
+    static description = "Create or update an extension config entry";
+    static examples = [
+        "<%= config.bin %> integration-layer config set ALGOLIA_APP_ID abc123",
+        "<%= config.bin %> integration-layer config set ALGOLIA_API_KEY s3cr3t --secret",
+    ];
+    static args = {
+        key: Args.string({ description: "the config entry key", required: true }),
+        value: Args.string({ description: "the value to store", required: true }),
+    };
+    static flags = {
+        secret: Flags.boolean({
+            description: "seal the value (write-only thereafter, encrypted at rest)",
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ConfigSet);
+        const { baseUrl, projectKey, token } = await this.resolveIlContext(flags);
+        await patchConfig(baseUrl, projectKey, token, [
+            { key: args.key, value: args.value, secret: flags.secret },
+        ]);
+        this.log(`✓ set '${args.key}'${flags.secret ? " (secret)" : ""} for '${projectKey}'.`);
+    }
+}
+//# sourceMappingURL=set.js.map

package/dist/commands/integration-layer/config/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../../src/commands/integration-layer/config/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,uBAAuB;IAC5D,MAAM,CAAU,WAAW,GAAG,4CAA4C,CAAC;IAE3E,MAAM,CAAU,QAAQ,GAAG;QACzB,sEAAsE;QACtE,gFAAgF;KACjF,CAAC;IAEF,MAAM,CAAU,IAAI,GAAG;QACrB,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACzE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KAC1E,CAAC;IAEF,MAAM,CAAU,KAAK,GAAG;QACtB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;YACpB,WAAW,EAAE,2DAA2D;YACxE,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC1E,MAAM,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE;YAC5C,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;SAC3D,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,UAAU,IAAI,CAAC,CAAC;IACzF,CAAC"}

package/dist/commands/integration-layer/config/unset.d.ts

@@ -0,0 +1,9 @@
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ConfigUnset extends IntegrationLayerCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/integration-layer/config/unset.js

@@ -0,0 +1,18 @@
+import { Args } from "@oclif/core";
+import { patchConfig } from "../../../lib/ilClient.js";
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ConfigUnset extends IntegrationLayerCommand {
+    static description = "Remove an extension config entry";
+    static examples = ["<%= config.bin %> integration-layer config unset ALGOLIA_APP_ID"];
+    static args = {
+        key: Args.string({ description: "the config entry key", required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ConfigUnset);
+        const { baseUrl, projectKey, token } = await this.resolveIlContext(flags);
+        // A PATCH entry with `value: null` deletes that key (integration layer contract).
+        await patchConfig(baseUrl, projectKey, token, [{ key: args.key, value: null }]);
+        this.log(`✓ removed '${args.key}' from '${projectKey}'.`);
+    }
+}
+//# sourceMappingURL=unset.js.map

package/dist/commands/integration-layer/config/unset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unset.js","sourceRoot":"","sources":["../../../../src/commands/integration-layer/config/unset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,uBAAuB;IAC9D,MAAM,CAAU,WAAW,GAAG,kCAAkC,CAAC;IAEjE,MAAM,CAAU,QAAQ,GAAG,CAAC,iEAAiE,CAAC,CAAC;IAE/F,MAAM,CAAU,IAAI,GAAG;QACrB,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KAC1E,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACtD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC1E,kFAAkF;QAClF,MAAM,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,GAAG,WAAW,UAAU,IAAI,CAAC,CAAC;IAC5D,CAAC"}

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

@@ -0,0 +1,12 @@
+import { Command } from "@oclif/core";
+export default class ExtensionBuild extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        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>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,40 @@
+import { Command, Flags } from "@oclif/core";
+import { defaultEntry, defaultOutfile } from "../../../lib/tooling/build.js";
+import { bundleForFlags } from "../../../lib/tooling/extensions.js";
+export default class ExtensionBuild extends Command {
+    static description = "Bundle src/extension.ts into a single self-contained CommonJS artifact";
+    static examples = [
+        "<%= config.bin %> integration-layer extension build",
+        "<%= config.bin %> integration-layer extension build --entry src/extension.ts --out dist/extension.js",
+        "<%= config.bin %> integration-layer extension build --all",
+    ];
+    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 (the single artifact a project deploys)",
+            default: false,
+        }),
+        "extensions-dir": Flags.string({
+            description: "directory holding the extension packages (used with --all)",
+            default: "extensions",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ExtensionBuild);
+        let built;
+        try {
+            built = await bundleForFlags({
+                all: flags.all,
+                extensionsDir: flags["extensions-dir"],
+                entry: flags.entry,
+                out: flags.out,
+            });
+        }
+        catch (err) {
+            this.error(err.message);
+        }
+        this.log(`✓ bundled ${built.describe} → ${built.outfile}`);
+    }
+}
+//# sourceMappingURL=build.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../../src/commands/integration-layer/extension/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,MAAM,CAAU,WAAW,GACzB,wEAAwE,CAAC;IAE3E,MAAM,CAAU,QAAQ,GAAG;QACzB,qDAAqD;QACrD,sGAAsG;QACtG,2DAA2D;KAC5D,CAAC;IAEF,MAAM,CAAU,KAAK,GAAG;QACtB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6BAA6B,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC;QAC5F,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC;QACnF,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;YACjB,WAAW,EACT,6GAA6G;YAC/G,OAAO,EAAE,KAAK;SACf,CAAC;QACF,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC;YAC7B,WAAW,EAAE,4DAA4D;YACzE,OAAO,EAAE,YAAY;SACtB,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACnD,IAAI,KAAK,CAAC;QACV,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,cAAc,CAAC;gBAC3B,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,aAAa,EAAE,KAAK,CAAC,gBAAgB,CAAC;gBACtC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,GAAG,EAAE,KAAK,CAAC,GAAG;aACf,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,QAAQ,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC"}

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

@@ -0,0 +1,9 @@
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ExtensionDelete extends IntegrationLayerCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,39 @@
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import { Flags } from "@oclif/core";
+import { deleteExtensionSubgraph } from "../../../lib/ilClient.js";
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+async function confirm(question) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        const answer = (await rl.question(`${question} `)).trim().toLowerCase();
+        return answer === "y" || answer === "yes";
+    }
+    finally {
+        rl.close();
+    }
+}
+export default class ExtensionDelete extends IntegrationLayerCommand {
+    static description = "Remove the extension subgraph from the project's published graph";
+    static examples = [
+        "<%= config.bin %> integration-layer extension delete",
+        "<%= config.bin %> integration-layer extension delete --yes",
+    ];
+    static flags = {
+        yes: Flags.boolean({ char: "y", description: "skip the confirmation prompt", default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(ExtensionDelete);
+        const { baseUrl, projectKey, token } = await this.resolveIlContext(flags);
+        if (!flags.yes) {
+            const confirmed = await confirm(`Remove the extension subgraph for '${projectKey}' from the published graph? (y/N)`);
+            if (!confirmed) {
+                this.log("Aborted.");
+                return;
+            }
+        }
+        await deleteExtensionSubgraph(baseUrl, projectKey, token);
+        this.log(`✓ removed the extension subgraph for '${projectKey}'.`);
+    }
+}
+//# sourceMappingURL=delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../../src/commands/integration-layer/extension/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,KAAK,UAAU,OAAO,CAAC,QAAgB;IACrC,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACxE,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,KAAK,CAAC;IAC5C,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,uBAAuB;IAClE,MAAM,CAAU,WAAW,GAAG,kEAAkE,CAAC;IAEjG,MAAM,CAAU,QAAQ,GAAG;QACzB,sDAAsD;QACtD,4DAA4D;KAC7D,CAAC;IAEF,MAAM,CAAU,KAAK,GAAG;QACtB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,8BAA8B,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KAC/F,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACpD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAE1E,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,MAAM,OAAO,CAC7B,sCAAsC,UAAU,mCAAmC,CACpF,CAAC;YACF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;QACH,CAAC;QAED,MAAM,uBAAuB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG,CAAC,yCAAyC,UAAU,IAAI,CAAC,CAAC;IACpE,CAAC"}

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

@@ -0,0 +1,13 @@
+import { Command } from "@oclif/core";
+export default class ExtensionInvoke extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        entry: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        out: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        action: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        sku: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,89 @@
+import { readFile } from "node:fs/promises";
+import { Command, Flags } from "@oclif/core";
+import { buildBundle, defaultEntry, defaultOutfile } from "../../../lib/tooling/build.js";
+import { loadBundleSource } from "../../../lib/tooling/loadBundle.js";
+/** A sample commercetools cart callback payload. */
+function sampleCartInput(action, sku) {
+    // A minimal sample callback for local testing. The real payload is the SDK's
+    // ExtensionInput (resource: a full Cart Reference); we send just the fields a
+    // cart handler reads, cast to the SDK type.
+    return {
+        action,
+        resource: {
+            typeId: "cart",
+            id: "sample-cart",
+            obj: {
+                id: "sample-cart",
+                lineItems: [{ id: "sample-line-item", quantity: 1, variant: { sku } }],
+            },
+        },
+    };
+}
+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 ExtensionInvoke extends Command {
+    static description = "Fire a sample commercetools cart callback at the bundle's API-Extension handlers";
+    static examples = [
+        "<%= config.bin %> integration-layer extension invoke",
+        "<%= config.bin %> integration-layer extension invoke --action Update --sku BLOCKED-SKU",
+        "<%= config.bin %> integration-layer extension invoke --config MAX_QTY=5 --config REGION=eu",
+    ];
+    static flags = {
+        entry: Flags.string({ description: "extension entry source file", default: defaultEntry() }),
+        out: Flags.string({ description: "bundle output file", default: defaultOutfile() }),
+        action: Flags.string({
+            description: "the trigger action",
+            options: ["Create", "Update"],
+            default: "Create",
+        }),
+        sku: Flags.string({
+            description: "SKU on the sample cart's line item",
+            default: "BLOCKED-SKU",
+        }),
+        config: Flags.string({
+            description: "a ctx.config entry as KEY=VALUE (repeatable)",
+            multiple: true,
+            delimiter: ",",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ExtensionInvoke);
+        const config = {};
+        for (const pair of flags.config ?? []) {
+            const eq = pair.indexOf("=");
+            if (eq > 0)
+                config[pair.slice(0, eq)] = pair.slice(eq + 1);
+        }
+        const { outfile } = await buildBundle(flags.entry, flags.out);
+        const mod = loadBundleSource(await readFile(outfile, "utf8"));
+        const handlers = Array.isArray(mod.apiExtensions)
+            ? mod.apiExtensions
+            : [];
+        if (handlers.length === 0) {
+            this.error("this bundle declares no `apiExtensions`.");
+        }
+        const action = flags.action;
+        const input = sampleCartInput(action, flags.sku);
+        const ctx = { now: () => Date.now(), config };
+        this.log(`Invoking ${handlers.length} handler(s) with a ${input.action} on cart ` +
+            `(line item SKU '${flags.sku}')`);
+        for (const h of handlers) {
+            if (h.resourceTypeId !== input.resource.typeId || !h.actions.includes(action)) {
+                this.log(`  · ${h.key}: skipped (does not trigger on cart/${action})`);
+                continue;
+            }
+            const result = await h.handler(input, ctx);
+            this.log(`  → ${h.key}: ${describeResult(result)}`);
+        }
+    }
+}
+//# sourceMappingURL=invoke.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../../../src/commands/integration-layer/extension/invoke.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAQtE,oDAAoD;AACpD,SAAS,eAAe,CAAC,MAA0B,EAAE,GAAW;IAC9D,6EAA6E;IAC7E,8EAA8E;IAC9E,4CAA4C;IAC5C,OAAO;QACL,MAAM;QACN,QAAQ,EAAE;YACR,MAAM,EAAE,MAAM;YACd,EAAE,EAAE,aAAa;YACjB,GAAG,EAAE;gBACH,EAAE,EAAE,aAAa;gBACjB,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC;aACvE;SACF;KAC8B,CAAC;AACpC,CAAC;AAED,SAAS,cAAc,CAAC,MAA0B;IAChD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7D,OAAO,WAAW,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrF,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,OAAO,YAAY,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,MAAM,CAAU,WAAW,GACzB,kFAAkF,CAAC;IAErF,MAAM,CAAU,QAAQ,GAAG;QACzB,sDAAsD;QACtD,wFAAwF;QACxF,4FAA4F;KAC7F,CAAC;IAEF,MAAM,CAAU,KAAK,GAAG;QACtB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6BAA6B,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC;QAC5F,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC;QACnF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,oBAAoB;YACjC,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;YAC7B,OAAO,EAAE,QAAQ;SAClB,CAAC;QACF,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,oCAAoC;YACjD,OAAO,EAAE,aAAa;SACvB,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,8CAA8C;YAC3D,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,GAAG;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAEpD,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,EAAE,GAAG,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAgC,CAAC;QAC7F,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;YAC/C,CAAC,CAAE,GAAG,CAAC,aAA0C;YACjD,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAA4B,CAAC;QAClD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG,CACN,YAAY,QAAQ,CAAC,MAAM,sBAAsB,KAAK,CAAC,MAAM,WAAW;YACtE,mBAAmB,KAAK,CAAC,GAAG,IAAI,CACnC,CAAC;QAEF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,cAAc,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9E,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,uCAAuC,MAAM,GAAG,CAAC,CAAC;gBACvE,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC3C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC"}

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

@@ -0,0 +1,28 @@
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ExtensionPush extends IntegrationLayerCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        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>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "source-revision": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "no-source-revision": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        wait: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "wait-timeout": import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * 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.
+     */
+    private reportOutcome;
+    /** True when the remote result should abort the push. */
+    private reportRemote;
+    run(): Promise<void>;
+}