@shardworks/stacks-apparatus 0.1.101

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Sean Boots
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/dist/backend.d.ts

@@ -0,0 +1,83 @@
+/**
+ * StacksBackend — persistence abstraction for The Stacks.
+ *
+ * All SQLite-specific types stay behind this interface. The apparatus
+ * and all consuming plugins depend only on these types. Backend
+ * implementations (SQLite, in-memory) implement this interface.
+ *
+ * See: docs/specification.md §8
+ */
+import type { BookEntry, BookSchema, Scalar } from './types.ts';
+export interface BookRef {
+    ownerId: string;
+    book: string;
+}
+export interface BackendOptions {
+    home: string;
+}
+export interface PutResult {
+    created: boolean;
+    prev?: BookEntry;
+}
+export interface PatchResult {
+    entry: BookEntry;
+    prev: BookEntry;
+}
+export interface DeleteResult {
+    found: boolean;
+    prev?: BookEntry;
+}
+export type InternalCondition = {
+    field: string;
+    op: 'eq' | 'neq';
+    value: Scalar;
+} | {
+    field: string;
+    op: 'gt' | 'gte' | 'lt' | 'lte';
+    value: number | string;
+} | {
+    field: string;
+    op: 'like';
+    value: string;
+} | {
+    field: string;
+    op: 'in';
+    values: Scalar[];
+} | {
+    field: string;
+    op: 'isNull' | 'isNotNull';
+};
+export interface InternalQuery {
+    where?: InternalCondition[];
+    orderBy?: Array<{
+        field: string;
+        dir: 'asc' | 'desc';
+    }>;
+    limit?: number;
+    offset?: number;
+}
+/** Narrowed query type for count() — conditions only, no pagination. */
+export interface CountQuery {
+    where?: InternalCondition[];
+}
+export interface BackendTransaction {
+    put(ref: BookRef, entry: BookEntry, opts?: {
+        withPrev: boolean;
+    }): PutResult;
+    patch(ref: BookRef, id: string, fields: Record<string, unknown>): PatchResult;
+    delete(ref: BookRef, id: string, opts?: {
+        withPrev: boolean;
+    }): DeleteResult;
+    get(ref: BookRef, id: string): BookEntry | null;
+    find(ref: BookRef, query: InternalQuery): BookEntry[];
+    count(ref: BookRef, query: CountQuery): number;
+    commit(): void;
+    rollback(): void;
+}
+export interface StacksBackend {
+    open(options: BackendOptions): void;
+    close(): void;
+    ensureBook(ref: BookRef, schema: BookSchema): void;
+    beginTransaction(): BackendTransaction;
+}
+//# sourceMappingURL=backend.d.ts.map

package/dist/backend.d.ts.map

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

package/dist/backend.js

@@ -0,0 +1,11 @@
+/**
+ * StacksBackend — persistence abstraction for The Stacks.
+ *
+ * All SQLite-specific types stay behind this interface. The apparatus
+ * and all consuming plugins depend only on these types. Backend
+ * implementations (SQLite, in-memory) implement this interface.
+ *
+ * See: docs/specification.md §8
+ */
+export {};
+//# sourceMappingURL=backend.js.map

package/dist/backend.js.map

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

package/dist/cdc.d.ts

