@decaf-ts/db-decorators 0.16.0 → 0.17.1

package/lib/types/operations/types.d.mts

@@ -1,7 +1,7 @@
-import { OperationKeys } from "./constants.js";
-import { IRepository } from "../interfaces/IRepository.js";
+import { OperationKeys } from "./constants.d.mts";
+import { IRepository } from "../interfaces/IRepository.d.mts";
 import { Model } from "@decaf-ts/decorator-validation";
-import { ContextOfRepository } from "../repository/index.js";
+import { ContextOfRepository } from "../repository/index.d.mts";
 /**
  * @description Metadata for database operations
  * @summary Contains information about an operation, its handler, and associated metadata

package/lib/types/overrides/Model.d.cts

@@ -1,7 +1,7 @@
 import { Constructor } from "@decaf-ts/decoration";
 import "@decaf-ts/decorator-validation";
-import { ComposedFromMetadata } from "../model/index.cjs";
-import { Context } from "../repository/index.cjs";
+import { ComposedFromMetadata } from "../model/index.d.cts";
+import { Context } from "../repository/index.d.cts";
 declare module "@decaf-ts/decorator-validation" {
     interface Model {
         isTransient(): boolean;

package/lib/types/overrides/Model.d.mts

@@ -1,7 +1,7 @@
 import { Constructor } from "@decaf-ts/decoration";
 import "@decaf-ts/decorator-validation";
-import { ComposedFromMetadata } from "../model/index.js";
-import { Context } from "../repository/index.js";
+import { ComposedFromMetadata } from "../model/index.d.mts";
+import { Context } from "../repository/index.d.mts";
 declare module "@decaf-ts/decorator-validation" {
     interface Model {
         isTransient(): boolean;

package/lib/types/overrides/index.d.cts

@@ -4,7 +4,7 @@
  * @module db-decorators/overrides
  */
 import "./overrides";
-export * from "./Model.cjs";
-export * from "./overrides.cjs";
-export * from "./Metadata.cjs";
-export * from "./ModelBuilderExtensions.cjs";
+export * from "./Model.d.cts";
+export * from "./overrides.d.cts";
+export * from "./Metadata.d.cts";
+export * from "./ModelBuilderExtensions.d.cts";

package/lib/types/overrides/index.d.mts

@@ -4,7 +4,7 @@
  * @module db-decorators/overrides
  */
 import "./overrides";
-export * from "./Model.js";
-export * from "./overrides.js";
-export * from "./Metadata.js";
-export * from "./ModelBuilderExtensions.js";
+export * from "./Model.d.mts";
+export * from "./overrides.d.mts";
+export * from "./Metadata.d.mts";
+export * from "./ModelBuilderExtensions.d.mts";

package/lib/types/repository/Context.d.cts

@@ -1,9 +1,9 @@
-import { ContextArgs } from "./utils.cjs";
-import { Contextual, FlagsOf } from "../interfaces/Contextual.cjs";
-import { OperationKeys } from "../operations/constants.cjs";
+import { ContextArgs } from "./utils.d.cts";
+import { Contextual, FlagsOf } from "../interfaces/Contextual.d.cts";
+import { OperationKeys } from "../operations/constants.d.cts";
 import { Model } from "@decaf-ts/decorator-validation";
 import { ObjectAccumulator } from "typed-object-accumulator";
