@hraness/sponge 0.2.5 → 0.3.0

package/dist/src/digest/store.d.ts

@@ -1,57 +0,0 @@
-import type { DatabaseSync } from 'node:sqlite';
-import { type DigestOptions, type DigestV1 } from './schema.js';
-import { type ReviewStatus } from '../store/changes.js';
-export type { ReviewStatus };
-/** Per-field review of a digest. Only accepted fields can ever be published. */
-export interface DigestReview {
-    gist?: ReviewStatus;
-    ideas?: (ReviewStatus | null)[];
-    quotes?: (ReviewStatus | null)[][];
-}
-export interface Derivation {
-    id: string;
-    itemId: string;
-    revisionId: string;
-    kind: 'digest';
-    producer: unknown;
-    inputHash: string;
-    output: DigestV1;
-    review: DigestReview;
-    createdAt: string;
-}
-/** A parsed digest serialized in fixed key order, so key order never makes a different object. */
-export declare function canonicalDigest(d: DigestV1): string;
-/** Content address of a derivation: the same output from the same input is the same immutable object on every device. */
-export declare const derivationId: (revisionId: string, kind: string, inputHash: string, output: string) => string;
-/**
- * Store a draft digest only when every v1 rule passes against the revision it was made from.
- * Drafts are immutable data, not change-log entries; a different output is a new object.
- */
-export declare function putDigest(db: DatabaseSync, input: {
-    itemId: string;
-    revisionId: string;
-    producer: Record<string, unknown>;
-    inputHash: string;
-    output: unknown;
-    options?: DigestOptions;
-}): {
-    id: string;
-    duplicate: boolean;
-};
-/** The newest digest made from the item's current revision. */
-export declare function currentDigest(db: DatabaseSync, itemId: string): Derivation | undefined;
-export declare function readDigest(db: DatabaseSync, id: string): Derivation | undefined;
-/** The newest stored digest for exactly these inputs, so a rerun reuses it instead of asking the model again. */
-export declare function findDigest(db: DatabaseSync, revisionId: string, inputHash: string): Derivation | undefined;
-/** Review fields of a digest. Each changed path is its own change: `review.gist`, `review.ideas.<i>`, `review.quotes.<i>.<j>`. */
-export declare function reviewDigest(db: DatabaseSync, id: string, review: DigestReview): Derivation;
-/** The accepted subset of a digest. Rejected or unreviewed fields never leave the device. */
-export declare function acceptedDigest(d: Derivation): {
-    lead?: string;
-    ideas: {
-        claim: string;
-        detail: string;
-        kind: string;
-        quotes: string[];
-    }[];
-} | undefined;

package/dist/src/digest/store.js

