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

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

@@ -0,0 +1,320 @@
+// Local dev server for an extension — the inner loop the build/validate/push flow
+// lacks. It builds the bundle, loads it, serves an Apollo Federation v2 subgraph from
+// its `typeDefs` + `resolvers`, and esbuild watches the source so an edit hot-swaps
+// the served schema with no restart. The command wrapper is ours; the schema
+// composition / gateway / SDL-fetch building blocks are the copied low-level tooling
+// functions (compose.ts, gateway.ts, ilClient.fetchSubgraphSdl).
+//
+// Modes:
+//   serve              standalone: the extension subgraph at /graphql.
+//   serve --compose    + the merged schema (extension + integration layer) at /composed.
+//   serve --gateway    /graphql becomes an executable federated gateway over the
+//                       local extension + the deployed integration layer.
+// --compose/--gateway reach the integration layer, so they need the auth flags/env
+// (ilFlags); --gateway also mints an anonymous session for its calls.
+import { createServer } from "node:http";
+import { readFile } from "node:fs/promises";
+import process from "node:process";
+import { Flags } from "@oclif/core";
+import { parse } from "graphql";
+import { createYoga } from "graphql-yoga";
+import { useApolloFederation } from "@envelop/apollo-federation";
+import { buildSubgraphSchema } from "@apollo/subgraph";
+import { context as esbuildContext } from "esbuild";
+import { defaultEntry, defaultOutfile, HOST_PROVIDED_EXTERNALS } from "../../../lib/tooling/build.js";
+import { loadBundleSource } from "../../../lib/tooling/loadBundle.js";
+import { composeWithIntegrationLayer, } from "../../../lib/tooling/compose.js";
+import { makeGateway, mintAnonymousSession } from "../../../lib/tooling/gateway.js";
+import { fetchSubgraphSdl } from "../../../lib/ilClient.js";
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+/**
+ * Per-project config the runtime injects as `ctx.config`. Locally there is no
+ * integration layer to read it from, so it's sourced from `EXTENSION_CONFIG_<KEY>`
+ * env vars — e.g. `EXTENSION_CONFIG_ALGOLIA_API_KEY=…` becomes `ctx.config.ALGOLIA_API_KEY`.
+ */
+function devConfigFromEnv() {
+    const prefix = "EXTENSION_CONFIG_";
+    const config = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (key.startsWith(prefix) && typeof value === "string") {
+            config[key.slice(prefix.length)] = value;
+        }
+    }
+    return config;
+}
+function devContext() {
+    return { now: () => Date.now(), config: devConfigFromEnv() };
+}
+/**
+ * Build a federation subgraph schema from the loaded bundle, the same way the runtime
+ * does. Throws (with a clean message) if the bundle didn't export a `typeDefs` string
+ * + `resolvers` object — the same shape `validateBundle` checks.
+ */
+function buildSubgraph(mod) {
+    const { typeDefs, resolvers } = mod;
+    if (typeof typeDefs !== "string" || typeDefs.trim() === "") {
+        throw new Error("bundle must export a non-empty `typeDefs` string");
+    }
+    if (resolvers === null || typeof resolvers !== "object") {
+        throw new Error("bundle must export a `resolvers` object");
+    }
+    // `@apollo/subgraph` types `resolvers` as its internal `GraphQLResolverMap`; the
+    // bundle's exports are `unknown` (validated above), so cast through the function's
+    // own parameter type rather than reaching into its `dist/` internals.
+    const moduleArg = { typeDefs: parse(typeDefs), resolvers };
+    return { schema: buildSubgraphSchema(moduleArg), typeDefs };
+}
+export default class ExtensionServe extends IntegrationLayerCommand {
+    static description = "Run a local dev server for the extension (subgraph, or a composed/federated gateway)";
+    static examples = [
+        "<%= config.bin %> integration-layer extension serve",
+        "<%= config.bin %> integration-layer extension serve --compose",
+        "<%= config.bin %> integration-layer extension serve --gateway --port 4000",
+    ];
+    // Standalone serve needs no login; --compose/--gateway resolve the context lazily
+    // (and then require a logged-in principal) only when they actually reach the IL.
+    authorized = false;
+    static flags = {
+        port: Flags.integer({ char: "p", description: "port to listen on", default: 4000 }),
+        compose: Flags.boolean({
+            description: "also serve the merged (extension + integration layer) schema at /composed",
+            default: false,
+        }),
+        gateway: Flags.boolean({
+            description: "make /graphql an executable federated gateway over both subgraphs",
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ExtensionServe);
+        const entry = defaultEntry();
+        const outfile = defaultOutfile();
+        const port = flags.port;
+        // In gateway mode /graphql is the gateway, so the raw extension subgraph moves to
+        // an internal path the gateway reaches over HTTP. Otherwise /graphql is the subgraph.
+        const subgraphPath = flags.gateway ? "/_extension" : "/graphql";
+        const extensionUrl = `http://localhost:${port}${subgraphPath}`;
+        // --compose/--gateway fetch the integration-layer SDL once up front; --gateway
+        // also mints an anonymous session so its integration-layer calls authenticate.
+        const withIntegrationLayer = flags.compose || flags.gateway;
+        let integrationLayerSdl;
+        let integrationLayerGraphqlUrl = "";
+        let integrationLayerBearer;
+        if (withIntegrationLayer) {
+            const { baseUrl, projectKey, token } = await this.resolveIlContext(flags);
+            integrationLayerGraphqlUrl = `${baseUrl}/${encodeURIComponent(projectKey)}/graphql`;
+            this.log(`Fetching integration-layer subgraph SDL for '${projectKey}' from ${baseUrl} …`);
+            integrationLayerSdl = await fetchSubgraphSdl(baseUrl, projectKey, token);
+            if (flags.gateway) {
+                integrationLayerBearer = await mintAnonymousSession(baseUrl, projectKey);
+                this.log("Minted an anonymous session for the gateway.");
+            }
+        }
+        // Served-schema state, hot-swapped on each rebuild. The yoga factories/dispatcher
+        // below close over these, so a reload is picked up with no restart.
+        let subgraphSchema;
+        let composed;
+        // The gateway yoga handler + the supergraph it was built for. We only rebuild the
+        // (expensive) gateway when the supergraph SDL changes; a resolver-only edit is
+        // covered by the /_extension hot-reload alone. On a failed recompile we keep the
+        // last good gateway serving and log the errors.
+        let gatewayYoga;
+        let gatewaySupergraphSdl;
+        let apolloGateway;
+        const log = (m) => this.log(m);
+        const warn = (m) => {
+            this.logToStderr(m);
+        };
+        const ctx = await this.watchAndBuild(entry, outfile, async (built) => {
+            subgraphSchema = built.schema;
+            if (!withIntegrationLayer)
+                return;
+            composed = composeWithIntegrationLayer(integrationLayerSdl, built.typeDefs, {
+                integrationLayerUrl: integrationLayerGraphqlUrl,
+                extensionUrl,
+            });
+            if (!composed.ok) {
+                warn("✗ does not compose with the integration layer:");
+                for (const e of composed.errors)
+                    warn(`  - ${e}`);
+                return;
+            }
+            log(`✓ composes with the integration layer — full schema at http://localhost:${port}/composed`);
+            if (!flags.gateway)
+                return;
+            if (composed.supergraphSdl === gatewaySupergraphSdl) {
+                log("  (gateway plan unchanged — extension reloaded in place)");
+                return;
+            }
+            try {
+                const gw = await makeGateway({
+                    supergraphSdl: composed.supergraphSdl,
+                    integrationLayerBearer: integrationLayerBearer,
+                });
+                const prev = apolloGateway;
+                apolloGateway = gw;
+                gatewaySupergraphSdl = composed.supergraphSdl;
+                gatewayYoga = createYoga({
+                    plugins: [useApolloFederation({ gateway: gw })],
+                    graphqlEndpoint: "/graphql",
+                    landingPage: false,
+                });
+                log(`✓ gateway ready at http://localhost:${port}/graphql`);
+                if (prev)
+                    await prev.stop();
+            }
+            catch (err) {
+                warn(`✗ gateway build failed: ${err.message}`);
+            }
+        });
+        if (!subgraphSchema) {
+            await ctx.dispose();
+            this.error("initial build did not produce a valid subgraph (see errors above)");
+        }
+        if (withIntegrationLayer && !composed?.ok) {
+            warn(flags.gateway
+                ? "⚠ extension does not compose with the integration layer yet — the gateway is " +
+                    "unavailable until it does; fix the errors above and save to recompose."
+                : "⚠ extension does not compose with the integration layer yet — serving the " +
+                    "standalone subgraph; fix the errors above and save to recompose.");
+        }
+        // The raw extension subgraph (executable). At /graphql normally, or the internal
+        // /_extension when the gateway owns /graphql.
+        const subgraphYoga = createYoga({
+            schema: () => subgraphSchema,
+            context: () => devContext(),
+            graphqlEndpoint: subgraphPath,
+            landingPage: false,
+        });
+        // The composed, client-facing merged schema — browsable/introspectable, not
+        // executable (no resolvers). Available in both --compose and --gateway.
+        const composedYoga = withIntegrationLayer
+            ? createYoga({
+                schema: () => {
+                    if (!composed?.ok) {
+                        throw new Error(`extension does not compose with the integration layer:\n${(composed?.errors ?? []).join("\n")}`);
+                    }
+                    return composed.apiSchema;
+                },
+                graphqlEndpoint: "/composed",
+                landingPage: false,
+            })
+            : undefined;
+        const server = createServer((req, res) => {
+            const path = (req.url ?? "").split("?")[0];
+            // Plain-text SDL endpoints (handy for `curl > schema.graphql`).
+            if (req.method === "GET" && (path === "/schema.graphql" || path === "/supergraph.graphql")) {
+                if (!composed?.ok) {
+                    res.statusCode = 503;
+                    res.setHeader("content-type", "text/plain");
+                    res.end(`extension does not compose with the integration layer:\n${(composed?.errors ?? []).join("\n")}\n`);
+                    return;
+                }
+                res.setHeader("content-type", "text/plain; charset=utf-8");
+                res.end(path === "/schema.graphql" ? composed.apiSdl : composed.supergraphSdl);
+                return;
+            }
+            if (composedYoga && path.startsWith("/composed"))
+                return void composedYoga(req, res);
+            if (flags.gateway && path.startsWith("/graphql")) {
+                if (!gatewayYoga) {
+                    const errs = composed && !composed.ok ? composed.errors : [];
+                    res.statusCode = 503;
+                    res.setHeader("content-type", "text/plain");
+                    res.end(`gateway not ready — extension does not compose with the integration layer:\n${errs.join("\n")}\n`);
+                    return;
+                }
+                return void gatewayYoga(req, res);
+            }
+            // /_extension (gateway) or /graphql (standalone/compose).
+            return void subgraphYoga(req, res);
+        });
+        await new Promise((resolve) => server.listen(port, resolve));
+        const base = `http://localhost:${port}`;
+        const lines = [`\n🔌 ${entry} live:`];
+        lines.push(flags.gateway
+            ? `   ${base}/graphql   — FEDERATED gateway (local extension + deployed integration layer)`
+            : `   ${base}/graphql   — extension subgraph`);
+        if (flags.gateway)
+            lines.push(`   ${base}/_extension — the raw extension subgraph (gateway routes to it)`);
+        if (withIntegrationLayer) {
+            lines.push(`   ${base}/composed  — full merged schema (browsable; not executable)`);
+            lines.push(`   ${base}/schema.graphql, ${base}/supergraph.graphql — SDL (text)`);
+        }
+        lines.push(`   open ${base}/graphql in a browser for GraphiQL`);
+        lines.push(`   watching ${entry} — edit and save to hot-reload\n`);
+        this.log(lines.join("\n"));
+        const shutdown = () => {
+            void ctx.dispose();
+            server.close(() => process.exit(0));
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+        // Keep the process alive; the server + esbuild watcher run until a signal.
+        await new Promise(() => { });
+    }
+    /**
+     * 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.
+     */
+    async watchAndBuild(entry, outfile, onBuild) {
+        const reload = async () => {
+            const source = await readFile(outfile, "utf8");
+            const mod = loadBundleSource(source);
+            await onBuild(buildSubgraph(mod));
+        };
+        let firstBuildDone;
+        const firstBuild = new Promise((resolve) => {
+            firstBuildDone = resolve;
+        });
+        let isFirstBuild = true;
+        const log = (m) => this.log(m);
+        const warn = (m) => this.logToStderr(m);
+        const ctx = await esbuildContext({
+            entryPoints: [entry],
+            outfile,
+            bundle: true,
+            format: "cjs",
+            platform: "neutral",
+            target: "node22",
+            conditions: ["worker"],
+            external: HOST_PROVIDED_EXTERNALS,
+            logLevel: "silent",
+            plugins: [
+                {
+                    name: "il-serve-reload",
+                    setup(build) {
+                        build.onEnd(async (result) => {
+                            try {
+                                if (result.errors.length > 0) {
+                                    warn("✗ build failed — fix the error and save again");
+                                    for (const e of result.errors)
+                                        warn(`  ${e.text}`);
+                                    return;
+                                }
+                                try {
+                                    await reload();
+                                    log(`✓ ${isFirstBuild ? "built" : "reloaded"} ${entry}`);
+                                }
+                                catch (err) {
+                                    warn(`✗ reload failed: ${err.message}`);
+                                }
+                            }
+                            finally {
+                                if (isFirstBuild) {
+                                    isFirstBuild = false;
+                                    firstBuildDone();
+                                }
+                            }
+                        });
+                    },
+                },
+            ],
+        });
+        await ctx.watch();
+        await firstBuild;
+        return ctx;
+    }
+}
+//# sourceMappingURL=serve.js.map

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

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

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

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

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

@@ -0,0 +1,24 @@
+import { fetchExtensionMeta } from "../../../lib/ilClient.js";
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ExtensionStatus extends IntegrationLayerCommand {
+    static description = "Show the project's stored extension bundle (version, size, …)";
+    static examples = ["<%= config.bin %> integration-layer extension status"];
+    async run() {
+        const { flags } = await this.parse(ExtensionStatus);
+        const { baseUrl, projectKey, token } = await this.resolveIlContext(flags);
+        const meta = await fetchExtensionMeta(baseUrl, projectKey, token);
+        if (!meta) {
+            this.log(`No extension bundle is stored for '${projectKey}'.`);
+            return;
+        }
+        this.log(`Stored extension for '${projectKey}':`);
+        this.log(`  version:    ${meta.version}`);
+        this.log(`  size:       ${meta.length} bytes`);
+        this.log(`  uploaded:   ${new Date(meta.uploadedAt).toISOString()}`);
+        if (meta.filename)
+            this.log(`  filename:   ${meta.filename}`);
+        if (meta.updatedBy)
+            this.log(`  updated by: ${meta.updatedBy}`);
+    }
+}
+//# sourceMappingURL=status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/commands/integration-layer/extension/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,uBAAuB;IAClE,MAAM,CAAU,WAAW,GAAG,+DAA+D,CAAC;IAE9F,MAAM,CAAU,QAAQ,GAAG,CAAC,sDAAsD,CAAC,CAAC;IAEpF,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;QAC1E,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,GAAG,CAAC,sCAAsC,UAAU,IAAI,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,yBAAyB,UAAU,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,MAAM,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACrE,IAAI,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC"}

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

@@ -0,0 +1,13 @@
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ExtensionValidate 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>;
+        skip: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /** Print a remote validation result legibly. Returns true when it passed. */
+    private reportRemote;
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,76 @@
+import { Flags } from "@oclif/core";
+import { buildBundle, defaultEntry, defaultOutfile } from "../../../lib/tooling/build.js";
+import { validateBundle, BundleValidationError } from "../../../lib/tooling/validateBundle.js";
+import { remoteValidate } from "../../../lib/ilClient.js";
+import { IntegrationLayerCommand } from "../../../lib/base.js";
+export default class ExtensionValidate extends IntegrationLayerCommand {
+    static description = "Build, run local checks, then compose against the project schema and gate breaking changes";
+    static examples = [
+        "<%= config.bin %> integration-layer extension validate",
+        "<%= config.bin %> integration-layer extension validate --skip remote",
+    ];
+    static flags = {
+        entry: Flags.string({ description: "extension entry source file", default: defaultEntry() }),
+        out: Flags.string({ description: "bundle output file", default: defaultOutfile() }),
+        skip: Flags.string({
+            description: "run only one half of the gate",
+            options: ["local", "remote"],
+        }),
+    };
+    /** Print a remote validation result legibly. Returns true when it passed. */
+    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}`);
+            return false;
+        }
+        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}`);
+            }
+            return false;
+        }
+        if (!result.comparedToPublished) {
+            this.log("✓ composes with the integration layer supergraph (breaking-change check skipped: no published baseline)");
+            return true;
+        }
+        this.log("✓ composes with the integration layer supergraph and introduces no breaking changes");
+        return true;
+    }
+    async run() {
+        const { flags } = await this.parse(ExtensionValidate);
+        const { outfile, sourceFiles } = await buildBundle(flags.entry, flags.out);
+        let typeDefs = null;
+        if (flags.skip !== "local") {
+            try {
+                const local = await validateBundle(outfile, sourceFiles);
+                typeDefs = local.typeDefs;
+                this.log(`✓ local checks passed (resolver roots: ${local.resolverTypes.join(", ") || "none"}; ` +
+                    `API extensions: ${local.apiExtensionKeys.join(", ") || "none"})`);
+            }
+            catch (err) {
+                if (err instanceof BundleValidationError)
+                    this.error(err.message);
+                throw err;
+            }
+        }
+        else {
+            // Skipping local: still need the SDL for the remote check — load it cheaply.
+            const local = await validateBundle(outfile, sourceFiles).catch(() => null);
+            typeDefs = local?.typeDefs ?? null;
+        }
+        if (flags.skip === "remote")
+            return;
+        if (typeDefs === null) {
+            this.log("· no GraphQL subgraph in this bundle — nothing to compose remotely.");
+            return;
+        }
+        const { baseUrl, projectKey, token } = await this.resolveIlContext(flags);
+        const result = await remoteValidate(baseUrl, projectKey, token, typeDefs);
+        if (!this.reportRemote(result))
+            this.error("remote validation failed.");
+    }
+}
+//# sourceMappingURL=validate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../../src/commands/integration-layer/extension/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/F,OAAO,EAAE,cAAc,EAA+B,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,uBAAuB;IACpE,MAAM,CAAU,WAAW,GACzB,4FAA4F,CAAC;IAE/F,MAAM,CAAU,QAAQ,GAAG;QACzB,wDAAwD;QACxD,sEAAsE;KACvE,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,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,+BAA+B;YAC5C,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;SAC7B,CAAC;KACH,CAAC;IAEF,6EAA6E;IACrE,YAAY,CAAC,MAA8B;QACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,CAAC,qEAAqE,CAAC,CAAC;YACxF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,iBAAiB;gBAAE,IAAI,CAAC,WAAW,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;YAC3E,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,WAAW,CAAC,sEAAsE,CAAC,CAAC;YACzF,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC5C,IAAI,CAAC,WAAW,CAAC,QAAQ,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAChC,IAAI,CAAC,GAAG,CACN,yGAAyG,CAC1G,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,qFAAqF,CAAC,CAAC;QAChG,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACtD,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAE3E,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBACzD,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;gBAC1B,IAAI,CAAC,GAAG,CACN,0CAA0C,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,IAAI;oBACpF,mBAAmB,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CACpE,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,qBAAqB;oBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAClE,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,6EAA6E;YAC7E,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAC3E,QAAQ,GAAG,KAAK,EAAE,QAAQ,IAAI,IAAI,CAAC;QACrC,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACpC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAC;YAChF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC1E,CAAC"}