-import { ContextFlags, FlagsOfContext, LoggerOfFlags, RepositoryFlags } from "./types.cjs";
+import { ContextFlags, FlagsOfContext, LoggerOfFlags, RepositoryFlags } from "./types.d.cts";
 import { Constructor } from "@decaf-ts/decoration";
 /**
  * @description Factory type for creating context instances.

package/lib/types/repository/Context.d.mts

@@ -1,9 +1,9 @@
-import { ContextArgs } from "./utils.js";
-import { Contextual, FlagsOf } from "../interfaces/Contextual.js";
-import { OperationKeys } from "../operations/constants.js";
+import { ContextArgs } from "./utils.d.mts";
+import { Contextual, FlagsOf } from "../interfaces/Contextual.d.mts";
+import { OperationKeys } from "../operations/constants.d.mts";
 import { Model } from "@decaf-ts/decorator-validation";
 import { ObjectAccumulator } from "typed-object-accumulator";
-import { ContextFlags, FlagsOfContext, LoggerOfFlags, RepositoryFlags } from "./types.js";
+import { ContextFlags, FlagsOfContext, LoggerOfFlags, RepositoryFlags } from "./types.d.mts";
 import { Constructor } from "@decaf-ts/decoration";
 /**
  * @description Factory type for creating context instances.

package/lib/types/repository/Repository.d.cts

@@ -1,8 +1,8 @@
 import "../overrides";
-import { IRepository } from "../interfaces/IRepository.cjs";
+import { IRepository } from "../interfaces/IRepository.d.cts";
 import { Model } from "@decaf-ts/decorator-validation";
-import { Context } from "./Context.cjs";
-import { PrimaryKeyType, RepositoryFlags } from "./types.cjs";
+import { Context } from "./Context.d.cts";
+import { PrimaryKeyType, RepositoryFlags } from "./types.d.cts";
 import { Constructor } from "@decaf-ts/decoration";
 /**
  * @description Base repository implementation providing CRUD operations for models.

package/lib/types/repository/Repository.d.mts

@@ -1,8 +1,8 @@
 import "../overrides";
-import { IRepository } from "../interfaces/IRepository.js";
+import { IRepository } from "../interfaces/IRepository.d.mts";
 import { Model } from "@decaf-ts/decorator-validation";
-import { Context } from "./Context.js";
-import { PrimaryKeyType, RepositoryFlags } from "./types.js";
+import { Context } from "./Context.d.mts";
+import { PrimaryKeyType, RepositoryFlags } from "./types.d.mts";
 import { Constructor } from "@decaf-ts/decoration";
 /**
  * @description Base repository implementation providing CRUD operations for models.

package/lib/types/repository/constants.d.cts

@@ -1,4 +1,4 @@
-import { RepositoryFlags } from "./types.cjs";
+import { RepositoryFlags } from "./types.d.cts";
 /**
  * @description Default configuration flags for repository operations.
  * @summary Provides default values for repository operation flags, excluding the timestamp property.

package/lib/types/repository/constants.d.mts

@@ -1,4 +1,4 @@
-import { RepositoryFlags } from "./types.js";
+import { RepositoryFlags } from "./types.d.mts";
 /**
  * @description Default configuration flags for repository operations.
  * @summary Provides default values for repository operation flags, excluding the timestamp property.

package/lib/types/repository/index.d.cts

@@ -3,10 +3,10 @@
  * @summary This file exports all the necessary components for the repository functionality, including the Repository class, constants, context, errors, types, and utils.
  * @module db-decorators/repository
  */
-export * from "./Repository.cjs";
-export * from "./constants.cjs";
-export * from "./Context.cjs";
-export * from "./errors.cjs";
-export * from "./types.cjs";
-export * from "./utils.cjs";
-export * from "./wrappers.cjs";
+export * from "./Repository.d.cts";
+export * from "./constants.d.cts";
+export * from "./Context.d.cts";
+export * from "./errors.d.cts";
+export * from "./types.d.cts";
+export * from "./utils.d.cts";
+export * from "./wrappers.d.cts";

package/lib/types/repository/index.d.mts

@@ -3,10 +3,10 @@
  * @summary This file exports all the necessary components for the repository functionality, including the Repository class, constants, context, errors, types, and utils.
  * @module db-decorators/repository
  */
-export * from "./Repository.js";
-export * from "./constants.js";
-export * from "./Context.js";
-export * from "./errors.js";
-export * from "./types.js";
-export * from "./utils.js";
-export * from "./wrappers.js";
+export * from "./Repository.d.mts";
+export * from "./constants.d.mts";
+export * from "./Context.d.mts";
+export * from "./errors.d.mts";
+export * from "./types.d.mts";
+export * from "./utils.d.mts";
+export * from "./wrappers.d.mts";

package/lib/types/repository/types.d.cts

