@decaf-ts/core 0.7.2 → 0.7.4

package/lib/esm/ram/RamSequence.js

@@ -1,145 +0,0 @@
-import { RamSequenceModel } from "./model/RamSequenceModel.js";
-import { InternalError, NotFoundError } from "@decaf-ts/db-decorators";
-import { Sequence } from "./../persistence/index.js";
-import { Repository } from "./../repository/index.js";
-/**
- * @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 class RamSequence extends Sequence {
-    constructor(options, adapter) {
-        super(options);
-        this.repo = Repository.forModel(RamSequenceModel, adapter.alias);
-    }
-    /**
-     * @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
-     */
-    async current() {
-        const { name, startWith } = this.options;
-        try {
-            const sequence = await this.repo.read(name);
-            return this.parse(sequence.current);
-        }
-        catch (e) {
-            if (e instanceof NotFoundError) {
-                if (typeof startWith === "undefined")
-                    throw new InternalError("Starting value is not defined for a non existing sequence");
-                try {
-                    return this.parse(startWith);
-                }
-                catch (e) {
-                    throw new InternalError(`Failed to parse initial value for sequence ${startWith}: ${e}`);
-                }
-            }
-            throw new InternalError(`Failed to retrieve current value for sequence ${name}: ${e}`);
-        }
-    }
-    /**
-     * @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
-     */
-    parse(value) {
-        return Sequence.parseValue(this.options.type, value);
-    }
-    /**
-     * @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
-     */
-    async increment(current, count) {
-        const { type, incrementBy, name } = this.options;
-        let next;
-        const toIncrementBy = count || incrementBy;
-        if (toIncrementBy % incrementBy !== 0)
-            throw new InternalError(`Value to increment does not consider the incrementBy setting: ${incrementBy}`);
-        switch (type) {
-            case "Number":
-                next = this.parse(current) + toIncrementBy;
-                break;
-            case "BigInt":
-                next = this.parse(current) + BigInt(toIncrementBy);
-                break;
-            case "String":
-                next = this.parse(current);
-                break;
-            default:
-                throw new InternalError("Should never happen");
-        }
-        let seq;
-        const repo = this.repo.override({
-            ignoredValidationProperties: ["updatedOn"],
-        });
-        try {
-            seq = await repo.update(new RamSequenceModel({ id: name, current: next }));
-        }
-        catch (e) {
-            if (!(e instanceof NotFoundError)) {
-                throw e;
-            }
-            seq = await repo.create(new RamSequenceModel({ id: name, current: next }));
-        }
-        return seq.current;
-    }
-    /**
-     * @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
-     */
-    async next() {
-        const current = await this.current();
-        return this.increment(current);
-    }
-    /**
-     * @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
-     */
-    async range(count) {
-        const current = (await this.current());
-        const incrementBy = this.parse(this.options.incrementBy);
-        const next = await this.increment(current, this.parse(count) * incrementBy);
-        const range = [];
-        for (let i = 1; i <= count; i++) {
-            range.push(current + incrementBy * this.parse(i));
-        }
-        if (range[range.length - 1] !== next && this.options.type !== "String")
-            throw new InternalError("Miscalculation of range");
-        return range;
-    }
-}
-//# sourceMappingURL=RamSequence.js.map

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

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

package/lib/esm/ram/model/RamSequenceModel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RamSequenceModel.js","sourceRoot":"","sources":["../../../../src/ram/model/RamSequenceModel.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,+BAAoB;AACtD,OAAO,EAAE,EAAE,EAAE,kCAAuB;AAEpC;;;;;;;;;;;;;;;;;GAiBG;AAGI,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,SAAS;IAe7C,YAAY,GAAgC;QAC1C,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;CACF,CAAA;AAbC;IADC,EAAE,EAAE;;4CACO;AAQZ;IAFC,QAAQ,EAAE;IACV,KAAK,EAAE;;iDACkB;AAbf,gBAAgB;IAF5B,KAAK,CAAC,eAAe,CAAC;IACtB,KAAK,EAAE;;GACK,gBAAgB,CAkB5B"}

