@hawiah/postgres 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 HAWIAH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# @hawiah/postgres [![NPM version](https://img.shields.io/npm/v/@hawiah/postgres.svg?style=flat-square&color=informational)](https://npmjs.com/package/@hawiah/postgres)
+
+PostgreSQL driver with schema-less JSONB storage for Node.js applications.
+
+## Installation
+
+```bash
+npm install @hawiah/postgres
+```
+
+## Features
+
+- Schema-less data storage using PostgreSQL JSONB
+- Connection pooling with node-postgres (pg)
+- Support for cloud providers (Neon, Supabase, etc.)
+- Transaction support
+- Unified IDriver interface
+- Automatic table creation and indexing
+- Raw SQL query execution support
+
+## License
+
+MIT

package/dist/drivers/PostgreSQLDriver.d.ts

@@ -0,0 +1,168 @@
+import { Pool, PoolClient, PoolConfig } from 'pg';
+import { IDriver, Query, Data } from '../interfaces/IDriver';
+/**
+ * PostgreSQL driver configuration options
+ */
+export interface PostgreSQLDriverOptions {
+    /**
+     * PostgreSQL connection string (recommended)
+     * Example: 'postgresql://user:password@host:port/database'
+     */
+    connectionString?: string;
+    /**
+     * Or individual connection parameters
+     */
+    host?: string;
+    port?: number;
+    user?: string;
+    password?: string;
+    database?: string;
+    /**
+     * Table name to use
+     */
+    tableName: string;
+    /**
+     * SSL configuration (required for cloud providers like Neon, Supabase)
+     */
+    ssl?: boolean | object;
+    /**
+     * Connection pool size (default: 10)
+     */
+    max?: number;
+    /**
+     * Additional PostgreSQL pool options
+     */
+    poolOptions?: PoolConfig;
+}
+/**
+ * Driver implementation for PostgreSQL using node-postgres.
+ * Provides a schema-less interface to PostgreSQL tables with JSONB storage.
+ */
+export declare class PostgreSQLDriver implements IDriver {
+    private pool;
+    private tableName;
+    private config;
+    /**
+     * Creates a new instance of PostgreSQLDriver
+     * @param options - PostgreSQL driver configuration options
+     */
+    constructor(options: PostgreSQLDriverOptions);
+    /**
+     * Connects to the PostgreSQL database.
+     * Creates the table if it doesn't exist.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnects from the PostgreSQL database.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Inserts a new record into the database.
+     * @param data - The data to insert
+     * @returns The inserted record with ID
+     */
+    set(data: Data): Promise<Data>;
+    /**
+     * Retrieves records matching the query.
+     * @param query - The query criteria
+     * @returns Array of matching records
+     */
+    get(query: Query): Promise<Data[]>;
+    /**
+     * Retrieves a single record matching the query.
+     * @param query - The query criteria
+     * @returns The first matching record or null
+     */
+    getOne(query: Query): Promise<Data | null>;
+    /**
+     * Updates records matching the query.
+     * @param query - The query criteria
+     * @param data - The data to update
+     * @returns The number of updated records
+     */
+    update(query: Query, data: Data): Promise<number>;
+    /**
+     * Deletes records matching the query.
+     * @param query - The query criteria
+     * @returns The number of deleted records
+     */
+    delete(query: Query): Promise<number>;
+    /**
+     * Checks if any record matches the query.
+     * @param query - The query criteria
+     * @returns True if a match exists, false otherwise
+     */
+    exists(query: Query): Promise<boolean>;
+    /**
+     * Counts records matching the query.
+     * @param query - The query criteria
+     * @returns The number of matching records
+     */
+    count(query: Query): Promise<number>;
+    /**
+     * Ensures the database is connected before executing operations.
+     * @throws Error if database is not connected
+     * @private
+     */
+    private ensureConnected;
+    /**
+     * Generates a unique ID for records.
+     * @returns A unique string ID
+     * @private
+     */
+    private generateId;
+    /**
+     * Checks if a record matches the query criteria.
+     * @param record - The record to check
+     * @param query - The query criteria
+     * @returns True if the record matches
+     * @private
+     */
+    private matchesQuery;
+    /**
+     * Gets the PostgreSQL connection pool.
+     * @returns The PostgreSQL connection pool
+     */
+    getPool(): Pool | null;
+    /**
+     * Executes a raw SQL query.
+     * WARNING: Use with caution. This bypasses the abstraction layer.
+     * @param sql - The SQL query to execute
+     * @param params - Optional parameters for the query
+     * @returns Query results
+     */
+    executeRaw(sql: string, params?: any[]): Promise<any>;
+    /**
+     * Clears all data from the table.
+     */
+    clear(): Promise<void>;
+    /**
+     * Drops the entire table.
+     * WARNING: This will permanently delete all data and indexes.
+     */
+    drop(): Promise<void>;
+    /**
+     * Vacuums the table for optimization.
+     */
+    vacuum(): Promise<void>;
+    /**
+     * Analyzes the table for query optimization.
+     */
+    analyze(): Promise<void>;
+    /**
+     * Begins a transaction.
+     * @returns A client from the pool for transaction use
+     */
+    beginTransaction(): Promise<PoolClient>;
+    /**
+     * Commits a transaction.
+     * @param client - The client to commit
+     */
+    commit(client: PoolClient): Promise<void>;
+    /**
+     * Rolls back a transaction.
+     * @param client - The client to rollback
+     */
+    rollback(client: PoolClient): Promise<void>;
+}
+//# sourceMappingURL=PostgreSQLDriver.d.ts.map