@@ -1,9 +1,9 @@
-import { Context } from "./Context.cjs";
+import { Context } from "./Context.d.cts";
 import { ExtendedMetadata, Model } from "@decaf-ts/decorator-validation";
-import { OperationKeys } from "../operations/index.cjs";
+import { OperationKeys } from "../operations/index.d.cts";
 import { Constructor } from "@decaf-ts/decoration";
 import { Logger } from "@decaf-ts/logging";
-import { IRepository } from "../interfaces/index.cjs";
+import { IRepository } from "../interfaces/index.d.cts";
 /**
  * @description Type utility for ensuring model extension.
  * @summary A conditional type that ensures a type extends the Model class.

package/lib/types/repository/types.d.mts

@@ -1,9 +1,9 @@
-import { Context } from "./Context.js";
+import { Context } from "./Context.d.mts";
 import { ExtendedMetadata, Model } from "@decaf-ts/decorator-validation";
-import { OperationKeys } from "../operations/index.js";
+import { OperationKeys } from "../operations/index.d.mts";
 import { Constructor } from "@decaf-ts/decoration";
 import { Logger } from "@decaf-ts/logging";
-import { IRepository } from "../interfaces/index.js";
+import { IRepository } from "../interfaces/index.d.mts";
 /**
  * @description Type utility for ensuring model extension.
  * @summary A conditional type that ensures a type extends the Model class.

package/lib/types/repository/utils.d.cts

@@ -1,7 +1,7 @@
-import { IRepository } from "../interfaces/IRepository.cjs";
+import { IRepository } from "../interfaces/IRepository.d.cts";
 import { Model, ModelErrorDefinition } from "@decaf-ts/decorator-validation";
-import { Context } from "./Context.cjs";
-import { ContextOfRepository } from "./types.cjs";
+import { Context } from "./Context.d.cts";
+import { ContextOfRepository } from "./types.d.cts";
 export type ContextArgs<C extends Context<any>> = {
     context: C;
     args: [...any[], C];

package/lib/types/repository/utils.d.mts

@@ -1,7 +1,7 @@
-import { IRepository } from "../interfaces/IRepository.js";
+import { IRepository } from "../interfaces/IRepository.d.mts";
 import { Model, ModelErrorDefinition } from "@decaf-ts/decorator-validation";
-import { Context } from "./Context.js";
-import { ContextOfRepository } from "./types.js";
+import { Context } from "./Context.d.mts";
+import { ContextOfRepository } from "./types.d.mts";
 export type ContextArgs<C extends Context<any>> = {
     context: C;
     args: [...any[], C];

package/lib/types/validation/decorators.d.cts

@@ -1,9 +1,9 @@
 import "./validation";
 import { Model, Serializer } from "@decaf-ts/decorator-validation";
-import { OperationKeys } from "../operations/constants.cjs";
-import { IRepository } from "../interfaces/IRepository.cjs";
+import { OperationKeys } from "../operations/constants.d.cts";
+import { IRepository } from "../interfaces/IRepository.d.cts";
 import { Constructor } from "@decaf-ts/decoration";
-import { ContextOfRepository } from "../repository/index.cjs";
+import { ContextOfRepository } from "../repository/index.d.cts";
 /**
  * @description Prevents a property from being modified after initial creation.
  * @summary Marks the property as readonly, causing validation errors if attempts are made to modify it during updates.

package/lib/types/validation/decorators.d.mts

@@ -1,9 +1,9 @@
 import "./validation";
 import { Model, Serializer } from "@decaf-ts/decorator-validation";
-import { OperationKeys } from "../operations/constants.js";
-import { IRepository } from "../interfaces/IRepository.js";
+import { OperationKeys } from "../operations/constants.d.mts";
+import { IRepository } from "../interfaces/IRepository.d.mts";
 import { Constructor } from "@decaf-ts/decoration";
-import { ContextOfRepository } from "../repository/index.js";
+import { ContextOfRepository } from "../repository/index.d.mts";
 /**
  * @description Prevents a property from being modified after initial creation.
  * @summary Marks the property as readonly, causing validation errors if attempts are made to modify it during updates.

package/lib/types/validation/index.d.cts

@@ -1,4 +1,4 @@
-export * from "./validators/index.cjs";
-export * from "./constants.cjs";
-export * from "./decorators.cjs";
-export * from "./validation.cjs";
+export * from "./validators/index.d.cts";
+export * from "./constants.d.cts";
+export * from "./decorators.d.cts";
+export * from "./validation.d.cts";

package/lib/types/validation/index.d.mts

@@ -1,4 +1,4 @@
-export * from "./validators/index.js";
-export * from "./constants.js";
-export * from "./decorators.js";
-export * from "./validation.js";
+export * from "./validators/index.d.mts";
+export * from "./constants.d.mts";
+export * from "./decorators.d.mts";
+export * from "./validation.d.mts";

package/lib/types/validation/validators/index.d.cts

@@ -1,3 +1,3 @@
-export * from "./ReadOnlyValidator.cjs";
-export * from "./TimestampValidator.cjs";
-export * from "./UpdateValidator.cjs";
+export * from "./ReadOnlyValidator.d.cts";
+export * from "./TimestampValidator.d.cts";
+export * from "./UpdateValidator.d.cts";

package/lib/types/validation/validators/index.d.mts

@@ -1,3 +1,3 @@
-export * from "./ReadOnlyValidator.js";
-export * from "./TimestampValidator.js";
-export * from "./UpdateValidator.js";
+export * from "./ReadOnlyValidator.d.mts";
+export * from "./TimestampValidator.d.mts";
+export * from "./UpdateValidator.d.mts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/db-decorators",
-  "version": "0.16.0",
+  "version": "0.17.1",
   "description": "Agnostic database decorators and repository",
   "type": "module",
   "exports": {
@@ -97,6 +97,18 @@
   "main": "./lib/cjs/index.cjs",
   "module": "./lib/esm/index.js",
   "sideEffects": [
+    "./lib/esm/index.js",
+    "./lib/cjs/index.cjs",
+    "./lib/esm/validation/index.js",
+    "./lib/esm/validation/validators/index.js",
+    "./lib/esm/validation/validators/ReadOnlyValidator.js",
+    "./lib/esm/validation/validators/TimestampValidator.js",
+    "./lib/esm/validation/validators/UpdateValidator.js",
+    "./lib/cjs/validation/index.cjs",
+    "./lib/cjs/validation/validators/index.cjs",
+    "./lib/cjs/validation/validators/ReadOnlyValidator.cjs",
+    "./lib/cjs/validation/validators/TimestampValidator.cjs",
+    "./lib/cjs/validation/validators/UpdateValidator.cjs",
     "./lib/esm/overrides/index.js",
     "./lib/esm/overrides/overrides.js",
     "./lib/esm/validation/validation.js",

package/lib/types/identity/decorators.d.ts

@@ -1,8 +0,0 @@
-/**
- * @description Decorator that marks a property as an ID field
- * @summary Creates a composite decorator that marks a property as required, readonly, and as the ID field for database operations
- * @return {PropertyDecorator} A decorator that can be applied to class properties
- * @function id
- * @category Property Decorators
- */
-export declare function id(): (target: object, propertyKey?: string | symbol | unknown, descriptor?: PropertyDescriptor | number) => void;

