@getlatedev/node 0.2.1161 → 0.2.1163

package/README.md

@@ -1203,8 +1203,8 @@ try {
 ### Support Assistant
 | Method | Description |
 |--------|-------------|
-| `supportAssistant.getSupportAnswer()` | Get a support answer (private beta) |
-| `supportAssistant.askSupportQuestion()` | Ask a support question (private beta) |
+| `supportAssistant.getSupportAnswer()` | Get a support answer |
+| `supportAssistant.askSupportQuestion()` | Ask a support question |
 
 ### Tracking Tags
 | Method | Description |

package/dist/index.d.mts

@@ -11234,6 +11234,10 @@ type Profile = {
      * IANA timezone new posts on this profile use when the request names no `timezone`. Null means UTC.
      */
     timezone?: (string) | null;
+    /**
+     * Your own identifier for this profile, set on create or update. Null when none is set.
+     */
+    externalId?: (string) | null;
     isDefault?: boolean;
     /**
      * Only present when includeOverLimit=true. Indicates if this profile exceeds the plan limit.
@@ -12256,7 +12260,7 @@ type SupportRun = {
     answer: (string) | null;
     usage: SupportRunUsage;
     /**
-     * The amount billed for the run, in USD: the model cost plus 20%, never above `maxCostUsd`. 0 for a failed run.
+     * The amount billed for the run, in USD: the tokens in `usage` at the Support Assistant rates (see Ask a support question), never above `maxCostUsd`. 0 for a failed run.
      */
     costUsd: number;
     /**
@@ -20355,6 +20359,10 @@ type GetUserError = (ErrorResponse | unknown | {
 });
 type ListProfilesData = {
     query?: {
+        /**
+         * Exact-match filter on the externalId you set on the profile, to find the profile of one of your tenants without storing its Zernio id. Team members can each own a profile with the same externalId, so the result is a list.
+         */
+        externalId?: string;
         /**
          * When true, includes over-limit profiles (marked with isOverLimit: true).
          */
@@ -20384,6 +20392,10 @@ type CreateProfileData = {
          * IANA timezone new posts on this profile use when they name no `timezone`. Omit to keep UTC. An unknown name returns 400.
          */
         timezone?: string;
+        /**
+         * Your own identifier for this profile, typically the id of the tenant or client it serves in your system (1 to 255 characters, trimmed). Unique among the profiles of the user who owns the profile: a duplicate returns 409 profile_external_id_conflict. Look a profile up by it with GET /v1/profiles?externalId=.
+         */
+        externalId?: string;
     };
     headers?: {
         /**
@@ -20470,6 +20482,10 @@ type UpdateProfileData = {
          * IANA timezone new posts on this profile use when they name no `timezone`. Set to null to go back to UTC. An unknown name returns 400.
          */
         timezone?: (string) | null;
+        /**
+         * Your own identifier for this profile (1 to 255 characters, trimmed). Set to null to clear it. A value another profile of the same owner already holds returns 409 profile_external_id_conflict.
+         */
+        externalId?: (string) | null;
         isDefault?: boolean;
     };
     path: {

package/dist/index.d.ts

@@ -11234,6 +11234,10 @@ type Profile = {
      * IANA timezone new posts on this profile use when the request names no `timezone`. Null means UTC.
      */
     timezone?: (string) | null;
+    /**
+     * Your own identifier for this profile, set on create or update. Null when none is set.
+     */
+    externalId?: (string) | null;
     isDefault?: boolean;
     /**
      * Only present when includeOverLimit=true. Indicates if this profile exceeds the plan limit.
@@ -12256,7 +12260,7 @@ type SupportRun = {
     answer: (string) | null;
     usage: SupportRunUsage;
     /**
-     * The amount billed for the run, in USD: the model cost plus 20%, never above `maxCostUsd`. 0 for a failed run.
+     * The amount billed for the run, in USD: the tokens in `usage` at the Support Assistant rates (see Ask a support question), never above `maxCostUsd`. 0 for a failed run.
      */
     costUsd: number;
     /**
@@ -20355,6 +20359,10 @@ type GetUserError = (ErrorResponse | unknown | {
 });
 type ListProfilesData = {
     query?: {
+        /**
+         * Exact-match filter on the externalId you set on the profile, to find the profile of one of your tenants without storing its Zernio id. Team members can each own a profile with the same externalId, so the result is a list.
+         */
+        externalId?: string;
         /**
          * When true, includes over-limit profiles (marked with isOverLimit: true).
          */
@@ -20384,6 +20392,10 @@ type CreateProfileData = {
          * IANA timezone new posts on this profile use when they name no `timezone`. Omit to keep UTC. An unknown name returns 400.
          */
         timezone?: string;
+        /**
+         * Your own identifier for this profile, typically the id of the tenant or client it serves in your system (1 to 255 characters, trimmed). Unique among the profiles of the user who owns the profile: a duplicate returns 409 profile_external_id_conflict. Look a profile up by it with GET /v1/profiles?externalId=.
+         */
+        externalId?: string;
     };
     headers?: {
         /**
@@ -20470,6 +20482,10 @@ type UpdateProfileData = {
          * IANA timezone new posts on this profile use when they name no `timezone`. Set to null to go back to UTC. An unknown name returns 400.
          */
         timezone?: (string) | null;
+        /**
+         * Your own identifier for this profile (1 to 255 characters, trimmed). Set to null to clear it. A value another profile of the same owner already holds returns 409 profile_external_id_conflict.
+         */
+        externalId?: (string) | null;
         isDefault?: boolean;
     };
     path: {

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1161",
+  version: "0.2.1163",
   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.1161",
+  version: "0.2.1163",
   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.1161",
+  "version": "0.2.1163",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -1267,7 +1267,7 @@ export const getUser = <ThrowOnError extends boolean = false>(options: OptionsLe
 
 /**
  * List profiles
- * Returns profiles sorted default-first, then by creation date. Filter with name (exact match) and paginate with limit/skip; without those params the full list is returned unchanged. Use includeOverLimit=true to include profiles that exceed the plan limit.
+ * Returns profiles sorted default-first, then by creation date. Filter with name or externalId (exact match) and paginate with limit/skip; without those params the full list is returned unchanged. Use includeOverLimit=true to include profiles that exceed the plan limit.
  */
 export const listProfiles = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<ListProfilesData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListProfilesResponse, ListProfilesError, ThrowOnError>({
@@ -1278,7 +1278,7 @@ export const listProfiles = <ThrowOnError extends boolean = false>(options?: Opt
 
 /**
  * Create profile
- * Creates a new profile with a name, optional description, and color. Names are unique per team: a duplicate returns a 409 whose details.existingProfileId carries the id of the existing profile. Send an Idempotency-Key header to make retries safe: a retried create with the same key and body replays the original 201 (same _id) instead of conflicting.
+ * Creates a new profile with a name, optional description, and color. Names are unique per team: a duplicate returns a 409 whose details.existingProfileId carries the id of the existing profile. Set externalId to your own tenant or client id to find the profile later without storing its Zernio id. A duplicate externalId returns the same kind of 409, with code profile_external_id_conflict. Send an Idempotency-Key header to make retries safe: a retried create with the same key and body replays the original 201 (same _id) instead of conflicting.
  */
 export const createProfile = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateProfileData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateProfileResponse, CreateProfileError, ThrowOnError>({
@@ -1300,7 +1300,7 @@ export const getProfile = <ThrowOnError extends boolean = false>(options: Option
 
 /**
  * Update profile
- * Updates a profile's name, description, color, default timezone, or default status.
+ * Updates a profile's name, description, color, default timezone, externalId, or default status.
  */
 export const updateProfile = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateProfileData, ThrowOnError>) => {
     return (options?.client ?? client).put<UpdateProfileResponse, UpdateProfileError, ThrowOnError>({
@@ -1458,6 +1458,13 @@ export const verifyWhatsAppNumber = <ThrowOnError extends boolean = false>(optio
  *
  * A failing or stalled analytics sync (see `analyticsSync`) raises a healthy account to at least `warning`.
  *
+ * On Facebook, Instagram and Threads the token is also probed live. A probe Meta refuses with a
+ * dead-token error sets `tokenStatus.valid` to `false` and names Meta's code, subcode and
+ * fbtrace in `issues`, unless an analytics sync succeeded with that token in the last six
+ * hours: then the token stays `valid` and `issues` reports the probe as inconclusive, since
+ * Meta answers a transient 190 to live tokens now and then. Neither verdict disconnects the
+ * account; that happens only when a real operation fails, and `account.disconnected` is sent.
+ *
  * For WhatsApp accounts the response also includes `platformConnection`, a live probe of the
  * Meta link behind the channel (the same read as `GET /v1/whatsapp/number-info`). The OAuth
  * token can be perfectly valid while Meta refuses to serve the phone-number object (for
@@ -9014,8 +9021,32 @@ export const addBroadcastRecipients = <ThrowOnError extends boolean = false>(opt
 };
 
 /**
- * Ask a support question (private beta)
- * Private beta: returns 403 `feature_not_available` unless enabled for your account. Asks Ana, the Zernio support agent, 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. Billed when the run finishes at the model cost plus 20%, never above `maxCostUsd`; failed runs are free. 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`. Requires an unrestricted API key, usage-based billing and a card on file. Limits per account: 3 active runs and $100 of runs per UTC month. Send an Idempotency-Key header to make retries safe.
+ * Ask a support question
+ * Asks Ana, the Zernio support agent, 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`.
+ *
+ * **Pricing.** Each question is billed once, when its run finishes, for the tokens Ana used:
+ *
+ * - Input: $6 per million tokens
+ * - Output: $30 per million tokens
+ * - Cache reads: $0.60 per million tokens
+ * - Cache writes: $7.50 per million tokens
+ *
+ * Most questions cost between $0.10 and $0.50. A run never bills more than its
+ * `maxCostUsd` ($0.50 to $3, $3 by default): near the cap Ana stops investigating and
+ * answers with what she found. Runs that end as `needs_human` are billed like any other;
+ * failed runs are free. The run's `usage` holds the token counts and `costUsd` the amount
+ * billed. Charges appear as "Support API" on your invoice.
+ *
+ * Requires an unrestricted API key, usage-based billing and a card on file. Limits per
+ * account: 3 active runs and $100 of runs per UTC month. Send an Idempotency-Key header
+ * to make retries safe.
+ *
  */
 export const askSupportQuestion = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<AskSupportQuestionData, ThrowOnError>) => {
     return (options?.client ?? client).post<AskSupportQuestionResponse, AskSupportQuestionError, ThrowOnError>({
@@ -9025,8 +9056,8 @@ export const askSupportQuestion = <ThrowOnError extends boolean = false>(options
 };
 
 /**
- * Get a support answer (private beta)
- * Private beta: returns 403 `feature_not_available` unless enabled for your account. 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: the model cost plus 20%, never above `maxCostUsd`, and 0 for a failed run.
+ * 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 (rates 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

@@ -9636,6 +9636,10 @@ export type Profile = {
      * IANA timezone new posts on this profile use when the request names no `timezone`. Null means UTC.
      */
     timezone?: (string) | null;
+    /**
+     * Your own identifier for this profile, set on create or update. Null when none is set.
+     */
+    externalId?: (string) | null;
     isDefault?: boolean;
     /**
      * Only present when includeOverLimit=true. Indicates if this profile exceeds the plan limit.
@@ -10719,7 +10723,7 @@ export type SupportRun = {
     answer: (string) | null;
     usage: SupportRunUsage;
     /**
-     * The amount billed for the run, in USD: the model cost plus 20%, never above `maxCostUsd`. 0 for a failed run.
+     * The amount billed for the run, in USD: the tokens in `usage` at the Support Assistant rates (see Ask a support question), never above `maxCostUsd`. 0 for a failed run.
      */
     costUsd: number;
     /**
@@ -19222,6 +19226,10 @@ export type GetUserError = (ErrorResponse | unknown | {
 
 export type ListProfilesData = {
     query?: {
+        /**
+         * Exact-match filter on the externalId you set on the profile, to find the profile of one of your tenants without storing its Zernio id. Team members can each own a profile with the same externalId, so the result is a list.
+         */
+        externalId?: string;
         /**
          * When true, includes over-limit profiles (marked with isOverLimit: true).
          */
@@ -19254,6 +19262,10 @@ export type CreateProfileData = {
          * IANA timezone new posts on this profile use when they name no `timezone`. Omit to keep UTC. An unknown name returns 400.
          */
         timezone?: string;
+        /**
+         * Your own identifier for this profile, typically the id of the tenant or client it serves in your system (1 to 255 characters, trimmed). Unique among the profiles of the user who owns the profile: a duplicate returns 409 profile_external_id_conflict. Look a profile up by it with GET /v1/profiles?externalId=.
+         */
+        externalId?: string;
     };
     headers?: {
         /**
@@ -19346,6 +19358,10 @@ export type UpdateProfileData = {
          * IANA timezone new posts on this profile use when they name no `timezone`. Set to null to go back to UTC. An unknown name returns 400.
          */
         timezone?: (string) | null;
+        /**
+         * Your own identifier for this profile (1 to 255 characters, trimmed). Set to null to clear it. A value another profile of the same owner already holds returns 409 profile_external_id_conflict.
+         */
+        externalId?: (string) | null;
         isDefault?: boolean;
     };
     path: {