effect 4.0.0-beta.70 → 4.0.0-beta.72

package/dist/unstable/sql/SqlError.js

@@ -1,21 +1,37 @@
 /**
- * Structured SQL errors used by the unstable SQL APIs.
+ * Structured SQL failures for unstable SQL clients and driver integrations.
  *
- * This module defines the top-level `SqlError` wrapper, the concrete
- * `SqlErrorReason` variants used by drivers and adapters, and helpers for
- * recognizing and classifying database failures. It is useful when turning
- * native driver errors into typed Effect failures, choosing retry policies from
- * `isRetryable`, or distinguishing user-facing query problems such as syntax
- * and constraint failures from infrastructure problems such as connection,
- * lock, statement timeout, deadlock, and serialization failures.
+ * This module provides the top-level `SqlError` wrapper, the concrete
+ * `SqlErrorReason` variants used by adapters, schemas for encoding or decoding
+ * those errors, guards for recognizing them, and a SQLite classifier for native
+ * driver causes. The model keeps query mistakes, authentication and
+ * authorization failures, constraint violations, connection failures, lock
+ * waits, deadlocks, serialization conflicts, statement timeouts, and unknown
+ * failures distinguishable in the Effect error channel.
  *
- * Query, connection, and migration code should preserve the original cause and
- * operation metadata when constructing these errors. Retrying can be appropriate
- * for transient connection and concurrency failures, but syntax, authorization,
- * authentication, and constraint failures generally require changing the query,
- * credentials, permissions, or migration data. When classifying SQLite errors,
- * the helpers inspect `code` and `errno` values and extract unique constraint
- * names when available.
+ * **Mental model**
+ *
+ * `SqlError` wraps exactly one reason. Its `message`, `cause`, and
+ * `isRetryable` values are delegated to that reason, so recovery code can branch
+ * on either the reason tag or the retryability flag without losing the original
+ * native cause. Reasons are intentionally driver-neutral; adapters translate
+ * database-specific error codes into this shared vocabulary.
+ *
+ * **Common tasks**
+ *
+ * Construct a reason when adapting a driver failure, wrap it in `SqlError` for
+ * client APIs, use `isSqlError` or `isSqlErrorReason` at boundaries that receive
+ * unknown failures, and use `classifySqliteError` when mapping SQLite `code` or
+ * `errno` values.
+ *
+ * **Gotchas**
+ *
+ * Preserve the native `cause` and `operation` metadata when constructing these
+ * errors; they are often the only way to diagnose dialect-specific failures.
+ * Retryable reasons represent transient infrastructure or concurrency problems,
+ * while syntax, credential, permission, and constraint failures generally need a
+ * changed query, configuration, or data set. SQLite unique violations include a
+ * best-effort constraint name when one can be extracted.
  *
  * @since 4.0.0
  */