@@ -1,77 +0,0 @@
-import { checkDigest, parseDigest } from './schema.js';
-import { markdownFor } from '../annotations/store.js';
-import { mutate } from '../store/changes.js';
-import { StoreError } from '../store/types.js';
-import { digest, hash } from '../store/files.js';
-const now = () => new Date().toISOString();
-const fail = (code = 'invalid-input') => { throw new StoreError(code); };
-/** A parsed digest serialized in fixed key order, so key order never makes a different object. */
-export function canonicalDigest(d) {
-    return JSON.stringify({ schemaVersion: d.schemaVersion, form: d.form, gist: { lead: d.gist.lead, ...(d.gist.context !== undefined ? { context: d.gist.context } : {}) }, ideas: d.ideas.map(i => ({ claim: i.claim, detail: i.detail, kind: i.kind, voice: i.voice.type === 'author' ? { type: 'author' } : { type: i.voice.type, name: i.voice.name }, quotes: i.quotes.map(q => ({ text: q.text, ...(q.speaker !== undefined ? { speaker: q.speaker } : {}), ...(q.locator ? { locator: q.locator.type === 'timestamp' ? { type: 'timestamp', ms: q.locator.ms } : { type: 'page', page: q.locator.page } } : {}) })) })), tags: [...d.tags] });
-}
-/** Content address of a derivation: the same output from the same input is the same immutable object on every device. */
-export const derivationId = (revisionId, kind, inputHash, output) => digest(JSON.stringify(['derivation-v1', revisionId, kind, inputHash, output]));
-/**
- * Store a draft digest only when every v1 rule passes against the revision it was made from.
- * Drafts are immutable data, not change-log entries; a different output is a new object.
- */
-export function putDigest(db, input) {
-    hash(input.inputHash);
-    const producer = JSON.stringify(input.producer);
-    if (!producer || Buffer.byteLength(producer) > 4096)
-        fail();
-    const revision = db.prepare('SELECT item_id FROM revisions WHERE id=?').get(input.revisionId);
-    if (revision?.item_id !== input.itemId)
-        fail('unavailable');
-    const parsed = parseDigest(input.output);
-    if (!parsed.digest)
-        throw Object.assign(new StoreError('invalid-input'), { issues: parsed.issues });
-    const check = checkDigest(parsed.digest, markdownFor(db, input.revisionId), input.options);
-    if (!check.ok)
-        throw Object.assign(new StoreError('invalid-input'), { issues: check.issues });
-    const output = canonicalDigest(parsed.digest);
-    if (Buffer.byteLength(output) > 65536)
-        fail();
-    const id = derivationId(input.revisionId, 'digest', input.inputHash, output);
-    if (db.prepare('SELECT 1 FROM derivations WHERE id=?').get(id))
-        return { id, duplicate: true };
-    db.prepare("INSERT INTO derivations(id,item_id,revision_id,kind,schema_version,producer_json,input_hash,output_json,created_at) VALUES(?,?,?,'digest',1,?,?,?,?)").run(id, input.itemId, input.revisionId, producer, input.inputHash, output, now());
-    return { id, duplicate: false };
-}
-function derivationRow(r) { return { id: String(r.id), itemId: String(r.item_id), revisionId: String(r.revision_id), kind: 'digest', producer: JSON.parse(String(r.producer_json)), inputHash: String(r.input_hash), output: JSON.parse(String(r.output_json)), review: JSON.parse(String(r.review_json)), createdAt: String(r.created_at) }; }
-/** The newest digest made from the item's current revision. */
-export function currentDigest(db, itemId) {
-    const r = db.prepare("SELECT d.* FROM derivations d JOIN items i ON i.id=d.item_id AND i.current_revision=d.revision_id WHERE d.item_id=? AND d.kind='digest' ORDER BY d.created_at DESC,d.rowid DESC LIMIT 1").get(itemId);
-    return r ? derivationRow(r) : undefined;
-}
-export function readDigest(db, id) { const r = db.prepare("SELECT * FROM derivations WHERE id=? AND kind='digest'").get(id); return r ? derivationRow(r) : undefined; }
-/** The newest stored digest for exactly these inputs, so a rerun reuses it instead of asking the model again. */
-export function findDigest(db, revisionId, inputHash) { hash(inputHash); const r = db.prepare("SELECT * FROM derivations WHERE revision_id=? AND kind='digest' AND input_hash=? ORDER BY created_at DESC,rowid DESC LIMIT 1").get(revisionId, inputHash); return r ? derivationRow(r) : undefined; }
-/** Review fields of a digest. Each changed path is its own change: `review.gist`, `review.ideas.<i>`, `review.quotes.<i>.<j>`. */
-export function reviewDigest(db, id, review) {
-    const row = db.prepare("SELECT * FROM derivations WHERE id=? AND kind='digest'").get(id) ?? fail('unavailable'), d = derivationRow(row);
-    const status = (v) => v === null || v === 'accepted' || v === 'rejected';
-    if (typeof review !== 'object' || review === null || Object.keys(review).some(k => !['gist', 'ideas', 'quotes'].includes(k)))
-        fail();
-    if (review.gist !== undefined && review.gist !== 'accepted' && review.gist !== 'rejected')
-        fail();
-    if (review.ideas !== undefined && (!Array.isArray(review.ideas) || review.ideas.length !== d.output.ideas.length || !review.ideas.every(status)))
-        fail();
-    if (review.quotes !== undefined && (!Array.isArray(review.quotes) || review.quotes.length !== d.output.ideas.length || review.quotes.some((q, i) => !Array.isArray(q) || q.length !== d.output.ideas[i].quotes.length || !q.every(status))))
-        fail();
-    const paths = [];
-    if (review.gist !== undefined)
-        paths.push(['review.gist', review.gist, d.review.gist ?? null]);
-    review.ideas?.forEach((v, i) => paths.push([`review.ideas.${i}`, v, d.review.ideas?.[i] ?? null]));
-    review.quotes?.forEach((q, i) => q.forEach((v, j) => paths.push([`review.quotes.${i}.${j}`, v, d.review.quotes?.[i]?.[j] ?? null])));
-    for (const [path, next, prior] of paths)
-        if (next !== prior)
-            mutate(db, 'derivation', id, path, next);
-    return derivationRow(db.prepare('SELECT * FROM derivations WHERE id=?').get(id));
-}
-/** The accepted subset of a digest. Rejected or unreviewed fields never leave the device. */
-export function acceptedDigest(d) {
-    const ideas = d.output.ideas.flatMap((idea, i) => d.review.ideas?.[i] === 'accepted' ? [{ claim: idea.claim, detail: idea.detail, kind: idea.kind, quotes: idea.quotes.filter((_, j) => d.review.quotes?.[i]?.[j] === 'accepted').map(q => q.text) }] : []);
-    const lead = d.review.gist === 'accepted' ? d.output.gist.lead : undefined;
-    return lead || ideas.length ? { ...(lead ? { lead } : {}), ideas } : undefined;
-}

