@warlock.js/cascade 5.29.0 → 5.31.0

package/cjs/index.cjs

@@ -41,7 +41,7 @@ fs = __toESM(fs, 1);
 let path = require("path");
 path = __toESM(path, 1);
 
-//#region ../cascade/src/context/database-data-source-context.ts
+//#region ../../packages/cascade/src/context/database-data-source-context.ts
 /**
 * Database DataSource Context
 *
@@ -72,7 +72,7 @@ const databaseDataSourceContext = new DatabaseDataSourceContext();
 _warlock_js_context.contextManager.register("db.datasource", databaseDataSourceContext);
 
 //#endregion
-//#region ../cascade/src/context/database-transaction-context.ts
+//#region ../../packages/cascade/src/context/database-transaction-context.ts
 /**
 * Database Transaction Context
 *
@@ -132,7 +132,7 @@ const databaseTransactionContext = new DatabaseTransactionContext();
 _warlock_js_context.contextManager.register("db.transaction", databaseTransactionContext);
 
 //#endregion
-//#region ../cascade/src/transactions/after-commit.ts
+//#region ../../packages/cascade/src/transactions/after-commit.ts
 function reportFailure(error) {
 	_warlock_js_logger.log.error("database", "afterCommit", `[cascade] afterCommit callback failed: ${error}`);
 }
@@ -174,7 +174,7 @@ async function flushAfterCommit(callbacks) {
 }
 
 //#endregion
-//#region ../cascade/src/data-source/data-source.ts
+//#region ../../packages/cascade/src/data-source/data-source.ts
 /**
 * Wrapper that couples a driver with its metadata.
 *
@@ -281,7 +281,7 @@ var DataSource = class {
 };
 
 //#endregion
-//#region ../cascade/src/errors/missing-data-source.error.ts
+//#region ../../packages/cascade/src/errors/missing-data-source.error.ts
 /**
 * Error thrown when a requested data source is not found in the registry.
 *
@@ -310,7 +310,7 @@ var MissingDataSourceError = class MissingDataSourceError extends Error {
 };
 
 //#endregion
-//#region ../cascade/src/data-source/data-source-registry.ts
+//#region ../../packages/cascade/src/data-source/data-source-registry.ts
 /** Maintains registry of named data sources. */
 var DataSourceRegistry = class {
 	sources = /* @__PURE__ */ new Map();
@@ -521,7 +521,7 @@ var DataSourceRegistry = class {
 const dataSourceRegistry = new DataSourceRegistry();
 
 //#endregion
-//#region ../cascade/src/errors/transaction-rollback.error.ts
+//#region ../../packages/cascade/src/errors/transaction-rollback.error.ts
 /**
 * Error thrown when a transaction is explicitly rolled back via ctx.rollback().
 *
@@ -548,7 +548,7 @@ var TransactionRollbackError = class TransactionRollbackError extends Error {
 };
 
 //#endregion
-//#region ../cascade/src/errors/undefined-where-value.error.ts
+//#region ../../packages/cascade/src/errors/undefined-where-value.error.ts
 /**
 * Error thrown when a `where()`-family call is given `undefined` as the
 * bound value.
@@ -584,7 +584,7 @@ var UndefinedWhereValueError = class UndefinedWhereValueError extends Error {
 };
 
 //#endregion
-//#region ../cascade/src/errors/unsafe-filter.error.ts
+//#region ../../packages/cascade/src/errors/unsafe-filter.error.ts
 /**
 * Error thrown when a filter value in an equality position contains
 * MongoDB operator keys (keys starting with `$`, e.g. `$ne`, `$gt`, `$where`).
@@ -622,7 +622,7 @@ var UnsafeFilterError = class UnsafeFilterError extends Error {
 };
 
 //#endregion
-//#region ../cascade/src/errors/unsafe-raw-expression.error.ts
+//#region ../../packages/cascade/src/errors/unsafe-raw-expression.error.ts
 /**
 * Error thrown when a string expression is passed to `whereRaw()` /
 * `orWhereRaw()` on the MongoDB driver.
@@ -648,7 +648,7 @@ var UnsafeRawExpressionError = class UnsafeRawExpressionError extends Error {
 };
 
 //#endregion
-//#region ../cascade/src/errors/unsupported-lean-operation.error.ts
+//#region ../../packages/cascade/src/errors/unsupported-lean-operation.error.ts
 /**
 * Error thrown when a query in lean read mode (`.lean()`) asks for something
 * that needs hydrated Model instances — eager-loading relations with `with()`
@@ -677,7 +677,7 @@ var UnsupportedLeanOperationError = class UnsupportedLeanOperationError extends
 };
 
 //#endregion
-//#region ../cascade/src/errors/unsupported-lock-for-update.error.ts
+//#region ../../packages/cascade/src/errors/unsupported-lock-for-update.error.ts
 /**
 * Error thrown when `lockForUpdate()` is requested on MongoDB, whose document
 * model has no row-level `SELECT ... FOR UPDATE` equivalent.
@@ -691,7 +691,7 @@ var UnsupportedLockForUpdateError = class UnsupportedLockForUpdateError extends
 };
 
 //#endregion
-//#region ../cascade/src/errors/unsupported-query-operation.error.ts
+//#region ../../packages/cascade/src/errors/unsupported-query-operation.error.ts
 /**
 * Error thrown when a query builder is asked for a read operation its driver
 * cannot express — e.g. a MongoDB-only aggregation stage such as `unwind()` or
@@ -726,7 +726,7 @@ var UnsupportedQueryOperationError = class UnsupportedQueryOperationError extend
 };
 
 //#endregion
-//#region ../cascade/src/errors/unsupported-update-operation.error.ts
+//#region ../../packages/cascade/src/errors/unsupported-update-operation.error.ts
 /**
 * Error thrown when a driver is asked to perform an update it cannot express
 * natively — e.g. an aggregation-pipeline update, `arrayFilters` or `$addToSet`
@@ -761,7 +761,7 @@ var UnsupportedUpdateOperationError = class UnsupportedUpdateOperationError exte
 };
 
 //#endregion
-//#region ../cascade/src/utils/prune-empty-parents.ts
+//#region ../../packages/cascade/src/utils/prune-empty-parents.ts
 /**
 * Remove the ancestors of `path` that became empty plain objects, walking from
 * the leaf's parent up to (and including) the top-level field.
@@ -795,7 +795,7 @@ function pruneEmptyParents(root, path) {
 }
 
 //#endregion
-//#region ../cascade/src/database-dirty-tracker.ts
+//#region ../../packages/cascade/src/database-dirty-tracker.ts
 function canBeFlatten(object) {
 	return (0, _mongez_supportive_is.isPlainObject)(object);
 }
@@ -1248,7 +1248,7 @@ var DatabaseDirtyTracker = class {
 };
 
 //#endregion
-//#region ../cascade/src/events/model-events.ts
+//#region ../../packages/cascade/src/events/model-events.ts
 /**
 * Light-weight async event emitter used to power model lifecycle hooks.
 *
@@ -1500,7 +1500,7 @@ var ModelEvents = class {
 const globalModelEvents = new ModelEvents();
 
 //#endregion
-//#region ../cascade/src/relations/key-conventions.ts
+//#region ../../packages/cascade/src/relations/key-conventions.ts
 /**
 * @fileoverview Foreign-key naming conventions for relation defaults.
 *
@@ -1625,7 +1625,7 @@ function inferPivotTable(selfModelName, relatedModelName, options) {
 }
 
 //#endregion
-//#region ../cascade/src/model/relation-decorators.ts
+//#region ../../packages/cascade/src/model/relation-decorators.ts
 /**
 * @fileoverview TC39 Stage 3 class field decorators for declaring model
 * relations directly on the field.
@@ -1812,7 +1812,7 @@ const HasMany = makeRelationDecorator("hasMany");
 const BelongsToMany = makeRelationDecorator("belongsToMany");
 
 //#endregion
-//#region ../cascade/src/model/register-model.ts
+//#region ../../packages/cascade/src/model/register-model.ts
 /**
 * Global model registry that maps model class names to their constructors.
 * This allows for string-based model references to avoid circular dependencies.
@@ -1997,7 +1997,7 @@ function verifyRegisteredRelations() {
 }
 
 //#endregion
-//#region ../cascade/src/relations/relation-loader.ts
+//#region ../../packages/cascade/src/relations/relation-loader.ts
 /**
 * @fileoverview Core relation loading logic for the Cascade ORM.
 *
@@ -2443,7 +2443,7 @@ var RelationLoader = class RelationLoader {
 };
 
 //#endregion
-//#region ../cascade/src/sync/model-events.ts
+//#region ../../packages/cascade/src/sync/model-events.ts
 /**
 * Model sync event name helpers.
 *
@@ -2545,7 +2545,7 @@ async function triggerModelEvent(modelClass, eventType, ...args) {
 }
 
 //#endregion
-//#region ../cascade/src/sync/sync-context.ts
+//#region ../../packages/cascade/src/sync/sync-context.ts
 /**
 * Default maximum sync depth.
 * Prevents infinite sync chains.
@@ -2638,7 +2638,7 @@ var SyncContextManager = class {
 };
 
 //#endregion
-//#region ../cascade/src/sync/sync-manager.ts
+//#region ../../packages/cascade/src/sync/sync-manager.ts
 /**
 * Manages sync operations across models with multi-level support.
 */
@@ -3141,7 +3141,7 @@ var SyncManager = class {
 };
 
 //#endregion
-//#region ../cascade/src/sync/model-sync-operation.ts
+//#region ../../packages/cascade/src/sync/model-sync-operation.ts
 /**
 * Model sync operation class.
 *
@@ -3391,7 +3391,7 @@ var ModelSyncOperation = class {
 };
 
 //#endregion
-//#region ../cascade/src/sync/model-sync.ts
+//#region ../../packages/cascade/src/sync/model-sync.ts
 /**
 * ModelSync facade implementation.
 *
@@ -3544,7 +3544,7 @@ var ModelSyncFacade = class {
 const modelSync = new ModelSyncFacade();
 
 //#endregion
-//#region ../cascade/src/model/methods/accessor-methods.ts
+//#region ../../packages/cascade/src/model/methods/accessor-methods.ts
 /**
 * Sentinel symbol to distinguish a genuinely missing field from a field
 * whose value is `undefined`. Encapsulated here — callers use `hasField()`.
@@ -3640,7 +3640,7 @@ function getBooleanField(model, key, defaultValue) {
 }
 
 //#endregion
-//#region ../cascade/src/sync/sync-fanout.ts
+//#region ../../packages/cascade/src/sync/sync-fanout.ts
 /**
 * Serializes post-commit sync fan-out and retries transient failures without
 * making the already-committed write, delete, or restore fail.
@@ -3703,7 +3703,7 @@ function enqueueSyncFanout(job) {
 }
 
 //#endregion
-//#region ../cascade/src/remover/database-remover.ts
+//#region ../../packages/cascade/src/remover/database-remover.ts
 /**
 * Database remover service that orchestrates model deletion.
 *
@@ -3887,7 +3887,7 @@ var DatabaseRemover = class {
 };
 
 //#endregion
-//#region ../cascade/src/utils/sanitize-filter.ts
+//#region ../../packages/cascade/src/utils/sanitize-filter.ts
 /**
 * Filter sanitization for equality-position values.
 *
@@ -3978,7 +3978,7 @@ function sanitizeFilter(filter) {
 }
 
 //#endregion
-//#region ../cascade/src/model/methods/delete-methods.ts
+//#region ../../packages/cascade/src/model/methods/delete-methods.ts
 async function destroyModel(model, options) {
 	return new DatabaseRemover(model).destroy(options);
 }
@@ -3994,7 +3994,7 @@ async function deleteOneRecord(ModelClass, filter) {
 }
 
 //#endregion
-//#region ../cascade/src/model/methods/dirty-methods.ts
+//#region ../../packages/cascade/src/model/methods/dirty-methods.ts
 function checkHasChanges(model) {
 	return model.dirtyTracker.hasChanges();
 }
@@ -4012,7 +4012,7 @@ function getDirtyColumns(model) {
 }
 
 //#endregion
-//#region ../cascade/src/relations/relation-hydrator.ts
+//#region ../../packages/cascade/src/relations/relation-hydrator.ts
 /**
 * Restores eager-loaded relations from a plain snapshot onto a model instance.
 *
@@ -4060,7 +4060,7 @@ var RelationHydrator = class {
 };
 
 //#endregion
-//#region ../cascade/src/model/methods/hydration-methods.ts
+//#region ../../packages/cascade/src/model/methods/hydration-methods.ts
 /**
 * Drivers re-inflate any ISO-looking string into a Date. Only fields the model
 * schema declares as dates may be converted, so put every other string back.
@@ -4119,7 +4119,7 @@ function replaceModelData(model, data) {
 }
 
 //#endregion
-//#region ../cascade/src/model/methods/static-event-methods.ts
+//#region ../../packages/cascade/src/model/methods/static-event-methods.ts
 /**
 * Isolated event emitter registry — one ModelEvents instance per model constructor.
 * Encapsulated here so no other module needs to know it exists.
@@ -4166,7 +4166,7 @@ function getGlobalEvents() {
 }
 
 //#endregion
-//#region ../cascade/src/model/methods/instance-event-methods.ts
+//#region ../../packages/cascade/src/model/methods/instance-event-methods.ts
 async function emitModelEvent(model, event, context) {
 	const ctor = model.constructor;
 	await model.events.emit(event, model, context);
@@ -4184,7 +4184,7 @@ function offModelEvent(model, event, listener) {
 }
 
 //#endregion
-//#region ../cascade/src/model/generate-model-id.ts
+//#region ../../packages/cascade/src/model/generate-model-id.ts
 /**
 * Generate the next model id using the model's configured sequence options.
 *
@@ -4205,7 +4205,7 @@ async function generateModelId(ModelClass) {
 }
 
 //#endregion
-//#region ../cascade/src/validation/database-writer-validation-error.ts
+//#region ../../packages/cascade/src/validation/database-writer-validation-error.ts
 /**
 * Error thrown when model validation fails during database write operations.
 *
@@ -4354,7 +4354,7 @@ var DatabaseWriterValidationError = class DatabaseWriterValidationError extends
 };
 
 //#endregion
-//#region ../cascade/src/validation/rules/exists-rule.ts
+//#region ../../packages/cascade/src/validation/rules/exists-rule.ts
 /**
 * Validates that a record exists in the database for the given column/value.
 *
@@ -4380,7 +4380,7 @@ const existsRule = {
 };
 
 //#endregion
-//#region ../cascade/src/validation/rules/unique-rule.ts
+//#region ../../packages/cascade/src/validation/rules/unique-rule.ts
 /**
 * Validates that a value is unique against a database column.
 *
@@ -4420,7 +4420,7 @@ const uniqueRule = {
 };
 
 //#endregion
-//#region ../cascade/src/validation/plugins/database-rules-plugin.ts
+//#region ../../packages/cascade/src/validation/plugins/database-rules-plugin.ts
 /**
 * Cascade's database-rules plugin for Seal.
 */
@@ -4457,7 +4457,7 @@ const databaseRulesPlugin = {
 };
 
 //#endregion
-//#region ../cascade/src/validation/mutators/embed-mutator.ts
+//#region ../../packages/cascade/src/validation/mutators/embed-mutator.ts
 const databaseModelMutator = async (value, context) => {
 	const { model } = context?.options || {};
 	if (!model) throw new Error("Model option is required");
@@ -4486,7 +4486,7 @@ const databaseModelsMutator = async (value, context) => {
 };
 
 //#endregion
-//#region ../cascade/src/validation/rules/database-model-rule.ts
+//#region ../../packages/cascade/src/validation/rules/database-model-rule.ts
 const databaseModelRule = {
 	name: "databaseModel",
 	defaultErrorMessage: "The :input must be a valid :model model",
@@ -4513,7 +4513,7 @@ const databaseModelsRule = {
 };
 
 //#endregion
-//#region ../cascade/src/validation/transformers/embed-model-transformer.ts
+//#region ../../packages/cascade/src/validation/transformers/embed-model-transformer.ts
 const databaseModelTransformer = (value, context) => {
 	const embed = context.options.embed ?? "embedData";
 	if (value instanceof Model === false && !Array.isArray(value)) return value;
@@ -4526,7 +4526,7 @@ const databaseModelTransformer = (value, context) => {
 };
 
 //#endregion
-//#region ../cascade/src/validation/validators/embed-validator.ts
+//#region ../../packages/cascade/src/validation/validators/embed-validator.ts
 var EmbedModelValidator = class extends _warlock_js_seal.BaseValidator {
 	/**
 	* Check if value is a string type
@@ -4560,7 +4560,7 @@ var EmbedModelValidator = class extends _warlock_js_seal.BaseValidator {
 };
 
 //#endregion
-//#region ../cascade/src/validation/plugins/embed-validator-plugin.ts
+//#region ../../packages/cascade/src/validation/plugins/embed-validator-plugin.ts
 /**
 * File validation plugin for Seal
 */
@@ -4581,12 +4581,12 @@ const embedValidator = {
 };
 
 //#endregion
-//#region ../cascade/src/validation/database-seal-plugins.ts
+//#region ../../packages/cascade/src/validation/database-seal-plugins.ts
 (0, _warlock_js_seal.registerPlugin)(embedValidator);
 (0, _warlock_js_seal.registerPlugin)(databaseRulesPlugin);
 
 //#endregion
-//#region ../cascade/src/writer/database-writer.ts
+//#region ../../packages/cascade/src/writer/database-writer.ts
 /**
 * Database writer service that orchestrates model persistence.
 *
@@ -4945,7 +4945,7 @@ var DatabaseWriter = class {
 };
 
 //#endregion
-//#region ../cascade/src/model/methods/meta-methods.ts
+//#region ../../packages/cascade/src/model/methods/meta-methods.ts
 /**
 * Whether a subclass (or an intermediate base below `Model`) set the static
 * itself. The base `Model` initialises several statics (strictMode,
@@ -5013,7 +5013,7 @@ async function performAtomicDecrement(model, field, amount = 1) {
 }
 
 //#endregion
-//#region ../cascade/src/relations/pivot-operations.ts
+//#region ../../packages/cascade/src/relations/pivot-operations.ts
 /**
 * Manages pivot table operations for many-to-many relationships.
 *
@@ -5240,7 +5240,7 @@ function createPivotOperations(model, relationName) {
 }
 
 //#endregion
-//#region ../cascade/src/model/methods/pivot-methods.ts
+//#region ../../packages/cascade/src/model/methods/pivot-methods.ts
 /**
 * Get the pivot-operations handle for a `belongsToMany` relation.
 *
@@ -5284,7 +5284,7 @@ async function detachPivotRelation(model, relation, ids) {
 }
 
 //#endregion
-//#region ../cascade/src/model/methods/serialization-methods.ts
+//#region ../../packages/cascade/src/model/methods/serialization-methods.ts
 /**
 * Field names that commonly hold credentials/secrets. Used only to emit a
 * one-time warning when such a field exists in a model's schema but is not
@@ -5347,7 +5347,7 @@ function modelToJSON(model) {
 }
 
 //#endregion
-//#region ../cascade/src/model/methods/query-methods.ts
+//#region ../../packages/cascade/src/model/methods/query-methods.ts
 function buildQuery(ModelClass, BaseModel) {
 	const queryBuilder = ModelClass.newQueryBuilder();
 	queryBuilder.pendingGlobalScopes = new Map([...BaseModel.globalScopes, ...ModelClass.globalScopes]);
@@ -5577,7 +5577,7 @@ function resolveDataSource(ModelClass) {
 }
 
 //#endregion
-//#region ../cascade/src/restorer/database-restorer.ts
+//#region ../../packages/cascade/src/restorer/database-restorer.ts
 /**
 * Database restorer service that orchestrates model restoration.
 *
@@ -5919,7 +5919,7 @@ var DatabaseRestorer = class {
 };
 
 //#endregion
-//#region ../cascade/src/model/methods/restore-methods.ts
+//#region ../../packages/cascade/src/model/methods/restore-methods.ts
 async function restoreRecord(ModelClass, id, options) {
 	const result = await new DatabaseRestorer(ModelClass).restore(id, options);
 	if (!result.restoredRecord) throw new Error(`Failed to restore ${ModelClass.name} with ${ModelClass.primaryKey} ${id}: no record returned.`);
@@ -5931,7 +5931,7 @@ async function restoreAllRecords(ModelClass, options) {
 }
 
 //#endregion
-//#region ../cascade/src/model/methods/scope-methods.ts
+//#region ../../packages/cascade/src/model/methods/scope-methods.ts
 /**
 * Give the model class its OWN scope map before mutating.
 *
@@ -5963,7 +5963,7 @@ function removeLocalModelScope(ModelClass, name) {
 }
 
 //#endregion
-//#region ../cascade/src/model/methods/write-methods.ts
+//#region ../../packages/cascade/src/model/methods/write-methods.ts
 /**
 * Default number of rows processed per chunk by {@link createManyRecords}.
 *
@@ -6185,7 +6185,7 @@ async function upsertRecord(ModelClass, filter, data, options) {
 }
 
 //#endregion
-//#region ../cascade/src/model/model.ts
+//#region ../../packages/cascade/src/model/model.ts
 /**
 * Base class that powers all Cascade models.
 *
@@ -8110,7 +8110,7 @@ var Model = class Model {
 };
 
 //#endregion
-//#region ../cascade/src/expressions/aggregate-expressions.ts
+//#region ../../packages/cascade/src/expressions/aggregate-expressions.ts
 /**
 * Checks if a value is an abstract aggregate expression.
 */
@@ -8413,7 +8413,7 @@ const $agg = {
 };
 
 //#endregion
-//#region ../cascade/src/expressions/column-expressions.ts
+//#region ../../packages/cascade/src/expressions/column-expressions.ts
 /**
 * Type guard: is `value` one of the typed column-expression nodes?
 *
@@ -8563,7 +8563,7 @@ const $expr = {
 };
 
 //#endregion
-//#region ../cascade/src/utils/is-valid-date-value.ts
+//#region ../../packages/cascade/src/utils/is-valid-date-value.ts
 const isoRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,6})?(Z|[+-]\d{2}:?\d{2})$/;
 /**
 * Check if the given value is a valid date value
@@ -8587,7 +8587,7 @@ function isValidDateValue(value) {
 }
 
 //#endregion
-//#region ../cascade/src/drivers/mongodb/mongodb-blueprint.ts
+//#region ../../packages/cascade/src/drivers/mongodb/mongodb-blueprint.ts
 var MongoDBBlueprint = class {
 	database;
 	/**
@@ -8637,7 +8637,7 @@ var MongoDBBlueprint = class {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/mongodb/mongodb-id-generator.ts
+//#region ../../packages/cascade/src/drivers/mongodb/mongodb-id-generator.ts
 /** Number of times a reservation retries after a duplicate-key (E11000) error. */
 const MAX_RESERVE_ATTEMPTS = 3;
 /** MongoDB duplicate-key error code. */
@@ -8870,7 +8870,7 @@ var MongoIdGenerator = class {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/mongodb/mongodb-migration-driver.ts
+//#region ../../packages/cascade/src/drivers/mongodb/mongodb-migration-driver.ts
 /**
 * MongoDB-specific migration driver implementation.
 *
@@ -9398,7 +9398,7 @@ var MongoMigrationDriver = class {
 };
 
 //#endregion
-//#region ../cascade/src/query-builder/lean-records.ts
+//#region ../../packages/cascade/src/query-builder/lean-records.ts
 /**
 * Throw when a lean query also asks for eager-loaded relations.
 *
@@ -9428,7 +9428,7 @@ function stripHiddenFromLeanRecords(records, modelClass) {
 }
 
 //#endregion
-//#region ../cascade/src/query-builder/query-builder.ts
+//#region ../../packages/cascade/src/query-builder/query-builder.ts
 /**
 * Pure, driver-agnostic query builder.
 *
@@ -10695,7 +10695,7 @@ var QueryBuilder = class QueryBuilder {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/mongodb/mongodb-query-operations.ts
+//#region ../../packages/cascade/src/drivers/mongodb/mongodb-query-operations.ts
 /**
 * Helper class for constructing MongoDB aggregation pipeline operations.
 *
@@ -10968,7 +10968,7 @@ var MongoQueryOperations = class {
 };
 
 //#endregion
-//#region ../cascade/src/utils/escape-regex.ts
+//#region ../../packages/cascade/src/utils/escape-regex.ts
 /**
 * Regex escaping for pattern-matching helpers.
 *
@@ -11042,7 +11042,7 @@ function resolveLikePattern(pattern) {
 }
 
 //#endregion
-//#region ../cascade/src/drivers/mongodb/pipeline-stage-object.ts
+//#region ../../packages/cascade/src/drivers/mongodb/pipeline-stage-object.ts
 /**
 * Whether a value looks like one MongoDB aggregation stage: a plain object
 * with exactly one key, and that key is a `$`-prefixed stage name
@@ -11064,7 +11064,7 @@ function isPipelineStageObject(value) {
 }
 
 //#endregion
-//#region ../cascade/src/drivers/mongodb/mongodb-query-parser.ts
+//#region ../../packages/cascade/src/drivers/mongodb/mongodb-query-parser.ts
 const isPlainObject = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
 /**
 * AND one `key: value` condition into `target`. Operators on the same field
@@ -12364,7 +12364,7 @@ var MongoQueryParser = class {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/mongodb/mongodb-query-builder.ts
+//#region ../../packages/cascade/src/drivers/mongodb/mongodb-query-builder.ts
 /**
 * MongoDB-specific query builder implementation using aggregation pipeline.
 */
@@ -14349,7 +14349,7 @@ var MongoQueryBuilder = class MongoQueryBuilder extends QueryBuilder {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/mongodb/mongodb-sync-adapter.ts
+//#region ../../packages/cascade/src/drivers/mongodb/mongodb-sync-adapter.ts
 /**
 * MongoDB implementation of the sync adapter.
 * Handles array updates using positional operators and arrayFilters.
@@ -14465,7 +14465,7 @@ var MongoSyncAdapter = class {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/mongodb/mongodb-update-translator.ts
+//#region ../../packages/cascade/src/drivers/mongodb/mongodb-update-translator.ts
 /**
 * Translate cascade's driver-agnostic update into MongoDB's native form.
 *
@@ -14488,7 +14488,7 @@ function toMongoUpdate(update) {
 }
 
 //#endregion
-//#region ../cascade/src/drivers/mongodb/mongodb-driver.ts
+//#region ../../packages/cascade/src/drivers/mongodb/mongodb-driver.ts
 const DEFAULT_TRANSACTION_OPTIONS = {
 	readPreference: "primary",
 	readConcern: { level: "local" },
@@ -15310,7 +15310,7 @@ var MongoDbDriver = class {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/postgres/postgres-blueprint.ts
+//#region ../../packages/cascade/src/drivers/postgres/postgres-blueprint.ts
 /**
 * PostgreSQL Blueprint.
 *
@@ -15412,7 +15412,7 @@ var PostgresBlueprint = class {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/postgres/naming.ts
+//#region ../../packages/cascade/src/drivers/postgres/naming.ts
 /** Convert a JavaScript camelCase key to a PostgreSQL snake_case column name. */
 function camelToSnake(value) {
 	if (value === "*" || value.includes("_")) return value;
@@ -15428,7 +15428,7 @@ function snakeKeysToCamel(row) {
 }
 
 //#endregion
-//#region ../cascade/src/drivers/postgres/postgres-dialect.ts
+//#region ../../packages/cascade/src/drivers/postgres/postgres-dialect.ts
 /**
 * PostgreSQL-specific SQL dialect implementation.
 *
@@ -15744,7 +15744,7 @@ function toFiniteNumber$1(value) {
 }
 
 //#endregion
-//#region ../cascade/src/sql-database-dirty-tracker.ts
+//#region ../../packages/cascade/src/sql-database-dirty-tracker.ts
 /**
 * A dirty tracker designed for SQL databases where nested objects shouldn't be flattened.
 * Since SQL drivers (like Postgres) replace the entire JSON column when updated,
@@ -15760,7 +15760,7 @@ var SqlDatabaseDirtyTracker = class extends DatabaseDirtyTracker {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/postgres/postgres-type-converters.ts
+//#region ../../packages/cascade/src/drivers/postgres/postgres-type-converters.ts
 const toDate = (value) => new Date(value);
 const toSafeInteger = (value) => {
 	const n = Number(value);
@@ -15815,7 +15815,7 @@ function convertPostgresValue(value, dataTypeID) {
 }
 
 //#endregion
-//#region ../cascade/src/drivers/postgres/postgres-ttl-purge.ts
+//#region ../../packages/cascade/src/drivers/postgres/postgres-ttl-purge.ts
 const TTL_PURGE_INTERVAL_MINUTES = 1;
 const TTL_COMMENT_PREFIX = "warlock_ttl:";
 let nextDriverId = 0;
@@ -15909,7 +15909,7 @@ async function loadPostgresTTLPurgeJobs(driver) {
 }
 
 //#endregion
-//#region ../cascade/src/drivers/postgres/postgres-migration-driver.ts
+//#region ../../packages/cascade/src/drivers/postgres/postgres-migration-driver.ts
 /**
 * PostgreSQL Migration Driver
 *
@@ -16670,7 +16670,7 @@ var PostgresMigrationDriver = class {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/postgres/postgres-query-parser.ts
+//#region ../../packages/cascade/src/drivers/postgres/postgres-query-parser.ts
 /** Allowed `::cast` type names, e.g. `int`, `numeric(10,2)`, `text[]`. */
 const SAFE_CAST_PATTERN = /^[a-z_][a-z0-9_ ]*(\(\d+(,\d+)?\))?(\[\])?$/i;
 /** Allowed orderBy direction, with optional NULLS placement. */
@@ -17358,7 +17358,6 @@ var PostgresQueryParser = class PostgresQueryParser {
 				if (subParser.orderClauses.length > 0) orderBy = ` ORDER BY ${renumber(subParser.orderClauses.join(", "))}`;
 				if (subParser.limitValue !== void 0) limitClause = ` ${this.dialect.limitOffset(subParser.limitValue)}`;
 			}
-			orderBy || limitClause ? `${quotedRelatedTable}${fkCondition}${extraWhere}${orderBy}${limitClause}` : `${innerSelect.replace("json_agg(", "").replace(/\)$/, "")}${quotedRelatedTable}${fkCondition}${extraWhere}`;
 			const aggregated = orderBy || limitClause ? `(SELECT json_agg(row_to_json(sub.*)) FROM (SELECT * FROM ${quotedRelatedTable} a WHERE ${fkCondition}${extraWhere}${orderBy}${limitClause}) sub) AS ${quotedAlias}` : `(SELECT ${innerSelect} FROM ${quotedRelatedTable} a WHERE ${fkCondition}${extraWhere}) AS ${quotedAlias}`;
 			this.selectRaw.push(aggregated);
 		} else {
@@ -17616,7 +17615,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/postgres/postgres-query-builder.ts
+//#region ../../packages/cascade/src/drivers/postgres/postgres-query-builder.ts
 /**
 * Cast an Op[] to PostgresParserOperation[] — the shapes are compatible since
 * both have `type: string` and `data: Record<string, unknown>`.
@@ -18959,7 +18958,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 };
 
 //#endregion
-//#region ../cascade/src/migration/sql-serializer.ts
+//#region ../../packages/cascade/src/migration/sql-serializer.ts
 /**
 * Converts PendingOperation objects to SQL strings for a specific dialect.
 */
@@ -18983,7 +18982,7 @@ var SQLSerializer = class {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/postgres/postgres-sql-serializer.ts
+//#region ../../packages/cascade/src/drivers/postgres/postgres-sql-serializer.ts
 /**
 * PostgreSQL-specific SQL serializer.
 *
@@ -19251,7 +19250,7 @@ var PostgresSQLSerializer = class extends SQLSerializer {
 };
 
 //#endregion
-//#region ../cascade/src/drivers/postgres/postgres-update-validator.ts
+//#region ../../packages/cascade/src/drivers/postgres/postgres-update-validator.ts
 /**
 * Update operators the Postgres driver can express in SQL.
 *
@@ -19283,7 +19282,7 @@ function assertPostgresUpdate(update, options) {
 }
 
 //#endregion
-//#region ../cascade/src/drivers/postgres/postgres-driver.ts
+//#region ../../packages/cascade/src/drivers/postgres/postgres-driver.ts
 /**
 * PostgreSQL Driver
 *
@@ -20690,7 +20689,7 @@ var PostgresDriver = class {
 };
 
 //#endregion
-//#region ../cascade/src/utils/connect-to-database.ts
+//#region ../../packages/cascade/src/utils/connect-to-database.ts
 /**
 * Connect to a database and register the data source.
 *
@@ -20818,7 +20817,7 @@ function pickPostgresDriverOptions(driverOptions) {
 }
 
 //#endregion
-//#region ../cascade/src/utils/database-writer.utils.ts
+//#region ../../packages/cascade/src/utils/database-writer.utils.ts
 /**
 * Transfer value before saving it into the database
 */
@@ -20842,7 +20841,7 @@ function useModelTransformer(callback) {
 }
 
 //#endregion
-//#region ../cascade/src/utils/define-model.ts
+//#region ../../packages/cascade/src/utils/define-model.ts
 /**
 * Define a model with a clean, concise API.
 *
@@ -20934,7 +20933,7 @@ function defineModel(options) {
 }
 
 //#endregion
-//#region ../cascade/src/utils/once-connected.ts
+//#region ../../packages/cascade/src/utils/once-connected.ts
 /**
 * Whether the given source is the registry's actual default (not just the `isDefault` option flag).
 */
@@ -21143,7 +21142,7 @@ function onceDisconnected(dataSourceOrNameOrCallback, callback) {
 }
 
 //#endregion
-//#region ../cascade/src/migration/column-builder.ts
+//#region ../../packages/cascade/src/migration/column-builder.ts
 /**
 * Fluent builder for defining column properties.
 *
@@ -21673,7 +21672,7 @@ var ColumnBuilder = class {
 };
 
 //#endregion
-//#region ../cascade/src/migration/foreign-key-builder.ts
+//#region ../../packages/cascade/src/migration/foreign-key-builder.ts
 /**
 * Fluent builder for foreign key constraints.
 *
@@ -21797,7 +21796,7 @@ var ForeignKeyBuilder = class {
 };
 
 //#endregion
-//#region ../cascade/src/migration/column-helpers.ts
+//#region ../../packages/cascade/src/migration/column-helpers.ts
 /**
 * A no-op migration sink used by standalone column helpers.
 *
@@ -22169,7 +22168,7 @@ function arrayJson() {
 }
 
 //#endregion
-//#region ../cascade/src/migration/migration.ts
+//#region ../../packages/cascade/src/migration/migration.ts
 /**
 * Base class for all database migrations.
 *
@@ -24407,7 +24406,7 @@ Migration.alter = function alterMigration(model, schema, options = {}) {
 Migration.__declarativeFactoriesAttached = true;
 
 //#endregion
-//#region ../cascade/src/migration/parse-created-at.ts
+//#region ../../packages/cascade/src/migration/parse-created-at.ts
 /**
 * Parse a migration's `createdAt` stamp into a `Date`.
 *
@@ -24473,7 +24472,7 @@ function compareCreatedAt(a, b) {
 }
 
 //#endregion
-//#region ../cascade/src/migration/migration-order.ts
+//#region ../../packages/cascade/src/migration/migration-order.ts
 /**
 * Comparator for applying migrations — oldest first.
 *
@@ -24510,7 +24509,7 @@ function sortMigrationsForRollback(a, b) {
 }
 
 //#endregion
-//#region ../cascade/src/migration/sql-grammar.ts
+//#region ../../packages/cascade/src/migration/sql-grammar.ts
 /**
 * Parses and sorts SQL statements globally based on their execution phase,
 * and classifies statements by their semantic type.
@@ -24631,7 +24630,7 @@ var SQLGrammar = class {
 };
 
 //#endregion
-//#region ../cascade/src/migration/migration-runner.ts
+//#region ../../packages/cascade/src/migration/migration-runner.ts
 /** Name of the lock document Mongo migrations claim inside the migrations collection. */
 const MIGRATION_LOCK_NAME = "__warlock_migration_lock__";
 const MIGRATION_LOCK_KEY = "warlock:migrations";
@@ -25501,7 +25500,7 @@ var MigrationRunner = class {
 const migrationRunner = new MigrationRunner();
 
 //#endregion
-//#region ../cascade/src/operations/database.ts
+//#region ../../packages/cascade/src/operations/database.ts
 /**
 * Create a database on the configured data source. Returns `created: false`
 * when the database already exists — drivers are responsible for the
@@ -25537,7 +25536,7 @@ async function dropAllTables(options = {}) {
 }
 
 //#endregion
-//#region ../cascade/src/operations/migrations.ts
+//#region ../../packages/cascade/src/operations/migrations.ts
 /**
 * Run every pending migration registered on the migration runner.
 *