@salesforce/b2c-tooling-sdk 0.0.0-nightly.20260120023917 → 0.0.0-nightly.20260121023856

package/dist/esm/skills/index.js

@@ -0,0 +1,14 @@
+/*
+ * 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
+ */
+// Agent/IDE utilities
+export { IDE_CONFIGS, ALL_IDE_TYPES, detectInstalledIdes, getSkillInstallPath, getIdeDisplayName, getIdeDocsUrl, } from './agents.js';
+// GitHub/download utilities
+export { getCacheDir, getRelease, listReleases, getCachedArtifact, downloadSkillsArtifact, clearCache, } from './github.js';
+// Skill parsing
+export { parseSkillFrontmatter, scanSkills, filterSkillsByName, findSkillsByName } from './parser.js';
+// Installation
+export { isSkillInstalled, installSkills, removeSkill } from './installer.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyDH,sBAAsB;AACtB,OAAO,EACL,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,4BAA4B;AAC5B,OAAO,EACL,WAAW,EACX,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,gBAAgB;AAChB,OAAO,EAAC,qBAAqB,EAAE,UAAU,EAAE,kBAAkB,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAEpG,eAAe;AACf,OAAO,EAAC,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC"}

package/dist/esm/skills/installer.d.ts

@@ -0,0 +1,34 @@
+import type { IdeType, InstallSkillsOptions, InstallSkillsResult, SkillMetadata } from './types.js';
+/**
+ * Check if a skill is already installed.
+ *
+ * @param skillName - Name of the skill
+ * @param ide - Target IDE
+ * @param options - Installation options
+ * @returns true if skill is installed, false otherwise
+ */
+export declare function isSkillInstalled(skillName: string, ide: IdeType, options: {
+    global: boolean;
+    projectRoot?: string;
+}): boolean;
+/**
+ * Install skills to target IDE directories.
+ *
+ * @param skills - Skills to install
+ * @param sourceDir - Directory containing extracted skills
+ * @param options - Installation options
+ * @returns Installation results
+ */
+export declare function installSkills(skills: SkillMetadata[], sourceDir: string, options: InstallSkillsOptions): Promise<InstallSkillsResult>;
+/**
+ * Remove an installed skill.
+ *
+ * @param skillName - Name of the skill to remove
+ * @param ide - Target IDE
+ * @param options - Installation options
+ * @returns true if removed, false if not found
+ */
+export declare function removeSkill(skillName: string, ide: IdeType, options: {
+    global: boolean;
+    projectRoot?: string;
+}): Promise<boolean>;

package/dist/esm/skills/installer.js

