@salesforce/b2c-tooling-sdk 1.9.0 → 1.11.0

package/dist/cjs/skills/installer.js

@@ -1,182 +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 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,
-                    directory: options.directory,
-                });
-                // 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/cjs/skills/installer.js.map

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

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

@@ -1,39 +0,0 @@
-import type { SkillMetadata, SkillSet } from './types.js';
-/**
- * Parse YAML frontmatter from SKILL.md content.
- * Supports both simple key: value and YAML block scalars (e.g., 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/cjs/skills/parser.js

@@ -1,126 +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 path from 'node:path';
-import yaml from 'js-yaml';
-import { getLogger } from '../logging/logger.js';
-/**
- * Parse YAML frontmatter from SKILL.md content.
- * Supports both simple key: value and YAML block scalars (e.g., description: >-).
- *
- * @param content - File content with frontmatter
- * @returns Parsed frontmatter or null if invalid
- */
-export function parseSkillFrontmatter(content) {
-    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
-    if (!match) {
-        return null;
-    }
-    try {
-        const parsed = yaml.load(match[1]);
-        if (!parsed)
-            return null;
-        const name = typeof parsed.name === 'string' ? parsed.name.trim() : undefined;
-        const description = typeof parsed.description === 'string' ? parsed.description.trim() : undefined;
-        if (!name || !description) {
-            return null;
-        }
-        return { name, description };
-    }
-    catch {
-        return 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 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/cjs/skills/parser.js.map

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

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

@@ -1,4 +0,0 @@
-import type { SkillSet, SkillSourceConfig } from './types.js';
-export declare const SKILL_SOURCES: Record<SkillSet, SkillSourceConfig>;
-export declare function getSkillSource(skillSet: SkillSet): SkillSourceConfig;
-export declare const ALL_SKILL_SETS: SkillSet[];

package/dist/cjs/skills/sources.js

@@ -1,52 +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
- */
-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,
-    },
-    'storefront-next': {
-        id: 'storefront-next',
-        displayName: 'Storefront Next development skills',
-        type: 'release-artifact',
-        repo: 'SalesforceCommerceCloud/b2c-developer-tooling',
-        assetName: 'storefront-next-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

@@ -1 +0,0 @@
-{"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,iBAAiB,EAAE;QACjB,EAAE,EAAE,iBAAiB;QACrB,WAAW,EAAE,oCAAoC;QACjD,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,+CAA+C;QACrD,SAAS,EAAE,4BAA4B;QACvC,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

@@ -1,153 +0,0 @@
-/**
- * Supported IDE types for skill installation.
- */
-export type IdeType = 'claude-code' | 'cursor' | 'windsurf' | 'vscode' | 'codex' | 'opencode' | 'agentforce-vibes' | 'manual';
-/**
- * Skill set categories matching the plugins directory structure.
- */
-export type SkillSet = 'b2c' | 'b2c-cli' | 'cap-dev' | 'storefront-next';
-/**
- * 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.
- */
-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;
-    /** Download URL for storefront-next-skills.zip asset, or null if not present */
-    storefrontNextSkillsAssetUrl: 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;
-    /** Custom directory override (used instead of IDE-specific project path) */
-    directory?: 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;
-    /** For repo-contents sources: the resolved commit SHA */
-    commitSha?: string;
-}

package/dist/cjs/skills/types.js

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

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

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

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

@@ -1,12 +0,0 @@
-/**
- * SLAS Shopper Login token retrieval.
- *
- * Provides functions to obtain shopper access tokens from the SLAS
- * Shopper Login service, supporting public (PKCE) and private
- * (client_credentials) client flows for both guest and registered customers.
- *
- * @module slas
- */
-export type { SlasTokenConfig, SlasTokenResponse, SlasRegisteredLoginConfig } from './types.js';
-export { generateCodeChallenge, generateCodeVerifier } from './pkce.js';
-export { getGuestToken, getRegisteredToken } from './token.js';

package/dist/cjs/slas/index.js

@@ -1,8 +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
- */
-export { generateCodeChallenge, generateCodeVerifier } from './pkce.js';
-export { getGuestToken, getRegisteredToken } from './token.js';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/slas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,EAAC,qBAAqB,EAAE,oBAAoB,EAAC,MAAM,WAAW,CAAC;AACtE,OAAO,EAAC,aAAa,EAAE,kBAAkB,EAAC,MAAM,YAAY,CAAC"}

package/dist/cjs/slas/pkce.d.ts

@@ -1,13 +0,0 @@
-/**
- * Generates a cryptographically random PKCE code verifier.
- *
- * @returns A 128-character base64url-encoded random string
- */
-export declare function generateCodeVerifier(): string;
-/**
- * Generates a PKCE code challenge from a code verifier using S256.
- *
- * @param verifier - The code verifier to hash
- * @returns The base64url-encoded SHA-256 hash of the verifier
- */
-export declare function generateCodeChallenge(verifier: string): string;

package/dist/cjs/slas/pkce.js

@@ -1,35 +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
- */
-/**
- * PKCE (Proof Key for Code Exchange) helpers for SLAS authentication.
- *
- * @module slas/pkce
- */
-import { randomBytes, createHash } from 'node:crypto';
-/**
- * Encodes a buffer as a base64url string (RFC 7636).
- */
-function base64url(buffer) {
-    return buffer.toString('base64url');
-}
-/**
- * Generates a cryptographically random PKCE code verifier.
- *
- * @returns A 128-character base64url-encoded random string
- */
-export function generateCodeVerifier() {
-    return base64url(randomBytes(96));
-}
-/**
- * Generates a PKCE code challenge from a code verifier using S256.
- *
- * @param verifier - The code verifier to hash
- * @returns The base64url-encoded SHA-256 hash of the verifier
- */
-export function generateCodeChallenge(verifier) {
-    return base64url(createHash('sha256').update(verifier).digest());
-}
-//# sourceMappingURL=pkce.js.map