@decaf-ts/core 0.0.4

package/lib/esm/repository/Repository.d.ts

@@ -0,0 +1,33 @@
+import { DBModel, Repository as Rep } from "@decaf-ts/db-decorators";
+import { Observable } from "../interfaces/Observable";
+import { Observer } from "../interfaces/Observer";
+import { Adapter } from "../persistence/Adapter";
+export declare abstract class Repository<T extends DBModel> extends Rep<T> implements Observable {
+    private observers;
+    private readonly _adapter;
+    get adapter(): Adapter<string>;
+    protected constructor();
+    create(model: T, ...args: any[]): Promise<T>;
+    read(key: string, ...args: any[]): Promise<T>;
+    update(model: T, ...args: any[]): Promise<T>;
+    delete(key: string, ...args: any[]): Promise<T>;
+    /**
+     * @summary Registers an {@link Observer}
+     * @param {Observer} observer
+     *
+     * @see {Observable#observe}
+     */
+    observe(observer: Observer): void;
+    /**
+     * @summary Unregisters an {@link Observer}
+     * @param {Observer} observer
+     *
+     * @see {Observable#unObserve}
+     */
+    unObserve(observer: Observer): void;
+    /**
+     * @summary calls all registered {@link Observer}s to update themselves
+     * @param {any[]} [args] optional arguments to be passed to the {@link Observer#refresh} method
+     */
+    updateObservers(...args: any[]): Promise<void>;
+}

package/lib/esm/repository/Repository.js

@@ -0,0 +1 @@
+import{InternalError,Repository as Rep}from"@decaf-ts/db-decorators";import{ObserverError}from"./errors";class Repository extends Rep{get adapter(){if(this._adapter)return this._adapter;throw new InternalError("No adapter found for this repository. did you use the @uses decorator or pass it in the constructor?")}constructor(){super(),this.observers=[]}async create(r,...e){return this.adapter.create(r,...e)}async read(r,...e){return this.adapter.read(r,...e)}async update(r,...e){return this.adapter.update(r,...e)}async delete(r,...e){return this.adapter.delete(r,...e)}observe(r){if(-1!==this.observers.indexOf(r))throw new InternalError("Observer already registered");this.observers.push(r)}unObserve(r){r=this.observers.indexOf(r);if(-1===r)throw new InternalError("Failed to find Observer");this.observers.splice(r,1)}async updateObservers(...t){return new Promise((r,e)=>{Promise.all(this.observers.map(r=>r.refresh(...t))).then(()=>{r()}).catch(r=>e(new ObserverError(r)))})}}export{Repository};

package/lib/esm/repository/errors.d.ts

@@ -0,0 +1,12 @@
+import { BaseError } from "@decaf-ts/db-decorators";
+/**
+ * @summary Represents a failure in observer communication
+ *
+ * @param {string} msg the error message
+ *
+ * @class ObserverError
+ * @extends BaseError
+ */
+export declare class ObserverError extends BaseError {
+    constructor(msg: string | Error);
+}

package/lib/esm/repository/errors.js

@@ -0,0 +1 @@
+import{BaseError}from"@decaf-ts/db-decorators";class ObserverError extends BaseError{constructor(r){super(ObserverError.name,r)}}export{ObserverError};

package/lib/esm/repository/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./errors";
+export * from "./Repository";

package/lib/esm/repository/index.js

@@ -0,0 +1 @@
+export*from"./errors";export*from"./Repository";

package/lib/identity/decorators.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.pkOnCreate=pkOnCreate,exports.pk=pk;let decorator_validation_1=require("@decaf-ts/decorator-validation"),db_decorators_1=require("@decaf-ts/db-decorators"),reflection_1=require("@decaf-ts/reflection");async function pkOnCreate(r,t,a){if(r.sequence){let e;try{e=await this.adapter.getSequence(a,r.sequence,r.options)}catch(e){throw new db_decorators_1.InternalError(`Failed to instantiate Sequence ${r.sequence.name}: `+e)}r=await e.next();Object.defineProperty(a,t,{enumerable:!0,writable:!1,configurable:!0,value:r})}}function pk(e,r){e={sequence:e,options:r};return(0,reflection_1.apply)((0,db_decorators_1.index)(),(0,decorator_validation_1.required)(),(0,db_decorators_1.readonly)(),(0,reflection_1.metadata)((0,db_decorators_1.getDBKey)(db_decorators_1.DBKeys.ID),{}),(0,db_decorators_1.onCreate)(pkOnCreate,e))}