@@ -280,14 +296,14 @@ export class UnknownError extends /*#__PURE__*/Schema.TaggedErrorClass("effect/s
   }
 }
 /**
- * Schema union for encoding and decoding `SqlErrorReason` values.
+ * Schema for encoding and decoding SQL error reasons.
  *
  * @category schemas
  * @since 4.0.0
  */
 export const SqlErrorReason = /*#__PURE__*/Schema.Union([ConnectionError, AuthenticationError, AuthorizationError, SqlSyntaxError, UniqueViolation, ConstraintError, DeadlockError, SerializationError, LockTimeoutError, StatementTimeoutError, UnknownError]);
 /**
- * Top-level SQL error wrapper whose `message`, `cause`, and `isRetryable`
+ * Error wrapper for SQL failures whose `message`, `cause`, and `isRetryable`
  * values are derived from its `SqlErrorReason`.
  *
  * @category errors

package/dist/unstable/sql/SqlError.js.map

@@ -1 +1 @@
-{"version":3,"file":"SqlError.js","names":["Predicate","Schema","TypeId","ReasonTypeId","ReasonFields","cause","Defect","message","optional","String","operation","ConnectionError","TaggedErrorClass","isRetryable","AuthenticationError","AuthorizationError","SqlSyntaxError","UniqueViolationFields","constraint","UniqueViolation","ConstraintError","DeadlockError","SerializationError","LockTimeoutError","StatementTimeoutError","UnknownError","SqlErrorReason","Union","SqlError","reason","_tag","isSqlError","u","hasProperty","isSqlErrorReason","sqliteCodeFromCause","undefined","code","sqliteNumericCodeFromCause","errno","matchesSqliteNumericCode","expected","matchesSqliteCode","startsWith","UNKNOWN_CONSTRAINT","SQLITE_CONSTRAINT_UNIQUE","SQLITE_CONSTRAINT_UNIQUE_CODE","normalizeConstraintIdentifier","identifier","trimmed","trim","length","sqliteUniqueConstraintFromCause","prefix","index","indexOf","slice","classifySqliteError","props","numericCode","ResultLengthMismatch","Number","actual"],"sources":["../../../src/unstable/sql/SqlError.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"SqlError.js","names":["Predicate","Schema","TypeId","ReasonTypeId","ReasonFields","cause","Defect","message","optional","String","operation","ConnectionError","TaggedErrorClass","isRetryable","AuthenticationError","AuthorizationError","SqlSyntaxError","UniqueViolationFields","constraint","UniqueViolation","ConstraintError","DeadlockError","SerializationError","LockTimeoutError","StatementTimeoutError","UnknownError","SqlErrorReason","Union","SqlError","reason","_tag","isSqlError","u","hasProperty","isSqlErrorReason","sqliteCodeFromCause","undefined","code","sqliteNumericCodeFromCause","errno","matchesSqliteNumericCode","expected","matchesSqliteCode","startsWith","UNKNOWN_CONSTRAINT","SQLITE_CONSTRAINT_UNIQUE","SQLITE_CONSTRAINT_UNIQUE_CODE","normalizeConstraintIdentifier","identifier","trimmed","trim","length","sqliteUniqueConstraintFromCause","prefix","index","indexOf","slice","classifySqliteError","props","numericCode","ResultLengthMismatch","Number","actual"],"sources":["../../../src/unstable/sql/SqlError.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/sql/SqlResolver.d.ts

@@ -46,7 +46,7 @@ export interface SqlRequest<In, A, E, R> extends Request.Request<A, E | Schema.S
     readonly payload: In;
 }
 /**
- * Submits a payload as a `SqlRequest` to a request resolver, either directly
+ * Runs a payload as a `SqlRequest` through a request resolver, either directly
  * with a payload and resolver or curried by resolver.
  *
  * @category requests
@@ -54,7 +54,7 @@ export interface SqlRequest<In, A, E, R> extends Request.Request<A, E | Schema.S
  */
 export declare const request: {
     /**
-     * Submits a payload as a `SqlRequest` to a request resolver, either directly
+     * Runs a payload as a `SqlRequest` through a request resolver, either directly
      * with a payload and resolver or curried by resolver.
      *
      * @category requests
@@ -62,7 +62,7 @@ export declare const request: {
      */
     <In, A, E, R>(resolver: RequestResolver.RequestResolver<SqlRequest<In, A, E, R>>): (payload: In) => Effect.Effect<A, E | Schema.SchemaError, R>;
     /**
-     * Submits a payload as a `SqlRequest` to a request resolver, either directly
+     * Runs a payload as a `SqlRequest` through a request resolver, either directly
      * with a payload and resolver or curried by resolver.
      *
      * @category requests

package/dist/unstable/sql/SqlResolver.js

@@ -49,7 +49,7 @@ const SqlRequestProto = {
   }
 };
 /**
- * Submits a payload as a `SqlRequest` to a request resolver, either directly
+ * Runs a payload as a `SqlRequest` through a request resolver, either directly
  * with a payload and resolver or curried by resolver.
  *
  * @category requests

package/dist/unstable/sql/SqlSchema.d.ts

@@ -1,21 +1,36 @@
 /**
- * Schema-driven helpers for wrapping SQL executions in typed query functions.
- *
- * This module connects `Schema` request and result definitions to an `execute`
- * callback that runs the actual SQL statement. The returned functions accept
- * the request schema's decoded `Type`, encode it to the SQL-facing `Encoded`
- * shape, run the callback, and then decode unknown driver rows through the
- * result schema. This is useful for repository methods, CRUD helpers, request
- * resolvers, and write operations where callers should work with domain values
- * instead of raw SQL parameters or rows.
- *
- * The `execute` callback always receives `Req["Encoded"]`, so schema
- * transformations, required encoding services, and database representations
- * such as nullable columns, JSON values, dates, and bigints must line up with
- * the statement builder and dialect in use. Result schemas decode the rows
- * returned by the driver after any SQL client row transforms; `findOne` and
- * `findOneOption` only inspect the first row, `findNonEmpty` requires at least
- * one row, and `void` discards any driver result after request encoding.
+ * Wraps SQL execution callbacks with request encoding and result decoding.
+ *
+ * `SqlSchema` is a small adapter between Effect Schema and SQL statements. Each
+ * helper builds a function that accepts the decoded request type used by
+ * application code, encodes it before calling `execute`, and decodes unknown
+ * driver rows into the result schema. The helpers differ only in how many rows
+ * they expect and how they represent an empty result set.
+ *
+ * **Mental model**
+ *
+ * The request schema protects the boundary going into SQL, and the result
+ * schema protects the boundary coming back out. `execute` still owns statement
+ * construction and database execution; this module only shapes the values that
+ * cross that boundary.
+ *
+ * **Common tasks**
+ *
+ * - Use {@link findAll} for queries that may return any number of rows.
+ * - Use {@link findNonEmpty} when an empty result is a failure.
+ * - Use {@link findOne} when the first row is required.
+ * - Use {@link findOneOption} when the first row is optional.
+ * - Use `void` for writes where the encoded request matters but the driver
+ *   result should be discarded.
+ *
+ * **Gotchas**
+ *
+ * `execute` receives `Req["Encoded"]`, not `Req["Type"]`. Any schema
+ * transformations, encoding services, nullable columns, JSON values, dates, and
+ * bigint representations must match the SQL builder and dialect in use. Result
+ * schemas decode rows after SQL client row transforms have run. {@link findOne}
+ * and {@link findOneOption} only inspect the first returned row; they do not
+ * assert that the query returned exactly one row.
  *
  * @since 4.0.0
  */
@@ -25,8 +40,15 @@ import * as Effect from "../../Effect.ts";
 import type * as Option from "../../Option.ts";
 import * as Schema from "../../Schema.ts";
 /**
- * Builds a query function that encodes the request, decodes all result rows,
- * and fails with `NoSuchElementError` when the result set is empty.
+ * Builds a query function that encodes the request and decodes all result rows,
+ * allowing an empty result set.
+ *
+ * **When to use**
+ *
+ * Use when a query may return zero or more rows and an empty result should be
+ * represented as an empty array.
+ *
+ * @see {@link findNonEmpty} for queries where an empty result is a failure
  *
  * @category constructors
  * @since 4.0.0
@@ -37,7 +59,15 @@ export declare const findAll: <Req extends Schema.Top, Res extends Schema.Top, E
     readonly execute: (request: Req["Encoded"]) => Effect.Effect<ReadonlyArray<unknown>, E, R>;
 }) => (request: Req["Type"]) => Effect.Effect<Array<Res["Type"]>, E | Schema.SchemaError, Req["EncodingServices"] | Res["DecodingServices"] | R>;
 /**
- * Run a sql query with a request schema and a result schema.
+ * Builds a query function that encodes the request, decodes all result rows,
+ * and fails with `NoSuchElementError` when the result set is empty.
+ *
+ * **When to use**
+ *
+ * Use when a query must return at least one row and an empty result should be
+ * treated as a failure.
+ *
+ * @see {@link findAll} for queries where an empty result should return an empty array
  *
  * @category constructors
  * @since 4.0.0
@@ -53,7 +83,7 @@ declare const void_: <Req extends Schema.Top, E, R>(options: {
 }) => (request: Req["Type"]) => Effect.Effect<void, E | Schema.SchemaError, R | Req["EncodingServices"]>;
 export { 
 /**
- * Run a sql query with a request schema and discard the result.
+ * Runs a sql query with a request schema and discard the result.
  *
  * @category constructors
  * @since 4.0.0

package/dist/unstable/sql/SqlSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SqlSchema.d.ts","sourceRoot":"","sources":["../../../src/unstable/sql/SqlSchema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SqlSchema.d.ts","sourceRoot":"","sources":["../../../src/unstable/sql/SqlSchema.ts"],"names":[],"mappings":"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"}

package/dist/unstable/sql/SqlSchema.js

@@ -1,21 +1,36 @@
 /**
- * Schema-driven helpers for wrapping SQL executions in typed query functions.
- *
- * This module connects `Schema` request and result definitions to an `execute`
- * callback that runs the actual SQL statement. The returned functions accept
- * the request schema's decoded `Type`, encode it to the SQL-facing `Encoded`
- * shape, run the callback, and then decode unknown driver rows through the
- * result schema. This is useful for repository methods, CRUD helpers, request
- * resolvers, and write operations where callers should work with domain values
- * instead of raw SQL parameters or rows.
- *
- * The `execute` callback always receives `Req["Encoded"]`, so schema
- * transformations, required encoding services, and database representations
- * such as nullable columns, JSON values, dates, and bigints must line up with
- * the statement builder and dialect in use. Result schemas decode the rows
- * returned by the driver after any SQL client row transforms; `findOne` and
- * `findOneOption` only inspect the first row, `findNonEmpty` requires at least
- * one row, and `void` discards any driver result after request encoding.
+ * Wraps SQL execution callbacks with request encoding and result decoding.
+ *
+ * `SqlSchema` is a small adapter between Effect Schema and SQL statements. Each
+ * helper builds a function that accepts the decoded request type used by
+ * application code, encodes it before calling `execute`, and decodes unknown
+ * driver rows into the result schema. The helpers differ only in how many rows
+ * they expect and how they represent an empty result set.
+ *
+ * **Mental model**
+ *
+ * The request schema protects the boundary going into SQL, and the result
+ * schema protects the boundary coming back out. `execute` still owns statement
+ * construction and database execution; this module only shapes the values that
+ * cross that boundary.
+ *
+ * **Common tasks**
+ *
+ * - Use {@link findAll} for queries that may return any number of rows.
+ * - Use {@link findNonEmpty} when an empty result is a failure.
+ * - Use {@link findOne} when the first row is required.
+ * - Use {@link findOneOption} when the first row is optional.
+ * - Use `void` for writes where the encoded request matters but the driver
+ *   result should be discarded.
+ *
+ * **Gotchas**
+ *
+ * `execute` receives `Req["Encoded"]`, not `Req["Type"]`. Any schema
+ * transformations, encoding services, nullable columns, JSON values, dates, and
+ * bigint representations must match the SQL builder and dialect in use. Result
+ * schemas decode rows after SQL client row transforms have run. {@link findOne}
+ * and {@link findOneOption} only inspect the first returned row; they do not
+ * assert that the query returned exactly one row.
  *
  * @since 4.0.0
  */
@@ -24,8 +39,15 @@ import * as Cause from "../../Cause.js";
 import * as Effect from "../../Effect.js";
 import * as Schema from "../../Schema.js";
 /**
- * Builds a query function that encodes the request, decodes all result rows,
- * and fails with `NoSuchElementError` when the result set is empty.
+ * Builds a query function that encodes the request and decodes all result rows,
+ * allowing an empty result set.
+ *
+ * **When to use**
+ *
+ * Use when a query may return zero or more rows and an empty result should be
+ * represented as an empty array.
+ *
+ * @see {@link findNonEmpty} for queries where an empty result is a failure
  *
  * @category constructors
  * @since 4.0.0
@@ -36,7 +58,15 @@ export const findAll = options => {
   return request => Effect.flatMap(Effect.flatMap(encodeRequest(request), options.execute), decode);
 };
 /**
- * Run a sql query with a request schema and a result schema.
+ * Builds a query function that encodes the request, decodes all result rows,
+ * and fails with `NoSuchElementError` when the result set is empty.
+ *
+ * **When to use**
+ *
+ * Use when a query must return at least one row and an empty result should be
+ * treated as a failure.
+ *
+ * @see {@link findAll} for queries where an empty result should return an empty array
  *
  * @category constructors
  * @since 4.0.0
@@ -51,7 +81,7 @@ const void_ = options => {
 };
 export {
 /**
- * Run a sql query with a request schema and discard the result.
+ * Runs a sql query with a request schema and discard the result.
  *
  * @category constructors
  * @since 4.0.0

package/dist/unstable/sql/SqlSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"SqlSchema.js","names":["Arr","Cause","Effect","Schema","findAll","options","encodeRequest","encodeEffect","Request","decode","decodeUnknownEffect","mutable","Array","Result","request","flatMap","execute","findNonEmpty","find","results","isArrayNonEmpty","succeed","fail","NoSuchElementError","void_","encode","asVoid","void","findOne","arr","isReadonlyArrayNonEmpty","findOneOption","asSome","succeedNone"],"sources":["../../../src/unstable/sql/SqlSchema.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;AAqBA,OAAO,KAAKA,GAAG,MAAM,gBAAgB;AACrC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAEzC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAEzC;;;;;;;AAOA,OAAO,MAAMC,OAAO,GAClBC,OAIC,IACC;EACF,MAAMC,aAAa,GAAGH,MAAM,CAACI,YAAY,CAACF,OAAO,CAACG,OAAO,CAAC;EAC1D,MAAMC,MAAM,GAAGN,MAAM,CAACO,mBAAmB,CAACP,MAAM,CAACQ,OAAO,CAACR,MAAM,CAACS,KAAK,CAACP,OAAO,CAACQ,MAAM,CAAC,CAAC,CAAC;EACvF,OACEC,OAAoB,IAKjBZ,MAAM,CAACa,OAAO,CAACb,MAAM,CAACa,OAAO,CAACT,aAAa,CAACQ,OAAO,CAAC,EAAET,OAAO,CAACW,OAAO,CAAC,EAAEP,MAAM,CAAC;AACtF,CAAC;AAED;;;;;;AAMA,OAAO,MAAMQ,YAAY,GACvBZ,OAIC,IACC;EACF,MAAMa,IAAI,GAAGd,OAAO,CAACC,OAAO,CAAC;EAC7B,OACES,OAAoB,IAMpBZ,MAAM,CAACa,OAAO,CAACG,IAAI,CAACJ,OAAO,CAAC,EAAGK,OAAO,IACpCnB,GAAG,CAACoB,eAAe,CAACD,OAAO,CAAC,GACxBjB,MAAM,CAACmB,OAAO,CAACF,OAAO,CAAC,GACvBjB,MAAM,CAACoB,IAAI,CAAC,IAAIrB,KAAK,CAACsB,kBAAkB,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAMC,KAAK,GACTnB,OAGC,IACC;EACF,MAAMoB,MAAM,GAAGtB,MAAM,CAACI,YAAY,CAACF,OAAO,CAACG,OAAO,CAAC;EACnD,OAAQM,OAAoB,IAC1BZ,MAAM,CAACwB,MAAM,CACXxB,MAAM,CAACa,OAAO,CAACU,MAAM,CAACX,OAAO,CAAC,EAAET,OAAO,CAACW,OAAO,CAAC,CACjD;AACL,CAAC;AACD;AACE;;;;;;AAMAQ,KAAK,IAAIG,IAAI;AAGf;;;;;;;AAOA,OAAO,MAAMC,OAAO,GAClBvB,OAIC,IACC;EACF,MAAMC,aAAa,GAAGH,MAAM,CAACI,YAAY,CAACF,OAAO,CAACG,OAAO,CAAC;EAC1D,MAAMC,MAAM,GAAGN,MAAM,CAACO,mBAAmB,CAACL,OAAO,CAACQ,MAAM,CAAC;EACzD,OACEC,OAAoB,IAMpBZ,MAAM,CAACa,OAAO,CACZb,MAAM,CAACa,OAAO,CAACT,aAAa,CAACQ,OAAO,CAAC,EAAET,OAAO,CAACW,OAAO,CAAC,EACtDa,GAAG,IAIC7B,GAAG,CAAC8B,uBAAuB,CAACD,GAAG,CAAC,GAAGpB,MAAM,CAACoB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG3B,MAAM,CAACoB,IAAI,CAAC,IAAIrB,KAAK,CAACsB,kBAAkB,EAAE,CAAC,CACrG;AACL,CAAC;AAED;;;;;;;AAOA,OAAO,MAAMQ,aAAa,GACxB1B,OAIC,IACC;EACF,MAAMC,aAAa,GAAGH,MAAM,CAACI,YAAY,CAACF,OAAO,CAACG,OAAO,CAAC;EAC1D,MAAMC,MAAM,GAAGN,MAAM,CAACO,mBAAmB,CAACL,OAAO,CAACQ,MAAM,CAAC;EACzD,OACEC,OAAoB,IAMpBZ,MAAM,CAACa,OAAO,CACZb,MAAM,CAACa,OAAO,CAACT,aAAa,CAACQ,OAAO,CAAC,EAAET,OAAO,CAACW,OAAO,CAAC,EACtDa,GAAG,IAIC7B,GAAG,CAAC8B,uBAAuB,CAACD,GAAG,CAAC,GAAG3B,MAAM,CAAC8B,MAAM,CAACvB,MAAM,CAACoB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG3B,MAAM,CAAC+B,WAAW,CAC3F;AACL,CAAC","ignoreList":[]}
+{"version":3,"file":"SqlSchema.js","names":["Arr","Cause","Effect","Schema","findAll","options","encodeRequest","encodeEffect","Request","decode","decodeUnknownEffect","mutable","Array","Result","request","flatMap","execute","findNonEmpty","find","results","isArrayNonEmpty","succeed","fail","NoSuchElementError","void_","encode","asVoid","void","findOne","arr","isReadonlyArrayNonEmpty","findOneOption","asSome","succeedNone"],"sources":["../../../src/unstable/sql/SqlSchema.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/sql/Statement.d.ts

@@ -307,7 +307,7 @@ export interface Constructor {
      *
      * **When to use**
      *
-     * Useful for `ORDER BY` and `GROUP BY` clauses.
+     * Use when `ORDER BY` and `GROUP BY` clauses.
      */
     readonly csv: {
         (values: ReadonlyArray<string | Fragment>): Fragment;

package/dist/unstable/sql/Statement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Statement.d.ts","sourceRoot":"","sources":["../../../src/unstable/sql/Statement.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Statement.d.ts","sourceRoot":"","sources":["../../../src/unstable/sql/Statement.ts"],"names":[],"mappings":"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"}

package/dist/unstable/sql/Statement.js

@@ -1,20 +1,40 @@
 /**
- * Building blocks for Effect's unstable SQL statement API.
+ * Low-level SQL statement and fragment primitives.
  *
- * This module defines the low-level `Statement` and `Fragment` model used by
- * SQL clients, the tagged-template `Constructor` for creating executable
- * parameterized statements, and dialect compilers that turn statement segments
- * into SQL text plus bind parameters. It also provides helpers for escaped
- * identifiers, `IN` lists, comma-separated clause fragments, record inserts and
- * updates, custom segments, and row or identifier transforms.
+ * This module is the foundation used by SQL clients to build executable,
+ * parameterized SQL. It defines the {@link Statement} and {@link Fragment}
+ * models, the tagged-template {@link Constructor}, segment constructors for
+ * identifiers, parameters, literals, arrays, records, and custom dialect data,
+ * plus compilers that render those segments into dialect-specific SQL text and
+ * bind parameters.
  *
- * In tagged templates, interpolated `Fragment`s and known `Segment`s are
- * spliced into the statement, while ordinary values become bound parameters. Use
- * identifiers for table and column names and the record helpers for generated
- * column lists; `literal` and `unsafe` insert SQL text directly and should only
- * be used with trusted SQL. Compilation is dialect-specific, caches rendered SQL
- * on the statement, and has a `withoutTransform` path for bypassing identifier
- * transforms, so compiled output can differ from normal transformed execution.
+ * **Mental model**
+ *
+ * A statement is a sequence of {@link Segment} values. In a tagged template,
+ * nested fragments and known segments are spliced into that sequence, while
+ * ordinary interpolated values become bound parameters. A {@link Compiler}
+ * turns the sequence into SQL for one dialect, escaping identifiers and
+ * formatting placeholders for that dialect. Executing a {@link Statement} uses
+ * the connection acquirer captured by {@link make} and can return rows, raw
+ * results, streams, values, or unprepared execution paths.
+ *
+ * **Common tasks**
+ *
+ * - Build statements with a {@link Constructor} tagged template
+ * - Use {@link identifier} for table and column names rather than interpolating
+ *   plain strings
+ * - Compose optional clauses with {@link and}, {@link or}, {@link csv}, and
+ *   {@link join}
+ * - Create insert and update fragments with record helpers
+ * - Add custom segment handling with {@link custom} and {@link makeCompiler}
+ *
+ * **Gotchas**
+ *
+ * Bound parameters protect values, not SQL syntax. Use `literal` and `unsafe`
+ * only for trusted SQL text, and use identifiers for names that need escaping.
+ * Compiled SQL is dialect-specific and cached on the statement;
+ * `withoutTransform` intentionally bypasses identifier or row transforms, so
+ * its output can differ from normal execution.
  *
  * @since 4.0.0
  */