@e22m4u/js-repository 0.6.5 → 0.8.0

package/src/relations/belongs-to-resolver.d.ts

@@ -1,46 +0,0 @@
-import {ModelData} from '../types.js';
-import {Service} from '@e22m4u/js-service';
-import {FilterClause} from '../filter/index.js';
-
-/**
- * Belongs to resolver.
- */
-export declare class BelongsToResolver extends Service {
-  /**
-   * Include to.
-   *
-   * @param entities
-   * @param sourceName
-   * @param targetName
-   * @param relationName
-   * @param foreignKey
-   * @param scope
-   */
-  includeTo(
-    entities: ModelData[],
-    sourceName: string,
-    targetName: string,
-    relationName: string,
-    foreignKey?: string,
-    scope?: FilterClause,
-  ): Promise<void>;
-
-  /**
-   * Include polymorphic to.
-   *
-   * @param entities
-   * @param sourceName
-   * @param relationName
-   * @param foreignKey
-   * @param discriminator
-   * @param scope
-   */
-  includePolymorphicTo(
-    entities: ModelData[],
-    sourceName: string,
-    relationName: string,
-    foreignKey?: string,
-    discriminator?: string,
-    scope?: FilterClause,
-  ): Promise<void>;
-}

package/src/relations/has-many-resolver.d.ts

@@ -1,67 +0,0 @@
-import {ModelData} from '../types.js';
-import {Service} from '@e22m4u/js-service';
-import {FilterClause} from '../filter/index.js';
-
-/**
- * Has many resolver.
- */
-export declare class HasManyResolver extends Service {
-  /**
-   * Include to.
-   *
-   * @param entities
-   * @param sourceName
-   * @param targetName
-   * @param relationName
-   * @param foreignKey
-   * @param scope
-   */
-  includeTo(
-    entities: ModelData[],
-    sourceName: string,
-    targetName: string,
-    relationName: string,
-    foreignKey: string,
-    scope?: FilterClause,
-  ): Promise<void>;
-
-  /**
-   * Include polymorphic to.
-   *
-   * @param entities
-   * @param sourceName
-   * @param targetName
-   * @param relationName
-   * @param foreignKey
-   * @param discriminator
-   * @param scope
-   */
-  includePolymorphicTo(
-    entities: ModelData[],
-    sourceName: string,
-    targetName: string,
-    relationName: string,
-    foreignKey: string,
-    discriminator: string,
-    scope?: FilterClause,
-  ): Promise<void>;
-
-  /**
-   * Include polymorphic by relation name.
-   *
-   * @param entities
-   * @param sourceName
-   * @param targetName
-   * @param relationName
-   * @param targetRelationName
-   * @param scope
-   */
-  includePolymorphicByRelationName(
-    entities: ModelData[],
-    sourceName: string,
-    targetName: string,
-    relationName: string,
-    targetRelationName: string,
-    scope?: FilterClause,
-  ): Promise<void>;
-}

package/src/relations/has-one-resolver.d.ts

@@ -1,67 +0,0 @@
-import {ModelData} from '../types.js';
-import {Service} from '@e22m4u/js-service';
-import {FilterClause} from '../filter/index.js';
-
-/**
- * Has one resolver.
- */
-export declare class HasOneResolver extends Service {
-  /**
-   * Include to.
-   *
-   * @param entities
-   * @param sourceName
-   * @param targetName
-   * @param relationName
-   * @param foreignKey
-   * @param scope
-   */
-  includeTo(
-    entities: ModelData[],
-    sourceName: string,
-    targetName: string,
-    relationName: string,
-    foreignKey: string,
-    scope?: FilterClause,
-  ): Promise<void>;
-
-  /**
-   * Include polymorphic to.
-   *
-   * @param entities
-   * @param sourceName
-   * @param targetName
-   * @param relationName
-   * @param foreignKey
-   * @param discriminator
-   * @param scope
-   */
-  includePolymorphicTo(
-    entities: ModelData[],
-    sourceName: string,
-    targetName: string,
-    relationName: string,
-    foreignKey: string,
-    discriminator: string,
-    scope?: FilterClause,
-  ): Promise<void>;
-
-  /**
-   * Include polymorphic by relation name.
-   *
-   * @param entities
-   * @param sourceName
-   * @param targetName
-   * @param relationName
-   * @param targetRelationName
-   * @param scope
-   */
-  includePolymorphicByRelationName(
-    entities: ModelData[],
-    sourceName: string,
-    targetName: string,
-    relationName: string,
-    targetRelationName: string,
-    scope?: FilterClause,
-  ): Promise<void>;
-}

package/src/relations/index.d.ts

