@genfeedai/workflow-engine 0.2.0

package/dist/workflow-engine/src/executors/saas/mention-trigger-executor.d.ts

@@ -0,0 +1,47 @@
+import { BaseExecutor, type ExecutorInput, type ExecutorOutput } from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export type MentionTriggerPlatform = 'twitter' | 'instagram' | 'threads';
+export interface MentionTriggerOutput {
+    /** The post/tweet ID containing the mention */
+    postId: string;
+    /** URL of the post */
+    postUrl: string;
+    /** Text of the post */
+    text: string;
+    /** Author user ID */
+    authorId: string;
+    /** Author username */
+    authorUsername: string;
+    /** Platform */
+    platform: MentionTriggerPlatform;
+    /** Timestamp of the mention */
+    mentionedAt: string;
+}
+export type MentionChecker = (params: {
+    organizationId: string;
+    platform: MentionTriggerPlatform;
+    keywords?: string[];
+    excludeKeywords?: string[];
+    lastMentionId: string | null;
+}) => Promise<MentionTriggerOutput | null>;
+/**
+ * Mention Trigger Executor
+ *
+ * Starts a workflow when the authenticated user is mentioned.
+ * Polls mentions at configurable intervals and deduplicates.
+ *
+ * Node Type: mentionTrigger
+ */
+export declare class MentionTriggerExecutor extends BaseExecutor {
+    readonly nodeType = "mentionTrigger";
+    private checker;
+    setChecker(checker: MentionChecker): void;
+    validate(node: ExecutableNode): {
+        valid: boolean;
+        errors: string[];
+    };
+    execute(input: ExecutorInput): Promise<ExecutorOutput>;
+    estimateCost(_node: ExecutableNode): number;
+}
+export declare function createMentionTriggerExecutor(): MentionTriggerExecutor;
+//# sourceMappingURL=mention-trigger-executor.d.ts.map

package/dist/workflow-engine/src/executors/saas/mention-trigger-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-trigger-executor.d.ts","sourceRoot":"","sources":["../../../../../src/executors/saas/mention-trigger-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,sBAAsB,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,QAAQ,EAAE,sBAAsB,CAAC;IACjC,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;AAM3C;;;;;;;GAOG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,QAAQ,CAAC,QAAQ,oBAAoB;IACrC,OAAO,CAAC,OAAO,CAA+B;IAE9C,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIzC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAsB9D,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAoD5D,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;CAG5C;AAED,wBAAgB,4BAA4B,IAAI,sBAAsB,CAErE"}

package/dist/workflow-engine/src/executors/saas/mention-trigger-executor.js

@@ -0,0 +1,71 @@
+import { BaseExecutor, } from '@workflow-engine/executors/base-executor';
+// =============================================================================
+// EXECUTOR
+// =============================================================================
+/**
+ * Mention Trigger Executor
+ *
+ * Starts a workflow when the authenticated user is mentioned.
+ * Polls mentions at configurable intervals and deduplicates.
+ *
+ * Node Type: mentionTrigger
+ */
+export class MentionTriggerExecutor extends BaseExecutor {
+    nodeType = 'mentionTrigger';
+    checker = null;
+    setChecker(checker) {
+        this.checker = checker;
+    }
+    validate(node) {
+        const baseValidation = super.validate(node);
+        const errors = [...baseValidation.errors];
+        const platform = node.config.platform;
+        const validPlatforms = [
+            'twitter',
+            'instagram',
+            'threads',
+        ];
+        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, context } = input;
+        if (!this.checker) {
+            throw new Error('Mention checker not configured');
+        }
+        const platform = this.getRequiredConfig(node.config, 'platform');
+        const keywords = this.getOptionalConfig(node.config, 'keywords', []);
+        const excludeKeywords = this.getOptionalConfig(node.config, 'excludeKeywords', []);
+        const lastMentionId = this.getOptionalConfig(node.config, 'lastMentionId', null);
+        const result = await this.checker({
+            excludeKeywords,
+            keywords,
+            lastMentionId,
+            organizationId: context.organizationId,
+            platform,
+        });
+        if (!result) {
+            return {
+                data: null,
+                metadata: { matched: false, platform },
+            };
+        }
+        return {
+            data: result,
+            metadata: {
+                matched: true,
+                platform,
+                postId: result.postId,
+            },
+        };
+    }
+    estimateCost(_node) {
+        return 0;
+    }
+}
+export function createMentionTriggerExecutor() {
+    return new MentionTriggerExecutor();
+}

