dbgate-sqlite-dumper 0.1.0 → 0.1.1

package/dist/index.d.cts

@@ -1,6 +1,8 @@
-import { a as SqliteConnectionInput, A as AcquiredSqliteConnection, S as SqliteConnection, b as SqliteExecResult, c as SqliteRow, d as SqliteErrorInfo } from './types-CTyJTzB6.cjs';
-export { e as SqliteColumnValue, f as SqliteConnectionSource, g as SqliteParameterValue, h as SqliteQuery, i as SqliteQueryResult, j as SqliteStreamOptions, k as isSqliteConnectionSource } from './types-CTyJTzB6.cjs';
+import { b as SqliteConnectionInput, A as AcquiredSqliteConnection, S as SqliteConnection, c as SqliteExecResult, d as SqliteRow, e as SqliteErrorInfo } from './types-DziV5ysl.cjs';
+export { f as SqliteColumnValue, a as SqliteConnectionFeatures, g as SqliteConnectionSource, h as SqliteParameterValue, i as SqliteQuery, j as SqliteQueryResult, k as SqliteStreamOptions, l as isSqliteConnectionSource } from './types-DziV5ysl.cjs';
 import { Writable, Readable } from 'node:stream';
+import { S as SqliteDumperError } from './errors-CplNzuYs.cjs';
+export { O as OperationCancelledError, i as isAbortError, t as throwIfAborted } from './errors-CplNzuYs.cjs';
 
 /**
  * Normalizes a {@link SqliteConnectionInput} into an acquired connection with
@@ -22,6 +24,23 @@ declare function executeStatement(connection: SqliteConnection, sql: string, sig
 declare function toNumber(value: unknown, fallback?: number): number;
 /** Coerces a text-valued catalog cell to a string, or `null` for SQL `NULL`. */
 declare function toText(value: unknown): string | null;
+/**
+ * Bytes as a `Buffer`, from any shape a driver returns them in: `Buffer`,
+ * `Uint8Array`, `ArrayBuffer` (libSQL), or an array of byte values (the
+ * JSON transport of Cloudflare D1).
+ */
+declare function toBuffer(value: Uint8Array | ArrayBuffer | readonly number[]): Buffer;
+/** {@link SqliteConnectionFeatures} with every default filled in. */
+interface ResolvedConnectionFeatures {
+    readonly transactions: boolean;
+    readonly pragmaFunctions: boolean;
+    readonly extendedPragmas: boolean;
+    readonly schemaQualifiedNames: boolean;
+    readonly binaryTransport: 'native' | 'hex';
+    readonly pagedReadSize: number | undefined;
+    readonly reservedNamePrefixes: readonly string[];
+}
+declare function connectionFeatures(connection: SqliteConnection): ResolvedConnectionFeatures;
 
 /**
  * How a dump obtains a consistent view of the database.
@@ -48,6 +67,12 @@ interface SqliteDumpSession {
      * uncommitted changes. Reported so a caller can tell.
      */
     readonly joinedExistingTransaction: boolean;
+    /**
+     * `true` when a snapshot was asked for but the engine has no transactions
+     * (see `SqliteConnectionFeatures.transactions`), so the session reads
+     * without one and {@link consistency} is `'none'`.
+     */
+    readonly snapshotUnavailable: boolean;
     /**
      * Ends the read transaction. Idempotent. Never throws for a handle that is
      * already closed — cleanup must not mask the error that caused it.
@@ -721,6 +746,9 @@ interface SqliteIntrospectionResult {
  * to the plain `PRAGMA` statements otherwise.
  *
  * Runs entirely on the one handle it is given, in sequence, and never writes.
+ * A handle that declares {@link SqliteConnection.features} restrictions is
+ * read with the equivalent queries it does allow; one that has
+ * {@link SqliteConnection.queryBatch} gets the per-table catalog in batches.
  */
 declare function introspectSqlite(connection: SqliteConnection, options?: IntrospectSqliteOptions, signal?: AbortSignal): Promise<SqliteIntrospectionResult>;
 