@@ -1,4 +0,0 @@
-export * from './has-one-resolver.js';
-export * from './has-many-resolver.js';
-export * from './belongs-to-resolver.js';
-export * from './references-many-resolver.js';

package/src/relations/references-many-resolver.d.ts

@@ -1,27 +0,0 @@
-import {ModelData} from '../types.js';
-import {Service} from '@e22m4u/js-service';
-import {FilterClause} from '../filter/index.js';
-
-/**
- * References many resolver.
- */
-export declare class ReferencesManyResolver extends Service {
-  /**
-   * Include to.
-   *
-   * @param entities
-   * @param sourceName
-   * @param targetName
-   * @param relationName
-   * @param foreignKey
-   * @param scope
-   */
-  includeTo(
-    entities: ModelData[],
-    sourceName: string,
-    targetName: string,
-    relationName: string,
-    foreignKey?: string,
-    scope?: FilterClause,
-  ): Promise<void>;
-}

package/src/repository/index.d.ts

@@ -1,2 +0,0 @@
-export * from './repository.js';
-export * from './repository-registry.js';

package/src/repository/repository-registry.d.ts

@@ -1,29 +0,0 @@
-import {ModelId} from '../types.js';
-import {ModelData} from '../types.js';
-import {Service} from '@e22m4u/js-service';
-import {Repository} from './repository.js';
-import {Constructor} from '@e22m4u/js-service';
-import {DEFAULT_PRIMARY_KEY_PROPERTY_NAME} from '../definition/index.js';
-
-/**
- * Repository registry.
- */
-export declare class RepositoryRegistry extends Service {
-  /**
-   * Set repository registry.
-   *
-   * @param ctor
-   */
-  setRepositoryCtor(ctor: Constructor<Repository<any, any, any>>): void;
-
-  /**
-   * Get repository.
-   *
-   * @param modelName
-   */
-  getRepository<
-    Data extends ModelData = ModelData,
-    IdType extends ModelId = ModelId,
-    IdName extends string = typeof DEFAULT_PRIMARY_KEY_PROPERTY_NAME,
-  >(modelName: string): Repository<Data, IdType, IdName>;
-}

package/src/repository/repository.d.ts

@@ -1,183 +0,0 @@
-import {ModelId} from '../types.js';
-import {Flatten} from '../types.js';
-import {ModelData} from '../types.js';
-import {PartialBy} from '../types.js';
-import {Service} from '@e22m4u/js-service';
-import {Adapter} from '../adapter/index.js';
-import {WhereClause} from '../filter/index.js';
-import {FilterClause} from '../filter/index.js';
-import {ItemFilterClause} from '../filter/index.js';
-import {ServiceContainer} from '@e22m4u/js-service';
-import {DEFAULT_PRIMARY_KEY_PROPERTY_NAME} from '../definition/index.js';
-
-/**
- * Repository.
- */
-export declare class Repository<
-  Data extends object = ModelData,
-  IdType extends ModelId = ModelId,
-  IdName extends string = typeof DEFAULT_PRIMARY_KEY_PROPERTY_NAME,
-  FlatData extends object = Flatten<Data>,
-> extends Service {
-  // it fixes unused generic bug
-  private _Data?: Data;
-  private _IdType?: IdType;
-  private _IdName?: IdName;
-  private _FlatData?: FlatData;
-
-  /**
-   * Model name.
-   */
-  get modelName(): string;
-
-  /**
-   * Datasource name.
-   */
-  get datasourceName(): string;
-
-  /**
-   * Constructor.
-   *
-   * @param container
-   * @param modelName
-   */
-  constructor(container: ServiceContainer, modelName: string);
-
-  /**
-   * Get adapter.
-   */
-  getAdapter(): Promise<Adapter>;
-
-  /**
-   * Create.
-   *
-   * @param data
-   * @param filter
-   */
-  create(
-    data: WithOptionalId<FlatData, IdName>,
-    filter?: ItemFilterClause<FlatData>,
-  ): Promise<FlatData>;
-
-  /**
-   * Replace by id.
-   *
-   * @param id
-   * @param data
-   * @param filter
-   */
-  replaceById(
-    id: IdType,
-    data: WithoutId<FlatData, IdName>,
-    filter?: ItemFilterClause<FlatData>,
-  ): Promise<FlatData>;
-
-  /**
-   * Replace or create.
-   *
-   * @param data
-   * @param filter
-   */
-  replaceOrCreate(
-    data: WithOptionalId<FlatData, IdName>,
-    filter?: ItemFilterClause<FlatData>,
-  ): Promise<FlatData>;
-
-  /**
-   * Patch.
-   *
-   * @param data
-   * @param where
-   */
-  patch(
-    data: PartialWithoutId<FlatData, IdName>,
-    where?: WhereClause<FlatData>,
-  ): Promise<number>;
-
-  /**
-   * Patch by id.
-   *
-   * @param id
-   * @param data
-   * @param filter
-   */
-  patchById(
-    id: IdType,
-    data: PartialWithoutId<FlatData, IdName>,
-    filter?: ItemFilterClause<FlatData>,
-  ): Promise<FlatData>;
-
-  /**
-   * Find.
-   *
-   * @param filter
-   */
-  find(filter?: FilterClause<FlatData>): Promise<FlatData[]>;
-
-  /**
-   * Find one.
-   *
-   * @param filter
-   */
-  findOne(filter?: FilterClause<FlatData>): Promise<FlatData | undefined>;
-
-  /**
-   * Find by id.
-   *
-   * @param id
-   * @param filter
-   */
-  findById(id: IdType, filter?: ItemFilterClause<FlatData>): Promise<FlatData>;
-
-  /**
-   * Delete.
-   *
-   * @param where
-   */
-  delete(where?: WhereClause<FlatData>): Promise<number>;
-
-  /**
-   * Delete by id.
-   *
-   * @param id
-   */
-  deleteById(id: IdType): Promise<boolean>;
-
-  /**
-   * Exists.
-   *
-   * @param id
-   */
-  exists(id: IdType): Promise<boolean>;
-
-  /**
-   * Count.
-   *
-   * @param where
-   */
-  count(where?: WhereClause<FlatData>): Promise<number>;
-}
-
-/**
- * Removes id field.
- */
-export declare type WithoutId<
-  Data extends object,
-  IdName extends string = 'id',
-> = Flatten<Omit<Data, IdName>>;
-
-/**
- * Makes fields as optional and remove id field.
- */
-export declare type PartialWithoutId<
-  Data extends object,
-  IdName extends string = 'id',
-> = Flatten<Partial<Omit<Data, IdName>>>;
-
-/**
- * Makes the required id field as optional.
- */
-export declare type WithOptionalId<
-  Data extends object,
-  IdName extends string = 'id',
-> = Flatten<Data extends {[K in IdName]: any} ? PartialBy<Data, IdName> : Data>;