package/lib/identity/decorators.d.ts

@@ -0,0 +1,29 @@
+import { Constructor } from "@decaf-ts/decorator-validation";
+import { SequenceOptions } from "../interfaces/SequenceOptions";
+import { Sequence } from "../interfaces/Sequence";
+import { DBModel } from "@decaf-ts/db-decorators";
+import { Repository } from "../repository/Repository";
+export type IdOnCreateData = {
+    sequence?: Constructor<Sequence>;
+    options?: SequenceOptions;
+};
+/**
+ * @summary Primary Key Decorator
+ * @description Marks the property as the {@link DBModel}s primary key.
+ *  Also marks the property as {@link unique} as {@required} and ensures the index is created properly according to the provided {@link Sequence}
+ *
+ *
+ *
+ * @function pk
+ *
+ * @memberOf module:wallet-db.Decorators
+ *
+ * @see unique
+ * @see required
+ * @see on
+ * @param data
+ * @param key
+ * @param model
+ */
+export declare function pkOnCreate<T extends DBModel, V extends Repository<T>>(this: V, data: IdOnCreateData, key: string, model: T): Promise<void>;
+export declare function pk(sequence?: Constructor<Sequence>, opts?: SequenceOptions): <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/lib/identity/index.cjs

@@ -0,0 +1 @@
+var __createBinding=this&&this.__createBinding||(Object.create?function(e,t,r,i){void 0===i&&(i=r);var o=Object.getOwnPropertyDescriptor(t,r);o&&("get"in o?t.__esModule:!o.writable&&!o.configurable)||(o={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,i,o)}:function(e,t,r,i){e[i=void 0===i?r:i]=t[r]}),__exportStar=this&&this.__exportStar||function(e,t){for(var r in e)"default"===r||Object.prototype.hasOwnProperty.call(t,r)||__createBinding(t,e,r)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./decorators.cjs"),exports);

package/lib/identity/index.d.ts

@@ -0,0 +1 @@
+export * from "./decorators";

package/lib/index.cjs

@@ -0,0 +1 @@
+var __createBinding=this&&this.__createBinding||(Object.create?function(e,r,t,o){void 0===o&&(o=t);var i=Object.getOwnPropertyDescriptor(r,t);i&&("get"in i?r.__esModule:!i.writable&&!i.configurable)||(i={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,o,i)}:function(e,r,t,o){e[o=void 0===o?t:o]=r[t]}),__exportStar=this&&this.__exportStar||function(e,r){for(var t in e)"default"===t||Object.prototype.hasOwnProperty.call(r,t)||__createBinding(r,e,t)};Object.defineProperty(exports,"__esModule",{value:!0}),exports.VERSION=void 0,__exportStar(require("./identity/index.cjs"),exports),__exportStar(require("./interfaces/index.cjs"),exports),__exportStar(require("./model/index.cjs"),exports),__exportStar(require("./persistence/index.cjs"),exports),__exportStar(require("./repository/index.cjs"),exports),exports.VERSION="0.0.3";

package/lib/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @summary Module summary
+ * @description Module description
+ * @module ts-workspace
+ */
+/**
+ * @summary Namespace summary
+ * @description Namespace description
+ * @namespace Namespace
+ * @memberOf module:ts-workspace
+ */
+export * from "./identity";
+export * from "./interfaces";
+export * from "./model";
+export * from "./persistence";
+export * from "./repository";
+/**
+ * @summary stores the current package version
+ * @description this is how you should document a constant
+ * @const VERSION
+ * @memberOf module:ts-workspace
+ */
+export declare const VERSION = "0.0.3";

package/lib/interfaces/Builder.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0});

package/lib/interfaces/Builder.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @summary Standard Builder APi for the Builder design pattern
+ * @description Expose the build method
+ *
+ * @interface Builder
+ *
+ * @category Construction
+ */
+export interface Builder<T> {
+    /**
+     * @summary Build the Object
+     *
+     * @method
+     */
+    build(...args: any[]): T;
+}

package/lib/interfaces/Executor.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0});

