ts-prorm-orm 1.2.2 → 2.0.0

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.BaseDialect = 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.operatorToWhereKey = exports.getOperatorString = exports.OpAliases = exports.Operators = exports.Op = exports.GEOGRAPHY = exports.GEOMETRY = exports.ARRAY = exports.ENUM = void 0;
-exports.lowerCase = 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 = void 0;
-exports.ModelDiagram = 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 = void 0;
-exports.jsonExtract = 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 = void 0;
-exports.sqlRepeat = 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 = void 0;
-exports.sqlSum = exports.sqlReverse = 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; } });
@@ -137,6 +140,7 @@ Object.defineProperty(exports, "Operators", { enumerable: true, get: function ()
 Object.defineProperty(exports, "OpAliases", { enumerable: true, get: function () { return operators_2.Operators; } });
 Object.defineProperty(exports, "getOperatorString", { enumerable: true, get: function () { return operators_2.getOperatorString; } });
 Object.defineProperty(exports, "operatorToWhereKey", { enumerable: true, get: function () { return operators_2.operatorToWhereKey; } });
+Object.defineProperty(exports, "normalizeOperatorKeys", { enumerable: true, get: function () { return operators_2.normalizeOperatorKeys; } });
 // Core where helpers
 Object.defineProperty(exports, "where", { enumerable: true, get: function () { return operators_2.where; } });
 Object.defineProperty(exports, "and", { enumerable: true, get: function () { return operators_2.and; } });
@@ -211,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; } });
@@ -393,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
@@ -481,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/decorators.d.ts

@@ -106,11 +106,47 @@ interface AttributeMetadata {
     validate?: Record<string, any>;
 }
 /**
- * Define model options (use on model class)
+ * Mark a class as an abstract base model.
  *
- * @example
- * @Table({ tableName: 'users', timestamps: true })
+ * An abstract model gets no table of its own. Its columns, and any
+ * `@PrimaryKey` / `@Default` / validation applied to them, are inherited by the
+ * concrete models that extend it, so shared fields are declared once:
+ *
+ * ```typescript
+ * // This is the base model, which defines the common fields between all comments.
+ * @AbstractModel()
+ * class BaseComment {
+ *   @Column(DataTypes.INTEGER())
+ *   @PrimaryKey()
+ *   @AutoIncrement()
+ *   declare id: number;
+ *
+ *   @Column(DataTypes.TEXT())
+ *   declare body: string;
+ * }
+ *
+ * @Table({ tableName: 'post_comments' })
+ * class PostComment extends BaseComment {
+ *   @Column(DataTypes.INTEGER())
+ *   declare postId: number;
+ * }
+ * ```
+ *
+ * `PostComment` is created with id, body and postId. Passing the abstract class
+ * itself to `addModel()` is an error - there is no table to address.
+ */
+export declare function AbstractModel(options?: TableOptions): ClassDecorator;
+/** True when the class (by name) was declared `@AbstractModel`. */
+export declare function isAbstractModel(nameOrClass: string | Function): boolean;
+/**
+ * Attribute metadata for a model, including everything inherited from abstract
+ * base classes up the prototype chain.
+ *
+ * Metadata is keyed by constructor name, so a subclass would otherwise see only
+ * the columns declared directly on it. Base columns come first, and a subclass
+ * redeclaring a column overrides it.
  */
+export declare function getInheritedAttributeMetadata(modelClass: Function): Map<string, AttributeMetadata>;
 export declare function Table(options?: TableOptions): ClassDecorator;
 /**
  * Table options interface

package/dist/models/decorators.js

@@ -13,6 +13,9 @@
  * - @Comment - Add column comment
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractModel = AbstractModel;
+exports.isAbstractModel = isAbstractModel;
+exports.getInheritedAttributeMetadata = getInheritedAttributeMetadata;
 exports.Table = Table;
 exports.Attribute = Attribute;
 exports.Column = Column;
@@ -70,6 +73,77 @@ const associationMetadata = new Map();
  * @example
  * @Table({ tableName: 'users', timestamps: true })
  */
