@vibesdotdev/storage 0.0.2 → 1.0.0-rc.3

package/dist/sync/record-sync-bridge.js

@@ -1,20 +1,16 @@
-import { getVibesRuntime } from '@vibesdotdev/runtime';
-import { resolveWorkspacePath } from '../paths.js';
-import { StorageRecord } from '../record';
-import { resolveCloudRecordCrudConfig } from './cloud-record-crud-config.js';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { resolveWorkspacePath } from "../paths.js";
+import { StorageRecord } from "../record/index.js";
+import { cloudRecordCrudConfigOf, resolveCloudRecordCrudConfig } from "./cloud-record-crud-config.js";
 const PAGE_SIZE = 200;
+/** A record is syncable when it is enabled, allows the cloud adapter and declares remote CRUD metadata. */
 export function isSyncableStorageRecord(descriptor) {
     if (descriptor.enabled === false)
         return false;
     if (!descriptor.allowedAdapters.includes('storage.cloud-api'))
         return false;
-    try {
-        resolveCloudRecordCrudConfig(descriptor);
-        return true;
-    }
-    catch {
-        return false;
-    }
+    return cloudRecordCrudConfigOf(descriptor) !== undefined;
 }
 export function createRecordSyncBridgeDescriptor(descriptor) {
     const sync = descriptor.sync;
@@ -42,57 +38,61 @@ export function createRecordSyncBridgeDescriptor(descriptor) {
             sensitiveFields: sync?.sensitiveFields ?? [],
             idField: sync?.idField ?? descriptor.primaryKey ?? 'id'
         },
-        collect: () => collectRecordItems(descriptor, sync),
+        collect: ({ runtime }) => collectRecordItems(runtime, descriptor, sync),
         toRemote: sync?.toRemote,
         fromRemote: sync?.fromRemote,
-        beforePush: beforePush
-            ? (record, context) => beforePush(record, {
-                ...context,
-                runtime: getVibesRuntime()
-            })
-            : undefined,
-        deleteRemote: deleteRemote
-            ? (record, context) => deleteRemote(record, {
-                ...context,
-                runtime: getVibesRuntime()
-            })
-            : undefined,
-        writePulled: (items) => writePulledRecordItems(descriptor, sync, items)
+        // Every hook runs on the bridge's own runtime (the context it passes).
+        beforePush: beforePush ? (record, context) => beforePush(record, context) : undefined,
+        deleteRemote: deleteRemote ? (record, context) => deleteRemote(record, context) : undefined,
+        writePulled: (items, { runtime }) => writePulledRecordItems(runtime, descriptor, sync, items)
     };
 }