package/dist/workflow-engine/src/executors/saas/mention-trigger-executor.spec.d.ts

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

package/dist/workflow-engine/src/executors/saas/mention-trigger-executor.spec.d.ts.map

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

package/dist/workflow-engine/src/executors/saas/mention-trigger-executor.spec.js

@@ -0,0 +1,83 @@
+import { createMentionTriggerExecutor } from '@workflow-engine/executors/saas/mention-trigger-executor';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+function makeInput(config) {
+  const node = {
+    config,
+    id: 'trigger-1',
+    inputs: [],
+    label: 'Mention Trigger',
+    type: 'mentionTrigger',
+  };
+  const context = {
+    organizationId: 'org-1',
+    runId: 'run-1',
+    userId: 'user-1',
+    workflowId: 'wf-1',
+  };
+  return { context, inputs: new Map(), node };
+}
+describe('MentionTriggerExecutor', () => {
+  let executor;
+  let mockChecker;
+  beforeEach(() => {
+    executor = createMentionTriggerExecutor();
+    mockChecker = vi.fn().mockResolvedValue({
+      authorId: 'a-1',
+      authorUsername: 'someone',
+      mentionedAt: '2026-02-21T20:00:00Z',
+      platform: 'twitter',
+      postId: 'post-1',
+      postUrl: 'https://x.com/someone/status/post-1',
+      text: 'Hey @us!',
+    });
+    executor.setChecker(mockChecker);
+  });
+  it('creates via factory', () => {
+    expect(executor.nodeType).toBe('mentionTrigger');
+  });
+  it('throws if checker not configured', async () => {
+    const fresh = createMentionTriggerExecutor();
+    const input = makeInput({ platform: 'twitter' });
+    await expect(fresh.execute(input)).rejects.toThrow(
+      'checker not configured',
+    );
+  });
+  it('returns mention data when matched', async () => {
+    const input = makeInput({ platform: 'twitter' });
+    const result = await executor.execute(input);
+    expect(result.metadata).toMatchObject({ matched: true, postId: 'post-1' });
+    expect(result.data).toMatchObject({ postId: 'post-1' });
+  });
+  it('returns null when no match', async () => {
+    mockChecker.mockResolvedValue(null);
+    const input = makeInput({ platform: 'twitter' });
+    const result = await executor.execute(input);
+    expect(result.metadata).toMatchObject({ matched: false });
+    expect(result.data).toBeNull();
+  });
+  it('passes keywords to checker', async () => {
+    const input = makeInput({
+      excludeKeywords: ['spam'],
+      keywords: ['help'],
+      platform: 'twitter',
+    });
+    await executor.execute(input);
+    expect(mockChecker).toHaveBeenCalledWith(
+      expect.objectContaining({
+        excludeKeywords: ['spam'],
+        keywords: ['help'],
+      }),
+    );
+  });
+  it('validates platform', () => {
+    const node = {
+      config: { platform: 'tiktok' },
+      id: 't1',
+      inputs: [],
+      label: 'T',
+      type: 'mentionTrigger',
+    };
+    expect(executor.validate(node).valid).toBe(false);
+  });
+});

package/dist/workflow-engine/src/executors/saas/music-source-executor.d.ts

