promptdock 0.1.0

package/dist/ui.d.ts

@@ -0,0 +1,22 @@
+import type { CliIo } from "./context.js";
+/** NO_COLOR (https://no-color.org) honored: any non-empty value disables color. */
+export declare function colors(env: Record<string, string | undefined>, isTTY: boolean): {
+    bold: (s: string) => string;
+    dim: (s: string) => string;
+    green: (s: string) => string;
+    red: (s: string) => string;
+    yellow: (s: string) => string;
+    cyan: (s: string) => string;
+};
+export type Colors = ReturnType<typeof colors>;
+export declare function formatBytes(n: number): string;
+export declare function formatCountdown(totalSecs: number): string;
+/** ~Nh retry copy for the cap verdict (mirrors the app's premium-cap copy). */
+export declare function retryHours(retryAfterSecs: number): string;
+/**
+ * Numbered-list picker (TTY only — callers gate). Returns the chosen index.
+ * Enter accepts the preselected default.
+ */
+export declare function promptSelect(io: CliIo, title: string, options: string[], preselect: number): Promise<number>;
+/** y/N confirm (TTY only — callers gate; -y bypasses upstream). */
+export declare function confirm(io: CliIo, prompt: string, def?: boolean): Promise<boolean>;

package/dist/ui.js

@@ -0,0 +1,58 @@
+/** NO_COLOR (https://no-color.org) honored: any non-empty value disables color. */
+export function colors(env, isTTY) {
+    const on = isTTY && !env.NO_COLOR;
+    const wrap = (open, close) => (s) => (on ? `${open}${s}${close}` : s);
+    return {
+        bold: wrap("\u001b[1m", "\u001b[22m"),
+        dim: wrap("\u001b[2m", "\u001b[22m"),
+        green: wrap("\u001b[32m", "\u001b[39m"),
+        red: wrap("\u001b[31m", "\u001b[39m"),
+        yellow: wrap("\u001b[33m", "\u001b[39m"),
+        cyan: wrap("\u001b[36m", "\u001b[39m"),
+    };
+}
+export function formatBytes(n) {
+    if (!Number.isFinite(n) || n < 0)
+        return "0 B";
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    return `${(n / (1024 * 1024)).toFixed(1)} MB`;
+}
+export function formatCountdown(totalSecs) {
+    const s = Math.max(0, Math.floor(totalSecs));
+    return `${Math.floor(s / 60)}:${String(s % 60).padStart(2, "0")}`;
+}
+/** ~Nh retry copy for the cap verdict (mirrors the app's premium-cap copy). */
+export function retryHours(retryAfterSecs) {
+    return `~${Math.max(1, Math.ceil(retryAfterSecs / 3600))}h`;
+}
+/**
+ * Numbered-list picker (TTY only — callers gate). Returns the chosen index.
+ * Enter accepts the preselected default.
+ */
+export async function promptSelect(io, title, options, preselect) {
+    io.out(title);
+    options.forEach((opt, i) => {
+        const marker = i === preselect ? "❯" : " ";
+        io.out(` ${marker} ${i + 1}. ${opt}`);
+    });
+    for (;;) {
+        const answer = (await io.question(`Choose [${preselect + 1}]: `)).trim();
+        if (answer === "")
+            return preselect;
+        const n = Number(answer);
+        if (Number.isInteger(n) && n >= 1 && n <= options.length)
+            return n - 1;
+        io.out(`Enter a number between 1 and ${options.length}.`);
+    }
+}
+/** y/N confirm (TTY only — callers gate; -y bypasses upstream). */
+export async function confirm(io, prompt, def = false) {
+    const suffix = def ? "[Y/n]" : "[y/N]";
+    const answer = (await io.question(`${prompt} ${suffix} `)).trim().toLowerCase();
+    if (answer === "")
+        return def;
+    return answer === "y" || answer === "yes";
+}

package/dist/verdicts.d.ts

@@ -0,0 +1,4 @@
+import type { ResolveResponse } from "./contract.js";
+export declare const UPGRADE_URL = "https://promptdock.ai/pricing";
+/** Throws the DX3-copy CliError for a deny verdict; returns for ok/already_entitled. */
+export declare function assertInstallable(resolve: ResolveResponse, refString: string): void;

package/dist/verdicts.js

@@ -0,0 +1,26 @@
+import { CliError, EXIT } from "./errors.js";
+import { retryHours } from "./ui.js";
+export const UPGRADE_URL = "https://promptdock.ai/pricing";
+/** Throws the DX3-copy CliError for a deny verdict; returns for ok/already_entitled. */
+export function assertInstallable(resolve, refString) {
+    switch (resolve.verdict) {
+        case "ok":
+        case "already_entitled":
+            return;
+        case "not_found":
+            throw new CliError(`skill not found: ${refString} — check the ref (the format is handle/slug; a pasted promptdock.ai skill URL also works)`, EXIT.DENIED, { footer: "not_found" });
+        case "insufficient_tier": {
+            const title = resolve.title ? `"${resolve.title}"` : "This skill";
+            throw new CliError(`${title} is a premium skill. Premium skills need the Explorer plan ($10/mo) or higher` +
+                (resolve.current ? ` — your account is on the ${resolve.current} tier.` : "."), EXIT.DENIED, { footer: "insufficient_tier", hint: `Upgrade: ${UPGRADE_URL}` });
+        }
+        case "cap_hit": {
+            const wait = retryHours(Number(resolve.retry_after_secs) || 3600);
+            throw new CliError(`you've hit the daily premium-skill limit — try again in ${wait}`, EXIT.DENIED, { footer: "cap_hit" });
+        }
+        default:
+            throw new CliError(`unrecognized server verdict — update the CLI and retry`, EXIT.DENIED, {
+                footer: "verdict",
+            });
+    }
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "promptdock",
+  "version": "0.1.0",
+  "description": "Install AI agent skills from PromptDock — npx promptdock@latest install <handle>/<slug>",
+  "keywords": ["promptdock", "skills", "ai", "agents", "claude", "cli"],
+  "homepage": "https://promptdock.ai",
+  "bugs": { "url": "https://promptdock.ai/docs/cli/errors" },
+  "license": "UNLICENSED",
+  "type": "module",
+  "bin": { "promptdock": "dist/index.js" },
+  "files": ["dist", "README.md"],
+  "engines": { "node": ">=18" },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "typescript": "^5",
+    "vitest": "^4.1.8"
+  }
+}