@genfeedai/workflow-saas 0.2.0

package/dist/workflow-saas/src/registry/saas-definitions.js

@@ -0,0 +1,290 @@
+import { DEFAULT_BRAND_ASSET_DATA, DEFAULT_BRAND_CONTEXT_DATA, DEFAULT_BRAND_DATA, DEFAULT_CONDITION_DATA, DEFAULT_DELAY_DATA, DEFAULT_ENGAGEMENT_TRIGGER_DATA, DEFAULT_FOLLOW_USER_DATA, DEFAULT_KEYWORD_TRIGGER_DATA, DEFAULT_LIKE_POST_DATA, DEFAULT_MUSIC_SOURCE_DATA, DEFAULT_PATTERN_CONTEXT_DATA, DEFAULT_PERSONA_CONTENT_PLAN_DATA, DEFAULT_PERSONA_PHOTO_SESSION_DATA, DEFAULT_PERSONA_VIDEO_CONTENT_DATA, DEFAULT_POST_REPLY_DATA, DEFAULT_PUBLISH_DATA, DEFAULT_SEND_DM_DATA, DEFAULT_SOUND_OVERLAY_DATA, } from '@workflow-saas/nodes';
+/**
+ * SaaS-specific node definitions
+ *
+ * These nodes are only available in the SaaS platform
+ * and extend the core workflow functionality with
+ * multi-tenant features like brand context and assets.
+ */
+export const SAAS_NODE_DEFINITIONS = {
+    brand: {
+        category: 'input',
+        defaultData: DEFAULT_BRAND_DATA,
+        description: 'Select a brand from your organization to inject brand context',
+        icon: 'Store',
+        inputs: [],
+        label: 'Brand',
+        outputs: [
+            { id: 'brand', label: 'Brand Context', type: 'brand' },
+            { id: 'voice', label: 'Voice', type: 'text' },
+            { id: 'colors', label: 'Colors', type: 'object' },
+            { id: 'fonts', label: 'Fonts', type: 'object' },
+        ],
+        type: 'brand',
+    },
+    brandAsset: {
+        category: 'saas',
+        defaultData: DEFAULT_BRAND_ASSET_DATA,
+        description: 'Resolve brand logos, banners, and reference images',
+        icon: 'ImageIcon',
+        inputs: [],
+        label: 'Brand Asset',
+        outputs: [
+            { id: 'image', label: 'Asset', type: 'image' },
+            {
+                id: 'images',
+                label: 'Reference Images',
+                multiple: true,
+                type: 'image',
+            },
+        ],
+        type: 'brandAsset',
+    },
+    brandContext: {
+        category: 'saas',
+        defaultData: DEFAULT_BRAND_CONTEXT_DATA,
+        description: 'Inject brand voice, colors, fonts, and default models into workflow',
+        icon: 'Palette',
+        inputs: [],
+        label: 'Brand Context',
+        outputs: [
+            { id: 'voice', label: 'Brand Voice', type: 'text' },
+            { id: 'colors', label: 'Color Palette', type: 'text' },
+            { id: 'fonts', label: 'Font Family', type: 'text' },
+            { id: 'models', label: 'Default Models', type: 'text' },
+        ],
+        type: 'brandContext',
+    },
+    condition: {
+        category: 'processing',
+        defaultData: DEFAULT_CONDITION_DATA,
+        description: 'Branch workflow based on field conditions, comparisons, or expressions',
+        icon: 'GitBranch',
+        inputs: [{ id: 'value', label: 'Value', required: true, type: 'any' }],
+        label: 'Condition',
+        outputs: [
+            { id: 'true', label: 'True', type: 'any' },
+            { id: 'false', label: 'False', type: 'any' },
+        ],
+        type: 'condition',
+    },
+    delay: {
+        category: 'processing',
+        defaultData: DEFAULT_DELAY_DATA,
+        description: 'Pause workflow execution for a fixed duration, until a time, or optimal posting time',
+        icon: 'Clock',
+        inputs: [{ id: 'data', label: 'Data', required: false, type: 'any' }],
+        label: 'Delay',
+        outputs: [{ id: 'data', label: 'Data', type: 'any' }],
+        type: 'delay',
+    },
+    engagementTrigger: {
+        category: 'automation',
+        defaultData: DEFAULT_ENGAGEMENT_TRIGGER_DATA,
+        description: 'Start workflow when engagement metrics (likes, comments, shares, views) hit a threshold',
+        icon: 'BarChart2',
+        inputs: [],
+        label: 'Engagement Trigger',
+        outputs: [
+            { id: 'postId', label: 'Post ID', type: 'text' },
+            { id: 'postUrl', label: 'Post URL', type: 'text' },
+            { id: 'metricType', label: 'Metric Type', type: 'text' },
+            { id: 'currentValue', label: 'Current Value', type: 'number' },
+            { id: 'threshold', label: 'Threshold', type: 'number' },
+            { id: 'platform', label: 'Platform', type: 'text' },
+        ],
+        type: 'engagementTrigger',
+    },
+    followUser: {
+        category: 'automation',
+        defaultData: DEFAULT_FOLLOW_USER_DATA,
+        description: 'Follow a user account on a social platform',
+        icon: 'UserPlus',
+        inputs: [
+            { id: 'brand', label: 'Brand', required: true, type: 'brand' },
+            { id: 'userId', label: 'User ID', required: true, type: 'text' },
+        ],
+        label: 'Follow User',
+        outputs: [{ id: 'success', label: 'Success', type: 'text' }],
+        type: 'followUser',
+    },
+    keywordTrigger: {
+        category: 'automation',
+        defaultData: DEFAULT_KEYWORD_TRIGGER_DATA,
+        description: 'Start workflow when a keyword or phrase is detected in social posts',
+        icon: 'Search',
+        inputs: [],
+        label: 'Keyword Trigger',
+        outputs: [
+            { id: 'postId', label: 'Post ID', type: 'text' },
+            { id: 'postUrl', label: 'Post URL', type: 'text' },
+            { id: 'text', label: 'Post Text', type: 'text' },
+            { id: 'matchedKeyword', label: 'Matched Keyword', type: 'text' },
+            { id: 'authorId', label: 'Author ID', type: 'text' },
+            { id: 'authorUsername', label: 'Author Username', type: 'text' },
+            { id: 'platform', label: 'Platform', type: 'text' },
+        ],
+        type: 'keywordTrigger',
+    },
+    likePost: {
+        category: 'automation',
+        defaultData: DEFAULT_LIKE_POST_DATA,
+        description: 'Like or favorite a post on a social platform',
+        icon: 'Heart',
+        inputs: [
+            { id: 'brand', label: 'Brand', required: true, type: 'brand' },
+            { id: 'postId', label: 'Post ID', required: true, type: 'text' },
+        ],
+        label: 'Like Post',
+        outputs: [{ id: 'success', label: 'Success', type: 'text' }],
+        type: 'likePost',
+    },
+    musicSource: {
+        category: 'input',
+        defaultData: DEFAULT_MUSIC_SOURCE_DATA,
+        description: 'Resolve music from trends, library, upload, or AI generation',
+        icon: 'Music',
+        inputs: [
+            { id: 'uploadUrl', label: 'Upload URL', required: false, type: 'text' },
+            {
+                id: 'generatePrompt',
+                label: 'AI Prompt',
+                required: false,
+                type: 'text',
+            },
+        ],
+        label: 'Music Source',
+        outputs: [
+            { id: 'musicUrl', label: 'Music URL', type: 'text' },
+            { id: 'duration', label: 'Duration (s)', type: 'number' },
+            { id: 'tempo', label: 'Tempo (BPM)', type: 'number' },
+            { id: 'title', label: 'Title', type: 'text' },
+        ],
+        type: 'musicSource',
+    },
+    patternContext: {
+        category: 'saas',
+        defaultData: DEFAULT_PATTERN_CONTEXT_DATA,
+        description: 'Retrieve proven creative patterns for your brand from performance data',
+        icon: 'TrendingUp',
+        inputs: [],
+        label: 'Pattern Context',
+        outputs: [{ id: 'patterns', label: 'Patterns', type: 'object' }],
+        type: 'patternContext',
+    },
+    personaContentPlan: {
+        category: 'saas',
+        defaultData: DEFAULT_PERSONA_CONTENT_PLAN_DATA,
+        description: 'Generate an N-day content plan based on persona content strategy',
+        icon: 'Calendar',
+        inputs: [{ id: 'brand', label: 'Brand', required: true, type: 'brand' }],
+        label: 'Content Plan',
+        outputs: [{ id: 'plan', label: 'Content Plan', type: 'object' }],
+        type: 'personaContentPlan',
+    },
+    personaPhotoSession: {
+        category: 'saas',
+        defaultData: DEFAULT_PERSONA_PHOTO_SESSION_DATA,
+        description: 'Generate batch photos for an AI persona using their avatar',
+        icon: 'Camera',
+        inputs: [{ id: 'brand', label: 'Brand', required: true, type: 'brand' }],
+        label: 'Persona Photo Session',
+        outputs: [
+            {
+                id: 'images',
+                label: 'Generated Photos',
+                multiple: true,
+                type: 'image',
+            },
+        ],
+        type: 'personaPhotoSession',
+    },
+    personaVideoContent: {
+        category: 'saas',
+        defaultData: DEFAULT_PERSONA_VIDEO_CONTENT_DATA,
+        description: 'Generate video content with AI persona avatar and voice',
+        icon: 'Video',
+        inputs: [
+            { id: 'brand', label: 'Brand', required: true, type: 'brand' },
+            { id: 'script', label: 'Script', type: 'text' },
+        ],
+        label: 'Persona Video',
+        outputs: [{ id: 'video', label: 'Generated Video', type: 'video' }],
+        type: 'personaVideoContent',
+    },
+    postReply: {
+        category: 'automation',
+        defaultData: DEFAULT_POST_REPLY_DATA,
+        description: 'Reply to a social media post on Twitter, Instagram, Threads, or Facebook',
+        icon: 'MessageSquare',
+        inputs: [
+            { id: 'brand', label: 'Brand', required: true, type: 'brand' },
+            { id: 'postId', label: 'Post ID', required: true, type: 'text' },
+            { id: 'text', label: 'Reply Text', required: true, type: 'text' },
+        ],
+        label: 'Post Reply',
+        outputs: [
+            { id: 'replyId', label: 'Reply ID', type: 'text' },
+            { id: 'replyUrl', label: 'Reply URL', type: 'text' },
+        ],
+        type: 'postReply',
+    },
+    publish: {
+        category: 'output',
+        defaultData: DEFAULT_PUBLISH_DATA,
+        description: 'Publish content to Twitter, Instagram, TikTok, or LinkedIn',
+        icon: 'Share2',
+        inputs: [
+            { id: 'brand', label: 'Brand', required: true, type: 'brand' },
+            { id: 'media', label: 'Media', required: true, type: 'any' },
+            { id: 'caption', label: 'Caption', type: 'text' },
+        ],
+        label: 'Publish',
+        outputs: [],
+        type: 'publish',
+    },
+    sendDm: {
+        category: 'automation',
+        defaultData: DEFAULT_SEND_DM_DATA,
+        description: 'Send a direct message on Twitter or Instagram',
+        icon: 'Send',
+        inputs: [
+            { id: 'brand', label: 'Brand', required: true, type: 'brand' },
+            {
+                id: 'recipientId',
+                label: 'Recipient ID',
+                required: true,
+                type: 'text',
+            },
+            { id: 'text', label: 'Message Text', required: true, type: 'text' },
+        ],
+        label: 'Send DM',
+        outputs: [{ id: 'messageId', label: 'Message ID', type: 'text' }],
+        type: 'sendDm',
+    },
+    soundOverlay: {
+        category: 'processing',
+        defaultData: DEFAULT_SOUND_OVERLAY_DATA,
+        description: 'Add audio track to video via FFmpeg',
+        icon: 'Volume2',
+        inputs: [
+            { id: 'videoUrl', label: 'Video URL', required: true, type: 'text' },
+            { id: 'soundUrl', label: 'Sound URL', required: true, type: 'text' },
+        ],
+        label: 'Sound Overlay',
+        outputs: [{ id: 'videoUrl', label: 'Output Video', type: 'text' }],
+        type: 'soundOverlay',
+    },
+};
+/**
+ * Get all SaaS node types
+ */
+export function getSaaSNodeTypes() {
+    return Object.keys(SAAS_NODE_DEFINITIONS);
+}
+/**
+ * Check if a node type is a SaaS node
+ */
+export function isSaaSNode(type) {
+    return type in SAAS_NODE_DEFINITIONS;
+}

