prostgles-server 2.0.178 → 2.0.179

package/lib/Filtering.js

@@ -0,0 +1,299 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFilterItem = void 0;
+const prostgles_types_1 = require("prostgles-types");
+const DboBuilder_1 = require("./DboBuilder");
+const parseFilterItem = (args) => {
+    const { filter: _f, select, tableAlias, pgp } = args;
+    if (!_f || (0, prostgles_types_1.isEmpty)(_f))
+        return "";
+    const mErr = (msg) => {
+        throw `${msg}: ${JSON.stringify(_f, null, 2)}`;
+    }, asValue = (v) => pgp.as.format("$1", [v]);
+    const fKeys = (0, prostgles_types_1.getKeys)(_f);
+    if (fKeys.length === 0) {
+        return "";
+    }
+    else if (fKeys.length > 1) {
+        return fKeys.map(fk => (0, exports.parseFilterItem)({
+            filter: { [fk]: _f[fk] },
+            select,
+            tableAlias,
+            pgp,
+        }))
+            .sort() /*  sorted to ensure duplicate subscription channels are not created due to different condition order */
+            .join(" AND ");
+    }
+    const fKey = fKeys[0];
+    /* Exists filter */
+    if (prostgles_types_1.EXISTS_KEYS.find(k => k in _f)) {
+        // parseExistsFilter()
+    }
+    let selItem;
+    if (select)
+        selItem = select.find(s => fKey === s.alias);
+    let rightF = _f[fKey];
+    const getLeftQ = (selItm) => {
+        if (selItm.type === "function")
+            return selItm.getQuery();
+        return selItm.getQuery(tableAlias);
+    };
+    /**
+      * Parsed left side of the query
+      */
+    let leftQ; // = asName(selItem.alias);
+    /* Check if string notation. Build obj if necessary */
+    const dot_notation_delims = ["->", "."];
+    if (!selItem) {
+        /* See if dot notation. Pick the best matching starting string */
+        if (select) {
+            selItem = select.find(s => fKey.startsWith(s.alias) &&
+                dot_notation_delims.find(dn => fKey.slice(s.alias.length).startsWith(dn)));
+        }
+        if (!selItem) {
+            mErr("Bad filter. Could not match to a column or alias: ");
+            throw " ";
+        }
+        const remainingStr = fKey.slice(selItem.alias.length);
+        /* Is json path spec */
+        if (remainingStr.startsWith("->")) {
+            leftQ = getLeftQ(selItem);
+            const getSep = (fromIdx = 0) => {
+                const strPart = remainingStr.slice(fromIdx);
+                let idx = strPart.indexOf("->");
+                let idxx = strPart.indexOf("->>");
+                if (idx > -1) {
+                    /* if -> matches then check if it's the last separator */
+                    if (idx === idxx)
+                        return { idx: idx + fromIdx, sep: "->>" };
+                    return { idx: idx + fromIdx, sep: "->" };
+                }
+                idx = strPart.indexOf("->>");
+                if (idx > -1) {
+                    return { idx: idx + fromIdx, sep: "->>" };
+                }
+                return undefined;
+            };
+            let currSep = getSep();
+            while (currSep) {
+                let nextSep = getSep(currSep.idx + currSep.sep.length);
+                let nextIdx = nextSep ? nextSep.idx : remainingStr.length;
+                /* If ending in set then add set as well into key */
+                if (nextSep && nextIdx + nextSep.sep.length === remainingStr.length) {
+                    nextIdx = remainingStr.length;
+                    nextSep = undefined;
+                }
+                // console.log({ currSep, nextSep })
+                leftQ += currSep.sep + asValue(remainingStr.slice(currSep.idx + currSep.sep.length, nextIdx));
+                currSep = nextSep;
+            }
+            /* Is collapsed filter spec  e.g. { "col.$ilike": 'text' } */
+        }
+        else if (remainingStr.startsWith(".")) {
+            leftQ = getLeftQ(selItem);
+            let getSep = (fromIdx = 0) => {
+                const idx = remainingStr.slice(fromIdx).indexOf(".");
+                if (idx > -1)
+                    return fromIdx + idx;
+                return idx;
+            };
+            let currIdx = getSep();
+            let res = {};
+            let curObj = res;
+            while (currIdx > -1) {
+                let nextIdx = getSep(currIdx + 1);
+                let nIdx = nextIdx > -1 ? nextIdx : remainingStr.length;
+                /* If ending in dot then add dot as well into key */
+                if (nextIdx + 1 === remainingStr.length) {
+                    nIdx = remainingStr.length;
+                    nextIdx = -1;
+                }
+                const key = remainingStr.slice(currIdx + 1, nIdx);
+                curObj[key] = nextIdx > -1 ? {} : _f[fKey];
+                curObj = curObj[key];
+                currIdx = nextIdx;
+            }
+            rightF = res;
+        }
+        else {
+            console.trace(141, select, selItem, remainingStr);
+            mErr("Bad filter. Could not find the valid col name or alias or col json path");
+        }
+    }
+    else {
+        leftQ = getLeftQ(selItem);
+    }
+    if (!leftQ)
+        mErr("Internal error: leftQ missing?!");
+    /* Matching sel item */
+    if ((0, DboBuilder_1.isPlainObject)(rightF)) {
+        const parseRightVal = (val, expect = null) => {
+            const checkIfArr = () => {
+                if (!Array.isArray(val))
+                    return mErr("This type of filter/column expects an Array of items");
+            };
+            if (expect === "csv") {
+                checkIfArr();
+                return pgp.as.format("($1:csv)", [val]);
+            }
+            else if (expect === "array" || selItem && selItem.columnPGDataType && selItem.columnPGDataType === "ARRAY") {
+                checkIfArr();
+                return pgp.as.format(" ARRAY[$1:csv]", [val]);
+            }
+            return asValue(val);
+        };
+        const filterKeys = Object.keys(rightF);
+        if (filterKeys.length !== 1)
+            mErr("Bad filter. Expecting one key only");
+        const fOpType = filterKeys[0];
+        const fVal = rightF[fOpType];
+        let sOpType;
+        let sVal;
+        if (fVal && (0, DboBuilder_1.isPlainObject)(fVal)) {
+            const keys = Object.keys(fVal);
+            if (!keys.length || keys.length !== 1) {
+                return mErr("Bad filter. Expecting a nested object with one key only ");
+            }
+            sOpType = keys[0];
+            sVal = fVal[sOpType];
+        }
+        // console.log({ fOpType, fVal, sOpType })
+        /** JSON cannot be compared so we'll cast it to TEXT */
+        if (selItem?.column_udt_type === "json" || ["$ilike", "$like", "$nilike", "$nlike"].includes(fOpType)) {
+            leftQ += "::TEXT ";
+        }
+        /** st_makeenvelope */
+        if (prostgles_types_1.GeomFilterKeys.includes(fOpType) && sOpType && prostgles_types_1.GeomFilter_Funcs.includes(sOpType)) {
+            /** If leftQ is geography then this err can happen: 'Antipodal (180 degrees long) edge detected!' */
+            if (sOpType.toLowerCase() === "st_makeenvelope")
+                leftQ += "::geometry";
+            return leftQ + ` ${fOpType} ` + `${sOpType}${parseRightVal(sVal, "csv")}`;
+        }
+        else if (["=", "$eq"].includes(fOpType) && !sOpType) {
+            if (fVal === null)
+                return leftQ + " IS NULL ";
+            return leftQ + " = " + parseRightVal(fVal);
+        }
+        else if (["<>", "$ne"].includes(fOpType)) {
+            if (fVal === null)
+                return leftQ + " IS NOT NULL ";
+            return leftQ + " <> " + parseRightVal(fVal);
+        }
+        else if ([">", "$gt"].includes(fOpType)) {
+            return leftQ + " > " + parseRightVal(fVal);
+        }
+        else if (["<", "$lt"].includes(fOpType)) {
+            return leftQ + " < " + parseRightVal(fVal);
+        }
+        else if ([">=", "$gte"].includes(fOpType)) {
+            return leftQ + " >=  " + parseRightVal(fVal);
+        }
+        else if (["<=", "$lte"].includes(fOpType)) {
+            return leftQ + " <= " + parseRightVal(fVal);
+        }
+        else if (["$in"].includes(fOpType)) {
+            if (!fVal?.length) {
+                return " FALSE ";
+            }
+            let _fVal = fVal.filter((v) => v !== null);
+            let c1 = "", c2 = "";
+            if (_fVal.length)
+                c1 = leftQ + " IN " + parseRightVal(_fVal, "csv");
+            if (fVal.includes(null))
+                c2 = ` ${leftQ} IS NULL `;
+            return [c1, c2].filter(c => c).join(" OR ");
+        }
+        else if (["$nin"].includes(fOpType)) {
+            if (!fVal?.length) {
+                return " TRUE ";
+            }
+            let _fVal = fVal.filter((v) => v !== null);
+            let c1 = "", c2 = "";
+            if (_fVal.length)
+                c1 = leftQ + " NOT IN " + parseRightVal(_fVal, "csv");
+            if (fVal.includes(null))
+                c2 = ` ${leftQ} IS NOT NULL `;
+            return [c1, c2].filter(c => c).join(" AND ");
+        }
+        else if (["$between"].includes(fOpType)) {
+            if (!Array.isArray(fVal) || fVal.length !== 2) {
+                return mErr("Between filter expects an array of two values");
+            }
+            return leftQ + " BETWEEN " + asValue(fVal[0]) + " AND " + asValue(fVal[1]);
+        }
+        else if (["$ilike"].includes(fOpType)) {
+            return leftQ + " ILIKE " + asValue(fVal);
+        }
+        else if (["$like"].includes(fOpType)) {
+            return leftQ + " LIKE " + asValue(fVal);
+        }
+        else if (["$nilike"].includes(fOpType)) {
+            return leftQ + " NOT ILIKE " + asValue(fVal);
+        }
+        else if (["$nlike"].includes(fOpType)) {
+            return leftQ + " NOT LIKE " + asValue(fVal);
+            /* MAYBE TEXT OR MAYBE ARRAY */
+        }
+        else if (["@>", "<@", "$contains", "$containedBy", "&&", "@@"].includes(fOpType)) {
+            let operand = fOpType === "@@" ? "@@" :
+                ["@>", "$contains"].includes(fOpType) ? "@>" :
+                    ["&&"].includes(fOpType) ? "&&" :
+                        "<@";
+            /* Array for sure */
+            if (Array.isArray(fVal)) {
+                return leftQ + operand + parseRightVal(fVal, "array");
+                /* FTSQuery */
+            }
+            else if (["@@"].includes(fOpType) && prostgles_types_1.TextFilter_FullTextSearchFilterKeys.includes(sOpType)) {
+                let lq = `to_tsvector(${leftQ}::text)`;
+                if (selItem && selItem.columnPGDataType === "tsvector")
+                    lq = leftQ;
+                let res = `${lq} ${operand} ` + `${sOpType}${parseRightVal(sVal, "csv")}`;
+                return res;
+            }
+            else {
+                return mErr("Unrecognised filter operand: " + fOpType + " ");
+            }
+        }
+        else {
+            /** Maybe it's an object key which means it's an equality comparison against a json object */
+            if (selItem?.column_udt_type?.startsWith("json")) {
+                return leftQ + " = " + parseRightVal(rightF);
+            }
+            return mErr("Unrecognised filter operand: " + fOpType + " ");
+        }
+    }
+    else {
+        /* Is an equal filter */
+        if (rightF === null) {
+            return leftQ + " IS NULL ";
+        }
+        else {
+            return leftQ + " = " + asValue(rightF);
+        }
+    }
+};
+exports.parseFilterItem = parseFilterItem;
+// ensure pgp is not NULL!!!
+// const asValue = v => v;// pgp.as.value;
+// const filters: FilterSpec[] = [
+//   ...(["ilike", "like"].map(op => ({ 
+//     operands: ["$" + op],
+//     tsDataTypes: ["any"] as TSDataType[],
+//     tsDefinition: ` { $${op}: string } `,
+//     // data_types: 
+//     getQuery: (leftQuery: string, rightVal: any) => {
+//       return `${leftQuery}::text ${op.toUpperCase()} ${asValue(rightVal)}::text` 
+//     }
+//   }))),
+//   { 
+//     operands: ["", "="],
+//     tsDataTypes: ["any"],
+//     tsDefinition: ` { "=": any } | any `,
+//     // data_types: 
+//     getQuery: (leftQuery: string, rightVal: any) => {
+//       if(rightVal === null) return`${leftQuery} IS NULL `;
+//       return `${leftQuery} = ${asValue(rightVal)}`;
+//     }
+//   }
+// ];