package/dist/drivers/PostgreSQLDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgreSQLDriver.d.ts","sourceRoot":"","sources":["../../src/drivers/PostgreSQLDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,UAAU,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,OAAO;IAC5C,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAa;IAE3B;;;OAGG;gBACS,OAAO,EAAE,uBAAuB;IAgB5C;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;OAIG;IACG,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BpC;;;;OAIG;IACG,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAexC;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAiBhD;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAiCvD;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAe3C;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAO5C;;;;OAIG;IACG,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAa1C;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAMvB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IASpB;;;OAGG;IACH,OAAO,IAAI,IAAI,GAAG,IAAI;IAItB;;;;;;OAMG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAM3D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,UAAU,CAAC;IAO7C;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAIpD"}

package/dist/drivers/PostgreSQLDriver.js

@@ -0,0 +1,294 @@
+import { Pool } from 'pg';
+/**
+ * Driver implementation for PostgreSQL using node-postgres.
+ * Provides a schema-less interface to PostgreSQL tables with JSONB storage.
+ */
+export class PostgreSQLDriver {
+    /**
+     * Creates a new instance of PostgreSQLDriver
+     * @param options - PostgreSQL driver configuration options
+     */
+    constructor(options) {
+        this.pool = null;
+        this.tableName = options.tableName;
+        this.config = {
+            connectionString: options.connectionString,
+            host: options.host,
+            port: options.port,
+            user: options.user,
+            password: options.password,
+            database: options.database,
+            max: options.max || 10,
+            ssl: options.ssl !== undefined ? options.ssl : (options.connectionString?.includes('sslmode=require') ? { rejectUnauthorized: false } : false),
+            ...options.poolOptions,
+        };
+    }
+    /**
+     * Connects to the PostgreSQL database.
+     * Creates the table if it doesn't exist.
+     */
+    async connect() {
+        this.pool = new Pool(this.config);
+        const createTableSQL = `
+            CREATE TABLE IF NOT EXISTS ${this.tableName} (
+                _id VARCHAR(100) PRIMARY KEY,
+                _data JSONB NOT NULL,
+                _createdAt TIMESTAMP NOT NULL,
+                _updatedAt TIMESTAMP NOT NULL
+            )
+        `;
+        await this.pool.query(createTableSQL);
+        await this.pool.query(`CREATE INDEX IF NOT EXISTS idx_${this.tableName}_createdAt ON ${this.tableName}(_createdAt)`);
+        await this.pool.query(`CREATE INDEX IF NOT EXISTS idx_${this.tableName}_updatedAt ON ${this.tableName}(_updatedAt)`);
+    }
+    /**
+     * Disconnects from the PostgreSQL database.
+     */
+    async disconnect() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+    /**
+     * Inserts a new record into the database.
+     * @param data - The data to insert
+     * @returns The inserted record with ID
+     */
+    async set(data) {
+        this.ensureConnected();
+        const id = this.generateId();
+        const now = new Date();
+        const record = {
+            ...data,
+            _id: id,
+            _createdAt: now.toISOString(),
+            _updatedAt: now.toISOString(),
+        };
+        const sql = `
+            INSERT INTO ${this.tableName} (_id, _data, _createdAt, _updatedAt)
+            VALUES ($1, $2, $3, $4)
+        `;
+        await this.pool.query(sql, [
+            id,
+            JSON.stringify(record),
+            now,
+            now,
+        ]);
+        return record;
+    }
+    /**
+     * Retrieves records matching the query.
+     * @param query - The query criteria
+     * @returns Array of matching records
+     */
+    async get(query) {
+        this.ensureConnected();
+        const sql = `SELECT _data FROM ${this.tableName}`;
+        const result = await this.pool.query(sql);
+        const allRecords = result.rows.map((row) => row._data);
+        if (Object.keys(query).length === 0) {
+            return allRecords;
+        }
+        return allRecords.filter((record) => this.matchesQuery(record, query));
+    }
+    /**
+     * Retrieves a single record matching the query.
+     * @param query - The query criteria
+     * @returns The first matching record or null
+     */
+    async getOne(query) {
+        this.ensureConnected();
+        if (query._id) {
+            const sql = `SELECT _data FROM ${this.tableName} WHERE _id = $1 LIMIT 1`;
+            const result = await this.pool.query(sql, [query._id]);
+            if (result.rows.length > 0) {
+                return result.rows[0]._data;
+            }
+            return null;
+        }
+        const results = await this.get(query);
+        return results.length > 0 ? results[0] : null;
+    }
+    /**
+     * Updates records matching the query.
+     * @param query - The query criteria
+     * @param data - The data to update
+     * @returns The number of updated records
+     */
+    async update(query, data) {
+        this.ensureConnected();
+        const records = await this.get(query);
+        let count = 0;
+        const sql = `
+            UPDATE ${this.tableName}
+            SET _data = $1, _updatedAt = $2
+            WHERE _id = $3
+        `;
+        for (const record of records) {
+            const updatedRecord = {
+                ...record,
+                ...data,
+                _updatedAt: new Date().toISOString(),
+            };
+            updatedRecord._id = record._id;
+            updatedRecord._createdAt = record._createdAt;
+            await this.pool.query(sql, [
+                JSON.stringify(updatedRecord),
+                new Date(),
+                record._id,
+            ]);
+            count++;
+        }
+        return count;
+    }
+    /**
+     * Deletes records matching the query.
+     * @param query - The query criteria
+     * @returns The number of deleted records
+     */
+    async delete(query) {
+        this.ensureConnected();
+        const records = await this.get(query);
+        const sql = `DELETE FROM ${this.tableName} WHERE _id = $1`;
+        let count = 0;
+        for (const record of records) {
+            await this.pool.query(sql, [record._id]);
+            count++;
+        }
+        return count;
+    }
+    /**
+     * Checks if any record matches the query.
+     * @param query - The query criteria
+     * @returns True if a match exists, false otherwise
+     */
+    async exists(query) {
+        this.ensureConnected();
+        const result = await this.getOne(query);
+        return result !== null;
+    }
+    /**
+     * Counts records matching the query.
+     * @param query - The query criteria
+     * @returns The number of matching records
+     */
+    async count(query) {
+        this.ensureConnected();
+        if (Object.keys(query).length === 0) {
+            const sql = `SELECT COUNT(*) as count FROM ${this.tableName}`;
+            const result = await this.pool.query(sql);
+            return parseInt(result.rows[0].count);
+        }
+        const results = await this.get(query);
+        return results.length;
+    }
+    /**
+     * Ensures the database is connected before executing operations.
+     * @throws Error if database is not connected
+     * @private
+     */
+    ensureConnected() {
+        if (!this.pool) {
+            throw new Error('Database not connected. Call connect() first.');
+        }
+    }
+    /**
+     * Generates a unique ID for records.
+     * @returns A unique string ID
+     * @private
+     */
+    generateId() {
+        return `${Date.now()}_${Math.random().toString(36).substring(2, 15)}`;
+    }
+    /**
+     * Checks if a record matches the query criteria.
+     * @param record - The record to check
+     * @param query - The query criteria
+     * @returns True if the record matches
+     * @private
+     */
+    matchesQuery(record, query) {
+        for (const [key, value] of Object.entries(query)) {
+            if (record[key] !== value) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Gets the PostgreSQL connection pool.
+     * @returns The PostgreSQL connection pool
+     */
+    getPool() {
+        return this.pool;
+    }
+    /**
+     * Executes a raw SQL query.
+     * WARNING: Use with caution. This bypasses the abstraction layer.
+     * @param sql - The SQL query to execute
+     * @param params - Optional parameters for the query
+     * @returns Query results
+     */
+    async executeRaw(sql, params) {
+        this.ensureConnected();
+        const result = await this.pool.query(sql, params);
+        return result.rows;
+    }
+    /**
+     * Clears all data from the table.
+     */
+    async clear() {
+        this.ensureConnected();
+        await this.pool.query(`DELETE FROM ${this.tableName}`);
+    }
+    /**
+     * Drops the entire table.
+     * WARNING: This will permanently delete all data and indexes.
+     */
+    async drop() {
+        this.ensureConnected();
+        await this.pool.query(`DROP TABLE IF EXISTS ${this.tableName}`);
+    }
+    /**
+     * Vacuums the table for optimization.
+     */
+    async vacuum() {
+        this.ensureConnected();
+        await this.pool.query(`VACUUM ${this.tableName}`);
+    }
+    /**
+     * Analyzes the table for query optimization.
+     */
+    async analyze() {
+        this.ensureConnected();
+        await this.pool.query(`ANALYZE ${this.tableName}`);
+    }
+    /**
+     * Begins a transaction.
+     * @returns A client from the pool for transaction use
+     */
+    async beginTransaction() {
+        this.ensureConnected();
+        const client = await this.pool.connect();
+        await client.query('BEGIN');
+        return client;
+    }
+    /**
+     * Commits a transaction.
+     * @param client - The client to commit
+     */
+    async commit(client) {
+        await client.query('COMMIT');
+        client.release();
+    }
+    /**
+     * Rolls back a transaction.
+     * @param client - The client to rollback
+     */
+    async rollback(client) {
+        await client.query('ROLLBACK');
+        client.release();
+    }
+}
+//# sourceMappingURL=PostgreSQLDriver.js.map

package/dist/drivers/PostgreSQLDriver.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { IDriver, Query, Data } from './interfaces/IDriver';
+export { PostgreSQLDriver, PostgreSQLDriverOptions } from './drivers/PostgreSQLDriver';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { PostgreSQLDriver } from './drivers/PostgreSQLDriver';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAA2B,MAAM,4BAA4B,CAAC"}

package/dist/interfaces/IDriver.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Query interface for filtering data
+ */
+export interface Query {
+    [key: string]: any;
+}
+/**
+ * Data interface for storing information
+ */
+export interface Data {
+    [key: string]: any;
+}
+/**
+ * Driver interface that all database drivers must implement
+ */
+export interface IDriver {
+    /**
+     * Connect to the database
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the database
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Set/Insert data into the database
+     * @param data - The data to store
+     * @returns The stored data with any additional fields (like auto-generated IDs)
+     */
+    set(data: Data): Promise<Data>;
+    /**
+     * Get data from the database based on query
+     * @param query - The query to filter data
+     * @returns Array of matching records
+     */
+    get(query: Query): Promise<Data[]>;
+    /**
+     * Update data in the database
+     * @param query - The query to find records to update
+     * @param data - The new data to set
+     * @returns Number of updated records
+     */
+    update(query: Query, data: Data): Promise<number>;
+    /**
+     * Delete data from the database
+     * @param query - The query to find records to delete
+     * @returns Number of deleted records
+     */
+    delete(query: Query): Promise<number>;
+    /**
+     * Get a single record from the database
+     * @param query - The query to filter data
+     * @returns A single matching record or null
+     */
+    getOne(query: Query): Promise<Data | null>;
+    /**
+     * Check if a record exists
+     * @param query - The query to check
+     * @returns True if exists, false otherwise
+     */
+    exists(query: Query): Promise<boolean>;
+    /**
+     * Count records matching the query
+     * @param query - The query to filter data
+     * @returns Number of matching records
+     */
+    count(query: Query): Promise<number>;
+}
+//# sourceMappingURL=IDriver.d.ts.map

package/dist/interfaces/IDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDriver.d.ts","sourceRoot":"","sources":["../../src/interfaces/IDriver.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElD;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtC;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAE3C;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC"}

package/dist/interfaces/IDriver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IDriver.js.map

package/dist/interfaces/IDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDriver.js","sourceRoot":"","sources":["../../src/interfaces/IDriver.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@hawiah/postgres",
+  "version": "0.1.0",
+  "description": "PostgreSQL driver with schema-less JSONB storage - lightweight and fast data persistence for Node.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node test/example.js"
+  },
+  "keywords": [
+    "postgresql",
+    "postgres",
+    "pg",
+    "database",
+    "driver",
+    "jsonb",
+    "schema-less",
+    "node-postgres",
+    "sql",
+    "lightweight",
+    "hawiah"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Shuruhatik/hawiah-postgres.git"
+  },
+  "homepage": "https://github.com/Shuruhatik/hawiah-postgres#readme",
+  "bugs": {
+    "url": "https://github.com/Shuruhatik/hawiah-postgres/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "INSTALLATION.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "pg": "^8.16.3"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.11.10",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}