@curviate/cli 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -6,6 +6,31 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html):
 a new command or flag is a minor; a breaking command/flag/exit-code change is a major; a fix is a patch.
 
+## [Unreleased]
+
+## [0.17.0] - 2026-07-17
+
+A minor release adding the `company follow-invite` and `company invitable-followers`
+commands. No breaking changes, built against `@curviate/sdk` 0.17.0.
+
+### Added
+
+- **`company follow-invite <id> --invitee <AC…> [--invitee <AC…> ...]`** (write, admin-gated,
+  `--preview` accepted). Invites the connected account's 1st-degree connections to follow an
+  administered company page. `--invitee` is repeatable, at least one required, max 50 per
+  request. All-or-nothing: for an all-valid request you get one outcome per requested invitee,
+  in request order (`status: "invited" | "already_invited" | "ineligible" | "not_found"`); if
+  any invitee id is invalid the whole request rejects with a 404, not a partial result.
+  Re-inviting an already-invited member is a safe no-op, the same `invitation_id`, never a
+  duplicate. `<id>`
+  accepts a URL, slug, or numeric id, resolved to the numeric provider_id first (including
+  under `--preview`, so the preview renders the actual request that would be sent).
+- **`company invitable-followers <id> [--limit] [--cursor] [--all]`** (paginated read). Lists
+  the connections eligible to be invited to follow a company page you administer, the read
+  that seeds `company follow-invite`. Items carry no name or headline; hydrate a candidate via
+  `profile <id>` first. `invite_token` is always re-encoded as base64 in CLI output (the raw
+  value can carry bytes unsafe to print in a terminal), in every output mode.
+
 ## [0.16.0] - 2026-07-17
 
 A minor release adding the `inboxes` command group. No breaking changes,

package/dist/{account-ZDIZAXVI.js → account-VDKORNPQ.js}

@@ -8,18 +8,18 @@ import {
 import {
   AUTH_NEEDED
 } from "./chunk-M6UDWFHX.js";
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import {
   slimAccountGet,
   slimAccountList,
   slimAccountListItem
-} from "./chunk-45KHSWCV.js";
+} from "./chunk-ROULHEFW.js";
 import {
   pageDelayFromFlags,
   streamAll
 } from "./chunk-EEMJDJ4W.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,

package/dist/{chunk-45KHSWCV.js → chunk-ROULHEFW.js}

@@ -255,6 +255,32 @@ function slimCompany(data) {
     follower_count: d["follower_count"] ?? null
   };
 }
