@astrosheep/square 0.3.70 → 0.3.71

package/dist/square-actions.d.ts

@@ -1,21 +1,24 @@
-import { type SquareState } from './model.js';
 import type { WakeTransportPort } from './ports.js';
-import type { Activity, CatchOptions, CatchResult, ExpressOptions, ExpressResult, OperationControl, OwnershipFenceOptions } from './square-facade.js';
-import { type CatchProjection } from './catch-decisions.js';
+import type { Activity, CatchOptions, ExpressOptions, ExpressResult, ExpressionObservation, ListenerChangeResult, OperationControl, OwnershipFenceOptions } from './square-facade.js';
+import { type CatchSelection } from './catch-decisions.js';
 import { type HostContext } from './participant-host.js';
 export interface OperationContext extends HostContext {
     readonly wakeTransport?: WakeTransportPort;
 }
 export type { OwnershipFenceOptions };
-export declare function catchUp(square: OperationContext, name: string, options?: CatchOptions, project?: (state: SquareState) => CatchProjection, control?: OperationControl): Promise<CatchResult>;
+export declare function catchUp(square: OperationContext, name: string, options?: CatchOptions, control?: OperationControl): Promise<CatchSelection>;
+export declare function catchUp(square: OperationContext, name: string, options: CatchOptions, control: OperationControl | undefined, leaseId: string): Promise<CatchSelection | null>;
 export declare function join(square: OperationContext, name: string, control?: OperationControl): Promise<{
     readonly name: string;
     readonly activity: Activity | null;
+    readonly participantCount: number;
+    readonly reconnected: boolean;
 }>;
-/** End the standing participant and immediately let the caller reclaim the name. */
+/** Takeover holds the host CAS fence across the single done+join artifact transaction. */
 export declare function takeover(square: OperationContext, name: string, _oldSessionIds?: readonly string[], control?: OperationControl): Promise<{
     readonly name: string;
     readonly activities: readonly Activity[];
+    readonly participantCount: number;
     readonly epoch?: number;
 }>;
 export declare function implicitJoin(square: OperationContext, name: string, control?: OperationControl): Promise<{
@@ -23,28 +26,15 @@ export declare function implicitJoin(square: OperationContext, name: string, con
     readonly state: 'joined' | 'active' | 'done';
     readonly activity: Activity | null;
 }>;
-export declare function express(square: OperationContext, name: string, body: string, options?: ExpressOptions, control?: OperationControl): Promise<ExpressResult>;
-export interface ListenerChangeResult {
-    readonly activity: Activity | null;
+export interface ExpressCommittedResult extends ExpressResult {
+    readonly observation: ExpressionObservation;
 }
+export declare function express(square: OperationContext, name: string, body: string, options?: ExpressOptions, control?: OperationControl): Promise<ExpressCommittedResult>;
 export declare function listen(square: OperationContext, actor: string, target: string, control?: OperationControl): Promise<ListenerChangeResult>;
 export declare function ignore(square: OperationContext, actor: string, target: string, control?: OperationControl): Promise<ListenerChangeResult>;
 export declare function listening(square: OperationContext, actor: string, control?: OperationControl): Promise<readonly string[]>;
 export declare function done(square: OperationContext, name: string, body?: string, fence?: OwnershipFenceOptions, control?: OperationControl): Promise<ExpressResult>;
-/**
- * End one session's ownership of a participant inside the ownership claim critical
- * section. The artifact `done` (when this session is still the owner) and retirement of
- * this session's routes share one transaction, and the exact captured presence row is
- * removed only while the lock is still held. A rejoin or takeover therefore lands either
- * before the whole cleanup — and is part of the state being ended — or after it, with
- * fresh presence and route rows that this cleanup can never touch.
- */
 export declare function endOwnedSession(square: OperationContext, name: string, sessionId: string, expectedEpoch?: number): Promise<ExpressResult | null>;
-/**
- * Retire an ended session's orphan routes when no participant name is known. The
- * ownership claim lock is held across the ledger read and the artifact transaction, so a
- * rejoin that claims first is seen as a live participant and its route survives.
- */
 export declare function retireEndedSessionRoutes(square: OperationContext, sessionId: string): Promise<void>;
 export declare function hold(square: OperationContext, name: string, reason?: string, control?: OperationControl): Promise<ExpressResult>;
 export declare function resume(square: OperationContext, name: string, control?: OperationControl): Promise<ExpressResult>;