@sitecoreai-labs/sitecoreai-cli 0.0.4 → 0.1.0

package/dist/deploy/tasks/shared.js

@@ -1,67 +1,45 @@
 "use strict";
 /**
- * Helpers specific to `scai deploy` task runners — env-context
- * resolution against the Deploy API, JSON-aware result printing,
- * project/environment/org lookup. Neutral helpers (`toLogger`,
- * `selectMatch`, `confirmDestructive`, etc.) live in
- * `@/shared/cli-tasks`; serialization-specific helpers live in
- * `@/serialization/tasks/shared`.
+ * CLI presentation helpers for `scai provision deploy` task runners —
+ * JSON-aware result printing.
+ *
+ * Env-context resolution and project / environment / organization
+ * lookup moved to `@/deploy/context` (presentation-free, barrel-
+ * exported); this file re-exports them so the runners keep their
+ * `./shared` import surface. Neutral helpers (`toLogger`, `selectMatch`,
+ * `confirmDestructive`, etc.) live in `@/shared/cli-tasks`.
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveProjectIdValue = exports.resolveTenantTypeValue = exports.resolveEnvironmentType = exports.resolveDeployEnvironmentId = exports.resolveDeployProjectId = exports.filterEnvironmentsByType = exports.getEnvironmentType = exports.extractDeployEnvironmentList = exports.printDeployWhatIf = exports.printDeployResultWithContext = exports.printDeployResult = exports.resolveDeployOrganizationId = exports.getDeployContext = exports.resolveApiTimeoutMs = exports.selectFromList = exports.selectMatch = exports.confirmDestructive = exports.inputError = exports.applyIfDefined = exports.toLogger = void 0;
-const errors_1 = require("../../shared/errors");
-const keychain_1 = require("../../shared/keychain");
-const cli_tasks_1 = require("../../shared/cli-tasks");
-const env_1 = require("../../shared/env");
-const api_1 = require("../../deploy/api");
+exports.printDeployWhatIf = exports.printDeployResultWithContext = exports.printDeployResult = exports.resolveApiTimeoutMs = exports.selectFromList = exports.selectMatch = exports.confirmDestructive = exports.inputError = exports.applyIfDefined = exports.toLogger = void 0;
+const envelope_1 = require("../../shared/envelope");
 // Re-export neutral helpers so deploy task runners can keep using
 // the local `./shared` import surface; new code can also import
 // these directly from `@/shared/cli-tasks`.
-var cli_tasks_2 = require("../../shared/cli-tasks");
-Object.defineProperty(exports, "toLogger", { enumerable: true, get: function () { return cli_tasks_2.toLogger; } });
-Object.defineProperty(exports, "applyIfDefined", { enumerable: true, get: function () { return cli_tasks_2.applyIfDefined; } });
-Object.defineProperty(exports, "inputError", { enumerable: true, get: function () { return cli_tasks_2.inputError; } });
-Object.defineProperty(exports, "confirmDestructive", { enumerable: true, get: function () { return cli_tasks_2.confirmDestructive; } });
-Object.defineProperty(exports, "selectMatch", { enumerable: true, get: function () { return cli_tasks_2.selectMatch; } });
-Object.defineProperty(exports, "selectFromList", { enumerable: true, get: function () { return cli_tasks_2.selectFromList; } });
-Object.defineProperty(exports, "resolveApiTimeoutMs", { enumerable: true, get: function () { return cli_tasks_2.resolveApiTimeoutMs; } });
-const getDeployContext = async (options) => {
-    const { envName, environment } = (0, env_1.resolveEnvironment)(options);
-    const token = (await (0, keychain_1.getDeployToken)(envName)) ?? environment.deployToken;
-    if (!token) {
-        throw (0, errors_1.createCliError)(`Deploy token not found for environment '${envName}'.`, "AUTH_REQUIRED", {
-            hint: "Run 'scai init' or 'scai login' to authenticate.",
-        });
-    }
-    return {
-        token,
-        baseUrl: undefined,
-        envName,
-        organizationId: environment.organizationId,
-        projectId: environment.projectId,
-        environmentId: environment.environmentId,
-        environmentType: environment.environmentType,
-        editingHostEnvironmentIds: environment.editingHostEnvironmentIds,
-        whatIf: options.whatIf,
-    };
-};
-exports.getDeployContext = getDeployContext;
-const resolveDeployOrganizationId = async (context) => {
-    if (context.organizationId) {
-        return context.organizationId;
-    }
-    try {
-        const organization = await (0, api_1.fetchOrganization)({
-            accessToken: context.token,
-            baseUrl: context.baseUrl,
-        });
-        return organization.id ?? organization.organizationId;
-    }
-    catch {
-        return undefined;
-    }
-};
-exports.resolveDeployOrganizationId = resolveDeployOrganizationId;
+var cli_tasks_1 = require("../../shared/cli-tasks");
+Object.defineProperty(exports, "toLogger", { enumerable: true, get: function () { return cli_tasks_1.toLogger; } });
+Object.defineProperty(exports, "applyIfDefined", { enumerable: true, get: function () { return cli_tasks_1.applyIfDefined; } });
+Object.defineProperty(exports, "inputError", { enumerable: true, get: function () { return cli_tasks_1.inputError; } });
+Object.defineProperty(exports, "confirmDestructive", { enumerable: true, get: function () { return cli_tasks_1.confirmDestructive; } });
+Object.defineProperty(exports, "selectMatch", { enumerable: true, get: function () { return cli_tasks_1.selectMatch; } });
+Object.defineProperty(exports, "selectFromList", { enumerable: true, get: function () { return cli_tasks_1.selectFromList; } });
+Object.defineProperty(exports, "resolveApiTimeoutMs", { enumerable: true, get: function () { return cli_tasks_1.resolveApiTimeoutMs; } });
+// Re-export the presentation-free deploy context + lookup helpers so the
+// runners keep their `./shared` import surface.
+__exportStar(require("../../deploy/context"), exports);
 const printDeployResult = (logger, data) => {
     if (data === undefined || data === null || data === "") {
         logger.info("Request succeeded (empty response).", "green");
@@ -81,12 +59,12 @@ const printDeployResult = (logger, data) => {
 exports.printDeployResult = printDeployResult;
 const printDeployResultWithContext = (logger, context, command, result, extra = {}) => {
     if (logger.isJson()) {
-        logger.json({
-            command,
-            environment: context.envName ?? null,
-            ...extra,
-            result,
-        });
+        // `extra` keys overlapping with canonical envelope fields
+        // (totalCount, pageSize, whatIf, etc.) are hoisted to envelope-
+        // level; anything else lands under `meta`. Keeps the top-level
+        // namespace clean while preserving the caller's ability to attach
+        // pagination metadata without nesting it under `data`.
+        logger.json((0, envelope_1.buildScaiEnvelope)({ command, environment: context.envName, data: result, extra }));
         return;
     }
     (0, exports.printDeployResult)(logger, result);
@@ -94,168 +72,14 @@ const printDeployResultWithContext = (logger, context, command, result, extra =
 exports.printDeployResultWithContext = printDeployResultWithContext;
 const printDeployWhatIf = (logger, context, command, request) => {
     if (logger.isJson()) {
-        logger.json({
+        logger.json((0, envelope_1.buildScaiEnvelope)({
             command,
-            environment: context.envName ?? null,
-            whatIf: true,
-            request,
-        });
+            environment: context.envName,
+            data: request,
+            extra: { whatIf: true },
+        }));
         return;
     }
     (0, exports.printDeployResult)(logger, { whatIf: true, request });
 };
 exports.printDeployWhatIf = printDeployWhatIf;
-const extractDeployEnvironmentList = (result) => {
-    if (Array.isArray(result)) {
-        return result;
-    }
-    if (result && typeof result === "object") {
-        const record = result;
-        const items = record.items ?? record.data ?? record.environments;
-        if (Array.isArray(items)) {
-            return items;
-        }
-    }
-    return [];
-};
-exports.extractDeployEnvironmentList = extractDeployEnvironmentList;
-const getEnvironmentType = (environment) => {
-    const record = environment;
-    const candidates = [
-        record.projectType,
-        record.projectTypeName,
-        record.environmentType,
-        record.type,
-    ];
-    for (const candidate of candidates) {
-        if (typeof candidate === "string") {
-            return candidate;
-        }
-    }
-    const project = record.project;
-    if (project && typeof project === "object") {
-        const projectRecord = project;
-        const projectCandidates = [
-            projectRecord.projectType,
-            projectRecord.projectTypeName,
-            projectRecord.environmentType,
-            projectRecord.type,
-        ];
-        for (const candidate of projectCandidates) {
-            if (typeof candidate === "string") {
-                return candidate;
-            }
-        }
-    }
-    return undefined;
-};
-exports.getEnvironmentType = getEnvironmentType;
-const filterEnvironmentsByType = (environments, type) => {
-    if (!type) {
-        return environments;
-    }
-    const normalized = type.toLowerCase();
-    let sawType = false;
-    const filtered = environments.filter((environment) => {
-        const envType = (0, exports.getEnvironmentType)(environment);
-        if (!envType) {
-            return false;
-        }
-        sawType = true;
-        return envType.toLowerCase().includes(normalized);
-    });
-    return sawType ? filtered : environments;
-};
-exports.filterEnvironmentsByType = filterEnvironmentsByType;
-const resolveDeployProjectId = async (context, options) => {
-    const selection = options.project;
-    if (!selection) {
-        return undefined;
-    }
-    if (context.whatIf) {
-        return selection;
-    }
-    const projects = await (0, api_1.fetchProjects)({
-        accessToken: context.token,
-        baseUrl: context.baseUrl,
-    });
-    const project = (0, cli_tasks_1.selectMatch)(projects, "Project", selection);
-    return project.id ?? project.projectId;
-};
-exports.resolveDeployProjectId = resolveDeployProjectId;
-const resolveDeployEnvironmentId = async (context, options) => {
-    const selection = options.id ?? options.name;
-    if (context.whatIf) {
-        if (selection) {
-            return selection;
-        }
-        if (context.environmentId) {
-            return context.environmentId;
-        }
-        throw (0, errors_1.createCliError)("Environment ID is required for --what-if. Use --id.", "INPUT_INVALID", {
-            hint: "Provide an explicit environment ID to avoid lookup calls.",
-        });
-    }
-    if (!selection) {
-        if (context.environmentId) {
-            return context.environmentId;
-        }
-        const envHint = context.envName ? ` for --environment-name '${context.envName}'` : "";
-        throw (0, cli_tasks_1.inputError)(`Environment name or ID is required. Use --name/--id, or run init to store an environmentId${envHint}.`);
-    }
-    const projectId = await (0, exports.resolveDeployProjectId)(context, options);
-    if (projectId) {
-        const environments = await (0, api_1.fetchProjectEnvironments)({ accessToken: context.token, baseUrl: context.baseUrl }, projectId);
-        const environment = (0, cli_tasks_1.selectMatch)(environments, "Environment", selection);
-        const environmentId = environment.id ?? environment.environmentId;
-        if (!environmentId) {
-            throw (0, cli_tasks_1.inputError)("Environment ID was not available.");
-        }
-        return environmentId;
-    }
-    const listResult = await (0, api_1.fetchEnvironments)({ accessToken: context.token, baseUrl: context.baseUrl }, {});
-    const list = listResult.items ??
-        listResult.data ??
-        (Array.isArray(listResult) ? listResult : []);
-    const environment = (0, cli_tasks_1.selectMatch)(list, "Environment", selection);
-    const environmentId = environment.id ?? environment.environmentId;
-    if (!environmentId) {
-        throw (0, cli_tasks_1.inputError)("Environment ID was not available.");
-    }
-    return environmentId;
-};
-exports.resolveDeployEnvironmentId = resolveDeployEnvironmentId;
-const resolveEnvironmentType = (value) => {
-    if (!value || typeof value !== "object") {
-        return undefined;
-    }
-    const record = value;
-    const type = record.type ?? record.environmentType ?? record.envType;
-    return typeof type === "string" ? type.toLowerCase() : undefined;
-};
-exports.resolveEnvironmentType = resolveEnvironmentType;
-const resolveTenantTypeValue = (value) => {
-    if (typeof value === "number") {
-        return value;
-    }
-    if (typeof value === "string") {
-        const normalized = value.trim().toLowerCase();
-        if (normalized === "prod" || normalized === "production") {
-            return 1;
-        }
-        if (normalized === "nonprod" ||
-            normalized === "non-production" ||
-            normalized === "nonproduction") {
-            return 0;
-        }
-    }
-    return undefined;
-};
-exports.resolveTenantTypeValue = resolveTenantTypeValue;
-const resolveProjectIdValue = (value) => {
-    if (typeof value === "string" && value.trim().length > 0) {
-        return value;
-    }
-    return undefined;
-};
-exports.resolveProjectIdValue = resolveProjectIdValue;

package/dist/deploy/tasks/site-bind.d.ts

@@ -1,5 +1,5 @@
 /**
- * `scai deploy site bind` runner.
+ * `scai provision deploy site bind` runner.
  *
  * Populates the SXA Site Grouping fields the Cloud Portal Pages /
  * Channels app requires for a site to surface — `HostName`,
@@ -18,4 +18,3 @@
  */
 import type { DeploySiteBindOptions } from "./types";
 export declare const runDeploySiteBind: (options: DeploySiteBindOptions) => Promise<void>;
