@d34dman/flowdrop 0.0.57 → 0.0.59

package/dist/registry/nodeComponentRegistry.js

@@ -8,10 +8,13 @@
  * - External libraries to contribute node types via plugins
  * - Runtime switching between different node visualizations
  */
+import { BaseRegistry } from './BaseRegistry.js';
 /**
  * Central registry for node component types.
  * Allows built-in and third-party components to be registered and resolved.
  *
+ * Extends BaseRegistry for shared mechanics (subscribe, onClear, etc.).
+ *
  * @example
  * ```typescript
  * // Register a custom node
@@ -27,13 +30,11 @@
  * const component = nodeComponentRegistry.getComponent("myCustomNode");
  * ```
  */
-class NodeComponentRegistry {
-    /** Map of type -> registration */
-    components = new Map();
+class NodeComponentRegistry extends BaseRegistry {
     /** Default type to use when requested type is not found */
     defaultType = 'workflowNode';
-    /** Listeners for registry changes */
-    listeners = new Set();
+    /** Initial default type, restored on clear() */
+    static INITIAL_DEFAULT_TYPE = 'workflowNode';
     /**
      * Register a node component type.
      *
@@ -51,12 +52,19 @@ class NodeComponentRegistry {
      * });
      * ```
      */
+    /**
+     * Clear all registrations and reset default type.
+     */
+    clear() {
+        super.clear();
+        this.defaultType = NodeComponentRegistry.INITIAL_DEFAULT_TYPE;
+    }
     register(registration, overwrite = false) {
-        if (this.components.has(registration.type) && !overwrite) {
+        if (this.items.has(registration.type) && !overwrite) {
             throw new Error(`Node type "${registration.type}" is already registered. ` +
                 `Use overwrite: true to replace it, or use a namespaced type like "mylib:${registration.type}".`);
         }
-        this.components.set(registration.type, registration);
+        this.items.set(registration.type, registration);
         this.notifyListeners();
     }
     /**
@@ -71,28 +79,6 @@ class NodeComponentRegistry {
             this.register(registration, overwrite);
         }
     }
-    /**
-     * Unregister a node component type.
-     *
-     * @param type - The type identifier to remove
-     * @returns true if the type was found and removed, false otherwise
-     */
-    unregister(type) {
-        const result = this.components.delete(type);
-        if (result) {
-            this.notifyListeners();
-        }
-        return result;
-    }
-    /**
-     * Get a registration by type.
-     *
-     * @param type - The type identifier to look up
-     * @returns The registration if found, undefined otherwise
-     */
-    get(type) {
-        return this.components.get(type);
-    }
     /**
      * Get the component for a type, with fallback to default.
      *
@@ -100,17 +86,21 @@ class NodeComponentRegistry {
      * @returns The component if found, or the default component
      */
     getComponent(type) {
-        const registration = this.components.get(type) ?? this.components.get(this.defaultType);
+        const registration = this.items.get(type) ?? this.items.get(this.defaultType);
         return registration?.component;
     }
     /**
-     * Check if a type is registered.
+     * Get framework-agnostic metadata for a type, without the Svelte component.
      *
-     * @param type - The type identifier to check
-     * @returns true if the type is registered
+     * @param type - The type identifier to look up
+     * @returns The metadata if found, undefined otherwise
      */
-    has(type) {
-        return this.components.has(type);
+    getMetadata(type) {
+        const reg = this.items.get(type);
+        if (!reg)
+            return undefined;
+        const { component: _, ...metadata } = reg;
+        return metadata;
     }
     /**
      * Get all registered type identifiers.
@@ -118,15 +108,7 @@ class NodeComponentRegistry {
      * @returns Array of registered type strings
      */
     getTypes() {
-        return Array.from(this.components.keys());
-    }
-    /**
-     * Get all registrations.
-     *
-     * @returns Array of all registered node component metadata
-     */
-    getAll() {
-        return Array.from(this.components.values());
+        return this.getKeys();
     }
     /**
      * Get registrations filtered by criteria.
@@ -182,7 +164,7 @@ class NodeComponentRegistry {
      * @throws Error if the type is not registered
      */
     setDefaultType(type) {
-        if (!this.components.has(type)) {
+        if (!this.items.has(type)) {
             throw new Error(`Cannot set default to unregistered type: ${type}`);
         }
         this.defaultType = type;
@@ -195,25 +177,6 @@ class NodeComponentRegistry {
     getDefaultType() {
         return this.defaultType;
     }
-    /**
-     * Subscribe to registry changes.
-     * Called whenever components are registered or unregistered.
-     *
-     * @param listener - Callback to invoke on changes
-     * @returns Unsubscribe function
-     */
-    subscribe(listener) {
-        this.listeners.add(listener);
-        return () => this.listeners.delete(listener);
-    }
-    /**
-     * Notify all listeners of a change.
-     */
-    notifyListeners() {
-        for (const listener of this.listeners) {
-            listener();
-        }
-    }
     /**
      * Get oneOf options for config forms.
      * Returns array suitable for JSON Schema oneOf with const/title.
@@ -241,7 +204,7 @@ class NodeComponentRegistry {
      * @returns The status position, or default "top-right"
      */
     getStatusPosition(type) {
-        return this.components.get(type)?.statusPosition ?? 'top-right';
+        return this.items.get(type)?.statusPosition ?? 'top-right';
     }
     /**
      * Get the status size for a node type.
@@ -250,23 +213,7 @@ class NodeComponentRegistry {
      * @returns The status size, or default "md"
      */
     getStatusSize(type) {
-        return this.components.get(type)?.statusSize ?? 'md';
-    }
-    /**
-     * Clear all registrations.
-     * Primarily useful for testing.
-     */
-    clear() {
-        this.components.clear();
-        this.notifyListeners();
-    }
-    /**
-     * Get the count of registered components.
-     *
-     * @returns Number of registered node types
-     */
-    get size() {
-        return this.components.size;
+        return this.items.get(type)?.statusSize ?? 'md';
     }
 }
 /** Singleton instance of the node component registry */

package/dist/registry/workflowFormatRegistry.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Workflow Format Registry
+ *
+ * Central registry for workflow format adapters that allows built-in and
+ * third-party formats to be registered and resolved at runtime.
+ *
+ * This enables:
+ * - Custom workflow formats (e.g., n8n, LangGraph) to be registered by users
+ * - Format adapters to bundle their own node types
+ * - Bidirectional conversion between FlowDrop's StandardWorkflow and external formats
+ *
+ * Extends BaseRegistry for shared mechanics (subscribe, onClear, etc.).
+ */
+import type { StandardWorkflow } from '../adapters/WorkflowAdapter.js';
+import type { NodeMetadata, WorkflowFormat } from '../types/index.js';
+import { BaseRegistry } from './BaseRegistry.js';
+/**
+ * Validation result returned by format adapters.
+ */
+export interface FormatValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Interface that all workflow format adapters must implement.
+ * Adapters handle bidirectional conversion between FlowDrop's StandardWorkflow
+ * and an external workflow format.
+ *
+ * @example
+ * ```typescript
+ * const myAdapter: WorkflowFormatAdapter = {
+ *   id: 'n8n',
+ *   name: 'n8n Workflow',
+ *   export: (workflow) => JSON.stringify(convertToN8n(workflow)),
+ *   import: (data) => convertFromN8n(JSON.parse(data)),
+ * };
+ * ```
+ */
+export interface WorkflowFormatAdapter {
+    /** Unique format identifier (e.g., 'agentspec', 'n8n') */
+    id: WorkflowFormat;
+    /** Display name for UI (e.g., 'Agent Spec (Oracle)') */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Version */
+    version?: string;
+    /**
+     * Optional node types specific to this format.
+     * When provided, these nodes are merged into the sidebar
+     * and automatically tagged with this format.
+     */
+    nodes?: NodeMetadata[];
+    /** Convert a StandardWorkflow to this format's JSON string */
+    export(workflow: StandardWorkflow): string;
+    /** Parse this format's input and convert to StandardWorkflow */
+    import(data: string): StandardWorkflow;
+    /** Validate whether a workflow can be exported to this format */
+    validate?(workflow: StandardWorkflow): FormatValidationResult;
+}
+/**
+ * Central registry for workflow format adapters.
+ * Singleton — extends BaseRegistry for shared mechanics.
+ *
+ * @example
+ * ```typescript
+ * // Register a custom format
+ * workflowFormatRegistry.register({
+ *   id: 'n8n',
+ *   name: 'n8n Workflow',
+ *   export: (workflow) => JSON.stringify(convertToN8n(workflow)),
+ *   import: (data) => convertFromN8n(JSON.parse(data)),
+ * });
+ *
+ * // Get an adapter
+ * const adapter = workflowFormatRegistry.get('n8n');
+ * ```
+ */
+declare class WorkflowFormatRegistry extends BaseRegistry<string, WorkflowFormatAdapter> {
+    /**
+     * Register a workflow format adapter.
+     *
+     * @param adapter - The format adapter to register
+     * @param overwrite - If true, allows overwriting existing registrations
+     * @throws Error if format already registered and overwrite is false
+     */
+    register(adapter: WorkflowFormatAdapter, overwrite?: boolean): void;
+    /**
+     * Get all registered format identifiers.
+     *
+     * @returns Array of format id strings
+     */
+    getIds(): string[];
+    /**
+     * Get all node types provided by registered format adapters.
+     * Collects `adapter.nodes` from all adapters that provide them.
+     *
+     * @returns Array of NodeMetadata from all format adapters
+     */
+    getAllFormatNodes(): NodeMetadata[];
+    /**
+     * Get node types for a specific format.
+     *
+     * @param formatId - The format identifier
+     * @returns Array of NodeMetadata for the format, or empty array
+     */
+    getFormatNodes(formatId: WorkflowFormat): NodeMetadata[];
+    /**
+     * Get oneOf options for config forms.
+     * Returns array suitable for JSON Schema oneOf with const/title.
+     *
+     * @returns Array of oneOf items
+     */
+    getOneOfOptions(): Array<{
+        const: string;
+        title: string;
+    }>;
+}
+/** Singleton instance of the workflow format registry */
+export declare const workflowFormatRegistry: WorkflowFormatRegistry;
+export {};

package/dist/registry/workflowFormatRegistry.js

@@ -0,0 +1,96 @@
+/**
+ * Workflow Format Registry
+ *
+ * Central registry for workflow format adapters that allows built-in and
+ * third-party formats to be registered and resolved at runtime.
+ *
+ * This enables:
+ * - Custom workflow formats (e.g., n8n, LangGraph) to be registered by users
+ * - Format adapters to bundle their own node types
+ * - Bidirectional conversion between FlowDrop's StandardWorkflow and external formats
+ *
+ * Extends BaseRegistry for shared mechanics (subscribe, onClear, etc.).
+ */
+import { BaseRegistry } from './BaseRegistry.js';
+/**
+ * Central registry for workflow format adapters.
+ * Singleton — extends BaseRegistry for shared mechanics.
+ *
+ * @example
+ * ```typescript
+ * // Register a custom format
+ * workflowFormatRegistry.register({
+ *   id: 'n8n',
+ *   name: 'n8n Workflow',
+ *   export: (workflow) => JSON.stringify(convertToN8n(workflow)),
+ *   import: (data) => convertFromN8n(JSON.parse(data)),
+ * });
+ *
+ * // Get an adapter
+ * const adapter = workflowFormatRegistry.get('n8n');
+ * ```
+ */
+class WorkflowFormatRegistry extends BaseRegistry {
+    /**
+     * Register a workflow format adapter.
+     *
+     * @param adapter - The format adapter to register
+     * @param overwrite - If true, allows overwriting existing registrations
+     * @throws Error if format already registered and overwrite is false
+     */
+    register(adapter, overwrite = false) {
+        if (this.items.has(adapter.id) && !overwrite) {
+            throw new Error(`Workflow format "${adapter.id}" is already registered. ` +
+                `Use overwrite: true to replace it.`);
+        }
+        this.items.set(adapter.id, adapter);
+        this.notifyListeners();
+    }
+    /**
+     * Get all registered format identifiers.
+     *
+     * @returns Array of format id strings
+     */
+    getIds() {
+        return this.getKeys();
+    }
+    /**
+     * Get all node types provided by registered format adapters.
+     * Collects `adapter.nodes` from all adapters that provide them.
+     *
+     * @returns Array of NodeMetadata from all format adapters
+     */
+    getAllFormatNodes() {
+        const allNodes = [];
+        for (const adapter of this.items.values()) {
+            if (adapter.nodes && adapter.nodes.length > 0) {
+                allNodes.push(...adapter.nodes);
+            }
+        }
+        return allNodes;
+    }
+    /**
+     * Get node types for a specific format.
+     *
+     * @param formatId - The format identifier
+     * @returns Array of NodeMetadata for the format, or empty array
+     */
+    getFormatNodes(formatId) {
+        const adapter = this.items.get(formatId);
+        return adapter?.nodes ?? [];
+    }
+    /**
+     * Get oneOf options for config forms.
+     * Returns array suitable for JSON Schema oneOf with const/title.
+     *
+     * @returns Array of oneOf items
+     */
+    getOneOfOptions() {
+        return this.getAll().map((adapter) => ({
+            const: adapter.id,
+            title: adapter.name
+        }));
+    }
+}
+/** Singleton instance of the workflow format registry */
+export const workflowFormatRegistry = new WorkflowFormatRegistry();

package/dist/schema/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * FlowDrop Workflow JSON Schema
+ *
+ * Provides the versioned JSON Schema for the FlowDrop workflow document format.
+ * The schema is generated from the OpenAPI YAML definitions in `api/components/schemas/`.
+ *
+ * @example
+ * ```typescript
+ * import { workflowSchema, WORKFLOW_SCHEMA_VERSION } from '@d34dman/flowdrop/core';
+ *
+ * // Use with any JSON Schema validator (e.g., Ajv)
+ * import Ajv from 'ajv/dist/2020';
+ * const ajv = new Ajv();
+ * const validate = ajv.compile(workflowSchema);
+ * const valid = validate(myWorkflow);
+ * ```
+ *
+ * @module schema
+ */
+import workflowSchema from '../schemas/v1/workflow.schema.json';
+/** Current workflow schema format version */
+export declare const WORKFLOW_SCHEMA_VERSION = "1.0.0";
+export { workflowSchema };

package/dist/schema/index.js

@@ -0,0 +1,23 @@
+/**
+ * FlowDrop Workflow JSON Schema
+ *
+ * Provides the versioned JSON Schema for the FlowDrop workflow document format.
+ * The schema is generated from the OpenAPI YAML definitions in `api/components/schemas/`.
+ *
+ * @example
+ * ```typescript
+ * import { workflowSchema, WORKFLOW_SCHEMA_VERSION } from '@d34dman/flowdrop/core';
+ *
+ * // Use with any JSON Schema validator (e.g., Ajv)
+ * import Ajv from 'ajv/dist/2020';
+ * const ajv = new Ajv();
+ * const validate = ajv.compile(workflowSchema);
+ * const valid = validate(myWorkflow);
+ * ```
+ *
+ * @module schema
+ */
+import workflowSchema from '../schemas/v1/workflow.schema.json';
+/** Current workflow schema format version */
+export const WORKFLOW_SCHEMA_VERSION = '1.0.0';
+export { workflowSchema };