//#region src/db/do-sql-types.d.ts
/**
 * Shared Durable Object SQL types and config (production)
 *
 * Imported by both the config-time entry (index.ts) and the runtime entries
 * (do-sql.ts, do-sql-dialect.ts, do-sql-class.ts). This module must NOT import
 * from cloudflare:workers so it stays safe at config time and in tests.
 */
/**
 * Durable Object SQL database configuration.
 *
 * One DO instance holds the whole CMS database (a single SQLite file).
 * With `session: "auto"` and the `experimental` + `replica_routing`
 * compatibility flags enabled, reads route to the nearest replica and writes
 * are proxied to the primary, with bookmark-based read-your-writes.
 */
interface DurableObjectsConfig {
  /** Wrangler binding name for the DO namespace (class `EmDashDB`). */
  binding: string;
  /**
   * Name of the singleton DO instance that holds the database.
   *
   * One DO == one SQLite database == the whole CMS. Defaults to `"emdash"`.
   * Override only if you intentionally run multiple isolated databases
   * behind a single binding.
   *
   * @default "emdash"
   */
  name?: string;
  /**
   * Read-replication routing mode.
   *
   * - `"disabled"` — every query goes to the single primary DO. (default)
   * - `"auto"` — anonymous reads route to the nearest replica; writes are
   *   proxied to the primary, and authenticated requests get read-your-writes
   *   consistency via a bookmark cookie.
   *
   * `"auto"` requires the `experimental` and `replica_routing` compatibility
   * flags in wrangler. `EmDashDB` enables replication on the primary
   * automatically (via `ctx.storage.enableReplicas()`).
   *
   * @default "disabled"
   */
  session?: "disabled" | "auto";
  /**
   * Cookie name for the read-your-writes bookmark.
   * Only used when `session` is `"auto"`.
   *
   * @default "__em_do_bookmark"
   */
  bookmarkCookie?: string;
}
/** A single statement for `batchQuery`. */
interface DOQueryStatement {
  sql: string;
  params?: unknown[];
}
/** Result shape returned by the `EmDashDB` RPC methods. */
interface DOQueryResult {
  rows: Record<string, unknown>[];
  /** Rows written. `undefined` for read-only statements. */
  changes?: number;
  /**
   * Replication bookmark captured after a write, used for read-your-writes.
   * `undefined` for reads or when replication is not enabled.
   */
  bookmark?: string;
}
//#endregion
export { DOQueryStatement as n, DurableObjectsConfig as r, DOQueryResult as t };