@@ -1032,6 +1060,13 @@ interface TableDataExportRequest {
      * `ArchiveEntry.systemRowFilter`.
      */
     readonly systemRowFilter?: readonly string[];
+    /**
+     * The table's primary-key index (`origin` `pk`), for a `WITHOUT ROWID`
+     * table read in pages: it gives the key order — direction and collation
+     * of each column — that the pages follow. See
+     * `SqliteConnectionFeatures.pagedReadSize`.
+     */
+    readonly primaryKeyIndex?: SqliteIndex;
     readonly options?: TableDataExportOptions;
     readonly signal?: AbortSignal;
     readonly onProgress?: DumpProgressCallback;
@@ -1071,6 +1106,21 @@ declare class SqlChunkBuilder {
     build(): string | Buffer;
 }
 
+/**
+ * How the bytes of text and blob values travel from SQLite to this package.
+ *
+ * Natively they arrive as bytes. Over a transport that cannot carry bytes
+ * exactly — JSON, for Cloudflare D1 — SQLite is asked for their `hex()`
+ * instead, which any transport carries as plain ASCII text.
+ */
+interface SqliteValueTransport {
+    /** Text values (in a UTF-8 database) are read as `hex()` of their bytes. */
+    readonly hexText: boolean;
+    /** Blob values are read as `hex()`. */
+    readonly hexBlob: boolean;
+}
+declare const NATIVE_VALUE_TRANSPORT: SqliteValueTransport;
+declare function valueTransport(utf8Database: boolean, binaryTransport: 'native' | 'hex'): SqliteValueTransport;
 /**
  * The select-list for one column: its storage class, and a value shaped so
  * that only exact representations cross the driver boundary.
@@ -1084,8 +1134,11 @@ declare class SqlChunkBuilder {
  *   read as text instead and the driver's (lossless, for valid UTF-16)
  *   conversion is used;
  * - `BLOB` → the bytes; `NULL` → `NULL`.
+ *
+ * With a hex {@link SqliteValueTransport}, text and blob bytes are read as
+ * `hex()` text instead.
  */
-declare function columnValueSelect(column: string, index: number, utf8Database: boolean): string;
+declare function columnValueSelect(column: string, index: number, utf8Database: boolean, transport?: SqliteValueTransport): string;
 /**
  * Renders column `index` of a row produced by {@link columnValueSelect} as
  * the SQL literal the native `.dump` writes for it.
@@ -1095,7 +1148,7 @@ declare function columnValueSelect(column: string, index: number, utf8Database:
  * stored value exactly (see `DumpWriter` for why that cannot go through a
  * string).
  */
-declare function renderColumnLiteral(row: SqliteRow, index: number, textStyle: TextLiteralStyle): string | Buffer;
+declare function renderColumnLiteral(row: SqliteRow, index: number, textStyle: TextLiteralStyle, transport?: SqliteValueTransport): string | Buffer;
 
 /**
  * The columns the native `.dump` inserts: those `PRAGMA table_info` lists,
@@ -1246,25 +1299,6 @@ interface StatementSourceLocation {
  */
 type SqlDumpSource = string | Buffer | Uint8Array | Readable | AsyncIterable<string | Buffer | Uint8Array>;
 
-/** Base class for every error this package throws intentionally. */
-declare class SqliteDumperError extends Error {
-    readonly code: string;
-    constructor(code: string, message: string, options?: {
-        cause?: unknown;
-    });
-}
-/** Thrown when an operation stops because its `AbortSignal` was triggered. */
-declare class OperationCancelledError extends SqliteDumperError {
-    constructor(message?: string);
-}
-declare function throwIfAborted(signal: AbortSignal | undefined): void;
-/**
- * True for both cancellation shapes this package can observe: its own
- * {@link OperationCancelledError} and the `DOMException` an `AbortSignal`
- * (or a Node stream aborted through one) raises.
- */
-declare function isAbortError(error: unknown): boolean;
-
 /** Common base for every error {@link restoreSqlDump} (or its parser) throws intentionally. */
 declare class RestoreError extends SqliteDumperError {
 }
@@ -1890,4 +1924,4 @@ interface DumpResult {
  */
 declare function dumpSqlite(connectionInput: SqliteConnectionInput, options: DumpSqliteOptions, output: Writable, onProgress?: DumpProgressCallback, signal?: AbortSignal): Promise<DumpResult>;
 
-export { AcquiredSqliteConnection, type ArchiveCycle, type ArchiveDependency, type ArchiveDependencyStrength, type ArchiveEntry, type ArchiveIdentityInput, type ArchiveObjectType, BufferDumpWriter, COMPLETE_TRANSITIONS, CompleteToken, DEFENSIVE_WARNING_COMMENT, type DotCommandPolicy, type DroppableKind, type DumpArchiveInspection, type DumpMode, type DumpObjectKinds, type DumpProgressCallback, type DumpProgressEvent, type DumpProgressPhase, type DumpProgressSection, type DumpResult, type DumpSection, type DumpSelection, type DumpSqliteOptions, type DumpWriter, type InspectDumpArchiveOptions, type IntrospectSqliteOptions, InvalidTextEncodingError, MalformedSqlDumpError, type NormalizedDumpSelection, OperationCancelledError, type ParsedStatement, type PlainSqlRenderOptions, type PlainSqlRenderRequest, type PlainSqlRenderResult, type PreflightRestoreReport, type PreflightRestoreRequest, type ResolvedPlainSqlRenderOptions, RestoreError, RestoreExecutionError, type RestoreOptions, type RestoreProgressCallback, type RestoreProgressEvent, type RestoreProgressPhase, RestoreSessionState, type RestoreStatementError, type RestoreWarning, SEQUENCE_TABLE_NAME, SESSION_GUARD_FOOTER, SESSION_GUARD_HEADER, SQLITE_KEYWORD_COUNT, type SkippedDotCommand, SqlChunkBuilder, type SqlDumpRestoreRequest, type SqlDumpRestoreResult, type SqlDumpSource, SqlParseError, SqlStatementParser, type SqlStatementParserOptions, type SqliteCapabilities, type SqliteColumn, type SqliteColumnHidden, SqliteConnection, SqliteConnectionInput, type SqliteConsistencyMode, type SqliteDatabase, type SqliteDiagnostic, type SqliteDiagnosticSeverity, type SqliteDumpSession, type SqliteDumpSessionOptions, SqliteDumperError, SqliteErrorInfo, SqliteExecResult, type SqliteForeignKey, type SqliteForeignKeyColumn, type SqliteIndex, type SqliteIndexColumn, type SqliteIntrospectionResult, type SqliteObjectKind, type SqliteObjectReference, SqliteRow, type SqliteSequence, type SqliteTable, type SqliteTableKind, type SqliteTrigger, type SqliteVersion, type SqliteView, type StatementInfo, type StatementSourceLocation, StatementTooLargeError, StreamDumpWriter, type TableDataExportOptions, type TableDataExportRequest, type TableDataExportResult, type TargetCapabilities, type TargetCompatibilityOptions, type TextLiteralStyle, UNSUPPORTED_FEATURES, type UnsatisfiedDependency, UnsupportedClientCommandError, WRITABLE_SCHEMA_OFF, WRITABLE_SCHEMA_ON, acquireSqliteConnection, assignDumpSection, beginSqliteDumpSession, checkTargetCompatibility, classifyWord, columnValueSelect, completeTransition, createArchiveIdentity, createCanonicalIdentity, createDumpId, declaresAutoincrement, decodeStatementBytes, describeStatement, detectSqliteCapabilities, detectSqliteVersion, detectSqliteCapabilities as detectTargetCapabilities, dumpSectionPriority, dumpSqlite, executeStatement, exportTableDataAsInserts, foldSqliteName, insertableColumns, inspectDumpArchive, introspectSqlite, isAbortError, isCompleteStatement, isIdentifierCharCode, isIndexSelected, isSchemaTableName, isSqliteDump, isSqliteKeyword, isStatisticsTableName, isTableDataExcluded, isTableSelected, isTriggerSelected, isTruthyPragmaValue, isViewSelected, maskSqlLiterals, needsIdentifierQuoting, normalizeDumpSelection, parseSqlStatements, parseSqliteVersion, parseTableOptions, parseVirtualTableModule, preflightRestore, preservableRowidName, quoteIdentifier, quoteIdentifierIfNeeded, quoteQualifiedIdentifier, quoteStringLiteral, redactSecrets, renderBlobLiteral, renderColumnLiteral, renderDatabaseSettings, renderDrop, renderEscapedStringLiteral, renderPlainSql, renderQuotedStringLiteral, renderSchemaLine, renderSchemaObject, renderSystemTablePrelude, renderTextLiteral, renderVirtualTable, resolvePlainSqlRenderOptions, restoreSqlDump, safeSqlPreview, streamSqlStatements, streamWithParser, tableGroupPriority, throwIfAborted, toAsciiLowerCase, toAsciiUpperCase, toByteStringChunks, toNumber, toText, unsupportedFeatureDiagnostics };
+export { AcquiredSqliteConnection, type ArchiveCycle, type ArchiveDependency, type ArchiveDependencyStrength, type ArchiveEntry, type ArchiveIdentityInput, type ArchiveObjectType, BufferDumpWriter, COMPLETE_TRANSITIONS, CompleteToken, DEFENSIVE_WARNING_COMMENT, type DotCommandPolicy, type DroppableKind, type DumpArchiveInspection, type DumpMode, type DumpObjectKinds, type DumpProgressCallback, type DumpProgressEvent, type DumpProgressPhase, type DumpProgressSection, type DumpResult, type DumpSection, type DumpSelection, type DumpSqliteOptions, type DumpWriter, type InspectDumpArchiveOptions, type IntrospectSqliteOptions, InvalidTextEncodingError, MalformedSqlDumpError, NATIVE_VALUE_TRANSPORT, type NormalizedDumpSelection, type ParsedStatement, type PlainSqlRenderOptions, type PlainSqlRenderRequest, type PlainSqlRenderResult, type PreflightRestoreReport, type PreflightRestoreRequest, type ResolvedConnectionFeatures, type ResolvedPlainSqlRenderOptions, RestoreError, RestoreExecutionError, type RestoreOptions, type RestoreProgressCallback, type RestoreProgressEvent, type RestoreProgressPhase, RestoreSessionState, type RestoreStatementError, type RestoreWarning, SEQUENCE_TABLE_NAME, SESSION_GUARD_FOOTER, SESSION_GUARD_HEADER, SQLITE_KEYWORD_COUNT, type SkippedDotCommand, SqlChunkBuilder, type SqlDumpRestoreRequest, type SqlDumpRestoreResult, type SqlDumpSource, SqlParseError, SqlStatementParser, type SqlStatementParserOptions, type SqliteCapabilities, type SqliteColumn, type SqliteColumnHidden, SqliteConnection, SqliteConnectionInput, type SqliteConsistencyMode, type SqliteDatabase, type SqliteDiagnostic, type SqliteDiagnosticSeverity, type SqliteDumpSession, type SqliteDumpSessionOptions, SqliteDumperError, SqliteErrorInfo, SqliteExecResult, type SqliteForeignKey, type SqliteForeignKeyColumn, type SqliteIndex, type SqliteIndexColumn, type SqliteIntrospectionResult, type SqliteObjectKind, type SqliteObjectReference, SqliteRow, type SqliteSequence, type SqliteTable, type SqliteTableKind, type SqliteTrigger, type SqliteValueTransport, type SqliteVersion, type SqliteView, type StatementInfo, type StatementSourceLocation, StatementTooLargeError, StreamDumpWriter, type TableDataExportOptions, type TableDataExportRequest, type TableDataExportResult, type TargetCapabilities, type TargetCompatibilityOptions, type TextLiteralStyle, UNSUPPORTED_FEATURES, type UnsatisfiedDependency, UnsupportedClientCommandError, WRITABLE_SCHEMA_OFF, WRITABLE_SCHEMA_ON, acquireSqliteConnection, assignDumpSection, beginSqliteDumpSession, checkTargetCompatibility, classifyWord, columnValueSelect, completeTransition, connectionFeatures, createArchiveIdentity, createCanonicalIdentity, createDumpId, declaresAutoincrement, decodeStatementBytes, describeStatement, detectSqliteCapabilities, detectSqliteVersion, detectSqliteCapabilities as detectTargetCapabilities, dumpSectionPriority, dumpSqlite, executeStatement, exportTableDataAsInserts, foldSqliteName, insertableColumns, inspectDumpArchive, introspectSqlite, isCompleteStatement, isIdentifierCharCode, isIndexSelected, isSchemaTableName, isSqliteDump, isSqliteKeyword, isStatisticsTableName, isTableDataExcluded, isTableSelected, isTriggerSelected, isTruthyPragmaValue, isViewSelected, maskSqlLiterals, needsIdentifierQuoting, normalizeDumpSelection, parseSqlStatements, parseSqliteVersion, parseTableOptions, parseVirtualTableModule, preflightRestore, preservableRowidName, quoteIdentifier, quoteIdentifierIfNeeded, quoteQualifiedIdentifier, quoteStringLiteral, redactSecrets, renderBlobLiteral, renderColumnLiteral, renderDatabaseSettings, renderDrop, renderEscapedStringLiteral, renderPlainSql, renderQuotedStringLiteral, renderSchemaLine, renderSchemaObject, renderSystemTablePrelude, renderTextLiteral, renderVirtualTable, resolvePlainSqlRenderOptions, restoreSqlDump, safeSqlPreview, streamSqlStatements, streamWithParser, tableGroupPriority, toAsciiLowerCase, toAsciiUpperCase, toBuffer, toByteStringChunks, toNumber, toText, unsupportedFeatureDiagnostics, valueTransport };

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-import { a as SqliteConnectionInput, A as AcquiredSqliteConnection, S as SqliteConnection, b as SqliteExecResult, c as SqliteRow, d as SqliteErrorInfo } from './types-CTyJTzB6.js';
-export { e as SqliteColumnValue, f as SqliteConnectionSource, g as SqliteParameterValue, h as SqliteQuery, i as SqliteQueryResult, j as SqliteStreamOptions, k as isSqliteConnectionSource } from './types-CTyJTzB6.js';
+import { b as SqliteConnectionInput, A as AcquiredSqliteConnection, S as SqliteConnection, c as SqliteExecResult, d as SqliteRow, e as SqliteErrorInfo } from './types-DziV5ysl.js';
+export { f as SqliteColumnValue, a as SqliteConnectionFeatures, g as SqliteConnectionSource, h as SqliteParameterValue, i as SqliteQuery, j as SqliteQueryResult, k as SqliteStreamOptions, l as isSqliteConnectionSource } from './types-DziV5ysl.js';
 import { Writable, Readable } from 'node:stream';
+import { S as SqliteDumperError } from './errors-CplNzuYs.js';
+export { O as OperationCancelledError, i as isAbortError, t as throwIfAborted } from './errors-CplNzuYs.js';
 
 /**
  * Normalizes a {@link SqliteConnectionInput} into an acquired connection with
@@ -22,6 +24,23 @@ declare function executeStatement(connection: SqliteConnection, sql: string, sig
 declare function toNumber(value: unknown, fallback?: number): number;
 /** Coerces a text-valued catalog cell to a string, or `null` for SQL `NULL`. */
 declare function toText(value: unknown): string | null;
+/**
+ * Bytes as a `Buffer`, from any shape a driver returns them in: `Buffer`,
+ * `Uint8Array`, `ArrayBuffer` (libSQL), or an array of byte values (the
+ * JSON transport of Cloudflare D1).
+ */
+declare function toBuffer(value: Uint8Array | ArrayBuffer | readonly number[]): Buffer;
+/** {@link SqliteConnectionFeatures} with every default filled in. */
+interface ResolvedConnectionFeatures {
+    readonly transactions: boolean;
+    readonly pragmaFunctions: boolean;
+    readonly extendedPragmas: boolean;
+    readonly schemaQualifiedNames: boolean;
+    readonly binaryTransport: 'native' | 'hex';
+    readonly pagedReadSize: number | undefined;
+    readonly reservedNamePrefixes: readonly string[];
+}
+declare function connectionFeatures(connection: SqliteConnection): ResolvedConnectionFeatures;
 
 /**
  * How a dump obtains a consistent view of the database.
@@ -48,6 +67,12 @@ interface SqliteDumpSession {
      * uncommitted changes. Reported so a caller can tell.
      */
     readonly joinedExistingTransaction: boolean;
+    /**
+     * `true` when a snapshot was asked for but the engine has no transactions
+     * (see `SqliteConnectionFeatures.transactions`), so the session reads
+     * without one and {@link consistency} is `'none'`.
+     */
+    readonly snapshotUnavailable: boolean;
     /**
      * Ends the read transaction. Idempotent. Never throws for a handle that is
      * already closed — cleanup must not mask the error that caused it.
@@ -721,6 +746,9 @@ interface SqliteIntrospectionResult {
  * to the plain `PRAGMA` statements otherwise.
  *
  * Runs entirely on the one handle it is given, in sequence, and never writes.
+ * A handle that declares {@link SqliteConnection.features} restrictions is
+ * read with the equivalent queries it does allow; one that has
+ * {@link SqliteConnection.queryBatch} gets the per-table catalog in batches.
  */
 declare function introspectSqlite(connection: SqliteConnection, options?: IntrospectSqliteOptions, signal?: AbortSignal): Promise<SqliteIntrospectionResult>;
 
@@ -1032,6 +1060,13 @@ interface TableDataExportRequest {
      * `ArchiveEntry.systemRowFilter`.
      */
     readonly systemRowFilter?: readonly string[];
+    /**
+     * The table's primary-key index (`origin` `pk`), for a `WITHOUT ROWID`
+     * table read in pages: it gives the key order — direction and collation
+     * of each column — that the pages follow. See
+     * `SqliteConnectionFeatures.pagedReadSize`.
+     */
+    readonly primaryKeyIndex?: SqliteIndex;
     readonly options?: TableDataExportOptions;
     readonly signal?: AbortSignal;
     readonly onProgress?: DumpProgressCallback;
@@ -1071,6 +1106,21 @@ declare class SqlChunkBuilder {
     build(): string | Buffer;
 }
 
+/**
+ * How the bytes of text and blob values travel from SQLite to this package.
+ *
+ * Natively they arrive as bytes. Over a transport that cannot carry bytes
+ * exactly — JSON, for Cloudflare D1 — SQLite is asked for their `hex()`
+ * instead, which any transport carries as plain ASCII text.
+ */
+interface SqliteValueTransport {
+    /** Text values (in a UTF-8 database) are read as `hex()` of their bytes. */
+    readonly hexText: boolean;
+    /** Blob values are read as `hex()`. */
+    readonly hexBlob: boolean;
+}
+declare const NATIVE_VALUE_TRANSPORT: SqliteValueTransport;
+declare function valueTransport(utf8Database: boolean, binaryTransport: 'native' | 'hex'): SqliteValueTransport;
 /**
  * The select-list for one column: its storage class, and a value shaped so
  * that only exact representations cross the driver boundary.
@@ -1084,8 +1134,11 @@ declare class SqlChunkBuilder {
  *   read as text instead and the driver's (lossless, for valid UTF-16)
  *   conversion is used;
  * - `BLOB` → the bytes; `NULL` → `NULL`.
+ *
+ * With a hex {@link SqliteValueTransport}, text and blob bytes are read as
+ * `hex()` text instead.
  */
-declare function columnValueSelect(column: string, index: number, utf8Database: boolean): string;
+declare function columnValueSelect(column: string, index: number, utf8Database: boolean, transport?: SqliteValueTransport): string;
 /**
  * Renders column `index` of a row produced by {@link columnValueSelect} as
  * the SQL literal the native `.dump` writes for it.
@@ -1095,7 +1148,7 @@ declare function columnValueSelect(column: string, index: number, utf8Database:
  * stored value exactly (see `DumpWriter` for why that cannot go through a
  * string).
  */
-declare function renderColumnLiteral(row: SqliteRow, index: number, textStyle: TextLiteralStyle): string | Buffer;
+declare function renderColumnLiteral(row: SqliteRow, index: number, textStyle: TextLiteralStyle, transport?: SqliteValueTransport): string | Buffer;
 
 /**
  * The columns the native `.dump` inserts: those `PRAGMA table_info` lists,
@@ -1246,25 +1299,6 @@ interface StatementSourceLocation {
  */
 type SqlDumpSource = string | Buffer | Uint8Array | Readable | AsyncIterable<string | Buffer | Uint8Array>;
 
-/** Base class for every error this package throws intentionally. */
-declare class SqliteDumperError extends Error {
-    readonly code: string;
-    constructor(code: string, message: string, options?: {
-        cause?: unknown;
-    });
-}
-/** Thrown when an operation stops because its `AbortSignal` was triggered. */
-declare class OperationCancelledError extends SqliteDumperError {
-    constructor(message?: string);
-}
-declare function throwIfAborted(signal: AbortSignal | undefined): void;
-/**
- * True for both cancellation shapes this package can observe: its own
- * {@link OperationCancelledError} and the `DOMException` an `AbortSignal`
- * (or a Node stream aborted through one) raises.
- */
-declare function isAbortError(error: unknown): boolean;
-
 /** Common base for every error {@link restoreSqlDump} (or its parser) throws intentionally. */
 declare class RestoreError extends SqliteDumperError {
 }
@@ -1890,4 +1924,4 @@ interface DumpResult {
  */
 declare function dumpSqlite(connectionInput: SqliteConnectionInput, options: DumpSqliteOptions, output: Writable, onProgress?: DumpProgressCallback, signal?: AbortSignal): Promise<DumpResult>;
 
-export { AcquiredSqliteConnection, type ArchiveCycle, type ArchiveDependency, type ArchiveDependencyStrength, type ArchiveEntry, type ArchiveIdentityInput, type ArchiveObjectType, BufferDumpWriter, COMPLETE_TRANSITIONS, CompleteToken, DEFENSIVE_WARNING_COMMENT, type DotCommandPolicy, type DroppableKind, type DumpArchiveInspection, type DumpMode, type DumpObjectKinds, type DumpProgressCallback, type DumpProgressEvent, type DumpProgressPhase, type DumpProgressSection, type DumpResult, type DumpSection, type DumpSelection, type DumpSqliteOptions, type DumpWriter, type InspectDumpArchiveOptions, type IntrospectSqliteOptions, InvalidTextEncodingError, MalformedSqlDumpError, type NormalizedDumpSelection, OperationCancelledError, type ParsedStatement, type PlainSqlRenderOptions, type PlainSqlRenderRequest, type PlainSqlRenderResult, type PreflightRestoreReport, type PreflightRestoreRequest, type ResolvedPlainSqlRenderOptions, RestoreError, RestoreExecutionError, type RestoreOptions, type RestoreProgressCallback, type RestoreProgressEvent, type RestoreProgressPhase, RestoreSessionState, type RestoreStatementError, type RestoreWarning, SEQUENCE_TABLE_NAME, SESSION_GUARD_FOOTER, SESSION_GUARD_HEADER, SQLITE_KEYWORD_COUNT, type SkippedDotCommand, SqlChunkBuilder, type SqlDumpRestoreRequest, type SqlDumpRestoreResult, type SqlDumpSource, SqlParseError, SqlStatementParser, type SqlStatementParserOptions, type SqliteCapabilities, type SqliteColumn, type SqliteColumnHidden, SqliteConnection, SqliteConnectionInput, type SqliteConsistencyMode, type SqliteDatabase, type SqliteDiagnostic, type SqliteDiagnosticSeverity, type SqliteDumpSession, type SqliteDumpSessionOptions, SqliteDumperError, SqliteErrorInfo, SqliteExecResult, type SqliteForeignKey, type SqliteForeignKeyColumn, type SqliteIndex, type SqliteIndexColumn, type SqliteIntrospectionResult, type SqliteObjectKind, type SqliteObjectReference, SqliteRow, type SqliteSequence, type SqliteTable, type SqliteTableKind, type SqliteTrigger, type SqliteVersion, type SqliteView, type StatementInfo, type StatementSourceLocation, StatementTooLargeError, StreamDumpWriter, type TableDataExportOptions, type TableDataExportRequest, type TableDataExportResult, type TargetCapabilities, type TargetCompatibilityOptions, type TextLiteralStyle, UNSUPPORTED_FEATURES, type UnsatisfiedDependency, UnsupportedClientCommandError, WRITABLE_SCHEMA_OFF, WRITABLE_SCHEMA_ON, acquireSqliteConnection, assignDumpSection, beginSqliteDumpSession, checkTargetCompatibility, classifyWord, columnValueSelect, completeTransition, createArchiveIdentity, createCanonicalIdentity, createDumpId, declaresAutoincrement, decodeStatementBytes, describeStatement, detectSqliteCapabilities, detectSqliteVersion, detectSqliteCapabilities as detectTargetCapabilities, dumpSectionPriority, dumpSqlite, executeStatement, exportTableDataAsInserts, foldSqliteName, insertableColumns, inspectDumpArchive, introspectSqlite, isAbortError, isCompleteStatement, isIdentifierCharCode, isIndexSelected, isSchemaTableName, isSqliteDump, isSqliteKeyword, isStatisticsTableName, isTableDataExcluded, isTableSelected, isTriggerSelected, isTruthyPragmaValue, isViewSelected, maskSqlLiterals, needsIdentifierQuoting, normalizeDumpSelection, parseSqlStatements, parseSqliteVersion, parseTableOptions, parseVirtualTableModule, preflightRestore, preservableRowidName, quoteIdentifier, quoteIdentifierIfNeeded, quoteQualifiedIdentifier, quoteStringLiteral, redactSecrets, renderBlobLiteral, renderColumnLiteral, renderDatabaseSettings, renderDrop, renderEscapedStringLiteral, renderPlainSql, renderQuotedStringLiteral, renderSchemaLine, renderSchemaObject, renderSystemTablePrelude, renderTextLiteral, renderVirtualTable, resolvePlainSqlRenderOptions, restoreSqlDump, safeSqlPreview, streamSqlStatements, streamWithParser, tableGroupPriority, throwIfAborted, toAsciiLowerCase, toAsciiUpperCase, toByteStringChunks, toNumber, toText, unsupportedFeatureDiagnostics };
+export { AcquiredSqliteConnection, type ArchiveCycle, type ArchiveDependency, type ArchiveDependencyStrength, type ArchiveEntry, type ArchiveIdentityInput, type ArchiveObjectType, BufferDumpWriter, COMPLETE_TRANSITIONS, CompleteToken, DEFENSIVE_WARNING_COMMENT, type DotCommandPolicy, type DroppableKind, type DumpArchiveInspection, type DumpMode, type DumpObjectKinds, type DumpProgressCallback, type DumpProgressEvent, type DumpProgressPhase, type DumpProgressSection, type DumpResult, type DumpSection, type DumpSelection, type DumpSqliteOptions, type DumpWriter, type InspectDumpArchiveOptions, type IntrospectSqliteOptions, InvalidTextEncodingError, MalformedSqlDumpError, NATIVE_VALUE_TRANSPORT, type NormalizedDumpSelection, type ParsedStatement, type PlainSqlRenderOptions, type PlainSqlRenderRequest, type PlainSqlRenderResult, type PreflightRestoreReport, type PreflightRestoreRequest, type ResolvedConnectionFeatures, type ResolvedPlainSqlRenderOptions, RestoreError, RestoreExecutionError, type RestoreOptions, type RestoreProgressCallback, type RestoreProgressEvent, type RestoreProgressPhase, RestoreSessionState, type RestoreStatementError, type RestoreWarning, SEQUENCE_TABLE_NAME, SESSION_GUARD_FOOTER, SESSION_GUARD_HEADER, SQLITE_KEYWORD_COUNT, type SkippedDotCommand, SqlChunkBuilder, type SqlDumpRestoreRequest, type SqlDumpRestoreResult, type SqlDumpSource, SqlParseError, SqlStatementParser, type SqlStatementParserOptions, type SqliteCapabilities, type SqliteColumn, type SqliteColumnHidden, SqliteConnection, SqliteConnectionInput, type SqliteConsistencyMode, type SqliteDatabase, type SqliteDiagnostic, type SqliteDiagnosticSeverity, type SqliteDumpSession, type SqliteDumpSessionOptions, SqliteDumperError, SqliteErrorInfo, SqliteExecResult, type SqliteForeignKey, type SqliteForeignKeyColumn, type SqliteIndex, type SqliteIndexColumn, type SqliteIntrospectionResult, type SqliteObjectKind, type SqliteObjectReference, SqliteRow, type SqliteSequence, type SqliteTable, type SqliteTableKind, type SqliteTrigger, type SqliteValueTransport, type SqliteVersion, type SqliteView, type StatementInfo, type StatementSourceLocation, StatementTooLargeError, StreamDumpWriter, type TableDataExportOptions, type TableDataExportRequest, type TableDataExportResult, type TargetCapabilities, type TargetCompatibilityOptions, type TextLiteralStyle, UNSUPPORTED_FEATURES, type UnsatisfiedDependency, UnsupportedClientCommandError, WRITABLE_SCHEMA_OFF, WRITABLE_SCHEMA_ON, acquireSqliteConnection, assignDumpSection, beginSqliteDumpSession, checkTargetCompatibility, classifyWord, columnValueSelect, completeTransition, connectionFeatures, createArchiveIdentity, createCanonicalIdentity, createDumpId, declaresAutoincrement, decodeStatementBytes, describeStatement, detectSqliteCapabilities, detectSqliteVersion, detectSqliteCapabilities as detectTargetCapabilities, dumpSectionPriority, dumpSqlite, executeStatement, exportTableDataAsInserts, foldSqliteName, insertableColumns, inspectDumpArchive, introspectSqlite, isCompleteStatement, isIdentifierCharCode, isIndexSelected, isSchemaTableName, isSqliteDump, isSqliteKeyword, isStatisticsTableName, isTableDataExcluded, isTableSelected, isTriggerSelected, isTruthyPragmaValue, isViewSelected, maskSqlLiterals, needsIdentifierQuoting, normalizeDumpSelection, parseSqlStatements, parseSqliteVersion, parseTableOptions, parseVirtualTableModule, preflightRestore, preservableRowidName, quoteIdentifier, quoteIdentifierIfNeeded, quoteQualifiedIdentifier, quoteStringLiteral, redactSecrets, renderBlobLiteral, renderColumnLiteral, renderDatabaseSettings, renderDrop, renderEscapedStringLiteral, renderPlainSql, renderQuotedStringLiteral, renderSchemaLine, renderSchemaObject, renderSystemTablePrelude, renderTextLiteral, renderVirtualTable, resolvePlainSqlRenderOptions, restoreSqlDump, safeSqlPreview, streamSqlStatements, streamWithParser, tableGroupPriority, toAsciiLowerCase, toAsciiUpperCase, toBuffer, toByteStringChunks, toNumber, toText, unsupportedFeatureDiagnostics, valueTransport };