@sqlbraid/core 0.1.0-rc.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\nexport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\nexport const SQL_FRAGMENT = Symbol.for(\"sqlbraid.fragment\");\n\nconst SQL_BOUND_PARAMETER = Symbol.for(\"sqlbraid.bound-parameter\");\nconst knownBoundParameters = new WeakSet<object>();\ndeclare const boundParameterBrand: unique symbol;\nconst SQL_ROUTINE_PARAMETER = Symbol.for(\"sqlbraid.routine-parameter\");\nconst knownRoutineParameters = new WeakSet<object>();\n\nexport interface SourceRange {\n  readonly start: number;\n  readonly end: number;\n}\n\nexport interface RenderLimits {\n  readonly maxSqlBytes?: number;\n  readonly maxBindCount?: number;\n  readonly maxStructuralItems?: number;\n  readonly maxNestingDepth?: number;\n}\n\nexport type QueryResultKind = \"rows\" | \"command\" | \"call\" | \"unknown\";\n\nexport type NumericSemantics =\n  | \"exact-integer\"\n  | \"exact-decimal\"\n  | \"approximate-binary\";\n\nexport type NumericRepresentation = \"string\" | \"number\";\n\nexport type TransportFidelity =\n  | \"lossless\"\n  | \"guarded\"\n  | \"lossy\"\n  | \"unsupported\";\n\nexport interface NumericTypeContract {\n  readonly semantics: NumericSemantics;\n  readonly representation: NumericRepresentation;\n  readonly fidelity: TransportFidelity;\n  readonly binaryPrecision?: 32 | 64;\n}\n\nexport interface ExactIntegerRange {\n  readonly min?: bigint;\n  readonly max?: bigint;\n}\n\nexport class ResultExactnessError extends Error {\n  readonly code = \"BRAID_RESULT_EXACTNESS\";\n\n  constructor(message = \"Result value does not have an exact representation.\") {\n    super(message);\n    this.name = \"ResultExactnessError\";\n  }\n}\n\nfunction exactnessFailure(message: string): never {\n  throw new ResultExactnessError(message);\n}\n\nexport function decodeExactInteger(value: unknown, range?: ExactIntegerRange): bigint {\n  let result: bigint;\n  if (typeof value === \"bigint\") {\n    result = value;\n  } else if (typeof value === \"string\" && /^[+-]?\\d+$/u.test(value)) {\n    try {\n      result = BigInt(value);\n    } catch {\n      return exactnessFailure(\"Result value does not have an exact integer representation.\");\n    }\n  } else if (typeof value === \"number\" && Number.isSafeInteger(value)) {\n    result = BigInt(value);\n  } else {\n    return exactnessFailure(\"Result value does not have an exact integer representation.\");\n  }\n\n  if (range !== undefined) {\n    if (\n      (range.min !== undefined && typeof range.min !== \"bigint\")\n      || (range.max !== undefined && typeof range.max !== \"bigint\")\n      || (range.min !== undefined && range.max !== undefined && range.min > range.max)\n    ) {\n      throw new TypeError(\"Exact integer range bounds must be ordered bigint values.\");\n    }\n    if (range.min !== undefined && result < range.min) {\n      return exactnessFailure(\"Result exact integer is below the configured minimum.\");\n    }\n    if (range.max !== undefined && result > range.max) {\n      return exactnessFailure(\"Result exact integer is above the configured maximum.\");\n    }\n  }\n  return result;\n}\n\n/**\n * Normalize an exact integer at the raw SQLBraid boundary without changing\n * its textual spelling. This is intentionally not a bigint decoder: callers\n * that need arithmetic may opt in to decodeExactInteger().\n */\nexport function normalizeExactInteger(value: unknown): string {\n  if (typeof value === \"string\" && /^[+-]?\\d+$/u.test(value)) return value;\n  if (typeof value === \"bigint\") return value.toString(10);\n  if (typeof value === \"number\" && Number.isSafeInteger(value)) return String(value);\n  return exactnessFailure(\"Result value does not have an exact integer representation.\");\n}\n\n/**\n * Convert a database-reported count to a safe operational Number. Counts are\n * not application values, so unlike exact SQL numerics they remain numbers,\n * but narrowing an unsafe value is never implicit.\n */\nexport function safeDatabaseCount(value: unknown): number {\n  if (typeof value === \"number\") {\n    if (Number.isSafeInteger(value) && value >= 0) return value === 0 ? 0 : value;\n    return exactnessFailure(\"Database count is not a safe non-negative integer.\");\n  }\n  if (typeof value === \"bigint\") {\n    if (value < 0n || value > BigInt(Number.MAX_SAFE_INTEGER)) {\n      return exactnessFailure(\"Database count is not a safe non-negative integer.\");\n    }\n    return Number(value);\n  }\n  if (typeof value === \"string\" && /^[+]?\\d+$/u.test(value)) {\n    try {\n      const count = BigInt(value);\n      if (count >= 0n && count <= BigInt(Number.MAX_SAFE_INTEGER)) return Number(count);\n    } catch {\n      // Fall through to the common exactness error.\n    }\n  }\n  return exactnessFailure(\"Database count is not a safe non-negative integer.\");\n}\n\nexport function decodeExactDecimal(value: unknown, options?: { readonly allowBigInt?: boolean }): string {\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"bigint\" && options?.allowBigInt === true) return value.toString();\n  return exactnessFailure(\"Result value does not have an exact decimal representation.\");\n}\n\nexport type RoutineParameterDirection = \"in\" | \"out\" | \"inout\";\n\nexport interface RoutineProcedure {\n  readonly name: string;\n  readonly parameterNames: readonly string[];\n}\n\nexport type RoutineSchema = StandardSchemaV1<any, any>;\n\nexport interface RoutineContract<\n  Output extends Readonly<Record<string, unknown>> = Readonly<Record<string, unknown>>,\n  Sets extends readonly RoutineSchema[] = readonly RoutineSchema[],\n  ReturnValue = unknown,\n> {\n  readonly output?: StandardSchemaV1<any, Output>;\n  readonly resultSets?: Sets;\n  readonly returnValue?: StandardSchemaV1<any, ReturnValue>;\n  readonly procedure?: RoutineProcedure;\n}\n\n/**\n * A rendered parameter is always a value. Adapters MUST NOT interpret it as\n * raw SQL, an identifier, a nested query, a driver-specific fragment, or a\n * structural tagged-template command.\n */\nexport interface RenderedParameter {\n  readonly value: unknown;\n  readonly interpolation?: number;\n  readonly hint?: ParameterTypeHint;\n  readonly direction?: RoutineParameterDirection;\n  readonly outputName?: string;\n}\n\nexport interface RenderedStatement {\n  readonly segments: readonly string[];\n  readonly parameters: readonly RenderedParameter[];\n  readonly dialectId: string;\n  readonly resultKind: QueryResultKind;\n  readonly routineProcedure?: RoutineProcedure;\n  readonly fingerprint?: string;\n  readonly variantFingerprint?: string;\n}\n\nexport interface ParameterTypeHint<Input = unknown> {\n  readonly databaseType: string;\n  readonly length?: number | \"max\";\n  readonly precision?: number;\n  readonly scale?: number;\n  readonly __input?: Input;\n}\n\nexport interface BoundParameter<Input = unknown> {\n  readonly value: Input;\n  readonly hint: ParameterTypeHint<Input>;\n  readonly [boundParameterBrand]: true;\n}\n\nexport interface RoutineParameter<Input = unknown> {\n  readonly value: Input;\n  readonly hint?: ParameterTypeHint;\n  readonly direction: Exclude<RoutineParameterDirection, \"in\">;\n  readonly outputName: string;\n}\n\nfunction validHintNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value) && Number.isInteger(value) && value >= 0;\n}\n\nfunction validHintInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value) && Number.isInteger(value);\n}\n\nfunction isParameterTypeHint(value: unknown): value is ParameterTypeHint {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return false;\n  const candidate = value as { readonly databaseType?: unknown; readonly length?: unknown; readonly precision?: unknown; readonly scale?: unknown };\n  return typeof candidate.databaseType === \"string\"\n    && candidate.databaseType.trim().length > 0\n    && (candidate.length === undefined || candidate.length === \"max\" || validHintNumber(candidate.length))\n    && (candidate.precision === undefined || validHintNumber(candidate.precision))\n    && (candidate.scale === undefined || validHintInteger(candidate.scale));\n}\n\nexport function createParameterTypeHint<Input = unknown>(hint: ParameterTypeHint<Input>): ParameterTypeHint<Input> {\n  if (!isParameterTypeHint(hint)) throw new TypeError(\"sql.bind hint must be an object with valid structural fields.\");\n  const candidate = hint as { readonly databaseType?: unknown; readonly length?: unknown; readonly precision?: unknown; readonly scale?: unknown };\n  if (typeof candidate.databaseType !== \"string\" || !candidate.databaseType.trim()) throw new TypeError(\"sql.bind hint databaseType must be a non-empty string.\");\n  if (candidate.length !== undefined && candidate.length !== \"max\" && !validHintNumber(candidate.length)) throw new TypeError(\"sql.bind hint length must be a non-negative integer or \\\"max\\\".\");\n  if (candidate.precision !== undefined && !validHintNumber(candidate.precision)) throw new TypeError(\"sql.bind hint precision must be a non-negative integer.\");\n  if (candidate.scale !== undefined && !validHintInteger(candidate.scale)) throw new TypeError(\"sql.bind hint scale must be an integer.\");\n  const normalized = {\n    databaseType: candidate.databaseType,\n    ...(candidate.length === undefined ? {} : { length: candidate.length }),\n    ...(candidate.precision === undefined ? {} : { precision: candidate.precision }),\n    ...(candidate.scale === undefined ? {} : { scale: candidate.scale }),\n  } as ParameterTypeHint<Input>;\n  return Object.freeze(normalized);\n}\n\nexport function createBoundParameter<Input>(\n  value: NoInfer<Input>,\n  hint: ParameterTypeHint<Input>,\n): BoundParameter<Input> {\n  const normalizedHint = createParameterTypeHint(hint);\n  const bound = Object.freeze({ value, hint: normalizedHint, [SQL_BOUND_PARAMETER]: true });\n  knownBoundParameters.add(bound);\n  return bound as unknown as BoundParameter<Input>;\n}\n\nexport function isBoundParameter(value: unknown): value is BoundParameter {\n  if (typeof value !== \"object\" || value === null || !knownBoundParameters.has(value) || !Object.hasOwn(value, SQL_BOUND_PARAMETER)) return false;\n  const candidate = value as { readonly value?: unknown; readonly hint?: unknown; readonly [SQL_BOUND_PARAMETER]?: unknown };\n  return candidate[SQL_BOUND_PARAMETER] === true\n    && Object.hasOwn(candidate, \"value\")\n    && isParameterTypeHint(candidate.hint);\n}\n\nfunction normalizeOutputName(name: unknown): string {\n  if (typeof name !== \"string\" || !name.trim()) throw new TypeError(\"Routine outputName must be a non-empty string.\");\n  return name;\n}\n\nexport function createRoutineOutParameter(\n  name: string,\n  hint?: ParameterTypeHint,\n): RoutineParameter<null> {\n  const normalizedHint = hint === undefined ? undefined : createParameterTypeHint(hint);\n  const parameter = Object.freeze({\n    value: null,\n    direction: \"out\" as const,\n    outputName: normalizeOutputName(name),\n    ...(normalizedHint === undefined ? {} : { hint: normalizedHint }),\n    [SQL_ROUTINE_PARAMETER]: true as const,\n  });\n  knownRoutineParameters.add(parameter);\n  return parameter;\n}\n\nexport function createRoutineInOutParameter<Input>(\n  name: string,\n  value: NoInfer<Input>,\n  hint?: ParameterTypeHint<Input>,\n): RoutineParameter<Input> {\n  const normalizedHint = hint === undefined ? undefined : createParameterTypeHint(hint);\n  const parameter = Object.freeze({\n    value,\n    direction: \"inout\" as const,\n    outputName: normalizeOutputName(name),\n    ...(normalizedHint === undefined ? {} : { hint: normalizedHint }),\n    [SQL_ROUTINE_PARAMETER]: true as const,\n  });\n  knownRoutineParameters.add(parameter);\n  return parameter as RoutineParameter<Input>;\n}\n\nexport function isRoutineParameter(value: unknown): value is RoutineParameter {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value) || !knownRoutineParameters.has(value)) return false;\n  const candidate = value as {\n    readonly value?: unknown;\n    readonly direction?: unknown;\n    readonly outputName?: unknown;\n    readonly hint?: unknown;\n    readonly [SQL_ROUTINE_PARAMETER]?: unknown;\n  };\n  return candidate[SQL_ROUTINE_PARAMETER] === true\n    && Object.hasOwn(candidate, \"value\")\n    && (candidate.direction === \"out\" || candidate.direction === \"inout\")\n    && typeof candidate.outputName === \"string\"\n    && Boolean(candidate.outputName.trim())\n    && (candidate.hint === undefined || isParameterTypeHint(candidate.hint));\n}\n\nexport type ParameterTransportKind =\n  | \"native-value-template\"\n  | \"text-positional\"\n  | \"text-named\"\n  | \"typed-request\";\n\nexport type RequestedReuse = \"auto\" | \"simple\" | \"reuse\";\nexport type EffectiveReuse = \"simple\" | \"reuse\";\nexport type ReuseOwner = \"sqlbraid\" | \"driver\" | \"server\";\n\nexport interface StatementBindingContext {\n  readonly dialectId: string;\n  readonly requestedReuse: RequestedReuse;\n  readonly preparedName?: string;\n  readonly transactionScoped?: boolean;\n}\n\nexport interface BindingDescription {\n  readonly index: number;\n  readonly name?: string;\n  readonly interpolation?: number;\n  readonly hint?: ParameterTypeHint;\n  readonly direction?: RoutineParameterDirection;\n  readonly outputName?: string;\n}\n\nexport interface LiteralizeOptions {\n  readonly values?: \"inline\" | \"redacted\";\n  readonly maxValueLength?: number;\n  readonly binary?: \"summary\" | \"full\";\n  readonly redact?: (parameter: RenderedParameter, index: number) => boolean;\n}\n\nexport interface LiteralizedSqlResult {\n  readonly text: string;\n  /**\n   * True when no diagnostic parameter representation was truncated. Redaction,\n   * unsupported literal markers, and divergence from wire SQL do not make it\n   * incomplete.\n   */\n  readonly complete: boolean;\n  readonly redactedParameters: number;\n  readonly truncatedParameters: number;\n}\n\nexport interface StatementBindingDescription {\n  readonly adapterId: string;\n  readonly dialectId: string;\n  readonly transport: ParameterTransportKind;\n  readonly parameterizedSql?: string;\n  readonly bindings: readonly BindingDescription[];\n  readonly reuse: {\n    readonly requested: RequestedReuse;\n    readonly effective: EffectiveReuse;\n    readonly owner: ReuseOwner;\n    readonly capacity?: number;\n  };\n  /** Diagnostic reconstruction only; never use this text as execution input. */\n  readonly literalizedSql: (options?: LiteralizeOptions) => LiteralizedSqlResult;\n}\n\nexport interface StatementBindingAdapter {\n  readonly id: string;\n  describe(statement: RenderedStatement, context: StatementBindingContext): StatementBindingDescription;\n  describeBulk?(bulk: RenderedBulk, context: StatementBindingContext): BulkBindingDescription;\n}\n\nexport interface StatementBindingDescriptionOptions {\n  readonly adapterId: string;\n  readonly transport: ParameterTransportKind;\n  readonly placeholder?: (index: number) => string;\n  readonly reuse: {\n    readonly effective: EffectiveReuse;\n    readonly owner: ReuseOwner;\n    readonly capacity?: number;\n  };\n  readonly formatLiteral?: (parameter: RenderedParameter, index: number, options: LiteralizeOptions) => string | undefined;\n}\n\nexport interface RenderedBulk {\n  readonly statement: RenderedStatement;\n  readonly parameterSets: readonly (readonly unknown[])[];\n}\n\nexport interface BulkBindingDescription {\n  readonly adapterId: string;\n  readonly dialectId: string;\n  readonly transport: ParameterTransportKind;\n  readonly parameterizedSql?: string;\n  readonly bindings: readonly BindingDescription[];\n  readonly itemCount: number;\n  valuesAt(index: number): readonly unknown[];\n  literalizedSql(index: number, options?: LiteralizeOptions): LiteralizedSqlResult;\n}\n\n/**\n * Normalize and snapshot a homogeneous bulk's logical statement and value\n * matrix. Values themselves are application-owned and are not cloned.\n */\nexport function createRenderedBulk(bulk: RenderedBulk): RenderedBulk {\n  if (bulk === null || typeof bulk !== \"object\" || Array.isArray(bulk)) {\n    throw new TypeError(\"RenderedBulk must be an object.\");\n  }\n  const statement = createRenderedStatement(bulk.statement);\n  if (!Array.isArray(bulk.parameterSets)) {\n    throw new TypeError(\"RenderedBulk parameterSets must be an array.\");\n  }\n  const parameterCount = statement.parameters.length;\n  const parameterSets = Object.freeze(bulk.parameterSets.map((values) => {\n    if (!Array.isArray(values) || values.length !== parameterCount) {\n      throw new TypeError(\"RenderedBulk parameter sets must match the rendered parameter count.\");\n    }\n    for (let index = 0; index < values.length; index += 1) {\n      if (values[index] === undefined && statement.parameters[index]?.direction !== \"out\") {\n        throw new SqlRenderError(\n          \"BRAID_BIND_VALUE_UNSUPPORTED\",\n          \"Undefined bind values are unsupported; use null for SQL NULL.\",\n        );\n      }\n    }\n    return Object.isFrozen(values) ? values : Object.freeze([...values]);\n  }));\n  return Object.freeze({ statement, parameterSets });\n}\n\nconst knownRenderedStatements = new WeakSet<object>();\n\nfunction copyRenderedParameter(parameter: RenderedParameter): RenderedParameter {\n  if (typeof parameter !== \"object\" || parameter === null || Array.isArray(parameter)) {\n    throw new TypeError(\"RenderedStatement parameters must be parameter records.\");\n  }\n  const candidate = parameter as {\n    readonly value?: unknown;\n    readonly interpolation?: unknown;\n    readonly hint?: unknown;\n    readonly direction?: unknown;\n    readonly outputName?: unknown;\n  };\n  if (!Object.hasOwn(candidate, \"value\")) throw new TypeError(\"RenderedStatement parameters must contain a value.\");\n  const interpolation = candidate.interpolation;\n  if (interpolation !== undefined && !validHintNumber(interpolation)) {\n    throw new TypeError(\"RenderedStatement parameter interpolation must be a non-negative integer.\");\n  }\n  const hint = candidate.hint === undefined ? undefined : createParameterTypeHint(candidate.hint as ParameterTypeHint);\n  const direction = candidate.direction;\n  if (direction !== undefined && direction !== \"in\" && direction !== \"out\" && direction !== \"inout\") {\n    throw new TypeError(\"RenderedStatement parameter direction is unsupported.\");\n  }\n  const outputName = candidate.outputName;\n  if (outputName !== undefined && (typeof outputName !== \"string\" || !outputName.trim())) {\n    throw new TypeError(\"RenderedStatement parameter outputName must be a non-empty string.\");\n  }\n  if ((direction === \"out\" || direction === \"inout\") && outputName === undefined) {\n    throw new TypeError(\"RenderedStatement OUT and INOUT parameters require an outputName.\");\n  }\n  if (outputName !== undefined && (direction === undefined || direction === \"in\")) {\n    throw new TypeError(\"RenderedStatement parameter outputName requires an OUT or INOUT direction.\");\n  }\n  if (candidate.value === undefined && direction !== \"out\") {\n    throw new SqlRenderError(\n      \"BRAID_BIND_VALUE_UNSUPPORTED\",\n      \"Undefined bind values are unsupported; use null for SQL NULL.\",\n    );\n  }\n  return Object.freeze({\n    value: candidate.value,\n    ...(interpolation === undefined ? {} : { interpolation }),\n    ...(hint === undefined ? {} : { hint }),\n    ...(direction === undefined ? {} : { direction }),\n    ...(outputName === undefined ? {} : { outputName }),\n  });\n}\n\nfunction copyRoutineProcedure(procedure: RoutineProcedure | undefined): RoutineProcedure | undefined {\n  if (procedure === undefined) return undefined;\n  if (typeof procedure !== \"object\" || procedure === null || typeof procedure.name !== \"string\" || !procedure.name.trim()) {\n    throw new TypeError(\"Routine procedure name must be a non-empty string.\");\n  }\n  if (!Array.isArray(procedure.parameterNames)) throw new TypeError(\"Routine procedure parameterNames must be an array.\");\n  const parameterNames = procedure.parameterNames.map((name) => {\n    if (typeof name !== \"string\" || !name.trim()) throw new TypeError(\"Routine procedure parameterNames must contain non-empty strings.\");\n    return name;\n  });\n  if (new Set(parameterNames).size !== parameterNames.length) throw new TypeError(\"Routine procedure parameterNames must be unique.\");\n  return Object.freeze({ name: procedure.name, parameterNames: Object.freeze(parameterNames) });\n}\n\nexport function createRenderedStatement(statement: {\n  readonly segments: readonly string[];\n  readonly parameters: readonly RenderedParameter[];\n  readonly resultKind: QueryResultKind;\n  readonly routineProcedure?: RoutineProcedure;\n  readonly dialectId: string;\n  readonly fingerprint?: string;\n  readonly variantFingerprint?: string;\n}): RenderedStatement {\n  if (typeof statement !== \"object\" || statement === null) throw new TypeError(\"RenderedStatement must be an object.\");\n  if (knownRenderedStatements.has(statement)) return statement as RenderedStatement;\n  if (!Array.isArray(statement.segments)) {\n    throw new TypeError(\"RenderedStatement segments must be an array of strings.\");\n  }\n  if (!Array.isArray(statement.parameters)) throw new TypeError(\"RenderedStatement parameters must be an array.\");\n  if (statement.segments.length !== statement.parameters.length + 1) {\n    throw new TypeError(\"RenderedStatement invariant violated: segments.length must equal parameters.length + 1.\");\n  }\n  if (statement.resultKind !== \"call\" && statement.routineProcedure !== undefined) {\n    throw new TypeError(\"Routine procedure metadata is only valid for call statements.\");\n  }\n  if (typeof statement.dialectId !== \"string\" || !statement.dialectId) throw new TypeError(\"RenderedStatement dialectId must be a non-empty string.\");\n  const segments = Object.freeze([...statement.segments]);\n  if (segments.some((segment) => typeof segment !== \"string\")) throw new TypeError(\"RenderedStatement segments must be an array of strings.\");\n  const parameters = Object.freeze(Array.from(statement.parameters, copyRenderedParameter));\n  if (parameters.some((parameter) => parameter.direction === \"inout\" && statement.resultKind !== \"call\")) {\n    throw new TypeError(\"INOUT parameters are only valid for call statements.\");\n  }\n  if (parameters.some((parameter) => parameter.direction === \"out\"\n    && statement.resultKind !== \"call\"\n    && statement.resultKind !== \"rows\")) {\n    throw new TypeError(\"OUT parameters are only valid for call and rows statements.\");\n  }\n  const outputNames = new Set<string>();\n  for (const parameter of parameters) {\n    if (parameter.outputName !== undefined) {\n      if (outputNames.has(parameter.outputName)) throw new TypeError(`Duplicate routine outputName: ${parameter.outputName}`);\n      outputNames.add(parameter.outputName);\n    }\n  }\n  const routineProcedure = copyRoutineProcedure(statement.routineProcedure);\n  if (routineProcedure !== undefined && routineProcedure.parameterNames.length !== parameters.length) {\n    throw new TypeError(\"Routine procedure parameterNames must match the rendered parameter count.\");\n  }\n  const rendered = Object.freeze({\n    segments,\n    parameters,\n    dialectId: statement.dialectId,\n    resultKind: statement.resultKind,\n    ...(routineProcedure === undefined ? {} : { routineProcedure }),\n    ...(statement.fingerprint === undefined ? {} : { fingerprint: statement.fingerprint }),\n    ...(statement.variantFingerprint === undefined ? {} : { variantFingerprint: statement.variantFingerprint }),\n  });\n  knownRenderedStatements.add(rendered);\n  return rendered;\n}\n\nexport function parameterizedSql(statement: RenderedStatement, placeholder: (index: number) => string): string {\n  const parts: string[] = [statement.segments[0] ?? \"\"];\n  for (let index = 0; index < statement.parameters.length; index += 1) {\n    parts.push(placeholder(index + 1), statement.segments[index + 1] ?? \"\");\n  }\n  return parts.join(\"\");\n}\n\nfunction genericLiteral(parameter: RenderedParameter, dialectId: string, binary: \"summary\" | \"full\"): string {\n  const value = parameter.value;\n  if (value === null) return \"NULL\";\n  if (value === undefined) return \"[undefined]\";\n  if (typeof value === \"string\") return `'${value.replaceAll(\"'\", \"''\")}'`;\n  if (typeof value === \"boolean\") {\n    if (/^(?:mysql|sqlite)/i.test(dialectId) || /^(?:oracle|mssql|sqlserver)/i.test(dialectId)) return value ? \"1\" : \"0\";\n    if (/^(?:postgres|postgresql|cockroach|redshift)/i.test(dialectId)) return value ? \"TRUE\" : \"FALSE\";\n    return `[boolean ${value ? \"true\" : \"false\"}]`;\n  }\n  if (typeof value === \"number\") return Number.isFinite(value) ? String(value) : `[unsupported ${String(value)}]`;\n  if (typeof value === \"bigint\") return value.toString();\n  if (value instanceof Date) {\n    try {\n      const timestamp = Date.prototype.getTime.call(value);\n      return Number.isNaN(timestamp) ? \"[unsupported date]\" : `[date ${Date.prototype.toISOString.call(value)}]`;\n    } catch {\n      return \"[unsupported date]\";\n    }\n  }\n  if (value instanceof Uint8Array) {\n    try {\n      if (binary === \"full\") {\n        let hex = \"\";\n        for (const byte of value) hex += byte.toString(16).padStart(2, \"0\");\n        return `X'${hex}'`;\n      }\n      return `[binary ${value.byteLength} bytes]`;\n    } catch {\n      return \"[unsupported binary]\";\n    }\n  }\n  if (typeof value === \"object\") return \"[unsupported object]\";\n  return `[unsupported ${typeof value}]`;\n}\n\nfunction literalized(\n  statement: RenderedStatement,\n  dialectId: string,\n  formatLiteral: StatementBindingDescriptionOptions[\"formatLiteral\"],\n  options: LiteralizeOptions | undefined,\n): LiteralizedSqlResult {\n  const resolved: LiteralizeOptions = options ?? {};\n  const valuesMode = resolved.values ?? \"redacted\";\n  const maxLength = resolved.maxValueLength;\n  if (valuesMode !== \"inline\" && valuesMode !== \"redacted\") throw new TypeError(\"literalizedSql values must be \\\"inline\\\" or \\\"redacted\\\".\");\n  if (maxLength !== undefined && (!Number.isSafeInteger(maxLength) || maxLength < 0)) {\n    throw new TypeError(\"literalizedSql maxValueLength must be a non-negative integer.\");\n  }\n  const binary = resolved.binary ?? \"summary\";\n  if (binary !== \"summary\" && binary !== \"full\") throw new TypeError(\"literalizedSql binary must be \\\"summary\\\" or \\\"full\\\".\");\n  if (resolved.redact !== undefined && typeof resolved.redact !== \"function\") throw new TypeError(\"literalizedSql redact must be a function.\");\n  const parts: string[] = [statement.segments[0] ?? \"\"];\n  let redactedParameters = 0;\n  let truncatedParameters = 0;\n  for (let index = 0; index < statement.parameters.length; index += 1) {\n    const parameter = statement.parameters[index];\n    const redact = valuesMode === \"redacted\" || resolved.redact?.(parameter, index) === true;\n    let valueText: string;\n    if (redact) {\n      valueText = \"[REDACTED]\";\n      redactedParameters += 1;\n    } else {\n      valueText = formatLiteral?.(parameter, index, resolved) ?? genericLiteral(parameter, dialectId, binary);\n    }\n    if (maxLength !== undefined && valueText.length > maxLength) {\n      valueText = maxLength === 0 ? \"\" : valueText.slice(0, maxLength);\n      truncatedParameters += 1;\n    }\n    parts.push(valueText, statement.segments[index + 1] ?? \"\");\n  }\n  return Object.freeze({\n    text: parts.join(\"\"),\n    complete: truncatedParameters === 0,\n    redactedParameters,\n    truncatedParameters,\n  });\n}\n\nexport function createStatementBindingDescription(\n  statement: RenderedStatement,\n  context: StatementBindingContext,\n  options: StatementBindingDescriptionOptions,\n): StatementBindingDescription {\n  const logical = createRenderedStatement(statement);\n  const adapterId = options.adapterId;\n  const transport = options.transport;\n  const placeholder = options.placeholder;\n  const formatLiteral = options.formatLiteral;\n  const effective = options.reuse.effective;\n  const owner = options.reuse.owner;\n  const capacity = options.reuse.capacity;\n  const dialectId = context.dialectId;\n  const requestedReuse = context.requestedReuse;\n  if (logical.dialectId !== dialectId) {\n    throw new TypeError(`BRAID_DIALECT: statement binding dialect ${dialectId} does not match rendered statement dialect ${logical.dialectId}.`);\n  }\n  if (typeof adapterId !== \"string\" || !adapterId) throw new TypeError(\"Statement binding adapterId must be a non-empty string.\");\n  if (typeof dialectId !== \"string\" || !dialectId) throw new TypeError(\"Statement binding dialectId must be a non-empty string.\");\n  if (![\"native-value-template\", \"text-positional\", \"text-named\", \"typed-request\"].includes(transport)) {\n    throw new TypeError(\"Statement binding transport is unsupported.\");\n  }\n  if (transport !== \"native-value-template\" && placeholder === undefined) {\n    throw new TypeError(\"Text and typed statement transports require a placeholder function.\");\n  }\n  if (![\"auto\", \"simple\", \"reuse\"].includes(requestedReuse)) throw new TypeError(\"Statement binding requestedReuse is unsupported.\");\n  if (![\"simple\", \"reuse\"].includes(effective) || ![\"sqlbraid\", \"driver\", \"server\"].includes(owner)) {\n    throw new TypeError(\"Statement binding reuse policy is unsupported.\");\n  }\n  if (capacity !== undefined && (!Number.isSafeInteger(capacity) || capacity < 0)) {\n    throw new TypeError(\"Statement binding reuse capacity must be a non-negative safe integer.\");\n  }\n  if (placeholder !== undefined && typeof placeholder !== \"function\") {\n    throw new TypeError(\"Statement binding placeholder must be a function.\");\n  }\n  const bindings = Object.freeze(logical.parameters.map((parameter, offset) => Object.freeze({\n    index: offset + 1,\n    ...(parameter.outputName === undefined ? {} : { name: parameter.outputName, outputName: parameter.outputName }),\n    ...(parameter.interpolation === undefined ? {} : { interpolation: parameter.interpolation }),\n    ...(parameter.hint === undefined ? {} : { hint: createParameterTypeHint(parameter.hint) }),\n    ...(parameter.direction === undefined ? {} : { direction: parameter.direction }),\n  })));\n  const reuse = Object.freeze({\n    requested: requestedReuse,\n    effective,\n    owner,\n    ...(capacity === undefined ? {} : { capacity }),\n  });\n  let parameterizedReady = false;\n  let parameterized: string | undefined;\n  const literalCache = new Map<string, LiteralizedSqlResult>();\n  let defaultLiteralized: LiteralizedSqlResult | undefined;\n  const description = {\n    adapterId,\n    dialectId,\n    transport,\n    bindings,\n    reuse,\n    literalizedSql: (literalOptions?: LiteralizeOptions): LiteralizedSqlResult => {\n      if (literalOptions === undefined) {\n        if (defaultLiteralized === undefined) defaultLiteralized = literalized(logical, dialectId, formatLiteral, undefined);\n        return defaultLiteralized;\n      }\n      if (typeof literalOptions !== \"object\" || literalOptions === null) throw new TypeError(\"literalizedSql options must be an object.\");\n      const values = literalOptions.values;\n      const binary = literalOptions.binary;\n      const maxValueLength = literalOptions.maxValueLength;\n      const redact = literalOptions.redact;\n      const snapshot = Object.freeze({\n        ...(values === undefined ? {} : { values }),\n        ...(binary === undefined ? {} : { binary }),\n        ...(maxValueLength === undefined ? {} : { maxValueLength }),\n        ...(redact === undefined ? {} : { redact }),\n      });\n      const cacheKey = redact === undefined\n        ? `${values ?? \"\"}\\u0000${binary ?? \"\"}\\u0000${maxValueLength ?? \"\"}`\n        : undefined;\n      if (cacheKey !== undefined) {\n        const cached = literalCache.get(cacheKey);\n        if (cached) return cached;\n      }\n      const result = literalized(logical, dialectId, formatLiteral, snapshot);\n      if (cacheKey !== undefined) literalCache.set(cacheKey, result);\n      return result;\n    },\n  } as StatementBindingDescription;\n  if (placeholder !== undefined) {\n    Object.defineProperty(description, \"parameterizedSql\", {\n      enumerable: true,\n      configurable: false,\n      get: () => {\n        if (!parameterizedReady) {\n          parameterized = parameterizedSql(logical, placeholder);\n          parameterizedReady = true;\n        }\n        return parameterized;\n      },\n    });\n  }\n  return Object.freeze(description);\n}\n\n/**\n * Build one binding description for a logical bulk statement. The statement\n * metadata is shared by every parameter set; values and diagnostics are\n * addressed only when requested for a particular item.\n */\nexport function createBulkBindingDescription(\n  bulk: RenderedBulk,\n  context: StatementBindingContext,\n  options: StatementBindingDescriptionOptions,\n): BulkBindingDescription {\n  const logical = createRenderedBulk(bulk);\n  const statementBinding = createStatementBindingDescription(logical.statement, context, options);\n  const parameterSets = logical.parameterSets;\n  const itemCount = parameterSets.length;\n  const valuesAt = (index: number): readonly unknown[] => {\n    if (!Number.isSafeInteger(index) || index < 0 || index >= itemCount) {\n      throw new RangeError(`Bulk item index ${String(index)} is outside [0, ${itemCount}).`);\n    }\n    return parameterSets[index]!;\n  };\n  const literalizedSqlFor = (index: number, literalOptions?: LiteralizeOptions): LiteralizedSqlResult => {\n    const values = valuesAt(index);\n    const optionsSnapshot = literalOptions === undefined ? undefined : {\n      ...(literalOptions.values === undefined ? {} : { values: literalOptions.values }),\n      ...(literalOptions.binary === undefined ? {} : { binary: literalOptions.binary }),\n      ...(literalOptions.maxValueLength === undefined ? {} : { maxValueLength: literalOptions.maxValueLength }),\n      ...(literalOptions.redact === undefined ? {} : { redact: literalOptions.redact }),\n    };\n    const statement = {\n      ...logical.statement,\n      parameters: logical.statement.parameters.map((parameter, parameterIndex) => ({\n        ...parameter,\n        value: values[parameterIndex],\n      })),\n    };\n    const result = createStatementBindingDescription(\n      statement,\n      context,\n      options,\n    ).literalizedSql(optionsSnapshot);\n    return result;\n  };\n  const description = {\n    adapterId: statementBinding.adapterId,\n    dialectId: statementBinding.dialectId,\n    transport: statementBinding.transport,\n    bindings: statementBinding.bindings,\n    itemCount,\n    valuesAt,\n    literalizedSql: literalizedSqlFor,\n  } as BulkBindingDescription;\n  if (\"parameterizedSql\" in statementBinding) {\n    Object.defineProperty(description, \"parameterizedSql\", {\n      enumerable: true,\n      configurable: false,\n      get: () => statementBinding.parameterizedSql,\n    });\n  }\n  return Object.freeze(description);\n}\n\nexport interface DialectLexicalProfile {\n  readonly lineCommentPrefixes: readonly string[];\n  readonly supportsNestedBlockComments?: boolean;\n  readonly supportsDollarQuotes?: boolean;\n  readonly supportsBacktickIdentifiers?: boolean;\n  readonly supportsBracketIdentifiers?: boolean;\n  readonly supportsOracleQQuotes?: boolean;\n  readonly backslashEscapes?: boolean;\n}\n\nexport interface Dialect {\n  readonly id: string;\n  quoteIdentifier(identifier: string): string;\n  readonly lexicalProfile?: DialectLexicalProfile;\n}\n\nexport interface TypeMapping {\n  readonly databaseType: string;\n  readonly inputType: string;\n  readonly outputType: string;\n  readonly nullable: boolean;\n  readonly numeric?: NumericTypeContract;\n}\n\nexport interface TypePolicy {\n  readonly id: string;\n  readonly hash: string;\n  readonly mappings: readonly TypeMapping[];\n  decode(databaseType: string, value: unknown): unknown;\n  encode(databaseType: string, value: unknown): unknown;\n}\n\nexport interface TextNode {\n  readonly kind: \"text\";\n  readonly text: string;\n  readonly range: SourceRange;\n}\n\nexport interface BindNode {\n  readonly kind: \"bind\";\n  readonly interpolation: number;\n  readonly range: SourceRange;\n}\n\nexport interface FragmentNode {\n  readonly kind: \"fragment\";\n  readonly fragment: SqlFragment;\n  readonly range: SourceRange;\n}\n\nexport interface IdentifierNode {\n  readonly kind: \"identifier\";\n  readonly value: string | readonly string[];\n  readonly range: SourceRange;\n}\n\nexport interface RawNode {\n  readonly kind: \"raw\";\n  readonly text: string;\n  readonly range: SourceRange;\n}\n\nexport interface ListNode {\n  readonly kind: \"list\";\n  readonly values: readonly unknown[];\n  readonly range: SourceRange;\n}\n\nexport interface IfNode {\n  readonly kind: \"if\";\n  readonly condition: number;\n  readonly children: readonly TemplateNode[];\n  readonly range: SourceRange;\n}\n\nexport interface ChooseWhen {\n  readonly condition: number;\n  readonly children: readonly TemplateNode[];\n  readonly range: SourceRange;\n}\n\nexport interface ChooseNode {\n  readonly kind: \"choose\";\n  readonly whens: readonly ChooseWhen[];\n  readonly otherwise?: readonly TemplateNode[];\n  readonly range: SourceRange;\n}\n\nexport interface TrimAttributes {\n  readonly prefix: string;\n  readonly prefixOverrides: readonly string[];\n  readonly suffix: string;\n  readonly suffixOverrides: readonly string[];\n}\n\nexport interface TrimNode {\n  readonly kind: \"trim\";\n  readonly attributes: TrimAttributes;\n  readonly children: readonly TemplateNode[];\n  readonly range: SourceRange;\n}\n\nexport type TemplateNode =\n  | TextNode\n  | BindNode\n  | FragmentNode\n  | IdentifierNode\n  | RawNode\n  | ListNode\n  | IfNode\n  | ChooseNode\n  | TrimNode;\n\nexport interface TemplateIr {\n  readonly version: 1;\n  readonly nodes: readonly TemplateNode[];\n  readonly sourceLength: number;\n}\n\nexport interface SqlFragment {\n  readonly [SQL_FRAGMENT]: true;\n  readonly ir: TemplateIr;\n  readonly values: readonly unknown[];\n  readonly dialectId: string;\n}\n\nexport interface Query<Row = unknown, Kind extends QueryResultKind = \"unknown\"> {\n  readonly ir: TemplateIr;\n  readonly values: readonly unknown[];\n  readonly resultKind: Kind;\n  /**\n   * Application result mapper. Never forwarded to a DB driver.\n   */\n  readonly resultSchema?: StandardSchemaV1<unknown, Row>;\n  readonly routineContract?: RoutineContract;\n  render(): RenderedStatement;\n  readonly __row?: Row;\n}\n\nexport type RowQuery<Row = unknown> = Query<Row, \"rows\">;\nexport type CommandQuery = Query<CommandResult, \"command\">;\nexport type CallQuery<Result extends RoutineCallResult = RoutineCallResult> = Query<Result, \"call\">;\n\nexport interface CommandResult {\n  readonly affectedRows?: number;\n  readonly insertId?: string;\n  readonly [key: string]: unknown;\n}\n\nexport interface RowsExecutionResult<Row = unknown> {\n  readonly kind: \"rows\";\n  readonly rows: readonly Row[];\n  readonly rowCount?: number;\n  readonly command?: never;\n}\n\nexport interface CommandExecutionResult {\n  readonly kind: \"command\";\n  readonly rows: readonly [];\n  readonly rowCount?: number;\n  readonly command: CommandResult;\n}\n\nexport type QueryExecutionResult<Row = unknown> =\n  | RowsExecutionResult<Row>\n  | CommandExecutionResult;\n\nexport interface ExecutionOptions {\n  readonly signal?: AbortSignal;\n}\n\nexport interface RowValidationOptions<Row> extends ExecutionOptions {\n  readonly schema?: StandardSchemaV1<unknown, NoInfer<Row>>;\n}\n\nexport interface StreamOptions<Row> extends RowValidationOptions<Row> {}\n\nexport type TransactionIsolation =\n  | \"read-uncommitted\"\n  | \"read-committed\"\n  | \"repeatable-read\"\n  | \"serializable\";\n\nexport interface TransactionOptions {\n  readonly isolation?: TransactionIsolation;\n  readonly readOnly?: boolean;\n}\n\nexport class UnsupportedFeatureError extends Error {\n  constructor(\n    readonly feature: string,\n    readonly code: `BRAID_${string}`,\n    message: string,\n    options?: ErrorOptions,\n  ) {\n    super(`${code}: ${message}`, options);\n    this.name = \"UnsupportedFeatureError\";\n  }\n}\n\nexport interface RoutineResultSet<Row = unknown> {\n  readonly rows: readonly Row[];\n}\n\nexport type RoutineResultSetTuple<Sets extends readonly unknown[]> = {\n  readonly [K in keyof Sets]: RoutineResultSet<Sets[K]>;\n};\n\nexport interface RoutineCallResult<\n  Output extends Readonly<Record<string, unknown>> = Readonly<Record<string, unknown>>,\n  Sets extends readonly unknown[] = readonly unknown[],\n  ReturnValue = unknown,\n> {\n  readonly output: Output;\n  readonly resultSets: RoutineResultSetTuple<Sets>;\n  readonly returnValue?: ReturnValue;\n}\n\nexport type RoutineSchemaOutput<Schema> = Schema extends StandardSchemaV1<any, infer Output> ? Output : never;\n\ntype RoutineRowsFromSchemas<Schemas extends readonly RoutineSchema[]> = {\n  readonly [K in keyof Schemas]: RoutineSchemaOutput<Schemas[K]>;\n};\n\nexport type RoutineResultFromContract<Contract extends RoutineContract> = RoutineCallResult<\n  Contract[\"output\"] extends RoutineSchema\n    ? RoutineSchemaOutput<Contract[\"output\"]> extends Readonly<Record<string, unknown>>\n      ? RoutineSchemaOutput<Contract[\"output\"]>\n      : Readonly<Record<string, unknown>>\n    : Readonly<Record<string, unknown>>,\n  Contract[\"resultSets\"] extends infer Schemas extends readonly RoutineSchema[]\n    ? RoutineRowsFromSchemas<Schemas>\n    : readonly unknown[],\n  Contract[\"returnValue\"] extends RoutineSchema ? RoutineSchemaOutput<Contract[\"returnValue\"]> : unknown\n> & (Contract extends { readonly returnValue: RoutineSchema }\n  ? { readonly returnValue: RoutineSchemaOutput<Contract[\"returnValue\"]> }\n  : {});\n\nexport type RoutineResultSource =\n  | {\n      readonly kind: \"out-cursor\";\n      readonly name?: string;\n      readonly parameterIndex?: number;\n    }\n  | {\n      readonly kind: \"implicit\";\n      readonly index: number;\n    }\n  | {\n      readonly kind: \"emitted\";\n      readonly index: number;\n    };\n\nexport interface DriverRoutineResultSet {\n  readonly rows: readonly unknown[];\n  readonly source: RoutineResultSource;\n}\n\nexport interface DriverRoutineResult {\n  readonly output: Readonly<Record<string, unknown>>;\n  readonly returnValue?: unknown;\n  readonly resultSets: readonly DriverRoutineResultSet[];\n}\n\nexport type RoutineMappingLocation =\n  | { readonly kind: \"output\" }\n  | { readonly kind: \"return-value\" }\n  | {\n      readonly kind: \"result-set\";\n      readonly resultSetIndex: number;\n      readonly rowIndex: number;\n    };\n\nexport type DriverCapabilityErrorCode =\n  | \"BRAID_STREAM_UNSUPPORTED\"\n  | \"BRAID_CALL_UNSUPPORTED\"\n  | \"BRAID_CALL_RESULT_SETS\"\n  | \"BRAID_CALL_CURSOR_TX_REQUIRED\"\n  | \"BRAID_CALL_OUT_UNSUPPORTED\"\n  | \"BRAID_CALL_RETURN_UNSUPPORTED\"\n  | \"BRAID_CALL_CURSOR_UNSUPPORTED\"\n  | \"BRAID_RESOURCE_CLEANUP\";\n\nexport class RoutineMappingError extends Error {\n  readonly code = \"BRAID_CALL_MAP\";\n  readonly location: RoutineMappingLocation;\n\n  constructor(message: string, location: RoutineMappingLocation, options?: { readonly cause?: unknown }) {\n    super(message, options);\n    this.name = \"RoutineMappingError\";\n    this.location = Object.freeze(location);\n  }\n}\n\nexport type BulkExecutionMode = \"native-bulk\" | \"pipeline\" | \"prepared-loop\" | \"remote-batch\";\n\nexport interface BulkExecutionResult {\n  readonly inputCount: number;\n  readonly affectedRows?: number;\n  readonly executionMode: BulkExecutionMode;\n}\n\nexport interface QueryExecutor {\n  /** Stable identity for the physical execution resource shared by wrappers; pools must use a leased resource. */\n  readonly ownershipKey?: object;\n  readonly statementBinding: StatementBindingAdapter;\n  readonly environment?: DriverEnvironment;\n  query<Row>(rendered: RenderedStatement, binding?: StatementBindingDescription, options?: ExecutionOptions): Promise<QueryExecutionResult<Row>>;\n  stream<Row>(rendered: RenderedStatement, binding?: StatementBindingDescription, options?: ExecutionOptions): AsyncIterable<Row>;\n  call(rendered: RenderedStatement, binding?: StatementBindingDescription, options?: ExecutionOptions): Promise<DriverRoutineResult>;\n  bulk?(bulk: RenderedBulk, binding: BulkBindingDescription, options?: ExecutionOptions): Promise<BulkExecutionResult>;\n  begin?(options?: TransactionOptions): Promise<void>;\n  commit?(): Promise<void>;\n  rollback?(): Promise<void>;\n  savepoint?(name: string): Promise<void>;\n  rollbackTo?(name: string): Promise<void>;\n  releaseSavepoint?(name: string): Promise<void>;\n}\n\nexport interface ConnectionLease extends QueryExecutor {\n  release(options?: { readonly discard?: boolean }): void | Promise<void>;\n}\n\nexport interface ConnectionProvider {\n  readonly statementBinding: StatementBindingAdapter;\n  readonly environment?: DriverEnvironment;\n  acquire(): Promise<ConnectionLease>;\n}\n\nexport interface QueryExecutionPlan {\n  readonly adapterId: string;\n  readonly dialectId: string;\n  readonly transport: ParameterTransportKind;\n  readonly reuse: StatementBindingDescription[\"reuse\"];\n}\n\nexport interface QueryReadyEvent {\n  readonly type: \"query:ready\";\n  readonly purpose?: \"environment\";\n  readonly operationId: string;\n  readonly batchId?: string;\n  readonly sql?: string;\n  readonly values: readonly unknown[];\n  readonly bindingMap?: readonly {\n    readonly placeholder: number;\n    readonly interpolation?: number;\n    readonly direction?: RoutineParameterDirection;\n    readonly outputName?: string;\n  }[];\n  readonly parameterHints?: readonly (ParameterTypeHint | undefined)[];\n  readonly execution: QueryExecutionPlan;\n  readonly literalizedSql: (options?: LiteralizeOptions) => LiteralizedSqlResult;\n  readonly declaredKind: QueryResultKind;\n  readonly fingerprint?: string;\n  readonly variantFingerprint?: string;\n  readonly preparedName?: string;\n  readonly transactionDepth: number;\n  readonly transactionScoped: boolean;\n}\n\nexport interface QueryResultEvent {\n  readonly type: \"query:result\";\n  readonly purpose?: \"environment\";\n  readonly operationId: string;\n  readonly preparedName?: string;\n  readonly batchId?: string;\n  readonly durationMs: number;\n  readonly actualKind: \"rows\" | \"command\" | \"call\";\n  readonly rowCount?: number;\n  readonly resultSetCount?: number;\n  readonly outputKeys?: readonly string[];\n  readonly hasReturnValue?: boolean;\n  readonly command?: Readonly<Record<string, unknown>>;\n  readonly transactionDepth: number;\n  readonly transactionScoped: boolean;\n}\n\nexport interface QueryMappedEvent {\n  readonly type: \"query:mapped\";\n  readonly purpose?: \"environment\";\n  readonly operationId: string;\n  readonly preparedName?: string;\n  readonly batchId?: string;\n  readonly durationMs: number;\n  readonly rowCount: number;\n  readonly queryMapped: boolean;\n  readonly executionMapped: boolean;\n  readonly transactionDepth: number;\n  readonly transactionScoped: boolean;\n}\n\nexport interface BulkReadyEvent {\n  readonly type: \"bulk:ready\";\n  readonly operationId: string;\n  readonly itemCount: number;\n  readonly transactionDepth: number;\n  readonly transactionScoped: boolean;\n  readonly sql?: string;\n  readonly valuesAt: (index: number) => readonly unknown[];\n  readonly literalizedSql: (index: number, options?: LiteralizeOptions) => LiteralizedSqlResult;\n}\n\nexport interface BulkResultEvent {\n  readonly type: \"bulk:result\";\n  readonly operationId: string;\n  readonly itemCount: number;\n  readonly affectedRows?: number;\n  readonly executionMode: BulkExecutionMode;\n  readonly durationMs: number;\n  readonly transactionDepth: number;\n  readonly transactionScoped: boolean;\n}\n\nexport type QueryErrorStage =\n  | \"render\"\n  | \"prepared\"\n  | \"observer-before\"\n  | \"materialize\"\n  | \"acquire\"\n  | \"driver\"\n  | \"result-kind\"\n  | \"cardinality\"\n  | \"query-map\"\n  | \"execution-map\"\n  | \"observer-after\"\n  | \"release\"\n  | \"stream\"\n  | \"transaction\";\n\nexport interface QueryErrorEvent {\n  readonly type: \"query:error\";\n  readonly purpose?: \"environment\";\n  readonly operationId: string;\n  readonly preparedName?: string;\n  readonly batchId?: string;\n  readonly error: unknown;\n  readonly stage: QueryErrorStage;\n  readonly executionStarted: boolean;\n  readonly executionCompleted: boolean;\n  readonly durationMs?: number;\n  readonly transactionDepth: number;\n  readonly transactionScoped: boolean;\n}\n\nexport interface StreamStartEvent {\n  readonly type: \"stream:start\";\n  readonly operationId: string;\n  readonly sql?: string;\n  readonly values: readonly unknown[];\n  readonly bindingMap?: readonly {\n    readonly placeholder: number;\n    readonly interpolation?: number;\n    readonly direction?: RoutineParameterDirection;\n    readonly outputName?: string;\n  }[];\n  readonly parameterHints?: readonly (ParameterTypeHint | undefined)[];\n  readonly execution: QueryExecutionPlan;\n  readonly literalizedSql: (options?: LiteralizeOptions) => LiteralizedSqlResult;\n  readonly declaredKind: \"rows\";\n  readonly variantFingerprint?: string;\n  readonly preparedName?: string;\n  readonly transactionDepth: number;\n  readonly transactionScoped: boolean;\n}\n\nexport interface StreamEndEvent {\n  readonly type: \"stream:end\";\n  readonly operationId: string;\n  readonly status: \"completed\" | \"error\";\n  readonly durationMs: number;\n  readonly rowCount: number;\n  readonly error?: unknown;\n  readonly transactionDepth: number;\n  readonly transactionScoped: boolean;\n}\n\nexport type TransactionEventPhase =\n  | \"begin\"\n  | \"commit\"\n  | \"rollback\"\n  | \"savepoint\"\n  | \"rollback-to-savepoint\"\n  | \"release-savepoint\";\n\nexport interface TransactionEvent {\n  readonly type: \"transaction\";\n  readonly transactionId: string;\n  readonly phase: TransactionEventPhase;\n  readonly status: \"requested\" | \"completed\" | \"failed\";\n  readonly depth: number;\n  readonly savepointName?: string;\n  readonly durationMs?: number;\n  readonly error?: unknown;\n}\n\nexport type ExecutionEvent =\n  | QueryReadyEvent\n  | QueryResultEvent\n  | QueryMappedEvent\n  | BulkReadyEvent\n  | BulkResultEvent\n  | QueryErrorEvent\n  | StreamStartEvent\n  | StreamEndEvent\n  | TransactionEvent;\n\nexport interface ExecutionObserver {\n  onEvent(event: ExecutionEvent): void | Promise<void>;\n}\n\nexport interface EnvironmentCapability {\n  readonly status: \"guaranteed\" | \"guarded\" | \"unsupported\";\n  readonly canonical?: \"string\" | \"number\" | \"Uint8Array\";\n  readonly rawRepresentations?: readonly string[];\n  readonly conditionCode?: string;\n}\n\nexport interface DatabaseEnvironment {\n  readonly database: { readonly product: string; readonly version?: string; readonly edition?: string };\n  readonly driver: { readonly id: string; readonly version?: string; readonly profile?: string };\n  readonly runtime: { readonly id: string; readonly version?: string };\n  readonly typePolicy?: { readonly id: string; readonly hash: string };\n  readonly capabilities: Readonly<Record<string, EnvironmentCapability>>;\n  readonly supportMatch: {\n    readonly status: \"official\" | \"conditional\" | \"compatible\";\n    readonly targetId?: string;\n    readonly reason?: string;\n  };\n}\n\n/** Adapter evidence only. Probes run through the ordinary observed, leased query path. */\nexport interface DriverEnvironment {\n  readonly database: DatabaseEnvironment[\"database\"];\n  readonly driver: DatabaseEnvironment[\"driver\"];\n  readonly typePolicy?: { readonly id: string; readonly hash: string };\n  readonly capabilities: DatabaseEnvironment[\"capabilities\"];\n  readonly probe?: {\n    readonly statement: RenderedStatement;\n    readonly read: (rows: readonly unknown[]) => {\n      readonly version?: string;\n      readonly edition?: string;\n      readonly capabilities?: Readonly<Record<string, EnvironmentCapability>>;\n    };\n  };\n}\n\n/** Structural subset of a support manifest; importing support tooling is unnecessary. */\nexport interface EnvironmentSupportTarget {\n  readonly id: string;\n  readonly status: string;\n  readonly database: { readonly product: string; readonly version: string; readonly edition: string };\n  readonly driver: { readonly id: string; readonly version: string; readonly profile: string };\n  readonly runtime: { readonly id: string; readonly version: string };\n  readonly typePolicy: { readonly id: string; readonly hash: string };\n  readonly evidence: { readonly status: string };\n}\n\nexport interface EnvironmentOptions {\n  readonly targets?: readonly EnvironmentSupportTarget[];\n  /** Re-probe the current lease instead of returning the cached observation. */\n  readonly refresh?: boolean;\n}\n\nexport interface DatabaseOptions {\n  readonly observers?: readonly ExecutionObserver[];\n  readonly reuse?: RequestedReuse;\n}\n\nexport type PreparableQuery = ExecutableQuery | CallQuery;\n\nexport type PreparedArguments<Input, Options> =\n  [Input] extends [never] ? [options?: Options] : [input: Input, options?: Options];\n\nexport type PreparedQuery<Input, Q extends PreparableQuery> = {\n  readonly name: string;\n} & (Q extends CallQuery<infer Result>\n  ? { call(...args: PreparedArguments<Input, ExecutionOptions>): Promise<Result> }\n  : { execute(...args: PreparedArguments<Input, ExecutionOptions>): Promise<ExecutionResultOf<Q>> }\n    & (Q extends RowQuery<infer Row> ? {\n      all(...args: PreparedArguments<Input, RowValidationOptions<Row>>): Promise<readonly Row[]>;\n      one(...args: PreparedArguments<Input, RowValidationOptions<Row>>): Promise<Row>;\n      maybeOne(...args: PreparedArguments<Input, RowValidationOptions<Row>>): Promise<Row | undefined>;\n      stream(...args: PreparedArguments<Input, StreamOptions<Row>>): AsyncIterable<Row>;\n    } : {}));\n\nexport type ExecutableQuery =\n  | RowQuery<unknown>\n  | Query<unknown, \"command\">\n  | Query<unknown, \"unknown\">;\n\nexport type ExecutionResultOf<Q> =\n  Q extends RowQuery<infer Row>\n    ? RowsExecutionResult<Row>\n    : Q extends Query<unknown, \"command\">\n      ? CommandExecutionResult\n      : Q extends Query<infer Row, \"unknown\">\n        ? QueryExecutionResult<Row>\n        : never;\n\nexport interface Database {\n  environment(options?: EnvironmentOptions): Promise<DatabaseEnvironment>;\n  all<Row>(query: RowQuery<Row>, options?: RowValidationOptions<Row>): Promise<readonly Row[]>;\n  one<Row>(query: RowQuery<Row>, options?: RowValidationOptions<Row>): Promise<Row>;\n  maybeOne<Row>(query: RowQuery<Row>, options?: RowValidationOptions<Row>): Promise<Row | undefined>;\n  execute<Q extends ExecutableQuery>(query: Q, options?: ExecutionOptions): Promise<ExecutionResultOf<Q>>;\n  call<Result extends RoutineCallResult>(query: CallQuery<Result>, options?: ExecutionOptions): Promise<Result>;\n  batch<const Queries extends readonly ExecutableQuery[]>(queries: Queries, options?: ExecutionOptions): Promise<{ readonly [K in keyof Queries]: ExecutionResultOf<Queries[K]> }>;\n  bulk<Input>(inputs: readonly Input[], factory: (input: Input, index: number) => CommandQuery, options?: ExecutionOptions): Promise<BulkResult>;\n  prepare<Factory extends () => PreparableQuery>(\n    name: string,\n    factory: Factory & (Parameters<Factory> extends [] ? unknown : never),\n  ): PreparedQuery<never, ReturnType<Factory>>;\n  prepare<Factory extends (input: never) => PreparableQuery>(\n    name: string,\n    factory: Factory & (Parameters<Factory> extends [unknown] ? unknown : never),\n  ): PreparedQuery<Parameters<Factory>[0], ReturnType<Factory>>;\n  stream<Row>(query: RowQuery<Row>, options?: StreamOptions<Row>): AsyncIterable<Row>;\n  session<T>(callback: (database: Database) => Promise<T>): Promise<T>;\n  tx<T>(callback: (database: Database) => Promise<T>): Promise<T>;\n  tx<T>(options: TransactionOptions, callback: (database: Database) => Promise<T>): Promise<T>;\n}\n\nexport interface BulkResult {\n  readonly inputCount: number;\n  readonly affectedRows?: number;\n}\n\nexport type QueryRow<Q> = Q extends Query<infer Row, QueryResultKind> ? Row : never;\n\nexport interface SqlTagLike<Kind extends QueryResultKind = QueryResultKind, Row = unknown> {\n  (strings: TemplateStringsArray, ...values: readonly unknown[]): Query<Row, Kind>;\n}\n\nexport interface RoutineContractTag<Contract extends RoutineContract> {\n  (strings: TemplateStringsArray, ...values: readonly unknown[]): CallQuery<RoutineResultFromContract<Contract>>;\n}\n\nexport interface RowsTag {\n  // Two type parameters keep this overload out of the sql.rows<Row> instantiation expression.\n  <Input, Output>(schema: StandardSchemaV1<Input, Output>): SqlTagLike<\"rows\", Output>;\n  <Row = unknown>(strings: TemplateStringsArray, ...values: readonly unknown[]): RowQuery<Row>;\n}\n\nexport interface SqlTag extends SqlTagLike<\"unknown\"> {\n  rows: RowsTag;\n  command: (strings: TemplateStringsArray, ...values: readonly unknown[]) => CommandQuery;\n  call: {\n    <Result extends RoutineCallResult = RoutineCallResult>(strings: TemplateStringsArray, ...values: readonly unknown[]): CallQuery<Result>;\n    <Contract extends RoutineContract>(contract: Contract): RoutineContractTag<Contract>;\n  };\n  bind<Input>(value: NoInfer<Input>, hint: ParameterTypeHint<Input>): BoundParameter<Input>;\n  out(name: string, hint?: ParameterTypeHint): RoutineParameter<null>;\n  inOut<Input>(name: string, value: NoInfer<Input>, hint?: ParameterTypeHint<Input>): RoutineParameter<Input>;\n  fragment: (strings: TemplateStringsArray, ...values: readonly unknown[]) => SqlFragment;\n  empty: SqlFragment;\n  ident: (identifier: string | readonly string[]) => SqlFragment;\n  raw: (text: string) => SqlFragment;\n  join: (items: readonly SqlFragment[], separator?: SqlFragment) => SqlFragment;\n  list: (values: readonly unknown[]) => SqlFragment;\n}\n\nexport class SqlRenderError extends Error {\n  readonly code: string;\n\n  constructor(code: string, message: string) {\n    super(message);\n    this.name = \"SqlRenderError\";\n    this.code = code;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@sqlbraid/core",
+  "version": "0.1.0-rc.0",
+  "description": "Core SQLBraid types and SQL template interfaces for typed database applications",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Clickin/SQLBraid.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/Clickin/SQLBraid#readme",
+  "bugs": {
+    "url": "https://github.com/Clickin/SQLBraid/issues"
+  },
+  "keywords": [
+    "sql",
+    "typescript",
+    "database",
+    "query"
+  ],
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@standard-schema/spec": "1.1.0"
+  }
+}