@vibesdotdev/storage 0.0.1

package/dist/daemon/commands/sync.js

@@ -0,0 +1,169 @@
+/**
+ * Sync Command Handlers
+ *
+ * RPC commands for storage sync operations:
+ * - sync.status  -> Returns sync state for all manifests
+ * - sync.trigger -> Enqueues an immediate sync job
+ * - sync.resolve -> Resolves a conflict (keep-local or keep-remote)
+ */
+/**
+ * Handle `sync.status` — returns current sync state for all manifests.
+ */
+export async function handleSyncStatus(_message, deps) {
+    const { loadSyncState } = await import('../../sync/sync-state.consumer.js');
+    const state = await loadSyncState();
+    // Also check if sync is enabled
+    let syncEnabled = false;
+    try {
+        const manifest = await deps.runtime
+            .query('config/manifest')
+            .filter((d) => d.id === 'ai.core')
+            .resolve();
+        if (manifest) {
+            const config = manifest;
+            const data = await config.load();
+            syncEnabled = data?.syncToCloud === true;
+        }
+    }
+    catch {
+        // Config not available
+    }
+    return {
+        success: true,
+        syncEnabled,
+        updatedAt: state.updatedAt,
+        manifests: state.manifests,
+        summary: {
+            total: Object.keys(state.manifests).length,
+            inSync: Object.values(state.manifests).filter((m) => m.syncStatus === 'in-sync').length,
+            localAhead: Object.values(state.manifests).filter((m) => m.syncStatus === 'local-ahead')
+                .length,
+            remoteAhead: Object.values(state.manifests).filter((m) => m.syncStatus === 'remote-ahead')
+                .length,
+            conflicts: Object.values(state.manifests).filter((m) => m.syncStatus === 'conflict').length,
+            paused: Object.values(state.manifests).filter((m) => m.syncStatus === 'paused').length,
+            neverSynced: Object.values(state.manifests).filter((m) => m.syncStatus === 'never-synced')
+                .length
+        }
+    };
+}
+/**
+ * Handle `sync.trigger` — enqueues an immediate storage-sync job.
+ */
+export async function handleSyncTrigger(message, deps) {
+    const manifestIds = message.manifestIds ?? [];
+    const force = message.force ?? true;
+    // Broadcast that sync was triggered
+    deps.subscriptionManager.broadcast?.('activity', {
+        type: 'sync-triggered',
+        manifestIds,
+        force,
+        timestamp: new Date().toISOString()
+    });
+    // Run pull + push inline (for RPC response)
+    const { pullFromCloud } = await import('../../sync/cloud-pull.js');
+    const pullResult = await pullFromCloud({ manifestIds, force });
+    const { SyncBridge } = await import('../../sync/sync-bridge.js');
+    const { resolveSyncTarget } = await import('../../sync/resolve-sync-target.js');
+    const bridgeDescriptors = deps.runtime
+        .query('storage/sync-bridge')
+        .enabled()
+        .descriptors();
+    const bridgeTargets = manifestIds.length > 0
+        ? bridgeDescriptors.filter((descriptor) => manifestIds.includes(descriptor.id))
+        : bridgeDescriptors;
+    const bridgeResults = [];
+    if (bridgeTargets.length > 0) {
+        const { syncTarget, apiToken } = await resolveSyncTarget();
+        if (syncTarget && syncTarget !== 'unknown') {
+            for (const descriptor of bridgeTargets) {
+                const bridge = new SyncBridge(descriptor);
+                const result = await bridge.execute(syncTarget, { direction: 'both', dryRun: false, force }, apiToken);
+                bridgeResults.push({
+                    bridgeId: result.bridgeId,
+                    pushed: result.pushed,
+                    pulled: result.pulled,
+                    skipped: result.skipped,
+                    conflicts: result.conflicts,
+                    errors: result.errors
+                });
+            }
+        }
+    }
+    return {
+        success: true,
+        triggered: true,
+        pullResult,
+        bridgeResults,
+        message: `Sync triggered. Pulled: ${pullResult.pulled}, Conflicts: ${pullResult.conflicts}, Bridges: ${bridgeResults.length}`
+    };
+}
+/**
+ * Handle `sync.resolve` — resolves a manifest conflict.
+ * Accepts { manifestId, resolution: 'keep-local' | 'keep-remote' }
+ */
+export async function handleSyncResolve(message, deps) {
+    const manifestId = message.manifestId;
+    const resolution = message.resolution;
+    if (!manifestId || !resolution) {
+        return { success: false, error: 'Missing manifestId or resolution' };
+    }
+    const { loadSyncState, saveSyncState, getManifestSyncState, markSynced, computeHash } = await import('../../sync/sync-state.consumer.js');
+    const syncState = await loadSyncState();
+    const manifestState = getManifestSyncState(syncState, manifestId);
+    if (manifestState.syncStatus !== 'conflict') {
+        return { success: false, error: `Manifest ${manifestId} is not in conflict state` };
+    }
+    if (resolution === 'keep-local') {
+        // Push local to cloud
+        const { StorageManifest } = await import('../../manifest/base.js');
+        const localManifest = new StorageManifest(manifestId);
+        const localData = await localManifest.load();
+        if (localData) {
+            try {
+                const cloudAdapter = await deps.runtime
+                    .query('storage/adapter')
+                    .filter((d) => d.id === 'storage.cloud-api')
+                    .resolve();
+                if (cloudAdapter) {
+                    const descriptor = deps.runtime
+                        .query('storage/manifest')
+                        .filter((d) => d.id === manifestId)
+                        .firstDescriptor();
+                    const adapter = cloudAdapter;
+                    const cloudConfig = descriptor?.config?.['storage.cloud-api'] ?? {};
+                    adapter.configure(cloudConfig);
+                    const store = adapter.documentStore(descriptor.namespace, descriptor.schema);
+                    await store.save(localData);
+                }
+            }
+            catch {
+                return { success: false, error: 'Failed to push local data to cloud' };
+            }
+        }
+        const hash = localData ? computeHash(localData) : '';
+        markSynced(syncState, manifestId, hash, 'push');
+    }
+    else {
+        // Pull remote to local
+        const { pullFromCloud } = await import('../../sync/cloud-pull.js');
+        await pullFromCloud({ manifestIds: [manifestId], force: true });
+        // pullFromCloud updates syncState internally, but we need fresh state
+        const freshState = await loadSyncState();
+        Object.assign(syncState, freshState);
+    }
+    await saveSyncState(syncState);
+    deps.subscriptionManager.broadcast?.('activity', {
+        type: 'sync-conflict-resolved',
+        manifestId,
+        resolution,
+        timestamp: new Date().toISOString()
+    });
+    return {
+        success: true,
+        manifestId,
+        resolution,
+        newStatus: getManifestSyncState(syncState, manifestId).syncStatus
+    };
+}
+//# sourceMappingURL=sync.js.map