package/dist/workflow-saas/src/registry/saas-definitions.spec.d.ts

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

package/dist/workflow-saas/src/registry/saas-definitions.spec.d.ts.map

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

package/dist/workflow-saas/src/registry/saas-definitions.spec.js

@@ -0,0 +1,25 @@
+import {
+  isSaaSNode,
+  SAAS_NODE_DEFINITIONS,
+} from '@workflow-saas/registry/saas-definitions';
+import { describe, expect, it } from 'vitest';
+
+describe('SAAS_NODE_DEFINITIONS', () => {
+  it('has expected types', () => {
+    expect(Object.keys(SAAS_NODE_DEFINITIONS)).toContain('brand');
+    expect(Object.keys(SAAS_NODE_DEFINITIONS)).toContain('publish');
+  });
+  it('each has required fields', () => {
+    for (const [type, def] of Object.entries(SAAS_NODE_DEFINITIONS)) {
+      expect(def.type).toBe(type);
+      expect(def.label).toBeTruthy();
+      expect(def.description).toBeTruthy();
+      expect(Array.isArray(def.inputs)).toBe(true);
+      expect(Array.isArray(def.outputs)).toBe(true);
+    }
+  });
+});
+describe('isSaaSNode', () => {
+  it('true for saas', () => expect(isSaaSNode('brand')).toBe(true));
+  it('false for non-saas', () => expect(isSaaSNode('textInput')).toBe(false));
+});

