@genfeedai/workflow-engine 0.2.0

package/dist/src/executors/saas/rss-input-executor.js

@@ -0,0 +1,95 @@
+import { BaseExecutor } from '@workflow-engine/executors/base-executor';
+/**
+ * RSS Input Executor
+ *
+ * Fetches and parses RSS feeds from URL or raw XML.
+ * Used for content aggregation workflows.
+ *
+ * Node Type: rssInput
+ * Definition: @genfeedai/workflow-saas/nodes/rss-input.ts
+ */
+export class RssInputExecutor extends BaseExecutor {
+  nodeType = 'rssInput';
+  fetcher = null;
+  parser = null;
+  setFetcher(fetcher) {
+    this.fetcher = fetcher;
+  }
+  setParser(parser) {
+    this.parser = parser;
+  }
+  validate(node) {
+    const baseValidation = super.validate(node);
+    const errors = [...baseValidation.errors];
+    const inputMode = node.config.inputMode;
+    if (inputMode === 'url') {
+      const feedUrl = node.config.feedUrl;
+      if (!feedUrl || typeof feedUrl !== 'string') {
+        errors.push('Feed URL is required when input mode is "url"');
+      }
+    } else if (inputMode === 'text') {
+      const rawXml = node.config.rawXml;
+      if (!rawXml || typeof rawXml !== 'string') {
+        errors.push('Raw XML is required when input mode is "text"');
+      }
+    } else {
+      errors.push('Input mode must be "url" or "text"');
+    }
+    return {
+      errors,
+      valid: errors.length === 0,
+    };
+  }
+  async execute(input) {
+    const { node } = input;
+    const inputMode = this.getRequiredConfig(node.config, 'inputMode');
+    const selectedItemIndex = this.getOptionalConfig(
+      node.config,
+      'selectedItemIndex',
+      0,
+    );
+    let result;
+    if (inputMode === 'url') {
+      if (!this.fetcher) {
+        throw new Error('RSS feed fetcher not configured');
+      }
+      const feedUrl = this.getRequiredConfig(node.config, 'feedUrl');
+      result = await this.fetcher(feedUrl);
+    } else {
+      if (!this.parser) {
+        throw new Error('RSS feed parser not configured');
+      }
+      const rawXml = this.getRequiredConfig(node.config, 'rawXml');
+      result = await this.parser(rawXml);
+    }
+    const selectedItem = result.items[selectedItemIndex];
+    if (!selectedItem) {
+      throw new Error(
+        `No item at index ${selectedItemIndex}. Feed has ${result.items.length} items.`,
+      );
+    }
+    return {
+      data: {
+        description: selectedItem.description,
+        link: selectedItem.link,
+        title: selectedItem.title,
+      },
+      metadata: {
+        feedTitle: result.title,
+        inputMode,
+        itemCount: result.items.length,
+        selectedIndex: selectedItemIndex,
+      },
+    };
+  }
+}
+export function createRssInputExecutor(fetcher, parser) {
+  const executor = new RssInputExecutor();
+  if (fetcher) {
+    executor.setFetcher(fetcher);
+  }
+  if (parser) {
+    executor.setParser(parser);
+  }
+  return executor;
+}

package/dist/src/executors/saas/send-dm-executor.d.ts

