@deterministic-code/datasources 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -0,0 +1,126 @@
+export type { ICommand } from "./ICommand.js";
+export { execute, executeReader } from "./ICommand.js";
+export type { ICommandMiddleware } from "./ICommandMiddleware.js";
+export type { IConnection } from "./IConnection.js";
+export type { IDatasource } from "./IDatasource.js";
+export type { IDriver } from "./IDriver.js";
+export { columnType } from "./IDriver.js";
+export type { Information } from "./Information.js";
+export type { DatasourceOptions } from "./DatasourceOptions.js";
+export { DatasourceFactory } from "./DatasourceFactory.js";
+export { ProviderCatalog } from "./ProviderCatalog.js";
+export { DriverLoader } from "./DriverLoader.js";
+export type { ICreateTableStatement, ICreateIndexStatement, IDropTableStatement, IAlterTableStatement, AlterAction, IDropIndexStatement, IDropTriggerStatement, ICreateTriggerStatement, IIdentityInsertStatement, ICreateCreateStoredProcedureStatement, ICreateReadStoredProcedureStatement, ICreateUpdateStoredProcedureStatement, ICreateDeleteStoredProcedureStatement, ICreateBulkCreateStoredProcedureStatement, ICreateBulkUpdateStoredProcedureStatement, ICreateBulkDeleteStoredProcedureStatement, IDropRoutineStatement, RoutineParameter, IDeleteStatement, IExpression, IBulkDeleteStatement, IBulkInsertStatement, IBulkUpdateStatement, IInsertStatement, ISelectStatement, IStatement, IStatementVisitor, ICondition, IConditionVisitor, IExecuteStoredProcedureStatement, IReturnStatement, ITableConstraint, TableConstraintKind, IUpdateStatement, IWhere, } from "./statements/index.js";
+export type { IReader } from "./IReader.js";
+export type { IRepository } from "./IRepository.js";
+export type { IReadonlyRepository } from "./IReadonlyRepository.js";
+export type { ICRUDRepository } from "./ICRUDRepository.js";
+export { ReadonlyRepository, untyped } from "./ReadonlyRepository.js";
+export type { IRepositoryFactory } from "./IRepositoryFactory.js";
+export type { ICRUDRepositoryFactory } from "./ICRUDRepositoryFactory.js";
+export { RepositoryFactory } from "./RepositoryFactory.js";
+export { RepositoryAccess } from "./RepositoryAccess.js";
+export { RepositoryNotRegisteredError } from "./RepositoryNotRegisteredError.js";
+export type { IEnriched } from "./IEnriched.js";
+export type { IRepositoryTree } from "./IRepositoryTree.js";
+export type { IRepositoryTreeNode } from "./IRepositoryTreeNode.js";
+export type { Association, Enrichment } from "./Enrichment.js";
+export { EnrichmentPropertyType } from "./EnrichmentPropertyType.js";
+export type { IReadonlyEnrichmentStrategy } from "./IReadonlyEnrichmentStrategy.js";
+export type { IWriteEnrichmentStrategy } from "./IWriteEnrichmentStrategy.js";
+export type { WriteMode } from "./WriteMode.js";
+export { DefaultReadonlyEnrichmentStrategy } from "./DefaultReadonlyEnrichmentStrategy.js";
+export { DefaultWriteEnrichmentStrategy } from "./DefaultWriteEnrichmentStrategy.js";
+export { DeleteEnrichmentStrategy } from "./DeleteEnrichmentStrategy.js";
+export { CascadeDeleteEnrichmentStrategy } from "./CascadeDeleteEnrichmentStrategy.js";
+export { UpdateEnrichmentStrategy } from "./UpdateEnrichmentStrategy.js";
+export { DefaultUpdateEnrichmentStrategy } from "./DefaultUpdateEnrichmentStrategy.js";
+export { CreateEnrichmentStrategy } from "./CreateEnrichmentStrategy.js";
+export { DefaultCreateEnrichmentStrategy } from "./DefaultCreateEnrichmentStrategy.js";
+export { CascadeDeleteUpdateEnrichmentStrategy } from "./CascadeDeleteUpdateEnrichmentStrategy.js";
+export { LazyWriteEnrichmentStrategy } from "./LazyWriteEnrichmentStrategy.js";
+export { HashsetOptimizedReadonlyEnrichmentStrategy } from "./HashsetOptimizedReadonlyEnrichmentStrategy.js";
+export { NestedToObjectEnrichmentStrategy } from "./NestedToObjectEnrichmentStrategy.js";
+export { BulkCRUDRepository } from "./BulkCRUDRepository.js";
+export type { IBulkWriteStrategy } from "./IBulkWriteStrategy.js";
+export type { BulkCommand } from "./BulkCommand.js";
+export { SingleCommandIBulkWriteStrategy } from "./SingleCommandIBulkWriteStrategy.js";
+export { BatchCommandIBulkWriteStrategy } from "./BatchCommandIBulkWriteStrategy.js";
+export { StoredProcedureBulkWriteStrategy } from "./StoredProcedureBulkWriteStrategy.js";
+export { RepositoryTree } from "./RepositoryTree.js";
+export { RepositoryTreeNode } from "./RepositoryTreeNode.js";
+export { CRUDRepository } from "./CRUDRepository.js";
+export { ReadonlyRepositoryBuilder } from "./ReadonlyRepositoryBuilder.js";
+export { CRUDRepositoryBuilder } from "./CRUDRepositoryBuilder.js";
+export { StatementMappers } from "./StatementMappers.js";
+export { ReadonlyRepositoryStatements } from "./ReadonlyRepositoryStatements.js";
+export { CRUDRepositoryStatements } from "./CRUDRepositoryStatements.js";
+export type { BuiltRepository } from "./BuiltRepository.js";
+export { createCRUDRepositoryOptions } from "./createCRUDRepositoryOptions.js";
+export { createReadonlyRepositoryMappingOptions } from "./createReadonlyRepositoryMappingOptions.js";
+export type { ReadonlyRepositoryMappingOptions } from "./ReadonlyRepositoryMappingOptions.js";
+export type { CRUDRepositoryOptions } from "./CRUDRepositoryOptions.js";
+export { Response } from "./Response.js";
+export type { ITransaction } from "./ITransaction.js";
+export type { IUnitOfWork } from "./IUnitOfWork.js";
+export { UnitOfWorkTransaction } from "./UnitOfWorkTransaction.js";
+export { IsolationLevel } from "./IsolationLevel.js";
+export type { IsolationLevel as IsolationLevelName } from "./IsolationLevel.js";
+export type { Comparison } from "./statements/index.js";
+export { ArrayExpression, CheckConstraint, ColumnDefault, Condition, ConditionRenderer, ExpressionRenderer, CreateIndexStatement, CreateTableStatement, CreateTableStatementTextRenderer, CreateIndexStatementTextRenderer, DropTableStatement, DropTableStatementTextRenderer, AlterTableStatement, AlterTableStatementTextRenderer, DropIndexStatement, DropIndexStatementTextRenderer, DropTriggerStatement, DropTriggerStatementTextRenderer, CreateTriggerStatement, CreateTriggerStatementTextRenderer, IdentityInsertStatement, IdentityInsertStatementTextRenderer, CreateCreateStoredProcedureStatement, CreateReadStoredProcedureStatement, CreateUpdateStoredProcedureStatement, CreateDeleteStoredProcedureStatement, CreateBulkCreateStoredProcedureStatement, CreateBulkUpdateStoredProcedureStatement, CreateBulkDeleteStoredProcedureStatement, CreateCreateStoredProcedureStatementTextRenderer, CreateReadStoredProcedureStatementTextRenderer, CreateUpdateStoredProcedureStatementTextRenderer, CreateDeleteStoredProcedureStatementTextRenderer, CreateBulkCreateStoredProcedureStatementTextRenderer, CreateBulkUpdateStoredProcedureStatementTextRenderer, CreateBulkDeleteStoredProcedureStatementTextRenderer, DropRoutineStatement, DropRoutineStatementTextRenderer, SelectStatementTextRenderer, InsertStatementTextRenderer, UpdateStatementTextRenderer, DeleteStatementTextRenderer, BulkInsertStatementTextRenderer, BulkUpdateStatementTextRenderer, BulkDeleteStatementTextRenderer, ExecuteStoredProcedureStatementTextRenderer, ReturnStatementTextRenderer, SelectInsertedIdStatementTextRenderer, DefaultStatementTextRenderer, DeleteStatement, ForeignKey, Identifier, InsertStatement, BulkInsertStatement, BulkUpdateStatement, BulkDeleteStatement, Literal, NotNull, Operator, eq, ne, gt, lt, ge, le, PrimaryKey, Aggregate, OrderBy, SelectStatement, StatementParser, StatementRenderer, StatementTextRenderer, Native, n, Subquery, ReferentialAction, ExpressionEvaluator, StatementEvaluator, ExecuteStoredProcedureStatement, SelectInsertedIdStatement, ReturnStatement, UniqueConstraint, UpdateStatement, WhereText, Where, Join, } from "./statements/index.js";
+export type { IDatasourceFactory } from "./IDatasourceFactory.js";
+export type { Parameter } from "./Parameter.js";
+export { ParameterDirection } from "./ParameterDirection.js";
+export type { ParameterDirection as ParameterDirectionName } from "./ParameterDirection.js";
+export type { Row } from "./Row.js";
+export { ArrayReader } from "./ArrayReader.js";
+export { FirstResultReader } from "./FirstResultReader.js";
+export { StreamingReader, statementReader } from "./StreamingReader.js";
+export { splitStatements } from "./splitStatements.js";
+export { statementParameters } from "./statementParameters.js";
+export { statementUsesParameter } from "./statementUsesParameter.js";
+export { collectAsync } from "./collectAsync.js";
+export { CommandMiddlewareHost } from "./CommandMiddlewareHost.js";
+export { ConsoleCommandMiddleware, formatElapsed, } from "./ConsoleCommandMiddleware.js";
+export { ExpectConsoleMiddleware } from "./ExpectConsoleMiddleware.js";
+export { Datasource } from "./Datasource.js";
+export { DatasourceUrl } from "./DatasourceUrl.js";
+export { DatasourceUrlParser } from "./DatasourceUrlParser.js";
+export { DatasourceError } from "./DatasourceError.js";
+export type { Cell, Cells } from "./converters/Cell.js";
+export type { Constructable } from "./converters/Constructable.js";
+export { TypeConverter } from "./converters/TypeConverter.js";
+export { type FieldSize, type SpecField, } from "./converters/SpecField.js";
+export type { DecimalRule, SpecFieldRules } from "./converters/SpecFieldRules.js";
+export type { IMapping } from "./converters/IMapping.js";
+export { DeterministicTypeConverter } from "./converters/DeterministicTypeConverter.js";
+export type { DefaultValueOptions } from "./converters/DefaultValueOptions.js";
+export { DefaultValueConverter, EMPTY_UUID, sqlStringLiteral, } from "./converters/DefaultValueConverter.js";
+export { MetaDataRowTypeConverter } from "./converters/MetaDataRowTypeConverter.js";
+export { RowTypeConverter } from "./converters/RowTypeConverter.js";
+export { ToLowerCaseConverter } from "./converters/ToLowerCaseConverter.js";
+export { ToUpperCaseConverter } from "./converters/ToUpperCaseConverter.js";
+export { ChangeCasingConverter, type Casing } from "./converters/ChangeCasingConverter.js";
+export { PluralizerConverter } from "./converters/PluralizerConverter.js";
+export { RegexConverter } from "./converters/RegexConverter.js";
+export { ReplaceConverter } from "./converters/ReplaceConverter.js";
+export type { IMapper } from "./mappers/IMapper.js";
+export type { IFlatToNestedMapper } from "./mappers/IFlatToNestedMapper.js";
+export type { TypeMap, TypeMapFields } from "./mappers/TypeMap.js";
+export type { TypeMapGroup } from "./mappers/TypeMapGroup.js";
+export { FlatToNestedMapper } from "./mappers/FlatToNestedMapper.js";
+export { ChangeCasingMapper } from "./mappers/ChangeCasingMapper.js";
+export { DictionaryMapper } from "./mappers/DictionaryMapper.js";
+export { IdentityMapper } from "./mappers/IdentityMapper.js";
+export { PluralizerMapper } from "./mappers/PluralizerMapper.js";
+export { TransformMapper } from "./mappers/TransformMapper.js";
+export { TransformConverterMapper } from "./mappers/TransformConverterMapper.js";
+export { RowTypeMapper } from "./mappers/RowTypeMapper.js";
+export { parametersToRecord } from "./parametersToRecord.js";
+export { ProviderNotImplementedError } from "./ProviderNotImplementedError.js";
+export { ProviderNotInstalledError } from "./ProviderNotInstalledError.js";
+export type { Column, JoinKind, SelectStatementOptions, ReferentialAction as ReferentialActionName, SortDirection } from "./statements/index.js";
+export type { Field, Scalar } from "./builders/index.js";
+export { readerToAsyncIterable } from "./readerToAsyncIterable.js";
+export { StubCommand, StubConnection, StubDatasource, StubReader, StubRepository, StubTransaction, createStubDatasource, } from "./stubs/index.js";
+export { MockCommand, MockConnection, MockDatasource, MockDriver, MockSelectStatement, MockReader, MockRepository, MockTransaction, MockWhere, } from "./mocks/index.js";

