@samet-it/be-db-common 1.0.11 → 1.1.2

package/dist/connection/db.connection.d.ts

@@ -1,12 +1,11 @@
-import type { DbConnectionLike, DbExecOpt, DbQueryResultMore, DbQueryResultOne, DbConnOpt, DbMeta, DbOnAfter, DbConnProps } from "./index.types";
+import { DbConnectionLike, DbExecOpt, DbQueryResultMore, DbQueryResultOne, DbConnOpt, DbMeta, DbOnAfter, DbConnProps, DbRepoLink } from "./index.types";
 import { LoggerLike } from "@samet-it/be-base-common";
 import type { DbLines } from "../line";
-import type { DbRepoDef } from "../repo";
 import type { Opt } from "@leyyo/common";
 /**
  * DB connection abstract class
  * */
-export declare abstract class DbConnection<REPO extends DbRepoDef, META extends DbMeta, OPT extends DbExecOpt> implements DbConnectionLike<REPO, META, OPT> {
+export declare abstract class DbConnection<LINK extends DbRepoLink, META extends DbMeta, OPT extends DbExecOpt> implements DbConnectionLike<LINK, META, OPT> {
     /**
      * Logger
      * */
@@ -60,9 +59,9 @@ export declare abstract class DbConnection<REPO extends DbRepoDef, META extends
     /** {@inheritDoc} */
     exec<T>(fn: Promise<T>, p1?: string | Omit<OPT, 'printSql'>): Promise<T>;
     /** {@inheritDoc} */
-    abstract more<T>(repo: REPO, sql: string | DbLines, name?: string | DbExecOpt): Promise<DbQueryResultMore<T, META>>;
+    abstract more<T>(link: LINK, sql: string | DbLines, name?: string | DbExecOpt): Promise<DbQueryResultMore<T, META>>;
     /** {@inheritDoc} */
-    abstract one<T>(repo: REPO, sql: string | DbLines, name?: string | DbExecOpt): Promise<DbQueryResultOne<T, META>>;
+    abstract one<T>(link: LINK, sql: string | DbLines, name?: string | DbExecOpt): Promise<DbQueryResultOne<T, META>>;
     /**
      * It will be called during module based systems
      * */

package/dist/connection/index.types.d.ts

@@ -1,7 +1,6 @@
 import type { DbLines } from "../line";
-import type { DbRepoDef } from "../repo";
 import type { DbErrorOmit } from "../error";
-import { Opt } from "@leyyo/common";
+import type { Opt } from "@leyyo/common";
 /**
  * DB query result
  * */
@@ -129,7 +128,7 @@ export interface DbConnectionBase<OPT extends DbExecOpt = DbExecOpt> {
 /**
  * DB connection interface
  * */
-export interface DbConnectionLike<REPO extends DbRepoDef, META extends DbMeta, OPT extends DbExecOpt> extends DbConnectionBase {
+export interface DbConnectionLike<LINK extends DbRepoLink, META extends DbMeta, OPT extends DbExecOpt> extends DbConnectionBase {
     /**
      * Props on connection
      * */
@@ -171,23 +170,23 @@ export interface DbConnectionLike<REPO extends DbRepoDef, META extends DbMeta, O
     /**
      * Execute a sql and return rows
      *
-     * @param {DbRepoLike} repo - repository instance
+     * @param {DbRepoLink} link - repository link
      * @param {(string|DbLines)} sql - sql or sql lines
      * @param {(DbExecOpt|string)?} opt - option or query name
      * @return {Promise<DbQueryResultMore>} - rows
      * @async
      * */
-    more<T>(repo: REPO, sql: string | DbLines, opt?: string | OPT): Promise<DbQueryResultMore<T, META>>;
+    more<T>(link: LINK, sql: string | DbLines, opt?: string | OPT): Promise<DbQueryResultMore<T, META>>;
     /**
      * Execute a sql and return a row
      *
-     * @param {DbRepoLike} repo - repository instance
+     * @param {DbRepoLink} link - repository link
      * @param {(string|DbLines)} sql - sql or sql lines
      * @param {(DbExecOpt|string)?} opt - option or query name
      * @return {Promise<DbQueryResultOne>} - row
      * @async
      * */
-    one<T>(repo: REPO, sql: string | DbLines, opt?: string | OPT): Promise<DbQueryResultOne<T, META>>;
+    one<T>(link: LINK, sql: string | DbLines, opt?: string | OPT): Promise<DbQueryResultOne<T, META>>;
     /**
      * It will be called during module based systems
      *
@@ -292,3 +291,7 @@ export type DbOnAfter = () => Promise<void>;
  * DB connection events
  * */
 export type DbEvent = 'connected' | 'disconnected' | 'first-connected';
+/** Repository Link */
+export interface DbRepoLink {
+    path: string;
+}

package/dist/repo/db.repo.d.ts

@@ -1,4 +1,4 @@
-import type { DbCheckKeysResult, DbRepoProps, DbRepoLike, DbRepoOpt, DbRepoDef, DbCheckKeysTuple } from "./index.types";
+import type { DbCheckKeysResult, DbRepoProps, DbRepoLike, DbRepoOpt, DbCheckKeysTuple } from "./index.types";
 import type { DefDims, Entity, IdDocLike, LoggerLike, Pair, Portion, UrnDocLike, UrnTuple, View } from "@samet-it/be-base-common";
 import type { DbConnectionBase, DbExecOpt } from "../connection";
 import type { KeyValue, StrKey } from "@leyyo/common";
@@ -39,8 +39,6 @@ export declare abstract class DbRepo<CONN extends DbConnectionBase, OPT extends
     /** @inheritDoc */
     get props(): Readonly<DbRepoProps<CONN, ID, ENTITY>>;
     /** @inheritDoc */
-    get $def(): DbRepoDef;
-    /** @inheritDoc */
     $cast<T>(): T;
     protected _keyToUrn(key: KeyValue): string;
     /** @inheritDoc */

package/dist/repo/db.repo.js

@@ -233,10 +233,6 @@ class DbRepo {
         return this._props;
     }
     /** @inheritDoc */
-    get $def() {
-        return this;
-    }
-    /** @inheritDoc */
     $cast() {
         return this;
     }

package/dist/repo/index.types.d.ts

@@ -3,7 +3,7 @@ import type { DbConnectionBase, DbExecOpt } from "../connection";
 import type { DefDims, Portion, View } from "@samet-it/be-base-common";
 import type { QueryAny, QueryRegular } from "@leyyo/query";
 import type { CacheConnectionLike, CacheChannelLike } from "@samet-it/be-cache-common";
-import type { Fnc, KeyValue, StrKey } from "@leyyo/common";
+import type { KeyValue, StrKey } from "@leyyo/common";
 /**
  * Urn delimiter literals (options)
  * */
@@ -16,10 +16,6 @@ export interface DbRepoLike<CONN extends DbConnectionBase, OPT extends DbExecOpt
      * Props on repository
      * */
     get props(): Readonly<DbRepoProps<CONN, ID, ENTITY>>;
-    /**
-     * Converts current instance to flatten instance with ignoring generics
-     * */
-    get $def(): DbRepoDef;
     /**
      * Casts current instance to given type
      * */
@@ -391,7 +387,6 @@ export interface DbRepoLike<CONN extends DbConnectionBase, OPT extends DbExecOpt
      *
      * @param {Entity} doc - document object
      * @param {string?} dim - dimension, default: `def`
-     * @param {boolean?} ignoreCheck - ignores to check input
      * @return {Promise<IdDocLike>} - dim object
      * @async
      * */
@@ -487,7 +482,6 @@ export interface DbRepoLike<CONN extends DbConnectionBase, OPT extends DbExecOpt
      * */
     listPortions(keys: Array<KeyValue>, ignoreCheck?: boolean): Promise<Array<PORTION>>;
 }
-export type DbRepoDef = DbRepoLike<DbConnectionBase, DbExecOpt, KeyValue, Entity, UrnDocLike, keyof Entity, DefDims, Pair, View, Portion>;
 /**
  * DB repository option
  * */
@@ -501,20 +495,22 @@ export interface DbRepoOpt<ID extends KeyValue, ENTITY extends Entity<ID>> {
     /**
      * Model version
      *
-     * @default `1.0.0`
-     * @type {string}
+     * @default 1
+     * @type {number}
      * */
     version?: number;
     /**
      * Urn delimiter
      *
-     * @default `,` -- use comma
+     * @default ","
      * @type {UrnDelimiter}
      * */
     urnDelimiter?: UrnDelimiter;
     /**
      * Urn prefix, like domain:subdomain
      *
+     * @example domain:subdomain
+     *
      * @type {string}
      * */
     urnPrefix?: string;
@@ -522,7 +518,8 @@ export interface DbRepoOpt<ID extends KeyValue, ENTITY extends Entity<ID>> {
      * Id format, number or string
      * - if yes, it evaluates as integer
      * - if no, it evaluates as string, uuid etc
-     * @default `false`
+     *
+     * @default false
      * */
     useNumericId?: boolean;
     /**
@@ -531,7 +528,7 @@ export interface DbRepoOpt<ID extends KeyValue, ENTITY extends Entity<ID>> {
      * - if no, it generates number - timestamp
      *
      * @fields `createdAt`, `updatedAt`
-     * @default `false`
+     * @default false
      * */
     useIsoDate?: boolean;
     /**
@@ -539,8 +536,8 @@ export interface DbRepoOpt<ID extends KeyValue, ENTITY extends Entity<ID>> {
      * - if yes, id is same with urn
      * - if no, id is not same with urn
      *
-     * @fields `_urn`
-     * @default `false`
+     * @fields `_urn`, `id`
+     * @default false
      * */
     idSame?: boolean;
     /**
@@ -549,7 +546,7 @@ export interface DbRepoOpt<ID extends KeyValue, ENTITY extends Entity<ID>> {
      * - if no, it validates trash case
      *
      * @fields `_trashId`
-     * @default `false`
+     * @default false
      * */
     useSoftDelete?: boolean;
     /**
@@ -558,7 +555,7 @@ export interface DbRepoOpt<ID extends KeyValue, ENTITY extends Entity<ID>> {
      * - if no, it ignores `createdAt`
      *
      * @fields `createdAt`
-     * @default `false`
+     * @default false
      * */
     useCreatedAt?: boolean;
     /**
@@ -567,7 +564,7 @@ export interface DbRepoOpt<ID extends KeyValue, ENTITY extends Entity<ID>> {
      * - if no, it ignores `createdBy`
      *
      * @fields `createdBy`
-     * @default `false`
+     * @default false
      * */
     useCreatedBy?: boolean;
     /**
@@ -576,7 +573,7 @@ export interface DbRepoOpt<ID extends KeyValue, ENTITY extends Entity<ID>> {
      * - if no, it builds updatedAt
      *
      * @fields `updatedAt`
-     * @default `false`
+     * @default false
      * */
     useUpdatedAt?: boolean;
     /**
@@ -585,7 +582,7 @@ export interface DbRepoOpt<ID extends KeyValue, ENTITY extends Entity<ID>> {
      * - if no, it ignores `updatedBy`
      *
      * @fields `updatedBy`
-     * @default `false`
+     * @default false
      * */
     useUpdatedBy?: boolean;
     /**
@@ -594,7 +591,7 @@ export interface DbRepoOpt<ID extends KeyValue, ENTITY extends Entity<ID>> {
      * - if no, it ignores `_ver`
      *
      * @fields `_ver`
-     * @default `false`
+     * @default false
      * */
     useVersion?: boolean;
     /**
@@ -603,7 +600,7 @@ export interface DbRepoOpt<ID extends KeyValue, ENTITY extends Entity<ID>> {
      * - if no, it ignores `_rev`
      *
      * @fields `_rev`
-     * @default `false`
+     * @default false
      * */
     useRevision?: boolean;
     /**
@@ -612,27 +609,33 @@ export interface DbRepoOpt<ID extends KeyValue, ENTITY extends Entity<ID>> {
      * - if no, it ignores `_alpha`
      *
      * @fields `_alpha`
-     * @default `false`
+     *
+     * @param {Entity} doc
+     * @async
      * */
-    alphaFn?: Fnc;
+    alphaFn?: DbRepoExtensionLambda<ID, ENTITY>;
     /**
      * Manages `search` case, to power search
      * - if yes, it builds `_search`
      * - if no, it ignores `_search`
      *
-     * @fields `_alpha`
-     * @default `false`
+     * @fields `_search`
+     *
+     * @param {Entity} doc
+     * @async
      * */
-    searchFn?: Fnc;
+    searchFn?: DbRepoExtensionLambda<ID, ENTITY>;
     /**
      * Manages `irregular` case, to store irregular field which is not in model
      * - if yes, it builds `_irregular`
      * - if no, it ignores `_irregular`
      *
      * @fields `_irregular`
-     * @default `false`
+     *
+     * @param {Entity} doc
+     * @async
      * */
-    irregularFn?: Fnc;
+    irregularFn?: DbRepoExtensionLambda<ID, ENTITY>;
     /**
      * Field list which can not be set (update/replace)
      *
@@ -683,19 +686,62 @@ export interface DbCheckKeysResult<ID extends KeyValue> {
     urns: Array<string>;
     ordered: Array<DbCheckKeysTuple<ID>>;
 }
+/**
+ * Response model during key is being checked
+ * @tuple
+ *
+ * Options
+ * - if primary(urn) => `[value (string), '_urn'];
+ * - if secondary(id) => `[value (string|number), 'id'];
+ * */
 export type DbCheckKeysTuple<ID extends KeyValue> = [string, '_urn'] | [ID, 'id'];
 /**
  * DB `$toUrnTuple` lambda
- * @function
+ *
+ * @see {@link DbRepoLike#$toUrnTuple}
+ * @method
+ *
+ * @param {UrnDocLike} urnRec - an object which will be a source to generate an urn
+ * @return {UrnTuple} - tuple
  * */
 export type DbRepoToUrnTuple<URN extends UrnDocLike = UrnDocLike> = (urnRec: URN) => UrnTuple;
 /**
  * DB `toDim` lambda
- * @function
+ *
+ * @see {@link DbRepoLike#$toDim}
+ * @method
+ *
+ * @param {Entity} doc - document
+ * @param {DefDims} dim - dimension
  * */
 export type DbRepoToDim<R, ID extends KeyValue, ENTITY extends Entity<ID>, DIMS extends DefDims = DefDims> = (doc: ENTITY, dim: DIMS | undefined) => Promise<R>;
+/**
+ * Default model which contains keys
+ * */
 export interface DbIdLike {
+    /**
+     * Secondary key for an entity
+     *
+     * @type {KeyValue}
+     */
     id?: KeyValue;
-    urn?: string;
+    /**
+     * Primary key for an entity
+     *
+     * @type {string}
+     */
     _urn?: string;
+    /**
+     * Alternative usage for {@link #_urn}
+     *
+     * @type {string}
+     */
+    urn?: string;
 }
+/**
+ * Lambda to handle several extensions, ie: search, ...
+ *
+ * @param {Entity} doc - document
+ * @async
+ * */
+export type DbRepoExtensionLambda<ID extends KeyValue, ENTITY extends Entity<ID>> = (doc: ENTITY) => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@samet-it/be-db-common",
-  "version": "1.0.11",
+  "version": "1.1.2",
   "description": "Backend DB Common",
   "repository": {
     "type": "git",
@@ -63,8 +63,8 @@
     }
   },
   "dependencies": {
+    "@leyyo/query": "^1.2.2",
     "@leyyo/common": "^1.2.1",
-    "@leyyo/query": "^1.2.1",
     "@leyyo/type": "^1.1.1",
     "@samet-it/be-base-common": "^1.1.1",
     "@samet-it/be-cache-common": "^1.1.1"