-//# sourceMappingURL=site-bind.d.ts.map

package/dist/deploy/tasks/site-bind.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * `scai deploy site bind` runner.
+ * `scai provision deploy site bind` runner.
  *
  * Populates the SXA Site Grouping fields the Cloud Portal Pages /
  * Channels app requires for a site to surface — `HostName`,
@@ -21,24 +21,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runDeploySiteBind = void 0;
 const authoring_client_1 = require("../../recipe/api/authoring-client");
 const errors_1 = require("../../shared/errors");
-const env_1 = require("../../shared/env");
+const environment_1 = require("../../policy/environment");
 const shared_1 = require("./shared");
 const runDeploySiteBind = async (options) => {
     const logger = (0, shared_1.toLogger)(options);
     if (!options.siteName) {
-        throw (0, errors_1.createCliError)("Site name is required.", "INPUT_INVALID", {
+        throw (0, errors_1.createScaiError)("Site name is required.", "INPUT_INVALID", {
             hint: "Pass --site-name (e.g. `e2e`).",
         });
     }
     if (!options.siteCollection) {
-        throw (0, errors_1.createCliError)("Site collection is required.", "INPUT_INVALID", {
+        throw (0, errors_1.createScaiError)("Site collection is required.", "INPUT_INVALID", {
             hint: "Pass --site-collection (the Headless Tenant the site lives under).",
         });
     }
     const renderingHostName = options.renderingHostName ?? options.siteName;
     const startItemName = options.startItemName ?? "Home";
     const hostNamePattern = options.hostNamePattern ?? "*";
-    const { envName, environment, timeoutMs } = (0, env_1.resolveEnvironment)(options);
+    const { envName, environment, timeoutMs } = (0, environment_1.resolveEnvironment)(options);
     const client = (0, authoring_client_1.createAuthoringClient)({
         environment,
         request: timeoutMs ? { timeoutMs } : undefined,
@@ -48,7 +48,7 @@ const runDeploySiteBind = async (options) => {
     const startItemPath = `${siteRoot}/${startItemName}`;
     const siteGrouping = await client.getItem({ path: siteGroupingPath });
     if (!siteGrouping) {
-        throw (0, errors_1.createCliError)(`Site Grouping item '${siteGroupingPath}' was not found.`, "INPUT_INVALID", {
+        throw (0, errors_1.createScaiError)(`Site Grouping item '${siteGroupingPath}' was not found.`, "INPUT_INVALID", {
             hint: "Verify --site-name and --site-collection point at an existing SXA Headless Site. The Site Grouping item lives under the site's `Settings/Site Grouping/<siteName>` path.",
         });
     }
@@ -84,7 +84,7 @@ const runDeploySiteBind = async (options) => {
     }
     const startItem = await client.getItem({ path: startItemPath });
     if (!startItem) {
-        throw (0, errors_1.createCliError)(`Start item '${startItemPath}' was not found.`, "INPUT_INVALID", {
+        throw (0, errors_1.createScaiError)(`Start item '${startItemPath}' was not found.`, "INPUT_INVALID", {
             hint: `Create a '${startItemName}' page under ${siteRoot} (or pass --start-item-name to point at the page that already exists). Without a Start Item the site won't render.`,
         });
     }

package/dist/deploy/tasks/site.d.ts

@@ -1,5 +1,5 @@
 /**
- * `scai deploy site list` runner.
+ * `scai provision deploy site list` runner.
  *
  * Discovers SXA sites in a Sitecore CM environment via the Authoring
  * GraphQL API. Sibling of `editing-host list`, but where editing hosts
@@ -7,8 +7,7 @@
  * tree — so this command resolves env config the same way `scai
  * recipe push` does (via `resolveTenant`-style lookup) rather than
  * `getDeployContext`. Both flows authenticate against the same
- * env profile written by `scai login`.
+ * env profile written by `scai setup login`.
  */
 import type { DeploySiteListOptions } from "./types";
 export declare const runDeploySiteList: (options: DeploySiteListOptions) => Promise<void>;
-//# sourceMappingURL=site.d.ts.map

package/dist/deploy/tasks/site.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * `scai deploy site list` runner.
+ * `scai provision deploy site list` runner.
  *
  * Discovers SXA sites in a Sitecore CM environment via the Authoring
  * GraphQL API. Sibling of `editing-host list`, but where editing hosts
@@ -8,16 +8,16 @@
  * tree — so this command resolves env config the same way `scai
  * recipe push` does (via `resolveTenant`-style lookup) rather than
  * `getDeployContext`. Both flows authenticate against the same
- * env profile written by `scai login`.
+ * env profile written by `scai setup login`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runDeploySiteList = void 0;
 const site_discovery_1 = require("../../recipe/api/site-discovery");
-const env_1 = require("../../shared/env");
+const environment_1 = require("../../policy/environment");
 const shared_1 = require("./shared");
 const runDeploySiteList = async (options) => {
     const logger = (0, shared_1.toLogger)(options);
-    const { envName, environment } = (0, env_1.resolveEnvironment)(options);
+    const { envName, environment } = (0, environment_1.resolveEnvironment)(options);
     const sites = await (0, site_discovery_1.discoverSites)(environment, {
         includeHostnames: Boolean(options.hostnames),
         contentRoot: options.contentRoot,

package/dist/deploy/tasks/source-control.d.ts

@@ -11,4 +11,3 @@ export declare const runDeploySourceControlRepositoryCreateFromTemplate: (option
 export declare const runDeploySourceControlProviders: (options: DeploySourceControlTemplatesOptions) => Promise<void>;
 export declare const runDeploySourceControlGet: (options: DeploySourceControlOptions) => Promise<void>;
 export declare const runDeploySourceControlDelete: (options: DeploySourceControlOptions) => Promise<void>;
-//# sourceMappingURL=source-control.d.ts.map

package/dist/deploy/tasks/source-control.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runDeploySourceControlDelete = exports.runDeploySourceControlGet = exports.runDeploySourceControlProviders = exports.runDeploySourceControlRepositoryCreateFromTemplate = exports.runDeploySourceControlRepositoryValidate = exports.runDeploySourceControlTemplates = exports.runDeploySourceControlRepositoryBranches = exports.runDeploySourceControlRepositoryGet = exports.runDeploySourceControlValidate = exports.runDeploySourceControlAccessToken = exports.runDeploySourceControlState = exports.runDeploySourceControlList = void 0;
-const api_1 = require("../../deploy/api");
+const source_control_1 = require("../../deploy/api/source-control");
 const shared_1 = require("./shared");
 const runDeploySourceControlList = async (options) => {
     const logger = (0, shared_1.toLogger)(options);
     const context = await (0, shared_1.getDeployContext)(options);
-    const result = await (0, api_1.fetchSourceControlIntegrations)({
+    const result = await (0, source_control_1.fetchSourceControlIntegrations)({
         accessToken: context.token,
         baseUrl: context.baseUrl,
     });
@@ -16,7 +16,7 @@ exports.runDeploySourceControlList = runDeploySourceControlList;
 const runDeploySourceControlState = async (options) => {
     const logger = (0, shared_1.toLogger)(options);
     const context = await (0, shared_1.getDeployContext)(options);
-    const result = await (0, api_1.fetchSourceControlIntegrationState)({
+    const result = await (0, source_control_1.fetchSourceControlIntegrationState)({
         accessToken: context.token,
         baseUrl: context.baseUrl,
     });
@@ -29,7 +29,7 @@ const runDeploySourceControlAccessToken = async (options) => {
     if (!options.id) {
         throw (0, shared_1.inputError)("Source control integration ID is required. Use --id.");
     }
-    const result = await (0, api_1.fetchSourceControlAccessToken)({ accessToken: context.token, baseUrl: context.baseUrl }, options.id);
+    const result = await (0, source_control_1.fetchSourceControlAccessToken)({ accessToken: context.token, baseUrl: context.baseUrl }, options.id);
     (0, shared_1.printDeployResultWithContext)(logger, context, "deploy.source-control.access-token", result);
 };
 exports.runDeploySourceControlAccessToken = runDeploySourceControlAccessToken;
@@ -40,7 +40,7 @@ const runDeploySourceControlValidate = async (options) => {
     if (!integrationId) {
         throw (0, shared_1.inputError)("Source control integration ID is required. Use --id.");
     }
-    const result = await (0, api_1.validateSourceControlIntegration)({ accessToken: context.token, baseUrl: context.baseUrl }, {
+    const result = await (0, source_control_1.validateSourceControlIntegration)({ accessToken: context.token, baseUrl: context.baseUrl }, {
         integrationId,
     });
     (0, shared_1.printDeployResultWithContext)(logger, context, "deploy.source-control.validate", result);
@@ -52,7 +52,7 @@ const runDeploySourceControlRepositoryGet = async (options) => {
     if (!options.integrationId || !options.repositoryId) {
         throw (0, shared_1.inputError)("Integration ID and repository ID are required.");
     }
-    const result = await (0, api_1.fetchSourceControlRepository)({ accessToken: context.token, baseUrl: context.baseUrl }, {
+    const result = await (0, source_control_1.fetchSourceControlRepository)({ accessToken: context.token, baseUrl: context.baseUrl }, {
         IntegrationId: options.integrationId,
         RepositoryId: options.repositoryId,
     });
@@ -65,7 +65,7 @@ const runDeploySourceControlRepositoryBranches = async (options) => {
     if (!options.integrationId || !options.repositoryName) {
         throw (0, shared_1.inputError)("Integration ID and repository name are required.");
     }
-    const result = await (0, api_1.fetchSourceControlRepositoryBranches)({ accessToken: context.token, baseUrl: context.baseUrl }, options.repositoryName, {
+    const result = await (0, source_control_1.fetchSourceControlRepositoryBranches)({ accessToken: context.token, baseUrl: context.baseUrl }, options.repositoryName, {
         IntegrationId: options.integrationId,
     });
     (0, shared_1.printDeployResultWithContext)(logger, context, "deploy.source-control.repository.branches", result);
@@ -75,7 +75,7 @@ const runDeploySourceControlTemplates = async (options) => {
     const logger = (0, shared_1.toLogger)(options);
     const context = await (0, shared_1.getDeployContext)(options);
     const query = options.provider ? { provider: options.provider } : undefined;
-    const result = await (0, api_1.fetchSourceControlTemplates)({ accessToken: context.token, baseUrl: context.baseUrl }, query);
+    const result = await (0, source_control_1.fetchSourceControlTemplates)({ accessToken: context.token, baseUrl: context.baseUrl }, query);
     (0, shared_1.printDeployResultWithContext)(logger, context, "deploy.source-control.templates", result);
 };
 exports.runDeploySourceControlTemplates = runDeploySourceControlTemplates;
@@ -85,7 +85,7 @@ const runDeploySourceControlRepositoryValidate = async (options) => {
     if (!options.integrationId || !options.repositoryName) {
         throw (0, shared_1.inputError)("Integration ID and repository name are required.");
     }
-    const result = await (0, api_1.validateSourceControlRepository)({ accessToken: context.token, baseUrl: context.baseUrl }, {
+    const result = await (0, source_control_1.validateSourceControlRepository)({ accessToken: context.token, baseUrl: context.baseUrl }, {
         integrationId: options.integrationId,
         repositoryName: options.repositoryName,
     });
@@ -127,15 +127,15 @@ const runDeploySourceControlRepositoryCreateFromTemplate = async (options) => {
         return;
     }
     const result = options.provider.toLowerCase() === "github"
-        ? await (0, api_1.createSourceControlRepositoryGithub)({ accessToken: context.token, baseUrl: context.baseUrl }, input)
-        : await (0, api_1.createSourceControlRepository)({ accessToken: context.token, baseUrl: context.baseUrl }, input);
+        ? await (0, source_control_1.createSourceControlRepositoryGithub)({ accessToken: context.token, baseUrl: context.baseUrl }, input)
+        : await (0, source_control_1.createSourceControlRepository)({ accessToken: context.token, baseUrl: context.baseUrl }, input);
     (0, shared_1.printDeployResultWithContext)(logger, context, "deploy.source-control.repository.create", result);
 };
 exports.runDeploySourceControlRepositoryCreateFromTemplate = runDeploySourceControlRepositoryCreateFromTemplate;
 const runDeploySourceControlProviders = async (options) => {
     const logger = (0, shared_1.toLogger)(options);
     const context = await (0, shared_1.getDeployContext)(options);
-    const result = await (0, api_1.fetchSourceControlProviders)({
+    const result = await (0, source_control_1.fetchSourceControlProviders)({
         accessToken: context.token,
         baseUrl: context.baseUrl,
     });
@@ -149,7 +149,7 @@ const runDeploySourceControlGet = async (options) => {
     if (!id) {
         throw (0, shared_1.inputError)("Source control integration ID is required. Use --id.");
     }
-    const result = await (0, api_1.fetchSourceControlIntegration)({ accessToken: context.token, baseUrl: context.baseUrl }, id);
+    const result = await (0, source_control_1.fetchSourceControlIntegration)({ accessToken: context.token, baseUrl: context.baseUrl }, id);
     (0, shared_1.printDeployResultWithContext)(logger, context, "deploy.source-control.get", result);
 };
 exports.runDeploySourceControlGet = runDeploySourceControlGet;
@@ -167,7 +167,7 @@ const runDeploySourceControlDelete = async (options) => {
         });
         return;
     }
-    const result = await (0, api_1.deleteSourceControlIntegration)({ accessToken: context.token, baseUrl: context.baseUrl }, id);
+    const result = await (0, source_control_1.deleteSourceControlIntegration)({ accessToken: context.token, baseUrl: context.baseUrl }, id);
     (0, shared_1.printDeployResultWithContext)(logger, context, "deploy.source-control.delete", result);
 };
 exports.runDeploySourceControlDelete = runDeploySourceControlDelete;

package/dist/deploy/tasks/transport-spinner.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Install the CLI spinner + HTTP-trace listener on the Deploy
+ * transport. Idempotent — safe to call once per CLI invocation.
+ */
+export declare const installDeployTransportSpinner: () => void;

package/dist/deploy/tasks/transport-spinner.js

@@ -0,0 +1,118 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installDeployTransportSpinner = void 0;
+/**
+ * CLI spinner + trace presentation for the Deploy API transport.
+ *
+ * `deployRequest` (public `./deploy` surface) reports request lifecycle
+ * to an optional listener and stays silent on its own. The CLI installs
+ * this listener at startup: an `ora` spinner per request plus
+ * `SITECOREAI_TRACE_HTTP` trace lines, with SIGINT / SIGTERM / exit
+ * cleanup so a cancelled run never leaves a spinner spinning.
+ *
+ * `ora` is dynamically imported on first use, so it never enters the
+ * dependency graph of an SDK consumer that imports `./deploy` directly.
+ */
+const consola_1 = require("consola");
+const transport_events_1 = require("../../deploy/api/common/transport-events");
+const activeSpinners = new Set();
+let handlersInstalled = false;
+const installHandlers = () => {
+    if (handlersInstalled) {
+        return;
+    }
+    handlersInstalled = true;
+    const cleanup = () => {
+        for (const spinner of activeSpinners) {
+            try {
+                spinner.stop();
+            }
+            catch {
+                // ignore spinner cleanup failures
+            }
+        }
+        activeSpinners.clear();
+    };
+    process.on("SIGINT", cleanup);
+    process.on("SIGTERM", cleanup);
+    process.on("exit", cleanup);
+};
+const startSpinner = async (method, path, silent) => {
+    if (silent) {
+        return null;
+    }
+    if (!process.stdout.isTTY) {
+        return null;
+    }
+    if (process.env.SITECOREAI_QUIET === "1" || process.env.SITECOREAI_JSON === "1") {
+        return null;
+    }
+    const { default: ora } = await Promise.resolve().then(() => __importStar(require("ora")));
+    const spinner = ora({ text: `${method} ${path}` }).start();
+    const handle = {
+        succeed: () => {
+            spinner.succeed();
+            activeSpinners.delete(handle);
+        },
+        fail: () => {
+            spinner.fail();
+            activeSpinners.delete(handle);
+        },
+        stop: () => {
+            spinner.stop();
+            activeSpinners.delete(handle);
+        },
+    };
+    activeSpinners.add(handle);
+    installHandlers();
+    return { succeed: handle.succeed, fail: handle.fail };
+};
+let installed = false;
+/**
+ * Install the CLI spinner + HTTP-trace listener on the Deploy
+ * transport. Idempotent — safe to call once per CLI invocation.
+ */
+const installDeployTransportSpinner = () => {
+    if (installed) {
+        return;
+    }
+    installed = true;
+    (0, transport_events_1.setDeployTransportListener)({
+        onRequestStart: (method, path, silent) => startSpinner(method, path, silent),
+        onTrace: (message) => consola_1.consola.debug(message),
+    });
+};
+exports.installDeployTransportSpinner = installDeployTransportSpinner;