@atscript/db 0.1.146 → 0.1.148

package/dist/index.mjs

@@ -1,14 +1,14 @@
-import { a as bucketTimeZoneUnavailable, n as CasMismatchError, r as DbError, t as CasExhaustedError } from "./db-error-D5uilS_A.mjs";
-import { $ as isGeoIndexableType, A as vectorIndexNotFoundMessage, B as guardAggregate, C as createFailureCollector, D as resolveDesignType, E as AtscriptDbReadable, F as bucketSourceVerdict, G as narrowerFilterOps, H as guardPath, I as canFilterLeaf, J as RelationalFieldMapper, K as sortFieldNames, L as checkHavingKeys, M as ENCRYPTED_REASON, N as acceptedOperatorsHint, O as geoIndexNotFoundMessage, P as assertGeoPoint, Q as TableMetadata, R as classifyQueryPath, S as BaseDbAdapter, T as NativeIntegrity, U as guardPaths, V as guardFilter, W as guardQuery, X as FieldMappingStrategy, Y as DocumentFieldMapper, Z as UniquSelect, _ as AtscriptDbTable, at as normalizeComputedSelect, b as ApplicationIntegrity, et as isGeoPointType, g as isViewType, h as isAtscriptDbView, it as jsonValueAncestor, j as ADAPTER_FILTER_REASON, k as searchIndexNotFoundMessage, m as AtscriptDbView, n as isColumnTypeChanged, nt as isBucketableField, ot as resolveCalendarBuckets, q as unsupportedOperatorMessage, rt as isJsonValueField, st as NoopLogger, tt as aliasTargetOf, v as assertNoVersionWrites, w as IntegrityStrategy, x as ALL_BUCKET_UNITS, y as decomposePatch, z as collectQueryPaths } from "./column-diff-e2oHc71_.mjs";
-import { t as ALL_AGGREGATE_FNS } from "./aggregate-fns-CfsveE1w.mjs";
-import { T as tableNameOf } from "./nested-writer-CnOOAehr.mjs";
+import { a as aggregateExpressionsNotSupported, c as isConflict, l as spaceClosedError, n as CasMismatchError, o as aggregateFailure, r as DbError, s as bucketTimeZoneUnavailable, t as CasExhaustedError } from "./db-error-Az85UhTX.mjs";
+import { $ as FieldMappingStrategy, A as geoIndexNotFoundMessage, B as classifyQueryPath, C as ALL_VIEW_CAPABILITIES, D as NativeIntegrity, E as IntegrityStrategy, F as acceptedOperatorsHint, G as guardPath, H as groupSourceVerdict, I as assertGeoPoint, J as narrowerFilterOps, K as guardPaths, L as bucketSourceVerdict, M as vectorIndexNotFoundMessage, N as ADAPTER_FILTER_REASON, O as AtscriptDbReadable, P as ENCRYPTED_REASON, Q as DocumentFieldMapper, R as canFilterLeaf, S as ALL_BUCKET_UNITS, T as createFailureCollector, U as guardAggregate, V as collectQueryPaths, W as guardFilter, X as unsupportedOperatorMessage, Y as sortFieldNames, Z as RelationalFieldMapper, _ as isViewType, at as aliasTargetOf, b as decomposePatch, ct as jsonValueAncestor, dt as NoopLogger, et as UniquSelect, f as fkColumns, g as isAtscriptDbView, h as AtscriptDbView, it as isGeoPointType, j as searchIndexNotFoundMessage, k as resolveDesignType, lt as normalizeComputedSelect, n as isColumnTypeChanged, nt as TableMetadata, ot as isBucketableField, q as guardQuery, rt as isGeoIndexableType, st as isJsonValueField, tt as numericOperandProblem, ut as resolveCalendarBuckets, v as AtscriptDbTable, w as BaseDbAdapter, x as ApplicationIntegrity, y as assertNoVersionWrites, z as checkHavingKeys } from "./column-diff-Cp6ZoyRE.mjs";
+import { n as ALL_AGGREGATE_FNS } from "./aggregate-fns-CyaZyb9I.mjs";
+import { A as isResolvedRelationFilter, C as REL_FILTER_MAX_NODES, E as containsRelationFilter, G as isFieldRef, K as translateQueryTree, N as relationStaticFilter, O as forEachResolvedRelation, S as REL_FILTER_MAX_DEPTH, T as andFilters, V as tableNameOf, W as evaluateExpr, k as hasRelationOp, w as ResolvedRelationFilter, x as uniqueKeyTuple } from "./nested-writer-CUBoq1ZO.mjs";
 import { t as DB_ENTITY_ANNOTATIONS } from "./derived-rules-0sKn4f5C.mjs";
 import { a as isPlainObject, i as isEmptyObject, n as findAncestorInSet, o as selfOrAncestor, r as getPath, t as deletePath } from "./object-TkiJQ-Dp.mjs";
 import { t as DEFAULT_DB_SPACE } from "./consts-C_-5_pFq.mjs";
 import { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, getDbFieldOp, isDbFieldOp, reconcileCas, separateCas, separateFieldOps } from "./ops.mjs";
