resonate-basic-ephemeral-world-usage-typescript

What problem does it solve?

Provides clear, practical patterns for writing and organizing Ephemeral World code that initializes the Resonate client, registers functions, starts and monitors executions, manages cross-process RPCs, and shares non-serializable dependencies, removing common confusion between ephemeral (client) and durable (context) APIs.

Core Features & Use Cases

• Client Initialization Modes: Guidance for local in-memory development and server-connected configurations using environment variables and constructor options.
• Function Registration & Invocation: Best practices for registering functions by reference, invoking with run/beginRun for local execution, and rpc/beginRpc for remote execution with explicit targets.
• Promise Management & Human-in-the-Loop: Create, get, resolve, and reject promises for external approvals and asynchronous coordination.
• Dependency Injection & Scheduling: Set non-serializable dependencies in the ephemeral world for use by durable functions and create cron-like schedules for recurring tasks.
• Common Pitfalls & Decision Rules: Clear rules to avoid mixing Client and Context APIs, handle in-memory argument wrapping, and use correct RPC targets.

Quick Start

Initialize a Resonate client, set required dependencies, register your workflow functions, and start a run or RPC with a unique execution id to observe the ephemeral-to-durable flow.