@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.1

package/dist/cjs/schemas/collapse.js

@@ -1,180 +0,0 @@
-/*
- * 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
- */
-/** HTTP methods that can appear in OpenAPI paths */
-const HTTP_METHODS = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace'];
-/**
- * Collapses an OpenAPI schema for context-efficient representation.
- *
- * This function implements a three-tier disclosure model:
- *
- * 1. **No options provided (default):**
- *    - Paths: `{"/products": ["get", "post"]}` (method names only)
- *    - Schemas: `{"Product": {}}` (keys only)
- *    - Examples: `{"ProductExample": {}}` (keys only)
- *
- * 2. **Selective expansion:**
- *    - Only specified paths/schemas/examples are fully expanded
- *    - Everything else remains collapsed
- *
- * Non-collapsible sections (info, servers, security, tags, etc.) are preserved as-is.
- *
- * @param schema - The OpenAPI schema to collapse
- * @param options - Options controlling what to expand
- * @returns The collapsed schema
- *
- * @example
- * // Collapse everything (default behavior)
- * const collapsed = collapseOpenApiSchema(fullSchema);
- *
- * @example
- * // Expand only /products path and Product schema
- * const collapsed = collapseOpenApiSchema(fullSchema, {
- *   expandPaths: ['/products'],
- *   expandSchemas: ['Product']
- * });
- */
-export function collapseOpenApiSchema(schema, options = {}) {
-    const { expandPaths = [], expandSchemas = [], expandExamples = [] } = options;
-    // Start with a shallow copy
-    const result = { ...schema };
-    // Collapse paths
-    if (schema.paths) {
-        result.paths = collapsePaths(schema.paths, expandPaths);
-    }
-    // Collapse components
-    if (schema.components) {
-        result.components = {
-            ...schema.components,
-        };
-        if (schema.components.schemas) {
-            result.components.schemas = collapseSchemas(schema.components.schemas, expandSchemas);
-        }
-        if (schema.components.examples) {
-            result.components.examples = collapseExamples(schema.components.examples, expandExamples);
-        }
-    }
-    return result;
-}
-/**
- * Collapses path items to show only HTTP method names.
- *
- * @param paths - The paths object from an OpenAPI schema
- * @param expandPaths - Paths to keep fully expanded
- * @returns Collapsed paths object
- */
-function collapsePaths(paths, expandPaths) {
-    const result = {};
-    const expandSet = new Set(expandPaths);
-    for (const [pathKey, pathItem] of Object.entries(paths)) {
-        if (expandSet.has(pathKey)) {
-            // Keep full path item for expanded paths
-            result[pathKey] = pathItem;
-        }
-        else {
-            // Collapse to method names only
-            const methods = Object.keys(pathItem).filter((key) => HTTP_METHODS.includes(key));
-            result[pathKey] = methods;
-        }
-    }
-    return result;
-}
-/**
- * Collapses schemas to show only keys with empty objects.
- *
- * @param schemas - The schemas object from components
- * @param expandSchemas - Schema names to keep fully expanded
- * @returns Collapsed schemas object
- */
-function collapseSchemas(schemas, expandSchemas) {
-    const result = {};
-    const expandSet = new Set(expandSchemas);
-    for (const [schemaName, schemaValue] of Object.entries(schemas)) {
-        if (expandSet.has(schemaName)) {
-            // Keep full schema for expanded schemas
-            result[schemaName] = schemaValue;
-        }
-        else {
-            // Collapse to empty object
-            result[schemaName] = {};
-        }
-    }
-    return result;
-}
-/**
- * Collapses examples to show only keys with empty objects.
- *
- * @param examples - The examples object from components
- * @param expandExamples - Example names to keep fully expanded
- * @returns Collapsed examples object
- */
-function collapseExamples(examples, expandExamples) {
-    const result = {};
-    const expandSet = new Set(expandExamples);
-    for (const [exampleName, exampleValue] of Object.entries(examples)) {
-        if (expandSet.has(exampleName)) {
-            // Keep full example for expanded examples
-            result[exampleName] = exampleValue;
-        }
-        else {
-            // Collapse to empty object
-            result[exampleName] = {};
-        }
-    }
-    return result;
-}
-/**
- * Checks if a schema has been collapsed (i.e., is in outline form).
- *
- * @param schema - The schema to check
- * @returns true if paths are collapsed (arrays) or schemas are empty objects
- */
-export function isCollapsedSchema(schema) {
-    // Check if any path is collapsed (array of methods instead of full path item)
-    if (schema.paths) {
-        for (const pathItem of Object.values(schema.paths)) {
-            if (Array.isArray(pathItem)) {
-                return true;
-            }
-        }
-    }
-    // Check if any schema is collapsed (empty object)
-    if (schema.components?.schemas) {
-        for (const schemaValue of Object.values(schema.components.schemas)) {
-            if (typeof schemaValue === 'object' && schemaValue !== null && Object.keys(schemaValue).length === 0) {
-                return true;
-            }
-        }
-    }
-    return false;
-}
-/**
- * Gets the list of available path keys from a schema.
- *
- * @param schema - The OpenAPI schema
- * @returns Array of path keys (e.g., ["/products", "/orders"])
- */
-export function getPathKeys(schema) {
-    return schema.paths ? Object.keys(schema.paths) : [];
-}
-/**
- * Gets the list of available schema names from a schema.
- *
- * @param schema - The OpenAPI schema
- * @returns Array of schema names (e.g., ["Product", "Order"])
- */
-export function getSchemaNames(schema) {
-    return schema.components?.schemas ? Object.keys(schema.components.schemas) : [];
-}
-/**
- * Gets the list of available example names from a schema.
- *
- * @param schema - The OpenAPI schema
- * @returns Array of example names
- */
-export function getExampleNames(schema) {
-    return schema.components?.examples ? Object.keys(schema.components.examples) : [];
-}
-//# sourceMappingURL=collapse.js.map

