uranio 1.0.8 → 1.1.0

package/.uranio/package-lock.json

@@ -10,10 +10,12 @@
         "@aws-sdk/util-dynamodb": "^3.995.0",
         "mongodb": "^7.1.0",
         "mysql2": "^3.17.5",
-        "uranio": "1.0.6"
+        "pg": "^8.18.0",
+        "uranio": "1.0.8"
       },
       "devDependencies": {
         "@types/node": "^25.3.0",
+        "@types/pg": "^8.16.0",
         "dotenv": "^16.3.1",
         "eslint": "^10.0.1",
         "eslint-config-prettier": "^10.1.8",
@@ -2355,6 +2357,18 @@
         "undici-types": "~7.18.0"
       }
     },
+    "node_modules/@types/pg": {
+      "version": "8.16.0",
+      "resolved": "https://registry.npmjs.org/@types/pg/-/pg-8.16.0.tgz",
+      "integrity": "sha512-RmhMd/wD+CF8Dfo+cVIy3RR5cl8CyfXQ0tGgW6XBL8L4LM/UTEbNXYRbLwU6w+CgrKBNbrQWt4FUtTfaU5jSYQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*",
+        "pg-protocol": "*",
+        "pg-types": "^2.2.0"
+      }
+    },
     "node_modules/@types/webidl-conversions": {
       "version": "7.0.3",
       "resolved": "https://registry.npmjs.org/@types/webidl-conversions/-/webidl-conversions-7.0.3.tgz",
@@ -2435,15 +2449,6 @@
         "url": "https://github.com/chalk/ansi-styles?sponsor=1"
       }
     },
-    "node_modules/app-root-path": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/app-root-path/-/app-root-path-3.1.0.tgz",
-      "integrity": "sha512-biN3PwB2gUtjaYy/isrU3aNWI5w+fAfvHkSvCKeQGxhmYpwKFUxudR3Yya+KqVRHBmEDYh+/lTozYCFbmzX4nA==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 6.0.0"
-      }
-    },
     "node_modules/aws-ssl-profiles": {
       "version": "1.1.2",
       "resolved": "https://registry.npmjs.org/aws-ssl-profiles/-/aws-ssl-profiles-1.1.2.tgz",
@@ -3072,6 +3077,18 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/find-up-simple": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/find-up-simple/-/find-up-simple-1.0.1.tgz",
+      "integrity": "sha512-afd4O7zpqHeRyg4PfDQsXmlDe2PfdHtJt6Akt8jOWaApLOZk5JXs6VMR29lz03pRe9mpykrRCYIYxaJYcfpncQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/flat-cache": {
       "version": "4.0.1",
       "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz",
@@ -3725,6 +3742,111 @@
         "through": "~2.3"
       }
     },