package/dist/index.js

@@ -0,0 +1,83 @@
+export { execute, executeReader } from "./ICommand.js";
+export { columnType } from "./IDriver.js";
+export { DatasourceFactory } from "./DatasourceFactory.js";
+export { ProviderCatalog } from "./ProviderCatalog.js";
+export { DriverLoader } from "./DriverLoader.js";
+export { ReadonlyRepository, untyped } from "./ReadonlyRepository.js";
+export { RepositoryFactory } from "./RepositoryFactory.js";
+export { RepositoryAccess } from "./RepositoryAccess.js";
+export { RepositoryNotRegisteredError } from "./RepositoryNotRegisteredError.js";
+export { EnrichmentPropertyType } from "./EnrichmentPropertyType.js";
+export { DefaultReadonlyEnrichmentStrategy } from "./DefaultReadonlyEnrichmentStrategy.js";
+export { DefaultWriteEnrichmentStrategy } from "./DefaultWriteEnrichmentStrategy.js";
+export { DeleteEnrichmentStrategy } from "./DeleteEnrichmentStrategy.js";
+export { CascadeDeleteEnrichmentStrategy } from "./CascadeDeleteEnrichmentStrategy.js";
+export { UpdateEnrichmentStrategy } from "./UpdateEnrichmentStrategy.js";
+export { DefaultUpdateEnrichmentStrategy } from "./DefaultUpdateEnrichmentStrategy.js";
+export { CreateEnrichmentStrategy } from "./CreateEnrichmentStrategy.js";
+export { DefaultCreateEnrichmentStrategy } from "./DefaultCreateEnrichmentStrategy.js";
+export { CascadeDeleteUpdateEnrichmentStrategy } from "./CascadeDeleteUpdateEnrichmentStrategy.js";
+export { LazyWriteEnrichmentStrategy } from "./LazyWriteEnrichmentStrategy.js";
+export { HashsetOptimizedReadonlyEnrichmentStrategy } from "./HashsetOptimizedReadonlyEnrichmentStrategy.js";
+export { NestedToObjectEnrichmentStrategy } from "./NestedToObjectEnrichmentStrategy.js";
+export { BulkCRUDRepository } from "./BulkCRUDRepository.js";
+export { SingleCommandIBulkWriteStrategy } from "./SingleCommandIBulkWriteStrategy.js";
+export { BatchCommandIBulkWriteStrategy } from "./BatchCommandIBulkWriteStrategy.js";
+export { StoredProcedureBulkWriteStrategy } from "./StoredProcedureBulkWriteStrategy.js";
+export { RepositoryTree } from "./RepositoryTree.js";
+export { RepositoryTreeNode } from "./RepositoryTreeNode.js";
+export { CRUDRepository } from "./CRUDRepository.js";
+export { ReadonlyRepositoryBuilder } from "./ReadonlyRepositoryBuilder.js";
+export { CRUDRepositoryBuilder } from "./CRUDRepositoryBuilder.js";
+export { StatementMappers } from "./StatementMappers.js";
+export { ReadonlyRepositoryStatements } from "./ReadonlyRepositoryStatements.js";
+export { CRUDRepositoryStatements } from "./CRUDRepositoryStatements.js";
+export { createCRUDRepositoryOptions } from "./createCRUDRepositoryOptions.js";
+export { createReadonlyRepositoryMappingOptions } from "./createReadonlyRepositoryMappingOptions.js";
+export { Response } from "./Response.js";
+export { UnitOfWorkTransaction } from "./UnitOfWorkTransaction.js";
+export { IsolationLevel } from "./IsolationLevel.js";
+export { ArrayExpression, CheckConstraint, ColumnDefault, Condition, ConditionRenderer, ExpressionRenderer, CreateIndexStatement, CreateTableStatement, CreateTableStatementTextRenderer, CreateIndexStatementTextRenderer, DropTableStatement, DropTableStatementTextRenderer, AlterTableStatement, AlterTableStatementTextRenderer, DropIndexStatement, DropIndexStatementTextRenderer, DropTriggerStatement, DropTriggerStatementTextRenderer, CreateTriggerStatement, CreateTriggerStatementTextRenderer, IdentityInsertStatement, IdentityInsertStatementTextRenderer, CreateCreateStoredProcedureStatement, CreateReadStoredProcedureStatement, CreateUpdateStoredProcedureStatement, CreateDeleteStoredProcedureStatement, CreateBulkCreateStoredProcedureStatement, CreateBulkUpdateStoredProcedureStatement, CreateBulkDeleteStoredProcedureStatement, CreateCreateStoredProcedureStatementTextRenderer, CreateReadStoredProcedureStatementTextRenderer, CreateUpdateStoredProcedureStatementTextRenderer, CreateDeleteStoredProcedureStatementTextRenderer, CreateBulkCreateStoredProcedureStatementTextRenderer, CreateBulkUpdateStoredProcedureStatementTextRenderer, CreateBulkDeleteStoredProcedureStatementTextRenderer, DropRoutineStatement, DropRoutineStatementTextRenderer, SelectStatementTextRenderer, InsertStatementTextRenderer, UpdateStatementTextRenderer, DeleteStatementTextRenderer, BulkInsertStatementTextRenderer, BulkUpdateStatementTextRenderer, BulkDeleteStatementTextRenderer, ExecuteStoredProcedureStatementTextRenderer, ReturnStatementTextRenderer, SelectInsertedIdStatementTextRenderer, DefaultStatementTextRenderer, DeleteStatement, ForeignKey, Identifier, InsertStatement, BulkInsertStatement, BulkUpdateStatement, BulkDeleteStatement, Literal, NotNull, Operator, eq, ne, gt, lt, ge, le, PrimaryKey, Aggregate, OrderBy, SelectStatement, StatementParser, StatementRenderer, StatementTextRenderer, Native, n, Subquery, ReferentialAction, ExpressionEvaluator, StatementEvaluator, ExecuteStoredProcedureStatement, SelectInsertedIdStatement, ReturnStatement, UniqueConstraint, UpdateStatement, WhereText, Where, Join, } from "./statements/index.js";
+export { ParameterDirection } from "./ParameterDirection.js";
+export { ArrayReader } from "./ArrayReader.js";
+export { FirstResultReader } from "./FirstResultReader.js";
+export { StreamingReader, statementReader } from "./StreamingReader.js";
+export { splitStatements } from "./splitStatements.js";
+export { statementParameters } from "./statementParameters.js";
+export { statementUsesParameter } from "./statementUsesParameter.js";
+export { collectAsync } from "./collectAsync.js";
+export { CommandMiddlewareHost } from "./CommandMiddlewareHost.js";
+export { ConsoleCommandMiddleware, formatElapsed, } from "./ConsoleCommandMiddleware.js";
+export { ExpectConsoleMiddleware } from "./ExpectConsoleMiddleware.js";
+export { Datasource } from "./Datasource.js";
+export { DatasourceUrl } from "./DatasourceUrl.js";
+export { DatasourceUrlParser } from "./DatasourceUrlParser.js";
+import { Datasource } from "./Datasource.js";
+import { DatasourceFactory } from "./DatasourceFactory.js";
+Datasource.create = (options) => DatasourceFactory.create(options);
+export { DatasourceError } from "./DatasourceError.js";
+export { TypeConverter } from "./converters/TypeConverter.js";
+export { DeterministicTypeConverter } from "./converters/DeterministicTypeConverter.js";
+export { DefaultValueConverter, EMPTY_UUID, sqlStringLiteral, } from "./converters/DefaultValueConverter.js";
+export { MetaDataRowTypeConverter } from "./converters/MetaDataRowTypeConverter.js";
+export { RowTypeConverter } from "./converters/RowTypeConverter.js";
+export { ToLowerCaseConverter } from "./converters/ToLowerCaseConverter.js";
+export { ToUpperCaseConverter } from "./converters/ToUpperCaseConverter.js";
+export { ChangeCasingConverter } from "./converters/ChangeCasingConverter.js";
+export { PluralizerConverter } from "./converters/PluralizerConverter.js";
+export { RegexConverter } from "./converters/RegexConverter.js";
+export { ReplaceConverter } from "./converters/ReplaceConverter.js";
+export { FlatToNestedMapper } from "./mappers/FlatToNestedMapper.js";
+export { ChangeCasingMapper } from "./mappers/ChangeCasingMapper.js";
+export { DictionaryMapper } from "./mappers/DictionaryMapper.js";
+export { IdentityMapper } from "./mappers/IdentityMapper.js";
+export { PluralizerMapper } from "./mappers/PluralizerMapper.js";
+export { TransformMapper } from "./mappers/TransformMapper.js";
+export { TransformConverterMapper } from "./mappers/TransformConverterMapper.js";
+export { RowTypeMapper } from "./mappers/RowTypeMapper.js";
+export { parametersToRecord } from "./parametersToRecord.js";
+export { ProviderNotImplementedError } from "./ProviderNotImplementedError.js";
+export { ProviderNotInstalledError } from "./ProviderNotInstalledError.js";
+export { readerToAsyncIterable } from "./readerToAsyncIterable.js";
+export { StubCommand, StubConnection, StubDatasource, StubReader, StubRepository, StubTransaction, createStubDatasource, } from "./stubs/index.js";
+export { MockCommand, MockConnection, MockDatasource, MockDriver, MockSelectStatement, MockReader, MockRepository, MockTransaction, MockWhere, } from "./mocks/index.js";