@@ -0,0 +1,43 @@
+import { MusicSourceType } from '@genfeedai/enums';
+import { BaseExecutor, type ExecutorInput, type ExecutorOutput } from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export interface MusicSourceResult {
+    musicUrl: string;
+    duration: number;
+    tempo: number | null;
+    title: string;
+    artist: string | null;
+}
+export type MusicSourceResolver = (params: {
+    organizationId: string;
+    sourceType: MusicSourceType;
+    trendPlatform?: 'tiktok' | 'instagram' | null;
+    trendMinUsage?: number;
+    libraryCategory?: string | null;
+    libraryMood?: string | null;
+    uploadUrl?: string | null;
+    generatePrompt?: string | null;
+    generateDuration?: number;
+}) => Promise<MusicSourceResult>;
+/**
+ * Music Source Executor
+ *
+ * Resolves music from various sources for beat-synced editing.
+ * Supports trending sounds, curated library, user uploads, and AI generation.
+ *
+ * Node Type: musicSource
+ * Definition: @genfeedai/workflow-saas/nodes/music-source.ts
+ */
+export declare class MusicSourceExecutor extends BaseExecutor {
+    readonly nodeType = "musicSource";
+    private resolver;
+    setResolver(resolver: MusicSourceResolver): void;
+    validate(node: ExecutableNode): {
+        valid: boolean;
+        errors: string[];
+    };
+    estimateCost(node: ExecutableNode): number;
+    execute(input: ExecutorInput): Promise<ExecutorOutput>;
+}
+export declare function createMusicSourceExecutor(resolver?: MusicSourceResolver): MusicSourceExecutor;
+//# sourceMappingURL=music-source-executor.d.ts.map

package/dist/workflow-engine/src/executors/saas/music-source-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"music-source-executor.d.ts","sourceRoot":"","sources":["../../../../../src/executors/saas/music-source-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,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,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,eAAe,CAAC;IAC5B,aAAa,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAAC;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEjC;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,QAAQ,CAAC,QAAQ,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAoC;IAEpD,WAAW,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAIhD,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA8BpE,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IAYpC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CAgE7D;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,mBAAmB,CAMrB"}

package/dist/workflow-engine/src/executors/saas/music-source-executor.js

@@ -0,0 +1,91 @@
+import { MusicSourceType } from '@genfeedai/enums';
+import { BaseExecutor, } from '@workflow-engine/executors/base-executor';
+/**
+ * Music Source Executor
+ *
+ * Resolves music from various sources for beat-synced editing.
+ * Supports trending sounds, curated library, user uploads, and AI generation.
+ *
+ * Node Type: musicSource
+ * Definition: @genfeedai/workflow-saas/nodes/music-source.ts
+ */
+export class MusicSourceExecutor extends BaseExecutor {
+    nodeType = 'musicSource';
+    resolver = null;
+    setResolver(resolver) {
+        this.resolver = resolver;
+    }
+    validate(node) {
+        const baseValidation = super.validate(node);
+        const errors = [...baseValidation.errors];
+        const sourceType = node.config.sourceType;
+        if (sourceType &&
+            !Object.values(MusicSourceType).includes(sourceType)) {
+            errors.push(`Invalid source type. Must be one of: ${Object.values(MusicSourceType).join(', ')}`);
+        }
+        const generateDuration = node.config.generateDuration;
+        if (generateDuration !== undefined &&
+            (typeof generateDuration !== 'number' ||
+                generateDuration < 5 ||
+                generateDuration > 300)) {
+            errors.push('Generate duration must be between 5 and 300 seconds');
+        }
+        return {
+            errors,
+            valid: errors.length === 0,
+        };
+    }
+    estimateCost(node) {
+        const sourceType = node.config.sourceType;
+        switch (sourceType) {
+            case MusicSourceType.GENERATE:
+                return 5; // AI generation costs more
+            case MusicSourceType.TREND_SOUND:
+                return 2; // Trend lookup costs credits
+            default:
+                return 1; // Library and upload are cheaper
+        }
+    }
+    async execute(input) {
+        const { node, inputs, context } = input;
+        if (!this.resolver) {
+            throw new Error('Music source resolver not configured');
+        }
+        const sourceType = this.getOptionalConfig(node.config, 'sourceType', MusicSourceType.LIBRARY);
+        const trendPlatform = this.getOptionalConfig(node.config, 'trendPlatform', null);
+        const trendMinUsage = this.getOptionalConfig(node.config, 'trendMinUsage', 10000);
+        const libraryCategory = this.getOptionalConfig(node.config, 'libraryCategory', null);
+        const libraryMood = this.getOptionalConfig(node.config, 'libraryMood', null);
+        const generateDuration = this.getOptionalConfig(node.config, 'generateDuration', 30);
+        // Get optional inputs
+        const uploadUrl = inputs.get('uploadUrl');
+        const generatePrompt = inputs.get('generatePrompt');
+        const result = await this.resolver({
+            generateDuration,
+            generatePrompt,
+            libraryCategory,
+            libraryMood,
+            organizationId: context.organizationId,
+            sourceType,
+            trendMinUsage,
+            trendPlatform,
+            uploadUrl,
+        });
+        return {
+            data: result.musicUrl,
+            metadata: {
+                artist: result.artist,
+                duration: result.duration,
+                tempo: result.tempo,
+                title: result.title,
+            },
+        };
+    }
+}
+export function createMusicSourceExecutor(resolver) {
+    const executor = new MusicSourceExecutor();
+    if (resolver) {
+        executor.setResolver(resolver);
+    }
+    return executor;
+}

