@syncular/client 0.0.1-60

package/src/blobs/migrate.ts

@@ -0,0 +1,67 @@
+/**
+ * @syncular/client - Blob storage migrations
+ */
+
+import type { Kysely } from 'kysely';
+
+/**
+ * Ensures the client blob schema exists in the database.
+ * Safe to call multiple times (idempotent).
+ */
+export async function ensureClientBlobSchema<DB>(
+  db: Kysely<DB>
+): Promise<void> {
+  // Blob cache table
+  await db.schema
+    .createTable('sync_blob_cache')
+    .ifNotExists()
+    .addColumn('hash', 'text', (col) => col.primaryKey())
+    .addColumn('size', 'integer', (col) => col.notNull())
+    .addColumn('mime_type', 'text', (col) => col.notNull())
+    .addColumn('body', 'blob', (col) => col.notNull())
+    .addColumn('encrypted', 'integer', (col) => col.notNull().defaultTo(0))
+    .addColumn('key_id', 'text')
+    .addColumn('cached_at', 'bigint', (col) => col.notNull())
+    .addColumn('last_accessed_at', 'bigint', (col) => col.notNull())
+    .execute();
+
+  await db.schema
+    .createIndex('idx_sync_blob_cache_last_accessed')
+    .ifNotExists()
+    .on('sync_blob_cache')
+    .columns(['last_accessed_at'])
+    .execute();
+
+  // Blob upload outbox table
+  await db.schema
+    .createTable('sync_blob_outbox')
+    .ifNotExists()
+    .addColumn('id', 'integer', (col) => col.primaryKey().autoIncrement())
+    .addColumn('hash', 'text', (col) => col.notNull().unique())
+    .addColumn('size', 'integer', (col) => col.notNull())
+    .addColumn('mime_type', 'text', (col) => col.notNull())
+    .addColumn('body', 'blob', (col) => col.notNull())
+    .addColumn('encrypted', 'integer', (col) => col.notNull().defaultTo(0))
+    .addColumn('key_id', 'text')
+    .addColumn('status', 'text', (col) => col.notNull())
+    .addColumn('attempt_count', 'integer', (col) => col.notNull().defaultTo(0))
+    .addColumn('error', 'text')
+    .addColumn('created_at', 'bigint', (col) => col.notNull())
+    .addColumn('updated_at', 'bigint', (col) => col.notNull())
+    .execute();
+
+  await db.schema
+    .createIndex('idx_sync_blob_outbox_status')
+    .ifNotExists()
+    .on('sync_blob_outbox')
+    .columns(['status', 'created_at'])
+    .execute();
+}
+
+/**
+ * Drops the client blob schema from the database.
+ */
+export async function dropClientBlobSchema<DB>(db: Kysely<DB>): Promise<void> {
+  await db.schema.dropTable('sync_blob_outbox').ifExists().execute();
+  await db.schema.dropTable('sync_blob_cache').ifExists().execute();
+}

package/src/blobs/types.ts

@@ -0,0 +1,84 @@
+/**
+ * @syncular/client - Blob storage types
+ */
+
+import type { Generated } from 'kysely';
+
+// ============================================================================
+// Blob Cache Table
+// ============================================================================
+
+/**
+ * Local blob cache table.
+ * Stores downloaded blobs for offline access.
+ */
+export interface SyncBlobCacheTable {
+  /** SHA-256 hash with prefix: "sha256:<hex>" */
+  hash: string;
+  /** Size in bytes */
+  size: number;
+  /** MIME type */
+  mime_type: string;
+  /** Blob content */
+  body: Uint8Array;
+  /** Whether the blob is encrypted */
+  encrypted: number; // SQLite boolean
+  /** Encryption key ID (if encrypted) */
+  key_id: string | null;
+  /** When the blob was cached */
+  cached_at: number;
+  /** Last accessed timestamp (for LRU eviction) */
+  last_accessed_at: number;
+}
+
+// ============================================================================
+// Blob Upload Outbox Table
+// ============================================================================
+
+export type BlobUploadStatus =
+  | 'pending'
+  | 'uploading'
+  | 'uploaded'
+  | 'confirming'
+  | 'complete'
+  | 'failed';
+
+/**
+ * Blob upload outbox table.
+ * Tracks pending blob uploads for offline support.
+ */
+export interface SyncBlobOutboxTable {
+  /** Local row id */
+  id: Generated<number>;
+  /** SHA-256 hash with prefix: "sha256:<hex>" */
+  hash: string;
+  /** Size in bytes */
+  size: number;
+  /** MIME type */
+  mime_type: string;
+  /** Blob content (stored locally until upload completes) */
+  body: Uint8Array;
+  /** Whether the blob is encrypted */
+  encrypted: number; // SQLite boolean
+  /** Encryption key ID (if encrypted) */
+  key_id: string | null;
+  /** Upload status */
+  status: BlobUploadStatus;
+  /** Upload attempt count */
+  attempt_count: number;
+  /** Last error message */
+  error: string | null;
+  /** When the upload was queued */
+  created_at: number;
+  /** When the upload was last updated */
+  updated_at: number;
+}
+
+// ============================================================================
+// Database Interface
+// ============================================================================
+
+export interface SyncBlobClientDb {
+  sync_blob_cache: SyncBlobCacheTable;
+  sync_blob_outbox: SyncBlobOutboxTable;
+}