package/dist/commands/integration-layer/hello.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "@oclif/core";
+export default class IntegrationLayerHelloCommand extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/integration-layer/hello.js

@@ -0,0 +1,10 @@
+import { Command } from "@oclif/core";
+export default class IntegrationLayerHelloCommand extends Command {
+    static description = "Print a hello world message from the integration-layer topic";
+    static examples = ["<%= config.bin %> integration-layer hello"];
+    async run() {
+        await this.parse(IntegrationLayerHelloCommand);
+        this.log("Hello, world!");
+    }
+}
+//# sourceMappingURL=hello.js.map

package/dist/commands/integration-layer/hello.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hello.js","sourceRoot":"","sources":["../../../src/commands/integration-layer/hello.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,OAAO,OAAO,4BAA6B,SAAQ,OAAO;IAC/D,MAAM,CAAU,WAAW,GAAG,8DAA8D,CAAC;IAE7F,MAAM,CAAU,QAAQ,GAAG,CAAC,2CAA2C,CAAC,CAAC;IAEzE,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC5B,CAAC"}

package/dist/commands/integration-layer/init.d.ts

@@ -0,0 +1,13 @@
+import { Command } from "@oclif/core";
+export default class Init extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        directory: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        template: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/integration-layer/init.js

@@ -0,0 +1,135 @@
+import { mkdir, readdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { Args, Command, Flags } from "@oclif/core";
+// The `basic` template is vendored inline (no network fetch) — a minimal, buildable
+// extension: a GraphQL subgraph field plus a commented API-Extension example. Keep it
+// dependency-light so `extension build`/`validate` work on it out of the box.
+const TEMPLATE_FILES = {
+    "src/extension.ts": `// A minimal integration-layer extension.
+//
+// Export a GraphQL subgraph (\`typeDefs\` + \`resolvers\`) to add fields to the graph,
+// and/or \`apiExtensions\` to run synchronous commercetools cart/order callbacks.
+// Build it with:  commercetools integration-layer extension build
+// Serve it with:  commercetools integration-layer extension serve
+
+export const typeDefs = /* GraphQL */ \`
+  type Query {
+    extensionInfo: String
+  }
+\`;
+
+export const resolvers = {
+  Query: {
+    extensionInfo: () => "hello from the integration-layer extension",
+  },
+};
+
+// // Example API Extension (uncomment to block a cart line item by SKU):
+// export const apiExtensions = [
+//   {
+//     key: "block-sku",
+//     resourceTypeId: "cart",
+//     actions: ["Create", "Update"],
+//     handler: (input, ctx) => {
+//       const blocked = ctx.config.BLOCKED_SKU ?? "BLOCKED-SKU";
+//       const items = input.resource.obj?.lineItems ?? [];
+//       if (items.some((li) => li.variant?.sku === blocked)) {
+//         return { errors: [{ code: "SkuBlocked", message: \\\`\\\${blocked} is not purchasable\\\` }] };
+//       }
+//       return {};
+//     },
+//   },
+// ];
+`,
+    "package.json": `{
+  "name": "integration-layer-extension",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "commercetools integration-layer extension build",
+    "serve": "commercetools integration-layer extension serve",
+    "push": "commercetools integration-layer extension push"
+  },
+  "devDependencies": {
+    "@commercetools/platform-sdk": "8.25.0",
+    "graphql": "^16.9.0",
+    "typescript": "^5.7.2"
+  }
+}
+`,
+    "tsconfig.json": `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*"]
+}
+`,
+    ".env.example": `# The authenticated commands (validate/push/status/delete, schema, config) reuse the
+# token from \`commercetools auth login\` (as a manage_project client) — no credentials
+# go here. Optionally override the integration-layer edge URL. Copy to .env.
+INTEGRATION_LAYER_URL=
+`,
+    ".gitignore": `node_modules/
+dist/
+.env
+`,
+    "README.md": `# integration-layer extension
+
+Scaffolded by \`commercetools integration-layer init\`.
+
+- \`commercetools integration-layer extension build\` — bundle \`src/extension.ts\`
+- \`commercetools integration-layer extension serve\` — local dev server
+- \`commercetools integration-layer extension push\` — validate + upload
+
+Run \`commercetools auth login\` first — the authenticated commands (push/validate/
+status/delete, schema, config) reuse that token. Optionally copy \`.env.example\` to
+\`.env\` to override the integration-layer edge URL.
+`,
+};
+export default class Init extends Command {
+    static description = "Scaffold an integration-layer extension project from a template";
+    static examples = [
+        "<%= config.bin %> integration-layer init my-extension",
+        "<%= config.bin %> integration-layer init my-extension --template basic",
+    ];
+    static args = {
+        directory: Args.string({ description: "directory to scaffold into", required: true }),
+    };
+    static flags = {
+        template: Flags.string({
+            description: "the template to use",
+            options: ["basic"],
+            default: "basic",
+        }),
+        force: Flags.boolean({
+            char: "f",
+            description: "scaffold into a non-empty directory",
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Init);
+        const dir = args.directory;
+        const existing = await readdir(dir).catch(() => []);
+        if (existing.length > 0 && !flags.force) {
+            this.error(`Directory '${dir}' is not empty. Pass --force to scaffold into it anyway.`);
+        }
+        for (const [relPath, contents] of Object.entries(TEMPLATE_FILES)) {
+            const target = join(dir, relPath);
+            await mkdir(join(target, ".."), { recursive: true });
+            await writeFile(target, contents, "utf8");
+        }
+        this.log(`✓ scaffolded a '${flags.template}' extension in ${dir}`);
+        this.log("Next steps:");
+        this.log(`  cd ${dir}`);
+        this.log("  npm install");
+        this.log("  commercetools integration-layer extension serve");
+    }
+}
+//# sourceMappingURL=init.js.map