package/lib/PostgresNotifListenManager.d.ts

@@ -0,0 +1,27 @@
+import { DB } from "./Prostgles";
+import pg from "pg-promise/typescript/pg-subset";
+import pgPromise from "pg-promise";
+export declare type PrglNotifListener = (args: {
+    length: number;
+    processId: number;
+    channel: string;
+    payload: string;
+    name: string;
+}) => void;
+export declare class PostgresNotifListenManager {
+    connection?: pgPromise.IConnected<{}, pg.IClient>;
+    db_pg: DB;
+    notifListener: PrglNotifListener;
+    db_channel_name: string;
+    isListening: any;
+    client: any;
+    static create: (db_pg: DB, notifListener: PrglNotifListener, db_channel_name: string) => Promise<PostgresNotifListenManager>;
+    constructor(db_pg: DB, notifListener: PrglNotifListener, db_channel_name: string, noInit?: boolean);
+    init(): Promise<PostgresNotifListenManager>;
+    isReady(): any;
+    startListening(): Promise<unknown>;
+    destroy: () => void;
+    stopListening: () => void;
+    reconnect(delay?: number | undefined, maxAttempts?: number | undefined): Promise<unknown>;
+}
+//# sourceMappingURL=PostgresNotifListenManager.d.ts.map

package/lib/PostgresNotifListenManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresNotifListenManager.d.ts","sourceRoot":"","sources":["PostgresNotifListenManager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,iCAAiC,CAAC;AACjD,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC,oBAAY,iBAAiB,GAAG,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE,KAAK,IAAI,CAAC;AACvI,qBAAa,0BAA0B;IACnC,UAAU,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IAClD,KAAK,EAAE,EAAE,CAAC;IACV,aAAa,EAAE,iBAAiB,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,GAAG,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC;IAEZ,MAAM,CAAC,MAAM,6BAA8B,iBAAiB,mBAAmB,MAAM,KAAG,QAAQ,0BAA0B,CAAC,CAG1H;gBAEW,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,UAAQ;IAS1F,IAAI,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAQjD,OAAO;IAIP,cAAc;IA+Bd,OAAO,aAEN;IAED,aAAa,aAKZ;IAED,SAAS,CAAC,KAAK,GAAE,MAAM,GAAG,SAAa,EAAE,WAAW,GAAE,MAAM,GAAG,SAAa;CAsD/E"}

