@decaf-ts/core 0.7.2 → 0.7.4

package/lib/utils/Services.cjs

@@ -0,0 +1,159 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientBasedService = exports.Service = void 0;
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const logging_1 = require("@decaf-ts/logging");
+const injectable_decorators_1 = require("@decaf-ts/injectable-decorators");
+class Service {
+    constructor(name) {
+        this.name = name;
+        /**
+         * @description The context constructor for this adapter
+         * @summary Reference to the context class constructor used by this adapter
+         */
+        this.Context = (db_decorators_1.Context);
+    }
+    /**
+     * @description Creates repository flags for an operation
+     * @summary Generates a set of flags that describe a database operation, combining default flags with overrides
+     * @template F - The Repository Flags type
+     * @template M - The model type
+     * @param {OperationKeys} operation - The type of operation being performed
+     * @param {Constructor<M>} model - The model constructor
+     * @param {Partial<F>} flags - Custom flag overrides
+     * @param {...any[]} args - Additional arguments
+     * @return {Promise<F>} The complete set of flags
+     */
+    async flags(operation, flags, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    ...args) {
+        let log = (flags.logger || logging_1.Logging.for(this.toString()));
+        if (flags.correlationId)
+            log = log.for({ correlationId: flags.correlationId });
+        return Object.assign({}, db_decorators_1.DefaultRepositoryFlags, flags, {
+            timestamp: new Date(),
+            operation: operation,
+            logger: log,
+        });
+    }
+    async context(operation, overrides, ...args) {
+        const flags = await this.flags(operation, overrides, ...args);
+        return new this.Context().accumulate(flags);
+    }
+    async logCtx(args, method, allowCreate = false) {
+        return (await Service.logCtx.bind(this)(args, method, allowCreate));
+    }
+    static async logCtx(args, operation, allowCreate = false) {
+        const bootCtx = async function bootCtx() {
+            if (!allowCreate)
+                throw new db_decorators_1.InternalError("No context provided");
+            return this.context(typeof operation === "string" ? operation : operation.name, {});
+        }.bind(this);
+        if (args.length < 1) {
+            args = [await bootCtx()];
+        }
+        const ctx = args.pop();
+        if (!(ctx instanceof db_decorators_1.Context))
+            args = [...args, await bootCtx()];
+        const log = (this
+            ? ctx.logger.for(this).for(operation)
+            : ctx.logger.clear().for(this).for(operation));
+        return {
+            ctx: ctx,
+            log: operation ? log.for(operation) : log,
+            ctxArgs: [...args, ctx],
+        };
+    }
+    /**
+     * @description Retrieves a Service instance by name/class
+     * @summary Looks up and returns a cached API instance by its name or constructor
+     * @template A Type extending Api
+     * @param {string | Constructor<A>} name - Name of the API or its constructor
+     * @return {A} The requested API instance
+     */
+    static get(name) {
+        if (!name)
+            throw new db_decorators_1.InternalError(`No name provided`);
+        const injectable = injectable_decorators_1.Injectables.get(name);
+        if (injectable)
+            return injectable;
+        throw new db_decorators_1.InternalError(`No Service found for ${typeof name === "string" ? name : typeof name === "symbol" ? name.toString() : name.name}`);
+    }
+    static async boot(...args) {
+        const factory = {
+            async context(operation) {
+                return new db_decorators_1.Context().accumulate(Object.assign({}, db_decorators_1.DefaultRepositoryFlags, {
+                    timestamp: new Date(),
+                    operation: operation,
+                    logger: logging_1.Logging.get(),
+                }));
+            },
+        };
+        const { log, ctxArgs } = await this.logCtx.bind(factory)(args, this.boot, true);
+        const services = injectable_decorators_1.Injectables.services();
+        for (const [key, service] of Object.entries(services)) {
+            try {
+                const s = new service();
+                if (s instanceof ClientBasedService)
+                    await s.boot(...ctxArgs);
+            }
+            catch (e) {
+                log.error(`Failed to boot ${key} service`, e);
+            }
+        }
+    }
+}
+exports.Service = Service;
+class ClientBasedService extends Service {
+    constructor() {
+        super();
+    }
+    async boot(...args) {
+        const { log, ctxArgs } = await this.logCtx(args, this.boot, true);
+        log.verbose(`Initializing ${this.toString()}...`);
+        const { config, client } = await this.initialize(...ctxArgs);
+        this._config = config;
+        this._client = client;
+    }
+    get config() {
+        if (!this._config)
+            throw new db_decorators_1.InternalError(`Config not initialized`);
+        return this._config;
+    }
+    get client() {
+        if (!this._client)
+            throw new db_decorators_1.InternalError(`Client not initialized`);
+        return this._client;
+    }
+    async shutdown(...args) {
+        const { log } = await this.logCtx(args, this.shutdown, true);
+        log.info(`Shutting down ${this.name} service...`);
+    }
+}
+exports.ClientBasedService = ClientBasedService;
+__decorate([
+    (0, logging_1.final)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ClientBasedService.prototype, "boot", null);
+__decorate([
+    (0, logging_1.final)(),
+    __metadata("design:type", Object),
+    __metadata("design:paramtypes", [])
+], ClientBasedService.prototype, "config", null);
+__decorate([
+    (0, logging_1.final)(),
+    __metadata("design:type", Object),
+    __metadata("design:paramtypes", [])
+], ClientBasedService.prototype, "client", null);
+//# sourceMappingURL=Services.js.map

package/lib/utils/Services.d.ts

@@ -0,0 +1,50 @@
+import { Context, Contextual, OperationKeys } from "@decaf-ts/db-decorators";
+import { Constructor } from "@decaf-ts/decoration";
+import { ContextualArgs, ContextualizedArgs, MaybeContextualArg } from "./ContextualLoggedClass";
+import { FlagsOf } from "../persistence/index";
+export declare abstract class Service<C extends Context<any> = any> implements Contextual<C> {
+    readonly name?: string | undefined;
+    protected constructor(name?: string | undefined);
+    /**
+     * @description Creates repository flags for an operation
+     * @summary Generates a set of flags that describe a database operation, combining default flags with overrides
+     * @template F - The Repository Flags type
+     * @template M - The model type
+     * @param {OperationKeys} operation - The type of operation being performed
+     * @param {Constructor<M>} model - The model constructor
+     * @param {Partial<F>} flags - Custom flag overrides
+     * @param {...any[]} args - Additional arguments
+     * @return {Promise<F>} The complete set of flags
+     */
+    protected flags(operation: OperationKeys | string, flags: Partial<FlagsOf<C>>, ...args: any[]): Promise<FlagsOf<C>>;
+    /**
+     * @description The context constructor for this adapter
+     * @summary Reference to the context class constructor used by this adapter
+     */
+    protected readonly Context: Constructor<C>;
+    context(operation: OperationKeys.CREATE | OperationKeys.READ | OperationKeys.UPDATE | OperationKeys.DELETE | string, overrides: Partial<FlagsOf<C>>, ...args: any[]): Promise<C>;
+    protected logCtx<ARGS extends any[]>(args: ARGS, method: ((...args: any[]) => any) | string, allowCreate?: boolean): Promise<ContextualizedArgs<any, ARGS>>;
+    protected static logCtx<CONTEXT extends Context<any>, ARGS extends any[]>(this: Contextual, args: ARGS, operation: ((...args: any[]) => any) | string, allowCreate?: boolean): Promise<ContextualizedArgs<CONTEXT, ARGS>>;
+    /**
+     * @description Retrieves a Service instance by name/class
+     * @summary Looks up and returns a cached API instance by its name or constructor
+     * @template A Type extending Api
+     * @param {string | Constructor<A>} name - Name of the API or its constructor
+     * @return {A} The requested API instance
+     */
+    static get<A extends Service>(name: string | symbol | Constructor<A>): A;
+    static boot<C extends Context<any> = any>(...args: MaybeContextualArg<C>): Promise<void>;
+}
+export declare abstract class ClientBasedService<CLIENT, CONF, C extends Context<any> = any> extends Service {
+    protected _client?: CLIENT;
+    protected _config?: CONF;
+    protected constructor();
+    boot(...args: MaybeContextualArg<C>): Promise<void>;
+    abstract initialize(...args: ContextualArgs<C>): Promise<{
+        config: CONF;
+        client: CLIENT;
+    }>;
+    protected get config(): CONF;
+    get client(): CLIENT;
+    shutdown(...args: MaybeContextualArg<C>): Promise<void>;
+}

package/lib/utils/Services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Services.js","sourceRoot":"","sources":["../../src/utils/Services.ts"],"names":[],"mappings":"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"}

package/lib/utils/decorators.cjs

@@ -1,22 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.final = final;
-/**
- * @description Creates a decorator that makes a method non-configurable
- * @summary This decorator prevents a method from being overridden by making it non-configurable.
- * It throws an error if used on anything other than a method.
- * @return {Function} A decorator function that can be applied to methods
- * @function final
- * @category Method Decorators
- */
-function final() {
-    return (target, propertyKey, descriptor) => {
-        if (!descriptor)
-            throw new Error("final decorator can only be used on methods");
-        if (descriptor?.configurable) {
-            descriptor.configurable = false;
+exports.service = service;
+const decoration_1 = require("@decaf-ts/decoration");
+const injectable_decorators_1 = require("@decaf-ts/injectable-decorators");
+const index_1 = require("./../persistence/index.cjs");
+function service(key) {
+    return function service(target, prop, descriptor) {
+        decoration_1.Metadata.set(index_1.PersistenceKeys.SERVICE, key, target);
+        const decs = [];
+        if (descriptor && typeof descriptor.value === "number") {
+            decs.push((0, injectable_decorators_1.inject)());
         }
-        return descriptor;
+        else if (!descriptor && !prop) {
+            decs.push((0, injectable_decorators_1.injectable)({
+                callback: (inst) => Object.defineProperty(inst, "name", {
+                    enumerable: true,
+                    configurable: false,
+                    writable: false,
+                    value: key,
+                }),
+            }));
+        }
+        else if (!descriptor) {
+            decs.push((0, injectable_decorators_1.inject)());
+        }
+        else
+            throw new Error("Invalid decorator usage. Should be impossible");
+        decs.push((0, decoration_1.metadata)(index_1.PersistenceKeys.SERVICE, key));
+        return (0, decoration_1.apply)(...decs)(target, prop, descriptor);
     };
 }
 //# sourceMappingURL=decorators.js.map

package/lib/utils/decorators.d.ts

@@ -1,9 +1 @@
-/**
- * @description Creates a decorator that makes a method non-configurable
- * @summary This decorator prevents a method from being overridden by making it non-configurable.
- * It throws an error if used on anything other than a method.
- * @return {Function} A decorator function that can be applied to methods
- * @function final
- * @category Method Decorators
- */
-export declare function final(): (target: object, propertyKey?: any, descriptor?: PropertyDescriptor) => PropertyDescriptor;
+export declare function service(key: string): (target: any, prop?: any, descriptor?: any) => void;

package/lib/utils/decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/utils/decorators.ts"],"names":[],"mappings":";;AAQA,sBAaC;AArBD;;;;;;;GAOG;AACH,SAAgB,KAAK;IACnB,OAAO,CACL,MAAc,EACd,WAAiB,EACjB,UAA+B,EAC/B,EAAE;QACF,IAAI,CAAC,UAAU;YACb,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,IAAI,UAAU,EAAE,YAAY,EAAE,CAAC;YAC7B,UAAU,CAAC,YAAY,GAAG,KAAK,CAAC;QAClC,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/utils/decorators.ts"],"names":[],"mappings":";;AAIA,0BAyBC;AA7BD,qDAAiE;AACjE,2EAAqE;AACrE,sDAAuD;AAEvD,SAAgB,OAAO,CAAC,GAAW;IACjC,OAAO,SAAS,OAAO,CAAC,MAAW,EAAE,IAAU,EAAE,UAAgB;QAC/D,qBAAQ,CAAC,GAAG,CAAC,uBAAe,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,EAAE,CAAC;QAChB,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvD,IAAI,CAAC,IAAI,CAAC,IAAA,8BAAM,GAAE,CAAC,CAAC;QACtB,CAAC;aAAM,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CACP,IAAA,kCAAU,EAAC;gBACT,QAAQ,EAAE,CAAC,IAAS,EAAE,EAAE,CACtB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE;oBAClC,UAAU,EAAE,IAAI;oBAChB,YAAY,EAAE,KAAK;oBACnB,QAAQ,EAAE,KAAK;oBACf,KAAK,EAAE,GAAG;iBACX,CAAC;aACL,CAAC,CACH,CAAC;QACJ,CAAC;aAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,IAAA,8BAAM,GAAE,CAAC,CAAC;QACtB,CAAC;;YAAM,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAExE,IAAI,CAAC,IAAI,CAAC,IAAA,qBAAQ,EAAC,uBAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAClD,OAAO,IAAA,kBAAK,EAAC,GAAG,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC,CAAC;AACJ,CAAC"}

package/lib/utils/index.cjs

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./decorators.cjs"), exports);
+__exportStar(require("./ContextualLoggedClass.cjs"), exports);
 __exportStar(require("./errors.cjs"), exports);
+__exportStar(require("./Services.cjs"), exports);
 //# sourceMappingURL=index.js.map

package/lib/utils/index.d.ts

@@ -1,2 +1,3 @@
-export * from "./decorators";
+export * from "./ContextualLoggedClass";
 export * from "./errors";
+export * from "./Services";

package/lib/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAA6B;AAC7B,+CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAAwC;AACxC,+CAAyB;AACzB,iDAA2B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/core",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "Core persistence module for the decaf framework",
   "type": "module",
   "exports": {

package/lib/esm/identity/utils.d.ts

@@ -1,24 +0,0 @@
-import { Model } from "@decaf-ts/decorator-validation";
-import { Constructor } from "@decaf-ts/decoration";
-/**
- * @description Gets the table name for a model
- * @summary Retrieves the table name associated with a model by checking metadata or falling back to the constructor name
- * @template M - Type that extends Model
- * @param {M | Constructor<M>} model - The model instance or constructor to get the table name for
- * @return {string} The table name for the model
- * @function getTableName
- * @memberOf module:core
- */
-export declare function getTableName<M extends Model>(model: M | Constructor<M>): string;
-export declare function getColumnName<M extends Model>(model: M | Constructor<M>, attribute: string): string;
-/**
- * @description Generates a sequence name for a model
- * @summary Creates a standardized sequence name by combining the table name with additional arguments
- * @template M - Type that extends Model
- * @param {M | Constructor<M>} model - The model instance or constructor to generate the sequence name for
- * @param {...string} args - Additional string arguments to append to the sequence name
- * @return {string} The generated sequence name
- * @function sequenceNameForModel
- * @memberOf module:core
- */
-export declare function sequenceNameForModel<M extends Model>(model: M | Constructor<M>, ...args: string[]): string;

package/lib/esm/identity/utils.js

@@ -1,44 +0,0 @@
-import { Model } from "@decaf-ts/decorator-validation";
-import { InternalError } from "@decaf-ts/db-decorators";
-import { PersistenceKeys } from "./../persistence/constants.js";
-import { Metadata } from "@decaf-ts/decoration";
-/**
- * @description Gets the table name for a model
- * @summary Retrieves the table name associated with a model by checking metadata or falling back to the constructor name
- * @template M - Type that extends Model
- * @param {M | Constructor<M>} model - The model instance or constructor to get the table name for
- * @return {string} The table name for the model
- * @function getTableName
- * @memberOf module:core
- */
-export function getTableName(model) {
-    const obj = model instanceof Model ? Model.get(model.constructor.name) : model;
-    if (!obj)
-        throw new InternalError(`Unable to find model ${model}`);
-    const meta = Metadata.get(model instanceof Model ? model.constructor : model, PersistenceKeys.TABLE);
-    if (meta) {
-        return meta;
-    }
-    if (model instanceof Model) {
-        return model.constructor.name;
-    }
-    return model.name;
-}
-export function getColumnName(model, attribute) {
-    const metadata = Metadata.get(model instanceof Model ? model.constructor : model, Metadata.key(PersistenceKeys.COLUMN, attribute));
-    return metadata ? metadata : attribute;
-}
-/**
- * @description Generates a sequence name for a model
- * @summary Creates a standardized sequence name by combining the table name with additional arguments
- * @template M - Type that extends Model
- * @param {M | Constructor<M>} model - The model instance or constructor to generate the sequence name for
- * @param {...string} args - Additional string arguments to append to the sequence name
- * @return {string} The generated sequence name
- * @function sequenceNameForModel
- * @memberOf module:core
- */
-export function sequenceNameForModel(model, ...args) {
-    return [getTableName(model), ...args].join("_");
-}
-//# sourceMappingURL=utils.js.map

package/lib/esm/identity/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/identity/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,sCAAiC;AAC3D,OAAO,EAAe,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAyB;IAEzB,MAAM,GAAG,GACP,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAErE,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,aAAa,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;IAEnE,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CACvB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAE,KAAa,EAC3D,eAAe,CAAC,KAAK,CACtB,CAAC;IAEF,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,KAAyB,EACzB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAC3B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAE,KAAa,EAC3D,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAChD,CAAC;IACF,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACzC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAyB,EACzB,GAAG,IAAc;IAEjB,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,CAAC"}

package/lib/esm/ram/RamContext.d.ts

@@ -1,28 +0,0 @@
-import { Context } from "@decaf-ts/db-decorators";
-import { RamFlags } from "./types";
-/**
- * @description Context class for RAM adapter operations
- * @summary Provides a specialized context for RAM adapter operations, extending the base Context with RAM-specific flags. This context is used to pass operation parameters and user information.
- * @class RamContext
- * @category Ram
- * @example
- * ```typescript
- * // Create a new RAM context
- * const context = new RamContext();
- * // Optionally set a flag
- * context.set('UUID', '123e4567-e89b-12d3-a456-426614174000');
- * // Access a flag from the context
- * const uuid = context.get('UUID');
- * ```
- * @mermaid
- * sequenceDiagram
- *   participant Caller
- *   participant RamContext
- *   participant BaseContext as Context
- *   Caller->>RamContext: new RamContext()
- *   RamContext->>BaseContext: super()
- *   RamContext-->>Caller: instance
- */
-export declare class RamContext extends Context<RamFlags> {
-    constructor();
-}

package/lib/esm/ram/RamContext.js

@@ -1,30 +0,0 @@
-import { Context } from "@decaf-ts/db-decorators";
-/**
- * @description Context class for RAM adapter operations
- * @summary Provides a specialized context for RAM adapter operations, extending the base Context with RAM-specific flags. This context is used to pass operation parameters and user information.
- * @class RamContext
- * @category Ram
- * @example
- * ```typescript
- * // Create a new RAM context
- * const context = new RamContext();
- * // Optionally set a flag
- * context.set('UUID', '123e4567-e89b-12d3-a456-426614174000');
- * // Access a flag from the context
- * const uuid = context.get('UUID');
- * ```
- * @mermaid
- * sequenceDiagram
- *   participant Caller
- *   participant RamContext
- *   participant BaseContext as Context
- *   Caller->>RamContext: new RamContext()
- *   RamContext->>BaseContext: super()
- *   RamContext-->>Caller: instance
- */
-export class RamContext extends Context {
-    constructor() {
-        super();
-    }
-}
-//# sourceMappingURL=RamContext.js.map

package/lib/esm/ram/RamContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RamContext.js","sourceRoot":"","sources":["../../../src/ram/RamContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGlD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,UAAW,SAAQ,OAAiB;IAC/C;QACE,KAAK,EAAE,CAAC;IACV,CAAC;CACF"}

package/lib/esm/ram/RamSequence.d.ts

@@ -1,75 +0,0 @@
-import { RamSequenceModel } from "./model/RamSequenceModel";
-import { Sequence } from "../persistence";
-import { SequenceOptions } from "../interfaces";
-import { RamAdapter } from "./RamAdapter";
-import { Repo } from "../repository";
-/**
- * @description RAM-specific sequence implementation
- * @summary Extends the base Sequence class to provide auto-incrementing sequence functionality
- * for the RAM adapter. This class manages sequences stored in memory, allowing for the generation
- * of sequential identifiers for entities.
- * @param {SequenceOptions} options - Configuration options for the sequence
- * @param {RamAdapter} adapter - The RAM adapter instance to use for storage
- * @class RamSequence
- * @category Ram
- * @example
- * ```typescript
- * // Create a new numeric sequence starting at 1
- * const sequence = new RamSequence({
- *   name: 'order_sequence',
- *   type: 'Number',
- *   startWith: 1,
- *   incrementBy: 1
- * }, ramAdapter);
- *
- * // Get the next value in the sequence
- * const nextId = await sequence.next();
- *
- * // Get a range of values
- * const idRange = await sequence.range(5); // Returns 5 sequential values
- * ```
- */
-export declare class RamSequence extends Sequence {
-    protected repo: Repo<RamSequenceModel>;
-    constructor(options: SequenceOptions, adapter: RamAdapter);
-    /**
-     * @description Retrieves the current value of the sequence
-     * @summary Gets the current value of the sequence from storage. If the sequence
-     * doesn't exist yet, it returns the configured starting value.
-     * @return A promise that resolves to the current sequence value
-     */
-    current(): Promise<string | number | bigint>;
-    /**
-     * @description Parses a value according to the sequence type
-     * @summary Converts a value to the appropriate type for the sequence (string, number, or bigint)
-     * using the base Sequence class's parseValue method.
-     * @param {string | number | bigint} value - The value to parse
-     * @return {string | number | bigint} The parsed value in the correct type
-     */
-    private parse;
-    /**
-     * @description Increments the sequence value
-     * @summary Increases the current sequence value by the specified amount and persists
-     * the new value to storage. This method handles both numeric and BigInt sequence types.
-     * @param {string | number | bigint} current - The current value of the sequence
-     * @param {number} [count] - Optional amount to increment by, defaults to the sequence's incrementBy value
-     * @return A promise that resolves to the new sequence value after incrementing
-     */
-    private increment;
-    /**
-     * @description Gets the next value in the sequence
-     * @summary Retrieves the current value of the sequence and increments it by the
-     * configured increment amount. This is the main method used to get a new sequential value.
-     * @return A promise that resolves to the next value in the sequence
-     */
-    next(): Promise<number | string | bigint>;
-    /**
-     * @description Generates a range of sequential values
-     * @summary Retrieves a specified number of sequential values from the sequence.
-     * This is useful when you need to allocate multiple IDs at once.
-     * The method increments the sequence by the total amount needed and returns all values in the range.
-     * @param {number} count - The number of sequential values to generate
-     * @return A promise that resolves to an array of sequential values
-     */
-    range(count: number): Promise<(number | string | bigint)[]>;
-}