package/lib/interfaces/Executor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @summary processes query objects
+ *
+ * @interface Executor
+ *
+ * @category Query
+ */
+export interface Executor {
+    /**
+     * @summary Processes itself
+     *
+     * @param {any[]} args
+     *
+     * @method
+     */
+    execute<V>(...args: any): Promise<V[]>;
+}

package/lib/interfaces/IAdapter.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0});

package/lib/interfaces/IAdapter.d.ts

@@ -0,0 +1,5 @@
+import { RawExecutor } from "./RawExecutor";
+import { Observable } from "./Observable";
+import { CrudOperator } from "@decaf-ts/db-decorators";
+export interface IAdapter<T> extends CrudOperator<any>, RawExecutor<T>, Observable {
+}

package/lib/interfaces/Observable.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0});

package/lib/interfaces/Observable.d.ts

@@ -0,0 +1,31 @@
+import { Observer } from "./Observer";
+/**
+ * @summary Observable Api
+ * @description manage and update {@link Observer}s
+ *
+ * @interface Observable
+ *
+ * @category Observables
+ */
+export interface Observable {
+    /**
+     * @summary Register new {@link Observer}s
+     * @param {Observer} observer
+     *
+     * @method
+     */
+    observe(observer: Observer): void;
+    /**
+     * @summary Unregister new {@link Observer}s
+     * @param {Observer} observer
+     *
+     * @method
+     */
+    unObserve(observer: Observer): void;
+    /**
+     * @summary have registered {@link Observer}s update themselves
+     * @param {any[]} args
+     * @method
+     */
+    updateObservers(...args: any[]): Promise<void>;
+}

package/lib/interfaces/Observer.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0});

package/lib/interfaces/Observer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @summary Observer Api
+ * @description will be called by the {@link Observable}
+ *
+ * @interface Observer
+ *
+ * @category Observables
+ */
+export interface Observer {
+    /**
+     * @summary Refreshes the Observer
+     * @param {any[]} args
+     * @method
+     */
+    refresh(...args: any[]): Promise<void>;
+}

package/lib/interfaces/RawExecutor.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0});

package/lib/interfaces/RawExecutor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @summary Executes a raw instruction in the Database
+ * @typeDef T The input type
+ *
+ * @interface RawExecutor
+ * @category Query
+ */
+export interface RawExecutor<T> {
+    /**
+     * @summary Executes a raw instruction in the Database
+     *
+     * @typeDef V the expected outcome of the instruction
+     * @param rawInput
+     * @param args
+     *
+     * @method
+     */
+    raw<V>(rawInput: T, ...args: any[]): Promise<V>;
+}

package/lib/interfaces/Sequence.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0});

package/lib/interfaces/Sequence.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @summary Sequence
+ *
+ * @interface Sequence
+ *
+ * @category Sequences
+ */
+export interface Sequence {
+    /**
+     * @summary generates the next value in the sequence
+     *
+     * @method
+     */
+    next(): Promise<string | number>;
+    current(): Promise<string | number>;
+}

package/lib/interfaces/SequenceOptions.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0});

package/lib/interfaces/SequenceOptions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @typedef SequenceOptions
+ *
+ * @prop {string | number} [startingValue] defines the starting value when sequence doest not exist
+ *
+ * @category Sequences
+ */
+export interface SequenceOptions {
+    startingValue: string | number;
+}

package/lib/interfaces/index.cjs

