sh3-core 0.8.2 → 0.9.1

package/dist/server-shard/types.d.ts

@@ -10,8 +10,51 @@
  * The server bundle is a separate ESM file whose default export conforms
  * to the `ServerShard` interface.
  */
-import type { SyncHandle } from '../documents/sync/types';
-import type { SyncRegistry } from '../documents/sync/registry';
+import type { DocumentMeta } from '../documents/types';
+import type { SyncPolicy, ConflictFile } from '../documents/sync-types';
+/**
+ * Per-tenant document API exposed to server shards via
+ * `ServerShardContext.documents(tenantId)`. Every method is
+ * permission-checked by the host at call time.
+ */
+export interface TenantDocumentAPI {
+    read(shardId: string, path: string): Promise<string | null>;
+    exists(shardId: string, path: string): Promise<boolean>;
+    list(shardId: string): Promise<DocumentMeta[]>;
+    listAll(): Promise<Array<DocumentMeta & {
+        shardId: string;
+    }>>;
+    write(shardId: string, path: string, content: string | Uint8Array, metadata?: Record<string, unknown>): Promise<{
+        version: number;
+        syncState: 'synced' | 'pending';
+    }>;
+    delete(shardId: string, path: string): Promise<void>;
+    applyFromPeer(input: {
+        shardId: string;
+        path: string;
+        content: string | Uint8Array;
+        incomingVersion: number;
+        expectedLocalVersion: number;
+        origin: string;
+        deleted?: boolean;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        applied: true;
+        version: number;
+    } | {
+        applied: false;
+        reason: 'stale' | 'conflict' | 'conflict-extended';
+    }>;
+    getTick(): Promise<number>;
+    readPolicy(): Promise<SyncPolicy | null>;
+    writePolicy(policy: SyncPolicy): Promise<void>;
+    listConflicts(): Promise<Array<{
+        shardId: string;
+        path: string;
+    }>>;
+    readConflict(shardId: string, path: string): Promise<ConflictFile | null>;
+    resolveConflict(shardId: string, path: string, choice: 'local' | string | Uint8Array): Promise<void>;
+}
 /**
  * Context provided by sh3-server when mounting a server shard's routes.
  */
@@ -41,14 +84,16 @@ export interface ServerShardContext {
      * WebSocket upgrade registration — unchanged from 0.8.1.
      */
     wsRegister?: (onConnect: (ws: any, c: any) => void) => any;
+    /** Tenant ids that currently have doc content on this server. */
+    tenants(): string[];
+    /** Per-tenant document API, permission-checked per operation. */
+    documents(tenant: string): TenantDocumentAPI;
     /**
-     * Obtain a tenant-scoped SyncHandle from a server-side route handler.
-     * The handle enforces GrantRecord checks exactly like the client-side
-     * one. Throws if the shard's manifest does not declare `documents:sync`.
+     * Declare the server's role for a tenant. Called by shards with
+     * `sync:peer` permission. No-op unless the caller holds it.
+     * Absent => 'primary' behavior at the store.
      */
-    sync: (tenantId: string, connectorId: string) => Promise<SyncHandle>;
-    /** Tenant-scoped SyncRegistry accessor — grant enumeration/listing. */
-    syncRegistry: (tenantId: string) => SyncRegistry;
+    setPeerRole(tenant: string, role: 'primary' | 'replica'): void;
 }
 /**
  * The interface a server shard bundle must default-export.
@@ -64,6 +109,8 @@ export interface ServerShard {
      * May be async if the shard needs to initialise resources before serving.
      */
     routes: (router: HonoLike, context: ServerShardContext) => void | Promise<void>;
+    /** Optional shutdown hook. Called once on server SIGTERM/SIGINT. */
+    teardown?(): void | Promise<void>;
 }
 /**
  * Hono MiddlewareHandler type — duplicated here to avoid importing hono

package/dist/shards/activate-browse.test.js

@@ -2,14 +2,14 @@ import { describe, it, expect, beforeEach } from 'vitest';
 import { MemoryDocumentBackend } from '../documents/backends';
 import { __setDocumentBackend, __setTenantId } from '../documents/config';
 import { registerShard, activateShard, __resetShardRegistryForTest } from './activate.svelte';
-import { PERMISSION_DOCUMENTS_BROWSE } from '../documents/types';
+import { PERMISSION_DOCUMENTS_BROWSE, PERMISSION_DOCUMENTS_READ, PERMISSION_DOCUMENTS_WRITE, } from '../documents/types';
 describe('ctx.browse permission gating', () => {
     beforeEach(() => {
         __resetShardRegistryForTest();
         __setDocumentBackend(new MemoryDocumentBackend());
         __setTenantId('tenant-a');
     });
-    it('is undefined when permission is absent', async () => {
+    it('is undefined when no documents permission is declared', async () => {
         let captured = null;
         registerShard({
             manifest: { id: 'no-browse', label: 'n', version: '0.0.0', views: [] },
@@ -18,7 +18,7 @@ describe('ctx.browse permission gating', () => {
         await activateShard('no-browse');
         expect(captured.browse).toBeUndefined();
     });
-    it('is defined when documents:browse is declared', async () => {
+    it('exposes metadata methods when documents:browse is declared', async () => {
         var _a, _b, _c;
         let captured = null;
         registerShard({
@@ -33,4 +33,88 @@ describe('ctx.browse permission gating', () => {
         expect(typeof ((_b = captured.browse) === null || _b === void 0 ? void 0 : _b.watchDocuments)).toBe('function');
         expect(typeof ((_c = captured.browse) === null || _c === void 0 ? void 0 : _c.listShards)).toBe('function');
     });
+    it('omits readFrom and writeTo when only documents:browse is declared', async () => {
+        var _a, _b;
+        let captured = null;
+        registerShard({
+            manifest: {
+                id: 'browse-only', label: 'b', version: '0.0.0', views: [],
+                permissions: [PERMISSION_DOCUMENTS_BROWSE],
+            },
+            activate(ctx) { captured = ctx; },
+        });
+        await activateShard('browse-only');
+        expect((_a = captured.browse) === null || _a === void 0 ? void 0 : _a.readFrom).toBeUndefined();
+        expect((_b = captured.browse) === null || _b === void 0 ? void 0 : _b.writeTo).toBeUndefined();
+    });
+    it('exposes readFrom when documents:browse + documents:read are declared', async () => {
+        var _a, _b;
+        let captured = null;
+        registerShard({
+            manifest: {
+                id: 'browse-and-read', label: 'br', version: '0.0.0', views: [],
+                permissions: [PERMISSION_DOCUMENTS_BROWSE, PERMISSION_DOCUMENTS_READ],
+            },
+            activate(ctx) { captured = ctx; },
+        });
+        await activateShard('browse-and-read');
+        expect(typeof ((_a = captured.browse) === null || _a === void 0 ? void 0 : _a.readFrom)).toBe('function');
+        expect((_b = captured.browse) === null || _b === void 0 ? void 0 : _b.writeTo).toBeUndefined();
+    });
+    it('exposes writeTo when documents:browse + documents:write are declared', async () => {
+        var _a, _b;
+        let captured = null;
+        registerShard({
+            manifest: {
+                id: 'browse-and-write', label: 'bw', version: '0.0.0', views: [],
+                permissions: [PERMISSION_DOCUMENTS_BROWSE, PERMISSION_DOCUMENTS_WRITE],
+            },
+            activate(ctx) { captured = ctx; },
+        });
+        await activateShard('browse-and-write');
+        expect((_a = captured.browse) === null || _a === void 0 ? void 0 : _a.readFrom).toBeUndefined();
+        expect(typeof ((_b = captured.browse) === null || _b === void 0 ? void 0 : _b.writeTo)).toBe('function');
+    });
+    it('exposes both readFrom and writeTo when all three permissions are declared', async () => {
+        var _a, _b;
+        let captured = null;
+        registerShard({
+            manifest: {
+                id: 'full-access', label: 'full', version: '0.0.0', views: [],
+                permissions: [
+                    PERMISSION_DOCUMENTS_BROWSE,
+                    PERMISSION_DOCUMENTS_READ,
+                    PERMISSION_DOCUMENTS_WRITE,
+                ],
+            },
+            activate(ctx) { captured = ctx; },
+        });
+        await activateShard('full-access');
+        expect(typeof ((_a = captured.browse) === null || _a === void 0 ? void 0 : _a.readFrom)).toBe('function');
+        expect(typeof ((_b = captured.browse) === null || _b === void 0 ? void 0 : _b.writeTo)).toBe('function');
+    });
+    it('yields no ctx.browse when documents:read is declared without documents:browse', async () => {
+        let captured = null;
+        registerShard({
+            manifest: {
+                id: 'read-only', label: 'r', version: '0.0.0', views: [],
+                permissions: [PERMISSION_DOCUMENTS_READ],
+            },
+            activate(ctx) { captured = ctx; },
+        });
+        await activateShard('read-only');
+        expect(captured.browse).toBeUndefined();
+    });
+    it('yields no ctx.browse when documents:write is declared without documents:browse', async () => {
+        let captured = null;
+        registerShard({
+            manifest: {
+                id: 'write-only', label: 'w', version: '0.0.0', views: [],
+                permissions: [PERMISSION_DOCUMENTS_WRITE],
+            },
+            activate(ctx) { captured = ctx; },
+        });
+        await activateShard('write-only');
+        expect(captured.browse).toBeUndefined();
+    });
 });

package/dist/shards/activate.svelte.js

@@ -23,12 +23,8 @@ import { fetchEnvState, putEnvState } from '../env/client';
 import { isAdmin as checkIsAdmin } from '../auth/index';
 import { createZoneManager } from '../state/manage';
 import { PERMISSION_STATE_MANAGE } from '../state/types';
-import { PERMISSION_DOCUMENTS_SYNC } from '../documents/sync/types';
-import { PERMISSION_DOCUMENTS_BROWSE } from '../documents/types';
+import { PERMISSION_DOCUMENTS_BROWSE, PERMISSION_DOCUMENTS_READ, PERMISSION_DOCUMENTS_WRITE, } from '../documents/types';
 import { createBrowseCapability } from '../documents/browse';
-import { getSyncBundle } from '../documents/sync/singleton';
-import { createSyncHandle } from '../documents/sync/handle';
-import { createSyncRegistryAccessor } from '../documents/sync/observer';
 import { createShardKeysApi } from '../keys/client';
 import { PERMISSION_KEYS_MINT } from '../keys/types';
 import { subscribe } from '../keys/revocation-bus.svelte';
@@ -74,7 +70,7 @@ export function registerShard(shard) {
  * @throws If the shard is not registered, or if a manifest view has no factory after activation.
  */
 export async function activateShard(id) {
-    var _a, _b, _c, _d, _e, _f, _g;
+    var _a, _b, _c, _d, _e;
     const shard = registeredShards.get(id);
     if (!shard) {
         throw new Error(`Cannot activate shard "${id}": not registered`);
@@ -141,33 +137,15 @@ export async function activateShard(id) {
             ? createZoneManager()
             : undefined,
         browse: ((_b = shard.manifest.permissions) === null || _b === void 0 ? void 0 : _b.includes(PERMISSION_DOCUMENTS_BROWSE))
-            ? createBrowseCapability(getTenantId(), getDocumentBackend())
-            : undefined,
-        syncRegistry: ((_c = shard.manifest.permissions) === null || _c === void 0 ? void 0 : _c.includes(PERMISSION_DOCUMENTS_BROWSE))
-            ? createSyncRegistryAccessor(getDocumentBackend(), getTenantId())
-            : undefined,
-        sync: ((_d = shard.manifest.permissions) === null || _d === void 0 ? void 0 : _d.includes(PERMISSION_DOCUMENTS_SYNC))
-            ? () => {
-                const backend = getDocumentBackend();
-                const tenantId = getTenantId();
-                const bundlePromise = getSyncBundle(backend, tenantId);
-                const handlePromise = bundlePromise.then(({ engine, registry }) => createSyncHandle({ tenantId, connectorId: id, engine, registry }));
-                return {
-                    connectorId: id,
-                    grantedScopes: async () => (await handlePromise).grantedScopes(),
-                    getManifest: async (scope) => (await handlePromise).getManifest(scope),
-                    changesSince: async (scope, cursor) => (await handlePromise).changesSince(scope, cursor),
-                    ack: async (scope, cursor) => (await handlePromise).ack(scope, cursor),
-                    apply: async (scope, entry, opts) => (await handlePromise).apply(scope, entry, opts),
-                    applyBatch: async (scope, manifest, opts) => (await handlePromise).applyBatch(scope, manifest, opts),
-                    forget: async (scope, path) => (await handlePromise).forget(scope, path),
-                };
-            }
+            ? createBrowseCapability(getTenantId(), getDocumentBackend(), {
+                canRead: shard.manifest.permissions.includes(PERMISSION_DOCUMENTS_READ),
+                canWrite: shard.manifest.permissions.includes(PERMISSION_DOCUMENTS_WRITE),
+            })
             : undefined,
-        keys: ((_e = shard.manifest.permissions) === null || _e === void 0 ? void 0 : _e.includes(PERMISSION_KEYS_MINT))
+        keys: ((_c = shard.manifest.permissions) === null || _c === void 0 ? void 0 : _c.includes(PERMISSION_KEYS_MINT))
             ? createShardKeysApi({
                 shardId: id,
-                shardPermissions: (_f = shard.manifest.permissions) !== null && _f !== void 0 ? _f : [],
+                shardPermissions: (_d = shard.manifest.permissions) !== null && _d !== void 0 ? _d : [],
             })
             : undefined,
     };
@@ -204,7 +182,7 @@ export async function activateShard(id) {
             console.warn(`[sh3] Failed to hydrate env state for shard "${id}":`, err instanceof Error ? err.message : err);
         }
     }
-    void ((_g = shard.autostart) === null || _g === void 0 ? void 0 : _g.call(shard, ctx));
+    void ((_e = shard.autostart) === null || _e === void 0 ? void 0 : _e.call(shard, ctx));
 }
 /**
  * Deactivate an active shard. Calls `shard.deactivate`, flushes and disposes

package/dist/shards/types.d.ts

@@ -2,8 +2,6 @@ import type { StateZones } from '../state/zones.svelte';
 import type { ZoneSchema, ZoneManager } from '../state/types';
 import type { DocumentHandle, DocumentHandleOptions } from '../documents/types';
 import type { BrowseCapability } from '../documents/browse';
-import type { SyncHandle } from '../documents/sync/types';
-import type { SyncRegistry } from '../documents/sync/registry';
 import type { EnvState } from '../env/types';
 import type { Verb } from '../verbs/types';
 import type { ShardContextKeys } from '../keys/types';
@@ -214,12 +212,6 @@ export interface ShardContext {
      * `if (ctx.zones)` before use.
      */
     zones?: ZoneManager;
