@sqlbraid/core 0.1.0-rc.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":"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mBAAmB,UAAU,6BAA6B,UAAU,mBAAmB,QAAQ,qBAAqB;EACzI,OAAO,KAAK,UAAU,mBAAmB,UAAU,6BAA6B,UAAU,mBAAmB,cAAc;EAC3H,KAAK,UAAU,mBAAmB,UAAU,6BAA6B,UAAU,mBAAmB,QAAQ;EAC9G,MAAM,MAAM,cAAc,SAAS,wBAAwB,UAAU,mBAAmB,QAAQ;EAChG,OAAO,UAAU,qBAAqB;EACtC,WAAW;EACX,aAAa;EACb,WAAW,eAAe;EAC1B,YAAY,eAAe;EAC3B,kBAAkB,eAAe;;iBAGlB,wBAAwB;EACvC,QAAQ;aAAqB;aAA6B;;iBAG3C;WACN,kBAAkB;WAClB,cAAc;EACvB,WAAW,QAAQ;;iBAGJ;WACN;WACA;WACA,WAAW;WACX,OAAO;;iBAGD;WACN;WACA;WACA;WACA;WACA;WACA;WACA;aACE;aACA;aACA,YAAY;aACZ;;WAEF,2BAA2B;WAC3B,WAAW;WACX,iBAAiB,UAAU,sBAAsB;WACjD,cAAc;WACd;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA,UAAU,SAAS;WACnB;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;WACA;WACA,WAAW;WACX,iBAAiB,eAAe,UAAU,sBAAsB;;iBAG1D;WACN;WACA;WACA;WACA;WACA,eAAe;WACf;WACA;WACA;;YAGC;iBAgBK;WACN;WACA;WACA;WACA;WACA;WACA;WACA,OAAO;WACP;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;aACE;aACA;aACA,YAAY;aACZ;;WAEF,2BAA2B;WAC3B,WAAW;WACX,iBAAiB,UAAU,sBAAsB;WACjD;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;YAGC;iBAQK;WACN;WACA;WACA,OAAO;WACP;WACA;WACA;WACA;WACA;;YAGC,iBACR,kBACA,mBACA,mBACA,iBACA,kBACA,kBACA,mBACA,iBACA;iBAEa;EACf,QAAQ,OAAO,wBAAwB;;iBAGxB;WACN;WACA;WACA;WACA;;iBAGM;WACN;aAAqB;aAA0B;aAA2B;;WAC1E;aAAmB;aAAqB;aAA2B;;WACnE;aAAoB;aAAqB;;WACzC;aAAwB;aAAqB;;WAC7C,cAAc,SAAS,eAAe;WACtC;aACE;aACA;aACA;;;;iBAKI;WACN,UAAU;WACV,QAAQ;WACR;aAAwB;aAAqB;;WAC7C,cAAc;WACd;aACE,WAAW;aACX,OAAO;eACL;eACA;eACA,eAAe,SAAS,eAAe;;;;;iBAMrC;WACN;WACA;WACA;aAAqB;aAA0B;aAA0B;;WACzE;aAAmB;aAAqB;aAA0B;;WAClE;aAAoB;aAAqB;;WACzC;aAAuB;aAAqB;;WAC5C;aAAqB;;;iBAGf;WACN,mBAAmB;;WAEnB;;iBAGM;WACN,qBAAqB;WACrB,QAAQ;;YAGP,kBAAkB,kBAAkB;YAEpC,kBAAkB,OAAO,YAClC,0BAA0B,UAAU,YAAY,OAAO,OAAO,UAAU;YAE/D,cAAc,OAAO,UAAU;WAChC;KACN,UAAU,gBAAgB;EACzB,QAAQ,MAAM,kBAAkB,OAAO,oBAAoB,QAAQ;;EACnE,WAAW,MAAM,kBAAkB,OAAO,oBAAoB,QAAQ,kBAAkB;KACvF,UAAU,eAAe;EAC1B,OAAO,MAAM,kBAAkB,OAAO,qBAAqB,QAAQ,iBAAiB;EACpF,OAAO,MAAM,kBAAkB,OAAO,qBAAqB,QAAQ,QAAQ;EAC3E,YAAY,MAAM,kBAAkB,OAAO,qBAAqB,QAAQ,QAAQ;EAChF,UAAU,MAAM,kBAAkB,OAAO,cAAc,QAAQ,cAAc;;YAGvE,kBACR,oBACA,4BACA;YAEQ,kBAAkB,KAC5B,UAAU,eAAe,OACrB,oBAAoB,OACpB,UAAU,4BACR,yBACA,UAAU,YAAY,kBACpB,qBAAqB;iBAGd;EACf,YAAY,UAAU,qBAAqB,QAAQ;EACnD,IAAI,KAAK,OAAO,SAAS,MAAM,UAAU,qBAAqB,OAAO,iBAAiB;EACtF,IAAI,KAAK,OAAO,SAAS,MAAM,UAAU,qBAAqB,OAAO,QAAQ;EAC7E,SAAS,KAAK,OAAO,SAAS,MAAM,UAAU,qBAAqB,OAAO,QAAQ;EAClF,QAAQ,UAAU,iBAAiB,OAAO,GAAG,UAAU,mBAAmB,QAAQ,kBAAkB;EACpG,KAAK,eAAe,mBAAmB,OAAO,UAAU,SAAS,UAAU,mBAAmB,QAAQ;EACtG,YAAY,yBAAyB,mBAAmB,SAAS,SAAS,UAAU,mBAAmB,oBAAoB,WAAW,UAAU,kBAAkB,QAAQ;EAC1K,KAAK,OAAO,iBAAiB,SAAS,UAAU,OAAO,OAAO,kBAAkB,cAAc,UAAU,mBAAmB,QAAQ;EACnI,QAAQ,sBAAsB,iBAC5B,cACA,SAAS,WAAW,WAAW,yCAC9B,qBAAqB,WAAW;EACnC,QAAQ,iBAAiB,iBAAiB,iBACxC,cACA,SAAS,WAAW,WAAW,gDAC9B,cAAc,WAAW,aAAa,WAAW;EACpD,OAAO,KAAK,OAAO,SAAS,MAAM,UAAU,cAAc,OAAO,cAAc;EAC/E,QAAQ,GAAG,WAAW,UAAU,aAAa,QAAQ,KAAK,QAAQ;EAClE,GAAG,GAAG,WAAW,UAAU,aAAa,QAAQ,KAAK,QAAQ;EAC7D,GAAG,GAAG,SAAS,oBAAoB,WAAW,UAAU,aAAa,QAAQ,KAAK,QAAQ;;iBAG3E;WACN;WACA;;YAGC,SAAS,KAAK,UAAU,YAAY,KAAK,mBAAmB;iBAEvD,WAAW,aAAa,kBAAkB,iBAAiB;GACzE,SAAS,yBAAyB,6BAA6B,MAAM,KAAK;;iBAG5D,mBAAmB,iBAAiB;GAClD,SAAS,yBAAyB,6BAA6B,UAAU,0BAA0B;;iBAGrF;GAEd,OAAO,QAAQ,QAAQ,mBAAiB,OAAO,UAAU,mBAAmB;GAC5E,eAAe,SAAS,yBAAyB,6BAA6B,SAAS;;iBAGzE,eAAe;EAC9B,MAAM;EACN,UAAU,SAAS,yBAAyB,+BAA+B;EAC3E;KACG,eAAe,oBAAoB,mBAAmB,SAAS,yBAAyB,6BAA6B,UAAU;KAC/H,iBAAiB,iBAAiB,UAAU,WAAW,mBAAmB;;EAE7E,KAAK,OAAO,OAAO,QAAQ,QAAQ,MAAM,kBAAkB,SAAS,eAAe;EACnF,IAAI,cAAc,OAAO,oBAAoB;EAC7C,MAAM,OAAO,cAAc,OAAO,QAAQ,QAAQ,OAAO,kBAAkB,SAAS,iBAAiB;EACrG,WAAW,SAAS,yBAAyB,+BAA+B;EAC5E,OAAO;EACP,QAAQ,2CAA2C;EACnD,MAAM,iBAAiB;EACvB,OAAO,gBAAgB,eAAe,YAAY,gBAAgB;EAClE,OAAO,+BAA+B;;qBAG3B,uBAAuB;WACzB;EAEG,YAAA,cAAc"}

