create-settlegrid-tool 1.0.0 → 1.0.1

package/dist/index.js

@@ -3,7 +3,7 @@
 // src/index.ts
 import prompts from "prompts";
 import pc3 from "picocolors";
-import path2 from "path";
+import path4 from "path";
 
 // src/scaffold.ts
 import fs from "fs-extra";
@@ -128,7 +128,7 @@ startCommand = "npm start"
 
 // src/banner.ts
 import pc2 from "picocolors";
-function banner() {
+function banner(version) {
   const emerald = pc2.green;
   const dim = pc2.dim;
   const art = `
@@ -138,14 +138,209 @@ ${emerald("  \\__ \\/ -_)  _|  _| / -_)| (_ | '_| / _` |")}
 ${emerald("  |___/\\___|\\__|\\__|_\\___| \\___|_| |_\\__,_|")}
 `;
   const tagline = dim("  The Settlement Layer for the AI Economy");
-  const version = dim("  v1.0.0");
+  const versionLine = dim(`  v${version}`);
   const separator = dim("  " + "-".repeat(44));
   return `${art}${tagline}
-${version}
+${versionLine}
 ${separator}
 `;
 }
 
+// src/args.ts
+var TEMPLATE_EQ_PREFIX = "--template=";
+function parseArgs(argv) {
+  const result = { help: false, version: false };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--help" || arg === "-h") {
+      result.help = true;
+    } else if (arg === "--version") {
+      result.version = true;
+    } else if (arg === "--template") {
+      const next = argv[i + 1];
+      if (next !== void 0 && !next.startsWith("-")) {
+        result.template = next;
+        i++;
+      } else {
+        result.template = "";
+      }
+    } else if (arg.startsWith(TEMPLATE_EQ_PREFIX)) {
+      result.template = arg.slice(TEMPLATE_EQ_PREFIX.length);
+    } else if (arg.startsWith("-")) {
+    } else if (result.directory === void 0) {
+      result.directory = arg;
+    }
+  }
+  return result;
+}
+
+// src/version.ts
+import { readFileSync } from "fs";
+import * as path2 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+function readPackageVersion() {
+  try {
+    const here = path2.dirname(fileURLToPath2(import.meta.url));
+    const pkgPath = path2.resolve(here, "..", "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    return typeof pkg.version === "string" && pkg.version.length > 0 ? pkg.version : "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+// src/gallery.ts
+import fs2 from "fs-extra";
+var GALLERY_OWNER = "settlegrid";
+var GALLERY_REPO_PREFIX = "settlegrid-";
+var MAX_SLUG_LEN = 64;
+var GALLERY_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var ScaffoldError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "ScaffoldError";
+    this.code = code;
+  }
+};
+function isValidGallerySlug(slug) {
+  return slug.length > 0 && slug.length <= MAX_SLUG_LEN && GALLERY_SLUG_RE.test(slug);
+}
+function gallerySource(slug) {
+  return `github:${GALLERY_OWNER}/${GALLERY_REPO_PREFIX}${slug}`;
+}
+function defaultGalleryDir(slug) {
+  return `${GALLERY_REPO_PREFIX}${slug}`;
+}
+function classifyGigetError(err) {
+  const msg = (err instanceof Error ? err.message : String(err)).toLowerCase();
+  if (msg.includes("404") || msg.includes("not found")) {
+    return "template_not_found";
+  }
+  if (msg.includes("eacces") || msg.includes("eperm") || msg.includes("erofs") || msg.includes("enospc") || msg.includes("eexist") || msg.includes("permission denied")) {
+    return "write_failed";
+  }
+  return "download_failed";
+}
+async function downloadGalleryTemplate(slug, targetDir) {
+  if (!isValidGallerySlug(slug)) {
+    throw new ScaffoldError(
+      "template_not_found",
+      slug.trim().length === 0 ? "Missing template slug. Usage: npx create-settlegrid-tool --template <slug>" : `Unknown or invalid template "${slug}". Slugs are lowercase letters, digits, and hyphens.`
+    );
+  }
+  if (await fs2.pathExists(targetDir)) {
+    const entries = await fs2.readdir(targetDir);
+    if (entries.length > 0) {
+      throw new ScaffoldError(
+        "write_failed",
+        `Directory "${targetDir}" already exists and is not empty.`
+      );
+    }
+  }
+  try {
+    const { downloadTemplate } = await import("giget");
+    await downloadTemplate(gallerySource(slug), {
+      dir: targetDir,
+      force: true
+    });
+  } catch (err) {
+    throw new ScaffoldError(
+      classifyGigetError(err),
+      err instanceof Error ? err.message : String(err)
+    );
+  }
+}
+
+// src/telemetry.ts
+import { chmodSync, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { homedir } from "os";
+import * as path3 from "path";
+import { randomUUID } from "crypto";
+var DEFAULT_PROXY_BASE = "https://settlegrid.ai";
+var TELEMETRY_TIMEOUT_MS = 2e3;
+function isOptedOut() {
+  if (isCi()) return true;
+  const raw = process.env.SETTLEGRID_TELEMETRY?.trim().toLowerCase();
+  if (!raw) return false;
+  return raw === "0" || raw === "false" || raw === "no" || raw === "off";
+}
+function isCi() {
+  return process.env.CI !== void 0 || process.env.CONTINUOUS_INTEGRATION !== void 0;
+}
+function getProxyBase() {
+  const raw = process.env.SETTLEGRID_API_URL?.trim();
+  const base = raw && raw.length > 0 ? raw : DEFAULT_PROXY_BASE;
+  return base.replace(/\/$/, "");
+}
+function telemetryIdPath() {
+  const home = homedir() || "/tmp";
+  return path3.join(home, ".settlegrid", "telemetry-id");
+}
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function getDistinctId() {
+  const envId = process.env.SETTLEGRID_POSTHOG_ID?.trim();
+  if (envId && UUID_RE.test(envId)) return envId;
+  const file = telemetryIdPath();
+  try {
+    const existing = readFileSync2(file, "utf8").trim();
+    if (UUID_RE.test(existing)) return existing;
+  } catch {
+  }
+  const id = randomUUID();
+  try {
+    mkdirSync(path3.dirname(file), { recursive: true, mode: 448 });
+    writeFileSync(file, id, { mode: 384 });
+    chmodSync(file, 384);
+  } catch {
+  }
+  return id;
+}
+var fetchOverride;
+async function post(body) {
+  const fetchImpl = fetchOverride ?? globalThis.fetch;
+  if (typeof fetchImpl !== "function") {
+    return false;
+  }
+  const url = `${getProxyBase()}/api/telemetry/capture`;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), TELEMETRY_TIMEOUT_MS);
+  try {
+    const res = await fetchImpl(url, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body),
+      redirect: "error",
+      signal: controller.signal
+    });
+    return res.ok;
+  } catch {
+    return false;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function capture(event, properties) {
+  if (isOptedOut()) return false;
+  return post({
+    event,
+    properties,
+    distinct_id: getDistinctId()
+  });
+}
+async function captureScaffoldSuccess(args) {
+  return capture("scaffold_success", {
+    template_slug: args.template_slug,
+    duration_ms: args.duration_ms
+  });
+}
+async function captureScaffoldFailed(args) {
+  return capture("scaffold_failed", {
+    template_slug: args.template_slug,
+    error_code: args.error_code
+  });
+}
+
 // src/index.ts
 var CATEGORIES = [
   { title: "Data", value: "data" },
@@ -177,31 +372,85 @@ var DEPLOY_TARGETS = [
 function toSlug(name) {
   return name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
 }
-async function main() {
-  console.log(banner());
-  const dirArg = process.argv[2];
-  if (dirArg === "--help" || dirArg === "-h") {
-    console.log(`
-  ${pc3.bold("Usage:")} npx create-settlegrid-tool ${pc3.cyan("[directory]")}
+function helpText() {
+  return `
+  ${pc3.bold("Usage:")}
+    ${pc3.cyan("npx create-settlegrid-tool")} ${pc3.dim("[directory]")}
+    ${pc3.cyan("npx create-settlegrid-tool --template")} ${pc3.dim("<slug> [directory]")}
+
+  ${pc3.dim("Create a monetized AI tool project with SettleGrid billing.")}
 
-  ${pc3.dim("Creates a monetized AI tool project with SettleGrid billing.")}
+  ${pc3.bold("Modes:")}
+    ${pc3.dim("Interactive")}   Run with no ${pc3.cyan("--template")} flag to pick a starter
+                  archetype (blank, rest-api, openapi, mcp-server).
+    ${pc3.dim("Gallery")}       Pass ${pc3.cyan("--template <slug>")} to scaffold one of the
+                  published templates from ${pc3.underline("https://settlegrid.ai/templates")}.
 
   ${pc3.bold("Options:")}
-    ${pc3.cyan("[directory]")}   Project directory name (default: prompted)
-    ${pc3.cyan("--help, -h")}   Show this help message
-    ${pc3.cyan("--version")}    Show version
-`);
-    process.exit(0);
-  }
-  if (dirArg === "--version") {
-    console.log("1.0.0");
-    process.exit(0);
+    ${pc3.cyan("--template <slug>")}   Gallery template slug, e.g. ${pc3.dim("tmdb")} (non-interactive)
+    ${pc3.cyan("[directory]")}         Target directory (default: ${pc3.dim("settlegrid-<slug>")} in
+                        gallery mode, or prompted in interactive mode)
+    ${pc3.cyan("--help, -h")}          Show this help message
+    ${pc3.cyan("--version")}           Show version
+`;
+}
+function mapInteractiveError(err) {
+  const msg = (err instanceof Error ? err.message : String(err)).toLowerCase();
+  if (msg.includes("already exists")) return "write_failed";
+  if (msg.includes("not found")) return "template_not_found";
+  return "unknown";
+}
+async function runGalleryMode(slug, directoryArg) {
+  const scaffoldStart = Date.now();
+  const trimmedSlug = slug.trim();
+  const telemetrySlug = isValidGallerySlug(trimmedSlug) ? trimmedSlug : "(invalid)";
+  const directory = directoryArg ?? defaultGalleryDir(trimmedSlug);
+  const targetDir = path4.resolve(process.cwd(), directory);
+  console.log(
+    pc3.dim(`  Scaffolding "${trimmedSlug}" from the SettleGrid gallery...`)
+  );
+  console.log();
+  try {
+    await downloadGalleryTemplate(trimmedSlug, targetDir);
+  } catch (err) {
+    const code = err instanceof ScaffoldError ? err.code : "unknown";
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(pc3.red("  Scaffold failed: ") + message);
+    if (code === "template_not_found") {
+      console.error(
+        pc3.dim("  Browse available templates at ") + pc3.cyan("https://settlegrid.ai/templates")
+      );
+    }
+    console.error();
+    process.exitCode = 1;
+    void captureScaffoldFailed({
+      template_slug: telemetrySlug,
+      error_code: code
+    });
+    return;
   }
+  console.log(pc3.green(pc3.bold("  Done!")) + " Template ready.\n");
+  console.log(`  ${pc3.dim("$")} ${pc3.cyan(`cd ${directory}`)}`);
+  console.log(`  ${pc3.dim("$")} ${pc3.cyan("npm install")}`);
+  console.log(
+    `  ${pc3.dim("$")} ${pc3.cyan("cp .env.example .env")}   ${pc3.dim("# add your API keys")}`
+  );
+  console.log(`  ${pc3.dim("$")} ${pc3.cyan("npm run dev")}
+`);
+  console.log(
+    pc3.dim("  Register your tool to start earning: ") + pc3.cyan(pc3.underline("https://settlegrid.ai/dashboard/tools")) + "\n"
+  );
+  void captureScaffoldSuccess({
+    template_slug: telemetrySlug,
+    duration_ms: Date.now() - scaffoldStart
+  });
+}
+async function runInteractiveMode(directoryArg) {
   let cancelled = false;
   const response = await prompts(
     [
       {
-        type: dirArg ? null : "text",
+        type: directoryArg ? null : "text",
         name: "directory",
         message: "Project directory",
         initial: "my-tool",
@@ -211,7 +460,7 @@ async function main() {
         type: "text",
         name: "toolName",
         message: "Tool name",
-        initial: (prev) => prev || dirArg || "my-tool"
+        initial: (prev) => prev || directoryArg || "my-tool"
       },
       {
         type: "text",
@@ -261,9 +510,9 @@ async function main() {
     console.log(pc3.red("\nSetup cancelled."));
     process.exit(1);
   }
-  const directory = dirArg || response.directory;
+  const directory = directoryArg || response.directory;
   const toolSlug = toSlug(directory);
-  const targetDir = path2.resolve(process.cwd(), directory);
+  const targetDir = path4.resolve(process.cwd(), directory);
   const config = {
     directory,
     toolName: response.toolName || directory,
@@ -279,7 +528,19 @@ async function main() {
   console.log();
   console.log(pc3.dim("  Scaffolding project..."));
   console.log();
-  await scaffold(config);
+  const scaffoldStart = Date.now();
+  try {
+    await scaffold(config);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(pc3.red("  Scaffold failed: ") + message + "\n");
+    process.exitCode = 1;
+    void captureScaffoldFailed({
+      template_slug: config.template,
+      error_code: mapInteractiveError(err)
+    });
+    return;
+  }
   console.log(pc3.green(pc3.bold("  Done!")) + " Your tool is ready.\n");
   console.log(`  ${pc3.dim("$")} ${pc3.cyan(`cd ${directory}`)}`);
   console.log(`  ${pc3.dim("$")} ${pc3.cyan("npm install")}`);
@@ -288,6 +549,28 @@ async function main() {
   console.log(
     pc3.dim("  Next: Register your tool at ") + pc3.cyan(pc3.underline("https://settlegrid.ai/dashboard/tools")) + "\n"
   );
+  void captureScaffoldSuccess({
+    template_slug: config.template,
+    duration_ms: Date.now() - scaffoldStart
+  });
+}
+async function main() {
+  const version = readPackageVersion();
+  const args = parseArgs(process.argv.slice(2));
+  console.log(banner(version));
+  if (args.help) {
+    console.log(helpText());
+    process.exit(0);
+  }
+  if (args.version) {
+    console.log(version);
+    process.exit(0);
+  }
+  if (args.template !== void 0) {
+    await runGalleryMode(args.template, args.directory);
+    return;
+  }
+  await runInteractiveMode(args.directory);
 }
 main().catch((err) => {
   console.error(pc3.red("Error:"), err instanceof Error ? err.message : err);

package/dist/postinstall.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+
+// src/telemetry.ts
+import { chmodSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import * as path from "path";
+import { randomUUID } from "crypto";
+var DEFAULT_PROXY_BASE = "https://settlegrid.ai";
+var TELEMETRY_TIMEOUT_MS = 2e3;
+function isOptedOut() {
+  if (isCi()) return true;
+  const raw = process.env.SETTLEGRID_TELEMETRY?.trim().toLowerCase();
+  if (!raw) return false;
+  return raw === "0" || raw === "false" || raw === "no" || raw === "off";
+}
+function isCi() {
+  return process.env.CI !== void 0 || process.env.CONTINUOUS_INTEGRATION !== void 0;
+}
+function getProxyBase() {
+  const raw = process.env.SETTLEGRID_API_URL?.trim();
+  const base = raw && raw.length > 0 ? raw : DEFAULT_PROXY_BASE;
+  return base.replace(/\/$/, "");
+}
+function telemetryIdPath() {
+  const home = homedir() || "/tmp";
+  return path.join(home, ".settlegrid", "telemetry-id");
+}
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function getDistinctId() {
+  const envId = process.env.SETTLEGRID_POSTHOG_ID?.trim();
+  if (envId && UUID_RE.test(envId)) return envId;
+  const file = telemetryIdPath();
+  try {
+    const existing = readFileSync(file, "utf8").trim();
+    if (UUID_RE.test(existing)) return existing;
+  } catch {
+  }
+  const id = randomUUID();
+  try {
+    mkdirSync(path.dirname(file), { recursive: true, mode: 448 });
+    writeFileSync(file, id, { mode: 384 });
+    chmodSync(file, 384);
+  } catch {
+  }
+  return id;
+}
+var fetchOverride;
+async function post(body) {
+  const fetchImpl = fetchOverride ?? globalThis.fetch;
+  if (typeof fetchImpl !== "function") {
+    return false;
+  }
+  const url = `${getProxyBase()}/api/telemetry/capture`;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), TELEMETRY_TIMEOUT_MS);
+  try {
+    const res = await fetchImpl(url, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body),
+      redirect: "error",
+      signal: controller.signal
+    });
+    return res.ok;
+  } catch {
+    return false;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function capture(event, properties) {
+  if (isOptedOut()) return false;
+  return post({
+    event,
+    properties,
+    distinct_id: getDistinctId()
+  });
+}
+async function captureCliInstallStarted(args) {
+  return capture("cli_install_started", {
+    cli_version: args.cli_version,
+    node_version: process.versions.node,
+    os: `${process.platform}-${process.arch}`
+  });
+}
+
+// src/version.ts
+import { readFileSync as readFileSync2 } from "fs";
+import * as path2 from "path";
+import { fileURLToPath } from "url";
+function readPackageVersion() {
+  try {
+    const here = path2.dirname(fileURLToPath(import.meta.url));
+    const pkgPath = path2.resolve(here, "..", "package.json");
+    const pkg = JSON.parse(readFileSync2(pkgPath, "utf8"));
+    return typeof pkg.version === "string" && pkg.version.length > 0 ? pkg.version : "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+// src/postinstall.ts
+var SAFETY_EXIT_MS = 2500;
+(async () => {
+  const safety = setTimeout(() => process.exit(0), SAFETY_EXIT_MS);
+  safety.unref();
+  try {
+    await captureCliInstallStarted({ cli_version: readPackageVersion() });
+  } catch {
+  } finally {
+    clearTimeout(safety);
+    process.exit(0);
+  }
+})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-settlegrid-tool",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Create a monetized AI tool with SettleGrid in 30 seconds",
   "keywords": [
     "settlegrid",
@@ -47,10 +47,12 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "tsc --noEmit",
+    "postinstall": "node ./dist/postinstall.js || true",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
     "fs-extra": "^11.2.0",
+    "giget": "^1.2.3",
     "picocolors": "^1.1.0",
     "prompts": "^2.4.2"
   },