@zernio/node 0.2.672 → 0.2.674

package/dist/index.d.mts

@@ -6500,7 +6500,8 @@ type SocialAccount = {
     /**
      * Whether the user explicitly activated this account. false means the account was
      * created as a side effect (e.g., posting account auto-created when user connected
-     * ads first). Posting UI and scheduler ignore accounts with enabled: false.
+     * ads first). Such accounts are hidden from this list, cannot be posted to
+     * (`ACCOUNT_NOT_ENABLED_FOR_POSTING`), and are not billed as connected accounts.
      *
      */
     enabled?: boolean;
@@ -12270,7 +12271,7 @@ type CreatePostError = ({
     /**
      * Stable machine-readable cause. Absent for ownership failures.
      */
-    code?: 'ACCOUNT_DISCONNECTED' | 'PROFILE_OVER_LIMIT';
+    code?: 'ACCOUNT_DISCONNECTED' | 'ACCOUNT_NOT_ENABLED_FOR_POSTING' | 'PROFILE_OVER_LIMIT';
 } | {
     error?: string;
     details?: {
@@ -15731,7 +15732,57 @@ type ConnectOpenAiAdsCredentialsResponse = ({
     adAccountName?: string;
     redirectUrl?: string;
 });
-type ConnectOpenAiAdsCredentialsError = (ErrorResponse | unknown);
+type ConnectOpenAiAdsCredentialsError = (ErrorResponse | unknown | {
+    /**
+     * Human-readable error message suitable for end-user display.
+     */
+    error: string;
+    /**
+     * Machine-readable error code. Stable across versions.
+     */
+    code: 'PAYMENT_REQUIRED';
+    /**
+     * Discriminator for which gate fired.
+     */
+    reason: 'free_tier_exceeded' | 'twitter_passthrough' | 'enterprise_required';
+    /**
+     * Link to the relevant documentation page.
+     */
+    documentation_url?: string;
+    /**
+     * Deep-link to send the end-user to. For
+     * `free_tier_exceeded` and `twitter_passthrough` this is
+     * the Zernio billing tab. For `enterprise_required` this
+     * is the Zernio enterprise contact page.
+     *
+     */
+    dashboard_url?: string;
+    /**
+     * Structured context for SDK clients that want to render their own UX. Keys vary by `reason`.
+     */
+    details?: {
+        /**
+         * How many accounts the free tier allows. Only set when reason=free_tier_exceeded.
+         */
+        free_tier_account_limit?: number;
+        /**
+         * How many accounts the team currently has connected. Set when reason=free_tier_exceeded or reason=enterprise_required.
+         */
+        current_account_count?: number;
+        /**
+         * Whether the team currently has a card on file in Stripe. Set when reason=free_tier_exceeded or reason=twitter_passthrough.
+         */
+        has_payment_method?: boolean;
+        /**
+         * The negotiated connected-account cap from the
+         * team's enterprise contract. Self-service teams
+         * have no cap and never receive this reason. Only
+         * set when reason=enterprise_required.
+         *
+         */
+        effective_account_limit?: number;
+    };
+});
 type ConnectWhatsAppCredentialsData = {
     body: {
         /**
@@ -20476,7 +20527,7 @@ type ListInboxCommentsResponse = ({
             platform?: string;
             error?: string;
             /**
-             * Error code if available
+             * Error code if available (e.g. TOKEN_EXPIRED, or X_INBOX_NOT_ENABLED for an X account whose owner has not enabled X inbox)
              */
             code?: (string) | null;
             /**

package/dist/index.d.ts

@@ -6500,7 +6500,8 @@ type SocialAccount = {
     /**
      * Whether the user explicitly activated this account. false means the account was
      * created as a side effect (e.g., posting account auto-created when user connected
-     * ads first). Posting UI and scheduler ignore accounts with enabled: false.
+     * ads first). Such accounts are hidden from this list, cannot be posted to
+     * (`ACCOUNT_NOT_ENABLED_FOR_POSTING`), and are not billed as connected accounts.
      *
      */
     enabled?: boolean;
@@ -12270,7 +12271,7 @@ type CreatePostError = ({
     /**
      * Stable machine-readable cause. Absent for ownership failures.
      */
-    code?: 'ACCOUNT_DISCONNECTED' | 'PROFILE_OVER_LIMIT';
+    code?: 'ACCOUNT_DISCONNECTED' | 'ACCOUNT_NOT_ENABLED_FOR_POSTING' | 'PROFILE_OVER_LIMIT';
 } | {
     error?: string;
     details?: {
@@ -15731,7 +15732,57 @@ type ConnectOpenAiAdsCredentialsResponse = ({
     adAccountName?: string;
     redirectUrl?: string;
 });
-type ConnectOpenAiAdsCredentialsError = (ErrorResponse | unknown);
+type ConnectOpenAiAdsCredentialsError = (ErrorResponse | unknown | {
+    /**
+     * Human-readable error message suitable for end-user display.
+     */
+    error: string;
+    /**
+     * Machine-readable error code. Stable across versions.
+     */
+    code: 'PAYMENT_REQUIRED';
+    /**
+     * Discriminator for which gate fired.
+     */
+    reason: 'free_tier_exceeded' | 'twitter_passthrough' | 'enterprise_required';
+    /**
+     * Link to the relevant documentation page.
+     */
+    documentation_url?: string;
+    /**
+     * Deep-link to send the end-user to. For
+     * `free_tier_exceeded` and `twitter_passthrough` this is
+     * the Zernio billing tab. For `enterprise_required` this
+     * is the Zernio enterprise contact page.
+     *
+     */
+    dashboard_url?: string;
+    /**
+     * Structured context for SDK clients that want to render their own UX. Keys vary by `reason`.
+     */
+    details?: {
+        /**
+         * How many accounts the free tier allows. Only set when reason=free_tier_exceeded.
+         */
+        free_tier_account_limit?: number;
+        /**
+         * How many accounts the team currently has connected. Set when reason=free_tier_exceeded or reason=enterprise_required.
+         */
+        current_account_count?: number;
+        /**
+         * Whether the team currently has a card on file in Stripe. Set when reason=free_tier_exceeded or reason=twitter_passthrough.
+         */
+        has_payment_method?: boolean;
+        /**
+         * The negotiated connected-account cap from the
+         * team's enterprise contract. Self-service teams
+         * have no cap and never receive this reason. Only
+         * set when reason=enterprise_required.
+         *
+         */
+        effective_account_limit?: number;
+    };
+});
 type ConnectWhatsAppCredentialsData = {
     body: {
         /**
@@ -20476,7 +20527,7 @@ type ListInboxCommentsResponse = ({
             platform?: string;
             error?: string;
             /**
-             * Error code if available
+             * Error code if available (e.g. TOKEN_EXPIRED, or X_INBOX_NOT_ENABLED for an X account whose owner has not enabled X inbox)
              */
             code?: (string) | null;
             /**

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -5363,7 +5363,8 @@ export type SocialAccount = {
     /**
      * Whether the user explicitly activated this account. false means the account was
      * created as a side effect (e.g., posting account auto-created when user connected
-     * ads first). Posting UI and scheduler ignore accounts with enabled: false.
+     * ads first). Such accounts are hidden from this list, cannot be posted to
+     * (`ACCOUNT_NOT_ENABLED_FOR_POSTING`), and are not billed as connected accounts.
      *
      */
     enabled?: boolean;
@@ -11427,7 +11428,7 @@ export type CreatePostError = ({
     /**
      * Stable machine-readable cause. Absent for ownership failures.
      */
-    code?: 'ACCOUNT_DISCONNECTED' | 'PROFILE_OVER_LIMIT';
+    code?: 'ACCOUNT_DISCONNECTED' | 'ACCOUNT_NOT_ENABLED_FOR_POSTING' | 'PROFILE_OVER_LIMIT';
 } | {
     error?: string;
     details?: {
@@ -15124,7 +15125,57 @@ export type ConnectOpenAiAdsCredentialsResponse = ({
     redirectUrl?: string;
 });
 
-export type ConnectOpenAiAdsCredentialsError = (ErrorResponse | unknown);
+export type ConnectOpenAiAdsCredentialsError = (ErrorResponse | unknown | {
+    /**
+     * Human-readable error message suitable for end-user display.
+     */
+    error: string;
+    /**
+     * Machine-readable error code. Stable across versions.
+     */
+    code: 'PAYMENT_REQUIRED';
+    /**
+     * Discriminator for which gate fired.
+     */
+    reason: 'free_tier_exceeded' | 'twitter_passthrough' | 'enterprise_required';
+    /**
+     * Link to the relevant documentation page.
+     */
+    documentation_url?: string;
+    /**
+     * Deep-link to send the end-user to. For
+     * `free_tier_exceeded` and `twitter_passthrough` this is
+     * the Zernio billing tab. For `enterprise_required` this
+     * is the Zernio enterprise contact page.
+     *
+     */
+    dashboard_url?: string;
+    /**
+     * Structured context for SDK clients that want to render their own UX. Keys vary by `reason`.
+     */
+    details?: {
+        /**
+         * How many accounts the free tier allows. Only set when reason=free_tier_exceeded.
+         */
+        free_tier_account_limit?: number;
+        /**
+         * How many accounts the team currently has connected. Set when reason=free_tier_exceeded or reason=enterprise_required.
+         */
+        current_account_count?: number;
+        /**
+         * Whether the team currently has a card on file in Stripe. Set when reason=free_tier_exceeded or reason=twitter_passthrough.
+         */
+        has_payment_method?: boolean;
+        /**
+         * The negotiated connected-account cap from the
+         * team's enterprise contract. Self-service teams
+         * have no cap and never receive this reason. Only
+         * set when reason=enterprise_required.
+         *
+         */
+        effective_account_limit?: number;
+    };
+});
 
 export type ConnectWhatsAppCredentialsData = {
     body: {
@@ -20185,7 +20236,7 @@ export type ListInboxCommentsResponse = ({
             platform?: string;
             error?: string;
             /**
-             * Error code if available
+             * Error code if available (e.g. TOKEN_EXPIRED, or X_INBOX_NOT_ENABLED for an X account whose owner has not enabled X inbox)
              */
             code?: (string) | null;
             /**