@salesforce/b2c-tooling-sdk 1.4.0 → 1.6.0

package/dist/cjs/skills/sources.js

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+function pluginsTag(version) {
+    const bare = version.replace(/^v/, '');
+    return `b2c-agent-plugins@${bare}`;
+}
+export const SKILL_SOURCES = {
+    b2c: {
+        id: 'b2c',
+        displayName: 'B2C Commerce development patterns',
+        type: 'release-artifact',
+        repo: 'SalesforceCommerceCloud/b2c-developer-tooling',
+        assetName: 'b2c-skills.zip',
+        tagPattern: pluginsTag,
+    },
+    'b2c-cli': {
+        id: 'b2c-cli',
+        displayName: 'B2C CLI commands and operations',
+        type: 'release-artifact',
+        repo: 'SalesforceCommerceCloud/b2c-developer-tooling',
+        assetName: 'b2c-cli-skills.zip',
+        tagPattern: pluginsTag,
+    },
+    'cap-dev': {
+        id: 'cap-dev',
+        displayName: 'Commerce Apps development skills',
+        type: 'repo-contents',
+        repo: 'SalesforceCommerceCloud/commerce-apps',
+        ref: 'main',
+        skillsPath: '.claude/skills',
+    },
+};
+export function getSkillSource(skillSet) {
+    const source = SKILL_SOURCES[skillSet];
+    if (!source) {
+        throw new Error(`Unknown skill set: ${skillSet}`);
+    }
+    return source;
+}
+export const ALL_SKILL_SETS = Object.keys(SKILL_SOURCES);
+//# sourceMappingURL=sources.js.map

package/dist/cjs/skills/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../../src/skills/sources.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvC,OAAO,qBAAqB,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAwC;IAChE,GAAG,EAAE;QACH,EAAE,EAAE,KAAK;QACT,WAAW,EAAE,mCAAmC;QAChD,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,+CAA+C;QACrD,SAAS,EAAE,gBAAgB;QAC3B,UAAU,EAAE,UAAU;KACvB;IACD,SAAS,EAAE;QACT,EAAE,EAAE,SAAS;QACb,WAAW,EAAE,iCAAiC;QAC9C,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,+CAA+C;QACrD,SAAS,EAAE,oBAAoB;QAC/B,UAAU,EAAE,UAAU;KACvB;IACD,SAAS,EAAE;QACT,EAAE,EAAE,SAAS;QACb,WAAW,EAAE,kCAAkC;QAC/C,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,uCAAuC;QAC7C,GAAG,EAAE,MAAM;QACX,UAAU,EAAE,gBAAgB;KAC7B;CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,QAAkB;IAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAe,MAAM,CAAC,IAAI,CAAC,aAAa,CAAe,CAAC"}

package/dist/cjs/skills/types.d.ts

@@ -5,7 +5,20 @@ export type IdeType = 'claude-code' | 'cursor' | 'windsurf' | 'vscode' | 'codex'
 /**
  * Skill set categories matching the plugins directory structure.
  */
-export type SkillSet = 'b2c' | 'b2c-cli';
+export type SkillSet = 'b2c' | 'b2c-cli' | 'cap-dev';
+/**
+ * Configuration for a skill source — defines how to fetch skills from a particular repository.
+ */
+export interface SkillSourceConfig {
+    id: SkillSet;
+    displayName: string;
+    type: 'release-artifact' | 'repo-contents';
+    repo: string;
+    assetName?: string;
+    tagPattern?: (version: string) => string;
+    ref?: string;
+    skillsPath?: string;
+}
 /**
  * IDE path configuration for skill installation.
  */
@@ -133,4 +146,6 @@ export interface CachedArtifact {
     path: string;
     /** ISO date string when artifact was downloaded */
     downloadedAt: string;
+    /** For repo-contents sources: the resolved commit SHA */
+    commitSha?: string;
 }

package/dist/esm/cli/lifecycle.d.ts

@@ -4,7 +4,7 @@ import type { Logger } from '../logging/index.js';
 /**
  * Types of B2C operations that support lifecycle hooks.
  */
