@genfeedai/workflow-engine 0.2.0

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

@@ -0,0 +1,62 @@
+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/workflow-engine/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/workflow-engine/src/executors/saas/send-dm-executor.js

@@ -0,0 +1,77 @@
+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/workflow-engine/src/executors/saas/send-dm-executor.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=send-dm-executor.spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send-dm-executor.spec.d.ts","sourceRoot":"","sources":["../../../../../src/executors/saas/send-dm-executor.spec.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,114 @@
+import { createSendDmExecutor } from '@workflow-engine/executors/saas/send-dm-executor';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+function makeInput(config, inputData) {
+  const node = {
+    config,
+    id: 'dm-1',
+    inputs: [],
+    label: 'Send DM',
+    type: 'sendDm',
+  };
+  const inputs = new Map();
+  if (inputData) {
+    for (const [k, v] of Object.entries(inputData)) {
+      inputs.set(k, v);
+    }
+  }
+  const context = {
+    organizationId: 'org-1',
+    runId: 'run-1',
+    userId: 'user-1',
+    workflowId: 'wf-1',
+  };
+  return { context, inputs, node };
+}
+describe('SendDmExecutor', () => {
+  let executor;
+  let mockSender;
+  beforeEach(() => {
+    executor = createSendDmExecutor();
+    mockSender = vi.fn().mockResolvedValue({ messageId: 'msg-123' });
+    executor.setSender(mockSender);
+  });
+  it('creates via factory', () => {
+    expect(executor.nodeType).toBe('sendDm');
+  });
+  it('throws if sender not configured', async () => {
+    const fresh = createSendDmExecutor();
+    const input = makeInput({
+      platform: 'twitter',
+      recipientId: 'u1',
+      text: 'hi',
+    });
+    await expect(fresh.execute(input)).rejects.toThrow(
+      'DM sender not configured',
+    );
+  });
+  it('sends DM with config values', async () => {
+    const input = makeInput({
+      platform: 'twitter',
+      recipientId: 'user-456',
+      text: 'Hello!',
+    });
+    const result = await executor.execute(input);
+    expect(mockSender).toHaveBeenCalledWith(
+      expect.objectContaining({
+        platform: 'twitter',
+        recipientId: 'user-456',
+        text: 'Hello!',
+      }),
+    );
+    expect(result.data).toMatchObject({
+      messageId: 'msg-123',
+      platform: 'twitter',
+      recipientId: 'user-456',
+      success: true,
+    });
+  });
+  it('uses input values when config is missing', async () => {
+    const input = makeInput(
+      { platform: 'twitter' },
+      {
+        recipientId: 'user-789',
+        text: 'From input!',
+      },
+    );
+    const result = await executor.execute(input);
+    expect(result.data).toMatchObject({ success: true });
+  });
+  it('throws if recipientId missing', async () => {
+    const input = makeInput({ platform: 'twitter', text: 'hello' });
+    await expect(executor.execute(input)).rejects.toThrow(
+      'Recipient ID is required',
+    );
+  });
+  it('throws if text missing', async () => {
+    const input = makeInput({ platform: 'twitter', recipientId: 'u1' });
+    await expect(executor.execute(input)).rejects.toThrow(
+      'DM text is required',
+    );
+  });
+  it('validates platform', () => {
+    const node = {
+      config: { platform: 'tiktok' },
+      id: 'dm1',
+      inputs: [],
+      label: 'DM',
+      type: 'sendDm',
+    };
+    const result = executor.validate(node);
+    expect(result.valid).toBe(false);
+  });
+  it('validates valid platform', () => {
+    const node = {
+      config: { platform: 'twitter' },
+      id: 'dm1',
+      inputs: [],
+      label: 'DM',
+      type: 'sendDm',
+    };
+    const result = executor.validate(node);
+    expect(result.valid).toBe(true);
+  });
+});

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

@@ -0,0 +1,40 @@
+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/workflow-engine/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/workflow-engine/src/executors/saas/social-publish-executor.js

@@ -0,0 +1,85 @@
+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/workflow-engine/src/executors/saas/social-publish-executor.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=social-publish-executor.spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"social-publish-executor.spec.d.ts","sourceRoot":"","sources":["../../../../../src/executors/saas/social-publish-executor.spec.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,97 @@
+import { createSocialPublishExecutor } from '@workflow-engine/executors/saas/social-publish-executor';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const ctx = {
+  organizationId: 'org-1',
+  runId: 'run-1',
+  userId: 'user-1',
+  workflowId: 'wf-1',
+};
+function makeInput(config, inputMap) {
+  return {
+    context: ctx,
+    inputs: new Map(Object.entries(inputMap ?? {})),
+    node: {
+      config,
+      id: 'sp-1',
+      inputs: [],
+      label: 'SP',
+      type: 'socialPublish',
+    },
+  };
+}
+describe('SocialPublishExecutor', () => {
+  let publisher;
+  beforeEach(() => {
+    publisher = vi
+      .fn()
+      .mockResolvedValue({ postId: 'p-1', publishedUrl: 'https://x.com/p/1' });
+  });
+  describe('validate', () => {
+    it('valid with correct platform', () => {
+      const exec = createSocialPublishExecutor();
+      expect(
+        exec.validate({
+          config: { platform: 'youtube' },
+          id: '1',
+          inputs: [],
+          label: 'SP',
+          type: 'socialPublish',
+        }).valid,
+      ).toBe(true);
+    });
+    it('invalid without platform', () => {
+      const exec = createSocialPublishExecutor();
+      expect(
+        exec.validate({
+          config: {},
+          id: '1',
+          inputs: [],
+          label: 'SP',
+          type: 'socialPublish',
+        }).valid,
+      ).toBe(false);
+    });
+    it('invalid with bad visibility', () => {
+      const exec = createSocialPublishExecutor();
+      expect(
+        exec.validate({
+          config: { platform: 'youtube', visibility: 'secret' },
+          id: '1',
+          inputs: [],
+          label: 'SP',
+          type: 'socialPublish',
+        }).valid,
+      ).toBe(false);
+    });
+  });
+  describe('execute', () => {
+    it('throws without publisher', async () => {
+      await expect(
+        createSocialPublishExecutor().execute(
+          makeInput({ platform: 'youtube' }, { video: 'v.mp4' }),
+        ),
+      ).rejects.toThrow('publisher');
+    });
+    it('publishes video', async () => {
+      const exec = createSocialPublishExecutor(publisher);
+      const result = await exec.execute(
+        makeInput({ platform: 'youtube', title: 'Test' }, { video: 'v.mp4' }),
+      );
+      expect(result.data).toBe('https://x.com/p/1');
+      expect(result.metadata?.platform).toBe('youtube');
+    });
+    it('handles scheduled time', async () => {
+      const exec = createSocialPublishExecutor(publisher);
+      await exec.execute(
+        makeInput(
+          { platform: 'twitter', scheduledTime: '2025-06-01T12:00:00Z' },
+          { video: 'v.mp4' },
+        ),
+      );
+      expect(publisher).toHaveBeenCalledWith(
+        expect.objectContaining({ scheduledTime: expect.any(Date) }),
+      );
+    });
+  });
+});

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

@@ -0,0 +1,39 @@
+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/workflow-engine/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/workflow-engine/src/executors/saas/sound-overlay-executor.js

@@ -0,0 +1,80 @@
+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/workflow-engine/src/executors/saas/sound-overlay-executor.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sound-overlay-executor.spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sound-overlay-executor.spec.d.ts","sourceRoot":"","sources":["../../../../../src/executors/saas/sound-overlay-executor.spec.ts"],"names":[],"mappings":""}