@astrosheep/square 0.3.70 → 0.3.72

package/dist/activity-feed.d.ts

@@ -1,7 +1,6 @@
-import { type StoredAct, type SquareState } from './model.js';
-export declare function actDelta(acts: StoredAct[], cursor: number): StoredAct[];
-/** Visible activities after the participant's derived continuous-seen prefix. */
-export declare function deliveryDelta(squareState: SquareState, name: string, delivery?: import("./delivery.js").DeliveryModel): StoredAct[];
-export declare function directedPeerSays(squareState: SquareState, delta: StoredAct[], name: string, delivery?: import("./delivery.js").DeliveryModel): Extract<StoredAct, {
+import type { SquareRead } from './ports.js';
+import type { StoredAct } from './model.js';
+/** Directed suffix includes seen rows beyond an earlier hole, unlike notification pending. */
+export declare function directedSuffix(facts: SquareRead, name: string): Extract<StoredAct, {
     kind: 'say';
 }>[];

package/dist/activity-feed.js

@@ -1,11 +1,15 @@
-import { deriveDeliveryModel } from './delivery.js';
-export function actDelta(acts, cursor) {
-    return acts.filter((act) => act.index > cursor);
-}
-/** Visible activities after the participant's derived continuous-seen prefix. */
-export function deliveryDelta(squareState, name, delivery = deriveDeliveryModel(squareState)) {
-    return actDelta(squareState.acts, delivery.cursorFor(name));
-}
-export function directedPeerSays(squareState, delta, name, delivery = deriveDeliveryModel(squareState)) {
-    return delta.filter((act) => delivery.directedTo(act, name));
+import { readCursor } from './runtime.js';
+/** Directed suffix includes seen rows beyond an earlier hole, unlike notification pending. */
+export function directedSuffix(facts, name) {
+    const result = [];
+    let afterIndex = readCursor(facts, name);
+    while (true) {
+        const page = facts.directed(name, { afterIndex }, { edge: 'oldest', limit: 100 });
+        for (const act of facts.activities(page.items.map((head) => head.index)))
+            if (act.kind === 'say')
+                result.push(act);
+        if (!page.hasMore)
+            return result;
+        afterIndex = page.items.at(-1).index;
+    }
 }

package/dist/artifact.d.ts

@@ -1,45 +1,38 @@
-import { type SquareState } from './model.js';
-export { createSquareState, emptyRuntimeState } from './square-state.js';
+import { DatabaseSync } from 'node:sqlite';
+import { type BuildOptions } from './model.js';
+import type { SquareArtifactPort } from './ports.js';
+import { type SquareState } from './square-sqlite.js';
+/** All build paths share configuration validation and lazy guide preparation. */
+export declare function prepareSquareBuild(options: Omit<BuildOptions, 'force'>, snippet: string): SquareState;
+/** File build owns publication and CLI conflict semantics, not host resources. */
+export declare function createSquare(location: string, options: BuildOptions, snippet: string, signal?: AbortSignal): Promise<Pick<SquareState, 'hardCap' | 'throttlePerMinute'>>;
 export interface DoctorProblem {
     kind: string;
     message: string;
 }
 export interface DiagnoseResult {
     unfixable?: string;
+    migrationRequired?: string;
     problems: DoctorProblem[];
-    state?: SquareState;
+    standingCount?: number;
 }
 export interface SquareSnapshot {
     readonly state: SquareState;
     readonly revision: number;
 }
-/** Creates a new SQLite artifact only when its pathname did not already exist. */
-export declare function createSquareFile(squarePath: string, state: SquareState): Promise<boolean>;
-/**
- * Reads a complete validated snapshot, yielding between transient SQLite lock
- * conflicts. The URI remains create-disabled throughout the retry loop.
- */
-export declare function readSquareSnapshot(squarePath: string, signal?: AbortSignal): Promise<SquareSnapshot>;
-/** Check the artifact revision without loading or parsing the historical state. */
-export declare function readSquareRevision(squarePath: string, signal?: AbortSignal): Promise<number>;
-/** One reference-counted revision detector per canonical artifact in this process. */
-export declare function observeSquareRevision(squarePath: string): Promise<import('./file-changes.js').VersionObserver<number | null>>;
-export type SquareTransition<R> = (state: SquareState, revision: number) => {
-    state?: SquareState;
-    result: R;
-};
-/**
- * Executes one synchronous SquareState transition under SQLite's write lock.
- * A busy COMMIT retries on this same transaction, so fn is never replayed.
- */
-export declare function transactSquareSnapshot<R>(squarePath: string, fn: SquareTransition<R>, signal?: AbortSignal, forceCommit?: boolean): Promise<{
-    result: R;
-    revision: number;
-    changed: boolean;
-}>;
-/** Replaces an existing validated snapshot in place and always advances its revision. */
-export declare function replaceSquareSnapshot(squarePath: string, state: SquareState): Promise<SquareSnapshot>;
-export declare function writeSquareFile(squarePath: string, squareState: SquareState): Promise<void>;
-export declare function loadSquare(squarePath: string): Promise<SquareState>;
-export declare function probeSquare(squarePath: string): Promise<SquareState | undefined>;
-export declare function diagnoseSquareFile(squarePath: string): Promise<DiagnoseResult>;
+/** Private artifact-boundary connection shared with explicit migration. Never creates a path. */
+export declare function openExistingSquareDatabase(location: string): DatabaseSync;
+export declare function retrySqliteBusy<T>(operation: () => T, signal?: AbortSignal): Promise<T>;
+/** Acquisition may retry; after change starts, only COMMIT retries, retaining its result. */
+export declare function inSqliteTransaction<T>(db: DatabaseSync, write: boolean, validate: () => void, change: () => T, signal?: AbortSignal): Promise<T>;
+/** One connection, ordered operations, guarded synchronous transaction capabilities. */
+export declare function createArtifactPort(location: string, initial?: SquareState, externalSignal?: AbortSignal): SquareArtifactPort;
+/** New-format creation; initial authority is accepted only at this explicit boundary. */
+export declare function createSquareFile(location: string, state: SquareState, signal?: AbortSignal): Promise<boolean>;
+/** Explicit build --force / fixture import, never a runtime state-replacement callback. */
+export declare function writeSquareFile(location: string, state: SquareState, signal?: AbortSignal): Promise<void>;
+/** Explicit test/export projection. Hot callers must use the typed port. */
+export declare function readSquareSnapshot(location: string, signal?: AbortSignal): Promise<SquareSnapshot>;
+export declare function readSquareRevision(location: string, signal?: AbortSignal): Promise<number>;
+export declare function observeSquareRevision(location: string): Promise<import('./file-changes.js').VersionObserver<number | null>>;
+export declare function diagnoseSquareFile(location: string): Promise<DiagnoseResult>;