-export type B2COperationType = 'job:run' | 'job:import' | 'job:export' | 'code:deploy' | 'code:download' | 'code:activate' | 'site-archive:import' | 'site-archive:export';
+export type B2COperationType = 'job:run' | 'job:import' | 'job:export' | 'code:deploy' | 'code:download' | 'code:activate' | 'site-archive:import' | 'site-archive:export' | 'cap:install' | 'cap:uninstall';
 /**
  * Context provided to lifecycle hooks for a B2C operation.
  *

package/dist/esm/cli/lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/cli/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAwKvC;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,aAA+B,EAC/B,QAAiC,EACjC,QAAqB;IAErB,OAAO;QACL,aAAa;QACb,WAAW,EAAE,UAAU,EAAE;QACzB,QAAQ;QACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACrB,SAAS,GAAoC,EAAE,CAAC;IAChD,MAAM,CAAU;IAExB,YAAY,MAAe;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAA0C;QACrD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,OAA4B;QAC1C,MAAM,gBAAgB,GAA6B,EAAE,CAAC;QAEtD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,eAAe;gBAAE,SAAS;YAExC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBACvD,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;oBACjB,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,QAAQ,CAAC,IAAI,oBAAoB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;oBACrF,OAAO,MAAM,CAAC,CAAC,kBAAkB;gBACnC,CAAC;gBACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;oBACpB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,0CAA0C;gBAC1C,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,QAAQ,CAAC,IAAI,4BAA4B,KAAK,EAAE,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,OAA4B,EAAE,MAA0B;QACrE,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,cAAc;gBAAE,SAAS;YAEvC,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,4BAA4B;gBAC5B,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,QAAQ,CAAC,IAAI,2BAA2B,KAAK,EAAE,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/cli/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AA0KvC;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,aAA+B,EAC/B,QAAiC,EACjC,QAAqB;IAErB,OAAO;QACL,aAAa;QACb,WAAW,EAAE,UAAU,EAAE;QACzB,QAAQ;QACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACrB,SAAS,GAAoC,EAAE,CAAC;IAChD,MAAM,CAAU;IAExB,YAAY,MAAe;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAA0C;QACrD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,OAA4B;QAC1C,MAAM,gBAAgB,GAA6B,EAAE,CAAC;QAEtD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,eAAe;gBAAE,SAAS;YAExC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBACvD,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;oBACjB,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,QAAQ,CAAC,IAAI,oBAAoB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;oBACrF,OAAO,MAAM,CAAC,CAAC,kBAAkB;gBACnC,CAAC;gBACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;oBACpB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,0CAA0C;gBAC1C,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,QAAQ,CAAC,IAAI,4BAA4B,KAAK,EAAE,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,OAA4B,EAAE,MAA0B;QACrE,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,cAAc;gBAAE,SAAS;YAEvC,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,4BAA4B;gBAC5B,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,QAAQ,CAAC,IAAI,2BAA2B,KAAK,EAAE,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC/B,CAAC;CACF"}

package/dist/esm/index.d.ts

@@ -22,6 +22,8 @@ export type { CloneState, WaitForCloneOptions, WaitForClonePollInfo } from './op
 export { buildCipReportSql, describeCipTable, executeCipReport, getCipReportByName, listCipReports, listCipTables, } from './operations/cip/index.js';
 export type { CipColumnMetadata, CipDescribeTableOptions, CipDescribeTableResult, CipListTablesOptions, CipListTablesResult, CipReportDefinition, CipReportExecutionOptions, CipReportParamType, CipReportParamDefinition, CipReportQueryExecutor, CipReportQueryResult, CipReportSqlResult, CipTableMetadata, } from './operations/cip/index.js';
 export { getUser, getUserByLogin, listUsers, createUser, updateUser, deleteUser, purgeUser, resetUser, grantRole, revokeRole, } from './operations/users/index.js';
+export { validateCap, commerceAppInstall, commerceAppUninstall, commerceAppPackage, discoverLocalApps, listInstalledApps, parseCommerceFeatureStatesXml, readManifest, pullCommerceApps, } from './operations/cap/index.js';
+export type { CapValidationResult, CommerceAppManifest, CommerceAppInstallOptions, CommerceAppInstallResult, CommerceAppUninstallOptions, CommerceAppUninstallResult, CommerceAppPackageOptions, CommerceAppPackageResult, CommerceFeatureState, LocalCommerceApp, ListInstalledAppsOptions, ListInstalledAppsResult, PullCommerceAppsOptions, PullCommerceAppsResult, PulledApp, PullSource, } from './operations/cap/index.js';
 export { getRole, listRoles } from './operations/roles/index.js';
 export { getOrg, getOrgByName, listOrgs } from './operations/orgs/index.js';
 export { getSafetyLevel, describeSafetyLevel, checkSafetyViolation, checkLevelViolation, SafetyBlockedError, SafetyConfirmationRequired, SafetyGuard, extractJobIdFromPath, maxSafetyLevel, isValidSafetyLevel, parseSafetyLevelString, resolveEffectiveSafetyConfig, loadGlobalSafetyConfig, isValidSafetyAction, VALID_SAFETY_ACTIONS, withSafetyConfirmation, } from './safety/index.js';

package/dist/esm/index.js

@@ -26,6 +26,8 @@ export { isUuid, isFriendlySandboxId, parseFriendlySandboxId, resolveSandboxId,
 export { buildCipReportSql, describeCipTable, executeCipReport, getCipReportByName, listCipReports, listCipTables, } from './operations/cip/index.js';
 // Operations - Users
 export { getUser, getUserByLogin, listUsers, createUser, updateUser, deleteUser, purgeUser, resetUser, grantRole, revokeRole, } from './operations/users/index.js';
+// Operations - CAP (Commerce App Packages)
+export { validateCap, commerceAppInstall, commerceAppUninstall, commerceAppPackage, discoverLocalApps, listInstalledApps, parseCommerceFeatureStatesXml, readManifest, pullCommerceApps, } from './operations/cap/index.js';
 // Operations - Roles
 export { getRole, listRoles } from './operations/roles/index.js';
 // Operations - Organizations

package/dist/esm/index.js.map

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

package/dist/esm/operations/cap/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Commerce App Package (CAP) operations for B2C Commerce.
+ *
+ * This module provides functions for validating, packaging, installing, and
+ * uninstalling Commerce App Packages (CAPs) on B2C Commerce instances.
+ *
+ * ## CAP Operations
+ *
+ * - {@link validateCap} - Validate CAP structure and manifest (local, no instance required)
+ * - {@link commerceAppInstall} - Install a CAP via the sfcc-install-commerce-app job
+ * - {@link commerceAppUninstall} - Uninstall a CAP via the sfcc-uninstall-commerce-app job
+ * - {@link commerceAppPackage} - Package a CAP directory into a distributable .zip
+ * - {@link discoverLocalApps} - Discover local CAPs by finding commerce-app.json files
+ * - {@link listInstalledApps} - List installed apps on an instance via commerce_feature_states export
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import {
+ *   validateCap,
+ *   commerceAppInstall,
+ *   commerceAppUninstall,
+ *   commerceAppPackage,
+ *   discoverLocalApps,
+ *   listInstalledApps,
+ * } from '@salesforce/b2c-tooling-sdk/operations/cap';
+ *
+ * // Validate locally
+ * const result = await validateCap('./my-commerce-app');
+ * if (!result.valid) console.error(result.errors);
+ *
+ * // Package for distribution
+ * const pkg = await commerceAppPackage('./my-commerce-app');
+ *
+ * // Install on an instance
+ * await commerceAppInstall(instance, './my-commerce-app', { siteId: 'RefArch' });
+ *
+ * // Uninstall
+ * await commerceAppUninstall(instance, 'my-app', 'tax', { siteId: 'RefArch' });
+ * ```
+ *
+ * @module operations/cap
+ */
+export { validateCap } from './validate.js';
+export type { CapValidationResult, CommerceAppManifest } from './validate.js';
+export { JobExecutionError } from '../jobs/run.js';
+export { commerceAppInstall, readManifest } from './install.js';
+export type { CommerceAppInstallOptions, CommerceAppInstallResult } from './install.js';
+export { commerceAppUninstall } from './uninstall.js';
+export type { CommerceAppUninstallOptions, CommerceAppUninstallResult } from './uninstall.js';
+export { commerceAppPackage } from './package.js';
+export type { CommerceAppPackageOptions, CommerceAppPackageResult } from './package.js';
+export { discoverLocalApps, listInstalledApps, parseCommerceFeatureStatesXml } from './list.js';
+export { pullCommerceApps } from './pull.js';
+export type { PullCommerceAppsOptions, PullCommerceAppsResult, PulledApp, PullSource } from './pull.js';
+export type { CommerceFeatureState, LocalCommerceApp, ListInstalledAppsOptions, ListInstalledAppsResult, } from './list.js';