package/dist/mappers/ChangeCasingMapper.d.ts

@@ -0,0 +1,9 @@
+import { type Casing } from "../converters/ChangeCasingConverter.js";
+import type { IMapper } from "./IMapper.js";
+export declare class ChangeCasingMapper implements IMapper<string, string> {
+    private readonly forward;
+    private readonly reverse;
+    constructor(from: Casing, to: Casing);
+    map: (value: string) => string;
+    reverseMap: (value: string) => string;
+}

package/dist/mappers/ChangeCasingMapper.js

@@ -0,0 +1,11 @@
+import { ChangeCasingConverter } from "../converters/ChangeCasingConverter.js";
+export class ChangeCasingMapper {
+    forward;
+    reverse;
+    constructor(from, to) {
+        this.forward = new ChangeCasingConverter(to);
+        this.reverse = new ChangeCasingConverter(from);
+    }
+    map = (value) => this.forward.convert(value);
+    reverseMap = (value) => this.reverse.convert(value);
+}

package/dist/mappers/DictionaryMapper.d.ts

@@ -0,0 +1,8 @@
+import type { IMapper } from "./IMapper.js";
+export declare class DictionaryMapper<T extends string | number> implements IMapper<T, T> {
+    private readonly forward;
+    private readonly reverse;
+    constructor(map: readonly (readonly [T, T])[]);
+    map: (value: T) => T;
+    reverseMap: (value: T) => T;
+}

