@resonatehq/sdk 0.9.6 → 0.10.0

package/README.md

@@ -1,33 +1,105 @@
-![resonate component banner](/assets/resonate-component.png)
+![resonate component banner](./assets/resonate-banner.png)
 
 # Resonate TypeScript SDK
 
 [![cicd](https://github.com/resonatehq/resonate-sdk-ts/actions/workflows/cicd.yaml/badge.svg)](https://github.com/resonatehq/resonate-sdk-ts/actions/workflows/cicd.yaml)
 [![codecov](https://codecov.io/gh/resonatehq/resonate-sdk-ts/branch/main/graph/badge.svg)](https://codecov.io/gh/resonatehq/resonate-sdk-ts)
+[![dst](https://github.com/resonatehq/resonate-sdk-ts/actions/workflows/dst.yml/badge.svg)](https://github.com/resonatehq/resonate-sdk-ts/actions/workflows/dst.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
 ## About this component
 
 The Resonate TypeScript SDK enables developers to build reliable and scalable cloud applications across a wide variety of use cases.
 
-### [How to contribute to this SDK](./CONTRIBUTING.md)
+- [How to contribute to this SDK](./CONTRIBUTING.md)
+- [Evaluate Resonate for your next project](https://docs.resonatehq.io/evaluate/)
+- [Example application library](https://github.com/resonatehq-examples)
+- [Join the Discord](https://resonatehq.io/discord)
+- [Subscribe to the Blog](https://journal.resonatehq.io/subscribe)
+- [Follow on X](https://x.com/resonatehqio)
+- [Follow on LinkedIn](https://www.linkedin.com/company/resonatehqio)
+- [Subscribe on YouTube](https://www.youtube.com/@resonatehqio)
 
-### [How to use this SDK](https://docs.resonatehq.io/develop/typescript)
+## Quickstart
 
-### [Get started with Resonate](https://docs.resonatehq.io/get-started/)
+![quickstart banner](./assets/quickstart-banner.png)
 
-### [Evaluate Resonate for your next project](https://docs.resonatehq.io/evaluate/)
+1. Install the Resonate Server & CLI
 
-### [Example application library](https://github.com/resonatehq-examples)
+```shell
+brew install resonatehq/tap/resonate
+```
 
-### [The concepts that power Resonate](https://www.distributed-async-await.io/)
+2. Install the Resonate SDK
 
-### [Join the Discord](https://resonatehq.io/discord)
+```shell
+npm install @resonatehq/sdk
+```
 
-### [Subscribe to the Blog](https://journal.resonatehq.io/subscribe)
+3. Write your first Resonate Function
 
-### [Follow on Twitter](https://twitter.com/resonatehqio)
+A countdown as a loop. Simple, but the function can run for minutes, hours, or days, despite restarts.
 
-### [Follow on LinkedIn](https://www.linkedin.com/company/resonatehqio)
+```typescript
+import { Resonate, type Context } from "@resonatehq/sdk";
 
-### [Subscribe on YouTube](https://www.youtube.com/@resonatehqio)
+function* countdown(context: Context, count: number, delay: number) {
+  for (let i = count; i > 0; i--) {
+    // Run a function, persist its result
+    yield* context.run((context: Context) => console.log(`Countdown: ${i}`));
+    // Sleep
+    yield* context.sleep(delay * 1000);
+  }
+  console.log("Done!");
+}
+// Instantiate Resonate
+const resonate = new Resonate({ url: "http://localhost:8001" });
+// Register the function
+resonate.register(countdown);
+```
+
+[Clone a working example repo](https://github.com/resonatehq-examples/example-quickstart-ts)
+
+4. Start the server
+
+```shell
+resonate dev
+```
+
+5. Start the worker
+
+```shell
+npx ts-node countdown.ts
+```
+
+6. Run the function
+
+Run the function with execution ID `countdown.1`:
+
+```shell
+resonate invoke countdown.1 --func countdown --arg 5 --arg 60
+```
+
+**Result**
+
+You will see the countdown in the terminal
+
+```shell
+npx ts-node countdown.ts
+Countdown: 5
+Countdown: 4
+Countdown: 3
+Countdown: 2
+Countdown: 1
+Done!
+```
+
+**What to try**
+
+After starting the function, inspect the current state of the execution using the `resonate tree` command. The tree command visualizes the call graph of the function execution as a graph of durable promises.
+
+```shell
+resonate tree countdown.1
+```
+
+Now try killing the worker mid-countdown and restarting. **The countdown picks up right where it left off without missing a beat.**

package/dist/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,GAAG,IAAI,MAAM,CAAC;CACf;AAED,qBAAa,SAAS;IACpB,GAAG,IAAI,MAAM;CAGd;AAED,qBAAa,SAAS;IACb,IAAI,SAAK;IAChB,GAAG,IAAI,MAAM;CAGd"}

package/dist/clock.js

@@ -0,0 +1,12 @@
+export class WallClock {
+    now() {
+        return Date.now();
+    }
+}
+export class StepClock {
+    time = 0;
+    now() {
+        return this.time++;
+    }
+}
+//# sourceMappingURL=clock.js.map

package/dist/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,SAAS;IACpB,GAAG;QACD,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC;CACF;AAED,MAAM,OAAO,SAAS;IACb,IAAI,GAAG,CAAC,CAAC;IAChB,GAAG;QACD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/codec.d.ts

@@ -0,0 +1,11 @@
+import { type Encryptor } from "./encryptor.js";
+import type { PromiseRecord, Value } from "./network/types.js";
+export declare class Codec {
+    private encoder;
+    private encryptor;
+    constructor(encryptor?: Encryptor);
+    encode(value: any): Value;
+    decode(value: Value | undefined): any | undefined;
+    decodePromise(promise: PromiseRecord): PromiseRecord;
+}
+//# sourceMappingURL=codec.d.ts.map

package/dist/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,gBAAgB,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AA8E/D,qBAAa,KAAK;IAChB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,GAAE,SAA+B;IAKtD,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK;IAWzB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,GAAG,GAAG,SAAS;IAajD,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa;CAUrD"}

package/dist/codec.js

@@ -0,0 +1,115 @@
+import { NoopEncryptor } from "./encryptor.js";
+import exceptions from "./exceptions.js";
+import * as util from "./util.js";
+class JsonEncoder {
+    inf = "__INF__";
+    negInf = "__NEG_INF__";
+    encode(value) {
+        if (value === undefined) {
+            return { data: "", headers: {} };
+        }
+        let json;
+        try {
+            json = JSON.stringify(value, (_, v) => {
+                if (v === Number.POSITIVE_INFINITY)
+                    return this.inf;
+                if (v === Number.NEGATIVE_INFINITY)
+                    return this.negInf;
+                if (v instanceof AggregateError) {
+                    return {
+                        __type: "aggregate_error",
+                        message: v.message,
+                        stack: v.stack,
+                        name: v.name,
+                        errors: v.errors,
+                    };
+                }
+                if (v instanceof Error) {
+                    return {
+                        __type: "error",
+                        message: v.message,
+                        stack: v.stack,
+                        name: v.name,
+                    };
+                }
+                return v;
+            });
+            return {
+                headers: {},
+                data: util.base64Encode(json),
+            };
+        }
+        catch (e) {
+            throw exceptions.ENCODING_ARGS_UNENCODEABLE("unknown", e);
+        }
+    }
+    decode(value) {
+        if (!value?.data) {
+            return undefined;
+        }
+        try {
+            const decoded = JSON.parse(util.base64Decode(value.data), (_, v) => {
+                if (v === this.inf)
+                    return Number.POSITIVE_INFINITY;
+                if (v === this.negInf)
+                    return Number.NEGATIVE_INFINITY;
+                if (v?.__type === "aggregate_error") {
+                    return Object.assign(new AggregateError(v.errors, v.message), v);
+                }
+                if (v?.__type === "error") {
+                    const err = new Error(v.message || "Unknown error");
+                    if (v.name)
+                        err.name = v.name;
+                    if (v.stack)
+                        err.stack = v.stack;
+                    return err;
+                }
+                return v;
+            });
+            return decoded;
+        }
+        catch (e) {
+            throw exceptions.ENCODING_ARGS_UNDECODEABLE("unknown", e);
+        }
+    }
+}
+export class Codec {
+    encoder;
+    encryptor;
+    constructor(encryptor = new NoopEncryptor()) {
+        this.encoder = new JsonEncoder();
+        this.encryptor = encryptor;
+    }
+    encode(value) {
+        const encoded = this.encoder.encode(value);
+        try {
+            const encrypted = this.encryptor.encrypt(encoded);
+            return encrypted;
+        }
+        catch (e) {
+            throw exceptions.ENCODING_ARGS_UNENCODEABLE("unknown", e);
+        }
+    }
+    decode(value) {
+        if (!value?.data) {
+            return undefined;
+        }
+        try {
+            const decrypted = this.encryptor.decrypt(value);
+            return this.encoder.decode(decrypted);
+        }
+        catch (e) {
+            throw exceptions.ENCODING_ARGS_UNDECODEABLE("unknown", e);
+        }
+    }
+    decodePromise(promise) {
+        const param = this.decode(promise.param);
+        const value = this.decode(promise.value);
+        return {
+            ...promise,
+            param: { headers: promise.param?.headers, data: param },
+            value: { headers: promise.value?.headers, data: value },
+        };
+    }
+}
+//# sourceMappingURL=codec.js.map

package/dist/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"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"}

package/dist/computation.d.ts

@@ -0,0 +1,40 @@
+import type { Clock } from "./clock.js";
+import type { Heartbeat } from "./heartbeat.js";
+import type { Logger } from "./logger.js";
+import type { PromiseRecord } from "./network/types.js";
+import type { OptionsBuilder } from "./options.js";
+import type { Registry } from "./registry.js";
+import { type RetryPolicyConstructor } from "./retries.js";
+import { type Trace } from "./trace.js";
+import type { Effects } from "./types.js";
+export type Status = Done | Suspended;
+export type Done = {
+    kind: "done";
+    id: string;
+    state: "resolved" | "rejected";
+    value: any;
+    trace: Trace;
+};
+export type Suspended = {
+    kind: "suspended";
+    awaited: string[];
+    trace: Trace;
+};
+export declare class Computation {
+    private id;
+    private clock;
+    private effects;
+    private retries;
+    private registry;
+    private dependencies;
+    private optsBuilder;
+    private logger;
+    private heartbeat;
+    private processing;
+    constructor(id: string, clock: Clock, effects: Effects, retries: Map<string, RetryPolicyConstructor>, registry: Registry, heartbeat: Heartbeat, dependencies: Map<string, any>, optsBuilder: OptionsBuilder, logger: Logger);
+    executeUntilBlocked(rootPromise: PromiseRecord): Promise<Status>;
+    private processAcquired;
+    private processGenerator;
+    private processFunction;
+}
+//# sourceMappingURL=computation.d.ts.map

package/dist/computation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computation.d.ts","sourceRoot":"","sources":["../src/computation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,KAAK,KAAK,EAAkB,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAQ,MAAM,YAAY,CAAC;AAGhD,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEtC,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;IAC/B,KAAK,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AASF,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,UAAU,CAAS;gBAGzB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAC5C,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,WAAW,EAAE,cAAc,EAC3B,MAAM,EAAE,MAAM;IAaH,mBAAmB,CAAC,WAAW,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;YAW/D,eAAe;YAqDf,gBAAgB;YAwChB,eAAe;CAoB9B"}

package/dist/computation.js

@@ -0,0 +1,152 @@
+import { InnerContext } from "./context.js";
+import { Coroutine } from "./coroutine.js";
+import exceptions from "./exceptions.js";
+import { Exponential, Never } from "./retries.js";
+import { TraceCollector } from "./trace.js";
+import * as util from "./util.js";
+export class Computation {
+    id;
+    clock;
+    effects;
+    retries;
+    registry;
+    dependencies;
+    optsBuilder;
+    logger;
+    heartbeat;
+    processing = false;
+    constructor(id, clock, effects, retries, registry, heartbeat, dependencies, optsBuilder, logger) {
+        this.id = id;
+        this.clock = clock;
+        this.effects = effects;
+        this.retries = retries;
+        this.registry = registry;
+        this.heartbeat = heartbeat;
+        this.dependencies = dependencies;
+        this.optsBuilder = optsBuilder;
+        this.logger = logger;
+    }
+    async executeUntilBlocked(rootPromise) {
+        if (this.processing)
+            throw exceptions.PANIC("computation", "already processing");
+        this.processing = true;
+        try {
+            return await this.processAcquired(rootPromise);
+        }
+        finally {
+            this.processing = false;
+        }
+    }
+    async processAcquired(rootPromise) {
+        if (!isValidData(rootPromise.param?.data)) {
+            throw exceptions.PANIC("computation", "invalid promise data");
+        }
+        const { func, args, retry, version = 1 } = rootPromise.param.data;
+        const registered = this.registry.get(func, version);
+        // function must be registered
+        if (!registered) {
+            throw exceptions.REGISTRY_FUNCTION_NOT_REGISTERED(func, version);
+        }
+        if (version !== 0)
+            util.assert(version === registered.version, "versions must match");
+        util.assert(func === registered.name, "names must match");
+        // start heartbeat
+        this.heartbeat.start();
+        const retryCtor = retry ? this.retries.get(retry.type) : undefined;
+        const retryPolicy = retryCtor
+            ? new retryCtor(retry?.data)
+            : util.isGeneratorFunction(registered.func)
+                ? new Never()
+                : new Exponential();
+        if (retry && !retryCtor) {
+            this.logger.warn({ component: "computation", retryType: retry.type }, `Retry policy '${retry.type}' not found. Will ignore.`);
+        }
+        const ctxConfig = {
+            id: this.id,
+            oId: rootPromise.tags["resonate:origin"] ?? this.id,
+            func: registered.func.name,
+            clock: this.clock,
+            registry: this.registry,
+            dependencies: this.dependencies,
+            optsBuilder: this.optsBuilder,
+            timeout: rootPromise.timeoutAt,
+            version: registered.version,
+            retryPolicy: retryPolicy,
+        };
+        if (util.isGeneratorFunction(registered.func)) {
+            return this.processGenerator(registered.func, ctxConfig, args, rootPromise);
+        }
+        return this.processFunction(this.id, registered.func, new InnerContext(ctxConfig), args);
+    }
+    async processGenerator(func, ctxConfig, args, rootPromise) {
+        const collector = new TraceCollector();
+        // If boundary promise is done, short-circuit (dedup the root)
+        if (rootPromise.state !== "pending") {
+            const state = rootPromise.state === "resolved" ? "resolved" : "rejected";
+            collector.emit({ kind: "dedup", id: rootPromise.id, state, value: rootPromise.value });
+            this.logger.debug({ component: "trace", kind: "dedup", id: rootPromise.id }, "trace: dedup");
+            return {
+                kind: "done",
+                id: rootPromise.id,
+                state,
+                value: rootPromise.value,
+                trace: collector.getTrace(),
+            };
+        }
+        const ctx = new InnerContext(ctxConfig);
+        const status = await Coroutine.exec(this.logger, ctx, func, args, this.effects, collector);
+        const trace = collector.getTrace();
+        if (status.type === "done") {
+            return {
+                kind: "done",
+                id: this.id,
+                state: status.result.kind === "value" ? "resolved" : "rejected",
+                value: status.result.kind === "value" ? status.result.value : status.result.error,
+                trace,
+            };
+        }
+        // Only remote todos remain — locals are handled inline by the coroutine
+        return { kind: "suspended", awaited: status.todo.remote.map((t) => t.id), trace };
+    }
+    async processFunction(id, func, ctx, args) {
+        const collector = new TraceCollector();
+        collector.emit({ kind: "spawn", id });
+        this.logger.debug({ component: "trace", kind: "spawn", id }, "trace: spawn");
+        const result = await util.executeWithRetry(ctx, func, args, this.logger);
+        const state = result.kind === "value" ? "resolved" : "rejected";
+        const value = result.kind === "value" ? result.value : result.error;
+        collector.emit({ kind: "return", id, state, value });
+        this.logger.debug({ component: "trace", kind: "return", id }, "trace: return");
+        return {
+            kind: "done",
+            id,
+            state,
+            value,
+            trace: collector.getTrace(),
+        };
+    }
+}
+// Helper functions
+function isValidData(data) {
+    if (data === null || typeof data !== "object")
+        return false;
+    const d = data;
+    // func must be a string
+    if (typeof d.func !== "string")
+        return false;
+    // args must be an array
+    if (!Array.isArray(d.args))
+        return false;
+    // retry (if present) must be an object with string `type` and any `data`
+    if (d.retry !== undefined) {
+        if (d.retry === null || typeof d.retry !== "object" || typeof d.retry.type !== "string" || !("data" in d.retry)) {
+            return false;
+        }
+    }
+    // version (if present) must be a number
+    if (d.version !== undefined && typeof d.version !== "number") {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=computation.js.map

package/dist/computation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computation.js","sourceRoot":"","sources":["../src/computation.ts"],"names":[],"mappings":"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"}