@georgedong32/ccs 7.67.0 → 8.0.0

package/dist/utils/package-manager-detector.js

@@ -2,8 +2,9 @@
 /**
  * Package Manager Detector Utilities
  *
- * Cross-platform package manager detection utilities for CCS.
- * Now only supports npm-based installation (npm/yarn/pnpm/bun).
+ * Detect the package manager and install root that own the CURRENT CCS binary.
+ * This is intentionally different from "which package manager has CCS installed
+ * somewhere on the machine" because self-update must target the current install.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -29,75 +30,263 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectPackageManager = void 0;
-const path = __importStar(require("path"));
+exports.formatManualUpdateCommand = exports.readInstalledPackageState = exports.readInstalledPackageVersion = exports.buildPackageManagerEnv = exports.detectPackageManager = exports.detectCurrentInstall = void 0;
 const fs = __importStar(require("fs"));
-const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const CCS_PACKAGE_NAME = '@kaitranntt/ccs';
+function resolveScriptPath(scriptPath) {
+    // Keep Windows-style absolute test fixtures stable on non-Windows hosts, but
+    // still resolve real POSIX symlink paths such as ~/.bun/bin/ccs.
+    if (path.win32.isAbsolute(scriptPath) && !path.isAbsolute(scriptPath)) {
+        return scriptPath;
+    }
+    try {
+        return fs.realpathSync(scriptPath);
+    }
+    catch {
+        return path.resolve(scriptPath);
+    }
+}
+function findPackageRoot(scriptPath) {
+    let currentDir = path.dirname(scriptPath);
+    for (let i = 0; i < 8; i++) {
+        const packageJsonPath = path.join(currentDir, 'package.json');
+        if (fs.existsSync(packageJsonPath)) {
+            try {
+                const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+                if (packageJson.name === CCS_PACKAGE_NAME) {
+                    return currentDir;
+                }
+            }
+            catch {
+                // Ignore malformed package.json and keep walking upward.
+            }
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            break;
+        }
+        currentDir = parentDir;
+    }
+    return null;
+}
+function getPrefixBeforeMarker(packageRoot, marker) {
+    const index = packageRoot.lastIndexOf(marker);
+    return index >= 0 ? packageRoot.slice(0, index) || path.parse(packageRoot).root : null;
+}
+function inferInstallFromPath(targetPath) {
+    const normalizedPath = targetPath.split(path.sep).join('/');
+    if (normalizedPath.includes(`/install/global/node_modules/@kaitranntt/ccs`) ||
+        normalizedPath.includes(`/.bun/install/global/node_modules/@kaitranntt/ccs`)) {
+        return {
+            manager: 'bun',
+            prefix: getPrefixBeforeMarker(targetPath, `${path.sep}install${path.sep}global${path.sep}node_modules`),
+        };
+    }
+    if (normalizedPath.includes(`/global/node_modules/@kaitranntt/ccs`)) {
+        return {
+            manager: 'yarn',
+            prefix: getPrefixBeforeMarker(targetPath, `${path.sep}global${path.sep}node_modules`),
+        };
+    }
+    if (normalizedPath.includes('/global/') &&
+        normalizedPath.includes('/.pnpm/') &&
+        normalizedPath.includes('/node_modules/@kaitranntt/ccs')) {
+        const pnpmVirtualStoreMatch = targetPath.match(new RegExp(`${path.sep.replace(/\\/g, '\\\\')}global${path.sep.replace(/\\/g, '\\\\')}[^${path.sep.replace(/\\/g, '\\\\')}]+${path.sep.replace(/\\/g, '\\\\')}\\.pnpm${path.sep.replace(/\\/g, '\\\\')}`));
+        if (pnpmVirtualStoreMatch) {
+            return {
+                manager: 'pnpm',
+                prefix: getPrefixBeforeMarker(targetPath, `${path.sep}global${path.sep}`),
+            };
+        }
+    }
+    if (normalizedPath.includes('/global/') &&
+        normalizedPath.includes('/node_modules/@kaitranntt/ccs')) {
+        const pnpmFlatMatch = normalizedPath.match(/\/global\/([^/]+)\/node_modules\/@kaitranntt\/ccs/);
+        if (!pnpmFlatMatch || pnpmFlatMatch[1] === 'lib') {
+            return null;
+        }
+        return {
+            manager: 'pnpm',
+            prefix: getPrefixBeforeMarker(targetPath, `${path.sep}global${path.sep}`),
+        };
+    }
+    if (normalizedPath.includes('/.pnpm/') &&
+        normalizedPath.includes('/node_modules/@kaitranntt/ccs')) {
+        return {
+            manager: 'pnpm',
+            prefix: null,
+        };
+    }
+    if (normalizedPath.includes('/lib/node_modules/@kaitranntt/ccs')) {
+        return {
+            manager: 'npm',
+            prefix: getPrefixBeforeMarker(targetPath, `${path.sep}lib${path.sep}node_modules`),
+        };
+    }
+    if (normalizedPath.includes('/node_modules/@kaitranntt/ccs') &&
+        !normalizedPath.includes('/global/node_modules/@kaitranntt/ccs') &&
+        !normalizedPath.includes('/install/global/node_modules/@kaitranntt/ccs') &&
+        !normalizedPath.includes('/.pnpm/')) {
+        return {
+            manager: 'npm',
+            prefix: getPrefixBeforeMarker(targetPath, `${path.sep}node_modules`),
+        };
+    }
+    return null;
+}
 /**
- * Detect which package manager was used for installation
+ * Detect the current install owner from the path of the running script.
+ * Defaults to npm when the path is ambiguous because npm's global layout is
+ * the safest fallback for the existing manual remediation commands.
  */
