@elsikora/nestjs-crud-automator 3.0.2 → 4.0.0-dev.2

package/dist/cjs/class/api/controller/get-list/cursor/data-source-contract.class.js

@@ -0,0 +1,424 @@
+'use strict';
+
+var apiControllerCursor_constant = require('../../../../../constant/api-controller-cursor.constant.js');
+require('../../../../../enum/decorator/api/action.enum.js');
+require('../../../../../enum/decorator/api/authentication-type.enum.js');
+require('../../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js');
+require('../../../../../enum/decorator/api/controller/get-list/query/pagination-mode.enum.js');
+require('../../../../../enum/decorator/api/controller/get-list/query/unlisted-fields.enum.js');
+require('../../../../../enum/decorator/api/controller/relation-reference-shape.enum.js');
+require('../../../../../enum/decorator/api/controller/request/target.enum.js');
+require('../../../../../enum/decorator/api/controller/request/transformer-type.enum.js');
+require('../../../../../enum/decorator/api/controller/response-target.enum.js');
+require('../../../../../enum/decorator/api/dto-type.enum.js');
+require('../../../../../enum/decorator/api/function/context-storage-kind.enum.js');
+require('../../../../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js');
+require('../../../../../enum/decorator/api/function/transaction/event-status.enum.js');
+require('../../../../../enum/decorator/api/function/transaction/failure-stage.enum.js');
+require('../../../../../enum/decorator/api/function/transaction/mode.enum.js');
+require('../../../../../enum/decorator/api/function/transaction/outcome.enum.js');
+require('../../../../../enum/decorator/api/function/transaction/owner-kind.enum.js');
+require('../../../../../enum/decorator/api/function/transaction/trace-type.enum.js');
+require('../../../../../enum/decorator/api/function/type.enum.js');
+require('../../../../../enum/decorator/api/on-type.enum.js');
+require('../../../../../enum/decorator/api/property/data-type.enum.js');
+require('../../../../../enum/decorator/api/property/date/identifier.enum.js');
+require('../../../../../enum/decorator/api/property/date/type.enum.js');
+var desribeType_enum = require('../../../../../enum/decorator/api/property/desribe-type.enum.js');
+var numberType_enum = require('../../../../../enum/decorator/api/property/number-type.enum.js');
+var stringType_enum = require('../../../../../enum/decorator/api/property/string-type.enum.js');
+require('../../../../../enum/decorator/api/route/subscriber-authorization-expectation.enum.js');
+require('../../../../../enum/decorator/api/route/type.enum.js');
+var enumValues_utility = require('../../../../../utility/api/controller/get-list/query/enum-values.utility.js');
+var resolveCursorOrderFields_utility = require('../../../../../utility/api/controller/get-list/query/resolve-cursor-order-fields.utility.js');
+var exception_utility = require('../../../../../utility/error/exception.utility.js');
+var objectFindPropertyDescriptor_utility = require('../../../../../utility/object-find-property-descriptor.utility.js');
+
+const POSTGRES_BOOLEAN_OID = 16;
+const POSTGRES_BIGINT_OID = 20;
+const POSTGRES_SMALLINT_OID = 21;
+const POSTGRES_INTEGER_OID = 23;
+const POSTGRES_UUID_OID = 2950;
+const POSTGRES_BIGINT_PROBE = "9007199254740992";
+const SIGNED_BIGINT_MAXIMUM = 9223372036854775807n;
+const SIGNED_BIGINT_MINIMUM = -9223372036854775808n;
+const BASE64_INPUT_GROUP_SIZE = 3;
+const BASE64_OUTPUT_GROUP_SIZE = 4;
+const BOOLEAN_JSON_MAXIMUM_BYTES = 5;
+const JSON_STRING_QUOTES_BYTES = 2;
+const NUMBER_JSON_MAXIMUM_BYTES = 25;
+const SIGNED_BIGINT_JSON_MAXIMUM_BYTES = 22;
+const CURSOR_CONTEXT_HASH_LENGTH = 64;
+const BINARY_RADIX = 2;
+const SIGNED_WIDTH_OFFSET = 1;
+const UUID_TEXT_LENGTH = 36;
+const UUID_VALUE_PATTERN = /^[\da-f]{8}-(?:[\da-f]{4}-){3}[\da-f]{12}$/u;
+const INTEGER_BITS_16 = 16;
+const INTEGER_BITS_32 = 32;
+const SIGNED_SMALLINT_MINIMUM = -32768;
+const SIGNED_SMALLINT_MAXIMUM = 32_767;
+const SIGNED_INTEGER_MINIMUM = -2147483648;
+const SIGNED_INTEGER_MAXIMUM = 2_147_483_647;
+const INTEGER_STORAGE_BITS = Object.freeze({
+    "postgres:integer": INTEGER_BITS_32,
+    "postgres:smallint": INTEGER_BITS_16,
+});
+const EXACT_STORAGE_TYPES_BY_DRIVER = Object.freeze({
+    postgres: Object.freeze({
+        BIGINT_STRING: new Set(["bigint"]),
+        BOOLEAN: new Set(["boolean"]),
+        ENUM_NUMBER: new Set(["integer", "smallint"]),
+        INTEGER: new Set(["integer", "smallint"]),
+        UUID: new Set(["uuid"]),
+    }),
+});
+/**
+ * Proves that the active repository uses an exact database/storage/hydration
+ * contract for every protected cursor tuple field.
+ */
+class ApiControllerGetListCursorDataSourceContract {
+    static assertSafe(repository, plan) {
+        if (plan) {
+            this.assertStorageSafe(repository, plan);
+        }
+        const target = repository.metadata.target;
+        if (repository.metadata.afterLoadListeners.length > 0) {
+            throw exception_utility.ErrorException("CURSOR GET_LIST entity cannot use a TypeORM afterLoad listener");
+        }
+        for (const subscriber of repository.manager.connection.subscribers) {
+            if (this.hasAfterLoad(subscriber) && this.isApplicable(subscriber, target)) {
+                throw exception_utility.ErrorException("CURSOR GET_LIST entity cannot use an applicable TypeORM afterLoad subscriber");
+            }
+        }
+    }
+    static createValueValidator(repository, plan) {
+        this.assertSafe(repository, plan);
+        const driverType = this.getDriverType(repository);
+        if (!driverType) {
+            throw exception_utility.ErrorException("CURSOR GET_LIST requires a supported exact active database storage contract");
+        }
+        const contracts = Object.freeze(this.getOrderFields(plan).map((field) => {
+            const column = repository.metadata.columns.find((candidate) => candidate.propertyPath === field.path);
+            if (!column) {
+                throw exception_utility.ErrorException(`CURSOR GET_LIST active repository is missing order field "${field.path}"`);
+            }
+            return Object.freeze({
+                field,
+                normalizedStorageType: this.normalizeActiveStorageType(repository, column),
+                storageContract: this.getStorageContract(field),
+            });
+        }));
+        return Object.freeze((field, value) => {
+            const contract = contracts.find((candidate) => candidate.field === field && candidate.field.path === field.path);
+            if (!contract) {
+                throw exception_utility.ErrorException("CURSOR GET_LIST storage validator received an unknown order field");
+            }
+            this.assertStorageValueSafe(driverType, contract.normalizedStorageType, contract.storageContract, contract.field, value);
+        });
+    }
+    static assertActiveColumnMatches(field, column) {
+        const columnType = this.normalizeDeclaredColumnType(column.type);
+        const columnPrecision = column.precision ?? undefined;
+        const fieldPrecision = field.precision ?? undefined;
+        if (column.propertyPath !== field.path || columnType !== field.columnType || columnPrecision !== fieldPrecision || column.scale !== field.scale || column.isArray !== field.isColumnArray || column.isNullable !== field.isNullable || column.isSelect !== field.isSelected || column.unsigned !== field.isUnsigned || Boolean(column.transformer) !== field.hasTransformer) {
+            throw exception_utility.ErrorException(`CURSOR GET_LIST active column metadata for "${field.path}" differs from the compiled cursor plan`);
+        }
+        if (column.isArray || column.isNullable || !column.isSelect || column.transformer || column.isVirtual || column.isVirtualProperty) {
+            throw exception_utility.ErrorException(`CURSOR GET_LIST active order field "${field.path}" is not an exact selected persisted scalar`);
+        }
+    }
+    static assertExactPostgresTextParser(repository, storageContract, normalizedStorageType) {
+        const connection = repository.manager.connection;
+        const driver = connection.driver;
+        const postgres = driver && typeof driver === "object" && "postgres" in driver ? driver.postgres : undefined;
+        const driverTypes = postgres && typeof postgres === "object" && "types" in postgres ? postgres.types : undefined;
+        const getTypeParser = driverTypes && typeof driverTypes === "object" && "getTypeParser" in driverTypes ? driverTypes.getTypeParser : undefined;
+        if (typeof getTypeParser !== "function") {
+            throw exception_utility.ErrorException("CURSOR GET_LIST active PostgreSQL driver cannot prove its text result parsers");
+        }
+        let oid;
+        let probes;
+        if (storageContract === "BOOLEAN" && normalizedStorageType === "boolean") {
+            oid = POSTGRES_BOOLEAN_OID;
+            probes = Object.freeze([this.createPostgresParserProbe("t", true), this.createPostgresParserProbe("f", false)]);
+        }
+        else if ((storageContract === "INTEGER" || storageContract === "ENUM_NUMBER") && normalizedStorageType === "smallint") {
+            oid = POSTGRES_SMALLINT_OID;
+            probes = Object.freeze([this.createPostgresParserProbe(SIGNED_SMALLINT_MINIMUM.toString(), SIGNED_SMALLINT_MINIMUM), this.createPostgresParserProbe("-1", -1), this.createPostgresParserProbe("0", 0), this.createPostgresParserProbe("1", 1), this.createPostgresParserProbe(SIGNED_SMALLINT_MAXIMUM.toString(), SIGNED_SMALLINT_MAXIMUM)]);
+        }
+        else if ((storageContract === "INTEGER" || storageContract === "ENUM_NUMBER") && normalizedStorageType === "integer") {
+            oid = POSTGRES_INTEGER_OID;
+            probes = Object.freeze([this.createPostgresParserProbe(SIGNED_INTEGER_MINIMUM.toString(), SIGNED_INTEGER_MINIMUM), this.createPostgresParserProbe("-1", -1), this.createPostgresParserProbe("0", 0), this.createPostgresParserProbe("1", 1), this.createPostgresParserProbe(SIGNED_INTEGER_MAXIMUM.toString(), SIGNED_INTEGER_MAXIMUM)]);
+        }
+        else if (storageContract === "BIGINT_STRING" && normalizedStorageType === "bigint") {
+            oid = POSTGRES_BIGINT_OID;
+            probes = Object.freeze([SIGNED_BIGINT_MINIMUM.toString(), "-9007199254740993", "-9007199254740992", POSTGRES_BIGINT_PROBE, "9007199254740993", SIGNED_BIGINT_MAXIMUM.toString()].map((probe) => this.createPostgresParserProbe(probe, probe)));
+        }
+        else if (storageContract === "UUID" && normalizedStorageType === "uuid") {
+            oid = POSTGRES_UUID_OID;
+            probes = Object.freeze(["00000000-0000-0000-0000-000000000001", "00000000-0000-0000-0000-000000000002", "ffffffff-ffff-ffff-ffff-ffffffffffff"].map((probe) => this.createPostgresParserProbe(probe, probe)));
+        }
+        else {
+            throw exception_utility.ErrorException("CURSOR GET_LIST active PostgreSQL storage has no proven text result parser");
+        }
+        try {
+            const parser = Reflect.apply(getTypeParser, driverTypes, [oid, "text"]);
+            if (typeof parser !== "function" || !probes.every(([input, expected]) => Object.is(Reflect.apply(parser, undefined, [input]), expected))) {
+                throw exception_utility.ErrorException("CURSOR GET_LIST active PostgreSQL text result parser is incompatible with an order field");
+            }
+        }
+        catch {
+            throw exception_utility.ErrorException("CURSOR GET_LIST active PostgreSQL text result parser is incompatible with an order field");
+        }
+    }
+    static assertIntegerStorageValue(driverType, normalizedStorageType, field, value) {
+        const storageKey = `${driverType}:${normalizedStorageType}`;
+        const bits = INTEGER_STORAGE_BITS[storageKey];
+        if (!bits || typeof value !== "number" || !Number.isSafeInteger(value)) {
+            throw exception_utility.ErrorException(`CURSOR GET_LIST integer order field "${field.path}" has an invalid active storage value`);
+        }
+        const databaseMinimum = -(BINARY_RADIX ** (bits - SIGNED_WIDTH_OFFSET));
+        const databaseMaximum = BINARY_RADIX ** (bits - SIGNED_WIDTH_OFFSET) - SIGNED_WIDTH_OFFSET;
+        if (value < databaseMinimum || value > databaseMaximum) {
+            throw exception_utility.ErrorException(`CURSOR GET_LIST integer order field "${field.path}" exceeds its active database storage range`);
+        }
+    }
+    static assertPrimaryTieBreaker(repository, plan) {
+        const primaryColumns = repository.metadata.primaryColumns;
+        const finalTieBreaker = plan.order.tieBreakers?.at(-1)?.field;
+        if (primaryColumns.length !== 1 || !finalTieBreaker || primaryColumns[0]?.propertyPath !== finalTieBreaker) {
+            throw exception_utility.ErrorException("CURSOR GET_LIST active repository must use the final order field as its sole primary key");
+        }
+    }
+    static assertStorageSafe(repository, plan) {
+        const driverType = this.getDriverType(repository);
+        const fields = this.getOrderFields(plan);
+        const driverStorage = driverType ? EXACT_STORAGE_TYPES_BY_DRIVER[driverType] : undefined;
+        if (!driverType || !driverStorage) {
+            throw exception_utility.ErrorException("CURSOR GET_LIST requires a supported exact active database storage contract");
+        }
+        if (driverType === "postgres" && this.isPostgresBinaryMode(repository)) {
+            throw exception_utility.ErrorException("CURSOR GET_LIST requires PostgreSQL text result parsers for exact cursor values");
+        }
+        if (driverType === "postgres" && this.hasCustomPostgresTypes(repository)) {
+            throw exception_utility.ErrorException("CURSOR GET_LIST cannot prove custom PostgreSQL result parsers");
+        }
+        this.assertPrimaryTieBreaker(repository, plan);
+        const checkedParserContracts = new Set();
+        for (const field of fields) {
+            const column = repository.metadata.columns.find((candidate) => candidate.propertyPath === field.path);
+            if (!column) {
+                throw exception_utility.ErrorException(`CURSOR GET_LIST active repository is missing order field "${field.path}"`);
+            }
+            this.assertActiveColumnMatches(field, column);
+            const storageContract = this.getStorageContract(field);
+            const normalizedStorageType = this.normalizeActiveStorageType(repository, column);
+            if (!driverStorage[storageContract]?.has(normalizedStorageType)) {
+                throw exception_utility.ErrorException(`CURSOR GET_LIST order field "${field.path}" has no proven exact active database representation`);
+            }
+            if (field.isUnsigned) {
+                throw exception_utility.ErrorException(`CURSOR GET_LIST order field "${field.path}" cannot use unsigned metadata with active PostgreSQL storage`);
+            }
+            const parserContract = `${storageContract}:${normalizedStorageType}`;
+            if (!checkedParserContracts.has(parserContract)) {
+                this.assertExactPostgresTextParser(repository, storageContract, normalizedStorageType);
+                checkedParserContracts.add(parserContract);
+            }
+        }
+        this.assertTokenCapacitySafe(plan);
+    }
+    static assertStorageValueSafe(driverType, normalizedStorageType, storageContract, field, value) {
+        if (storageContract === "BOOLEAN") {
+            if (typeof value !== "boolean") {
+                throw exception_utility.ErrorException(`CURSOR GET_LIST boolean order field "${field.path}" has an invalid active storage value`);
+            }
+            return;
+        }
+        if (storageContract === "INTEGER" || storageContract === "ENUM_NUMBER") {
+            this.assertIntegerStorageValue(driverType, normalizedStorageType, field, value);
+            return;
+        }
+        if (storageContract === "BIGINT_STRING") {
+            if (typeof value !== "string" || !/^(?:0|-?[1-9]\d*)$/u.test(value)) {
+                throw exception_utility.ErrorException(`CURSOR GET_LIST bigint-string order field "${field.path}" has an invalid active storage value`);
+            }
+            const bigintValue = BigInt(value);
+            if (bigintValue < SIGNED_BIGINT_MINIMUM || bigintValue > SIGNED_BIGINT_MAXIMUM) {
+                throw exception_utility.ErrorException(`CURSOR GET_LIST bigint-string order field "${field.path}" exceeds the active PostgreSQL bigint domain`);
+            }
+            return;
+        }
+        if (storageContract === "UUID") {
+            if (typeof value !== "string" || !UUID_VALUE_PATTERN.test(value)) {
+                throw exception_utility.ErrorException(`CURSOR GET_LIST UUID order field "${field.path}" has an invalid active storage value`);
+            }
+            return;
+        }
+        throw exception_utility.ErrorException(`CURSOR GET_LIST order field "${field.path}" has no active storage value contract`);
+    }
+    static assertTokenCapacitySafe(plan) {
+        const emptyPayloadBytes = Buffer.byteLength(JSON.stringify({ c: "0".repeat(CURSOR_CONTEXT_HASH_LENGTH), v: 1, values: [] }), "utf8");
+        for (const fields of this.getOrderFieldSequences(plan)) {
+            let maximumPayloadBytes = emptyPayloadBytes + Math.max(0, fields.length - 1);
+            for (const field of fields) {
+                maximumPayloadBytes += this.getMaximumStorageJsonBytes(field);
+            }
+            if (Math.ceil((maximumPayloadBytes * BASE64_OUTPUT_GROUP_SIZE) / BASE64_INPUT_GROUP_SIZE) > apiControllerCursor_constant.API_CONTROLLER_CURSOR_TOKEN_MAX_LENGTH) {
+                throw exception_utility.ErrorException("CURSOR GET_LIST active order tuple can exceed the maximum cursor token length");
+            }
+        }
+    }
+    static createPostgresParserProbe(input, expected) {
+        return Object.freeze([input, expected]);
+    }
+    static getDriverType(repository) {
+        const options = repository.manager.connection.options;
+        const type = options && typeof options === "object" && "type" in options ? options.type : undefined;
+        return typeof type === "string" ? type : undefined;
+    }
+    static getMaximumStorageJsonBytes(field) {
+        const storageContract = this.getStorageContract(field);
+        if (storageContract === "BOOLEAN") {
+            return BOOLEAN_JSON_MAXIMUM_BYTES;
+        }
+        if (storageContract === "INTEGER" || storageContract === "ENUM_NUMBER") {
+            return NUMBER_JSON_MAXIMUM_BYTES;
+        }
+        if (storageContract === "BIGINT_STRING") {
+            return SIGNED_BIGINT_JSON_MAXIMUM_BYTES;
+        }
+        if (storageContract === "UUID") {
+            return UUID_TEXT_LENGTH + JSON_STRING_QUOTES_BYTES;
+        }
+        throw exception_utility.ErrorException(`CURSOR GET_LIST order field "${field.path}" has no bounded PostgreSQL CURSOR v1 storage contract`);
+    }
+    static getOrderFields(plan) {
+        return resolveCursorOrderFields_utility.ApiControllerGetListQueryResolveCursorOrderFields(plan.order).map((fieldName) => {
+            const field = plan.order.serverFields[fieldName];
+            if (!field) {
+                throw exception_utility.ErrorException("CURSOR GET_LIST compiled order field is missing");
+            }
+            return field;
+        });
+    }
+    static getOrderFieldSequences(plan) {
+        const tieBreakerFields = Object.freeze((plan.order.tieBreakers ?? []).map((entry) => entry.field));
+        const configuredSequences = [Object.freeze([...(plan.order.defaultOrder ?? []).map((entry) => entry.field), ...tieBreakerFields])];
+        for (const [fieldName, field] of Object.entries(plan.order.fields)) {
+            if (field.isEnabled) {
+                configuredSequences.push(Object.freeze([fieldName, ...tieBreakerFields]));
+            }
+        }
+        return Object.freeze(configuredSequences.map((sequence) => {
+            const seenFields = new Set();
+            const fields = [];
+            for (const fieldName of sequence) {
+                if (seenFields.has(fieldName)) {
+                    continue;
+                }
+                const field = plan.order.serverFields[fieldName];
+                if (!field) {
+                    throw exception_utility.ErrorException("CURSOR GET_LIST compiled order field is missing");
+                }
+                seenFields.add(fieldName);
+                fields.push(field);
+            }
+            return Object.freeze(fields);
+        }));
+    }
+    static getStorageContract(field) {
+        if (field.type === desribeType_enum.EApiPropertyDescribeType.BOOLEAN) {
+            return "BOOLEAN";
+        }
+        if (field.type === desribeType_enum.EApiPropertyDescribeType.NUMBER) {
+            if ("format" in field.metadata && field.metadata.format === numberType_enum.EApiPropertyNumberType.INTEGER) {
+                return "INTEGER";
+            }
+            throw exception_utility.ErrorException(`CURSOR GET_LIST numeric order field "${field.path}" is not supported by PostgreSQL CURSOR v1`);
+        }
+        if (field.type === desribeType_enum.EApiPropertyDescribeType.STRING) {
+            if ("format" in field.metadata && field.metadata.format === stringType_enum.EApiPropertyStringType.BIGINT_STRING) {
+                return "BIGINT_STRING";
+            }
+            throw exception_utility.ErrorException(`CURSOR GET_LIST string order field "${field.path}" is not supported by PostgreSQL CURSOR v1`);
+        }
+        if (field.type === desribeType_enum.EApiPropertyDescribeType.ENUM) {
+            const values = enumValues_utility.ApiControllerGetListQueryEnumValues("enum" in field.metadata ? field.metadata.enum : {});
+            if (values.length > 0 && values.every((value) => typeof value === "number" && Number.isSafeInteger(value))) {
+                return "ENUM_NUMBER";
+            }
+            throw exception_utility.ErrorException(`CURSOR GET_LIST enum order field "${field.path}" is not supported by PostgreSQL CURSOR v1`);
+        }
+        if (field.type === desribeType_enum.EApiPropertyDescribeType.UUID) {
+            return "UUID";
+        }
+        throw exception_utility.ErrorException(`CURSOR GET_LIST order field "${field.path}" is not supported by PostgreSQL CURSOR v1`);
+    }
+    static hasAfterLoad(subscriber) {
+        const descriptor = objectFindPropertyDescriptor_utility.ObjectFindPropertyDescriptor(subscriber, "afterLoad");
+        return Boolean(descriptor && (!("value" in descriptor) || typeof descriptor.value === "function"));
+    }
+    static hasCustomPostgresTypes(repository) {
+        const options = repository.manager.connection.options;
+        const extra = options && typeof options === "object" && "extra" in options ? options.extra : undefined;
+        return Boolean(extra && typeof extra === "object" && Object.hasOwn(extra, "types"));
+    }
+    static isApplicable(subscriber, target) {
+        const descriptor = objectFindPropertyDescriptor_utility.ObjectFindPropertyDescriptor(subscriber, "listenTo");
+        if (!descriptor) {
+            return true;
+        }
+        if (!("value" in descriptor) || typeof descriptor.value !== "function") {
+            throw exception_utility.ErrorException("CURSOR GET_LIST TypeORM subscriber listenTo must be a data method");
+        }
+        const listenedTarget = Reflect.apply(descriptor.value, subscriber, []);
+        if (!listenedTarget || listenedTarget === Object || listenedTarget === target) {
+            return true;
+        }
+        return typeof listenedTarget === "function" && typeof target === "function" && this.isConstructorAncestor(listenedTarget, target);
+    }
+    static isConstructorAncestor(ancestor, target) {
+        let current = Object.getPrototypeOf(target);
+        while (current) {
+            if (current === ancestor) {
+                return true;
+            }
+            current = Object.getPrototypeOf(current);
+        }
+        return false;
+    }
+    static isPostgresBinaryMode(repository) {
+        const connection = repository.manager.connection;
+        const extra = connection.options && typeof connection.options === "object" && "extra" in connection.options ? connection.options.extra : undefined;
+        const extraBinary = extra && typeof extra === "object" && "binary" in extra ? extra.binary : undefined;
+        const driver = connection.driver;
+        const postgres = driver && typeof driver === "object" && "postgres" in driver ? driver.postgres : undefined;
+        const postgresDefaults = postgres && typeof postgres === "object" && "defaults" in postgres ? postgres.defaults : undefined;
+        const defaultBinary = postgresDefaults && typeof postgresDefaults === "object" && "binary" in postgresDefaults ? postgresDefaults.binary : undefined;
+        return Boolean(extraBinary) || Boolean(defaultBinary);
+    }
+    static normalizeActiveStorageType(repository, column) {
+        const driver = repository.manager.connection.driver;
+        const normalizeType = driver && typeof driver === "object" && "normalizeType" in driver ? driver.normalizeType : undefined;
+        if (typeof normalizeType !== "function") {
+            throw exception_utility.ErrorException("CURSOR GET_LIST active database driver cannot prove its storage type");
+        }
+        const normalized = Reflect.apply(normalizeType, driver, [column]);
+        if (typeof normalized !== "string" || normalized.length === 0) {
+            throw exception_utility.ErrorException("CURSOR GET_LIST active database driver returned an invalid storage type");
+        }
+        return normalized.trim().toLowerCase();
+    }
+    static normalizeDeclaredColumnType(type) {
+        if (type === Boolean) {
+            return "boolean-constructor";
+        }
+        if (type === Number) {
+            return "number-constructor";
+        }
+        return typeof type === "string" ? type.trim().toLowerCase() : "unknown";
+    }
+}
+
+exports.ApiControllerGetListCursorDataSourceContract = ApiControllerGetListCursorDataSourceContract;
+//# sourceMappingURL=data-source-contract.class.js.map