+    "node_modules/pg": {
+      "version": "8.18.0",
+      "resolved": "https://registry.npmjs.org/pg/-/pg-8.18.0.tgz",
+      "integrity": "sha512-xqrUDL1b9MbkydY/s+VZ6v+xiMUmOUk7SS9d/1kpyQxoJ6U9AO1oIJyUWVZojbfe5Cc/oluutcgFG4L9RDP1iQ==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "pg-connection-string": "^2.11.0",
+        "pg-pool": "^3.11.0",
+        "pg-protocol": "^1.11.0",
+        "pg-types": "2.2.0",
+        "pgpass": "1.0.5"
+      },
+      "engines": {
+        "node": ">= 16.0.0"
+      },
+      "optionalDependencies": {
+        "pg-cloudflare": "^1.3.0"
+      },
+      "peerDependencies": {
+        "pg-native": ">=3.0.1"
+      },
+      "peerDependenciesMeta": {
+        "pg-native": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/pg-cloudflare": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/pg-cloudflare/-/pg-cloudflare-1.3.0.tgz",
+      "integrity": "sha512-6lswVVSztmHiRtD6I8hw4qP/nDm1EJbKMRhf3HCYaqud7frGysPv7FYJ5noZQdhQtN2xJnimfMtvQq21pdbzyQ==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/pg-connection-string": {
+      "version": "2.11.0",
+      "resolved": "https://registry.npmjs.org/pg-connection-string/-/pg-connection-string-2.11.0.tgz",
+      "integrity": "sha512-kecgoJwhOpxYU21rZjULrmrBJ698U2RxXofKVzOn5UDj61BPj/qMb7diYUR1nLScCDbrztQFl1TaQZT0t1EtzQ==",
+      "license": "MIT"
+    },
+    "node_modules/pg-int8": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/pg-int8/-/pg-int8-1.0.1.tgz",
+      "integrity": "sha512-WCtabS6t3c8SkpDBUlb1kjOs7l66xsGdKpIPZsg4wR+B3+u9UAum2odSsF9tnvxg80h4ZxLWMy4pRjOsFIqQpw==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/pg-pool": {
+      "version": "3.11.0",
+      "resolved": "https://registry.npmjs.org/pg-pool/-/pg-pool-3.11.0.tgz",
+      "integrity": "sha512-MJYfvHwtGp870aeusDh+hg9apvOe2zmpZJpyt+BMtzUWlVqbhFmMK6bOBXLBUPd7iRtIF9fZplDc7KrPN3PN7w==",
+      "license": "MIT",
+      "peerDependencies": {
+        "pg": ">=8.0"
+      }
+    },
+    "node_modules/pg-protocol": {
+      "version": "1.11.0",
+      "resolved": "https://registry.npmjs.org/pg-protocol/-/pg-protocol-1.11.0.tgz",
+      "integrity": "sha512-pfsxk2M9M3BuGgDOfuy37VNRRX3jmKgMjcvAcWqNDpZSf4cUmv8HSOl5ViRQFsfARFn0KuUQTgLxVMbNq5NW3g==",
+      "license": "MIT"
+    },
+    "node_modules/pg-types": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/pg-types/-/pg-types-2.2.0.tgz",
+      "integrity": "sha512-qTAAlrEsl8s4OiEQY69wDvcMIdQN6wdz5ojQiOy6YRMuynxenON0O5oCpJI6lshc6scgAY8qvJ2On/p+CXY0GA==",
+      "license": "MIT",
+      "dependencies": {
+        "pg-int8": "1.0.1",
+        "postgres-array": "~2.0.0",
+        "postgres-bytea": "~1.0.0",
+        "postgres-date": "~1.0.4",
+        "postgres-interval": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/pgpass": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/pgpass/-/pgpass-1.0.5.tgz",
+      "integrity": "sha512-FdW9r/jQZhSeohs1Z3sI1yxFQNFvMcnmfuj4WBMUTxOrAyLMaTcE1aAMBiTlbMNaXvBCQuVi0R7hd8udDSP7ug==",
+      "license": "MIT",
+      "dependencies": {
+        "split2": "^4.1.0"
+      }
+    },
+    "node_modules/pkg-dir": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-8.0.0.tgz",
+      "integrity": "sha512-4peoBq4Wks0riS0z8741NVv+/8IiTvqnZAr8QGgtdifrtpdXbNw/FxRS1l6NFqm4EMzuS0EDqNNx4XGaz8cuyQ==",
+      "license": "MIT",
+      "dependencies": {
+        "find-up-simple": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/plutonio": {
       "version": "0.7.7",
       "resolved": "https://registry.npmjs.org/plutonio/-/plutonio-0.7.7.tgz",
@@ -3735,6 +3857,45 @@
         "typescript": "^5.9.3"
       }
     },
