snapshot of https://github.com/toeverything/AFFiNE.git (canary, 2026-09-16; blobs > 131072B omitted)

packages/common/nbstore/src/storage/blob.ts

@@ -0,0 +1,78 @@
+import type { Connection } from '../connection';
+import { type Storage } from './storage';
+
+export interface BlobRecord {
+  key: string;
+  data: Uint8Array;
+  mime: string;
+  createdAt?: Date;
+}
+
+export interface ListedBlobRecord {
+  key: string;
+  mime: string;
+  size: number;
+  createdAt?: Date;
+}
+
+export type BlobSource =
+  | { type: 'currentDoc'; workspaceId: string; docId: string }
+  | {
+      type: 'history';
+      workspaceId: string;
+      docId: string;
+      timestampMs: number;
+    };
+
+export interface SourceBlobRecord extends ListedBlobRecord {
+  source: BlobSource;
+}
+
+export interface SourceScopedBlobStorage {
+  registerSource(source: BlobSource, signal?: AbortSignal): Promise<void>;
+  unregisterSource(source: BlobSource): Promise<void>;
+  readableSources(signal?: AbortSignal): AsyncIterable<SourceBlobRecord>;
+}
+
+export function isSourceScopedBlobStorage(
+  storage: BlobStorage
+): storage is BlobStorage & SourceScopedBlobStorage {
+  return 'registerSource' in storage && 'readableSources' in storage;
+}
+
+export interface BlobStorage extends Storage {
+  readonly storageType: 'blob';
+  readonly isReadonly: boolean;
+  get(
+    key: string,
+    signal?: AbortSignal,
+    source?: BlobSource
+  ): Promise<BlobRecord | null>;
+  set(blob: BlobRecord, signal?: AbortSignal): Promise<void>;
+  delete(
+    key: string,
+    permanently: boolean,
+    signal?: AbortSignal
+  ): Promise<void>;
+  release(signal?: AbortSignal): Promise<void>;
+  list(signal?: AbortSignal): Promise<ListedBlobRecord[]>;
+}
+
+export abstract class BlobStorageBase implements BlobStorage {
+  readonly storageType = 'blob';
+  abstract readonly connection: Connection;
+  abstract readonly isReadonly: boolean;
+  abstract get(
+    key: string,
+    signal?: AbortSignal,
+    source?: BlobSource
+  ): Promise<BlobRecord | null>;
+  abstract set(blob: BlobRecord, signal?: AbortSignal): Promise<void>;
+  abstract delete(
+    key: string,
+    permanently: boolean,
+    signal?: AbortSignal
+  ): Promise<void>;
+  abstract release(signal?: AbortSignal): Promise<void>;
+  abstract list(signal?: AbortSignal): Promise<ListedBlobRecord[]>;
+}