@getlatedev/node 0.1.58 → 0.2.4

package/src/generated/types.gen.ts

@@ -533,6 +533,91 @@ export type HashtagInfo = {
 
 export type status2 = 'safe' | 'banned' | 'restricted' | 'unknown';
 
+export type InstagramAccountInsightsResponse = {
+    success?: boolean;
+    /**
+     * The Zernio SocialAccount ID
+     */
+    accountId?: string;
+    platform?: string;
+    dateRange?: {
+        since?: string;
+        until?: string;
+    };
+    metricType?: 'time_series' | 'total_value';
+    /**
+     * Breakdown dimension used (only present when breakdown was requested)
+     */
+    breakdown?: string;
+    /**
+     * Object keyed by metric name. For time_series: each metric has "total" (number) and "values" (array of {date, value}).
+     * For total_value: each metric has "total" (number) and optionally "breakdowns" (array of {dimension, value}).
+     *
+     */
+    metrics?: {
+        [key: string]: {
+            /**
+             * Sum or aggregate value for the metric
+             */
+            total?: number;
+            /**
+             * Daily values (only for time_series)
+             */
+            values?: Array<{
+                date?: string;
+                value?: number;
+            }>;
+            /**
+             * Breakdown values (only for total_value with breakdown)
+             */
+            breakdowns?: Array<{
+                dimension?: string;
+                value?: number;
+            }>;
+        };
+    };
+    dataDelay?: string;
+};
+
+export type metricType = 'time_series' | 'total_value';
+
+export type InstagramDemographicsResponse = {
+    success?: boolean;
+    /**
+     * The Zernio SocialAccount ID
+     */
+    accountId?: string;
+    platform?: string;
+    metric?: 'follower_demographics' | 'engaged_audience_demographics';
+    /**
+     * The timeframe used for demographic data
+     */
+    timeframe?: 'this_week' | 'this_month';
+    /**
+     * Object keyed by breakdown dimension (age, city, country, gender)
+     */
+    demographics?: {
+        [key: string]: Array<{
+            /**
+             * The dimension value (e.g., "25-34", "US", "M")
+             */
+            dimension?: string;
+            /**
+             * Count of accounts in this dimension
+             */
+            value?: number;
+        }>;
+    };
+    note?: string;
+};
+
+export type metric = 'follower_demographics' | 'engaged_audience_demographics';
+
+/**
+ * The timeframe used for demographic data
+ */
+export type timeframe = 'this_week' | 'this_month';
+
 /**
  * Feed aspect ratio 0.8-1.91, carousels up to 10 items, stories require media (no captions). User tag coordinates 0.0-1.0 from top-left. Images over 8 MB and videos over platform limits are auto-compressed.
  */
@@ -1415,9 +1500,13 @@ export type TikTokPlatformData = {
      */
     mediaType?: 'video' | 'photo';
     /**
-     * Optional for video posts. Timestamp in milliseconds to select which frame to use as thumbnail (defaults to 1000ms/1 second).
+     * Optional for video posts. Timestamp in milliseconds to select which frame to use as thumbnail (defaults to 1000ms/1 second). Ignored when videoCoverImageUrl is provided.
      */
     videoCoverTimestampMs?: number;
+    /**
+     * Optional for video posts. URL of a custom thumbnail image (JPG, PNG, or WebP, max 20MB). The image is stitched as a single frame at the start of the video and used as the cover. Overrides videoCoverTimestampMs when provided.
+     */
+    videoCoverImageUrl?: string;
     /**
      * Optional for photo carousels. Index of image to use as cover, 0-based (defaults to 0/first image).
      */
@@ -2447,6 +2536,86 @@ export type GetYouTubeDailyViewsError = ({
     error?: string;
 });
 
+export type GetInstagramAccountInsightsData = {
+    query: {
+        /**
+         * The Zernio SocialAccount ID for the Instagram account
+         */
+        accountId: string;
+        /**
+         * Breakdown dimension (only valid with metricType=total_value).
+         * Valid values depend on the metric: media_product_type, follow_type, follower_type, contact_button_type.
+         *
+         */
+        breakdown?: string;
+        /**
+         * Comma-separated list of metrics. Defaults to "reach,views,accounts_engaged,total_interactions".
+         * Valid metrics: reach, views, accounts_engaged, total_interactions, comments, likes, saves, shares,
+         * replies, reposts, follows_and_unfollows, profile_links_taps.
+         * Note: only "reach" supports metricType=time_series. All other metrics are total_value only.
+         *
+         */
+        metrics?: string;
+        /**
+         * "total_value" (default) returns aggregated totals and supports breakdowns.
+         * "time_series" returns daily values but only works with the "reach" metric.
+         *
+         */
+        metricType?: 'time_series' | 'total_value';
+        /**
+         * Start date (YYYY-MM-DD). Defaults to 30 days ago.
+         */
+        since?: string;
+        /**
+         * End date (YYYY-MM-DD). Defaults to today.
+         */
+        until?: string;
+    };
+};
+
+export type GetInstagramAccountInsightsResponse = (InstagramAccountInsightsResponse);
+
+export type GetInstagramAccountInsightsError = ({
+    error?: string;
+} | {
+    error?: string;
+    code?: string;
+});
+
+export type GetInstagramDemographicsData = {
+    query: {
+        /**
+         * The Zernio SocialAccount ID for the Instagram account
+         */
+        accountId: string;
+        /**
+         * Comma-separated list of demographic dimensions: age, city, country, gender.
+         * Defaults to all four if omitted.
+         *
+         */
+        breakdown?: string;
+        /**
+         * "follower_demographics" for follower audience data, or "engaged_audience_demographics" for engaged viewers.
+         *
+         */
+        metric?: 'follower_demographics' | 'engaged_audience_demographics';
+        /**
+         * Time period for demographic data. Defaults to "this_month".
+         *
+         */
+        timeframe?: 'this_week' | 'this_month';
+    };
+};
+
+export type GetInstagramDemographicsResponse = (InstagramDemographicsResponse);
+
+export type GetInstagramDemographicsError = ({
+    error?: string;
+} | {
+    error?: string;
+    code?: string;
+});
+
 export type GetDailyMetricsData = {
     query?: {
         /**
@@ -3478,6 +3647,79 @@ export type GetAccountHealthError = ({
     error?: string;
 });
 
+export type GetTikTokCreatorInfoData = {
+    path: {
+        /**
+         * The TikTok account ID
+         */
+        accountId: string;
+    };
+    query?: {
+        /**
+         * The media type to get creator info for (affects available interaction settings)
+         */
+        mediaType?: 'video' | 'photo';
+    };
+};
+
+export type GetTikTokCreatorInfoResponse = ({
+    creator?: {
+        /**
+         * Creator display name
+         */
+        nickname?: string;
+        /**
+         * Creator avatar URL
+         */
+        avatarUrl?: string;
+        /**
+         * Whether the creator is verified
+         */
+        isVerified?: boolean;
+        /**
+         * Whether the creator can publish more posts right now
+         */
+        canPostMore?: boolean;
+    };
+    /**
+     * Available privacy level options for this creator
+     */
+    privacyLevels?: Array<{
+        /**
+         * Privacy level value to use when creating posts (e.g. PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY)
+         */
+        value?: string;
+        /**
+         * Human-readable label
+         */
+        label?: string;
+    }>;
+    postingLimits?: {
+        /**
+         * Maximum video duration in seconds
+         */
+        maxVideoDurationSec?: number;
+        /**
+         * Available interaction toggles (comment, duet, stitch) and their defaults
+         */
+        interactionSettings?: {
+            [key: string]: unknown;
+        };
+    };
+    /**
+     * Available commercial content disclosure options
+     */
+    commercialContentTypes?: Array<{
+        value?: string;
+        label?: string;
+        requires?: Array<(string)>;
+    }>;
+});
+
+export type GetTikTokCreatorInfoError = ({
+    error?: string;
+});
+
 export type ListApiKeysResponse = ({
     apiKeys?: Array<ApiKey>;
 });
@@ -6283,6 +6525,14 @@ export type SendInboxMessageData = {
          * Message text
          */
         message?: string;
+        /**
+         * URL of the attachment to send (image, video, audio, or file). The URL must be publicly accessible. For binary file uploads, use multipart/form-data instead.
+         */
+        attachmentUrl?: string;
+        /**
+         * Type of attachment. Defaults to file if not specified.
+         */
+        attachmentType?: 'image' | 'video' | 'audio' | 'file';
         /**
          * Quick reply buttons. Mutually exclusive with buttons. Max 13 items.
          */

package/src/index.ts

@@ -1,13 +1,13 @@
 /**
- * Late - Official Node.js library for the Late API
+ * Zernio - Official Node.js library for the Zernio API
  *
  * @example
  * ```typescript
- * import Late from 'late';
+ * import Zernio from '@zernio/node';
  *
- * const late = new Late();
+ * const zernio = new Zernio();
  *
- * const post = await late.posts.create({
+ * const post = await zernio.posts.create({
  *   body: {
  *     content: 'Hello world!',
  *     platforms: [{ platform: 'twitter', accountId: 'acc_123' }],
@@ -19,11 +19,12 @@
  * @packageDocumentation
  */
 
-// Main client export
-export { Late, Late as default, type ClientOptions } from './client';
+// Main client export (Zernio is primary, Late is kept for backwards compatibility)
+export { Zernio, Zernio as default, Late, type ClientOptions } from './client';
 
-// Error exports
+// Error exports (ZernioApiError is primary, LateApiError is kept for backwards compatibility)
 export {
+  ZernioApiError,
   LateApiError,
   RateLimitError,
   ValidationError,