@publishq/sdk 0.0.2 → 0.0.4

package/README.md

@@ -79,7 +79,7 @@ await publishq.posts.removeAccount('<post-id>', '<account-id>');
 // List connected social accounts (filter by workspace / platform)
 const { data } = await publishq.accounts.list({ platform: ['TIKTOK'] });
 
-// TikTok requires fetching creator info before posting — the privacyLevel you
+// TikTok requires fetching creator info before posting. The privacyLevel you
 // set must be one of the returned privacyLevelOptions.
 const { data: info } = await publishq.accounts.getTikTokCreatorInfo('<account-id>');
 ```
@@ -128,8 +128,8 @@ const publishq = new PublishQ({
 
 ## Related
 
-- [`@publishq/cli`](https://www.npmjs.com/package/@publishq/cli) — command-line interface built on this SDK.
-- [`@publishq/mcp`](https://www.npmjs.com/package/@publishq/mcp) — Model Context Protocol server for Claude Desktop and other AI agents.
+- [`@publishq/cli`](https://www.npmjs.com/package/@publishq/cli): command-line interface built on this SDK.
+- [`@publishq/mcp`](https://www.npmjs.com/package/@publishq/mcp): Model Context Protocol server for Claude Desktop and other AI agents.
 - [API reference](https://publishq.com/docs)
 
 ## License

package/dist/index.cjs

@@ -100,7 +100,9 @@ __export(index_exports, {
   zTikTokCreatorInfoResponse: () => zTikTokCreatorInfoResponse,
   zTikTokPlatformSpecificSettings: () => zTikTokPlatformSpecificSettings,
   zTwitterPlatformSpecificSettings: () => zTwitterPlatformSpecificSettings,
+  zUpdatePostAccount: () => zUpdatePostAccount,
   zUpdatePostBody: () => zUpdatePostBody,
+  zUpdatePostOverrides: () => zUpdatePostOverrides,
   zUpdatePostPath: () => zUpdatePostPath,
   zUpdatePostRequest: () => zUpdatePostRequest,
   zUpdatePostResponse: () => zUpdatePostResponse,
@@ -1314,6 +1316,9 @@ var zYouTubePlatformSpecificSettings = z.object({
   })),
   playlistId: z.optional(z.string().register(z.globalRegistry, {
     description: "Playlist ID to add the video to after upload."
+  })),
+  thumbnailMediaId: z.optional(z.uuid().register(z.globalRegistry, {
+    description: "ID of an image in your media library to set as the custom thumbnail of this video. JPEG or PNG, up to 50MB; YouTube recommends 1280x720 (16:9). Upload the image with the media endpoints first. The thumbnail is set right after the video uploads. If YouTube refuses it (custom thumbnails need a verified channel), the video still publishes and `thumbnail` on the account says why. To replace it on a draft or scheduled post, update the account with the new id; to remove it, send `thumbnailMediaId: null`."
   }))
 }).register(z.globalRegistry, {
   description: "YouTube-specific upload settings, such as description and privacy."
@@ -1531,6 +1536,9 @@ var zPlatformSpecificSettings = z.union([
     })),
     playlistId: z.optional(z.string().register(z.globalRegistry, {
       description: "Playlist ID to add the video to after upload."
+    })),
+    thumbnailMediaId: z.optional(z.uuid().register(z.globalRegistry, {
+      description: "ID of an image in your media library to set as the custom thumbnail of this video. JPEG or PNG, up to 50MB; YouTube recommends 1280x720 (16:9). Upload the image with the media endpoints first. The thumbnail is set right after the video uploads. If YouTube refuses it (custom thumbnails need a verified channel), the video still publishes and `thumbnail` on the account says why. To replace it on a draft or scheduled post, update the account with the new id; to remove it, send `thumbnailMediaId: null`."
     }))
   }).register(z.globalRegistry, {
     description: "YouTube-specific upload settings, such as description and privacy."
@@ -1675,6 +1683,12 @@ var zPostAccount = z.object({
   errorMessage: z.optional(z.string().register(z.globalRegistry, {
     description: "Error message from the platform if publishing failed for this account."
   })),
+  thumbnail: z.optional(z.object({
+    status: z.enum(["APPLIED", "FAILED"]),
+    errorMessage: z.optional(z.string())
+  }).register(z.globalRegistry, {
+    description: "Present on a published account whose post set a custom thumbnail: whether the platform applied it, and if not, why. The post itself is live either way."
+  })),
   failure: z.optional(z.intersection(zPublishFailure, z.unknown().register(z.globalRegistry, {
     description: "The same failure read as an action: what happened and the one thing to do about it. Present whenever status is FAILED, including when the platform gave no reason. The wording is what the app and the failure email show, so a client does not have to interpret `errorMessage` itself."
   }))),
@@ -1752,6 +1766,22 @@ var zCreatePostRequest = z.object({
 }).register(z.globalRegistry, {
   description: "Create a post across one or more connected social accounts."
 });
+var zUpdatePostOverrides = z.object({
+  content: z.nullish(z.string()),
+  mediaIds: z.nullish(z.array(z.uuid()).check(z.maxLength(35))),
+  thumbnailTimestamp: z.nullish(z.int().check(z.gte(0)))
+}).register(z.globalRegistry, {
+  description: "Override the post-level content, media or thumbnail timestamp for this specific account."
+});
+var zUpdatePostAccount = z.object({
+  accountId: z.uuid().register(z.globalRegistry, {
+    description: "ID of a connected social account to post to."
+  }),
+  postOverrides: z.optional(zUpdatePostOverrides),
+  platformSpecificSettings: z.optional(z.intersection(zPlatformSpecificSettings, z.unknown().register(z.globalRegistry, {
+    description: "Platform-specific settings to change. Only the settings you send change, and every setting you leave out keeps its current value. Send a setting as null to remove it. Nested objects merge the same way (JSON Merge Patch, RFC 7396). The resulting settings must still be valid for the platform, so a required setting cannot be removed."
+  })))
+});
 var zUpdatePostRequest = z.object({
   content: z.optional(z.string().register(z.globalRegistry, {
     description: "New shared text content for the post."
@@ -1765,14 +1795,14 @@ var zUpdatePostRequest = z.object({
   thumbnailTimestamp: z.optional(z.int().check(z.gte(0)).register(z.globalRegistry, {
     description: "New video thumbnail timestamp in milliseconds for Instagram and TikTok media. Does not change which media files are attached. Combine with mediaIds if you want to replace media and set the new thumbnail timestamp in the same request."
   })),
-  accounts: z.optional(z.array(zCreatePostAccount).check(z.minLength(1)).register(z.globalRegistry, {
-    description: "Accounts whose content overrides or platform-specific settings should be updated, plus any additional connected accounts to add to the post. Existing accounts omitted from this array remain unchanged and must be removed through the account-specific delete endpoint."
+  accounts: z.optional(z.array(zUpdatePostAccount).check(z.minLength(1)).register(z.globalRegistry, {
+    description: "Accounts to change, plus any connected accounts to add to the post. For an account already in the post, only the fields you send change: omitted fields keep their current value and a field sent as null is removed. Existing accounts left out of this array stay unchanged; remove an account through the account-specific delete endpoint."
   })),
   publishNow: z.optional(z.boolean().register(z.globalRegistry, {
     description: "Publish an existing draft immediately. Cannot be combined with scheduledAt."
   }))
 }).register(z.globalRegistry, {
-  description: "Update a draft or scheduled post. Published and publishing posts cannot be updated. Media behavior is explicit: omit mediaIds to keep existing media unchanged, provide mediaIds to replace all current media, or provide an empty mediaIds array to remove all media."
+  description: "Update a draft or scheduled post. Published and publishing posts cannot be updated. Only the fields you send change; everything you leave out keeps its current value. To remove an account setting, or an account's own text, media or thumbnail timestamp, send it as null. Media behavior is explicit: omit mediaIds to keep existing media unchanged, provide mediaIds to replace all current media, or provide an empty mediaIds array to remove all media. The post that results from the update is validated as a whole before anything is saved."
 });
 var zSuccessMessage = z.object({
   deleted: z.literal(true),
@@ -2269,7 +2299,9 @@ var index_default = PublishQ;
   zTikTokCreatorInfoResponse,
   zTikTokPlatformSpecificSettings,
   zTwitterPlatformSpecificSettings,
+  zUpdatePostAccount,
   zUpdatePostBody,
+  zUpdatePostOverrides,
   zUpdatePostPath,
   zUpdatePostRequest,
   zUpdatePostResponse,