ugcinc 4.1.95 → 4.1.97

package/dist/automations/graph-controller.d.ts

@@ -331,6 +331,7 @@ export declare function getPortErrorsForNode({ nodeId, errors, }: {
 }>;
 /**
  * Check if there's a missing trigger error
+ * @deprecated Trigger validation has been removed - automations no longer require trigger nodes
  */
 export declare function hasMissingTriggerError({ errors }: {
     errors: ValidationError[];

package/dist/automations/graph-controller.js

@@ -485,6 +485,7 @@ function getAllNodes() {
             outputModes: def.outputModes,
             selectionModes: def.selectionModes,
             defaults: def.defaults,
+            hidden: def.hidden,
         });
     }
     return results;
@@ -731,7 +732,6 @@ function checkCrossContextViolation({ sourceNodeId, targetNodeId, nodes, }) {
 // ===========================================================================
 // Workflow Validation
 // ===========================================================================
-const TRIGGER_TYPES = ['manual-trigger', 'recurrence'];
 const TERMINAL_TYPES = ['passthrough', 'auto-post', 'save-to-media'];
 /**
  * Validate workflow and return structured errors for UI highlighting
@@ -739,15 +739,7 @@ const TERMINAL_TYPES = ['passthrough', 'auto-post', 'save-to-media'];
 function validateWorkflow({ nodes, }) {
     const errors = [];
     const connections = deriveConnectionsInternal(nodes);
-    // 1. Check for trigger node
-    const hasTrigger = nodes.some(n => TRIGGER_TYPES.includes(n.type));
-    if (!hasTrigger) {
-        errors.push({
-            type: 'missing_trigger',
-            message: 'Automation requires a trigger node (Manual Trigger or Recurrence)',
-        });
-    }
-    // 2. Check for terminal node
+    // 1. Check for terminal node
     const hasTerminal = nodes.some(n => TERMINAL_TYPES.includes(n.type));
     if (!hasTerminal) {
         errors.push({
@@ -1024,8 +1016,10 @@ function getPortErrorsForNode({ nodeId, errors, }) {
 }
 /**
  * Check if there's a missing trigger error
+ * @deprecated Trigger validation has been removed - automations no longer require trigger nodes
  */
 function hasMissingTriggerError({ errors }) {
+    // Trigger validation removed - kept for backward compatibility
     return errors.some(e => e.type === 'missing_trigger');
 }
 /**

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

@@ -328,6 +328,14 @@ export declare const nodeDefinitions: {
         __TInputs: import("./transcript").TranscriptNodeInputs;
         __TOutputs: import("./transcript").TranscriptNodeOutputs;
     };
+    readonly variable: NodeDefinition<"variable", "source", {
+        outputs: import("../types").NodePort[];
+        outputMode: import("./types").OutputMode | null;
+        selectionMode: import("./types").SelectionMode | null;
+    }, import("./variable").VariableNodeInputs, import("./variable").VariableNodeOutputs, false> & {
+        __TInputs: import("./variable").VariableNodeInputs;
+        __TOutputs: import("./variable").VariableNodeOutputs;
+    };
     readonly 'video-composer': NodeDefinition<"video-composer", "generator", {
         videoEditor: {
             width: number;

package/dist/automations/nodes/index.js

@@ -39,6 +39,7 @@ const screenshot_animation_1 = __importDefault(require("./screenshot-animation")
 const social_audio_1 = __importDefault(require("./social-audio"));
 const text_1 = __importDefault(require("./text"));
 const transcript_1 = __importDefault(require("./transcript"));
+const variable_1 = __importDefault(require("./variable"));
 const video_composer_1 = __importDefault(require("./video-composer"));
 const video_import_1 = __importDefault(require("./video-import"));
 // =============================================================================
@@ -77,6 +78,7 @@ exports.nodeDefinitions = {
     'social-audio': social_audio_1.default,
     'text': text_1.default,
     'transcript': transcript_1.default,
+    'variable': variable_1.default,
     'video-composer': video_composer_1.default,
     'video-import': video_import_1.default,
 };

package/dist/automations/nodes/manual-trigger.js

@@ -10,6 +10,7 @@ const definition = (0, types_1.defineNode)({
     description: 'Trigger manually',
     type: 'trigger',
     category: 'Triggers',
+    hidden: true,
     outputModes: null,
     selectionModes: null,
     defaults: {

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

@@ -1,11 +1,11 @@
-import type { NodePort, PortValue } from '../types';
+import type { NodePort, PortValue, DayOfWeek } from '../types';
 import { type TriggerCollectionConfig, type MediaItemType, type OutputMode, type SelectionMode } from './types';
 /** Recurrence node has no inputs (trigger node) */
 export interface RecurrenceNodeInputs {
 }
 /** Recurrence outputs are dynamic based on config. Output port IDs are user-defined. */
 export type RecurrenceNodeOutputs = Record<string, PortValue | PortValue[]>;
-export type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+export type { DayOfWeek } from '../types';
 export interface RecurrenceMediaOutput extends NodePort {
     type: MediaItemType;
     selectionMode: 'specific' | 'by-tag';

package/dist/automations/nodes/recurrence.js

@@ -11,6 +11,7 @@ const definition = (0, types_1.defineNode)({
     description: 'Run continuously',
     type: 'trigger',
     category: 'Triggers',
+    hidden: true,
     outputModes: null,
     selectionModes: null,
     defaults: {

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

@@ -159,6 +159,8 @@ export interface NodeDefinition<TNodeId extends string, T extends NodeCategory,
     isFlowControl: boolean;
     /** If true, this node can be "captured" by a for-each context */
     canBeCaptured: boolean;
+    /** If true, this node is hidden from the add node UI */
+    hidden: boolean;
     outputModes: OutputModesForCategory<T>;
     selectionModes: SelectionModesForCategory<T>;
     defaults: DefaultsForCategory<T, TDefaults>;
@@ -255,6 +257,8 @@ export declare function defineNode<TNodeId extends string, T extends NodeCategor
     isFlowControl?: boolean;
     /** If true, this node can be "captured" by a for-each context */
     canBeCaptured?: boolean;
+    /** If true, this node is hidden from the add node UI */
+    hidden?: boolean;
     outputModes: OutputModesForCategory<T>;
     selectionModes: SelectionModesForCategory<T>;
     defaults: DefaultsForCategory<T, TCustomDefaults>;

package/dist/automations/nodes/types.js

@@ -35,6 +35,7 @@ function defineNode(def) {
         isInternal: (def.isInternal ?? false),
         isFlowControl: def.isFlowControl ?? false,
         canBeCaptured: def.canBeCaptured ?? false,
+        hidden: def.hidden ?? false,
         /**
          * Wrapper that accepts a node (type + config) and calls the typed computePorts.
          * Runtime validates node.type matches this definition.

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

@@ -0,0 +1,18 @@
+import type { NodePort, PortValue } from '../types';
+import { type OutputMode, type SelectionMode } from './types';
+/** Variable node has no inputs (source node) */
+export interface VariableNodeInputs {
+}
+/** Variable outputs are dynamic based on config. Output port IDs are user-defined. */
+export type VariableNodeOutputs = Record<string, PortValue | PortValue[]>;
+declare const definition: import("./types").NodeDefinition<"variable", "source", {
+    outputs: NodePort[];
+    outputMode: OutputMode | null;
+    selectionMode: SelectionMode | null;
+}, VariableNodeInputs, VariableNodeOutputs, false>;
+declare const _default: typeof definition & {
+    __TInputs: VariableNodeInputs;
+    __TOutputs: VariableNodeOutputs;
+};
+export default _default;
+export type VariableNodeConfig = typeof definition.defaults;

package/dist/automations/nodes/variable.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("./types");
+// =============================================================================
+// Node Definition
+// =============================================================================
+const definition = (0, types_1.defineNode)({
+    nodeId: 'variable',
+    label: 'Variable',
+    description: 'Define runtime input variables',
+    type: 'source',
+    category: 'Sources',
+    outputModes: ['single', 'per-input'],
+    selectionModes: ['random', 'sequential'],
+    defaults: {
+        outputs: [{ id: 'input-1', type: 'image', isArray: false, required: true }],
+        outputMode: 'single',
+        selectionMode: 'random',
+    },
+    computePorts: ({ config }) => {
+        return {
+            inputs: [],
+            outputs: config?.outputs ?? [],
+        };
+    },
+    generatePreview: (config, _ctx) => {
+        // Variable outputs are provided at runtime, no preview available
+        const result = {};
+        for (const output of config.outputs) {
+            result[output.id] = null;
+        }
+        return (0, types_1.preview)(result);
+    },
+    validate: (config) => {
+        const errors = [];
+        const outputs = config.outputs;
+        if (!outputs?.length) {
+            errors.push('Variable node requires at least one output to be configured');
+        }
+        else {
+            const validTypes = ['image', 'video', 'audio', 'text', 'social_audio', 'account', 'boolean', 'object'];
+            for (const output of outputs) {
+                if (!output.id) {
+                    errors.push('Variable output requires an id');
+                }
+                const outputType = Array.isArray(output.type) ? output.type.join(' | ') : output.type;
+                if (!output.type || !validTypes.includes(outputType)) {
+                    errors.push(`Invalid Variable output type: ${outputType}`);
+                }
+            }
+        }
+        return errors;
+    },
+});
+exports.default = definition;

package/dist/automations/types.d.ts

@@ -267,6 +267,8 @@ export interface ComputedNode {
     selectionModes: SelectionMode[] | null;
     /** Default config values for this node */
     defaults: Record<string, unknown>;
+    /** If true, this node is hidden from the add node UI */
+    hidden?: boolean;
 }
 export interface OutputSchemaProperty {
     type: 'string' | 'number' | 'boolean' | 'array' | 'object';
@@ -353,6 +355,31 @@ type InternalTemplateNode = {
  * Discriminated union enabling automatic type narrowing based on node type.
  */
 export type TemplateNode = UserCreatableTemplateNode | InternalTemplateNode;
+export type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+/**
+ * Schedule configuration for automated runs (stored on template, not recurrence node)
+ */
+export interface ScheduleConfig {
+    frequencyType: 'per-day' | 'periodic';
+    runsPerDay?: number;
+    periodDays?: number;
+    daysOfWeek?: DayOfWeek[];
+    timingType: 'specific' | 'random-window';
+    specificTimes?: string[];
+    randomWindowStart?: string;
+    randomWindowEnd?: string;
+    timezone: string;
+}
+/**
+ * Account iteration configuration for scheduled runs
+ */
+export interface AccountIterationConfig {
+    enabled: boolean;
+    selectionMode: 'specific' | 'by-tag';
+    accountIds?: string[];
+    accountTag?: string;
+    iterationMode: 'sequential' | 'random';
+}
 export interface AutomationTemplate {
     id: string;
     org_id: string;
@@ -365,6 +392,8 @@ export interface AutomationTemplate {
     recurrence_enabled: boolean;
     next_run_at: string | null;
     last_run_at: string | null;
+    schedule_config: ScheduleConfig | null;
+    account_iteration_config: AccountIterationConfig | null;
     created_at: string;
     updated_at: string;
 }

package/dist/index.d.ts

@@ -56,12 +56,14 @@ export { IfLogicOperators, applyLogicOperator } from './automations/nodes/if';
 export type { LLMNodeConfig, LLMNodeOutputs, LLMProvider, LLMApiKeys, } from './automations/nodes/llm';
 export { LLMProviders, outputFieldToZod, outputFieldsToZod } from './automations/nodes/llm';
 export type { ManualTriggerNodeConfig, ManualTriggerNodeOutputs } from './automations/nodes/manual-trigger';
+export type { VariableNodeConfig, VariableNodeOutputs } from './automations/nodes/variable';
 export type { MediaNodeConfig, MediaNodeOutput } from './automations/nodes/media';
 export type { NotNodeConfig } from './automations/nodes/not';
 export type { OutputNodeConfig, OutputNodeOutputs } from './automations/nodes/output';
 export type { RandomNodeConfig, RandomInputPort, RandomNodeMode, RandomNodeOutputs } from './automations/nodes/random';
 export type { RandomRouteNodeConfig, RandomRouteBranch, RandomRoutePassthroughInput, } from './automations/nodes/random-route';
-export type { RecurrenceNodeConfig, DayOfWeek, RecurrenceMediaOutput, RecurrenceMediaConfig, RecurrenceNodeOutputs, } from './automations/nodes/recurrence';
+export type { RecurrenceNodeConfig, RecurrenceMediaOutput, RecurrenceMediaConfig, RecurrenceNodeOutputs, } from './automations/nodes/recurrence';
+export type { DayOfWeek, ScheduleConfig, AccountIterationConfig, } from './automations/types';
 export type { SaveToMediaNodeConfig, SaveToMediaInput, SaveToMediaType } from './automations/nodes/save-to-media';
 export { formatDateTag } from './automations/nodes/save-to-media';
 export type { ScreenshotAnimationNodeConfig } from './automations/nodes/screenshot-animation';

package/package.json

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