@invect/core 0.0.1

package/dist/actions/types.d.ts

@@ -0,0 +1,373 @@
+import { Logger } from "../types/schemas-fresh/invect-config.js";
+import { FlowEdge, FlowNodeDefinitions } from "../services/flow-versions/schemas-fresh.js";
+import { AgentPromptResult } from "../types/agent-tool.types.js";
+import { SubmitPromptRequest } from "../services/node-data.service.js";
+import { RecordToolExecutionInput, SubmitAgentPromptRequest, SubmitPromptResult } from "../types-fresh.js";
+import { NodeDefinition } from "../types/node-definition.types.js";
+import { CredentialsService } from "../services/credentials/credentials.service.js";
+import { BaseAIClient } from "../services/ai/base-client.js";
+import { z } from "zod/v4";
+
+//#region src/actions/types.d.ts
+/**
+ * Provider category for UI organisation and palette grouping.
+ */
+type ProviderCategory = 'email' | 'messaging' | 'storage' | 'database' | 'development' | 'ai' | 'http' | 'utility' | 'core' | 'custom';
+/**
+ * A provider groups related actions under a service / brand.
+ * Examples: "gmail", "slack", "http", "core".
+ *
+ * Multiple action files can reference the same ProviderDef – the registry
+ * de-duplicates by `id`.
+ */
+interface ProviderDef {
+  /** Unique slug, e.g. "gmail", "slack", "core" */
+  id: string;
+  /** Human-readable name */
+  name: string;
+  /** Lucide icon name for UI (fallback when no static SVG file exists for the provider id) */
+  icon: string;
+  /**
+   * Raw SVG markup for custom provider branding (legacy).
+   *
+   * Prefer adding a static SVG file to `pkg/frontend/src/assets/provider-icons/{id}.svg`
+   * instead. The frontend resolves icons by provider `id` first, then falls back
+   * to `svgIcon`, then to the Lucide `icon` name.
+   */
+  svgIcon?: string;
+  /** Category for palette grouping */
+  category: ProviderCategory;
+  /**
+   * Which section this provider's actions appear in within the node palette.
+   * Maps directly to the frontend sidebar categories.
+   */
+  nodeCategory: 'Common' | 'AI' | 'Data' | 'Logic' | 'IO' | 'Integrations' | 'Custom' | 'Triggers';
+  /** Optional longer description */
+  description?: string;
+  /** Link to provider API docs */
+  docsUrl?: string;
+}
+/**
+ * Declares what kind of credential an action needs (if any).
+ */
+interface CredentialRequirement {
+  required: boolean;
+  type?: 'oauth2' | 'api_key' | 'basic_auth' | 'database' | 'llm';
+  /** OAuth2 provider id from the OAuth2 providers registry */
+  oauth2Provider?: string;
+  /** Shown to the user explaining what the credential is for */
+  description?: string;
+}
+/**
+ * Describes a single parameter field for the config panel / tool schema.
+ */
+interface ParamField {
+  name: string;
+  label: string;
+  type: 'text' | 'textarea' | 'number' | 'boolean' | 'select' | 'json' | 'code';
+  description?: string;
+  placeholder?: string;
+  defaultValue?: unknown;
+  required?: boolean;
+  /** When true, field is hidden from the config panel */
+  hidden?: boolean;
+  options?: {
+    label: string;
+    value: string | number;
+  }[];
+  /** Show in collapsed "More Options" section */
+  extended?: boolean;
+  /**
+   * When true the AI provides this value at runtime (tool mode).
+   * When false the value is treated as a static configuration.
+   * Defaults to `true` when omitted.
+   */
+  aiProvided?: boolean;
+  /**
+   * Declare that this field's options should be loaded from the server
+   * when the values of `dependsOn` fields change.
+   *
+   * The `handler` runs server-side with access to credentials and services.
+   * The frontend only sees the serialised metadata (`dependsOn` + flag).
+   *
+   * Example — load AI models based on the selected credential:
+   * ```ts
+   * loadOptions: {
+   *   dependsOn: ['credentialId'],
+   *   handler: async (deps, ctx) => {
+   *     const cred = await ctx.services.credentials.get(deps.credentialId);
+   *     const models = await fetchModels(cred);
+   *     return { options: models.map(m => ({ label: m.name, value: m.id })) };
+   *   },
+   * }
+   * ```
+   */
+  loadOptions?: LoadOptionsConfig;
+}
+/**
+ * Server-side handler context provided to `loadOptions.handler`.
+ */
+interface LoadOptionsContext {
+  logger: Logger;
+  services: {
+    credentials: CredentialsService;
+  };
+}
+/**
+ * Configuration for dynamic option loading on a field.
+ */
+interface LoadOptionsConfig {
+  /**
+   * Which sibling param fields this depends on.
+   * When any of these change, the frontend calls the server to reload options.
+   */
+  dependsOn: string[];
+  /**
+   * Server-side handler that returns the options for this field.
+   * Receives the current values of the `dependsOn` fields plus the full context.
+   */
+  handler: (dependencyValues: Record<string, unknown>, context: LoadOptionsContext) => Promise<LoadOptionsResult>;
+}
+/**
+ * Result returned by a `loadOptions` handler.
+ */
+interface LoadOptionsResult {
+  /** The options to populate the select/combobox with. */
+  options: {
+    label: string;
+    value: string | number;
+  }[];
+  /** Optional default value to auto-select if the current value is not in the list. */
+  defaultValue?: string | number;
+  /** Optional placeholder text override. */
+  placeholder?: string;
+  /** If true, the field should be disabled (e.g. no options available). */
+  disabled?: boolean;
+}
+/**
+ * Credential shape as provided to an executing action.
+ */
+interface ActionCredential {
+  id: string;
+  name: string;
+  type: string;
+  authType: string;
+  config: Record<string, unknown>;
+}
+/**
+ * Execution context handed to every `execute()` call regardless of whether
+ * the action is running as a flow node or an AI-agent tool.
+ */
+interface ActionExecutionContext {
+  /** Scoped logger */
+  logger: Logger;
+  /** Decrypted credential (null when action doesn't require one) */
+  credential: ActionCredential | null;
+  /**
+   * Upstream node outputs keyed by reference-id.
+   * Present when running inside a flow; `undefined` when running as a standalone tool.
+   */
+  incomingData?: Record<string, unknown>;
+  /**
+   * Flow inputs (top-level inputs provided when starting the flow).
+   * Only present when the action runs as a flow node.
+   */
+  flowInputs?: Record<string, unknown>;
+  /**
+   * Flow-level identifiers. Only present when the action runs as a flow node.
+   */
+  flowContext?: {
+    flowId: string;
+    flowRunId: string;
+    nodeId: string;
+    traceId?: string;
+  };
+  /**
+   * Service functions available from the flow orchestrator.
+   * Only present when running inside a flow. Actions should
+   * gracefully degrade when these are not available (e.g. tool mode).
+   */
+  functions?: {
+    /** Render a Nunjucks template against variables */runTemplateReplacement?: (template: string, variables: Record<string, unknown>) => Promise<string>; /** Submit a prompt to an AI model (for Model node) */
+    submitPrompt?: (request: SubmitPromptRequest) => Promise<SubmitPromptResult>; /** Submit an agent prompt with tools (for Agent node) */
+    submitAgentPrompt?: (request: SubmitAgentPromptRequest) => Promise<AgentPromptResult | {
+      type: 'batch_submitted';
+      batchJobId: string;
+      nodeId: string;
+      flowRunId: string;
+    }>; /** Get a decrypted credential by id */
+    getCredential?: (credentialId: string) => Promise<ActionCredential | null>; /** Mark downstream nodes as skipped (for If-Else node) */
+    markDownstreamNodesAsSkipped?: (nodeId: string, edges: readonly FlowEdge[], skippedNodes: Set<string>, isFromIfElse?: boolean) => void; /** Record a tool execution (for Agent node) */
+    recordToolExecution?: (input: RecordToolExecutionInput) => Promise<{
+      id: string;
+    } | null>;
+  };
+  /**
+   * Additional flow-run context passed through for special nodes (If-Else, Agent).
+   * Not available in tool mode.
+   */
+  flowRunState?: {
+    edges?: readonly FlowEdge[];
+    nodes?: readonly FlowNodeDefinitions[];
+    skippedNodeIds?: Set<string>;
+    flowParams?: Record<string, unknown>;
+    globalConfig?: Record<string, unknown>;
+  };
+}
+/**
+ * Context provided to `onConfigUpdate` — gives access to services needed
+ * for dynamic configuration (e.g. fetching model lists from a provider).
+ */
+interface ActionConfigUpdateContext {
+  logger: Logger;
+  services: {
+    credentials: CredentialsService;
+    baseAIClient: BaseAIClient;
+  };
+}
+/**
+ * Event payload describing which config field changed.
+ */
+interface ActionConfigUpdateEvent {
+  nodeId: string;
+  nodeType: string;
+  flowId?: string;
+  params: Record<string, unknown>;
+  change?: {
+    field: string;
+    value: unknown;
+  };
+}
+/**
+ * Response from `onConfigUpdate` — returns an updated definition and
+ * optionally mutated params, warnings, or errors.
+ */
+interface ActionConfigUpdateResponse {
+  definition: NodeDefinition;
+  params?: Record<string, unknown>;
+  warnings?: string[];
+  errors?: string[];
+}
+/**
+ * Every `execute()` function returns this.
+ * It intentionally matches `AgentToolResult` so tool results need no mapping.
+ *
+ * The `output` field should be one of:
+ *   - `string`           → text, JSON-serialized data, template results
+ *   - plain object/array → structured data (API responses, query results)
+ *   - `undefined`        → batch-pending sentinel (flow pauses, no output stored)
+ *
+ * Avoid returning raw numbers, booleans, `null`, Buffers, Dates, or class instances.
+ * The action executor bridge infers `OutputVariable.type` as `'object'` for non-null
+ * objects, and `'string'` for everything else.
+ */
+interface ActionResult {
+  success: boolean;
+  output?: unknown;
+  error?: string;
+  metadata?: Record<string, unknown>;
+  /**
+   * Optional named output variables.
+   * When provided, the action executor bridge uses these directly
+   * instead of wrapping `output` into a single "output" variable.
+   * Useful for flow-control nodes like If-Else that produce branch-specific outputs.
+   */
+  outputVariables?: Record<string, {
+    value: unknown;
+    type: 'string' | 'object';
+  }>;
+}
+/**
+ * Sub-category within a provider for finer-grained UI grouping.
+ */
+type ActionCategory = 'read' | 'write' | 'delete' | 'manage';
+/**
+ * Complete action definition — the single source of truth for a node/tool.
+ *
+ * @typeParam TParams - Inferred from the Zod `params.schema`
+ */
+interface ActionDefinition<TParams = unknown> {
+  /**
+   * Globally unique action id using `provider.action_name` format.
+   * This is also the **node type** stored in the database and used by the
+   * executor registry.
+   *
+   * Examples: `"gmail.list_messages"`, `"core.javascript"`, `"http.request"`
+   */
+  id: string;
+  /** Human-readable name displayed in the palette and on the node */
+  name: string;
+  /** Description shown in the UI and given to AI agents */
+  description: string;
+  /** Provider this action belongs to */
+  provider: ProviderDef;
+  /** Credential requirements (omit if the action needs no credentials) */
+  credential?: CredentialRequirement;
+  /** Parameter configuration */
+  params: {
+    /** Zod schema — used for validation in both node and tool paths */schema: z.ZodType<TParams>; /** UI field descriptors (drives the config panel and the tool JSON-Schema) */
+    fields: ParamField[];
+  };
+  /**
+   * Custom output handle definitions.
+   * When set, `toNodeDefinition()` will use these instead of the default
+   * single `{ id: 'output', label: 'Output', type: 'object' }` handle.
+   *
+   * Example (if/else node):
+   * ```ts
+   * outputs: [
+   *   { id: 'true_output', label: 'True', type: 'any' },
+   *   { id: 'false_output', label: 'False', type: 'any' },
+   * ]
+   * ```
+   */
+  outputs?: Array<{
+    id: string;
+    label: string;
+    type: string;
+  }>;
+  /**
+   * If true, the node has no input handle (entry-point / trigger nodes).
+   * When set, `toNodeDefinition()` will produce `input: undefined`.
+   */
+  noInput?: boolean;
+  /**
+   * Maximum number of instances of this node type allowed in a single flow.
+   * For example, `maxInstances: 1` ensures only one Manual Trigger per flow.
+   * When omitted there is no limit.
+   */
+  maxInstances?: number;
+  /**
+   * When true the action is still registered and executable but is hidden
+   * from the node palette in the frontend.  Useful for deprecated actions
+   * that must remain functional for backward compatibility.
+   */
+  hidden?: boolean;
+  /** Search / filter tags */
+  tags?: string[];
+  /**
+   * Lucide icon name for this specific action.
+   * When set, overrides `provider.icon` for the node definition.
+   * Use this to give each core node a contextually meaningful icon
+   * instead of inheriting the generic provider icon.
+   */
+  icon?: string;
+  /** Sub-category inside the provider */
+  actionCategory?: ActionCategory;
+  /**
+   * The execute function — called identically whether the action is
+   * running as a flow node or as an AI-agent tool.
+   */
+  execute(params: TParams, context: ActionExecutionContext): Promise<ActionResult>;
+  /**
+   * Optional hook for dynamic configuration updates.
+   * Called when the frontend changes a config field (e.g. selecting a credential
+   * for a Model node triggers fetching the available models).
+   *
+   * If not provided, the default behaviour returns the static definition + params.
+   */
+  onConfigUpdate?(event: ActionConfigUpdateEvent, context: ActionConfigUpdateContext): Promise<ActionConfigUpdateResponse>;
+}
+//#endregion
+export { ActionCategory, ActionConfigUpdateContext, ActionConfigUpdateEvent, ActionConfigUpdateResponse, ActionCredential, ActionDefinition, ActionExecutionContext, ActionResult, CredentialRequirement, LoadOptionsConfig, LoadOptionsContext, LoadOptionsResult, ParamField, ProviderCategory, ProviderDef };
+//# sourceMappingURL=types.d.ts.map

