@vibesdotdev/storage 0.0.1

package/dist/sync/schemas/cloud-pull.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cloud Pull Schemas
+ *
+ * Types for cloud pull operations — options and result structures.
+ */
+export interface CloudPullOptions {
+    /** Only pull specific manifests */
+    manifestIds?: string[];
+    /** Force overwrite local even if local has changes */
+    force?: boolean;
+    /** Preview without writing */
+    dryRun?: boolean;
+}
+export interface CloudPullResult {
+    pulled: number;
+    skipped: number;
+    conflicts: number;
+    errors: number;
+    details: Array<{
+        manifestId: string;
+        action: 'pulled' | 'skipped' | 'conflict' | 'error';
+        message?: string;
+    }>;
+}
+//# sourceMappingURL=cloud-pull.d.ts.map

package/dist/sync/schemas/cloud-pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-pull.d.ts","sourceRoot":"","sources":["../../../src/sync/schemas/cloud-pull.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAChC,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;QACpD,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACH"}

package/dist/sync/schemas/cloud-pull.js

@@ -0,0 +1,7 @@
+/**
+ * Cloud Pull Schemas
+ *
+ * Types for cloud pull operations — options and result structures.
+ */
+export {};
+//# sourceMappingURL=cloud-pull.js.map

package/dist/sync/schemas/cloud-pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-pull.js","sourceRoot":"","sources":["../../../src/sync/schemas/cloud-pull.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/sync/schemas/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Storage Sync Schemas
+ *
+ * Re-exports all sync-related schemas and types.
+ */
+export { SyncStatusSchema, ManifestSyncStateSchema, SyncStateSchema, type SyncStatus, type ManifestSyncState, type SyncState } from './sync-state';
+export { type CloudPullOptions, type CloudPullResult } from './cloud-pull';
+export { type SyncHelpers } from './sync-helpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/sync/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sync/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAE3E,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/sync/schemas/index.js

@@ -0,0 +1,9 @@
+/**
+ * Storage Sync Schemas
+ *
+ * Re-exports all sync-related schemas and types.
+ */
+export { SyncStatusSchema, ManifestSyncStateSchema, SyncStateSchema } from './sync-state.js';
+export {} from './cloud-pull.js';
+export {} from './sync-helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/sync/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sync/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EAIf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAA+C,MAAM,cAAc,CAAC;AAE3E,OAAO,EAAoB,MAAM,gBAAgB,CAAC"}

package/dist/sync/schemas/sync-helpers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Sync Helpers Schema
+ *
+ * Interface for sync operation helper functions passed between sync components.
+ */
+import type { SyncState, ManifestSyncState } from './sync-state';
+export interface SyncHelpers {
+    dryRun: boolean;
+    computeHash: (data: unknown) => string;
+    getManifestSyncState: (state: SyncState, id: string) => ManifestSyncState;
+    markSynced: (state: SyncState, id: string, hash: string, dir: 'push' | 'pull') => void;
+    markLocalAhead: (state: SyncState, id: string, hash: string) => void;
+    markConflict: (state: SyncState, id: string, local: string, remote: string) => void;
+    markError: (state: SyncState, id: string, msg: string) => void;
+    markRemoteAhead: (state: SyncState, id: string, hash: string) => void;
+}
+//# sourceMappingURL=sync-helpers.d.ts.map

package/dist/sync/schemas/sync-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-helpers.d.ts","sourceRoot":"","sources":["../../../src/sync/schemas/sync-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;IACvC,oBAAoB,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,KAAK,iBAAiB,CAAC;IAC1E,UAAU,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACvF,cAAc,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,YAAY,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpF,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,eAAe,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE"}

package/dist/sync/schemas/sync-helpers.js

@@ -0,0 +1,7 @@
+/**
+ * Sync Helpers Schema
+ *
+ * Interface for sync operation helper functions passed between sync components.
+ */
+export {};
+//# sourceMappingURL=sync-helpers.js.map