package/dist/workflow-engine/src/executors/saas/music-source-executor.spec.d.ts

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

package/dist/workflow-engine/src/executors/saas/music-source-executor.spec.d.ts.map

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

package/dist/workflow-engine/src/executors/saas/music-source-executor.spec.js

@@ -0,0 +1,122 @@
+import { MusicSourceType } from '@genfeedai/enums';
+import { createMusicSourceExecutor } from '@workflow-engine/executors/saas/music-source-executor';
+import { describe, expect, it, vi } from 'vitest';
+
+const ctx = {
+  organizationId: 'o',
+  runId: 'r',
+  userId: 'u',
+  workflowId: 'w',
+};
+describe('MusicSourceExecutor', () => {
+  describe('validate', () => {
+    it('valid defaults', () => {
+      expect(
+        createMusicSourceExecutor().validate({
+          config: {},
+          id: '1',
+          inputs: [],
+          label: 'M',
+          type: 'musicSource',
+        }).valid,
+      ).toBe(true);
+    });
+    it('invalid sourceType', () => {
+      expect(
+        createMusicSourceExecutor().validate({
+          config: { sourceType: 'spotify' },
+          id: '1',
+          inputs: [],
+          label: 'M',
+          type: 'musicSource',
+        }).valid,
+      ).toBe(false);
+    });
+    it('invalid generateDuration', () => {
+      expect(
+        createMusicSourceExecutor().validate({
+          config: { generateDuration: 500 },
+          id: '1',
+          inputs: [],
+          label: 'M',
+          type: 'musicSource',
+        }).valid,
+      ).toBe(false);
+    });
+  });
+  describe('estimateCost', () => {
+    it('5 for generate', () => {
+      expect(
+        createMusicSourceExecutor().estimateCost({
+          config: { sourceType: MusicSourceType.GENERATE },
+          id: '1',
+          inputs: [],
+          label: 'M',
+          type: 'musicSource',
+        }),
+      ).toBe(5);
+    });
+    it('2 for trend', () => {
+      expect(
+        createMusicSourceExecutor().estimateCost({
+          config: { sourceType: MusicSourceType.TREND_SOUND },
+          id: '1',
+          inputs: [],
+          label: 'M',
+          type: 'musicSource',
+        }),
+      ).toBe(2);
+    });
+    it('1 for library', () => {
+      expect(
+        createMusicSourceExecutor().estimateCost({
+          config: { sourceType: MusicSourceType.LIBRARY },
+          id: '1',
+          inputs: [],
+          label: 'M',
+          type: 'musicSource',
+        }),
+      ).toBe(1);
+    });
+  });
+  describe('execute', () => {
+    it('throws without resolver', async () => {
+      await expect(
+        createMusicSourceExecutor().execute({
+          context: ctx,
+          inputs: new Map(),
+          node: {
+            config: {},
+            id: '1',
+            inputs: [],
+            label: 'M',
+            type: 'musicSource',
+          },
+        }),
+      ).rejects.toThrow('resolver');
+    });
+    it('resolves music', async () => {
+      const resolver = vi.fn().mockResolvedValue({
+        artist: 'A',
+        duration: 60,
+        musicUrl: 'http://m.mp3',
+        tempo: 120,
+        title: 'Song',
+      });
+      const exec = createMusicSourceExecutor(resolver);
+      const result = await exec.execute({
+        context: ctx,
+        inputs: new Map(),
+        node: {
+          config: {},
+          id: '1',
+          inputs: [],
+          label: 'M',
+          type: 'musicSource',
+        },
+      });
+      expect(result.data).toBe('http://m.mp3');
+      expect(result.metadata?.title).toBe('Song');
+    });
+  });
+});