@@ -0,0 +1 @@
+var __createBinding=this&&this.__createBinding||(Object.create?function(e,r,t,o){void 0===o&&(o=t);var i=Object.getOwnPropertyDescriptor(r,t);i&&("get"in i?r.__esModule:!i.writable&&!i.configurable)||(i={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,o,i)}:function(e,r,t,o){e[o=void 0===o?t:o]=r[t]}),__exportStar=this&&this.__exportStar||function(e,r){for(var t in e)"default"===t||Object.prototype.hasOwnProperty.call(r,t)||__createBinding(r,e,t)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./Builder.cjs"),exports),__exportStar(require("./Executor.cjs"),exports),__exportStar(require("./IAdapter.cjs"),exports),__exportStar(require("./Observable.cjs"),exports),__exportStar(require("./Observer.cjs"),exports),__exportStar(require("./RawExecutor.cjs"),exports),__exportStar(require("./Sequence.cjs"),exports),__exportStar(require("./SequenceOptions.cjs"),exports);

package/lib/interfaces/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./Builder";
+export * from "./Executor";
+export * from "./IAdapter";
+export * from "./Observable";
+export * from "./Observer";
+export * from "./RawExecutor";
+export * from "./Sequence";
+export * from "./SequenceOptions";

package/lib/model/BaseModel.cjs

@@ -0,0 +1 @@
+var __decorate=this&&this.__decorate||function(e,t,o,a){var d,r=arguments.length,s=r<3?t:null===a?a=Object.getOwnPropertyDescriptor(t,o):a;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,o,a);else for(var c=e.length-1;0<=c;c--)(d=e[c])&&(s=(r<3?d(s):3<r?d(t,o,s):d(t,o))||s);return 3<r&&s&&Object.defineProperty(t,o,s),s},__metadata=this&&this.__metadata||function(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)};Object.defineProperty(exports,"__esModule",{value:!0}),exports.BaseModel=void 0;let db_decorators_1=require("@decaf-ts/db-decorators");class BaseModel extends db_decorators_1.DBModel{constructor(e){super(e),this.createdOn=void 0,this.updatedOn=void 0}}exports.BaseModel=BaseModel,__decorate([(0,db_decorators_1.timestamp)(db_decorators_1.DBOperations.CREATE),__metadata("design:type",Date)],BaseModel.prototype,"createdOn",void 0),__decorate([(0,db_decorators_1.timestamp)(),__metadata("design:type",Date)],BaseModel.prototype,"updatedOn",void 0);

package/lib/model/BaseModel.d.ts

@@ -0,0 +1,7 @@
+import { DBModel } from "@decaf-ts/db-decorators";
+import { ModelArg } from "@decaf-ts/decorator-validation";
+export declare abstract class BaseModel extends DBModel {
+    createdOn?: Date;
+    updatedOn?: Date;
+    protected constructor(arg?: ModelArg<BaseModel>);
+}

package/lib/model/index.cjs