package/lib/types/identity/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * @description Exports for the identity module.
- * @summary This file exports all the necessary components for the identity functionality, including decorators.
- * @module db-decorators/identity
- */
-export * from "./decorators";

package/lib/types/index.d.ts

@@ -1,15 +0,0 @@
-export * from "./identity";
-export * from "./interfaces";
-export * from "./model";
-export * from "./operations";
-export * from "./overrides";
-export * from "./repository";
-export * from "./validation";
-/**
- * @description Current version of the reflection package
- * @summary Stores the semantic version number of the package
- * @const VERSION
- * @memberOf module:db-decorators
- */
-export declare const VERSION = "0.15.0";
-export declare const PACKAGE_NAME = "@decaf-ts/db-decorators";

package/lib/types/interfaces/BulkCrudOperator.d.ts

@@ -1,47 +0,0 @@
-import { CrudOperator } from "./CrudOperator";
-import { PrimaryKeyType } from "../repository/index";
-/**
- * @description Interface for bulk CRUD operations
- * @summary Extends the basic CRUD operations to support bulk operations on multiple models at once
- * @template M - The model type
- * @interface BulkCrudOperator
- * @memberOf module:db-decorators
- */
-export interface BulkCrudOperator<M> extends CrudOperator<M> {
-    /**
-     * @description Creates multiple model instances in the database
-     * @summary Bulk operation to create multiple models at once
-     * @template M - The model type
-     * @param {M[]} models - Array of model instances to create
-     * @param {...any[]} args - Additional arguments
-     * @return {Promise<M[]>} Promise resolving to the created model instances
-     */
-    createAll(models: M[], ...args: any[]): Promise<M[]>;
-    /**
-     * @description Retrieves multiple model instances from the database by their keys
-     * @summary Bulk operation to read multiple models at once
-     * @template M - The model type
-     * @param {(PrimaryKeyType[])} keys - Array of primary keys to retrieve
-     * @param {...any[]} args - Additional arguments
-     * @return {Promise<M[]>} Promise resolving to the retrieved model instances
-     */
-    readAll(keys: PrimaryKeyType[], ...args: any[]): Promise<M[]>;
-    /**
-     * @description Updates multiple model instances in the database
-     * @summary Bulk operation to update multiple models at once
-     * @template M - The model type
-     * @param {M[]} models - Array of model instances to update
-     * @param {...any[]} args - Additional arguments
-     * @return {Promise<M[]>} Promise resolving to the updated model instances
-     */
-    updateAll(models: M[], ...args: any[]): Promise<M[]>;
-    /**
-     * @description Deletes multiple model instances from the database by their keys
-     * @summary Bulk operation to delete multiple models at once
-     * @template M - The model type
-     * @param {(PrimaryKeyType[])} keys - Array of primary keys to delete
-     * @param {...any[]} args - Additional arguments
-     * @return {Promise<M[]>} Promise resolving to the deleted model instances
-     */
-    deleteAll(keys: PrimaryKeyType[], ...args: any[]): Promise<M[]>;
-}