package/dist/cjs/schemas/collapse.js.map

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

package/dist/cjs/schemas/index.d.ts

@@ -1,58 +0,0 @@
-/**
- * OpenAPI Schema utilities for B2C Commerce.
- *
- * Provides utilities for working with OpenAPI schemas, including
- * collapsing large schemas for context-efficient representation in
- * agentic/LLM scenarios.
- *
- * ## Schema Collapsing
- *
- * Use {@link collapseOpenApiSchema} to reduce the size of large OpenAPI schemas
- * while preserving structure for discovery:
- *
- * ```typescript
- * import { collapseOpenApiSchema } from '@salesforce/b2c-tooling-sdk/schemas';
- *
- * // Collapse to outline form (default)
- * const collapsed = collapseOpenApiSchema(fullSchema);
- * // Result: paths show only ["get", "post"], schemas show only {}
- *
- * // Selectively expand specific items
- * const collapsed = collapseOpenApiSchema(fullSchema, {
- *   expandPaths: ['/products/search'],
- *   expandSchemas: ['Product', 'SearchResult']
- * });
- * ```
- *
- * ## Utility Functions
- *
- * Helper functions for inspecting schemas:
- *
- * ```typescript
- * import {
- *   getPathKeys,
- *   getSchemaNames,
- *   isCollapsedSchema,
- *   getApiType
- * } from '@salesforce/b2c-tooling-sdk/schemas';
- *
- * // Get available paths
- * const paths = getPathKeys(schema); // ["/products", "/orders", ...]
- *
- * // Get available schemas
- * const schemas = getSchemaNames(schema); // ["Product", "Order", ...]
- *
- * // Check if schema is collapsed
- * if (isCollapsedSchema(schema)) {
- *   console.log('Schema is in collapsed form');
- * }
- *
- * // Map security scheme to API type
- * const apiType = getApiType('AmOAuth2'); // Returns 'Admin'
- * ```
- *
- * @module schemas
- */
-export { collapseOpenApiSchema, isCollapsedSchema, getPathKeys, getSchemaNames, getExampleNames } from './collapse.js';
-export { getApiType } from './security-schemes.js';
-export type { SchemaCollapseOptions, OpenApiSchemaInput, CollapsedOpenApiSchema, CollapsedPath } from './collapse.js';

package/dist/cjs/schemas/index.js