package/src/types.d.ts

@@ -1,43 +0,0 @@
-/**
- * Free-form object with open properties.
- */
-export declare type AnyObject = {
-  [property: string]: unknown;
-};
-
-/**
- * Makes specific field as optional.
- */
-export declare type PartialBy<T, K extends keyof T> = Omit<T, K> &
-  Partial<Pick<T, K>>;
-
-/**
- * Model data.
- */
-export declare type ModelData = Record<string, unknown>;
-
-/**
- * Model id.
- */
-export declare type ModelId = unknown;
-
-/**
- * Flatten.
- */
-type Identity<T> = T;
-export declare type Flatten<T> = Identity<{[k in keyof T]: T[k]}>;
-
-/**
- * A callable type with the "new" operator
- * allows class and constructor.
- */
-export interface Constructor<T = unknown> {
-  new (...args: any[]): T;
-}
-
-/**
- * Representing a value or promise. This type is used
- * to represent results of synchronous/asynchronous
- * resolution of values.
- */
-export type ValueOrPromise<T> = T | PromiseLike<T>;

package/src/types.js

@@ -1 +0,0 @@
-export {};

package/src/utils/capitalize.d.ts

@@ -1,6 +0,0 @@
-/**
- * Capitalize.
- *
- * @param string
- */
-export declare function capitalize(string: string): string;

package/src/utils/clone-deep.d.ts

@@ -1,6 +0,0 @@
-/**
- * Clone deep.
- *
- * @param value
- */
-export declare function cloneDeep<T>(value: T): T;

package/src/utils/exclude-object-keys.d.ts

@@ -1,10 +0,0 @@
-/**
- * Exclude object keys.
- *
- * @param obj
- * @param keys
- */
-export declare function excludeObjectKeys<T extends object>(
-  obj: T,
-  keys: string | string[],
-): Partial<T>;

package/src/utils/get-ctor-name.d.ts

@@ -1,6 +0,0 @@
-/**
- * Get ctor name.
- *
- * @param value
- */
-export declare function getCtorName(value: unknown): string | undefined;

package/src/utils/get-ctor-name.js

@@ -1,11 +0,0 @@
-/**
- * Get ctor name.
- *
- * @param {*} value
- * @returns {string|undefined}
- */
-export function getCtorName(value) {
-  if (value === null) return 'Null';
-  if (value === undefined) return 'Undefined';
-  return (value.constructor && value.constructor.name) || undefined;
-}

package/src/utils/get-ctor-name.spec.js