package/lib/types/interfaces/Contextual.d.ts

@@ -1,23 +0,0 @@
-import { OperationKeys } from "../operations";
-import { Context } from "../repository";
-export type FlagsOf<C extends Context<any>> = C extends Context<infer T> ? T : never;
-/**
- * @description Interface for context-aware operations
- * @summary Provides context management for database operations
- * @template F - Type extending RepositoryFlags, defaults to RepositoryFlags
- * @template C - Type extending Context<F>, defaults to Context<F>
- * @interface Contextual
- * @memberOf module:db-decorators
- */
-export interface Contextual<C extends Context<any> = Context<any>> {
-    /**
-     * @description Creates a context for a specific operation
-     * @summary Generates an operation-specific context with custom flags
-     * @param {(OperationKeys.CREATE|OperationKeys.READ|OperationKeys.UPDATE|OperationKeys.DELETE)} operation - The operation type
-     * @template F - Type extending RepositoryFlags, defaults to RepositoryFlags
-     * @param {Partial<F>} overrides - Custom flag overrides for this context
-     * @param {...any[]} args - Additional arguments
-     * @return {Promise<C>} Promise resolving to the created context
-     */
-    context(operation: ((...args: any[]) => any) | OperationKeys.CREATE | OperationKeys.READ | OperationKeys.UPDATE | OperationKeys.DELETE | string, overrides: Partial<FlagsOf<C>>, ...args: any[]): Promise<C>;
-}

package/lib/types/interfaces/CrudOperator.d.ts

