@sqlbraid/core 1.0.0 → 1.0.3

package/dist/index.js

@@ -1,661 +1,358 @@
-//#region src/authoring-modules.ts
-const AUTHORING_MODULE_CATALOG = Object.freeze([
+//#region src/errors.ts
+/** Thrown when a driver value cannot be represented without losing database information. */
+var ResultExactnessError = class ResultExactnessError extends Error {
+	static {
+		this.code = "BRAID_RESULT_EXACTNESS";
+	}
+	constructor(message = "Result value does not have an exact representation.") {
+		super(message);
+		this.code = ResultExactnessError.code;
+		this.name = "ResultExactnessError";
+	}
+};
+/**
+* The intentionally small compatibility boundary for SQLBraid-owned errors.
+*
+* Keep this registry explicit.  In particular, a BRAID_ token in a driver
+* message or an internal compiler fallback is not public merely because it
+* happens to use the project prefix.
+*/
+const PUBLIC_ERROR_DEFINITIONS = Object.freeze([
 	{
-		moduleSpecifier: "@sqlbraid/template",
-		helperFamily: "template"
+		code: "BRAID_RESULT_EXACTNESS",
+		category: "runtime",
+		owner: "ResultExactnessError"
 	},
 	{
-		moduleSpecifier: "@sqlbraid/postgres",
-		dialectId: "postgres",
-		helperFamily: "template"
+		code: "BRAID_CALL_MAP",
+		category: "runtime",
+		owner: "RoutineMappingError"
 	},
 	{
-		moduleSpecifier: "@sqlbraid/mysql",
-		dialectId: "mysql",
-		helperFamily: "template"
+		code: "BRAID_RESULT_KIND",
+		category: "runtime",
+		owner: "@sqlbraid/runtime:DatabaseResultKindError"
 	},
 	{
-		moduleSpecifier: "@sqlbraid/mariadb",
-		dialectId: "mariadb",
-		helperFamily: "template"
+		code: "BRAID_RESULT_VALIDATION",
+		category: "runtime",
+		owner: "@sqlbraid/runtime:DatabaseResultValidationError"
 	},
 	{
-		moduleSpecifier: "@sqlbraid/sqlite",
-		dialectId: "sqlite",
-		helperFamily: "template"
+		code: "BRAID_BATCH_ABORTED",
+		category: "runtime",
+		owner: "runtime batch lifecycle/synthetic observer error"
 	},
 	{
-		moduleSpecifier: "@sqlbraid/oracle",
-		dialectId: "oracle",
-		helperFamily: "template"
+		code: "BRAID_TX_SCOPE",
+		category: "runtime",
+		owner: "@sqlbraid/runtime:DatabaseScopeError"
 	},
 	{
-		moduleSpecifier: "@sqlbraid/mssql",
-		dialectId: "mssql",
-		helperFamily: "template"
+		code: "BRAID_TX_CLOSED",
+		category: "runtime",
+		owner: "@sqlbraid/runtime:DatabaseScopeError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/pg",
-		dialectId: "postgres",
-		helperFamily: "facade"
+		code: "BRAID_SESSION_SCOPE",
+		category: "runtime",
+		owner: "@sqlbraid/runtime:DatabaseScopeError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/mysql2",
-		dialectId: "mysql",
-		helperFamily: "facade"
+		code: "BRAID_SESSION_CLOSED",
+		category: "runtime",
+		owner: "@sqlbraid/runtime:DatabaseScopeError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/mariadb",
-		dialectId: "mariadb",
-		helperFamily: "facade"
+		code: "BRAID_CONNECTION_POISONED",
+		category: "runtime",
+		owner: "@sqlbraid/runtime:DatabaseScopeError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/node-sqlite",
-		dialectId: "sqlite",
-		helperFamily: "facade"
+		code: "BRAID_STREAM_SCOPE",
+		category: "runtime",
+		owner: "@sqlbraid/runtime:DatabaseScopeError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/better-sqlite3",
-		dialectId: "sqlite",
-		helperFamily: "facade"
+		code: "BRAID_REENTRY",
+		category: "runtime",
+		owner: "@sqlbraid/runtime:DatabaseScopeError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/libsql",
-		dialectId: "sqlite",
-		helperFamily: "facade"
+		code: "BRAID_TX_OPTIONS_NESTED",
+		category: "runtime",
+		owner: "@sqlbraid/runtime:DatabaseScopeError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/sqlite-wasm",
-		dialectId: "sqlite",
-		helperFamily: "facade"
+		code: "BRAID_MIGRATE_SOURCE",
+		category: "runtime",
+		owner: "@sqlbraid/migrate:MigrationError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/d1",
-		dialectId: "sqlite",
-		helperFamily: "facade"
+		code: "BRAID_MIGRATE_UNINITIALIZED",
+		category: "runtime",
+		owner: "@sqlbraid/migrate:MigrationStartupError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/oracledb",
-		dialectId: "oracle",
-		helperFamily: "facade"
+		code: "BRAID_MIGRATE_PENDING",
+		category: "runtime",
+		owner: "@sqlbraid/migrate:MigrationStartupError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/tedious",
-		dialectId: "mssql",
-		helperFamily: "facade"
+		code: "BRAID_MIGRATE_AHEAD",
+		category: "runtime",
+		owner: "@sqlbraid/migrate:MigrationStartupError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/postgres",
-		dialectId: "postgres",
-		helperFamily: "facade"
+		code: "BRAID_MIGRATE_CHECKSUM",
+		category: "runtime",
+		owner: "@sqlbraid/migrate:MigrationStartupError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/mysql",
-		dialectId: "mysql",
-		helperFamily: "facade"
+		code: "BRAID_MIGRATE_ORDER",
+		category: "runtime",
+		owner: "@sqlbraid/migrate:MigrationError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/sqlite",
-		dialectId: "sqlite",
-		helperFamily: "facade"
+		code: "BRAID_MIGRATE_DIRTY",
+		category: "runtime",
+		owner: "@sqlbraid/migrate:MigrationError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/oracle",
-		dialectId: "oracle",
-		helperFamily: "facade"
+		code: "BRAID_MIGRATE_BUSY",
+		category: "runtime",
+		owner: "@sqlbraid/migrate:MigrationError"
 	},
 	{
-		moduleSpecifier: "sqlbraid/mssql",
-		dialectId: "mssql",
-		helperFamily: "facade"
-	}
-].map((entry) => Object.freeze(entry)));
-
-//#endregion
-//#region src/capabilities.ts
-const definitions = [
+		code: "BRAID_MIGRATE_SCHEMA_DRIFT",
+		category: "runtime",
+		owner: "@sqlbraid/migrate:MigrationStartupError"
+	},
 	{
-		id: "sql.native-transparency",
-		family: "support"
+		code: "BRAID_CALL_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["routine.call"]
 	},
 	{
-		id: "sql.generated-structure",
-		family: "support"
+		code: "BRAID_RESULT_SETS_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["routine.result-sets"]
 	},
 	{
-		id: "result.rows",
-		family: "support"
+		code: "BRAID_STREAM_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["statement.stream"]
 	},
 	{
-		id: "result.command",
-		family: "support"
+		code: "BRAID_CANCEL_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["statement.cancel"]
 	},
 	{
-		id: "result.multiple-sets",
-		family: "support"
+		code: "BRAID_SESSION_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["session.pinned"]
 	},
 	{
-		id: "result.standard-schema",
-		family: "support"
+		code: "BRAID_TX_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["transaction", "transaction.savepoint"]
 	},
 	{
-		id: "numeric.exact-integer",
-		family: "representation"
+		code: "BRAID_TX_OPTIONS_INVALID",
+		category: "runtime",
+		owner: "TypeError with code"
 	},
 	{
-		id: "numeric.exact-decimal",
-		family: "representation"
+		code: "BRAID_TX_OPTION_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: [
+			"transaction.read-only",
+			"transaction.isolation.read-uncommitted",
+			"transaction.isolation.read-committed",
+			"transaction.isolation.repeatable-read",
+			"transaction.isolation.serializable"
+		]
 	},
 	{
-		id: "numeric.approximate-float",
-		family: "representation"
+		code: "BRAID_CALL_RESULT_SETS",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["routine.result-sets"]
 	},
 	{
-		id: "numeric.approximate-special",
-		family: "representation"
+		code: "BRAID_CALL_CURSOR_TX_REQUIRED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["routine.out-cursor"]
 	},
 	{
-		id: "numeric.bind-exact",
-		family: "representation"
+		code: "BRAID_CALL_OUT_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["routine.out", "routine.inout"]
 	},
 	{
-		id: "numeric.aggregate",
-		family: "representation"
+		code: "BRAID_CALL_RETURN_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["routine.return-value"]
 	},
 	{
-		id: "numeric.command-metadata",
-		family: "representation"
+		code: "BRAID_CALL_PROCEDURE_INVALID",
+		category: "adapter",
+		owner: "AdapterError"
 	},
 	{
-		id: "numeric.special-values",
-		family: "representation"
+		code: "BRAID_CALL_CURSOR_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["routine.out-cursor"]
 	},
 	{
-		id: "numeric.scale-greater-than-precision",
-		family: "representation"
+		code: "BRAID_RESOURCE_CLEANUP",
+		category: "adapter",
+		owner: "adapter cleanup error with code",
+		features: ["resource.cleanup", "resource.discard"]
 	},
 	{
-		id: "numeric.negative-scale",
-		family: "representation"
+		code: "BRAID_BIND_HINT_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["statement.bind-hint"]
 	},
 	{
-		id: "data.json-parsed",
-		family: "representation"
+		code: "BRAID_BIND_VALUE_UNSUPPORTED",
+		category: "adapter",
+		owner: "AdapterError"
 	},
 	{
-		id: "data.json-lossless-text",
-		family: "representation"
+		code: "BRAID_INTEGER_MODE_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["result.exact-integer"]
 	},
 	{
-		id: "data.sql-variant",
-		family: "representation"
+		code: "BRAID_CALL_LOB_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["routine.out"]
 	},
 	{
-		id: "data.oracle-object",
-		family: "representation"
-	},
-	{
-		id: "data.oracle-collection",
-		family: "representation"
-	},
-	{
-		id: "data.vector",
-		family: "representation"
-	},
-	{
-		id: "data.binary",
-		family: "representation"
-	},
-	{
-		id: "data.uuid",
-		family: "representation"
-	},
-	{
-		id: "data.temporal-native",
-		family: "representation"
-	},
-	{
-		id: "data.temporal-lossless",
-		family: "representation"
-	},
-	{
-		id: "data.timezone",
-		family: "representation"
-	},
-	{
-		id: "metadata.command-safe",
-		family: "metadata"
-	},
-	{
-		id: "dml.insert-returning",
-		family: "support"
-	},
-	{
-		id: "dml.update-returning",
-		family: "support"
-	},
-	{
-		id: "dml.delete-returning",
-		family: "support"
-	},
-	{
-		id: "dml.merge-returning",
-		family: "support"
-	},
-	{
-		id: "dml.upsert-returning",
-		family: "support"
-	},
-	{
-		id: "session.pinned",
-		family: "support"
-	},
-	{
-		id: "statement.prepare",
-		family: "support"
-	},
-	{
-		id: "statement.cancel",
-		family: "support"
-	},
-	{
-		id: "statement.stream",
-		family: "support"
-	},
-	{
-		id: "statement.bulk",
-		family: "support"
-	},
-	{
-		id: "execution.bulk-fidelity",
-		family: "support"
-	},
-	{
-		id: "transaction",
-		family: "support"
-	},
-	{
-		id: "transaction.savepoint",
-		family: "support"
-	},
-	{
-		id: "transaction.read-only",
-		family: "support"
-	},
-	{
-		id: "transaction.isolation.read-uncommitted",
-		family: "support"
-	},
-	{
-		id: "transaction.isolation.read-committed",
-		family: "support"
-	},
-	{
-		id: "transaction.isolation.repeatable-read",
-		family: "support"
-	},
-	{
-		id: "transaction.isolation.serializable",
-		family: "support"
-	},
-	{
-		id: "routine.call",
-		family: "support"
-	},
-	{
-		id: "routine.out",
-		family: "support"
-	},
-	{
-		id: "routine.inout",
-		family: "support"
+		code: "BRAID_BULK_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["statement.bulk"]
 	},
 	{
-		id: "routine.result-sets",
-		family: "support"
+		code: "BRAID_PREPARE_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["statement.prepare"]
 	},
 	{
-		id: "routine.out-cursor",
-		family: "support"
+		code: "BRAID_DIALECT_MISMATCH",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["dialect"]
 	},
 	{
-		id: "routine.return-value",
-		family: "support"
+		code: "BRAID_RESULT_KIND_AMBIGUOUS",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["result.rows", "result.command"]
 	},
 	{
-		id: "metadata.identity",
-		family: "metadata"
+		code: "BRAID_PREPARED_NAME",
+		category: "runtime",
+		owner: "prepared query validation"
 	},
 	{
-		id: "metadata.generated",
-		family: "metadata"
+		code: "BRAID_PREPARED_SHAPE",
+		category: "runtime",
+		owner: "prepared query validation"
 	},
 	{
-		id: "metadata.routines",
-		family: "metadata"
+		code: "BRAID_BIND_TYPE_REQUIRED",
+		category: "adapter",
+		owner: "AdapterError"
 	},
 	{
-		id: "metadata.types",
-		family: "metadata"
-	}
-];
-const WELL_KNOWN_CAPABILITIES = Object.freeze(definitions.map((entry) => Object.freeze(entry)));
-const WELL_KNOWN_CAPABILITY_IDS = Object.freeze(definitions.map(({ id }) => id));
-const wellKnownCapabilityIds = new Set(WELL_KNOWN_CAPABILITY_IDS);
-function isWellKnownCapabilityId(value) {
-	return wellKnownCapabilityIds.has(value);
-}
-
-//#endregion
-//#region src/index.ts
-const SQL_FRAGMENT = Symbol.for("sqlbraid.fragment");
-const SQL_BOUND_PARAMETER = Symbol.for("sqlbraid.bound-parameter");
-const knownBoundParameters = /* @__PURE__ */ new WeakSet();
-const SQL_ROUTINE_PARAMETER = Symbol.for("sqlbraid.routine-parameter");
-const knownRoutineParameters = /* @__PURE__ */ new WeakSet();
-var ResultExactnessError = class ResultExactnessError extends Error {
-	static {
-		this.code = "BRAID_RESULT_EXACTNESS";
-	}
-	constructor(message = "Result value does not have an exact representation.") {
-		super(message);
-		this.code = ResultExactnessError.code;
-		this.name = "ResultExactnessError";
-	}
-};
-/**
-* The intentionally small compatibility boundary for SQLBraid-owned errors.
-*
-* Keep this registry explicit.  In particular, a BRAID_ token in a driver
-* message or an internal compiler fallback is not public merely because it
-* happens to use the project prefix.
-*/
-const PUBLIC_ERROR_DEFINITIONS = Object.freeze([
-	{
-		code: "BRAID_RESULT_EXACTNESS",
+		code: "BRAID_EMPTY_LIST",
 		category: "runtime",
-		owner: "ResultExactnessError"
+		owner: "SqlRenderError"
 	},
 	{
-		code: "BRAID_CALL_MAP",
+		code: "BRAID_EMPTY_SET",
 		category: "runtime",
-		owner: "RoutineMappingError"
+		owner: "SqlRenderError"
 	},
 	{
-		code: "BRAID_RESULT_KIND",
+		code: "BRAID_DIALECT",
 		category: "runtime",
-		owner: "@sqlbraid/runtime:DatabaseResultKindError"
+		owner: "SqlRenderError"
 	},
 	{
-		code: "BRAID_RESULT_VALIDATION",
-		category: "runtime",
-		owner: "@sqlbraid/runtime:DatabaseResultValidationError"
+		code: "BRAID_ASYNC_CONTEXT",
+		category: "compiler",
+		owner: "compiler diagnostic"
 	},
 	{
-		code: "BRAID_BATCH_ABORTED",
+		code: "BRAID_DIRECTIVE_UNTERMINATED",
 		category: "runtime",
-		owner: "runtime batch lifecycle/synthetic observer error"
+		owner: "SqlRenderError"
 	},
 	{
-		code: "BRAID_TX_SCOPE",
+		code: "BRAID_DIRECTIVE",
 		category: "runtime",
-		owner: "@sqlbraid/runtime:DatabaseScopeError"
+		owner: "SqlRenderError"
 	},
 	{
-		code: "BRAID_TX_CLOSED",
+		code: "BRAID_CONDITION",
 		category: "runtime",
-		owner: "@sqlbraid/runtime:DatabaseScopeError"
+		owner: "SqlRenderError"
 	},
 	{
-		code: "BRAID_SESSION_SCOPE",
+		code: "BRAID_ATTRIBUTES",
 		category: "runtime",
-		owner: "@sqlbraid/runtime:DatabaseScopeError"
+		owner: "SqlRenderError"
 	},
 	{
-		code: "BRAID_SESSION_CLOSED",
+		code: "BRAID_STRUCTURE",
 		category: "runtime",
-		owner: "@sqlbraid/runtime:DatabaseScopeError"
+		owner: "SqlRenderError"
 	},
 	{
-		code: "BRAID_CONNECTION_POISONED",
+		code: "BRAID_HOLE_CONTEXT",
 		category: "runtime",
-		owner: "@sqlbraid/runtime:DatabaseScopeError"
+		owner: "SqlRenderError"
 	},
 	{
-		code: "BRAID_STREAM_SCOPE",
+		code: "BRAID_SQL_LEX",
 		category: "runtime",
-		owner: "@sqlbraid/runtime:DatabaseScopeError"
+		owner: "SqlRenderError"
 	},
 	{
-		code: "BRAID_REENTRY",
+		code: "BRAID_DEPTH",
 		category: "runtime",
-		owner: "@sqlbraid/runtime:DatabaseScopeError"
+		owner: "SqlRenderError"
 	},
 	{
-		code: "BRAID_TX_OPTIONS_NESTED",
+		code: "BRAID_STRUCTURE_LIMIT",
 		category: "runtime",
-		owner: "@sqlbraid/runtime:DatabaseScopeError"
+		owner: "SqlRenderError"
 	},
 	{
-		code: "BRAID_CALL_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["routine.call"]
-	},
-	{
-		code: "BRAID_RESULT_SETS_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["routine.result-sets"]
-	},
-	{
-		code: "BRAID_STREAM_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["statement.stream"]
-	},
-	{
-		code: "BRAID_CANCEL_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["statement.cancel"]
-	},
-	{
-		code: "BRAID_SESSION_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["session.pinned"]
-	},
-	{
-		code: "BRAID_TX_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["transaction", "transaction.savepoint"]
-	},
-	{
-		code: "BRAID_TX_OPTIONS_INVALID",
-		category: "runtime",
-		owner: "TypeError with code"
-	},
-	{
-		code: "BRAID_TX_OPTION_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: [
-			"transaction.read-only",
-			"transaction.isolation.read-uncommitted",
-			"transaction.isolation.read-committed",
-			"transaction.isolation.repeatable-read",
-			"transaction.isolation.serializable"
-		]
-	},
-	{
-		code: "BRAID_CALL_RESULT_SETS",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["routine.result-sets"]
-	},
-	{
-		code: "BRAID_CALL_CURSOR_TX_REQUIRED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["routine.out-cursor"]
-	},
-	{
-		code: "BRAID_CALL_OUT_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["routine.out", "routine.inout"]
-	},
-	{
-		code: "BRAID_CALL_RETURN_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["routine.call", "routine.return-value"]
-	},
-	{
-		code: "BRAID_CALL_CURSOR_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["routine.out-cursor"]
-	},
-	{
-		code: "BRAID_RESOURCE_CLEANUP",
-		category: "adapter",
-		owner: "adapter cleanup error with code",
-		features: ["resource.cleanup", "resource.discard"]
-	},
-	{
-		code: "BRAID_BIND_HINT_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["statement.bind-hint"]
-	},
-	{
-		code: "BRAID_BIND_VALUE_UNSUPPORTED",
-		category: "adapter",
-		owner: "AdapterError"
-	},
-	{
-		code: "BRAID_INTEGER_MODE_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["result.exact-integer"]
-	},
-	{
-		code: "BRAID_CALL_LOB_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["routine.out"]
-	},
-	{
-		code: "BRAID_BULK_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["statement.bulk"]
-	},
-	{
-		code: "BRAID_PREPARE_UNSUPPORTED",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["statement.prepare"]
-	},
-	{
-		code: "BRAID_DIALECT_MISMATCH",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["dialect"]
-	},
-	{
-		code: "BRAID_RESULT_KIND_AMBIGUOUS",
-		category: "adapter",
-		owner: "UnsupportedFeatureError",
-		features: ["result.rows", "result.command"]
-	},
-	{
-		code: "BRAID_PREPARED_NAME",
-		category: "runtime",
-		owner: "prepared query validation"
-	},
-	{
-		code: "BRAID_PREPARED_SHAPE",
-		category: "runtime",
-		owner: "prepared query validation"
-	},
-	{
-		code: "BRAID_BIND_TYPE_REQUIRED",
-		category: "adapter",
-		owner: "AdapterError"
-	},
-	{
-		code: "BRAID_EMPTY_LIST",
-		category: "runtime",
-		owner: "SqlRenderError"
-	},
-	{
-		code: "BRAID_EMPTY_SET",
-		category: "runtime",
-		owner: "SqlRenderError"
-	},
-	{
-		code: "BRAID_DIALECT",
-		category: "runtime",
-		owner: "SqlRenderError"
-	},
-	{
-		code: "BRAID_ASYNC_CONTEXT",
-		category: "compiler",
-		owner: "compiler diagnostic"
-	},
-	{
-		code: "BRAID_DIRECTIVE_UNTERMINATED",
-		category: "runtime",
-		owner: "SqlRenderError"
-	},
-	{
-		code: "BRAID_DIRECTIVE",
-		category: "runtime",
-		owner: "SqlRenderError"
-	},
-	{
-		code: "BRAID_CONDITION",
-		category: "runtime",
-		owner: "SqlRenderError"
-	},
-	{
-		code: "BRAID_ATTRIBUTES",
-		category: "runtime",
-		owner: "SqlRenderError"
-	},
-	{
-		code: "BRAID_STRUCTURE",
-		category: "runtime",
-		owner: "SqlRenderError"
-	},
-	{
-		code: "BRAID_HOLE_CONTEXT",
-		category: "runtime",
-		owner: "SqlRenderError"
-	},
-	{
-		code: "BRAID_SQL_LEX",
-		category: "runtime",
-		owner: "SqlRenderError"
-	},
-	{
-		code: "BRAID_DEPTH",
-		category: "runtime",
-		owner: "SqlRenderError"
-	},
-	{
-		code: "BRAID_STRUCTURE_LIMIT",
-		category: "runtime",
-		owner: "SqlRenderError"
-	},
-	{
-		code: "BRAID_SQL_LIMIT",
-		category: "runtime",
-		owner: "SqlRenderError"
+		code: "BRAID_SQL_LIMIT",
+		category: "runtime",
+		owner: "SqlRenderError"
 	},
 	{
 		code: "BRAID_BIND_LIMIT",
@@ -663,9 +360,47 @@ const PUBLIC_ERROR_DEFINITIONS = Object.freeze([
 		owner: "SqlRenderError"
 	}
 ]);
+/** Public adapter capability failure. Unsupported features reject explicitly rather than being buffered or simulated. */
+var UnsupportedFeatureError = class extends Error {
+	constructor(feature, code, message, options) {
+		super(`${code}: ${message}`, options);
+		this.feature = feature;
+		this.code = code;
+		this.name = "UnsupportedFeatureError";
+	}
+};
+/** Return true only for a registered, semantically valid feature/code pair. */
+function isPublicUnsupportedFeatureError(error) {
+	if (!(error instanceof UnsupportedFeatureError)) return false;
+	return PUBLIC_ERROR_DEFINITIONS.find((candidate) => candidate.owner === "UnsupportedFeatureError" && candidate.code === error.code)?.features?.includes(error.feature) === true;
+}
+/** An adapter-owned input/transport failure that retains TypeError semantics. */
+var AdapterError = class extends TypeError {
+	constructor(code, message, options) {
+		super(`${code}: ${message}`, options);
+		this.code = code;
+		this.name = "AdapterError";
+	}
+};
+/** Rendering/authoring failure with a stable diagnostic code, raised before driver execution. */
+var SqlRenderError = class extends Error {
+	constructor(code, message) {
+		super(message);
+		this.name = "SqlRenderError";
+		this.code = code;
+	}
+};
+
+//#endregion
+//#region src/numeric.ts
 function exactnessFailure(message) {
 	throw new ResultExactnessError(message);
 }
+/**
+* Decode an exact integer from driver output, optionally enforcing bigint bounds.
+*
+* @throws {ResultExactnessError} When the value is not an exact integer or violates the requested range.
+*/
 function decodeExactInteger(value, range) {
 	let result;
 	if (typeof value === "bigint") result = value;
@@ -714,12 +449,24 @@ function safeDatabaseCount(value) {
 	} catch {}
 	return exactnessFailure("Database count is not a safe non-negative integer.");
 }
+/**
+* Preserve an exact decimal as text; numeric JavaScript values are rejected because they may already be rounded.
+*
+* @throws {ResultExactnessError} When the value cannot prove exact decimal fidelity.
+*/
 function decodeExactDecimal(value, options) {
 	if (typeof value === "string") return value;
 	if (typeof value === "bigint" && options?.allowBigInt === true) return value.toString();
 	return exactnessFailure("Result value does not have an exact decimal representation.");
 }
-function validHintNumber(value) {
+
+//#endregion
+//#region src/parameter.ts
+const SQL_BOUND_PARAMETER = Symbol.for("sqlbraid.bound-parameter");
+const knownBoundParameters = /* @__PURE__ */ new WeakSet();
+const SQL_ROUTINE_PARAMETER = Symbol.for("sqlbraid.routine-parameter");
+const knownRoutineParameters = /* @__PURE__ */ new WeakSet();
+function validHintNumber$1(value) {
 	return typeof value === "number" && Number.isFinite(value) && Number.isInteger(value) && value >= 0;
 }
 function validHintInteger(value) {
@@ -728,14 +475,15 @@ function validHintInteger(value) {
 function isParameterTypeHint(value) {
 	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
 	const candidate = value;
-	return typeof candidate.databaseType === "string" && candidate.databaseType.trim().length > 0 && (candidate.length === void 0 || candidate.length === "max" || validHintNumber(candidate.length)) && (candidate.precision === void 0 || validHintNumber(candidate.precision)) && (candidate.scale === void 0 || validHintInteger(candidate.scale));
+	return typeof candidate.databaseType === "string" && candidate.databaseType.trim().length > 0 && (candidate.length === void 0 || candidate.length === "max" || validHintNumber$1(candidate.length)) && (candidate.precision === void 0 || validHintNumber$1(candidate.precision)) && (candidate.scale === void 0 || validHintInteger(candidate.scale));
 }
+/** Validate and freeze an explicit database parameter-type hint. */
 function createParameterTypeHint(hint) {
 	if (!isParameterTypeHint(hint)) throw new TypeError("sql.bind hint must be an object with valid structural fields.");
 	const candidate = hint;
 	if (typeof candidate.databaseType !== "string" || !candidate.databaseType.trim()) throw new TypeError("sql.bind hint databaseType must be a non-empty string.");
-	if (candidate.length !== void 0 && candidate.length !== "max" && !validHintNumber(candidate.length)) throw new TypeError("sql.bind hint length must be a non-negative integer or \"max\".");
-	if (candidate.precision !== void 0 && !validHintNumber(candidate.precision)) throw new TypeError("sql.bind hint precision must be a non-negative integer.");
+	if (candidate.length !== void 0 && candidate.length !== "max" && !validHintNumber$1(candidate.length)) throw new TypeError("sql.bind hint length must be a non-negative integer or \"max\".");
+	if (candidate.precision !== void 0 && !validHintNumber$1(candidate.precision)) throw new TypeError("sql.bind hint precision must be a non-negative integer.");
 	if (candidate.scale !== void 0 && !validHintInteger(candidate.scale)) throw new TypeError("sql.bind hint scale must be an integer.");
 	const normalized = {
 		databaseType: candidate.databaseType,
@@ -745,6 +493,7 @@ function createParameterTypeHint(hint) {
 	};
 	return Object.freeze(normalized);
 }
+/** Create the value-only marker consumed by adapter binding for an explicitly typed input. */
 function createBoundParameter(value, hint) {
 	const normalizedHint = createParameterTypeHint(hint);
 	const bound = Object.freeze({
@@ -755,6 +504,7 @@ function createBoundParameter(value, hint) {
 	knownBoundParameters.add(bound);
 	return bound;
 }
+/** Recognize only bound-parameter objects created by SQLBraid's own constructor. */
 function isBoundParameter(value) {
 	if (typeof value !== "object" || value === null || !knownBoundParameters.has(value) || !Object.hasOwn(value, SQL_BOUND_PARAMETER)) return false;
 	const candidate = value;
@@ -764,6 +514,7 @@ function normalizeOutputName(name) {
 	if (typeof name !== "string" || !name.trim()) throw new TypeError("Routine outputName must be a non-empty string.");
 	return name;
 }
+/** Create a value-only OUT parameter descriptor; the adapter supplies the native carrier. */
 function createRoutineOutParameter(name, hint) {
 	const normalizedHint = hint === void 0 ? void 0 : createParameterTypeHint(hint);
 	const parameter = Object.freeze({
@@ -776,6 +527,7 @@ function createRoutineOutParameter(name, hint) {
 	knownRoutineParameters.add(parameter);
 	return parameter;
 }
+/** Create a value-only INOUT parameter descriptor; input value and output channel stay distinct. */
 function createRoutineInOutParameter(name, value, hint) {
 	const normalizedHint = hint === void 0 ? void 0 : createParameterTypeHint(hint);
 	const parameter = Object.freeze({
@@ -788,17 +540,35 @@ function createRoutineInOutParameter(name, value, hint) {
 	knownRoutineParameters.add(parameter);
 	return parameter;
 }
+/** Recognize only routine OUT/INOUT descriptors created by SQLBraid's own constructor. */
 function isRoutineParameter(value) {
 	if (typeof value !== "object" || value === null || Array.isArray(value) || !knownRoutineParameters.has(value)) return false;
 	const candidate = value;
 	return candidate[SQL_ROUTINE_PARAMETER] === true && Object.hasOwn(candidate, "value") && (candidate.direction === "out" || candidate.direction === "inout") && typeof candidate.outputName === "string" && Boolean(candidate.outputName.trim()) && (candidate.hint === void 0 || isParameterTypeHint(candidate.hint));
 }
-/**
-* Normalize and snapshot a homogeneous bulk's logical statement and value
-* matrix. Values themselves are application-owned and are not cloned.
-*/
-function createRenderedBulk(bulk) {
-	if (bulk === null || typeof bulk !== "object" || Array.isArray(bulk)) throw new TypeError("RenderedBulk must be an object.");
+
+//#endregion
+//#region src/routine.ts
+/** Identifies which routine channel or row failed during Standard Schema mapping. */
+var RoutineMappingError = class RoutineMappingError extends Error {
+	static {
+		this.code = "BRAID_CALL_MAP";
+	}
+	constructor(message, location, options) {
+		super(message, options);
+		this.code = RoutineMappingError.code;
+		this.name = "RoutineMappingError";
+		this.location = Object.freeze(location);
+	}
+};
+
+//#endregion
+//#region src/statement.ts
+function validHintNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) && Number.isInteger(value) && value >= 0;
+}
+function createRenderedBulk(bulk) {
+	if (bulk === null || typeof bulk !== "object" || Array.isArray(bulk)) throw new TypeError("RenderedBulk must be an object.");
 	const statement = createRenderedStatement(bulk.statement);
 	if (!Array.isArray(bulk.parameterSets)) throw new TypeError("RenderedBulk parameterSets must be an array.");
 	const parameterCount = statement.parameters.length;
@@ -866,6 +636,8 @@ function copyNativeTemplate(value, segments) {
 	});
 	return Object.freeze(cooked);
 }
+/** Validate and freeze one logical statement without creating a second mutable SQL/value source of truth. */
+/** @throws {TypeError|SqlRenderError} For broken segment/parameter invariants or unsupported bind values. */
 function createRenderedStatement(statement) {
 	if (typeof statement !== "object" || statement === null) throw new TypeError("RenderedStatement must be an object.");
 	if (knownRenderedStatements.has(statement)) return statement;
@@ -900,6 +672,10 @@ function createRenderedStatement(statement) {
 	knownRenderedStatements.add(rendered);
 	return rendered;
 }
+
+//#endregion
+//#region src/binding.ts
+/** Materialize placeholder text as a derived view; this helper does not own reuse or driver transport policy. */
 function parameterizedSql(statement, placeholder) {
 	const parts = [statement.segments[0] ?? ""];
 	for (let index = 0; index < statement.parameters.length; index += 1) parts.push(placeholder(index + 1), statement.segments[index + 1] ?? "");
@@ -972,6 +748,7 @@ function literalized(statement, dialectId, formatLiteral, options) {
 		truncatedParameters
 	});
 }
+/** Build an immutable binding description before I/O, including adapter reuse policy and diagnostic literalization. */
 function createStatementBindingDescription(statement, context, options) {
 	const logical = createRenderedStatement(statement);
 	const adapterId = options.adapterId;
@@ -1071,9 +848,8 @@ function createStatementBindingDescription(statement, context, options) {
 	return Object.freeze(description);
 }
 /**
-* Build one binding description for a logical bulk statement. The statement
-* metadata is shared by every parameter set; values and diagnostics are
-* addressed only when requested for a particular item.
+* Build one binding description for a homogeneous bulk statement without cloning application-owned values.
+* Statement metadata is shared by every parameter set; values and diagnostics are addressed by item index.
 */
 function createBulkBindingDescription(bulk, context, options) {
 	const logical = createRenderedBulk(bulk);
@@ -1116,45 +892,359 @@ function createBulkBindingDescription(bulk, context, options) {
 	});
 	return Object.freeze(description);
 }
-var UnsupportedFeatureError = class extends Error {
-	constructor(feature, code, message, options) {
-		super(`${code}: ${message}`, options);
-		this.feature = feature;
-		this.code = code;
-		this.name = "UnsupportedFeatureError";
-	}
-};
-/** Return true only for a registered, semantically valid feature/code pair. */
-function isPublicUnsupportedFeatureError(error) {
-	if (!(error instanceof UnsupportedFeatureError)) return false;
-	return PUBLIC_ERROR_DEFINITIONS.find((candidate) => candidate.owner === "UnsupportedFeatureError" && candidate.code === error.code)?.features?.includes(error.feature) === true;
-}
-/** An adapter-owned input/transport failure that retains TypeError semantics. */
-var AdapterError = class extends TypeError {
-	constructor(code, message, options) {
-		super(`${code}: ${message}`, options);
-		this.code = code;
-		this.name = "AdapterError";
-	}
-};
-var RoutineMappingError = class RoutineMappingError extends Error {
-	static {
-		this.code = "BRAID_CALL_MAP";
-	}
-	constructor(message, location, options) {
-		super(message, options);
-		this.code = RoutineMappingError.code;
-		this.name = "RoutineMappingError";
-		this.location = Object.freeze(location);
+
+//#endregion
+//#region src/template-ir.ts
+const SQL_FRAGMENT = Symbol.for("sqlbraid.fragment");
+
+//#endregion
+//#region src/authoring-modules.ts
+const AUTHORING_MODULE_CATALOG = Object.freeze([
+	{
+		moduleSpecifier: "@sqlbraid/template",
+		helperFamily: "template"
+	},
+	{
+		moduleSpecifier: "@sqlbraid/postgres",
+		dialectId: "postgres",
+		helperFamily: "template"
+	},
+	{
+		moduleSpecifier: "@sqlbraid/mysql",
+		dialectId: "mysql",
+		helperFamily: "template"
+	},
+	{
+		moduleSpecifier: "@sqlbraid/mariadb",
+		dialectId: "mariadb",
+		helperFamily: "template"
+	},
+	{
+		moduleSpecifier: "@sqlbraid/sqlite",
+		dialectId: "sqlite",
+		helperFamily: "template"
+	},
+	{
+		moduleSpecifier: "@sqlbraid/oracle",
+		dialectId: "oracle",
+		helperFamily: "template"
+	},
+	{
+		moduleSpecifier: "@sqlbraid/mssql",
+		dialectId: "mssql",
+		helperFamily: "template"
+	},
+	{
+		moduleSpecifier: "sqlbraid/pg",
+		dialectId: "postgres",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/mysql2",
+		dialectId: "mysql",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/mariadb",
+		dialectId: "mariadb",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/node-sqlite",
+		dialectId: "sqlite",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/better-sqlite3",
+		dialectId: "sqlite",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/libsql",
+		dialectId: "sqlite",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/sqlite-wasm",
+		dialectId: "sqlite",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/d1",
+		dialectId: "sqlite",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/oracledb",
+		dialectId: "oracle",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/tedious",
+		dialectId: "mssql",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/postgres",
+		dialectId: "postgres",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/mysql",
+		dialectId: "mysql",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/sqlite",
+		dialectId: "sqlite",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/oracle",
+		dialectId: "oracle",
+		helperFamily: "facade"
+	},
+	{
+		moduleSpecifier: "sqlbraid/mssql",
+		dialectId: "mssql",
+		helperFamily: "facade"
 	}
-};
-var SqlRenderError = class extends Error {
-	constructor(code, message) {
-		super(message);
-		this.name = "SqlRenderError";
-		this.code = code;
+].map((entry) => Object.freeze(entry)));
+
+//#endregion
+//#region src/capabilities.ts
+const definitions = [
+	{
+		id: "sql.native-transparency",
+		family: "support"
+	},
+	{
+		id: "sql.generated-structure",
+		family: "support"
+	},
+	{
+		id: "result.rows",
+		family: "support"
+	},
+	{
+		id: "result.command",
+		family: "support"
+	},
+	{
+		id: "result.multiple-sets",
+		family: "support"
+	},
+	{
+		id: "result.standard-schema",
+		family: "support"
+	},
+	{
+		id: "numeric.exact-integer",
+		family: "representation"
+	},
+	{
+		id: "numeric.exact-decimal",
+		family: "representation"
+	},
+	{
+		id: "numeric.approximate-float",
+		family: "representation"
+	},
+	{
+		id: "numeric.approximate-special",
+		family: "representation"
+	},
+	{
+		id: "numeric.bind-exact",
+		family: "representation"
+	},
+	{
+		id: "numeric.aggregate",
+		family: "representation"
+	},
+	{
+		id: "numeric.command-metadata",
+		family: "representation"
+	},
+	{
+		id: "numeric.special-values",
+		family: "representation"
+	},
+	{
+		id: "numeric.scale-greater-than-precision",
+		family: "representation"
+	},
+	{
+		id: "numeric.negative-scale",
+		family: "representation"
+	},
+	{
+		id: "data.json-parsed",
+		family: "representation"
+	},
+	{
+		id: "data.json-lossless-text",
+		family: "representation"
+	},
+	{
+		id: "data.sql-variant",
+		family: "representation"
+	},
+	{
+		id: "data.oracle-object",
+		family: "representation"
+	},
+	{
+		id: "data.oracle-collection",
+		family: "representation"
+	},
+	{
+		id: "data.vector",
+		family: "representation"
+	},
+	{
+		id: "data.binary",
+		family: "representation"
+	},
+	{
+		id: "data.uuid",
+		family: "representation"
+	},
+	{
+		id: "data.temporal-native",
+		family: "representation"
+	},
+	{
+		id: "data.temporal-lossless",
+		family: "representation"
+	},
+	{
+		id: "data.timezone",
+		family: "representation"
+	},
+	{
+		id: "metadata.command-safe",
+		family: "metadata"
+	},
+	{
+		id: "dml.insert-returning",
+		family: "support"
+	},
+	{
+		id: "dml.update-returning",
+		family: "support"
+	},
+	{
+		id: "dml.delete-returning",
+		family: "support"
+	},
+	{
+		id: "dml.merge-returning",
+		family: "support"
+	},
+	{
+		id: "dml.upsert-returning",
+		family: "support"
+	},
+	{
+		id: "session.pinned",
+		family: "support"
+	},
+	{
+		id: "statement.prepare",
+		family: "support"
+	},
+	{
+		id: "statement.cancel",
+		family: "support"
+	},
+	{
+		id: "statement.stream",
+		family: "support"
+	},
+	{
+		id: "statement.bulk",
+		family: "support"
+	},
+	{
+		id: "execution.bulk-fidelity",
+		family: "support"
+	},
+	{
+		id: "transaction",
+		family: "support"
+	},
+	{
+		id: "transaction.savepoint",
+		family: "support"
+	},
+	{
+		id: "transaction.read-only",
+		family: "support"
+	},
+	{
+		id: "transaction.isolation.read-uncommitted",
+		family: "support"
+	},
+	{
+		id: "transaction.isolation.read-committed",
+		family: "support"
+	},
+	{
+		id: "transaction.isolation.repeatable-read",
+		family: "support"
+	},
+	{
+		id: "transaction.isolation.serializable",
+		family: "support"
+	},
+	{
+		id: "routine.call",
+		family: "support"
+	},
+	{
+		id: "routine.out",
+		family: "support"
+	},
+	{
+		id: "routine.inout",
+		family: "support"
+	},
+	{
+		id: "routine.result-sets",
+		family: "support"
+	},
+	{
+		id: "routine.out-cursor",
+		family: "support"
+	},
+	{
+		id: "routine.return-value",
+		family: "support"
+	},
+	{
+		id: "metadata.identity",
+		family: "metadata"
+	},
+	{
+		id: "metadata.generated",
+		family: "metadata"
+	},
+	{
+		id: "metadata.routines",
+		family: "metadata"
+	},
+	{
+		id: "metadata.types",
+		family: "metadata"
 	}
-};
+];
+const WELL_KNOWN_CAPABILITIES = Object.freeze(definitions.map((entry) => Object.freeze(entry)));
+const WELL_KNOWN_CAPABILITY_IDS = Object.freeze(definitions.map(({ id }) => id));
+const wellKnownCapabilityIds = new Set(WELL_KNOWN_CAPABILITY_IDS);
+function isWellKnownCapabilityId(value) {
+	return wellKnownCapabilityIds.has(value);
+}
 
 //#endregion
 export { AUTHORING_MODULE_CATALOG, AdapterError, PUBLIC_ERROR_DEFINITIONS, ResultExactnessError, RoutineMappingError, SQL_FRAGMENT, SqlRenderError, UnsupportedFeatureError, WELL_KNOWN_CAPABILITIES, WELL_KNOWN_CAPABILITY_IDS, createBoundParameter, createBulkBindingDescription, createParameterTypeHint, createRenderedBulk, createRenderedStatement, createRoutineInOutParameter, createRoutineOutParameter, createStatementBindingDescription, decodeExactDecimal, decodeExactInteger, isBoundParameter, isPublicUnsupportedFeatureError, isRoutineParameter, isWellKnownCapabilityId, normalizeExactInteger, parameterizedSql, safeDatabaseCount };