package/dist/mappers/DictionaryMapper.js

@@ -0,0 +1,13 @@
+export class DictionaryMapper {
+    forward = new Map();
+    reverse = new Map();
+    constructor(map) {
+        for (const [from, to] of map) {
+            this.forward.set(from, to);
+            if (!this.reverse.has(to))
+                this.reverse.set(to, from);
+        }
+    }
+    map = (value) => this.forward.get(value) ?? value;
+    reverseMap = (value) => this.reverse.get(value) ?? value;
+}

package/dist/mappers/FlatToNestedMapper.d.ts

@@ -0,0 +1,20 @@
+import type { Cells } from "../converters/Cell.js";
+import type { IFlatToNestedMapper } from "./IFlatToNestedMapper.js";
+import type { TypeMap } from "./TypeMap.js";
+export declare class FlatToNestedMapper<T> implements IFlatToNestedMapper<T> {
+    readonly spec: TypeMap<T>;
+    private readonly scalars;
+    private readonly groups;
+    private readonly parentDest;
+    constructor(spec: TypeMap<T>);
+    map: (rows: Iterable<T | Cells>) => T[];
+    reverseMap: (values: T[]) => Cells[];
+    private _map;
+    private _collapse;
+    private explode;
+    private scalarsOf;
+    private withChild;
+    private mapped;
+    private mark;
+    private merge;
+}

