ts-prorm-orm 1.2.3 → 2.1.0

package/dist/graph/types.d.ts

@@ -142,6 +142,17 @@ export interface GraphTraversalSpec {
     targetWhere?: WhereOptions;
     limit?: number;
 }
+/**
+ * Direction of one normalized order term.
+ *
+ * `'RANDOM'` comes from the `random()` order helper (`src/operators.ts`) and
+ * carries no field — the engines that can shuffle express it as a whole term
+ * of their own (Cypher `rand()`, Gremlin `order().by(shuffle)`), and the ones
+ * that cannot raise a {@link GraphCapabilityError}.
+ */
+export type GraphOrderDirection = 'ASC' | 'DESC' | 'RANDOM';
+/** One normalized order term: the property to sort on and its direction. */
+export type GraphOrderTerm = [string, GraphOrderDirection];
 /** Options for a node find/match. */
 export interface NodeMatchSpec {
     label: string;
@@ -150,7 +161,7 @@ export interface NodeMatchSpec {
         include?: string[];
         exclude?: string[];
     };
-    order?: Array<[string, 'ASC' | 'DESC']> | string[];
+    order?: GraphOrderTerm[] | string[];
     limit?: number | string;
     offset?: number | string;
     /** Associations to co-fetch as graph walks. */

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { ConnectionManager, createConnectionManager, NamedConnectionOptions } fr
 export { DataTypes, AbstractDataType } from './models/data-types';
 export { CreationOptional, NonAttribute, ForeignKey, InferAttributes, InferCreationAttributes, PartialBy, RequiredBy, ModelStatic, ModelOptions, } from './models/typescript-types';
 export { Model } from './models';
-export { Table, Attribute, Column, AllowNull, PrimaryKey, AutoIncrement, NotNull, Default, Unique, Comment, getModelMetadata, getAttributeMetadata, getModelAttributes, clearMetadata, HasOneOptions, HasManyOptions, BelongsToOptions, BelongsToManyOptions, HasOne, HasMany, BelongsTo, BelongsToMany, } from './models/decorators';
+export { Table, AbstractModel, isAbstractModel, getInheritedAttributeMetadata, Attribute, Column, AllowNull, PrimaryKey, AutoIncrement, NotNull, Default, Unique, Comment, getModelMetadata, getAttributeMetadata, getModelAttributes, clearMetadata, HasOneOptions, HasManyOptions, BelongsToOptions, BelongsToManyOptions, HasOne, HasMany, BelongsTo, BelongsToMany, } from './models/decorators';
 export * from './compliance';
 export * from './extensions';
 export declare const STRING: ((...args: any[]) => import("./models").STRING) & {
@@ -172,6 +172,8 @@ export { ReplicaManager } from './replica-manager';
 export type { ReplicaStatus, ReplicaConnectionConfig, LagDetectionConfig, ReplicationOptions, RoutingStrategy, } from './replica-manager';
 export { Dialect, BaseDialect, DialectRegistry } from './dialects/dialect';
 export { BaseGraphDialect, Neo4jGraphDialect, GremlinGraphDialect, DgraphGraphDialect, GRAPH_DIALECTS, registerGraphDialects, } from './graph';
+export { GraphCapabilityError, ParamBag, normalizeWhere, deriveAssociationEdge, defaultEdgeLabel, safeIdent, } from './graph';
+export type { GraphConnectionOptions, GraphStatement, GraphPredicate, CanonOp, GraphAssociationType, GraphAssociationSpec, GraphPropertyDefinition, NodeModelDefinition, EdgeModelDefinition, GraphTraversalDirection, GraphTraversalStep, GraphTraversalSpec, NodeMatchSpec, WhereRenderContext, EdgeCreateSpec, NodeConstraintKind, DialectRegistryLike, } from './graph';
 export type { DialectOptions, ColumnDefinition, TableOptions, DropTableOptions, TableDescription, IndexOptions, BuildOptions, InsertOptions, UpdateOptions as DialectUpdateOptions, DeleteOptions, SelectOptions, CTEOption, CreateExtensionOptions, DropExtensionOptions, ExtensionInfo, } from './dialects/dialect';
 export { SQLiteDialect } from './dialects/sqlite';
 export { OracleDialect, createOracleDialect } from './dialects/oracle';
@@ -210,11 +212,18 @@ export { UserManager, PRIVILEGE_LEVELS } from './user-management';
 export type { PrivilegeType, PrivilegeScope, CreateUserOptions, AlterUserOptions, GrantOptions, RevokeOptions, RoleOptions, UserInfo, PrivilegeInfo, } from './user-management';
 export { SQLiteAdvanced, createSQLiteAdvanced } from './sqlite-advanced';
 export type { TriggerTiming, TriggerEvent, FTS5Tokenizer, GeneratedStorageType, ConflictAlgorithm, } from './sqlite-advanced';
-export { SQL, MYSQL, MARIADB, POSTGRES, SQLITE, getConstantsForDialect, IsolationLevelEnum, IsolationLevelValue, } from './sql-constants';
-export type { SQLConstants, MySQLConstants, PostgresConstants, SQLiteConstants, IsolationLevel, ForeignKeyChecks, UniqueKeyChecks, Autocommit, Cache, SqlMode, PragmaSettings, ConstraintDeferral, SearchPath, } from './sql-constants';
+export { SQL, MYSQL, MARIADB, POSTGRES, SQLITE, getConstantsForDialect, getForeignKeyChecksSQL, UnsupportedForeignKeyChecksError, IsolationLevelEnum, IsolationLevelValue, } from './sql-constants';
+export type { ForeignKeyChecksMode, SQLConstants, MySQLConstants, PostgresConstants, SQLiteConstants, IsolationLevel, ForeignKeyChecks, UniqueKeyChecks, Autocommit, Cache, SqlMode, PragmaSettings, ConstraintDeferral, SearchPath, } from './sql-constants';
 export * from './nosql';
 export { count, countDistinct, avg, min, max, stringAgg, arrayAgg, CaseBuilder, SimpleCaseBuilder, caseWhen, caseOf, dateTrunc, dateAdd, dateSub, dateDiff, currentDate, currentTimestamp, fullTextMatch, fullTextRank, jsonExtract, jsonKeys, jsonTypeOf, round, ceil, floor, power, sqrt, abs, sign, mod, greatest, least, concat, upper, lower, length, replace, lpad, rpad, split, WindowFunctionBuilder, rowNumber, rank, denseRank, percentRank, cumeDist, ntile, lag, lead, firstValue, lastValue, nthValue, sumOver, avgOver, countOver, minOver, maxOver, windowFn, NullsOrder, } from './query-builders/functions';
 export { random as sqlRandom, truncate as sqlTruncate, substring as sqlSubstring, trim as sqlTrim, ltrim as sqlLtrim, rtrim as sqlRtrim, jsonContains as sqlJsonContains, jsonHasKey as sqlJsonHasKey, formatDate as sqlFormatDate, now as sqlNow, repeat as sqlRepeat, reverse as sqlReverse, sum as sqlSum, } from './query-builders/functions';
+export { AbstractCacheManager, RedisClusterCache, createRedisClusterCache } from './cache';
+export type { CacheBackend, L2CacheOptions, CacheKeyOptions, CacheStats, CacheBackendFactory, RedisClusterOptions, RedisClusterNodeConfig, } from './cache';
+export type { CacheEntry as CacheManagerEntry, CacheManagerOptions as CacheManagerConfig, L1CacheOptions as CacheManagerL1Options, RedisClusterCacheOptions as RedisClusterCacheConfig, RedisClusterNode as RedisClusterCacheNode, } from './cache';
+export { AuditLogger, setAuditLogger, getAuditLogger, addAuditHistoryToModel, addAuditHistoryToInstance, } from './audit';
+export type { AuditLog, AuditLoggerOptions } from './audit';
+export { convertPrismaSchema, parsePrismaSchema, resolveRelations } from './prisma-migrate';
+export type { ConversionResult, PrismaSchema, PrismaModel, PrismaEnum, PrismaField, PrormRelation, } from './prisma-migrate';
 import { Prorm } from './prorm';
 import { Transaction } from './types';
 declare const ORM: {

package/dist/index.js

@@ -40,13 +40,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VARBINARY = exports.BINARY = exports.BLOB = exports.JSONB = exports.JSON = exports.UUIDV4 = exports.UUID = exports.TIME = exports.NOW = exports.DATEONLY = exports.DATE = exports.BOOLEAN = exports.DECIMAL = exports.DOUBLE = exports.FLOAT = exports.BIGINT = exports.INTEGER = exports.TEXT = exports.CHAR = exports.VARCHAR = exports.STRING = exports.BelongsToMany = exports.BelongsTo = exports.HasMany = exports.HasOne = exports.clearMetadata = exports.getModelAttributes = exports.getAttributeMetadata = exports.getModelMetadata = exports.Comment = exports.Unique = exports.Default = exports.NotNull = exports.AutoIncrement = exports.PrimaryKey = exports.AllowNull = exports.Column = exports.Attribute = exports.Table = exports.Model = exports.AbstractDataType = exports.DataTypes = exports.createConnectionManager = exports.ConnectionManager = exports.StreamIterator = exports.BatchTransform = exports.FilterTransform = exports.MapTransform = exports.QueryTypes = exports.Prorm = void 0;
-exports.ReplicaManager = exports.Transaction = exports.isOrderExpression = exports.random = exports.desc = exports.asc = exports.overlap = exports.contains = exports.isNotNull = exports.isNull = exports.notBetween = exports.between = exports.notIn = exports.inOp = exports.in = exports.notIRegexp = exports.iRegexp = exports.notRegexp = exports.regexp = exports.match = exports.notSubstring = exports.substring = exports.notEndsWith = exports.endsWith = exports.notStartsWith = exports.startsWith = exports.notILike = exports.iLike = exports.notLike = exports.like = exports.lte = exports.lt = exports.gte = exports.gt = exports.ne = exports.eq = exports.not = exports.or = exports.and = exports.where = exports.normalizeOperatorKeys = exports.operatorToWhereKey = exports.getOperatorString = exports.OpAliases = exports.Operators = exports.Op = exports.GEOGRAPHY = exports.GEOMETRY = exports.ARRAY = exports.ENUM = void 0;
-exports.upperCase = exports.spliceStr = exports.formatDefaultValue = exports.toDefaultValue = exports.removeTicks = exports.addTicks = exports.escapeLike = exports.pad = exports.truncate = exports.coalesce = exports.isEmpty = exports.formatWhere = exports.escapeId = exports.escapeString = exports.formatValue = exports.formatValues = exports.isValidUUID = exports.generateShortUUID = exports.generateUUID = exports.omit = exports.pick = exports.merge = exports.cloneDeep = exports.singularize = exports.pluralize = exports.snakeCase = exports.camelize = exports.kebabToCamel = exports.camelToKebab = exports.snakeToCamel = exports.camelToSnake = exports.ModelManager = exports.ScopeManager = exports.createPool = exports.PooledConnection = exports.DatabaseConnectionPool = exports.ConnectionPool = exports.createMSSQLDialect = exports.MSSQLDialect = exports.createOracleDialect = exports.OracleDialect = exports.SQLiteDialect = exports.registerGraphDialects = exports.GRAPH_DIALECTS = exports.DgraphGraphDialect = exports.GremlinGraphDialect = exports.Neo4jGraphDialect = exports.BaseGraphDialect = exports.DialectRegistry = exports.BaseDialect = void 0;
-exports.removeGeneratedModel = exports.listModels = exports.setOutputDir = exports.getOutputDir = exports.configureCLI = exports.generateModels = exports.model = exports.CLI = exports.utils = exports.isEmptyResultError = exports.isConstraintError = exports.isConnectionError = exports.isValidationError = exports.isPrormError = exports.ErrorCodes = exports.EmptyResultError = exports.EagerLoadError = exports.AssociationError = exports.BulkRecordError = exports.ResourceLockedError = exports.TimeoutError = exports.ExclusionConstraintError = exports.ForeignKeyConstraintError = exports.UniqueConstraintError = exports.ValidationError = exports.DatabaseError = exports.ConnectionError = exports.PrormError = exports.setDefaultLogger = exports.getDefaultLogger = exports.createSilentLogger = exports.createLogger = exports.LogLevelStrings = exports.LogLevel = exports.Logger = exports.createQueryInterface = exports.CreateQueryInterface = exports.stringUtils = exports.regex = exports.truncateStr = exports.padEnd = exports.padStart = exports.trimEnd = exports.trimStart = exports.rtrim = exports.ltrim = exports.trim = exports.capitalizeWords = exports.capitalize = exports.lowerCase = void 0;
-exports.fullTextRank = exports.fullTextMatch = exports.currentTimestamp = exports.currentDate = exports.dateDiff = exports.dateSub = exports.dateAdd = exports.dateTrunc = exports.caseOf = exports.caseWhen = exports.SimpleCaseBuilder = exports.CaseBuilder = exports.arrayAgg = exports.stringAgg = exports.max = exports.min = exports.avg = exports.countDistinct = exports.count = exports.IsolationLevelEnum = exports.getConstantsForDialect = exports.SQLITE = exports.POSTGRES = exports.MARIADB = exports.MYSQL = exports.SQL = exports.createSQLiteAdvanced = exports.SQLiteAdvanced = exports.PRIVILEGE_LEVELS = exports.UserManager = exports.DatabaseSecurityDecorator = exports.Database = exports.buildCreateFullTextIndexSQL = exports.buildDropPolicySQL = exports.buildCreatePolicySQL = exports.buildEnableRowLevelSecuritySQL = exports.buildDropTriggerSQL = exports.buildCreateTriggerStatements = exports.buildDropSequenceSQL = exports.buildCreateSequenceSQL = exports.UnsupportedSchemaObjectError = exports.buildOptionsClause = exports.KNOWN_FDWS = exports.ForeignDataManager = exports.generateERDiagramFromFile = exports.generateModelDiagramFromFile = exports.generateERDiagram = exports.generateModelDiagram = exports.ERDiagram = exports.ModelDiagram = void 0;
-exports.sqlNow = exports.sqlFormatDate = exports.sqlJsonHasKey = exports.sqlJsonContains = exports.sqlRtrim = exports.sqlLtrim = exports.sqlTrim = exports.sqlSubstring = exports.sqlTruncate = exports.sqlRandom = exports.NullsOrder = exports.windowFn = exports.maxOver = exports.minOver = exports.countOver = exports.avgOver = exports.sumOver = exports.nthValue = exports.lastValue = exports.firstValue = exports.lead = exports.lag = exports.ntile = exports.cumeDist = exports.percentRank = exports.denseRank = exports.rank = exports.rowNumber = exports.WindowFunctionBuilder = exports.split = exports.rpad = exports.lpad = exports.replace = exports.length = exports.lower = exports.upper = exports.concat = exports.least = exports.greatest = exports.mod = exports.sign = exports.abs = exports.sqrt = exports.power = exports.floor = exports.ceil = exports.round = exports.jsonTypeOf = exports.jsonKeys = exports.jsonExtract = void 0;
-exports.sqlSum = exports.sqlReverse = exports.sqlRepeat = void 0;
+exports.JSONB = exports.JSON = exports.UUIDV4 = exports.UUID = exports.TIME = exports.NOW = exports.DATEONLY = exports.DATE = exports.BOOLEAN = exports.DECIMAL = exports.DOUBLE = exports.FLOAT = exports.BIGINT = exports.INTEGER = exports.TEXT = exports.CHAR = exports.VARCHAR = exports.STRING = exports.BelongsToMany = exports.BelongsTo = exports.HasMany = exports.HasOne = exports.clearMetadata = exports.getModelAttributes = exports.getAttributeMetadata = exports.getModelMetadata = exports.Comment = exports.Unique = exports.Default = exports.NotNull = exports.AutoIncrement = exports.PrimaryKey = exports.AllowNull = exports.Column = exports.Attribute = exports.getInheritedAttributeMetadata = exports.isAbstractModel = exports.AbstractModel = exports.Table = exports.Model = exports.AbstractDataType = exports.DataTypes = exports.createConnectionManager = exports.ConnectionManager = exports.StreamIterator = exports.BatchTransform = exports.FilterTransform = exports.MapTransform = exports.QueryTypes = exports.Prorm = void 0;
+exports.random = exports.desc = exports.asc = exports.overlap = exports.contains = exports.isNotNull = exports.isNull = exports.notBetween = exports.between = exports.notIn = exports.inOp = exports.in = exports.notIRegexp = exports.iRegexp = exports.notRegexp = exports.regexp = exports.match = exports.notSubstring = exports.substring = exports.notEndsWith = exports.endsWith = exports.notStartsWith = exports.startsWith = exports.notILike = exports.iLike = exports.notLike = exports.like = exports.lte = exports.lt = exports.gte = exports.gt = exports.ne = exports.eq = exports.not = exports.or = exports.and = exports.where = exports.normalizeOperatorKeys = exports.operatorToWhereKey = exports.getOperatorString = exports.OpAliases = exports.Operators = exports.Op = exports.GEOGRAPHY = exports.GEOMETRY = exports.ARRAY = exports.ENUM = exports.VARBINARY = exports.BINARY = exports.BLOB = void 0;
+exports.coalesce = exports.isEmpty = exports.formatWhere = exports.escapeId = exports.escapeString = exports.formatValue = exports.formatValues = exports.isValidUUID = exports.generateShortUUID = exports.generateUUID = exports.omit = exports.pick = exports.merge = exports.cloneDeep = exports.singularize = exports.pluralize = exports.snakeCase = exports.camelize = exports.kebabToCamel = exports.camelToKebab = exports.snakeToCamel = exports.camelToSnake = exports.ModelManager = exports.ScopeManager = exports.createPool = exports.PooledConnection = exports.DatabaseConnectionPool = exports.ConnectionPool = exports.createMSSQLDialect = exports.MSSQLDialect = exports.createOracleDialect = exports.OracleDialect = exports.SQLiteDialect = exports.safeIdent = exports.defaultEdgeLabel = exports.deriveAssociationEdge = exports.normalizeWhere = exports.ParamBag = exports.GraphCapabilityError = exports.registerGraphDialects = exports.GRAPH_DIALECTS = exports.DgraphGraphDialect = exports.GremlinGraphDialect = exports.Neo4jGraphDialect = exports.BaseGraphDialect = exports.DialectRegistry = exports.BaseDialect = exports.ReplicaManager = exports.Transaction = exports.isOrderExpression = void 0;
+exports.isEmptyResultError = exports.isConstraintError = exports.isConnectionError = exports.isValidationError = exports.isPrormError = exports.ErrorCodes = exports.EmptyResultError = exports.EagerLoadError = exports.AssociationError = exports.BulkRecordError = exports.ResourceLockedError = exports.TimeoutError = exports.ExclusionConstraintError = exports.ForeignKeyConstraintError = exports.UniqueConstraintError = exports.ValidationError = exports.DatabaseError = exports.ConnectionError = exports.PrormError = exports.setDefaultLogger = exports.getDefaultLogger = exports.createSilentLogger = exports.createLogger = exports.LogLevelStrings = exports.LogLevel = exports.Logger = exports.createQueryInterface = exports.CreateQueryInterface = exports.stringUtils = exports.regex = exports.truncateStr = exports.padEnd = exports.padStart = exports.trimEnd = exports.trimStart = exports.rtrim = exports.ltrim = exports.trim = exports.capitalizeWords = exports.capitalize = exports.lowerCase = exports.upperCase = exports.spliceStr = exports.formatDefaultValue = exports.toDefaultValue = exports.removeTicks = exports.addTicks = exports.escapeLike = exports.pad = exports.truncate = void 0;
+exports.CaseBuilder = exports.arrayAgg = exports.stringAgg = exports.max = exports.min = exports.avg = exports.countDistinct = exports.count = exports.IsolationLevelEnum = exports.UnsupportedForeignKeyChecksError = exports.getForeignKeyChecksSQL = exports.getConstantsForDialect = exports.SQLITE = exports.POSTGRES = exports.MARIADB = exports.MYSQL = exports.SQL = exports.createSQLiteAdvanced = exports.SQLiteAdvanced = exports.PRIVILEGE_LEVELS = exports.UserManager = exports.DatabaseSecurityDecorator = exports.Database = exports.buildCreateFullTextIndexSQL = exports.buildDropPolicySQL = exports.buildCreatePolicySQL = exports.buildEnableRowLevelSecuritySQL = exports.buildDropTriggerSQL = exports.buildCreateTriggerStatements = exports.buildDropSequenceSQL = exports.buildCreateSequenceSQL = exports.UnsupportedSchemaObjectError = exports.buildOptionsClause = exports.KNOWN_FDWS = exports.ForeignDataManager = exports.generateERDiagramFromFile = exports.generateModelDiagramFromFile = exports.generateERDiagram = exports.generateModelDiagram = exports.ERDiagram = exports.ModelDiagram = exports.removeGeneratedModel = exports.listModels = exports.setOutputDir = exports.getOutputDir = exports.configureCLI = exports.generateModels = exports.model = exports.CLI = exports.utils = void 0;
+exports.windowFn = exports.maxOver = exports.minOver = exports.countOver = exports.avgOver = exports.sumOver = exports.nthValue = exports.lastValue = exports.firstValue = exports.lead = exports.lag = exports.ntile = exports.cumeDist = exports.percentRank = exports.denseRank = exports.rank = exports.rowNumber = exports.WindowFunctionBuilder = exports.split = exports.rpad = exports.lpad = exports.replace = exports.length = exports.lower = exports.upper = exports.concat = exports.least = exports.greatest = exports.mod = exports.sign = exports.abs = exports.sqrt = exports.power = exports.floor = exports.ceil = exports.round = exports.jsonTypeOf = exports.jsonKeys = exports.jsonExtract = exports.fullTextRank = exports.fullTextMatch = exports.currentTimestamp = exports.currentDate = exports.dateDiff = exports.dateSub = exports.dateAdd = exports.dateTrunc = exports.caseOf = exports.caseWhen = exports.SimpleCaseBuilder = void 0;
+exports.resolveRelations = exports.parsePrismaSchema = exports.convertPrismaSchema = exports.addAuditHistoryToInstance = exports.addAuditHistoryToModel = exports.getAuditLogger = exports.setAuditLogger = exports.AuditLogger = exports.createRedisClusterCache = exports.RedisClusterCache = exports.AbstractCacheManager = exports.sqlSum = exports.sqlReverse = exports.sqlRepeat = exports.sqlNow = exports.sqlFormatDate = exports.sqlJsonHasKey = exports.sqlJsonContains = exports.sqlRtrim = exports.sqlLtrim = exports.sqlTrim = exports.sqlSubstring = exports.sqlTruncate = exports.sqlRandom = exports.NullsOrder = void 0;
 // Re-export Prorm class and query types
 var prorm_1 = require("./prorm");
 Object.defineProperty(exports, "Prorm", { enumerable: true, get: function () { return prorm_1.Prorm; } });
@@ -73,6 +73,9 @@ Object.defineProperty(exports, "Model", { enumerable: true, get: function () { r
 // Export decorators
 var decorators_1 = require("./models/decorators");
 Object.defineProperty(exports, "Table", { enumerable: true, get: function () { return decorators_1.Table; } });
+Object.defineProperty(exports, "AbstractModel", { enumerable: true, get: function () { return decorators_1.AbstractModel; } });
+Object.defineProperty(exports, "isAbstractModel", { enumerable: true, get: function () { return decorators_1.isAbstractModel; } });
+Object.defineProperty(exports, "getInheritedAttributeMetadata", { enumerable: true, get: function () { return decorators_1.getInheritedAttributeMetadata; } });
 Object.defineProperty(exports, "Attribute", { enumerable: true, get: function () { return decorators_1.Attribute; } });
 Object.defineProperty(exports, "Column", { enumerable: true, get: function () { return decorators_1.Column; } });
 Object.defineProperty(exports, "AllowNull", { enumerable: true, get: function () { return decorators_1.AllowNull; } });
@@ -212,6 +215,16 @@ Object.defineProperty(exports, "registerGraphDialects", { enumerable: true, get:
 const dialect_2 = require("./dialects/dialect");
 const graph_2 = require("./graph");
 (0, graph_2.registerGraphDialects)(dialect_2.DialectRegistry);
+// The rest of './graph': the typed error thrown for relational-only features
+// on a graph backend, plus the where/edge helpers a custom graph dialect needs.
+// None of these names collide with the SQL-side exports above.
+var graph_3 = require("./graph");
+Object.defineProperty(exports, "GraphCapabilityError", { enumerable: true, get: function () { return graph_3.GraphCapabilityError; } });
+Object.defineProperty(exports, "ParamBag", { enumerable: true, get: function () { return graph_3.ParamBag; } });
+Object.defineProperty(exports, "normalizeWhere", { enumerable: true, get: function () { return graph_3.normalizeWhere; } });
+Object.defineProperty(exports, "deriveAssociationEdge", { enumerable: true, get: function () { return graph_3.deriveAssociationEdge; } });
+Object.defineProperty(exports, "defaultEdgeLabel", { enumerable: true, get: function () { return graph_3.defaultEdgeLabel; } });
+Object.defineProperty(exports, "safeIdent", { enumerable: true, get: function () { return graph_3.safeIdent; } });
 // Re-export SQLite dialect
 var sqlite_1 = require("./dialects/sqlite");
 Object.defineProperty(exports, "SQLiteDialect", { enumerable: true, get: function () { return sqlite_1.SQLiteDialect; } });
@@ -394,6 +407,8 @@ Object.defineProperty(exports, "MARIADB", { enumerable: true, get: function () {
 Object.defineProperty(exports, "POSTGRES", { enumerable: true, get: function () { return sql_constants_1.POSTGRES; } });
 Object.defineProperty(exports, "SQLITE", { enumerable: true, get: function () { return sql_constants_1.SQLITE; } });
 Object.defineProperty(exports, "getConstantsForDialect", { enumerable: true, get: function () { return sql_constants_1.getConstantsForDialect; } });
+Object.defineProperty(exports, "getForeignKeyChecksSQL", { enumerable: true, get: function () { return sql_constants_1.getForeignKeyChecksSQL; } });
+Object.defineProperty(exports, "UnsupportedForeignKeyChecksError", { enumerable: true, get: function () { return sql_constants_1.UnsupportedForeignKeyChecksError; } });
 Object.defineProperty(exports, "IsolationLevelEnum", { enumerable: true, get: function () { return sql_constants_1.IsolationLevelEnum; } });
 // Re-export NoSQL stores (MongoDB, Redis, DynamoDB) — separate from the SQL
 // dialects since they don't share the SQL-shaped Dialect interface
@@ -482,6 +497,37 @@ Object.defineProperty(exports, "sqlNow", { enumerable: true, get: function () {
 Object.defineProperty(exports, "sqlRepeat", { enumerable: true, get: function () { return functions_2.repeat; } });
 Object.defineProperty(exports, "sqlReverse", { enumerable: true, get: function () { return functions_2.reverse; } });
 Object.defineProperty(exports, "sqlSum", { enumerable: true, get: function () { return functions_2.sum; } });
+// Re-export the query-result cache (L1 in-memory + L2 Redis Cluster).
+// Five of this module's type names are already taken at the package root by
+// unrelated declarations that consumers may import today, so those five keep
+// their existing meaning and the cache module's versions are aliased:
+//   CacheEntry              -> ./query-optimizers' prepared-statement entry
+//   CacheManagerOptions,    -> ./types' (older, flatter) cache option shapes
+//   L1CacheOptions,
+//   RedisClusterCacheOptions,
+//   RedisClusterNode
+// The remaining names don't collide and are exported unchanged.
+var cache_1 = require("./cache");
+Object.defineProperty(exports, "AbstractCacheManager", { enumerable: true, get: function () { return cache_1.AbstractCacheManager; } });
+Object.defineProperty(exports, "RedisClusterCache", { enumerable: true, get: function () { return cache_1.RedisClusterCache; } });
+Object.defineProperty(exports, "createRedisClusterCache", { enumerable: true, get: function () { return cache_1.createRedisClusterCache; } });
+// Re-export the audit log (persists model changes to a database table).
+// Note the neighbours: `Audit`/`getAuditLog`/`AuditEntry` (the in-memory
+// decorator, from './decorators') and `ComplianceAuditTrail` (from
+// './compliance') are different features that happen to share the prefix.
+// No name here collides with either, so all are exported as-is.
+var audit_1 = require("./audit");
+Object.defineProperty(exports, "AuditLogger", { enumerable: true, get: function () { return audit_1.AuditLogger; } });
+Object.defineProperty(exports, "setAuditLogger", { enumerable: true, get: function () { return audit_1.setAuditLogger; } });
+Object.defineProperty(exports, "getAuditLogger", { enumerable: true, get: function () { return audit_1.getAuditLogger; } });
+Object.defineProperty(exports, "addAuditHistoryToModel", { enumerable: true, get: function () { return audit_1.addAuditHistoryToModel; } });
+Object.defineProperty(exports, "addAuditHistoryToInstance", { enumerable: true, get: function () { return audit_1.addAuditHistoryToInstance; } });
+// Re-export the Prisma schema converter (pure functions; the CLI's
+// `prisma:import` command owns the filesystem side).
+var prisma_migrate_1 = require("./prisma-migrate");
+Object.defineProperty(exports, "convertPrismaSchema", { enumerable: true, get: function () { return prisma_migrate_1.convertPrismaSchema; } });
+Object.defineProperty(exports, "parsePrismaSchema", { enumerable: true, get: function () { return prisma_migrate_1.parsePrismaSchema; } });
+Object.defineProperty(exports, "resolveRelations", { enumerable: true, get: function () { return prisma_migrate_1.resolveRelations; } });
 // Export default ORM configuration
 const prorm_2 = require("./prorm");
 const data_types_3 = require("./models/data-types");

package/dist/logging/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Logging.
+ *
+ * - `logger`        the general-purpose levelled Logger (debug/info/warn/error)
+ * - `query-logging` query logging in the shape of Sequelize's `logging` option
+ */
+export { LogLevel, LogLevelStrings, Logger, createLogger, createSilentLogger, getDefaultLogger, setDefaultLogger, resetDefaultLogger, } from './logger';
+export type { LoggerOptions, LogEntry, LoggerEvents } from './logger';
+export { logQuery, resolveQueryLogger, formatQueryLog, defaultQueryLogger, } from './query-logging';
+export type { LoggingOption, QueryLogFunction, QueryLogContext, QueryLogOptions, } from './query-logging';

package/dist/logging/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Logging.
+ *
+ * - `logger`        the general-purpose levelled Logger (debug/info/warn/error)
+ * - `query-logging` query logging in the shape of Sequelize's `logging` option
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultQueryLogger = exports.formatQueryLog = exports.resolveQueryLogger = exports.logQuery = exports.resetDefaultLogger = exports.setDefaultLogger = exports.getDefaultLogger = exports.createSilentLogger = exports.createLogger = exports.Logger = exports.LogLevelStrings = exports.LogLevel = void 0;
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_1.LogLevel; } });
+Object.defineProperty(exports, "LogLevelStrings", { enumerable: true, get: function () { return logger_1.LogLevelStrings; } });
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
+Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_1.createLogger; } });
+Object.defineProperty(exports, "createSilentLogger", { enumerable: true, get: function () { return logger_1.createSilentLogger; } });
+Object.defineProperty(exports, "getDefaultLogger", { enumerable: true, get: function () { return logger_1.getDefaultLogger; } });
+Object.defineProperty(exports, "setDefaultLogger", { enumerable: true, get: function () { return logger_1.setDefaultLogger; } });
+Object.defineProperty(exports, "resetDefaultLogger", { enumerable: true, get: function () { return logger_1.resetDefaultLogger; } });
+var query_logging_1 = require("./query-logging");
+Object.defineProperty(exports, "logQuery", { enumerable: true, get: function () { return query_logging_1.logQuery; } });
+Object.defineProperty(exports, "resolveQueryLogger", { enumerable: true, get: function () { return query_logging_1.resolveQueryLogger; } });
+Object.defineProperty(exports, "formatQueryLog", { enumerable: true, get: function () { return query_logging_1.formatQueryLog; } });
+Object.defineProperty(exports, "defaultQueryLogger", { enumerable: true, get: function () { return query_logging_1.defaultQueryLogger; } });

package/dist/logging/query-logging.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Query logging, following the Sequelize logger's shape.
+ *
+ * Sequelize's contract is small and widely known, so this matches it rather
+ * than inventing another:
+ *
+ *   logging: false                  no output
+ *   logging: true                   console.log
+ *   logging: console.log            any function, called as (sql, timing)
+ *   benchmark: true                 append the elapsed time
+ *   logQueryParameters: true        append the bound values
+ *
+ * A per-query `logging` overrides the instance-level one, so a single noisy
+ * call can be traced without turning logging on globally - and, symmetrically,
+ * one call can be silenced with `logging: false`.
+ *
+ * This module exists because the resolution logic was previously inlined at
+ * four call sites and only some of them ran it: `count`, `bulkCreate`,
+ * `increment` and the aggregates emitted nothing at all, so turning logging on
+ * showed an incomplete picture of what the ORM was doing.
+ */
+/** What `logging` accepts, at instance or query level. */
+export type LoggingOption = boolean | QueryLogFunction | undefined;
+/**
+ * A logging callback.
+ *
+ * `timing` is the elapsed milliseconds; it is passed whenever the caller
+ * measured the query, which is always here. Sequelize only guarantees it under
+ * `benchmark: true`, so treat it as optional for compatibility.
+ */
+export type QueryLogFunction = (sql: string, timing?: number) => void;
+/** Everything that shapes one log line. */
+export interface QueryLogContext {
+    /** The SQL that was executed. */
+    sql: string;
+    /** Elapsed milliseconds. */
+    duration: number;
+    /** Values bound to the statement, when known. */
+    parameters?: unknown[];
+    /** The model this query was issued for, when applicable. */
+    model?: string;
+    /** The kind of statement, e.g. SELECT or INSERT. */
+    type?: string;
+}
+/** Options controlling how a query is logged. */
+export interface QueryLogOptions {
+    /** Instance-level `logging`. */
+    instanceLogging?: LoggingOption;
+    /** Per-query `logging`, which wins when present. */
+    queryLogging?: LoggingOption;
+    /** Append `Elapsed time: Nms`. */
+    benchmark?: boolean;
+    /** Append the bound parameters. */
+    logQueryParameters?: boolean;
+}
+/**
+ * Resolve the effective logging function for one query.
+ *
+ * Returns null when logging is off. Precedence is query-level, then
+ * instance-level; `false` at either level wins over a function at the other,
+ * because silencing is the more specific intent.
+ */
+export declare function resolveQueryLogger(options: QueryLogOptions): QueryLogFunction | null;
+/** The built-in logger used for `logging: true`. */
+export declare const defaultQueryLogger: QueryLogFunction;
+/**
+ * Render one log line.
+ *
+ * Mirrors Sequelize's `Executed (default): <sql>` prefix so existing log
+ * parsers and eyeballs both keep working.
+ */
+export declare function formatQueryLog(context: QueryLogContext, options?: QueryLogOptions): string;
+/**
+ * Log one query, if logging is enabled for it.
+ *
+ * A user-supplied function receives the raw SQL and the timing, exactly as
+ * Sequelize does, so callbacks written against that API work unchanged. The
+ * built-in logger gets the formatted line instead.
+ *
+ * @returns whether anything was logged
+ */
+export declare function logQuery(context: QueryLogContext, options?: QueryLogOptions): boolean;

package/dist/logging/query-logging.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Query logging, following the Sequelize logger's shape.
+ *
+ * Sequelize's contract is small and widely known, so this matches it rather
+ * than inventing another:
+ *
+ *   logging: false                  no output
+ *   logging: true                   console.log
+ *   logging: console.log            any function, called as (sql, timing)
+ *   benchmark: true                 append the elapsed time
+ *   logQueryParameters: true        append the bound values
+ *
+ * A per-query `logging` overrides the instance-level one, so a single noisy
+ * call can be traced without turning logging on globally - and, symmetrically,
+ * one call can be silenced with `logging: false`.
+ *
+ * This module exists because the resolution logic was previously inlined at
+ * four call sites and only some of them ran it: `count`, `bulkCreate`,
+ * `increment` and the aggregates emitted nothing at all, so turning logging on
+ * showed an incomplete picture of what the ORM was doing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultQueryLogger = void 0;
+exports.resolveQueryLogger = resolveQueryLogger;
+exports.formatQueryLog = formatQueryLog;
+exports.logQuery = logQuery;
+/**
+ * Resolve the effective logging function for one query.
+ *
+ * Returns null when logging is off. Precedence is query-level, then
+ * instance-level; `false` at either level wins over a function at the other,
+ * because silencing is the more specific intent.
+ */
+function resolveQueryLogger(options) {
+    const { queryLogging, instanceLogging } = options;
+    // An explicit per-query setting decides on its own.
+    if (queryLogging === false)
+        return null;
+    if (typeof queryLogging === 'function')
+        return queryLogging;
+    if (queryLogging === true)
+        return exports.defaultQueryLogger;
+    if (instanceLogging === false)
+        return null;
+    if (typeof instanceLogging === 'function')
+        return instanceLogging;
+    if (instanceLogging === true)
+        return exports.defaultQueryLogger;
+    // Unset at both levels: quiet, matching Sequelize's `logging: false` default
+    // in recent versions, unless benchmarking was explicitly asked for.
+    return options.benchmark ? exports.defaultQueryLogger : null;
+}
+/** The built-in logger used for `logging: true`. */
+const defaultQueryLogger = (sql, timing) => {
+    // eslint-disable-next-line no-console
+    console.log(timing === undefined ? sql : `${sql} Elapsed time: ${timing}ms`);
+};
+exports.defaultQueryLogger = defaultQueryLogger;
+/**
+ * Render one log line.
+ *
+ * Mirrors Sequelize's `Executed (default): <sql>` prefix so existing log
+ * parsers and eyeballs both keep working.
+ */
+function formatQueryLog(context, options = {}) {
+    const label = context.model ? `Executed (${context.model})` : 'Executed (default)';
+    let line = `${label}: ${context.sql}`;
+    if (options.logQueryParameters && context.parameters?.length) {
+        line += `; ${JSON.stringify(context.parameters)}`;
+    }
+    if (options.benchmark) {
+        line += ` Elapsed time: ${context.duration}ms`;
+    }
+    return line;
+}
+/**
+ * Log one query, if logging is enabled for it.
+ *
+ * A user-supplied function receives the raw SQL and the timing, exactly as
+ * Sequelize does, so callbacks written against that API work unchanged. The
+ * built-in logger gets the formatted line instead.
+ *
+ * @returns whether anything was logged
+ */
+function logQuery(context, options = {}) {
+    const logger = resolveQueryLogger(options);
+    if (!logger)
+        return false;
+    if (logger === exports.defaultQueryLogger) {
+        // eslint-disable-next-line no-console
+        console.log(formatQueryLog(context, options));
+    }
+    else {
+        // Custom loggers get the SQL unadorned; decorating it would break anyone
+        // parsing it or forwarding it to a structured log.
+        logger(options.logQueryParameters && context.parameters?.length
+            ? `${context.sql}; ${JSON.stringify(context.parameters)}`
+            : context.sql, context.duration);
+    }
+    return true;
+}

package/dist/models/associations.d.ts

@@ -18,6 +18,10 @@ declare abstract class BaseAssociation {
      */
     getAssociationConfig(): AssociationConfig;
 }
+/**
+ * The resolved shape of a declared association: the two models, the foreign
+ * key, the alias, and any join table.
+ */
 export interface AssociationConfig {
     model: ModelStatic<any>;
     as: string;
@@ -28,6 +32,9 @@ export interface AssociationConfig {
     onDelete?: string;
     onUpdate?: string;
 }
+/**
+ * An eager-load nested inside another, for traversing more than one hop.
+ */
 export interface NestedIncludeOptions extends IncludeOptions {
     /**
      * Nested includes - support for multi-level eager loading
@@ -59,6 +66,10 @@ export declare class HasOneAssociation extends BaseAssociation {
      */
     getConstraintSql(tableName: string): string;
 }
+/**
+ * A one-to-many relationship. The foreign key lives on the **target**, so the
+ * child rows are what get written when the association changes.
+ */
 export declare class HasManyAssociation extends BaseAssociation {
     constructor(source: ModelStatic<any>, target: ModelStatic<any>, options?: AssociationOptions);
     inferForeignKey(): string;
@@ -68,6 +79,10 @@ export declare class HasManyAssociation extends BaseAssociation {
      */
     getConstraintSql(tableName: string): string;
 }
+/**
+ * A many-to-one relationship. The foreign key lives on the **source**, so the
+ * row you called it on is what gets written.
+ */
 export declare class BelongsToAssociation extends BaseAssociation {
     constructor(source: ModelStatic<any>, target: ModelStatic<any>, options?: AssociationOptions);
     inferForeignKey(): string;
@@ -81,6 +96,10 @@ export declare class BelongsToAssociation extends BaseAssociation {
      */
     getForeignKeyOptions(): AssociationForeignKeyOptions | undefined;
 }
+/**
+ * A many-to-many relationship through a join table. Neither side holds a
+ * foreign key; the join table holds both.
+ */
 export declare class BelongsToManyAssociation extends BaseAssociation {
     private through;
     private throughModel;
@@ -93,18 +112,37 @@ export declare class BelongsToManyAssociation extends BaseAssociation {
     setThroughModel(model: ModelStatic<any>): void;
     getThroughModel(): ModelStatic<any> | null;
 }
+/**
+ * The instance methods a `hasOne` adds — get, set and create the related row.
+ */
 export interface HasOneMixin {
     (target: ModelStatic<any>, options?: AssociationOptions): HasOneAssociation;
 }
+/**
+ * The instance methods a `hasMany` adds — get, set, add, remove, count and
+ * create related rows.
+ */
 export interface HasManyMixin {
     (target: ModelStatic<any>, options?: AssociationOptions): HasManyAssociation;
 }
+/**
+ * The instance methods a `belongsTo` adds — get, set, unset and create the
+ * parent row.
+ */
 export interface BelongsToMixin {
     (target: ModelStatic<any>, options?: AssociationOptions): BelongsToAssociation;
 }
+/**
+ * The instance methods a `belongsToMany` adds, including the join-table
+ * operations for adding and removing links.
+ */
 export interface BelongsToManyMixin {
     (target: ModelStatic<any>, options?: AssociationOptions): BelongsToManyAssociation;
 }
+/**
+ * Attaches the association helper methods to a model, named after the alias
+ * so `User.hasMany(Post)` yields `getPosts`, `addPost` and the rest.
+ */
 export declare function createAssociationMixins(source: ModelStatic<any>, sourceModelName: string, instancePrototype?: any): {
     hasOne: HasOneMixin;
     hasMany: HasManyMixin;

package/dist/models/associations.js

@@ -130,6 +130,10 @@ class HasOneAssociation extends BaseAssociation {
 }
 exports.HasOneAssociation = HasOneAssociation;
 // HasMany Association - one-to-many where source has many targets
+/**
+ * A one-to-many relationship. The foreign key lives on the **target**, so the
+ * child rows are what get written when the association changes.
+ */
 class HasManyAssociation extends BaseAssociation {
     constructor(source, target, options = {}) {
         super(source, target, options);
@@ -163,6 +167,10 @@ class HasManyAssociation extends BaseAssociation {
 }
 exports.HasManyAssociation = HasManyAssociation;
 // BelongsTo Association - one-to-one where source belongs to target
+/**
+ * A many-to-one relationship. The foreign key lives on the **source**, so the
+ * row you called it on is what gets written.
+ */
 class BelongsToAssociation extends BaseAssociation {
     constructor(source, target, options = {}) {
         super(source, target, options);
@@ -203,6 +211,10 @@ class BelongsToAssociation extends BaseAssociation {
 }
 exports.BelongsToAssociation = BelongsToAssociation;
 // BelongsToMany Association - many-to-many through a junction table
+/**
+ * A many-to-many relationship through a join table. Neither side holds a
+ * foreign key; the join table holds both.
+ */
 class BelongsToManyAssociation extends BaseAssociation {
     constructor(source, target, options = {}) {
         super(source, target, options);
@@ -278,6 +290,10 @@ class BelongsToManyAssociation extends BaseAssociation {
 }
 exports.BelongsToManyAssociation = BelongsToManyAssociation;
 // Factory function to create association mixin methods
+/**
+ * Attaches the association helper methods to a model, named after the alias
+ * so `User.hasMany(Post)` yields `getPosts`, `addPost` and the rest.
+ */
 function createAssociationMixins(source, sourceModelName, instancePrototype) {
     // Use provided instance prototype, or fall back to source.prototype, or source itself
     const prototypeTarget = instancePrototype || source.prototype || source;