package/lib/PostgresNotifListenManager.js

@@ -0,0 +1,122 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Stefan L. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresNotifListenManager = void 0;
+class PostgresNotifListenManager {
+    constructor(db_pg, notifListener, db_channel_name, noInit = false) {
+        this.destroy = () => {
+            if (this.connection)
+                this.connection.done();
+        };
+        this.stopListening = () => {
+            if (this.db_channel_name) {
+                if (this.connection)
+                    this.connection.none('UNLISTEN $1~', this.db_channel_name);
+                if (this.client)
+                    this.client.query('UNLISTEN $1~', this.db_channel_name);
+            }
+        };
+        if (!db_pg || !notifListener || !db_channel_name)
+            throw "PostgresNotifListenManager: db_pg OR notifListener OR db_channel_name MISSING";
+        this.db_pg = db_pg;
+        this.notifListener = notifListener;
+        this.db_channel_name = db_channel_name;
+        if (!noInit)
+            this.init();
+    }
+    async init() {
+        this.connection = undefined;
+        this.isListening = await this.startListening();
+        return this;
+    }
+    isReady() {
+        return this.isListening;
+    }
+    startListening() {
+        if (!this.db_pg || !this.notifListener)
+            throw "PostgresNotifListenManager: db_pg OR notifListener missing";
+        return this.reconnect() // = same as reconnect(0, 1)
+            .then(obj => {
+            return obj;
+            /* TODO: expose this within onReady */
+            // console.log('psqlWS - Successful Initial Connection');
+            // obj.done(); - releases the connection
+            /*  HOW TO SEND NOTIF
+                Used for testing in conjunction with
+                SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE datname='db-name';
+
+                function sendNotifications() {
+                    if (this.connection) {
+                        this.connection.none('NOTIFY $1~, $2', [this.db_channel_name, 'my payload string'])
+                            .catch(error => {
+                                console.log('psqlWS - Failed to Notify:', error); // unlikely to ever happen
+                            })
+                    }
+                }
+            */
+        })
+            .catch(error => {
+            console.log('PostgresNotifListenManager: Failed Initial Connection:', error);
+        });
+    }
+    reconnect(delay = 0, maxAttempts = 0) {
+        if (!this.db_pg || !this.notifListener)
+            throw "db_pg OR notifListener missing";
+        delay = delay > 0 ? parseInt(delay + "") : 0;
+        maxAttempts = maxAttempts > 0 ? parseInt(maxAttempts + "") : 1;
+        const setListeners = (client, notifListener, db_channel_name) => {
+            client.on('notification', notifListener);
+            this.client = client;
+            if (!this.connection)
+                throw "Connection missing";
+            return this.connection.none('LISTEN $1~', db_channel_name)
+                .catch(error => {
+                console.log("PostgresNotifListenManager: unexpected error: ", error); // unlikely to ever happen
+            });
+        }, removeListeners = (client) => {
+            client.removeListener('notification', this.notifListener);
+        }, onConnectionLost = (err, e) => {
+            console.log('PostgresNotifListenManager: Connectivity Problem:', err);
+            this.connection = undefined; // prevent use of the broken connection
+            removeListeners(e.client);
+            this.reconnect(5000, 10) // retry 10 times, with 5-second intervals
+                .then(() => {
+                console.log('PostgresNotifListenManager: Successfully Reconnected');
+            })
+                .catch(() => {
+                // failed after 10 attempts
+                console.log('PostgresNotifListenManager: Connection Lost Permanently. TERMINATING NODE PROCESS');
+                process.exit(); // exiting the process
+            });
+        };
+        return new Promise((resolve, reject) => {
+            setTimeout(() => {
+                this.db_pg.connect({ direct: true, onLost: onConnectionLost })
+                    .then(obj => {
+                    this.connection = obj; // global connection is now available
+                    resolve(obj);
+                    return setListeners(obj.client, this.notifListener, this.db_channel_name);
+                })
+                    .catch(error => {
+                    console.log('PostgresNotifListenManager: Error Connecting:', error);
+                    if (--maxAttempts) {
+                        this.reconnect(delay, maxAttempts)
+                            .then(resolve)
+                            .catch(reject);
+                    }
+                    else {
+                        reject(error);
+                    }
+                });
+            }, delay);
+        });
+    }
+}
+exports.PostgresNotifListenManager = PostgresNotifListenManager;
+PostgresNotifListenManager.create = (db_pg, notifListener, db_channel_name) => {
+    let res = new PostgresNotifListenManager(db_pg, notifListener, db_channel_name, true);
+    return res.init();
+};