package/dist/daemon/commands/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../src/daemon/commands/sync.ts"],"names":[],"mappings":"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"}

package/dist/docs/adapters.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=adapters.docs.descriptor.d.ts.map

package/dist/docs/adapters.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/adapters.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,QAAA,MAAM,UAAU,EAAE,mBA4NjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/adapters.docs.descriptor.js

@@ -0,0 +1,223 @@
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'storage.adapters',
+    title: 'Storage Adapters',
+    summary: 'Storage adapter interface, adapter implementations (libsql/D1/memory), and registration',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: `---
+title: Storage Adapters
+summary: Storage adapter interface, adapter implementations (libsql/D1/memory), and registration
+tags: [storage, adapters, interface, registration]
+parent: storage
+order: 1
+surfaces: [cli, web, in-app]
+hardware: [consumer, cloud]
+---
+
+# Storage Adapters
+
+Storage adapters provide the persistence layer for the vibes storage system. The \`storage/adapter\` runtime kind defines the interface that all adapters must implement.
+
+## Adapter Interface
+
+All adapters implement the \`StorageAdapterInterface\`:
+
+\`\`\`ts
+interface StorageAdapterInterface {
+  // Document operations
+  documentStore<T>(namespace: string, schema: ZodSchema<T>): {
+    load(): Promise<T | null>;
+    save(data: T): Promise<void>;
+    exists(): Promise<boolean>;
+    delete(): Promise<void>;
+  };
+
+  // Repository operations
+  repository<T>(namespace: string, schema: ZodSchema<T>): {
+    find(id: string): Promise<T | null>;
+    findAll(query?: Query): Promise<T[]>;
+    insert(data: T): Promise<T>;
+    update(id: string, data: Partial<T>): Promise<T>;
+    delete(id: string): Promise<void>;
+  };
+
+  // Lifecycle
+  ensureReady(): Promise<void>;
+  close(): Promise<void>;
+}
+\`\`\`
+
+## Available Adapters
+
+### Memory Adapter
+
+In-memory storage for testing and ephemeral use:
+
+\`\`\`ts
+import { storageAdapterMemoryPlugin } from '@vibesdotdev/storage-adapter-memory';
+await runtime.registerPlugin(storageAdapterMemoryPlugin);
+\`\`\`
+
+**Use cases:**
+- Unit and integration tests
+- Development prototyping
+- Caching layers
+
+**Limitations:**
+- Data lost on process restart
+- No concurrent access support
+
+### LibSQL Adapter
+
+Local SQLite storage using libsql:
+
+\`\`\`ts
+import { storageAdapterLibsqlPlugin } from '@vibesdotdev/storage-adapter-libsql';
+await runtime.registerPlugin(storageAdapterLibsqlPlugin({
+  dbUrl: 'file:local.db'
+}));
+\`\`\`
+
+**Use cases:**
+- Single-user desktop apps
+- Local-first applications
+- Edge computing scenarios
+
+### D1 Adapter
+
+Cloudflare D1 database adapter:
+
+\`\`\`ts
+import { storageAdapterD1Plugin } from '@vibesdotdev/storage-adapter-d1';
+await runtime.registerPlugin(storageAdapterD1Plugin({
+  binding: env.DB  // Cloudflare D1 binding
+}));
+\`\`\`
+
+**Use cases:**
+- Cloudflare Workers deployments
+- Serverless applications
+- Multi-tenant SaaS
+
+### Drizzle ORM Adapter
+
+Database-agnostic adapter via Drizzle ORM:
+
+\`\`\`ts
+import { storageAdapterDrizzlePlugin } from '@vibesdotdev/storage-adapter-drizzle';
+import { drizzle } from 'drizzle-orm/postgres-js';
+import postgres from 'postgres';
+
+const client = postgres(process.env.DATABASE_URL!);
+const db = drizzle(client);
+
+await runtime.registerPlugin(storageAdapterDrizzlePlugin({ db }));
+\`\`\`
+
+**Use cases:**
+- Production PostgreSQL deployments
+- Complex queries and relations
+- Migration management
+
+### Cloud-API Adapter
+
+Remote storage via HTTP API (used for sync):
+
+\`\`\`ts
+import { storageAdapterCloudApiPlugin } from '@vibesdotdev/storage-adapter-cloud-api';
+await runtime.registerPlugin(storageAdapterCloudApiPlugin({
+  baseUrl: 'https://storage.vibes.dev',
+  authToken: '...'
+}));
+\`\`\`
+
+**Use cases:**
+- Cross-app sync (see \`storage.sync\`)
+- Centralized backup
+- Multi-device synchronization
+
+## Adapter Registration
+
+Adapters register themselves via runtime plugins:
+
+\`\`\`ts
+import { getVibesRuntime } from '@vibesdotdev/runtime';
+import { storagePlugin } from '@vibesdotdev/storage';
+import { storageAdapterMemoryPlugin } from '@vibesdotdev/storage-adapter-memory';
+
+const runtime = getVibesRuntime();
+
+// Register core storage first
+await runtime.registerPlugin(storagePlugin);
+
+// Then register adapter
+await runtime.registerPlugin(storageAdapterMemoryPlugin);
+\`\`\`
+
+## Adapter Resolution
+
+The runtime resolves adapters based on hardware scope:
+
+\`\`\`ts
+// Runtime auto-selects based on scope
+const adapter = await runtime.query('storage/adapter')
+  .forHardware('consumer')
+  .resolve();
+
+// Or filter explicitly
+const adapter = await runtime.query('storage/adapter')
+  .filter(d => d.id === 'storage.adapter.libsql')
+  .resolve();
+\`\`\`
+
+**Resolution priority:**
+1. Explicit filter match
+2. Hardware compatibility
+3. Persistent over memory adapters
+4. First registered
+
+## Writing Custom Adapters
+
+Create a plugin that registers a \`storage/adapter\` descriptor:
+
+\`\`\`ts
+import { createRuntimePlugin } from '@vibesdotdev/runtime';
+import type { StorageAdapterDescriptor } from '@vibesdotdev/storage';
+
+const descriptor: StorageAdapterDescriptor = {
+  kind: 'storage/adapter',
+  id: 'storage.adapter.custom',
+  title: 'Custom Adapter',
+  persistent: true,
+  hardware: ['consumer', 'cloud']
+};
+
+export const customAdapterPlugin = createRuntimePlugin({
+  id: 'custom-adapter',
+  kinds: [{
+    id: 'storage/adapter',
+    descriptorSchema: StorageAdapterDescriptorSchema,
+    defaultImplementation: CustomAdapterImpl
+  }],
+  descriptors: [descriptor]
+});
+\`\`\`
+
+:::card{title="See also"}
+- [\`storage.manifests\`](storage.manifests) — Manifest declarations
+- [\`storage.records\`](storage.records) — Record CRUD operations
+- [\`storage.sync\`](storage.sync) — Cross-app synchronization
+:::
+`
+    },
+    parent: 'storage',
+    order: 1,
+    tags: ['storage', 'adapters', 'interface', 'registration'],
+    surfaces: ['cli', 'web', 'in-app'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=adapters.docs.descriptor.js.map

package/dist/docs/adapters.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/adapters.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,yFAAyF;IAClG,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4MT;KACC;IACD,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,CAAC;IAC1D,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/manifests.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=manifests.docs.descriptor.d.ts.map

package/dist/docs/manifests.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifests.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/manifests.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,QAAA,MAAM,UAAU,EAAE,mBAyTjB,CAAC;AAEF,eAAe,UAAU,CAAC"}