@@ -1,46 +0,0 @@
-import { PrimaryKeyType } from "../repository/index";
-/**
- * @description Basic CRUD operations interface
- * @summary Exposes a standard Create, Read, Update, Delete API for database operations
- * @template M - The model type
- * @interface CrudOperator
- * @memberOf module:db-decorators
- */
-export interface CrudOperator<M> {
-    /**
-     * @description Creates a new model instance in the database
-     * @summary Create a new model
-     * @template M - The model type
-     * @param {M} model - The model instance to create
-     * @param {...any[]} args - Additional arguments
-     * @return {Promise<M>} Promise resolving to the created model instance
-     */
-    create(model: M, ...args: any[]): Promise<M>;
-    /**
-     * @description Retrieves a model instance from the database by its key
-     * @summary Read a model
-     * @template M - The model type
-     * @param {PrimaryKeyType} key - The primary key of the model to retrieve
-     * @param {...any[]} args - Additional arguments
-     * @return {Promise<M>} Promise resolving to the retrieved model instance
-     */
-    read(key: PrimaryKeyType, ...args: any[]): Promise<M>;
-    /**
-     * @description Updates a model instance in the database
-     * @summary Update a model
-     * @template M - The model type
-     * @param {M} model - The model instance to update
-     * @param {...any[]} args - Additional arguments
-     * @return {Promise<M>} Promise resolving to the updated model instance
-     */
-    update(model: M, ...args: any[]): Promise<M>;
-    /**
-     * @description Deletes a model instance from the database by its key
-     * @summary Delete a model
-     * @template M - The model type
-     * @param {PrimaryKeyType} key - The primary key of the model to delete
-     * @param {...any[]} args - Additional arguments
-     * @return {Promise<M>} Promise resolving to the deleted model instance
-     */
-    delete(key: PrimaryKeyType, ...args: any[]): Promise<M>;
-}

package/lib/types/interfaces/IRepository.d.ts

@@ -1,19 +0,0 @@
-import { Model, ModelConstructor } from "@decaf-ts/decorator-validation";
-import { BulkCrudOperator } from "./BulkCrudOperator";
-import { Context, RepositoryFlags } from "../repository";
-/**
- * @description Repository interface for database operations
- * @summary Interface holding basic CRUD APIs for database models, providing standard operations and metadata
- * @template M - Type extending Model
- * @template F - Type extending RepositoryFlags, defaults to RepositoryFlags
- * @template C - Type extending Context<F>, defaults to Context<F>
- * @interface IRepository
- * @memberOf module:db-decorators
- */
-export interface IRepository<M extends Model<boolean>, C extends Context<any> = Context<RepositoryFlags>> extends BulkCrudOperator<M> {
-    /**
-     * @description The constructor of the model class
-     * @summary Reference to the model class constructor used to create new instances
-     */
-    readonly class: ModelConstructor<M>;
-}

package/lib/types/interfaces/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * @description Exports for the interfaces module.
- * @summary This file exports all the necessary components for the interfaces functionality, including BulkCrudOperator, Contextual, CrudOperator, and IRepository.
- * @module db-decorators/interfaces
- */
-export * from "./BulkCrudOperator";
-export * from "./Contextual";
-export * from "./CrudOperator";
-export * from "./IRepository";

package/lib/types/model/constants.d.ts

@@ -1,37 +0,0 @@
-/**
- * @description Database reflection keys
- * @summary Collection of keys used for reflection metadata in database operations
- * @const DBKeys
- * @memberOf module:db-decorators
- */
-export declare const DBKeys: {
-    REFLECT: string;
-    REPOSITORY: string;
-    CLASS: string;
-    ID: string;
-    INDEX: string;
-    UNIQUE: string;
-    SERIALIZE: string;
-    READONLY: string;
-    TIMESTAMP: string;
-    TRANSIENT: string;
-    HASH: string;
-    COMPOSED: string;
-    GENERATED: string;
-    VERSION: string;
-    ORIGINAL: string;
-};
-/**
- * @description Default separator character for composite indexes
- * @summary The default separator character used when concatenating multiple fields into a single index
- * @const DefaultSeparator
- * @memberOf module:db-decorators
- */
-export declare const DefaultSeparator = "_";
-/**
- * @description Default format for timestamp fields
- * @summary Standard date format string used for timestamp fields in database models
- * @const DEFAULT_TIMESTAMP_FORMAT
- * @memberOf module:db-decorators
- */
-export declare const DEFAULT_TIMESTAMP_FORMAT = "dd/MM/yyyy HH:mm:ss:S";