@voltagent/core 1.2.18 → 1.2.19

package/dist/index.d.mts

@@ -1986,6 +1986,15 @@ type VoltOpsDiscordCredential = VoltOpsStoredCredentialRef | WithCredentialMetad
 }> | WithCredentialMetadata<{
     webhookUrl: string;
 }>;
+type VoltOpsPostgresCredential = VoltOpsStoredCredentialRef | WithCredentialMetadata<{
+    host: string;
+    port?: number;
+    user: string;
+    password: string;
+    database: string;
+    ssl?: boolean;
+    rejectUnauthorized?: boolean;
+}>;
 type VoltOpsGmailCredential = VoltOpsStoredCredentialRef | WithCredentialMetadata<{
     accessToken?: string;
     refreshToken?: string;
@@ -2176,6 +2185,22 @@ interface VoltOpsDiscordMemberRoleParams extends VoltOpsDiscordBaseParams {
     userId: string;
     roleId: string;
 }
+interface VoltOpsPostgresBaseParams {
+    credential: VoltOpsPostgresCredential;
+    actionId?: string;
+    catalogId?: string;
+    projectId?: string | null;
+}
+interface VoltOpsPostgresExecuteParams extends VoltOpsPostgresBaseParams {
+    query: string;
+    parameters?: unknown[];
+    applicationName?: string;
+    statementTimeoutMs?: number;
+    connectionTimeoutMs?: number;
+    ssl?: {
+        rejectUnauthorized?: boolean;
+    };
+}
 interface VoltOpsGmailBaseParams {
     credential: VoltOpsGmailCredential;
     actionId?: string;
@@ -2258,6 +2283,9 @@ type VoltOpsActionsApi = {
         getEmail: (params: VoltOpsGmailGetEmailParams) => Promise<VoltOpsActionExecutionResult>;
         getThread: (params: VoltOpsGmailGetThreadParams) => Promise<VoltOpsActionExecutionResult>;
     };
+    postgres: {
+        executeQuery: (params: VoltOpsPostgresExecuteParams) => Promise<VoltOpsActionExecutionResult>;
+    };
 };
 interface VoltOpsEvalsApi {
     runs: {
@@ -2702,6 +2730,9 @@ declare class VoltOpsActionsClient {
         getEmail: (params: VoltOpsGmailGetEmailParams) => Promise<VoltOpsActionExecutionResult>;
         getThread: (params: VoltOpsGmailGetThreadParams) => Promise<VoltOpsActionExecutionResult>;
     };
+    readonly postgres: {
+        executeQuery: (params: VoltOpsPostgresExecuteParams) => Promise<VoltOpsActionExecutionResult>;
+    };
     constructor(transport: VoltOpsActionsTransport, options?: {
         useProjectEndpoint?: boolean;
     });
@@ -2722,6 +2753,7 @@ declare class VoltOpsActionsClient {
     private searchGmailEmails;
     private getGmailEmail;
     private getGmailThread;
+    private executePostgresQuery;
     private sendDiscordMessage;
     private sendDiscordWebhookMessage;
     private deleteDiscordMessage;
@@ -2749,6 +2781,7 @@ declare class VoltOpsActionsClient {
     private ensureSlackCredential;
     private ensureDiscordCredential;
     private ensureGmailCredential;
+    private ensurePostgresCredential;
     private normalizeCredentialMetadata;
     private normalizeIdentifier;
     private ensureRecord;

package/dist/index.d.ts

@@ -1986,6 +1986,15 @@ type VoltOpsDiscordCredential = VoltOpsStoredCredentialRef | WithCredentialMetad
 }> | WithCredentialMetadata<{
     webhookUrl: string;
 }>;
+type VoltOpsPostgresCredential = VoltOpsStoredCredentialRef | WithCredentialMetadata<{
+    host: string;
+    port?: number;
+    user: string;
+    password: string;
+    database: string;
+    ssl?: boolean;
+    rejectUnauthorized?: boolean;
+}>;
 type VoltOpsGmailCredential = VoltOpsStoredCredentialRef | WithCredentialMetadata<{
     accessToken?: string;
     refreshToken?: string;
@@ -2176,6 +2185,22 @@ interface VoltOpsDiscordMemberRoleParams extends VoltOpsDiscordBaseParams {
     userId: string;
     roleId: string;
 }
+interface VoltOpsPostgresBaseParams {
+    credential: VoltOpsPostgresCredential;
+    actionId?: string;
+    catalogId?: string;
+    projectId?: string | null;
+}
+interface VoltOpsPostgresExecuteParams extends VoltOpsPostgresBaseParams {
+    query: string;
+    parameters?: unknown[];
+    applicationName?: string;
+    statementTimeoutMs?: number;
+    connectionTimeoutMs?: number;
+    ssl?: {
+        rejectUnauthorized?: boolean;
+    };
+}
 interface VoltOpsGmailBaseParams {
     credential: VoltOpsGmailCredential;
     actionId?: string;
@@ -2258,6 +2283,9 @@ type VoltOpsActionsApi = {
         getEmail: (params: VoltOpsGmailGetEmailParams) => Promise<VoltOpsActionExecutionResult>;
         getThread: (params: VoltOpsGmailGetThreadParams) => Promise<VoltOpsActionExecutionResult>;
     };
+    postgres: {
+        executeQuery: (params: VoltOpsPostgresExecuteParams) => Promise<VoltOpsActionExecutionResult>;
+    };
 };
 interface VoltOpsEvalsApi {
     runs: {
@@ -2702,6 +2730,9 @@ declare class VoltOpsActionsClient {
         getEmail: (params: VoltOpsGmailGetEmailParams) => Promise<VoltOpsActionExecutionResult>;
         getThread: (params: VoltOpsGmailGetThreadParams) => Promise<VoltOpsActionExecutionResult>;
     };
+    readonly postgres: {
+        executeQuery: (params: VoltOpsPostgresExecuteParams) => Promise<VoltOpsActionExecutionResult>;
+    };
     constructor(transport: VoltOpsActionsTransport, options?: {
         useProjectEndpoint?: boolean;
     });
@@ -2722,6 +2753,7 @@ declare class VoltOpsActionsClient {
     private searchGmailEmails;
     private getGmailEmail;
     private getGmailThread;
+    private executePostgresQuery;
     private sendDiscordMessage;
     private sendDiscordWebhookMessage;
     private deleteDiscordMessage;
@@ -2749,6 +2781,7 @@ declare class VoltOpsActionsClient {
     private ensureSlackCredential;
     private ensureDiscordCredential;
     private ensureGmailCredential;
+    private ensurePostgresCredential;
     private normalizeCredentialMetadata;
     private normalizeIdentifier;
     private ensureRecord;

package/dist/index.js

@@ -8982,6 +8982,9 @@ var VoltOpsActionsClient = class {
       getEmail: this.getGmailEmail.bind(this),
       getThread: this.getGmailThread.bind(this)
     };
+    this.postgres = {
+      executeQuery: this.executePostgresQuery.bind(this)
+    };
   }
   static {
     __name(this, "VoltOpsActionsClient");
@@ -8990,6 +8993,7 @@ var VoltOpsActionsClient = class {
   slack;
   discord;
   gmail;
+  postgres;
   useProjectEndpoint;
   get actionExecutionPath() {
     return this.useProjectEndpoint ? "/actions/project/run" : "/actions/execute";
@@ -9453,6 +9457,60 @@ var VoltOpsActionsClient = class {
       input
     });
   }
+  async executePostgresQuery(params) {
+    if (!params || typeof params !== "object") {
+      throw new VoltOpsActionError("params must be provided", 400);
+    }
+    const credential = this.ensurePostgresCredential(params.credential);
+    const query = this.trimString(params.query);
+    if (!query) {
+      throw new VoltOpsActionError("query must be provided", 400);
+    }
+    const parameters = Array.isArray(params.parameters) ? params.parameters : [];
+    const applicationName = this.trimString(params.applicationName);
+    const statementTimeoutMs = this.normalizePositiveInteger(
+      params.statementTimeoutMs,
+      "statementTimeoutMs",
+      { allowZero: false }
+    );
+    const connectionTimeoutMs = this.normalizePositiveInteger(
+      params.connectionTimeoutMs,
+      "connectionTimeoutMs",
+      { allowZero: false }
+    );
+    const ssl = params.ssl && typeof params.ssl === "object" && !Array.isArray(params.ssl) ? {
+      rejectUnauthorized: typeof params.ssl.rejectUnauthorized === "boolean" ? params.ssl.rejectUnauthorized : void 0
+    } : void 0;
+    const input = {
+      query
+    };
+    if (parameters.length) {
+      input.parameters = parameters;
+    }
+    if (applicationName) {
+      input.applicationName = applicationName;
+    }
+    if (typeof statementTimeoutMs === "number") {
+      input.statementTimeoutMs = statementTimeoutMs;
+    }
+    if (typeof connectionTimeoutMs === "number") {
+      input.connectionTimeoutMs = connectionTimeoutMs;
+    }
+    if (ssl) {
+      input.ssl = ssl;
+    }
+    const payload = {
+      credential,
+      catalogId: params.catalogId ?? void 0,
+      actionId: params.actionId ?? "postgres.executeQuery",
+      projectId: params.projectId ?? void 0,
+      payload: {
+        input
+      }
+    };
+    const response = await this.postActionExecution(this.actionExecutionPath, payload);
+    return this.mapActionExecution(response);
+  }
   async sendDiscordMessage(params) {
     if (!params || typeof params !== "object") {
       throw new VoltOpsActionError("params must be provided", 400);
@@ -10052,6 +10110,51 @@ var VoltOpsActionsClient = class {
     }
     return payload;
   }
+  ensurePostgresCredential(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+      throw new VoltOpsActionError("credential must be an object", 400);
+    }
+    const record = value;
+    const metadata = this.normalizeCredentialMetadata(record.metadata);
+    const storedId = this.trimString(
+      typeof record.credentialId === "string" ? record.credentialId : typeof record.id === "string" ? record.id : void 0
+    );
+    if (storedId) {
+      return metadata ? { credentialId: storedId, metadata } : { credentialId: storedId };
+    }
+    const host = this.trimString(record.host);
+    const user = this.trimString(record.user);
+    const password = this.trimString(record.password);
+    const database = this.trimString(record.database);
+    if (!host || !user || !password || !database) {
+      throw new VoltOpsActionError(
+        "credential must include host, user, password, and database for Postgres actions",
+        400
+      );
+    }
+    const port = typeof record.port === "number" && Number.isFinite(record.port) ? Math.trunc(record.port) : void 0;
+    const ssl = typeof record.ssl === "boolean" ? record.ssl : void 0;
+    const rejectUnauthorized = typeof record.rejectUnauthorized === "boolean" ? record.rejectUnauthorized : void 0;
+    const payload = {
+      host,
+      user,
+      password,
+      database
+    };
+    if (port !== void 0) {
+      payload.port = port;
+    }
+    if (ssl !== void 0) {
+      payload.ssl = ssl;
+    }
+    if (rejectUnauthorized !== void 0) {
+      payload.rejectUnauthorized = rejectUnauthorized;
+    }
+    if (metadata) {
+      payload.metadata = metadata;
+    }
+    return payload;
+  }
   normalizeCredentialMetadata(metadata) {
     if (metadata === void 0 || metadata === null) {
       return void 0;
@@ -10116,7 +10219,7 @@ var VoltOpsActionsClient = class {
     }
     return entries.length > 0 ? entries : void 0;
   }
-  normalizePositiveInteger(value, field) {
+  normalizePositiveInteger(value, field, options) {
     if (value === void 0 || value === null) {
       return void 0;
     }
@@ -10124,8 +10227,9 @@ var VoltOpsActionsClient = class {
       throw new VoltOpsActionError(`${field} must be a finite number`, 400);
     }
     const normalized = Math.floor(value);
-    if (normalized <= 0) {
-      throw new VoltOpsActionError(`${field} must be greater than 0`, 400);
+    const allowZero = options?.allowZero ?? false;
+    if (normalized < 0 || !allowZero && normalized === 0) {
+      throw new VoltOpsActionError(`${field} must be greater than ${allowZero ? "-1" : "0"}`, 400);
     }
     return normalized;
   }