ugcinc 4.12.0 → 4.14.0

package/README.md

@@ -93,6 +93,28 @@ do {
 } while (cursor);
 ```
 
+For interactive tables, `posts.getPostsPage()` keeps filtering and sorting on the server and
+returns page-scoped latest stats plus `totalCount`, organization-wide `postTags`,
+`anyHasTitle`, and `matchingAccountIds`. It supports caption/title/account search; platform,
+post type, status, account, account-tag, post-tag, social-audio, and phone-type filters; and
+sorting by account, status, title, caption, tag, audio presence, scheduled time, or engagement:
+
+```typescript
+const page = await client.posts.getPostsPage({
+  search: "launch",
+  statuses: ["complete"],
+  postTags: ["fall-campaign"],
+  sortBy: "views",
+  sortDirection: "desc",
+  limit: 200,
+});
+
+if (page.ok) {
+  console.log(page.data.posts, page.data.stats, page.data.totalCount);
+  const next = page.data.nextCursor;
+}
+```
+
 ## Caption Overlays
 
 Video posts can carry text overlays to display on the video. Pass `captionOverlays` to

package/dist/accounts.d.ts

@@ -96,6 +96,8 @@ export interface EditProfileInfo {
 }
 export interface GetAccountsParams {
     tag?: string;
+    /** Platform filter: only accounts of this type are returned. */
+    type?: 'tiktok' | 'instagram';
     org_group?: string;
     user_group?: string;
     status?: AccountStatus;

package/dist/posts.d.ts

@@ -64,6 +64,37 @@ export interface GetPostsParams {
     limit?: number;
     /** Opaque cursor from a previous response's `nextCursor`, to fetch the next page. */
     cursor?: string;
+    /** Case-insensitive substring search across caption, title, and account username. */
+    search?: string;
+    platform?: 'tiktok' | 'instagram';
+    postType?: PostType;
+    statuses?: PostStatus[];
+    /** Match any comma-separated tag on the post's account. */
+    accountTags?: string[];
+    /** Match any comma-separated tag stored on the post. */
+    postTags?: string[];
+    socialAudioIds?: string[];
+    phoneTypes?: Array<'physical_iphone' | 'manual_iphone' | 'physical_android' | 'emulated_android' | 'social_api' | 'custom_provider' | 'tracking' | 'clipper'>;
+    sortBy?: PostSortField;
+    sortDirection?: PostSortDirection;
+}
+export type PostSortField = 'created' | 'account' | 'status' | 'title' | 'caption' | 'tag' | 'audio' | 'time' | 'views' | 'likes' | 'comments' | 'shares';
+export type PostSortDirection = 'asc' | 'desc';
+export interface GetPostsPageParams extends GetPostsParams {
+    /** Page size. Defaults to 200 and is capped at 500. */
+    limit?: number;
+}
+export interface PostsPage {
+    posts: Post[];
+    /** Latest stats only for posts in this page. */
+    stats: PostStat[];
+    totalCount: number;
+    /** Distinct comma-split post tags across the organization. */
+    postTags: string[];
+    anyHasTitle: boolean;
+    /** Accounts with a match when `accountIds` is ignored and all other filters remain active. */
+    matchingAccountIds: string[];
+    nextCursor: string | null;
 }
 export interface CreateSlideshowParams {
     accountId: string | null;
@@ -179,6 +210,11 @@ export declare class PostsClient extends BaseClient {
      * passed back as `cursor` to fetch the next page, ordered newest-first.
      */
     getPosts(params?: GetPostsParams): Promise<ApiResponse<Post[]>>;
+    /**
+     * Get one server-filtered/sorted page plus table metadata and page-scoped stats.
+     * Unlike getPosts(), this method never falls back to an unbounded response.
+     */
+    getPostsPage(params?: GetPostsPageParams): Promise<ApiResponse<PostsPage>>;
     /**
      * Create a draft post without assigning it to an account
      *

package/dist/posts.js

@@ -15,6 +15,13 @@ class PostsClient extends base_1.BaseClient {
     async getPosts(params) {
         return this.post('/post', params ?? {});
     }
+    /**
+     * Get one server-filtered/sorted page plus table metadata and page-scoped stats.
+     * Unlike getPosts(), this method never falls back to an unbounded response.
+     */
+    async getPostsPage(params = {}) {
+        return this.post('/post', { ...params, includePageMeta: true });
+    }
     /**
      * Create a draft post without assigning it to an account
      *

package/dist/render/compositions/IMessageDmComposition/types.d.ts

@@ -399,10 +399,10 @@ export declare const iMessageDmPropsSchema: z.ZodObject<{
     dynamicCrop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     cropVerticalCenter: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    time?: string | undefined;
     backgroundColor?: string | undefined;
     lightMode?: boolean | undefined;
     username?: string | undefined;
-    time?: string | undefined;
     profilePicUrl?: string | undefined;
     messages?: {
         text: string;
@@ -582,10 +582,10 @@ export declare const iMessageDmPropsSchema: z.ZodObject<{
     readReceiptLeft?: number | undefined;
     readReceiptRight?: number | undefined;
 }, {
+    time?: string | undefined;
     backgroundColor?: string | undefined;
     lightMode?: boolean | undefined;
     username?: string | undefined;
-    time?: string | undefined;
     profilePicUrl?: string | undefined;
     messages?: {
         text: string;

package/dist/tools/accounts.js

@@ -8,6 +8,7 @@ exports.accountTools = [
         description: 'List accounts with optional filters. Returns all accounts if no filters provided.',
         schema: zod_1.z.object({
             tag: zod_1.z.string().optional().describe('Filter by tag'),
+            type: zod_1.z.enum(['tiktok', 'instagram']).optional().describe('Filter by platform'),
             org_group: zod_1.z.string().optional().describe('Filter by org group'),
             user_group: zod_1.z.string().optional().describe('Filter by user group'),
             status: zod_1.z.enum(['uninitialized', 'pending', 'initialized', 'setup', 'warming', 'warmed', 'needs_replacement', 'replacing', 'failed', 'deleted']).optional().describe('Filter by account status'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc",
-  "version": "4.12.0",
+  "version": "4.14.0",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",