package/dist/index.js

@@ -0,0 +1,475 @@
+//#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 extends Error {
+	code = "BRAID_RESULT_EXACTNESS";
+	constructor(message = "Result value does not have an exact representation.") {
+		super(message);
+		this.name = "ResultExactnessError";
+	}
+};
+function exactnessFailure(message) {
+	throw new ResultExactnessError(message);
+}
+function decodeExactInteger(value, range) {
+	let result;
+	if (typeof value === "bigint") result = value;
+	else if (typeof value === "string" && /^[+-]?\d+$/u.test(value)) try {
+		result = BigInt(value);
+	} catch {
+		return exactnessFailure("Result value does not have an exact integer representation.");
+	}
+	else if (typeof value === "number" && Number.isSafeInteger(value)) result = BigInt(value);
+	else return exactnessFailure("Result value does not have an exact integer representation.");
+	if (range !== void 0) {
+		if (range.min !== void 0 && typeof range.min !== "bigint" || range.max !== void 0 && typeof range.max !== "bigint" || range.min !== void 0 && range.max !== void 0 && range.min > range.max) throw new TypeError("Exact integer range bounds must be ordered bigint values.");
+		if (range.min !== void 0 && result < range.min) return exactnessFailure("Result exact integer is below the configured minimum.");
+		if (range.max !== void 0 && result > range.max) return exactnessFailure("Result exact integer is above the configured maximum.");
+	}
+	return result;
+}
+/**
+* Normalize an exact integer at the raw SQLBraid boundary without changing
+* its textual spelling. This is intentionally not a bigint decoder: callers
+* that need arithmetic may opt in to decodeExactInteger().
+*/
+function normalizeExactInteger(value) {
+	if (typeof value === "string" && /^[+-]?\d+$/u.test(value)) return value;
+	if (typeof value === "bigint") return value.toString(10);
+	if (typeof value === "number" && Number.isSafeInteger(value)) return String(value);
+	return exactnessFailure("Result value does not have an exact integer representation.");
+}
+/**
+* Convert a database-reported count to a safe operational Number. Counts are
+* not application values, so unlike exact SQL numerics they remain numbers,
+* but narrowing an unsafe value is never implicit.
+*/
+function safeDatabaseCount(value) {
+	if (typeof value === "number") {
+		if (Number.isSafeInteger(value) && value >= 0) return value === 0 ? 0 : value;
+		return exactnessFailure("Database count is not a safe non-negative integer.");
+	}
+	if (typeof value === "bigint") {
+		if (value < 0n || value > BigInt(Number.MAX_SAFE_INTEGER)) return exactnessFailure("Database count is not a safe non-negative integer.");
+		return Number(value);
+	}
+	if (typeof value === "string" && /^[+]?\d+$/u.test(value)) try {
+		const count = BigInt(value);
+		if (count >= 0n && count <= BigInt(Number.MAX_SAFE_INTEGER)) return Number(count);
+	} catch {}
+	return exactnessFailure("Database count is not a safe non-negative integer.");
+}
+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) {
+	return typeof value === "number" && Number.isFinite(value) && Number.isInteger(value) && value >= 0;
+}
+function validHintInteger(value) {
+	return typeof value === "number" && Number.isFinite(value) && Number.isInteger(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));
+}
+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.scale !== void 0 && !validHintInteger(candidate.scale)) throw new TypeError("sql.bind hint scale must be an integer.");
+	const normalized = {
+		databaseType: candidate.databaseType,
+		...candidate.length === void 0 ? {} : { length: candidate.length },
+		...candidate.precision === void 0 ? {} : { precision: candidate.precision },
+		...candidate.scale === void 0 ? {} : { scale: candidate.scale }
+	};
+	return Object.freeze(normalized);
+}
+function createBoundParameter(value, hint) {
+	const normalizedHint = createParameterTypeHint(hint);
+	const bound = Object.freeze({
+		value,
+		hint: normalizedHint,
+		[SQL_BOUND_PARAMETER]: true
+	});
+	knownBoundParameters.add(bound);
+	return bound;
+}
+function isBoundParameter(value) {
+	if (typeof value !== "object" || value === null || !knownBoundParameters.has(value) || !Object.hasOwn(value, SQL_BOUND_PARAMETER)) return false;
+	const candidate = value;
+	return candidate[SQL_BOUND_PARAMETER] === true && Object.hasOwn(candidate, "value") && isParameterTypeHint(candidate.hint);
+}
+function normalizeOutputName(name) {
+	if (typeof name !== "string" || !name.trim()) throw new TypeError("Routine outputName must be a non-empty string.");
+	return name;
+}
+function createRoutineOutParameter(name, hint) {
+	const normalizedHint = hint === void 0 ? void 0 : createParameterTypeHint(hint);
+	const parameter = Object.freeze({
+		value: null,
+		direction: "out",
+		outputName: normalizeOutputName(name),
+		...normalizedHint === void 0 ? {} : { hint: normalizedHint },
+		[SQL_ROUTINE_PARAMETER]: true
+	});
+	knownRoutineParameters.add(parameter);
+	return parameter;
+}
+function createRoutineInOutParameter(name, value, hint) {
+	const normalizedHint = hint === void 0 ? void 0 : createParameterTypeHint(hint);
+	const parameter = Object.freeze({
+		value,
+		direction: "inout",
+		outputName: normalizeOutputName(name),
+		...normalizedHint === void 0 ? {} : { hint: normalizedHint },
+		[SQL_ROUTINE_PARAMETER]: true
+	});
+	knownRoutineParameters.add(parameter);
+	return parameter;
+}
+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.");
+	const statement = createRenderedStatement(bulk.statement);
+	if (!Array.isArray(bulk.parameterSets)) throw new TypeError("RenderedBulk parameterSets must be an array.");
+	const parameterCount = statement.parameters.length;
+	const parameterSets = Object.freeze(bulk.parameterSets.map((values) => {
+		if (!Array.isArray(values) || values.length !== parameterCount) throw new TypeError("RenderedBulk parameter sets must match the rendered parameter count.");
+		for (let index = 0; index < values.length; index += 1) if (values[index] === void 0 && statement.parameters[index]?.direction !== "out") throw new SqlRenderError("BRAID_BIND_VALUE_UNSUPPORTED", "Undefined bind values are unsupported; use null for SQL NULL.");
+		return Object.isFrozen(values) ? values : Object.freeze([...values]);
+	}));
+	return Object.freeze({
+		statement,
+		parameterSets
+	});
+}
+const knownRenderedStatements = /* @__PURE__ */ new WeakSet();
+function copyRenderedParameter(parameter) {
+	if (typeof parameter !== "object" || parameter === null || Array.isArray(parameter)) throw new TypeError("RenderedStatement parameters must be parameter records.");
+	const candidate = parameter;
+	if (!Object.hasOwn(candidate, "value")) throw new TypeError("RenderedStatement parameters must contain a value.");
+	const interpolation = candidate.interpolation;
+	if (interpolation !== void 0 && !validHintNumber(interpolation)) throw new TypeError("RenderedStatement parameter interpolation must be a non-negative integer.");
+	const hint = candidate.hint === void 0 ? void 0 : createParameterTypeHint(candidate.hint);
+	const direction = candidate.direction;
+	if (direction !== void 0 && direction !== "in" && direction !== "out" && direction !== "inout") throw new TypeError("RenderedStatement parameter direction is unsupported.");
+	const outputName = candidate.outputName;
+	if (outputName !== void 0 && (typeof outputName !== "string" || !outputName.trim())) throw new TypeError("RenderedStatement parameter outputName must be a non-empty string.");
+	if ((direction === "out" || direction === "inout") && outputName === void 0) throw new TypeError("RenderedStatement OUT and INOUT parameters require an outputName.");
+	if (outputName !== void 0 && (direction === void 0 || direction === "in")) throw new TypeError("RenderedStatement parameter outputName requires an OUT or INOUT direction.");
+	if (candidate.value === void 0 && direction !== "out") throw new SqlRenderError("BRAID_BIND_VALUE_UNSUPPORTED", "Undefined bind values are unsupported; use null for SQL NULL.");
+	return Object.freeze({
+		value: candidate.value,
+		...interpolation === void 0 ? {} : { interpolation },
+		...hint === void 0 ? {} : { hint },
+		...direction === void 0 ? {} : { direction },
+		...outputName === void 0 ? {} : { outputName }
+	});
+}
+function copyRoutineProcedure(procedure) {
+	if (procedure === void 0) return void 0;
+	if (typeof procedure !== "object" || procedure === null || typeof procedure.name !== "string" || !procedure.name.trim()) throw new TypeError("Routine procedure name must be a non-empty string.");
+	if (!Array.isArray(procedure.parameterNames)) throw new TypeError("Routine procedure parameterNames must be an array.");
+	const parameterNames = procedure.parameterNames.map((name) => {
+		if (typeof name !== "string" || !name.trim()) throw new TypeError("Routine procedure parameterNames must contain non-empty strings.");
+		return name;
+	});
+	if (new Set(parameterNames).size !== parameterNames.length) throw new TypeError("Routine procedure parameterNames must be unique.");
+	return Object.freeze({
+		name: procedure.name,
+		parameterNames: Object.freeze(parameterNames)
+	});
+}
+function createRenderedStatement(statement) {
+	if (typeof statement !== "object" || statement === null) throw new TypeError("RenderedStatement must be an object.");
+	if (knownRenderedStatements.has(statement)) return statement;
+	if (!Array.isArray(statement.segments)) throw new TypeError("RenderedStatement segments must be an array of strings.");
+	if (!Array.isArray(statement.parameters)) throw new TypeError("RenderedStatement parameters must be an array.");
+	if (statement.segments.length !== statement.parameters.length + 1) throw new TypeError("RenderedStatement invariant violated: segments.length must equal parameters.length + 1.");
+	if (statement.resultKind !== "call" && statement.routineProcedure !== void 0) throw new TypeError("Routine procedure metadata is only valid for call statements.");
+	if (typeof statement.dialectId !== "string" || !statement.dialectId) throw new TypeError("RenderedStatement dialectId must be a non-empty string.");
+	const segments = Object.freeze([...statement.segments]);
+	if (segments.some((segment) => typeof segment !== "string")) throw new TypeError("RenderedStatement segments must be an array of strings.");
+	const parameters = Object.freeze(Array.from(statement.parameters, copyRenderedParameter));
+	if (parameters.some((parameter) => parameter.direction === "inout" && statement.resultKind !== "call")) throw new TypeError("INOUT parameters are only valid for call statements.");
+	if (parameters.some((parameter) => parameter.direction === "out" && statement.resultKind !== "call" && statement.resultKind !== "rows")) throw new TypeError("OUT parameters are only valid for call and rows statements.");
+	const outputNames = /* @__PURE__ */ new Set();
+	for (const parameter of parameters) if (parameter.outputName !== void 0) {
+		if (outputNames.has(parameter.outputName)) throw new TypeError(`Duplicate routine outputName: ${parameter.outputName}`);
+		outputNames.add(parameter.outputName);
+	}
+	const routineProcedure = copyRoutineProcedure(statement.routineProcedure);
+	if (routineProcedure !== void 0 && routineProcedure.parameterNames.length !== parameters.length) throw new TypeError("Routine procedure parameterNames must match the rendered parameter count.");
+	const rendered = Object.freeze({
+		segments,
+		parameters,
+		dialectId: statement.dialectId,
+		resultKind: statement.resultKind,
+		...routineProcedure === void 0 ? {} : { routineProcedure },
+		...statement.fingerprint === void 0 ? {} : { fingerprint: statement.fingerprint },
+		...statement.variantFingerprint === void 0 ? {} : { variantFingerprint: statement.variantFingerprint }
+	});
+	knownRenderedStatements.add(rendered);
+	return rendered;
+}
+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] ?? "");
+	return parts.join("");
+}
+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 === "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";
+		return `[boolean ${value ? "true" : "false"}]`;
+	}
+	if (typeof value === "number") return Number.isFinite(value) ? String(value) : `[unsupported ${String(value)}]`;
+	if (typeof value === "bigint") return value.toString();
+	if (value instanceof Date) try {
+		const timestamp = Date.prototype.getTime.call(value);
+		return Number.isNaN(timestamp) ? "[unsupported date]" : `[date ${Date.prototype.toISOString.call(value)}]`;
+	} catch {
+		return "[unsupported date]";
+	}
+	if (value instanceof Uint8Array) try {
+		if (binary === "full") {
+			let hex = "";
+			for (const byte of value) hex += byte.toString(16).padStart(2, "0");
+			return `X'${hex}'`;
+		}
+		return `[binary ${value.byteLength} bytes]`;
+	} catch {
+		return "[unsupported binary]";
+	}
+	if (typeof value === "object") return "[unsupported object]";
+	return `[unsupported ${typeof value}]`;
+}
+function literalized(statement, dialectId, formatLiteral, options) {
+	const resolved = options ?? {};
+	const valuesMode = resolved.values ?? "redacted";
+	const maxLength = resolved.maxValueLength;
+	if (valuesMode !== "inline" && valuesMode !== "redacted") throw new TypeError("literalizedSql values must be \"inline\" or \"redacted\".");
+	if (maxLength !== void 0 && (!Number.isSafeInteger(maxLength) || maxLength < 0)) throw new TypeError("literalizedSql maxValueLength must be a non-negative integer.");
+	const binary = resolved.binary ?? "summary";
+	if (binary !== "summary" && binary !== "full") throw new TypeError("literalizedSql binary must be \"summary\" or \"full\".");
+	if (resolved.redact !== void 0 && typeof resolved.redact !== "function") throw new TypeError("literalizedSql redact must be a function.");
+	const parts = [statement.segments[0] ?? ""];
+	let redactedParameters = 0;
+	let truncatedParameters = 0;
+	for (let index = 0; index < statement.parameters.length; index += 1) {
+		const parameter = statement.parameters[index];
+		const redact = valuesMode === "redacted" || resolved.redact?.(parameter, index) === true;
+		let valueText;
+		if (redact) {
+			valueText = "[REDACTED]";
+			redactedParameters += 1;
+		} else valueText = formatLiteral?.(parameter, index, resolved) ?? genericLiteral(parameter, dialectId, binary);
+		if (maxLength !== void 0 && valueText.length > maxLength) {
+			valueText = maxLength === 0 ? "" : valueText.slice(0, maxLength);
+			truncatedParameters += 1;
+		}
+		parts.push(valueText, statement.segments[index + 1] ?? "");
+	}
+	return Object.freeze({
+		text: parts.join(""),
+		complete: truncatedParameters === 0,
+		redactedParameters,
+		truncatedParameters
+	});
+}
+function createStatementBindingDescription(statement, context, options) {
+	const logical = createRenderedStatement(statement);
+	const adapterId = options.adapterId;
+	const transport = options.transport;
+	const placeholder = options.placeholder;
+	const formatLiteral = options.formatLiteral;
+	const effective = options.reuse.effective;
+	const owner = options.reuse.owner;
+	const capacity = options.reuse.capacity;
+	const dialectId = context.dialectId;
+	const requestedReuse = context.requestedReuse;
+	if (logical.dialectId !== dialectId) throw new TypeError(`BRAID_DIALECT: statement binding dialect ${dialectId} does not match rendered statement dialect ${logical.dialectId}.`);
+	if (typeof adapterId !== "string" || !adapterId) throw new TypeError("Statement binding adapterId must be a non-empty string.");
+	if (typeof dialectId !== "string" || !dialectId) throw new TypeError("Statement binding dialectId must be a non-empty string.");
+	if (![
+		"native-value-template",
+		"text-positional",
+		"text-named",
+		"typed-request"
+	].includes(transport)) throw new TypeError("Statement binding transport is unsupported.");
+	if (transport !== "native-value-template" && placeholder === void 0) throw new TypeError("Text and typed statement transports require a placeholder function.");
+	if (![
+		"auto",
+		"simple",
+		"reuse"
+	].includes(requestedReuse)) throw new TypeError("Statement binding requestedReuse is unsupported.");
+	if (!["simple", "reuse"].includes(effective) || ![
+		"sqlbraid",
+		"driver",
+		"server"
+	].includes(owner)) throw new TypeError("Statement binding reuse policy is unsupported.");
+	if (capacity !== void 0 && (!Number.isSafeInteger(capacity) || capacity < 0)) throw new TypeError("Statement binding reuse capacity must be a non-negative safe integer.");
+	if (placeholder !== void 0 && typeof placeholder !== "function") throw new TypeError("Statement binding placeholder must be a function.");
+	const bindings = Object.freeze(logical.parameters.map((parameter, offset) => Object.freeze({
+		index: offset + 1,
+		...parameter.outputName === void 0 ? {} : {
+			name: parameter.outputName,
+			outputName: parameter.outputName
+		},
+		...parameter.interpolation === void 0 ? {} : { interpolation: parameter.interpolation },
+		...parameter.hint === void 0 ? {} : { hint: createParameterTypeHint(parameter.hint) },
+		...parameter.direction === void 0 ? {} : { direction: parameter.direction }
+	})));
+	const reuse = Object.freeze({
+		requested: requestedReuse,
+		effective,
+		owner,
+		...capacity === void 0 ? {} : { capacity }
+	});
+	let parameterizedReady = false;
+	let parameterized;
+	const literalCache = /* @__PURE__ */ new Map();
+	let defaultLiteralized;
+	const description = {
+		adapterId,
+		dialectId,
+		transport,
+		bindings,
+		reuse,
+		literalizedSql: (literalOptions) => {
+			if (literalOptions === void 0) {
+				if (defaultLiteralized === void 0) defaultLiteralized = literalized(logical, dialectId, formatLiteral, void 0);
+				return defaultLiteralized;
+			}
+			if (typeof literalOptions !== "object" || literalOptions === null) throw new TypeError("literalizedSql options must be an object.");
+			const values = literalOptions.values;
+			const binary = literalOptions.binary;
+			const maxValueLength = literalOptions.maxValueLength;
+			const redact = literalOptions.redact;
+			const snapshot = Object.freeze({
+				...values === void 0 ? {} : { values },
+				...binary === void 0 ? {} : { binary },
+				...maxValueLength === void 0 ? {} : { maxValueLength },
+				...redact === void 0 ? {} : { redact }
+			});
+			const cacheKey = redact === void 0 ? `${values ?? ""}\u0000${binary ?? ""}\u0000${maxValueLength ?? ""}` : void 0;
+			if (cacheKey !== void 0) {
+				const cached = literalCache.get(cacheKey);
+				if (cached) return cached;
+			}
+			const result = literalized(logical, dialectId, formatLiteral, snapshot);
+			if (cacheKey !== void 0) literalCache.set(cacheKey, result);
+			return result;
+		}
+	};
+	if (placeholder !== void 0) Object.defineProperty(description, "parameterizedSql", {
+		enumerable: true,
+		configurable: false,
+		get: () => {
+			if (!parameterizedReady) {
+				parameterized = parameterizedSql(logical, placeholder);
+				parameterizedReady = true;
+			}
+			return parameterized;
+		}
+	});
+	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.
+*/
+function createBulkBindingDescription(bulk, context, options) {
+	const logical = createRenderedBulk(bulk);
+	const statementBinding = createStatementBindingDescription(logical.statement, context, options);
+	const parameterSets = logical.parameterSets;
+	const itemCount = parameterSets.length;
+	const valuesAt = (index) => {
+		if (!Number.isSafeInteger(index) || index < 0 || index >= itemCount) throw new RangeError(`Bulk item index ${String(index)} is outside [0, ${itemCount}).`);
+		return parameterSets[index];
+	};
+	const literalizedSqlFor = (index, literalOptions) => {
+		const values = valuesAt(index);
+		const optionsSnapshot = literalOptions === void 0 ? void 0 : {
+			...literalOptions.values === void 0 ? {} : { values: literalOptions.values },
+			...literalOptions.binary === void 0 ? {} : { binary: literalOptions.binary },
+			...literalOptions.maxValueLength === void 0 ? {} : { maxValueLength: literalOptions.maxValueLength },
+			...literalOptions.redact === void 0 ? {} : { redact: literalOptions.redact }
+		};
+		return createStatementBindingDescription({
+			...logical.statement,
+			parameters: logical.statement.parameters.map((parameter, parameterIndex) => ({
+				...parameter,
+				value: values[parameterIndex]
+			}))
+		}, context, options).literalizedSql(optionsSnapshot);
+	};
+	const description = {
+		adapterId: statementBinding.adapterId,
+		dialectId: statementBinding.dialectId,
+		transport: statementBinding.transport,
+		bindings: statementBinding.bindings,
+		itemCount,
+		valuesAt,
+		literalizedSql: literalizedSqlFor
+	};
+	if ("parameterizedSql" in statementBinding) Object.defineProperty(description, "parameterizedSql", {
+		enumerable: true,
+		configurable: false,
+		get: () => statementBinding.parameterizedSql
+	});
+	return Object.freeze(description);
+}
+var UnsupportedFeatureError = class extends Error {
+	feature;
+	code;
+	constructor(feature, code, message, options) {
+		super(`${code}: ${message}`, options);
+		this.feature = feature;
+		this.code = code;
+		this.name = "UnsupportedFeatureError";
+	}
+};
+var RoutineMappingError = class extends Error {
+	code = "BRAID_CALL_MAP";
+	location;
+	constructor(message, location, options) {
+		super(message, options);
+		this.name = "RoutineMappingError";
+		this.location = Object.freeze(location);
+	}
+};
+var SqlRenderError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "SqlRenderError";
+		this.code = code;
+	}
+};
+
+//#endregion
+export { ResultExactnessError, RoutineMappingError, SQL_FRAGMENT, SqlRenderError, UnsupportedFeatureError, createBoundParameter, createBulkBindingDescription, createParameterTypeHint, createRenderedBulk, createRenderedStatement, createRoutineInOutParameter, createRoutineOutParameter, createStatementBindingDescription, decodeExactDecimal, decodeExactInteger, isBoundParameter, isRoutineParameter, normalizeExactInteger, parameterizedSql, safeDatabaseCount };
+//# sourceMappingURL=index.js.map