@juit/pgproxy-client 1.0.0

package/dist/result.cjs

@@ -0,0 +1,59 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// result.ts
+var result_exports = {};
+__export(result_exports, {
+  PGResult: () => PGResult
+});
+module.exports = __toCommonJS(result_exports);
+var PGResult = class PGResultImpl {
+  command;
+  fields;
+  rowCount;
+  rows;
+  tuples;
+  constructor(result, registry) {
+    this.rowCount = result.rowCount;
+    this.command = result.command;
+    this.fields = result.fields.map(([name, oid]) => ({ name, oid }));
+    const rowCount = result.rows.length;
+    const colCount = result.fields.length;
+    const mappers = result.fields.map(([name, oid]) => [
+      name,
+      registry.getParser(oid)
+    ]);
+    const rows = this.rows = new Array(rowCount);
+    const tuples = this.tuples = new Array(rowCount);
+    for (let row = 0; row < rowCount; row++) {
+      const tupleData = tuples[row] = new Array(colCount);
+      const rowData = rows[row] = {};
+      for (let col = 0; col < colCount; col++) {
+        const [name, parser] = mappers[col];
+        const value = result.rows[row][col];
+        tupleData[col] = rowData[name] = value === null ? null : value === void 0 ? null : parser(value);
+      }
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PGResult
+});
+//# sourceMappingURL=result.cjs.map

package/dist/result.cjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/result.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA2CO,IAAM,WAAgC,MAAM,aAGjB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,QAA4B,UAAoB;AAC1D,SAAK,WAAW,OAAO;AACvB,SAAK,UAAU,OAAO;AACtB,SAAK,SAAS,OAAO,OAAO,IAAI,CAAC,CAAE,MAAM,GAAI,OAAO,EAAE,MAAM,IAAI,EAAE;AAElE,UAAM,WAAW,OAAO,KAAK;AAC7B,UAAM,WAAW,OAAO,OAAO;AAE/B,UAAM,UAAU,OAAO,OAAO,IAAI,CAAC,CAAE,MAAM,GAAI,MAAO;AAAA,MACpD;AAAA,MAAM,SAAS,UAAU,GAAG;AAAA,IAC9B,CAAW;AAEX,UAAM,OAAO,KAAK,OAAO,IAAI,MAAM,QAAQ;AAC3C,UAAM,SAAS,KAAK,SAAS,IAAI,MAAM,QAAQ;AAE/C,aAAS,MAAM,GAAG,MAAM,UAAU,OAAQ;AACxC,YAAM,YAAY,OAAO,GAAG,IAAI,IAAI,MAAM,QAAQ;AAClD,YAAM,UAAU,KAAK,GAAG,IAAI,CAAC;AAE7B,eAAS,MAAM,GAAG,MAAM,UAAU,OAAQ;AACxC,cAAM,CAAE,MAAM,MAAO,IAAI,QAAQ,GAAG;AACpC,cAAM,QAAQ,OAAO,KAAK,GAAG,EAAG,GAAG;AACnC,kBAAU,GAAG,IAAI,QAAQ,IAAI,IAC3B,UAAU,OAAO,OACjB,UAAU,SAAY,OACtB,OAAO,KAAK;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/result.d.ts

@@ -0,0 +1,30 @@
+import type { Registry } from '@juit/pgproxy-types';
+import type { PGConnectionResult } from './provider';
+/** The result of a database query */
+export interface PGResult<Row extends Record<string, any> = Record<string, any>, Tuple extends readonly any[] = readonly any[]> {
+    /** The SQL command that generated this result (`SELECT`, `INSERT`, ...) */
+    command: string;
+    /** Result description describing column names and relative OIDs */
+    fields: {
+        name: string;
+        oid: number;
+    }[];
+    /**
+     * The number of rows affected by the query.
+     *
+     * This can be the number of lines returned in `rows` (for `SELECT`
+     * statements, for example) or the number of lines _affected_ by the query
+     * (the number of records inserted by an `INSERT` query).
+     */
+    rowCount: number;
+    /** The rows returned by the database query, keyed by the column name. */
+    rows: Row[];
+    /** The tuples returned by the database query, keyed by the column index. */
+    tuples: Tuple[];
+}
+/** Constructor for {@link (PGResult:interface)} instances */
+export interface PGResultConstructor {
+    new <Row extends Record<string, any> = Record<string, any>, Tuple extends readonly any[] = readonly any[]>(result: PGConnectionResult, registry: Registry): PGResult<Row, Tuple>;
+}
+/** The result of a database query */
+export declare const PGResult: PGResultConstructor;

package/dist/result.mjs

@@ -0,0 +1,34 @@
+// result.ts
+var PGResult = class PGResultImpl {
+  command;
+  fields;
+  rowCount;
+  rows;
+  tuples;
+  constructor(result, registry) {
+    this.rowCount = result.rowCount;
+    this.command = result.command;
+    this.fields = result.fields.map(([name, oid]) => ({ name, oid }));
+    const rowCount = result.rows.length;
+    const colCount = result.fields.length;
+    const mappers = result.fields.map(([name, oid]) => [
+      name,
+      registry.getParser(oid)
+    ]);
+    const rows = this.rows = new Array(rowCount);
+    const tuples = this.tuples = new Array(rowCount);
+    for (let row = 0; row < rowCount; row++) {
+      const tupleData = tuples[row] = new Array(colCount);
+      const rowData = rows[row] = {};
+      for (let col = 0; col < colCount; col++) {
+        const [name, parser] = mappers[col];
+        const value = result.rows[row][col];
+        tupleData[col] = rowData[name] = value === null ? null : value === void 0 ? null : parser(value);
+      }
+    }
+  }
+};
+export {
+  PGResult
+};
+//# sourceMappingURL=result.mjs.map

package/dist/result.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/result.ts"],
+  "mappings": ";AA2CO,IAAM,WAAgC,MAAM,aAGjB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,QAA4B,UAAoB;AAC1D,SAAK,WAAW,OAAO;AACvB,SAAK,UAAU,OAAO;AACtB,SAAK,SAAS,OAAO,OAAO,IAAI,CAAC,CAAE,MAAM,GAAI,OAAO,EAAE,MAAM,IAAI,EAAE;AAElE,UAAM,WAAW,OAAO,KAAK;AAC7B,UAAM,WAAW,OAAO,OAAO;AAE/B,UAAM,UAAU,OAAO,OAAO,IAAI,CAAC,CAAE,MAAM,GAAI,MAAO;AAAA,MACpD;AAAA,MAAM,SAAS,UAAU,GAAG;AAAA,IAC9B,CAAW;AAEX,UAAM,OAAO,KAAK,OAAO,IAAI,MAAM,QAAQ;AAC3C,UAAM,SAAS,KAAK,SAAS,IAAI,MAAM,QAAQ;AAE/C,aAAS,MAAM,GAAG,MAAM,UAAU,OAAQ;AACxC,YAAM,YAAY,OAAO,GAAG,IAAI,IAAI,MAAM,QAAQ;AAClD,YAAM,UAAU,KAAK,GAAG,IAAI,CAAC;AAE7B,eAAS,MAAM,GAAG,MAAM,UAAU,OAAQ;AACxC,cAAM,CAAE,MAAM,MAAO,IAAI,QAAQ,GAAG;AACpC,cAAM,QAAQ,OAAO,KAAK,GAAG,EAAG,GAAG;AACnC,kBAAU,GAAG,IAAI,QAAQ,IAAI,IAC3B,UAAU,OAAO,OACjB,UAAU,SAAY,OACtB,OAAO,KAAK;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/websocket.cjs

@@ -0,0 +1,184 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// websocket.ts
+var websocket_exports = {};
+__export(websocket_exports, {
+  WebSocketProvider: () => WebSocketProvider
+});
+module.exports = __toCommonJS(websocket_exports);
+var import_assert = require("./assert.cjs");
+var pgWebSocketReadyState = {
+  CONNECTING: 0,
+  OPEN: 1,
+  CLOSING: 2,
+  CLOSED: 3
+};
+function msg(message, defaultMessage) {
+  return message || defaultMessage;
+}
+var WebSocketRequest = class {
+  constructor(id) {
+    this.id = id;
+    this.promise = new Promise((resolve, reject) => Object.defineProperties(this, {
+      resolve: { value: resolve },
+      reject: { value: reject }
+    }));
+  }
+  promise;
+  resolve;
+  reject;
+};
+var WebSocketConnectionImpl = class {
+  constructor(_socket, _getRequestId) {
+    this._socket = _socket;
+    this._getRequestId = _getRequestId;
+    _socket.addEventListener("close", (event) => {
+      if (!this._error) {
+        const reason = msg(event.reason, "Unknown Reason");
+        const message = `WebSocket Closed (${event.code}): ${reason}`;
+        this._error = new Error(message);
+      }
+      for (const req of this._requests.values())
+        req.reject(this._error);
+      this._requests.clear();
+    });
+    _socket.addEventListener("error", (event) => {
+      if (event.error)
+        this._error = event.error;
+      else
+        this._error = new Error("Unknown WebSocket Error");
+      for (const req of this._requests.values())
+        req.reject(this._error);
+      this._requests.clear();
+      this.close();
+    });
+    _socket.addEventListener("message", (event) => {
+      try {
+        const data = event.data;
+        (0, import_assert.assert)(typeof data === "string", 'Data not a "string"');
+        let payload;
+        try {
+          payload = JSON.parse(data);
+        } catch (error) {
+          throw new Error("Unable to parse JSON payload");
+        }
+        (0, import_assert.assert)(payload && typeof payload === "object", "JSON payload is not an object");
+        const request = this._requests.get(payload.id);
+        (0, import_assert.assert)(request, `Invalid response ID "${payload.id}"`);
+        if (payload.statusCode === 200) {
+          this._requests.delete(payload.id);
+          return request.resolve(payload);
+        } else if (payload.statusCode === 400) {
+          this._requests.delete(payload.id);
+          return request.reject(new Error(`${msg(payload.error, "Unknown error")} (${payload.statusCode})`));
+        } else {
+          throw new Error(`${msg(payload.error, "Unknown error")} (${payload.statusCode})`);
+        }
+      } catch (error) {
+        _socket.close(1003, msg(error.message, "Uknown error"));
+      }
+    });
+  }
+  /** Open requests to correlate, keyed by their unique request id */
+  _requests = /* @__PURE__ */ new Map();
+  /** Our error, set also when the websocket is closed */
+  _error;
+  close() {
+    if (this._socket.readyState === pgWebSocketReadyState.CLOSED)
+      return;
+    if (this._socket.readyState === pgWebSocketReadyState.CLOSING)
+      return;
+    this._socket.close(1e3, "Normal termination");
+  }
+  query(query, params) {
+    if (this._error)
+      return Promise.reject(this._error);
+    return new Promise((resolve, reject) => {
+      const id = this._getRequestId();
+      const request = new WebSocketRequest(id);
+      this._requests.set(id, request);
+      request.promise.then(resolve, reject);
+      try {
+        this._socket.send(JSON.stringify({ id, query, params }));
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+};
+var WebSocketProvider = class {
+  _connections = /* @__PURE__ */ new Set();
+  /**
+   * Handle the initial connection of a WebSocket.
+   *
+   * This method should be called _synchronously_ by {@link WebSocketProvider._getWebSocket} as
+   * soon as the WebSocket instance is created.
+   */
+  _connectWebSocket(socket) {
+    return new Promise((resolve, reject) => {
+      if (socket.readyState === pgWebSocketReadyState.OPEN)
+        return resolve(socket);
+      if (socket.readyState !== pgWebSocketReadyState.CONNECTING) {
+        return reject(new Error(`Invalid WebSocket ready state ${socket.readyState}`));
+      }
+      const onopen = () => {
+        removeEventListeners();
+        resolve(socket);
+      };
+      const onerror = (event) => {
+        removeEventListeners();
+        if ("error" in event)
+          return reject(event.error);
+        reject(new Error("Uknown error opening WebSocket"));
+      };
+      const onclose = (event) => {
+        removeEventListeners();
+        reject(new Error(`Connection closed with code ${event.code}: ${event.reason}`));
+      };
+      const removeEventListeners = () => {
+        socket.removeEventListener("open", onopen);
+        socket.removeEventListener("error", onerror);
+        socket.removeEventListener("close", onclose);
+      };
+      socket.addEventListener("open", onopen);
+      socket.addEventListener("error", onerror);
+      socket.addEventListener("close", onclose);
+    });
+  }
+  async acquire() {
+    const socket = await this._getWebSocket();
+    const connection = new WebSocketConnectionImpl(socket, () => this._getUniqueRequestId());
+    this._connections.add(connection);
+    return connection;
+  }
+  async release(connection) {
+    this._connections.delete(connection);
+    connection.close();
+  }
+  async destroy() {
+    this._connections.forEach((connection) => connection.close());
+    this._connections.clear();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WebSocketProvider
+});
+//# sourceMappingURL=websocket.cjs.map

package/dist/websocket.cjs.map

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

package/dist/websocket.d.ts

@@ -0,0 +1,60 @@
+import type { PGConnection, PGConnectionResult, PGProvider } from './provider';
+interface PGWebSocketCloseEvent {
+    readonly code: number;
+    readonly reason: string;
+}
+interface PGWebSocketMessageEvent {
+    readonly data?: any;
+}
+interface PGWebSocketErrorEvent {
+    readonly error?: any;
+}
+export interface PGWebSocket {
+    addEventListener(event: 'close', handler: (event: PGWebSocketCloseEvent) => void): void;
+    addEventListener(event: 'error', handler: (event: PGWebSocketErrorEvent) => void): void;
+    addEventListener(event: 'message', handler: (event: PGWebSocketMessageEvent) => void): void;
+    addEventListener(event: 'open', handler: () => void): void;
+    removeEventListener(event: 'close', handler: (event: PGWebSocketCloseEvent) => void): void;
+    removeEventListener(event: 'error', handler: (event: PGWebSocketErrorEvent) => void): void;
+    removeEventListener(event: 'message', handler: (event: PGWebSocketMessageEvent) => void): void;
+    removeEventListener(event: 'open', handler: () => void): void;
+    readonly readyState: number;
+    send(message: string): void;
+    close(code?: number, reason?: string): void;
+}
+/** A connection to the database backed by a `WebSocket` */
+export interface WebSocketConnection extends PGConnection {
+    /** Close this connection and the underlying `WebSocket` */
+    close(): void;
+}
+/** An abstract provider implementing `connect(...)` via WHATWG WebSockets */
+export declare abstract class WebSocketProvider implements PGProvider<WebSocketConnection> {
+    private readonly _connections;
+    abstract query(text: string, params: (string | null)[]): Promise<PGConnectionResult>;
+    /** Return a unique request identifier to correlate responses */
+    protected abstract _getUniqueRequestId(): string;
+    /**
+     * Create a new WebSocket.
+     *
+     * This method can be asynchronous and can return a `Promise`. This is
+     * due to the fact that in order to create our authentication token with the
+     * Web Cryptography API, we need to _await_ the resolution of our token.
+     *
+     * This method should call _synchronously_ the {@link WebSocketProvider._connectWebSocket}
+     * as soon as the WebSocket instance is created, in order to handle `open`,
+     * `close`, or `error` events before the event loop has a chance to resolve
+     * the `Promise` asynchronously.
+     */
+    protected abstract _getWebSocket(): Promise<PGWebSocket>;
+    /**
+     * Handle the initial connection of a WebSocket.
+     *
+     * This method should be called _synchronously_ by {@link WebSocketProvider._getWebSocket} as
+     * soon as the WebSocket instance is created.
+     */
+    protected _connectWebSocket<S extends PGWebSocket>(socket: S): Promise<S>;
+    acquire(): Promise<WebSocketConnection>;
+    release(connection: WebSocketConnection): Promise<void>;
+    destroy(): Promise<void>;
+}
+export {};

package/dist/websocket.mjs

@@ -0,0 +1,159 @@
+// websocket.ts
+import { assert } from "./assert.mjs";
+var pgWebSocketReadyState = {
+  CONNECTING: 0,
+  OPEN: 1,
+  CLOSING: 2,
+  CLOSED: 3
+};
+function msg(message, defaultMessage) {
+  return message || defaultMessage;
+}
+var WebSocketRequest = class {
+  constructor(id) {
+    this.id = id;
+    this.promise = new Promise((resolve, reject) => Object.defineProperties(this, {
+      resolve: { value: resolve },
+      reject: { value: reject }
+    }));
+  }
+  promise;
+  resolve;
+  reject;
+};
+var WebSocketConnectionImpl = class {
+  constructor(_socket, _getRequestId) {
+    this._socket = _socket;
+    this._getRequestId = _getRequestId;
+    _socket.addEventListener("close", (event) => {
+      if (!this._error) {
+        const reason = msg(event.reason, "Unknown Reason");
+        const message = `WebSocket Closed (${event.code}): ${reason}`;
+        this._error = new Error(message);
+      }
+      for (const req of this._requests.values())
+        req.reject(this._error);
+      this._requests.clear();
+    });
+    _socket.addEventListener("error", (event) => {
+      if (event.error)
+        this._error = event.error;
+      else
+        this._error = new Error("Unknown WebSocket Error");
+      for (const req of this._requests.values())
+        req.reject(this._error);
+      this._requests.clear();
+      this.close();
+    });
+    _socket.addEventListener("message", (event) => {
+      try {
+        const data = event.data;
+        assert(typeof data === "string", 'Data not a "string"');
+        let payload;
+        try {
+          payload = JSON.parse(data);
+        } catch (error) {
+          throw new Error("Unable to parse JSON payload");
+        }
+        assert(payload && typeof payload === "object", "JSON payload is not an object");
+        const request = this._requests.get(payload.id);
+        assert(request, `Invalid response ID "${payload.id}"`);
+        if (payload.statusCode === 200) {
+          this._requests.delete(payload.id);
+          return request.resolve(payload);
+        } else if (payload.statusCode === 400) {
+          this._requests.delete(payload.id);
+          return request.reject(new Error(`${msg(payload.error, "Unknown error")} (${payload.statusCode})`));
+        } else {
+          throw new Error(`${msg(payload.error, "Unknown error")} (${payload.statusCode})`);
+        }
+      } catch (error) {
+        _socket.close(1003, msg(error.message, "Uknown error"));
+      }
+    });
+  }
+  /** Open requests to correlate, keyed by their unique request id */
+  _requests = /* @__PURE__ */ new Map();
+  /** Our error, set also when the websocket is closed */
+  _error;
+  close() {
+    if (this._socket.readyState === pgWebSocketReadyState.CLOSED)
+      return;
+    if (this._socket.readyState === pgWebSocketReadyState.CLOSING)
+      return;
+    this._socket.close(1e3, "Normal termination");
+  }
+  query(query, params) {
+    if (this._error)
+      return Promise.reject(this._error);
+    return new Promise((resolve, reject) => {
+      const id = this._getRequestId();
+      const request = new WebSocketRequest(id);
+      this._requests.set(id, request);
+      request.promise.then(resolve, reject);
+      try {
+        this._socket.send(JSON.stringify({ id, query, params }));
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+};
+var WebSocketProvider = class {
+  _connections = /* @__PURE__ */ new Set();
+  /**
+   * Handle the initial connection of a WebSocket.
+   *
+   * This method should be called _synchronously_ by {@link WebSocketProvider._getWebSocket} as
+   * soon as the WebSocket instance is created.
+   */
+  _connectWebSocket(socket) {
+    return new Promise((resolve, reject) => {
+      if (socket.readyState === pgWebSocketReadyState.OPEN)
+        return resolve(socket);
+      if (socket.readyState !== pgWebSocketReadyState.CONNECTING) {
+        return reject(new Error(`Invalid WebSocket ready state ${socket.readyState}`));
+      }
+      const onopen = () => {
+        removeEventListeners();
+        resolve(socket);
+      };
+      const onerror = (event) => {
+        removeEventListeners();
+        if ("error" in event)
+          return reject(event.error);
+        reject(new Error("Uknown error opening WebSocket"));
+      };
+      const onclose = (event) => {
+        removeEventListeners();
+        reject(new Error(`Connection closed with code ${event.code}: ${event.reason}`));
+      };
+      const removeEventListeners = () => {
+        socket.removeEventListener("open", onopen);
+        socket.removeEventListener("error", onerror);
+        socket.removeEventListener("close", onclose);
+      };
+      socket.addEventListener("open", onopen);
+      socket.addEventListener("error", onerror);
+      socket.addEventListener("close", onclose);
+    });
+  }
+  async acquire() {
+    const socket = await this._getWebSocket();
+    const connection = new WebSocketConnectionImpl(socket, () => this._getUniqueRequestId());
+    this._connections.add(connection);
+    return connection;
+  }
+  async release(connection) {
+    this._connections.delete(connection);
+    connection.close();
+  }
+  async destroy() {
+    this._connections.forEach((connection) => connection.close());
+    this._connections.clear();
+  }
+};
+export {
+  WebSocketProvider
+};
+//# sourceMappingURL=websocket.mjs.map

package/dist/websocket.mjs.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@juit/pgproxy-client",
+  "version": "1.0.0",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "author": "Juit Developers <developers@juit.com>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/juitnow/juit-pgproxy.git"
+  },
+  "keywords": [
+    "database",
+    "pg",
+    "pool",
+    "postgres",
+    "proxy"
+  ],
+  "bugs": {
+    "url": "https://github.com/juitnow/juit-pgproxy/issues"
+  },
+  "homepage": "https://github.com/juitnow/juit-pgproxy#readme",
+  "dependencies": {
+    "@juit/pgproxy-types": "1.0.0"
+  },
+  "directories": {
+    "test": "test"
+  },
+  "files": [
+    "*.md",
+    "dist/",
+    "src/"
+  ]
+}

package/src/assert.ts

@@ -0,0 +1,4 @@
+/** The easiest assertion function in the world */
+export function assert(what: unknown, message: string): asserts what {
+  if (! what) throw new Error(message)
+}