@haverstack/record-adapter-sqlite 0.33.0 → 0.34.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { StackCapabilities, StackRecord, RecordChangeSet, RecordVersion, ActorOptions, TypeId, StackQuery, QueryResult, FileId, VersionsQuery, JournalQuery, RecordJournalEntry, StackType, AssociationEdit, Actor } from '@haverstack/core';
-import { StackRecordAdapter, JournalOptions } from '@haverstack/core/adapter';
+import { StackCapabilities, StackRecord, RecordChangeSet, TypeId, StackQuery, QueryResult, FileId, VersionsQuery, RecordVersion, JournalQuery, RecordJournalEntry, StackType, AssociationEdit, Actor } from '@haverstack/core';
+import { StackRecordAdapter, JournalOptions, MutateOptions, BumpVersionOptions } from '@haverstack/core/adapter';
 import { StackTokenStore, TokenSession, TokenInfo } from '@haverstack/core/wire';
 
 /**
@@ -24,14 +24,10 @@ interface SqlExecutor {
     /** Run a parameterized statement and return all result rows. */
     all<T = Record<string, unknown>>(sql: string, params?: readonly unknown[]): T[];
     /**
-     * Run `fn` atomically: every statement it issues commits together, or
-     * none do if it throws. `fn` must be synchronous and call back into
-     * this executor only — not every engine's transaction primitive can
-     * straddle a suspended call. A binding with a real multi-statement
-     * transaction (BEGIN/COMMIT/ROLLBACK) implements this with one; a
-     * binding whose transaction primitive is itself a callback wrapper
-     * (e.g. a Durable Object's storage.transactionSync) can pass `fn`
-     * straight through to it.
+     * Run `fn` atomically: every statement it issues commits, or none do if it
+     * throws. A callback rather than BEGIN/COMMIT text because some engines
+     * only offer one (a Durable Object's storage.transactionSync); for the
+     * same reason `fn` must be synchronous and use only this executor.
      */
     transaction<T>(fn: () => T): T;
 }
@@ -67,28 +63,13 @@ declare abstract class SharedSqlRecordAdapter implements StackRecordAdapter {
     protected constructor(exec: SqlExecutor, config: StackConfig);
     createRecord(record: StackRecord, opts?: JournalOptions): Promise<StackRecord>;
     getRecord(id: string): Promise<StackRecord | null>;
-    mutateRecord(id: string, changes: RecordChangeSet, opts?: {
-        ifVersion?: number;
-        snapshot?: RecordVersion;
-        bumpsVersion?: boolean;
-    } & ActorOptions & JournalOptions): Promise<StackRecord>;
+    mutateRecord(id: string, changes: RecordChangeSet, opts?: MutateOptions & BumpVersionOptions): Promise<StackRecord>;
     deleteRecord(id: string, opts?: {
         purge?: boolean;
-        ifVersion?: number;
-        snapshot?: RecordVersion;
-    } & ActorOptions & JournalOptions): Promise<StackRecord | null>;
-    undeleteRecord(id: string, opts?: {
-        ifVersion?: number;
-        snapshot?: RecordVersion;
-    } & ActorOptions & JournalOptions): Promise<StackRecord>;
-    restoreVersion(id: string, version: number, opts?: {
-        ifVersion?: number;
-        snapshot?: RecordVersion;
-    } & ActorOptions & JournalOptions): Promise<StackRecord>;
-    commitMigration(id: string, toTypeId: TypeId, content: Record<string, unknown>, opts?: {
-        ifVersion?: number;
-        snapshot?: RecordVersion;
-    } & ActorOptions & JournalOptions): Promise<StackRecord>;
+    } & MutateOptions): Promise<StackRecord | null>;
+    undeleteRecord(id: string, opts?: MutateOptions): Promise<StackRecord>;
+    restoreVersion(id: string, version: number, opts?: MutateOptions): Promise<StackRecord>;
+    commitMigration(id: string, toTypeId: TypeId, content: Record<string, unknown>, opts?: MutateOptions): Promise<StackRecord>;
     queryRecords(query: StackQuery): Promise<QueryResult>;
     deleteUnreferencedAttachmentRecords(fileId: FileId, metadataTypeIds: TypeId[]): Promise<StackRecord[]>;
     getVersions(id: string, query?: VersionsQuery): Promise<RecordVersion[]>;