-    /**
-     * Cross-shard document sync API. Only present when the shard's
-     * manifest declares the `'documents:sync'` permission. Check with
-     * `if (ctx.sync)` before use.
-     */
-    sync?: () => SyncHandle;
     /**
      * Tenant-wide document browse API. Read-only enumeration and change
      * subscription across every shard's documents for the active tenant.
@@ -228,13 +220,6 @@ export interface ShardContext {
      * owning shard's own `ctx.documents()` handle.
      */
     browse?: BrowseCapability;
-    /**
-     * Sync registry observer. Read-only list/revoke/conflict enumeration
-     * for explorer-class shards. Only present when the shard declares
-     * `'documents:browse'`. Granting still happens exclusively via
-     * `<SyncGrantPicker />`.
-     */
-    syncRegistry?: () => SyncRegistry;
     /**
      * Mint/list/revoke keys minted by this shard. Only available when the
      * manifest declares the `keys:mint` permission.

package/dist/shell/views/KeysAndPeers.svelte

@@ -70,7 +70,7 @@
           <div class="keys-peers-info">
             <span class="keys-peers-label">{row.label}</span>
             <span class="keys-peers-meta">
-              Minted by: {row.mintedByShardId ?? 'system'}{row.connectorId ? ` \u00B7 Connector: ${row.connectorId}` : ''}
+              Minted by: {row.mintedByShardId ?? 'system'}{row.peerRole || row.peerId ? ` \u00B7 Peer: ${row.peerRole ?? '—'}${row.peerId ? ` (${row.peerId})` : ''}` : ''}
             </span>
             <span class="keys-peers-meta">
               Scopes: {row.scopes.join(', ')}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** Auto-generated from package.json — do not edit manually. */