-import { a as forceNavNonOptional, c as getKeyProps, o as isNavRelation, r as buildValidationContext, s as createDbValidatorPlugin, t as buildDbValidator } from "./validator-Clu2q_7z.mjs";
+import { a as forceNavNonOptional, c as getKeyProps, o as isNavRelation, r as buildValidationContext, s as createDbValidatorPlugin, t as buildDbValidator } from "./validator-BTiIOTKP.mjs";
 import { isAnnotatedType } from "@atscript/typescript/utils";
-import { computeInsights, isPrimitive, walkFilter } from "@uniqu/core";
+import { RELATION_OPS, computeInsights, isPrimitive, isRelationOp, walkFilter } from "@uniqu/core";
 import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
 //#region src/encryption.ts
 const ENVELOPE_VERSION = "aes1";
@@ -235,8 +235,14 @@ var DbSpace = class {
 	_readables = /* @__PURE__ */ new WeakMap();
 	/** All tables created in this space — used for reverse FK lookup during cascade. */
 	_allTables = /* @__PURE__ */ new Set();
+	/** Every table / view handle the space created — flagged closed on {@link close}. */
+	_handles = /* @__PURE__ */ new Set();
 	/** Lazily created adapter for administrative ops (drop table/view) that don't need a registered readable. */
 	_adminAdapter;
+	/** Every adapter this space created (tables, views, admin) — disposed on close. */
+	_adapters = /* @__PURE__ */ new Set();
+	_onClose;
+	_closing;
 	logger;
 	/** Encryption service for `@db.encrypted` fields — validated eagerly at construction. */
 	_encryption;
@@ -251,6 +257,7 @@ var DbSpace = class {
 		else {
 			const options = loggerOrOptions ?? {};
 			this.logger = options.logger ?? NoopLogger;
+			this._onClose = options.onClose;
 			if (options.encryption) this._encryption = new DbEncryption(options.encryption);
 		}
 	}
@@ -259,6 +266,7 @@ var DbSpace = class {
 	* appropriate instance. Uses `@db.view` or `@db.view.for` presence to distinguish.
 	*/
 	get(type, logger) {
+		this._assertOpen();
 		if (isViewType(type)) return this.getView(type, logger);
 		return this.getTable(type, logger);
 	}
@@ -267,6 +275,7 @@ var DbSpace = class {
 	* Creates the table + adapter on first access, caches for subsequent calls.
 	*/
 	getTable(type, logger) {
+		this._assertOpen();
 		let readable = this._readables.get(type);
 		if (!readable) {
 			assertNotAlias(type);
@@ -279,6 +288,7 @@ var DbSpace = class {
 			readable.setFkLookupResolver((tableName) => this._getFkLookupTarget(tableName));
 			readable.setEncryption(this._encryption);
 			this._readables.set(type, readable);
+			this._handles.add(readable);
 		}
 		return readable;
 	}
@@ -287,12 +297,14 @@ var DbSpace = class {
 	* Creates the view + adapter on first access, caches for subsequent calls.
 	*/
 	getView(type, logger) {
+		this._assertOpen();
 		let readable = this._readables.get(type);
 		if (!readable) {
 			assertNotAlias(type);
 			readable = new AtscriptDbView(type, this._createAdapter(), logger || this.logger, (t) => this.get(t));
 			readable.setEncryption(this._encryption);
 			this._readables.set(type, readable);
+			this._handles.add(readable);
 		}
 		return readable;
 	}
@@ -301,6 +313,7 @@ var DbSpace = class {
 	* Creates the table/view + adapter on first access if needed.
 	*/
 	getAdapter(type) {
+		this._assertOpen();
 		return this.get(type).dbAdapter;
 	}
 	/**
@@ -308,6 +321,7 @@ var DbSpace = class {
 	* See `BaseDbAdapter.dropTableByName` for an adapter that does not support it.
 	*/
 	async dropTableByName(tableName) {
+		this._assertOpen();
 		await this._getAdminAdapter().dropTableByName(tableName);
 	}
 	/**
@@ -315,6 +329,7 @@ var DbSpace = class {
 	* See `BaseDbAdapter.dropViewByName` for an adapter that does not support it.
 	*/
 	async dropViewByName(viewName) {
+		this._assertOpen();
 		await this._getAdminAdapter().dropViewByName(viewName);
 	}
 	/**
@@ -323,6 +338,7 @@ var DbSpace = class {
 	* @since 0.1.128
 	*/
 	async dropTablesByName(tableNames) {
+		this._assertOpen();
 		await this._getAdminAdapter().dropTablesByName(tableNames);
 	}
 	/**
@@ -332,6 +348,7 @@ var DbSpace = class {
 	* @since 0.1.128
 	*/
 	async getReferencingForeignKeys(tableName) {
+		this._assertOpen();
 		return this._getAdminAdapter().getReferencingForeignKeys?.(tableName);
 	}
 	/**
@@ -350,8 +367,46 @@ var DbSpace = class {
 	_createAdapter() {
 		const adapter = this.adapterFactory();
 		adapter.registerSpace?.(this);
+		this._adapters.add(adapter);
 		return adapter;
 	}
+	/** `true` once {@link close} was called. @since 0.1.148 */
+	get closed() {
+		return this._closing !== void 0;
+	}
+	/** Throws `SPACE_CLOSED` once the space is closed. */
+	_assertOpen() {
+		if (this._closing) throw spaceClosedError();
+	}
+	/**
+	* Closes the space: marks it closed, disposes every adapter it created, then
+	* runs the `onClose` hook (the `createAdapter` helpers close their driver
+	* there). Idempotent — every call returns the first call's promise. Every
+	* step is attempted; failures are collected into an `AggregateError`.
+	*
+	* It does not cancel or drain in-flight queries: call it after the server
+	* stopped accepting requests. After close, `get*` and operations on existing
+	* table/view handles throw `DbError("SPACE_CLOSED")`.
+	* @since 0.1.148
+	*/
+	close() {
+		return this._closing ??= this._doClose();
+	}
+	async _doClose() {
+		for (const readable of this._handles) readable._spaceClosed = true;
+		const errors = [];
+		for (const adapter of this._adapters) try {
+			await adapter.dispose?.();
+		} catch (error) {
+			errors.push(error);
+		}
+		try {
+			await this._onClose?.();
+		} catch (error) {
+			errors.push(error);
+		}
+		if (errors.length > 0) throw aggregateFailure("DbSpace close failed", errors);
+	}
 	/**
 	* Finds all child tables with FKs pointing to the given parent table name.
 	* Accesses `table.foreignKeys` which triggers `_flatten()` if needed.
@@ -375,34 +430,9 @@ var DbSpace = class {
 		for (const table of this._allTables) if (table.tableName === tableName) return { count: (filter) => table.count({ filter }) };
 	}
 };
-//#endregion
-//#region src/query/query-tree.ts
-/**
-* `true` when a query-tree operand is a field reference (`{ field, type? }`)
-* rather than a literal — e.g. the right side of a field-to-field comparison.
-* @since 0.1.136
-*/
-function isFieldRef(value) {
-	return value !== null && typeof value === "object" && "field" in value;
-}
-/**
-* Translates a JS-emitted query tree into a FilterExpr.
-* Resolves field references (type + field path) to physical column names
-* via the provided resolver function.
-*/
-function translateQueryTree(node, resolveField) {
-	if ("$and" in node) return { $and: node.$and.map((n) => translateQueryTree(n, resolveField)) };
-	if ("$or" in node) return { $or: node.$or.map((n) => translateQueryTree(n, resolveField)) };
-	if ("$not" in node) return { $not: translateQueryTree(node.$not, resolveField) };
-	const comp = node;
-	const leftField = resolveField(comp.left);
-	if (isFieldRef(comp.right)) {
-		const rightField = resolveField(comp.right);
-		return { [leftField]: { [comp.op]: { $field: rightField } } };
-	}
-	if (comp.op === "$exists") return { [leftField]: { $exists: comp.right !== false } };
-	return { [leftField]: { [comp.op]: comp.right } };
-}
+if (typeof Symbol.asyncDispose === "symbol") DbSpace.prototype[Symbol.asyncDispose] = function() {
+	return this.close();
+};
 //#endregion
 //#region src/table/db-entity.ts
 /**
@@ -422,4 +452,4 @@ function isDbEntityType(value) {
 	return DB_ENTITY_ANNOTATIONS.some((name) => value.metadata.has(name));
 }
 //#endregion
-export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, BaseDbAdapter, CasExhaustedError, CasMismatchError, DEFAULT_DB_SPACE, DbEncryption, DbError, DbSpace, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, IntegrityStrategy, NativeIntegrity, NoopLogger, RelationalFieldMapper, TableMetadata, UniquSelect, acceptedOperatorsHint, aliasTargetOf, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, createDbValidatorPlugin, createFailureCollector, decomposePatch, deletePath, findAncestorInSet, forceNavNonOptional, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, reconcileCas, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, tableNameOf, translateQueryTree, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };
+export { $cas, $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, ADAPTER_FILTER_REASON, ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_VIEW_CAPABILITIES, ApplicationIntegrity, AtscriptDbReadable, AtscriptDbTable, AtscriptDbView, BaseDbAdapter, CasExhaustedError, CasMismatchError, DEFAULT_DB_SPACE, DbEncryption, DbError, DbSpace, DocumentFieldMapper, ENCRYPTED_REASON, FieldMappingStrategy, IntegrityStrategy, NativeIntegrity, NoopLogger, RELATION_OPS, REL_FILTER_MAX_DEPTH, REL_FILTER_MAX_NODES, RelationalFieldMapper, ResolvedRelationFilter, TableMetadata, UniquSelect, acceptedOperatorsHint, aggregateExpressionsNotSupported, aggregateFailure, aliasTargetOf, andFilters, assertGeoPoint, assertNoVersionWrites, bucketSourceVerdict, bucketTimeZoneUnavailable, buildDbValidator, buildValidationContext, canFilterLeaf, checkHavingKeys, classifyQueryPath, collectQueryPaths, computeInsights, containsRelationFilter, createDbValidatorPlugin, createFailureCollector, decomposePatch, deletePath, evaluateExpr, findAncestorInSet, fkColumns, forEachResolvedRelation, forceNavNonOptional, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, groupSourceVerdict, guardAggregate, guardFilter, guardPath, guardPaths, guardQuery, hasRelationOp, isAtscriptDbView, isBucketableField, isColumnTypeChanged, isConflict, isDbEntityType, isDbFieldOp, isEmptyObject, isFieldRef, isGeoIndexableType, isGeoPointType, isJsonValueField, isNavRelation, isPlainObject, isPrimitive, isRelationOp, isResolvedRelationFilter, isViewType, jsonValueAncestor, narrowerFilterOps, normalizeComputedSelect, numericOperandProblem, reconcileCas, relationStaticFilter, resolveCalendarBuckets, resolveDesignType, searchIndexNotFoundMessage, selfOrAncestor, separateCas, separateFieldOps, sortFieldNames, tableNameOf, translateQueryTree, uniqueKeyTuple, unsupportedOperatorMessage, vectorIndexNotFoundMessage, walkFilter, withOptimisticRetry };