package/lib/esm/ram/model/index.d.ts

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

package/lib/esm/ram/model/index.js

@@ -1,2 +0,0 @@
-export * from "./RamSequenceModel.js";
-//# sourceMappingURL=index.js.map

package/lib/esm/ram/model/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ram/model/index.ts"],"names":[],"mappings":"AAAA,sCAAmC"}

package/lib/identity/utils.cjs

@@ -1,49 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTableName = getTableName;
-exports.getColumnName = getColumnName;
-exports.sequenceNameForModel = sequenceNameForModel;
-const decorator_validation_1 = require("@decaf-ts/decorator-validation");
-const db_decorators_1 = require("@decaf-ts/db-decorators");
-const constants_1 = require("./../persistence/constants.cjs");
-const decoration_1 = require("@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
- */
-function getTableName(model) {
-    const obj = model instanceof decorator_validation_1.Model ? decorator_validation_1.Model.get(model.constructor.name) : model;
-    if (!obj)
-        throw new db_decorators_1.InternalError(`Unable to find model ${model}`);
-    const meta = decoration_1.Metadata.get(model instanceof decorator_validation_1.Model ? model.constructor : model, constants_1.PersistenceKeys.TABLE);
-    if (meta) {
-        return meta;
-    }
-    if (model instanceof decorator_validation_1.Model) {
-        return model.constructor.name;
-    }
-    return model.name;
-}
-function getColumnName(model, attribute) {
-    const metadata = decoration_1.Metadata.get(model instanceof decorator_validation_1.Model ? model.constructor : model, decoration_1.Metadata.key(constants_1.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
- */
-function sequenceNameForModel(model, ...args) {
-    return [getTableName(model), ...args].join("_");
-}
-//# sourceMappingURL=utils.js.map

package/lib/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/identity/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/identity/utils.ts"],"names":[],"mappings":";;AAcA,oCAoBC;AAED,sCASC;AAYD,oDAKC;AA9DD,yEAAuD;AACvD,2DAAwD;AACxD,8DAA2D;AAC3D,qDAA6D;AAE7D;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAC1B,KAAyB;IAEzB,MAAM,GAAG,GACP,KAAK,YAAY,4BAAK,CAAC,CAAC,CAAC,4BAAK,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAErE,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,6BAAa,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;IAEnE,MAAM,IAAI,GAAG,qBAAQ,CAAC,GAAG,CACvB,KAAK,YAAY,4BAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAE,KAAa,EAC3D,2BAAe,CAAC,KAAK,CACtB,CAAC;IAEF,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,YAAY,4BAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC;AACpB,CAAC;AAED,SAAgB,aAAa,CAC3B,KAAyB,EACzB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,qBAAQ,CAAC,GAAG,CAC3B,KAAK,YAAY,4BAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAE,KAAa,EAC3D,qBAAQ,CAAC,GAAG,CAAC,2BAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAChD,CAAC;IACF,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACzC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,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/ram/RamContext.cjs

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RamContext = void 0;
-const db_decorators_1 = require("@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
- */
-class RamContext extends db_decorators_1.Context {
-    constructor() {
-        super();
-    }
-}
-exports.RamContext = RamContext;
-//# sourceMappingURL=RamContext.js.map

package/lib/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/ram/RamContext.js.map

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

package/lib/ram/RamSequence.cjs

@@ -1,149 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RamSequence = void 0;
-const RamSequenceModel_1 = require("./model/RamSequenceModel.cjs");
-const db_decorators_1 = require("@decaf-ts/db-decorators");
-const persistence_1 = require("./../persistence/index.cjs");
-const repository_1 = require("./../repository/index.cjs");
-/**
- * @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
- * ```
- */
-class RamSequence extends persistence_1.Sequence {
-    constructor(options, adapter) {
-        super(options);
-        this.repo = repository_1.Repository.forModel(RamSequenceModel_1.RamSequenceModel, adapter.alias);
-    }
-    /**
-     * @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
-     */
-    async current() {
-        const { name, startWith } = this.options;
-        try {
-            const sequence = await this.repo.read(name);
-            return this.parse(sequence.current);
-        }
-        catch (e) {
-            if (e instanceof db_decorators_1.NotFoundError) {
-                if (typeof startWith === "undefined")
-                    throw new db_decorators_1.InternalError("Starting value is not defined for a non existing sequence");
-                try {
-                    return this.parse(startWith);
-                }
-                catch (e) {
-                    throw new db_decorators_1.InternalError(`Failed to parse initial value for sequence ${startWith}: ${e}`);
-                }
-            }
-            throw new db_decorators_1.InternalError(`Failed to retrieve current value for sequence ${name}: ${e}`);
-        }
-    }
-    /**
-     * @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
-     */
-    parse(value) {
-        return persistence_1.Sequence.parseValue(this.options.type, value);
-    }
-    /**
-     * @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
-     */
-    async increment(current, count) {
-        const { type, incrementBy, name } = this.options;
-        let next;
-        const toIncrementBy = count || incrementBy;
-        if (toIncrementBy % incrementBy !== 0)
-            throw new db_decorators_1.InternalError(`Value to increment does not consider the incrementBy setting: ${incrementBy}`);
-        switch (type) {
-            case "Number":
-                next = this.parse(current) + toIncrementBy;
-                break;
-            case "BigInt":
-                next = this.parse(current) + BigInt(toIncrementBy);
-                break;
-            case "String":
-                next = this.parse(current);
-                break;
-            default:
-                throw new db_decorators_1.InternalError("Should never happen");
-        }
-        let seq;
-        const repo = this.repo.override({
-            ignoredValidationProperties: ["updatedOn"],
-        });
-        try {
-            seq = await repo.update(new RamSequenceModel_1.RamSequenceModel({ id: name, current: next }));
-        }
-        catch (e) {
-            if (!(e instanceof db_decorators_1.NotFoundError)) {
-                throw e;
-            }
-            seq = await repo.create(new RamSequenceModel_1.RamSequenceModel({ id: name, current: next }));
-        }
-        return seq.current;
-    }
-    /**
-     * @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
-     */
-    async next() {
-        const current = await this.current();
-        return this.increment(current);
-    }
-    /**
-     * @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
-     */
-    async range(count) {
-        const current = (await this.current());
-        const incrementBy = this.parse(this.options.incrementBy);
-        const next = await this.increment(current, this.parse(count) * incrementBy);
-        const range = [];
-        for (let i = 1; i <= count; i++) {
-            range.push(current + incrementBy * this.parse(i));
-        }
-        if (range[range.length - 1] !== next && this.options.type !== "String")
-            throw new db_decorators_1.InternalError("Miscalculation of range");
-        return range;
-    }
-}
-exports.RamSequence = RamSequence;
-//# sourceMappingURL=RamSequence.js.map

package/lib/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)[]>;
-}

package/lib/ram/RamSequence.js.map

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

package/lib/ram/model/RamSequenceModel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RamSequenceModel.js","sourceRoot":"","sources":["../../../src/ram/model/RamSequenceModel.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yEAAiE;AAEjE,mDAAsD;AACtD,yDAAoC;AAEpC;;;;;;;;;;;;;;;;;GAiBG;AAGI,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,iBAAS;IAe7C,YAAY,GAAgC;QAC1C,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;CACF,CAAA;AAlBY,4CAAgB;AAK3B;IADC,IAAA,aAAE,GAAE;;4CACO;AAQZ;IAFC,IAAA,+BAAQ,GAAE;IACV,IAAA,aAAK,GAAE;;iDACkB;2BAbf,gBAAgB;IAF5B,IAAA,aAAK,EAAC,eAAe,CAAC;IACtB,IAAA,4BAAK,GAAE;;GACK,gBAAgB,CAkB5B"}

package/lib/ram/model/index.cjs

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-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("./RamSequenceModel.cjs"), exports);
-//# sourceMappingURL=index.js.map

package/lib/ram/model/index.d.ts

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

package/lib/ram/model/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ram/model/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAmC"}