@curviate/sdk 0.41.0 → 0.42.0

package/dist/index.js

@@ -180,6 +180,28 @@ var ERROR_CODES = [
   // was charged. Stop and surface it to a human (or support) rather than
   // backing off.
   "STRIPE_DRIFT_DETECTED",
+  // Drafts and scheduled posts (`/v1/drafts`). Each is user_fixable and none
+  // clears on an unchanged retry; read the code, then change the request.
+  //
+  // - `DRAFT_LIMIT_REACHED` (422): the bucket (one account, or "no account")
+  //   already holds 50 Drafts. Delete one, or use another account.
+  // - `MEDIA_QUOTA_EXCEEDED` (422): the file would take the bucket past its
+  //   media quota; nothing was stored. Delete media first.
+  // - `ACCOUNT_REQUIRED` (422): publishing or scheduling needs an account on the
+  //   Draft (also `account_id: null` on a scheduled Draft: unschedule first).
+  // - `DRAFT_NOT_PUBLISHABLE` (422): a content gap (empty text, ...); the
+  //   message names the field.
+  // - `SCHEDULE_CONFLICT` (422): another scheduled Draft on the same account is
+  //   within 5 minutes of this `scheduled_at`; the message names it.
+  // - `DRAFT_PUBLISHING` (409): a publish of this Draft is in flight (or its
+  //   outcome is being settled). Read the Draft again in a few seconds; if it
+  //   says to check the account's posts first, do that before retrying.
+  "DRAFT_LIMIT_REACHED",
+  "MEDIA_QUOTA_EXCEEDED",
+  "ACCOUNT_REQUIRED",
+  "DRAFT_NOT_PUBLISHABLE",
+  "SCHEDULE_CONFLICT",
+  "DRAFT_PUBLISHING",
   // Generic
   "INTERNAL"
 ];
@@ -357,6 +379,11 @@ function buildInit(method, opts, signal) {
     authorization: `Bearer ${opts.apiKey}`
   };
   const init = { method, headers, signal };
+  if (opts.rawBody !== void 0 && method !== "GET" && method !== "HEAD") {
+    headers["content-type"] = opts.rawBody.contentType;
+    init.body = opts.rawBody.data;
+    return init;
+  }
   if (method === "GET" || method === "HEAD" || opts.body === void 0) {
     return init;
   }
@@ -487,7 +514,8 @@ function createContext(config, accountId) {
       maxRetries: config.maxRetries,
       ...config.fetch ? { fetch: config.fetch } : {},
       ...args.query !== void 0 ? { query: args.query } : {},
-      ...args.body !== void 0 ? { body: args.body } : {}
+      ...args.body !== void 0 ? { body: args.body } : {},
+      ...args.rawBody !== void 0 ? { rawBody: args.rawBody } : {}
     });
   };
   return { request, accountId };
@@ -3089,6 +3117,145 @@ var WebhooksResource = class {
   }
 };
 