package/dist/mappers/FlatToNestedMapper.js

@@ -0,0 +1,105 @@
+const stringFields = (fields) => Object.fromEntries(Object.entries(fields).filter((entry) => typeof entry[1] === "string"));
+const destOf = (fields, column) => Object.entries(fields).find(([, source]) => source === column)?.[0] ?? column;
+const cellKey = (value) => (value == null ? null : String(value));
+export class FlatToNestedMapper {
+    spec;
+    scalars;
+    groups;
+    parentDest;
+    constructor(spec) {
+        this.spec = spec;
+        this.scalars = {};
+        this.groups = {};
+        for (const [name, value] of Object.entries(spec.fields)) {
+            if (typeof value === "string")
+                this.scalars[name] = value;
+            else {
+                const fields = stringFields(value.fields);
+                this.groups[name] = { key: value.key, fields, destKey: destOf(fields, value.key) };
+            }
+        }
+        this.parentDest = destOf(this.scalars, spec.key);
+    }
+    map = (rows) => this._collapse(rows);
+    reverseMap = (values) => [...values].flatMap((value) => this.explode(value));
+    _map = (row) => {
+        const dest = {};
+        for (const [name, column] of Object.entries(this.scalars))
+            dest[name] = row[column] ?? null;
+        for (const [name, group] of Object.entries(this.groups)) {
+            const key = row[group.key];
+            dest[name] =
+                key == null
+                    ? []
+                    : [
+                        Object.fromEntries(Object.entries(group.fields).map(([field, column]) => [field, row[column] ?? null])),
+                    ];
+        }
+        return dest;
+    };
+    _collapse = (rows) => {
+        const byParent = new Map();
+        const seen = new Set();
+        for (const raw of rows) {
+            const item = this.mapped(raw) ? raw : this._map(raw);
+            const parent = cellKey(item[this.parentDest]);
+            if (parent == null)
+                continue;
+            const existing = byParent.get(parent);
+            if (!existing) {
+                byParent.set(parent, item);
+                this.mark(seen, parent, item);
+                continue;
+            }
+            this.merge(existing, item, parent, seen);
+        }
+        return [...byParent.values()];
+    };
+    explode = (value) => {
+        const record = value;
+        let rows = [this.scalarsOf(record)];
+        for (const [name, group] of Object.entries(this.groups)) {
+            const children = record[name]?.length
+                ? record[name]
+                : [undefined];
+            rows = rows.flatMap((row) => children.map((child) => this.withChild(row, group, child)));
+        }
+        return rows;
+    };
+    scalarsOf = (record) => {
+        const row = {};
+        for (const [name, column] of Object.entries(this.scalars))
+            row[column] = record[name] ?? null;
+        return row;
+    };
+    withChild = (row, group, child) => {
+        const next = { ...row };
+        for (const [field, column] of Object.entries(group.fields))
+            next[column] = child?.[field] ?? null;
+        return next;
+    };
+    mapped = (row) => Object.keys(this.groups).every((name) => Array.isArray(row[name]));
+    mark = (seen, parent, item) => {
+        const record = item;
+        for (const [name, group] of Object.entries(this.groups))
+            for (const child of record[name]) {
+                const key = cellKey(child[group.destKey]);
+                if (key != null)
+                    seen.add(`${parent}:${name}:${key}`);
+            }
+    };
+    merge = (into, from, parent, seen) => {
+        const dest = into;
+        const source = from;
+        for (const [name, group] of Object.entries(this.groups)) {
+            const children = dest[name];
+            for (const child of source[name]) {
+                const key = cellKey(child[group.destKey]);
+                if (key == null || seen.has(`${parent}:${name}:${key}`))
+                    continue;
+                seen.add(`${parent}:${name}:${key}`);
+                children.push(child);
+            }
+        }
+    };
+}

