@fairmint/captable-ai 0.1.37 → 0.1.39

package/dist/index.js

@@ -17321,80 +17321,6 @@ async function requireAuth() {
   return creds;
 }
 
-// src/auth/refresh-portals.ts
-var PORTALS_TTL_MS = 3e5;
-var REQUEST_TIMEOUT_MS = 1e4;
-function isStoredPortal(v) {
-  if (typeof v !== "object" || v === null) return false;
-  const obj = v;
-  return typeof obj.id === "string";
-}
-function parsePortals(body) {
-  if (typeof body !== "object" || body === null) return null;
-  if (!("portals" in body)) return null;
-  const portals = body.portals;
-  if (!Array.isArray(portals)) return null;
-  if (!portals.every(isStoredPortal)) return null;
-  return portals;
-}
-function cachedPortalsNeedNameRefresh(portals) {
-  return portals.some((portal) => typeof portal.name !== "string" || portal.name.trim() === "");
-}
-async function refreshPortalsIfStale(creds, force = false) {
-  if (!force && !cachedPortalsNeedNameRefresh(creds.portals) && creds.portalsLastFetchedAt && Date.now() - Date.parse(creds.portalsLastFetchedAt) < PORTALS_TTL_MS) {
-    return creds;
-  }
-  if (isTokenExpired(creds.accessToken)) {
-    return creds;
-  }
-  try {
-    const res = await fetch(`${getApiUrl()}/auth/portals`, {
-      headers: { Authorization: `Bearer ${creds.accessToken}` },
-      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
-    });
-    if (!res.ok) {
-      return creds;
-    }
-    const body = await res.json();
-    const portals = parsePortals(body);
-    if (portals) {
-      const updated = {
-        ...creds,
-        portals,
-        portalsLastFetchedAt: (/* @__PURE__ */ new Date()).toISOString()
-      };
-      await writeCredentials(updated);
-      return updated;
-    }
-  } catch {
-    process.stderr.write("Warning: Could not refresh company list (using cached data).\n");
-  }
-  return creds;
-}
-async function markPortalsFetched(creds) {
-  creds.portalsLastFetchedAt = (/* @__PURE__ */ new Date()).toISOString();
-  await writeCredentials(creds);
-}
-async function refreshCachedPortalNames() {
-  try {
-    const creds = await readCredentials();
-    if (!creds) return;
-    const updated = await refreshPortalsIfStale(creds, true);
-    const config2 = await readConfig();
-    const activeId = config2.activePortal?.id;
-    if (!activeId) return;
-    const portal = updated.portals.find((candidate) => candidate.id === activeId);
-    if (portal) await setActivePortal(portal);
-  } catch {
-    process.stderr.write(
-      "Warning: Could not refresh company name after updating the company list.\n"
-    );
-  }
-}
-
-// src/output.ts
-import { renameSync, rmSync, writeFileSync } from "fs";
-
 // src/exit-codes.ts
 var EXIT = {
   OK: 0,
@@ -17408,6 +17334,7 @@ var EXIT = {
 };
 
 // src/output.ts
+import { renameSync, rmSync, writeFileSync } from "fs";
 function write(msg) {
   process.stdout.write(`${msg}
 `);
@@ -17513,111 +17440,6 @@ function exitWithUsage(message, usageLine, code = "USAGE") {
   process.exit(EXIT.USAGE);
 }
 
-// src/validate-flags.ts
-function restorePositional(args, value, originalIndex) {
-  const insertAt = args.positionalIndexes.findIndex((index) => index > originalIndex);
-  if (insertAt === -1) {
-    args.positional.push(value);
-    args.positionalIndexes.push(originalIndex);
-    return;
-  }
-  args.positional.splice(insertAt, 0, value);
-  args.positionalIndexes.splice(insertAt, 0, originalIndex);
-}
-function validateFlags(args, allowed) {
-  const valueFlags = new Set(allowed.flags ?? []);
-  const booleanFlags = new Set(allowed.booleans ?? []);
-  const allAllowed = /* @__PURE__ */ new Set([...valueFlags, ...booleanFlags]);
-  const allList = [...allAllowed].map((f) => `--${f}`).join(", ");
-  for (const key of Object.keys(args.flags)) {
-    if (!allAllowed.has(key)) {
-      exitWithError(
-        `Unknown flag: --${key}. Allowed flags: ${allList || "(none)"}`,
-        "UNKNOWN_FLAG",
-        void 0,
-        EXIT.USAGE
-      );
-    }
-    if (booleanFlags.has(key) && !valueFlags.has(key) && args.flagValueSources[key] === "next") {
-      args.boolean.add(key);
-      restorePositional(args, args.flags[key], args.flagValueIndexes[key]);
-      delete args.flags[key];
-      delete args.flagValueSources[key];
-      delete args.flagValueIndexes[key];
-      continue;
-    }
-    if (booleanFlags.has(key) && !valueFlags.has(key)) {
-      exitWithError(
-        `Flag --${key} does not take a value.`,
-        "UNEXPECTED_FLAG_VALUE",
-        void 0,
-        EXIT.USAGE
-      );
-    }
-  }
-  for (const key of args.boolean) {
-    if (valueFlags.has(key)) {
-      exitWithError(`Flag --${key} requires a value.`, "MISSING_FLAG_VALUE", void 0, EXIT.USAGE);
-    }
-    if (!booleanFlags.has(key)) {
-      exitWithError(
-        `Unknown flag: --${key}. Allowed flags: ${allList || "(none)"}`,
-        "UNKNOWN_FLAG",
-        void 0,
-        EXIT.USAGE
-      );
-    }
-  }
-}
-
-// src/commands/auth-status.ts
-async function runAuthStatus(args) {
-  validateFlags(args, { flags: [], booleans: [] });
-  let creds = await readCredentials();
-  const config2 = await readConfig();
-  if (creds) {
-    creds = await refreshPortalsIfStale(creds);
-  }
-  if (!creds) {
-    if (isJsonMode()) {
-      printJson({ data: { authenticated: false } });
-    } else {
-      printLine("Not logged in. Run: captable-ai login");
-    }
-    return;
-  }
-  const expired = isTokenExpired(creds.accessToken);
-  const payload = decodeJwtPayload(creds.accessToken);
-  const expiresAt = typeof payload.exp === "number" ? new Date(payload.exp * 1e3).toISOString() : creds.expiresAt;
-  const activeCompany = resolveActiveCompany(config2, creds.portals);
-  const status = {
-    authenticated: true,
-    expired,
-    user: creds.user,
-    activeCompany,
-    tokenExpiresAt: expiresAt,
-    companyCount: creds.portals.length
-  };
-  if (isJsonMode()) {
-    printJson({ data: status });
-    return;
-  }
-  printLine(
-    expired ? "Status: Expired (will auto-refresh on next command)" : "Status: Authenticated"
-  );
-  printLine();
-  printKeyValue([
-    ["Email", creds.user.email],
-    ["User ID", creds.user.id],
-    ["Token expires", expiresAt],
-    ["Active company", activeCompany ? activeCompany.name ?? activeCompany.id : "(none)"],
-    ["Companies available", String(creds.portals.length)]
-  ]);
-}
-
-// src/commands/export.ts
-import { renameSync as renameSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
-
 // src/api.ts
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -17634,7 +17456,7 @@ function coerceDetails(raw) {
   }
   return details.length > 0 ? details : void 0;
 }
-var REQUEST_TIMEOUT_MS2 = 3e4;
+var REQUEST_TIMEOUT_MS = 3e4;
 function exitForRefreshFailure(err, softFail = false) {
   if (err instanceof Error && err.name === "AuthError") {
     failRequest(
@@ -17694,7 +17516,7 @@ async function refreshTokens(creds) {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ refreshToken: creds.refreshToken, clientType: "cli" }),
-      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS2)
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
     });
   } catch (fetchErr) {
     const err = new Error(
@@ -17764,7 +17586,7 @@ async function apiRequest(path, opts = {}) {
   const buildFetchOpts = () => ({
     method,
     headers: { ...headers },
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS2),
+    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
     ...body !== void 0 ? { body: JSON.stringify(body) } : {}
   });
   let res;
@@ -17893,6 +17715,182 @@ async function handleResponse(res, softFail = false) {
   return parsed;
 }
 
+// src/auth/refresh-portals.ts
+var PORTALS_TTL_MS = 3e5;
+var REQUEST_TIMEOUT_MS2 = 1e4;
+function isStoredPortal(v) {
+  if (typeof v !== "object" || v === null) return false;
+  const obj = v;
+  return typeof obj.id === "string";
+}
+function parsePortals(body) {
+  if (typeof body !== "object" || body === null) return null;
+  if (!("portals" in body)) return null;
+  const portals = body.portals;
+  if (!Array.isArray(portals)) return null;
+  if (!portals.every(isStoredPortal)) return null;
+  return portals;
+}
+function cachedPortalsNeedNameRefresh(portals) {
+  return portals.some((portal) => typeof portal.name !== "string" || portal.name.trim() === "");
+}
+async function refreshPortalsIfStale(creds, force = false) {
+  if (!force && !cachedPortalsNeedNameRefresh(creds.portals) && creds.portalsLastFetchedAt && Date.now() - Date.parse(creds.portalsLastFetchedAt) < PORTALS_TTL_MS) {
+    return creds;
+  }
+  if (isTokenExpired(creds.accessToken)) {
+    return creds;
+  }
+  try {
+    const res = await fetch(`${getApiUrl()}/auth/portals`, {
+      headers: { Authorization: `Bearer ${creds.accessToken}` },
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS2)
+    });
+    if (!res.ok) {
+      return creds;
+    }
+    const body = await res.json();
+    const portals = parsePortals(body);
+    if (portals) {
+      const updated = {
+        ...creds,
+        portals,
+        portalsLastFetchedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      await writeCredentials(updated);
+      return updated;
+    }
+  } catch {
+    process.stderr.write("Warning: Could not refresh company list (using cached data).\n");
+  }
+  return creds;
+}
+async function markPortalsFetched(creds) {
+  creds.portalsLastFetchedAt = (/* @__PURE__ */ new Date()).toISOString();
+  await writeCredentials(creds);
+}
+async function refreshCachedPortalNames() {
+  try {
+    const creds = await readCredentials();
+    if (!creds) return;
+    const updated = await refreshPortalsIfStale(creds, true);
+    const config2 = await readConfig();
+    const activeId = config2.activePortal?.id;
+    if (!activeId) return;
+    const portal = updated.portals.find((candidate) => candidate.id === activeId);
+    if (portal) await setActivePortal(portal);
+  } catch {
+    process.stderr.write(
+      "Warning: Could not refresh company name after updating the company list.\n"
+    );
+  }
+}
+
+// src/validate-flags.ts
+function restorePositional(args, value, originalIndex) {
+  const insertAt = args.positionalIndexes.findIndex((index) => index > originalIndex);
+  if (insertAt === -1) {
+    args.positional.push(value);
+    args.positionalIndexes.push(originalIndex);
+    return;
+  }
+  args.positional.splice(insertAt, 0, value);
+  args.positionalIndexes.splice(insertAt, 0, originalIndex);
+}
+function validateFlags(args, allowed) {
+  const valueFlags = new Set(allowed.flags ?? []);
+  const booleanFlags = new Set(allowed.booleans ?? []);
+  const allAllowed = /* @__PURE__ */ new Set([...valueFlags, ...booleanFlags]);
+  const allList = [...allAllowed].map((f) => `--${f}`).join(", ");
+  for (const key of Object.keys(args.flags)) {
+    if (!allAllowed.has(key)) {
+      exitWithError(
+        `Unknown flag: --${key}. Allowed flags: ${allList || "(none)"}`,
+        "UNKNOWN_FLAG",
+        void 0,
+        EXIT.USAGE
+      );
+    }
+    if (booleanFlags.has(key) && !valueFlags.has(key) && args.flagValueSources[key] === "next") {
+      args.boolean.add(key);
+      restorePositional(args, args.flags[key], args.flagValueIndexes[key]);
+      delete args.flags[key];
+      delete args.flagValueSources[key];
+      delete args.flagValueIndexes[key];
+      continue;
+    }
+    if (booleanFlags.has(key) && !valueFlags.has(key)) {
+      exitWithError(
+        `Flag --${key} does not take a value.`,
+        "UNEXPECTED_FLAG_VALUE",
+        void 0,
+        EXIT.USAGE
+      );
+    }
+  }
+  for (const key of args.boolean) {
+    if (valueFlags.has(key)) {
+      exitWithError(`Flag --${key} requires a value.`, "MISSING_FLAG_VALUE", void 0, EXIT.USAGE);
+    }
+    if (!booleanFlags.has(key)) {
+      exitWithError(
+        `Unknown flag: --${key}. Allowed flags: ${allList || "(none)"}`,
+        "UNKNOWN_FLAG",
+        void 0,
+        EXIT.USAGE
+      );
+    }
+  }
+}
+
+// src/commands/auth-status.ts
+async function runAuthStatus(args) {
+  validateFlags(args, { flags: [], booleans: [] });
+  let creds = await readCredentials();
+  const config2 = await readConfig();
+  if (creds) {
+    creds = await refreshPortalsIfStale(creds);
+  }
+  if (!creds) {
+    if (isJsonMode()) {
+      printJson({ data: { authenticated: false } });
+    } else {
+      printLine("Not logged in. Run: captable-ai login");
+    }
+    return;
+  }
+  const expired = isTokenExpired(creds.accessToken);
+  const payload = decodeJwtPayload(creds.accessToken);
+  const expiresAt = typeof payload.exp === "number" ? new Date(payload.exp * 1e3).toISOString() : creds.expiresAt;
+  const activeCompany = resolveActiveCompany(config2, creds.portals);
+  const status = {
+    authenticated: true,
+    expired,
+    user: creds.user,
+    activeCompany,
+    tokenExpiresAt: expiresAt,
+    companyCount: creds.portals.length
+  };
+  if (isJsonMode()) {
+    printJson({ data: status });
+    return;
+  }
+  printLine(
+    expired ? "Status: Expired (will auto-refresh on next command)" : "Status: Authenticated"
+  );
+  printLine();
+  printKeyValue([
+    ["Email", creds.user.email],
+    ["User ID", creds.user.id],
+    ["Token expires", expiresAt],
+    ["Active company", activeCompany ? activeCompany.name ?? activeCompany.id : "(none)"],
+    ["Companies available", String(creds.portals.length)]
+  ]);
+}
+
+// src/commands/export.ts
+import { renameSync as renameSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
+
 // src/flags.ts
 function looksLikeFlag(value) {
   if (!value.startsWith("-")) return false;
@@ -20924,6 +20922,20 @@ async function hashFile(path) {
   const data = await readFile4(path);
   return createHash2("sha256").update(data).digest("hex");
 }
+async function openImportSession(portalId) {
+  try {
+    const res = await apiRequest("/import-sessions", {
+      method: "POST",
+      body: { portalId },
+      // Optional: a failure must throw to the catch below, not exit the process.
+      softFail: true
+    });
+    const id = res.data?.session?.id;
+    return typeof id === "string" ? id : null;
+  } catch {
+    return null;
+  }
+}
 async function runDocumentsUpload(args, rawArgv) {
   if (rawArgv.includes("--help") || rawArgv.includes("-h")) {
     process.stdout.write(
@@ -20953,11 +20965,15 @@ async function runDocumentsUpload(args, rawArgv) {
     });
   }
   if (!isJsonMode()) printLine(`Preparing ${files.length} file(s)...`);
+  const importSessionId = await openImportSession(portalId);
   const prepareRes = await apiRequest(
     `/${portalId}/documents/prepare`,
     {
       method: "POST",
-      body: { files: files.map(({ path: _, ...f }) => f) }
+      body: {
+        files: files.map(({ path: _, ...f }) => f),
+        ...importSessionId === null ? {} : { importSessionId }
+      }
     }
   );
   const documents = prepareRes.data?.documents ?? [];
@@ -24504,6 +24520,9 @@ function exitForThrownError(err) {
   if (err instanceof AuthRequiredError) {
     exitWithError(err.message, "AUTH_REQUIRED", void 0, EXIT.AUTH);
   }
+  if (err instanceof ApiRequestError) {
+    exitWithError(err.message, err.code ?? "ERROR", err.details, EXIT.SERVER_ERROR);
+  }
   exitWithError(err.message, "ERROR", void 0, EXIT.SERVER_ERROR);
 }
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fairmint/captable-ai",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "description": "Agent-native CLI for Captable AI — manage companies, upload documents, run OCF extraction, and commit cap tables from the terminal.",
   "keywords": [
     "captable",