-function detectPackageManager() {
-    const scriptPath = process.argv[1];
-    // Check if script path contains package manager indicators
-    if (scriptPath.includes('.pnpm'))
-        return 'pnpm';
-    if (scriptPath.includes('yarn'))
-        return 'yarn';
-    if (scriptPath.includes('bun'))
-        return 'bun';
-    // Check parent directories for lock files
-    const binDir = path.dirname(scriptPath);
-    let checkDir = binDir;
-    for (let i = 0; i < 5; i++) {
-        if (fs.existsSync(path.join(checkDir, 'pnpm-lock.yaml')))
-            return 'pnpm';
-        if (fs.existsSync(path.join(checkDir, 'yarn.lock')))
-            return 'yarn';
-        if (fs.existsSync(path.join(checkDir, 'bun.lockb')))
-            return 'bun';
-        checkDir = path.dirname(checkDir);
-    }
-    // Check if package managers are available on the system
-    try {
-        const yarnResult = (0, child_process_1.spawnSync)('yarn', ['global', 'list', '--pattern', '@georgedong32/ccs'], {
-            encoding: 'utf8',
-            shell: true,
-            timeout: 5000,
-        });
-        if (yarnResult.status === 0 && yarnResult.stdout.includes('@georgedong32/ccs')) {
-            return 'yarn';
+function detectCurrentInstall(scriptPath = process.argv[1] || '') {
+    const resolvedScriptPath = resolveScriptPath(scriptPath);
+    const pathMatch = inferInstallFromPath(resolvedScriptPath) ?? inferInstallFromPath(scriptPath);
+    const packageRoot = findPackageRoot(resolvedScriptPath);
+    if (pathMatch) {
+        return {
+            manager: pathMatch.manager,
+            scriptPath,
+            resolvedScriptPath,
+            packageRoot,
+            prefix: pathMatch.prefix,
+            detectionSource: 'path',
+        };
+    }
+    if (packageRoot) {
+        const packageRootMatch = inferInstallFromPath(packageRoot);
+        if (packageRootMatch) {
+            return {
+                manager: packageRootMatch.manager,
+                scriptPath,
+                resolvedScriptPath,
+                packageRoot,
+                prefix: packageRootMatch.prefix,
+                detectionSource: 'package-root',
+            };
         }
     }
-    catch (_err) {
-        // Continue to next check
+    return {
+        manager: 'npm',
+        scriptPath,
+        resolvedScriptPath,
+        packageRoot,
+        prefix: null,
+        detectionSource: 'default',
+    };
+}
+exports.detectCurrentInstall = detectCurrentInstall;
+/**
+ * Backward-compatible helper for callers that only need the package manager.
+ */
+function detectPackageManager(scriptPath = process.argv[1] || '') {
+    return detectCurrentInstall(scriptPath).manager;
+}
+exports.detectPackageManager = detectPackageManager;
+function buildPackageManagerEnv(install, baseEnv = process.env) {
+    if (!install.prefix) {
+        return { ...baseEnv };
+    }
+    switch (install.manager) {
+        case 'npm':
+            return {
+                ...baseEnv,
+                npm_config_prefix: install.prefix,
+                NPM_CONFIG_PREFIX: install.prefix,
+            };
+        case 'yarn':
+            return {
+                ...baseEnv,
+                YARN_GLOBAL_FOLDER: install.prefix,
+            };
+        case 'pnpm':
+            return {
+                ...baseEnv,
+                PNPM_HOME: install.prefix,
+            };
+        case 'bun':
+            return {
+                ...baseEnv,
+                BUN_INSTALL: install.prefix,
+            };
+        default:
+            return { ...baseEnv };
     }
+}
+exports.buildPackageManagerEnv = buildPackageManagerEnv;
+function readInstalledPackageVersion(install) {
+    return readInstalledPackageState(install).version;
+}
+exports.readInstalledPackageVersion = readInstalledPackageVersion;
+function readFileMtimeMs(filePath) {
     try {
-        const pnpmResult = (0, child_process_1.spawnSync)('pnpm', ['list', '-g', '--pattern', '@georgedong32/ccs'], {
-            encoding: 'utf8',
-            shell: true,
-            timeout: 5000,
-        });
-        if (pnpmResult.status === 0 && pnpmResult.stdout.includes('@georgedong32/ccs')) {
-            return 'pnpm';
-        }
+        return fs.statSync(filePath).mtimeMs;
     }
-    catch (_err) {
-        // Continue to next check
+    catch {
+        return null;
     }
+}
+function readInstalledPackageState(install) {
+    if (!install.packageRoot) {
+        return {
+            version: null,
+            packageJsonMtimeMs: null,
+            scriptMtimeMs: readFileMtimeMs(install.resolvedScriptPath),
+        };
+    }
+    const packageJsonPath = path.join(install.packageRoot, 'package.json');
+    const packageJsonMtimeMs = readFileMtimeMs(packageJsonPath);
+    const scriptMtimeMs = readFileMtimeMs(install.resolvedScriptPath);
     try {
-        const bunResult = (0, child_process_1.spawnSync)('bun', ['pm', 'ls', '-g', '--pattern', '@georgedong32/ccs'], {
-            encoding: 'utf8',
-            shell: true,
-            timeout: 5000,
-        });
-        if (bunResult.status === 0 && bunResult.stdout.includes('@georgedong32/ccs')) {
-            return 'bun';
-        }
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        return {
+            version: typeof packageJson.version === 'string' ? packageJson.version : null,
+            packageJsonMtimeMs,
+            scriptMtimeMs,
+        };
     }
-    catch (_err) {
-        // Continue to default
+    catch {
+        return {
+            version: null,
+            packageJsonMtimeMs,
+            scriptMtimeMs,
+        };
     }
-    return 'npm';
 }
-exports.detectPackageManager = detectPackageManager;
+exports.readInstalledPackageState = readInstalledPackageState;
+function quoteForShell(value) {
+    if (/^[A-Za-z0-9_./:-]+$/.test(value)) {
+        return value;
+    }
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function quoteForCmd(value) {
+    return value.replace(/'/g, "''");
+}
+function formatWindowsEnvCommand(envVar, value, command) {
+    return `powershell -NoProfile -Command "$env:${envVar}='${quoteForCmd(value)}'; ${command}"`;
+}
+function formatManualUpdateCommand(targetTag, install = detectCurrentInstall(), platform = process.platform) {
+    const command = {
+        npm: `npm install -g @kaitranntt/ccs@${targetTag}`,
+        yarn: `yarn global add @kaitranntt/ccs@${targetTag}`,
+        pnpm: `pnpm add -g @kaitranntt/ccs@${targetTag}`,
+        bun: `bun add -g @kaitranntt/ccs@${targetTag}`,
+    }[install.manager];
+    if (!install.prefix) {
+        return command;
+    }
+    const envVar = {
+        npm: 'NPM_CONFIG_PREFIX',
+        yarn: 'YARN_GLOBAL_FOLDER',
+        pnpm: 'PNPM_HOME',
+        bun: 'BUN_INSTALL',
+    }[install.manager];
+    if (platform === 'win32') {
+        return formatWindowsEnvCommand(envVar, install.prefix, command);
+    }
+    return `${envVar}=${quoteForShell(install.prefix)} ${command}`;
+}
+exports.formatManualUpdateCommand = formatManualUpdateCommand;
 //# sourceMappingURL=package-manager-detector.js.map

package/dist/utils/package-manager-detector.js.map

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

package/dist/utils/prompt-injection-strategy.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Shared prompt injection strategy.
+ *
+ * Detects which prompt injection mode the user is using and ensures CCS
+ * always uses the SAME mode so Claude CLI never receives mixed
+ * `--append-system-prompt` and `--append-system-prompt-file` flags.
+ *
+ * Rules:
+ *  - User passes `--append-system-prompt` → all CCS prompts use inline
+ *  - User passes `--append-system-prompt-file` → all CCS prompts use file
+ *  - Neither present → default to inline (`--append-system-prompt`)
+ */
+export type PromptInjectionMode = 'inline' | 'file';
+/** `--append-system-prompt` — inline prompt text */
+export declare const PROMPT_FLAG_INLINE = "--append-system-prompt";
+/** `--append-system-prompt-file` — prompt read from file */
+export declare const PROMPT_FLAG_FILE = "--append-system-prompt-file";
+export declare function getManagedPromptFileName(promptName: string): string;
+export declare function getManagedPromptFilePath(promptName: string): string;
+export declare function hasManagedPromptFileArg(params: {
+    args: string[];
+    promptName: string;
+}): boolean;
+/**
+ * Detect which prompt injection mode to use based on user-provided args.
+ *
+ * - `--append-system-prompt-file` found (space or `=` form) → 'file'
+ * - `--append-system-prompt` found (space or `=` form) → 'inline'
+ * - Neither → 'inline' (default)
+ */
+export declare function detectPromptInjectionMode(args: string[]): PromptInjectionMode;
+/**
+ * Build a `--append-system-prompt <text>` arg pair.
+ */
+export declare function buildInlineSteeringArg(params: {
+    promptContent: string;
+}): string[];
+/**
+ * Build a `--append-system-prompt-file <path>` arg pair.
+ * Writes the prompt to a temp file first.
+ */
+export declare function buildFileSteeringArg(params: {
+    promptFileName: string;
+    promptContent: string;
+}): string[];
+/**
+ * Build steering prompt args in the given mode.
+ */
+export declare function buildSteeringArg(params: {
+    args: string[];
+    promptName: string;
+    promptContent: string;
+}): string[];
+//# sourceMappingURL=prompt-injection-strategy.d.ts.map

package/dist/utils/prompt-injection-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-injection-strategy.d.ts","sourceRoot":"","sources":["../../src/utils/prompt-injection-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpD,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAC3D,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAM9D,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAuB/F;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAU7E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAElF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,EAAE,CAYX;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,EAAE,CAWX"}

package/dist/utils/prompt-injection-strategy.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * Shared prompt injection strategy.
+ *
+ * Detects which prompt injection mode the user is using and ensures CCS
+ * always uses the SAME mode so Claude CLI never receives mixed
+ * `--append-system-prompt` and `--append-system-prompt-file` flags.
+ *
+ * Rules:
+ *  - User passes `--append-system-prompt` → all CCS prompts use inline
+ *  - User passes `--append-system-prompt-file` → all CCS prompts use file
+ *  - Neither present → default to inline (`--append-system-prompt`)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSteeringArg = exports.buildFileSteeringArg = exports.buildInlineSteeringArg = exports.detectPromptInjectionMode = exports.hasManagedPromptFileArg = exports.getManagedPromptFilePath = exports.getManagedPromptFileName = exports.PROMPT_FLAG_FILE = exports.PROMPT_FLAG_INLINE = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_manager_1 = require("./config-manager");
+/** `--append-system-prompt` — inline prompt text */
+exports.PROMPT_FLAG_INLINE = '--append-system-prompt';
+/** `--append-system-prompt-file` — prompt read from file */
+exports.PROMPT_FLAG_FILE = '--append-system-prompt-file';
+function getManagedPromptsDir() {
+    return path.join((0, config_manager_1.getCcsDir)(), 'prompts');
+}
+function getManagedPromptFileName(promptName) {
+    return `${promptName}.txt`;
+}
+exports.getManagedPromptFileName = getManagedPromptFileName;
+function getManagedPromptFilePath(promptName) {
+    return path.join(getManagedPromptsDir(), getManagedPromptFileName(promptName));
+}
+exports.getManagedPromptFilePath = getManagedPromptFilePath;
+function hasManagedPromptFileArg(params) {
+    const expectedPath = path.resolve(getManagedPromptFilePath(params.promptName));
+    for (let index = 0; index < params.args.length; index += 1) {
+        const arg = params.args[index];
+        if (arg === exports.PROMPT_FLAG_FILE) {
+            const filePath = params.args[index + 1];
+            if (filePath && path.resolve(filePath) === expectedPath) {
+                return true;
+            }
+            continue;
+        }
+        if (arg.startsWith(`${exports.PROMPT_FLAG_FILE}=`) &&
+            path.resolve(arg.slice(exports.PROMPT_FLAG_FILE.length + 1)) === expectedPath) {
+            return true;
+        }
+    }
+    return false;
+}
+exports.hasManagedPromptFileArg = hasManagedPromptFileArg;
+/**
+ * Detect which prompt injection mode to use based on user-provided args.
+ *
+ * - `--append-system-prompt-file` found (space or `=` form) → 'file'
+ * - `--append-system-prompt` found (space or `=` form) → 'inline'
+ * - Neither → 'inline' (default)
+ */
+function detectPromptInjectionMode(args) {
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === exports.PROMPT_FLAG_FILE || arg.startsWith(`${exports.PROMPT_FLAG_FILE}=`)) {
+            return 'file';
+        }
+    }
+    return 'inline';
+}
+exports.detectPromptInjectionMode = detectPromptInjectionMode;
+/**
+ * Build a `--append-system-prompt <text>` arg pair.
+ */
+function buildInlineSteeringArg(params) {
+    return [exports.PROMPT_FLAG_INLINE, params.promptContent];
+}
+exports.buildInlineSteeringArg = buildInlineSteeringArg;
+/**
+ * Build a `--append-system-prompt-file <path>` arg pair.
+ * Writes the prompt to a temp file first.
+ */
+function buildFileSteeringArg(params) {
+    const promptsFolder = getManagedPromptsDir();
+    if (!fs.existsSync(promptsFolder)) {
+        fs.mkdirSync(promptsFolder, { recursive: true });
+    }
+    const promptFile = path.join(promptsFolder, params.promptFileName);
+    fs.writeFileSync(promptFile, params.promptContent);
+    return [exports.PROMPT_FLAG_FILE, promptFile];
+}
+exports.buildFileSteeringArg = buildFileSteeringArg;
+/**
+ * Build steering prompt args in the given mode.
+ */
+function buildSteeringArg(params) {
+    const mode = detectPromptInjectionMode(params.args);
+    if (mode === 'file') {
+        return buildFileSteeringArg({
+            promptFileName: getManagedPromptFileName(params.promptName),
+            promptContent: params.promptContent,
+        });
+    }
+    return buildInlineSteeringArg({ promptContent: params.promptContent });
+}
+exports.buildSteeringArg = buildSteeringArg;
+//# sourceMappingURL=prompt-injection-strategy.js.map

package/dist/utils/prompt-injection-strategy.js.map

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

package/dist/utils/retry-strategy.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Retry Strategy Utility
+ *
+ * Reusable exponential-backoff retry wrapper extracted from
+ * scattered retry logic in glmt-proxy and binary/downloader.
+ *
+ * Usage:
+ *   const data = await withRetry(() => fetch(url), { maxRetries: 3, baseDelayMs: 100 });
+ */
+/** Configuration options for retry behavior */
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries: number;
+    /** Base delay in ms for the first retry (default: 1000) */
+    baseDelayMs: number;
+    /** Upper bound for the computed backoff delay. Note: server-provided `retryAfter` (from RetryableError) takes precedence and may exceed this cap. */
+    maxDelayMs?: number;
+    /** Multiplier applied per attempt (default: 2). Values <1 produce degrowth. */
+    backoffMultiplier?: number;
+    /** Override the default retryability check */
+    retryableCheck?: (error: unknown) => boolean;
+    /** Callback fired before each retry. Errors thrown by this callback are swallowed to prevent aborting the retry loop. */
+    onRetry?: (error: Error, attempt: number) => void;
+}
+/**
+ * Execute `fn` with automatic retries on retryable failures.
+ *
+ * Retryability defaults to checking for `RetryableError` instances
+ * and CCSError with `recoverable === true`. Override with `retryableCheck`.
+ *
+ * @param fn - The async function to execute
+ * @param options - Retry configuration
+ * @returns The resolved value from `fn`
+ * @throws The last error encountered after exhausting retries
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry-strategy.d.ts.map

package/dist/utils/retry-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-strategy.d.ts","sourceRoot":"","sources":["../../src/utils/retry-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,qJAAqJ;IACrJ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC7C,yHAAyH;IACzH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AA+CD;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAkD1F"}