+    "node_modules/postgres-array": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/postgres-array/-/postgres-array-2.0.0.tgz",
+      "integrity": "sha512-VpZrUqU5A69eQyW2c5CA1jtLecCsN2U/bD6VilrFDWq5+5UIEVO7nazS3TEcHf1zuPYO/sqGvUvW62g86RXZuA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/postgres-bytea": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/postgres-bytea/-/postgres-bytea-1.0.1.tgz",
+      "integrity": "sha512-5+5HqXnsZPE65IJZSMkZtURARZelel2oXUEO8rH83VS/hxH5vv1uHquPg5wZs8yMAfdv971IU+kcPUczi7NVBQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/postgres-date": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/postgres-date/-/postgres-date-1.0.7.tgz",
+      "integrity": "sha512-suDmjLVQg78nMK2UZ454hAG+OAW+HQPZ6n++TNDUX+L0+uUlLywnoxJKDou51Zm+zTCjrCl0Nq6J9C5hP9vK/Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/postgres-interval": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/postgres-interval/-/postgres-interval-1.2.0.tgz",
+      "integrity": "sha512-9ZhXKM/rw350N1ovuWHbGxnGh/SNJ4cnxHiM0rxE4VN41wsg8P8zWn9hv/buK00RP4WvlOyr/RBDiptyxVbkZQ==",
+      "license": "MIT",
+      "dependencies": {
+        "xtend": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/prelude-ls": {
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz",
@@ -3967,6 +4128,15 @@
         "node": "*"
       }
     },
+    "node_modules/split2": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/split2/-/split2-4.2.0.tgz",
+      "integrity": "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==",
+      "license": "ISC",
+      "engines": {
+        "node": ">= 10.x"
+      }
+    },
     "node_modules/sql-escaper": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/sql-escaper/-/sql-escaper-1.3.3.tgz",
@@ -4148,14 +4318,14 @@
       "license": "MIT"
     },
     "node_modules/uranio": {
-      "version": "1.0.6",
-      "resolved": "https://registry.npmjs.org/uranio/-/uranio-1.0.6.tgz",
-      "integrity": "sha512-6cZNiGmAawnIkLWlxgymAVt/3QkrAyVsKRX3TUZHBwyfeAx+kohnnAAEpoFuZTuhNWeRmv1osQsMKX0AmJPeog==",
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/uranio/-/uranio-1.0.8.tgz",
+      "integrity": "sha512-S6kU0AEensbEO5Zn+cFS8lDwdD8f+r7Z5kKmDBLr2zV9kf3o+e+haQugIlVnlQsyJD41Zx6CEUFpkJg4v1vJ7g==",
       "license": "UNLICENSED",
       "dependencies": {
-        "app-root-path": "^3.1.0",
         "i0n": "^0.9.0",
         "inquirer": "^13.3.0",
+        "pkg-dir": "^8.0.0",
         "plutonio": "^0.7.7",
         "r4y": "^0.9.0",
         "yaml": "^2.8.2"
@@ -4305,6 +4475,15 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/xtend": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz",
+      "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.4"
+      }
+    },
     "node_modules/yaml": {
       "version": "2.8.2",
       "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.8.2.tgz",

package/.uranio/package.json

@@ -11,6 +11,7 @@
   },
   "devDependencies": {
     "@types/node": "^25.3.0",
+    "@types/pg": "^8.16.0",
     "dotenv": "^16.3.1",
     "eslint": "^10.0.1",
     "eslint-config-prettier": "^10.1.8",
@@ -26,6 +27,7 @@
     "@aws-sdk/util-dynamodb": "^3.995.0",
     "mongodb": "^7.1.0",
     "mysql2": "^3.17.5",
-    "uranio": "1.0.8"
+    "pg": "^8.18.0",
+    "uranio": "1.1.0"
   }
 }

package/.uranio/src/atom/postgresql.ts

