@astrosheep/square 0.3.69 → 0.3.71

package/dist/square-application.d.ts

@@ -1,58 +1,34 @@
-import type { HostLedgerPort, WakeTransportPort } from './ports.js';
-import { statusPresentation, participantsPresentation } from './views.js';
-import type { Activity, CatchOptions, CatchResult, ExpressOptions, ExpressResult, HistoryQuery, ListenerChangeResult, ParticipantStatus, PerceivedActivity, OperationControl } from './square-facade.js';
-/** Final control coordinate shared by facade, actions, and application adapters. */
-export interface SquareApplicationContext {
-    readonly cwd: string;
-    readonly env: NodeJS.ProcessEnv;
-    readonly squarePath?: string;
-    readonly participant?: string;
-    readonly clock?: () => number;
-    readonly hostLedger?: HostLedgerPort;
-    readonly wakeTransport?: WakeTransportPort;
-}
-export interface JoinApplicationOptions {
-    readonly takeover?: boolean;
-}
-export interface JoinApplicationResult {
-    readonly participant: string;
-    readonly activity: Activity | null;
-    readonly kind: 'joined' | 'reconnected' | 'taken-over';
-    readonly participantCount: number;
-}
-export interface ExpressApplicationOptions extends ExpressOptions {
-    readonly noWait?: boolean;
-}
-export interface ExpressApplicationResult extends ExpressResult {
-    readonly waited: boolean;
-}
-export interface ApplicationStatus {
-    readonly context: string;
-    readonly actCount: number;
-    readonly hardCap: number | null;
-    readonly throttlePerMinute?: number;
-    readonly held: {
-        readonly by: string;
-        readonly reason?: string;
-    } | null;
-    readonly participants: readonly ParticipantStatus[];
-}
-export type ApplicationParticipants = Awaited<ReturnType<typeof participantsPresentation>>;
-export type ApplicationStatusProjection = Awaited<ReturnType<typeof statusPresentation>>;
-export interface SquareApplication {
-    join(options?: JoinApplicationOptions, control?: OperationControl): Promise<JoinApplicationResult>;
-    express(body: string, options?: ExpressApplicationOptions, control?: OperationControl): Promise<ExpressApplicationResult>;
-    catch(options?: CatchOptions, control?: OperationControl): Promise<CatchResult>;
+import type { Activity, ExpressResult, HistoryQuery, OperationControl, Participant, ParticipantStatus, SquareApplication, SquareApplicationContext, SquareAtInput, SquareBuildInput, SquareSnapshot } from './square-facade.js';
+export type * from './square-facade.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';
+/** Supported SDK resource. It owns one open artifact; application operations use
+ * the same owner functions directly, not an application -> SDK -> application chain. */
+export declare class Square {
+    readonly location: string;
+    private readonly square;
+    private readonly transport;
+    private constructor();
+    static at(input: SquareAtInput, control?: OperationControl): Promise<Square>;
+    static build(input: SquareBuildInput): Promise<Square>;
+    static inMemory(input: Omit<SquareBuildInput, 'path'>): Square;
+    private handle;
+    join(name: string, control?: OperationControl): Promise<Participant>;
+    takeover(name: string, control?: OperationControl): Promise<Participant>;
+    doneOwnedSession(name: string, body: string, expectedEpoch: number, control?: OperationControl): Promise<ExpressResult>;
+    implicitJoin(name: string, control?: OperationControl): Promise<{
+        readonly state: 'joined' | 'active' | 'done';
+        readonly participant?: Participant;
+    }>;
+    participants(): Promise<ParticipantStatus[]>;
+    snapshot(control?: OperationControl): Promise<SquareSnapshot>;
     history(query?: HistoryQuery, control?: OperationControl): Promise<Activity[]>;
-    listen(target: string, control?: OperationControl): Promise<ListenerChangeResult>;
-    ignore(target: string, control?: OperationControl): Promise<ListenerChangeResult>;
-    listening(control?: OperationControl): Promise<readonly string[]>;
-    hold(reason?: string, control?: OperationControl): Promise<ExpressResult>;
-    resume(control?: OperationControl): Promise<ExpressResult>;
-    /** Leave without a message. Only an omitted or empty body is accepted. */
-    done(body?: string, control?: OperationControl): Promise<ExpressResult>;
-    status(): Promise<ApplicationStatusProjection>;
-    participants(): Promise<ApplicationParticipants>;
+    recognize(env: NodeJS.ProcessEnv): Promise<Participant | null>;
+    close(): Promise<void>;
+    endOwnedSession(name: string, sessionId: string, expectedEpoch?: number): Promise<ExpressResult | null>;
+    retireEndedSessionRoutes(sessionId: string): Promise<void>;
 }
 export declare function createSquareApplication(context: SquareApplicationContext): SquareApplication;
-export type { CatchResult, PerceivedActivity };