package/dist/mappers/IFlatToNestedMapper.d.ts

@@ -0,0 +1,6 @@
+import type { Cells } from "../converters/Cell.js";
+import type { IMapper } from "./IMapper.js";
+import type { TypeMap } from "./TypeMap.js";
+export interface IFlatToNestedMapper<T> extends IMapper<Iterable<T | Cells>, T[]> {
+    readonly spec: TypeMap<T>;
+}

package/dist/mappers/IFlatToNestedMapper.js

@@ -0,0 +1 @@
+export {};

package/dist/mappers/IMapper.d.ts

@@ -0,0 +1,4 @@
+export interface IMapper<TFrom, TTo> {
+    map(value: TFrom): TTo;
+    reverseMap(value: TTo): TFrom;
+}

package/dist/mappers/IMapper.js

@@ -0,0 +1 @@
+export {};

package/dist/mappers/IdentityMapper.d.ts

@@ -0,0 +1,5 @@
+import type { IMapper } from "./IMapper.js";
+export declare class IdentityMapper<T> implements IMapper<T, T> {
+    map: (value: T) => T;
+    reverseMap: (value: T) => T;
+}

package/dist/mappers/IdentityMapper.js

@@ -0,0 +1,4 @@
+export class IdentityMapper {
+    map = (value) => value;
+    reverseMap = (value) => value;
+}

