@invect/core 0.0.1

package/dist/services/flow-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-validator.js","names":[],"sources":["../../src/services/flow-validator.ts"],"sourcesContent":["import {\n  FlowValidationResult,\n  ValidationContext,\n  GraphAnalysis,\n  FlowValidationError,\n  FlowValidationWarning,\n} from '../types/validation';\nimport { InvectDefinition, FlowNodeDefinitions, FlowEdge } from './flow-versions/schemas-fresh';\nimport { GraphService } from './graph.service';\n\n/**\n * Checks whether a node type is an entry point (receives external data, not flow data).\n * Entry points: trigger actions and legacy core.input / INPUT nodes.\n */\nfunction isEntryPointNode(nodeType: string): boolean {\n  return nodeType === 'INPUT' || nodeType === 'core.input' || nodeType.startsWith('trigger.');\n}\n\n/**\n * Static flow validator.\n *\n * Designed to help an agent (or user) verify that a flow definition will\n * execute correctly. This does NOT prevent saving — it only reports issues.\n *\n * Errors  = the flow WILL fail at execution time (topological sort throws, etc.)\n * Warnings = the flow will run but something looks unintentional.\n */\nexport class FlowValidator {\n  static validateFlowDefinition(flowDefinition: InvectDefinition): FlowValidationResult {\n    try {\n      const context = new ValidationContext(\n        flowDefinition,\n        this.analyzeGraph(flowDefinition.nodes, flowDefinition.edges),\n      );\n\n      // Phase 1: Empty flow\n      this.validateNotEmpty(context);\n\n      // Phase 2: Edge integrity — edges must reference existing nodes\n      this.validateEdgeReferences(context);\n\n      // Phase 3: Self-referencing edges (source === target)\n      this.validateNoSelfReferences(context);\n\n      // Phase 4: Duplicate edges (same source→target on same handles)\n      this.validateNoDuplicateEdges(context);\n\n      // Phase 5: Cycle detection — cycles make topological sort throw\n      this.validateNoCycles(context);\n\n      // Phase 6: Entry-point nodes should not have incoming edges\n      this.validateEntryPoints(context);\n\n      // Phase 7: Completely disconnected nodes (zero edges)\n      this.validateNoDisconnectedNodes(context);\n\n      // Phase 8: Single manual trigger per flow\n      this.validateSingleManualTrigger(context);\n\n      return this.buildResult(context);\n    } catch (error) {\n      return {\n        isValid: false,\n        errors: [\n          {\n            severity: 'error' as const,\n            type: 'VALIDATION_SYSTEM_ERROR',\n            message: `Validation system error: ${error instanceof Error ? error.message : 'Unknown error'}`,\n          },\n        ],\n        warnings: [],\n      };\n    }\n  }\n\n  // ─── Graph analysis ──────────────────────────────────────────────────────────\n\n  private static analyzeGraph(\n    nodes: readonly FlowNodeDefinitions[],\n    edges: readonly FlowEdge[],\n  ): GraphAnalysis {\n    const nodeMap = new Map(nodes.map((n) => [n.id, n]));\n    const edgeMap = new Map(edges.map((e) => [e.id, e]));\n    const incomingEdges = new Map<string, FlowEdge[]>();\n    const outgoingEdges = new Map<string, FlowEdge[]>();\n\n    for (const node of nodes) {\n      incomingEdges.set(node.id, GraphService.getIncomingEdges(node.id, edges));\n      outgoingEdges.set(node.id, GraphService.getOutgoingEdges(node.id, edges));\n    }\n\n    return { nodeMap, edgeMap, incomingEdges, outgoingEdges };\n  }\n\n  // ─── Phase 1: Empty flow ────────────────────────────────────────────────────\n\n  private static validateNotEmpty(context: ValidationContext): void {\n    if (context.definition.nodes.length === 0) {\n      context.addWarning('EMPTY_FLOW', 'Flow has no nodes');\n    }\n  }\n\n  // ─── Phase 2: Edge references ───────────────────────────────────────────────\n\n  private static validateEdgeReferences(context: ValidationContext): void {\n    const { nodeMap } = context.analysis;\n\n    for (const edge of context.definition.edges) {\n      if (!nodeMap.has(edge.source)) {\n        context.addError('INVALID_EDGE_REFERENCE', 'Edge references non-existent source node', {\n          edgeId: edge.id,\n          sourceNodeId: edge.source,\n          targetNodeId: edge.target,\n        });\n      }\n      if (!nodeMap.has(edge.target)) {\n        context.addError('INVALID_EDGE_REFERENCE', 'Edge references non-existent target node', {\n          edgeId: edge.id,\n          sourceNodeId: edge.source,\n          targetNodeId: edge.target,\n        });\n      }\n    }\n  }\n\n  // ─── Phase 3: Self-referencing edges ────────────────────────────────────────\n\n  private static validateNoSelfReferences(context: ValidationContext): void {\n    for (const edge of context.definition.edges) {\n      if (edge.source === edge.target) {\n        context.addError('SELF_REFERENCING_EDGE', 'Edge connects a node to itself', {\n          edgeId: edge.id,\n          nodeId: edge.source,\n        });\n      }\n    }\n  }\n\n  // ─── Phase 4: Duplicate edges ───────────────────────────────────────────────\n\n  private static validateNoDuplicateEdges(context: ValidationContext): void {\n    const seen = new Set<string>();\n\n    for (const edge of context.definition.edges) {\n      // Include handles so parallel edges on different output ports are allowed\n      const key = `${edge.source}:${edge.sourceHandle ?? ''}→${edge.target}:${edge.targetHandle ?? ''}`;\n      if (seen.has(key)) {\n        context.addWarning('DUPLICATE_EDGE', 'Duplicate connection between the same nodes', {\n          edgeId: edge.id,\n          sourceNodeId: edge.source,\n          targetNodeId: edge.target,\n        });\n      }\n      seen.add(key);\n    }\n  }\n\n  // ─── Phase 5: Cycle detection ───────────────────────────────────────────────\n\n  private static validateNoCycles(context: ValidationContext): void {\n    const { nodes, edges } = context.definition;\n    const result = GraphService.hasCycleDetection(nodes, edges);\n\n    if (result.hasCycle && result.cyclePath) {\n      context.addError('CIRCULAR_DEPENDENCY', 'Flow contains a cycle and cannot be executed', {\n        additionalContext: {\n          cyclePath: result.cyclePath,\n          involvedNodeIds: result.cyclePath.slice(0, -1),\n        },\n      });\n    }\n  }\n\n  // ─── Phase 6: Entry-point nodes ─────────────────────────────────────────────\n\n  private static validateEntryPoints(context: ValidationContext): void {\n    const { incomingEdges } = context.analysis;\n\n    for (const node of context.definition.nodes) {\n      if (!isEntryPointNode(node.type)) {\n        continue;\n      }\n\n      const incoming = incomingEdges.get(node.id) || [];\n      if (incoming.length > 0) {\n        context.addWarning(\n          'ENTRY_NODE_HAS_INCOMING_EDGES',\n          `${node.label || node.type} is an entry-point node and should not have incoming connections`,\n          {\n            nodeId: node.id,\n            sourceNodeType: node.type,\n            additionalContext: {\n              incomingEdgeCount: incoming.length,\n            },\n          },\n        );\n      }\n    }\n  }\n\n  // ─── Phase 7: Disconnected nodes ────────────────────────────────────────────\n\n  private static validateNoDisconnectedNodes(context: ValidationContext): void {\n    const { incomingEdges, outgoingEdges } = context.analysis;\n\n    // Only meaningful when there are at least 2 nodes\n    if (context.definition.nodes.length < 2) {\n      return;\n    }\n\n    for (const node of context.definition.nodes) {\n      const incoming = incomingEdges.get(node.id) || [];\n      const outgoing = outgoingEdges.get(node.id) || [];\n\n      if (incoming.length === 0 && outgoing.length === 0) {\n        context.addWarning('DISCONNECTED_NODE', 'Node has no connections to other nodes', {\n          nodeId: node.id,\n          sourceNodeType: node.type,\n        });\n      }\n    }\n  }\n\n  // ─── Phase 8: Single manual trigger ─────────────────────────────────────────\n\n  private static validateSingleManualTrigger(context: ValidationContext): void {\n    const manualTriggers = context.definition.nodes.filter((n) => n.type === 'trigger.manual');\n\n    if (manualTriggers.length > 1) {\n      context.addError(\n        'MULTIPLE_MANUAL_TRIGGERS',\n        `Only one Manual Trigger is allowed per flow, but ${manualTriggers.length} were found`,\n        {\n          additionalContext: {\n            triggerNodeIds: manualTriggers.map((n) => n.id),\n          },\n        },\n      );\n    }\n  }\n\n  // ─── Result builder ─────────────────────────────────────────────────────────\n\n  private static buildResult(context: ValidationContext): FlowValidationResult {\n    const warnings = context.issues.filter(\n      (i) => i.severity === 'warning',\n    ) as FlowValidationWarning[];\n\n    if (context.hasErrors()) {\n      return {\n        isValid: false,\n        errors: context.issues.filter((i) => i.severity === 'error') as FlowValidationError[],\n        warnings,\n      };\n    }\n\n    return {\n      isValid: true,\n      warnings: warnings.length > 0 ? warnings : undefined,\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/services/flow-versions/flow-versions.model.cjs

@@ -0,0 +1,231 @@
+const require_errors_types = require("../../types/common/errors.types.cjs");
+//#region src/services/flow-versions/flow-versions.model.ts
+const TABLE = "flow_versions";
+/**
+* Flow Versions CRUD operations class — uses InvectAdapter.
+*/
+var FlowVersionsModel = class {
+	constructor(adapter, logger) {
+		this.adapter = adapter;
+		this.logger = logger;
+	}
+	/**
+	* Create a new flow version
+	*/
+	async create(flowId, input) {
+		try {
+			const nextVersionNumber = await this.getNextVersionNumber(flowId);
+			const result = await this.adapter.create({
+				model: TABLE,
+				data: {
+					flow_id: flowId,
+					version: nextVersionNumber,
+					invect_definition: input.invectDefinition,
+					created_at: /* @__PURE__ */ new Date()
+				}
+			});
+			return this.normalize(result);
+		} catch (error) {
+			this.logger.error("Failed to create flow version", {
+				flowId,
+				error
+			});
+			throw new require_errors_types.DatabaseError("Failed to create flow version", { error });
+		}
+	}
+	/**
+	* Create a new flow version and optionally set it as live
+	*/
+	async createAndSetLive(flowId, input, setAsLive = false) {
+		const newVersion = await this.create(flowId, input);
+		if (setAsLive) {
+			const { FlowsModel } = await Promise.resolve().then(() => require("../flows/flows.model.cjs"));
+			await new FlowsModel(this.adapter, this.logger).setLiveVersion(flowId, newVersion.version);
+		}
+		return newVersion;
+	}
+	/**
+	* Get all versions for a flow with optional filtering
+	*/
+	async listByFlowId(flowId, options) {
+		const pagination = options?.pagination || {
+			limit: 100,
+			page: 1
+		};
+		const sort = options?.sort;
+		const offset = (pagination.page - 1) * pagination.limit;
+		const where = [{
+			field: "flow_id",
+			value: flowId
+		}];
+		try {
+			const [data, totalCount] = await Promise.all([this.adapter.findMany({
+				model: TABLE,
+				where,
+				limit: pagination.limit,
+				offset,
+				sortBy: sort ? {
+					field: this.mapSortField(sort.sortBy),
+					direction: sort.sortOrder
+				} : {
+					field: "version",
+					direction: "desc"
+				}
+			}), this.adapter.count({
+				model: TABLE,
+				where
+			})]);
+			return this.processPaginatedResults(data, totalCount, pagination);
+		} catch (error) {
+			this.logger.error("Failed to retrieve flow versions", {
+				flowId,
+				options,
+				error
+			});
+			throw new require_errors_types.DatabaseError("Failed to retrieve flow versions", { error });
+		}
+	}
+	/**
+	* Get specific flow version by composite key
+	*/
+	async findByKey(flowId, version) {
+		try {
+			if (version === "latest") {
+				const versions = await this.listByFlowId(flowId);
+				return versions.data.length > 0 ? versions.data[0] : null;
+			}
+			const result = await this.adapter.findOne({
+				model: TABLE,
+				where: [{
+					field: "flow_id",
+					value: flowId
+				}, {
+					field: "version",
+					value: version
+				}]
+			});
+			return result ? this.normalize(result) : null;
+		} catch (error) {
+			this.logger.error("Failed to get flow version", {
+				flowId,
+				version,
+				error
+			});
+			throw new require_errors_types.DatabaseError("Failed to get flow version", { error });
+		}
+	}
+	/**
+	* Update flow version
+	*/
+	async update(flowId, version, input) {
+		try {
+			const updateData = {};
+			if (input.invectDefinition !== void 0) updateData.invect_definition = input.invectDefinition;
+			const result = await this.adapter.update({
+				model: TABLE,
+				where: [{
+					field: "flow_id",
+					value: flowId
+				}, {
+					field: "version",
+					value: version
+				}],
+				update: updateData
+			});
+			if (!result) throw new require_errors_types.DatabaseError("Flow version not found");
+			return this.normalize(result);
+		} catch (error) {
+			this.logger.error("Failed to update flow version", {
+				flowId,
+				version,
+				error
+			});
+			throw new require_errors_types.DatabaseError("Failed to update flow version", { error });
+		}
+	}
+	/**
+	* Delete flow version
+	*/
+	async delete(flowId, version) {
+		try {
+			await this.adapter.delete({
+				model: TABLE,
+				where: [{
+					field: "flow_id",
+					value: flowId
+				}, {
+					field: "version",
+					value: version
+				}]
+			});
+		} catch (error) {
+			this.logger.error("Failed to delete flow version", {
+				flowId,
+				version,
+				error
+			});
+			throw new require_errors_types.DatabaseError("Failed to delete flow version", { error });
+		}
+	}
+	/**
+	* Get next version number for a flow
+	*/
+	async getNextVersionNumber(flowId) {
+		try {
+			const results = await this.adapter.findMany({
+				model: TABLE,
+				where: [{
+					field: "flow_id",
+					value: flowId
+				}],
+				sortBy: {
+					field: "version",
+					direction: "desc"
+				},
+				limit: 1,
+				select: ["version"]
+			});
+			return (results.length > 0 ? Number(results[0].version) : 0) + 1;
+		} catch (error) {
+			this.logger.error("Failed to get next version number", {
+				flowId,
+				error
+			});
+			return 1;
+		}
+	}
+	calculatePaginationMetadata(totalCount, pagination) {
+		const totalPages = Math.ceil(totalCount / pagination.limit);
+		return {
+			page: pagination.page,
+			limit: pagination.limit,
+			totalPages
+		};
+	}
+	processPaginatedResults(result, totalCount, pagination) {
+		return {
+			data: result.map((v) => this.normalize(v)),
+			pagination: this.calculatePaginationMetadata(totalCount, pagination)
+		};
+	}
+	normalize(raw) {
+		return {
+			version: Number(raw.version),
+			flowId: String(raw.flow_id ?? raw.flowId),
+			invectDefinition: raw.invect_definition ?? raw.invectDefinition,
+			createdAt: new Date(String(raw.created_at ?? raw.createdAt)).toISOString(),
+			createdBy: raw.created_by ? String(raw.created_by) : null
+		};
+	}
+	mapSortField(field) {
+		return {
+			version: "version",
+			createdAt: "created_at",
+			flowId: "flow_id"
+		}[field] ?? field;
+	}
+};
+//#endregion
+exports.FlowVersionsModel = FlowVersionsModel;
+
+//# sourceMappingURL=flow-versions.model.cjs.map

package/dist/services/flow-versions/flow-versions.model.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-versions.model.cjs","names":["DatabaseError"],"sources":["../../../src/services/flow-versions/flow-versions.model.ts"],"sourcesContent":["// Flow Versions Model for Invect core — adapter-based implementation\nimport type { InvectAdapter, WhereClause } from '../../database/adapter';\nimport { DatabaseError } from 'src/types/common/errors.types';\nimport { Logger, PaginatedResponse, QueryOptions } from 'src/types/schemas';\nimport { CreateFlowVersionRequest, InvectDefinitionRuntime } from './schemas-fresh';\nimport { FlowVersion } from '../../database';\n\n/**\n * Input for updating a flow version (limited fields)\n */\nexport interface UpdateFlowVersionInput {\n  invectDefinition?: InvectDefinitionRuntime;\n}\n\n/**\n * Flow version with optional composite key for database operations\n */\nexport interface FlowVersionKey {\n  version: number;\n  flowId: string;\n}\n\n/**\n * Flow version query parameters\n */\nexport interface FlowVersionQuery {\n  flowId: string;\n  version?: number | 'latest';\n  limit?: number;\n  offset?: number;\n}\n\nconst TABLE = 'flow_versions';\n\n/**\n * Flow Versions CRUD operations class — uses InvectAdapter.\n */\nexport class FlowVersionsModel {\n  constructor(\n    private readonly adapter: InvectAdapter,\n    private readonly logger: Logger,\n  ) {}\n\n  /**\n   * Create a new flow version\n   */\n  async create(flowId: string, input: CreateFlowVersionRequest): Promise<FlowVersion> {\n    try {\n      const nextVersionNumber = await this.getNextVersionNumber(flowId);\n\n      const result = await this.adapter.create({\n        model: TABLE,\n        data: {\n          flow_id: flowId,\n          version: nextVersionNumber,\n          invect_definition: input.invectDefinition,\n          created_at: new Date(),\n        },\n      });\n      return this.normalize(result);\n    } catch (error) {\n      this.logger.error('Failed to create flow version', { flowId, error });\n      throw new DatabaseError('Failed to create flow version', { error });\n    }\n  }\n\n  /**\n   * Create a new flow version and optionally set it as live\n   */\n  async createAndSetLive(\n    flowId: string,\n    input: CreateFlowVersionRequest,\n    setAsLive: boolean = false,\n  ): Promise<FlowVersion> {\n    const newVersion = await this.create(flowId, input);\n\n    if (setAsLive) {\n      const { FlowsModel } = await import('../flows/flows.model');\n      const flowsModel = new FlowsModel(this.adapter, this.logger);\n      await flowsModel.setLiveVersion(flowId, newVersion.version);\n    }\n\n    return newVersion;\n  }\n\n  /**\n   * Get all versions for a flow with optional filtering\n   */\n  async listByFlowId(\n    flowId: string,\n    options?: QueryOptions<FlowVersion>,\n  ): Promise<PaginatedResponse<FlowVersion>> {\n    const pagination = options?.pagination || { limit: 100, page: 1 };\n    const sort = options?.sort;\n    const offset = (pagination.page - 1) * pagination.limit;\n\n    const where: WhereClause[] = [{ field: 'flow_id', value: flowId }];\n\n    try {\n      const [data, totalCount] = await Promise.all([\n        this.adapter.findMany<Record<string, unknown>>({\n          model: TABLE,\n          where,\n          limit: pagination.limit,\n          offset,\n          sortBy: sort\n            ? { field: this.mapSortField(sort.sortBy as string), direction: sort.sortOrder }\n            : { field: 'version', direction: 'desc' },\n        }),\n        this.adapter.count({ model: TABLE, where }),\n      ]);\n\n      return this.processPaginatedResults(data, totalCount, pagination);\n    } catch (error) {\n      this.logger.error('Failed to retrieve flow versions', { flowId, options, error });\n      throw new DatabaseError('Failed to retrieve flow versions', { error });\n    }\n  }\n\n  /**\n   * Get specific flow version by composite key\n   */\n  async findByKey(flowId: string, version: number | 'latest'): Promise<FlowVersion | null> {\n    try {\n      if (version === 'latest') {\n        const versions = await this.listByFlowId(flowId);\n        return versions.data.length > 0 ? versions.data[0] : null;\n      }\n\n      const result = await this.adapter.findOne<Record<string, unknown>>({\n        model: TABLE,\n        where: [\n          { field: 'flow_id', value: flowId },\n          { field: 'version', value: version },\n        ],\n      });\n      return result ? this.normalize(result) : null;\n    } catch (error) {\n      this.logger.error('Failed to get flow version', { flowId, version, error });\n      throw new DatabaseError('Failed to get flow version', { error });\n    }\n  }\n\n  /**\n   * Update flow version\n   */\n  async update(\n    flowId: string,\n    version: number,\n    input: UpdateFlowVersionInput,\n  ): Promise<FlowVersion> {\n    try {\n      const updateData: Record<string, unknown> = {};\n      if (input.invectDefinition !== undefined) {\n        updateData.invect_definition = input.invectDefinition;\n      }\n\n      const result = await this.adapter.update<Record<string, unknown>>({\n        model: TABLE,\n        where: [\n          { field: 'flow_id', value: flowId },\n          { field: 'version', value: version },\n        ],\n        update: updateData,\n      });\n\n      if (!result) {\n        throw new DatabaseError('Flow version not found');\n      }\n      return this.normalize(result);\n    } catch (error) {\n      this.logger.error('Failed to update flow version', { flowId, version, error });\n      throw new DatabaseError('Failed to update flow version', { error });\n    }\n  }\n\n  /**\n   * Delete flow version\n   */\n  async delete(flowId: string, version: number): Promise<void> {\n    try {\n      await this.adapter.delete({\n        model: TABLE,\n        where: [\n          { field: 'flow_id', value: flowId },\n          { field: 'version', value: version },\n        ],\n      });\n    } catch (error) {\n      this.logger.error('Failed to delete flow version', { flowId, version, error });\n      throw new DatabaseError('Failed to delete flow version', { error });\n    }\n  }\n\n  /**\n   * Get next version number for a flow\n   */\n  private async getNextVersionNumber(flowId: string): Promise<number> {\n    try {\n      // Get current max version by fetching the first record sorted by version desc\n      const results = await this.adapter.findMany<Record<string, unknown>>({\n        model: TABLE,\n        where: [{ field: 'flow_id', value: flowId }],\n        sortBy: { field: 'version', direction: 'desc' },\n        limit: 1,\n        select: ['version'],\n      });\n\n      const maxVersion = results.length > 0 ? Number(results[0].version) : 0;\n      return maxVersion + 1;\n    } catch (error) {\n      this.logger.error('Failed to get next version number', { flowId, error });\n      return 1;\n    }\n  }\n\n  private calculatePaginationMetadata(\n    totalCount: number,\n    pagination: { page: number; limit: number },\n  ) {\n    const totalPages = Math.ceil(totalCount / pagination.limit);\n    return { page: pagination.page, limit: pagination.limit, totalPages };\n  }\n\n  private processPaginatedResults(\n    result: Record<string, unknown>[],\n    totalCount: number,\n    pagination: { page: number; limit: number },\n  ): PaginatedResponse<FlowVersion> {\n    const data = result.map((v) => this.normalize(v));\n    return { data, pagination: this.calculatePaginationMetadata(totalCount, pagination) };\n  }\n\n  private normalize(raw: Record<string, unknown>): FlowVersion {\n    return {\n      version: Number(raw.version),\n      flowId: String(raw.flow_id ?? raw.flowId),\n      invectDefinition: (raw.invect_definition ?? raw.invectDefinition) as InvectDefinitionRuntime,\n      createdAt: new Date(String(raw.created_at ?? raw.createdAt)).toISOString(),\n      createdBy: raw.created_by ? String(raw.created_by) : null,\n    };\n  }\n\n  private mapSortField(field: string): string {\n    const map: Record<string, string> = {\n      version: 'version',\n      createdAt: 'created_at',\n      flowId: 'flow_id',\n    };\n    return map[field] ?? field;\n  }\n}\n"],"mappings":"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"}

package/dist/services/flow-versions/flow-versions.model.d.cts

@@ -0,0 +1,55 @@
+import { PaginatedResponse, QueryOptions } from "../../types/schemas/pagination-sort-filter.cjs";
+import { Logger } from "../../types/schemas-fresh/invect-config.cjs";
+import { CreateFlowVersionRequest, InvectDefinitionRuntime } from "./schemas-fresh.cjs";
+import { InvectAdapter } from "../../database/adapter.cjs";
+import { FlowVersion } from "../../database/schema-sqlite.cjs";
+//#region src/services/flow-versions/flow-versions.model.d.ts
+/**
+ * Input for updating a flow version (limited fields)
+ */
+interface UpdateFlowVersionInput {
+  invectDefinition?: InvectDefinitionRuntime;
+}
+/**
+ * Flow Versions CRUD operations class — uses InvectAdapter.
+ */
+declare class FlowVersionsModel {
+  private readonly adapter;
+  private readonly logger;
+  constructor(adapter: InvectAdapter, logger: Logger);
+  /**
+   * Create a new flow version
+   */
+  create(flowId: string, input: CreateFlowVersionRequest): Promise<FlowVersion>;
+  /**
+   * Create a new flow version and optionally set it as live
+   */
+  createAndSetLive(flowId: string, input: CreateFlowVersionRequest, setAsLive?: boolean): Promise<FlowVersion>;
+  /**
+   * Get all versions for a flow with optional filtering
+   */
+  listByFlowId(flowId: string, options?: QueryOptions<FlowVersion>): Promise<PaginatedResponse<FlowVersion>>;
+  /**
+   * Get specific flow version by composite key
+   */
+  findByKey(flowId: string, version: number | 'latest'): Promise<FlowVersion | null>;
+  /**
+   * Update flow version
+   */
+  update(flowId: string, version: number, input: UpdateFlowVersionInput): Promise<FlowVersion>;
+  /**
+   * Delete flow version
+   */
+  delete(flowId: string, version: number): Promise<void>;
+  /**
+   * Get next version number for a flow
+   */
+  private getNextVersionNumber;
+  private calculatePaginationMetadata;
+  private processPaginatedResults;
+  private normalize;
+  private mapSortField;
+}
+//#endregion
+export { FlowVersionsModel };
+//# sourceMappingURL=flow-versions.model.d.cts.map

package/dist/services/flow-versions/flow-versions.model.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-versions.model.d.cts","names":[],"sources":["../../../src/services/flow-versions/flow-versions.model.ts"],"mappings":";;;;;;;;;UAUiB,sBAAA;EACf,gBAAA,GAAmB,uBAAA;AAAA;;;;cA0BR,iBAAA;EAAA,iBAEQ,OAAA;EAAA,iBACA,MAAA;cADA,OAAA,EAAS,aAAA,EACT,MAAA,EAAQ,MAAA;EA8GxB;;;EAxGG,MAAA,CAAO,MAAA,UAAgB,KAAA,EAAO,wBAAA,GAA2B,OAAA,CAAQ,WAAA;EAPpD;;;EA8Bb,gBAAA,CACJ,MAAA,UACA,KAAA,EAAO,wBAAA,EACP,SAAA,aACC,OAAA,CAAQ,WAAA;EAlCQ;;;EAiDb,YAAA,CACJ,MAAA,UACA,OAAA,GAAU,YAAA,CAAa,WAAA,IACtB,OAAA,CAAQ,iBAAA,CAAkB,WAAA;EA7ChB;;;EA4EP,SAAA,CAAU,MAAA,UAAgB,OAAA,sBAA6B,OAAA,CAAQ,WAAA;EA5EE;;;EAoGjE,MAAA,CACJ,MAAA,UACA,OAAA,UACA,KAAA,EAAO,sBAAA,GACN,OAAA,CAAQ,WAAA;EA/ET;;;EA4GI,MAAA,CAAO,MAAA,UAAgB,OAAA,WAAkB,OAAA;EA3FzC;;;EAAA,QA6GQ,oBAAA;EAAA,QAmBN,2BAAA;EAAA,QAQA,uBAAA;EAAA,QASA,SAAA;EAAA,QAUA,YAAA;AAAA"}

package/dist/services/flow-versions/flow-versions.model.d.ts

@@ -0,0 +1,55 @@
+import { PaginatedResponse, QueryOptions } from "../../types/schemas/pagination-sort-filter.js";
+import { Logger } from "../../types/schemas-fresh/invect-config.js";
+import { CreateFlowVersionRequest, InvectDefinitionRuntime } from "./schemas-fresh.js";
+import { InvectAdapter } from "../../database/adapter.js";
+import { FlowVersion } from "../../database/schema-sqlite.js";
+//#region src/services/flow-versions/flow-versions.model.d.ts
+/**
+ * Input for updating a flow version (limited fields)
+ */
+interface UpdateFlowVersionInput {
+  invectDefinition?: InvectDefinitionRuntime;
+}
+/**
+ * Flow Versions CRUD operations class — uses InvectAdapter.
+ */
+declare class FlowVersionsModel {
+  private readonly adapter;
+  private readonly logger;
+  constructor(adapter: InvectAdapter, logger: Logger);
+  /**
+   * Create a new flow version
+   */
+  create(flowId: string, input: CreateFlowVersionRequest): Promise<FlowVersion>;
+  /**
+   * Create a new flow version and optionally set it as live
+   */
+  createAndSetLive(flowId: string, input: CreateFlowVersionRequest, setAsLive?: boolean): Promise<FlowVersion>;
+  /**
+   * Get all versions for a flow with optional filtering
+   */
+  listByFlowId(flowId: string, options?: QueryOptions<FlowVersion>): Promise<PaginatedResponse<FlowVersion>>;
+  /**
+   * Get specific flow version by composite key
+   */
+  findByKey(flowId: string, version: number | 'latest'): Promise<FlowVersion | null>;
+  /**
+   * Update flow version
+   */
+  update(flowId: string, version: number, input: UpdateFlowVersionInput): Promise<FlowVersion>;
+  /**
+   * Delete flow version
+   */
+  delete(flowId: string, version: number): Promise<void>;
+  /**
+   * Get next version number for a flow
+   */
+  private getNextVersionNumber;
+  private calculatePaginationMetadata;
+  private processPaginatedResults;
+  private normalize;
+  private mapSortField;
+}
+//#endregion
+export { FlowVersionsModel };
+//# sourceMappingURL=flow-versions.model.d.ts.map

package/dist/services/flow-versions/flow-versions.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-versions.model.d.ts","names":[],"sources":["../../../src/services/flow-versions/flow-versions.model.ts"],"mappings":";;;;;;;;;UAUiB,sBAAA;EACf,gBAAA,GAAmB,uBAAA;AAAA;;;;cA0BR,iBAAA;EAAA,iBAEQ,OAAA;EAAA,iBACA,MAAA;cADA,OAAA,EAAS,aAAA,EACT,MAAA,EAAQ,MAAA;EA8GhB;;;EAxGL,MAAA,CAAO,MAAA,UAAgB,KAAA,EAAO,wBAAA,GAA2B,OAAA,CAAQ,WAAA;EAqIjB;;;EA9GhD,gBAAA,CACJ,MAAA,UACA,KAAA,EAAO,wBAAA,EACP,SAAA,aACC,OAAA,CAAQ,WAAA;EAlCiB;;;EAiDtB,YAAA,CACJ,MAAA,UACA,OAAA,GAAU,YAAA,CAAa,WAAA,IACtB,OAAA,CAAQ,iBAAA,CAAkB,WAAA;EA7CvB;;;EA4EA,SAAA,CAAU,MAAA,UAAgB,OAAA,sBAA6B,OAAA,CAAQ,WAAA;EA5EN;;;EAoGzD,MAAA,CACJ,MAAA,UACA,OAAA,UACA,KAAA,EAAO,sBAAA,GACN,OAAA,CAAQ,WAAA;EA/EF;;;EA4GH,MAAA,CAAO,MAAA,UAAgB,OAAA,WAAkB,OAAA;EA1GpC;;;EAAA,QA4HG,oBAAA;EAAA,QAmBN,2BAAA;EAAA,QAQA,uBAAA;EAAA,QASA,SAAA;EAAA,QAUA,YAAA;AAAA"}

package/dist/services/flow-versions/flow-versions.model.js

@@ -0,0 +1,231 @@
+import { DatabaseError } from "../../types/common/errors.types.js";
+//#region src/services/flow-versions/flow-versions.model.ts
+const TABLE = "flow_versions";
+/**
+* Flow Versions CRUD operations class — uses InvectAdapter.
+*/
+var FlowVersionsModel = class {
+	constructor(adapter, logger) {
+		this.adapter = adapter;
+		this.logger = logger;
+	}
+	/**
+	* Create a new flow version
+	*/
+	async create(flowId, input) {
+		try {
+			const nextVersionNumber = await this.getNextVersionNumber(flowId);
+			const result = await this.adapter.create({
+				model: TABLE,
+				data: {
+					flow_id: flowId,
+					version: nextVersionNumber,
+					invect_definition: input.invectDefinition,
+					created_at: /* @__PURE__ */ new Date()
+				}
+			});
+			return this.normalize(result);
+		} catch (error) {
+			this.logger.error("Failed to create flow version", {
+				flowId,
+				error
+			});
+			throw new DatabaseError("Failed to create flow version", { error });
+		}
+	}
+	/**
+	* Create a new flow version and optionally set it as live
+	*/
+	async createAndSetLive(flowId, input, setAsLive = false) {
+		const newVersion = await this.create(flowId, input);
+		if (setAsLive) {
+			const { FlowsModel } = await import("../flows/flows.model.js");
+			await new FlowsModel(this.adapter, this.logger).setLiveVersion(flowId, newVersion.version);
+		}
+		return newVersion;
+	}
+	/**
+	* Get all versions for a flow with optional filtering
+	*/
+	async listByFlowId(flowId, options) {
+		const pagination = options?.pagination || {
+			limit: 100,
+			page: 1
+		};
+		const sort = options?.sort;
+		const offset = (pagination.page - 1) * pagination.limit;
+		const where = [{
+			field: "flow_id",
+			value: flowId
+		}];
+		try {
+			const [data, totalCount] = await Promise.all([this.adapter.findMany({
+				model: TABLE,
+				where,
+				limit: pagination.limit,
+				offset,
+				sortBy: sort ? {
+					field: this.mapSortField(sort.sortBy),
+					direction: sort.sortOrder
+				} : {
+					field: "version",
+					direction: "desc"
+				}
+			}), this.adapter.count({
+				model: TABLE,
+				where
+			})]);
+			return this.processPaginatedResults(data, totalCount, pagination);
+		} catch (error) {
+			this.logger.error("Failed to retrieve flow versions", {
+				flowId,
+				options,
+				error
+			});
+			throw new DatabaseError("Failed to retrieve flow versions", { error });
+		}
+	}
+	/**
+	* Get specific flow version by composite key
+	*/
+	async findByKey(flowId, version) {
+		try {
+			if (version === "latest") {
+				const versions = await this.listByFlowId(flowId);
+				return versions.data.length > 0 ? versions.data[0] : null;
+			}
+			const result = await this.adapter.findOne({
+				model: TABLE,
+				where: [{
+					field: "flow_id",
+					value: flowId
+				}, {
+					field: "version",
+					value: version
+				}]
+			});
+			return result ? this.normalize(result) : null;
+		} catch (error) {
+			this.logger.error("Failed to get flow version", {
+				flowId,
+				version,
+				error
+			});
+			throw new DatabaseError("Failed to get flow version", { error });
+		}
+	}
+	/**
+	* Update flow version
+	*/
+	async update(flowId, version, input) {
+		try {
+			const updateData = {};
+			if (input.invectDefinition !== void 0) updateData.invect_definition = input.invectDefinition;
+			const result = await this.adapter.update({
+				model: TABLE,
+				where: [{
+					field: "flow_id",
+					value: flowId
+				}, {
+					field: "version",
+					value: version
+				}],
+				update: updateData
+			});
+			if (!result) throw new DatabaseError("Flow version not found");
+			return this.normalize(result);
+		} catch (error) {
+			this.logger.error("Failed to update flow version", {
+				flowId,
+				version,
+				error
+			});
+			throw new DatabaseError("Failed to update flow version", { error });
+		}
+	}
+	/**
+	* Delete flow version
+	*/
+	async delete(flowId, version) {
+		try {
+			await this.adapter.delete({
+				model: TABLE,
+				where: [{
+					field: "flow_id",
+					value: flowId
+				}, {
+					field: "version",
+					value: version
+				}]
+			});
+		} catch (error) {
+			this.logger.error("Failed to delete flow version", {
+				flowId,
+				version,
+				error
+			});
+			throw new DatabaseError("Failed to delete flow version", { error });
+		}
+	}
+	/**
+	* Get next version number for a flow
+	*/
+	async getNextVersionNumber(flowId) {
+		try {
+			const results = await this.adapter.findMany({
+				model: TABLE,
+				where: [{
+					field: "flow_id",
+					value: flowId
+				}],
+				sortBy: {
+					field: "version",
+					direction: "desc"
+				},
+				limit: 1,
+				select: ["version"]
+			});
+			return (results.length > 0 ? Number(results[0].version) : 0) + 1;
+		} catch (error) {
+			this.logger.error("Failed to get next version number", {
+				flowId,
+				error
+			});
+			return 1;
+		}
+	}
+	calculatePaginationMetadata(totalCount, pagination) {
+		const totalPages = Math.ceil(totalCount / pagination.limit);
+		return {
+			page: pagination.page,
+			limit: pagination.limit,
+			totalPages
+		};
+	}
+	processPaginatedResults(result, totalCount, pagination) {
+		return {
+			data: result.map((v) => this.normalize(v)),
+			pagination: this.calculatePaginationMetadata(totalCount, pagination)
+		};
+	}
+	normalize(raw) {
+		return {
+			version: Number(raw.version),
+			flowId: String(raw.flow_id ?? raw.flowId),
+			invectDefinition: raw.invect_definition ?? raw.invectDefinition,
+			createdAt: new Date(String(raw.created_at ?? raw.createdAt)).toISOString(),
+			createdBy: raw.created_by ? String(raw.created_by) : null
+		};
+	}
+	mapSortField(field) {
+		return {
+			version: "version",
+			createdAt: "created_at",
+			flowId: "flow_id"
+		}[field] ?? field;
+	}
+};
+//#endregion
+export { FlowVersionsModel };
+
+//# sourceMappingURL=flow-versions.model.js.map

package/dist/services/flow-versions/flow-versions.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-versions.model.js","names":[],"sources":["../../../src/services/flow-versions/flow-versions.model.ts"],"sourcesContent":["// Flow Versions Model for Invect core — adapter-based implementation\nimport type { InvectAdapter, WhereClause } from '../../database/adapter';\nimport { DatabaseError } from 'src/types/common/errors.types';\nimport { Logger, PaginatedResponse, QueryOptions } from 'src/types/schemas';\nimport { CreateFlowVersionRequest, InvectDefinitionRuntime } from './schemas-fresh';\nimport { FlowVersion } from '../../database';\n\n/**\n * Input for updating a flow version (limited fields)\n */\nexport interface UpdateFlowVersionInput {\n  invectDefinition?: InvectDefinitionRuntime;\n}\n\n/**\n * Flow version with optional composite key for database operations\n */\nexport interface FlowVersionKey {\n  version: number;\n  flowId: string;\n}\n\n/**\n * Flow version query parameters\n */\nexport interface FlowVersionQuery {\n  flowId: string;\n  version?: number | 'latest';\n  limit?: number;\n  offset?: number;\n}\n\nconst TABLE = 'flow_versions';\n\n/**\n * Flow Versions CRUD operations class — uses InvectAdapter.\n */\nexport class FlowVersionsModel {\n  constructor(\n    private readonly adapter: InvectAdapter,\n    private readonly logger: Logger,\n  ) {}\n\n  /**\n   * Create a new flow version\n   */\n  async create(flowId: string, input: CreateFlowVersionRequest): Promise<FlowVersion> {\n    try {\n      const nextVersionNumber = await this.getNextVersionNumber(flowId);\n\n      const result = await this.adapter.create({\n        model: TABLE,\n        data: {\n          flow_id: flowId,\n          version: nextVersionNumber,\n          invect_definition: input.invectDefinition,\n          created_at: new Date(),\n        },\n      });\n      return this.normalize(result);\n    } catch (error) {\n      this.logger.error('Failed to create flow version', { flowId, error });\n      throw new DatabaseError('Failed to create flow version', { error });\n    }\n  }\n\n  /**\n   * Create a new flow version and optionally set it as live\n   */\n  async createAndSetLive(\n    flowId: string,\n    input: CreateFlowVersionRequest,\n    setAsLive: boolean = false,\n  ): Promise<FlowVersion> {\n    const newVersion = await this.create(flowId, input);\n\n    if (setAsLive) {\n      const { FlowsModel } = await import('../flows/flows.model');\n      const flowsModel = new FlowsModel(this.adapter, this.logger);\n      await flowsModel.setLiveVersion(flowId, newVersion.version);\n    }\n\n    return newVersion;\n  }\n\n  /**\n   * Get all versions for a flow with optional filtering\n   */\n  async listByFlowId(\n    flowId: string,\n    options?: QueryOptions<FlowVersion>,\n  ): Promise<PaginatedResponse<FlowVersion>> {\n    const pagination = options?.pagination || { limit: 100, page: 1 };\n    const sort = options?.sort;\n    const offset = (pagination.page - 1) * pagination.limit;\n\n    const where: WhereClause[] = [{ field: 'flow_id', value: flowId }];\n\n    try {\n      const [data, totalCount] = await Promise.all([\n        this.adapter.findMany<Record<string, unknown>>({\n          model: TABLE,\n          where,\n          limit: pagination.limit,\n          offset,\n          sortBy: sort\n            ? { field: this.mapSortField(sort.sortBy as string), direction: sort.sortOrder }\n            : { field: 'version', direction: 'desc' },\n        }),\n        this.adapter.count({ model: TABLE, where }),\n      ]);\n\n      return this.processPaginatedResults(data, totalCount, pagination);\n    } catch (error) {\n      this.logger.error('Failed to retrieve flow versions', { flowId, options, error });\n      throw new DatabaseError('Failed to retrieve flow versions', { error });\n    }\n  }\n\n  /**\n   * Get specific flow version by composite key\n   */\n  async findByKey(flowId: string, version: number | 'latest'): Promise<FlowVersion | null> {\n    try {\n      if (version === 'latest') {\n        const versions = await this.listByFlowId(flowId);\n        return versions.data.length > 0 ? versions.data[0] : null;\n      }\n\n      const result = await this.adapter.findOne<Record<string, unknown>>({\n        model: TABLE,\n        where: [\n          { field: 'flow_id', value: flowId },\n          { field: 'version', value: version },\n        ],\n      });\n      return result ? this.normalize(result) : null;\n    } catch (error) {\n      this.logger.error('Failed to get flow version', { flowId, version, error });\n      throw new DatabaseError('Failed to get flow version', { error });\n    }\n  }\n\n  /**\n   * Update flow version\n   */\n  async update(\n    flowId: string,\n    version: number,\n    input: UpdateFlowVersionInput,\n  ): Promise<FlowVersion> {\n    try {\n      const updateData: Record<string, unknown> = {};\n      if (input.invectDefinition !== undefined) {\n        updateData.invect_definition = input.invectDefinition;\n      }\n\n      const result = await this.adapter.update<Record<string, unknown>>({\n        model: TABLE,\n        where: [\n          { field: 'flow_id', value: flowId },\n          { field: 'version', value: version },\n        ],\n        update: updateData,\n      });\n\n      if (!result) {\n        throw new DatabaseError('Flow version not found');\n      }\n      return this.normalize(result);\n    } catch (error) {\n      this.logger.error('Failed to update flow version', { flowId, version, error });\n      throw new DatabaseError('Failed to update flow version', { error });\n    }\n  }\n\n  /**\n   * Delete flow version\n   */\n  async delete(flowId: string, version: number): Promise<void> {\n    try {\n      await this.adapter.delete({\n        model: TABLE,\n        where: [\n          { field: 'flow_id', value: flowId },\n          { field: 'version', value: version },\n        ],\n      });\n    } catch (error) {\n      this.logger.error('Failed to delete flow version', { flowId, version, error });\n      throw new DatabaseError('Failed to delete flow version', { error });\n    }\n  }\n\n  /**\n   * Get next version number for a flow\n   */\n  private async getNextVersionNumber(flowId: string): Promise<number> {\n    try {\n      // Get current max version by fetching the first record sorted by version desc\n      const results = await this.adapter.findMany<Record<string, unknown>>({\n        model: TABLE,\n        where: [{ field: 'flow_id', value: flowId }],\n        sortBy: { field: 'version', direction: 'desc' },\n        limit: 1,\n        select: ['version'],\n      });\n\n      const maxVersion = results.length > 0 ? Number(results[0].version) : 0;\n      return maxVersion + 1;\n    } catch (error) {\n      this.logger.error('Failed to get next version number', { flowId, error });\n      return 1;\n    }\n  }\n\n  private calculatePaginationMetadata(\n    totalCount: number,\n    pagination: { page: number; limit: number },\n  ) {\n    const totalPages = Math.ceil(totalCount / pagination.limit);\n    return { page: pagination.page, limit: pagination.limit, totalPages };\n  }\n\n  private processPaginatedResults(\n    result: Record<string, unknown>[],\n    totalCount: number,\n    pagination: { page: number; limit: number },\n  ): PaginatedResponse<FlowVersion> {\n    const data = result.map((v) => this.normalize(v));\n    return { data, pagination: this.calculatePaginationMetadata(totalCount, pagination) };\n  }\n\n  private normalize(raw: Record<string, unknown>): FlowVersion {\n    return {\n      version: Number(raw.version),\n      flowId: String(raw.flow_id ?? raw.flowId),\n      invectDefinition: (raw.invect_definition ?? raw.invectDefinition) as InvectDefinitionRuntime,\n      createdAt: new Date(String(raw.created_at ?? raw.createdAt)).toISOString(),\n      createdBy: raw.created_by ? String(raw.created_by) : null,\n    };\n  }\n\n  private mapSortField(field: string): string {\n    const map: Record<string, string> = {\n      version: 'version',\n      createdAt: 'created_at',\n      flowId: 'flow_id',\n    };\n    return map[field] ?? field;\n  }\n}\n"],"mappings":"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"}