package/dist/sync/schemas/sync-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-helpers.js","sourceRoot":"","sources":["../../../src/sync/schemas/sync-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/sync/schemas/sync-state.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Sync State Schemas
+ *
+ * Zod schemas and inferred types for per-manifest sync state tracking.
+ * Pure schemas — no host/fs imports.
+ */
+import * as z from 'zod/v4';
+export declare const SyncStatusSchema: z.ZodEnum<{
+    "in-sync": "in-sync";
+    "local-ahead": "local-ahead";
+    "remote-ahead": "remote-ahead";
+    conflict: "conflict";
+    paused: "paused";
+    "never-synced": "never-synced";
+}>;
+export type SyncStatus = z.infer<typeof SyncStatusSchema>;
+export declare const ManifestSyncStateSchema: z.ZodObject<{
+    manifestId: z.ZodString;
+    localHash: z.ZodNullable<z.ZodString>;
+    remoteHash: z.ZodNullable<z.ZodString>;
+    lastLocalChange: z.ZodNullable<z.ZodString>;
+    lastRemoteChange: z.ZodNullable<z.ZodString>;
+    lastSyncAt: z.ZodNullable<z.ZodString>;
+    lastSyncDirection: z.ZodNullable<z.ZodEnum<{
+        pull: "pull";
+        push: "push";
+    }>>;
+    syncStatus: z.ZodEnum<{
+        "in-sync": "in-sync";
+        "local-ahead": "local-ahead";
+        "remote-ahead": "remote-ahead";
+        conflict: "conflict";
+        paused: "paused";
+        "never-synced": "never-synced";
+    }>;
+    errorMessage: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ManifestSyncState = z.infer<typeof ManifestSyncStateSchema>;
+export declare const SyncStateSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    updatedAt: z.ZodString;
+    manifests: z.ZodRecord<z.ZodString, z.ZodObject<{
+        manifestId: z.ZodString;
+        localHash: z.ZodNullable<z.ZodString>;
+        remoteHash: z.ZodNullable<z.ZodString>;
+        lastLocalChange: z.ZodNullable<z.ZodString>;
+        lastRemoteChange: z.ZodNullable<z.ZodString>;
+        lastSyncAt: z.ZodNullable<z.ZodString>;
+        lastSyncDirection: z.ZodNullable<z.ZodEnum<{
+            pull: "pull";
+            push: "push";
+        }>>;
+        syncStatus: z.ZodEnum<{
+            "in-sync": "in-sync";
+            "local-ahead": "local-ahead";
+            "remote-ahead": "remote-ahead";
+            conflict: "conflict";
+            paused: "paused";
+            "never-synced": "never-synced";
+        }>;
+        errorMessage: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SyncState = z.infer<typeof SyncStateSchema>;
+//# sourceMappingURL=sync-state.d.ts.map

package/dist/sync/schemas/sync-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-state.d.ts","sourceRoot":"","sources":["../../../src/sync/schemas/sync-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,gBAAgB;;;;;;;EAO3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;iBAUlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;iBAI1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/sync/schemas/sync-state.js

@@ -0,0 +1,32 @@
+/**
+ * Sync State Schemas
+ *
+ * Zod schemas and inferred types for per-manifest sync state tracking.
+ * Pure schemas — no host/fs imports.
+ */
+import * as z from 'zod/v4';
+export const SyncStatusSchema = z.enum([
+    'in-sync',
+    'local-ahead',
+    'remote-ahead',
+    'conflict',
+    'paused',
+    'never-synced'
+]);
+export const ManifestSyncStateSchema = z.object({
+    manifestId: z.string(),
+    localHash: z.string().nullable(),
+    remoteHash: z.string().nullable(),
+    lastLocalChange: z.string().nullable(),
+    lastRemoteChange: z.string().nullable(),
+    lastSyncAt: z.string().nullable(),
+    lastSyncDirection: z.enum(['push', 'pull']).nullable(),
+    syncStatus: SyncStatusSchema,
+    errorMessage: z.string().nullable()
+});
+export const SyncStateSchema = z.object({
+    version: z.literal(1),
+    updatedAt: z.string(),
+    manifests: z.record(z.string(), ManifestSyncStateSchema)
+});
+//# sourceMappingURL=sync-state.js.map

package/dist/sync/schemas/sync-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-state.js","sourceRoot":"","sources":["../../../src/sync/schemas/sync-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,SAAS;IACT,aAAa;IACb,cAAc;IACd,UAAU;IACV,QAAQ;IACR,cAAc;CACd,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtD,UAAU,EAAE,gBAAgB;IAC5B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC;CACxD,CAAC,CAAC"}

package/dist/sync/sync-bridge.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Sync Bridge — Default Implementation
+ *
+ * Executes bidirectional sync between local runtime descriptors and a cloud CRUD API.
+ * Each SyncBridge instance corresponds to a storage/sync-bridge descriptor.
+ *
+ * Flow:
+ * 1. Collect local descriptors via runtime.query(source.runtimeKind)
+ * 2. Fetch remote entities from target.apiPath
+ * 3. Diff local ↔ remote by idField
+ * 4. Push new/updated local items, pull new/updated remote items
+ * 5. Track state in sync-state.json alongside storage manifests
+ */
+import type { SyncBridgeDescriptor } from '../schemas/sync-bridge-descriptor';
+import type { KindContext } from '@vibesdotdev/runtime/schemas/kind';
+export interface SyncBridgeResult {
+    bridgeId: string;
+    pushed: number;
+    pulled: number;
+    skipped: number;
+    conflicts: number;
+    errors: number;
+    details: Array<{
+        entityId: string;
+        action: 'pushed' | 'pulled' | 'skipped' | 'conflict' | 'error';
+        message?: string;
+    }>;
+}
+export interface SyncBridgeOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    direction?: 'push' | 'pull' | 'both';
+}
+/**
+ * Default SyncBridge implementation.
+ * Constructed by the runtime with (descriptor, context).
+ */
+export declare class SyncBridge {
+    readonly descriptor: SyncBridgeDescriptor;
+    constructor(descriptor: SyncBridgeDescriptor, _context?: KindContext);
+    get id(): string;
+    /** Cached h2 fetch for HTTPS local endpoints */
+    private _h2Fetch;
+    /**
+     * Get an HTTP/2-aware fetch function.
+     * Local HTTPS endpoints (vite dev) require h2 since Bun's fetch is h1 only.
+     */
+    private getFetch;
+    /**
+     * Collect local descriptors from the runtime.
+     */
+    collectLocal(): Promise<Record<string, unknown>[]>;
+    private stripSensitiveFields;
+    private buildPushShape;
+    private buildComparableRemote;
+    private getEntityTimestamp;
+    private isDeleted;
+    private resolveConflictAction;
+    private extractList;
+    /**
+     * Fetch remote entities from the cloud CRUD API.
+     */
+    fetchRemote(apiEndpoint: string, apiToken?: string): Promise<Record<string, unknown>[]>;
+    /**
+     * Push a single entity to the cloud.
+     */
+    pushEntity(entity: Record<string, unknown>, apiEndpoint: string, apiToken?: string): Promise<void>;
+    deleteEntity(entity: Record<string, unknown>, apiEndpoint: string, apiToken?: string): Promise<void>;
+    /**
+     * Persist pulled items locally.
+     * Storage-backed bridges: merge into the storage manifest (localdb/json).
+     * Descriptor-only bridges: register with runtime.
+     */
+    private persistPulledItems;
+    /**
+     * Execute a full sync cycle.
+     */
+    execute(apiEndpoint: string, options?: SyncBridgeOptions, apiToken?: string): Promise<SyncBridgeResult>;
+}
+//# sourceMappingURL=sync-bridge.d.ts.map

package/dist/sync/sync-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-bridge.d.ts","sourceRoot":"","sources":["../../src/sync/sync-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAarE,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;QAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACrC;AAED;;;GAGG;AACH,qBAAa,UAAU;IACtB,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;gBAE9B,UAAU,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,WAAW;IAIpE,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAA2E;IAE3F;;;OAGG;YACW,QAAQ;IA2BtB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAaxD,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,qBAAqB;IA8B7B,OAAO,CAAC,WAAW;IAqBnB;;OAEG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAqE7F;;OAEG;IACG,UAAU,CACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAqCV,YAAY,CACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAoChB;;;;OAIG;YACW,kBAAkB;IA4ChC;;OAEG;IACG,OAAO,CACZ,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,iBAAsB,EAC/B,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC;CA2V5B"}