package/dist/mappers/PluralizerMapper.d.ts

@@ -0,0 +1,6 @@
+import type { IMapper } from "./IMapper.js";
+export declare class PluralizerMapper implements IMapper<string, string> {
+    private readonly pluralizer;
+    map: (value: string) => string;
+    reverseMap: (value: string) => string;
+}

package/dist/mappers/PluralizerMapper.js

@@ -0,0 +1,6 @@
+import { PluralizerConverter } from "../converters/PluralizerConverter.js";
+export class PluralizerMapper {
+    pluralizer = new PluralizerConverter();
+    map = (value) => this.pluralizer.convert(value);
+    reverseMap = (value) => this.pluralizer.reverseConvert(value);
+}

package/dist/mappers/RowTypeMapper.d.ts

@@ -0,0 +1,6 @@
+import type { Cells } from "../converters/Cell.js";
+import type { TypeConverter } from "../converters/TypeConverter.js";
+import { TransformMapper } from "./TransformMapper.js";
+export declare class RowTypeMapper<T> extends TransformMapper<Cells, T> {
+    constructor(converter?: TypeConverter<T, Cells>);
+}

package/dist/mappers/RowTypeMapper.js

@@ -0,0 +1,7 @@
+import { MetaDataRowTypeConverter as RowTypeConverter } from "../converters/MetaDataRowTypeConverter.js";
+import { TransformMapper } from "./TransformMapper.js";
+export class RowTypeMapper extends TransformMapper {
+    constructor(converter = new RowTypeConverter()) {
+        super((row) => converter.convert(row), (item) => converter.reverseConvert(item));
+    }
+}

package/dist/mappers/TransformConverterMapper.d.ts

@@ -0,0 +1,5 @@
+import type { TypeConverter } from "../converters/TypeConverter.js";
+import { TransformMapper } from "./TransformMapper.js";
+export declare class TransformConverterMapper<T> extends TransformMapper<T, T> {
+    constructor(converter: TypeConverter<T, T>, filter?: (value: T) => boolean);
+}

package/dist/mappers/TransformConverterMapper.js

@@ -0,0 +1,6 @@
+import { TransformMapper } from "./TransformMapper.js";
+export class TransformConverterMapper extends TransformMapper {
+    constructor(converter, filter) {
+        super((value) => (filter?.(value) !== false ? converter.convert(value) : value), (value) => (filter?.(value) !== false ? converter.reverseConvert(value) : value));
+    }
+}

package/dist/mappers/TransformMapper.d.ts

@@ -0,0 +1,6 @@
+import type { IMapper } from "./IMapper.js";
+export declare class TransformMapper<TFrom, TTo> implements IMapper<TFrom, TTo> {
+    readonly map: (value: TFrom) => TTo;
+    readonly reverseMap: (value: TTo) => TFrom;
+    constructor(map: (value: TFrom) => TTo, reverseMap: (value: TTo) => TFrom);
+}

package/dist/mappers/TransformMapper.js

@@ -0,0 +1,8 @@
+export class TransformMapper {
+    map;
+    reverseMap;
+    constructor(map, reverseMap) {
+        this.map = map;
+        this.reverseMap = reverseMap;
+    }
+}

package/dist/mappers/TypeMap.d.ts

@@ -0,0 +1,8 @@
+import type { TypeMapGroup } from "./TypeMapGroup.js";
+export type TypeMapFields<T> = {
+    [K in keyof T]?: T[K] extends readonly (infer E)[] ? TypeMapGroup<E> : string;
+};
+export type TypeMap<T> = {
+    key: string;
+    fields: TypeMapFields<T>;
+};

package/dist/mappers/TypeMap.js

@@ -0,0 +1 @@
+export {};

package/dist/mappers/TypeMapGroup.d.ts

@@ -0,0 +1,5 @@
+import type { TypeMapFields } from "./TypeMap.js";
+export type TypeMapGroup<E> = {
+    key: string;
+    fields: TypeMapFields<E>;
+};

package/dist/mappers/TypeMapGroup.js

@@ -0,0 +1 @@
+export {};

package/dist/mocks/index.d.ts