package/dist/actions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/actions/types.ts"],"mappings":"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"}

package/dist/database/adapter-factory.cjs

@@ -0,0 +1,188 @@
+require("../_virtual/_rolldown/runtime.cjs");
+const require_adapter = require("./adapter.cjs");
+let crypto = require("crypto");
+//#region src/database/adapter-factory.ts
+function createInvectAdapterFactory(rawAdapter, config, schemaMeta) {
+	const caps = {
+		...require_adapter.getDefaultCapabilities(config.dialect),
+		...config
+	};
+	function transformInput(model, data) {
+		const tableMeta = schemaMeta[model];
+		if (!tableMeta) return data;
+		const out = {};
+		for (const [key, value] of Object.entries(data)) {
+			const meta = tableMeta[key];
+			if (!meta || value === void 0 || value === null) {
+				out[key] = value;
+				continue;
+			}
+			out[key] = coerceInput(value, meta.type);
+		}
+		return out;
+	}
+	function applyCreateDefaults(model, data) {
+		const tableMeta = schemaMeta[model];
+		if (!tableMeta) return data;
+		const out = { ...data };
+		for (const [key, meta] of Object.entries(tableMeta)) {
+			if (out[key] !== void 0 && out[key] !== null) continue;
+			if (meta.defaultValue === "uuid") out[key] = (0, crypto.randomUUID)();
+		}
+		return out;
+	}
+	function coerceInput(value, type) {
+		switch (type) {
+			case "boolean":
+				if (!caps.supportsBooleans && typeof value === "boolean") return value ? 1 : 0;
+				return value;
+			case "date":
+				if (!caps.supportsDates && value instanceof Date) return value.toISOString();
+				return value;
+			case "json":
+				if (!caps.supportsJSON && typeof value === "object" && value !== null) return JSON.stringify(value);
+				return value;
+			case "string[]":
+				if (!caps.supportsArrays && Array.isArray(value)) return JSON.stringify(value);
+				return value;
+			default: return value;
+		}
+	}
+	function transformOutput(model, data) {
+		if (!data) return null;
+		const tableMeta = schemaMeta[model];
+		if (!tableMeta) return data;
+		const out = {};
+		for (const [key, value] of Object.entries(data)) {
+			const meta = tableMeta[key];
+			if (!meta || value === void 0 || value === null) {
+				out[key] = value;
+				continue;
+			}
+			out[key] = coerceOutput(value, meta.type);
+		}
+		return out;
+	}
+	function coerceOutput(value, type) {
+		switch (type) {
+			case "boolean":
+				if (!caps.supportsBooleans && typeof value === "number") return value === 1;
+				return value;
+			case "date":
+				if (!caps.supportsDates && typeof value === "string") return new Date(value);
+				return value;
+			case "json":
+				if (!caps.supportsJSON && typeof value === "string") try {
+					return JSON.parse(value);
+				} catch {
+					return value;
+				}
+				return value;
+			case "string[]":
+				if (!caps.supportsArrays && typeof value === "string") try {
+					return JSON.parse(value);
+				} catch {
+					return value;
+				}
+				return value;
+			default: return value;
+		}
+	}
+	function transformWhere(model, where) {
+		const tableMeta = schemaMeta[model];
+		if (!tableMeta) return where;
+		return where.map((clause) => {
+			const meta = tableMeta[clause.field];
+			if (!meta || clause.value === null || clause.value === void 0) return clause;
+			return {
+				...clause,
+				value: coerceInput(clause.value, meta.type)
+			};
+		});
+	}
+	function wrapAdapter(raw) {
+		const executeRaw = raw.executeRaw;
+		return {
+			dialect: config.dialect,
+			async create({ model, data }) {
+				const transformed = transformInput(model, applyCreateDefaults(model, data));
+				return transformOutput(model, await raw.create({
+					model,
+					data: transformed
+				}));
+			},
+			async findOne({ model, where, select }) {
+				const transformedWhere = transformWhere(model, where);
+				return transformOutput(model, await raw.findOne({
+					model,
+					where: transformedWhere,
+					select
+				}));
+			},
+			async findMany({ model, where, limit, offset, sortBy, select }) {
+				const transformedWhere = where ? transformWhere(model, where) : void 0;
+				return (await raw.findMany({
+					model,
+					where: transformedWhere,
+					limit,
+					offset,
+					sortBy,
+					select
+				})).map((r) => transformOutput(model, r));
+			},
+			async count({ model, where }) {
+				const transformedWhere = where ? transformWhere(model, where) : void 0;
+				return raw.count({
+					model,
+					where: transformedWhere
+				});
+			},
+			async update({ model, where, update: updateData, returning }) {
+				const transformedWhere = transformWhere(model, where);
+				const transformedUpdate = transformInput(model, updateData);
+				return transformOutput(model, await raw.update({
+					model,
+					where: transformedWhere,
+					update: transformedUpdate,
+					returning
+				}));
+			},
+			async updateMany({ model, where, update: updateData }) {
+				const transformedWhere = transformWhere(model, where);
+				const transformedUpdate = transformInput(model, updateData);
+				return raw.updateMany({
+					model,
+					where: transformedWhere,
+					update: transformedUpdate
+				});
+			},
+			async delete({ model, where }) {
+				const transformedWhere = transformWhere(model, where);
+				return raw.delete({
+					model,
+					where: transformedWhere
+				});
+			},
+			async deleteMany({ model, where }) {
+				const transformedWhere = transformWhere(model, where);
+				return raw.deleteMany({
+					model,
+					where: transformedWhere
+				});
+			},
+			executeRaw: executeRaw ? async (sqlStr, params) => {
+				return executeRaw(sqlStr, params);
+			} : void 0,
+			async transaction(callback) {
+				return raw.transaction(async (rawTrx) => {
+					return callback(wrapAdapter(rawTrx));
+				});
+			}
+		};
+	}
+	return wrapAdapter(rawAdapter);
+}
+//#endregion
+exports.createInvectAdapterFactory = createInvectAdapterFactory;
+
+//# sourceMappingURL=adapter-factory.cjs.map