+// src/resources/drafts.ts
+var DraftsResource = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  /**
+   * Store a Draft. Every field is optional, `account_id` and `text` included.
+   * `POST /v1/drafts`
+   *
+   * With `scheduled_at` (ISO 8601 with offset, between 5 minutes and 365 days
+   * ahead) the Draft is scheduled in the same call and needs an account and
+   * publishable text. Up to 50 Drafts and 2 GiB of media per account, and per
+   * no-account. A retry creates a second Draft.
+   *
+   * @example
+   * const draft = await curviate.drafts.create({
+   *   account_id: "acc_01J8Z3K9P0Q1R2S3T4V5W6X7Y8",
+   *   text: "Three things we learned shipping our first agent integration.",
+   *   scheduled_at: "2026-10-12T09:00:00+02:00",
+   * });
+   * // draft.status === "scheduled"
+   */
+  create(body = {}) {
+    return this.ctx.request({
+      method: "POST",
+      path: "/v1/drafts",
+      body
+    });
+  }
+  /**
+   * List Drafts, cursor-paginated. `GET /v1/drafts`
+   *
+   * `status` defaults to `["draft", "scheduled", "failed"]`; add `"published"`
+   * to include publish records (`object: "publish_record"`, never Drafts).
+   * `account_id` is an `acc_` id or `"none"`. `from`/`to` are a half-open
+   * `[from, to)` range on each item's own date.
+   *
+   * @example
+   * const page = await curviate.drafts.list({ status: ["scheduled"], order: "asc" });
+   */
+  list(params) {
+    const { status, ...rest } = params ?? {};
+    return this.ctx.request({
+      method: "GET",
+      path: "/v1/drafts",
+      query: { ...rest, ...status !== void 0 ? { status: status.join(",") } : {} }
+    });
+  }
+  /**
+   * Return one Draft, with a fresh signed link (valid 1 hour) per attachment.
+   * `GET /v1/drafts/{id}`
+   *
+   * @example
+   * const draft = await curviate.drafts.get("drf_01J8Z3K9P0Q1R2S3T4V5W6X7Y8");
+   */
+  get(id) {
+    return this.ctx.request({
+      method: "GET",
+      path: apiPath`/v1/drafts/${id}`
+    });
+  }
+  /**
+   * Partial update: an omitted field is left as is, `null` clears it.
+   * `PATCH /v1/drafts/{id}`
+   *
+   * `attachments` replaces the whole list (`{ id }` keeps a file, a base64
+   * object adds one, anything left out is deleted). `scheduled_at` schedules,
+   * reschedules or, with `null`, unschedules. Editing a `failed` Draft clears
+   * its `failure`. A Draft being published answers `409 DRAFT_PUBLISHING`.
+   *
+   * @example
+   * await curviate.drafts.update(id, { scheduled_at: null }); // unschedule
+   */
+  update(id, body) {
+    return this.ctx.request({
+      method: "PATCH",
+      path: apiPath`/v1/drafts/${id}`,
+      body
+    });
+  }
+  /**
+   * Delete the Draft and its stored media (bodyless, 204).
+   * `DELETE /v1/drafts/{id}`
+   *
+   * @example
+   * await curviate.drafts.delete(id);
+   */
+  async delete(id) {
+    await this.ctx.request({
+      method: "DELETE",
+      path: apiPath`/v1/drafts/${id}`
+    });
+  }
+  /**
+   * Publish the Draft now, under the same rules and safety limits as
+   * `posts.create`. `POST /v1/drafts/{id}/publish`
+   *
+   * Success deletes the Draft and its media, writes a publish record and
+   * returns `{ object: "post_created", id }`; no webhook is sent. A known
+   * failure leaves the Draft unchanged. A `504` or `502` whose message says
+   * the outcome is unknown means the post may be live: check the account's
+   * posts before retrying.
+   *
+   * @example
+   * const { id: postId } = await curviate.drafts.publish(draftId);
+   */
+  publish(id) {
+    return this.ctx.request({
+      method: "POST",
+      path: apiPath`/v1/drafts/${id}/publish`
+    });
+  }
+  /**
+   * Add one file to the Draft as the raw request body, for media too large to
+   * send inline: an MP4 video or a PDF, each up to 50 MiB. An image is capped at 5 MiB on
+   * every route. One file per call.
+   * `POST /v1/drafts/{id}/attachments?filename=...`
+   *
+   * Small files (up to 5 MiB) can instead ride inline in `create` / `update`
+   * as base64. Resolves with the Draft, the new attachment last.
+   *
+   * @example
+   * const bytes = await readFile("clip.mp4");
+   * const draft = await curviate.drafts.uploadAttachment(id, bytes, {
+   *   filename: "clip.mp4",
+   *   contentType: "video/mp4",
+   * });
+   */
+  uploadAttachment(id, data, options) {
+    const contentType = options.contentType ?? (data instanceof Blob ? data.type : "");
+    return this.ctx.request({
+      method: "POST",
+      path: apiPath`/v1/drafts/${id}/attachments`,
+      query: { filename: options.filename },
+      rawBody: { data, contentType }
+    });
+  }
+};
+
 // src/resources/index.ts
 function buildNamespaces(ctx) {
   return {
@@ -3109,14 +3276,16 @@ function buildNamespaces(ctx) {
     recruiter: new RecruiterResource(ctx),
     jobs: new JobsResource(ctx),
     companies: new CompaniesResource(ctx),
-    webhooks: new WebhooksResource(ctx)
+    webhooks: new WebhooksResource(ctx),
+    drafts: new DraftsResource(ctx)
   };
 }
 function buildRootNamespaces(ctx) {
   return {
     accounts: new AccountsResource(ctx),
     auth: new AuthResource(ctx),
-    webhooks: new WebhooksResource(ctx)
+    webhooks: new WebhooksResource(ctx),
+    drafts: new DraftsResource(ctx)
   };
 }
 function buildAccountScopedNamespaces(ctx) {
@@ -3124,11 +3293,13 @@ function buildAccountScopedNamespaces(ctx) {
     accounts: _accounts,
     auth: _auth,
     webhooks: _webhooks,
+    drafts: _drafts,
     ...rest
   } = buildNamespaces(ctx);
   void _accounts;
   void _auth;
   void _webhooks;
+  void _drafts;
   return rest;
 }
 
@@ -3141,6 +3312,7 @@ var Curviate = class {
     this.accounts = ns.accounts;
     this.auth = ns.auth;
     this.webhooks = ns.webhooks;
+    this.drafts = ns.drafts;
   }
   /**
    * Return an account-scoped accessor that fixes `account_id` on every call,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curviate/sdk",
-  "version": "0.41.0",
+  "version": "0.42.0",
   "private": false,
   "description": "TypeScript SDK for the Curviate API.",
   "license": "MIT",