@restatedev/restate-sdk 0.7.3-worker → 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/LICENSE +1 -1
- package/README.md +29 -51
- package/dist/clients/workflow_client.d.ts +77 -0
- package/dist/clients/workflow_client.d.ts.map +1 -0
- package/dist/clients/workflow_client.js +172 -0
- package/dist/clients/workflow_client.js.map +1 -0
- package/dist/connection/buffered_connection.js +44 -0
- package/dist/connection/buffered_connection.js.map +1 -0
- package/dist/connection/connection.js +13 -0
- package/dist/connection/connection.js.map +1 -0
- package/dist/connection/embedded_connection.js +59 -0
- package/dist/connection/embedded_connection.js.map +1 -0
- package/dist/connection/http_connection.js +203 -0
- package/dist/connection/http_connection.js.map +1 -0
- package/dist/connection/lambda_connection.js +58 -0
- package/dist/connection/lambda_connection.js.map +1 -0
- package/dist/{restate_context.d.ts → context.d.ts} +239 -170
- package/dist/context.d.ts.map +1 -0
- package/dist/context.js +113 -0
- package/dist/context.js.map +1 -0
- package/dist/{restate_context_impl.d.ts → context_impl.d.ts} +26 -30
- package/dist/context_impl.d.ts.map +1 -0
- package/dist/context_impl.js +439 -0
- package/dist/context_impl.js.map +1 -0
- package/dist/embedded/api.d.ts +2 -2
- package/dist/embedded/api.d.ts.map +1 -1
- package/dist/embedded/api.js +35 -0
- package/dist/embedded/api.js.map +1 -0
- package/dist/embedded/handler.d.ts +2 -2
- package/dist/embedded/handler.d.ts.map +1 -1
- package/dist/embedded/handler.js +26 -0
- package/dist/embedded/handler.js.map +1 -0
- package/dist/embedded/http2_remote.js +91 -0
- package/dist/embedded/http2_remote.js.map +1 -0
- package/dist/embedded/invocation.d.ts.map +1 -1
- package/dist/embedded/invocation.js +94 -0
- package/dist/embedded/invocation.js.map +1 -0
- package/dist/endpoint/endpoint_impl.d.ts +35 -0
- package/dist/endpoint/endpoint_impl.d.ts.map +1 -0
- package/dist/endpoint/endpoint_impl.js +405 -0
- package/dist/endpoint/endpoint_impl.js.map +1 -0
- package/dist/endpoint/http2_handler.d.ts +11 -0
- package/dist/endpoint/http2_handler.d.ts.map +1 -0
- package/dist/endpoint/http2_handler.js +119 -0
- package/dist/endpoint/http2_handler.js.map +1 -0
- package/dist/endpoint/lambda_handler.d.ts +15 -0
- package/dist/endpoint/lambda_handler.d.ts.map +1 -0
- package/dist/endpoint/lambda_handler.js +144 -0
- package/dist/endpoint/lambda_handler.js.map +1 -0
- package/dist/endpoint.d.ts +161 -0
- package/dist/endpoint.d.ts.map +1 -0
- package/dist/endpoint.js +22 -0
- package/dist/endpoint.js.map +1 -0
- package/dist/generated/dev/restate/events.js +371 -0
- package/dist/generated/dev/restate/events.js.map +1 -0
- package/dist/generated/dev/restate/ext.js +215 -0
- package/dist/generated/dev/restate/ext.js.map +1 -0
- package/dist/generated/google/protobuf/descriptor.js +6676 -0
- package/dist/generated/google/protobuf/descriptor.js.map +1 -0
- package/dist/generated/google/protobuf/empty.js +107 -0
- package/dist/generated/google/protobuf/empty.js.map +1 -0
- package/dist/generated/google/protobuf/struct.js +754 -0
- package/dist/generated/google/protobuf/struct.js.map +1 -0
- package/dist/generated/proto/discovery.js +364 -0
- package/dist/generated/proto/discovery.js.map +1 -0
- package/dist/generated/proto/dynrpc.js +668 -0
- package/dist/generated/proto/dynrpc.js.map +1 -0
- package/dist/generated/proto/javascript.d.ts +13 -0
- package/dist/generated/proto/javascript.d.ts.map +1 -1
- package/dist/generated/proto/javascript.js +416 -0
- package/dist/generated/proto/javascript.js.map +1 -0
- package/dist/generated/proto/protocol.d.ts +43 -0
- package/dist/generated/proto/protocol.d.ts.map +1 -1
- package/dist/generated/proto/protocol.js +2641 -0
- package/dist/generated/proto/protocol.js.map +1 -0
- package/dist/generated/proto/services.js +1535 -0
- package/dist/generated/proto/services.js.map +1 -0
- package/dist/generated/proto/test.js +321 -0
- package/dist/generated/proto/test.js.map +1 -0
- package/dist/invocation.d.ts +4 -1
- package/dist/invocation.d.ts.map +1 -1
- package/dist/invocation.js +157 -0
- package/dist/invocation.js.map +1 -0
- package/dist/io/decoder.d.ts +1 -0
- package/dist/io/decoder.d.ts.map +1 -1
- package/dist/io/decoder.js +140 -0
- package/dist/io/decoder.js.map +1 -0
- package/dist/io/encoder.d.ts +1 -2
- package/dist/io/encoder.d.ts.map +1 -1
- package/dist/io/encoder.js +68 -0
- package/dist/io/encoder.js.map +1 -0
- package/dist/journal.d.ts +13 -4
- package/dist/journal.d.ts.map +1 -1
- package/dist/journal.js +405 -0
- package/dist/journal.js.map +1 -0
- package/dist/local_state_store.d.ts +5 -3
- package/dist/local_state_store.d.ts.map +1 -1
- package/dist/local_state_store.js +82 -0
- package/dist/local_state_store.js.map +1 -0
- package/dist/logger.d.ts +19 -0
- package/dist/logger.d.ts.map +1 -0
- package/dist/logger.js +90 -0
- package/dist/logger.js.map +1 -0
- package/dist/promise_combinator_tracker.d.ts +29 -0
- package/dist/promise_combinator_tracker.d.ts.map +1 -0
- package/dist/promise_combinator_tracker.js +128 -0
- package/dist/promise_combinator_tracker.js.map +1 -0
- package/dist/public_api.d.ts +5 -5
- package/dist/public_api.d.ts.map +1 -1
- package/dist/public_api.js +60 -0
- package/dist/public_api.js.map +1 -0
- package/dist/state_machine.d.ts +19 -12
- package/dist/state_machine.d.ts.map +1 -1
- package/dist/state_machine.js +437 -0
- package/dist/state_machine.js.map +1 -0
- package/dist/types/errors.d.ts +12 -3
- package/dist/types/errors.d.ts.map +1 -1
- package/dist/types/errors.js +273 -0
- package/dist/types/errors.js.map +1 -0
- package/dist/types/grpc.d.ts +6 -4
- package/dist/types/grpc.d.ts.map +1 -1
- package/dist/types/grpc.js +81 -0
- package/dist/types/grpc.js.map +1 -0
- package/dist/types/protocol.d.ts +9 -5
- package/dist/types/protocol.d.ts.map +1 -1
- package/dist/types/protocol.js +147 -0
- package/dist/types/protocol.js.map +1 -0
- package/dist/types/router.d.ts +8 -8
- package/dist/types/router.d.ts.map +1 -1
- package/dist/types/router.js +36 -0
- package/dist/types/router.js.map +1 -0
- package/dist/types/types.d.ts +1 -0
- package/dist/types/types.d.ts.map +1 -1
- package/dist/types/types.js +138 -0
- package/dist/types/types.js.map +1 -0
- package/dist/utils/{assumpsions.d.ts → assumptions.d.ts} +1 -1
- package/dist/utils/{assumpsions.d.ts.map → assumptions.d.ts.map} +1 -1
- package/dist/utils/assumptions.js +101 -0
- package/dist/utils/assumptions.js.map +1 -0
- package/dist/utils/message_logger.d.ts +28 -0
- package/dist/utils/message_logger.d.ts.map +1 -0
- package/dist/utils/message_logger.js +88 -0
- package/dist/utils/message_logger.js.map +1 -0
- package/dist/utils/promises.d.ts +15 -0
- package/dist/utils/promises.d.ts.map +1 -0
- package/dist/utils/promises.js +67 -0
- package/dist/utils/promises.js.map +1 -0
- package/dist/utils/public_utils.js +49 -0
- package/dist/utils/public_utils.js.map +1 -0
- package/dist/utils/rand.d.ts +1 -1
- package/dist/utils/rand.d.ts.map +1 -1
- package/dist/utils/rand.js +114 -0
- package/dist/utils/rand.js.map +1 -0
- package/dist/utils/utils.d.ts +1 -10
- package/dist/utils/utils.d.ts.map +1 -1
- package/dist/utils/utils.js +122 -0
- package/dist/utils/utils.js.map +1 -0
- package/dist/workflows/workflow.d.ts +101 -0
- package/dist/workflows/workflow.d.ts.map +1 -0
- package/dist/workflows/workflow.js +80 -0
- package/dist/workflows/workflow.js.map +1 -0
- package/dist/workflows/workflow_state_service.d.ts +35 -0
- package/dist/workflows/workflow_state_service.d.ts.map +1 -0
- package/dist/workflows/workflow_state_service.js +201 -0
- package/dist/workflows/workflow_state_service.js.map +1 -0
- package/dist/workflows/workflow_wrapper_service.d.ts +10 -0
- package/dist/workflows/workflow_wrapper_service.d.ts.map +1 -0
- package/dist/workflows/workflow_wrapper_service.js +264 -0
- package/dist/workflows/workflow_wrapper_service.js.map +1 -0
- package/package.json +38 -39
- package/src/clients/workflow_client.ts +290 -0
- package/src/connection/buffered_connection.ts +47 -0
- package/src/connection/connection.ts +34 -0
- package/src/connection/embedded_connection.ts +62 -0
- package/src/connection/http_connection.ts +228 -0
- package/src/connection/lambda_connection.ts +69 -0
- package/src/context.ts +633 -0
- package/src/context_impl.ts +721 -0
- package/src/embedded/api.ts +57 -0
- package/src/embedded/handler.ts +36 -0
- package/src/embedded/http2_remote.ts +103 -0
- package/src/embedded/invocation.ts +126 -0
- package/src/endpoint/endpoint_impl.ts +623 -0
- package/src/endpoint/http2_handler.ts +151 -0
- package/src/endpoint/lambda_handler.ts +181 -0
- package/src/endpoint.ts +187 -0
- package/src/generated/dev/restate/events.ts +430 -0
- package/src/generated/dev/restate/ext.ts +238 -0
- package/src/generated/google/protobuf/descriptor.ts +7889 -0
- package/src/generated/google/protobuf/empty.ts +150 -0
- package/src/generated/google/protobuf/struct.ts +878 -0
- package/src/generated/proto/discovery.ts +423 -0
- package/src/generated/proto/dynrpc.ts +768 -0
- package/src/generated/proto/javascript.ts +488 -0
- package/src/generated/proto/protocol.ts +3091 -0
- package/src/generated/proto/services.ts +1834 -0
- package/src/generated/proto/test.ts +387 -0
- package/src/invocation.ts +212 -0
- package/src/io/decoder.ts +171 -0
- package/src/io/encoder.ts +72 -0
- package/src/journal.ts +537 -0
- package/src/local_state_store.ts +94 -0
- package/src/logger.ts +121 -0
- package/src/promise_combinator_tracker.ts +191 -0
- package/src/public_api.ts +53 -0
- package/src/state_machine.ts +635 -0
- package/src/types/errors.ts +297 -0
- package/src/types/grpc.ts +97 -0
- package/src/types/protocol.ts +201 -0
- package/src/types/router.ts +118 -0
- package/src/types/types.ts +160 -0
- package/src/utils/assumptions.ts +131 -0
- package/src/utils/message_logger.ts +112 -0
- package/src/utils/promises.ts +118 -0
- package/src/utils/public_utils.ts +91 -0
- package/src/utils/rand.ts +142 -0
- package/src/utils/utils.ts +178 -0
- package/src/workflows/workflow.ts +178 -0
- package/src/workflows/workflow_state_service.ts +299 -0
- package/src/workflows/workflow_wrapper_service.ts +314 -0
- package/dist/cloudflare_bundle.js +0 -27387
- package/dist/restate_context.d.ts.map +0 -1
- package/dist/restate_context_impl.d.ts.map +0 -1
- package/dist/server/base_restate_server.d.ts +0 -32
- package/dist/server/base_restate_server.d.ts.map +0 -1
- package/dist/server/restate_lambda_handler.d.ts +0 -104
- package/dist/server/restate_lambda_handler.d.ts.map +0 -1
- package/dist/server/restate_server.d.ts +0 -97
- package/dist/server/restate_server.d.ts.map +0 -1
- package/dist/utils/logger.d.ts +0 -60
- package/dist/utils/logger.d.ts.map +0 -1
|
@@ -0,0 +1,437 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/*
|
|
3
|
+
* Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH
|
|
4
|
+
*
|
|
5
|
+
* This file is part of the Restate SDK for Node.js/TypeScript,
|
|
6
|
+
* which is released under the MIT license.
|
|
7
|
+
*
|
|
8
|
+
* You can find a copy of the license in file LICENSE in the root
|
|
9
|
+
* directory of this repository or package, or at
|
|
10
|
+
* https://github.com/restatedev/sdk-typescript/blob/main/LICENSE
|
|
11
|
+
*/
|
|
12
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
13
|
+
if (k2 === undefined) k2 = k;
|
|
14
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
15
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
16
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
17
|
+
}
|
|
18
|
+
Object.defineProperty(o, k2, desc);
|
|
19
|
+
}) : (function(o, m, k, k2) {
|
|
20
|
+
if (k2 === undefined) k2 = k;
|
|
21
|
+
o[k2] = m[k];
|
|
22
|
+
}));
|
|
23
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
24
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
25
|
+
}) : function(o, v) {
|
|
26
|
+
o["default"] = v;
|
|
27
|
+
});
|
|
28
|
+
var __importStar = (this && this.__importStar) || function (mod) {
|
|
29
|
+
if (mod && mod.__esModule) return mod;
|
|
30
|
+
var result = {};
|
|
31
|
+
if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
|
|
32
|
+
__setModuleDefault(result, mod);
|
|
33
|
+
return result;
|
|
34
|
+
};
|
|
35
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
|
+
exports.StateMachine = void 0;
|
|
37
|
+
const p = __importStar(require("./types/protocol"));
|
|
38
|
+
const context_impl_1 = require("./context_impl");
|
|
39
|
+
const discovery_1 = require("./generated/proto/discovery");
|
|
40
|
+
const types_1 = require("./types/types");
|
|
41
|
+
const message_logger_1 = require("./utils/message_logger");
|
|
42
|
+
const timers_1 = require("timers");
|
|
43
|
+
const protocol_1 = require("./types/protocol");
|
|
44
|
+
const journal_1 = require("./journal");
|
|
45
|
+
const errors_1 = require("./types/errors");
|
|
46
|
+
const logger_1 = require("./logger");
|
|
47
|
+
const promises_1 = require("./utils/promises");
|
|
48
|
+
const promise_combinator_tracker_1 = require("./promise_combinator_tracker");
|
|
49
|
+
class StateMachine {
|
|
50
|
+
connection;
|
|
51
|
+
invocation;
|
|
52
|
+
protocolMode;
|
|
53
|
+
suspensionMillis;
|
|
54
|
+
journal;
|
|
55
|
+
restateContext;
|
|
56
|
+
invocationComplete = new promises_1.CompletablePromise();
|
|
57
|
+
// when this flag is true, no more work will (and may) happen
|
|
58
|
+
// this is set to true in case of
|
|
59
|
+
// - a completed invocation
|
|
60
|
+
// - a suspension
|
|
61
|
+
// - an error in the state machine
|
|
62
|
+
stateMachineClosed = false;
|
|
63
|
+
localStateStore;
|
|
64
|
+
// Whether the input channel (runtime -> service) is closed
|
|
65
|
+
// If it is closed, then we suspend immediately upon the next suspension point
|
|
66
|
+
// If it is open, then we suspend later because we might still get completions
|
|
67
|
+
inputChannelClosed = false;
|
|
68
|
+
// Suspension timeout that gets set and cleared based on completion messages;
|
|
69
|
+
suspensionTimeout;
|
|
70
|
+
promiseCombinatorTracker;
|
|
71
|
+
console;
|
|
72
|
+
constructor(connection, invocation, protocolMode, keyedContext, loggerContext, suspensionMillis = 30_000) {
|
|
73
|
+
this.connection = connection;
|
|
74
|
+
this.invocation = invocation;
|
|
75
|
+
this.protocolMode = protocolMode;
|
|
76
|
+
this.suspensionMillis = suspensionMillis;
|
|
77
|
+
this.localStateStore = invocation.localStateStore;
|
|
78
|
+
this.console = (0, message_logger_1.createStateMachineConsole)(loggerContext);
|
|
79
|
+
this.restateContext = new context_impl_1.ContextImpl(this.invocation.id, this.invocation.method.service,
|
|
80
|
+
// The console exposed by RestateContext filters logs in replay, while the internal one is based on the ENV variables.
|
|
81
|
+
(0, logger_1.createRestateConsole)(loggerContext, () => !this.journal.isReplaying()), keyedContext, this);
|
|
82
|
+
this.journal = new journal_1.Journal(this.invocation);
|
|
83
|
+
this.promiseCombinatorTracker = new promise_combinator_tracker_1.PromiseCombinatorTracker(this.readCombinatorOrderEntry.bind(this), this.writeCombinatorOrderEntry.bind(this));
|
|
84
|
+
}
|
|
85
|
+
handleMessage(m) {
|
|
86
|
+
if (this.stateMachineClosed) {
|
|
87
|
+
// ignore this message
|
|
88
|
+
return false;
|
|
89
|
+
}
|
|
90
|
+
if (m.messageType === protocol_1.COMPLETION_MESSAGE_TYPE) {
|
|
91
|
+
this.console.debugJournalMessage("Received completion message from Restate, adding to journal.", m.messageType, m.message);
|
|
92
|
+
this.journal.handleRuntimeCompletionMessage(m.message);
|
|
93
|
+
}
|
|
94
|
+
else if (m.messageType === protocol_1.ENTRY_ACK_MESSAGE_TYPE) {
|
|
95
|
+
this.console.debugJournalMessage("Received entry ack message from Restate, adding to journal.", m.messageType, m.message);
|
|
96
|
+
this.journal.handleEntryAckMessage(m.message);
|
|
97
|
+
}
|
|
98
|
+
else {
|
|
99
|
+
throw errors_1.RetryableError.protocolViolation(`Received message of type ${m.messageType}. Can only accept completion or acks messages after replay has finished.`);
|
|
100
|
+
}
|
|
101
|
+
// Remove lingering suspension timeouts, if we are not waiting for completions anymore
|
|
102
|
+
if (this.suspensionTimeout !== undefined &&
|
|
103
|
+
this.journal.getCompletableIndices().length === 0) {
|
|
104
|
+
(0, timers_1.clearTimeout)(this.suspensionTimeout);
|
|
105
|
+
this.suspensionTimeout = undefined;
|
|
106
|
+
}
|
|
107
|
+
return false; // we are never complete
|
|
108
|
+
}
|
|
109
|
+
handleUserCodeMessage(messageType, message, completedFlag, protocolVersion, requiresAckFlag) {
|
|
110
|
+
// if the state machine is already closed, return a promise that never
|
|
111
|
+
// completes, so that the user code does not resume
|
|
112
|
+
if (this.stateMachineClosed) {
|
|
113
|
+
return promises_1.WRAPPED_PROMISE_PENDING;
|
|
114
|
+
}
|
|
115
|
+
const promise = this.journal.handleUserSideMessage(messageType, message);
|
|
116
|
+
const journalIndex = this.journal.getUserCodeJournalIndex();
|
|
117
|
+
// Only send the message to restate if we are not in replaying mode
|
|
118
|
+
if (this.journal.isProcessing()) {
|
|
119
|
+
this.console.debugJournalMessage("Adding message to journal and sending to Restate", messageType, message);
|
|
120
|
+
this.send(new types_1.Message(messageType, message, completedFlag, protocolVersion, requiresAckFlag));
|
|
121
|
+
}
|
|
122
|
+
else {
|
|
123
|
+
this.console.debugJournalMessage("Matched and replayed message from journal", messageType, message);
|
|
124
|
+
}
|
|
125
|
+
return (0, promises_1.wrapDeeply)(promise, () => {
|
|
126
|
+
if (!p.SUSPENSION_TRIGGERS.includes(messageType)) {
|
|
127
|
+
return;
|
|
128
|
+
}
|
|
129
|
+
if (this.journal.isUnResolved(journalIndex)) {
|
|
130
|
+
this.hitSuspensionPoint();
|
|
131
|
+
}
|
|
132
|
+
});
|
|
133
|
+
}
|
|
134
|
+
// -- Methods related to combinators to wire up promise combinator API with PromiseCombinatorTracker
|
|
135
|
+
createCombinator(combinatorConstructor, promises) {
|
|
136
|
+
if (this.stateMachineClosed) {
|
|
137
|
+
return promises_1.WRAPPED_PROMISE_PENDING;
|
|
138
|
+
}
|
|
139
|
+
// We don't need the promise wrapping here to schedule a suspension,
|
|
140
|
+
// because the combined promises will already have that, so once we call then() on them,
|
|
141
|
+
// if we have to suspend we will suspend.
|
|
142
|
+
return this.promiseCombinatorTracker.createCombinator(combinatorConstructor, promises);
|
|
143
|
+
}
|
|
144
|
+
readCombinatorOrderEntry(combinatorId) {
|
|
145
|
+
const wannabeCombinatorEntry = this.journal.readNextReplayEntry();
|
|
146
|
+
if (wannabeCombinatorEntry === undefined) {
|
|
147
|
+
// We're in processing mode
|
|
148
|
+
return undefined;
|
|
149
|
+
}
|
|
150
|
+
if (wannabeCombinatorEntry.messageType !== protocol_1.COMBINATOR_ENTRY_MESSAGE) {
|
|
151
|
+
throw errors_1.RetryableError.journalMismatch(this.journal.getUserCodeJournalIndex(), wannabeCombinatorEntry, {
|
|
152
|
+
messageType: protocol_1.COMBINATOR_ENTRY_MESSAGE,
|
|
153
|
+
message: {
|
|
154
|
+
combinatorId,
|
|
155
|
+
},
|
|
156
|
+
});
|
|
157
|
+
}
|
|
158
|
+
const combinatorMessage = wannabeCombinatorEntry.message;
|
|
159
|
+
if (combinatorMessage.combinatorId != combinatorId) {
|
|
160
|
+
throw errors_1.RetryableError.journalMismatch(this.journal.getUserCodeJournalIndex(), wannabeCombinatorEntry, {
|
|
161
|
+
messageType: protocol_1.COMBINATOR_ENTRY_MESSAGE,
|
|
162
|
+
message: {
|
|
163
|
+
combinatorId,
|
|
164
|
+
},
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
this.console.debugJournalMessage("Matched and replayed message from journal", protocol_1.COMBINATOR_ENTRY_MESSAGE, combinatorMessage);
|
|
168
|
+
return combinatorMessage.journalEntriesOrder.map((id) => ({
|
|
169
|
+
id,
|
|
170
|
+
type: promise_combinator_tracker_1.PromiseType.JournalEntry,
|
|
171
|
+
}));
|
|
172
|
+
}
|
|
173
|
+
async writeCombinatorOrderEntry(combinatorId, order) {
|
|
174
|
+
if (this.journal.isProcessing()) {
|
|
175
|
+
const combinatorMessage = {
|
|
176
|
+
combinatorId,
|
|
177
|
+
journalEntriesOrder: order.map((pid) => pid.id),
|
|
178
|
+
};
|
|
179
|
+
this.console.debugJournalMessage("Adding message to journal and sending to Restate", protocol_1.COMBINATOR_ENTRY_MESSAGE, combinatorMessage);
|
|
180
|
+
const ackPromise = this.journal.appendJournalEntry(protocol_1.COMBINATOR_ENTRY_MESSAGE, combinatorMessage);
|
|
181
|
+
this.send(new types_1.Message(protocol_1.COMBINATOR_ENTRY_MESSAGE, combinatorMessage, undefined, undefined, true));
|
|
182
|
+
this.hitSuspensionPoint();
|
|
183
|
+
await ackPromise;
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
/**
|
|
187
|
+
* Invokes the RPC function and returns a promise that completes when the state machine
|
|
188
|
+
* stops processing the invocation, meaning when:
|
|
189
|
+
* - The function completes with a result or an exception
|
|
190
|
+
* - The execution suspends
|
|
191
|
+
* - An error is raised in the state machine (network, API violation, ...)
|
|
192
|
+
*
|
|
193
|
+
* The returned promise resolves successfully for all the cases above, because the are (from
|
|
194
|
+
* the perspective of the state machine) expected outcomes in which it send out corresponding
|
|
195
|
+
* result messages and cleanly closed the connection.
|
|
196
|
+
*
|
|
197
|
+
* The returned promise is rejected when an unhandled error arises and the caller would be
|
|
198
|
+
* expected to ensure that resources are properly cleaned up.
|
|
199
|
+
*/
|
|
200
|
+
invoke() {
|
|
201
|
+
// --------------------------------------------------------------------------------------------
|
|
202
|
+
// Implementation note:
|
|
203
|
+
//
|
|
204
|
+
// This method is not async, because we don't want to actually await anything
|
|
205
|
+
// in there. We cannot await the completion of the actual invocation, because for long-running
|
|
206
|
+
// code (that suspends), the function invocation never completes. Instead, the state machine
|
|
207
|
+
// triggers a suspension.
|
|
208
|
+
// We need to do a bit of promise chaining for the rpc function promise, and return a different
|
|
209
|
+
// promise that completes in also in suspension and error cases.
|
|
210
|
+
// --------------------------------------------------------------------------------------------
|
|
211
|
+
// it is unexpected for the state machine to be closed here, so we raise an error in
|
|
212
|
+
// that case, unlike in other places, where we simply ignore things
|
|
213
|
+
if (this.stateMachineClosed) {
|
|
214
|
+
return Promise.reject(new Error("state machine is already closed"));
|
|
215
|
+
}
|
|
216
|
+
if (this.journal.nextEntryWillBeReplayed()) {
|
|
217
|
+
this.console.debugInvokeMessage("Resuming (replaying) function.");
|
|
218
|
+
}
|
|
219
|
+
else {
|
|
220
|
+
this.console.debugInvokeMessage("Invoking function.");
|
|
221
|
+
}
|
|
222
|
+
let resultBytes;
|
|
223
|
+
switch (this.invocation.invocationValue.kind) {
|
|
224
|
+
case "value":
|
|
225
|
+
resultBytes = this.invocation.method.invoke(this.restateContext, this.invocation.invocationValue.value);
|
|
226
|
+
break;
|
|
227
|
+
case "failure":
|
|
228
|
+
resultBytes = Promise.reject((0, errors_1.failureToTerminalError)(this.invocation.invocationValue.failure));
|
|
229
|
+
break;
|
|
230
|
+
}
|
|
231
|
+
resultBytes
|
|
232
|
+
.then((bytes) => {
|
|
233
|
+
// invocation successfully returned with a result value
|
|
234
|
+
try {
|
|
235
|
+
// the state machine might be closed here in some cases like when there was an error (like
|
|
236
|
+
// API violation) or a suspension, but the function code still completed
|
|
237
|
+
if (this.stateMachineClosed) {
|
|
238
|
+
this.console.warn("Unexpected successful completion of the function after the state machine closed. " +
|
|
239
|
+
"This may indicate that: \n" +
|
|
240
|
+
"- the function code does not properly await some Restate calls " +
|
|
241
|
+
"and did not notice an error \n" +
|
|
242
|
+
"- the function code was delayed for longer than the suspension timeout \n" +
|
|
243
|
+
"- the function code contained a try-catch block around a side effect which throws retryable errors. " +
|
|
244
|
+
"This try-catch block should be placed inside the side effect.");
|
|
245
|
+
return;
|
|
246
|
+
}
|
|
247
|
+
const value = Buffer.from(bytes);
|
|
248
|
+
// handle the result value
|
|
249
|
+
const msg = new types_1.Message(protocol_1.OUTPUT_STREAM_ENTRY_MESSAGE_TYPE, protocol_1.OutputStreamEntryMessage.create({
|
|
250
|
+
value,
|
|
251
|
+
}));
|
|
252
|
+
this.journal.handleUserSideMessage(msg.messageType, msg.message);
|
|
253
|
+
if (!this.journal.outputMsgWasReplayed()) {
|
|
254
|
+
this.send(msg);
|
|
255
|
+
this.console.debugJournalMessage("Journaled and sent output message", msg.messageType, msg.message);
|
|
256
|
+
}
|
|
257
|
+
else {
|
|
258
|
+
this.console.debugJournalMessage("Replayed and matched output message from journal", msg.messageType, msg.message);
|
|
259
|
+
}
|
|
260
|
+
this.console.debugInvokeMessage("Function completed successfully.");
|
|
261
|
+
// Mark the end of the invocation
|
|
262
|
+
this.send(new types_1.Message(protocol_1.END_MESSAGE_TYPE, protocol_1.EndMessage.create()));
|
|
263
|
+
this.finish(value);
|
|
264
|
+
}
|
|
265
|
+
catch (e) {
|
|
266
|
+
this.unhandledError((0, errors_1.ensureError)(e));
|
|
267
|
+
}
|
|
268
|
+
})
|
|
269
|
+
.catch((e) => {
|
|
270
|
+
// because of how we try/catch in the promise handler above, this here exclusively handles
|
|
271
|
+
// errors coming from the rpc function
|
|
272
|
+
try {
|
|
273
|
+
// Sometimes the function code fails as a consequence of the state machine encountering
|
|
274
|
+
// an error before (possibly Restate closed the connection).
|
|
275
|
+
if (this.stateMachineClosed) {
|
|
276
|
+
return;
|
|
277
|
+
}
|
|
278
|
+
const error = (0, errors_1.ensureError)(e);
|
|
279
|
+
this.console.trace("Function completed with an error: " + error.message, e);
|
|
280
|
+
this.sendErrorAndFinish(error);
|
|
281
|
+
}
|
|
282
|
+
catch (ee) {
|
|
283
|
+
this.unhandledError((0, errors_1.ensureError)(ee));
|
|
284
|
+
}
|
|
285
|
+
});
|
|
286
|
+
// this promise here completes under any completion, including the cases where the
|
|
287
|
+
// rpc function does not end (error, suspension, ...)
|
|
288
|
+
return this.invocationComplete.promise;
|
|
289
|
+
}
|
|
290
|
+
async sendErrorAndFinish(e) {
|
|
291
|
+
if (e instanceof errors_1.TerminalError) {
|
|
292
|
+
this.sendTerminalError(e);
|
|
293
|
+
}
|
|
294
|
+
else {
|
|
295
|
+
this.sendRetryableError(e);
|
|
296
|
+
}
|
|
297
|
+
await this.finish();
|
|
298
|
+
}
|
|
299
|
+
sendRetryableError(e) {
|
|
300
|
+
const msg = new types_1.Message(protocol_1.ERROR_MESSAGE_TYPE, (0, errors_1.errorToErrorMessage)(e));
|
|
301
|
+
this.console.debugJournalMessage("Invocation ended with retryable error.", msg.messageType, msg.message);
|
|
302
|
+
this.send(msg);
|
|
303
|
+
}
|
|
304
|
+
sendTerminalError(e) {
|
|
305
|
+
const msg = new types_1.Message(protocol_1.OUTPUT_STREAM_ENTRY_MESSAGE_TYPE, protocol_1.OutputStreamEntryMessage.create({
|
|
306
|
+
failure: e.toFailure(),
|
|
307
|
+
}));
|
|
308
|
+
this.console.debugJournalMessage("Invocation ended with failure message.", msg.messageType, msg.message);
|
|
309
|
+
this.journal.handleUserSideMessage(msg.messageType, msg.message);
|
|
310
|
+
if (!this.journal.outputMsgWasReplayed()) {
|
|
311
|
+
this.send(msg);
|
|
312
|
+
}
|
|
313
|
+
// Mark the end of the invocation
|
|
314
|
+
this.send(new types_1.Message(protocol_1.END_MESSAGE_TYPE, protocol_1.EndMessage.create()));
|
|
315
|
+
}
|
|
316
|
+
send(message) {
|
|
317
|
+
this.connection.send(message).catch((err) => {
|
|
318
|
+
this.handleStreamError(err);
|
|
319
|
+
});
|
|
320
|
+
}
|
|
321
|
+
/**
|
|
322
|
+
* Closes the state machine, flushes all output, and resolves the invocation promise.
|
|
323
|
+
*/
|
|
324
|
+
async finish(value) {
|
|
325
|
+
try {
|
|
326
|
+
this.stateMachineClosed = true;
|
|
327
|
+
this.journal.close();
|
|
328
|
+
this.clearSuspensionTimeout();
|
|
329
|
+
await this.connection.end();
|
|
330
|
+
this.invocationComplete.resolve(value);
|
|
331
|
+
}
|
|
332
|
+
catch (e) {
|
|
333
|
+
this.invocationComplete.reject((0, errors_1.ensureError)(e));
|
|
334
|
+
}
|
|
335
|
+
}
|
|
336
|
+
/**
|
|
337
|
+
* This function propagates errors up to the completion promise, to be handled
|
|
338
|
+
* on the connection layer.
|
|
339
|
+
*/
|
|
340
|
+
unhandledError(e) {
|
|
341
|
+
this.invocationComplete.reject(e);
|
|
342
|
+
this.stateMachineClosed = true;
|
|
343
|
+
this.journal.close();
|
|
344
|
+
this.clearSuspensionTimeout();
|
|
345
|
+
}
|
|
346
|
+
/**
|
|
347
|
+
* This method is invoked when we hit a suspension point. A suspension point is everytime the user "await"s a Promise returned by RestateContext that might be completed at a later point in time by a CompletionMessage/AckMessage.
|
|
348
|
+
*
|
|
349
|
+
* Depending on the state of the read channel, and on the protocol mode, it might either immediately suspend, or schedule a suspension to happen at a later point in time.
|
|
350
|
+
*/
|
|
351
|
+
hitSuspensionPoint() {
|
|
352
|
+
// If there was already a timeout set, we want to reset the time to postpone suspension as long as we make progress.
|
|
353
|
+
// So we first clear the old timeout, and then we set a new one.
|
|
354
|
+
this.clearSuspensionTimeout();
|
|
355
|
+
const delay = this.getSuspensionMillis();
|
|
356
|
+
this.console.debugJournalMessage("Scheduling suspension in " + delay + " ms");
|
|
357
|
+
if (delay >= 0) {
|
|
358
|
+
// Set a new suspension with a new timeout
|
|
359
|
+
// The suspension will only be sent if the timeout is not canceled due to a completion.
|
|
360
|
+
// In case the delay is 0 we still schedule a timeout in order to process the suspension on the next process tick,
|
|
361
|
+
// without interrupting the current work.
|
|
362
|
+
this.suspensionTimeout = setTimeout(() => {
|
|
363
|
+
this.suspend();
|
|
364
|
+
}, delay);
|
|
365
|
+
}
|
|
366
|
+
}
|
|
367
|
+
// Suspension timeouts:
|
|
368
|
+
// Lambda case: suspend immediately when control is back in the user code
|
|
369
|
+
// Bidi streaming case:
|
|
370
|
+
// - suspend after 1 seconds if input channel is still open (can still get completions)
|
|
371
|
+
// - suspend immediately if input channel is closed (cannot get completions)
|
|
372
|
+
getSuspensionMillis() {
|
|
373
|
+
return this.protocolMode === discovery_1.ProtocolMode.REQUEST_RESPONSE ||
|
|
374
|
+
this.inputChannelClosed
|
|
375
|
+
? 0
|
|
376
|
+
: this.suspensionMillis;
|
|
377
|
+
}
|
|
378
|
+
async suspend() {
|
|
379
|
+
const indices = this.journal.getCompletableIndices();
|
|
380
|
+
// If the state is closed then we either already send a suspension
|
|
381
|
+
// or something else bad happened...
|
|
382
|
+
if (this.journal.isClosed() || indices.length === 0) {
|
|
383
|
+
return;
|
|
384
|
+
}
|
|
385
|
+
// There need to be journal entries to complete, otherwise this timeout should have been removed.
|
|
386
|
+
// A suspension message is the end of the invocation.
|
|
387
|
+
// Resolve the root call with the suspension message
|
|
388
|
+
// This will lead to a onCallSuccess call where this msg will be sent.
|
|
389
|
+
const msg = new types_1.Message(protocol_1.SUSPENSION_MESSAGE_TYPE, protocol_1.SuspensionMessage.create({
|
|
390
|
+
entryIndexes: indices,
|
|
391
|
+
}));
|
|
392
|
+
this.console.debugJournalMessage("Writing suspension message to journal.", msg.messageType, msg.message);
|
|
393
|
+
this.journal.handleUserSideMessage(msg.messageType, msg.message);
|
|
394
|
+
if (!this.journal.outputMsgWasReplayed()) {
|
|
395
|
+
this.send(msg);
|
|
396
|
+
}
|
|
397
|
+
this.console.debugInvokeMessage("Suspending function.");
|
|
398
|
+
await this.finish();
|
|
399
|
+
}
|
|
400
|
+
/**
|
|
401
|
+
* WARNING: make sure you use this at the right point in the code
|
|
402
|
+
* After the index has been incremented...
|
|
403
|
+
* This is error-prone... Would be good to have a better solution for this.
|
|
404
|
+
*/
|
|
405
|
+
getUserCodeJournalIndex() {
|
|
406
|
+
return this.journal.getUserCodeJournalIndex();
|
|
407
|
+
}
|
|
408
|
+
handleInputClosed() {
|
|
409
|
+
if (this.journal.isClosed() ||
|
|
410
|
+
this.stateMachineClosed ||
|
|
411
|
+
this.inputChannelClosed) {
|
|
412
|
+
return;
|
|
413
|
+
}
|
|
414
|
+
this.inputChannelClosed = true;
|
|
415
|
+
this.console.debug("Restate closed connection to trigger suspension.");
|
|
416
|
+
// If there is a timeout planned, reset the timout to execute immediately when the work is done.
|
|
417
|
+
if (this.suspensionTimeout !== undefined) {
|
|
418
|
+
this.hitSuspensionPoint();
|
|
419
|
+
}
|
|
420
|
+
}
|
|
421
|
+
handleStreamError(e) {
|
|
422
|
+
this.console.info("Aborting function execution and closing state machine due to connection error: " +
|
|
423
|
+
e.message);
|
|
424
|
+
this.unhandledError(e);
|
|
425
|
+
}
|
|
426
|
+
nextEntryWillBeReplayed() {
|
|
427
|
+
return this.journal.nextEntryWillBeReplayed();
|
|
428
|
+
}
|
|
429
|
+
clearSuspensionTimeout() {
|
|
430
|
+
if (this.suspensionTimeout !== undefined) {
|
|
431
|
+
(0, timers_1.clearTimeout)(this.suspensionTimeout);
|
|
432
|
+
this.suspensionTimeout = undefined;
|
|
433
|
+
}
|
|
434
|
+
}
|
|
435
|
+
}
|
|
436
|
+
exports.StateMachine = StateMachine;
|
|
437
|
+
//# sourceMappingURL=state_machine.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"state_machine.js","sourceRoot":"","sources":["../src/state_machine.ts"],"names":[],"mappings":"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"}
|
package/dist/types/errors.d.ts
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import { ErrorMessage, Failure } from "../generated/proto/protocol";
|
|
2
|
-
import { Message } from "./types";
|
|
3
|
-
import { JournalEntry } from "../journal";
|
|
4
2
|
import { FailureWithTerminal } from "../generated/proto/javascript";
|
|
3
|
+
import * as p from "./protocol";
|
|
5
4
|
export declare enum ErrorCodes {
|
|
6
5
|
/**
|
|
7
6
|
* Not an error; returned on success.
|
|
@@ -159,15 +158,25 @@ export declare class RestateError extends Error {
|
|
|
159
158
|
export declare class TerminalError extends RestateError {
|
|
160
159
|
constructor(message: string, options?: {
|
|
161
160
|
errorCode?: number;
|
|
161
|
+
cause?: any;
|
|
162
162
|
});
|
|
163
163
|
}
|
|
164
|
+
export declare class TimeoutError extends TerminalError {
|
|
165
|
+
constructor();
|
|
166
|
+
}
|
|
164
167
|
export declare class RetryableError extends RestateError {
|
|
165
168
|
constructor(message: string, options?: {
|
|
166
169
|
errorCode?: number;
|
|
167
170
|
cause?: any;
|
|
168
171
|
});
|
|
169
172
|
static internal(message: string): RetryableError;
|
|
170
|
-
static journalMismatch(journalIndex: number,
|
|
173
|
+
static journalMismatch(journalIndex: number, actualEntry: {
|
|
174
|
+
messageType: bigint;
|
|
175
|
+
message: p.ProtocolMessage | Uint8Array;
|
|
176
|
+
}, expectedEntry: {
|
|
177
|
+
messageType: bigint;
|
|
178
|
+
message: p.ProtocolMessage | Uint8Array;
|
|
179
|
+
}): RetryableError;
|
|
171
180
|
static protocolViolation(message: string): RetryableError;
|
|
172
181
|
static apiViolation(message: string): RetryableError;
|
|
173
182
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC;AAEhC,oBAAY,UAAU;IACpB;;;OAGG;IACH,EAAE,IAAI;IACN;;;OAGG;IACH,SAAS,IAAI;IACb;;;;;;;OAOG;IACH,OAAO,IAAI;IACX;;;;;;OAMG;IACH,gBAAgB,IAAI;IACpB;;;;;;;OAOG;IACH,iBAAiB,IAAI;IACrB;;;;;;;;OAQG;IACH,SAAS,IAAI;IACb;;;;OAIG;IACH,cAAc,IAAI;IAClB;;;;;;;;;OASG;IACH,iBAAiB,IAAI;IACrB;;;;OAIG;IACH,kBAAkB,IAAI;IACtB;;;;;;;;;;;;;;;OAeG;IACH,mBAAmB,IAAI;IACvB;;;;;;OAMG;IACH,OAAO,KAAK;IACZ;;;;;;;;;;;;OAYG;IACH,YAAY,KAAK;IACjB;;;;OAIG;IACH,aAAa,KAAK;IAClB;;;;;OAKG;IACH,QAAQ,KAAK;IACb;;;;;OAKG;IACH,WAAW,KAAK;IAChB;;;OAGG;IACH,SAAS,KAAK;IACd;;;;OAIG;IACH,eAAe,KAAK;CACrB;AACD,oBAAY,iBAAiB;IAC3B,gBAAgB,KAAK;IACrB,kBAAkB,KAAK;CACxB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAa7C;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE;IAKnE,SAAS,IAAI,OAAO;CAM5B;AAID,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE;CAG3E;AAED,qBAAa,YAAa,SAAQ,aAAa;;CAI9C;AAGD,qBAAa,cAAe,SAAQ,YAAY;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE;WAI5D,QAAQ,CAAC,OAAO,EAAE,MAAM;WAIxB,eAAe,CAC3B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,CAAC,CAAC,eAAe,GAAG,UAAU,CAAC;KACzC,EACD,aAAa,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,CAAC,CAAC,eAAe,GAAG,UAAU,CAAC;KACzC;WAeW,iBAAiB,CAAC,OAAO,EAAE,MAAM;WAMjC,YAAY,CAAC,OAAO,EAAE,MAAM;CAK3C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAOlD;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,KAAK,GAAG,mBAAmB,CAM1E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAEtE;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,OAAO,GACrB,KAAK,CAOP;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,KAAK,GAAG,YAAY,CAO5D"}
|