canary-test-cli 5.7.0 → 5.11.0

package/dist/source-spec.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SourceSpecError = void 0;
+exports.parseSource = parseSource;
+/** Raised when a source spec does not match any accepted form. */
+class SourceSpecError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SourceSpecError";
+    }
+}
+exports.SourceSpecError = SourceSpecError;
+const ACCEPTED_FORMS = "accepted forms: github:owner/repo, an https/git@ URL, or a local path";
+/** Strip a trailing `.git` and any trailing slashes from a path segment. */
+function stripRepoSuffix(segment) {
+    return segment.replace(/\.git$/i, "").replace(/\/+$/, "");
+}
+/** Sanitize a raw `owner/repo` pair into `owner-repo`, rejecting empties. */
+function nameFromOwnerRepo(owner, repo, raw) {
+    const cleanOwner = owner.trim();
+    const cleanRepo = stripRepoSuffix(repo.trim());
+    if (!cleanOwner || !cleanRepo) {
+        throw new SourceSpecError(`cannot derive a name from "${raw}" (${ACCEPTED_FORMS})`);
+    }
+    return `${cleanOwner}-${cleanRepo}`;
+}
+/** Extract the last two path segments (owner, repo) from a URL-ish path. */
+function lastTwoSegments(pathPart) {
+    const segments = pathPart.split("/").filter(Boolean);
+    if (segments.length < 2) {
+        return null;
+    }
+    return [segments[segments.length - 2], segments[segments.length - 1]];
+}
+/** github:owner/repo shorthand. Returns null when `spec` is not this form. */
+function parseGithubShorthand(spec, raw) {
+    if (!spec.startsWith("github:")) {
+        return null;
+    }
+    const parts = spec.slice("github:".length).split("/").filter(Boolean);
+    if (parts.length !== 2) {
+        throw new SourceSpecError(`"${raw}" is not github:owner/repo (${ACCEPTED_FORMS})`);
+    }
+    const [owner, repo] = parts;
+    return {
+        cloneUrl: `https://github.com/${owner}/${stripRepoSuffix(repo)}.git`,
+        name: nameFromOwnerRepo(owner, repo, raw),
+    };
+}
+/** scp-like git URL: git@host:owner/repo(.git). Returns null when not this form. */
+function parseScpUrl(spec, raw) {
+    const scpMatch = spec.match(/^[\w.-]+@[\w.-]+:(.+)$/);
+    if (!scpMatch) {
+        return null;
+    }
+    const pair = lastTwoSegments(scpMatch[1]);
+    if (!pair) {
+        throw new SourceSpecError(`cannot derive owner/repo from "${raw}" (${ACCEPTED_FORMS})`);
+    }
+    return { cloneUrl: spec, name: nameFromOwnerRepo(pair[0], pair[1], raw) };
+}
+/** Full URL: https://, http://, git://, ssh://. Returns null when not this form. */
+function parseFullUrl(spec, raw) {
+    if (!/^(https?|git|ssh):\/\//i.test(spec)) {
+        return null;
+    }
+    let pathname;
+    try {
+        pathname = new URL(spec).pathname;
+    }
+    catch {
+        throw new SourceSpecError(`"${raw}" is not a valid URL (${ACCEPTED_FORMS})`);
+    }
+    const pair = lastTwoSegments(pathname);
+    if (!pair) {
+        throw new SourceSpecError(`cannot derive owner/repo from "${raw}" (${ACCEPTED_FORMS})`);
+    }
+    return { cloneUrl: spec, name: nameFromOwnerRepo(pair[0], pair[1], raw) };
+}
+/** Local filesystem path (absolute, ./relative, ../relative, or ~-relative). */
+function parseLocalPath(spec, raw) {
+    if (!(spec.startsWith("/") || spec.startsWith("./") || spec.startsWith("../") || spec.startsWith("~"))) {
+        return null;
+    }
+    const basename = stripRepoSuffix(spec.split("/").filter(Boolean).pop() ?? "");
+    if (!basename) {
+        throw new SourceSpecError(`cannot derive a name from path "${raw}" (${ACCEPTED_FORMS})`);
+    }
+    return { cloneUrl: spec, name: basename };
+}
+/**
+ * Parse a source spec into a clone URL and overlay name. Throws
+ * {@link SourceSpecError} on anything that does not match an accepted form.
+ */
+function parseSource(raw) {
+    const spec = (raw ?? "").trim();
+    if (!spec) {
+        throw new SourceSpecError(`empty source (${ACCEPTED_FORMS})`);
+    }
+    for (const handler of [parseGithubShorthand, parseScpUrl, parseFullUrl, parseLocalPath]) {
+        const parsed = handler(spec, raw);
+        if (parsed) {
+            return parsed;
+        }
+    }
+    throw new SourceSpecError(`unrecognized source "${raw}" (${ACCEPTED_FORMS})`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "canary-test-cli",
-  "version": "5.7.0",
+  "version": "5.11.0",
   "description": "Canary — AI-powered test automation agent",
   "license": "MIT",
   "repository": {
@@ -11,14 +11,21 @@
     "canary": "./bin/canary.js"
   },
   "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
     "postinstall": "node scripts/install.js",
-    "test": "node --test scripts/__tests__/install.test.js scripts/__tests__/canary.test.js"
+    "test": "npm run build && node --test \"scripts/__tests__/*.test.js\""
   },
   "engines": {
     "node": ">=18"
   },
   "files": [
     "bin/",
+    "dist/",
     "scripts/install.js"
-  ]
+  ],
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
 }