package/dist/workflow-saas/src/types.d.ts

@@ -0,0 +1,22 @@
+import type { BaseNodeData as CoreBaseNodeData } from '@genfeedai/types/nodes';
+import * as CoreNodeTypes from '@genfeedai/types/nodes';
+export type { HandleDefinition, HandleType, NodeCategory, NodeDefinition, NodeStatus, NodeType, } from '@genfeedai/types/nodes';
+export declare const NodeStatusEnum: typeof CoreNodeTypes.NodeStatusEnum;
+export declare const HandleTypeEnum: typeof CoreNodeTypes.HandleTypeEnum;
+export type { NodeType as CoreNodeType } from '@genfeedai/types/nodes';
+export interface BaseNodeData extends CoreBaseNodeData {
+    label: CoreBaseNodeData['label'];
+    status: CoreBaseNodeData['status'];
+    error?: CoreBaseNodeData['error'];
+    progress?: CoreBaseNodeData['progress'];
+    isLocked?: CoreBaseNodeData['isLocked'];
+    cachedOutput?: CoreBaseNodeData['cachedOutput'];
+    lockTimestamp?: CoreBaseNodeData['lockTimestamp'];
+    comment?: CoreBaseNodeData['comment'];
+    color?: CoreBaseNodeData['color'];
+}
+export type { ExtendedNodeCategory, SaaSHandleDefinition, SaaSHandleType, } from './workflows-contracts-shim';
+export interface WorkflowNodeData extends BaseNodeData {
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workflow-saas/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,KAAK,aAAa,MAAM,wBAAwB,CAAC;AAExD,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,UAAU,EACV,QAAQ,GACT,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,cAAc,qCAA+B,CAAC;AAC3D,eAAO,MAAM,cAAc,qCAA+B,CAAC;AAE3D,YAAY,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEvE,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAChD,aAAa,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;IAClD,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;CACnC;AAGD,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,GACf,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/workflow-saas/src/types.js

@@ -0,0 +1,3 @@
+import * as CoreNodeTypes from '@genfeedai/types/nodes';
+export const NodeStatusEnum = CoreNodeTypes.NodeStatusEnum;
+export const HandleTypeEnum = CoreNodeTypes.HandleTypeEnum;

package/dist/workflow-saas/src/types.spec.d.ts

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

package/dist/workflow-saas/src/types.spec.d.ts.map

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

package/dist/workflow-saas/src/types.spec.js

@@ -0,0 +1,7 @@
+import { HandleTypeEnum, NodeStatusEnum } from '@workflow-saas/types';
+import { describe, expect, it } from 'vitest';
+
+describe('types aliased exports', () => {
+  it('exports NodeStatusEnum', () => expect(NodeStatusEnum).toBeDefined());
+  it('exports HandleTypeEnum', () => expect(HandleTypeEnum).toBeDefined());
+});

package/dist/workflow-saas/src/workflows-contracts-shim.d.ts

@@ -0,0 +1,10 @@
+export type SaaSHandleType = 'image' | 'text' | 'video' | 'number' | 'audio' | 'brand' | 'object' | 'any';
+export interface SaaSHandleDefinition {
+    id: string;
+    type: SaaSHandleType;
+    label: string;
+    required?: boolean;
+    multiple?: boolean;
+}
+export type ExtendedNodeCategory = 'input' | 'ai' | 'processing' | 'output' | 'distribution' | 'composition' | 'automation' | 'repurposing' | 'saas';
+//# sourceMappingURL=workflows-contracts-shim.d.ts.map

package/dist/workflow-saas/src/workflows-contracts-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows-contracts-shim.d.ts","sourceRoot":"","sources":["../../../src/workflows-contracts-shim.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,MAAM,GACN,OAAO,GACP,QAAQ,GACR,OAAO,GACP,OAAO,GACP,QAAQ,GACR,KAAK,CAAC;AAEV,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,IAAI,GACJ,YAAY,GACZ,QAAQ,GACR,cAAc,GACd,aAAa,GACb,YAAY,GACZ,aAAa,GACb,MAAM,CAAC"}

package/dist/workflow-saas/src/workflows-contracts-shim.js

@@ -0,0 +1 @@
+export {};

package/dist/workflows-contracts-shim.d.ts

@@ -0,0 +1,27 @@
+export type SaaSHandleType =
+  | 'image'
+  | 'text'
+  | 'video'
+  | 'number'
+  | 'audio'
+  | 'brand'
+  | 'object'
+  | 'any';
+export interface SaaSHandleDefinition {
+  id: string;
+  type: SaaSHandleType;
+  label: string;
+  required?: boolean;
+  multiple?: boolean;
+}
+export type ExtendedNodeCategory =
+  | 'input'
+  | 'ai'
+  | 'processing'
+  | 'output'
+  | 'distribution'
+  | 'composition'
+  | 'automation'
+  | 'repurposing'
+  | 'saas';
+//# sourceMappingURL=workflows-contracts-shim.d.ts.map

package/dist/workflows-contracts-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows-contracts-shim.d.ts","sourceRoot":"","sources":["../src/workflows-contracts-shim.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,MAAM,GACN,OAAO,GACP,QAAQ,GACR,OAAO,GACP,OAAO,GACP,QAAQ,GACR,KAAK,CAAC;AAEV,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,IAAI,GACJ,YAAY,GACZ,QAAQ,GACR,cAAc,GACd,aAAa,GACb,YAAY,GACZ,aAAa,GACb,MAAM,CAAC"}

package/dist/workflows-contracts-shim.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "dependencies": {
+    "@genfeedai/enums": "2.3.2",
+    "@genfeedai/interfaces": "2.3.20",
+    "@genfeedai/types": "0.3.1",
+    "@genfeedai/workflows": "0.3.2"
+  },
+  "devDependencies": {
+    "typescript": "6.0.2"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./nodes": {
+      "types": "./dist/nodes/index.d.ts",
+      "import": "./dist/nodes/index.js",
+      "require": "./dist/nodes/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry/index.d.ts",
+      "import": "./dist/registry/index.js",
+      "require": "./dist/registry/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "require": "./dist/types.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "main": "./dist/index.js",
+  "license": "AGPL-3.0",
+  "name": "@genfeedai/workflow-saas",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc",
+    "deps:update": "bunx npm-check-updates -u --reject typescript && bun install",
+    "dev": "tsc --watch",
+    "prepublishOnly": "bun run build"
+  },
+  "repository": {
+    "directory": "workflow-saas",
+    "type": "git",
+    "url": "git+https://github.com/genfeedai/packages.git"
+  },
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "version": "0.2.0"
+}