package/dist/esm/operations/cap/index.js

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Commerce App Package (CAP) operations for B2C Commerce.
+ *
+ * This module provides functions for validating, packaging, installing, and
+ * uninstalling Commerce App Packages (CAPs) on B2C Commerce instances.
+ *
+ * ## CAP Operations
+ *
+ * - {@link validateCap} - Validate CAP structure and manifest (local, no instance required)
+ * - {@link commerceAppInstall} - Install a CAP via the sfcc-install-commerce-app job
+ * - {@link commerceAppUninstall} - Uninstall a CAP via the sfcc-uninstall-commerce-app job
+ * - {@link commerceAppPackage} - Package a CAP directory into a distributable .zip
+ * - {@link discoverLocalApps} - Discover local CAPs by finding commerce-app.json files
+ * - {@link listInstalledApps} - List installed apps on an instance via commerce_feature_states export
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import {
+ *   validateCap,
+ *   commerceAppInstall,
+ *   commerceAppUninstall,
+ *   commerceAppPackage,
+ *   discoverLocalApps,
+ *   listInstalledApps,
+ * } from '@salesforce/b2c-tooling-sdk/operations/cap';
+ *
+ * // Validate locally
+ * const result = await validateCap('./my-commerce-app');
+ * if (!result.valid) console.error(result.errors);
+ *
+ * // Package for distribution
+ * const pkg = await commerceAppPackage('./my-commerce-app');
+ *
+ * // Install on an instance
+ * await commerceAppInstall(instance, './my-commerce-app', { siteId: 'RefArch' });
+ *
+ * // Uninstall
+ * await commerceAppUninstall(instance, 'my-app', 'tax', { siteId: 'RefArch' });
+ * ```
+ *
+ * @module operations/cap
+ */
+export { validateCap } from './validate.js';
+// Re-export JobExecutionError for convenience in CLI commands
+export { JobExecutionError } from '../jobs/run.js';
+export { commerceAppInstall, readManifest } from './install.js';
+export { commerceAppUninstall } from './uninstall.js';
+export { commerceAppPackage } from './package.js';
+export { discoverLocalApps, listInstalledApps, parseCommerceFeatureStatesXml } from './list.js';
+export { pullCommerceApps } from './pull.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/operations/cap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/cap/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAG1C,8DAA8D;AAC9D,OAAO,EAAC,iBAAiB,EAAC,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAC,kBAAkB,EAAE,YAAY,EAAC,MAAM,cAAc,CAAC;AAG9D,OAAO,EAAC,oBAAoB,EAAC,MAAM,gBAAgB,CAAC;AAGpD,OAAO,EAAC,kBAAkB,EAAC,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAC,iBAAiB,EAAE,iBAAiB,EAAE,6BAA6B,EAAC,MAAM,WAAW,CAAC;AAE9F,OAAO,EAAC,gBAAgB,EAAC,MAAM,WAAW,CAAC"}

package/dist/esm/operations/cap/install.d.ts

@@ -0,0 +1,53 @@
+import { B2CInstance } from '../../instance/index.js';
+import { type JobExecution, type WaitForJobOptions } from '../jobs/run.js';
+import { type CommerceAppManifest } from './validate.js';
+/**
+ * Options for CAP installation.
+ */
+export interface CommerceAppInstallOptions {
+    /** Target site ID to install the app on. */
+    siteId: string;
+    /** Keep the uploaded zip on the instance after install (default: false). */
+    keepArchive?: boolean;
+    /** Wait options for job completion. */
+    waitOptions?: WaitForJobOptions;
+}
+/**
+ * Result of a CAP installation.
+ */
+export interface CommerceAppInstallResult {
+    /** Job execution details. */
+    execution: JobExecution;
+    /** App name (id from commerce-app.json). */
+    appName: string;
+    /** App version. */
+    appVersion: string;
+    /** Uploaded archive filename. */
+    archiveFilename: string;
+    /** Whether the archive was kept on the instance. */
+    archiveKept: boolean;
+}
+/**
+ * Installs a Commerce App Package (CAP) on a B2C Commerce instance.
+ *
+ * Accepts a local directory or zip file. Reads the commerce-app.json manifest
+ * to determine app name, version, and domain. Uploads the zip to WebDAV and
+ * executes the sfcc-install-commerce-app system job.
+ *
+ * @param instance - B2C instance to install to
+ * @param target - Path to a CAP directory or .zip file
+ * @param options - Install options including required siteId
+ * @returns Install result with job execution details
+ * @throws JobExecutionError if the install job fails
+ *
+ * @example
+ * ```typescript
+ * const result = await commerceAppInstall(instance, './commerce-avalara-tax-app-v0.2.5', {
+ *   siteId: 'RefArch',
+ * });
+ * ```
+ */
+export declare function commerceAppInstall(instance: B2CInstance, target: string, options: CommerceAppInstallOptions): Promise<CommerceAppInstallResult>;
+export declare function readManifest(capDir: string): CommerceAppManifest;
+/** Prefix site ID with "Sites-" if not already present. */
+export declare function normalizeSiteId(siteId: string): string;

package/dist/esm/operations/cap/install.js

@@ -0,0 +1,183 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Commerce App Package (CAP) installation.
+ *
+ * Uploads a CAP to WebDAV and runs the sfcc-install-commerce-app system job.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import JSZip from 'jszip';
+import { B2CInstance } from '../../instance/index.js';
+import { getLogger } from '../../logging/logger.js';
+import { waitForJob, JobExecutionError, getJobLog } from '../jobs/run.js';
+import { addDirectoryToZip } from '../util/zip.js';
+import {} from './validate.js';
+const INSTALL_JOB_ID = 'sfcc-install-commerce-app';
+/**
+ * Installs a Commerce App Package (CAP) on a B2C Commerce instance.
+ *
+ * Accepts a local directory or zip file. Reads the commerce-app.json manifest
+ * to determine app name, version, and domain. Uploads the zip to WebDAV and
+ * executes the sfcc-install-commerce-app system job.
+ *
+ * @param instance - B2C instance to install to
+ * @param target - Path to a CAP directory or .zip file
+ * @param options - Install options including required siteId
+ * @returns Install result with job execution details
+ * @throws JobExecutionError if the install job fails
+ *
+ * @example
+ * ```typescript
+ * const result = await commerceAppInstall(instance, './commerce-avalara-tax-app-v0.2.5', {
+ *   siteId: 'RefArch',
+ * });
+ * ```
+ */
+export async function commerceAppInstall(instance, target, options) {
+    const logger = getLogger();
+    const { siteId: rawSiteId, keepArchive = false, waitOptions } = options;
+    const siteId = normalizeSiteId(rawSiteId);
+    if (!fs.existsSync(target)) {
+        throw new Error(`Target not found: ${target}`);
+    }
+    const stat = fs.statSync(target);
+    let archiveContent;
+    let archiveFilename;
+    let manifest;
+    if (stat.isDirectory()) {
+        manifest = readManifest(target);
+        archiveFilename = `${manifest.id}-v${manifest.version}.zip`;
+        logger.debug({ path: target }, `Packaging CAP directory: ${target}`);
+        archiveContent = await createArchiveFromDirectory(target, `${manifest.id}-v${manifest.version}`);
+    }
+    else if (stat.isFile() && target.endsWith('.zip')) {
+        manifest = await readManifestFromZip(target);
+        archiveFilename = path.basename(target);
+        archiveContent = await fs.promises.readFile(target);
+    }
+    else {
+        throw new Error(`Target must be a directory or .zip file: ${target}`);
+    }
+    const uploadDir = 'Impex/commerce-apps';
+    const webdavUploadPath = `${uploadDir}/${archiveFilename}`;
+    const appPath = `webdav/Sites/${webdavUploadPath}`;
+    logger.debug({ path: webdavUploadPath }, `Uploading CAP to ${webdavUploadPath}`);
+    await instance.webdav.mkcol(uploadDir);
+    await instance.webdav.put(webdavUploadPath, archiveContent, 'application/zip');
+    logger.debug({ path: webdavUploadPath }, `CAP uploaded: ${webdavUploadPath}`);
+    // Execute the install job
+    logger.debug({ jobId: INSTALL_JOB_ID, appName: manifest.id, siteId }, `Executing ${INSTALL_JOB_ID} job`);
+    let execution;
+    // Try direct body format first (standard OCAPI format)
+    const { data, error } = await instance.ocapi.POST('/jobs/{job_id}/executions', {
+        params: { path: { job_id: INSTALL_JOB_ID } },
+        body: {
+            app_name: manifest.id,
+            app_source: 'WebDAV',
+            app_domain: manifest.domain,
+            site_id: siteId,
+            app_path: appPath,
+        },
+    });
+    if (error?.fault?.type === 'UnknownPropertyException' &&
+        error.fault.arguments?.document === 'job_execution_request') {
+        // Retry with parameters format (internal/support users)
+        logger.warn('Retrying with parameters format for internal users');
+        const { data: retryData, error: retryError } = await instance.ocapi.POST('/jobs/{job_id}/executions', {
+            params: { path: { job_id: INSTALL_JOB_ID } },
+            body: {
+                parameters: [
+                    { name: 'AppName', value: manifest.id },
+                    { name: 'AppSource', value: 'WebDAV' },
+                    { name: 'AppDomain', value: manifest.domain },
+                    { name: 'SiteId', value: siteId },
+                    { name: 'AppPath', value: appPath },
+                ],
+            },
+        });
+        if (retryError || !retryData) {
+            throw new Error(retryError?.fault?.message ?? 'Failed to start install job');
+        }
+        execution = retryData;
+    }
+    else if (error || !data) {
+        throw new Error(error?.fault?.message ?? 'Failed to start install job');
+    }
+    else {
+        execution = data;
+    }
+    logger.debug({ jobId: INSTALL_JOB_ID, executionId: execution.id }, `Install job started: ${execution.id}`);
+    // Wait for job completion
+    let finalExecution;
+    try {
+        finalExecution = await waitForJob(instance, INSTALL_JOB_ID, execution.id, waitOptions);
+    }
+    catch (err) {
+        if (err instanceof JobExecutionError) {
+            try {
+                const log = await getJobLog(instance, err.execution);
+                logger.error({ jobId: INSTALL_JOB_ID, log }, `Job log:\n${log}`);
+            }
+            catch {
+                logger.error({ jobId: INSTALL_JOB_ID }, 'Could not retrieve job log');
+            }
+        }
+        throw err;
+    }
+    // Clean up archive unless keeping
+    if (!keepArchive) {
+        await instance.webdav.delete(webdavUploadPath);
+        logger.debug({ path: webdavUploadPath }, `Archive deleted: ${webdavUploadPath}`);
+    }
+    return {
+        execution: finalExecution,
+        appName: manifest.id,
+        appVersion: manifest.version,
+        archiveFilename,
+        archiveKept: keepArchive,
+    };
+}
+export function readManifest(capDir) {
+    const manifestPath = path.join(capDir, 'commerce-app.json');
+    if (!fs.existsSync(manifestPath)) {
+        throw new Error(`commerce-app.json not found in: ${capDir}`);
+    }
+    try {
+        return JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+    }
+    catch {
+        throw new Error(`Failed to parse commerce-app.json in: ${capDir}`);
+    }
+}
+async function readManifestFromZip(zipPath) {
+    const data = await fs.promises.readFile(zipPath);
+    const zip = await JSZip.loadAsync(data);
+    // Find commerce-app.json at root or one level deep
+    for (const [filePath, entry] of Object.entries(zip.files)) {
+        if (!entry.dir && (filePath === 'commerce-app.json' || filePath.match(/^[^/]+\/commerce-app\.json$/))) {
+            try {
+                const content = await entry.async('string');
+                return JSON.parse(content);
+            }
+            catch {
+                throw new Error('Failed to parse commerce-app.json from zip');
+            }
+        }
+    }
+    throw new Error('commerce-app.json not found in zip');
+}
+/** Prefix site ID with "Sites-" if not already present. */
+export function normalizeSiteId(siteId) {
+    return siteId.startsWith('Sites-') ? siteId : `Sites-${siteId}`;
+}
+async function createArchiveFromDirectory(dirPath, archiveDirName) {
+    const zip = new JSZip();
+    const rootFolder = zip.folder(archiveDirName);
+    await addDirectoryToZip(rootFolder, dirPath);
+    return zip.generateAsync({ type: 'nodebuffer', compression: 'DEFLATE', compressionOptions: { level: 9 } });
+}
+//# sourceMappingURL=install.js.map

package/dist/esm/operations/cap/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../../src/operations/cap/install.ts"],"names":[],"mappings":"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"}

package/dist/esm/operations/cap/list.d.ts

@@ -0,0 +1,92 @@
+import { B2CInstance } from '../../instance/index.js';
+import type { JobExecution, WaitForJobOptions } from '../jobs/run.js';
+import type { CommerceAppManifest } from './validate.js';
+/**
+ * A commerce feature state parsed from the commerce-feature-states.xml export.
+ */
+export interface CommerceFeatureState {
+    siteId: string;
+    featureName: string;
+    featureType: string;
+    featureSource: string;
+    featureDomain: string;
+    installStatus: string;
+    configStatus: string;
+    featureVersionId: string;
+    installedAt: string;
+    configTasks?: unknown[];
+    installationMetadata?: unknown;
+}
+/**
+ * A locally discovered Commerce App Package.
+ */
+export interface LocalCommerceApp {
+    /** Absolute path to the directory containing commerce-app.json. */
+    path: string;
+    /** Parsed manifest from commerce-app.json. */
+    manifest: CommerceAppManifest;
+}
+/**
+ * Options for listing installed apps on an instance.
+ */
+export interface ListInstalledAppsOptions {
+    /** Specific site IDs to query. If omitted, discovers all sites via OCAPI. */
+    sites?: string[];
+    /** Wait options for the export job. */
+    waitOptions?: WaitForJobOptions;
+}
+/**
+ * Result of listing installed apps on an instance.
+ */
+export interface ListInstalledAppsResult {
+    /** Parsed commerce feature states from all queried sites. */
+    features: CommerceFeatureState[];
+    /** Job execution details. */
+    execution: JobExecution;
+}
+/**
+ * Discovers local Commerce App Packages by searching for commerce-app.json files.
+ *
+ * Walks the directory tree starting from `searchPath`, finds directories
+ * containing a `commerce-app.json` file, and reads each manifest.
+ *
+ * @param searchPath - Root directory to search
+ * @returns Array of discovered local apps with their paths and manifests
+ *
+ * @example
+ * ```typescript
+ * const apps = await discoverLocalApps('./my-workspace');
+ * for (const app of apps) {
+ *   console.log(`${app.manifest.id}@${app.manifest.version} at ${app.path}`);
+ * }
+ * ```
+ */
+export declare function discoverLocalApps(searchPath: string): Promise<LocalCommerceApp[]>;
+/**
+ * Lists installed Commerce Apps on a B2C instance by exporting commerce feature states.
+ *
+ * Attempts to export the `commerce_feature_states` data unit for each site.
+ * If the export fails (e.g. because the data unit is not yet supported on the server),
+ * falls back to a bundled stub fixture.
+ *
+ * @param instance - B2C instance to query
+ * @param options - Options including optional site filter and wait options
+ * @returns List of commerce feature states across all queried sites
+ *
+ * @example
+ * ```typescript
+ * const result = await listInstalledApps(instance);
+ * for (const state of result.features) {
+ *   console.log(`${state.featureName} (${state.installStatus}) on ${state.siteId}`);
+ * }
+ * ```
+ */
+export declare function listInstalledApps(instance: B2CInstance, options?: ListInstalledAppsOptions): Promise<ListInstalledAppsResult>;
+/**
+ * Parses a commerce-feature-states.xml string into CommerceFeatureState objects.
+ *
+ * @param xml - XML string to parse
+ * @param siteId - Site ID to associate with parsed states (used as fallback if not in XML attributes)
+ * @returns Array of parsed commerce feature states
+ */
+export declare function parseCommerceFeatureStatesXml(xml: string, siteId: string): Promise<CommerceFeatureState[]>;