package/dist/database/adapter-factory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-factory.cjs","names":["getDefaultCapabilities"],"sources":["../../src/database/adapter-factory.ts"],"sourcesContent":["/**\n * Adapter Factory\n *\n * Wraps a RawInvectAdapter with automatic type coercion based on dialect\n * capabilities. Inspired by better-auth's createAdapterFactory.\n *\n * This layer handles:\n * - boolean ↔ 0/1 integer (SQLite)\n * - Date ↔ ISO string (SQLite)\n * - JSON objects ↔ JSON string (SQLite, MySQL for text-mode JSON)\n * - string[] ↔ JSON string (SQLite, MySQL)\n */\n\nimport type { InvectAdapter, RawInvectAdapter, WhereClause, AdapterConfig } from './adapter';\nimport { getDefaultCapabilities } from './adapter';\nimport { randomUUID } from 'crypto';\n\n// ---------------------------------------------------------------------------\n// Column type metadata — tells the factory how to coerce values\n// ---------------------------------------------------------------------------\n\n/** Known column types for coercion. */\nexport type ColumnType = 'string' | 'number' | 'uuid' | 'boolean' | 'date' | 'json' | 'string[]';\n\nexport interface ColumnMeta {\n  type: ColumnType;\n  defaultValue?: 'uuid';\n}\n\n/**\n * Schema metadata: for each table, a map of column name → column type.\n * Only columns that require coercion need to be listed.\n * Unlisted columns are passed through as-is.\n */\nexport type SchemaMetadata = Record<string, Record<string, ColumnMeta>>;\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\nexport function createInvectAdapterFactory(\n  rawAdapter: RawInvectAdapter,\n  config: AdapterConfig,\n  schemaMeta: SchemaMetadata,\n): InvectAdapter {\n  const caps = {\n    ...getDefaultCapabilities(config.dialect),\n    ...config,\n  };\n\n  // -------------------------------------------------------------------------\n  // Input transform — before writing to DB\n  // -------------------------------------------------------------------------\n\n  function transformInput(model: string, data: Record<string, unknown>): Record<string, unknown> {\n    const tableMeta = schemaMeta[model];\n    if (!tableMeta) {\n      return data;\n    }\n\n    const out: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(data)) {\n      const meta = tableMeta[key];\n      if (!meta || value === undefined || value === null) {\n        out[key] = value;\n        continue;\n      }\n\n      out[key] = coerceInput(value, meta.type);\n    }\n    return out;\n  }\n\n  function applyCreateDefaults(\n    model: string,\n    data: Record<string, unknown>,\n  ): Record<string, unknown> {\n    const tableMeta = schemaMeta[model];\n    if (!tableMeta) {\n      return data;\n    }\n\n    const out = { ...data };\n    for (const [key, meta] of Object.entries(tableMeta)) {\n      if (out[key] !== undefined && out[key] !== null) {\n        continue;\n      }\n\n      if (meta.defaultValue === 'uuid') {\n        out[key] = randomUUID();\n      }\n    }\n\n    return out;\n  }\n\n  function coerceInput(value: unknown, type: ColumnType): unknown {\n    switch (type) {\n      case 'boolean':\n        if (!caps.supportsBooleans && typeof value === 'boolean') {\n          return value ? 1 : 0;\n        }\n        return value;\n\n      case 'date':\n        if (!caps.supportsDates && value instanceof Date) {\n          return value.toISOString();\n        }\n        return value;\n\n      case 'json':\n        if (!caps.supportsJSON && typeof value === 'object' && value !== null) {\n          return JSON.stringify(value);\n        }\n        return value;\n\n      case 'string[]':\n        if (!caps.supportsArrays && Array.isArray(value)) {\n          return JSON.stringify(value);\n        }\n        return value;\n\n      default:\n        return value;\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Output transform — after reading from DB\n  // -------------------------------------------------------------------------\n\n  function transformOutput(\n    model: string,\n    data: Record<string, unknown> | null,\n  ): Record<string, unknown> | null {\n    if (!data) {\n      return null;\n    }\n\n    const tableMeta = schemaMeta[model];\n    if (!tableMeta) {\n      return data;\n    }\n\n    const out: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(data)) {\n      const meta = tableMeta[key];\n      if (!meta || value === undefined || value === null) {\n        out[key] = value;\n        continue;\n      }\n\n      out[key] = coerceOutput(value, meta.type);\n    }\n    return out;\n  }\n\n  function coerceOutput(value: unknown, type: ColumnType): unknown {\n    switch (type) {\n      case 'boolean':\n        if (!caps.supportsBooleans && typeof value === 'number') {\n          return value === 1;\n        }\n        return value;\n\n      case 'date':\n        if (!caps.supportsDates && typeof value === 'string') {\n          return new Date(value);\n        }\n        return value;\n\n      case 'json':\n        if (!caps.supportsJSON && typeof value === 'string') {\n          try {\n            return JSON.parse(value);\n          } catch {\n            return value;\n          }\n        }\n        return value;\n\n      case 'string[]':\n        if (!caps.supportsArrays && typeof value === 'string') {\n          try {\n            return JSON.parse(value);\n          } catch {\n            return value;\n          }\n        }\n        return value;\n\n      default:\n        return value;\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Where clause coercion\n  // -------------------------------------------------------------------------\n\n  function transformWhere(model: string, where: WhereClause[]): WhereClause[] {\n    const tableMeta = schemaMeta[model];\n    if (!tableMeta) {\n      return where;\n    }\n\n    return where.map((clause) => {\n      const meta = tableMeta[clause.field];\n      if (!meta || clause.value === null || clause.value === undefined) {\n        return clause;\n      }\n      return { ...clause, value: coerceInput(clause.value, meta.type) };\n    });\n  }\n\n  // -------------------------------------------------------------------------\n  // Build the wrapped adapter\n  // -------------------------------------------------------------------------\n\n  function wrapAdapter(raw: RawInvectAdapter): InvectAdapter {\n    const executeRaw = raw.executeRaw;\n\n    return {\n      dialect: config.dialect,\n\n      async create<T extends Record<string, unknown>>({\n        model,\n        data,\n      }: {\n        model: string;\n        data: T;\n      }): Promise<T> {\n        const withDefaults = applyCreateDefaults(model, data);\n        const transformed = transformInput(model, withDefaults) as T;\n        const result = await raw.create({ model, data: transformed });\n        return transformOutput(model, result) as T;\n      },\n\n      async findOne<T extends Record<string, unknown>>({\n        model,\n        where,\n        select,\n      }: {\n        model: string;\n        where: WhereClause[];\n        select?: string[];\n      }): Promise<T | null> {\n        const transformedWhere = transformWhere(model, where);\n        const result = await raw.findOne({ model, where: transformedWhere, select });\n        return transformOutput(model, result) as T | null;\n      },\n\n      async findMany<T extends Record<string, unknown>>({\n        model,\n        where,\n        limit,\n        offset,\n        sortBy,\n        select,\n      }: {\n        model: string;\n        where?: WhereClause[];\n        limit?: number;\n        offset?: number;\n        sortBy?: { field: string; direction: 'asc' | 'desc' };\n        select?: string[];\n      }): Promise<T[]> {\n        const transformedWhere = where ? transformWhere(model, where) : undefined;\n        const results = await raw.findMany({\n          model,\n          where: transformedWhere,\n          limit,\n          offset,\n          sortBy,\n          select,\n        });\n        return results.map((r) => transformOutput(model, r) as T);\n      },\n\n      async count({ model, where }: { model: string; where?: WhereClause[] }): Promise<number> {\n        const transformedWhere = where ? transformWhere(model, where) : undefined;\n        return raw.count({ model, where: transformedWhere });\n      },\n\n      async update<T extends Record<string, unknown>>({\n        model,\n        where,\n        update: updateData,\n        returning,\n      }: {\n        model: string;\n        where: WhereClause[];\n        update: Record<string, unknown>;\n        returning?: boolean;\n      }): Promise<T | null> {\n        const transformedWhere = transformWhere(model, where);\n        const transformedUpdate = transformInput(model, updateData);\n        const result = await raw.update<T>({\n          model,\n          where: transformedWhere,\n          update: transformedUpdate,\n          returning,\n        });\n        return transformOutput(model, result) as T | null;\n      },\n\n      async updateMany({\n        model,\n        where,\n        update: updateData,\n      }: {\n        model: string;\n        where: WhereClause[];\n        update: Record<string, unknown>;\n      }): Promise<number> {\n        const transformedWhere = transformWhere(model, where);\n        const transformedUpdate = transformInput(model, updateData);\n        return raw.updateMany({\n          model,\n          where: transformedWhere,\n          update: transformedUpdate,\n        });\n      },\n\n      async delete({ model, where }: { model: string; where: WhereClause[] }): Promise<void> {\n        const transformedWhere = transformWhere(model, where);\n        return raw.delete({ model, where: transformedWhere });\n      },\n\n      async deleteMany({ model, where }: { model: string; where: WhereClause[] }): Promise<number> {\n        const transformedWhere = transformWhere(model, where);\n        return raw.deleteMany({ model, where: transformedWhere });\n      },\n\n      executeRaw: executeRaw\n        ? async <T extends Record<string, unknown>>(sqlStr: string, params?: unknown[]) => {\n            return executeRaw<T>(sqlStr, params);\n          }\n        : undefined,\n\n      async transaction<R>(callback: (trx: InvectAdapter) => Promise<R>): Promise<R> {\n        return raw.transaction(async (rawTrx) => {\n          const wrappedTrx = wrapAdapter(rawTrx);\n          return callback(wrappedTrx);\n        });\n      },\n    };\n  }\n\n  return wrapAdapter(rawAdapter);\n}\n"],"mappings":"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"}