@@ -0,0 +1,109 @@
+/**
+ *
+ * PostgreSQL Atom client module
+ *
+ */
+
+
+import {PostgreSQLClient} from '../client/postgresql';
+import * as sql from '../sql/index';
+
+import * as atom_types from '../types/atom';
+import * as where_types from '../types/where';
+import * as sql_types from '../types/sql';
+
+export class PostgreSQLAtomClient<S extends atom_types.postgresql_atom> {
+
+  constructor(
+    public client: PostgreSQLClient,
+    public name: string
+  ) {}
+
+  public async getAtom(where: where_types.Where<S>): Promise<S | null> {
+    const {query, map} = sql.param.compose_select({
+      table: this.name,
+      where,
+      limit: '1',
+    });
+    const [rows] = await this.client.exe(query, map);
+    if (Array.isArray(rows) && rows[0]) {
+      return rows[0] as S;
+    }
+    return null;
+  }
+
+  public async getAtoms({
+    where,
+    order,
+    limit,
+  }: {
+    where?: where_types.Where<S>;
+    order?: sql_types.OrderBy;
+    limit?: string;
+  }): Promise<S[]> {
+    const {query, map} = sql.param.compose_select({
+      table: this.name,
+      where,
+      order,
+      limit,
+    });
+    const [rows] = await this.client.exe(query, map);
+    if (Array.isArray(rows)) {
+      return rows as S[];
+    }
+    return [];
+  }
+
+  public async putAtom(shape: Partial<S>): Promise<any> {
+    const columns:(keyof S)[] = [];
+    for(const [key, _] of Object.entries(shape)){
+      columns.push(key as keyof S);
+    }
+    const {query, query_records} = sql.param.compose_insert({
+      table: this.name,
+      columns,
+      records: [shape]
+    });
+    const response = await this.client.exe(query, query_records);
+    return response;
+  }
+
+  public async putAtoms(shapes: Partial<S>[]): Promise<any> {
+    const columns:(keyof S)[] = [];
+    if(!Array.isArray(shapes) || shapes.length < 1 || !shapes[0]){
+      return null;
+    }
+    for(const [key, _] of Object.entries(shapes[0])){
+      columns.push(key as keyof S);
+    }
+    const {query, query_records} = sql.param.compose_insert({
+      table: this.name,
+      columns,
+      records: shapes
+    });
+    const response = await this.client.exe(query, query_records);
+    return response;
+  }
+
+  public async updateAtoms(
+    atom: Partial<S>,
+    where?: where_types.Where<S>,
+  ): Promise<any> {
+    const {query, map} = sql.param.compose_update({
+      table: this.name,
+      where,
+      update: atom
+    });
+    const response = await this.client.exe(query, map);
+    return response;
+  }
+
+  public async deleteAtoms(where: where_types.Where<S>): Promise<any> {
+    const {query, map} = sql.param.compose_delete({
+      table: this.name,
+      where,
+    });
+    const response = await this.client.exe(query, map);
+    return response;
+  }
+}

package/.uranio/src/client/postgresql.ts