@@ -0,0 +1,63 @@
+/**
+ * CDC registry — handler registration, event buffering, and coalescing.
+ *
+ * Two-phase execution model:
+ * - Phase 1 (failOnError: true):  runs INSIDE the transaction
+ * - Phase 2 (failOnError: false): runs AFTER commit with coalesced events
+ *
+ * See: docs/specification.md (stacks § CDC)
+ */
+import type { BookEntry, ChangeEvent, ChangeHandler, WatchOptions } from './types.ts';
+interface WatcherEntry {
+    handler: ChangeHandler;
+    failOnError: boolean;
+}
+export interface BufferedEvent {
+    ref: string;
+    ownerId: string;
+    book: string;
+    docId: string;
+    type: 'create' | 'update' | 'delete';
+    entry?: BookEntry;
+    prev?: BookEntry;
+}
+/**
+ * Coalesce buffered events per-document.
+ *
+ * Rules:
+ *   create                    → create (final state)
+ *   create → update(s)        → create (final state)
+ *   create → delete           → (no event)
+ *   update(s)                 → update (first prev, final state)
+ *   update(s) → delete        → delete (first prev)
+ *   delete                    → delete (prev)
+ */
+export declare function coalesceEvents(buffer: BufferedEvent[]): ChangeEvent<BookEntry>[];
+export declare class CdcRegistry {
+    private readonly watchers;
+    private locked;
+    /**
+     * Register a CDC handler for a book.
+     * Must be called before any writes (enforced by `locked` flag).
+     */
+    watch(ownerId: string, bookName: string, handler: ChangeHandler, options?: WatchOptions): void;
+    /** Mark the registry as locked — called on first write. */
+    lock(): void;
+    /** Check if any handlers are registered for a book (controls pre-read). */
+    hasWatchers(ownerId: string, bookName: string): boolean;
+    /** Get Phase 1 handlers (failOnError: true) for a book. */
+    getPhase1Handlers(ownerId: string, bookName: string): WatcherEntry[];
+    /** Get Phase 2 handlers (failOnError: false) for a book. */
+    getPhase2Handlers(ownerId: string, bookName: string): WatcherEntry[];
+    /**
+     * Fire Phase 1 handlers for a single event. Throws on handler error
+     * (caller is responsible for rolling back the transaction).
+     */
+    firePhase1(ownerId: string, bookName: string, event: ChangeEvent<BookEntry>): Promise<void>;
+    /**
+     * Fire Phase 2 handlers for coalesced events. Errors are logged, not thrown.
+     */
+    firePhase2(events: ChangeEvent<BookEntry>[]): Promise<void>;
+}
+export {};
+//# sourceMappingURL=cdc.d.ts.map

package/dist/cdc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdc.d.ts","sourceRoot":"","sources":["../src/cdc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAItF,UAAU,YAAY;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAID,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAkBD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,WAAW,CAAC,SAAS,CAAC,EAAE,CA8DhF;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;IACH,KAAK,CACH,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,YAAY,GACrB,IAAI;IAoBP,2DAA2D;IAC3D,IAAI,IAAI,IAAI;IAIZ,2EAA2E;IAC3E,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMvD,2DAA2D;IAC3D,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE;IAKpE,4DAA4D;IAC5D,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE;IAKpE;;;OAGG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC;IAMhB;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAelE"}

package/dist/cdc.js