@@ -0,0 +1,66 @@
+import {
+  BaseExecutor,
+  type ExecutorInput,
+  type ExecutorOutput,
+} from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export type DmPlatform = 'twitter' | 'instagram';
+export interface SendDmConfig {
+  /** Platform to send DM on */
+  platform: DmPlatform;
+  /** Recipient user ID or username */
+  recipientId?: string;
+  /** DM text */
+  text?: string;
+  /** Optional media URL to attach */
+  mediaUrl?: string;
+}
+export interface SendDmResult {
+  /** Whether the DM was sent successfully */
+  success: boolean;
+  /** The conversation/message ID */
+  messageId?: string;
+  /** Platform the DM was sent on */
+  platform: DmPlatform;
+  /** Recipient identifier */
+  recipientId: string;
+  /** Error message if failed */
+  error?: string;
+}
+/**
+ * Function signature for the injected DM sender.
+ * The NestJS service layer injects the actual implementation at runtime.
+ */
+export type DmSender = (params: {
+  organizationId: string;
+  userId: string;
+  /** The brand ID associated with this action. Use this instead of userId for brand-scoped operations. */
+  brandId?: string;
+  platform: DmPlatform;
+  recipientId: string;
+  text: string;
+  mediaUrl?: string;
+}) => Promise<{
+  messageId: string;
+}>;
+/**
+ * Send DM Executor
+ *
+ * Sends a direct message on the specified platform.
+ * Requires a DmSender to be injected at runtime.
+ *
+ * Node Type: sendDm
+ */
+export declare class SendDmExecutor extends BaseExecutor {
+  readonly nodeType = 'sendDm';
+  private sender;
+  setSender(sender: DmSender): void;
+  validate(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+  estimateCost(_node: ExecutableNode): number;
+}
+export declare function createSendDmExecutor(): SendDmExecutor;
+//# sourceMappingURL=send-dm-executor.d.ts.map

package/dist/src/executors/saas/send-dm-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-dm-executor.d.ts","sourceRoot":"","sources":["../../../../src/executors/saas/send-dm-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM7D,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,QAAQ,EAAE,UAAU,CAAC;IACrB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,QAAQ,EAAE,UAAU,CAAC;IACrB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,wGAAwG;IACxG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KAAK,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAMrC;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,QAAQ,CAAC,QAAQ,YAAY;IAC7B,OAAO,CAAC,MAAM,CAAyB;IAEvC,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAIjC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAe9D,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAyD5D,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;CAG5C;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/dist/src/executors/saas/send-dm-executor.js

@@ -0,0 +1,76 @@
+import { BaseExecutor } from '@workflow-engine/executors/base-executor';
+// =============================================================================
+// EXECUTOR
+// =============================================================================
+/**
+ * Send DM Executor
+ *
+ * Sends a direct message on the specified platform.
+ * Requires a DmSender to be injected at runtime.
+ *
+ * Node Type: sendDm
+ */
+export class SendDmExecutor extends BaseExecutor {
+  nodeType = 'sendDm';
+  sender = null;
+  setSender(sender) {
+    this.sender = sender;
+  }
+  validate(node) {
+    const baseValidation = super.validate(node);
+    const errors = [...baseValidation.errors];
+    const platform = node.config.platform;
+    const validPlatforms = ['twitter', 'instagram'];
+    if (!platform || !validPlatforms.includes(platform)) {
+      errors.push(
+        `Invalid platform. Must be one of: ${validPlatforms.join(', ')}`,
+      );
+    }
+    return { errors, valid: errors.length === 0 };
+  }
+  async execute(input) {
+    const { node, inputs, context } = input;
+    if (!this.sender) {
+      throw new Error('DM sender not configured');
+    }
+    const platform = this.getRequiredConfig(node.config, 'platform');
+    const recipientId = node.config.recipientId ?? inputs.get('recipientId');
+    const text = node.config.text ?? inputs.get('text');
+    if (!recipientId) {
+      throw new Error('Recipient ID is required (via config or input)');
+    }
+    if (!text) {
+      throw new Error('DM text is required (via config or input)');
+    }
+    const mediaUrl = node.config.mediaUrl ?? inputs.get('mediaUrl');
+    const result = await this.sender({
+      brandId: node.config.brandId,
+      mediaUrl,
+      organizationId: context.organizationId,
+      platform,
+      recipientId,
+      text,
+      userId: context.userId,
+    });
+    const dmResult = {
+      messageId: result.messageId,
+      platform,
+      recipientId,
+      success: true,
+    };
+    return {
+      data: dmResult,
+      metadata: {
+        messageId: result.messageId,
+        platform,
+        recipientId,
+      },
+    };
+  }
+  estimateCost(_node) {
+    return 1;
+  }
+}
+export function createSendDmExecutor() {
+  return new SendDmExecutor();
+}

package/dist/src/executors/saas/social-publish-executor.d.ts

@@ -0,0 +1,54 @@
+import {
+  BaseExecutor,
+  type ExecutorInput,
+  type ExecutorOutput,
+} from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export type SocialPlatform =
+  | 'youtube'
+  | 'tiktok'
+  | 'instagram'
+  | 'twitter'
+  | 'linkedin'
+  | 'facebook'
+  | 'threads'
+  | 'telegram';
+export type SocialVisibility = 'public' | 'private' | 'unlisted';
+export interface SocialPublishResult {
+  publishedUrl: string;
+  postId: string;
+}
+export type SocialPublisher = (params: {
+  organizationId: string;
+  userId: string;
+  videoUrl: string;
+  platform: SocialPlatform;
+  title: string;
+  description: string;
+  tags: string[];
+  visibility: SocialVisibility;
+  scheduledTime: Date | null;
+}) => Promise<SocialPublishResult>;
+/**
+ * Social Publish Executor
+ *
+ * Publishes video content to social media platforms.
+ * Requires OAuth integrations with each platform.
+ *
+ * Node Type: socialPublish
+ * Definition: @genfeedai/workflow-saas/nodes/social-publish.ts
+ */
+export declare class SocialPublishExecutor extends BaseExecutor {
+  readonly nodeType = 'socialPublish';
+  private publisher;
+  setPublisher(publisher: SocialPublisher): void;
+  validate(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+}
+export declare function createSocialPublishExecutor(
+  publisher?: SocialPublisher,
+): SocialPublishExecutor;
+//# sourceMappingURL=social-publish-executor.d.ts.map

package/dist/src/executors/saas/social-publish-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-publish-executor.d.ts","sourceRoot":"","sources":["../../../../src/executors/saas/social-publish-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,QAAQ,GACR,WAAW,GACX,SAAS,GACT,UAAU,GACV,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,gBAAgB,CAAC;IAC7B,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;CAC5B,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEnC;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,QAAQ,CAAC,QAAQ,mBAAmB;IACpC,OAAO,CAAC,SAAS,CAAgC;IAEjD,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAI9C,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAmC9D,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CAqD7D;AAED,wBAAgB,2BAA2B,CACzC,SAAS,CAAC,EAAE,eAAe,GAC1B,qBAAqB,CAMvB"}

package/dist/src/executors/saas/social-publish-executor.js

@@ -0,0 +1,94 @@
+import { BaseExecutor } from '@workflow-engine/executors/base-executor';
+/**
+ * Social Publish Executor
+ *
+ * Publishes video content to social media platforms.
+ * Requires OAuth integrations with each platform.
+ *
+ * Node Type: socialPublish
+ * Definition: @genfeedai/workflow-saas/nodes/social-publish.ts
+ */
+export class SocialPublishExecutor extends BaseExecutor {
+  nodeType = 'socialPublish';
+  publisher = null;
+  setPublisher(publisher) {
+    this.publisher = publisher;
+  }
+  validate(node) {
+    const baseValidation = super.validate(node);
+    const errors = [...baseValidation.errors];
+    const platform = node.config.platform;
+    const validPlatforms = [
+      'youtube',
+      'tiktok',
+      'instagram',
+      'twitter',
+      'linkedin',
+      'facebook',
+      'threads',
+      'telegram',
+    ];
+    if (!platform || !validPlatforms.includes(platform)) {
+      errors.push(
+        `Invalid platform. Must be one of: ${validPlatforms.join(', ')}`,
+      );
+    }
+    const visibility = node.config.visibility;
+    if (visibility && !['public', 'private', 'unlisted'].includes(visibility)) {
+      errors.push('Invalid visibility. Must be: public, private, or unlisted');
+    }
+    return {
+      errors,
+      valid: errors.length === 0,
+    };
+  }
+  async execute(input) {
+    const { node, inputs, context } = input;
+    if (!this.publisher) {
+      throw new Error('Social publisher not configured');
+    }
+    const videoUrl = this.getRequiredInput(inputs, 'video');
+    const platform = this.getRequiredConfig(node.config, 'platform');
+    const title = this.getOptionalConfig(node.config, 'title', '');
+    const description = this.getOptionalConfig(node.config, 'description', '');
+    const tags = this.getOptionalConfig(node.config, 'tags', []);
+    const visibility = this.getOptionalConfig(
+      node.config,
+      'visibility',
+      'public',
+    );
+    const scheduledTimeStr = this.getOptionalConfig(
+      node.config,
+      'scheduledTime',
+      null,
+    );
+    const scheduledTime = scheduledTimeStr ? new Date(scheduledTimeStr) : null;
+    const result = await this.publisher({
+      description,
+      organizationId: context.organizationId,
+      platform,
+      scheduledTime,
+      tags,
+      title,
+      userId: context.userId,
+      videoUrl,
+      visibility,
+    });
+    return {
+      data: result.publishedUrl,
+      metadata: {
+        platform,
+        postId: result.postId,
+        scheduledTime: scheduledTime?.toISOString() ?? null,
+        visibility,
+      },
+    };
+  }
+}
+export function createSocialPublishExecutor(publisher) {
+  const executor = new SocialPublishExecutor();
+  if (publisher) {
+    executor.setPublisher(publisher);
+  }
+  return executor;
+}

package/dist/src/executors/saas/sound-overlay-executor.d.ts

@@ -0,0 +1,45 @@
+import {
+  BaseExecutor,
+  type ExecutorInput,
+  type ExecutorOutput,
+} from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export type MixMode = 'replace' | 'mix' | 'background';
+export interface SoundOverlayResult {
+  outputVideoUrl: string;
+  jobId: string;
+}
+export type SoundOverlayProcessor = (params: {
+  organizationId: string;
+  videoUrl: string;
+  soundUrl: string;
+  mixMode: MixMode;
+  audioVolume: number;
+  videoVolume: number;
+  fadeIn: number;
+  fadeOut: number;
+}) => Promise<SoundOverlayResult>;
+/**
+ * Sound Overlay Executor
+ *
+ * Adds an audio track to a generated video using FFmpeg.
+ * Supports replace, mix, and background modes with volume controls.
+ *
+ * Node Type: soundOverlay
+ * Definition: @genfeedai/workflow-saas/nodes/sound-overlay.ts
+ */
+export declare class SoundOverlayExecutor extends BaseExecutor {
+  readonly nodeType = 'soundOverlay';
+  private processor;
+  setProcessor(processor: SoundOverlayProcessor): void;
+  validate(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  estimateCost(_node: ExecutableNode): number;
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+}
+export declare function createSoundOverlayExecutor(
+  processor?: SoundOverlayProcessor,
+): SoundOverlayExecutor;
+//# sourceMappingURL=sound-overlay-executor.d.ts.map

package/dist/src/executors/saas/sound-overlay-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sound-overlay-executor.d.ts","sourceRoot":"","sources":["../../../../src/executors/saas/sound-overlay-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAElC;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,QAAQ,kBAAkB;IACnC,OAAO,CAAC,SAAS,CAAsC;IAEvD,YAAY,CAAC,SAAS,EAAE,qBAAqB,GAAG,IAAI;IAIpD,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAkCpE,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAIrC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CA+C7D;AAED,wBAAgB,0BAA0B,CACxC,SAAS,CAAC,EAAE,qBAAqB,GAChC,oBAAoB,CAMtB"}

package/dist/src/executors/saas/sound-overlay-executor.js

@@ -0,0 +1,83 @@
+import { BaseExecutor } from '@workflow-engine/executors/base-executor';
+/**
+ * Sound Overlay Executor
+ *
+ * Adds an audio track to a generated video using FFmpeg.
+ * Supports replace, mix, and background modes with volume controls.
+ *
+ * Node Type: soundOverlay
+ * Definition: @genfeedai/workflow-saas/nodes/sound-overlay.ts
+ */
+export class SoundOverlayExecutor extends BaseExecutor {
+  nodeType = 'soundOverlay';
+  processor = null;
+  setProcessor(processor) {
+    this.processor = processor;
+  }
+  validate(node) {
+    const baseValidation = super.validate(node);
+    const errors = [...baseValidation.errors];
+    const mixMode = node.config.mixMode;
+    if (mixMode && !['replace', 'mix', 'background'].includes(mixMode)) {
+      errors.push('Invalid mix mode. Must be: replace, mix, or background');
+    }
+    const audioVolume = node.config.audioVolume;
+    if (
+      audioVolume !== undefined &&
+      (typeof audioVolume !== 'number' || audioVolume < 0 || audioVolume > 200)
+    ) {
+      errors.push('Audio volume must be between 0 and 200');
+    }
+    const videoVolume = node.config.videoVolume;
+    if (
+      videoVolume !== undefined &&
+      (typeof videoVolume !== 'number' || videoVolume < 0 || videoVolume > 200)
+    ) {
+      errors.push('Video volume must be between 0 and 200');
+    }
+    return {
+      errors,
+      valid: errors.length === 0,
+    };
+  }
+  estimateCost(_node) {
+    return 2; // Video processing costs 2 credits
+  }
+  async execute(input) {
+    const { node, inputs, context } = input;
+    if (!this.processor) {
+      throw new Error('Sound overlay processor not configured');
+    }
+    const videoUrl = this.getRequiredInput(inputs, 'videoUrl');
+    const soundUrl = this.getRequiredInput(inputs, 'soundUrl');
+    const mixMode = this.getOptionalConfig(node.config, 'mixMode', 'replace');
+    const audioVolume = this.getOptionalConfig(node.config, 'audioVolume', 100);
+    const videoVolume = this.getOptionalConfig(node.config, 'videoVolume', 0);
+    const fadeIn = this.getOptionalConfig(node.config, 'fadeIn', 0);
+    const fadeOut = this.getOptionalConfig(node.config, 'fadeOut', 0);
+    const result = await this.processor({
+      audioVolume,
+      fadeIn,
+      fadeOut,
+      mixMode,
+      organizationId: context.organizationId,
+      soundUrl,
+      videoUrl,
+      videoVolume,
+    });
+    return {
+      data: result.outputVideoUrl,
+      metadata: {
+        jobId: result.jobId,
+        mixMode,
+      },
+    };
+  }
+}
+export function createSoundOverlayExecutor(processor) {
+  const executor = new SoundOverlayExecutor();
+  if (processor) {
+    executor.setProcessor(processor);
+  }
+  return executor;
+}

package/dist/src/executors/saas/text-to-speech-executor.d.ts

@@ -0,0 +1,43 @@
+import type { ExecutionContext } from '@workflow-engine/execution/engine';
+import {
+  BaseExecutor,
+  type ExecutorInput,
+  type ExecutorOutput,
+} from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export interface TtsResult {
+  audioUrl: string;
+  duration: number;
+}
+/**
+ * Resolver that generates speech audio from text using a TTS provider.
+ * The actual implementation is injected at runtime from the NestJS service layer.
+ */
+export type TtsResolver = (
+  text: string,
+  voiceId: string,
+  context: ExecutionContext,
+  node: ExecutableNode,
+) => Promise<TtsResult>;
+/**
+ * Text to Speech Executor
+ *
+ * Converts text input into speech audio using ElevenLabs (or another provider).
+ * Text can come from an upstream input port or from node config.
+ *
+ * Node Type: textToSpeech
+ * Category: ai
+ */
+export declare class TextToSpeechExecutor extends BaseExecutor {
+  readonly nodeType = 'textToSpeech';
+  private resolver;
+  setResolver(resolver: TtsResolver): void;
+  validate(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  estimateCost(_node: ExecutableNode): number;
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+}
+export declare function createTextToSpeechExecutor(): TextToSpeechExecutor;
+//# sourceMappingURL=text-to-speech-executor.d.ts.map

package/dist/src/executors/saas/text-to-speech-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-to-speech-executor.d.ts","sourceRoot":"","sources":["../../../../src/executors/saas/text-to-speech-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EACL,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,cAAc,KACjB,OAAO,CAAC,SAAS,CAAC,CAAC;AAExB;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,QAAQ,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAA4B;IAE5C,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAIxC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAepE,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAIrC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CA8B7D;AAED,wBAAgB,0BAA0B,IAAI,oBAAoB,CAEjE"}

package/dist/src/executors/saas/text-to-speech-executor.js

@@ -0,0 +1,58 @@
+import { BaseExecutor } from '@workflow-engine/executors/base-executor';
+/**
+ * Text to Speech Executor
+ *
+ * Converts text input into speech audio using ElevenLabs (or another provider).
+ * Text can come from an upstream input port or from node config.
+ *
+ * Node Type: textToSpeech
+ * Category: ai
+ */
+export class TextToSpeechExecutor extends BaseExecutor {
+  nodeType = 'textToSpeech';
+  resolver = null;
+  setResolver(resolver) {
+    this.resolver = resolver;
+  }
+  validate(node) {
+    const baseValidation = super.validate(node);
+    const errors = [...baseValidation.errors];
+    const voiceId = node.config.voiceId;
+    if (!voiceId || typeof voiceId !== 'string') {
+      errors.push('Voice ID is required for text to speech');
+    }
+    return {
+      errors,
+      valid: errors.length === 0,
+    };
+  }
+  estimateCost(_node) {
+    return 3;
+  }
+  async execute(input) {
+    const { node, inputs } = input;
+    if (!this.resolver) {
+      throw new Error('TextToSpeech resolver not configured');
+    }
+    // Text can come from input port or config
+    const text =
+      inputs.get('text') ?? this.getOptionalConfig(node.config, 'text', '');
+    if (!text) {
+      throw new Error(
+        'Text is required: provide via input port or node config',
+      );
+    }
+    const voiceId = this.getRequiredConfig(node.config, 'voiceId');
+    const result = await this.resolver(text, voiceId, input.context, node);
+    return {
+      data: result,
+      metadata: {
+        duration: result.duration,
+        voiceId,
+      },
+    };
+  }
+}
+export function createTextToSpeechExecutor() {
+  return new TextToSpeechExecutor();
+}

package/dist/src/executors/saas/trend-trigger-executor.d.ts

@@ -0,0 +1,50 @@
+import {
+  BaseExecutor,
+  type ExecutorInput,
+  type ExecutorOutput,
+} from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export type TrendPlatform = 'tiktok' | 'instagram' | 'youtube' | 'twitter';
+export type TrendType = 'video' | 'sound' | 'hashtag';
+export type CheckFrequency = '15min' | '30min' | '1hr' | '6hr' | '24hr';
+export interface TrendTriggerOutput {
+  trendId: string;
+  topic: string;
+  platform: TrendPlatform;
+  viralScore: number;
+  hashtags: string[];
+  videoUrl: string | null;
+  soundId: string | null;
+}
+export type TrendChecker = (params: {
+  organizationId: string;
+  platform: TrendPlatform;
+  trendType: TrendType;
+  minViralScore: number;
+  keywords: string[];
+  excludeKeywords: string[];
+  lastTrendId: string | null;
+}) => Promise<TrendTriggerOutput | null>;
+/**
+ * Trend Trigger Executor
+ *
+ * Starts a workflow when a new trend matches the configured criteria.
+ * Polls trends at configurable intervals and deduplicates to avoid re-triggering.
+ *
+ * Node Type: trendTrigger
+ * Definition: @genfeedai/workflow-saas/nodes/trend-trigger.ts
+ */
+export declare class TrendTriggerExecutor extends BaseExecutor {
+  readonly nodeType = 'trendTrigger';
+  private checker;
+  setChecker(checker: TrendChecker): void;
+  validate(node: ExecutableNode): {
+    valid: boolean;
+    errors: string[];
+  };
+  execute(input: ExecutorInput): Promise<ExecutorOutput>;
+}
+export declare function createTrendTriggerExecutor(
+  checker?: TrendChecker,
+): TrendTriggerExecutor;
+//# sourceMappingURL=trend-trigger-executor.d.ts.map