+function encodeInviteToken(token) {
+  if (typeof token !== "string" || token.length === 0) return token;
+  return Buffer.from(token, "utf8").toString("base64");
+}
+function reencodeInviteTokenItem(item) {
+  if (!("invite_token" in item)) return item;
+  return { ...item, invite_token: encodeInviteToken(item["invite_token"]) };
+}
+function reencodeInvitableFollowers(data) {
+  const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
+  const items = Array.isArray(d["items"]) ? d["items"].map(reencodeInviteTokenItem) : [];
+  return { ...d, items };
+}
+function slimCompanyInvitableFollowerItem(item) {
+  return {
+    object: item["object"] ?? null,
+    id: item["id"] ?? null,
+    profile_urn: item["profile_urn"] ?? null,
+    invite_token: item["invite_token"] ?? null
+  };
+}
+function slimCompanyInvitableFollowers(data) {
+  const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
+  const items = Array.isArray(d["items"]) ? d["items"].map(slimCompanyInvitableFollowerItem) : [];
+  return { ...d, items };
+}
 
 export {
   slimProfileMe,
@@ -275,5 +301,8 @@ export {
   slimAccountList,
   slimAccountGet,
   slimJob,
-  slimCompany
+  slimCompany,
+  reencodeInviteTokenItem,
+  reencodeInvitableFollowers,
+  slimCompanyInvitableFollowers
 };

package/dist/cli.js

@@ -255,20 +255,20 @@ var main = defineCommand({
     // ---------------------------------------------------------------------------
     // Noun groups — lazy-loaded on first invocation.
     // ---------------------------------------------------------------------------
-    profile: () => import("./profile-JUTGTPES.js").then((m) => m.profileCommand),
-    company: () => import("./company-XU7TZ66L.js").then((m) => m.companyCommand),
-    job: () => import("./job-QLSGNDGW.js").then((m) => m.jobCommand),
-    connect: () => import("./connect-7OWBNGHU.js").then((m) => m.connectCommand),
-    search: () => import("./search-5U5U5MTT.js").then((m) => m.searchCommand),
-    inbox: () => import("./inbox-VVRQ7SOX.js").then((m) => m.inboxCommand),
+    profile: () => import("./profile-MLSIFVDJ.js").then((m) => m.profileCommand),
+    company: () => import("./company-CU3BEHRW.js").then((m) => m.companyCommand),
+    job: () => import("./job-6GEPEDLS.js").then((m) => m.jobCommand),
+    connect: () => import("./connect-DO3J5OUV.js").then((m) => m.connectCommand),
+    search: () => import("./search-ZQUKLQ6T.js").then((m) => m.searchCommand),
+    inbox: () => import("./inbox-RZOMPFDA.js").then((m) => m.inboxCommand),
     inboxes: () => import("./inboxes-MTPWLP5F.js").then((m) => m.inboxesCommand),
-    message: () => import("./message-IKKOI6CZ.js").then((m) => m.messageCommand),
-    post: () => import("./post-DH4RDYKZ.js").then((m) => m.postCommand),
-    comment: () => import("./comment-COJY6HQP.js").then((m) => m.commentCommand),
-    account: () => import("./account-ZDIZAXVI.js").then((m) => m.accountCommand),
-    webhook: () => import("./webhook-UWIOVWVV.js").then((m) => m.webhookCommand),
-    "sales-nav": () => import("./sales-nav-NUCYJ4S3.js").then((m) => m.salesNavCommand),
-    recruiter: () => import("./recruiter-WEZZVZN3.js").then((m) => m.recruiterCommand)
+    message: () => import("./message-KOSPK33G.js").then((m) => m.messageCommand),
+    post: () => import("./post-TSOE327K.js").then((m) => m.postCommand),
+    comment: () => import("./comment-56VBPLGW.js").then((m) => m.commentCommand),
+    account: () => import("./account-VDKORNPQ.js").then((m) => m.accountCommand),
+    webhook: () => import("./webhook-QFSZN3P2.js").then((m) => m.webhookCommand),
+    "sales-nav": () => import("./sales-nav-GD5WQCJI.js").then((m) => m.salesNavCommand),
+    recruiter: () => import("./recruiter-OWEQIFYG.js").then((m) => m.recruiterCommand)
   },
   async run() {
     const { runMain } = await import("citty");

package/dist/{company-XU7TZ66L.js → company-CU3BEHRW.js}

@@ -3,15 +3,21 @@ import {
   resolveIdentifier
 } from "./chunk-DMQZEPQE.js";
 import {
+  reencodeInvitableFollowers,
+  reencodeInviteTokenItem,
   slimCompany,
+  slimCompanyInvitableFollowers,
   slimSearchJobs,
   slimSearchPeople,
   slimSearchPosts
-} from "./chunk-45KHSWCV.js";
+} from "./chunk-ROULHEFW.js";
 import {
   pageDelayFromFlags,
   streamAll
 } from "./chunk-EEMJDJ4W.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,
@@ -20,7 +26,8 @@ import {
   resolveEffectiveConfig
 } from "./chunk-M33MI53G.js";
 import {
-  GLOBAL_FLAGS
+  GLOBAL_FLAGS,
+  WRITE_FLAGS
 } from "./chunk-TMU3CSPR.js";
 
 // src/commands/company.ts
@@ -52,6 +59,10 @@ function resolveOutputOpts(flags) {
     verbose: flags.verbose ?? false
   };
 }
+function normalizeInviteeIds(invitee) {
+  if (!invitee) return [];
+  return Array.isArray(invitee) ? invitee : [invitee];
+}
 async function resolveCompanyId(ns, raw) {
   const normalized = resolveIdentifier(raw);
   if (/^\d+$/.test(normalized)) return normalized;
@@ -176,6 +187,64 @@ async function runCompanyJobs(client, flags, out) {
     await handleSdkError(err, outOpts, out);
   }
 }
+async function runCompanyInvitableFollowers(client, flags, out) {
+  rejectPreviewOnRead(flags.preview, out);
+  const accountId = requireAccount(flags.account, out);
+  const ns = client.account(accountId);
+  const outOpts = resolveOutputOpts(flags);
+  const params = {};
+  if (flags.limit) params["limit"] = parseInt(flags.limit, 10);
+  if (flags.cursor) params["cursor"] = flags.cursor;
+  try {
+    const identifier = await resolveCompanyId(ns, flags.id ?? "");
+    if (flags.all) {
+      const maxPages = flags["max-pages"] ? parseInt(flags["max-pages"], 10) : 100;
+      const fn = (p) => ns.companies.invitableFollowers(identifier, p);
+      for await (const item of streamAll(fn, params, {
+        maxPages,
+        out,
+        pageDelayMs: pageDelayFromFlags(flags)
+      })) {
+        out.stdout.write(JSON.stringify(reencodeInviteTokenItem(item)) + "\n");
+      }
+      return;
+    }
+    const result = await ns.companies.invitableFollowers(identifier, params);
+    const safeResult = reencodeInvitableFollowers(result);
+    renderSuccess(safeResult, { ...outOpts, slim: slimCompanyInvitableFollowers }, out);
+  } catch (err) {
+    await handleSdkError(err, outOpts, out);
+  }
+}
+async function runCompanyFollowInvite(client, flags, out) {
+  const accountId = requireAccount(flags.account, out);
+  const ns = client.account(accountId);
+  const outOpts = resolveOutputOpts(flags);
+  const inviteeIds = normalizeInviteeIds(flags.invitee);
+  if (inviteeIds.length === 0) {
+    out.stderr.write("error: at least one --invitee is required.\n");
+    process.exit(2);
+    return;
+  }
+  try {
+    const identifier = await resolveCompanyId(ns, flags.id ?? "");
+    const body = { invitee_ids: inviteeIds };
+    if (flags.preview) {
+      const preview = buildPreviewOutput({
+        method: "companies.followInvite",
+        args: { identifier },
+        body,
+        account: accountId
+      });
+      out.stdout.write(JSON.stringify(preview) + "\n");
+      return;
+    }
+    const result = await ns.companies.followInvite(identifier, body);
+    renderSuccess(result, outOpts, out);
+  } catch (err) {
+    await handleSdkError(err, outOpts, out);
+  }
+}
 var companyEmployeesCommand = defineCommand({
   meta: { name: "employees", description: "List people who currently work at the company." },
   args: {
@@ -251,6 +320,64 @@ var companyJobsCommand = defineCommand({
     await runCompanyJobs(client, { ...flags, account: flags.account ?? cfg.account }, out);
   }
 });
+var companyInvitableFollowersCommand = defineCommand({
+  meta: {
+    name: "invitable-followers",
+    description: "List the account's 1st-degree connections who are eligible to be invited to follow the company page. This is the read that seeds `company follow-invite`. Items carry no name or headline (a wire limitation), so hydrate a candidate via `profile <id>` before deciding who to invite. `invite_token` is always returned as base64 (the raw value can carry binary bytes unsafe to print)."
+  },
+  args: {
+    ...GLOBAL_FLAGS,
+    id: { type: "positional", description: "Company identifier (URL, slug, or numeric id), resolved to the numeric id first." }
+  },
+  async run({ args }) {
+    const flags = args;
+    const cfg = await resolveEffectiveConfig({
+      apiKey: flags["api-key"],
+      baseUrl: flags["base-url"],
+      timeout: flags.timeout,
+      account: flags.account,
+      profile: flags.profile
+    });
+    if (!cfg.apiKey) {
+      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.exit(3);
+    }
+    const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
+    const out = buildOutputStreams();
+    await runCompanyInvitableFollowers(client, { ...flags, account: flags.account ?? cfg.account }, out);
+  }
+});
+var companyFollowInviteCommand = defineCommand({
+  meta: {
+    name: "follow-invite",
+    description: "Invite the account's 1st-degree connections to follow the administered company page. Write, admin-gated (the account must administer the page with invite rights). Pass the AC\u2026 member ids from `company invitable-followers`, one --invitee per invitee. All-or-nothing: for an all-valid request you get one outcome per invitee, in request order (invited/already_invited/ineligible/not_found); if any invitee id is invalid the whole request rejects with a 404, not a partial result. Re-inviting an already-invited member is a safe no-op (the same invitation id, never a duplicate)."
+  },
+  args: {
+    ...WRITE_FLAGS,
+    id: { type: "positional", description: "Company identifier (URL, slug, or numeric id), resolved to the numeric id first, including under --preview." },
+    invitee: {
+      type: "string",
+      description: "AC\u2026 member id to invite (from `company invitable-followers`). Repeatable, at least one required, max 50 per request."
+    }
+  },
+  async run({ args }) {
+    const flags = args;
+    const cfg = await resolveEffectiveConfig({
+      apiKey: flags["api-key"],
+      baseUrl: flags["base-url"],
+      timeout: flags.timeout,
+      account: flags.account,
+      profile: flags.profile
+    });
+    if (!cfg.apiKey) {
+      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.exit(3);
+    }
+    const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
+    const out = buildOutputStreams();
+    await runCompanyFollowInvite(client, { ...flags, account: flags.account ?? cfg.account }, out);
+  }
+});
 var companyCommand = defineCommand({
   meta: { name: "company", description: "Fetch a company profile by URL, slug, or numeric id, and its sub-resources." },
   args: {
@@ -261,7 +388,9 @@ var companyCommand = defineCommand({
   subCommands: {
     employees: companyEmployeesCommand,
     posts: companyPostsCommand,
-    jobs: companyJobsCommand
+    jobs: companyJobsCommand,
+    "invitable-followers": companyInvitableFollowersCommand,
+    "follow-invite": companyFollowInviteCommand
   },
   async run({ args }) {
     const flags = args;
@@ -284,7 +413,9 @@ var companyCommand = defineCommand({
 export {
   companyCommand,
   runCompanyEmployees,
+  runCompanyFollowInvite,
   runCompanyGet,
+  runCompanyInvitableFollowers,
   runCompanyJobs,
   runCompanyPosts
 };

package/dist/{connect-7OWBNGHU.js → connect-DO3J5OUV.js}

@@ -1,7 +1,4 @@
 #!/usr/bin/env node
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import {
   resolveIdentifier
 } from "./chunk-DMQZEPQE.js";
@@ -10,11 +7,14 @@ import {
   slimInviteReceivedItem,
   slimInviteSent,
   slimInviteSentItem
-} from "./chunk-45KHSWCV.js";
+} from "./chunk-ROULHEFW.js";
 import {
   pageDelayFromFlags,
   streamAll
 } from "./chunk-EEMJDJ4W.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,

package/dist/{job-QLSGNDGW.js → job-6GEPEDLS.js}

@@ -3,21 +3,21 @@ import {
   BinaryOutputError,
   writeBinaryOutput
 } from "./chunk-UWO2D4HW.js";
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import {
   resolveJobIdentifier
 } from "./chunk-DMQZEPQE.js";
 import {
   slimJob
-} from "./chunk-45KHSWCV.js";
+} from "./chunk-ROULHEFW.js";
 import {
   DEFAULT_PAGE_DELAY_MS,
   ndjsonModeNotice,
   pageDelayFromFlags,
   streamAll
 } from "./chunk-EEMJDJ4W.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,

package/dist/{profile-JUTGTPES.js → profile-MLSIFVDJ.js}

@@ -8,20 +8,20 @@ import {
   readAttachment,
   toAttachmentPayload
 } from "./chunk-BGZW6B7G.js";
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import {
   resolveIdentifier
 } from "./chunk-DMQZEPQE.js";
 import {
   slimProfile,
   slimProfileMe
-} from "./chunk-45KHSWCV.js";
+} from "./chunk-ROULHEFW.js";
 import {
   pageDelayFromFlags,
   streamAll
 } from "./chunk-EEMJDJ4W.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,

package/dist/{recruiter-WEZZVZN3.js → recruiter-OWEQIFYG.js}

@@ -13,20 +13,20 @@ import {
   BinaryOutputError,
   writeBinaryOutput
 } from "./chunk-UWO2D4HW.js";
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import {
   resolveIdentifier,
   resolveJobIdentifier
 } from "./chunk-DMQZEPQE.js";
 import {
   slimJob
-} from "./chunk-45KHSWCV.js";
+} from "./chunk-ROULHEFW.js";
 import {
   pageDelayFromFlags,
   streamAll
 } from "./chunk-EEMJDJ4W.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,

package/dist/{search-5U5U5MTT.js → search-ZQUKLQ6T.js}

@@ -14,7 +14,7 @@ import {
   slimSearchPeopleItem,
   slimSearchPosts,
   slimSearchPostsItem
-} from "./chunk-45KHSWCV.js";
+} from "./chunk-ROULHEFW.js";
 import {
   pageDelayFromFlags,
   streamAll

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curviate/cli",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "private": false,
   "description": "Official command-line interface for the Curviate API.",
   "license": "MIT",
@@ -41,7 +41,7 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@curviate/sdk": "^0.16.0",
+    "@curviate/sdk": "^0.17.0",
     "citty": "^0.1.6",
     "open": "^10.1.0"
   },

package/dist/{comment-COJY6HQP.js → comment-56VBPLGW.js}

@@ -11,14 +11,14 @@ import {
   readAttachment,
   toAttachmentPayload
 } from "./chunk-BGZW6B7G.js";
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import "./chunk-DMQZEPQE.js";
 import {
   pageDelayFromFlags,
   streamAll
 } from "./chunk-EEMJDJ4W.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,

package/dist/{inbox-VVRQ7SOX.js → inbox-RZOMPFDA.js}

@@ -1,7 +1,4 @@
 #!/usr/bin/env node
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import {
   normalizeChatId
 } from "./chunk-DMQZEPQE.js";
@@ -9,6 +6,9 @@ import {
   pageDelayFromFlags,
   streamAll
 } from "./chunk-EEMJDJ4W.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,

package/dist/{message-IKKOI6CZ.js → message-KOSPK33G.js}

@@ -11,13 +11,13 @@ import {
   BinaryOutputError,
   writeBinaryOutput
 } from "./chunk-UWO2D4HW.js";
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import {
   normalizeChatId,
   resolveIdentifier
 } from "./chunk-DMQZEPQE.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,

package/dist/{post-DH4RDYKZ.js → post-TSOE327K.js}

@@ -10,14 +10,14 @@ import {
   readAttachment,
   toAttachmentPayload
 } from "./chunk-BGZW6B7G.js";
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import "./chunk-DMQZEPQE.js";
 import {
   pageDelayFromFlags,
   streamAll
 } from "./chunk-EEMJDJ4W.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,

package/dist/{sales-nav-NUCYJ4S3.js → sales-nav-GD5WQCJI.js}

@@ -10,9 +10,6 @@ import {
   readAttachment,
   toAttachmentPayload
 } from "./chunk-BGZW6B7G.js";
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import {
   resolveIdentifier
 } from "./chunk-DMQZEPQE.js";
@@ -20,6 +17,9 @@ import {
   pageDelayFromFlags,
   streamAll
 } from "./chunk-EEMJDJ4W.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,

package/dist/{webhook-UWIOVWVV.js → webhook-QFSZN3P2.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import {
-  buildPreviewOutput
-} from "./chunk-R3VLWLVV.js";
 import {
   pageDelayFromFlags,
   streamAll
 } from "./chunk-EEMJDJ4W.js";
+import {
+  buildPreviewOutput
+} from "./chunk-R3VLWLVV.js";
 import {
   createClient,
   renderError,