@@ -1,65 +0,0 @@
-/*
- * 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
- */
-/**
- * OpenAPI Schema utilities for B2C Commerce.
- *
- * Provides utilities for working with OpenAPI schemas, including
- * collapsing large schemas for context-efficient representation in
- * agentic/LLM scenarios.
- *
- * ## Schema Collapsing
- *
- * Use {@link collapseOpenApiSchema} to reduce the size of large OpenAPI schemas
- * while preserving structure for discovery:
- *
- * ```typescript
- * import { collapseOpenApiSchema } from '@salesforce/b2c-tooling-sdk/schemas';
- *
- * // Collapse to outline form (default)
- * const collapsed = collapseOpenApiSchema(fullSchema);
- * // Result: paths show only ["get", "post"], schemas show only {}
- *
- * // Selectively expand specific items
- * const collapsed = collapseOpenApiSchema(fullSchema, {
- *   expandPaths: ['/products/search'],
- *   expandSchemas: ['Product', 'SearchResult']
- * });
- * ```
- *
- * ## Utility Functions
- *
- * Helper functions for inspecting schemas:
- *
- * ```typescript
- * import {
- *   getPathKeys,
- *   getSchemaNames,
- *   isCollapsedSchema,
- *   getApiType
- * } from '@salesforce/b2c-tooling-sdk/schemas';
- *
- * // Get available paths
- * const paths = getPathKeys(schema); // ["/products", "/orders", ...]
- *
- * // Get available schemas
- * const schemas = getSchemaNames(schema); // ["Product", "Order", ...]
- *
- * // Check if schema is collapsed
- * if (isCollapsedSchema(schema)) {
- *   console.log('Schema is in collapsed form');
- * }
- *
- * // Map security scheme to API type
- * const apiType = getApiType('AmOAuth2'); // Returns 'Admin'
- * ```
- *
- * @module schemas
- */
-// Collapse utilities
-export { collapseOpenApiSchema, isCollapsedSchema, getPathKeys, getSchemaNames, getExampleNames } from './collapse.js';
-// Security scheme utilities
-export { getApiType } from './security-schemes.js';
-//# sourceMappingURL=index.js.map

package/dist/cjs/schemas/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,qBAAqB;AACrB,OAAO,EAAC,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAC,MAAM,eAAe,CAAC;AACrH,4BAA4B;AAC5B,OAAO,EAAC,UAAU,EAAC,MAAM,uBAAuB,CAAC"}

package/dist/cjs/schemas/security-schemes.d.ts

@@ -1,26 +0,0 @@
-/**
- * Security scheme utilities for OpenAPI schemas.
- *
- * This module provides utility functions for processing security schemes
- * from SCAPI (Salesforce Commerce API) schemas, particularly for custom
- * API endpoints.
- *
- * @module schemas/security-schemes
- */
-/**
- * Maps security scheme to human-readable API type.
- *
- * This utility processes security schemes from SCAPI schemas (typically found
- * in custom API endpoints) and maps them to user-friendly API type names.
- *
- * @param securityScheme - The security scheme from the custom API endpoint
- * @returns Human-readable API type (Admin, Shopper, or the scheme itself)
- *
- * @example
- * ```typescript
- * getApiType('AmOAuth2')      // Returns 'Admin'
- * getApiType('ShopperToken')  // Returns 'Shopper'
- * getApiType(undefined)       // Returns '-'
- * ```
- */
-export declare function getApiType(securityScheme?: string): string;

package/dist/cjs/schemas/security-schemes.js

@@ -1,44 +0,0 @@
-/*
- * 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
- */
-/**
- * Security scheme utilities for OpenAPI schemas.
- *
- * This module provides utility functions for processing security schemes
- * from SCAPI (Salesforce Commerce API) schemas, particularly for custom
- * API endpoints.
- *
- * @module schemas/security-schemes
- */
-/**
- * Maps security scheme to human-readable API type.
- *
- * This utility processes security schemes from SCAPI schemas (typically found
- * in custom API endpoints) and maps them to user-friendly API type names.
- *
- * @param securityScheme - The security scheme from the custom API endpoint
- * @returns Human-readable API type (Admin, Shopper, or the scheme itself)
- *
- * @example
- * ```typescript
- * getApiType('AmOAuth2')      // Returns 'Admin'
- * getApiType('ShopperToken')  // Returns 'Shopper'
- * getApiType(undefined)       // Returns '-'
- * ```
- */
-export function getApiType(securityScheme) {
-    switch (securityScheme) {
-        case 'AmOAuth2': {
-            return 'Admin';
-        }
-        case 'ShopperToken': {
-            return 'Shopper';
-        }
-        default: {
-            return securityScheme || '-';
-        }
-    }
-}
-//# sourceMappingURL=security-schemes.js.map