@@ -0,0 +1,181 @@
+/*
+ * 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 path from 'node:path';
+import { getSkillInstallPath } from './agents.js';
+import { getLogger } from '../logging/logger.js';
+/**
+ * Sanitize a skill name to prevent path traversal attacks.
+ *
+ * @param name - Skill name to sanitize
+ * @returns Sanitized name safe for use in file paths
+ */
+function sanitizeName(name) {
+    // Remove path separators and null bytes
+    let sanitized = name.replace(/[/\\:\0]/g, '');
+    // Remove leading/trailing dots and spaces
+    sanitized = sanitized.replace(/^[.\s]+|[.\s]+$/g, '');
+    // Limit length
+    if (sanitized.length > 255) {
+        sanitized = sanitized.slice(0, 255);
+    }
+    return sanitized;
+}
+/**
+ * Validate that a path is safely within a base directory.
+ *
+ * @param targetPath - Path to validate
+ * @param baseDir - Base directory that must contain targetPath
+ * @returns true if path is safe, false otherwise
+ */
+function isPathSafe(targetPath, baseDir) {
+    const resolvedTarget = path.resolve(targetPath);
+    const resolvedBase = path.resolve(baseDir);
+    // Ensure the target is within the base directory
+    return resolvedTarget.startsWith(resolvedBase + path.sep) || resolvedTarget === resolvedBase;
+}
+/**
+ * Recursively copy a directory.
+ *
+ * @param source - Source directory
+ * @param target - Target directory
+ */
+async function copyDirectory(source, target) {
+    const logger = getLogger();
+    let fileCount = 0;
+    await fs.promises.mkdir(target, { recursive: true });
+    const entries = await fs.promises.readdir(source, { withFileTypes: true });
+    for (const entry of entries) {
+        const sourcePath = path.join(source, entry.name);
+        const targetPath = path.join(target, entry.name);
+        if (entry.isDirectory()) {
+            fileCount += await copyDirectory(sourcePath, targetPath);
+        }
+        else if (entry.isFile()) {
+            await fs.promises.copyFile(sourcePath, targetPath);
+            fileCount++;
+        }
+        // Skip symlinks and other special files for security
+    }
+    logger.debug({ source, target, fileCount }, 'Copied directory');
+    return fileCount;
+}
+/**
+ * Check if a skill is already installed.
+ *
+ * @param skillName - Name of the skill
+ * @param ide - Target IDE
+ * @param options - Installation options
+ * @returns true if skill is installed, false otherwise
+ */
+export function isSkillInstalled(skillName, ide, options) {
+    const installPath = getSkillInstallPath(ide, skillName, options);
+    return fs.existsSync(installPath);
+}
+/**
+ * Install skills to target IDE directories.
+ *
+ * @param skills - Skills to install
+ * @param sourceDir - Directory containing extracted skills
+ * @param options - Installation options
+ * @returns Installation results
+ */
+export async function installSkills(skills, sourceDir, options) {
+    const logger = getLogger();
+    const result = {
+        installed: [],
+        skipped: [],
+        errors: [],
+    };
+    for (const skill of skills) {
+        const sanitizedName = sanitizeName(skill.name);
+        if (sanitizedName !== skill.name) {
+            logger.warn({ original: skill.name, sanitized: sanitizedName }, 'Skill name was sanitized');
+        }
+        // Source path: sourceDir/skills/skill-path/
+        const sourcePath = path.join(sourceDir, 'skills', skill.path);
+        if (!fs.existsSync(sourcePath)) {
+            for (const ide of options.ides) {
+                result.errors.push({
+                    skill: skill.name,
+                    ide,
+                    error: `Source directory not found: ${sourcePath}`,
+                });
+            }
+            continue;
+        }
+        for (const ide of options.ides) {
+            try {
+                const targetPath = getSkillInstallPath(ide, sanitizedName, {
+                    global: options.global,
+                    projectRoot: options.projectRoot,
+                });
+                // Get the base directory for path safety validation
+                const baseDir = path.dirname(targetPath);
+                // Validate path safety
+                if (!isPathSafe(targetPath, baseDir)) {
+                    result.errors.push({
+                        skill: skill.name,
+                        ide,
+                        error: 'Path validation failed: potential directory traversal',
+                    });
+                    continue;
+                }
+                // Check if already installed
+                if (fs.existsSync(targetPath)) {
+                    if (!options.update) {
+                        result.skipped.push({
+                            skill: skill.name,
+                            ide,
+                            reason: 'Already installed (use --update to overwrite)',
+                        });
+                        continue;
+                    }
+                    // Remove existing for update
+                    await fs.promises.rm(targetPath, { recursive: true });
+                }
+                // Copy skill directory
+                await copyDirectory(sourcePath, targetPath);
+                result.installed.push({
+                    skill: skill.name,
+                    ide,
+                    path: targetPath,
+                });
+            }
+            catch (error) {
+                result.errors.push({
+                    skill: skill.name,
+                    ide,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    logger.debug({
+        installed: result.installed.length,
+        skipped: result.skipped.length,
+        errors: result.errors.length,
+    }, 'Installation complete');
+    return result;
+}
+/**
+ * Remove an installed skill.
+ *
+ * @param skillName - Name of the skill to remove
+ * @param ide - Target IDE
+ * @param options - Installation options
+ * @returns true if removed, false if not found
+ */
+export async function removeSkill(skillName, ide, options) {
+    const sanitizedName = sanitizeName(skillName);
+    const installPath = getSkillInstallPath(ide, sanitizedName, options);
+    if (!fs.existsSync(installPath)) {
+        return false;
+    }
+    await fs.promises.rm(installPath, { recursive: true });
+    return true;
+}
+//# sourceMappingURL=installer.js.map

package/dist/esm/skills/installer.js.map

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

package/dist/esm/skills/parser.d.ts

@@ -0,0 +1,39 @@
+import type { SkillMetadata, SkillSet } from './types.js';
+/**
+ * Parse simple YAML-like frontmatter from SKILL.md content.
+ * Only supports basic key: value pairs (name and description).
+ *
+ * @param content - File content with frontmatter
+ * @returns Parsed frontmatter or null if invalid
+ */
+export declare function parseSkillFrontmatter(content: string): {
+    name: string;
+    description: string;
+} | null;
+/**
+ * Scan a directory for skills and extract their metadata.
+ *
+ * @param skillsDir - Path to extracted skills directory (e.g., ~/.cache/b2c-cli/skills/v0.1.0/b2c/skills/)
+ * @param skillSet - The skill set being scanned ('b2c' or 'b2c-cli')
+ * @returns Array of skill metadata
+ */
+export declare function scanSkills(skillsDir: string, skillSet: SkillSet): Promise<SkillMetadata[]>;
+/**
+ * Filter skills by name.
+ *
+ * @param skills - All available skills
+ * @param names - Skill names to include (if provided)
+ * @returns Filtered skills
+ */
+export declare function filterSkillsByName(skills: SkillMetadata[], names?: string[]): SkillMetadata[];
+/**
+ * Find skills that match the given names, returning any that weren't found.
+ *
+ * @param skills - Available skills
+ * @param names - Requested skill names
+ * @returns Object with matched skills and names not found
+ */
+export declare function findSkillsByName(skills: SkillMetadata[], names: string[]): {
+    found: SkillMetadata[];
+    notFound: string[];
+};

package/dist/esm/skills/parser.js

@@ -0,0 +1,131 @@
+/*
+ * 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 path from 'node:path';
+import { getLogger } from '../logging/logger.js';
+/**
+ * Parse simple YAML-like frontmatter from SKILL.md content.
+ * Only supports basic key: value pairs (name and description).
+ *
+ * @param content - File content with frontmatter
+ * @returns Parsed frontmatter or null if invalid
+ */
+export function parseSkillFrontmatter(content) {
+    // Match frontmatter between --- delimiters
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!match) {
+        return null;
+    }
+    const frontmatter = match[1];
+    const result = {};
+    // Parse simple key: value lines
+    for (const line of frontmatter.split('\n')) {
+        const keyValueMatch = line.match(/^(\w+):\s*(.+)$/);
+        if (keyValueMatch) {
+            const [, key, value] = keyValueMatch;
+            if (key === 'name') {
+                result.name = value.trim();
+            }
+            else if (key === 'description') {
+                result.description = value.trim();
+            }
+        }
+    }
+    if (!result.name || !result.description) {
+        return null;
+    }
+    return { name: result.name, description: result.description };
+}
+/**
+ * Scan a directory for skills and extract their metadata.
+ *
+ * @param skillsDir - Path to extracted skills directory (e.g., ~/.cache/b2c-cli/skills/v0.1.0/b2c/skills/)
+ * @param skillSet - The skill set being scanned ('b2c' or 'b2c-cli')
+ * @returns Array of skill metadata
+ */
+export async function scanSkills(skillsDir, skillSet) {
+    const logger = getLogger();
+    const skills = [];
+    // The extracted structure should be: skillsDir/skills/skill-name/SKILL.md
+    // Find the skills subdirectory
+    const skillsSubdir = path.join(skillsDir, 'skills');
+    if (!fs.existsSync(skillsSubdir)) {
+        logger.debug({ skillsDir, skillsSubdir }, 'Skills subdirectory not found');
+        return skills;
+    }
+    const entries = await fs.promises.readdir(skillsSubdir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const skillDir = path.join(skillsSubdir, entry.name);
+        const skillPath = path.join(skillDir, 'SKILL.md');
+        if (!fs.existsSync(skillPath)) {
+            logger.debug({ skillDir }, 'No SKILL.md found, skipping');
+            continue;
+        }
+        try {
+            const content = await fs.promises.readFile(skillPath, 'utf-8');
+            const frontmatter = parseSkillFrontmatter(content);
+            if (!frontmatter) {
+                logger.warn({ skillPath }, 'Invalid frontmatter in SKILL.md');
+                continue;
+            }
+            // Check for references directory
+            const referencesDir = path.join(skillDir, 'references');
+            const hasReferences = fs.existsSync(referencesDir);
+            skills.push({
+                name: frontmatter.name,
+                description: frontmatter.description,
+                skillSet,
+                path: entry.name, // Relative path within skills directory
+                hasReferences,
+            });
+        }
+        catch (error) {
+            logger.warn({ skillPath, error }, 'Failed to parse SKILL.md');
+        }
+    }
+    logger.debug({ count: skills.length, skillSet }, 'Scanned skills');
+    return skills;
+}
+/**
+ * Filter skills by name.
+ *
+ * @param skills - All available skills
+ * @param names - Skill names to include (if provided)
+ * @returns Filtered skills
+ */
+export function filterSkillsByName(skills, names) {
+    if (!names || names.length === 0) {
+        return skills;
+    }
+    const nameSet = new Set(names);
+    return skills.filter((skill) => nameSet.has(skill.name));
+}
+/**
+ * Find skills that match the given names, returning any that weren't found.
+ *
+ * @param skills - Available skills
+ * @param names - Requested skill names
+ * @returns Object with matched skills and names not found
+ */
+export function findSkillsByName(skills, names) {
+    const skillMap = new Map(skills.map((s) => [s.name, s]));
+    const found = [];
+    const notFound = [];
+    for (const name of names) {
+        const skill = skillMap.get(name);
+        if (skill) {
+            found.push(skill);
+        }
+        else {
+            notFound.push(name);
+        }
+    }
+    return { found, notFound };
+}
+//# sourceMappingURL=parser.js.map

package/dist/esm/skills/parser.js.map

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

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

@@ -0,0 +1,134 @@
+/**
+ * Supported IDE types for skill installation.
+ */
+export type IdeType = 'claude-code' | 'cursor' | 'windsurf' | 'vscode' | 'codex' | 'opencode' | 'manual';
+/**
+ * Skill set categories matching the plugins directory structure.
+ */
+export type SkillSet = 'b2c' | 'b2c-cli';
+/**
+ * IDE path configuration for skill installation.
+ */
+export interface IdePaths {
+    /** Relative path for project-level installation (e.g., '.claude/skills') */
+    projectDir: string;
+    /** Absolute path for global/user-level installation (e.g., '~/.claude/skills') */
+    globalDir: string;
+}
+/**
+ * IDE configuration including paths and display name.
+ */
+export interface IdeConfig {
+    /** IDE identifier */
+    id: IdeType;
+    /** Human-readable display name */
+    displayName: string;
+    /** Installation paths */
+    paths: IdePaths;
+    /** Function to detect if IDE is installed */
+    detectInstalled: () => Promise<boolean>;
+    /** Optional documentation URL for skill configuration */
+    docsUrl?: string;
+}
+/**
+ * Skill metadata extracted from SKILL.md frontmatter.
+ */
+export interface SkillMetadata {
+    /** Skill identifier from frontmatter name field */
+    name: string;
+    /** Skill description from frontmatter */
+    description: string;
+    /** Skill set this skill belongs to (b2c or b2c-cli) */
+    skillSet: SkillSet;
+    /** Relative path within the skills archive */
+    path: string;
+    /** Whether this skill has a references/ subdirectory */
+    hasReferences: boolean;
+}
+/**
+ * GitHub release information.
+ */
+export interface ReleaseInfo {
+    /** Git tag name (e.g., 'v0.1.0') */
+    tagName: string;
+    /** Version number without 'v' prefix */
+    version: string;
+    /** ISO date string when release was published */
+    publishedAt: string;
+    /** Download URL for b2c-skills.zip asset, or null if not present */
+    b2cSkillsAssetUrl: string | null;
+    /** Download URL for b2c-cli-skills.zip asset, or null if not present */
+    b2cCliSkillsAssetUrl: string | null;
+}
+/**
+ * Options for downloading skills artifacts.
+ */
+export interface DownloadSkillsOptions {
+    /** Specific release version to download (default: 'latest') */
+    version?: string;
+    /** Custom cache directory (default: ~/.cache/b2c-cli/skills/) */
+    cacheDir?: string;
+    /** Force re-download even if cached */
+    forceDownload?: boolean;
+}
+/**
+ * Options for installing skills.
+ */
+export interface InstallSkillsOptions {
+    /** Specific skill names to install (default: all skills in skillset) */
+    skills?: string[];
+    /** Target IDEs to install to */
+    ides: IdeType[];
+    /** Install to global/user directory instead of project */
+    global: boolean;
+    /** Overwrite existing skills */
+    update: boolean;
+    /** Project root for project-level installations */
+    projectRoot?: string;
+}
+/**
+ * Result of a single skill installation.
+ */
+export interface SkillInstallation {
+    skill: string;
+    ide: IdeType;
+    path: string;
+}
+/**
+ * Reason for skipping a skill installation.
+ */
+export interface SkillSkipped {
+    skill: string;
+    ide: IdeType;
+    reason: string;
+}
+/**
+ * Error during skill installation.
+ */
+export interface SkillError {
+    skill: string;
+    ide: IdeType;
+    error: string;
+}
+/**
+ * Result of installing skills.
+ */
+export interface InstallSkillsResult {
+    /** Successfully installed skills */
+    installed: SkillInstallation[];
+    /** Skipped skills (already exist, no update flag) */
+    skipped: SkillSkipped[];
+    /** Failed installations */
+    errors: SkillError[];
+}
+/**
+ * Cached artifact metadata stored in manifest.json.
+ */
+export interface CachedArtifact {
+    /** Version of the cached artifact */
+    version: string;
+    /** Path to the extracted skills directory */
+    path: string;
+    /** ISO date string when artifact was downloaded */
+    downloadedAt: string;
+}

package/dist/esm/skills/types.js

@@ -0,0 +1,7 @@
+/*
+ * 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
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/b2c-tooling-sdk",
-  "version": "0.0.0-nightly.20260120023917",
+  "version": "0.0.0-nightly.20260121023856",
   "description": "Core tooling library for Salesforce Commerce Cloud B2C CLI",
   "author": "Charles Lavery",
   "license": "Apache-2.0",
@@ -199,6 +199,17 @@
         "types": "./dist/cjs/discovery/index.d.ts",
         "default": "./dist/cjs/discovery/index.js"
       }
+    },
+    "./skills": {
+      "development": "./src/skills/index.ts",
+      "import": {
+        "types": "./dist/esm/skills/index.d.ts",
+        "default": "./dist/esm/skills/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/skills/index.d.ts",
+        "default": "./dist/cjs/skills/index.js"
+      }
     }
   },
   "main": "./dist/cjs/index.js",