@@ -0,0 +1,9 @@
+export { MockCommand } from "./mock-command.js";
+export { MockConnection } from "./mock-connection.js";
+export { MockDatasource } from "./mock-datasource.js";
+export { MockDriver } from "./mock-driver.js";
+export { MockSelectStatement } from "./mock-select-statement.js";
+export { MockReader } from "./mock-reader.js";
+export { MockRepository } from "./mock-repository.js";
+export { MockTransaction } from "./mock-transaction.js";
+export { MockWhere } from "./mock-where.js";

package/dist/mocks/index.js

@@ -0,0 +1,9 @@
+export { MockCommand } from "./mock-command.js";
+export { MockConnection } from "./mock-connection.js";
+export { MockDatasource } from "./mock-datasource.js";
+export { MockDriver } from "./mock-driver.js";
+export { MockSelectStatement } from "./mock-select-statement.js";
+export { MockReader } from "./mock-reader.js";
+export { MockRepository } from "./mock-repository.js";
+export { MockTransaction } from "./mock-transaction.js";
+export { MockWhere } from "./mock-where.js";

package/dist/mocks/mock-command.d.ts

@@ -0,0 +1,28 @@
+import type { ICommand } from "../ICommand.js";
+import type { IConnection } from "../IConnection.js";
+import type { Cells } from "../converters/Cell.js";
+import type { IReader } from "../IReader.js";
+import type { Response } from "../Response.js";
+import { CommandMiddlewareHost } from "../CommandMiddlewareHost.js";
+import type { Parameter } from "../Parameter.js";
+import type { IStatement } from "../statements/IStatement.js";
+import { Native } from "../statements/Native.js";
+export declare class MockCommand extends CommandMiddlewareHost implements ICommand {
+    readonly connection: IConnection;
+    executeCalls: {
+        text: string;
+        parameters?: Parameter[];
+    }[];
+    executeReaderCalls: {
+        text: string;
+        parameters?: Parameter[];
+    }[];
+    executeError?: unknown;
+    executeReaderError?: unknown;
+    response: Response;
+    reader: IReader<Cells>;
+    constructor(connection: IConnection);
+    executeReaderStatement: (statement: IStatement, parameters?: Parameter[]) => Promise<IReader<Cells>>;
+    executeReaderNative(text: Native, parameters?: Parameter[]): Promise<IReader<Cells>>;
+    executeNative(text: Native, parameters?: Parameter[]): Promise<Response>;
+}

package/dist/mocks/mock-command.js

@@ -0,0 +1,42 @@
+import { CommandMiddlewareHost } from "../CommandMiddlewareHost.js";
+import { DefaultStatementTextRenderer } from "../statements/DefaultStatementTextRenderer.js";
+import { Native } from "../statements/Native.js";
+import { SelectInsertedIdStatement } from "../statements/SelectInsertedIdStatement.js";
+import { MockReader } from "./mock-reader.js";
+export class MockCommand extends CommandMiddlewareHost {
+    connection;
+    executeCalls = [];
+    executeReaderCalls = [];
+    executeError;
+    executeReaderError;
+    response = { result: undefined, rowsAffected: 0 };
+    reader = new MockReader();
+    constructor(connection) {
+        super();
+        this.connection = connection;
+    }
+    executeReaderStatement = (statement, parameters) => this.executeReaderNative(new Native(statement instanceof SelectInsertedIdStatement
+        ? `${statement.table}.${statement.column}`
+        : DefaultStatementTextRenderer.instance.render(statement)), parameters);
+    async executeReaderNative(text, parameters) {
+        return this.run(text.text, parameters, async (query, params) => {
+            this.executeReaderCalls.push({ text: query, parameters: params });
+            if (this.executeReaderError) {
+                throw this.executeReaderError;
+            }
+            const rows = this.reader instanceof MockReader
+                ? this.reader.rows
+                : [];
+            return { value: this.reader, rows };
+        });
+    }
+    async executeNative(text, parameters) {
+        return this.run(text.text, parameters, async (query, params) => {
+            this.executeCalls.push({ text: query, parameters: params });
+            if (this.executeError) {
+                throw this.executeError;
+            }
+            return { value: this.response, rows: [] };
+        });
+    }
+}

package/dist/mocks/mock-connection.d.ts

@@ -0,0 +1,22 @@
+import type { ICommand } from "../ICommand.js";
+import type { IConnection } from "../IConnection.js";
+import type { ITransaction } from "../ITransaction.js";
+import { type IsolationLevel as Isolation } from "../IsolationLevel.js";
+export declare class MockConnection implements IConnection {
+    readonly provider: string;
+    openCalls: number;
+    closeCalls: number;
+    startTransactionCalls: number;
+    openError?: unknown;
+    closeError?: unknown;
+    startTransactionError?: unknown;
+    transaction: ITransaction;
+    command?: ICommand;
+    isOpen: boolean;
+    constructor(transaction?: ITransaction, provider?: string);
+    createCommand: () => ICommand;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    [Symbol.asyncDispose]: () => Promise<void>;
+    startTransaction(isolation?: Isolation): Promise<ITransaction>;
+}