sh3-core 0.8.2 → 0.9.0

package/dist/documents/sync/tombstones.test.js

@@ -1,37 +0,0 @@
-import { describe, it, expect, beforeEach } from 'vitest';
-import { MemoryDocumentBackend } from '../backends';
-import { TombstoneStore } from './tombstones';
-describe('TombstoneStore', () => {
-    let backend;
-    let store;
-    beforeEach(() => {
-        backend = new MemoryDocumentBackend();
-        store = new TombstoneStore(backend, 'tenant-a');
-    });
-    it('records and retrieves a tombstone', async () => {
-        await store.record('shard-x', 'dir/file.md', 'hash123', 1000);
-        const t = await store.get('shard-x', 'dir/file.md');
-        expect(t).toEqual({ deletedAt: 1000, lastHash: 'hash123' });
-    });
-    it('returns null for non-tombstoned paths', async () => {
-        expect(await store.get('shard-x', 'absent.md')).toBeNull();
-    });
-    it('clears a tombstone (on upsert of same path)', async () => {
-        await store.record('shard-x', 'a.md', 'h', 1);
-        await store.clear('shard-x', 'a.md');
-        expect(await store.get('shard-x', 'a.md')).toBeNull();
-    });
-    it('lists tombstones within a shard', async () => {
-        await store.record('shard-x', 'a.md', 'h1', 1);
-        await store.record('shard-x', 'b.md', 'h2', 2);
-        await store.record('shard-y', 'c.md', 'h3', 3);
-        const list = await store.listByShard('shard-x');
-        expect(list.map((t) => t.path).sort()).toEqual(['a.md', 'b.md']);
-    });
-    it('lists all tombstones across shards', async () => {
-        await store.record('shard-x', 'a.md', 'h1', 1);
-        await store.record('shard-y', 'c.md', 'h3', 3);
-        const all = await store.listAll();
-        expect(all.length).toBe(2);
-    });
-});

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

@@ -1,116 +0,0 @@
-/** Permission string required in a shard manifest to obtain ctx.sync(). */
-export declare const PERMISSION_DOCUMENTS_SYNC = "documents:sync";
-/** Reserved shardId used to persist sync metadata (journal, tombstones, cursors, grants). */
-export declare const SYNC_RESERVED_SHARD_ID = "__sync__";
-export type SyncScope = {
-    kind: 'shard';
-    shardId: string;
-} | {
-    kind: 'tenant';
-} | {
-    kind: 'path';
-    shardId: string;
-    prefix: string;
-};
-export interface ManifestEntry {
-    path: string;
-    shardId: string;
-    hash: string;
-    size: number;
-    lastModified: number;
-    tombstone?: {
-        deletedAt: number;
-    };
-}
-export interface ApplyEntry {
-    path: string;
-    shardId: string;
-    op: 'upsert' | 'delete';
-    content?: string | ArrayBuffer;
-    remoteHash: string;
-    remoteMtime: number;
-}
-export interface ApplyOpts {
-    onConflict?: ConflictPolicy;
-    expectedLocalHash?: string;
-}
-export type ApplyOutcome = {
-    status: 'applied';
-    newHash: string;
-} | {
-    status: 'skipped-identical';
-} | {
-    status: 'conflict';
-    resolution: ConflictResolution;
-};
-export interface ApplyBatchResult {
-    applied: Array<{
-        path: string;
-        shardId: string;
-        newHash: string;
-    }>;
-    skipped: Array<{
-        path: string;
-        shardId: string;
-        reason: 'identical';
-    }>;
-    conflicts: ConflictResolution[];
-}
-export interface ConflictResolution {
-    path: string;
-    shardId: string;
-    localHash: string;
-    remoteHash: string;
-    conflictArtifactPath: string;
-    base?: {
-        hash: string;
-    };
-}
-export interface ConflictContext {
-    path: string;
-    shardId: string;
-    localHash: string;
-    remoteHash: string;
-    baseHash?: string;
-}
-export type ConflictPolicy = 'default' | 'remote-wins' | 'local-wins' | 'keep-both' | ((ctx: ConflictContext) => Promise<'remote-wins' | 'local-wins' | 'keep-both'>);
-export interface JournalEntry {
-    seq: number;
-    ts: number;
-    shardId: string;
-    path: string;
-    op: 'upsert' | 'delete';
-    hash: string | null;
-}
-export interface ChangePage {
-    entries: JournalEntry[];
-    nextCursor: string;
-    hasMore: boolean;
-    truncated?: boolean;
-}
-export interface GrantRecord {
-    connectorId: string;
-    scope: SyncScope;
-    grantedAt: number;
-}
-export interface SyncHandle {
-    readonly connectorId: string;
-    grantedScopes(): Promise<SyncScope[]>;
-    getManifest(scope: SyncScope): Promise<ManifestEntry[]>;
-    changesSince(scope: SyncScope, cursor?: string): Promise<ChangePage>;
-    ack(scope: SyncScope, cursor: string): Promise<void>;
-    apply(scope: SyncScope, entry: ApplyEntry, opts?: ApplyOpts): Promise<ApplyOutcome>;
-    applyBatch(scope: SyncScope, manifest: ApplyEntry[], opts?: ApplyOpts): Promise<ApplyBatchResult>;
-    forget(scope: SyncScope, path: string): Promise<void>;
-}
-export declare class ScopeNotGrantedError extends Error {
-    readonly scope: SyncScope;
-    constructor(scope: SyncScope);
-}
-export declare class ScopeRevokedError extends Error {
-    readonly scope: SyncScope;
-    constructor(scope: SyncScope);
-}
-export declare class TenantMismatchError extends Error {
-    constructor();
-}

