ugcinc 4.5.46 → 4.5.48

package/README.md

@@ -38,6 +38,7 @@ if (res.ok) {
 
 - `getAccounts(params?)` -> `POST /accounts`
 - `getStatus(params?)` -> `POST /accounts/status`
+- `getProfileSyncStatus(params)` -> `POST /accounts/profile-sync-status` (custom_provider profile verification)
 - `updateInfo(params)` -> `POST /accounts/update-info`
 - `updateSocial(params)` -> `POST /accounts/update-social`
 - `nicheSwitch(params)` -> `POST /accounts/niche-switch`

package/dist/accounts.d.ts

@@ -86,6 +86,16 @@ export interface GetAccountStatusParams {
     accountIds?: string[];
     includeCompleted?: boolean;
 }
+export interface GetProfileSyncStatusParams {
+    accountIds: string[];
+}
+export interface ProfileSyncStatusResult {
+    accountId: string;
+    inSync: boolean;
+}
+export interface GetProfileSyncStatusResponse {
+    results: ProfileSyncStatusResult[];
+}
 export interface AccountInfoUpdate {
     accountId: string;
     tag?: string;
@@ -234,6 +244,11 @@ export declare class AccountsClient extends BaseClient {
      * Get account status (tasks) for one or more accounts
      */
     getStatus(params?: GetAccountStatusParams): Promise<ApiResponse<AccountTask[]>>;
+    /**
+     * Check profile sync status for custom_provider accounts.
+     * Compares live Instagram/TikTok profile to expected values; when in sync, clears pending_info_change.
+     */
+    getProfileSyncStatus(params: GetProfileSyncStatusParams): Promise<ApiResponse<GetProfileSyncStatusResponse>>;
     /**
      * Update account metadata for one or more accounts
      * Supports: tag, org_group, user_group, keywords, profiles, description, warmupVersion, postVersion

package/dist/accounts.js

@@ -18,6 +18,13 @@ class AccountsClient extends base_1.BaseClient {
     async getStatus(params) {
         return this.post('/accounts/status', params ?? {});
     }
+    /**
+     * Check profile sync status for custom_provider accounts.
+     * Compares live Instagram/TikTok profile to expected values; when in sync, clears pending_info_change.
+     */
+    async getProfileSyncStatus(params) {
+        return this.post('/accounts/profile-sync-status', params);
+    }
     /**
      * Update account metadata for one or more accounts
      * Supports: tag, org_group, user_group, keywords, profiles, description, warmupVersion, postVersion

package/dist/automations/graph-controller.js

@@ -483,6 +483,7 @@ function getAllNodes() {
             nodeId: def.nodeId,
             label: def.label,
             description: def.description,
+            guide: def.guide,
             category: def.category,
             type: def.type,
             inputs,

package/dist/automations/nodes/types.d.ts

@@ -151,6 +151,8 @@ export interface NodeDefinition<TNodeId extends string, T extends NodeCategory,
     nodeId: TNodeId;
     label: string;
     description: string;
+    /** Detailed guide for AI agents: use cases, when to use/not use, tips, gotchas */
+    guide: string | null;
     type: T;
     category: string;
     /** If true, this node is internal and not user-creatable */
@@ -249,6 +251,8 @@ export declare function defineNode<TNodeId extends string, T extends NodeCategor
     nodeId: TNodeId;
     label: string;
     description: string;
+    /** Detailed guide for AI agents: use cases, when to use/not use, tips, gotchas */
+    guide?: string;
     type: T;
     category: string;
     /** If true, this node is internal and not user-creatable */

package/dist/automations/nodes/types.js

@@ -32,6 +32,7 @@ function preview(value) {
 function defineNode(def) {
     return {
         ...def,
+        guide: def.guide ?? null,
         isInternal: (def.isInternal ?? false),
         isFlowControl: def.isFlowControl ?? false,
         canBeCaptured: def.canBeCaptured ?? false,

package/dist/automations/types.d.ts

@@ -253,6 +253,8 @@ export interface ComputedNode {
     label: string;
     /** Description shown in add node modal */
     description: string;
+    /** Detailed guide for AI agents: use cases, when to use/not use, tips, gotchas */
+    guide: string | null;
     /** UI display category for grouping in add node modal */
     category: string;
     /** Functional type for node behavior classification */

package/package.json

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