+/** Classes marked with `@AbstractModel`, by constructor name. */
+const abstractModels = new Set();
+/**
+ * Mark a class as an abstract base model.
+ *
+ * An abstract model gets no table of its own. Its columns, and any
+ * `@PrimaryKey` / `@Default` / validation applied to them, are inherited by the
+ * concrete models that extend it, so shared fields are declared once:
+ *
+ * ```typescript
+ * // This is the base model, which defines the common fields between all comments.
+ * @AbstractModel()
+ * class BaseComment {
+ *   @Column(DataTypes.INTEGER())
+ *   @PrimaryKey()
+ *   @AutoIncrement()
+ *   declare id: number;
+ *
+ *   @Column(DataTypes.TEXT())
+ *   declare body: string;
+ * }
+ *
+ * @Table({ tableName: 'post_comments' })
+ * class PostComment extends BaseComment {
+ *   @Column(DataTypes.INTEGER())
+ *   declare postId: number;
+ * }
+ * ```
+ *
+ * `PostComment` is created with id, body and postId. Passing the abstract class
+ * itself to `addModel()` is an error - there is no table to address.
+ */
+function AbstractModel(options = {}) {
+    return function (target) {
+        abstractModels.add(target.name);
+        // Record the options so subclasses can inherit timestamps/paranoid and the
+        // rest, but never a tableName - each concrete model names its own table.
+        const { tableName: _ignored, ...inheritable } = options;
+        modelMetadata.set(target.name, { ...inheritable });
+        return target;
+    };
+}
+/** True when the class (by name) was declared `@AbstractModel`. */
+function isAbstractModel(nameOrClass) {
+    return abstractModels.has(typeof nameOrClass === 'string' ? nameOrClass : nameOrClass.name);
+}
+/**
+ * Attribute metadata for a model, including everything inherited from abstract
+ * base classes up the prototype chain.
+ *
+ * Metadata is keyed by constructor name, so a subclass would otherwise see only
+ * the columns declared directly on it. Base columns come first, and a subclass
+ * redeclaring a column overrides it.
+ */
+function getInheritedAttributeMetadata(modelClass) {
+    const chain = [];
+    let current = modelClass;
+    while (current && current !== Function.prototype && current.name) {
+        chain.unshift(current);
+        current = Object.getPrototypeOf(current);
+    }
+    const merged = new Map();
+    for (const cls of chain) {
+        const own = attributeMetadata.get(cls.name);
+        if (!own)
+            continue;
+        for (const [field, meta] of own)
+            merged.set(field, meta);
+    }
+    return merged;
+}
 function Table(options = {}) {
     return function (target) {
         const modelName = target.name;

package/dist/models/eager-load.d.ts

@@ -11,6 +11,16 @@
  * bugs you hit depended on which API you had used to define the model.
  *
  * Both paths now call `loadIncludes()` below.
+ *
+ * Two things about this loader are worth knowing before reading it:
+ *
+ * 1. An include is resolved with ONE query per association level, never a JOIN:
+ *    all parents are satisfied by a single `WHERE fk IN (...)`. That is
+ *    deliberate - it keeps the statement count constant in the number of rows -
+ *    but it is also why a per-include `limit` cannot simply be forwarded to that
+ *    query; see the per-parent window notes on `loadIncludes()`.
+ * 2. `{ all: true }` entries are expanded to one concrete include per
+ *    association before any of that happens; see `expandAllIncludes()`.
  */
 /** Minimal view of the association records kept in `Prorm.associations`. */
 export interface EagerLoadAssociation {
@@ -52,6 +62,49 @@ export declare function resolvePrimaryKeyAttr(m: any): string;
  * foreign-key logic to it.
  */
 export declare function resolveIncludeAssociation(ctx: EagerLoadContext, parentModel: any, parentModelName: string, includeOpt: any): EagerLoadAssociation;
+/**
+ * Expand `{ all: true }` / `{ all: 'alias' }` include entries into one concrete
+ * include per association.
+ *
+ * `loadIncludes()` used to open each iteration with `if (!includeOpt.model)
+ * continue`, so an entry carrying no `model` - which is exactly what
+ * `{ all: true }` is - was skipped without a word: `include: [{ all: true }]`
+ * emitted the parent SELECT and attached nothing. The class-based path expanded
+ * it (models/model.ts) and the `prorm.define()` path did not, so which of the
+ * two APIs you had used decided whether the option existed.
+ *
+ * Bounding the recursion. `nested: true` walks the association graph, and that
+ * graph routinely contains cycles (`User.hasMany(Post)` + `Post.belongsTo(User)`)
+ * and self-references (`Category.hasMany(Category)`). Depth alone does not bound
+ * those usefully here: unlike the class-based expander - which builds one SQL
+ * statement - every expanded include is another round trip, so a cycle across a
+ * model with three associations would reach 3^10 queries before the depth cap
+ * bit. So expansion is bounded twice: by `MAX_ALL_EXPANSION_DEPTH`, and by the
+ * chain of models already expanded on the current branch - a model is never
+ * auto-expanded twice on one path, which terminates cycles and self-references
+ * at their first repeat.
+ *
+ * The chain stops *re-expansion*, not the association itself: `User` with
+ * `{ all: true, nested: true }` still loads `posts` and each post's `user` (that
+ * is one of Post's associations, and `all` means all), but stops there rather
+ * than walking back into User's associations again. So a two-model cycle costs
+ * three queries, not ten levels of ping-pong.
+ *
+ * Two deliberate differences from the class-based expander:
+ * - the depth cap only ever stops *automatic* expansion; a hand-written include
+ *   is passed through at any depth rather than silently dropped.
+ * - an unknown `{ all: 'alias' }` is an error rather than a console warning.
+ *
+ * `required` carried onto an expanded include filters parents like any other
+ * required include. That needs expansion to happen before the parent-filtering
+ * pass rather than inside `loadIncludes()` at the end of the query - the
+ * filtering pass calls `resolveRequiredIncludeFilter`, which returns null for an
+ * entry with no `model`, so while `{ all: true }` was still un-expanded at that
+ * point `{ all: true, required: true }` loaded the associations and narrowed
+ * nothing. Callers therefore expand once, up front; expansion is idempotent, so
+ * `loadIncludes()` re-running it on an already-expanded list is a no-op.
+ */
+export declare function expandAllIncludes(ctx: EagerLoadContext, parentModel: any, parentModelName: string, includeList: any[], depth?: number, chain?: readonly string[]): any[];
 /**
  * An include filters its parents when it is `required`, and `required` defaults
  * to true whenever the include carries its own `where` - the same rule Sequelize
@@ -75,6 +128,18 @@ export declare function resolveRequiredIncludeFilter(ctx: EagerLoadContext, pare
     parentAttr: string;
     values: any[];
 } | null>;
+/**
+ * Attach a count of related rows to each parent, without loading them.
+ *
+ * `findAll({ withCount: ['posts'] })` sets `row.postsCount` on every parent.
+ * The counts are resolved with one grouped query per association, so this stays
+ * a constant number of statements no matter how many parents there are - the
+ * naive alternative is a count query per row.
+ *
+ * Use this when you need "how many" but not the rows themselves; a full
+ * `include` fetches every child just to measure the array.
+ */
+export declare function loadCounts(ctx: EagerLoadContext, parentRows: any[], parentModel: any, parentModelName: string, aliases: string[]): Promise<void>;
 /**
  * Eager-load `includeList` onto `parentRows`, recursing into nested includes.
  *
@@ -82,5 +147,39 @@ export declare function resolveRequiredIncludeFilter(ctx: EagerLoadContext, pare
  * caught and reported as an empty result, which made a typo'd alias, a missing
  * foreign key column, an unresolvable through model and a genuinely childless
  * parent all look identical - and hid most of the bugs this module now fixes.
+ *
+ * ## Per-include `limit` / `offset`
+ *
+ * `include: [{ model: Post, order: [['id', 'DESC']], limit: 5 }]` reads as "the
+ * 5 most recent posts *per user*", and that is what it now means. Getting there
+ * needs care, because one query serves every parent:
+ *
+ *   SELECT ... FROM "posts" WHERE "userId" IN (1, 2, 3) ORDER BY "id" DESC
+ *
+ * Forwarding `LIMIT 5` into that statement would cap the *whole result set* at 5
+ * rows - user 1 would get five posts and users 2 and 3 none - which is worse
+ * than the old behaviour of dropping the option, because the answer looks
+ * plausible while being wrong for every parent but the first. So the limit is
+ * never forwarded into a multi-parent `IN (...)` query. Instead:
+ *
+ * - `order` is still applied *in SQL*, so the database decides which rows come
+ *   first - the window is a window over the ordering the caller asked for, not
+ *   over insertion order.
+ * - the window is then applied per parent, in memory, when the fetched rows are
+ *   grouped onto their parents.
+ * - the one case where the shared query and a per-parent window coincide is a
+ *   single parent row (`findByPk(...)` with an include, the common case): there
+ *   `LIMIT`/`OFFSET` *are* pushed down to SQL, for `hasMany` only - see below.
+ *
+ * What this does NOT do: reduce what crosses the wire for multi-parent queries.
+ * All matching children are fetched and most of them are then discarded.
+ * `limit` here bounds the arrays you get back, it is not a transfer
+ * optimization. Doing better needs per-parent SQL windows (`ROW_NUMBER() OVER
+ * (PARTITION BY ...)` or `LATERAL`), which is a dialect-level feature this
+ * loader - which only ever calls `Model.findAll()` - cannot express today.
+ *
+ * `limit`/`offset` are only meaningful on a to-many include. On `belongsTo` and
+ * `hasOne` the result is a single row rather than a list, so they are reported
+ * and ignored rather than quietly accepted.
  */
 export declare function loadIncludes(ctx: EagerLoadContext, parentRows: any[], parentModel: any, parentModelName: string, includeList: any[]): Promise<void>;