@@ -0,0 +1 @@
+var __createBinding=this&&this.__createBinding||(Object.create?function(e,t,r,i){void 0===i&&(i=r);var n=Object.getOwnPropertyDescriptor(t,r);n&&("get"in n?t.__esModule:!n.writable&&!n.configurable)||(n={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,i,n)}:function(e,t,r,i){e[i=void 0===i?r:i]=t[r]}),__exportStar=this&&this.__exportStar||function(e,t){for(var r in e)"default"===r||Object.prototype.hasOwnProperty.call(t,r)||__createBinding(t,e,r)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./BaseModel.cjs"),exports);

package/lib/model/index.d.ts

@@ -0,0 +1 @@
+export * from "./BaseModel";

package/lib/persistence/Adapter.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.Adapter=void 0;let db_decorators_1=require("@decaf-ts/db-decorators"),injectable_decorators_1=require("@decaf-ts/injectable-decorators"),utils_1=require("./utils.cjs"),errors_1=require("../repository/errors.cjs");class Adapter{constructor(){this.observers=[]}observe(r){if(-1!==this.observers.indexOf(r))throw new db_decorators_1.InternalError("Observer already registered");this.observers.push(r)}unObserve(r){r=this.observers.indexOf(r);if(-1===r)throw new db_decorators_1.InternalError("Failed to find Observer");this.observers.splice(r,1)}async updateObservers(...t){return new Promise((r,e)=>{Promise.all(this.observers.map(r=>r.refresh(...t))).then(()=>{r()}).catch(r=>e(new errors_1.ObserverError(r)))})}static get current(){return this._current}static get(r){var e=injectable_decorators_1.Injectables.get((0,utils_1.genAdapterInjectableKey)(r));if(e)return e;throw new db_decorators_1.InternalError(`No Adapter registered under ${r}. Did you use the @adapter decorator?`)}static setCurrent(r){var e=this.get(r);if(!e)throw new db_decorators_1.NotFoundError(`No persistence flavour ${r} registered`);this._current=e}}exports.Adapter=Adapter;

package/lib/persistence/Adapter.d.ts

@@ -0,0 +1,39 @@
+import { DBModel } from "@decaf-ts/db-decorators";
+import { Observer } from "../interfaces/Observer";
+import { IAdapter } from "../interfaces/IAdapter";
+import { Sequence } from "../interfaces/Sequence";
+import { Constructor } from "@decaf-ts/decorator-validation";
+import { SequenceOptions } from "../interfaces/SequenceOptions";
+export declare abstract class Adapter<T = string> implements IAdapter<T> {
+    private static _current;
+    private observers;
+    abstract createIndex(...args: any[]): Promise<any>;
+    abstract getSequence<V extends DBModel>(model: V, sequence: Constructor<Sequence>, options?: SequenceOptions): Promise<Sequence>;
+    abstract create<V>(model: V, ...args: any[]): Promise<V>;
+    abstract read<V>(key: string | number, ...args: any[]): Promise<V>;
+    abstract update<V>(model: V, ...args: any[]): Promise<V>;
+    abstract delete<V>(key: string | number, ...args: any[]): Promise<V>;
+    abstract raw<V>(rawInput: T, ...args: any[]): Promise<V>;
+    /**
+     * @summary Registers an {@link Observer}
+     * @param {Observer} observer
+     *
+     * @see {Observable#observe}
+     */
+    observe(observer: Observer): void;
+    /**
+     * @summary Unregisters an {@link Observer}
+     * @param {Observer} observer
+     *
+     * @see {Observable#unObserve}
+     */
+    unObserve(observer: Observer): void;
+    /**
+     * @summary calls all registered {@link Observer}s to update themselves
+     * @param {any[]} [args] optional arguments to be passed to the {@link Observer#refresh} method
+     */
+    updateObservers(...args: any[]): Promise<void>;
+    static get current(): Adapter<any>;
+    static get(flavour: any): Adapter<any> | undefined;
+    static setCurrent(flavour: string): void;
+}

package/lib/persistence/constants.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.PersistenceKeys=void 0,exports.PersistenceKeys={REFLECT:"model.persistence.",ADAPTER:"adapter",INJECTABLE:"decaf-adapter-{0}"};

package/lib/persistence/constants.d.ts

@@ -0,0 +1 @@
+export declare const PersistenceKeys: Record<string, string>;

package/lib/persistence/decorators.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.getPersistenceKey=getPersistenceKey,exports.adapter=adapter,exports.uses=uses;let injectable_decorators_1=require("@decaf-ts/injectable-decorators"),reflection_1=require("@decaf-ts/reflection"),constants_1=require("./constants.cjs"),utils_1=require("./utils.cjs");function getPersistenceKey(e){return constants_1.PersistenceKeys.REFLECT+e}function adapter(e){return(0,injectable_decorators_1.injectable)((0,utils_1.genAdapterInjectableKey)(e),!0)}function uses(e){return(0,reflection_1.metadata)(getPersistenceKey(constants_1.PersistenceKeys.ADAPTER),(0,utils_1.genAdapterInjectableKey)(e))}

package/lib/persistence/decorators.d.ts

@@ -0,0 +1,3 @@
+export declare function getPersistenceKey(key: string): string;
+export declare function adapter(flavour: string): (original: any) => any;
+export declare function uses(flavour: string): import("@decaf-ts/reflection").CustomDecorator<V>;

package/lib/persistence/index.cjs

@@ -0,0 +1 @@
+var __createBinding=this&&this.__createBinding||(Object.create?function(e,r,t,o){void 0===o&&(o=t);var i=Object.getOwnPropertyDescriptor(r,t);i&&("get"in i?r.__esModule:!i.writable&&!i.configurable)||(i={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,o,i)}:function(e,r,t,o){e[o=void 0===o?t:o]=r[t]}),__exportStar=this&&this.__exportStar||function(e,r){for(var t in e)"default"===t||Object.prototype.hasOwnProperty.call(r,t)||__createBinding(r,e,t)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./Adapter.cjs"),exports),__exportStar(require("./constants.cjs"),exports),__exportStar(require("./decorators.cjs"),exports),__exportStar(require("./utils.cjs"),exports);

package/lib/persistence/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./Adapter";
+export * from "./constants";
+export * from "./decorators";
+export * from "./utils";

package/lib/persistence/utils.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.genAdapterInjectableKey=genAdapterInjectableKey;let decorator_validation_1=require("@decaf-ts/decorator-validation"),constants_1=require("./constants.cjs");function genAdapterInjectableKey(e){return(0,decorator_validation_1.sf)(constants_1.PersistenceKeys.INJECTABLE,e)}

package/lib/persistence/utils.d.ts

@@ -0,0 +1 @@
+export declare function genAdapterInjectableKey(flavour: string): string;

package/lib/repository/Repository.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.Repository=void 0;let db_decorators_1=require("@decaf-ts/db-decorators"),errors_1=require("./errors.cjs");class Repository extends db_decorators_1.Repository{get adapter(){if(this._adapter)return this._adapter;throw new db_decorators_1.InternalError("No adapter found for this repository. did you use the @uses decorator or pass it in the constructor?")}constructor(){super(),this.observers=[]}async create(r,...e){return this.adapter.create(r,...e)}async read(r,...e){return this.adapter.read(r,...e)}async update(r,...e){return this.adapter.update(r,...e)}async delete(r,...e){return this.adapter.delete(r,...e)}observe(r){if(-1!==this.observers.indexOf(r))throw new db_decorators_1.InternalError("Observer already registered");this.observers.push(r)}unObserve(r){r=this.observers.indexOf(r);if(-1===r)throw new db_decorators_1.InternalError("Failed to find Observer");this.observers.splice(r,1)}async updateObservers(...s){return new Promise((r,e)=>{Promise.all(this.observers.map(r=>r.refresh(...s))).then(()=>{r()}).catch(r=>e(new errors_1.ObserverError(r)))})}}exports.Repository=Repository;

package/lib/repository/Repository.d.ts

@@ -0,0 +1,33 @@
+import { DBModel, Repository as Rep } from "@decaf-ts/db-decorators";
+import { Observable } from "../interfaces/Observable";
+import { Observer } from "../interfaces/Observer";
+import { Adapter } from "../persistence/Adapter";
+export declare abstract class Repository<T extends DBModel> extends Rep<T> implements Observable {
+    private observers;
+    private readonly _adapter;
+    get adapter(): Adapter<string>;
+    protected constructor();
+    create(model: T, ...args: any[]): Promise<T>;
+    read(key: string, ...args: any[]): Promise<T>;
+    update(model: T, ...args: any[]): Promise<T>;
+    delete(key: string, ...args: any[]): Promise<T>;
+    /**
+     * @summary Registers an {@link Observer}
+     * @param {Observer} observer
+     *
+     * @see {Observable#observe}
+     */
+    observe(observer: Observer): void;
+    /**
+     * @summary Unregisters an {@link Observer}
+     * @param {Observer} observer
+     *
+     * @see {Observable#unObserve}
+     */
+    unObserve(observer: Observer): void;
+    /**
+     * @summary calls all registered {@link Observer}s to update themselves
+     * @param {any[]} [args] optional arguments to be passed to the {@link Observer#refresh} method
+     */
+    updateObservers(...args: any[]): Promise<void>;
+}

package/lib/repository/errors.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.ObserverError=void 0;let db_decorators_1=require("@decaf-ts/db-decorators");class ObserverError extends db_decorators_1.BaseError{constructor(r){super(ObserverError.name,r)}}exports.ObserverError=ObserverError;

package/lib/repository/errors.d.ts

@@ -0,0 +1,12 @@
+import { BaseError } from "@decaf-ts/db-decorators";
+/**
+ * @summary Represents a failure in observer communication
+ *
+ * @param {string} msg the error message
+ *
+ * @class ObserverError
+ * @extends BaseError
+ */
+export declare class ObserverError extends BaseError {
+    constructor(msg: string | Error);
+}

package/lib/repository/index.cjs

@@ -0,0 +1 @@
+var __createBinding=this&&this.__createBinding||(Object.create?function(e,r,t,o){void 0===o&&(o=t);var i=Object.getOwnPropertyDescriptor(r,t);i&&("get"in i?r.__esModule:!i.writable&&!i.configurable)||(i={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,o,i)}:function(e,r,t,o){e[o=void 0===o?t:o]=r[t]}),__exportStar=this&&this.__exportStar||function(e,r){for(var t in e)"default"===t||Object.prototype.hasOwnProperty.call(r,t)||__createBinding(r,e,t)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("./errors.cjs"),exports),__exportStar(require("./Repository.cjs"),exports);

package/lib/repository/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./errors";
+export * from "./Repository";

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "@decaf-ts/core",
+  "version": "0.0.4",
+  "description": "template for ts projects",
+  "type": "module",
+  "exports": {
+    "require": "./lib/index.cjs",
+    "import": "./lib/esm/index.js"
+  },
+  "types": "lib/index.d.ts",
+  "scripts": {
+    "do-install": "TOKEN=$(cat .token) npm install",
+    "update-dependencies": "rimraf node_modules/@decaf-ts package-lock.json && npm run do-install",
+    "flash-forward": "npx npm-check-updates -u && npm run do-install",
+    "reset": "rm -rf * && git checkout . && git pull && npm run do-install",
+    "build": "rimraf ./lib && rimraf ./dist && gulp dev",
+    "build:prod": "rimraf ./lib && rimraf ./dist && gulp prod",
+    "test": "jest --coverage --testPathPattern=\"/tests/unit\" --passWithNoTests --detectOpenHandles",
+    "test:integration": "jest --coverage --testPathPattern=\"/tests/(integration)\" --passWithNoTests --detectOpenHandles",
+    "test:all": "jest --coverage --testPathPattern=\"/tests/(unit|integration)\" --passWithNoTests --detectOpenHandles",
+    "lint": "eslint .",
+    "lint-fix": "eslint --fix ./src/*",
+    "test:circular": "dpdm -T --no-warning --no-tree ./src/index.ts",
+    "prepare-release": "npm run lint-fix && npm run build:prod && npm run test && npm run docs",
+    "release": "./bin/tag-release.sh",
+    "clean-publish": "npx clean-publish",
+    "coverage": "npm run test:all && jest-coverage-badges --input \"./workdocs/coverage/coverage-summary.json\" --output \"./workdocs/badges\"",
+    "docs": "npx rimraf ./docs && mkdir docs && npm run do-install -- better-docs taffydb && gulp docs; npm remove better-docs taffydb"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/decaf-ts/ts-workspace.git"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0"
+  },
+  "files": [
+    "lib",
+    "dist"
+  ],
+  "keywords": [
+    "plantuml",
+    "mermaid",
+    "uml",
+    "drawio",
+    "mddocs",
+    "md",
+    "jsdoc",
+    "doc",
+    "docs",
+    "documentation",
+    "ci/cd",
+    "ci",
+    "cd",
+    "template",
+    "typescript",
+    "ts"
+  ],
+  "author": "Tiago Venceslau",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/decaf-ts/ts-workspace/issues"
+  },
+  "homepage": "https://github.com/decaf-ts/ts-workspace#readme",
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@typescript-eslint/eslint-plugin": "^7.1.1",
+    "clean-publish": "^4.3.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.1.3",
+    "gulp": "^4.0.2",
+    "gulp-if": "^3.0.0",
+    "gulp-rename": "^2.0.0",
+    "gulp-replace": "^1.1.4",
+    "gulp-run-command": "^0.0.10",
+    "gulp-sourcemaps": "^3.0.0",
+    "gulp-typescript": "^6.0.0-alpha.1",
+    "gulp-uglify": "^3.0.2",
+    "jest": "^29.7.0",
+    "jest-coverage-badges": "^1.1.2",
+    "jest-junit": "^16.0.0",
+    "jsdoc": "^4.0.2",
+    "jsdoc-mermaid": "^1.0.0",
+    "markdown-include": "^0.4.3",
+    "merge-stream": "^2.0.0",
+    "nodemon": "^3.1.0",
+    "npm-check-updates": "^16.14.15",
+    "prettier": "^3.2.5",
+    "rimraf": "^5.0.5",
+    "ts-jest": "^29.1.2",
+    "ts-loader": "^9.5.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.4.2",
+    "vinyl-named": "^1.1.0",
+    "webpack-stream": "^7.0.0"
+  },
+  "peerDependencies": {
+    "@decaf-ts/db-decorators": "latest",
+    "@decaf-ts/decorator-validation": "latest",
+    "@decaf-ts/injectable-decorators": "latest",
+    "@decaf-ts/reflection": "latest",
+    "reflect-metadata": "^0.2.1"
+  }
+}