package/dist/src/store/foundation.d.ts

@@ -1,7 +0,0 @@
-/** Sync and publishing foundation, split by concern; this barrel keeps existing imports working. See docs/decisions/sync-and-publishing.md. */
-export { applyChange, append, listChanges, mutate, seedChanges, setReviewPath, sourceRefId, maxChangeBytes, type Change, type Entity, type LoggedChange } from './changes.js';
-export { backfillUris, itemUris, itemsForUri, setVisibility, syncUris, visibility, type Visibility, type VisibilityState } from '../identity/visibility.js';
-export { addComment, addHighlight, deleteAnnotation, importNote, listAnnotations, markdownFor, readAnnotation, setReadingState, updateAnnotation, type Annotation } from '../annotations/store.js';
-export { acceptedDigest, canonicalDigest, currentDigest, derivationId, findDigest, putDigest, readDigest, reviewDigest, type Derivation, type DigestReview, type ReviewStatus } from '../digest/store.js';
-export { currentEditorial, listEditorials, publicEditorial, putEditorial, readEditorial, reviewEditorial, type Editorial } from '../digest/editorial.js';
-export { publicProjection, type PublicEntry } from '../publish/projection.js';

package/dist/src/store/foundation.js

@@ -1,7 +0,0 @@
-/** Sync and publishing foundation, split by concern; this barrel keeps existing imports working. See docs/decisions/sync-and-publishing.md. */
-export { applyChange, append, listChanges, mutate, seedChanges, setReviewPath, sourceRefId, maxChangeBytes } from './changes.js';
-export { backfillUris, itemUris, itemsForUri, setVisibility, syncUris, visibility } from '../identity/visibility.js';
-export { addComment, addHighlight, deleteAnnotation, importNote, listAnnotations, markdownFor, readAnnotation, setReadingState, updateAnnotation } from '../annotations/store.js';
-export { acceptedDigest, canonicalDigest, currentDigest, derivationId, findDigest, putDigest, readDigest, reviewDigest } from '../digest/store.js';
-export { currentEditorial, listEditorials, publicEditorial, putEditorial, readEditorial, reviewEditorial } from '../digest/editorial.js';
-export { publicProjection } from '../publish/projection.js';