package/dist/workflow-engine/src/executors/saas/new-follower-trigger-executor.d.ts

@@ -0,0 +1,44 @@
+import { BaseExecutor, type ExecutorInput, type ExecutorOutput } from '@workflow-engine/executors/base-executor';
+import type { ExecutableNode } from '@workflow-engine/types';
+export type FollowerTriggerPlatform = 'twitter' | 'instagram';
+export interface NewFollowerTriggerOutput {
+    /** The new follower's user ID */
+    followerId: string;
+    /** The new follower's username */
+    followerUsername: string;
+    /** The new follower's display name */
+    followerDisplayName?: string;
+    /** Follower count of the new follower */
+    followerFollowerCount?: number;
+    /** Platform */
+    platform: FollowerTriggerPlatform;
+    /** Timestamp of the follow event */
+    followedAt: string;
+}
+export type NewFollowerChecker = (params: {
+    organizationId: string;
+    platform: FollowerTriggerPlatform;
+    minFollowerCount?: number;
+    lastFollowerId: string | null;
+}) => Promise<NewFollowerTriggerOutput | null>;
+/**
+ * New Follower Trigger Executor
+ *
+ * Starts a workflow when a new follower matching criteria is detected.
+ * Polls followers at configurable intervals and deduplicates.
+ *
+ * Node Type: newFollowerTrigger
+ */
+export declare class NewFollowerTriggerExecutor extends BaseExecutor {
+    readonly nodeType = "newFollowerTrigger";
+    private checker;
+    setChecker(checker: NewFollowerChecker): void;
+    validate(node: ExecutableNode): {
+        valid: boolean;
+        errors: string[];
+    };
+    execute(input: ExecutorInput): Promise<ExecutorOutput>;
+    estimateCost(_node: ExecutableNode): number;
+}
+export declare function createNewFollowerTriggerExecutor(): NewFollowerTriggerExecutor;
+//# sourceMappingURL=new-follower-trigger-executor.d.ts.map

package/dist/workflow-engine/src/executors/saas/new-follower-trigger-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-follower-trigger-executor.d.ts","sourceRoot":"","sources":["../../../../../src/executors/saas/new-follower-trigger-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,uBAAuB,GAAG,SAAS,GAAG,WAAW,CAAC;AAE9D,MAAM,WAAW,wBAAwB;IACvC,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,eAAe;IACf,QAAQ,EAAE,uBAAuB,CAAC;IAClC,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,KAAK,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAAC;AAM/C;;;;;;;GAOG;AACH,qBAAa,0BAA2B,SAAQ,YAAY;IAC1D,QAAQ,CAAC,QAAQ,wBAAwB;IACzC,OAAO,CAAC,OAAO,CAAmC;IAElD,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAI7C,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAkB9D,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA8C5D,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;CAG5C;AAED,wBAAgB,gCAAgC,IAAI,0BAA0B,CAE7E"}

package/dist/workflow-engine/src/executors/saas/new-follower-trigger-executor.js

