@sqb/connect 4.12.0 → 4.13.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sqb/connect",
   "description": "Multi-dialect database connection framework written with TypeScript",
-  "version": "4.12.0",
+  "version": "4.13.0",
   "author": "Panates",
   "contributors": [
     "Eray Hanoglu <e.hanoglu@panates.com>",
@@ -25,19 +25,22 @@
     "build:esm": "tsc -b tsconfig-build-esm.json",
     "postbuild": "cp README.md package.json ../../LICENSE ../../build/connect && cp ../../package.cjs.json ../../build/connect/cjs/package.json",
     "lint": "eslint . --max-warnings=0",
+    "lint:fix": "eslint . --max-warnings=0 --fix",
+    "format": "prettier . --write --log-level=warn",
     "test": "jest",
     "cover": "jest --collect-coverage",
     "clean": "npm run clean:src | npm run clean:dist | npm run clean:cover",
     "clean:src": "ts-cleanup -s src --all",
     "clean:dist": "rimraf ../../build/connectt",
-    "clean:cover": "rimraf ../../coverage/connect",
-    "format": "prettier . --write --log-level=warn"
+    "clean:cover": "rimraf ../../coverage/connect"
   },
   "dependencies": {
     "debug": "^4.3.5",
+    "doublylinked": "^2.5.4",
+    "fast-tokenizer": "^1.3.0",
     "lightning-pool": "^4.2.2",
     "lodash": "^4.17.21",
-    "power-tasks": "^1.7.3",
+    "power-tasks": "^1.7.4",
     "putil-isplainobject": "^1.1.5",
     "putil-merge": "^3.12.1",
     "putil-promisify": "^1.10.1",
@@ -47,10 +50,11 @@
   },
   "devDependencies": {
     "@types/debug": "^4.1.12",
-    "@types/lodash": "^4.17.4"
+    "@types/lodash": "^4.17.7",
+    "postgresql-client": "^2.12.0"
   },
   "peerDependencies": {
-    "@sqb/builder": "^4.12.0",
+    "@sqb/builder": "^4.13.0",
     "reflect-metadata": "^0.2.2"
   },
   "engines": {

package/types/client/adapter.d.ts

@@ -1,5 +1,5 @@
-import { Maybe } from 'ts-gems';
 import { classes } from '@sqb/builder';
+import { Maybe } from 'ts-gems';
 import { ClientConfiguration, DataType, QueryRequest, RowType } from './types.js';
 export interface Adapter {
     driver: string;

package/types/client/cursor-stream.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import { Readable } from 'stream';
 import { Cursor } from './cursor.js';
 export interface CursorStreamOptions {

package/types/client/extensions.d.ts

@@ -1,4 +1,15 @@
+import { SerializerExtension } from '@sqb/builder';
 import { Adapter } from './adapter.js';
-export declare let adapters: Adapter[];
-export declare function registerAdapter(adapter: Adapter): void;
-export declare function unRegisterAdapter(...adapter: Adapter[]): void;
+export declare class AdapterRegistry {
+    protected static adapters: Adapter[];
+    static get size(): number;
+    static register(...adapters: Adapter[]): void;
+    static forEach(callback: (value: Adapter, index: number) => void, thisArg?: any): void;
+    static items(): IterableIterator<Adapter>;
+    static unRegister(...extensions: Adapter[]): void;
+    static getAll(dialect: string): Adapter[];
+    static get(index: number): SerializerExtension | undefined;
+    static findDialect(dialect: string): SerializerExtension | undefined;
+    static findDriver(dialect: string): SerializerExtension | undefined;
+    static has(extension: Adapter): boolean;
+}

package/types/client/sqb-client.d.ts

@@ -1,6 +1,6 @@
+import { classes } from '@sqb/builder';
 import { Pool as LightningPool } from 'lightning-pool';
 import { Maybe, Type } from 'ts-gems';
-import { classes } from '@sqb/builder';
 import { Repository } from '../orm/repository.class.js';
 import { SqbConnection } from './sqb-connection.js';
 import { ClientConfiguration, ClientDefaults, ConnectionOptions, QueryExecuteOptions, QueryRequest, QueryResult, TransactionFunction } from './types.js';

package/types/client/sqb-connection.d.ts

@@ -1,5 +1,5 @@
-import { Type } from 'ts-gems';
 import { classes } from '@sqb/builder';
+import { Type } from 'ts-gems';
 import { Repository } from '../orm/repository.class.js';
 import { Adapter } from './adapter.js';
 import { SqbClient } from './sqb-client.js';

package/types/client/types.d.ts

@@ -1,6 +1,6 @@
+import { DataType, ParamOptions } from '@sqb/builder';
 import type { PoolConfiguration } from 'lightning-pool';
 import { Maybe } from 'ts-gems';
-import { DataType, ParamOptions } from '@sqb/builder';
 import type { Adapter } from './adapter';
 import type { Cursor } from './cursor';
 import type { FieldInfoMap } from './field-info-map';

package/types/index.d.ts

@@ -1,23 +1,12 @@
 import 'reflect-metadata';
-export * from './client/types.js';
 export * from './client/adapter.js';
+export * from './client/cursor.js';
+export * from './client/extensions.js';
 export * from './client/sqb-client.js';
 export * from './client/sqb-connection.js';
-export * from './client/cursor.js';
-export { registerAdapter, unRegisterAdapter } from './client/extensions.js';
-export * from './orm/orm.type.js';
-export * from './orm/orm.const.js';
+export * from './client/types.js';
+export * from './orm/backward.js';
 export * from './orm/base-entity.js';
-export * from './orm/repository.class.js';
-export * from './orm/model/entity-metadata.js';
-export * from './orm/model/field-metadata.js';
-export * from './orm/model/column-field-metadata.js';
-export * from './orm/model/embedded-field-metadata.js';
-export * from './orm/model/association-field-metadata.js';
-export * from './orm/model/association.js';
-export * from './orm/model/association-node.js';
-export * from './orm/model/index-metadata.js';
-export * from './orm/model/link-chain.js';
 export * from './orm/decorators/column.decorator.js';
 export * from './orm/decorators/embedded.decorator.js';
 export * from './orm/decorators/entity.decorator.js';
@@ -27,5 +16,17 @@ export * from './orm/decorators/index.decorator.js';
 export * from './orm/decorators/link.decorator.js';
 export * from './orm/decorators/primarykey.decorator.js';
 export * from './orm/decorators/transform.decorator.js';
-export { isColumnField, isEmbeddedField, isAssociationField, isEntityClass } from './orm/util/orm.helper.js';
-export * from './orm/backward.js';
+export * from './orm/model/association.js';
+export * from './orm/model/association-field-metadata.js';
+export * from './orm/model/association-node.js';
+export * from './orm/model/column-field-metadata.js';
+export * from './orm/model/embedded-field-metadata.js';
+export * from './orm/model/entity-metadata.js';
+export * from './orm/model/field-metadata.js';
+export * from './orm/model/index-metadata.js';
+export * from './orm/model/link-chain.js';
+export * from './orm/orm.const.js';
+export * from './orm/orm.type.js';
+export * from './orm/repository.class.js';
+export { isAssociationField, isColumnField, isEmbeddedField, isEntityClass } from './orm/util/orm.helper.js';
+export * from './orm/util/parse-fields-projection.js';

package/types/orm/commands/find.command.d.ts

@@ -2,6 +2,7 @@ import { SqbConnection } from '../../client/sqb-connection.js';
 import { AssociationNode } from '../model/association-node.js';
 import { EntityMetadata } from '../model/entity-metadata.js';
 import { Repository } from '../repository.class.js';
+import { FieldsProjection } from '../util/parse-fields-projection.js';
 import { RowConverter } from './row-converter.js';
 export type FindCommandArgs = {
     entity: EntityMetadata;
@@ -29,9 +30,7 @@ export declare class FindCommand {
         tableAlias?: string;
         converter?: RowConverter;
         entity?: EntityMetadata;
-        pick?: string[];
-        omit?: string[];
-        include?: string[];
+        projection?: FieldsProjection | string | string[];
         sort?: string[];
         prefix?: string;
         suffix?: string;
@@ -39,6 +38,6 @@ export declare class FindCommand {
     private _selectColumn;
     filter(filter: any): Promise<void>;
     sort(sortFields: string[]): Promise<void>;
-    execute(args: Pick<FindCommandArgs, 'connection' | 'distinct' | 'offset' | 'limit' | 'params' | 'onTransformRow'>): Promise<any[]>;
+    execute(args: Pick<FindCommandArgs, 'connection' | 'distinct' | 'offset' | 'limit' | 'params' | 'onTransformRow' | 'prettyPrint'>): Promise<any[]>;
     private _getEntityFromAlias;
 }

package/types/orm/commands/row-converter.d.ts

@@ -1,5 +1,5 @@
-import { Type } from 'ts-gems';
 import { DataType } from '@sqb/builder';
+import { Type } from 'ts-gems';
 import type { FieldInfoMap } from '../../client/field-info-map';
 import { SqbConnection } from '../../client/sqb-connection.js';
 import { ColumnTransformFunction } from '../orm.type.js';

package/types/orm/decorators/column.decorator.d.ts

@@ -2,3 +2,4 @@ import { DataType } from '@sqb/builder';
 import { ColumnFieldOptions } from '../model/column-field-metadata.js';
 export declare function Column(type?: DataType): PropertyDecorator;
 export declare function Column(options?: ColumnFieldOptions): PropertyDecorator;
+export declare namespace Column { }

package/types/orm/model/field-metadata.d.ts

@@ -10,7 +10,7 @@ export interface FieldMetadata {
     hidden?: boolean;
     /**
      * Indicates whether or not to include this field by default when making queries.
-     * If this set to "true" the field must be requested using "include" or "pick" option.
+     * If this set to "true" the field must be requested using "projection" option.
      */
     exclusive?: boolean;
 }

package/types/orm/orm.const.d.ts

@@ -1,2 +1,3 @@
 export declare const ENTITY_METADATA_KEY: unique symbol;
 export declare const REPOSITORY_KEY: unique symbol;
+export declare const DECORATOR_FACTORY: unique symbol;

package/types/orm/repository.class.d.ts

@@ -1,14 +1,12 @@
-import { PartialDTO, PatchDTO, StrictOmit, Type } from 'ts-gems';
 import { LogicalOperator } from '@sqb/builder';
+import { PartialDTO, PatchDTO, StrictOmit, Type } from 'ts-gems';
 import { FieldInfoMap } from '../client/field-info-map.js';
 import { SqbClient } from '../client/sqb-client.js';
 import { SqbConnection } from '../client/sqb-connection.js';
 import { QueryRequest, TransactionFunction } from '../client/types.js';
 import { EntityMetadata } from './model/entity-metadata.js';
 interface Projection {
-    pick?: string[];
-    omit?: string[];
-    include?: string[];
+    projection?: string | string[];
 }
 interface Filtering {
     filter?: LogicalOperator | LogicalOperator[] | object | object[];
@@ -18,6 +16,7 @@ export declare namespace Repository {
     type TransformRowFunction = (fields: FieldInfoMap, row: object, obj: object) => void;
     interface CommandOptions {
         connection?: SqbConnection;
+        prettyPrint?: boolean;
     }
     interface CreateOptions extends CommandOptions, Projection {
     }
@@ -31,7 +30,7 @@ export declare namespace Repository {
     }
     interface FindOptions extends CommandOptions, Projection, Filtering {
     }
-    interface FindOneOptions extends CommandOptions, Projection, Filtering {
+    interface FindOneOptions extends FindOptions {
         sort?: string[];
         offset?: number;
     }
@@ -44,6 +43,8 @@ export declare namespace Repository {
     }
     interface UpdateOptions extends CommandOptions, Projection, Filtering {
     }
+    interface UpdateOnlyOptions extends CommandOptions, Filtering {
+    }
     interface UpdateManyOptions extends CommandOptions, Filtering {
     }
 }
@@ -63,16 +64,15 @@ export declare class Repository<T> extends Repository_base {
     create(values: PartialDTO<T>, options?: Repository.CreateOptions): Promise<PartialDTO<T>>;
     createOnly(values: PartialDTO<T>, options?: StrictOmit<Repository.CreateOptions, keyof Projection>): Promise<void>;
     exists(keyValue: any | Record<string, any>, options?: Repository.ExistsOptions): Promise<boolean>;
+    existsOne(options?: Repository.ExistsOptions): Promise<boolean>;
     count(options?: Repository.CountOptions): Promise<number>;
-    /** @deprecated - Use findById instead */
-    find(keyValue: any | Record<string, any>, options?: Repository.FindOptions): Promise<PartialDTO<T> | undefined>;
     findById(keyValue: any | Record<string, any>, options?: Repository.FindOptions): Promise<PartialDTO<T> | undefined>;
     findOne(options?: Repository.FindOneOptions): Promise<PartialDTO<T> | undefined>;
     findMany(options?: Repository.FindManyOptions): Promise<PartialDTO<T>[]>;
     delete(keyValue: any | Record<string, any>, options?: Repository.DeleteOptions): Promise<boolean>;
     deleteMany(options?: Repository.DeleteManyOptions): Promise<number>;
     update(keyValue: any | Record<string, any>, values: PatchDTO<T>, options?: Repository.UpdateOptions): Promise<PartialDTO<T> | undefined>;
-    updateOnly(keyValue: any | Record<string, any>, values: PatchDTO<T>, options?: StrictOmit<Repository.UpdateOptions, keyof Projection>): Promise<boolean>;
+    updateOnly(keyValue: any | Record<string, any>, values: PatchDTO<T>, options?: Repository.UpdateOnlyOptions): Promise<boolean>;
     updateMany(values: PartialDTO<T>, options?: Repository.UpdateManyOptions): Promise<number>;
     protected _execute(fn: TransactionFunction, opts?: Repository.CommandOptions): Promise<any>;
     protected _create(values: PartialDTO<T>, options: Repository.CreateOptions & {
@@ -82,6 +82,9 @@ export declare class Repository<T> extends Repository_base {
     protected _exists(keyValue: any | Record<string, any>, options: Repository.ExistsOptions & {
         connection: SqbConnection;
     }): Promise<boolean>;
+    protected _existsOne(options: Repository.ExistsOptions & {
+        connection: SqbConnection;
+    }): Promise<boolean>;
     protected _count(options: Repository.CountOptions & {
         connection: SqbConnection;
     }): Promise<number>;

package/types/orm/util/parse-fields-projection.d.ts

@@ -0,0 +1,10 @@
+export declare class FieldsProjection {
+    [key: string]: FieldsProjection.Item;
+}
+export declare namespace FieldsProjection {
+    class Item {
+        sign?: string;
+        projection?: FieldsProjection;
+    }
+}
+export declare function parseFieldsProjection(projection: string | string[], keepCase?: boolean): FieldsProjection | undefined;