@astrosheep/square 0.3.93 → 0.3.95

package/dist/sqlite-square.d.ts

@@ -1,10 +1,9 @@
-import { type Body } from './model.js';
-import type { ActivityResult, HistoryQuery, HistoryResult, JoinOptions, JoinResult, ObservationOptions, OperationControl, Participant, SquareAtInput, SquareBuildInput, SquareLocation, StatusOptions, StatusResult, ParticipantsResult, RecoveryResult, DiscoveryOptions, InboxOptions, InboxResult, StreamOptions } from './square-facade.js';
+import { type Owner } from './model.js';
+import type { HistoryQuery, HistoryResult, JoinOptions, JoinResult, LifecycleResult, ObservationOptions, OperationControl, Participant, SquareAtInput, SquareBuildInput, SquareLocation, StatusOptions, StatusResult, ParticipantsResult, RecoveryResult, DiscoveryOptions, InboxOptions, InboxResult, StreamOptions, StreamRecord, Activity, PerceivedActivity } from './square-facade.js';
 export type * from './square-facade.js';
 export { createSquareResourceOwner } from './artifact.js';
 export { formatActivityId, parseActivityId, MAX_IDENTITY_SET_SIZE } from './square-core.js';
 export { CATCH_DEFAULT_LIMIT, CATCH_MAX_LIMIT } from './catch-decisions.js';
-export { HELD_WAIT_BUDGET_MS } from './runtime.js';
 export { HISTORY_DEFAULT_LIMIT, HISTORY_MAX_LIMIT } from './views.js';
 export { DEFAULT_LIST_DEPTH, MAX_LIST_DEPTH, DEFAULT_LIST_LIMIT, MAX_LIST_LIMIT } from './list.js';
 export declare function squareClock(env: NodeJS.ProcessEnv, clock?: () => number): () => number;
@@ -13,41 +12,55 @@ export declare class SqliteSquare {
     readonly location: string;
     private readonly artifact;
     private readonly clock;
-    private readonly body?;
-    private readonly wakeAddress?;
     private readonly wakeTransport?;
     private readonly indexPath?;
-    private readonly automaticDelivery;
-    private readonly ownsArtifact;
-    private readonly defaultParticipant?;
+    private readonly closesArtifact;
+    private readonly deliveryLocation;
     private constructor();
-    static at(input: SquareAtInput, control?: OperationControl, automaticDelivery?: boolean): Promise<SqliteSquare>;
-    static build(input: SquareBuildInput, control?: OperationControl, automaticDelivery?: boolean): Promise<SqliteSquare>;
+    static at(input: SquareAtInput, control?: OperationControl): Promise<SqliteSquare>;
+    static build(input: SquareBuildInput, control?: OperationControl): Promise<SqliteSquare>;
     static inMemory(input: Omit<SquareBuildInput, 'path' | 'resources'>): SqliteSquare;
-    /** Discovery is best effort and never grants write authority. Finish it before returning. */
-    private publishIdentity;
+    /** Discovery is best effort and never grants write authority. */
+    private publishSeat;
     private observation;
     private contextObservation;
     private handle;
     private static readonly ParticipantHandle;
-    participant(requested?: string): Promise<Participant>;
-    join(requested?: string, options?: JoinOptions, control?: OperationControl): Promise<JoinResult>;
-    implicitJoin(name: string, control?: OperationControl): Promise<{
-        readonly state: 'joined' | 'active' | 'done';
-        readonly participant?: Participant;
-    }>;
+    participant(name: string, { owner }: {
+        readonly owner: Owner;
+    }): Promise<Participant>;
+    join(requested: string, options: JoinOptions, control?: OperationControl): Promise<JoinResult>;
+    /** Restore only a standing seat; a concurrent departure or takeover cannot be revived. */
+    reattach(name: string, { owner, wakeAddress }: Pick<JoinOptions, 'owner' | 'wakeAddress'>, control?: OperationControl): Promise<Participant | null>;
     snapshot(control?: OperationControl): Promise<import("./square-facade.js").SquareSnapshot>;
     history(query?: HistoryQuery, control?: OperationControl): Promise<HistoryResult>;
     status(options?: StatusOptions, control?: OperationControl): Promise<StatusResult>;
     participants(options?: ObservationOptions, control?: OperationControl): Promise<ParticipantsResult>;
     recovery(requested?: string, control?: OperationControl): Promise<RecoveryResult>;
-    stream(options: StreamOptions, control?: OperationControl): AsyncIterable<import("./square-facade.js").StreamRecord>;
-    recognize(): Promise<readonly Participant[]>;
+    stream(options: StreamOptions & {
+        readonly recipient: string;
+    }, control?: OperationControl): AsyncIterable<PerceivedActivity>;
+    stream(options: StreamOptions & {
+        readonly recipient?: undefined;
+    }, control?: OperationControl): AsyncIterable<Activity>;
+    stream(options: StreamOptions, control?: OperationControl): AsyncIterable<StreamRecord>;
+    seatsOf(owner: Owner): Promise<readonly import('./square-facade.js').HeldSeat[]>;
     close(): Promise<void>;
-    cancelDeliveries(name: string, expectedGeneration: import('./square-core.js').ActivityId): Promise<boolean>;
-    endOwnedSession(name: string, sessionId: string, expectedGeneration?: import('./square-core.js').ActivityId, body?: Body): Promise<ActivityResult | null>;
+    private heldSeat;
+    cancelDeliveries(name: string, identity: {
+        readonly owner: Owner;
+        readonly generation: import('./square-core.js').ActivityId;
+    }): Promise<boolean>;
+    detach(name: string, identity: {
+        readonly owner: Owner;
+        readonly generation: import('./square-core.js').ActivityId;
+    }): Promise<true | null>;
+    endHeld(name: string, identity: {
+        readonly owner: Owner;
+        readonly generation: import('./square-core.js').ActivityId;
+    }): Promise<LifecycleResult | null>;
 }
 export declare function diagnoseSquare(input: SquareLocation, control?: OperationControl): Promise<import("./artifact.js").DiagnoseResult>;
 export declare function migrateSquare(input: SquareLocation, control?: OperationControl): Promise<import("./square-migration.js").MigrationOutcome>;
 export declare function discover(input: SquareAtInput, options?: DiscoveryOptions, control?: OperationControl): Promise<import("./square-facade.js").DiscoveryResult>;
-export declare function inbox(input: SquareAtInput, identity: string | Body, options?: InboxOptions, control?: OperationControl): Promise<InboxResult>;
+export declare function inbox(input: SquareAtInput, owner: Owner, options?: InboxOptions, control?: OperationControl): Promise<InboxResult>;