@@ -0,0 +1,65 @@
+import { BaseExecutor, } from '@workflow-engine/executors/base-executor';
+// =============================================================================
+// EXECUTOR
+// =============================================================================
+/**
+ * New Follower Trigger Executor
+ *
+ * Starts a workflow when a new follower matching criteria is detected.
+ * Polls followers at configurable intervals and deduplicates.
+ *
+ * Node Type: newFollowerTrigger
+ */
+export class NewFollowerTriggerExecutor extends BaseExecutor {
+    nodeType = 'newFollowerTrigger';
+    checker = null;
+    setChecker(checker) {
+        this.checker = checker;
+    }
+    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, context } = input;
+        if (!this.checker) {
+            throw new Error('New follower checker not configured');
+        }
+        const platform = this.getRequiredConfig(node.config, 'platform');
+        const minFollowerCount = this.getOptionalConfig(node.config, 'minFollowerCount', undefined);
+        const lastFollowerId = this.getOptionalConfig(node.config, 'lastFollowerId', null);
+        const result = await this.checker({
+            lastFollowerId,
+            minFollowerCount,
+            organizationId: context.organizationId,
+            platform,
+        });
+        if (!result) {
+            return {
+                data: null,
+                metadata: { matched: false, platform },
+            };
+        }
+        return {
+            data: result,
+            metadata: {
+                followerId: result.followerId,
+                matched: true,
+                platform,
+            },
+        };
+    }
+    estimateCost(_node) {
+        return 0;
+    }
+}
+export function createNewFollowerTriggerExecutor() {
+    return new NewFollowerTriggerExecutor();
+}

package/dist/workflow-engine/src/executors/saas/new-follower-trigger-executor.spec.d.ts

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

package/dist/workflow-engine/src/executors/saas/new-follower-trigger-executor.spec.d.ts.map

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

package/dist/workflow-engine/src/executors/saas/new-follower-trigger-executor.spec.js

@@ -0,0 +1,66 @@
+import { createNewFollowerTriggerExecutor } from '@workflow-engine/executors/saas/new-follower-trigger-executor';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+function makeInput(config) {
+  const node = {
+    config,
+    id: 'trigger-1',
+    inputs: [],
+    label: 'New Follower',
+    type: 'newFollowerTrigger',
+  };
+  const context = {
+    organizationId: 'org-1',
+    runId: 'run-1',
+    userId: 'user-1',
+    workflowId: 'wf-1',
+  };
+  return { context, inputs: new Map(), node };
+}
+describe('NewFollowerTriggerExecutor', () => {
+  let executor;
+  let mockChecker;
+  beforeEach(() => {
+    executor = createNewFollowerTriggerExecutor();
+    mockChecker = vi.fn().mockResolvedValue({
+      followedAt: '2026-02-21T20:00:00Z',
+      followerId: 'f-1',
+      followerUsername: 'newguy',
+      platform: 'twitter',
+    });
+    executor.setChecker(mockChecker);
+  });
+  it('creates via factory', () => {
+    expect(executor.nodeType).toBe('newFollowerTrigger');
+  });
+  it('throws if checker not configured', async () => {
+    const fresh = createNewFollowerTriggerExecutor();
+    const input = makeInput({ platform: 'twitter' });
+    await expect(fresh.execute(input)).rejects.toThrow(
+      'checker not configured',
+    );
+  });
+  it('returns follower data when matched', async () => {
+    const input = makeInput({ platform: 'twitter' });
+    const result = await executor.execute(input);
+    expect(result.metadata).toMatchObject({ matched: true });
+    expect(result.data).toMatchObject({ followerId: 'f-1' });
+  });
+  it('returns null when no match', async () => {
+    mockChecker.mockResolvedValue(null);
+    const input = makeInput({ platform: 'twitter' });
+    const result = await executor.execute(input);
+    expect(result.metadata).toMatchObject({ matched: false });
+    expect(result.data).toBeNull();
+  });
+  it('validates platform', () => {
+    const node = {
+      config: { platform: 'tiktok' },
+      id: 't1',
+      inputs: [],
+      label: 'T',
+      type: 'newFollowerTrigger',
+    };
+    expect(executor.validate(node).valid).toBe(false);
+  });
+});