@@ -1,17 +0,0 @@
-import {expect} from 'chai';
-import {getCtorName} from './get-ctor-name.js';
-
-describe('getCtorName', function () {
-  it('returns a constructor name of a given value', function () {
-    expect(getCtorName({})).to.be.eq('Object');
-    expect(getCtorName(new Date())).to.be.eq('Date');
-    expect(getCtorName([])).to.be.eq('Array');
-    expect(getCtorName(() => undefined)).to.be.eq('Function');
-    expect(getCtorName('string')).to.be.eq('String');
-    expect(getCtorName(10)).to.be.eq('Number');
-    expect(getCtorName(true)).to.be.eq('Boolean');
-    expect(getCtorName(false)).to.be.eq('Boolean');
-    expect(getCtorName(null)).to.be.eq('Null');
-    expect(getCtorName(undefined)).to.be.eq('Undefined');
-  });
-});

package/src/utils/get-decorator-target-type.d.ts

@@ -1,27 +0,0 @@
-/**
- * Decorator target type.
- */
-export declare enum DecoratorTargetType {
-  CONSTRUCTOR = 'constructor',
-  INSTANCE = 'instance',
-  STATIC_METHOD = 'staticMethod',
-  INSTANCE_METHOD = 'instanceMethod',
-  STATIC_PROPERTY = 'staticProperty',
-  INSTANCE_PROPERTY = 'instanceProperty',
-  CONSTRUCTOR_PARAMETER = 'constructorParameter',
-  STATIC_METHOD_PARAMETER = 'staticMethodParameter',
-  INSTANCE_METHOD_PARAMETER = 'instanceMethodParameter',
-}
-
-/**
- * Get decorator target type.
- *
- * @param target
- * @param propertyKey
- * @param descriptorOrIndex
- */
-export declare function getDecoratorTargetType(
-  target: object,
-  propertyKey?: string,
-  descriptorOrIndex?: PropertyDescriptor | number,
-): DecoratorTargetType;

package/src/utils/get-decorator-target-type.js

@@ -1,63 +0,0 @@
-/**
- * @typedef {object} PropertyDescriptor
- * @property {boolean|undefined} configurable
- * @property {boolean|undefined} enumerable
- * @property {*} value
- * @property {boolean|undefined} writable
- * @property {Function} get
- * @property {Function} set
- */
-
-/**
- * Decorator target type.
- *
- * @enum {string}
- * @property {string} CONSTRUCTOR
- * @property {string} INSTANCE
- * @property {string} STATIC_METHOD
- * @property {string} INSTANCE_METHOD
- * @property {string} STATIC_PROPERTY
- * @property {string} INSTANCE_PROPERTY
- * @property {string} CONSTRUCTOR_PARAMETER
- * @property {string} STATIC_METHOD_PARAMETER
- * @property {string} INSTANCE_METHOD_PARAMETER
- */
-export const DecoratorTargetType = {
-  CONSTRUCTOR: 'constructor',
-  INSTANCE: 'instance',
-  STATIC_METHOD: 'staticMethod',
-  INSTANCE_METHOD: 'instanceMethod',
-  STATIC_PROPERTY: 'staticProperty',
-  INSTANCE_PROPERTY: 'instanceProperty',
-  CONSTRUCTOR_PARAMETER: 'constructorParameter',
-  STATIC_METHOD_PARAMETER: 'staticMethodParameter',
-  INSTANCE_METHOD_PARAMETER: 'instanceMethodParameter',
-};
-
-/**
- * Get decorator target type.
- *
- * @param {object} target
- * @param {string|undefined} propertyKey
- * @param {PropertyDescriptor|number|undefined} descriptorOrIndex
- * @returns {DecoratorTargetType}
- */
-export function getDecoratorTargetType(target, propertyKey, descriptorOrIndex) {
-  const isCtor = typeof target === 'function';
-  const isParameter = typeof descriptorOrIndex === 'number';
-  const isProperty = propertyKey != null && descriptorOrIndex == null;
-  const isMethod = propertyKey != null && descriptorOrIndex != null;
-  const D = DecoratorTargetType;
-  if (isCtor) {
-    if (isParameter)
-      return propertyKey ? D.STATIC_METHOD_PARAMETER : D.CONSTRUCTOR_PARAMETER;
-    if (isProperty) return D.STATIC_PROPERTY;
-    if (isMethod) return D.STATIC_METHOD;
-    return D.CONSTRUCTOR;
-  } else {
-    if (isParameter) return D.INSTANCE_METHOD_PARAMETER;
-    if (isProperty) return D.INSTANCE_PROPERTY;
-    if (isMethod) return D.INSTANCE_METHOD;
-    return D.INSTANCE;
-  }
-}