@koderlabs/tasks-cli 0.1.0

package/dist/index.cjs

@@ -0,0 +1,1045 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  buildProgram: () => buildProgram,
+  main: () => main
+});
+module.exports = __toCommonJS(index_exports);
+var import_commander = require("commander");
+var import_picocolors8 = __toESM(require("picocolors"), 1);
+
+// src/api.ts
+var ApiError = class extends Error {
+  static {
+    __name(this, "ApiError");
+  }
+  status;
+  body;
+  constructor(status, message, body) {
+    super(message), this.status = status, this.body = body;
+    this.name = "ApiError";
+  }
+};
+var ApiClient = class {
+  static {
+    __name(this, "ApiClient");
+  }
+  apiUrl;
+  key;
+  fetchImpl;
+  maxRetries;
+  retryBaseMs;
+  constructor(opts) {
+    this.apiUrl = opts.apiUrl.replace(/\/+$/, "");
+    this.key = opts.key;
+    this.fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    this.maxRetries = opts.maxRetries ?? 3;
+    this.retryBaseMs = opts.retryBaseMs ?? 500;
+    if (!this.fetchImpl) {
+      throw new Error("No fetch implementation available. Use Node >= 18.");
+    }
+  }
+  /** Upload one or more source-map artifacts to a release. */
+  async uploadSourceMaps(version, environment, files) {
+    const url = `${this.apiUrl}/sdk/source-maps?version=${encodeURIComponent(version)}&environment=${encodeURIComponent(environment)}`;
+    const form = new FormData();
+    for (const f of files) {
+      const bytes = toUint8(f.content);
+      const blob = new Blob([
+        bytes
+      ], {
+        type: "application/json"
+      });
+      form.append("files", blob, f.filename);
+    }
+    return this.request("POST", url, form);
+  }
+  /** Create (or upsert) a release without uploading any artifacts. */
+  async createRelease(version, environment) {
+    return this.uploadSourceMaps(version, environment, []);
+  }
+  async request(method, url, body) {
+    let attempt = 0;
+    let lastErr;
+    while (attempt <= this.maxRetries) {
+      try {
+        const res = await this.fetchImpl(url, {
+          method,
+          headers: {
+            authorization: `Bearer ${this.key}`
+          },
+          body
+        });
+        if (res.status === 401 || res.status === 403) {
+          const txt = await safeText(res);
+          throw new ApiError(res.status, `Authentication failed (HTTP ${res.status}). Check your management key. ${txt}`.trim(), txt);
+        }
+        if (res.status === 429 || res.status >= 500) {
+          const retryAfter = parseRetryAfter(res.headers.get("retry-after"));
+          if (attempt < this.maxRetries) {
+            const wait2 = retryAfter ?? this.retryBaseMs * Math.pow(2, attempt);
+            await sleep(wait2);
+            attempt++;
+            continue;
+          }
+          const txt = await safeText(res);
+          throw new ApiError(res.status, `HTTP ${res.status} after ${attempt + 1} attempts. ${txt}`.trim(), txt);
+        }
+        if (!res.ok) {
+          const txt = await safeText(res);
+          throw new ApiError(res.status, `HTTP ${res.status}: ${txt}`.trim(), txt);
+        }
+        const json = await res.json();
+        return json && typeof json === "object" && "data" in json ? json.data : json;
+      } catch (err) {
+        if (err instanceof ApiError && err.status !== 429 && err.status < 500) throw err;
+        lastErr = err;
+        if (attempt >= this.maxRetries) throw err;
+        await sleep(this.retryBaseMs * Math.pow(2, attempt));
+        attempt++;
+      }
+    }
+    throw lastErr ?? new Error("Unreachable");
+  }
+};
+function toUint8(content) {
+  if (content instanceof Uint8Array) return content;
+  return new Uint8Array(content);
+}
+__name(toUint8, "toUint8");
+async function safeText(res) {
+  try {
+    return await res.text();
+  } catch {
+    return "";
+  }
+}
+__name(safeText, "safeText");
+function parseRetryAfter(header) {
+  if (!header) return null;
+  const n = Number(header);
+  if (Number.isFinite(n) && n >= 0) return n * 1e3;
+  const date = Date.parse(header);
+  if (Number.isFinite(date)) return Math.max(0, date - Date.now());
+  return null;
+}
+__name(parseRetryAfter, "parseRetryAfter");
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+__name(sleep, "sleep");
+
+// src/config.ts
+var import_node_fs = require("fs");
+var path = __toESM(require("path"), 1);
+var DEFAULT_API_URL = "http://localhost:11002/api/v1";
+var RC_FILENAME = ".tasksrc.json";
+function findRcFile(start) {
+  let dir = path.resolve(start);
+  while (true) {
+    const candidate = path.join(dir, RC_FILENAME);
+    if ((0, import_node_fs.existsSync)(candidate)) return candidate;
+    const parent = path.dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+__name(findRcFile, "findRcFile");
+function loadRc(start) {
+  const file = findRcFile(start);
+  if (!file) return {
+    data: {}
+  };
+  try {
+    const data = JSON.parse((0, import_node_fs.readFileSync)(file, "utf-8"));
+    return {
+      file,
+      data
+    };
+  } catch {
+    return {
+      file,
+      data: {}
+    };
+  }
+}
+__name(loadRc, "loadRc");
+function resolveConfig(input = {}, env = process.env) {
+  const { file: rcFile, data: rc } = loadRc(input.cwd ?? process.cwd());
+  const apiUrl = (input.apiUrl ?? env.INSTANTTASKS_ENDPOINT ?? env.INSTANTTASKS_API_URL ?? rc.endpoint ?? rc.apiUrl ?? DEFAULT_API_URL).replace(/\/+$/, "");
+  const key = input.key ?? env.INSTANTTASKS_INGEST_KEY ?? env.INSTANTTASKS_MANAGEMENT_KEY ?? rc.ingestKey ?? rc.key ?? "";
+  const projectId = input.projectId ?? env.INSTANTTASKS_PROJECT_ID ?? rc.projectId;
+  if (!key && !input.optionalKey) {
+    throw new Error("Missing key. Pass --key sk_live_... / pk_live_..., set INSTANTTASKS_INGEST_KEY, or add it to .tasksrc.json.");
+  }
+  if (key && !/^(sk|pk)_/.test(key)) {
+    throw new Error(`Invalid key format: expected sk_live_... / pk_live_..., got "${key.slice(0, 6)}\u2026".`);
+  }
+  return {
+    apiUrl,
+    key,
+    projectId,
+    rcFile
+  };
+}
+__name(resolveConfig, "resolveConfig");
+
+// src/commands/upload-sourcemaps.ts
+var import_node_fs2 = require("fs");
+var path2 = __toESM(require("path"), 1);
+var import_picocolors = __toESM(require("picocolors"), 1);
+async function uploadSourcemaps(opts) {
+  const log = opts.log ?? ((s) => console.log(s));
+  const env = opts.environment ?? "production";
+  const root = path2.resolve(opts.dir);
+  const maps = await walkForMaps(root);
+  if (maps.length === 0) {
+    log(import_picocolors.default.yellow(`No .js.map files found under ${root}`));
+    return 0;
+  }
+  log(import_picocolors.default.cyan(`Uploading ${maps.length} source map(s) to release ${opts.release} (${env})\u2026`));
+  const files = [];
+  for (const absPath of maps) {
+    const rel = path2.relative(root, absPath).split(path2.sep).join("/");
+    const url = opts.urlPrefix ? joinUrl(opts.urlPrefix, rel.replace(/\.map$/, "")) : void 0;
+    const content = await import_node_fs2.promises.readFile(absPath);
+    files.push({
+      filename: path2.basename(absPath),
+      url,
+      content
+    });
+    log(`  ${import_picocolors.default.dim("\u2192")} ${rel}${url ? import_picocolors.default.dim(`  (${url})`) : ""}`);
+  }
+  const result = await opts.apiClient.uploadSourceMaps(opts.release, env, files);
+  log(import_picocolors.default.green(`Done. Release ${result.release.version} now has ${result.uploaded.length} artifact(s).`));
+  return result.uploaded.length;
+}
+__name(uploadSourcemaps, "uploadSourcemaps");
+async function walkForMaps(dir) {
+  const out = [];
+  let entries;
+  try {
+    entries = await import_node_fs2.promises.readdir(dir, {
+      withFileTypes: true
+    });
+  } catch (err) {
+    throw new Error(`Cannot read directory ${dir}: ${err.message}`);
+  }
+  for (const entry of entries) {
+    const full = path2.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      const nested = await walkForMaps(full);
+      out.push(...nested);
+    } else if (entry.isFile() && entry.name.endsWith(".js.map")) {
+      out.push(full);
+    }
+  }
+  return out.sort();
+}
+__name(walkForMaps, "walkForMaps");
+function joinUrl(prefix, rel) {
+  const left = prefix.replace(/\/+$/, "");
+  const right = rel.replace(/^\/+/, "");
+  return `${left}/${right}`;
+}
+__name(joinUrl, "joinUrl");
+
+// src/commands/releases.ts
+var import_picocolors2 = __toESM(require("picocolors"), 1);
+async function createRelease(opts) {
+  const log = opts.log ?? ((s) => console.log(s));
+  const env = opts.environment ?? "production";
+  log(import_picocolors2.default.cyan(`Creating release ${opts.name} (${env})\u2026`));
+  const result = await opts.apiClient.createRelease(opts.name, env);
+  log(import_picocolors2.default.green(`Release ${result.release.version} ready (id=${result.release.id}).`));
+  return result.release.id;
+}
+__name(createRelease, "createRelease");
+
+// src/commands/doctor.ts
+var import_picocolors3 = __toESM(require("picocolors"), 1);
+async function doctor(opts = {}) {
+  const log = opts.log ?? ((s) => console.log(s));
+  const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+  const checks = [];
+  let cfg;
+  try {
+    cfg = resolveConfig({
+      apiUrl: opts.apiUrl,
+      key: opts.key,
+      projectId: opts.projectId
+    });
+    checks.push({
+      name: "config",
+      ok: true,
+      detail: `endpoint=${cfg.apiUrl}${cfg.rcFile ? ` (rc=${cfg.rcFile})` : ""}`
+    });
+  } catch (err) {
+    checks.push({
+      name: "config",
+      ok: false,
+      detail: err.message
+    });
+    return finish(checks, log);
+  }
+  if (!cfg.projectId) {
+    checks.push({
+      name: "projectId",
+      ok: false,
+      detail: "INSTANTTASKS_PROJECT_ID not set (some commands require it)."
+    });
+  } else {
+    checks.push({
+      name: "projectId",
+      ok: true,
+      detail: cfg.projectId
+    });
+  }
+  const configUrl = `${cfg.apiUrl}/sdk/v1/config`;
+  try {
+    const res = await fetchImpl(configUrl, {
+      method: "GET",
+      headers: {
+        authorization: `Bearer ${cfg.key}`
+      }
+    });
+    if (res.ok) {
+      checks.push({
+        name: "endpoint",
+        ok: true,
+        detail: `${configUrl} \u2192 ${res.status}`
+      });
+      checks.push({
+        name: "ingestKey",
+        ok: true,
+        detail: "authenticated"
+      });
+    } else if (res.status === 401 || res.status === 403) {
+      checks.push({
+        name: "endpoint",
+        ok: true,
+        detail: `${configUrl} reachable (${res.status})`
+      });
+      checks.push({
+        name: "ingestKey",
+        ok: false,
+        detail: `key rejected (HTTP ${res.status}) \u2014 check INSTANTTASKS_INGEST_KEY`
+      });
+    } else {
+      checks.push({
+        name: "endpoint",
+        ok: false,
+        detail: `${configUrl} \u2192 HTTP ${res.status}`
+      });
+    }
+  } catch (err) {
+    checks.push({
+      name: "endpoint",
+      ok: false,
+      detail: `cannot reach ${configUrl}: ${err.message}`
+    });
+  }
+  if (cfg.key.startsWith("pk_")) {
+    checks.push({
+      name: "sourcemapPermission",
+      ok: false,
+      detail: "pk_ keys cannot upload source maps \u2014 use sk_live_... for CI uploads"
+    });
+  } else if (cfg.key.startsWith("sk_")) {
+    checks.push({
+      name: "sourcemapPermission",
+      ok: true,
+      detail: "sk_ key has upload role"
+    });
+  }
+  return finish(checks, log);
+}
+__name(doctor, "doctor");
+function finish(checks, log) {
+  for (const c of checks) {
+    const mark = c.ok ? import_picocolors3.default.green("\u2713") : import_picocolors3.default.red("\u2717");
+    log(`  ${mark} ${import_picocolors3.default.bold(c.name.padEnd(20))} ${c.ok ? import_picocolors3.default.dim(c.detail) : import_picocolors3.default.yellow(c.detail)}`);
+  }
+  const ok = checks.every((c) => c.ok);
+  log("");
+  log(ok ? import_picocolors3.default.green("All checks passed.") : import_picocolors3.default.red("One or more checks failed."));
+  return {
+    ok,
+    checks
+  };
+}
+__name(finish, "finish");
+
+// src/commands/sourcemap-upload.ts
+var import_node_fs3 = require("fs");
+var path3 = __toESM(require("path"), 1);
+var import_picocolors4 = __toESM(require("picocolors"), 1);
+var DEFAULT_MAX_BYTES = 50 * 1024 * 1024;
+var MAX_RETRIES = 3;
+var RETRY_BASE_MS = 500;
+async function sourcemapUpload(opts) {
+  const log = opts.log ?? ((s) => console.log(s));
+  const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+  const maxBytes = opts.maxBytes ?? DEFAULT_MAX_BYTES;
+  const strict = opts.strict !== false;
+  const root = path3.resolve(opts.dist);
+  const maps = await walk(root);
+  if (maps.length === 0) {
+    log(import_picocolors4.default.yellow(`No .map files found under ${root}`));
+    return {
+      uploaded: 0,
+      failed: 0,
+      skipped: 0
+    };
+  }
+  log(import_picocolors4.default.cyan(`Uploading ${maps.length} source map(s)${opts.release ? ` for release ${opts.release}` : ""}\u2026`));
+  let uploaded = 0;
+  let failed = 0;
+  let skipped = 0;
+  for (const absPath of maps) {
+    const safe = safeRelative(root, absPath);
+    if (!safe) {
+      log(import_picocolors4.default.red(`  \u2717 ${absPath} \u2014 path escapes dist root`));
+      failed++;
+      continue;
+    }
+    const stat = await import_node_fs3.promises.stat(absPath);
+    if (stat.size > maxBytes) {
+      log(import_picocolors4.default.yellow(`  \u26A0 ${safe} \u2014 ${stat.size} bytes exceeds cap ${maxBytes}, skipping`));
+      skipped++;
+      continue;
+    }
+    const content = await import_node_fs3.promises.readFile(absPath, "utf-8");
+    const ok = await postWithRetry(fetchImpl, opts.apiUrl, opts.key, {
+      path: safe,
+      content,
+      release: opts.release,
+      environment: opts.environment
+    });
+    if (ok.ok) {
+      log(`  ${import_picocolors4.default.green("\u2713")} ${safe}`);
+      uploaded++;
+    } else {
+      log(import_picocolors4.default.red(`  \u2717 ${safe} \u2014 ${ok.detail}`));
+      failed++;
+    }
+  }
+  log("");
+  log(`${import_picocolors4.default.bold("Summary:")} ${import_picocolors4.default.green(`${uploaded} uploaded`)}, ${failed ? import_picocolors4.default.red(`${failed} failed`) : `${failed} failed`}, ${skipped} skipped.`);
+  if (failed > 0 && strict) {
+    throw new Error(`${failed} source-map upload(s) failed (use --no-strict to ignore).`);
+  }
+  return {
+    uploaded,
+    failed,
+    skipped
+  };
+}
+__name(sourcemapUpload, "sourcemapUpload");
+function safeRelative(root, abs) {
+  const resolvedRoot = path3.resolve(root);
+  const resolved = path3.resolve(abs);
+  if (!resolved.startsWith(resolvedRoot + path3.sep) && resolved !== resolvedRoot) return null;
+  const rel = path3.relative(resolvedRoot, resolved);
+  if (!rel || rel.startsWith("..") || path3.isAbsolute(rel)) return null;
+  return rel.split(path3.sep).join("/");
+}
+__name(safeRelative, "safeRelative");
+async function walk(dir) {
+  const out = [];
+  let entries;
+  try {
+    entries = await import_node_fs3.promises.readdir(dir, {
+      withFileTypes: true
+    });
+  } catch {
+    return out;
+  }
+  for (const entry of entries) {
+    if (entry.isSymbolicLink()) continue;
+    const full = path3.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      out.push(...await walk(full));
+    } else if (entry.isFile() && entry.name.endsWith(".map")) {
+      out.push(full);
+    }
+  }
+  return out.sort();
+}
+__name(walk, "walk");
+async function postWithRetry(fetchImpl, apiUrl, key, body) {
+  const url = `${apiUrl.replace(/\/+$/, "")}/sdk/source-maps`;
+  let lastDetail = "unknown";
+  for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+    try {
+      const res = await fetchImpl(url, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${key}`
+        },
+        body: JSON.stringify(body)
+      });
+      if (res.ok) return {
+        ok: true,
+        detail: `HTTP ${res.status}`
+      };
+      lastDetail = `HTTP ${res.status}`;
+      if (res.status !== 429 && (res.status < 500 || res.status >= 600)) {
+        return {
+          ok: false,
+          detail: lastDetail
+        };
+      }
+    } catch (err) {
+      lastDetail = err.message;
+    }
+    if (attempt < MAX_RETRIES) {
+      await new Promise((r) => setTimeout(r, RETRY_BASE_MS * Math.pow(2, attempt)));
+    }
+  }
+  return {
+    ok: false,
+    detail: lastDetail
+  };
+}
+__name(postWithRetry, "postWithRetry");
+
+// src/commands/symbols-upload.ts
+var import_node_fs4 = require("fs");
+var path4 = __toESM(require("path"), 1);
+var import_picocolors5 = __toESM(require("picocolors"), 1);
+var NATIVE_SYMBOLS_PATH = "/sdk/native-symbols";
+async function uploadIos(dsymPath, opts) {
+  const log = opts.log ?? ((s) => console.log(s));
+  const root = path4.resolve(dsymPath);
+  if (!root.endsWith(".dSYM")) {
+    log(import_picocolors5.default.yellow(`Warning: ${root} does not end in .dSYM \u2014 proceeding anyway.`));
+  }
+  const dwarfRoot = path4.join(root, "Contents", "Resources", "DWARF");
+  const files = await listFiles(dwarfRoot);
+  if (files.length === 0) {
+    log(import_picocolors5.default.yellow(`No DWARF files found under ${dwarfRoot}`));
+    return {
+      uploaded: 0,
+      failed: 0,
+      endpointMissing: false
+    };
+  }
+  log(import_picocolors5.default.cyan(`Uploading ${files.length} iOS symbol file(s)\u2026`));
+  return uploadAll(files, "ios", opts, log);
+}
+__name(uploadIos, "uploadIos");
+async function uploadAndroid(mappingPath, opts) {
+  const log = opts.log ?? ((s) => console.log(s));
+  const resolved = path4.resolve(mappingPath);
+  const stat = await import_node_fs4.promises.stat(resolved).catch(() => null);
+  if (!stat?.isFile()) {
+    throw new Error(`mapping.txt not found at ${resolved}`);
+  }
+  log(import_picocolors5.default.cyan(`Uploading Android mapping ${resolved}\u2026`));
+  return uploadAll([
+    resolved
+  ], "android", opts, log);
+}
+__name(uploadAndroid, "uploadAndroid");
+async function uploadAll(files, platform, opts, log) {
+  const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+  const url = `${opts.apiUrl.replace(/\/+$/, "")}${NATIVE_SYMBOLS_PATH}`;
+  let uploaded = 0;
+  let failed = 0;
+  let endpointMissing = false;
+  for (const file of files) {
+    const content = await import_node_fs4.promises.readFile(file);
+    const body = {
+      platform,
+      filename: path4.basename(file),
+      release: opts.release,
+      // Base64-encoded so binary DWARFs survive JSON transport.
+      contentBase64: content.toString("base64")
+    };
+    try {
+      const res = await fetchImpl(url, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${opts.key}`
+        },
+        body: JSON.stringify(body)
+      });
+      if (res.status === 404) {
+        endpointMissing = true;
+        log(import_picocolors5.default.yellow(`  \u26A0 ${path4.basename(file)} \u2014 endpoint pending (${NATIVE_SYMBOLS_PATH} returned 404)`));
+      } else if (res.ok) {
+        log(`  ${import_picocolors5.default.green("\u2713")} ${path4.basename(file)}`);
+        uploaded++;
+      } else {
+        log(import_picocolors5.default.red(`  \u2717 ${path4.basename(file)} \u2014 HTTP ${res.status}`));
+        failed++;
+      }
+    } catch (err) {
+      log(import_picocolors5.default.red(`  \u2717 ${path4.basename(file)} \u2014 ${err.message}`));
+      failed++;
+    }
+  }
+  if (endpointMissing) {
+    log("");
+    log(import_picocolors5.default.yellow(`Backend resolver pending: ${NATIVE_SYMBOLS_PATH} is not yet implemented. Symbol files were prepared but not stored server-side.`));
+  }
+  return {
+    uploaded,
+    failed,
+    endpointMissing
+  };
+}
+__name(uploadAll, "uploadAll");
+async function listFiles(dir) {
+  const out = [];
+  let entries;
+  try {
+    entries = await import_node_fs4.promises.readdir(dir, {
+      withFileTypes: true
+    });
+  } catch {
+    return out;
+  }
+  for (const entry of entries) {
+    if (entry.isSymbolicLink()) continue;
+    const full = path4.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      out.push(...await listFiles(full));
+    } else if (entry.isFile()) {
+      out.push(full);
+    }
+  }
+  return out;
+}
+__name(listFiles, "listFiles");
+
+// src/commands/init.ts
+var import_node_fs5 = require("fs");
+var path5 = __toESM(require("path"), 1);
+var import_picocolors6 = __toESM(require("picocolors"), 1);
+var SUPPORTED_PLATFORMS = [
+  "web",
+  "react",
+  "nextjs",
+  "vue",
+  "rn",
+  "nestjs"
+];
+var RC_TEMPLATE = `{
+  "endpoint": "https://tasks.koderlabs.net/api/v1",
+  "ingestKey": "pk_live_REPLACE_ME",
+  "projectId": "REPLACE_WITH_PROJECT_UUID"
+}
+`;
+var README_SNIPPET = `
+## InstantTasks SDK
+
+Run \`npx @koderlabs/tasks-cli doctor\` to verify your setup.
+
+Upload source maps in CI:
+
+\`\`\`sh
+npx @koderlabs/tasks-cli sourcemap upload ./dist --release "$GIT_SHA"
+\`\`\`
+`;
+function planInit(platform) {
+  const files = [
+    {
+      filepath: ".tasksrc.json",
+      contents: RC_TEMPLATE
+    },
+    {
+      filepath: "INSTANTTASKS.md",
+      contents: README_SNIPPET.trim() + "\n"
+    }
+  ];
+  files.push({
+    filepath: snippetPath(platform),
+    contents: snippetFor(platform)
+  });
+  return files;
+}
+__name(planInit, "planInit");
+function snippetPath(platform) {
+  switch (platform) {
+    case "web":
+      return "src/tasks-sdk.ts";
+    case "react":
+      return "src/tasks-sdk.ts";
+    case "nextjs":
+      return "instrumentation.ts";
+    case "vue":
+      return "src/tasks-sdk.ts";
+    case "rn":
+      return "src/tasks-sdk.ts";
+    case "nestjs":
+      return "src/tasks-sdk.ts";
+  }
+}
+__name(snippetPath, "snippetPath");
+function snippetFor(platform) {
+  switch (platform) {
+    case "web":
+    case "react":
+    case "vue":
+      return `import { init } from '@koderlabs/tasks-sdk-browser';
+
+init({
+  endpoint: import.meta.env.VITE_TASKS_ENDPOINT,
+  ingestKey: import.meta.env.VITE_TASKS_INGEST_KEY,
+  release: import.meta.env.VITE_RELEASE,
+});
+`;
+    case "nextjs":
+      return `// Next.js 13+ instrumentation hook \u2014 auto-loaded once per process.
+export async function register() {
+  const { init } = await import('@koderlabs/tasks-sdk-nextjs');
+  init({
+    endpoint: process.env.NEXT_PUBLIC_TASKS_ENDPOINT!,
+    ingestKey: process.env.NEXT_PUBLIC_TASKS_INGEST_KEY!,
+    release: process.env.NEXT_PUBLIC_RELEASE,
+  });
+}
+`;
+    case "rn":
+      return `import { init } from '@koderlabs/tasks-sdk-rn';
+
+init({
+  endpoint: process.env.EXPO_PUBLIC_TASKS_ENDPOINT!,
+  ingestKey: process.env.EXPO_PUBLIC_TASKS_INGEST_KEY!,
+  release: process.env.EXPO_PUBLIC_RELEASE,
+});
+`;
+    case "nestjs":
+      return `import { init } from '@koderlabs/tasks-sdk-node';
+
+init({
+  endpoint: process.env.INSTANTTASKS_ENDPOINT!,
+  ingestKey: process.env.INSTANTTASKS_INGEST_KEY!,
+  release: process.env.RELEASE,
+});
+`;
+  }
+}
+__name(snippetFor, "snippetFor");
+async function initScaffold(opts) {
+  const log = opts.log ?? ((s) => console.log(s));
+  const cwd = path5.resolve(opts.cwd ?? process.cwd());
+  const files = planInit(opts.platform);
+  const written = [];
+  const skipped = [];
+  log(import_picocolors6.default.cyan(`Scaffolding InstantTasks for ${import_picocolors6.default.bold(opts.platform)}\u2026`));
+  for (const f of files) {
+    const abs = path5.join(cwd, f.filepath);
+    const exists = await import_node_fs5.promises.stat(abs).then(() => true).catch(() => false);
+    if (opts.dryRun) {
+      log(import_picocolors6.default.dim(`  [dry-run] would write ${f.filepath}${exists ? " (overwrite)" : ""}`));
+      log(import_picocolors6.default.dim("  \u250C\u2500"));
+      for (const line of f.contents.split("\n")) log(import_picocolors6.default.dim(`  \u2502 ${line}`));
+      log(import_picocolors6.default.dim("  \u2514\u2500"));
+      continue;
+    }
+    if (exists && !opts.force) {
+      log(import_picocolors6.default.yellow(`  \u26A0 ${f.filepath} exists \u2014 skipping (pass --force to overwrite)`));
+      skipped.push(f.filepath);
+      continue;
+    }
+    await import_node_fs5.promises.mkdir(path5.dirname(abs), {
+      recursive: true
+    });
+    await import_node_fs5.promises.writeFile(abs, f.contents, "utf-8");
+    log(`  ${import_picocolors6.default.green("\u2713")} ${f.filepath}`);
+    written.push(f.filepath);
+  }
+  if (!opts.dryRun) {
+    log("");
+    log(import_picocolors6.default.green("Done. Edit .tasksrc.json with your project credentials, then run:"));
+    log(`  ${import_picocolors6.default.bold("npx @koderlabs/tasks-cli doctor")}`);
+  }
+  return {
+    files,
+    written,
+    skipped
+  };
+}
+__name(initScaffold, "initScaffold");
+
+// src/commands/events-tail.ts
+var import_picocolors7 = __toESM(require("picocolors"), 1);
+async function eventsTail(opts) {
+  const log = opts.log ?? ((s) => console.log(s));
+  const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+  const interval = opts.intervalMs ?? 5e3;
+  let since = opts.since ?? Date.now();
+  log(import_picocolors7.default.cyan(`Tailing events (poll every ${interval}ms). Ctrl-C to exit.`));
+  while (!opts.signal?.aborted) {
+    const params = new URLSearchParams({
+      since: String(since)
+    });
+    if (opts.projectId) params.set("projectId", opts.projectId);
+    for (const [k, v] of Object.entries(opts.filter ?? {})) params.set(k, v);
+    const url = `${opts.apiUrl.replace(/\/+$/, "")}/sdk/v1/events?${params.toString()}`;
+    try {
+      const res = await fetchImpl(url, {
+        method: "GET",
+        headers: {
+          authorization: `Bearer ${opts.key}`
+        },
+        signal: opts.signal
+      });
+      if (res.status === 404) {
+        log(import_picocolors7.default.yellow(`events endpoint not available yet (404). Backend needs to ship /sdk/v1/events \u2014 exiting tail loop.`));
+        return;
+      }
+      if (res.ok) {
+        const body = await res.json();
+        const rows = Array.isArray(body) ? body : Array.isArray(body?.data) ? body.data : [];
+        for (const row of rows) {
+          const ts = typeof row.ts === "number" ? new Date(row.ts).toISOString() : String(row.ts);
+          const kind = row.kind ?? "event";
+          const message = row.message ?? "";
+          const url2 = row.url ? import_picocolors7.default.dim(` ${row.url}`) : "";
+          log(`${import_picocolors7.default.dim(ts)} | ${import_picocolors7.default.bold(kind.padEnd(12))} | ${message}${url2}`);
+          if (typeof row.ts === "number") since = Math.max(since, row.ts + 1);
+        }
+        if (rows.length === 0) {
+          since = Date.now();
+        }
+      } else {
+        log(import_picocolors7.default.yellow(`poll failed: HTTP ${res.status}`));
+      }
+    } catch (err) {
+      if (err.name === "AbortError") return;
+      log(import_picocolors7.default.yellow(`poll error: ${err.message}`));
+    }
+    await wait(interval, opts.signal);
+  }
+}
+__name(eventsTail, "eventsTail");
+function wait(ms, signal) {
+  return new Promise((resolve6) => {
+    const t = setTimeout(resolve6, ms);
+    signal?.addEventListener("abort", () => {
+      clearTimeout(t);
+      resolve6();
+    });
+  });
+}
+__name(wait, "wait");
+function parseSince(input, now = Date.now()) {
+  if (!input) return now;
+  const match = input.match(/^(\d+)([smhd])$/);
+  if (!match) {
+    const n = Number(input);
+    return Number.isFinite(n) ? n : now;
+  }
+  const value = parseInt(match[1], 10);
+  const unit = match[2];
+  const mult = unit === "s" ? 1e3 : unit === "m" ? 6e4 : unit === "h" ? 36e5 : 864e5;
+  return now - value * mult;
+}
+__name(parseSince, "parseSince");
+
+// src/index.ts
+var VERSION = "0.0.0";
+function buildProgram() {
+  const program = new import_commander.Command();
+  program.name("tasks").description("InstantTasks CLI \u2014 doctor, source maps, symbols, init, events tail").version(VERSION);
+  program.command("doctor").description("Validate config + connectivity (CI-friendly; non-zero on failure)").option("--api-url <url>", "API base URL (defaults to env / .tasksrc.json)").option("--key <key>", "Ingest or management key").option("--project <id>", "Project ID").action(async (opts) => {
+    const result = await doctor({
+      apiUrl: opts.apiUrl,
+      key: opts.key,
+      projectId: opts.project
+    });
+    if (!result.ok) process.exit(1);
+  });
+  const sourcemap = program.command("sourcemap").description("Source-map utilities");
+  sourcemap.command("upload <dist>").description("Recursively upload .map files from a dist directory").option("--release <sha>", "Release name / version (associates maps with a release)").option("--environment <env>", "Release environment", "production").option("--max-size <bytes>", "Per-file size cap in bytes", String(50 * 1024 * 1024)).option("--no-strict", "Do not exit non-zero on individual file failures").option("--api-url <url>", "API base URL").option("--key <key>", "Management key (sk_live_...)").action(async (dist, opts) => {
+    const cfg = resolveConfig({
+      apiUrl: opts.apiUrl,
+      key: opts.key
+    });
+    await sourcemapUpload({
+      dist,
+      apiUrl: cfg.apiUrl,
+      key: cfg.key,
+      release: opts.release,
+      environment: opts.environment,
+      maxBytes: Number(opts.maxSize),
+      strict: opts.strict !== false
+    });
+  });
+  const symbols = program.command("symbols").description("Native symbol uploads (iOS dSYM, Android ProGuard)");
+  symbols.command("upload-ios <dsym>").description("Upload DWARF files from a .dSYM bundle").option("--release <sha>", "Release name / version").option("--api-url <url>").option("--key <key>").action(async (dsym, opts) => {
+    const cfg = resolveConfig({
+      apiUrl: opts.apiUrl,
+      key: opts.key
+    });
+    await uploadIos(dsym, {
+      apiUrl: cfg.apiUrl,
+      key: cfg.key,
+      release: opts.release
+    });
+  });
+  symbols.command("upload-android <mapping>").description("Upload an Android ProGuard mapping.txt").option("--release <sha>", "Release name / version").option("--api-url <url>").option("--key <key>").action(async (mapping, opts) => {
+    const cfg = resolveConfig({
+      apiUrl: opts.apiUrl,
+      key: opts.key
+    });
+    await uploadAndroid(mapping, {
+      apiUrl: cfg.apiUrl,
+      key: cfg.key,
+      release: opts.release
+    });
+  });
+  program.command("init <platform>").description(`Scaffold .tasksrc.json + init snippet (platforms: ${SUPPORTED_PLATFORMS.join(", ")})`).option("--dry-run", "Print files that would be written but do not write them").option("--force", "Overwrite existing files").action(async (platform, opts) => {
+    if (!SUPPORTED_PLATFORMS.includes(platform)) {
+      throw new Error(`Unsupported platform "${platform}". Pick one of: ${SUPPORTED_PLATFORMS.join(", ")}`);
+    }
+    await initScaffold({
+      platform,
+      dryRun: opts.dryRun,
+      force: opts.force
+    });
+  });
+  const events = program.command("events").description("Event utilities");
+  events.command("tail").description("Stream recent SDK events (long-poll fallback until WebSocket lands)").option("--filter <kv...>", "Filter, e.g. project=<id>").option("--since <duration>", "Lookback window (e.g. 10m, 1h)").option("--interval <ms>", "Poll interval in ms", "5000").option("--api-url <url>").option("--key <key>").option("--project <id>").action(async (opts) => {
+    const cfg = resolveConfig({
+      apiUrl: opts.apiUrl,
+      key: opts.key,
+      projectId: opts.project
+    });
+    const filter = {};
+    const rawFilters = Array.isArray(opts.filter) ? opts.filter : opts.filter ? [
+      opts.filter
+    ] : [];
+    for (const kv of rawFilters) {
+      const [k, v] = String(kv).split("=");
+      if (k && v) filter[k] = v;
+    }
+    const controller = new AbortController();
+    const onSig = /* @__PURE__ */ __name(() => {
+      console.log(import_picocolors8.default.dim("\n  (exiting)"));
+      controller.abort();
+    }, "onSig");
+    process.once("SIGINT", onSig);
+    process.once("SIGTERM", onSig);
+    await eventsTail({
+      apiUrl: cfg.apiUrl,
+      key: cfg.key,
+      projectId: cfg.projectId,
+      since: parseSince(opts.since),
+      intervalMs: Number(opts.interval) || 5e3,
+      filter,
+      signal: controller.signal
+    });
+  });
+  program.command("upload-sourcemaps").description("[legacy] Upload .js.map files in a directory to a release").requiredOption("--release <name>", "Release name / version").requiredOption("--dir <path>", "Directory to walk for *.js.map files").option("--environment <env>", "Release environment", "production").option("--url-prefix <prefix>", "Public URL prefix for source files").option("--project <projectId>").option("--api-url <url>").option("--key <key>").action(async (opts) => {
+    const cfg = resolveConfig({
+      apiUrl: opts.apiUrl,
+      key: opts.key,
+      projectId: opts.project
+    });
+    const client = new ApiClient({
+      apiUrl: cfg.apiUrl,
+      key: cfg.key
+    });
+    await uploadSourcemaps({
+      release: opts.release,
+      dir: opts.dir,
+      environment: opts.environment,
+      urlPrefix: opts.urlPrefix,
+      apiClient: client
+    });
+  });
+  program.command("create-release").description("Create (or upsert) a release on the server").requiredOption("--name <name>", "Release name / version").option("--environment <env>", "Release environment", "production").option("--project <projectId>").option("--api-url <url>").option("--key <key>").action(async (opts) => {
+    const cfg = resolveConfig({
+      apiUrl: opts.apiUrl,
+      key: opts.key,
+      projectId: opts.project
+    });
+    const client = new ApiClient({
+      apiUrl: cfg.apiUrl,
+      key: cfg.key
+    });
+    await createRelease({
+      name: opts.name,
+      environment: opts.environment,
+      apiClient: client
+    });
+  });
+  return program;
+}
+__name(buildProgram, "buildProgram");
+async function main(argv = process.argv) {
+  const program = buildProgram();
+  program.exitOverride();
+  try {
+    await program.parseAsync(argv);
+    return 0;
+  } catch (err) {
+    if (err instanceof ApiError) {
+      console.error(import_picocolors8.default.red(`API error (${err.status}): ${err.message}`));
+      return 1;
+    }
+    const anyErr = err;
+    if (anyErr && typeof anyErr === "object" && "code" in anyErr) {
+      if (anyErr.code === "commander.helpDisplayed" || anyErr.code === "commander.version") return 0;
+      if (anyErr.code === "commander.help") return 0;
+    }
+    console.error(import_picocolors8.default.red(err.message || String(err)));
+    return 1;
+  }
+}
+__name(main, "main");
+var isEntry = (() => {
+  try {
+    const argv1 = process.argv[1] ?? "";
+    return /(?:^|[\\/])(tasks|instanttasks-cli|index\.[mc]?js)$/.test(argv1);
+  } catch {
+    return false;
+  }
+})();
+if (isEntry) {
+  main().then((code) => process.exit(code));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildProgram,
+  main
+});
+//# sourceMappingURL=index.cjs.map