package/lib/Prostgles.d.ts

@@ -0,0 +1,193 @@
+import * as pgPromise from 'pg-promise';
+import pg = require('pg-promise/typescript/pg-subset');
+import FileManager, { ImageOptions, LocalConfig, S3Config } from "./FileManager";
+import AuthHandler, { Auth } from "./AuthHandler";
+import TableConfigurator, { TableConfig } from "./TableConfig";
+import { DboBuilder, DBHandlerServer, PRGLIOSocket } from "./DboBuilder";
+export { DBHandlerServer };
+export declare type PGP = pgPromise.IMain<{}, pg.IClient>;
+import { AnyObject } from "prostgles-types";
+import { Publish, PublishMethods, PublishParams, PublishParser } from "./PublishParser";
+import { DBEventsManager } from "./DBEventsManager";
+export declare type DB = pgPromise.IDatabase<{}, pg.IClient>;
+declare type DbConnection = string | pg.IConnectionParameters<pg.IClient>;
+declare type DbConnectionOpts = pg.IDefaults;
+export declare const TABLE_METHODS: readonly ["update", "find", "findOne", "insert", "delete", "upsert"];
+export declare const JOIN_TYPES: readonly ["one-many", "many-one", "one-one", "many-many"];
+export declare type Join = {
+    tables: [string, string];
+    on: {
+        [key: string]: string;
+    };
+    type: typeof JOIN_TYPES[number];
+};
+export declare type Joins = Join[] | "inferred";
+declare type Keywords = {
+    $and: string;
+    $or: string;
+    $not: string;
+};
+export declare type DeepPartial<T> = {
+    [P in keyof T]?: DeepPartial<T[P]>;
+};
+declare type ExpressApp = {
+    get: (routePath: string, cb: (req: {
+        params: {
+            name: string;
+        };
+        cookies: {
+            sid: string;
+        };
+    }, res: {
+        redirect: (redirectUrl: string) => any;
+        contentType: (type: string) => void;
+        sendFile: (fileName: string, opts?: {
+            root: string;
+        }) => any;
+        status: (code: number) => {
+            json: (response: AnyObject) => any;
+        };
+    }) => any) => any;
+};
+/**
+ * Allows uploading and downloading files.
+ * Currently supports only S3.
+ *
+ * @description
+ * Will create a media table that contains file metadata and urls
+ * Inserting a file into this table through prostgles will upload it to S3 and insert the relevant metadata into the media table
+ * Requesting a file from HTTP GET {fileUrlPath}/{fileId} will:
+ *  1. check auth (if provided)
+ *  2. check the permissions in publish (if provided)
+ *  3. redirect the request to the signed url (if allowed)
+ *
+ * Specifying referencedTables will:
+ *  1. create a column in that table called media
+ *  2. create a lookup table lookup_media_{referencedTable} that joins referencedTable to the media table
+ */
+export declare type FileTableConfig = {
+    tableName?: string;
+    /**
+     * GET path used in serving media. defaults to /${tableName}
+     */
+    fileServeRoute?: string;
+    awsS3Config?: S3Config;
+    localConfig?: LocalConfig;
+    expressApp: ExpressApp;
+    referencedTables?: {
+        [tableName: string]: "one" | "many";
+    };
+    imageOptions?: ImageOptions;
+};
+export declare type ProstglesInitOptions<S = void> = {
+    dbConnection: DbConnection;
+    dbOptions?: DbConnectionOpts;
+    tsGeneratedTypesDir?: string;
+    io?: any;
+    publish?: Publish<S>;
+    publishMethods?: PublishMethods<S>;
+    publishRawSQL?(params: PublishParams<S>): ((boolean | "*") | Promise<(boolean | "*")>);
+    joins?: Joins;
+    schema?: string;
+    sqlFilePath?: string;
+    onReady(dbo: DBOFullyTyped<S>, db: DB): void;
+    transactions?: string | boolean;
+    wsChannelNamePrefix?: string;
+    onSocketConnect?(socket: PRGLIOSocket, dbo: DBOFullyTyped<S>, db?: DB): any;
+    onSocketDisconnect?(socket: PRGLIOSocket, dbo: DBOFullyTyped<S>, db?: DB): any;
+    auth?: Auth<S>;
+    DEBUG_MODE?: boolean;
+    watchSchemaType?: 
+    /**
+     * Will check client queries for schema changes
+     * Default
+     */
+    "events"
+    /**
+     * Will set database event trigger for schema changes. Requires superuser
+     */
+     | "queries";
+    watchSchema?: 
+    /**
+     * If true then DBoGenerated.d.ts will be updated and "onReady" will be called with new schema on both client and server
+     */
+    boolean
+    /**
+     * "hotReloadMode" will only rewrite the DBoGenerated.d.ts found in tsGeneratedTypesDir
+     * This is meant to be used in development when server restarts on file change
+     */
+     | "hotReloadMode"
+    /**
+     * Function called when schema changes. Nothing else triggered
+     */
+     | ((event: {
+        command: string;
+        query: string;
+    }) => void)
+    /**
+     * Schema checked for changes every 'checkIntervalMillis" milliseconds
+     */
+     | {
+        checkIntervalMillis: number;
+    };
+    keywords?: Keywords;
+    onNotice?: (notice: AnyObject, message?: string) => void;
+    fileTable?: FileTableConfig;
+    tableConfig?: TableConfig;
+};
+export declare type OnReady = {
+    dbo: DBHandlerServer;
+    db: DB;
+};
+import { DBOFullyTyped } from "./DBSchemaBuilder";
+export declare class Prostgles {
+    opts: ProstglesInitOptions;
+    db?: DB;
+    pgp?: PGP;
+    dbo?: DBHandlerServer;
+    _dboBuilder?: DboBuilder;
+    get dboBuilder(): DboBuilder;
+    set dboBuilder(d: DboBuilder);
+    publishParser?: PublishParser;
+    authHandler?: AuthHandler;
+    keywords: {
+        $filter: string;
+        $and: string;
+        $or: string;
+        $not: string;
+    };
+    private loaded;
+    dbEventsManager?: DBEventsManager;
+    fileManager?: FileManager;
+    tableConfigurator?: TableConfigurator;
+    isMedia(tableName: string): boolean;
+    constructor(params: ProstglesInitOptions);
+    destroyed: boolean;
+    onSchemaChange(event: {
+        command: string;
+        query: string;
+    }): Promise<void>;
+    checkDb(): void;
+    getTSFileName(): {
+        fileName: string;
+        fullPath: string;
+    };
+    private getFileText;
+    writeDBSchema(force?: boolean): void;
+    refreshDBO: () => Promise<DBHandlerServer>;
+    isSuperUser: boolean;
+    schema_checkIntervalMillis: any;
+    init(onReady: (dbo: DBOFullyTyped, db: DB) => any): Promise<{
+        db: DBOFullyTyped;
+        _db: DB;
+        pgp: PGP;
+        io?: any;
+        destroy: () => Promise<boolean>;
+    }>;
+    runSQLFile(filePath: string): Promise<any[][]>;
+    connectedSockets: any[];
+    setSocketEvents(): Promise<void>;
+    pushSocketSchema: (socket: any) => Promise<void>;
+}
+export declare function isSuperUser(db: DB): Promise<boolean>;
+//# sourceMappingURL=Prostgles.d.ts.map

package/lib/Prostgles.d.ts.map

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