@kodus/cli 0.4.3 → 0.4.5

package/dist/utils/skills-sync.js

@@ -0,0 +1,396 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { readBundledSkills } from './skills.js';
+import { assertValidSkillName } from './skills.js';
+export const DEFAULT_SYNC_SKILL_NAMES = [
+    'kodus-review',
+    'kodus-pr-suggestions-resolver',
+    'kodus-business-rules-validation',
+];
+const LEGACY_BUSINESS_RULES_NAME = 'business-rules-validation';
+const MANAGED_SKILLS_MANIFEST = '.kodus-managed-skills.json';
+async function isDirectory(targetPath) {
+    try {
+        const stats = await fs.stat(targetPath);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function isFile(targetPath) {
+    try {
+        const stats = await fs.stat(targetPath);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function resolveManagedSkillPath(target, skillName) {
+    const safeSkillName = assertValidSkillName(skillName);
+    const filePath = target.type === 'skill'
+        ? path.join(target.baseDir, safeSkillName, 'SKILL.md')
+        : path.join(target.baseDir, `${safeSkillName}.md`);
+    const resolvedBaseDir = path.resolve(target.baseDir);
+    const resolvedPath = path.resolve(filePath);
+    const expectedPrefix = `${resolvedBaseDir}${path.sep}`;
+    if (resolvedPath !== resolvedBaseDir &&
+        !resolvedPath.startsWith(expectedPrefix)) {
+        throw new Error(`Invalid skill name: ${skillName}`);
+    }
+    return resolvedPath;
+}
+function resolveManagedSkillEntryPath(target, skillName) {
+    const safeSkillName = assertValidSkillName(skillName);
+    const filePath = target.type === 'skill'
+        ? path.join(target.baseDir, safeSkillName)
+        : path.join(target.baseDir, `${safeSkillName}.md`);
+    const resolvedBaseDir = path.resolve(target.baseDir);
+    const resolvedPath = path.resolve(filePath);
+    const expectedPrefix = `${resolvedBaseDir}${path.sep}`;
+    if (resolvedPath !== resolvedBaseDir &&
+        !resolvedPath.startsWith(expectedPrefix)) {
+        throw new Error(`Invalid skill name: ${skillName}`);
+    }
+    return resolvedPath;
+}
+async function writeIfChanged(filePath, content, dryRun) {
+    let existingContent = null;
+    try {
+        existingContent = await fs.readFile(filePath, 'utf8');
+    }
+    catch {
+        // File does not exist yet.
+    }
+    if (existingContent === content) {
+        return 'unchanged';
+    }
+    if (dryRun) {
+        return existingContent === null ? 'created' : 'updated';
+    }
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, content, 'utf8');
+    return existingContent === null ? 'created' : 'updated';
+}
+async function removePathIfExists(targetPath, dryRun) {
+    const exists = (await isDirectory(targetPath)) || (await isFile(targetPath));
+    if (!exists) {
+        return false;
+    }
+    if (!dryRun) {
+        await fs.rm(targetPath, { recursive: true, force: true });
+    }
+    return true;
+}
+function resolveManagedManifestPath(target) {
+    return path.join(target.baseDir, MANAGED_SKILLS_MANIFEST);
+}
+async function readManagedSkillNames(target) {
+    try {
+        const raw = await fs.readFile(resolveManagedManifestPath(target), 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) {
+            return [];
+        }
+        return parsed
+            .filter((value) => typeof value === 'string')
+            .map((value) => {
+            try {
+                return assertValidSkillName(value);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((value) => value !== null);
+    }
+    catch {
+        return [];
+    }
+}
+async function writeManagedSkillNames(target, skillNames, dryRun) {
+    if (dryRun) {
+        return;
+    }
+    const manifestPath = resolveManagedManifestPath(target);
+    await fs.mkdir(path.dirname(manifestPath), { recursive: true });
+    await fs.writeFile(manifestPath, `${JSON.stringify(skillNames.sort(), null, 2)}\n`, 'utf8');
+}
+function applyWriteStatus(result, writeStatus) {
+    if (writeStatus === 'created') {
+        result.created += 1;
+        return;
+    }
+    if (writeStatus === 'updated') {
+        result.updated += 1;
+        return;
+    }
+    result.unchanged += 1;
+}
+function createSkippedTargetResult(target, reason) {
+    return {
+        target,
+        synced: false,
+        created: 0,
+        updated: 0,
+        unchanged: 0,
+        removedManaged: 0,
+        removedLegacy: 0,
+        reason,
+    };
+}
+function createSyncedTargetResult(target) {
+    return {
+        target,
+        synced: true,
+        created: 0,
+        updated: 0,
+        unchanged: 0,
+        removedManaged: 0,
+        removedLegacy: 0,
+    };
+}
+export function buildDefaultSkillSyncTargets(cwd = process.cwd(), homeDir = os.homedir()) {
+    return [
+        {
+            label: 'Codex project skills',
+            type: 'skill',
+            activationPath: path.join(cwd, '.codex'),
+            baseDir: path.join(cwd, '.codex', 'skills'),
+        },
+        {
+            label: 'Codex user skills',
+            type: 'skill',
+            activationPath: path.join(homeDir, '.codex'),
+            baseDir: path.join(homeDir, '.codex', 'skills'),
+        },
+        {
+            label: 'Claude project commands',
+            type: 'command',
+            activationPath: path.join(cwd, '.claude'),
+            baseDir: path.join(cwd, '.claude', 'commands'),
+        },
+        {
+            label: 'Claude user commands',
+            type: 'command',
+            activationPath: path.join(homeDir, '.claude'),
+            baseDir: path.join(homeDir, '.claude', 'commands'),
+        },
+        {
+            label: 'Claude config commands',
+            type: 'command',
+            activationPath: path.join(homeDir, '.config', 'claude'),
+            baseDir: path.join(homeDir, '.config', 'claude', 'commands'),
+        },
+        {
+            label: 'Cursor project commands',
+            type: 'command',
+            activationPath: path.join(cwd, '.cursor'),
+            baseDir: path.join(cwd, '.cursor', 'commands'),
+        },
+        {
+            label: 'Cursor user commands',
+            type: 'command',
+            activationPath: path.join(homeDir, '.cursor'),
+            baseDir: path.join(homeDir, '.cursor', 'commands'),
+        },
+        {
+            label: 'Agents project skills',
+            type: 'skill',
+            activationPath: path.join(cwd, '.agents'),
+            baseDir: path.join(cwd, '.agents', 'skills'),
+        },
+        {
+            label: 'Agents user skills',
+            type: 'skill',
+            activationPath: path.join(homeDir, '.config', 'agents'),
+            baseDir: path.join(homeDir, '.config', 'agents', 'skills'),
+        },
+        {
+            label: 'OpenCode project skills',
+            type: 'skill',
+            activationPath: path.join(cwd, '.opencode'),
+            baseDir: path.join(cwd, '.opencode', 'skill'),
+        },
+        {
+            label: 'OpenCode user commands',
+            type: 'command',
+            activationPath: path.join(homeDir, '.config', 'opencode'),
+            baseDir: path.join(homeDir, '.config', 'opencode', 'command'),
+        },
+        {
+            label: 'AiderDesk project commands',
+            type: 'command',
+            activationPath: path.join(cwd, '.aider-desk'),
+            baseDir: path.join(cwd, '.aider-desk', 'commands'),
+        },
+        {
+            label: 'AiderDesk user commands',
+            type: 'command',
+            activationPath: path.join(homeDir, '.aider-desk'),
+            baseDir: path.join(homeDir, '.aider-desk', 'commands'),
+        },
+        {
+            label: 'Kilo Code project skills',
+            type: 'skill',
+            activationPath: path.join(cwd, '.kilocode'),
+            baseDir: path.join(cwd, '.kilocode', 'skills'),
+        },
+        {
+            label: 'Kilo Code user skills',
+            type: 'skill',
+            activationPath: path.join(homeDir, '.kilocode'),
+            baseDir: path.join(homeDir, '.kilocode', 'skills'),
+        },
+        {
+            label: 'Roo Code project skills',
+            type: 'skill',
+            activationPath: path.join(cwd, '.roo'),
+            baseDir: path.join(cwd, '.roo', 'skills'),
+        },
+        {
+            label: 'Roo Code user skills',
+            type: 'skill',
+            activationPath: path.join(homeDir, '.roo'),
+            baseDir: path.join(homeDir, '.roo', 'skills'),
+        },
+        {
+            label: 'Goose project skills',
+            type: 'skill',
+            activationPath: path.join(cwd, '.goose'),
+            baseDir: path.join(cwd, '.goose', 'skills'),
+        },
+        {
+            label: 'Goose user skills',
+            type: 'skill',
+            activationPath: path.join(homeDir, '.config', 'goose'),
+            baseDir: path.join(homeDir, '.config', 'goose', 'skills'),
+        },
+        {
+            label: 'Antigravity project skills',
+            type: 'skill',
+            activationPath: path.join(cwd, '.agent'),
+            baseDir: path.join(cwd, '.agent', 'skills'),
+        },
+        {
+            label: 'Antigravity user skills',
+            type: 'skill',
+            activationPath: path.join(homeDir, '.gemini', 'antigravity'),
+            baseDir: path.join(homeDir, '.gemini', 'antigravity', 'skills'),
+        },
+        {
+            label: 'Droid project skills',
+            type: 'skill',
+            activationPath: path.join(cwd, '.factory'),
+            baseDir: path.join(cwd, '.factory', 'skills'),
+        },
+        {
+            label: 'Droid user skills',
+            type: 'skill',
+            activationPath: path.join(homeDir, '.factory'),
+            baseDir: path.join(homeDir, '.factory', 'skills'),
+        },
+        {
+            label: 'Windsurf project skills',
+            type: 'skill',
+            activationPath: path.join(cwd, '.windsurf'),
+            baseDir: path.join(cwd, '.windsurf', 'skills'),
+        },
+        {
+            label: 'Windsurf user skills',
+            type: 'skill',
+            activationPath: path.join(homeDir, '.codeium', 'windsurf'),
+            baseDir: path.join(homeDir, '.codeium', 'windsurf', 'skills'),
+        },
+        {
+            label: 'Gemini project skills',
+            type: 'skill',
+            activationPath: path.join(cwd, '.gemini'),
+            baseDir: path.join(cwd, '.gemini', 'skills'),
+        },
+    ];
+}
+async function loadSkillsForSync(skills) {
+    if (skills) {
+        return skills;
+    }
+    return readBundledSkills([...DEFAULT_SYNC_SKILL_NAMES]);
+}
+export async function syncSkillsToTargets(targets, options = {}) {
+    const dryRun = options.dryRun ?? false;
+    const mode = options.mode ?? 'sync';
+    const skills = await loadSkillsForSync(options.skills);
+    const results = [];
+    for (const target of targets) {
+        const currentSkillNames = skills.map((skill) => skill.name);
+        let hasTargetDirectory = await isDirectory(target.baseDir);
+        if (mode === 'install' && !hasTargetDirectory) {
+            const hasActivationPath = await isDirectory(target.activationPath);
+            if (!hasActivationPath) {
+                results.push(createSkippedTargetResult(target, 'Agent root directory not found.'));
+                continue;
+            }
+            if (!dryRun) {
+                await fs.mkdir(target.baseDir, { recursive: true });
+            }
+            hasTargetDirectory = true;
+        }
+        if (!hasTargetDirectory) {
+            results.push(createSkippedTargetResult(target, 'Target directory not found.'));
+            continue;
+        }
+        const targetResult = createSyncedTargetResult(target);
+        const previouslyManagedSkillNames = await readManagedSkillNames(target);
+        const currentSkillNamesSet = new Set(currentSkillNames);
+        const staleManagedSkillNames = previouslyManagedSkillNames.filter((skillName) => !currentSkillNamesSet.has(skillName));
+        if (mode === 'uninstall') {
+            const uninstallSkillNames = Array.from(new Set([...currentSkillNames, ...previouslyManagedSkillNames]));
+            for (const skillName of uninstallSkillNames) {
+                const filePath = resolveManagedSkillEntryPath(target, skillName);
+                if (await removePathIfExists(filePath, dryRun)) {
+                    targetResult.removedManaged += 1;
+                }
+                else {
+                    targetResult.unchanged += 1;
+                }
+            }
+            await removePathIfExists(resolveManagedManifestPath(target), dryRun);
+        }
+        else {
+            for (const skill of skills) {
+                const filePath = resolveManagedSkillPath(target, skill.name);
+                const writeStatus = await writeIfChanged(filePath, skill.content, dryRun);
+                applyWriteStatus(targetResult, writeStatus);
+            }
+            for (const skillName of staleManagedSkillNames) {
+                const entryPath = resolveManagedSkillEntryPath(target, skillName);
+                if (await removePathIfExists(entryPath, dryRun)) {
+                    targetResult.removedManaged += 1;
+                }
+            }
+            await writeManagedSkillNames(target, currentSkillNames, dryRun);
+        }
+        const legacyPath = target.type === 'skill'
+            ? path.join(target.baseDir, LEGACY_BUSINESS_RULES_NAME)
+            : path.join(target.baseDir, `${LEGACY_BUSINESS_RULES_NAME}.md`);
+        if (await removePathIfExists(legacyPath, dryRun)) {
+            targetResult.removedLegacy += 1;
+        }
+        results.push(targetResult);
+    }
+    const syncedTargets = results.filter((result) => result.synced).length;
+    return {
+        results,
+        scannedTargets: results.length,
+        syncedTargets,
+        skippedTargets: results.length - syncedTargets,
+        createdFiles: results.reduce((sum, result) => sum + result.created, 0),
+        updatedFiles: results.reduce((sum, result) => sum + result.updated, 0),
+        unchangedFiles: results.reduce((sum, result) => sum + result.unchanged, 0),
+        removedManagedEntries: results.reduce((sum, result) => sum + result.removedManaged, 0),
+        removedLegacyEntries: results.reduce((sum, result) => sum + result.removedLegacy, 0),
+    };
+}
+//# sourceMappingURL=skills-sync.js.map

package/dist/utils/skills-sync.js.map

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

package/dist/utils/skills.d.ts

@@ -1,2 +1,9 @@
+export interface BundledSkillDocument {
+    name: string;
+    content: string;
+}
+export declare function assertValidSkillName(name: string): string;
 export declare function listBundledSkills(): Promise<string[]>;
+export declare function readBundledSkills(skillNames: string[]): Promise<BundledSkillDocument[]>;
+export declare function readBundledSkill(name: string): Promise<string>;
 //# sourceMappingURL=skills.d.ts.map

package/dist/utils/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/utils/skills.ts"],"names":[],"mappings":"AAYA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAkC3D"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/utils/skills.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAczD;AAuBD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA4B3D;AAED,wBAAsB,iBAAiB,CACnC,UAAU,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAgBjC;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGpE"}

package/dist/utils/skills.js

@@ -1,6 +1,18 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+export function assertValidSkillName(name) {
+    const trimmed = name.trim();
+    if (!trimmed ||
+        trimmed === '.' ||
+        trimmed === '..' ||
+        trimmed.includes('/') ||
+        trimmed.includes('\\') ||
+        path.basename(trimmed) !== trimmed) {
+        throw new Error(`Invalid skill name: ${name}`);
+    }
+    return trimmed;
+}
 function resolveSkillsCandidates() {
     const here = path.dirname(fileURLToPath(import.meta.url));
     return [
@@ -8,33 +20,60 @@ function resolveSkillsCandidates() {
         path.resolve(here, '../skills'),
     ];
 }
-export async function listBundledSkills() {
+async function resolveBundledSkillsRoot() {
     for (const dir of resolveSkillsCandidates()) {
         try {
-            const entries = await fs.readdir(dir, { withFileTypes: true });
-            const skills = await Promise.all(entries
-                .filter((entry) => entry.isDirectory())
-                .map(async (entry) => {
-                const skillFile = path.join(dir, entry.name, 'SKILL.md');
-                try {
-                    await fs.access(skillFile);
-                    return entry.name;
-                }
-                catch {
-                    return null;
-                }
-            }));
-            const normalized = skills
-                .filter((name) => !!name)
-                .sort((a, b) => a.localeCompare(b));
-            if (normalized.length > 0) {
-                return normalized;
-            }
+            await fs.access(dir);
+            return dir;
         }
         catch {
-            // Ignore missing candidate and continue.
+            // Try next candidate.
         }
     }
-    return [];
+    return null;
+}
+export async function listBundledSkills() {
+    const root = await resolveBundledSkillsRoot();
+    if (!root) {
+        return [];
+    }
+    try {
+        const entries = await fs.readdir(root, { withFileTypes: true });
+        const skills = await Promise.all(entries
+            .filter((entry) => entry.isDirectory())
+            .map(async (entry) => {
+            const skillFile = path.join(root, entry.name, 'SKILL.md');
+            try {
+                await fs.access(skillFile);
+                return entry.name;
+            }
+            catch {
+                return null;
+            }
+        }));
+        return skills
+            .filter((name) => !!name)
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+export async function readBundledSkills(skillNames) {
+    const root = await resolveBundledSkillsRoot();
+    if (!root) {
+        throw new Error('Bundled skills directory not found.');
+    }
+    const documents = await Promise.all(skillNames.map(async (rawName) => {
+        const name = assertValidSkillName(rawName);
+        const filePath = path.join(root, name, 'SKILL.md');
+        const content = await fs.readFile(filePath, 'utf8');
+        return { name, content };
+    }));
+    return documents;
+}
+export async function readBundledSkill(name) {
+    const [skill] = await readBundledSkills([name]);
+    return skill.content;
 }
 //# sourceMappingURL=skills.js.map

package/dist/utils/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/utils/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,SAAS,uBAAuB;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO;QACH,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC;KAClC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACnC,KAAK,MAAM,GAAG,IAAI,uBAAuB,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,OAAO;iBACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;iBACtC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBACjB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACvB,GAAG,EACH,KAAK,CAAC,IAAI,EACV,UAAU,CACb,CAAC;gBACF,IAAI,CAAC;oBACD,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBAC3B,OAAO,KAAK,CAAC,IAAI,CAAC;gBACtB,CAAC;gBAAC,MAAM,CAAC;oBACL,OAAO,IAAI,CAAC;gBAChB,CAAC;YACL,CAAC,CAAC,CACT,CAAC;YAEF,MAAM,UAAU,GAAG,MAAM;iBACpB,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,OAAO,UAAU,CAAC;YACtB,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,yCAAyC;QAC7C,CAAC;IACL,CAAC;IAED,OAAO,EAAE,CAAC;AACd,CAAC"}
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/utils/skills.ts"],"names":[],"mappings":"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"}

package/dist/utils/stream-input.d.ts

@@ -0,0 +1,13 @@
+type ReadableLike = NodeJS.ReadStream & {
+    isTTY?: boolean;
+    setEncoding?(encoding: BufferEncoding): void;
+    pause?(): void;
+    resume?(): void;
+};
+interface ReadStreamPayloadOptions {
+    noDataTimeoutMs?: number;
+    brokenStreamTimeoutMs?: number;
+}
+export declare function readStreamPayload(stream: ReadableLike, options?: ReadStreamPayloadOptions): Promise<string>;
+export {};
+//# sourceMappingURL=stream-input.d.ts.map

package/dist/utils/stream-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-input.d.ts","sourceRoot":"","sources":["../../src/utils/stream-input.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG,MAAM,CAAC,UAAU,GAAG;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,MAAM,CAAC,IAAI,IAAI,CAAC;CACnB,CAAC;AAEF,UAAU,wBAAwB;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,wBAAsB,iBAAiB,CACnC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,wBAA6B,GACvC,OAAO,CAAC,MAAM,CAAC,CA+CjB"}

package/dist/utils/stream-input.js

@@ -0,0 +1,36 @@
+export async function readStreamPayload(stream, options = {}) {
+    if (stream.isTTY) {
+        return '';
+    }
+    return new Promise((resolve) => {
+        let data = '';
+        let settled = false;
+        const noDataTimer = setTimeout(() => finish(''), options.noDataTimeoutMs ?? 750);
+        const brokenStreamTimer = setTimeout(() => finish(data), options.brokenStreamTimeoutMs ?? 5000);
+        const onData = (chunk) => {
+            data += chunk.toString();
+            clearTimeout(noDataTimer);
+        };
+        const onEnd = () => finish(data);
+        const onError = () => finish(data);
+        const finish = (value) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(noDataTimer);
+            clearTimeout(brokenStreamTimer);
+            stream.removeListener('data', onData);
+            stream.removeListener('end', onEnd);
+            stream.removeListener('error', onError);
+            stream.pause?.();
+            resolve(value);
+        };
+        stream.setEncoding?.('utf-8');
+        stream.on('data', onData);
+        stream.on('end', onEnd);
+        stream.on('error', onError);
+        stream.resume?.();
+    });
+}
+//# sourceMappingURL=stream-input.js.map

package/dist/utils/stream-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-input.js","sourceRoot":"","sources":["../../src/utils/stream-input.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,MAAoB,EACpB,UAAoC,EAAE;IAEtC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACd,CAAC;IAED,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACnC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,WAAW,GAAG,UAAU,CAC1B,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAChB,OAAO,CAAC,eAAe,IAAI,GAAG,CACjC,CAAC;QACF,MAAM,iBAAiB,GAAG,UAAU,CAChC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAClB,OAAO,CAAC,qBAAqB,IAAI,IAAI,CACxC,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,KAAsB,EAAQ,EAAE;YAC5C,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACzB,YAAY,CAAC,WAAW,CAAC,CAAC;QAC9B,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,GAAS,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,GAAS,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAQ,EAAE;YACnC,IAAI,OAAO,EAAE,CAAC;gBACV,OAAO;YACX,CAAC;YAED,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,WAAW,CAAC,CAAC;YAC1B,YAAY,CAAC,iBAAiB,CAAC,CAAC;YAChC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACtC,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACxC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC;QAEF,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5B,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;AACP,CAAC"}