package/dist/documents/sync/types.js

@@ -1,27 +0,0 @@
-/*
- * Document Sync API types. See docs/superpowers/specs/2026-04-14-document-sync-api-design.md.
- */
-/** Permission string required in a shard manifest to obtain ctx.sync(). */
-export const PERMISSION_DOCUMENTS_SYNC = 'documents:sync';
-/** Reserved shardId used to persist sync metadata (journal, tombstones, cursors, grants). */
-export const SYNC_RESERVED_SHARD_ID = '__sync__';
-export class ScopeNotGrantedError extends Error {
-    constructor(scope) {
-        super(`Scope not granted: ${JSON.stringify(scope)}`);
-        this.scope = scope;
-        this.name = 'ScopeNotGrantedError';
-    }
-}
-export class ScopeRevokedError extends Error {
-    constructor(scope) {
-        super(`Scope revoked during operation: ${JSON.stringify(scope)}`);
-        this.scope = scope;
-        this.name = 'ScopeRevokedError';
-    }
-}
-export class TenantMismatchError extends Error {
-    constructor() {
-        super('Sync handle tenantId does not match current session');
-        this.name = 'TenantMismatchError';
-    }
-}

package/dist/documents/sync/write-hook.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/documents/sync/write-hook.test.js

@@ -1,36 +0,0 @@
-// packages/sh3-core/src/documents/sync/write-hook.test.ts
-import { describe, it, expect, beforeEach } from 'vitest';
-import { MemoryDocumentBackend } from '../backends';
-import { __setDocumentBackend, __setTenantId } from '../config';
-import { createDocumentHandle } from '../handle';
-import { SyncEngine } from './engine';
-import { setJournalAppender, clearJournalAppender } from '../journal-hook';
-describe('regular document writes feed the sync journal', () => {
-    let backend;
-    let engine;
-    beforeEach(async () => {
-        backend = new MemoryDocumentBackend();
-        __setDocumentBackend(backend);
-        __setTenantId('tenant-a');
-        engine = new SyncEngine(backend, 'tenant-a');
-        await engine.init();
-        setJournalAppender(async (e) => { await engine.journal.append(e); });
-    });
-    it('appends upsert to journal when shard writes via ctx.documents()', async () => {
-        const h = createDocumentHandle('tenant-a', 'shard-x', backend, { format: 'text' });
-        await h.write('a.md', 'hello');
-        const page = await engine.journal.changesSince({ kind: 'tenant' });
-        expect(page.entries.map((e) => `${e.shardId}:${e.path}:${e.op}`)).toEqual([
-            'shard-x:a.md:upsert',
-        ]);
-        clearJournalAppender();
-    });
-    it('appends delete to journal', async () => {
-        const h = createDocumentHandle('tenant-a', 'shard-x', backend, { format: 'text' });
-        await h.write('a.md', 'hello');
-        await h.delete('a.md');
-        const page = await engine.journal.changesSince({ kind: 'tenant' });
-        expect(page.entries.map((e) => e.op)).toEqual(['upsert', 'delete']);
-        clearJournalAppender();
-    });
-});

package/dist/server-sync.d.ts

@@ -1,6 +0,0 @@
-export { getSyncBundle } from './documents/sync/singleton';
-export { createSyncHandle } from './documents/sync/handle';
-export { createSyncRegistry } from './documents/sync/registry';
-export type { SyncHandle } from './documents/sync/types';
-export type { SyncRegistry } from './documents/sync/registry';
-export type { DocumentBackend, DocumentMeta } from './documents/types';