ugcinc 3.75.0 → 3.77.0

package/dist/automations.js

@@ -625,6 +625,23 @@ function getAllNodes() {
                 },
             ],
         },
+        {
+            type: "destructure",
+            label: "Destructure",
+            description: "Extract specific elements from an array by index or range",
+            category: "Control Flow",
+            nodeCategory: "generator",
+            // Input is any array type
+            inputs: [
+                {
+                    id: "array",
+                    type: ["image[]", "video[]", "audio[]", "text[]", "object[]"],
+                    required: true,
+                },
+            ],
+            // Dynamic outputs based on config.selections
+            outputs: [],
+        },
         // === Terminal nodes ===
         {
             type: "auto-post",

package/dist/types.d.ts

@@ -796,7 +796,10 @@ export interface NodeOutputValues {
  * Schema definition for a property within an array item
  */
 export interface PropertySchema {
-    type: 'string' | 'number' | 'boolean' | 'object';
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    /** For arrays - the item type */
+    items?: 'string' | 'number' | 'boolean' | 'object';
+    /** For nested objects or array of objects */
     itemSchema?: Record<string, PropertySchema>;
 }
 export interface NodePort {
@@ -846,7 +849,7 @@ export interface NodeControlConfig {
      */
     isInitializer?: boolean;
 }
-export type NodeTypeEnum = 'social-audio' | 'text' | 'media' | 'video-import' | 'image-composer' | 'video-composer' | 'generate-image' | 'generate-video' | 'custom-model' | 'llm' | 'output' | 'manual-trigger' | 'recurrence' | 'compose-workflow' | 'account' | 'auto-post' | 'save-to-media' | 'deduplicate' | 'for-each' | 'random' | 'random-route' | 'branch' | 'if' | 'not' | 'transcript' | 'auto-caption' | 'screenshot-animation' | 'create-dm' | 'collect';
+export type NodeTypeEnum = 'social-audio' | 'text' | 'media' | 'video-import' | 'image-composer' | 'video-composer' | 'generate-image' | 'generate-video' | 'custom-model' | 'llm' | 'output' | 'manual-trigger' | 'recurrence' | 'compose-workflow' | 'account' | 'auto-post' | 'save-to-media' | 'deduplicate' | 'for-each' | 'random' | 'random-route' | 'branch' | 'if' | 'not' | 'transcript' | 'auto-caption' | 'screenshot-animation' | 'create-dm' | 'collect' | 'destructure';
 export interface OutputSchemaProperty {
     type: 'string' | 'number' | 'boolean' | 'array' | 'object';
     items?: 'string' | 'number' | 'boolean';
@@ -971,6 +974,7 @@ export interface WorkflowNodeDefinition {
         screenshotAnimationConfig?: ScreenshotAnimationNodeConfig;
         createDmConfig?: CreateDmNodeConfig;
         collectConfig?: CollectNodeConfig;
+        destructureConfig?: DestructureNodeConfig;
     };
 }
 export interface OutputInput {
@@ -1584,6 +1588,22 @@ export interface CollectNodeConfig {
     /** Template ID of the for-each loop this collects from (for validation) */
     forEachTemplateId?: string;
 }
+/**
+ * Destructure node selection - defines which indexes to extract from an array
+ */
+export interface DestructureSelection {
+    /** Port ID for this selection output (lowercase, hyphens/underscores only) */
+    portId: string;
+    /** Index expression: single index "0", comma-separated "0, 2, 4", ranges "0-3", or mixed "0, 2-4, 7" */
+    indexExpr: string;
+}
+/**
+ * Destructure node configuration - extracts specific elements from an array
+ */
+export interface DestructureNodeConfig {
+    /** List of selections - each becomes an output port */
+    selections: DestructureSelection[];
+}
 /**
  * Video Generation Model IDs
  * Text-to-video models take just a prompt, image-to-video models require an image input

package/package.json

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