@sqlbraid/core 1.0.0-rc.1 → 1.0.2

package/dist/index.js

@@ -1,123 +1,5 @@
-//#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"
-	}
-].map((entry) => Object.freeze(entry)));
-
-//#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();
+//#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";
@@ -204,32 +86,38 @@ const PUBLIC_ERROR_DEFINITIONS = Object.freeze([
 	{
 		code: "BRAID_CALL_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["routine.call"]
 	},
 	{
 		code: "BRAID_RESULT_SETS_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["routine.result-sets"]
 	},
 	{
 		code: "BRAID_STREAM_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["statement.stream"]
 	},
 	{
 		code: "BRAID_CANCEL_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["statement.cancel"]
 	},
 	{
 		code: "BRAID_SESSION_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["session.pinned"]
 	},
 	{
 		code: "BRAID_TX_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["transaction", "transaction.savepoint"]
 	},
 	{
 		code: "BRAID_TX_OPTIONS_INVALID",
@@ -239,42 +127,61 @@ const PUBLIC_ERROR_DEFINITIONS = Object.freeze([
 	{
 		code: "BRAID_TX_OPTION_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		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"
+		owner: "UnsupportedFeatureError",
+		features: ["routine.result-sets"]
 	},
 	{
 		code: "BRAID_CALL_CURSOR_TX_REQUIRED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["routine.out-cursor"]
 	},
 	{
 		code: "BRAID_CALL_OUT_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["routine.out", "routine.inout"]
 	},
 	{
 		code: "BRAID_CALL_RETURN_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["routine.return-value"]
+	},
+	{
+		code: "BRAID_CALL_PROCEDURE_INVALID",
+		category: "adapter",
+		owner: "AdapterError"
 	},
 	{
 		code: "BRAID_CALL_CURSOR_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["routine.out-cursor"]
 	},
 	{
 		code: "BRAID_RESOURCE_CLEANUP",
 		category: "adapter",
-		owner: "adapter cleanup error with code"
+		owner: "adapter cleanup error with code",
+		features: ["resource.cleanup", "resource.discard"]
 	},
 	{
 		code: "BRAID_BIND_HINT_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["statement.bind-hint"]
 	},
 	{
 		code: "BRAID_BIND_VALUE_UNSUPPORTED",
@@ -284,27 +191,38 @@ const PUBLIC_ERROR_DEFINITIONS = Object.freeze([
 	{
 		code: "BRAID_INTEGER_MODE_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["result.exact-integer"]
 	},
 	{
 		code: "BRAID_CALL_LOB_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["routine.out"]
 	},
 	{
 		code: "BRAID_BULK_UNSUPPORTED",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["statement.bulk"]
+	},
+	{
+		code: "BRAID_PREPARE_UNSUPPORTED",
+		category: "adapter",
+		owner: "UnsupportedFeatureError",
+		features: ["statement.prepare"]
 	},
 	{
 		code: "BRAID_DIALECT_MISMATCH",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["dialect"]
 	},
 	{
 		code: "BRAID_RESULT_KIND_AMBIGUOUS",
 		category: "adapter",
-		owner: "UnsupportedFeatureError"
+		owner: "UnsupportedFeatureError",
+		features: ["result.rows", "result.command"]
 	},
 	{
 		code: "BRAID_PREPARED_NAME",
@@ -397,9 +315,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;
@@ -448,12 +404,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) {
@@ -462,14 +430,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,
@@ -479,6 +448,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({
@@ -489,6 +459,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;
@@ -498,6 +469,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({
@@ -510,6 +482,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({
@@ -522,15 +495,33 @@ 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.
-*/
+
+//#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);
@@ -600,6 +591,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;
@@ -634,6 +627,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] ?? "");
@@ -643,7 +640,10 @@ function genericLiteral(parameter, dialectId, binary) {
 	const value = parameter.value;
 	if (value === null) return "NULL";
 	if (value === void 0) return "[undefined]";
-	if (typeof value === "string") return `'${value.replaceAll("'", "''")}'`;
+	if (typeof value === "string") {
+		if (/^(?:mysql|mariadb)/i.test(dialectId)) return `[string ${JSON.stringify(value)}]`;
+		return `'${value.replaceAll("'", "''")}'`;
+	}
 	if (typeof value === "boolean") {
 		if (/^(?:mysql|sqlite)/i.test(dialectId) || /^(?:oracle|mssql|sqlserver)/i.test(dialectId)) return value ? "1" : "0";
 		if (/^(?:postgres|postgresql|cockroach|redshift)/i.test(dialectId)) return value ? "TRUE" : "FALSE";
@@ -703,6 +703,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;
@@ -802,9 +803,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);
@@ -847,41 +847,360 @@ 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";
-	}
-};
-/** 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, createBoundParameter, createBulkBindingDescription, createParameterTypeHint, createRenderedBulk, createRenderedStatement, createRoutineInOutParameter, createRoutineOutParameter, createStatementBindingDescription, decodeExactDecimal, decodeExactInteger, isBoundParameter, isRoutineParameter, normalizeExactInteger, parameterizedSql, safeDatabaseCount };
+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 };
 //# sourceMappingURL=index.js.map