-async function collectRecordItems(descriptor, sync) {
-    const runtime = getVibesRuntime();
-    const record = await resolveLocalRecord(descriptor);
+async function collectRecordItems(runtime, descriptor, sync) {
+    const record = await resolveLocalRecord(runtime, descriptor);
     const collect = sync?.collect;
-    if (collect) {
-        return collect({
-            runtime,
-            record: record
+    if (collect)
+        return collect({ runtime, record });
+    return listAllRecords(record);
+}
+/** A pulled item's id under the record's id field; one without a string id refuses typed (never silently skipped). */
+function pulledIdOf(item, idField, recordId) {
+    const parsed = z.string().min(1).safeParse(item[idField]);
+    if (!parsed.success) {
+        throw new CapabilityError(`A pulled item for record '${recordId}' has no string id.`, 'INVALID_INPUT', {
+            reason: 'record-sync-pulled-id-invalid',
+            retryable: false,
+            details: { recordId, idField }
         });
     }
-    return listAllRecords(record);
+    return parsed.data;
 }
-async function writePulledRecordItems(descriptor, sync, items) {
-    const runtime = getVibesRuntime();
-    const record = (await resolveLocalRecord(descriptor));
+async function writePulledRecordItems(runtime, descriptor, sync, items) {
+    if (items.length === 0)
+        return;
+    const record = await resolveLocalRecord(runtime, descriptor);
     const writePulled = sync?.writePulled;
     if (writePulled) {
         await writePulled(items, { runtime, record });
         return;
     }
     const idField = sync?.idField ?? descriptor.primaryKey ?? 'id';
-    for (const item of items) {
-        const id = item[idField];
-        if (typeof id !== 'string')
-            continue;
-        await record.delete(id, { force: true }).catch(() => undefined);
-        await record.create(item);
-    }
+    await record.transaction(async () => {
+        for (const item of items) {
+            const id = pulledIdOf(item, idField, descriptor.id);
+            // Replace-by-id: a delete of a row that is not there resolves (`success: false`);
+            // any other delete failure surfaces rather than being papered over by the create.
+            await record.delete(id, { force: true });
+            await record.create(item);
+        }
+    });
 }
-async function resolveLocalRecord(descriptor) {
+/** Derives the local-only record descriptor used for inbound sync writes. Outbound delivery is suppressed. */
+export function createLocalRecordDescriptor(descriptor) {
     const localAdapters = descriptor.persistence?.localAdapters ?? ['storage.localdb'];
-    const localDescriptor = {
+    return {
         ...descriptor,
+        // Inbound sync writes must not enqueue outbound delivery jobs (prevents delivery loops)
+        delivery: undefined,
         defaultAdapter: localAdapters[0] ?? descriptor.defaultAdapter,
         persistence: {
             ...(descriptor.persistence ?? { mode: 'local-first' }),
@@ -101,8 +101,12 @@ async function resolveLocalRecord(descriptor) {
             remoteAdapters: descriptor.persistence?.remoteAdapters ?? ['storage.cloud-api']
         }
     };
+}
+async function resolveLocalRecord(runtime, descriptor) {
+    const localDescriptor = createLocalRecordDescriptor(descriptor);
     const record = new StorageRecord(localDescriptor, {
-        'runtime/workspace-path': resolveWorkspacePath()
+        runtime,
+        'runtime/workspace-path': resolveWorkspacePath(runtime)
     });
     await record.initialize();
     return record;

package/dist/sync/record-sync-bridge.js.map

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

package/dist/sync/resolve-sync-target.d.ts

@@ -1,23 +1,22 @@
+import type { SyncTarget, ResolveSyncTargetOptions } from '../schemas/sync/results.ts';
+export type { SyncTarget, ResolveSyncTargetOptions } from '../schemas/sync/results.ts';
 /**
  * Resolve Sync Target
  *
- * Resolves the current sync target URL, environment name, and auth token from the runtime.
- * Used by CLI commands and sync-bridge to determine where to push/pull data.
+ * The sync target of an owner app is that app's declared `infra/service`
+ * primary origin in the service environment the handed runtime selects
+ * from its runtime-resolved `infra/service` target port.
+ * Knowledge sync uses the `knowledge` service (e.g.
+ * `https://knowledge.vibes.dev`), never a marketing `apiUrl` and never the
+ * legacy `VIBES_API_URL`.
  *
- * Resolution chain for sync target:
- * 1. config/environment → apiUrl
- * 2. VIBES_API_URL environment variable
- * 3. 'unknown' (no target configured)
- *
- * Resolution chain for auth token:
- * 1. config/environment → apiToken
- * 2. config/manifest#auth → credentials.token (CLI credential store)
- * 3. VIBES_AUTH_TOKEN environment variable
+ * - A service the catalog does not declare is `'unknown'` (callers refuse to
+ *   push to it); any other failure (the infra.services config, the host tier)
+ *   propagates typed from the infra owner.
+ * - The token is the caller's bearer (auth's `resolveCallerBearer` through the
+ *   `auth/caller-bearer` context). The former `config/environment.apiToken`
+ *   left with that kind (rc04).
  */
-export interface SyncTarget {
-    syncTarget: string;
-    envName: string;
-    apiToken?: string;
-}
-export declare function resolveSyncTarget(): Promise<SyncTarget>;
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+export declare function resolveSyncTarget(runtime: VibesRuntime, ownerApp?: string, options?: ResolveSyncTargetOptions): Promise<SyncTarget>;
 //# sourceMappingURL=resolve-sync-target.d.ts.map

package/dist/sync/resolve-sync-target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-sync-target.d.ts","sourceRoot":"","sources":["../../src/sync/resolve-sync-target.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,UAAU;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,UAAU,CAAC,CA+B7D"}
+{"version":3,"file":"resolve-sync-target.d.ts","sourceRoot":"","sources":["../../src/sync/resolve-sync-target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACvF;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,YAAY,EACrB,QAAQ,SAAc,EACtB,OAAO,GAAE,wBAA6B,GACpC,OAAO,CAAC,UAAU,CAAC,CAerB"}

package/dist/sync/resolve-sync-target.js

@@ -1,45 +1,20 @@
-/**
- * Resolve Sync Target
- *
- * Resolves the current sync target URL, environment name, and auth token from the runtime.
- * Used by CLI commands and sync-bridge to determine where to push/pull data.
- *
- * Resolution chain for sync target:
- * 1. config/environment → apiUrl
- * 2. VIBES_API_URL environment variable
- * 3. 'unknown' (no target configured)
- *
- * Resolution chain for auth token:
- * 1. config/environment → apiToken
- * 2. config/manifest#auth → credentials.token (CLI credential store)
- * 3. VIBES_AUTH_TOKEN environment variable
- */
-import { getRuntimeEnv, getVibesRuntime } from '@vibesdotdev/runtime';
-export async function resolveSyncTarget() {
-    let syncTarget = getRuntimeEnv('VIBES_API_URL') ?? 'unknown';
-    let envName = 'env';
-    let apiToken;
-    try {
-        const runtime = getVibesRuntime();
-        const env = (await runtime.query('config/environment').resolve());
-        if (env?.apiUrl)
-            syncTarget = env.apiUrl;
-        if (env?.name)
-            envName = env.name;
-        else if (env?.id)
-            envName = env.id;
-        if (env?.apiToken)
-            apiToken = env.apiToken;
-    }
-    catch {
-        // Environment resolution may fail; use fallback
-    }
-    // Credential store lives in the app layer; consumers must supply auth via
-    // environment config or VIBES_AUTH_TOKEN.
-    // Fallback to environment variable
-    if (!apiToken && getRuntimeEnv('VIBES_AUTH_TOKEN')) {
-        apiToken = getRuntimeEnv('VIBES_AUTH_TOKEN');
-    }
-    return { syncTarget, envName, apiToken };
+import { ServiceTargetSchema } from '@vibesdotdev/infra-contracts';
+import { parseAdapterInput } from "../adapters/parse-adapter-input.js";
+import { resolveStorageCallerBearer } from "../utils/caller-bearer.js";
+export async function resolveSyncTarget(runtime, ownerApp = 'knowledge', options = {}) {
+    if (!runtime.hasKind('infra/service'))
+        return { syncTarget: 'unknown', envName: 'unknown' };
+    if (runtime.query('infra/service').withId(ownerApp).descriptors().length === 0)
+        return { syncTarget: 'unknown', envName: 'unknown' };
+    const service = await runtime.query('infra/service').withId(ownerApp).resolve();
+    const selected = parseAdapterInput(ServiceTargetSchema, await service.target('primary'), {
+        message: 'The service target answer is invalid.', code: 'INTERNAL', reason: 'service-target-invalid'
+    });
+    const syncTarget = selected.origin.replace(/\/$/, '');
+    const apiToken = options.includeBearer === false ? undefined : ((await resolveStorageCallerBearer(runtime)) ?? undefined);
+    const target = { syncTarget, envName: selected.environment };
+    if (apiToken)
+        target.apiToken = apiToken;
+    return target;
 }
 //# sourceMappingURL=resolve-sync-target.js.map

package/dist/sync/resolve-sync-target.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-sync-target.js","sourceRoot":"","sources":["../../src/sync/resolve-sync-target.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAQtE,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACtC,IAAI,UAAU,GAAG,aAAa,CAAC,eAAe,CAAC,IAAI,SAAS,CAAC;IAC7D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,QAA4B,CAAC;IAEjC,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,OAAO,EAAE,CAKxD,CAAC;QAET,IAAI,GAAG,EAAE,MAAM;YAAE,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC;QACzC,IAAI,GAAG,EAAE,IAAI;YAAE,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;aAC7B,IAAI,GAAG,EAAE,EAAE;YAAE,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,GAAG,EAAE,QAAQ;YAAE,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACR,gDAAgD;IACjD,CAAC;IAED,0EAA0E;IAC1E,0CAA0C;IAE1C,mCAAmC;IACnC,IAAI,CAAC,QAAQ,IAAI,aAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACpD,QAAQ,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"resolve-sync-target.js","sourceRoot":"","sources":["../../src/sync/resolve-sync-target.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,mBAAmB,EAA4C,MAAM,8BAA8B,CAAC;AAC7G,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,OAAqB,EACrB,QAAQ,GAAG,WAAW,EACtB,UAAoC,EAAE;IAEtC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAC5F,IAAI,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAErI,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAiC,eAAe,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;IAChH,MAAM,QAAQ,GAAG,iBAAiB,CAAC,mBAAmB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;QACxF,OAAO,EAAE,uCAAuC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,wBAAwB;KACpG,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEtD,MAAM,QAAQ,GACb,OAAO,CAAC,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,0BAA0B,CAAC,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC;IAC1G,MAAM,MAAM,GAAe,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC;IACzE,IAAI,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACzC,OAAO,MAAM,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { CloudSyncPushOptions } from '../schemas/sync/results.ts';
+import type { CloudSyncStateStore } from '../manifest/cloud-sync.core.ts';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import type { SyncState } from './schemas/sync-state.ts';
+import type { SyncStateRuntime } from './sync-state.consumer.ts';
+/** Both substrates satisfy this shape; the browser's ignores the runtime. */
+export interface RuntimeSyncStateModule extends CloudSyncStateStore {
+    afterSaveOptions: CloudSyncPushOptions;
+    loadSyncState(runtime: SyncStateRuntime): Promise<SyncState>;
+    saveSyncState(state: SyncState, runtime: SyncStateRuntime): Promise<void>;
+    markAllPaused: typeof import('./sync-state.browser.ts').markAllPaused;
+}
+/**
+ * Resolve sync-state persistence through the owning runtime. Pass the runtime
+ * the caller was handed; nothing is read from an ambient or global runtime.
+ */
+export declare function loadRuntimeSyncStateModule(runtime: RuntimeRef): Promise<RuntimeSyncStateModule>;
+//# sourceMappingURL=runtime-sync-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-sync-state.d.ts","sourceRoot":"","sources":["../../src/sync/runtime-sync-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAY1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,6EAA6E;AAC7E,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IAClE,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7D,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,aAAa,EAAE,cAAc,yBAAyB,EAAE,aAAa,CAAC;CACtE;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAKrG"}

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

@@ -0,0 +1,12 @@
+import { STORAGE_SYNC_STATE_ID, STORAGE_SYNC_STATE_KIND } from "./sync-state.descriptor.js";
+/**
+ * Resolve sync-state persistence through the owning runtime. Pass the runtime
+ * the caller was handed; nothing is read from an ambient or global runtime.
+ */
+export async function loadRuntimeSyncStateModule(runtime) {
+    return runtime
+        .query(STORAGE_SYNC_STATE_KIND)
+        .withId(STORAGE_SYNC_STATE_ID)
+        .resolve();
+}
+//# sourceMappingURL=runtime-sync-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-sync-state.js","sourceRoot":"","sources":["../../src/sync/runtime-sync-state.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAU5F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAAmB;IACnE,OAAO,OAAO;SACZ,KAAK,CAA4C,uBAAuB,CAAC;SACzE,MAAM,CAAC,qBAAqB,CAAC;SAC7B,OAAO,EAAE,CAAC;AACb,CAAC"}

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

@@ -16,10 +16,14 @@ export interface CloudPullResult {
     skipped: number;
     conflicts: number;
     errors: number;
-    details: Array<{
-        manifestId: string;
-        action: 'pulled' | 'skipped' | 'conflict' | 'error';
-        message?: string;
-    }>;
+    details: CloudPullDetail[];
+}
+/** One manifest's pull outcome. */
+export interface CloudPullDetail {
+    manifestId: string;
+    action: 'pulled' | 'skipped' | 'conflict' | 'error';
+    message?: string;
+    /** An `error` outcome's value-free failure facts (class, code, reason). */
+    failure?: import('@vibesdotdev/kernel').ValueFreeFailure;
 }
 //# sourceMappingURL=cloud-pull.d.ts.map

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

@@ -1 +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"}
+{"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,eAAe,EAAE,CAAC;CAC3B;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,gBAAgB,CAAC;CACzD"}

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

@@ -3,7 +3,7 @@
  *
  * 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';
+export { SyncStatusSchema, ManifestSyncStateSchema, SyncStateSchema, type SyncStatus, type ManifestSyncState, type SyncState } from './sync-state.ts';
+export { type CloudPullOptions, type CloudPullResult } from './cloud-pull.ts';
+export { type SyncHelpers } from './sync-helpers.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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,iBAAiB,CAAC;AAEzB,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/sync/schemas/index.js

@@ -3,7 +3,7 @@
  *
  * 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';
+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

@@ -1 +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"}
+{"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,iBAAiB,CAAC;AAEzB,OAAO,EAA+C,MAAM,iBAAiB,CAAC;AAE9E,OAAO,EAAoB,MAAM,mBAAmB,CAAC"}

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

@@ -3,15 +3,17 @@
  *
  * Interface for sync operation helper functions passed between sync components.
  */
-import type { SyncState, ManifestSyncState } from './sync-state';
+import type { SyncState, ManifestSyncState } from './sync-state.ts';
 export interface SyncHelpers {
     dryRun: boolean;
-    computeHash: (data: unknown) => string;
+    computeHash: <TValue>(data: TValue) => 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;
+    /** Optional: clear a prior error after a successful skip/decision. */
+    clearError?: (state: SyncState, id: 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

@@ -1 +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"}
+{"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,iBAAiB,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,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,sEAAsE;IACtE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,eAAe,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE"}

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

@@ -6,10 +6,10 @@
  */
 import * as z from 'zod/v4';
 export declare const SyncStatusSchema: z.ZodEnum<{
+    conflict: "conflict";
     "in-sync": "in-sync";
     "local-ahead": "local-ahead";
     "remote-ahead": "remote-ahead";
-    conflict: "conflict";
     paused: "paused";
     "never-synced": "never-synced";
 }>;
@@ -18,18 +18,19 @@ export declare const ManifestSyncStateSchema: z.ZodObject<{
     manifestId: z.ZodString;
     localHash: z.ZodNullable<z.ZodString>;
     remoteHash: z.ZodNullable<z.ZodString>;
+    hashVersion: z.ZodOptional<z.ZodNumber>;
     lastLocalChange: z.ZodNullable<z.ZodString>;
     lastRemoteChange: z.ZodNullable<z.ZodString>;
     lastSyncAt: z.ZodNullable<z.ZodString>;
     lastSyncDirection: z.ZodNullable<z.ZodEnum<{
-        pull: "pull";
         push: "push";
+        pull: "pull";
     }>>;
     syncStatus: z.ZodEnum<{
+        conflict: "conflict";
         "in-sync": "in-sync";
         "local-ahead": "local-ahead";
         "remote-ahead": "remote-ahead";
-        conflict: "conflict";
         paused: "paused";
         "never-synced": "never-synced";
     }>;
@@ -43,18 +44,19 @@ export declare const SyncStateSchema: z.ZodObject<{
         manifestId: z.ZodString;
         localHash: z.ZodNullable<z.ZodString>;
         remoteHash: z.ZodNullable<z.ZodString>;
+        hashVersion: z.ZodOptional<z.ZodNumber>;
         lastLocalChange: z.ZodNullable<z.ZodString>;
         lastRemoteChange: z.ZodNullable<z.ZodString>;
         lastSyncAt: z.ZodNullable<z.ZodString>;
         lastSyncDirection: z.ZodNullable<z.ZodEnum<{
-            pull: "pull";
             push: "push";
+            pull: "pull";
         }>>;
         syncStatus: z.ZodEnum<{
+            conflict: "conflict";
             "in-sync": "in-sync";
             "local-ahead": "local-ahead";
             "remote-ahead": "remote-ahead";
-            conflict: "conflict";
             paused: "paused";
             "never-synced": "never-synced";
         }>;

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;iBAWlC,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

@@ -17,6 +17,7 @@ export const ManifestSyncStateSchema = z.object({
     manifestId: z.string(),
     localHash: z.string().nullable(),
     remoteHash: z.string().nullable(),
+    hashVersion: z.number().optional(),
     lastLocalChange: z.string().nullable(),
     lastRemoteChange: z.string().nullable(),
     lastSyncAt: z.string().nullable(),

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

@@ -1 +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"}
+{"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,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,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

@@ -1,3 +1,5 @@
+import type { SyncBridgeResult, SyncBridgeOptions } from '../schemas/sync/results.ts';
+export type { SyncBridgeResult, SyncBridgeOptions } from '../schemas/sync/results.ts';
 /**
  * Sync Bridge — Default Implementation
  *
@@ -11,61 +13,59 @@
  * 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';
-}
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { type SyncBridgeDescriptor, type SyncEntity } from '../schemas/sync-bridge-descriptor.ts';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+/** The longest one remote request may take before it is refused `TIMEOUT sync-remote-timeout`. */
+export declare const SYNC_REMOTE_REQUEST_TIMEOUT_MS = 30000;
 /**
  * Default SyncBridge implementation.
  * Constructed by the runtime with (descriptor, context).
  */
 export declare class SyncBridge {
     readonly descriptor: SyncBridgeDescriptor;
-    constructor(descriptor: SyncBridgeDescriptor, _context?: KindContext);
+    /** The runtime that constructed this bridge (`context.runtime`); every read goes through it. */
+    private readonly runtime;
+    constructor(descriptor: SyncBridgeDescriptor, context: KindContext<VibesRuntime>);
     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.
+     * One remote request, bounded: the runtime lifecycle's deadline
+     * ({@link SYNC_REMOTE_REQUEST_TIMEOUT_MS}) and its disposal abort it. A
+     * transport failure refuses `UNAVAILABLE sync-remote-unreachable` (its
+     * cause kept, its message naming no URL); the deadline refuses
+     * `TIMEOUT sync-remote-timeout`. Certificate verification is never
+     * switched off here: a local endpoint with a self-signed certificate is
+     * trusted by the host, not by this bridge.
      */
-    private getFetch;
+    /** The descriptor's per-request deadline, or the default. */
+    private get requestTimeoutMs();
+    private readonly boundedFetch;
     /**
      * Collect local descriptors from the runtime.
      */
-    collectLocal(): Promise<Record<string, unknown>[]>;
+    collectLocal(): Promise<SyncEntity[]>;
     private stripSensitiveFields;
-    private buildPushShape;
+    private toPushedEntity;
     private buildComparableRemote;
     private getEntityTimestamp;
     private isDeleted;
     private resolveConflictAction;
+    /**
+     * The entity list of a remote page: the bare array, else the declared list
+     * field, else a known envelope field. Every item must be an object: a page
+     * whose list holds anything else refuses `sync-remote-body-invalid`
+     * (a malformed answer from the remote is a failure, never absence).
+     */
     private extractList;
     /**
      * Fetch remote entities from the cloud CRUD API.
      */
-    fetchRemote(apiEndpoint: string, apiToken?: string): Promise<Record<string, unknown>[]>;
+    fetchRemote(apiEndpoint: string, apiToken?: string): Promise<SyncEntity[]>;
     /**
      * 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>;
+    pushEntity(entity: SyncEntity, apiEndpoint: string, apiToken?: string): Promise<void>;
+    deleteEntity(entity: SyncEntity, apiEndpoint: string, apiToken?: string): Promise<void>;
     /**
      * Persist pulled items locally.
      * Storage-backed bridges: merge into the storage manifest (localdb/json).
@@ -75,6 +75,14 @@ export declare class SyncBridge {
     /**
      * Execute a full sync cycle.
      */
+    /**
+     * Push one local entity: the durable delivery of a single created record
+     * (D-RC11). Same `beforePush` hook, push shape and upsert as `execute`, and
+     * the same sync-state entry, without collecting or fetching the whole
+     * collection. A failure is recorded on the entity's sync state and thrown,
+     * so the delivering Workers job retries it.
+     */
+    pushOne(localItem: SyncEntity, apiEndpoint: string, apiToken?: string): Promise<void>;
     execute(apiEndpoint: string, options?: SyncBridgeOptions, apiToken?: string): Promise<SyncBridgeResult>;
 }
 //# sourceMappingURL=sync-bridge.d.ts.map