@atscript/db-sqlite 0.1.34 → 0.1.36

package/dist/index.d.ts

@@ -1,5 +1,5 @@
+import { BaseDbAdapter, TDbInsertResult, TDbInsertManyResult, DbQuery, FilterExpr, TDbUpdateResult, TDbDeleteResult, TExistingColumn, TColumnDiff, TSyncColumnResult, DbSpace } from '@atscript/utils-db';
 import { TAtscriptAnnotatedType } from '@atscript/typescript/utils';
-import { BaseDbAdapter, TDbInsertResult, TDbInsertManyResult, DbQuery, FilterExpr, TDbUpdateResult, TDbDeleteResult } from '@atscript/utils-db';
 import * as better_sqlite3 from 'better-sqlite3';
 import { FilterExpr as FilterExpr$1 } from '@uniqu/core';
 
@@ -66,9 +66,19 @@ interface TSqliteDriver {
 declare class SqliteAdapter extends BaseDbAdapter {
     protected readonly driver: TSqliteDriver;
     constructor(driver: TSqliteDriver);
+    protected _beginTransaction(): Promise<unknown>;
+    protected _commitTransaction(): Promise<void>;
+    protected _rollbackTransaction(): Promise<void>;
     /** SQLite does not use schemas — override to always exclude schema. */
     resolveTableName(): string;
+    /** SQLite enforces FK constraints natively via PRAGMA foreign_keys. */
+    supportsNativeForeignKeys(): boolean;
     prepareId(id: unknown, _fieldType: TAtscriptAnnotatedType): unknown;
+    /**
+     * Wraps a write operation to catch native SQLite constraint errors
+     * and rethrow as structured `DbError`.
+     */
+    private _wrapConstraintError;
     insertOne(data: Record<string, unknown>): Promise<TDbInsertResult>;
     insertMany(data: Array<Record<string, unknown>>): Promise<TDbInsertManyResult>;
     findOne(query: DbQuery): Promise<Record<string, unknown> | null>;
@@ -81,6 +91,20 @@ declare class SqliteAdapter extends BaseDbAdapter {
     deleteOne(filter: FilterExpr): Promise<TDbDeleteResult>;
     deleteMany(filter: FilterExpr): Promise<TDbDeleteResult>;
     ensureTable(): Promise<void>;
+    ensureView(): Promise<void>;
+    getExistingColumns(): Promise<TExistingColumn[]>;
+    syncColumns(diff: TColumnDiff): Promise<TSyncColumnResult>;
+    recreateTable(): Promise<void>;
+    dropTable(): Promise<void>;
+    dropColumns(columns: string[]): Promise<void>;
+    dropTableByName(tableName: string): Promise<void>;
+    dropViewByName(viewName: string): Promise<void>;
+    renameTable(oldName: string): Promise<void>;
+    typeMapper(field: {
+        designType: string;
+        isPrimaryKey: boolean;
+    }): string;
+    getExistingColumnsForTable(tableName: string): Promise<TExistingColumn[]>;
     syncIndexes(): Promise<void>;
 }
 
@@ -132,5 +156,7 @@ interface TSqlFragment {
  */
 declare function buildWhere(filter: FilterExpr$1): TSqlFragment;
 
-export { BetterSqlite3Driver, SqliteAdapter, buildWhere };
+declare function createAdapter(connection: string, options?: Record<string, unknown>): DbSpace;
+
+export { BetterSqlite3Driver, SqliteAdapter, buildWhere, createAdapter };
 export type { TSqlFragment, TSqliteDriver, TSqliteRunResult };