@superdoc-dev/sdk 1.0.0-alpha.2 → 1.0.0-alpha.4

package/src/skills.ts

@@ -1,91 +0,0 @@
-import { readFileSync, readdirSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { SuperDocCliError } from './runtime/errors';
-
-const skillsDir = path.resolve(fileURLToPath(new URL('../skills', import.meta.url)));
-const SKILL_NAME_RE = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
-
-function resolveSkillFilePath(skillName: string): string {
-  const filePath = path.resolve(skillsDir, `${skillName}.md`);
-  const root = `${skillsDir}${path.sep}`;
-  if (!filePath.startsWith(root)) {
-    throw new SuperDocCliError('Skill name resolved outside SDK skill directory.', {
-      code: 'INVALID_ARGUMENT',
-      details: { skillName },
-    });
-  }
-  return filePath;
-}
-
-/**
- * List the names of all SDK skills bundled with this package.
- *
- * @returns Sorted array of skill names (without the `.md` extension).
- * @throws {SuperDocCliError} With code `SKILL_IO_ERROR` if the skills directory cannot be read.
- */
-export function listSkills(): string[] {
-  try {
-    return readdirSync(skillsDir)
-      .filter((entry) => path.extname(entry) === '.md')
-      .map((entry) => path.basename(entry, '.md'))
-      .sort();
-  } catch (error) {
-    throw new SuperDocCliError('Unable to enumerate SDK skills.', {
-      code: 'SKILL_IO_ERROR',
-      details: {
-        skillsDir,
-        message: error instanceof Error ? error.message : String(error),
-      },
-    });
-  }
-}
-
-/**
- * Read the content of a bundled SDK skill by name.
- *
- * @param name - Skill name (e.g. `"editing-docx"`). Must match `[A-Za-z0-9][A-Za-z0-9_-]*`.
- * @returns The skill file content as a UTF-8 string.
- * @throws {SuperDocCliError} With code `INVALID_ARGUMENT` if the name is empty or contains invalid characters.
- * @throws {SuperDocCliError} With code `SKILL_NOT_FOUND` if no skill with that name exists.
- * @throws {SuperDocCliError} With code `SKILL_IO_ERROR` for other file-system read failures.
- */
-export function getSkill(name: string): string {
-  const normalized = name.trim();
-  if (!normalized || !SKILL_NAME_RE.test(normalized)) {
-    throw new SuperDocCliError('Skill name is required.', {
-      code: 'INVALID_ARGUMENT',
-      details: { name },
-    });
-  }
-
-  const filePath = resolveSkillFilePath(normalized);
-  try {
-    return readFileSync(filePath, 'utf8');
-  } catch (error) {
-    const nodeError = error as NodeJS.ErrnoException;
-    if (nodeError?.code === 'ENOENT') {
-      let available: string[] = [];
-      try {
-        available = listSkills();
-      } catch {
-        // Keep available empty when directory enumeration itself fails.
-      }
-      throw new SuperDocCliError('Requested SDK skill was not found.', {
-        code: 'SKILL_NOT_FOUND',
-        details: {
-          name: normalized,
-          available,
-        },
-      });
-    }
-
-    throw new SuperDocCliError('Requested SDK skill was not found.', {
-      code: 'SKILL_IO_ERROR',
-      details: {
-        name: normalized,
-        message: error instanceof Error ? error.message : String(error),
-      },
-    });
-  }
-}