@curviate/sdk 0.41.0 → 0.42.0

package/CHANGELOG.md

@@ -9,6 +9,36 @@ Versioning: semantic. Minor for additive changes, patch for bug fixes; no stabil
 
 ## [Unreleased]
 
+## [0.42.0] - 2026-10-07
+
+Fixture and types regenerated from the server integration branch (134 paths,
+server `b1c443c6a3a0e1c2a09944be39f01c6921fca46c`), **not** from a deployed
+document: regenerate from deployed staging and confirm an empty diff before
+publishing.
+
+### Added
+
+- **`drafts` resource** (root-scoped, 7 methods): `create`, `list`, `get`,
+  `update`, `delete`, `publish`, `uploadAttachment`. A Draft is a stored,
+  editable post that Curviate publishes at `scheduled_at` (ISO 8601 with
+  offset, passed through unchanged). `list` takes `status` as an array and
+  sends it as the API's comma list; `status: ["published"]` returns publish
+  records. `uploadAttachment(id, data, { filename, contentType })` sends a
+  file (an MP4 video or PDF up to 50 MiB; an image is capped at 5 MiB) as the raw request body.
+  `delete` resolves with `undefined` (204). (`posts.delete` and `comments.delete`
+  still hand back the transport's empty buffer under a `void` type; unchanged here.)
+- **Six new error codes** decode to themselves instead of `INTERNAL`:
+  `DRAFT_LIMIT_REACHED`, `MEDIA_QUOTA_EXCEEDED`, `ACCOUNT_REQUIRED`,
+  `DRAFT_NOT_PUBLISHABLE`, `SCHEDULE_CONFLICT`, `DRAFT_PUBLISHING`.
+- **`post.published` and `post.publish_failed` webhook events** join
+  `CurviateEvent` (`PostPublishedPayload`, `PostPublishFailedPayload`).
+  Payloads carry ids and times, never post text or media.
+- `Draft*` request and result types are exported.
+
+### Changed
+
+- The webhook `source` enum includes `post`, from the regenerated types.
+
 ## [0.41.0] - 2026-10-03
 
 Fixture and types regenerated against the deployed staging document

package/README.md

@@ -46,7 +46,7 @@ await curviate.auth.intent({ seat_id, auth_method: "credentials", credentials: {
 The `curviate.account(id)` accessor fixes the `account_id` on every call so you do not have to thread it manually:
 
 ```ts
-// Root-level: tenant-wide operations (accounts, auth, webhooks)
+// Root-level: tenant-wide operations (accounts, auth, webhooks, drafts)
 const { items: accounts } = await curviate.accounts.list();
 
 // Account-scoped: all LinkedIn ops under a specific account
@@ -58,6 +58,30 @@ const me = await acc.users.get("me");           // your own profile
 const profile = await acc.users.get("some-user-id"); // someone else's
 ```
 
+## Drafts and scheduled posts
+
+A Draft is a stored, editable, unpublished post. Give it an account and a `scheduled_at` and Curviate publishes it at that time. Drafts are tenant-wide, so `drafts` hangs off the root client (a Draft's `account_id` is a field, and optional). `acc.posts.create()` still publishes immediately and does not schedule.
+
+```ts
+const draft = await curviate.drafts.create({
+  account_id: "acc_...",
+  text: "Three things we learned shipping our first agent integration.",
+  scheduled_at: "2026-10-12T09:00:00+02:00", // ISO 8601 with offset; 5 min to 365 days ahead
+});
+
+// A video or PDF (up to 50 MiB) goes up as the raw body; images (up to 5 MiB) can ride inline as base64.
+await curviate.drafts.uploadAttachment(draft.id, await readFile("clip.mp4"), {
+  filename: "clip.mp4",
+  contentType: "video/mp4",
+});
+
+await curviate.drafts.update(draft.id, { scheduled_at: null }); // unschedule
+const { id: postId } = await curviate.drafts.publish(draft.id); // or publish now
+const { items } = await curviate.drafts.list({ status: ["scheduled", "published"] });
+```
+
+Refusals carry their own codes: `DRAFT_LIMIT_REACHED`, `MEDIA_QUOTA_EXCEEDED`, `ACCOUNT_REQUIRED`, `DRAFT_NOT_PUBLISHABLE`, `SCHEDULE_CONFLICT` and `DRAFT_PUBLISHING`. A scheduled publish that fails raises the `post.publish_failed` webhook (`post.published` on success); a `failure_code` of `outcome_unknown` means the post may be live, so check the account's posts before retrying.
+
 ---
 
 ## First end-to-end call