@@ -0,0 +1,106 @@
+/**
+ *
+ * PostgreSQL Client module
+ *
+ * @packageDocumentation
+ *
+ */
+
+import {Pool, PoolClient} from 'pg';
+import {log} from '../log/index';
+
+export type PostgreSQLClientParams = {
+  uri: string;
+  usePool?: boolean;
+};
+
+export class PostgreSQLClient {
+  public pool?: Pool;
+  public mainConnection: PoolClient | undefined;
+  protected uri: string;
+  constructor(params: PostgreSQLClientParams) {
+    this.uri = params.uri;
+    if (params.usePool === true) {
+      this.pool = new Pool({
+        connectionString: params.uri,
+      });
+    }
+  }
+  public async exe(sql: string, values?: any) {
+    // Convert named parameters object to positional parameters array
+    const {query, paramValues} = this._convert_named_to_positional(sql, values);
+    const with_values =
+      typeof paramValues !== 'undefined' && paramValues.length > 0
+        ? ` with values [${paramValues}]`
+        : '';
+    log.trace(`Excuting query '${query}'${with_values}`);
+    if (this.pool) {
+      return await this._execute_from_pool_connection(query, paramValues);
+    }
+    if (!this.mainConnection) {
+      await this.connect();
+    }
+    const result = await this.mainConnection!.query(query, paramValues);
+    return [result.rows, result.fields];
+  }
+  public async connect() {
+    log.trace(`Connecting to PostgreSQL database...`);
+    if (!this.pool) {
+      this.pool = new Pool({
+        connectionString: this.uri,
+      });
+    }
+    this.mainConnection = await this.pool.connect();
+    log.debug(`Connected to PostgreSQL database`);
+  }
+  public async disconnect() {
+    log.trace(`Disconnecting from PostgreSQL database...`);
+    if (this.mainConnection) {
+      this.mainConnection.release();
+      this.mainConnection = undefined;
+    }
+    if (this.pool) {
+      await this.pool.end();
+    }
+    log.debug(`Disconnected from PostgreSQL database`);
+  }
+  private async _execute_from_pool_connection(sql: string, values?: any[]) {
+    if (!this.pool) {
+      throw new Error(`Pool was not initialized`);
+    }
+    log.trace(`Retrieving pool connection...`);
+    const pool_connection = await this.pool.connect();
+    log.trace(`Retrieved pool connection`);
+    const result = await pool_connection.query(sql, values);
+    log.trace(`Releasing pool connection...`);
+    pool_connection.release();
+    log.trace(`Released pool connection`);
+    return [result.rows, result.fields];
+  }
+  private _convert_named_to_positional(
+    sql: string,
+    namedParams?: Record<string, any>
+  ): {query: string; paramValues: any[]} {
+    if (!namedParams || Object.keys(namedParams).length === 0) {
+      return {query: sql, paramValues: []};
+    }
+    // Sort keys to ensure consistent ordering
+    const sortedKeys = Object.keys(namedParams).sort();
+    let paramIndex = 1;
+    let convertedQuery = sql;
+    const paramValues: any[] = [];
+
+    // Replace each :paramName with $1, $2, etc.
+    for (const key of sortedKeys) {
+      const namedParam = `:${key}`;
+      // Replace all occurrences of this named parameter
+      while (convertedQuery.includes(namedParam)) {
+        convertedQuery = convertedQuery.replace(namedParam, `$${paramIndex}`);
+      }
+      paramValues.push(namedParams[key]);
+      paramIndex++;
+    }
+
+    return {query: convertedQuery, paramValues};
+  }
+}

package/.uranio/src/client.ts

@@ -9,6 +9,7 @@
 import {MongoDBClient, MongoDBClientParams} from './client/mongodb';
 import {MySQLClient, MySQLClientParams} from './client/mysql';
 import {DynamoDBClient, DynamoDBClientParams} from './client/dynamodb';
+import {PostgreSQLClient, PostgreSQLClientParams} from './client/postgresql';
 
 export class UranioMongoDBClient extends MongoDBClient {
   constructor(params: MongoDBClientParams) {
@@ -27,3 +28,10 @@ export class UranioDynamoDBClient extends DynamoDBClient {
     super(params);
   }
 }
+
+export class UranioPostgreSQLClient extends PostgreSQLClient {
+  constructor(params: PostgreSQLClientParams) {
+    super(params);
+  }
+}
+

package/.uranio/src/index.ts

@@ -16,3 +16,6 @@ export {MySQLClient};
 
 import {UranioDynamoDBClient as DynamoDBClient} from './client';
 export {DynamoDBClient};
+
+import {UranioPostgreSQLClient as PostgreSQLClient} from './client';
+export {PostgreSQLClient};

package/.uranio/src/types/atom.ts

@@ -19,3 +19,6 @@ export interface mongodb_atom extends atom {
 }
 
 export interface dynamodb_atom extends atom {}
+
+export interface postgresql_atom extends atom {}
+