package/dist/cjs/schemas/security-schemes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"security-schemes.js","sourceRoot":"","sources":["../../../src/schemas/security-schemes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU,CAAC,cAAuB;IAChD,QAAQ,cAAc,EAAE,CAAC;QACvB,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,OAAO,cAAc,IAAI,GAAG,CAAC;QAC/B,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -1,42 +0,0 @@
-import type { IdeConfig, IdeType } from './types.js';
-/**
- * IDE configurations with paths and detection logic.
- */
-export declare const IDE_CONFIGS: Record<IdeType, IdeConfig>;
-/**
- * All supported IDE types in display order.
- */
-export declare const ALL_IDE_TYPES: IdeType[];
-/**
- * Detect which IDEs are installed on the system.
- *
- * @returns Array of IDE types that appear to be installed
- */
-export declare function detectInstalledIdes(): Promise<IdeType[]>;
-/**
- * Get the installation path for a skill.
- *
- * @param ide - Target IDE
- * @param skillName - Name of the skill
- * @param options - Installation options
- * @returns Absolute path where the skill would be installed
- */
-export declare function getSkillInstallPath(ide: IdeType, skillName: string, options: {
-    global: boolean;
-    projectRoot?: string;
-    directory?: string;
-}): string;
-/**
- * Get the display name for an IDE.
- *
- * @param ide - IDE type
- * @returns Human-readable display name
- */
-export declare function getIdeDisplayName(ide: IdeType): string;
-/**
- * Get the documentation URL for an IDE.
- *
- * @param ide - IDE type
- * @returns Documentation URL or undefined if not available
- */
-export declare function getIdeDocsUrl(ide: IdeType): string | undefined;

package/dist/cjs/skills/agents.js

@@ -1,200 +0,0 @@
-/*
- * 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
- */
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-const home = os.homedir();
-/**
- * Get the Agentforce Vibes global skills directory based on platform.
- */
-function getAgentforceVibesGlobalDir() {
-    const platform = process.platform;
-    if (platform === 'darwin') {
-        return path.join(home, 'Library', 'Application Support', 'Code', 'User', 'globalStorage');
-    }
-    else if (platform === 'win32') {
-        return path.join(process.env.APPDATA || path.join(home, 'AppData', 'Roaming'), 'Code', 'User', 'globalStorage');
-    }
-    return path.join(home, '.config', 'Code', 'User', 'globalStorage');
-}
-/**
- * IDE configurations with paths and detection logic.
- */
-export const IDE_CONFIGS = {
-    'claude-code': {
-        id: 'claude-code',
-        displayName: 'Claude Code',
-        paths: {
-            projectDir: '.claude/skills',
-            globalDir: path.join(home, '.claude/skills'),
-        },
-        detectInstalled: async () => {
-            return fs.existsSync(path.join(home, '.claude'));
-        },
-        docsUrl: 'https://docs.anthropic.com/en/docs/claude-code',
-    },
-    cursor: {
-        id: 'cursor',
-        displayName: 'Cursor',
-        paths: {
-            projectDir: '.cursor/skills',
-            globalDir: path.join(home, '.cursor/skills'),
-        },
-        detectInstalled: async () => {
-            return fs.existsSync(path.join(home, '.cursor'));
-        },
-        docsUrl: 'https://cursor.com/docs/context/skills',
-    },
-    windsurf: {
-        id: 'windsurf',
-        displayName: 'Windsurf',
-        paths: {
-            projectDir: '.windsurf/skills',
-            globalDir: path.join(home, '.codeium/windsurf/skills'),
-        },
-        detectInstalled: async () => {
-            return fs.existsSync(path.join(home, '.codeium/windsurf'));
-        },
-        docsUrl: 'https://docs.windsurf.com/',
-    },
-    vscode: {
-        id: 'vscode',
-        displayName: 'VS Code / GitHub Copilot',
-        paths: {
-            projectDir: '.github/skills',
-            globalDir: path.join(home, '.copilot/skills'),
-        },
-        detectInstalled: async () => {
-            // Check for either .github directory (project-based) or ~/.copilot
-            return fs.existsSync(path.join(home, '.copilot'));
-        },
-        docsUrl: 'https://code.visualstudio.com/docs/copilot/customization/agent-skills',
-    },
-    codex: {
-        id: 'codex',
-        displayName: 'OpenAI Codex CLI',
-        paths: {
-            projectDir: '.codex/skills',
-            globalDir: path.join(home, '.codex/skills'),
-        },
-        detectInstalled: async () => {
-            return fs.existsSync(path.join(home, '.codex'));
-        },
-        docsUrl: 'https://github.com/openai/codex',
-    },
-    opencode: {
-        id: 'opencode',
-        displayName: 'OpenCode',
-        paths: {
-            projectDir: '.opencode/skills',
-            globalDir: path.join(home, '.config/opencode/skills'),
-        },
-        detectInstalled: async () => {
-            return fs.existsSync(path.join(home, '.config/opencode'));
-        },
-        docsUrl: 'https://opencode.ai/',
-    },
-    'agentforce-vibes': {
-        id: 'agentforce-vibes',
-        displayName: 'Agentforce Vibes',
-        paths: {
-            projectDir: '.a4drules/skills',
-            globalDir: getAgentforceVibesGlobalDir(),
-        },
-        detectInstalled: async () => {
-            // Check for the Agentforce extension's globalStorage entry
-            const globalStorageDir = getAgentforceVibesGlobalDir();
-            return fs.existsSync(path.join(globalStorageDir, 'salesforce.salesforcedx-einstein-gpt'));
-        },
-        docsUrl: 'https://developer.salesforce.com/docs/platform/einstein-for-devs/guide/skills.html',
-    },
-    manual: {
-        id: 'manual',
-        displayName: 'Manual Installation',
-        paths: {
-            projectDir: '.agents/skills',
-            globalDir: path.join(home, '.agents/skills'),
-        },
-        detectInstalled: async () => {
-            // Manual is always "available" as a fallback
-            return true;
-        },
-    },
-};
-/**
- * All supported IDE types in display order.
- */
-export const ALL_IDE_TYPES = [
-    'claude-code',
-    'cursor',
-    'windsurf',
-    'vscode',
-    'codex',
-    'opencode',
-    'agentforce-vibes',
-    'manual',
-];
-/**
- * Detect which IDEs are installed on the system.
- *
- * @returns Array of IDE types that appear to be installed
- */
-export async function detectInstalledIdes() {
-    const installed = [];
-    for (const ideType of ALL_IDE_TYPES) {
-        // Skip 'manual' from auto-detection since it's always available
-        if (ideType === 'manual') {
-            continue;
-        }
-        const config = IDE_CONFIGS[ideType];
-        const isInstalled = await config.detectInstalled();
-        if (isInstalled) {
-            installed.push(ideType);
-        }
-    }
-    return installed;
-}
-/**
- * Get the installation path for a skill.
- *
- * @param ide - Target IDE
- * @param skillName - Name of the skill
- * @param options - Installation options
- * @returns Absolute path where the skill would be installed
- */
-export function getSkillInstallPath(ide, skillName, options) {
-    // Custom directory override — used as the base path directly
-    if (options.directory) {
-        const projectRoot = options.projectRoot || process.cwd();
-        const dir = path.isAbsolute(options.directory) ? options.directory : path.join(projectRoot, options.directory);
-        return path.join(dir, skillName);
-    }
-    const config = IDE_CONFIGS[ide];
-    if (options.global) {
-        return path.join(config.paths.globalDir, skillName);
-    }
-    const projectRoot = options.projectRoot || process.cwd();
-    return path.join(projectRoot, config.paths.projectDir, skillName);
-}
-/**
- * Get the display name for an IDE.
- *
- * @param ide - IDE type
- * @returns Human-readable display name
- */
-export function getIdeDisplayName(ide) {
-    return IDE_CONFIGS[ide].displayName;
-}
-/**
- * Get the documentation URL for an IDE.
- *
- * @param ide - IDE type
- * @returns Documentation URL or undefined if not available
- */
-export function getIdeDocsUrl(ide) {
-    return IDE_CONFIGS[ide].docsUrl;
-}
-//# sourceMappingURL=agents.js.map

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

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

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

@@ -1,31 +0,0 @@
-import type { CachedArtifact, DownloadSkillsOptions, ReleaseInfo, SkillSet } from './types.js';
-/**
- * Get the cache directory for skills.
- * Uses XDG_CACHE_HOME on Linux, ~/.cache otherwise.
- */
-export declare function getCacheDir(): string;
-/**
- * Fetch release information from GitHub API.
- */
-export declare function getRelease(version?: string): Promise<ReleaseInfo>;
-/**
- * List available releases with skills artifacts.
- */
-export declare function listReleases(limit?: number): Promise<ReleaseInfo[]>;
-/**
- * Get cached artifact metadata if available.
- */
-export declare function getCachedArtifact(version: string, skillSet: SkillSet): CachedArtifact | null;
-/**
- * Download and extract skills artifact.
- * Dispatches to the appropriate download strategy based on the skill source type.
- *
- * @param skillSet - Which skill set to download
- * @param options - Download options
- * @returns Path to extracted skills directory
- */
-export declare function downloadSkillsArtifact(skillSet: SkillSet, options?: DownloadSkillsOptions): Promise<string>;
-/**
- * Clear the skills cache.
- */
-export declare function clearCache(version?: string): Promise<void>;