@getlatedev/node 0.2.1166 → 0.2.1168

package/dist/index.d.mts

@@ -12248,7 +12248,7 @@ type SupportRun = {
      */
     threadId: string;
     /**
-     * queued and running are in progress. needs_human means Ana handed the question to a person instead of answering; when `supportTicket` is set, a Zernio teammate has been notified and will follow up by email.
+     * queued and running are in progress. needs_human means the assistant handed the question to a person instead of answering; when `supportTicket` is set, a Zernio teammate has been notified and will follow up by email.
      */
     status: 'queued' | 'running' | 'completed' | 'needs_human' | 'failed';
     /**
@@ -12256,7 +12256,11 @@ type SupportRun = {
      */
     stopReason: ('answered' | 'human_review' | 'cost_cap' | 'deadline' | 'max_iterations' | 'error' | 'expired') | null;
     /**
-     * Ana's answer. Null while the run is in progress or when it failed.
+     * The question as asked, with leading and trailing whitespace trimmed. Null only on runs created before this field was added.
+     */
+    question: (string) | null;
+    /**
+     * The assistant's answer. Null while the run is in progress or when it failed.
      */
     answer: (string) | null;
     usage: SupportRunUsage;
@@ -12272,7 +12276,7 @@ type SupportRun = {
     startedAt: (string) | null;
     finishedAt: (string) | null;
     /**
-     * Set when Ana opened a support ticket with the Zernio team. Null otherwise. A teammate follows up by email with the user whose API key started the run.
+     * Set when the assistant opened a support ticket with the Zernio team. Null otherwise. A teammate follows up by email with the user whose API key started the run.
      */
     supportTicket: {
         openedAt: string;
@@ -12283,7 +12287,7 @@ type SupportRun = {
     pollAfterSeconds?: number;
 };
 /**
- * queued and running are in progress. needs_human means Ana handed the question to a person instead of answering; when `supportTicket` is set, a Zernio teammate has been notified and will follow up by email.
+ * queued and running are in progress. needs_human means the assistant handed the question to a person instead of answering; when `supportTicket` is set, a Zernio teammate has been notified and will follow up by email.
  */
 type status29 = 'queued' | 'running' | 'completed' | 'needs_human' | 'failed';
 /**
@@ -14577,8 +14581,11 @@ type WebhookPayloadComment = {
         /**
          * Ad context. Present only when the comment was made on paid content.
          * Instagram: populated from the webhook payload's value.media.ad_id, value.media.ad_title and value.media.original_media_id, each only when Meta includes it.
-         * Facebook: populated via a Graph API lookup of the parent post's promotion_status.
-         * Absent for comments on organic posts that are not currently promoted.
+         * Facebook: populated from a Graph API lookup of the parent post. Present when the post is an
+         * ad dark post (isDarkPost true, whatever its promotionStatus) or an organic post that is or was
+         * boosted (promotionStatus "active", "extendable" or "finished"). Meta does not link a dark post
+         * back to its ad, so id and title are never set on Facebook.
+         * Absent for comments on organic posts that are not promoted.
          *
          */
         ad?: {
@@ -14595,12 +14602,16 @@ type WebhookPayloadComment = {
              */
             originalMediaId?: string;
             /**
-             * Facebook promotion status returned by Graph API. Common values:
-             * "active" (organic post currently boosted), "ineligible" (dark
-             * post or ad creative, not promotable because it already is an ad).
+             * Facebook only. The parent post's promotion_status as the Graph API returns it, for example
+             * "active" (organic post currently boosted). Ad dark posts usually report "inactive" and
+             * sometimes "ineligible", so use isDarkPost, not this value, to tell an ad comment apart.
              *
              */
             promotionStatus?: string;
+            /**
+             * Facebook only: true when the post is an unpublished ad creative (dark post), false for a boosted organic post.
+             */
+            isDarkPost?: boolean;
         };
         /**
          * Facebook only. Present on graphic-only comments (sticker, GIF, photo) that
@@ -38574,7 +38585,7 @@ type AskSupportQuestionData = {
          */
         threadId?: string;
         /**
-         * Ids Ana should look at. Each must belong to your workspace.
+         * Ids the assistant should look at. Each must belong to your workspace.
          */
         context?: {
             postId?: string;

package/dist/index.d.ts

@@ -12248,7 +12248,7 @@ type SupportRun = {
      */
     threadId: string;
     /**
-     * queued and running are in progress. needs_human means Ana handed the question to a person instead of answering; when `supportTicket` is set, a Zernio teammate has been notified and will follow up by email.
+     * queued and running are in progress. needs_human means the assistant handed the question to a person instead of answering; when `supportTicket` is set, a Zernio teammate has been notified and will follow up by email.
      */
     status: 'queued' | 'running' | 'completed' | 'needs_human' | 'failed';
     /**
@@ -12256,7 +12256,11 @@ type SupportRun = {
      */
     stopReason: ('answered' | 'human_review' | 'cost_cap' | 'deadline' | 'max_iterations' | 'error' | 'expired') | null;
     /**
-     * Ana's answer. Null while the run is in progress or when it failed.
+     * The question as asked, with leading and trailing whitespace trimmed. Null only on runs created before this field was added.
+     */
+    question: (string) | null;
+    /**
+     * The assistant's answer. Null while the run is in progress or when it failed.
      */
     answer: (string) | null;
     usage: SupportRunUsage;
@@ -12272,7 +12276,7 @@ type SupportRun = {
     startedAt: (string) | null;
     finishedAt: (string) | null;
     /**
-     * Set when Ana opened a support ticket with the Zernio team. Null otherwise. A teammate follows up by email with the user whose API key started the run.
+     * Set when the assistant opened a support ticket with the Zernio team. Null otherwise. A teammate follows up by email with the user whose API key started the run.
      */
     supportTicket: {
         openedAt: string;
@@ -12283,7 +12287,7 @@ type SupportRun = {
     pollAfterSeconds?: number;
 };
 /**
- * queued and running are in progress. needs_human means Ana handed the question to a person instead of answering; when `supportTicket` is set, a Zernio teammate has been notified and will follow up by email.
+ * queued and running are in progress. needs_human means the assistant handed the question to a person instead of answering; when `supportTicket` is set, a Zernio teammate has been notified and will follow up by email.
  */
 type status29 = 'queued' | 'running' | 'completed' | 'needs_human' | 'failed';
 /**
@@ -14577,8 +14581,11 @@ type WebhookPayloadComment = {
         /**
          * Ad context. Present only when the comment was made on paid content.
          * Instagram: populated from the webhook payload's value.media.ad_id, value.media.ad_title and value.media.original_media_id, each only when Meta includes it.
-         * Facebook: populated via a Graph API lookup of the parent post's promotion_status.
-         * Absent for comments on organic posts that are not currently promoted.
+         * Facebook: populated from a Graph API lookup of the parent post. Present when the post is an
+         * ad dark post (isDarkPost true, whatever its promotionStatus) or an organic post that is or was
+         * boosted (promotionStatus "active", "extendable" or "finished"). Meta does not link a dark post
+         * back to its ad, so id and title are never set on Facebook.
+         * Absent for comments on organic posts that are not promoted.
          *
          */
         ad?: {
@@ -14595,12 +14602,16 @@ type WebhookPayloadComment = {
              */
             originalMediaId?: string;
             /**
-             * Facebook promotion status returned by Graph API. Common values:
-             * "active" (organic post currently boosted), "ineligible" (dark
-             * post or ad creative, not promotable because it already is an ad).
+             * Facebook only. The parent post's promotion_status as the Graph API returns it, for example
+             * "active" (organic post currently boosted). Ad dark posts usually report "inactive" and
+             * sometimes "ineligible", so use isDarkPost, not this value, to tell an ad comment apart.
              *
              */
             promotionStatus?: string;
+            /**
+             * Facebook only: true when the post is an unpublished ad creative (dark post), false for a boosted organic post.
+             */
+            isDarkPost?: boolean;
         };
         /**
          * Facebook only. Present on graphic-only comments (sticker, GIF, photo) that
@@ -38574,7 +38585,7 @@ type AskSupportQuestionData = {
          */
         threadId?: string;
         /**
-         * Ids Ana should look at. Each must belong to your workspace.
+         * Ids the assistant should look at. Each must belong to your workspace.
          */
         context?: {
             postId?: string;

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1166",
+  version: "0.2.1168",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1166",
+  version: "0.2.1168",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getlatedev/node",
-  "version": "0.2.1166",
+  "version": "0.2.1168",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -9022,7 +9022,7 @@ export const addBroadcastRecipients = <ThrowOnError extends boolean = false>(opt
 
 /**
  * List a thread's support answers
- * Lists the runs of one thread that your team started, with Ana's answers, oldest first. Replies from the Zernio team after a support ticket arrive by email and are not included. Runs are kept for 90 days. Page through a long thread with `limit` and `cursor`: pass `nextCursor` as `cursor` until it is null.
+ * Lists the runs of one thread that your team started, with each question and its answer, oldest first. Replies from the Zernio team after a support ticket arrive by email and are not included. Runs are kept for 90 days. Page through a long thread with `limit` and `cursor`: pass `nextCursor` as `cursor` until it is null.
  */
 export const listSupportAnswers = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListSupportAnswersData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListSupportAnswersResponse, ListSupportAnswersError, ThrowOnError>({
@@ -9033,13 +9033,13 @@ export const listSupportAnswers = <ThrowOnError extends boolean = false>(options
 
 /**
  * Ask a support question
- * Asks Ana, the Zernio support agent, a question about your workspace. Each question
+ * Asks the Zernio Support Assistant a question about your workspace. Each question
  * starts a run that answers asynchronously: this returns 202 with a `runId`, and the
  * answer arrives through the `support.run.completed` and `support.run.failed` webhooks.
  * `GET /v1/support/runs/{runId}` is the fallback. Pass `threadId` to continue an earlier
- * conversation, and `context` to point Ana at a post, account or profile. When Ana finds
- * a problem on Zernio's side she opens a support ticket with the team (see
- * `supportTicket` on the run) and the run ends as `needs_human`.
+ * conversation, and `context` to point the assistant at a post, account or profile.
+ * When the assistant finds a problem on Zernio's side it opens a support ticket with
+ * the team (see `supportTicket` on the run) and the run ends as `needs_human`.
  *
  * **Pricing.** You pay per question, once it finishes. The exact amount charged is the
  * run's `costUsd`.
@@ -9070,7 +9070,7 @@ export const askSupportQuestion = <ThrowOnError extends boolean = false>(options
 
 /**
  * Get a support answer
- * Returns a run started by your team, with Ana's answer once it is ready. Prefer the `support.run.completed` and `support.run.failed` webhooks; use this as the fallback, waiting `pollAfterSeconds` between polls. `costUsd` is the amount billed for the question, never above `maxCostUsd`, and 0 for a failed run (pricing on Ask a support question).
+ * Returns a run started by your team, with the answer once it is ready. Prefer the `support.run.completed` and `support.run.failed` webhooks; use this as the fallback, waiting `pollAfterSeconds` between polls. `costUsd` is the amount billed for the question, never above `maxCostUsd`, and 0 for a failed run (pricing on Ask a support question).
  */
 export const getSupportAnswer = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetSupportAnswerData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetSupportAnswerResponse, GetSupportAnswerError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -10710,7 +10710,7 @@ export type SupportRun = {
      */
     threadId: string;
     /**
-     * queued and running are in progress. needs_human means Ana handed the question to a person instead of answering; when `supportTicket` is set, a Zernio teammate has been notified and will follow up by email.
+     * queued and running are in progress. needs_human means the assistant handed the question to a person instead of answering; when `supportTicket` is set, a Zernio teammate has been notified and will follow up by email.
      */
     status: 'queued' | 'running' | 'completed' | 'needs_human' | 'failed';
     /**
@@ -10718,7 +10718,11 @@ export type SupportRun = {
      */
     stopReason: ('answered' | 'human_review' | 'cost_cap' | 'deadline' | 'max_iterations' | 'error' | 'expired') | null;
     /**
-     * Ana's answer. Null while the run is in progress or when it failed.
+     * The question as asked, with leading and trailing whitespace trimmed. Null only on runs created before this field was added.
+     */
+    question: (string) | null;
+    /**
+     * The assistant's answer. Null while the run is in progress or when it failed.
      */
     answer: (string) | null;
     usage: SupportRunUsage;
@@ -10734,7 +10738,7 @@ export type SupportRun = {
     startedAt: (string) | null;
     finishedAt: (string) | null;
     /**
-     * Set when Ana opened a support ticket with the Zernio team. Null otherwise. A teammate follows up by email with the user whose API key started the run.
+     * Set when the assistant opened a support ticket with the Zernio team. Null otherwise. A teammate follows up by email with the user whose API key started the run.
      */
     supportTicket: {
         openedAt: string;
@@ -10746,7 +10750,7 @@ export type SupportRun = {
 };
 
 /**
- * queued and running are in progress. needs_human means Ana handed the question to a person instead of answering; when `supportTicket` is set, a Zernio teammate has been notified and will follow up by email.
+ * queued and running are in progress. needs_human means the assistant handed the question to a person instead of answering; when `supportTicket` is set, a Zernio teammate has been notified and will follow up by email.
  */
 export type status29 = 'queued' | 'running' | 'completed' | 'needs_human' | 'failed';
 
@@ -13129,8 +13133,11 @@ export type WebhookPayloadComment = {
         /**
          * Ad context. Present only when the comment was made on paid content.
          * Instagram: populated from the webhook payload's value.media.ad_id, value.media.ad_title and value.media.original_media_id, each only when Meta includes it.
-         * Facebook: populated via a Graph API lookup of the parent post's promotion_status.
-         * Absent for comments on organic posts that are not currently promoted.
+         * Facebook: populated from a Graph API lookup of the parent post. Present when the post is an
+         * ad dark post (isDarkPost true, whatever its promotionStatus) or an organic post that is or was
+         * boosted (promotionStatus "active", "extendable" or "finished"). Meta does not link a dark post
+         * back to its ad, so id and title are never set on Facebook.
+         * Absent for comments on organic posts that are not promoted.
          *
          */
         ad?: {
@@ -13147,12 +13154,16 @@ export type WebhookPayloadComment = {
              */
             originalMediaId?: string;
             /**
-             * Facebook promotion status returned by Graph API. Common values:
-             * "active" (organic post currently boosted), "ineligible" (dark
-             * post or ad creative, not promotable because it already is an ad).
+             * Facebook only. The parent post's promotion_status as the Graph API returns it, for example
+             * "active" (organic post currently boosted). Ad dark posts usually report "inactive" and
+             * sometimes "ineligible", so use isDarkPost, not this value, to tell an ad comment apart.
              *
              */
             promotionStatus?: string;
+            /**
+             * Facebook only: true when the post is an unpublished ad creative (dark post), false for a boosted organic post.
+             */
+            isDarkPost?: boolean;
         };
         /**
          * Facebook only. Present on graphic-only comments (sticker, GIF, photo) that
@@ -38846,7 +38857,7 @@ export type AskSupportQuestionData = {
          */
         threadId?: string;
         /**
-         * Ids Ana should look at. Each must belong to your workspace.
+         * Ids the assistant should look at. Each must belong to your workspace.
          */
         context?: {
             postId?: string;