@invect/core 0.0.1

package/dist/actions/postgres/describe-table.cjs

@@ -0,0 +1,175 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_define_action = require("../define-action.cjs");
+const require_providers = require("../providers.cjs");
+let zod_v4 = require("zod/v4");
+let postgres = require("postgres");
+postgres = require_runtime.__toESM(postgres);
+//#region src/actions/postgres/describe-table.ts
+/**
+* postgres.describe_table — Describe columns of a PostgreSQL table
+*
+* Returns column names, data types, nullability, defaults, and
+* primary-key / foreign-key constraints for a given table.
+*/
+const paramsSchema = zod_v4.z.object({
+	credentialId: zod_v4.z.string().min(1, "Database credential is required"),
+	tableName: zod_v4.z.string().min(1, "Table name is required"),
+	schemaName: zod_v4.z.string().optional().default("public")
+});
+const postgresDescribeTableAction = require_define_action.defineAction({
+	id: "postgres.describe_table",
+	name: "Describe Table",
+	description: "Retrieve column definitions, data types, nullability, defaults, and key constraints for a PostgreSQL table.",
+	provider: require_providers.POSTGRES_PROVIDER,
+	actionCategory: "read",
+	tags: [
+		"postgres",
+		"postgresql",
+		"sql",
+		"database",
+		"table",
+		"columns",
+		"schema",
+		"describe",
+		"inspect",
+		"db"
+	],
+	credential: {
+		required: true,
+		type: "database",
+		description: "PostgreSQL database connection credential"
+	},
+	params: {
+		schema: paramsSchema,
+		fields: [
+			{
+				name: "credentialId",
+				label: "Database Credential",
+				type: "text",
+				required: true,
+				description: "Select a PostgreSQL database connection credential",
+				aiProvided: false
+			},
+			{
+				name: "tableName",
+				label: "Table Name",
+				type: "text",
+				required: true,
+				placeholder: "e.g. users",
+				description: "Name of the table to describe."
+			},
+			{
+				name: "schemaName",
+				label: "Schema",
+				type: "text",
+				defaultValue: "public",
+				description: "PostgreSQL schema the table belongs to.",
+				extended: true
+			}
+		]
+	},
+	async execute(params, context) {
+		const { credentialId, tableName, schemaName } = params;
+		let credential = context.credential;
+		if (!credential && context.functions?.getCredential) credential = await context.functions.getCredential(credentialId);
+		if (!credential) return {
+			success: false,
+			error: `Failed to load database credential: ${credentialId}`
+		};
+		const config = credential.config;
+		if (typeof config !== "object" || config === null || !("connectionString" in config) || typeof config.connectionString !== "string") return {
+			success: false,
+			error: "Invalid database credential — missing connectionString"
+		};
+		const sslOpt = config.ssl === true ? { rejectUnauthorized: false } : typeof config.ssl === "object" ? config.ssl : void 0;
+		const sql = (0, postgres.default)(config.connectionString, {
+			ssl: sslOpt,
+			max: 1
+		});
+		try {
+			const columnsQuery = `
+        SELECT
+          c.column_name,
+          c.data_type,
+          c.udt_name,
+          c.is_nullable,
+          c.column_default,
+          c.character_maximum_length,
+          c.numeric_precision,
+          c.ordinal_position
+        FROM information_schema.columns c
+        WHERE c.table_schema = '${schemaName}'
+          AND c.table_name   = '${tableName}'
+        ORDER BY c.ordinal_position
+      `;
+			const pkQuery = `
+        SELECT kcu.column_name
+        FROM information_schema.table_constraints tc
+        JOIN information_schema.key_column_usage kcu
+          ON tc.constraint_name = kcu.constraint_name
+         AND tc.table_schema    = kcu.table_schema
+        WHERE tc.table_schema    = '${schemaName}'
+          AND tc.table_name      = '${tableName}'
+          AND tc.constraint_type = 'PRIMARY KEY'
+      `;
+			const fkQuery = `
+        SELECT
+          kcu.column_name,
+          ccu.table_name  AS foreign_table_name,
+          ccu.column_name AS foreign_column_name,
+          tc.constraint_name
+        FROM information_schema.table_constraints tc
+        JOIN information_schema.key_column_usage kcu
+          ON tc.constraint_name = kcu.constraint_name
+         AND tc.table_schema    = kcu.table_schema
+        JOIN information_schema.constraint_column_usage ccu
+          ON ccu.constraint_name = tc.constraint_name
+         AND ccu.table_schema    = tc.table_schema
+        WHERE tc.table_schema    = '${schemaName}'
+          AND tc.table_name      = '${tableName}'
+          AND tc.constraint_type = 'FOREIGN KEY'
+      `;
+			const [columns, pkCols, fkCols] = await Promise.all([
+				sql.unsafe(columnsQuery),
+				sql.unsafe(pkQuery),
+				sql.unsafe(fkQuery)
+			]);
+			const pkSet = new Set(pkCols.map((r) => r.column_name));
+			const fkMap = new Map(fkCols.map((r) => [r.column_name, {
+				foreignTable: r.foreign_table_name,
+				foreignColumn: r.foreign_column_name
+			}]));
+			const enrichedColumns = columns.map((col) => ({
+				...col,
+				is_primary_key: pkSet.has(col.column_name),
+				foreign_key: fkMap.get(col.column_name) ?? null
+			}));
+			return {
+				success: true,
+				output: {
+					tableName,
+					schema: schemaName,
+					columns: enrichedColumns,
+					columnCount: enrichedColumns.length,
+					primaryKeyColumns: Array.from(pkSet)
+				},
+				metadata: {
+					tableName,
+					schema: schemaName,
+					columnCount: enrichedColumns.length
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				error: `Failed to describe table: ${error instanceof Error ? error.message : String(error)}`
+			};
+		} finally {
+			await sql.end().catch(() => {});
+		}
+	}
+});
+//#endregion
+exports.postgresDescribeTableAction = postgresDescribeTableAction;
+
+//# sourceMappingURL=describe-table.cjs.map

package/dist/actions/postgres/describe-table.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-table.cjs","names":["z","defineAction","POSTGRES_PROVIDER"],"sources":["../../../src/actions/postgres/describe-table.ts"],"sourcesContent":["/**\n * postgres.describe_table — Describe columns of a PostgreSQL table\n *\n * Returns column names, data types, nullability, defaults, and\n * primary-key / foreign-key constraints for a given table.\n */\n\nimport { defineAction } from '../define-action';\nimport { POSTGRES_PROVIDER } from '../providers';\nimport { z } from 'zod/v4';\nimport pgLib from 'postgres';\n\nconst paramsSchema = z.object({\n  credentialId: z.string().min(1, 'Database credential is required'),\n  tableName: z.string().min(1, 'Table name is required'),\n  schemaName: z.string().optional().default('public'),\n});\n\nexport const postgresDescribeTableAction = defineAction({\n  id: 'postgres.describe_table',\n  name: 'Describe Table',\n  description:\n    'Retrieve column definitions, data types, nullability, defaults, and key constraints for a PostgreSQL table.',\n  provider: POSTGRES_PROVIDER,\n  actionCategory: 'read',\n  tags: [\n    'postgres',\n    'postgresql',\n    'sql',\n    'database',\n    'table',\n    'columns',\n    'schema',\n    'describe',\n    'inspect',\n    'db',\n  ],\n\n  credential: {\n    required: true,\n    type: 'database',\n    description: 'PostgreSQL database connection credential',\n  },\n\n  params: {\n    schema: paramsSchema,\n    fields: [\n      {\n        name: 'credentialId',\n        label: 'Database Credential',\n        type: 'text',\n        required: true,\n        description: 'Select a PostgreSQL database connection credential',\n        aiProvided: false,\n      },\n      {\n        name: 'tableName',\n        label: 'Table Name',\n        type: 'text',\n        required: true,\n        placeholder: 'e.g. users',\n        description: 'Name of the table to describe.',\n      },\n      {\n        name: 'schemaName',\n        label: 'Schema',\n        type: 'text',\n        defaultValue: 'public',\n        description: 'PostgreSQL schema the table belongs to.',\n        extended: true,\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    const { credentialId, tableName, schemaName } = params;\n\n    let credential = context.credential;\n    if (!credential && context.functions?.getCredential) {\n      credential = await context.functions.getCredential(credentialId);\n    }\n    if (!credential) {\n      return { success: false, error: `Failed to load database credential: ${credentialId}` };\n    }\n\n    const config = credential.config;\n    if (\n      typeof config !== 'object' ||\n      config === null ||\n      !('connectionString' in config) ||\n      typeof config.connectionString !== 'string'\n    ) {\n      return { success: false, error: 'Invalid database credential — missing connectionString' };\n    }\n\n    const sslOpt =\n      config.ssl === true\n        ? { rejectUnauthorized: false }\n        : typeof config.ssl === 'object'\n          ? (config.ssl as { rejectUnauthorized?: boolean })\n          : undefined;\n\n    const sql = pgLib(config.connectionString, { ssl: sslOpt, max: 1 });\n\n    try {\n      // Columns\n      const columnsQuery = `\n        SELECT\n          c.column_name,\n          c.data_type,\n          c.udt_name,\n          c.is_nullable,\n          c.column_default,\n          c.character_maximum_length,\n          c.numeric_precision,\n          c.ordinal_position\n        FROM information_schema.columns c\n        WHERE c.table_schema = '${schemaName}'\n          AND c.table_name   = '${tableName}'\n        ORDER BY c.ordinal_position\n      `;\n\n      // Primary key columns\n      const pkQuery = `\n        SELECT kcu.column_name\n        FROM information_schema.table_constraints tc\n        JOIN information_schema.key_column_usage kcu\n          ON tc.constraint_name = kcu.constraint_name\n         AND tc.table_schema    = kcu.table_schema\n        WHERE tc.table_schema    = '${schemaName}'\n          AND tc.table_name      = '${tableName}'\n          AND tc.constraint_type = 'PRIMARY KEY'\n      `;\n\n      // Foreign keys\n      const fkQuery = `\n        SELECT\n          kcu.column_name,\n          ccu.table_name  AS foreign_table_name,\n          ccu.column_name AS foreign_column_name,\n          tc.constraint_name\n        FROM information_schema.table_constraints tc\n        JOIN information_schema.key_column_usage kcu\n          ON tc.constraint_name = kcu.constraint_name\n         AND tc.table_schema    = kcu.table_schema\n        JOIN information_schema.constraint_column_usage ccu\n          ON ccu.constraint_name = tc.constraint_name\n         AND ccu.table_schema    = tc.table_schema\n        WHERE tc.table_schema    = '${schemaName}'\n          AND tc.table_name      = '${tableName}'\n          AND tc.constraint_type = 'FOREIGN KEY'\n      `;\n\n      const [columns, pkCols, fkCols] = await Promise.all([\n        sql.unsafe(columnsQuery),\n        sql.unsafe(pkQuery),\n        sql.unsafe(fkQuery),\n      ]);\n\n      const pkSet = new Set(\n        (pkCols as unknown as { column_name: string }[]).map((r) => r.column_name),\n      );\n      const fkMap = new Map(\n        (\n          fkCols as unknown as {\n            column_name: string;\n            foreign_table_name: string;\n            foreign_column_name: string;\n          }[]\n        ).map((r) => [\n          r.column_name,\n          { foreignTable: r.foreign_table_name, foreignColumn: r.foreign_column_name },\n        ]),\n      );\n\n      const enrichedColumns = (columns as Record<string, unknown>[]).map((col) => ({\n        ...col,\n        is_primary_key: pkSet.has(col.column_name as string),\n        foreign_key: fkMap.get(col.column_name as string) ?? null,\n      }));\n\n      return {\n        success: true,\n        output: {\n          tableName,\n          schema: schemaName,\n          columns: enrichedColumns,\n          columnCount: enrichedColumns.length,\n          primaryKeyColumns: Array.from(pkSet),\n        },\n        metadata: { tableName, schema: schemaName, columnCount: enrichedColumns.length },\n      };\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      return { success: false, error: `Failed to describe table: ${msg}` };\n    } finally {\n      await sql.end().catch(() => {\n        /* connection cleanup */\n      });\n    }\n  },\n});\n"],"mappings":"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"}

package/dist/actions/postgres/describe-table.d.cts

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

package/dist/actions/postgres/describe-table.d.ts

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

package/dist/actions/postgres/describe-table.js

@@ -0,0 +1,165 @@
+import { defineAction } from "../define-action.js";
+import { POSTGRES_PROVIDER } from "../providers.js";
+import { z } from "zod/v4";
+import postgres from "postgres";
+const postgresDescribeTableAction = defineAction({
+	id: "postgres.describe_table",
+	name: "Describe Table",
+	description: "Retrieve column definitions, data types, nullability, defaults, and key constraints for a PostgreSQL table.",
+	provider: POSTGRES_PROVIDER,
+	actionCategory: "read",
+	tags: [
+		"postgres",
+		"postgresql",
+		"sql",
+		"database",
+		"table",
+		"columns",
+		"schema",
+		"describe",
+		"inspect",
+		"db"
+	],
+	credential: {
+		required: true,
+		type: "database",
+		description: "PostgreSQL database connection credential"
+	},
+	params: {
+		schema: z.object({
+			credentialId: z.string().min(1, "Database credential is required"),
+			tableName: z.string().min(1, "Table name is required"),
+			schemaName: z.string().optional().default("public")
+		}),
+		fields: [
+			{
+				name: "credentialId",
+				label: "Database Credential",
+				type: "text",
+				required: true,
+				description: "Select a PostgreSQL database connection credential",
+				aiProvided: false
+			},
+			{
+				name: "tableName",
+				label: "Table Name",
+				type: "text",
+				required: true,
+				placeholder: "e.g. users",
+				description: "Name of the table to describe."
+			},
+			{
+				name: "schemaName",
+				label: "Schema",
+				type: "text",
+				defaultValue: "public",
+				description: "PostgreSQL schema the table belongs to.",
+				extended: true
+			}
+		]
+	},
+	async execute(params, context) {
+		const { credentialId, tableName, schemaName } = params;
+		let credential = context.credential;
+		if (!credential && context.functions?.getCredential) credential = await context.functions.getCredential(credentialId);
+		if (!credential) return {
+			success: false,
+			error: `Failed to load database credential: ${credentialId}`
+		};
+		const config = credential.config;
+		if (typeof config !== "object" || config === null || !("connectionString" in config) || typeof config.connectionString !== "string") return {
+			success: false,
+			error: "Invalid database credential — missing connectionString"
+		};
+		const sslOpt = config.ssl === true ? { rejectUnauthorized: false } : typeof config.ssl === "object" ? config.ssl : void 0;
+		const sql = postgres(config.connectionString, {
+			ssl: sslOpt,
+			max: 1
+		});
+		try {
+			const columnsQuery = `
+        SELECT
+          c.column_name,
+          c.data_type,
+          c.udt_name,
+          c.is_nullable,
+          c.column_default,
+          c.character_maximum_length,
+          c.numeric_precision,
+          c.ordinal_position
+        FROM information_schema.columns c
+        WHERE c.table_schema = '${schemaName}'
+          AND c.table_name   = '${tableName}'
+        ORDER BY c.ordinal_position
+      `;
+			const pkQuery = `
+        SELECT kcu.column_name
+        FROM information_schema.table_constraints tc
+        JOIN information_schema.key_column_usage kcu
+          ON tc.constraint_name = kcu.constraint_name
+         AND tc.table_schema    = kcu.table_schema
+        WHERE tc.table_schema    = '${schemaName}'
+          AND tc.table_name      = '${tableName}'
+          AND tc.constraint_type = 'PRIMARY KEY'
+      `;
+			const fkQuery = `
+        SELECT
+          kcu.column_name,
+          ccu.table_name  AS foreign_table_name,
+          ccu.column_name AS foreign_column_name,
+          tc.constraint_name
+        FROM information_schema.table_constraints tc
+        JOIN information_schema.key_column_usage kcu
+          ON tc.constraint_name = kcu.constraint_name
+         AND tc.table_schema    = kcu.table_schema
+        JOIN information_schema.constraint_column_usage ccu
+          ON ccu.constraint_name = tc.constraint_name
+         AND ccu.table_schema    = tc.table_schema
+        WHERE tc.table_schema    = '${schemaName}'
+          AND tc.table_name      = '${tableName}'
+          AND tc.constraint_type = 'FOREIGN KEY'
+      `;
+			const [columns, pkCols, fkCols] = await Promise.all([
+				sql.unsafe(columnsQuery),
+				sql.unsafe(pkQuery),
+				sql.unsafe(fkQuery)
+			]);
+			const pkSet = new Set(pkCols.map((r) => r.column_name));
+			const fkMap = new Map(fkCols.map((r) => [r.column_name, {
+				foreignTable: r.foreign_table_name,
+				foreignColumn: r.foreign_column_name
+			}]));
+			const enrichedColumns = columns.map((col) => ({
+				...col,
+				is_primary_key: pkSet.has(col.column_name),
+				foreign_key: fkMap.get(col.column_name) ?? null
+			}));
+			return {
+				success: true,
+				output: {
+					tableName,
+					schema: schemaName,
+					columns: enrichedColumns,
+					columnCount: enrichedColumns.length,
+					primaryKeyColumns: Array.from(pkSet)
+				},
+				metadata: {
+					tableName,
+					schema: schemaName,
+					columnCount: enrichedColumns.length
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				error: `Failed to describe table: ${error instanceof Error ? error.message : String(error)}`
+			};
+		} finally {
+			await sql.end().catch(() => {});
+		}
+	}
+});
+//#endregion
+export { postgresDescribeTableAction };
+
+//# sourceMappingURL=describe-table.js.map

package/dist/actions/postgres/describe-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-table.js","names":["pgLib"],"sources":["../../../src/actions/postgres/describe-table.ts"],"sourcesContent":["/**\n * postgres.describe_table — Describe columns of a PostgreSQL table\n *\n * Returns column names, data types, nullability, defaults, and\n * primary-key / foreign-key constraints for a given table.\n */\n\nimport { defineAction } from '../define-action';\nimport { POSTGRES_PROVIDER } from '../providers';\nimport { z } from 'zod/v4';\nimport pgLib from 'postgres';\n\nconst paramsSchema = z.object({\n  credentialId: z.string().min(1, 'Database credential is required'),\n  tableName: z.string().min(1, 'Table name is required'),\n  schemaName: z.string().optional().default('public'),\n});\n\nexport const postgresDescribeTableAction = defineAction({\n  id: 'postgres.describe_table',\n  name: 'Describe Table',\n  description:\n    'Retrieve column definitions, data types, nullability, defaults, and key constraints for a PostgreSQL table.',\n  provider: POSTGRES_PROVIDER,\n  actionCategory: 'read',\n  tags: [\n    'postgres',\n    'postgresql',\n    'sql',\n    'database',\n    'table',\n    'columns',\n    'schema',\n    'describe',\n    'inspect',\n    'db',\n  ],\n\n  credential: {\n    required: true,\n    type: 'database',\n    description: 'PostgreSQL database connection credential',\n  },\n\n  params: {\n    schema: paramsSchema,\n    fields: [\n      {\n        name: 'credentialId',\n        label: 'Database Credential',\n        type: 'text',\n        required: true,\n        description: 'Select a PostgreSQL database connection credential',\n        aiProvided: false,\n      },\n      {\n        name: 'tableName',\n        label: 'Table Name',\n        type: 'text',\n        required: true,\n        placeholder: 'e.g. users',\n        description: 'Name of the table to describe.',\n      },\n      {\n        name: 'schemaName',\n        label: 'Schema',\n        type: 'text',\n        defaultValue: 'public',\n        description: 'PostgreSQL schema the table belongs to.',\n        extended: true,\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    const { credentialId, tableName, schemaName } = params;\n\n    let credential = context.credential;\n    if (!credential && context.functions?.getCredential) {\n      credential = await context.functions.getCredential(credentialId);\n    }\n    if (!credential) {\n      return { success: false, error: `Failed to load database credential: ${credentialId}` };\n    }\n\n    const config = credential.config;\n    if (\n      typeof config !== 'object' ||\n      config === null ||\n      !('connectionString' in config) ||\n      typeof config.connectionString !== 'string'\n    ) {\n      return { success: false, error: 'Invalid database credential — missing connectionString' };\n    }\n\n    const sslOpt =\n      config.ssl === true\n        ? { rejectUnauthorized: false }\n        : typeof config.ssl === 'object'\n          ? (config.ssl as { rejectUnauthorized?: boolean })\n          : undefined;\n\n    const sql = pgLib(config.connectionString, { ssl: sslOpt, max: 1 });\n\n    try {\n      // Columns\n      const columnsQuery = `\n        SELECT\n          c.column_name,\n          c.data_type,\n          c.udt_name,\n          c.is_nullable,\n          c.column_default,\n          c.character_maximum_length,\n          c.numeric_precision,\n          c.ordinal_position\n        FROM information_schema.columns c\n        WHERE c.table_schema = '${schemaName}'\n          AND c.table_name   = '${tableName}'\n        ORDER BY c.ordinal_position\n      `;\n\n      // Primary key columns\n      const pkQuery = `\n        SELECT kcu.column_name\n        FROM information_schema.table_constraints tc\n        JOIN information_schema.key_column_usage kcu\n          ON tc.constraint_name = kcu.constraint_name\n         AND tc.table_schema    = kcu.table_schema\n        WHERE tc.table_schema    = '${schemaName}'\n          AND tc.table_name      = '${tableName}'\n          AND tc.constraint_type = 'PRIMARY KEY'\n      `;\n\n      // Foreign keys\n      const fkQuery = `\n        SELECT\n          kcu.column_name,\n          ccu.table_name  AS foreign_table_name,\n          ccu.column_name AS foreign_column_name,\n          tc.constraint_name\n        FROM information_schema.table_constraints tc\n        JOIN information_schema.key_column_usage kcu\n          ON tc.constraint_name = kcu.constraint_name\n         AND tc.table_schema    = kcu.table_schema\n        JOIN information_schema.constraint_column_usage ccu\n          ON ccu.constraint_name = tc.constraint_name\n         AND ccu.table_schema    = tc.table_schema\n        WHERE tc.table_schema    = '${schemaName}'\n          AND tc.table_name      = '${tableName}'\n          AND tc.constraint_type = 'FOREIGN KEY'\n      `;\n\n      const [columns, pkCols, fkCols] = await Promise.all([\n        sql.unsafe(columnsQuery),\n        sql.unsafe(pkQuery),\n        sql.unsafe(fkQuery),\n      ]);\n\n      const pkSet = new Set(\n        (pkCols as unknown as { column_name: string }[]).map((r) => r.column_name),\n      );\n      const fkMap = new Map(\n        (\n          fkCols as unknown as {\n            column_name: string;\n            foreign_table_name: string;\n            foreign_column_name: string;\n          }[]\n        ).map((r) => [\n          r.column_name,\n          { foreignTable: r.foreign_table_name, foreignColumn: r.foreign_column_name },\n        ]),\n      );\n\n      const enrichedColumns = (columns as Record<string, unknown>[]).map((col) => ({\n        ...col,\n        is_primary_key: pkSet.has(col.column_name as string),\n        foreign_key: fkMap.get(col.column_name as string) ?? null,\n      }));\n\n      return {\n        success: true,\n        output: {\n          tableName,\n          schema: schemaName,\n          columns: enrichedColumns,\n          columnCount: enrichedColumns.length,\n          primaryKeyColumns: Array.from(pkSet),\n        },\n        metadata: { tableName, schema: schemaName, columnCount: enrichedColumns.length },\n      };\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      return { success: false, error: `Failed to describe table: ${msg}` };\n    } finally {\n      await sql.end().catch(() => {\n        /* connection cleanup */\n      });\n    }\n  },\n});\n"],"mappings":";;;;AAkBA,MAAa,8BAA8B,aAAa;CACtD,IAAI;CACJ,MAAM;CACN,aACE;CACF,UAAU;CACV,gBAAgB;CAChB,MAAM;EACJ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CAED,YAAY;EACV,UAAU;EACV,MAAM;EACN,aAAa;EACd;CAED,QAAQ;EACN,QAjCiB,EAAE,OAAO;GAC5B,cAAc,EAAE,QAAQ,CAAC,IAAI,GAAG,kCAAkC;GAClE,WAAW,EAAE,QAAQ,CAAC,IAAI,GAAG,yBAAyB;GACtD,YAAY,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,SAAS;GACpD,CAAC;EA8BE,QAAQ;GACN;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,aAAa;IACb,YAAY;IACb;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,aAAa;IACb,aAAa;IACd;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,cAAc;IACd,aAAa;IACb,UAAU;IACX;GACF;EACF;CAED,MAAM,QAAQ,QAAQ,SAAS;EAC7B,MAAM,EAAE,cAAc,WAAW,eAAe;EAEhD,IAAI,aAAa,QAAQ;AACzB,MAAI,CAAC,cAAc,QAAQ,WAAW,cACpC,cAAa,MAAM,QAAQ,UAAU,cAAc,aAAa;AAElE,MAAI,CAAC,WACH,QAAO;GAAE,SAAS;GAAO,OAAO,uCAAuC;GAAgB;EAGzF,MAAM,SAAS,WAAW;AAC1B,MACE,OAAO,WAAW,YAClB,WAAW,QACX,EAAE,sBAAsB,WACxB,OAAO,OAAO,qBAAqB,SAEnC,QAAO;GAAE,SAAS;GAAO,OAAO;GAA0D;EAG5F,MAAM,SACJ,OAAO,QAAQ,OACX,EAAE,oBAAoB,OAAO,GAC7B,OAAO,OAAO,QAAQ,WACnB,OAAO,MACR,KAAA;EAER,MAAM,MAAMA,SAAM,OAAO,kBAAkB;GAAE,KAAK;GAAQ,KAAK;GAAG,CAAC;AAEnE,MAAI;GAEF,MAAM,eAAe;;;;;;;;;;;kCAWO,WAAW;kCACX,UAAU;;;GAKtC,MAAM,UAAU;;;;;;sCAMgB,WAAW;sCACX,UAAU;;;GAK1C,MAAM,UAAU;;;;;;;;;;;;;sCAagB,WAAW;sCACX,UAAU;;;GAI1C,MAAM,CAAC,SAAS,QAAQ,UAAU,MAAM,QAAQ,IAAI;IAClD,IAAI,OAAO,aAAa;IACxB,IAAI,OAAO,QAAQ;IACnB,IAAI,OAAO,QAAQ;IACpB,CAAC;GAEF,MAAM,QAAQ,IAAI,IACf,OAAgD,KAAK,MAAM,EAAE,YAAY,CAC3E;GACD,MAAM,QAAQ,IAAI,IAEd,OAKA,KAAK,MAAM,CACX,EAAE,aACF;IAAE,cAAc,EAAE;IAAoB,eAAe,EAAE;IAAqB,CAC7E,CAAC,CACH;GAED,MAAM,kBAAmB,QAAsC,KAAK,SAAS;IAC3E,GAAG;IACH,gBAAgB,MAAM,IAAI,IAAI,YAAsB;IACpD,aAAa,MAAM,IAAI,IAAI,YAAsB,IAAI;IACtD,EAAE;AAEH,UAAO;IACL,SAAS;IACT,QAAQ;KACN;KACA,QAAQ;KACR,SAAS;KACT,aAAa,gBAAgB;KAC7B,mBAAmB,MAAM,KAAK,MAAM;KACrC;IACD,UAAU;KAAE;KAAW,QAAQ;KAAY,aAAa,gBAAgB;KAAQ;IACjF;WACM,OAAO;AAEd,UAAO;IAAE,SAAS;IAAO,OAAO,6BADpB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IACE;YAC5D;AACR,SAAM,IAAI,KAAK,CAAC,YAAY,GAE1B;;;CAGP,CAAC"}

package/dist/actions/postgres/execute-query.cjs

@@ -0,0 +1,120 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_define_action = require("../define-action.cjs");
+const require_providers = require("../providers.cjs");
+let zod_v4 = require("zod/v4");
+let postgres = require("postgres");
+postgres = require_runtime.__toESM(postgres);
+//#region src/actions/postgres/execute-query.ts
+/**
+* postgres.execute_query — Execute a raw SQL query
+*
+* Runs an arbitrary SQL statement against a PostgreSQL database and
+* returns the resulting rows. Supports Nunjucks templating in the query.
+*/
+const paramsSchema = zod_v4.z.object({
+	credentialId: zod_v4.z.string().min(1, "Database credential is required"),
+	query: zod_v4.z.string().min(1, "SQL query is required"),
+	timeout: zod_v4.z.number().int().positive().optional()
+});
+const postgresExecuteQueryAction = require_define_action.defineAction({
+	id: "postgres.execute_query",
+	name: "Execute Query",
+	description: "Run an arbitrary SQL query (SELECT, INSERT, UPDATE, DELETE, etc.) against a PostgreSQL database and return the results.",
+	provider: require_providers.POSTGRES_PROVIDER,
+	actionCategory: "read",
+	tags: [
+		"postgres",
+		"postgresql",
+		"sql",
+		"database",
+		"query",
+		"select",
+		"insert",
+		"update",
+		"delete",
+		"db"
+	],
+	credential: {
+		required: true,
+		type: "database",
+		description: "PostgreSQL database connection credential"
+	},
+	params: {
+		schema: paramsSchema,
+		fields: [
+			{
+				name: "credentialId",
+				label: "Database Credential",
+				type: "text",
+				required: true,
+				description: "Select a PostgreSQL database connection credential",
+				aiProvided: false
+			},
+			{
+				name: "query",
+				label: "SQL Query",
+				type: "code",
+				required: true,
+				description: "SQL statement to execute. Supports Nunjucks templates for dynamic values.",
+				defaultValue: "SELECT * FROM users LIMIT 10"
+			},
+			{
+				name: "timeout",
+				label: "Timeout (seconds)",
+				type: "number",
+				description: "Query timeout in seconds. Defaults to 30.",
+				defaultValue: 30,
+				extended: true
+			}
+		]
+	},
+	async execute(params, context) {
+		const { query, credentialId, timeout } = params;
+		let credential = context.credential;
+		if (!credential && context.functions?.getCredential) credential = await context.functions.getCredential(credentialId);
+		if (!credential) return {
+			success: false,
+			error: `Failed to load database credential: ${credentialId}`
+		};
+		const config = credential.config;
+		if (typeof config !== "object" || config === null || !("connectionString" in config) || typeof config.connectionString !== "string") return {
+			success: false,
+			error: "Invalid database credential — missing connectionString"
+		};
+		context.logger.debug("postgres.execute_query", { query: query.substring(0, 120) + (query.length > 120 ? "…" : "") });
+		const sslOpt = config.ssl === true ? { rejectUnauthorized: false } : typeof config.ssl === "object" ? config.ssl : void 0;
+		const sql = (0, postgres.default)(config.connectionString, {
+			ssl: sslOpt,
+			max: 1,
+			idle_timeout: timeout ?? 30
+		});
+		try {
+			const result = await sql.unsafe(query);
+			const data = Array.isArray(result) ? result : [];
+			const columns = data.length > 0 ? Object.keys(data[0]) : [];
+			return {
+				success: true,
+				output: {
+					data,
+					columns,
+					rowCount: data.length
+				},
+				metadata: {
+					rowCount: data.length,
+					columns
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				error: `SQL query failed: ${error instanceof Error ? error.message : String(error)}`
+			};
+		} finally {
+			await sql.end().catch(() => {});
+		}
+	}
+});
+//#endregion
+exports.postgresExecuteQueryAction = postgresExecuteQueryAction;
+
+//# sourceMappingURL=execute-query.cjs.map

package/dist/actions/postgres/execute-query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-query.cjs","names":["z","defineAction","POSTGRES_PROVIDER"],"sources":["../../../src/actions/postgres/execute-query.ts"],"sourcesContent":["/**\n * postgres.execute_query — Execute a raw SQL query\n *\n * Runs an arbitrary SQL statement against a PostgreSQL database and\n * returns the resulting rows. Supports Nunjucks templating in the query.\n */\n\nimport { defineAction } from '../define-action';\nimport { POSTGRES_PROVIDER } from '../providers';\nimport { z } from 'zod/v4';\nimport pgLib from 'postgres';\n\nconst paramsSchema = z.object({\n  credentialId: z.string().min(1, 'Database credential is required'),\n  query: z.string().min(1, 'SQL query is required'),\n  timeout: z.number().int().positive().optional(),\n});\n\nexport const postgresExecuteQueryAction = defineAction({\n  id: 'postgres.execute_query',\n  name: 'Execute Query',\n  description:\n    'Run an arbitrary SQL query (SELECT, INSERT, UPDATE, DELETE, etc.) against a PostgreSQL database and return the results.',\n  provider: POSTGRES_PROVIDER,\n  actionCategory: 'read',\n  tags: [\n    'postgres',\n    'postgresql',\n    'sql',\n    'database',\n    'query',\n    'select',\n    'insert',\n    'update',\n    'delete',\n    'db',\n  ],\n\n  credential: {\n    required: true,\n    type: 'database',\n    description: 'PostgreSQL database connection credential',\n  },\n\n  params: {\n    schema: paramsSchema,\n    fields: [\n      {\n        name: 'credentialId',\n        label: 'Database Credential',\n        type: 'text',\n        required: true,\n        description: 'Select a PostgreSQL database connection credential',\n        aiProvided: false,\n      },\n      {\n        name: 'query',\n        label: 'SQL Query',\n        type: 'code',\n        required: true,\n        description: 'SQL statement to execute. Supports Nunjucks templates for dynamic values.',\n        defaultValue: 'SELECT * FROM users LIMIT 10',\n      },\n      {\n        name: 'timeout',\n        label: 'Timeout (seconds)',\n        type: 'number',\n        description: 'Query timeout in seconds. Defaults to 30.',\n        defaultValue: 30,\n        extended: true,\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    const { query, credentialId, timeout } = params;\n\n    let credential = context.credential;\n    if (!credential && context.functions?.getCredential) {\n      credential = await context.functions.getCredential(credentialId);\n    }\n    if (!credential) {\n      return { success: false, error: `Failed to load database credential: ${credentialId}` };\n    }\n\n    const config = credential.config;\n    if (\n      typeof config !== 'object' ||\n      config === null ||\n      !('connectionString' in config) ||\n      typeof config.connectionString !== 'string'\n    ) {\n      return { success: false, error: 'Invalid database credential — missing connectionString' };\n    }\n\n    context.logger.debug('postgres.execute_query', {\n      query: query.substring(0, 120) + (query.length > 120 ? '…' : ''),\n    });\n\n    const sslOpt =\n      config.ssl === true\n        ? { rejectUnauthorized: false }\n        : typeof config.ssl === 'object'\n          ? (config.ssl as { rejectUnauthorized?: boolean })\n          : undefined;\n\n    const sql = pgLib(config.connectionString, {\n      ssl: sslOpt,\n      max: 1,\n      idle_timeout: timeout ?? 30,\n    });\n\n    try {\n      const result = await sql.unsafe(query);\n      const data = Array.isArray(result) ? result : [];\n      const columns = data.length > 0 ? Object.keys(data[0]) : [];\n\n      return {\n        success: true,\n        output: { data, columns, rowCount: data.length },\n        metadata: { rowCount: data.length, columns },\n      };\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      return { success: false, error: `SQL query failed: ${msg}` };\n    } finally {\n      await sql.end().catch(() => {\n        /* connection cleanup */\n      });\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;AAYA,MAAM,eAAeA,OAAAA,EAAE,OAAO;CAC5B,cAAcA,OAAAA,EAAE,QAAQ,CAAC,IAAI,GAAG,kCAAkC;CAClE,OAAOA,OAAAA,EAAE,QAAQ,CAAC,IAAI,GAAG,wBAAwB;CACjD,SAASA,OAAAA,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU;CAChD,CAAC;AAEF,MAAa,6BAA6BC,sBAAAA,aAAa;CACrD,IAAI;CACJ,MAAM;CACN,aACE;CACF,UAAUC,kBAAAA;CACV,gBAAgB;CAChB,MAAM;EACJ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CAED,YAAY;EACV,UAAU;EACV,MAAM;EACN,aAAa;EACd;CAED,QAAQ;EACN,QAAQ;EACR,QAAQ;GACN;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,aAAa;IACb,YAAY;IACb;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,aAAa;IACb,cAAc;IACf;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,aAAa;IACb,cAAc;IACd,UAAU;IACX;GACF;EACF;CAED,MAAM,QAAQ,QAAQ,SAAS;EAC7B,MAAM,EAAE,OAAO,cAAc,YAAY;EAEzC,IAAI,aAAa,QAAQ;AACzB,MAAI,CAAC,cAAc,QAAQ,WAAW,cACpC,cAAa,MAAM,QAAQ,UAAU,cAAc,aAAa;AAElE,MAAI,CAAC,WACH,QAAO;GAAE,SAAS;GAAO,OAAO,uCAAuC;GAAgB;EAGzF,MAAM,SAAS,WAAW;AAC1B,MACE,OAAO,WAAW,YAClB,WAAW,QACX,EAAE,sBAAsB,WACxB,OAAO,OAAO,qBAAqB,SAEnC,QAAO;GAAE,SAAS;GAAO,OAAO;GAA0D;AAG5F,UAAQ,OAAO,MAAM,0BAA0B,EAC7C,OAAO,MAAM,UAAU,GAAG,IAAI,IAAI,MAAM,SAAS,MAAM,MAAM,KAC9D,CAAC;EAEF,MAAM,SACJ,OAAO,QAAQ,OACX,EAAE,oBAAoB,OAAO,GAC7B,OAAO,OAAO,QAAQ,WACnB,OAAO,MACR,KAAA;EAER,MAAM,OAAA,GAAA,SAAA,SAAY,OAAO,kBAAkB;GACzC,KAAK;GACL,KAAK;GACL,cAAc,WAAW;GAC1B,CAAC;AAEF,MAAI;GACF,MAAM,SAAS,MAAM,IAAI,OAAO,MAAM;GACtC,MAAM,OAAO,MAAM,QAAQ,OAAO,GAAG,SAAS,EAAE;GAChD,MAAM,UAAU,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,GAAG,GAAG,EAAE;AAE3D,UAAO;IACL,SAAS;IACT,QAAQ;KAAE;KAAM;KAAS,UAAU,KAAK;KAAQ;IAChD,UAAU;KAAE,UAAU,KAAK;KAAQ;KAAS;IAC7C;WACM,OAAO;AAEd,UAAO;IAAE,SAAS;IAAO,OAAO,qBADpB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IACN;YACpD;AACR,SAAM,IAAI,KAAK,CAAC,YAAY,GAE1B;;;CAGP,CAAC"}

package/dist/actions/postgres/execute-query.d.cts

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

package/dist/actions/postgres/execute-query.d.ts

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

package/dist/actions/postgres/execute-query.js

@@ -0,0 +1,110 @@
+import { defineAction } from "../define-action.js";
+import { POSTGRES_PROVIDER } from "../providers.js";
+import { z } from "zod/v4";
+import postgres from "postgres";
+const postgresExecuteQueryAction = defineAction({
+	id: "postgres.execute_query",
+	name: "Execute Query",
+	description: "Run an arbitrary SQL query (SELECT, INSERT, UPDATE, DELETE, etc.) against a PostgreSQL database and return the results.",
+	provider: POSTGRES_PROVIDER,
+	actionCategory: "read",
+	tags: [
+		"postgres",
+		"postgresql",
+		"sql",
+		"database",
+		"query",
+		"select",
+		"insert",
+		"update",
+		"delete",
+		"db"
+	],
+	credential: {
+		required: true,
+		type: "database",
+		description: "PostgreSQL database connection credential"
+	},
+	params: {
+		schema: z.object({
+			credentialId: z.string().min(1, "Database credential is required"),
+			query: z.string().min(1, "SQL query is required"),
+			timeout: z.number().int().positive().optional()
+		}),
+		fields: [
+			{
+				name: "credentialId",
+				label: "Database Credential",
+				type: "text",
+				required: true,
+				description: "Select a PostgreSQL database connection credential",
+				aiProvided: false
+			},
+			{
+				name: "query",
+				label: "SQL Query",
+				type: "code",
+				required: true,
+				description: "SQL statement to execute. Supports Nunjucks templates for dynamic values.",
+				defaultValue: "SELECT * FROM users LIMIT 10"
+			},
+			{
+				name: "timeout",
+				label: "Timeout (seconds)",
+				type: "number",
+				description: "Query timeout in seconds. Defaults to 30.",
+				defaultValue: 30,
+				extended: true
+			}
+		]
+	},
+	async execute(params, context) {
+		const { query, credentialId, timeout } = params;
+		let credential = context.credential;
+		if (!credential && context.functions?.getCredential) credential = await context.functions.getCredential(credentialId);
+		if (!credential) return {
+			success: false,
+			error: `Failed to load database credential: ${credentialId}`
+		};
+		const config = credential.config;
+		if (typeof config !== "object" || config === null || !("connectionString" in config) || typeof config.connectionString !== "string") return {
+			success: false,
+			error: "Invalid database credential — missing connectionString"
+		};
+		context.logger.debug("postgres.execute_query", { query: query.substring(0, 120) + (query.length > 120 ? "…" : "") });
+		const sslOpt = config.ssl === true ? { rejectUnauthorized: false } : typeof config.ssl === "object" ? config.ssl : void 0;
+		const sql = postgres(config.connectionString, {
+			ssl: sslOpt,
+			max: 1,
+			idle_timeout: timeout ?? 30
+		});
+		try {
+			const result = await sql.unsafe(query);
+			const data = Array.isArray(result) ? result : [];
+			const columns = data.length > 0 ? Object.keys(data[0]) : [];
+			return {
+				success: true,
+				output: {
+					data,
+					columns,
+					rowCount: data.length
+				},
+				metadata: {
+					rowCount: data.length,
+					columns
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				error: `SQL query failed: ${error instanceof Error ? error.message : String(error)}`
+			};
+		} finally {
+			await sql.end().catch(() => {});
+		}
+	}
+});
+//#endregion
+export { postgresExecuteQueryAction };
+
+//# sourceMappingURL=execute-query.js.map

package/dist/actions/postgres/execute-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-query.js","names":["pgLib"],"sources":["../../../src/actions/postgres/execute-query.ts"],"sourcesContent":["/**\n * postgres.execute_query — Execute a raw SQL query\n *\n * Runs an arbitrary SQL statement against a PostgreSQL database and\n * returns the resulting rows. Supports Nunjucks templating in the query.\n */\n\nimport { defineAction } from '../define-action';\nimport { POSTGRES_PROVIDER } from '../providers';\nimport { z } from 'zod/v4';\nimport pgLib from 'postgres';\n\nconst paramsSchema = z.object({\n  credentialId: z.string().min(1, 'Database credential is required'),\n  query: z.string().min(1, 'SQL query is required'),\n  timeout: z.number().int().positive().optional(),\n});\n\nexport const postgresExecuteQueryAction = defineAction({\n  id: 'postgres.execute_query',\n  name: 'Execute Query',\n  description:\n    'Run an arbitrary SQL query (SELECT, INSERT, UPDATE, DELETE, etc.) against a PostgreSQL database and return the results.',\n  provider: POSTGRES_PROVIDER,\n  actionCategory: 'read',\n  tags: [\n    'postgres',\n    'postgresql',\n    'sql',\n    'database',\n    'query',\n    'select',\n    'insert',\n    'update',\n    'delete',\n    'db',\n  ],\n\n  credential: {\n    required: true,\n    type: 'database',\n    description: 'PostgreSQL database connection credential',\n  },\n\n  params: {\n    schema: paramsSchema,\n    fields: [\n      {\n        name: 'credentialId',\n        label: 'Database Credential',\n        type: 'text',\n        required: true,\n        description: 'Select a PostgreSQL database connection credential',\n        aiProvided: false,\n      },\n      {\n        name: 'query',\n        label: 'SQL Query',\n        type: 'code',\n        required: true,\n        description: 'SQL statement to execute. Supports Nunjucks templates for dynamic values.',\n        defaultValue: 'SELECT * FROM users LIMIT 10',\n      },\n      {\n        name: 'timeout',\n        label: 'Timeout (seconds)',\n        type: 'number',\n        description: 'Query timeout in seconds. Defaults to 30.',\n        defaultValue: 30,\n        extended: true,\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    const { query, credentialId, timeout } = params;\n\n    let credential = context.credential;\n    if (!credential && context.functions?.getCredential) {\n      credential = await context.functions.getCredential(credentialId);\n    }\n    if (!credential) {\n      return { success: false, error: `Failed to load database credential: ${credentialId}` };\n    }\n\n    const config = credential.config;\n    if (\n      typeof config !== 'object' ||\n      config === null ||\n      !('connectionString' in config) ||\n      typeof config.connectionString !== 'string'\n    ) {\n      return { success: false, error: 'Invalid database credential — missing connectionString' };\n    }\n\n    context.logger.debug('postgres.execute_query', {\n      query: query.substring(0, 120) + (query.length > 120 ? '…' : ''),\n    });\n\n    const sslOpt =\n      config.ssl === true\n        ? { rejectUnauthorized: false }\n        : typeof config.ssl === 'object'\n          ? (config.ssl as { rejectUnauthorized?: boolean })\n          : undefined;\n\n    const sql = pgLib(config.connectionString, {\n      ssl: sslOpt,\n      max: 1,\n      idle_timeout: timeout ?? 30,\n    });\n\n    try {\n      const result = await sql.unsafe(query);\n      const data = Array.isArray(result) ? result : [];\n      const columns = data.length > 0 ? Object.keys(data[0]) : [];\n\n      return {\n        success: true,\n        output: { data, columns, rowCount: data.length },\n        metadata: { rowCount: data.length, columns },\n      };\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      return { success: false, error: `SQL query failed: ${msg}` };\n    } finally {\n      await sql.end().catch(() => {\n        /* connection cleanup */\n      });\n    }\n  },\n});\n"],"mappings":";;;;AAkBA,MAAa,6BAA6B,aAAa;CACrD,IAAI;CACJ,MAAM;CACN,aACE;CACF,UAAU;CACV,gBAAgB;CAChB,MAAM;EACJ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CAED,YAAY;EACV,UAAU;EACV,MAAM;EACN,aAAa;EACd;CAED,QAAQ;EACN,QAjCiB,EAAE,OAAO;GAC5B,cAAc,EAAE,QAAQ,CAAC,IAAI,GAAG,kCAAkC;GAClE,OAAO,EAAE,QAAQ,CAAC,IAAI,GAAG,wBAAwB;GACjD,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU;GAChD,CAAC;EA8BE,QAAQ;GACN;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,aAAa;IACb,YAAY;IACb;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,aAAa;IACb,cAAc;IACf;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,aAAa;IACb,cAAc;IACd,UAAU;IACX;GACF;EACF;CAED,MAAM,QAAQ,QAAQ,SAAS;EAC7B,MAAM,EAAE,OAAO,cAAc,YAAY;EAEzC,IAAI,aAAa,QAAQ;AACzB,MAAI,CAAC,cAAc,QAAQ,WAAW,cACpC,cAAa,MAAM,QAAQ,UAAU,cAAc,aAAa;AAElE,MAAI,CAAC,WACH,QAAO;GAAE,SAAS;GAAO,OAAO,uCAAuC;GAAgB;EAGzF,MAAM,SAAS,WAAW;AAC1B,MACE,OAAO,WAAW,YAClB,WAAW,QACX,EAAE,sBAAsB,WACxB,OAAO,OAAO,qBAAqB,SAEnC,QAAO;GAAE,SAAS;GAAO,OAAO;GAA0D;AAG5F,UAAQ,OAAO,MAAM,0BAA0B,EAC7C,OAAO,MAAM,UAAU,GAAG,IAAI,IAAI,MAAM,SAAS,MAAM,MAAM,KAC9D,CAAC;EAEF,MAAM,SACJ,OAAO,QAAQ,OACX,EAAE,oBAAoB,OAAO,GAC7B,OAAO,OAAO,QAAQ,WACnB,OAAO,MACR,KAAA;EAER,MAAM,MAAMA,SAAM,OAAO,kBAAkB;GACzC,KAAK;GACL,KAAK;GACL,cAAc,WAAW;GAC1B,CAAC;AAEF,MAAI;GACF,MAAM,SAAS,MAAM,IAAI,OAAO,MAAM;GACtC,MAAM,OAAO,MAAM,QAAQ,OAAO,GAAG,SAAS,EAAE;GAChD,MAAM,UAAU,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,GAAG,GAAG,EAAE;AAE3D,UAAO;IACL,SAAS;IACT,QAAQ;KAAE;KAAM;KAAS,UAAU,KAAK;KAAQ;IAChD,UAAU;KAAE,UAAU,KAAK;KAAQ;KAAS;IAC7C;WACM,OAAO;AAEd,UAAO;IAAE,SAAS;IAAO,OAAO,qBADpB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IACN;YACpD;AACR,SAAM,IAAI,KAAK,CAAC,YAAY,GAE1B;;;CAGP,CAAC"}

package/dist/actions/postgres/index.cjs

@@ -0,0 +1,16 @@
+const require_execute_query = require("./execute-query.cjs");
+const require_list_tables = require("./list-tables.cjs");
+const require_describe_table = require("./describe-table.cjs");
+const require_insert_rows = require("./insert-rows.cjs");
+//#region src/actions/postgres/index.ts
+/** All Postgres actions as an array (for bulk registration). */
+const postgresActions = [
+	require_execute_query.postgresExecuteQueryAction,
+	require_list_tables.postgresListTablesAction,
+	require_describe_table.postgresDescribeTableAction,
+	require_insert_rows.postgresInsertRowsAction
+];
+//#endregion
+exports.postgresActions = postgresActions;
+
+//# sourceMappingURL=index.cjs.map