package/src/index.ts

@@ -0,0 +1,19 @@
+export * from './nodes';
+export * from './registry';
+
+export type {
+  BaseNodeData,
+  CoreNodeType,
+  ExtendedNodeCategory,
+  HandleDefinition,
+  HandleType,
+  NodeCategory,
+  NodeDefinition,
+  NodeStatus,
+  NodeType,
+  SaaSHandleDefinition,
+  SaaSHandleType,
+  WorkflowNodeData,
+} from './types';
+
+export { HandleTypeEnum, NodeStatusEnum } from './types';

package/src/nodes/beat-analysis.spec.ts

@@ -0,0 +1,81 @@
+import { BeatSensitivity } from '@genfeedai/enums';
+import { describe, expect, it } from 'vitest';
+import {
+  beatAnalysisNodeDefinition,
+  DEFAULT_BEAT_ANALYSIS_DATA,
+} from './beat-analysis';
+
+describe('beat-analysis node', () => {
+  describe('DEFAULT_BEAT_ANALYSIS_DATA', () => {
+    it('should have label set to Beat Analysis', () => {
+      expect(DEFAULT_BEAT_ANALYSIS_DATA.label).toBe('Beat Analysis');
+    });
+
+    it('should default to idle status', () => {
+      expect(DEFAULT_BEAT_ANALYSIS_DATA.status).toBe('idle');
+    });
+
+    it('should default beatSensitivity to MEDIUM', () => {
+      expect(DEFAULT_BEAT_ANALYSIS_DATA.beatSensitivity).toBe(
+        BeatSensitivity.MEDIUM,
+      );
+    });
+
+    it('should default BPM range to 60-200', () => {
+      expect(DEFAULT_BEAT_ANALYSIS_DATA.minBpm).toBe(60);
+      expect(DEFAULT_BEAT_ANALYSIS_DATA.maxBpm).toBe(200);
+    });
+
+    it('should default musicUrl to null', () => {
+      expect(DEFAULT_BEAT_ANALYSIS_DATA.musicUrl).toBeNull();
+    });
+
+    it('should default output arrays to empty', () => {
+      expect(DEFAULT_BEAT_ANALYSIS_DATA.beatTimestamps).toEqual([]);
+      expect(DEFAULT_BEAT_ANALYSIS_DATA.downbeats).toEqual([]);
+    });
+
+    it('should default processing info to null', () => {
+      expect(DEFAULT_BEAT_ANALYSIS_DATA.tempo).toBeNull();
+      expect(DEFAULT_BEAT_ANALYSIS_DATA.beatCount).toBeNull();
+      expect(DEFAULT_BEAT_ANALYSIS_DATA.analysisMethod).toBeNull();
+      expect(DEFAULT_BEAT_ANALYSIS_DATA.confidence).toBeNull();
+    });
+  });
+
+  describe('beatAnalysisNodeDefinition', () => {
+    it('should have type beatAnalysis', () => {
+      expect(beatAnalysisNodeDefinition.type).toBe('beatAnalysis');
+    });
+
+    it('should be in processing category', () => {
+      expect(beatAnalysisNodeDefinition.category).toBe('processing');
+    });
+
+    it('should have label Beat Analysis', () => {
+      expect(beatAnalysisNodeDefinition.label).toBe('Beat Analysis');
+    });
+
+    it('should require musicUrl input', () => {
+      expect(beatAnalysisNodeDefinition.inputs).toHaveLength(1);
+      expect(beatAnalysisNodeDefinition.inputs[0].id).toBe('musicUrl');
+      expect(beatAnalysisNodeDefinition.inputs[0].required).toBe(true);
+    });
+
+    it('should output tempo, beatTimestamps, downbeats, and beatCount', () => {
+      const outputIds = beatAnalysisNodeDefinition.outputs.map((o) => o.id);
+      expect(outputIds).toEqual([
+        'tempo',
+        'beatTimestamps',
+        'downbeats',
+        'beatCount',
+      ]);
+    });
+
+    it('should reference default data', () => {
+      expect(beatAnalysisNodeDefinition.defaultData).toBe(
+        DEFAULT_BEAT_ANALYSIS_DATA,
+      );
+    });
+  });
+});

