@ewhauser/world-celld 0.7.0 → 0.8.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +26 -0
- package/README.md +5 -0
- package/dist/index.d.ts +15 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +54 -37
- package/dist/index.js.map +1 -1
- package/dist/queue-consumer.d.ts +1 -1
- package/dist/queue-consumer.js +1 -1
- package/dist/{queue-delivery-DzNOtCYA.d.ts → queue-delivery-wvPp6_Hh.d.ts} +30 -3
- package/dist/queue-delivery-wvPp6_Hh.d.ts.map +1 -0
- package/dist/{queue-protocol-CtH7UUCO.js → queue-protocol-C1zbXwa_.js} +28 -2
- package/dist/queue-protocol-C1zbXwa_.js.map +1 -0
- package/dist/{run-list-B__jKuE7.js → run-list-DGsdv6Jf.js} +28 -2
- package/dist/{run-list-B__jKuE7.js.map → run-list-DGsdv6Jf.js.map} +1 -1
- package/dist/testing.d.ts +2 -0
- package/dist/testing.d.ts.map +1 -1
- package/dist/testing.js +945 -255
- package/dist/testing.js.map +1 -1
- package/dist/worker.d.ts +98 -1
- package/dist/worker.d.ts.map +1 -1
- package/dist/worker.js +972 -269
- package/dist/worker.js.map +1 -1
- package/package.json +1 -1
- package/dist/queue-delivery-DzNOtCYA.d.ts.map +0 -1
- package/dist/queue-protocol-CtH7UUCO.js.map +0 -1
package/dist/worker.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { i as QueuePayloadRegistration, r as QueuePayloadOrphan, t as QueueDeliveryResult } from "./queue-delivery-
|
|
1
|
+
import { a as RunQueueReservation, i as QueuePayloadRegistration, r as QueuePayloadOrphan, t as QueueDeliveryResult } from "./queue-delivery-wvPp6_Hh.js";
|
|
2
2
|
import { CreateEventParams, CreateEventRequest, Event, Hook, RunCreatedEventRequest, Step, TerminalWorkflowRunStatus, Wait, WorkflowRun, WorkflowRunStatus } from "@workflow/world";
|
|
3
3
|
//#region src/worker/queue-payload-store.d.ts
|
|
4
4
|
/**
|
|
@@ -299,6 +299,11 @@ interface HookTokenOwner {
|
|
|
299
299
|
//#region src/worker/durable-objects/hook-index-shared.d.ts
|
|
300
300
|
interface RunLifecycleStub {
|
|
301
301
|
getLifecycleStatus(): Promise<RunLifecycleStatus>;
|
|
302
|
+
resolveExpiredHookClaim(request: {
|
|
303
|
+
hookId: string;
|
|
304
|
+
claimId: string;
|
|
305
|
+
token?: string;
|
|
306
|
+
}): Promise<Hook | null>;
|
|
302
307
|
}
|
|
303
308
|
interface HookIndexEnv {
|
|
304
309
|
WORKFLOW_DB?: CellNamespaceLike<RunLifecycleStub>;
|
|
@@ -330,6 +335,7 @@ declare class HookIdDO extends DurableObject<HookIndexEnv> {
|
|
|
330
335
|
}>;
|
|
331
336
|
alarm(): Promise<void>;
|
|
332
337
|
private armAtMost;
|
|
338
|
+
private renewClaim;
|
|
333
339
|
private compactClaims;
|
|
334
340
|
}
|
|
335
341
|
//#endregion
|
|
@@ -357,6 +363,7 @@ declare class HookTokenDO extends DurableObject<HookIndexEnv> {
|
|
|
357
363
|
}>;
|
|
358
364
|
alarm(): Promise<void>;
|
|
359
365
|
private armAtMost;
|
|
366
|
+
private renewClaim;
|
|
360
367
|
private compactClaims;
|
|
361
368
|
}
|
|
362
369
|
//#endregion
|
|
@@ -401,6 +408,13 @@ declare class StreamDO extends DurableObject {
|
|
|
401
408
|
private wakeReaders;
|
|
402
409
|
private waitForChange;
|
|
403
410
|
private readSnapshot;
|
|
411
|
+
private readChunkRows;
|
|
412
|
+
/**
|
|
413
|
+
* Plan from the small segment size rows, then load only the segments that
|
|
414
|
+
* cover the requested range. A read that starts on a segment boundary (the
|
|
415
|
+
* common sequential case) needs one list and one multi-get.
|
|
416
|
+
*/
|
|
417
|
+
private readSegmentRows;
|
|
404
418
|
/** Append one bounded binary batch with contiguous indexes. */
|
|
405
419
|
writeChunks(runId: string, chunks: Uint8Array[]): Promise<StreamWriteResult>;
|
|
406
420
|
/**
|
|
@@ -421,6 +435,14 @@ declare class StreamDO extends DurableObject {
|
|
|
421
435
|
}): Promise<ExpireRunStreamsResult>;
|
|
422
436
|
/** Remove completed registry entries in a bounded, retry-safe batch. */
|
|
423
437
|
finalizeRegistry(runId: string, streams: string[]): Promise<FinalizeRunStreamsResult>;
|
|
438
|
+
/** Delete one page of per-chunk rows, listing size rows to avoid loading payloads. */
|
|
439
|
+
private expireChunkPage;
|
|
440
|
+
/**
|
|
441
|
+
* Delete one page of segment rows, listing segment size rows to avoid
|
|
442
|
+
* loading payloads. One segment always makes progress, even when it holds
|
|
443
|
+
* more chunks or bytes than the page allows.
|
|
444
|
+
*/
|
|
445
|
+
private expireSegmentPage;
|
|
424
446
|
/**
|
|
425
447
|
* Fence the stream and delete one bounded page. Listing size keys avoids
|
|
426
448
|
* loading payloads, and the transaction makes a crash retry resume safely.
|
|
@@ -463,6 +485,12 @@ declare class WorkflowRunDO extends DurableObject {
|
|
|
463
485
|
committed: boolean;
|
|
464
486
|
}>;
|
|
465
487
|
getRun(): Promise<RunReadOutcome<WorkflowRun | null>>;
|
|
488
|
+
/** Fence both supported event-claim forms before an expired shard claim is released. */
|
|
489
|
+
resolveExpiredHookClaim(request: {
|
|
490
|
+
hookId: string;
|
|
491
|
+
claimId: string;
|
|
492
|
+
token?: string;
|
|
493
|
+
}): Promise<Hook | null>;
|
|
466
494
|
/** Single authoritative lifecycle answer used after derivative compaction. */
|
|
467
495
|
getLifecycleStatus(): Promise<RunLifecycleStatus>;
|
|
468
496
|
getStep(stepId: string): Promise<RunReadOutcome<Step | null>>;
|
|
@@ -531,6 +559,67 @@ declare class WorkflowRunDO extends DurableObject {
|
|
|
531
559
|
private deletePayloadBatch;
|
|
532
560
|
private recordCleanupFailure;
|
|
533
561
|
private recordTerminalCleanupFailure;
|
|
562
|
+
/**
|
|
563
|
+
* Read-only admission for a run-bearing Queue message whose body travels
|
|
564
|
+
* inline in the broker envelope. It answers what payload registration does
|
|
565
|
+
* for offloaded bodies, without writing anything.
|
|
566
|
+
*/
|
|
567
|
+
getQueueAdmission(): Promise<{
|
|
568
|
+
ok: true;
|
|
569
|
+
} | {
|
|
570
|
+
ok: false;
|
|
571
|
+
message: string;
|
|
572
|
+
}>;
|
|
573
|
+
/**
|
|
574
|
+
* Enqueue-side admission and idempotency reservation in one transaction,
|
|
575
|
+
* for a run-scoped claim. Replaces a separate claim cell's reservation plus
|
|
576
|
+
* the run expiry check.
|
|
577
|
+
*/
|
|
578
|
+
reserveRunQueueMessage(params: {
|
|
579
|
+
claimName: string;
|
|
580
|
+
messageId: string;
|
|
581
|
+
expiresAt: number;
|
|
582
|
+
publicationPending?: boolean;
|
|
583
|
+
}): Promise<RunQueueReservation>;
|
|
584
|
+
confirmRunQueueMessagePublication(params: {
|
|
585
|
+
claimName: string;
|
|
586
|
+
messageId: string;
|
|
587
|
+
expiresAt: number;
|
|
588
|
+
}): Promise<void>;
|
|
589
|
+
/** Delivery-side run expiry check and in-flight claim in one transaction. */
|
|
590
|
+
claimRunQueueMessage(params: {
|
|
591
|
+
claimName: string;
|
|
592
|
+
messageId: string;
|
|
593
|
+
staleMs: number;
|
|
594
|
+
}): Promise<{
|
|
595
|
+
expired: true;
|
|
596
|
+
} | {
|
|
597
|
+
expired: false;
|
|
598
|
+
claimed: boolean;
|
|
599
|
+
retryAt?: number;
|
|
600
|
+
}>;
|
|
601
|
+
holdRunQueueMessage(params: {
|
|
602
|
+
claimName: string;
|
|
603
|
+
messageId: string;
|
|
604
|
+
retryAt: number;
|
|
605
|
+
expiresAt: number;
|
|
606
|
+
reservationExpiresAt?: number;
|
|
607
|
+
}): Promise<{
|
|
608
|
+
held: boolean;
|
|
609
|
+
}>;
|
|
610
|
+
releaseRunQueueMessage(params: {
|
|
611
|
+
claimName: string;
|
|
612
|
+
messageId: string;
|
|
613
|
+
}): Promise<void>;
|
|
614
|
+
completeRunQueueMessage(params: {
|
|
615
|
+
claimName: string;
|
|
616
|
+
messageId: string;
|
|
617
|
+
}): Promise<void>;
|
|
618
|
+
/** Failed enqueue cleanup must preserve delivery already accepted by the broker. */
|
|
619
|
+
abandonRunQueueMessageReservation(params: {
|
|
620
|
+
claimName: string;
|
|
621
|
+
messageId: string;
|
|
622
|
+
}): Promise<void>;
|
|
534
623
|
registerQueuePayload(registration: QueuePayloadRegistration): Promise<{
|
|
535
624
|
ok: true;
|
|
536
625
|
} | {
|
|
@@ -549,11 +638,19 @@ declare class WorkflowRunDO extends DurableObject {
|
|
|
549
638
|
reserveQueueMessage(params: {
|
|
550
639
|
messageId: string;
|
|
551
640
|
expiresAt: number;
|
|
641
|
+
publicationPending?: boolean;
|
|
552
642
|
}): Promise<{
|
|
553
643
|
admitted: boolean;
|
|
554
644
|
messageId: string;
|
|
645
|
+
publicationPending?: true;
|
|
555
646
|
}>;
|
|
647
|
+
confirmQueueMessagePublication(params: {
|
|
648
|
+
messageId: string;
|
|
649
|
+
expiresAt: number;
|
|
650
|
+
}): Promise<void>;
|
|
556
651
|
completeQueueMessage(messageId: string): Promise<void>;
|
|
652
|
+
/** Abandon the enqueue reservation without releasing an active delivery claim. */
|
|
653
|
+
abandonQueueMessageReservation(messageId: string): Promise<void>;
|
|
557
654
|
claimInflight(params: {
|
|
558
655
|
messageId: string;
|
|
559
656
|
staleMs: number;
|
package/dist/worker.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"worker.d.ts","names":[],"sources":["../src/worker/queue-payload-store.ts","../src/worker/router.ts","../src/worker/do-base.ts","../src/retention.ts","../src/apply-event.ts","../src/stream-protocol.ts","../src/indexes.ts","../src/config.ts","../src/worker/durable-objects/hook-index-shared.ts","../src/worker/durable-objects/HookIdDO.ts","../src/worker/durable-objects/HookTokenDO.ts","../src/worker/durable-objects/RunCatalogDO.ts","../src/worker/durable-objects/StreamDO.ts","../src/worker/durable-objects/WorkflowRunDO.ts","../src/worker/worker.ts"],"mappings":";;;;;;;;;;UAOiB;EACf,MAAM,aAAa,eAAe;IAAY;IAAe;MAAsB;EACnF,KAAK,cAAc;EACnB,OAAO,0BAA0B;;UAGlB;EACf,IACE,aACA,eACA;IAAY,iBAAiB;MAC5B;EACH,IAAI,cAAc;IAAU,QAAQ;;EACpC,OAAO,0BAA0B;;;;;
|
|
1
|
+
{"version":3,"file":"worker.d.ts","names":[],"sources":["../src/worker/queue-payload-store.ts","../src/worker/router.ts","../src/worker/do-base.ts","../src/retention.ts","../src/apply-event.ts","../src/stream-protocol.ts","../src/indexes.ts","../src/config.ts","../src/worker/durable-objects/hook-index-shared.ts","../src/worker/durable-objects/HookIdDO.ts","../src/worker/durable-objects/HookTokenDO.ts","../src/worker/durable-objects/RunCatalogDO.ts","../src/worker/durable-objects/StreamDO.ts","../src/worker/durable-objects/WorkflowRunDO.ts","../src/worker/worker.ts"],"mappings":"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"}
|