@prostgles/app 2.3.6-dev.1788986038 → 2.3.6-dev.1789048658

package/dist/common/constants.d.ts

@@ -0,0 +1 @@
+export declare const CLIENT_LOGS_KEY = "__PRGL_DEBUG_LOGS";

package/dist/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../common/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,sBAAsB,CAAC"}

package/dist/common/constants.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLIENT_LOGS_KEY = void 0;
+exports.CLIENT_LOGS_KEY = "__PRGL_DEBUG_LOGS";

package/dist/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../common/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG,mBAAmB,CAAC"}

package/dist/common/managedTableSchema.d.ts

@@ -1,5 +1,6 @@
 import type { DBSSchema } from "./publishUtils";
 import type { RequiredKeepUndefined } from "./utils";
+export declare const auditTrailFilterColumns: readonly ["schema_name", "table_name", "old_id", "new_id"];
 export type ClientTableAuditConfig = {
     error: string;
 } | {

package/dist/common/managedTableSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"managedTableSchema.d.ts","sourceRoot":"","sources":["../../../common/managedTableSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,MAAM,sBAAsB,GAC9B;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IACE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEN,MAAM,MAAM,YAAY,GAAG,qBAAqB,CAC9C,WAAW,CACT,WAAW,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAC/D,GAAG;IACF,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;CACjD,CACF,GAAG;IAAE,KAAK,CAAC,EAAE,sBAAsB,CAAA;CAAE,CAAC;AACvC,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAC/C,WAAW,CACT,WAAW,CACT,WAAW,CACT,WAAW,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAC/D,CAAC,SAAS,CAAC,CACb,CAAC,MAAM,CAAC,CACV,CACF,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;CAgB1B,CAAC"}
+{"version":3,"file":"managedTableSchema.d.ts","sourceRoot":"","sources":["../../../common/managedTableSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD,eAAO,MAAM,uBAAuB,4DAK1B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAC9B;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IACE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEN,MAAM,MAAM,YAAY,GAAG,qBAAqB,CAC9C,WAAW,CACT,WAAW,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAC/D,GAAG;IACF,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;CACjD,CACF,GAAG;IAAE,KAAK,CAAC,EAAE,sBAAsB,CAAA;CAAE,CAAC;AACvC,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAC/C,WAAW,CACT,WAAW,CACT,WAAW,CACT,WAAW,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAC/D,CAAC,SAAS,CAAC,CACb,CAAC,MAAM,CAAC,CACV,CACF,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;CAgB1B,CAAC"}

package/dist/common/managedTableSchema.js

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.annotationsTableColumns = void 0;
+exports.annotationsTableColumns = exports.auditTrailFilterColumns = void 0;
+exports.auditTrailFilterColumns = [
+    "schema_name",
+    "table_name",
+    "old_id",
+    "new_id",
+];
 exports.annotationsTableColumns = {
     id: `INT GENERATED ALWAYS AS IDENTITY PRIMARY KEY`,
     file_id: `UUID NOT NULL`,

package/dist/common/managedTableSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"managedTableSchema.js","sourceRoot":"","sources":["../../../common/managedTableSchema.ts"],"names":[],"mappings":";;;AA4Ba,QAAA,uBAAuB,GAAG;IACrC,EAAE,EAAE,8CAA8C;IAClD,OAAO,EAAE,eAAe;IACxB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,oCAAoC;IAC1C,UAAU,EAAE;QACV,WAAW,EAAE;YACX,WAAW,EAAE;gBACX,CAAC,EAAE,QAAQ;gBACX,CAAC,EAAE,QAAQ;gBACX,KAAK,EAAE,QAAQ;gBACf,MAAM,EAAE,QAAQ;aACjB;SACF;KACF;CACO,CAAC"}
+{"version":3,"file":"managedTableSchema.js","sourceRoot":"","sources":["../../../common/managedTableSchema.ts"],"names":[],"mappings":";;;AAGa,QAAA,uBAAuB,GAAG;IACrC,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,QAAQ;CACA,CAAC;AA2BE,QAAA,uBAAuB,GAAG;IACrC,EAAE,EAAE,8CAA8C;IAClD,OAAO,EAAE,eAAe;IACxB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,oCAAoC;IAC1C,UAAU,EAAE;QACV,WAAW,EAAE;YACX,WAAW,EAAE;gBACX,CAAC,EAAE,QAAQ;gBACX,CAAC,EAAE,QAAQ;gBACX,KAAK,EAAE,QAAQ;gBACf,MAAM,EAAE,QAAQ;aACjB;SACF;KACF;CACO,CAAC"}

package/dist/common/mcp/ui.mcp.schema.js

@@ -54,7 +54,7 @@ exports.uiMcpSchema = {
         ${"```json"}
         {
           "files": {
-            "Dockerfile": "FROM node:18\nWORKDIR /app\nCOPY . .\nRUN npm install\nCMD [\"node\", \"index.js\"]",
+            "Dockerfile": "FROM node:24-trixie-slim\nWORKDIR /app\nCOPY . .\nRUN npm install\nCMD [\"node\", \"index.js\"]",
             "index.ts": "import type { JSONB } from \"prostgles-types\"; console.log('hello world');"
           }
         }

package/dist/common/prostglesApiTypes.d.ts

@@ -1,5 +1,5 @@
 /**
  * Generated file. Do not edit.
  */
-export declare const prostglesApiTypes = "/**\n * Data fetching and manipulation methods for interacting with the database\n */\n/**\n * List of fields to include or exclude\n */\nexport type FieldFilter<T extends AnyObject = AnyObject> = SelectTyped<T>;\nexport type AscOrDesc = 1 | -1 | boolean;\nexport type OrderByDetailed<T> = {\n    key: keyof T;\n    asc?: AscOrDesc | null;\n    nulls?: \"last\" | \"first\" | null;\n    nullEmpty?: boolean | null;\n};\n/**\n * `{ product_name: -1 }` -> SORT BY product_name DESC\n * [{ field_name: (1 | -1 | boolean) }]\n * true | 1 -> ascending\n * false | -1 -> descending\n * Array order is maintained\n * if nullEmpty is true then empty text will be replaced to null (so nulls sorting takes effect on it)\n */\nexport type OrderByTyped<T extends AnyObject> = {\n    [K in keyof Partial<T>]: AscOrDesc;\n} | {\n    [K in keyof Partial<T>]: AscOrDesc;\n}[] | OrderByDetailed<T> | OrderByDetailed<T>[] | Array<keyof T> | keyof T;\nexport type OrderBy<T extends AnyObject | void = void> = T extends AnyObject ? OrderByTyped<T> : OrderByTyped<AnyObject>;\nexport type CommonSelect = \"*\" | \"\" | {\n    \"*\": 1;\n};\nexport type SelectTyped<T extends AnyObject> = {\n    [K in keyof Partial<T>]: 1 | true;\n} | {\n    [K in keyof Partial<T>]: 0 | false;\n} | (keyof T)[] | CommonSelect;\nexport declare const JOIN_KEYS: readonly [\"$innerJoin\", \"$leftJoin\"];\nexport declare const JOIN_PARAMS: readonly [\"select\", \"filter\", \"$path\", \"$condition\", \"offset\", \"limit\", \"orderBy\"];\nexport type JoinCondition = {\n    column: string;\n    rootColumn: string;\n} | ComplexFilter;\nexport type JoinPath = {\n    table: string;\n    /**\n     * {\n     *    leftColumn: \"rightColumn\"\n     * }\n     */\n    on?: Record<string, string>[];\n};\n/**\n * Can be either the target table name, or the sequence of tables to join through with the target table at the end.\n */\nexport type RawJoinPath = string | (JoinPath | string)[];\nexport type DetailedJoinSelect = Partial<Record<(typeof JOIN_KEYS)[number], RawJoinPath>> & {\n    select: Select;\n    filter?: FullFilter<void, void>;\n    having?: FullFilter<void, void>;\n    offset?: number;\n    limit?: number;\n    orderBy?: OrderBy;\n} & ({\n    $condition?: undefined;\n} | {\n    /**\n     * If present then will overwrite $path and any inferred joins\n     */\n    $condition?: JoinCondition[];\n});\nexport type SimpleJoinSelect = \"*\"\n/** Aliased Shorthand join: table_name: { ...select } */\n | Record<string, 1 | \"*\" | true | FunctionSelect> | Record<string, 0 | false>;\nexport type JoinSelect = SimpleJoinSelect | DetailedJoinSelect;\n/**\n * Functions that take one column argument can be applied to the selected field by specifying the function name.\n * Example: { field: { funcName: [\"field\"] } }\n * Can be written as { field: \"funcName\" } if the field is the same as the argument\n */\ntype FunctionShorthand = string;\n/**\n * Common functions:\n *  - Aggregation functions: $count, $sum, $avg, $min, $max\n *  - String functions: $upper, $lower\n *  - Date functions: $age, $date_part\n *  - JSON functions: $merge\n */\ntype FunctionFull = Record<string, any[] | readonly any[] | FunctionShorthand>;\ntype FunctionSelect = FunctionShorthand | FunctionFull;\n/**\n * { computed_field: { funcName: [args] } }\n */\ntype FunctionAliasedSelect = Record<string, FunctionFull>;\ntype InclusiveSelect = true | 1 | FunctionSelect | JoinSelect;\ntype SelectWithFunctions<T extends AnyObject = AnyObject, IsTyped = false> = ({\n    [K in keyof Partial<T>]: InclusiveSelect;\n} & Record<string, IsTyped extends true ? FunctionFull : InclusiveSelect>) | FunctionAliasedSelect | {\n    [K in keyof Partial<T>]: true | 1 | string;\n} | {\n    [K in keyof Partial<T>]: 0 | false;\n} | CommonSelect | (keyof Partial<T>)[];\n/** S param is needed to ensure the non typed select works fine */\nexport type Select<T extends AnyObject | void = void, S extends DBSchema | void = void> = {\n    t: T;\n    s: S;\n} extends {\n    t: AnyObject;\n    s: DBSchema;\n} ? SelectWithFunctions<T & {\n    $rowhash: string;\n}, true> : SelectWithFunctions<AnyObject & {\n    $rowhash: string;\n}, false>;\nexport type SelectBasic = {\n    [key: string]: any;\n} | {} | undefined | \"\" | \"*\";\n/**\n * Will return the first row as an object. Will throw an error if more than a row is returned. Use limit: 1 to avoid error.\n */\ntype ReturnTypeRow = \"row\";\ntype CommonSelectParams = {\n    /**\n     * Max number of rows to return. Defaults to 1000\n     * - On client publish rules can affect this behaviour: cannot request more than the maxLimit (if present)\n     */\n    limit?: number | null;\n    /**\n     * Number of rows to skip\n     */\n    offset?: number;\n    /**\n     * Will group by all non aggregated fields specified in select (or all fields by default)\n     */\n    groupBy?: boolean;\n    /**\n     * Result data structure/type:\n     * - **row**: the first row as an object\n     * - **value**: the first value from of first field\n     * - **values**: array of values from the selected field\n     * - **statement**: sql statement\n     * - **statement-no-rls**: sql statement without row level security\n     * - **statement-where**: sql statement where condition\n     */\n    returnType?: ReturnTypeRow\n    /**\n     * Will return the first value from the selected field\n     */\n     | \"value\"\n    /**\n     * Will return an array of values from the selected field. Similar to array_agg(field).\n     */\n     | \"values\"\n    /**\n     * Will return the sql statement. Requires publishRawSQL privileges if called by client\n     */\n     | \"statement\"\n    /**\n     * Will return the sql statement excluding the user header. Requires publishRawSQL privileges if called by client\n     */\n     | \"statement-no-rls\"\n    /**\n     * Will return the sql statement where condition. Requires publishRawSQL privileges if called by client\n     */\n     | \"statement-where\";\n};\nexport type SelectParams<T extends AnyObject | void = void, S extends DBSchema | void = void> = CommonSelectParams & {\n    /**\n     * Fields/expressions/linked data to select\n     * - `\"*\"` or undefined will return all fields\n     * - `{ field: 0 }` - all fields except the specified field will be selected. Cannot be combined with inclusive selects (1, true, function or join selects)\n     * - `{ field: 1 }` - only the specified field will be selected\n     * - `{ field: { $funcName: [...args] } }` - the field will be selected with the specified function applied\n     * - `{ field: 1, referencedTable: \"*\" }` - field together with all fields from referencedTable will be returned (as an array). The referencedTable must have a reference to the current table through foreign keys for this to work\n     * - `{ linkedData: { $leftJoin: [\"lookupTable\", \"targetTable\"], select: { field: 1 } } }` - linkedData will contain the linked/joined records from referencedTable as an array of objects.\n     */\n    select?: Select<T, S>;\n    /**\n     * Order by options\n     * - Order is maintained in arrays\n     * - `[{ key: \"field\", asc: true, nulls: \"last\" }]`\n     */\n    orderBy?: OrderBy<S extends DBSchema ? T : void>;\n    /**\n     * Filter applied after any aggregations (group by)\n     */\n    having?: FullFilter<T, S>;\n    abortSignal?: AbortSignal;\n};\ntype SubscribeActions = \"insert\" | \"delete\" | \"update\";\nexport type SubscribeOptions = {\n    /**\n     * If true then the first value will not be emitted\n     * */\n    skipFirst?: boolean;\n    /**\n     * Controls which actions will trigger the subscription.\n     * If not provided then all actions will be triggered\n     */\n    actions?: Partial<Record<SubscribeActions, true> | Record<SubscribeActions, false>>;\n    /**\n     * If true then the subscription will be triggered without first checking if selected column values have changed\n     * @default false\n     */\n    skipChangedColumnsCheck?: boolean;\n    /**\n     * If provided then the subscription will be throttled to the provided number of milliseconds\n     */\n    throttle?: number;\n    throttleOpts?: {\n        /**\n         * False by default.\n         * If true then the first value will be emitted at the end of the interval. Instant otherwise\n         * */\n        skipFirst?: boolean;\n    };\n};\nexport type SubscribeParams<T extends AnyObject | void = void, S extends DBSchema | void = void> = SelectParams<T, S> & SubscribeOptions;\nexport type InsertParams<T extends AnyObject | void = void, S extends DBSchema | void = void> = {\n    /**\n     * If defined will returns the specified fields of the updated record(s)\n     */\n    returning?: Select<T, S>;\n    /**\n     * By default the insert may fail due to a unique/exclusion constraint violation error. To control this:\n     * - DoNothing: will ignore the error and do nothing\n     * - DoUpdate: will update all non primary key columns of the conflicting row\n     */\n    onConflict?: \"DoNothing\" | \"DoUpdate\" | {\n        action: \"DoNothing\" | \"DoUpdate\";\n        conflictColumns: string[];\n    };\n    /**\n     * Used for sync.\n     * If true then only valid and allowed fields will be inserted\n     */\n    removeDisallowedFields?: boolean;\n} & Pick<CommonSelectParams, \"returnType\">;\ntype CollapseNumberIfStringPresent<T> = [\n    Extract<T, string>\n] extends [never] ? T : Exclude<T, number>;\nexport type NormalizedRow<T extends Record<string, unknown>> = Required<{\n    [K in keyof T]: CollapseNumberIfStringPresent<T[K]>;\n}>;\ntype JoinedSelect = Record<string, Select>;\nexport type SelectFunction = Record<string, any[]>;\ntype ParseSelect<Select extends SelectParams<TD>[\"select\"], TD extends AnyObject> = (Select extends {\n    \"*\": 1;\n} ? NormalizedRow<TD> : {}) & {\n    [Key in keyof Omit<Select, \"*\"> & string]: Select[Key] extends 1 ? NormalizedRow<TD>[Key] : Select[Key] extends SelectFunction ? any : Select[Key] extends JoinedSelect ? any[] : any;\n};\ntype SelectDataType<S extends DBSchema | void, O extends SelectParams<TD, S>, TD extends AnyObject> = O extends {\n    returnType: \"value\";\n} ? any : O extends {\n    returnType: \"values\";\n    select: Record<string, 1>;\n} ? ValueOf<Pick<NormalizedRow<TD>, keyof O[\"select\"]>> : O extends {\n    returnType: \"values\";\n} ? any : O extends {\n    select: \"*\";\n} ? NormalizedRow<TD> : O extends {\n    select: \"\";\n} ? Record<string, never> : O extends {\n    select: Record<string, 0>;\n} ? Omit<NormalizedRow<TD>, keyof O[\"select\"]> : O extends {\n    select: Record<string, any>;\n} ? ParseSelect<O[\"select\"], NormalizedRow<TD>> : NormalizedRow<TD>;\nexport type SelectReturnType<S extends DBSchema | void, O extends SelectParams<TD, S>, TD extends AnyObject, isMulti extends boolean> = O extends {\n    returnType: \"statement\";\n} ? string : isMulti extends true ? SelectDataType<S, O, TD>[] : SelectDataType<S, O, TD>;\nexport type UpdateParams<T extends AnyObject | void = void, S extends DBSchema | void = void> = {\n    /**\n     * If defined will returns the specified fields of the updated record(s)\n     */\n    returning?: Select<T, S>;\n    /**\n     * Used for sync.\n     * If true then only valid and allowed fields will be updated\n     */\n    removeDisallowedFields?: boolean;\n    /**\n     * true by default.\n     * When set to false the update will throw an error if more than one row is updated (but the update will commit).\n     * */\n    multi?: boolean;\n} & Pick<CommonSelectParams, \"returnType\">;\ntype GetReturningReturnType<O extends UpdateParams<TD, S>, TD extends AnyObject, S extends DBSchema | void = void> = O extends {\n    returning: \"*\";\n} ? NormalizedRow<TD> : O extends {\n    returning: \"\";\n} ? Record<string, never> : O extends {\n    returning: Record<string, 1>;\n} ? Pick<NormalizedRow<TD>, keyof O[\"returning\"]> : O extends {\n    returning: Record<string, 0>;\n} ? Omit<NormalizedRow<TD>, keyof O[\"returning\"]> : void;\n/**\n *\n * Nothing is returned by default.\n * `returning` must be specified to return the updated records.\n */\nexport type UpdateReturnType<O extends UpdateParams<TD, S>, TD extends AnyObject, S extends DBSchema | void = void> = O extends {\n    multi: false;\n} ? GetReturningReturnType<O, TD, S> : GetReturningReturnType<O, TD, S>[];\n/**\n * Nothing is returned by default.\n * `returning` must be specified to return the updated records.\n * If an array of records is inserted then an array of records will be returned\n * otherwise a single record will be returned.\n */\nexport type InsertReturnType<Data extends AnyObject, O extends UpdateParams<TD, S>, TD extends AnyObject, S extends DBSchema | void = void> = Data extends any[] | readonly any[] ? GetReturningReturnType<O, TD, S>[] : GetReturningReturnType<O, TD, S>;\nexport type SubscriptionHandler = {\n    unsubscribe: () => Promise<void>;\n    filter: FullFilter<void, void> | {};\n};\n/**\n * Callback fired once after subscribing and then every time the data matching the filter changes\n */\ntype SubscribeCallback<ItemsDataType> = (items: ItemsDataType, \n/**\n * Error due to schema changes or other post subscribe issues\n * Column or filter issues are thrown during the subscribe call\n */\nerror?: unknown) => void | Promise<void>;\n/**\n * Callback fired once after subscribing and then every time the data matching the filter changes\n */\ntype SubscribeOneCallback<ItemDataType> = (item: ItemDataType) => void | Promise<void>;\nexport type AllowedTSType = string | number | boolean | Date | unknown;\nexport type CastFromTSToPG<T extends AllowedTSType> = T extends number ? T | string : T extends string ? T | number | Date : T extends boolean ? T | string : T extends Date ? T | string : T;\nexport type UpsertDataToPGCast<TD extends AnyObject> = {\n    [K in keyof TD]: CastFromTSToPG<TD[K]> | Record<\"$merge\", unknown[]>;\n};\nexport type PartialLax<T = AnyObject> = Partial<T>;\ntype UpsertDataToPGCastLax<T extends AnyObject> = PartialLax<UpsertDataToPGCast<T>>;\nexport type DeleteParams<T extends AnyObject | void = void, S extends DBSchema | void = void> = {\n    returning?: Select<T, S>;\n} & Pick<CommonSelectParams, \"returnType\">;\n/**\n * TODO: pick only joined tables from schema AND exclude parent fkey columns from the nested data\n */\nexport type InsertDataWithNested<TD extends AnyObject, S extends DBSchema | void> = UpsertDataToPGCast<TD> & (S extends DBSchema ? string extends keyof S ? {} : {\n    [TableName in keyof S]?: Partial<InsertDataWithNested<S[TableName][\"columns\"], S>>[];\n} : {});\n/**\n * Methods for interacting with a table/view\n * - On client-side some methods are restricted (and undefined) based on publish rules on the server\n */\nexport type TableHandler<TD extends AnyObject = AnyObject, S extends DBSchema | void = void, TName extends (S extends DBSchema ? keyof S : never) = never> = {\n    /**\n     * Retrieves the table/view info\n     */\n    getInfo(\n    /**\n     * Language code for i18n data. \"en\" by default\n     */\n    lang?: string): Promise<TableInfo>;\n    /**\n     * Retrieves columns metadata of the table/view\n     */\n    getColumns(\n    /**\n     * Language code for i18n data. \"en\" by default\n     */\n    lang?: string, params?: GetColumnsParams): Promise<ValidatedColumnInfo[]>;\n    /**\n     * Retrieves a list of matching records from the view/table\n     */\n    find<P extends SelectParams<TD, S>>(\n    /**\n     * A filter for a table, defined as a MongoDB-like query object.\n     * Supported operators:\n     * - Comparison: $eq, $ne, $gt, $gte, $lt, $lte\n     * - Logical: $and, $or\n     * - Evaluation: $like, $ilike\n     * - Array: $in, $nin\n     * - Joins: $existsJoined: { [tableName]: TableFilter }\n     * @example\n     * {\n          $and: [\n            {\n              $or: [\n                { topic: { $in: [\"Prostgles\", \"Postgres\"] } },\n                { summary: { $ilike: \"%postgres%\" } },\n                { id: { $gt: 5 } },\n              ]\n            },\n            { summary: { $ne: null } }\n          ]\n        }\n    */\n    filter?: FullFilter<TD, S>, \n    /**\n     * @example\n     * {\n     *    select: {\n     *      field1: 1,\n     *      field2: 1,\n     *      referencedTable: \"*\", // all fields from the referenced table will be included in an array under the \"referencedTable\" key\n     *    },\n     *    orderBy: { field1: -1 },\n     *    limit: 10,\n     * }\n     */\n    selectParams?: P): Promise<SelectReturnType<S, P, TD, true>>;\n    /**\n     * Retrieves a record from the view/table\n     */\n    findOne<P extends SelectParams<TD, S>>(filter?: FullFilter<TD, S>, selectParams?: P): Promise<undefined | SelectReturnType<S, P, TD, false>>;\n    /**\n     * Retrieves a list of matching records from the view/table and subscribes to changes\n     */\n    subscribe<P extends SubscribeParams<TD, S>>(filter: FullFilter<TD, S>, params: P, onData: SubscribeCallback<SelectReturnType<S, P, TD, true>>): Promise<SubscriptionHandler>;\n    /**\n     * Retrieves first matching record from the view/table and subscribes to changes\n     */\n    subscribeOne<P extends SubscribeParams<TD, S>>(filter: FullFilter<TD, S>, params: P, onData: SubscribeOneCallback<SelectReturnType<S, P, TD, false> | undefined>): Promise<SubscriptionHandler>;\n    /**\n     * Returns the number of rows that match the filter\n     */\n    count<P extends SelectParams<TD, S>>(filter?: FullFilter<TD, S>, selectParams?: P): Promise<number>;\n    /**\n     * Returns result size in bits\n     */\n    size<P extends SelectParams<TD, S>>(filter?: FullFilter<TD, S>, selectParams?: P): Promise<string>;\n    /**\n     * Updates a record in the table based on the specified filter criteria\n     * - Use { multi: false } to ensure no more than one row is updated\n     */\n    update<P extends UpdateParams<TD, S>>(filter: FullFilter<TD, S>, newData: UpsertDataToPGCastLax<TD>, params?: P): Promise<UpdateReturnType<P, TD, S> | undefined>;\n    /**\n     * Updates multiple records in the table in a batch operation.\n     * - Each item in the `data` array contains a filter and the corresponding data to update.\n     */\n    updateBatch<P extends UpdateParams<TD, S>>(data: [FullFilter<TD, S>, UpsertDataToPGCastLax<TD>][], params?: P): Promise<null>;\n    /**\n     * Inserts a new record into the table.\n     */\n    insert<P extends InsertParams<TD, S>>(data: InsertDataWithNested<TD, S>, params?: P): Promise<GetReturningReturnType<P, TD, S>>;\n    /**\n     * Inserts new records into the table.\n     */\n    insertMany<P extends InsertParams<TD, S>>(data: InsertDataWithNested<TD, S>[], params?: P): Promise<GetReturningReturnType<P, TD, S>[]>;\n    /**\n     * Inserts or updates a record in the table.\n     * - If a record matching the `filter` exists, it updates the record.\n     * - If no matching record exists, it inserts a new record.\n     */\n    upsert<P extends UpdateParams<TD, S>>(filter: FullFilter<TD, S>, newData: UpsertDataToPGCastLax<TD>, params?: P): Promise<GetReturningReturnType<P, TD, S>>;\n    /**\n     * Deletes records from the table based on the specified filter criteria.\n     * - If no filter is provided, all records may be deleted (use with caution).\n     */\n    delete<P extends DeleteParams<TD, S>>(filter?: FullFilter<TD, S>, params?: P): Promise<GetReturningReturnType<P, TD, S>[]>;\n};\nexport type AsyncResult<T> = {\n    data?: undefined;\n    isLoading: true;\n    error?: undefined;\n} | {\n    data: T;\n    isLoading: boolean;\n    error?: unknown;\n};\nexport type HookOptions = {\n    /**\n     * Used to prevent the hook from fetching data\n     */\n    skip?: boolean;\n    /**\n     * Used to trigger re-fetching\n     */\n    deps?: any[];\n};\nexport type TableHandlerClientMethods<T extends AnyObject = AnyObject, S extends DBSchema | void = void> = {\n    /**\n     * Retrieves rows matching the filter and keeps them in sync\n     * - use { handlesOnData: true } to get optimistic updates method: $update\n     * - any changes to the row using the $update method will be reflected instantly\n     *    to all sync subscribers that were initiated with the same syncOptions\n     */\n    useSync?: <TD extends T, Opts extends SyncOptions>(basicFilter: EqualityFilter<TD>, syncOptions: Opts, hookOptions?: HookOptions) => AsyncResult<SyncDataItem<Required<TD>, Opts>[] | undefined>;\n    sync?: <TD extends T, Opts extends SyncOptions>(basicFilter: EqualityFilter<TD>, options: Opts, onChange: OnChange<TD, Opts>, onError?: OnErrorHandler) => Promise<SyncHandler<TD>>;\n    syncOne?: <TD extends T, Opts extends SyncOneOptions>(basicFilter: EqualityFilter<TD>, options: Opts, onChange: OnChangeOne<TD, Opts>, onError?: OnErrorHandler) => Promise<SingleSyncHandles<TD, Opts[\"handlesOnData\"]>>;\n    /**\n     * Retrieves the first row matching the filter and keeps it in sync\n     * - use { handlesOnData: true } to get optimistic updates method: $update\n     * - any changes to the row using the $update method will be reflected instantly\n     *    to all sync subscribers that were initiated with the same syncOptions\n     */\n    useSyncOne?: <TD extends T, Opts extends SyncOneOptions>(basicFilter: EqualityFilter<TD>, syncOptions: Opts, hookOptions?: HookOptions) => AsyncResult<SyncDataItem<Required<TD>, Opts> | undefined>;\n    /**\n     * Used internally to setup sync\n     */\n    _sync?: (filter: EqualityFilter<AnyObject> | undefined, selectParams: {\n        select: FieldFilter;\n    }, triggers: ClientSyncHandles) => Promise<DbTableSync>;\n    _syncInfo?: SyncTableInfo;\n    /**\n     * Retrieves a list of matching records from the view/table and subscribes to changes\n     */\n    useSubscribe: <SubParams extends SubscribeParams<T, S>>(filter?: FullFilter<T, S>, options?: SubParams, hookOptions?: HookOptions) => AsyncResult<SelectReturnType<S, SubParams, T, true> | undefined>;\n    /**\n     * Retrieves a matching record from the view/table and subscribes to changes\n     */\n    useSubscribeOne: <SubParams extends SubscribeParams<T, S>>(filter?: FullFilter<T, S>, options?: SubParams, hookOptions?: HookOptions) => AsyncResult<SelectReturnType<S, SubParams, T, false> | undefined>;\n    /**\n     * Retrieves a list of matching records from the view/table\n     */\n    useFind: <P extends SelectParams<T, S>>(filter?: FullFilter<T, S>, selectParams?: P, hookOptions?: HookOptions) => AsyncResult<SelectReturnType<S, P, T, true> | undefined>;\n    /**\n     * Retrieves first matching record from the view/table\n     */\n    useFindOne: <P extends SelectParams<T, S>>(filter?: FullFilter<T, S>, selectParams?: P, hookOptions?: HookOptions) => AsyncResult<SelectReturnType<S, P, T, false> | undefined>;\n    /**\n     * Returns the total number of rows matching the filter\n     */\n    useCount: <P extends SelectParams<T, S>>(filter?: FullFilter<T, S>, selectParams?: P, hookOptions?: HookOptions) => AsyncResult<number | undefined>;\n    /**\n     * Returns result size in bits matching the filter and selectParams\n     */\n    useSize: <P extends SelectParams<T, S>>(filter?: FullFilter<T, S>, selectParams?: P, hookOptions?: HookOptions) => AsyncResult<string | undefined>;\n};\nexport type TableHandlerClient<T extends AnyObject = AnyObject, S extends DBSchema | void = void> = TableHandler<T, S> & TableHandlerClientMethods<T, S>;\nexport type DBHandlerClient<Schema = void> = Schema extends DBSchema ? {\n    [tov_name in keyof Schema]: TableHandler<Schema[tov_name][\"columns\"], Schema> & TableHandlerClientMethods<Schema[tov_name][\"columns\"], Schema>;\n} : Record<string, Partial<TableHandler & TableHandlerClientMethods>>;\nexport type ClientOnReadyParams<DBSchema = void, FunctionHandler extends ClientFunctionHandler = ClientFunctionHandler, U extends UserLike = UserLike> = {\n    /**\n     * The database handler object.\n     * Only allowed tables and table methods are defined\n     */\n    db: Partial<DBHandlerClient<DBSchema>>;\n    sql: SQLHandler | undefined;\n    /**\n     * Server-side TS function handlers\n     * Only allowed methods are defined\n     */\n    methods: FunctionHandler | undefined;\n    methodSchema: ServerFunctionHandler | undefined;\n    /**\n     * Table schema with column permission details the client has access to\n     */\n    tableSchema: DBSchemaTable[] | undefined;\n    auth: AuthHandler<U>;\n    isReconnect: boolean;\n    socket: Socket;\n};\nexport\n";
+export declare const prostglesApiTypes = "/**\n * Data fetching and manipulation methods for interacting with the database\n */\n/**\n * List of fields to include or exclude\n */\nexport type FieldFilter<T extends AnyObject = AnyObject> = SelectTyped<T>;\nexport type AscOrDesc = 1 | -1 | boolean;\nexport type OrderByDetailed<T> = {\n    key: keyof T;\n    asc?: AscOrDesc | null;\n    nulls?: \"last\" | \"first\" | null;\n    nullEmpty?: boolean | null;\n};\n/**\n * `{ product_name: -1 }` -> SORT BY product_name DESC\n * [{ field_name: (1 | -1 | boolean) }]\n * true | 1 -> ascending\n * false | -1 -> descending\n * Array order is maintained\n * if nullEmpty is true then empty text will be replaced to null (so nulls sorting takes effect on it)\n */\nexport type OrderByTyped<T extends AnyObject> = {\n    [K in keyof Partial<T>]: AscOrDesc;\n} | {\n    [K in keyof Partial<T>]: AscOrDesc;\n}[] | OrderByDetailed<T> | OrderByDetailed<T>[] | Array<keyof T> | keyof T;\nexport type OrderBy<T extends AnyObject | void = void> = T extends AnyObject ? OrderByTyped<T> : OrderByTyped<AnyObject>;\nexport type CommonSelect = \"*\" | \"\" | {\n    \"*\": 1;\n};\nexport type SelectTyped<T extends AnyObject> = {\n    [K in keyof Partial<T>]: 1 | true;\n} | {\n    [K in keyof Partial<T>]: 0 | false;\n} | (keyof T)[] | CommonSelect;\nexport declare const JOIN_KEYS: readonly [\"$innerJoin\", \"$leftJoin\"];\nexport declare const JOIN_PARAMS: readonly [\"select\", \"filter\", \"$path\", \"$condition\", \"offset\", \"limit\", \"orderBy\"];\nexport type JoinCondition = {\n    column: string;\n    rootColumn: string;\n} | ComplexFilter;\nexport type JoinPath = {\n    table: string;\n    /**\n     * {\n     *    leftColumn: \"rightColumn\"\n     * }\n     */\n    on?: Record<string, string>[];\n};\n/**\n * Can be either the target table name, or the sequence of tables to join through with the target table at the end.\n */\nexport type RawJoinPath = string | (JoinPath | string)[];\nexport type DetailedJoinSelect = Partial<Record<(typeof JOIN_KEYS)[number], RawJoinPath>> & {\n    select: Select;\n    filter?: FullFilter<void, void>;\n    having?: FullFilter<void, void>;\n    offset?: number;\n    limit?: number;\n    orderBy?: OrderBy;\n} & ({\n    $condition?: undefined;\n} | {\n    /**\n     * If present then will overwrite $path and any inferred joins\n     */\n    $condition?: JoinCondition[];\n});\nexport type SimpleJoinSelect = \"*\"\n/** Aliased Shorthand join: table_name: { ...select } */\n | Record<string, 1 | \"*\" | true | FunctionSelect> | Record<string, 0 | false>;\nexport type JoinSelect = SimpleJoinSelect | DetailedJoinSelect;\n/**\n * Functions that take one column argument can be applied to the selected field by specifying the function name.\n * Example: { field: { funcName: [\"field\"] } }\n * Can be written as { field: \"funcName\" } if the field is the same as the argument\n */\ntype FunctionShorthand = string;\n/**\n * Common functions:\n *  - Aggregation functions: $count, $sum, $avg, $min, $max\n *  - String functions: $upper, $lower\n *  - Date functions: $age, $date_part\n *  - JSON functions: $merge\n */\ntype FunctionFull = Record<string, any[] | readonly any[] | FunctionShorthand>;\ntype FunctionSelect = FunctionShorthand | FunctionFull;\n/**\n * { computed_field: { funcName: [args] } }\n */\ntype FunctionAliasedSelect = Record<string, FunctionFull>;\ntype InclusiveSelect = true | 1 | FunctionSelect | JoinSelect;\ntype SelectWithFunctions<T extends AnyObject = AnyObject, IsTyped = false> = ({\n    [K in keyof Partial<T>]: InclusiveSelect;\n} & Record<string, IsTyped extends true ? FunctionFull : InclusiveSelect>) | FunctionAliasedSelect | {\n    [K in keyof Partial<T>]: true | 1 | string;\n} | {\n    [K in keyof Partial<T>]: 0 | false;\n} | CommonSelect | (keyof Partial<T>)[];\n/** S param is needed to ensure the non typed select works fine */\nexport type Select<T extends AnyObject | void = void, S extends DBSchema | void = void> = {\n    t: T;\n    s: S;\n} extends {\n    t: AnyObject;\n    s: DBSchema;\n} ? SelectWithFunctions<T & {\n    $rowhash: string;\n}, true> : SelectWithFunctions<AnyObject & {\n    $rowhash: string;\n}, false>;\nexport type SelectBasic = {\n    [key: string]: any;\n} | {} | undefined | \"\" | \"*\";\n/**\n * Will return the first row as an object. Will throw an error if more than a row is returned. Use limit: 1 to avoid error.\n */\ntype ReturnTypeRow = \"row\";\ntype CommonSelectParams = {\n    /**\n     * Max number of rows to return. Defaults to 1000\n     * - On client publish rules can affect this behaviour: cannot request more than the maxLimit (if present)\n     */\n    limit?: number | null;\n    /**\n     * Number of rows to skip\n     */\n    offset?: number;\n    /**\n     * Will group by all non aggregated fields specified in select (or all fields by default)\n     */\n    groupBy?: boolean;\n    /**\n     * Result data structure/type:\n     * - **row**: the first row as an object\n     * - **value**: the first value from of first field\n     * - **values**: array of values from the selected field\n     * - **statement**: sql statement\n     * - **statement-no-rls**: sql statement without row level security\n     * - **statement-where**: sql statement where condition\n     */\n    returnType?: ReturnTypeRow\n    /**\n     * Will return the first value from the selected field\n     */\n     | \"value\"\n    /**\n     * Will return an array of values from the selected field. Similar to array_agg(field).\n     */\n     | \"values\"\n    /**\n     * Will return the sql statement. Requires publishRawSQL privileges if called by client\n     */\n     | \"statement\"\n    /**\n     * Will return the sql statement excluding the user header. Requires publishRawSQL privileges if called by client\n     */\n     | \"statement-no-rls\"\n    /**\n     * Will return the sql statement where condition. Requires publishRawSQL privileges if called by client\n     */\n     | \"statement-where\";\n};\nexport type SelectParams<T extends AnyObject | void = void, S extends DBSchema | void = void> = CommonSelectParams & {\n    /**\n     * Fields/expressions/linked data to select\n     * - `\"*\"` or undefined will return all fields\n     * - `{ field: 0 }` - all fields except the specified field will be selected. Cannot be combined with inclusive selects (1, true, function or join selects)\n     * - `{ field: 1 }` - only the specified field will be selected\n     * - `{ field: { $funcName: [...args] } }` - the field will be selected with the specified function applied\n     * - `{ field: 1, referencedTable: \"*\" }` - field together with all fields from referencedTable will be returned (as an array). The referencedTable must have a reference to the current table through foreign keys for this to work\n     * - `{ linkedData: { $leftJoin: [\"lookupTable\", \"targetTable\"], select: { field: 1 } } }` - linkedData will contain the linked/joined records from referencedTable as an array of objects.\n     */\n    select?: Select<T, S>;\n    /**\n     * Order by options\n     * - Order is maintained in arrays\n     * - `[{ key: \"field\", asc: true, nulls: \"last\" }]`\n     */\n    orderBy?: OrderBy<S extends DBSchema ? T : void>;\n    /**\n     * Filter applied after any aggregations (group by)\n     */\n    having?: FullFilter<T, S>;\n    abortSignal?: AbortSignal;\n};\ntype SubscribeActions = \"insert\" | \"delete\" | \"update\";\nexport type SubscribeOptions = {\n    /**\n     * If true then the first value will not be emitted\n     * */\n    skipFirst?: boolean;\n    /**\n     * Controls which actions will trigger the subscription.\n     * If not provided then all actions will be triggered\n     */\n    actions?: Partial<Record<SubscribeActions, true> | Record<SubscribeActions, false>>;\n    /**\n     * If true then the subscription will be triggered without first checking if selected column values have changed\n     * @default false\n     */\n    skipChangedColumnsCheck?: boolean;\n    /**\n     * If provided then the subscription will be throttled to the provided number of milliseconds\n     */\n    throttle?: number;\n    throttleOpts?: {\n        /**\n         * False by default.\n         * If true then the first value will be emitted at the end of the interval. Instant otherwise\n         * */\n        skipFirst?: boolean;\n    };\n};\nexport type SubscribeParams<T extends AnyObject | void = void, S extends DBSchema | void = void> = SelectParams<T, S> & SubscribeOptions;\nexport type InsertParams<T extends AnyObject | void = void, S extends DBSchema | void = void> = {\n    /**\n     * If defined will returns the specified fields of the updated record(s)\n     */\n    returning?: Select<T, S>;\n    /**\n     * By default the insert may fail due to a unique/exclusion constraint violation error. To control this:\n     * - DoNothing: will ignore the error and do nothing\n     * - DoUpdate: will update all non primary key columns of the conflicting row\n     */\n    onConflict?: \"DoNothing\" | \"DoUpdate\" | {\n        action: \"DoNothing\" | \"DoUpdate\";\n        conflictColumns: string[];\n    };\n    /**\n     * Used for sync.\n     * If true then only valid and allowed fields will be inserted\n     */\n    removeDisallowedFields?: boolean;\n} & Pick<CommonSelectParams, \"returnType\">;\ntype CollapseNumberIfStringPresent<T> = [\n    Extract<T, string>\n] extends [never] ? T : Exclude<T, number>;\nexport type NormalizedRow<T extends Record<string, unknown>> = Required<{\n    [K in keyof T]: CollapseNumberIfStringPresent<T[K]>;\n}>;\ntype JoinedSelect = Record<string, Select>;\nexport type SelectFunction = Record<string, any[]>;\ntype ParseSelect<Select extends SelectParams<TD>[\"select\"], TD extends AnyObject> = (Select extends {\n    \"*\": 1;\n} ? NormalizedRow<TD> : {}) & {\n    [Key in keyof Omit<Select, \"*\"> & string]: Select[Key] extends 1 ? NormalizedRow<TD>[Key] : Select[Key] extends SelectFunction ? any : Select[Key] extends JoinedSelect ? any[] : any;\n};\ntype SelectDataType<S extends DBSchema | void, O extends SelectParams<TD, S>, TD extends AnyObject> = O extends {\n    returnType: \"value\";\n} ? any : O extends {\n    returnType: \"values\";\n    select: Record<string, 1>;\n} ? ValueOf<Pick<NormalizedRow<TD>, keyof O[\"select\"]>> : O extends {\n    returnType: \"values\";\n} ? any : O extends {\n    select: \"*\";\n} ? NormalizedRow<TD> : O extends {\n    select: \"\";\n} ? Record<string, never> : O extends {\n    select: Record<string, 0>;\n} ? Omit<NormalizedRow<TD>, keyof O[\"select\"]> : O extends {\n    select: Record<string, any>;\n} ? ParseSelect<O[\"select\"], NormalizedRow<TD>> : NormalizedRow<TD>;\nexport type SelectReturnType<S extends DBSchema | void, O extends SelectParams<TD, S>, TD extends AnyObject, isMulti extends boolean> = O extends {\n    returnType: \"statement\";\n} ? string : isMulti extends true ? SelectDataType<S, O, TD>[] : SelectDataType<S, O, TD>;\nexport type UpdateParams<T extends AnyObject | void = void, S extends DBSchema | void = void> = {\n    /**\n     * If defined will returns the specified fields of the updated record(s)\n     */\n    returning?: Select<T, S>;\n    /**\n     * Used for sync.\n     * If true then only valid and allowed fields will be updated\n     */\n    removeDisallowedFields?: boolean;\n    /**\n     * true by default.\n     * When set to false the update will throw an error if more than one row is updated (but the update will commit).\n     * */\n    multi?: boolean;\n} & Pick<CommonSelectParams, \"returnType\">;\ntype GetReturningReturnType<O extends UpdateParams<TD, S>, TD extends AnyObject, S extends DBSchema | void = void> = O extends {\n    returning: \"*\";\n} ? NormalizedRow<TD> : O extends {\n    returning: \"\";\n} ? Record<string, never> : O extends {\n    returning: Record<string, 1>;\n} ? Pick<NormalizedRow<TD>, keyof O[\"returning\"]> : O extends {\n    returning: Record<string, 0>;\n} ? Omit<NormalizedRow<TD>, keyof O[\"returning\"]> : void;\n/**\n *\n * Nothing is returned by default.\n * `returning` must be specified to return the updated records.\n */\nexport type UpdateReturnType<O extends UpdateParams<TD, S>, TD extends AnyObject, S extends DBSchema | void = void> = O extends {\n    multi: false;\n} ? GetReturningReturnType<O, TD, S> : GetReturningReturnType<O, TD, S>[];\n/**\n * Nothing is returned by default.\n * `returning` must be specified to return the updated records.\n * If an array of records is inserted then an array of records will be returned\n * otherwise a single record will be returned.\n */\nexport type InsertReturnType<Data extends AnyObject, O extends UpdateParams<TD, S>, TD extends AnyObject, S extends DBSchema | void = void> = Data extends any[] | readonly any[] ? GetReturningReturnType<O, TD, S>[] : GetReturningReturnType<O, TD, S>;\nexport type SubscriptionHandler = {\n    unsubscribe: () => Promise<void>;\n    filter: FullFilter<void, void> | {};\n};\n/**\n * Callback fired once after subscribing and then every time the data matching the filter changes\n */\ntype SubscribeCallback<ItemsDataType> = (items: ItemsDataType, \n/**\n * Error due to schema changes or other post subscribe issues\n * Column or filter issues are thrown during the subscribe call\n */\nerror?: unknown) => void | Promise<void>;\n/**\n * Callback fired once after subscribing and then every time the data matching the filter changes\n */\ntype SubscribeOneCallback<ItemDataType> = (item: ItemDataType) => void | Promise<void>;\nexport type AllowedTSType = string | number | boolean | Date | unknown;\nexport type CastFromTSToPG<T extends AllowedTSType> = T extends number ? T | string : T extends string ? T | number | Date : T extends boolean ? T | string : T extends Date ? T | string : T;\nexport type UpsertDataToPGCast<TD extends AnyObject> = {\n    [K in keyof TD]: CastFromTSToPG<TD[K]> | Record<\"$merge\", unknown[]>;\n};\nexport type PartialLax<T = AnyObject> = Partial<T>;\ntype UpsertDataToPGCastLax<T extends AnyObject> = PartialLax<UpsertDataToPGCast<T>>;\nexport type DeleteParams<T extends AnyObject | void = void, S extends DBSchema | void = void> = {\n    returning?: Select<T, S>;\n} & Pick<CommonSelectParams, \"returnType\">;\n/**\n * TODO: pick only joined tables from schema AND exclude parent fkey columns from the nested data\n */\nexport type InsertDataWithNested<TD extends AnyObject, S extends DBSchema | void, TName extends PropertyKey = never> = InsertColumnsWithReferences<TD, S, TName> & (S extends DBSchema ? string extends keyof S ? {} : {\n    [TableName in keyof S]?: Partial<InsertDataWithNested<S[TableName][\"columns\"], S, TableName>>[];\n} : {});\n/**\n * Methods for interacting with a table/view\n * - On client-side some methods are restricted (and undefined) based on publish rules on the server\n */\nexport type TableHandler<TD extends AnyObject = AnyObject, S extends DBSchema | void = void, TName extends PropertyKey = never> = {\n    /**\n     * Retrieves the table/view info\n     */\n    getInfo(\n    /**\n     * Language code for i18n data. \"en\" by default\n     */\n    lang?: string): Promise<TableInfo>;\n    /**\n     * Retrieves columns metadata of the table/view\n     */\n    getColumns(\n    /**\n     * Language code for i18n data. \"en\" by default\n     */\n    lang?: string, params?: GetColumnsParams): Promise<ValidatedColumnInfo[]>;\n    /**\n     * Retrieves a list of matching records from the view/table\n     */\n    find<P extends SelectParams<TD, S>>(\n    /**\n     * A filter for a table, defined as a MongoDB-like query object.\n     * Supported operators:\n     * - Comparison: $eq, $ne, $gt, $gte, $lt, $lte\n     * - Logical: $and, $or\n     * - Evaluation: $like, $ilike\n     * - Array: $in, $nin\n     * - Joins: $existsJoined: { [tableName]: TableFilter }\n     * @example\n     * {\n          $and: [\n            {\n              $or: [\n                { topic: { $in: [\"Prostgles\", \"Postgres\"] } },\n                { summary: { $ilike: \"%postgres%\" } },\n                { id: { $gt: 5 } },\n              ]\n            },\n            { summary: { $ne: null } }\n          ]\n        }\n    */\n    filter?: FullFilter<TD, S>, \n    /**\n     * @example\n     * {\n     *    select: {\n     *      field1: 1,\n     *      field2: 1,\n     *      referencedTable: \"*\", // all fields from the referenced table will be included in an array under the \"referencedTable\" key\n     *    },\n     *    orderBy: { field1: -1 },\n     *    limit: 10,\n     * }\n     */\n    selectParams?: P): Promise<SelectReturnType<S, P, TD, true>>;\n    /**\n     * Retrieves a record from the view/table\n     */\n    findOne<P extends SelectParams<TD, S>>(filter?: FullFilter<TD, S>, selectParams?: P): Promise<undefined | SelectReturnType<S, P, TD, false>>;\n    /**\n     * Retrieves a list of matching records from the view/table and subscribes to changes\n     */\n    subscribe<P extends SubscribeParams<TD, S>>(filter: FullFilter<TD, S>, params: P, onData: SubscribeCallback<SelectReturnType<S, P, TD, true>>): Promise<SubscriptionHandler>;\n    /**\n     * Retrieves first matching record from the view/table and subscribes to changes\n     */\n    subscribeOne<P extends SubscribeParams<TD, S>>(filter: FullFilter<TD, S>, params: P, onData: SubscribeOneCallback<SelectReturnType<S, P, TD, false> | undefined>): Promise<SubscriptionHandler>;\n    /**\n     * Returns the number of rows that match the filter\n     */\n    count<P extends SelectParams<TD, S>>(filter?: FullFilter<TD, S>, selectParams?: P): Promise<number>;\n    /**\n     * Returns result size in bits\n     */\n    size<P extends SelectParams<TD, S>>(filter?: FullFilter<TD, S>, selectParams?: P): Promise<string>;\n    /**\n     * Updates a record in the table based on the specified filter criteria\n     * - Use { multi: false } to ensure no more than one row is updated\n     */\n    update<P extends UpdateParams<TD, S>>(filter: FullFilter<TD, S>, newData: UpsertDataToPGCastLax<TD>, params?: P): Promise<UpdateReturnType<P, TD, S> | undefined>;\n    /**\n     * Updates multiple records in the table in a batch operation.\n     * - Each item in the `data` array contains a filter and the corresponding data to update.\n     */\n    updateBatch<P extends UpdateParams<TD, S>>(data: [FullFilter<TD, S>, UpsertDataToPGCastLax<TD>][], params?: P): Promise<null>;\n    /**\n     * Inserts a new record into the table.\n     */\n    insert<P extends InsertParams<TD, S>>(data: InsertDataWithNested<TD, S, TName>, params?: P): Promise<GetReturningReturnType<P, TD, S>>;\n    /**\n     * Inserts new records into the table.\n     */\n    insertMany<P extends InsertParams<TD, S>>(data: InsertDataWithNested<TD, S, TName>[], params?: P): Promise<GetReturningReturnType<P, TD, S>[]>;\n    /**\n     * Inserts or updates a record in the table.\n     * - If a record matching the `filter` exists, it updates the record.\n     * - If no matching record exists, it inserts a new record.\n     */\n    upsert<P extends UpdateParams<TD, S>>(filter: FullFilter<TD, S>, newData: UpsertDataToPGCastLax<TD>, params?: P): Promise<GetReturningReturnType<P, TD, S>>;\n    /**\n     * Deletes records from the table based on the specified filter criteria.\n     * - If no filter is provided, all records may be deleted (use with caution).\n     */\n    delete<P extends DeleteParams<TD, S>>(filter?: FullFilter<TD, S>, params?: P): Promise<GetReturningReturnType<P, TD, S>[]>;\n};\nexport type AsyncResult<T> = {\n    data?: undefined;\n    isLoading: true;\n    error?: undefined;\n} | {\n    data: T;\n    isLoading: boolean;\n    error?: unknown;\n};\nexport type HookOptions = {\n    /**\n     * Used to prevent the hook from fetching data\n     */\n    skip?: boolean;\n    /**\n     * Used to trigger re-fetching\n     */\n    deps?: any[];\n};\nexport type TableHandlerClientMethods<T extends AnyObject = AnyObject, S extends DBSchema | void = void> = {\n    /**\n     * Retrieves rows matching the filter and keeps them in sync\n     * - use { handlesOnData: true } to get optimistic updates method: $update\n     * - any changes to the row using the $update method will be reflected instantly\n     *    to all sync subscribers that were initiated with the same syncOptions\n     */\n    useSync?: <TD extends T, Opts extends SyncOptions>(basicFilter: EqualityFilter<TD>, syncOptions: Opts, hookOptions?: HookOptions) => AsyncResult<SyncDataItem<Required<TD>, Opts>[] | undefined>;\n    sync?: <TD extends T, Opts extends SyncOptions>(basicFilter: EqualityFilter<TD>, options: Opts, onChange: OnChange<TD, Opts>, onError?: OnErrorHandler) => Promise<SyncHandler<TD>>;\n    syncOne?: <TD extends T, Opts extends SyncOneOptions>(basicFilter: EqualityFilter<TD>, options: Opts, onChange: OnChangeOne<TD, Opts>, onError?: OnErrorHandler) => Promise<SingleSyncHandles<TD, Opts[\"handlesOnData\"]>>;\n    /**\n     * Retrieves the first row matching the filter and keeps it in sync\n     * - use { handlesOnData: true } to get optimistic updates method: $update\n     * - any changes to the row using the $update method will be reflected instantly\n     *    to all sync subscribers that were initiated with the same syncOptions\n     */\n    useSyncOne?: <TD extends T, Opts extends SyncOneOptions>(basicFilter: EqualityFilter<TD>, syncOptions: Opts, hookOptions?: HookOptions) => AsyncResult<SyncDataItem<Required<TD>, Opts> | undefined>;\n    /**\n     * Used internally to setup sync\n     */\n    _sync?: (filter: EqualityFilter<AnyObject> | undefined, selectParams: {\n        select: FieldFilter;\n    }, triggers: ClientSyncHandles) => Promise<DbTableSync>;\n    _syncInfo?: SyncTableInfo;\n    /**\n     * Retrieves a list of matching records from the view/table and subscribes to changes\n     */\n    useSubscribe: <SubParams extends SubscribeParams<T, S>>(filter?: FullFilter<T, S>, options?: SubParams, hookOptions?: HookOptions) => AsyncResult<SelectReturnType<S, SubParams, T, true> | undefined>;\n    /**\n     * Retrieves a matching record from the view/table and subscribes to changes\n     */\n    useSubscribeOne: <SubParams extends SubscribeParams<T, S>>(filter?: FullFilter<T, S>, options?: SubParams, hookOptions?: HookOptions) => AsyncResult<SelectReturnType<S, SubParams, T, false> | undefined>;\n    /**\n     * Retrieves a list of matching records from the view/table\n     */\n    useFind: <P extends SelectParams<T, S>>(filter?: FullFilter<T, S>, selectParams?: P, hookOptions?: HookOptions) => AsyncResult<SelectReturnType<S, P, T, true> | undefined>;\n    /**\n     * Retrieves first matching record from the view/table\n     */\n    useFindOne: <P extends SelectParams<T, S>>(filter?: FullFilter<T, S>, selectParams?: P, hookOptions?: HookOptions) => AsyncResult<SelectReturnType<S, P, T, false> | undefined>;\n    /**\n     * Returns the total number of rows matching the filter\n     */\n    useCount: <P extends SelectParams<T, S>>(filter?: FullFilter<T, S>, selectParams?: P, hookOptions?: HookOptions) => AsyncResult<number | undefined>;\n    /**\n     * Returns result size in bits matching the filter and selectParams\n     */\n    useSize: <P extends SelectParams<T, S>>(filter?: FullFilter<T, S>, selectParams?: P, hookOptions?: HookOptions) => AsyncResult<string | undefined>;\n};\nexport type TableHandlerClient<T extends AnyObject = AnyObject, S extends DBSchema | void = void> = TableHandler<T, S> & TableHandlerClientMethods<T, S>;\nexport type DBHandlerClient<Schema = void> = Schema extends DBSchema ? {\n    [tov_name in keyof Schema]: TableHandler<Schema[tov_name][\"columns\"], Schema> & TableHandlerClientMethods<Schema[tov_name][\"columns\"], Schema>;\n} : Record<string, Partial<TableHandler & TableHandlerClientMethods>>;\nexport type ClientOnReadyParams<DBSchema = void, FunctionHandler extends ClientFunctionHandler = ClientFunctionHandler, U extends UserLike = UserLike> = {\n    /**\n     * The database handler object.\n     * Only allowed tables and table methods are defined\n     */\n    db: Partial<DBHandlerClient<DBSchema>>;\n    sql: SQLHandler | undefined;\n    /**\n     * Server-side TS function handlers\n     * Only allowed methods are defined\n     */\n    methods: FunctionHandler | undefined;\n    methodSchema: ServerFunctionHandler | undefined;\n    /**\n     * Table schema with column permission details the client has access to\n     */\n    tableSchema: DBSchemaTable[] | undefined;\n    auth: AuthHandler<U>;\n    isReconnect: boolean;\n    socket: Socket;\n};\nexport\n";
 //# sourceMappingURL=prostglesApiTypes.d.ts.map

package/dist/common/prostglesApiTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prostglesApiTypes.d.ts","sourceRoot":"","sources":["../../../common/prostglesApiTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB,m/vBAmiB7B,CAAC"}
+{"version":3,"file":"prostglesApiTypes.d.ts","sourceRoot":"","sources":["../../../common/prostglesApiTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB,uiwBAmiB7B,CAAC"}

package/dist/common/prostglesApiTypes.js

@@ -343,14 +343,14 @@ export type DeleteParams<T extends AnyObject | void = void, S extends DBSchema |
 /**
  * TODO: pick only joined tables from schema AND exclude parent fkey columns from the nested data
  */
-export type InsertDataWithNested<TD extends AnyObject, S extends DBSchema | void> = UpsertDataToPGCast<TD> & (S extends DBSchema ? string extends keyof S ? {} : {
-    [TableName in keyof S]?: Partial<InsertDataWithNested<S[TableName]["columns"], S>>[];
+export type InsertDataWithNested<TD extends AnyObject, S extends DBSchema | void, TName extends PropertyKey = never> = InsertColumnsWithReferences<TD, S, TName> & (S extends DBSchema ? string extends keyof S ? {} : {
+    [TableName in keyof S]?: Partial<InsertDataWithNested<S[TableName]["columns"], S, TableName>>[];
 } : {});
 /**
  * Methods for interacting with a table/view
  * - On client-side some methods are restricted (and undefined) based on publish rules on the server
  */
-export type TableHandler<TD extends AnyObject = AnyObject, S extends DBSchema | void = void, TName extends (S extends DBSchema ? keyof S : never) = never> = {
+export type TableHandler<TD extends AnyObject = AnyObject, S extends DBSchema | void = void, TName extends PropertyKey = never> = {
     /**
      * Retrieves the table/view info
      */
@@ -440,11 +440,11 @@ export type TableHandler<TD extends AnyObject = AnyObject, S extends DBSchema |
     /**
      * Inserts a new record into the table.
      */
-    insert<P extends InsertParams<TD, S>>(data: InsertDataWithNested<TD, S>, params?: P): Promise<GetReturningReturnType<P, TD, S>>;
+    insert<P extends InsertParams<TD, S>>(data: InsertDataWithNested<TD, S, TName>, params?: P): Promise<GetReturningReturnType<P, TD, S>>;
     /**
      * Inserts new records into the table.
      */
-    insertMany<P extends InsertParams<TD, S>>(data: InsertDataWithNested<TD, S>[], params?: P): Promise<GetReturningReturnType<P, TD, S>[]>;
+    insertMany<P extends InsertParams<TD, S>>(data: InsertDataWithNested<TD, S, TName>[], params?: P): Promise<GetReturningReturnType<P, TD, S>[]>;
     /**
      * Inserts or updates a record in the table.
      * - If a record matching the \`filter\` exists, it updates the record.

package/dist/e2e/cli/index.d.ts

@@ -0,0 +1,18 @@
+import { type CreateTestDeploymentOptions, type TestDeployment } from "@prostgles/app/testing";
+import type { PageWIds } from "../tests/utils/utils";
+export { expect } from "@playwright/test";
+export { openTable, getTableWindow, insertRow, clickInsertRow, fillSmartForm, fillSmartFormAndInsert, setOrAddWorkspace, getDashboardUtils, type PageWIds, type LocatorWIds, } from "../tests/utils/utils";
+/** One isolated app per test; Playwright owns contexts and recording cleanup. */
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
+    clientLogs: void;
+} & {
+    deploymentOptions: CreateTestDeploymentOptions;
+    userKey: string;
+    deployment: TestDeployment;
+    app: {
+        page: PageWIds;
+        open: () => Promise<void>;
+    };
+}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+/** Paths are relative to the generated app's e2e/playwright.config.ts. */
+export declare const defineE2EConfig: () => import("@playwright/test").PlaywrightTestConfig<{}, {}>;

package/dist/e2e/cli/index.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineE2EConfig = exports.test = exports.getDashboardUtils = exports.setOrAddWorkspace = exports.fillSmartFormAndInsert = exports.fillSmartForm = exports.clickInsertRow = exports.insertRow = exports.getTableWindow = exports.openTable = exports.expect = void 0;
+const fixtures_1 = require("../tests/utils/fixtures");
+const test_1 = require("@playwright/test");
+const testing_1 = require("@prostgles/app/testing");
+var test_2 = require("@playwright/test");
+Object.defineProperty(exports, "expect", { enumerable: true, get: function () { return test_2.expect; } });
+var utils_1 = require("../tests/utils/utils");
+Object.defineProperty(exports, "openTable", { enumerable: true, get: function () { return utils_1.openTable; } });
+Object.defineProperty(exports, "getTableWindow", { enumerable: true, get: function () { return utils_1.getTableWindow; } });
+Object.defineProperty(exports, "insertRow", { enumerable: true, get: function () { return utils_1.insertRow; } });
+Object.defineProperty(exports, "clickInsertRow", { enumerable: true, get: function () { return utils_1.clickInsertRow; } });
+Object.defineProperty(exports, "fillSmartForm", { enumerable: true, get: function () { return utils_1.fillSmartForm; } });
+Object.defineProperty(exports, "fillSmartFormAndInsert", { enumerable: true, get: function () { return utils_1.fillSmartFormAndInsert; } });
+Object.defineProperty(exports, "setOrAddWorkspace", { enumerable: true, get: function () { return utils_1.setOrAddWorkspace; } });
+Object.defineProperty(exports, "getDashboardUtils", { enumerable: true, get: function () { return utils_1.getDashboardUtils; } });
+/** One isolated app per test; Playwright owns contexts and recording cleanup. */
+exports.test = fixtures_1.test.extend({
+    deploymentOptions: [{ configId: "e2e" }, { option: true }],
+    userKey: ["admin", { option: true }],
+    deployment: [
+        async ({ deploymentOptions }, use, testInfo) => {
+            const deployment = await (0, testing_1.createTestDeployment)({
+                ...deploymentOptions,
+                logPath: testInfo.outputPath("deployment.log"),
+            });
+            try {
+                await use(deployment);
+            }
+            finally {
+                await deployment.dispose();
+            }
+        },
+        { timeout: 120_000 },
+    ],
+    baseURL: async ({ deployment }, use) => await use(deployment.endpoint),
+    storageState: async ({ deployment, userKey }, use) => await use(deployment.storageStateAs(userKey)),
+    app: async ({ page, deployment }, use) => {
+        await use({
+            page: page,
+            open: async () => {
+                await page.goto(deployment.dashboardUrl);
+                await page.getByTestId("dashboard.menu").waitFor({ state: "visible" });
+            },
+        });
+    },
+});
+/** Paths are relative to the generated app's e2e/playwright.config.ts. */
+const defineE2EConfig = () => (0, test_1.defineConfig)({
+    testDir: "./tests",
+    outputDir: "./test-results",
+    reporter: [
+        ["html", { outputFolder: "./playwright-report", open: "never" }],
+    ],
+    timeout: 120_000,
+    workers: 1,
+    fullyParallel: false,
+    forbidOnly: !!process.env.CI,
+    retries: 0,
+    use: {
+        ...test_1.devices["Desktop Chrome"],
+        testIdAttribute: "data-command",
+        video: "on",
+        trace: "on",
+        screenshot: "only-on-failure",
+        actionTimeout: 15_000,
+    },
+});
+exports.defineE2EConfig = defineE2EConfig;

package/dist/e2e/cli/template.d.ts

@@ -0,0 +1,13 @@
+export declare const getE2ETemplate: (configId: string) => {
+    "playwright.config.ts": string;
+    "tsconfig.json": string;
+    ".gitignore": string;
+    "AGENTS.md": string;
+    tests: {
+        "fixtures.ts": string;
+        admin: {
+            "dashboard.spec.ts": string;
+        };
+    };
+};
+//# sourceMappingURL=template.d.ts.map

package/dist/e2e/cli/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../../e2e/cli/template.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM;;;;;;;;;;;CAuD7C,CAAC"}

package/dist/e2e/cli/template.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getE2ETemplate = void 0;
+const getE2ETemplate = (configId) => ({
+    "playwright.config.ts": `
+    import { defineE2EConfig } from "@prostgles/app/testing/ui";
+    export default defineE2EConfig();`,
+    "tsconfig.json": JSON.stringify({
+        compilerOptions: {
+            target: "ES2022",
+            module: "Node16",
+            moduleResolution: "Node16",
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            noEmit: true,
+        },
+        include: ["**/*.ts"],
+    }, null, 2),
+    ".gitignore": "test-results/\nplaywright-report/\n",
+    "AGENTS.md": `
+    # UI workflow tests
+
+    - Put business workflows in tests/<role>/*.spec.ts. Import test and expect from ../fixtures and UI helpers from @prostgles/app/testing/ui.
+    - Configure seeded users and deterministic data in tests/fixtures.ts using deploymentOptions.users and deploymentOptions.seed. Each test gets a fresh app and database; Docker must be available.
+    - Select a seeded user with test.use({ userKey: "member" }). Configure actual app permissions in src/; a user key is only a fixture name, not an authorization role.
+    - Start with await app.open(). Reuse openTable(app.page, tableName, true), getTableWindow(app.page, tableName), insertRow(app.page, tableName, values), fillSmartForm, fillSmartFormAndInsert, clickInsertRow and setOrAddWorkspace before adding selectors. These are the same helpers used by Prostgles UI's e2e tests.
+    - Assert visible business outcomes and denied actions for each role. Use deployment.connectProjectAs(userKey) when a database assertion helps. Keep app-specific helper functions here beside the workflows.
+    - Run npm run test:e2e:install once to install Chromium, then npm run test:e2e. To run a role or workflow: npm run test:e2e -- tests/admin or npm run test:e2e -- -g "workflow name".
+    - Videos and traces for every test, including passing tests, are saved in e2e/test-results/. Deployment and PostgreSQL logs are saved alongside them. Artifacts may contain test data and sessions; do not commit them.
+    - Run npm run test:e2e:report and select a test to play its video or inspect its trace. The HTML report is in e2e/playwright-report/. Results are replaced on the next run; copy them elsewhere inside the project if they must be kept.
+  `,
+    tests: {
+        "fixtures.ts": `
+      import { test as base } from "@prostgles/app/testing/ui";
+      export { expect } from "@prostgles/app/testing/ui";
+      export const test = base.extend({
+        deploymentOptions: {
+          configId: ${JSON.stringify(configId)},
+          users: [{ key: "admin", type: "admin" }, { key: "member", type: "default" }],
+          // seed: async ({ projectDatabase, stateDatabase }) => { ... },
+        },
+      });`,
+        admin: {
+            "dashboard.spec.ts": `
+        import { test, expect } from "../fixtures";
+        test.use({ userKey: "admin" });
+        test("admin opens the configured app", async ({ app }) => {
+          await app.open();
+          await expect(app.page.getByTestId("dashboard.menu")).toBeVisible();
+          // Add business workflows using openTable, insertRow and getTableWindow.
+        });`,
+        },
+    },
+});
+exports.getE2ETemplate = getE2ETemplate;
+//# sourceMappingURL=template.js.map

package/dist/e2e/cli/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../e2e/cli/template.ts"],"names":[],"mappings":";;;AAAO,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,CAAC;IACnD,sBAAsB,EAAE;;sCAEY;IACpC,eAAe,EAAE,IAAI,CAAC,SAAS,CAC7B;QACE,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,QAAQ;YAChB,gBAAgB,EAAE,QAAQ;YAC1B,MAAM,EAAE,IAAI;YACZ,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,IAAI;SACb;QACD,OAAO,EAAE,CAAC,SAAS,CAAC;KACrB,EACD,IAAI,EACJ,CAAC,CACF;IACD,YAAY,EAAE,qCAAqC;IACnD,WAAW,EAAE;;;;;;;;;;;GAWZ;IACD,KAAK,EAAE;QACL,aAAa,EAAE;;;;;sBAKG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;;;;UAIpC;QACN,KAAK,EAAE;YACL,mBAAmB,EAAE;;;;;;;YAOf;SACP;KACF;CACF,CAAC,CAAC;AAvDU,QAAA,cAAc,kBAuDxB"}