package/src/nodes/beat-analysis.ts

@@ -0,0 +1,67 @@
+/**
+ * Beat Analysis Node Types
+ *
+ * This node detects tempo and beat timestamps from audio files.
+ * Uses aubio for accurate onset detection with FFmpeg fallback.
+ */
+
+import { BeatSensitivity } from '@genfeedai/enums';
+import type { BaseTrendNodeData } from './trend-shared';
+
+export interface BeatAnalysisNodeData extends BaseTrendNodeData {
+  // Inputs
+  musicUrl: string | null;
+
+  // Configuration
+  minBpm: number;
+  maxBpm: number;
+  beatSensitivity: BeatSensitivity;
+
+  // Outputs
+  tempo: number | null;
+  beatTimestamps: number[];
+  downbeats: number[];
+
+  // Processing info
+  beatCount: number | null;
+  analysisMethod: 'aubio' | 'ffmpeg' | null;
+  confidence: number | null;
+}
+
+export const DEFAULT_BEAT_ANALYSIS_DATA: Partial<BeatAnalysisNodeData> = {
+  analysisMethod: null,
+  beatCount: null,
+  beatSensitivity: BeatSensitivity.MEDIUM,
+  beatTimestamps: [],
+  confidence: null,
+  downbeats: [],
+  label: 'Beat Analysis',
+  maxBpm: 200,
+  minBpm: 60,
+  musicUrl: null,
+  status: 'idle',
+  tempo: null,
+};
+
+export const beatAnalysisNodeDefinition = {
+  category: 'processing' as const,
+  defaultData: DEFAULT_BEAT_ANALYSIS_DATA,
+  description: 'Detect tempo and beat timestamps from audio',
+  icon: 'Activity',
+  inputs: [
+    { id: 'musicUrl', label: 'Music URL', required: true, type: 'text' },
+  ],
+  label: 'Beat Analysis',
+  outputs: [
+    { id: 'tempo', label: 'Tempo (BPM)', type: 'number' },
+    {
+      id: 'beatTimestamps',
+      label: 'Beat Timestamps',
+      multiple: true,
+      type: 'number',
+    },
+    { id: 'downbeats', label: 'Downbeats', multiple: true, type: 'number' },
+    { id: 'beatCount', label: 'Beat Count', type: 'number' },
+  ],
+  type: 'beatAnalysis',
+};