-export declare const VERSION = "0.8.2";
+export declare const VERSION = "0.9.1";

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Auto-generated from package.json — do not edit manually. */
-export const VERSION = '0.8.2';
+export const VERSION = '0.9.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh3-core",
-  "version": "0.8.2",
+  "version": "0.9.1",
   "type": "module",
   "files": [
     "dist"
@@ -26,18 +26,10 @@
     "./build": {
       "types": "./dist/build.d.ts",
       "default": "./dist/build.js"
-    },
-    "./server-sync": {
-      "types": "./dist/server-sync.d.ts",
-      "default": "./dist/server-sync.js"
-    },
-    "./testing": {
-      "types": "./dist/testing.d.ts",
-      "default": "./dist/testing.js"
     }
   },
   "scripts": {
-    "build": "node --import tsx scripts/sync-version.ts && svelte-package -i src -o dist && node --import tsx scripts/bundle-node-entries.ts && node --import tsx scripts/generate-api-docs.ts",
+    "build": "node --import tsx scripts/sync-version.ts && svelte-package -i src -o dist && node --import tsx scripts/generate-api-docs.ts",
     "check": "svelte-check --tsconfig ./tsconfig.json",
     "pack": "npm run build && npm pack",
     "test": "vitest run --passWithNoTests",

package/dist/documents/journal-hook.d.ts

@@ -1,6 +0,0 @@
-import type { JournalEntry } from './sync/types';
-type Appender = (entry: Omit<JournalEntry, 'seq' | 'ts'>) => Promise<void>;
-export declare function setJournalAppender(fn: Appender): void;
-export declare function clearJournalAppender(): void;
-export declare function notifyJournal(entry: Omit<JournalEntry, 'seq' | 'ts'>): Promise<void>;
-export {};

package/dist/documents/journal-hook.js

@@ -1,16 +0,0 @@
-/*
- * Journal appender hook — lets the sync engine subscribe to regular
- * shard writes/deletes without creating an import cycle between the
- * document handle and the sync subsystem.
- */
-let appender = null;
-export function setJournalAppender(fn) {
-    appender = fn;
-}
-export function clearJournalAppender() {
-    appender = null;
-}
-export async function notifyJournal(entry) {
-    if (appender)
-        await appender(entry);
-}

package/dist/documents/sync/activate-integration.test.js

@@ -1,37 +0,0 @@
-import { describe, it, expect, beforeEach } from 'vitest';
-import { MemoryDocumentBackend } from '../backends';
-import { __setDocumentBackend, __setTenantId } from '../config';
-import { __resetShardRegistryForTest, registerShard, activateShard } from '../../shards/activate.svelte';
-import { __resetSyncBundlesForTest } from './singleton';
-import { PERMISSION_DOCUMENTS_SYNC } from './types';
-describe('ctx.sync() gating', () => {
-    beforeEach(() => {
-        __resetShardRegistryForTest();
-        __resetSyncBundlesForTest();
-        __setDocumentBackend(new MemoryDocumentBackend());
-        __setTenantId('tenant-a');
-    });
-    it('is undefined without documents:sync permission', async () => {
-        let captured;
-        const shard = {
-            manifest: { id: 's-none', version: '0', views: [] },
-            activate: async (ctx) => { captured = ctx; },
-        };
-        registerShard(shard);
-        await activateShard('s-none');
-        expect(captured.sync).toBeUndefined();
-    });
-    it('is a function when documents:sync is declared', async () => {
-        let captured;
-        const shard = {
-            manifest: { id: 's-sync', version: '0', views: [], permissions: [PERMISSION_DOCUMENTS_SYNC] },
-            activate: async (ctx) => { captured = ctx; },
-        };
-        registerShard(shard);
-        await activateShard('s-sync');
-        expect(typeof captured.sync).toBe('function');
-        const h = captured.sync();
-        expect(h.connectorId).toBe('s-sync');
-        expect(await h.grantedScopes()).toEqual([]);
-    });
-});

package/dist/documents/sync/components/DocumentSyncExplorer.svelte

@@ -1,99 +0,0 @@
-<script lang="ts">
-  import { onMount } from 'svelte';
-  import SyncGrantPicker from './SyncGrantPicker.svelte';
-  import { createSyncRegistry, type SyncRegistry } from '../registry';
-  import { getDocumentBackend, getTenantId } from '../../config';
-  import type { GrantRecord, SyncScope, ConflictResolution } from '../types';
-
-  interface Props {
-    /** Optional connector-specific filter; if omitted, shows everything. */
-    connectorId?: string;
-    /** Shard IDs whose conflict artifacts should be listed. */
-    conflictShardIds?: string[];
-    /** Pending grant request, if any — embeds the picker when set. */
-    pendingRequest?: { connectorId: string; scope: SyncScope };
-  }
-
-  let { connectorId, conflictShardIds = [], pendingRequest }: Props = $props();
-
-  let registry: SyncRegistry | null = $state(null);
-  let grants: GrantRecord[] = $state([]);
-  let conflicts: ConflictResolution[] = $state([]);
-
-  async function refresh() {
-    if (!registry) return;
-    grants = await registry.list(connectorId);
-    const all: ConflictResolution[] = [];
-    for (const shardId of conflictShardIds) {
-      all.push(...await registry.listConflicts(shardId));
-    }
-    conflicts = all;
-  }
-
-  onMount(async () => {
-    registry = createSyncRegistry(getDocumentBackend(), getTenantId());
-    await refresh();
-  });
-
-  async function revoke(record: GrantRecord) {
-    if (!registry) return;
-    await registry.revoke(record.connectorId, record.scope);
-    await refresh();
-  }
-
-  function describeScope(s: SyncScope): string {
-    if (s.kind === 'tenant') return 'entire tenant';
-    if (s.kind === 'shard') return `shard:${s.shardId}`;
-    return `shard:${s.shardId}/${s.prefix}`;
-  }
-</script>
-
-<section class="document-sync-explorer" part="container">
-  <h2 part="title">Document Sync</h2>
-
-  {#if pendingRequest}
-    <SyncGrantPicker
-      connectorId={pendingRequest.connectorId}
-      scope={pendingRequest.scope}
-      onGranted={refresh}
-    />
-  {/if}
-
-  <h3 part="subtitle">Granted scopes</h3>
-  {#if grants.length === 0}
-    <p part="empty">No scopes granted yet.</p>
-  {:else}
-    <ul part="grants">
-      {#each grants as g}
-        <li>
-          <span part="grant-connector">{g.connectorId}</span>
-          <span part="grant-scope">{describeScope(g.scope)}</span>
-          <button type="button" onclick={() => revoke(g)} part="revoke">Revoke</button>
-        </li>
-      {/each}
-    </ul>
-  {/if}
-
-  <h3 part="subtitle">Conflicts</h3>
-  {#if conflicts.length === 0}
-    <p part="empty">No active conflicts.</p>
-  {:else}
-    <ul part="conflicts">
-      {#each conflicts as c}
-        <li>
-          <code part="conflict-path">{c.shardId}:{c.path}</code>
-          <small part="conflict-artifact">{c.conflictArtifactPath}</small>
-        </li>
-      {/each}
-    </ul>
-  {/if}
-</section>
-
-<style>
-  .document-sync-explorer {
-    display: grid;
-    gap: 0.75rem;
-  }
-  ul { list-style: none; padding: 0; margin: 0; }
-  li { display: flex; gap: 0.5rem; align-items: center; }
-</style>

package/dist/documents/sync/components/DocumentSyncExplorer.svelte.d.ts

@@ -1,15 +0,0 @@
-import type { SyncScope } from '../types';
-interface Props {
-    /** Optional connector-specific filter; if omitted, shows everything. */
-    connectorId?: string;
-    /** Shard IDs whose conflict artifacts should be listed. */
-    conflictShardIds?: string[];
-    /** Pending grant request, if any — embeds the picker when set. */
-    pendingRequest?: {
-        connectorId: string;
-        scope: SyncScope;
-    };
-}
-declare const DocumentSyncExplorer: import("svelte").Component<Props, {}, "">;
-type DocumentSyncExplorer = ReturnType<typeof DocumentSyncExplorer>;
-export default DocumentSyncExplorer;

package/dist/documents/sync/components/SyncGrantPicker.svelte

@@ -1,70 +0,0 @@
-<script lang="ts">
-  import { getDocumentBackend, getTenantId } from '../../config';
-  import { __grantInternal } from '../registry';
-  import type { SyncScope } from '../types';
-
-  import type { Snippet } from 'svelte';
-
-  interface Props {
-    connectorId: string;
-    scope: SyncScope;
-    onGranted?: () => void;
-    onCancel?: () => void;
-    rationale?: Snippet;
-  }
-
-  let { connectorId, scope, onGranted, onCancel, rationale }: Props = $props();
-
-  let pending = $state(false);
-  let error = $state<string | null>(null);
-
-  function describe(s: SyncScope): string {
-    switch (s.kind) {
-      case 'tenant': return 'all your documents across every shard';
-      case 'shard':  return `all documents for shard "${s.shardId}"`;
-      case 'path':   return `documents under "${s.prefix}" in shard "${s.shardId}"`;
-    }
-  }
-
-  async function confirm() {
-    pending = true;
-    error = null;
-    try {
-      await __grantInternal(getDocumentBackend(), getTenantId(), connectorId, scope);
-      onGranted?.();
-    } catch (e) {
-      error = e instanceof Error ? e.message : String(e);
-    } finally {
-      pending = false;
-    }
-  }
-</script>
-
-<section class="sync-grant-picker" part="container">
-  <header part="header">
-    <h3 part="title">Grant sync access</h3>
-  </header>
-  <p part="summary">
-    <strong>{connectorId}</strong> is requesting access to {describe(scope)}.
-  </p>
-  {#if rationale}{@render rationale()}{/if}
-  {#if error}
-    <p class="error" part="error">{error}</p>
-  {/if}
-  <footer part="actions">
-    <button type="button" disabled={pending} onclick={() => onCancel?.()} part="cancel">Cancel</button>
-    <button type="button" disabled={pending} onclick={confirm} part="confirm">Grant</button>
-  </footer>
-</section>
-
-<style>
-  .sync-grant-picker {
-    display: grid;
-    gap: 0.75rem;
-    padding: 1rem;
-    border: 1px solid var(--sh3-border, #444);
-    border-radius: 6px;
-  }
-  .error { color: var(--sh3-error, #c00); }
-  footer { display: flex; gap: 0.5rem; justify-content: flex-end; }
-</style>

package/dist/documents/sync/components/SyncGrantPicker.svelte.d.ts

@@ -1,12 +0,0 @@
-import type { SyncScope } from '../types';
-import type { Snippet } from 'svelte';
-interface Props {
-    connectorId: string;
-    scope: SyncScope;
-    onGranted?: () => void;
-    onCancel?: () => void;
-    rationale?: Snippet;
-}
-declare const SyncGrantPicker: import("svelte").Component<Props, {}, "">;
-type SyncGrantPicker = ReturnType<typeof SyncGrantPicker>;
-export default SyncGrantPicker;

package/dist/documents/sync/conflicts.d.ts

@@ -1,30 +0,0 @@
-import type { DocumentBackend } from '../types';
-import type { ConflictPolicy, ConflictResolution } from './types';
-interface ConflictInput {
-    connectorId: string;
-    shardId: string;
-    path: string;
-    localHash: string;
-    remoteHash: string;
-    remoteContent?: string | ArrayBuffer;
-    baseHash?: string;
-}
-export type ConflictAction = {
-    action: 'apply-remote';
-    asPath?: string;
-} | {
-    action: 'skip';
-} | {
-    action: 'conflict';
-    resolution: ConflictResolution;
-};
-export declare class ConflictManager {
-    private backend;
-    private tenantId;
-    constructor(backend: DocumentBackend, tenantId: string);
-    resolve(policy: ConflictPolicy, input: ConflictInput): Promise<ConflictAction>;
-    getBaseHash(connectorId: string, shardId: string, path: string): Promise<string | null>;
-    setBaseHash(connectorId: string, shardId: string, path: string, hash: string): Promise<void>;
-    listConflicts(shardId: string): Promise<ConflictResolution[]>;
-}
-export {};