@@ -0,0 +1,154 @@
+/**
+ * CDC registry — handler registration, event buffering, and coalescing.
+ *
+ * Two-phase execution model:
+ * - Phase 1 (failOnError: true):  runs INSIDE the transaction
+ * - Phase 2 (failOnError: false): runs AFTER commit with coalesced events
+ *
+ * See: docs/specification.md (stacks § CDC)
+ */
+/**
+ * Coalesce buffered events per-document.
+ *
+ * Rules:
+ *   create                    → create (final state)
+ *   create → update(s)        → create (final state)
+ *   create → delete           → (no event)
+ *   update(s)                 → update (first prev, final state)
+ *   update(s) → delete        → delete (first prev)
+ *   delete                    → delete (prev)
+ */
+export function coalesceEvents(buffer) {
+    const states = new Map();
+    for (const event of buffer) {
+        const key = `${event.ref}:${event.docId}`;
+        const existing = states.get(key);
+        if (!existing) {
+            states.set(key, {
+                ownerId: event.ownerId,
+                book: event.book,
+                docId: event.docId,
+                firstType: event.type,
+                lastType: event.type,
+                prev: event.prev,
+                entry: event.entry,
+            });
+        }
+        else {
+            existing.lastType = event.type;
+            if (event.entry)
+                existing.entry = event.entry;
+            // prev stays as the first event's prev (pre-transaction state)
+        }
+    }
+    const events = [];
+    for (const state of states.values()) {
+        if (state.firstType === 'create' && state.lastType === 'delete') {
+            // create → delete: no event (document never existed from observer's perspective)
+            continue;
+        }
+        if (state.firstType === 'create') {
+            // create (possibly followed by updates): coalesces to create with final state
+            events.push({
+                type: 'create',
+                ownerId: state.ownerId,
+                book: state.book,
+                entry: state.entry,
+            });
+        }
+        else if (state.lastType === 'delete') {
+            // update(s) → delete: coalesces to delete with original prev
+            events.push({
+                type: 'delete',
+                ownerId: state.ownerId,
+                book: state.book,
+                id: state.docId,
+                prev: state.prev,
+            });
+        }
+        else {
+            // update(s): coalesces to single update with first prev, final entry
+            events.push({
+                type: 'update',
+                ownerId: state.ownerId,
+                book: state.book,
+                entry: state.entry,
+                prev: state.prev,
+            });
+        }
+    }
+    return events;
+}
+// ── CDC Registry ──────────────────────────────────────────────────────
+export class CdcRegistry {
+    watchers = new Map();
+    locked = false;
+    /**
+     * Register a CDC handler for a book.
+     * Must be called before any writes (enforced by `locked` flag).
+     */
+    watch(ownerId, bookName, handler, options) {
+        if (this.locked) {
+            throw new Error(`[stacks] watch() called after writes have started. ` +
+                `Handlers must be registered during apparatus startup.`);
+        }
+        const key = `${ownerId}/${bookName}`;
+        let entries = this.watchers.get(key);
+        if (!entries) {
+            entries = [];
+            this.watchers.set(key, entries);
+        }
+        entries.push({
+            handler,
+            failOnError: options?.failOnError ?? true,
+        });
+    }
+    /** Mark the registry as locked — called on first write. */
+    lock() {
+        this.locked = true;
+    }
+    /** Check if any handlers are registered for a book (controls pre-read). */
+    hasWatchers(ownerId, bookName) {
+        const key = `${ownerId}/${bookName}`;
+        const entries = this.watchers.get(key);
+        return entries !== undefined && entries.length > 0;
+    }
+    /** Get Phase 1 handlers (failOnError: true) for a book. */
+    getPhase1Handlers(ownerId, bookName) {
+        const key = `${ownerId}/${bookName}`;
+        return (this.watchers.get(key) ?? []).filter((e) => e.failOnError);
+    }
+    /** Get Phase 2 handlers (failOnError: false) for a book. */
+    getPhase2Handlers(ownerId, bookName) {
+        const key = `${ownerId}/${bookName}`;
+        return (this.watchers.get(key) ?? []).filter((e) => !e.failOnError);
+    }
+    /**
+     * Fire Phase 1 handlers for a single event. Throws on handler error
+     * (caller is responsible for rolling back the transaction).
+     */
+    async firePhase1(ownerId, bookName, event) {
+        for (const entry of this.getPhase1Handlers(ownerId, bookName)) {
+            await entry.handler(event);
+        }
+    }
+    /**
+     * Fire Phase 2 handlers for coalesced events. Errors are logged, not thrown.
+     */
+    async firePhase2(events) {
+        for (const event of events) {
+            const key = `${event.ownerId}/${event.book}`;
+            const handlers = (this.watchers.get(key) ?? []).filter((e) => !e.failOnError);
+            for (const entry of handlers) {
+                try {
+                    await entry.handler(event);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.warn(`[stacks] Phase 2 handler error (${key}): ${msg}`);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=cdc.js.map

package/dist/cdc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdc.js","sourceRoot":"","sources":["../src/cdc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuCH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEhD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,QAAQ,EAAE,KAAK,CAAC,IAAI;gBACpB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;YAC/B,IAAI,KAAK,CAAC,KAAK;gBAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAC9C,+DAA+D;QACjE,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAA6B,EAAE,CAAC;IAE5C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAChE,iFAAiF;YACjF,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YACjC,8EAA8E;YAC9E,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAM;aACpB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACvC,6DAA6D;YAC7D,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,EAAE,EAAE,KAAK,CAAC,KAAK;gBACf,IAAI,EAAE,KAAK,CAAC,IAAK;aAClB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,qEAAqE;YACrE,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAM;gBACnB,IAAI,EAAE,KAAK,CAAC,IAAK;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yEAAyE;AAEzE,MAAM,OAAO,WAAW;IACL,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,MAAM,GAAG,KAAK,CAAC;IAEvB;;;OAGG;IACH,KAAK,CACH,OAAe,EACf,QAAgB,EAChB,OAAsB,EACtB,OAAsB;QAEtB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,qDAAqD;gBACrD,uDAAuD,CACxD,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAC;QACrC,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACX,OAAO;YACP,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,2DAA2D;IAC3D,IAAI;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,2EAA2E;IAC3E,WAAW,CAAC,OAAe,EAAE,QAAgB;QAC3C,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,2DAA2D;IAC3D,iBAAiB,CAAC,OAAe,EAAE,QAAgB;QACjD,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACrE,CAAC;IAED,4DAA4D;IAC5D,iBAAiB,CAAC,OAAe,EAAE,QAAgB;QACjD,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACtE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CACd,OAAe,EACf,QAAgB,EAChB,KAA6B;QAE7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC9D,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,MAAgC;QAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7C,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YAE9E,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC7B,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBAC7D,OAAO,CAAC,IAAI,CAAC,mCAAmC,GAAG,MAAM,GAAG,EAAE,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/conformance/helpers.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Conformance test helpers — create a StacksApi from a bare backend,
+ * bypassing the guild startup machinery.
+ *
+ * Each test gets a fresh backend + API instance. No state leaks.
+ */
+import type { StacksBackend, BookRef } from '../backend.ts';
+import type { BookEntry, StacksApi, ChangeEvent, CreateEvent, UpdateEvent, DeleteEvent, WatchOptions } from '../types.ts';
+export interface TestStacks {
+    stacks: StacksApi;
+    backend: StacksBackend;
+    /** Ensure a book exists (bypasses kit contribution flow). */
+    ensureBook(ownerId: string, bookName: string, schema?: {
+        indexes?: (string | string[])[];
+    }): void;
+}
+export declare function createTestStacks(backendFactory: () => StacksBackend): TestStacks;
+export declare function seedDocument(backend: StacksBackend, ref: BookRef, entry: BookEntry): void;
+export declare function collectEvents<T extends BookEntry = BookEntry>(stacks: StacksApi, ownerId: string, bookName: string, options?: WatchOptions): ChangeEvent<T>[];
+export interface PutCall {
+    ref: BookRef;
+    entry: BookEntry;
+    withPrev: boolean;
+}
+/**
+ * Wraps a backend factory to record put() calls on transactions,
+ * so tests can verify whether withPrev was requested.
+ */
+export declare function spyingBackendFactory(factory: () => StacksBackend): {
+    factory: () => StacksBackend;
+    putCalls: PutCall[];
+};
+/** Assert the event is a `create` and check its fields. */
+export declare function assertCreateEvent(event: ChangeEvent<BookEntry>, expected: {
+    entry: BookEntry;
+    ownerId?: string;
+    book?: string;
+}): asserts event is CreateEvent<BookEntry>;
+/** Assert the event is an `update` and check its fields. */
+export declare function assertUpdateEvent(event: ChangeEvent<BookEntry>, expected: {
+    entry: BookEntry;
+    prev: BookEntry;
+    ownerId?: string;
+    book?: string;
+}): asserts event is UpdateEvent<BookEntry>;
+/** Assert the event is a `delete` and check its fields. */
+export declare function assertDeleteEvent(event: ChangeEvent<BookEntry>, expected: {
+    id: string;
+    prev: BookEntry;
+    ownerId?: string;
+    book?: string;
+}): asserts event is DeleteEvent<BookEntry>;
+export declare const OWNER = "test-owner";
+export declare const BOOK = "testbook";
+export declare const REF: BookRef;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/conformance/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/conformance/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,WAAW,EAEX,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACb,MAAM,aAAa,CAAC;AAKrB,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,6DAA6D;IAC7D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CACnG;AAED,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,aAAa,GAAG,UAAU,CAahF;AAID,wBAAgB,YAAY,CAC1B,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,SAAS,GACf,IAAI,CAIN;AAID,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAC3D,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,YAAY,GACrB,WAAW,CAAC,CAAC,CAAC,EAAE,CAMlB;AAID,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,aAAa,GAC3B;IAAE,OAAO,EAAE,MAAM,aAAa,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,CAuBvD;AAID,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,EAC7B,QAAQ,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,SAAS,CAAC,CAKzC;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,EAC7B,QAAQ,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/E,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,SAAS,CAAC,CAMzC;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,EAC7B,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,SAAS,CAAC,CAMzC;AAID,eAAO,MAAM,KAAK,eAAe,CAAC;AAClC,eAAO,MAAM,IAAI,aAAa,CAAC;AAC/B,eAAO,MAAM,GAAG,EAAE,OAAwC,CAAC"}

package/dist/conformance/helpers.js

@@ -0,0 +1,91 @@
+/**
+ * Conformance test helpers — create a StacksApi from a bare backend,
+ * bypassing the guild startup machinery.
+ *
+ * Each test gets a fresh backend + API instance. No state leaks.
+ */
+import assert from 'node:assert/strict';
+import { createTestableStacks } from "./testable-stacks.js";
+export function createTestStacks(backendFactory) {
+    const backend = backendFactory();
+    backend.open({ home: '/tmp/stacks-test' });
+    const stacks = createTestableStacks(backend);
+    return {
+        stacks,
+        backend,
+        ensureBook(ownerId, bookName, schema = {}) {
+            backend.ensureBook({ ownerId, book: bookName }, schema);
+        },
+    };
+}
+// ── Seed helper (bypasses CDC lock) ──────────────────────────────────
+export function seedDocument(backend, ref, entry) {
+    const tx = backend.beginTransaction();
+    tx.put(ref, entry);
+    tx.commit();
+}
+// ── Event collector ──────────────────────────────────────────────────
+export function collectEvents(stacks, ownerId, bookName, options) {
+    const events = [];
+    stacks.watch(ownerId, bookName, ((event) => {
+        events.push(event);
+    }), options);
+    return events;
+}
+/**
+ * Wraps a backend factory to record put() calls on transactions,
+ * so tests can verify whether withPrev was requested.
+ */
+export function spyingBackendFactory(factory) {
+    const putCalls = [];
+    const wrappedFactory = () => {
+        const backend = factory();
+        const origBeginTransaction = backend.beginTransaction.bind(backend);
+        backend.beginTransaction = () => {
+            const tx = origBeginTransaction();
+            const origPut = tx.put.bind(tx);
+            tx.put = (ref, entry, opts) => {
+                putCalls.push({ ref, entry, withPrev: opts?.withPrev ?? false });
+                return origPut(ref, entry, opts);
+            };
+            return tx;
+        };
+        return backend;
+    };
+    return { factory: wrappedFactory, putCalls };
+}
+// ── CDC event assertion helpers ──────────────────────────────────────
+/** Assert the event is a `create` and check its fields. */
+export function assertCreateEvent(event, expected) {
+    assert.strictEqual(event.type, 'create');
+    assert.deepStrictEqual(event.entry, expected.entry);
+    if (expected.ownerId !== undefined)
+        assert.strictEqual(event.ownerId, expected.ownerId);
+    if (expected.book !== undefined)
+        assert.strictEqual(event.book, expected.book);
+}
+/** Assert the event is an `update` and check its fields. */
+export function assertUpdateEvent(event, expected) {
+    assert.strictEqual(event.type, 'update');
+    assert.deepStrictEqual(event.entry, expected.entry);
+    assert.deepStrictEqual(event.prev, expected.prev);
+    if (expected.ownerId !== undefined)
+        assert.strictEqual(event.ownerId, expected.ownerId);
+    if (expected.book !== undefined)
+        assert.strictEqual(event.book, expected.book);
+}
+/** Assert the event is a `delete` and check its fields. */
+export function assertDeleteEvent(event, expected) {
+    assert.strictEqual(event.type, 'delete');
+    assert.strictEqual(event.id, expected.id);
+    assert.deepStrictEqual(event.prev, expected.prev);
+    if (expected.ownerId !== undefined)
+        assert.strictEqual(event.ownerId, expected.ownerId);
+    if (expected.book !== undefined)
+        assert.strictEqual(event.book, expected.book);
+}
+// ── Default book ref ─────────────────────────────────────────────────
+export const OWNER = 'test-owner';
+export const BOOK = 'testbook';
+export const REF = { ownerId: OWNER, book: BOOK };
+//# sourceMappingURL=helpers.js.map

package/dist/conformance/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/conformance/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAYxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAW5D,MAAM,UAAU,gBAAgB,CAAC,cAAmC;IAClE,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAE7C,OAAO;QACL,MAAM;QACN,OAAO;QACP,UAAU,CAAC,OAAe,EAAE,QAAgB,EAAE,MAAM,GAAG,EAAE;YACvD,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,wEAAwE;AAExE,MAAM,UAAU,YAAY,CAC1B,OAAsB,EACtB,GAAY,EACZ,KAAgB;IAEhB,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IACtC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnB,EAAE,CAAC,MAAM,EAAE,CAAC;AACd,CAAC;AAED,wEAAwE;AAExE,MAAM,UAAU,aAAa,CAC3B,MAAiB,EACjB,OAAe,EACf,QAAgB,EAChB,OAAsB;IAEtB,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,MAAM,CAAC,KAAK,CAAI,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAqB,EAAE,EAAE;QAC5D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC,CAAqB,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA4B;IAE5B,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,MAAM,cAAc,GAAG,GAAkB,EAAE;QACzC,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;QAC1B,MAAM,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEpE,OAAO,CAAC,gBAAgB,GAAG,GAAG,EAAE;YAC9B,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEhC,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC;gBACjE,OAAO,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YACnC,CAAC,CAAC;YAEF,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QAEF,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,wEAAwE;AAExE,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAC/B,KAA6B,EAC7B,QAA+D;IAE/D,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxF,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,iBAAiB,CAC/B,KAA6B,EAC7B,QAAgF;IAEhF,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxF,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAC/B,KAA6B,EAC7B,QAA0E;IAE1E,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxF,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,wEAAwE;AAExE,MAAM,CAAC,MAAM,KAAK,GAAG,YAAY,CAAC;AAClC,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,CAAC;AAC/B,MAAM,CAAC,MAAM,GAAG,GAAY,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC"}

package/dist/conformance/suite.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Stacks conformance test suite — parametric registration.
+ *
+ * Exports a single function that registers all conformance tiers
+ * against a given backend factory. Each backend test file calls
+ * this with its own factory function.
+ */
+import type { StacksBackend } from '../backend.ts';
+export declare function runConformanceSuite(suiteName: string, backendFactory: () => StacksBackend): void;
+//# sourceMappingURL=suite.d.ts.map

package/dist/conformance/suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite.d.ts","sourceRoot":"","sources":["../../src/conformance/suite.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAQnD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,aAAa,GAClC,IAAI,CAQN"}

package/dist/conformance/suite.js

@@ -0,0 +1,22 @@
+/**
+ * Stacks conformance test suite — parametric registration.
+ *
+ * Exports a single function that registers all conformance tiers
+ * against a given backend factory. Each backend test file calls
+ * this with its own factory function.
+ */
+import { tier1DataIntegrity } from "./tier1-data-integrity.js";
+import { tier2Cdc } from "./tier2-cdc.js";
+import { tier25Transactions } from "./tier2.5-transactions.js";
+import { tier3Queries } from "./tier3-queries.js";
+import { tier4EdgeCases } from "./tier4-edge-cases.js";
+export function runConformanceSuite(suiteName, backendFactory) {
+    // Node test runner uses the describe/it calls inside each tier function
+    // to register tests. The suite name is just for documentation.
+    tier1DataIntegrity(backendFactory);
+    tier2Cdc(backendFactory);
+    tier25Transactions(backendFactory);
+    tier3Queries(backendFactory);
+    tier4EdgeCases(backendFactory);
+}
+//# sourceMappingURL=suite.js.map

package/dist/conformance/suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite.js","sourceRoot":"","sources":["../../src/conformance/suite.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,cAAmC;IAEnC,wEAAwE;IACxE,+DAA+D;IAC/D,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACzB,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACnC,YAAY,CAAC,cAAc,CAAC,CAAC;IAC7B,cAAc,CAAC,cAAc,CAAC,CAAC;AACjC,CAAC"}

package/dist/conformance/testable-stacks.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Testable Stacks — a minimal StacksApi wired directly to a backend,
+ * without requiring the guild startup machinery.
+ *
+ * Uses the same StacksCore as the production apparatus, ensuring
+ * behavioral identity by construction.
+ */
+import type { StacksBackend } from '../backend.ts';
+import type { StacksApi } from '../types.ts';
+export declare function createTestableStacks(backend: StacksBackend): StacksApi;
+//# sourceMappingURL=testable-stacks.d.ts.map

package/dist/conformance/testable-stacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testable-stacks.d.ts","sourceRoot":"","sources":["../../src/conformance/testable-stacks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAGtE"}

package/dist/conformance/testable-stacks.js

@@ -0,0 +1,13 @@
+/**
+ * Testable Stacks — a minimal StacksApi wired directly to a backend,
+ * without requiring the guild startup machinery.
+ *
+ * Uses the same StacksCore as the production apparatus, ensuring
+ * behavioral identity by construction.
+ */
+import { StacksCore } from "../stacks-core.js";
+export function createTestableStacks(backend) {
+    const core = new StacksCore(backend);
+    return core.createApi();
+}
+//# sourceMappingURL=testable-stacks.js.map

package/dist/conformance/testable-stacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testable-stacks.js","sourceRoot":"","sources":["../../src/conformance/testable-stacks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,UAAU,oBAAoB,CAAC,OAAsB;IACzD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;AAC1B,CAAC"}

package/dist/conformance/tier1-data-integrity.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tier 1 — Data Integrity conformance tests.
+ *
+ * Failures here mean data loss or corruption. Non-negotiable.
+ */
+import type { StacksBackend } from '../backend.ts';
+export declare function tier1DataIntegrity(backendFactory: () => StacksBackend): void;
+//# sourceMappingURL=tier1-data-integrity.d.ts.map

package/dist/conformance/tier1-data-integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier1-data-integrity.d.ts","sourceRoot":"","sources":["../../src/conformance/tier1-data-integrity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,aAAa,GAAG,IAAI,CAmG5E"}