package/dist/cjs/class/api/controller/get-list/cursor/data-source-contract.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source-contract.class.js","sources":["../../../../../../../../src/class/api/controller/get-list/cursor/data-source-contract.class.ts"],"sourcesContent":[null],"names":["ErrorException","API_CONTROLLER_CURSOR_TOKEN_MAX_LENGTH","ApiControllerGetListQueryResolveCursorOrderFields","EApiPropertyDescribeType","EApiPropertyNumberType","EApiPropertyStringType","ApiControllerGetListQueryEnumValues","ObjectFindPropertyDescriptor"],"mappings":"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"}

package/dist/cjs/class/api/controller/get-list/cursor/index.d.ts

@@ -0,0 +1,2 @@
+export { ApiControllerGetListCursorDataSourceContract } from './data-source-contract.class';
+export { ApiControllerGetListCursorRuntime } from './runtime.class';

package/dist/cjs/class/api/controller/get-list/cursor/runtime.class.d.ts

@@ -0,0 +1,28 @@
+import { EApiControllerGetListQueryPaginationMode } from '../../../../../enum/decorator/api';
+import { IApiBaseEntity } from '../../../../../interface/api-base-entity.interface';
+import { IApiControllerGetListQueryAst, IApiControllerGetListQueryPlanOrderEntry } from '../../../../../interface/class/api/controller/get-list/query';
+import { IApiGetListCursorResponseResult } from '../../../../../interface/decorator/api';
+import { TApiControllerGetListQueryCompiledPlan } from '../../../../../type/class/api/controller/get-list/compiled/plan.type';
+import { TApiControllerGetListCursorExecutionOptions } from '../../../../../type/class/api/controller/get-list/cursor/execution-options.type';
+export declare class ApiControllerGetListCursorRuntime {
+    static assertItemsInvariant(items: ReadonlyArray<IApiBaseEntity>, fields: ReadonlyArray<string>, signature: string): void;
+    static assertResponseInvariant(response: unknown, fields: ReadonlyArray<string>, signature: string): void;
+    static createContextHash(route: string, parameters: Partial<IApiBaseEntity> | undefined, plan: TApiControllerGetListQueryCompiledPlan<EApiControllerGetListQueryPaginationMode.CURSOR>, ast: IApiControllerGetListQueryAst, order: ReadonlyArray<IApiControllerGetListQueryPlanOrderEntry>, readPlanSignature?: string): string;
+    static createItemsInvariantSignature(items: ReadonlyArray<IApiBaseEntity>, fields: ReadonlyArray<string>): string;
+    static createResponseInvariantSignature(response: unknown, fields: ReadonlyArray<string>): string;
+    static execute<E extends IApiBaseEntity>(options: TApiControllerGetListCursorExecutionOptions<E>): Promise<IApiGetListCursorResponseResult<E>>;
+    static isolateItems<E extends IApiBaseEntity>(items: ReadonlyArray<E>, fields: ReadonlyArray<string>): Array<E>;
+    private static canonicalize;
+    private static canonicalStringify;
+    private static compareStrings;
+    private static createWindowWhere;
+    private static decode;
+    private static decodeValue;
+    private static encode;
+    private static executeWithinContract;
+    private static extractValues;
+    private static getOrderField;
+    private static readProtectedItemValue;
+    private static reverseOrder;
+    private static toTypeOrmOrder;
+}