@restatedev/restate-sdk-cloudflare-workers 1.17.2 → 1.17.3

package/dist/endpoint/endpoint.cjs

@@ -66,7 +66,7 @@ var EndpointBuilder = class {
 function computeDiscovery(components) {
 	return {
 		minProtocolVersion: 5,
-		maxProtocolVersion: 7,
+		maxProtocolVersion: 8,
 		services: [...components.values()].map((c) => c.discovery())
 	};
 }

package/dist/endpoint/endpoint.js

@@ -66,7 +66,7 @@ var EndpointBuilder = class {
 function computeDiscovery(components) {
 	return {
 		minProtocolVersion: 5,
-		maxProtocolVersion: 7,
+		maxProtocolVersion: 8,
 		services: [...components.values()].map((c) => c.discovery())
 	};
 }

package/dist/endpoint/endpoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint.js","names":["name"],"sources":["../../src/endpoint/endpoint.ts"],"sourcesContent":["/*\n * Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH\n *\n * This file is part of the Restate SDK for Node.js/TypeScript,\n * which is released under the MIT license.\n *\n * You can find a copy of the license in file LICENSE in the root\n * directory of this repository or package, or at\n * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport type {\n  JournalValueCodec,\n  ServiceDefinition,\n  VirtualObjectDefinition,\n  WorkflowDefinition,\n} from \"@restatedev/restate-sdk-core\";\n\nimport type {\n  ObjectOptions,\n  ServiceOptions,\n  WorkflowOptions,\n} from \"../types/rpc.js\";\nimport { HandlerWrapper } from \"../types/rpc.js\";\nimport type { Component } from \"./components.js\";\nimport {\n  ServiceComponent,\n  VirtualObjectComponent,\n  WorkflowComponent,\n} from \"./components.js\";\nimport type * as discovery from \"./discovery.js\";\nimport { defaultLoggerTransport } from \"../logging/console_logger_transport.js\";\nimport {\n  type LoggerTransport,\n  LogSource,\n} from \"../logging/logger_transport.js\";\nimport type { Logger } from \"../logging/logger.js\";\nimport { createLogger } from \"../logging/logger.js\";\nimport type { DefaultServiceOptions } from \"../endpoint.js\";\n\nfunction isServiceDefinition<P extends string, M>(\n  m: Record<string, any>\n): m is ServiceDefinition<P, M> & { service: M } {\n  return m && m.service !== undefined;\n}\n\nfunction isObjectDefinition<P extends string, M>(\n  m: Record<string, any>\n): m is VirtualObjectDefinition<P, M> & { object: M } {\n  return m && m.object !== undefined;\n}\n\nfunction isWorkflowDefinition<P extends string, M>(\n  m: Record<string, any>\n): m is WorkflowDefinition<P, M> & { workflow: M } {\n  return m && m.workflow !== undefined;\n}\n\n/**\n * Services can have additional information that is not part of the definition.\n * For example a description or metadata.\n */\ntype ServiceAuxInfo = {\n  description?: string;\n  metadata?: Record<string, any>;\n  options?: ServiceOptions | ObjectOptions | WorkflowOptions;\n};\n\nexport type Endpoint = {\n  loggerTransport: LoggerTransport;\n  components: Map<string, Component>;\n  keySet: string[];\n  /**\n   * This is a simple console without contextual info.\n   *\n   * This should be used only in cases where no contextual info is available.\n   */\n  rlog: Logger;\n  /**\n   * All discovery metadata, except protocol mode provided by the node/fetch/lambda endpoint implementations\n   */\n  discoveryMetadata: Omit<discovery.Endpoint, \"protocolMode\">;\n\n  /**\n   * Codec provider to use for journal values.\n   */\n  journalValueCodec?: Promise<JournalValueCodec>;\n};\n\nexport class EndpointBuilder {\n  private readonly serviceDefinitions: Map<\n    string,\n    | ServiceDefinition<string, any>\n    | VirtualObjectDefinition<string, any>\n    | WorkflowDefinition<string, any>\n  > = new Map();\n  private loggerTransport: LoggerTransport = defaultLoggerTransport;\n  private keySet: string[] = [];\n  private defaultServiceOptions: DefaultServiceOptions = {};\n  private journalValueCodecProvider?: () => Promise<JournalValueCodec>;\n\n  public bind<P extends string, M>(\n    definition:\n      | ServiceDefinition<P, M>\n      | VirtualObjectDefinition<P, M>\n      | WorkflowDefinition<P, M>\n  ) {\n    // Validate service name\n    if (definition.name.indexOf(\"/\") !== -1) {\n      throw new Error(\"service name must not contain any slash '/'\");\n    }\n\n    this.serviceDefinitions.set(definition.name, definition);\n  }\n\n  public addIdentityKeys(...keys: string[]) {\n    this.keySet.push(...keys);\n  }\n\n  public setDefaultServiceOptions(options: DefaultServiceOptions) {\n    this.defaultServiceOptions = options;\n  }\n\n  public setLogger(newLogger: LoggerTransport) {\n    this.loggerTransport = newLogger;\n  }\n\n  public setJournalValueCodecProvider(\n    codecProvider: () => Promise<JournalValueCodec>\n  ) {\n    this.journalValueCodecProvider = codecProvider;\n  }\n\n  public build(): Endpoint {\n    const rlog = createLogger(this.loggerTransport, LogSource.SYSTEM);\n\n    // Build the components\n    const components = new Map<string, Component>();\n    for (const [name, definition] of this.serviceDefinitions) {\n      if (isServiceDefinition(definition)) {\n        const { name, service } = definition;\n        if (!service) {\n          throw new TypeError(`no service implementation found.`);\n        }\n        components.set(\n          name,\n          buildServiceComponent(\n            name,\n            service,\n            definition as ServiceAuxInfo,\n            this.defaultServiceOptions\n          )\n        );\n      } else if (isObjectDefinition(definition)) {\n        const { name, object } = definition;\n        if (!object) {\n          throw new TypeError(`no object implementation found.`);\n        }\n        components.set(\n          name,\n          buildVirtualObjectComponent(\n            name,\n            object,\n            definition as ServiceAuxInfo,\n            this.defaultServiceOptions\n          )\n        );\n      } else if (isWorkflowDefinition(definition)) {\n        const { name, workflow } = definition;\n        if (!workflow) {\n          throw new TypeError(`no workflow implementation found.`);\n        }\n        components.set(\n          name,\n          buildWorkflowComponent(\n            name,\n            workflow,\n            definition as ServiceAuxInfo,\n            this.defaultServiceOptions\n          )\n        );\n      } else {\n        throw new TypeError(\n          `cannot bind ${name}, can only bind a service or a virtual object or a workflow definition`\n        );\n      }\n    }\n\n    // Compute discovery metadata\n    const discoveryMetadata = computeDiscovery(components);\n\n    return {\n      keySet: this.keySet,\n      loggerTransport: this.loggerTransport,\n      rlog,\n      components,\n      discoveryMetadata,\n      journalValueCodec: this.journalValueCodecProvider\n        ? this.journalValueCodecProvider()\n        : undefined,\n    };\n  }\n}\n\nfunction computeDiscovery(\n  components: Map<string, Component>\n): discovery.Endpoint {\n  return {\n    minProtocolVersion: 5,\n    maxProtocolVersion: 7,\n    services: [...components.values()].map((c) => c.discovery()),\n  };\n}\n\nfunction buildServiceComponent(\n  name: string,\n  router: any,\n  definition: ServiceAuxInfo,\n  defaultServiceOptions: DefaultServiceOptions\n): ServiceComponent {\n  if (name.indexOf(\"/\") !== -1) {\n    throw new Error(\"service name must not contain any slash '/'\");\n  }\n  const component = new ServiceComponent(\n    name,\n    definition.description,\n    definition.metadata,\n    {\n      ...defaultServiceOptions,\n      ...(definition?.options as ServiceOptions | undefined),\n    }\n  );\n\n  for (const [route, handler] of Object.entries(\n    router as { [s: string]: any }\n  )) {\n    const wrapper = HandlerWrapper.fromHandler(handler);\n    if (!wrapper) {\n      throw new TypeError(`${route} is not a restate handler.`);\n    }\n    wrapper.bindInstance(router);\n    component.add(route, wrapper);\n  }\n\n  return component;\n}\n\nfunction buildVirtualObjectComponent(\n  name: string,\n  router: any,\n  definition: ServiceAuxInfo,\n  defaultServiceOptions: DefaultServiceOptions\n): VirtualObjectComponent {\n  if (name.indexOf(\"/\") !== -1) {\n    throw new Error(\"service name must not contain any slash '/'\");\n  }\n  const component = new VirtualObjectComponent(\n    name,\n    definition.description,\n    definition.metadata,\n    {\n      ...defaultServiceOptions,\n      ...(definition?.options as ObjectOptions | undefined),\n    }\n  );\n\n  for (const [route, handler] of Object.entries(\n    router as { [s: string]: any }\n  )) {\n    const wrapper = HandlerWrapper.fromHandler(handler);\n    if (!wrapper) {\n      throw new TypeError(`${route} is not a restate handler.`);\n    }\n    wrapper.bindInstance(router);\n    component.add(route, wrapper);\n  }\n  return component;\n}\n\nfunction buildWorkflowComponent(\n  name: string,\n  workflow: any,\n  definition: ServiceAuxInfo,\n  defaultServiceOptions: DefaultServiceOptions\n): WorkflowComponent {\n  if (name.indexOf(\"/\") !== -1) {\n    throw new Error(\"service name must not contain any slash '/'\");\n  }\n  const component = new WorkflowComponent(\n    name,\n    definition.description,\n    definition.metadata,\n    {\n      ...defaultServiceOptions,\n      ...(definition?.options as WorkflowOptions | undefined),\n    }\n  );\n\n  for (const [route, handler] of Object.entries(\n    workflow as { [s: string]: any }\n  )) {\n    const wrapper = HandlerWrapper.fromHandler(handler);\n    if (!wrapper) {\n      throw new TypeError(`${route} is not a restate handler.`);\n    }\n    wrapper.bindInstance(workflow);\n    component.add(route, wrapper);\n  }\n  return component;\n}\n"],"mappings":"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"}
+{"version":3,"file":"endpoint.js","names":["name"],"sources":["../../src/endpoint/endpoint.ts"],"sourcesContent":["/*\n * Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH\n *\n * This file is part of the Restate SDK for Node.js/TypeScript,\n * which is released under the MIT license.\n *\n * You can find a copy of the license in file LICENSE in the root\n * directory of this repository or package, or at\n * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport type {\n  JournalValueCodec,\n  ServiceDefinition,\n  VirtualObjectDefinition,\n  WorkflowDefinition,\n} from \"@restatedev/restate-sdk-core\";\n\nimport type {\n  ObjectOptions,\n  ServiceOptions,\n  WorkflowOptions,\n} from \"../types/rpc.js\";\nimport { HandlerWrapper } from \"../types/rpc.js\";\nimport type { Component } from \"./components.js\";\nimport {\n  ServiceComponent,\n  VirtualObjectComponent,\n  WorkflowComponent,\n} from \"./components.js\";\nimport type * as discovery from \"./discovery.js\";\nimport { defaultLoggerTransport } from \"../logging/console_logger_transport.js\";\nimport {\n  type LoggerTransport,\n  LogSource,\n} from \"../logging/logger_transport.js\";\nimport type { Logger } from \"../logging/logger.js\";\nimport { createLogger } from \"../logging/logger.js\";\nimport type { DefaultServiceOptions } from \"../endpoint.js\";\n\nfunction isServiceDefinition<P extends string, M>(\n  m: Record<string, any>\n): m is ServiceDefinition<P, M> & { service: M } {\n  return m && m.service !== undefined;\n}\n\nfunction isObjectDefinition<P extends string, M>(\n  m: Record<string, any>\n): m is VirtualObjectDefinition<P, M> & { object: M } {\n  return m && m.object !== undefined;\n}\n\nfunction isWorkflowDefinition<P extends string, M>(\n  m: Record<string, any>\n): m is WorkflowDefinition<P, M> & { workflow: M } {\n  return m && m.workflow !== undefined;\n}\n\n/**\n * Services can have additional information that is not part of the definition.\n * For example a description or metadata.\n */\ntype ServiceAuxInfo = {\n  description?: string;\n  metadata?: Record<string, any>;\n  options?: ServiceOptions | ObjectOptions | WorkflowOptions;\n};\n\nexport type Endpoint = {\n  loggerTransport: LoggerTransport;\n  components: Map<string, Component>;\n  keySet: string[];\n  /**\n   * This is a simple console without contextual info.\n   *\n   * This should be used only in cases where no contextual info is available.\n   */\n  rlog: Logger;\n  /**\n   * All discovery metadata, except protocol mode provided by the node/fetch/lambda endpoint implementations\n   */\n  discoveryMetadata: Omit<discovery.Endpoint, \"protocolMode\">;\n\n  /**\n   * Codec provider to use for journal values.\n   */\n  journalValueCodec?: Promise<JournalValueCodec>;\n};\n\nexport class EndpointBuilder {\n  private readonly serviceDefinitions: Map<\n    string,\n    | ServiceDefinition<string, any>\n    | VirtualObjectDefinition<string, any>\n    | WorkflowDefinition<string, any>\n  > = new Map();\n  private loggerTransport: LoggerTransport = defaultLoggerTransport;\n  private keySet: string[] = [];\n  private defaultServiceOptions: DefaultServiceOptions = {};\n  private journalValueCodecProvider?: () => Promise<JournalValueCodec>;\n\n  public bind<P extends string, M>(\n    definition:\n      | ServiceDefinition<P, M>\n      | VirtualObjectDefinition<P, M>\n      | WorkflowDefinition<P, M>\n  ) {\n    // Validate service name\n    if (definition.name.indexOf(\"/\") !== -1) {\n      throw new Error(\"service name must not contain any slash '/'\");\n    }\n\n    this.serviceDefinitions.set(definition.name, definition);\n  }\n\n  public addIdentityKeys(...keys: string[]) {\n    this.keySet.push(...keys);\n  }\n\n  public setDefaultServiceOptions(options: DefaultServiceOptions) {\n    this.defaultServiceOptions = options;\n  }\n\n  public setLogger(newLogger: LoggerTransport) {\n    this.loggerTransport = newLogger;\n  }\n\n  public setJournalValueCodecProvider(\n    codecProvider: () => Promise<JournalValueCodec>\n  ) {\n    this.journalValueCodecProvider = codecProvider;\n  }\n\n  public build(): Endpoint {\n    const rlog = createLogger(this.loggerTransport, LogSource.SYSTEM);\n\n    // Build the components\n    const components = new Map<string, Component>();\n    for (const [name, definition] of this.serviceDefinitions) {\n      if (isServiceDefinition(definition)) {\n        const { name, service } = definition;\n        if (!service) {\n          throw new TypeError(`no service implementation found.`);\n        }\n        components.set(\n          name,\n          buildServiceComponent(\n            name,\n            service,\n            definition as ServiceAuxInfo,\n            this.defaultServiceOptions\n          )\n        );\n      } else if (isObjectDefinition(definition)) {\n        const { name, object } = definition;\n        if (!object) {\n          throw new TypeError(`no object implementation found.`);\n        }\n        components.set(\n          name,\n          buildVirtualObjectComponent(\n            name,\n            object,\n            definition as ServiceAuxInfo,\n            this.defaultServiceOptions\n          )\n        );\n      } else if (isWorkflowDefinition(definition)) {\n        const { name, workflow } = definition;\n        if (!workflow) {\n          throw new TypeError(`no workflow implementation found.`);\n        }\n        components.set(\n          name,\n          buildWorkflowComponent(\n            name,\n            workflow,\n            definition as ServiceAuxInfo,\n            this.defaultServiceOptions\n          )\n        );\n      } else {\n        throw new TypeError(\n          `cannot bind ${name}, can only bind a service or a virtual object or a workflow definition`\n        );\n      }\n    }\n\n    // Compute discovery metadata\n    const discoveryMetadata = computeDiscovery(components);\n\n    return {\n      keySet: this.keySet,\n      loggerTransport: this.loggerTransport,\n      rlog,\n      components,\n      discoveryMetadata,\n      journalValueCodec: this.journalValueCodecProvider\n        ? this.journalValueCodecProvider()\n        : undefined,\n    };\n  }\n}\n\nfunction computeDiscovery(\n  components: Map<string, Component>\n): discovery.Endpoint {\n  return {\n    minProtocolVersion: 5,\n    maxProtocolVersion: 8,\n    services: [...components.values()].map((c) => c.discovery()),\n  };\n}\n\nfunction buildServiceComponent(\n  name: string,\n  router: any,\n  definition: ServiceAuxInfo,\n  defaultServiceOptions: DefaultServiceOptions\n): ServiceComponent {\n  if (name.indexOf(\"/\") !== -1) {\n    throw new Error(\"service name must not contain any slash '/'\");\n  }\n  const component = new ServiceComponent(\n    name,\n    definition.description,\n    definition.metadata,\n    {\n      ...defaultServiceOptions,\n      ...(definition?.options as ServiceOptions | undefined),\n    }\n  );\n\n  for (const [route, handler] of Object.entries(\n    router as { [s: string]: any }\n  )) {\n    const wrapper = HandlerWrapper.fromHandler(handler);\n    if (!wrapper) {\n      throw new TypeError(`${route} is not a restate handler.`);\n    }\n    wrapper.bindInstance(router);\n    component.add(route, wrapper);\n  }\n\n  return component;\n}\n\nfunction buildVirtualObjectComponent(\n  name: string,\n  router: any,\n  definition: ServiceAuxInfo,\n  defaultServiceOptions: DefaultServiceOptions\n): VirtualObjectComponent {\n  if (name.indexOf(\"/\") !== -1) {\n    throw new Error(\"service name must not contain any slash '/'\");\n  }\n  const component = new VirtualObjectComponent(\n    name,\n    definition.description,\n    definition.metadata,\n    {\n      ...defaultServiceOptions,\n      ...(definition?.options as ObjectOptions | undefined),\n    }\n  );\n\n  for (const [route, handler] of Object.entries(\n    router as { [s: string]: any }\n  )) {\n    const wrapper = HandlerWrapper.fromHandler(handler);\n    if (!wrapper) {\n      throw new TypeError(`${route} is not a restate handler.`);\n    }\n    wrapper.bindInstance(router);\n    component.add(route, wrapper);\n  }\n  return component;\n}\n\nfunction buildWorkflowComponent(\n  name: string,\n  workflow: any,\n  definition: ServiceAuxInfo,\n  defaultServiceOptions: DefaultServiceOptions\n): WorkflowComponent {\n  if (name.indexOf(\"/\") !== -1) {\n    throw new Error(\"service name must not contain any slash '/'\");\n  }\n  const component = new WorkflowComponent(\n    name,\n    definition.description,\n    definition.metadata,\n    {\n      ...defaultServiceOptions,\n      ...(definition?.options as WorkflowOptions | undefined),\n    }\n  );\n\n  for (const [route, handler] of Object.entries(\n    workflow as { [s: string]: any }\n  )) {\n    const wrapper = HandlerWrapper.fromHandler(handler);\n    if (!wrapper) {\n      throw new TypeError(`${route} is not a restate handler.`);\n    }\n    wrapper.bindInstance(workflow);\n    component.add(route, wrapper);\n  }\n  return component;\n}\n"],"mappings":"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"}

package/dist/endpoint/handlers/vm/sdk_shared_core_wasm_bindings.d.ts

@@ -40,7 +40,7 @@ export interface WasmSendHandle {
 
 export type WasmAsyncResultValue = "NotReady" | "Empty" | { Success: Uint8Array } | { Failure: WasmFailure } | { StateKeys: string[] } | { InvocationId: string };
 
-export type WasmDoProgressResult = "AnyCompleted" | "WaitExternalProgress" | { ExecuteRun: number } | "CancelSignalReceived";
+export type WasmDoProgressResult = "AnyCompleted" | "WaitExternalProgress" | { ExecuteRun: number } | "CancelSignalReceived" | { EphemeralNotificationReady: number };
 
 export type WasmUnresolvedFuture = { Single: number } | { FirstCompleted: WasmUnresolvedFuture[] } | { AllCompleted: WasmUnresolvedFuture[] } | { FirstSucceededOrAllFailed: WasmUnresolvedFuture[] } | { AllSucceededOrFirstFailed: WasmUnresolvedFuture[] } | { Unknown: WasmUnresolvedFuture[] };
 
@@ -134,6 +134,7 @@ export class WasmVM {
     free(): void;
     [Symbol.dispose](): void;
     do_progress(future: WasmUnresolvedFuture): WasmDoProgressResult;
+    ephemeral_state_get(key: string): number;
     get_response_head(): WasmResponseHead;
     is_completed(handle: number): boolean;
     is_processing(): boolean;
@@ -177,6 +178,7 @@ export class WasmVM {
     sys_sleep(millis: bigint, name?: string | null): number;
     sys_write_output_failure(value: WasmFailure): void;
     sys_write_output_success(buffer: Uint8Array): void;
+    take_ephemeral_notification(ephemeral_notification_handle: number): WasmAsyncResultValue;
     take_notification(handle: number): WasmAsyncResultValue;
     take_output(): Uint8Array;
 }

package/dist/endpoint/handlers/vm/sdk_shared_core_wasm_bindings_bg.js

@@ -335,6 +335,19 @@ export class WasmVM {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * @param {string} key
+     * @returns {number}
+     */
+    ephemeral_state_get(key) {
+        const ptr0 = passStringToWasm0(key, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmvm_ephemeral_state_get(this.__wbg_ptr, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] >>> 0;
+    }
     /**
      * @returns {WasmResponseHead}
      */
@@ -895,6 +908,17 @@ export class WasmVM {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * @param {number} ephemeral_notification_handle
+     * @returns {WasmAsyncResultValue}
+     */
+    take_ephemeral_notification(ephemeral_notification_handle) {
+        const ret = wasm.wasmvm_take_ephemeral_notification(this.__wbg_ptr, ephemeral_notification_handle);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * @param {number} handle
      * @returns {WasmAsyncResultValue}

package/dist/endpoint/handlers/vm/sdk_shared_core_wasm_bindings_bg.wasm.d.ts

@@ -23,6 +23,7 @@ export const wasmheader_new: (a: number, b: number, c: number, d: number) => num
 export const wasmidentityverifier_new: (a: number, b: number) => [number, number, number];
 export const wasmidentityverifier_verify_identity: (a: number, b: number, c: number, d: number, e: number) => [number, number];
 export const wasmvm_do_progress: (a: number, b: any) => [number, number, number];
+export const wasmvm_ephemeral_state_get: (a: number, b: number, c: number) => [number, number, number];
 export const wasmvm_get_response_head: (a: number) => number;
 export const wasmvm_is_completed: (a: number, b: number) => number;
 export const wasmvm_is_processing: (a: number) => number;
@@ -66,10 +67,11 @@ export const wasmvm_sys_signal: (a: number, b: number, c: number) => [number, nu
 export const wasmvm_sys_sleep: (a: number, b: bigint, c: number, d: number) => [number, number, number];
 export const wasmvm_sys_write_output_failure: (a: number, b: any) => [number, number];
 export const wasmvm_sys_write_output_success: (a: number, b: number, c: number) => [number, number];
+export const wasmvm_take_ephemeral_notification: (a: number, b: number) => [number, number, number];
 export const wasmvm_take_notification: (a: number, b: number) => [number, number, number];
 export const wasmvm_take_output: (a: number) => any;
-export const __wbg_get_wasminput_invocation_id: (a: number) => [number, number];
 export const start: () => void;
+export const __wbg_get_wasminput_invocation_id: (a: number) => [number, number];
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_exn_store: (a: number) => void;

package/dist/internal.cjs

@@ -2,7 +2,25 @@ const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
 const require_errors = require('./types/errors.cjs');
 
 //#region src/internal.ts
-var internal_exports = /* @__PURE__ */ require_rolldown_runtime.__export({ isSuspendedError: () => require_errors.isSuspendedError });
+var internal_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
+	asInternal: () => asInternal,
+	isSuspendedError: () => require_errors.isSuspendedError
+});
+/**
+* Downcast the given context to {@link ContextInternal}, to access the internal APIs.
+*
+* Works with every context type passed to handlers, e.g. `Context`, `ObjectContext`, `ObjectSharedContext`, `WorkflowContext`.
+*
+* @example
+* ```ts
+* const ctxInternal = restate.internal.asInternal(ctx);
+* ```
+*
+* @experimental
+*/
+function asInternal(ctx) {
+	return ctx;
+}
 
 //#endregion
 Object.defineProperty(exports, 'internal_exports', {

package/dist/internal.d.cts

@@ -1,10 +1,24 @@
 import { isSuspendedError } from "./types/errors.cjs";
 import { Context, InvocationId, RestatePromise } from "./context.cjs";
+import { Serde } from "@restatedev/restate-sdk-core";
 
 //#region src/internal.d.ts
 declare namespace internal_d_exports {
-  export { ContextInternal, isSuspendedError };
+  export { ContextInternal, GetProjectOptions, asInternal, isSuspendedError };
 }
+/**
+ * Downcast the given context to {@link ContextInternal}, to access the internal APIs.
+ *
+ * Works with every context type passed to handlers, e.g. `Context`, `ObjectContext`, `ObjectSharedContext`, `WorkflowContext`.
+ *
+ * @example
+ * ```ts
+ * const ctxInternal = restate.internal.asInternal(ctx);
+ * ```
+ *
+ * @experimental
+ */
+declare function asInternal(ctx: Context): ContextInternal;
 /**
  * Internal {@link Context} interface exposing additional features.
  *
@@ -40,7 +54,7 @@ interface ContextInternal extends Context {
    *   name: "greeter",
    *   handlers: {
    *     greet: async (ctx: restate.Context, name: string) => {
-   *       ctxInternal = ctx as restate.internal.ContextInternal;
+   *       const ctxInternal = restate.internal.asInternal(ctx);
    *       const result = await RestatePromise.race([
    *         ctx.run(() => longRunningTask(name)),
    *         ctxInternal.cancellation().map(() => { throw new restate.TerminalError("Cancelled") }),
@@ -58,7 +72,7 @@ interface ContextInternal extends Context {
    *   name: "greeter",
    *   handlers: {
    *     greet: async (ctx: restate.Context, name: string) => {
-   *       const ctxInternal = ctx as restate.internal.ContextInternal;
+   *       const ctxInternal = restate.internal.asInternal(ctx);
    *       const controller = new AbortController();
    *       const cancellation = ctxInternal.cancellation()
    *         .map(() => {
@@ -82,7 +96,7 @@ interface ContextInternal extends Context {
    *   name: "greeter",
    *   handlers: {
    *     greet: async (ctx: restate.Context, name: string) => {
-   *       const ctxInternal = ctx as restate.internal.ContextInternal;
+   *       const ctxInternal = restate.internal.asInternal(ctx);
    *       try {
    *         return await RestatePromise.race([
    *           ctx.run(() => longRunningTask(name)),
@@ -118,7 +132,56 @@ interface ContextInternal extends Context {
    * @experimental
    */
   cancelPreviousCalls(): RestatePromise<InvocationId[]>;
+  /**
+   * Get state from the Restate runtime, apply the given `projection` to it,
+   * and record in the journal only the result of the projection.
+   *
+   * Use this to read big state values when you need only a small part of them:
+   * unlike `ctx.get`, the complete state value is not recorded in the journal,
+   * only its projection.
+   *
+   * It will appear in the UI as run(project:state_key).
+   *
+   * This method **MUST** only be used within Virtual Object and Workflow handlers.
+   *
+   * **NOTE:** Requires Restate >= 1.8 with service protocol V8 enabled, and **does not** work with request/response protocol mode (e.g. with AWS Lambda).
+   *
+   * @param name key of the state to retrieve
+   * @param projection function receiving the state value, or `null` if the state is empty.
+   * @param options serde for the state value, and serde for the projection result.
+   * @returns a {@link RestatePromise} resolved with the result of the projection.
+   *
+   * @example
+   * ```ts
+   * const ctxInternal = restate.internal.asInternal(ctx);
+   * const itemsCount = await ctxInternal.getProject<Item[], number>(
+   *   "items",
+   *   (items) => items?.length ?? 0
+   * );
+   * ```
+   *
+   * @experimental
+   */
+  getProject<TValue, TResult>(name: string, projection: (value: TValue | null) => TResult | Promise<TResult>, options?: GetProjectOptions<TValue, TResult>): RestatePromise<TResult>;
 }
+/**
+ * Options for {@link ContextInternal.getProject}.
+ *
+ * @experimental
+ */
+type GetProjectOptions<TValue, TResult> = {
+  /**
+   * Serde used to deserialize the state value.
+   */
+  serde?: Serde<TValue>;
+  /**
+   * Serde used to serialize the projection result, recorded in the journal.
+   *
+   * If not set, defaults to {@link GetProjectOptions.serde} when that is set,
+   * otherwise to the default serde.
+   */
+  resultSerde?: Serde<TResult>;
+};
 //#endregion
 export { internal_d_exports };
 //# sourceMappingURL=internal.d.cts.map

package/dist/internal.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.cts","names":[],"sources":["../src/internal.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;AAWiB,UAAA,eAAA,SAAwB,OAAR,CAAA;EAgGf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAA;;;;;;;;;;yBAWO,eAAe"}
+{"version":3,"file":"internal.d.cts","names":[],"sources":["../src/internal.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;AAiBA;AAWA;;AA2GwC,iBAtHxB,UAAA,CAsHwB,GAAA,EAtHR,OAsHQ,CAAA,EAtHE,eAsHF;;;;;;;;AAmC1B,UA9IG,eAAA,SAAwB,OA8I3B,CAAA;EACM;;;;AAQpB;;;;EAYgB,YAAA,EAAA,EAAA,OAAA;EAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAnEH;;;;;;;;;;yBAWO,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAkChB,kBAAkB,UAAU,QAAQ,oBAC9C,kBAAkB,QAAQ,WACnC,eAAe;;;;;;;KAQR;;;;UAIF,MAAM;;;;;;;gBAQA,MAAM"}

package/dist/internal.d.ts

@@ -1,10 +1,24 @@
 import { isSuspendedError } from "./types/errors.js";
 import { Context, InvocationId, RestatePromise } from "./context.js";
+import { Serde } from "@restatedev/restate-sdk-core";
 
 //#region src/internal.d.ts
 declare namespace internal_d_exports {
-  export { ContextInternal, isSuspendedError };
+  export { ContextInternal, GetProjectOptions, asInternal, isSuspendedError };
 }
+/**
+ * Downcast the given context to {@link ContextInternal}, to access the internal APIs.
+ *
+ * Works with every context type passed to handlers, e.g. `Context`, `ObjectContext`, `ObjectSharedContext`, `WorkflowContext`.
+ *
+ * @example
+ * ```ts
+ * const ctxInternal = restate.internal.asInternal(ctx);
+ * ```
+ *
+ * @experimental
+ */
+declare function asInternal(ctx: Context): ContextInternal;
 /**
  * Internal {@link Context} interface exposing additional features.
  *
@@ -40,7 +54,7 @@ interface ContextInternal extends Context {
    *   name: "greeter",
    *   handlers: {
    *     greet: async (ctx: restate.Context, name: string) => {
-   *       ctxInternal = ctx as restate.internal.ContextInternal;
+   *       const ctxInternal = restate.internal.asInternal(ctx);
    *       const result = await RestatePromise.race([
    *         ctx.run(() => longRunningTask(name)),
    *         ctxInternal.cancellation().map(() => { throw new restate.TerminalError("Cancelled") }),
@@ -58,7 +72,7 @@ interface ContextInternal extends Context {
    *   name: "greeter",
    *   handlers: {
    *     greet: async (ctx: restate.Context, name: string) => {
-   *       const ctxInternal = ctx as restate.internal.ContextInternal;
+   *       const ctxInternal = restate.internal.asInternal(ctx);
    *       const controller = new AbortController();
    *       const cancellation = ctxInternal.cancellation()
    *         .map(() => {
@@ -82,7 +96,7 @@ interface ContextInternal extends Context {
    *   name: "greeter",
    *   handlers: {
    *     greet: async (ctx: restate.Context, name: string) => {
-   *       const ctxInternal = ctx as restate.internal.ContextInternal;
+   *       const ctxInternal = restate.internal.asInternal(ctx);
    *       try {
    *         return await RestatePromise.race([
    *           ctx.run(() => longRunningTask(name)),
@@ -118,7 +132,56 @@ interface ContextInternal extends Context {
    * @experimental
    */
   cancelPreviousCalls(): RestatePromise<InvocationId[]>;
+  /**
+   * Get state from the Restate runtime, apply the given `projection` to it,
+   * and record in the journal only the result of the projection.
+   *
+   * Use this to read big state values when you need only a small part of them:
+   * unlike `ctx.get`, the complete state value is not recorded in the journal,
+   * only its projection.
+   *
+   * It will appear in the UI as run(project:state_key).
+   *
+   * This method **MUST** only be used within Virtual Object and Workflow handlers.
+   *
+   * **NOTE:** Requires Restate >= 1.8 with service protocol V8 enabled, and **does not** work with request/response protocol mode (e.g. with AWS Lambda).
+   *
+   * @param name key of the state to retrieve
+   * @param projection function receiving the state value, or `null` if the state is empty.
+   * @param options serde for the state value, and serde for the projection result.
+   * @returns a {@link RestatePromise} resolved with the result of the projection.
+   *
+   * @example
+   * ```ts
+   * const ctxInternal = restate.internal.asInternal(ctx);
+   * const itemsCount = await ctxInternal.getProject<Item[], number>(
+   *   "items",
+   *   (items) => items?.length ?? 0
+   * );
+   * ```
+   *
+   * @experimental
+   */
+  getProject<TValue, TResult>(name: string, projection: (value: TValue | null) => TResult | Promise<TResult>, options?: GetProjectOptions<TValue, TResult>): RestatePromise<TResult>;
 }
+/**
+ * Options for {@link ContextInternal.getProject}.
+ *
+ * @experimental
+ */
+type GetProjectOptions<TValue, TResult> = {
+  /**
+   * Serde used to deserialize the state value.
+   */
+  serde?: Serde<TValue>;
+  /**
+   * Serde used to serialize the projection result, recorded in the journal.
+   *
+   * If not set, defaults to {@link GetProjectOptions.serde} when that is set,
+   * otherwise to the default serde.
+   */
+  resultSerde?: Serde<TResult>;
+};
 //#endregion
 export { internal_d_exports };
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","names":[],"sources":["../src/internal.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;AAWiB,UAAA,eAAA,SAAwB,OAAR,CAAA;EAgGf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAA;;;;;;;;;;yBAWO,eAAe"}
+{"version":3,"file":"internal.d.ts","names":[],"sources":["../src/internal.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;AAiBA;AAWA;;AA2GwC,iBAtHxB,UAAA,CAsHwB,GAAA,EAtHR,OAsHQ,CAAA,EAtHE,eAsHF;;;;;;;;AAmC1B,UA9IG,eAAA,SAAwB,OA8I3B,CAAA;EACM;;;;AAQpB;;;;EAYgB,YAAA,EAAA,EAAA,OAAA;EAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAnEH;;;;;;;;;;yBAWO,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAkChB,kBAAkB,UAAU,QAAQ,oBAC9C,kBAAkB,QAAQ,WACnC,eAAe;;;;;;;KAQR;;;;UAIF,MAAM;;;;;;;gBAQA,MAAM"}

package/dist/internal.js

@@ -2,7 +2,25 @@ import { __export } from "./_virtual/rolldown_runtime.js";
 import { isSuspendedError } from "./types/errors.js";
 
 //#region src/internal.ts
-var internal_exports = /* @__PURE__ */ __export({ isSuspendedError: () => isSuspendedError });
+var internal_exports = /* @__PURE__ */ __export({
+	asInternal: () => asInternal,
+	isSuspendedError: () => isSuspendedError
+});
+/**
+* Downcast the given context to {@link ContextInternal}, to access the internal APIs.
+*
+* Works with every context type passed to handlers, e.g. `Context`, `ObjectContext`, `ObjectSharedContext`, `WorkflowContext`.
+*
+* @example
+* ```ts
+* const ctxInternal = restate.internal.asInternal(ctx);
+* ```
+*
+* @experimental
+*/
+function asInternal(ctx) {
+	return ctx;
+}
 
 //#endregion
 export { internal_exports };

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","names":[],"sources":["../src/internal.ts"],"sourcesContent":["import { Context, InvocationId, RestatePromise } from \"./context.js\";\n\nexport { isSuspendedError } from \"./types/errors.js\";\n\n/**\n * Internal {@link Context} interface exposing additional features.\n *\n * Please note that this API is to be considered experimental and might change without notice.\n *\n * @experimental\n */\nexport interface ContextInternal extends Context {\n  /**\n   * Returns true if the handler is in the processing phase.\n   * This is the mechanism used by `ctx.console` to distinguish whether we should log or not in replaying/processing.\n   *\n   * **WARNING**: This method should not be used to influence control flow, as it will **surely** lead to non-determinism errors!\n   *\n   * @experimental\n   */\n  isProcessing(): boolean;\n\n  /**\n   * Returns a {@link RestatePromise} that resolves with `undefined` when Restate signals cancellation\n   * of the current invocation.\n   *\n   * This method **MUST** only be used when the handler (or its parent service/endpoint) is configured\n   * with `explicitCancellation: true`. Without configuring this option, cancellations are propagated automatically,\n   * and this promise will **NEVER** resolve.\n   *\n   * **Promise reuse:** calling this method multiple times returns the **same** promise instance as long as\n   * the current cancellation signal has not yet arrived. Once the promise resolves (cancellation received),\n   * later calls return a **new** promise that will resolve on the next cancellation signal.\n   *\n   * @example Race a long-running side effect against cancellation\n   * ```ts\n   * const greeter = restate.service({\n   *   name: \"greeter\",\n   *   handlers: {\n   *     greet: async (ctx: restate.Context, name: string) => {\n   *       ctxInternal = ctx as restate.internal.ContextInternal;\n   *       const result = await RestatePromise.race([\n   *         ctx.run(() => longRunningTask(name)),\n   *         ctxInternal.cancellation().map(() => { throw new restate.TerminalError(\"Cancelled\") }),\n   *       ]);\n   *       return result;\n   *     },\n   *   },\n   *   options: { explicitCancellation: true },\n   * });\n   * ```\n   *\n   * @example Use the cancellation promise to create an AbortSignal for ctx.run\n   * ```ts\n   * const greeter = restate.service({\n   *   name: \"greeter\",\n   *   handlers: {\n   *     greet: async (ctx: restate.Context, name: string) => {\n   *       const ctxInternal = ctx as restate.internal.ContextInternal;\n   *       const controller = new AbortController();\n   *       const cancellation = ctxInternal.cancellation()\n   *         .map(() => {\n   *            controller.abort();\n   *            throw new restate.TerminalError(\"Cancelled\");\n   *         });\n   *\n   *       return RestatePromise.race([\n   *         ctx.run(() => fetch(`https://api.example.com/greet/${name}`, { signal: controller.signal })),\n   *         cancellation,\n   *       ]);\n   *     },\n   *   },\n   *   options: { explicitCancellation: true },\n   * });\n   * ```\n   *\n   * @example Handle cancellation, perform cleanup, then listen for the next cancellation\n   * ```ts\n   * const greeter = restate.service({\n   *   name: \"greeter\",\n   *   handlers: {\n   *     greet: async (ctx: restate.Context, name: string) => {\n   *       const ctxInternal = ctx as restate.internal.ContextInternal;\n   *       try {\n   *         return await RestatePromise.race([\n   *           ctx.run(() => longRunningTask(name)),\n   *           ctxInternal.cancellation().map(() => { throw new restate.TerminalError(\"Cancelled\") }),\n   *         ]);\n   *       } catch (e) {\n   *         // Perform cleanup\n   *         await ctx.run(() => cleanupResources(name));\n   *\n   *         // After cancellation is resolved, ctx.cancellation() returns a fresh promise.\n   *         // Race cleanup confirmation against the next cancellation signal.\n   *         await RestatePromise.race([\n   *           ctx.run(() => confirmCleanup(name)),\n   *           ctxInternal.cancellation().map(() => { throw new restate.TerminalError(\"Canceled during cleanup\") }),\n   *         ]);\n   *       }\n   *     },\n   *   },\n   *   options: { explicitCancellation: true },\n   * });\n   * ```\n   *\n   * @experimental\n   */\n  cancellation(): RestatePromise<void>;\n\n  /**\n   * Cancel all previous calls made from this handler.\n   *\n   * This method **MUST** only be used when the handler (or its parent service/endpoint) is configured\n   * with `explicitCancellation: true`. Without configuring this option, this operation will always be a no-op.\n   *\n   * @return the invocation id of the canceled calls.\n   * @experimental\n   */\n  cancelPreviousCalls(): RestatePromise<InvocationId[]>;\n}\n"],"mappings":""}
+{"version":3,"file":"internal.js","names":[],"sources":["../src/internal.ts"],"sourcesContent":["import { Context, InvocationId, RestatePromise } from \"./context.js\";\nimport type { Serde } from \"@restatedev/restate-sdk-core\";\n\nexport { isSuspendedError } from \"./types/errors.js\";\n\n/**\n * Downcast the given context to {@link ContextInternal}, to access the internal APIs.\n *\n * Works with every context type passed to handlers, e.g. `Context`, `ObjectContext`, `ObjectSharedContext`, `WorkflowContext`.\n *\n * @example\n * ```ts\n * const ctxInternal = restate.internal.asInternal(ctx);\n * ```\n *\n * @experimental\n */\nexport function asInternal(ctx: Context): ContextInternal {\n  return ctx as ContextInternal;\n}\n\n/**\n * Internal {@link Context} interface exposing additional features.\n *\n * Please note that this API is to be considered experimental and might change without notice.\n *\n * @experimental\n */\nexport interface ContextInternal extends Context {\n  /**\n   * Returns true if the handler is in the processing phase.\n   * This is the mechanism used by `ctx.console` to distinguish whether we should log or not in replaying/processing.\n   *\n   * **WARNING**: This method should not be used to influence control flow, as it will **surely** lead to non-determinism errors!\n   *\n   * @experimental\n   */\n  isProcessing(): boolean;\n\n  /**\n   * Returns a {@link RestatePromise} that resolves with `undefined` when Restate signals cancellation\n   * of the current invocation.\n   *\n   * This method **MUST** only be used when the handler (or its parent service/endpoint) is configured\n   * with `explicitCancellation: true`. Without configuring this option, cancellations are propagated automatically,\n   * and this promise will **NEVER** resolve.\n   *\n   * **Promise reuse:** calling this method multiple times returns the **same** promise instance as long as\n   * the current cancellation signal has not yet arrived. Once the promise resolves (cancellation received),\n   * later calls return a **new** promise that will resolve on the next cancellation signal.\n   *\n   * @example Race a long-running side effect against cancellation\n   * ```ts\n   * const greeter = restate.service({\n   *   name: \"greeter\",\n   *   handlers: {\n   *     greet: async (ctx: restate.Context, name: string) => {\n   *       const ctxInternal = restate.internal.asInternal(ctx);\n   *       const result = await RestatePromise.race([\n   *         ctx.run(() => longRunningTask(name)),\n   *         ctxInternal.cancellation().map(() => { throw new restate.TerminalError(\"Cancelled\") }),\n   *       ]);\n   *       return result;\n   *     },\n   *   },\n   *   options: { explicitCancellation: true },\n   * });\n   * ```\n   *\n   * @example Use the cancellation promise to create an AbortSignal for ctx.run\n   * ```ts\n   * const greeter = restate.service({\n   *   name: \"greeter\",\n   *   handlers: {\n   *     greet: async (ctx: restate.Context, name: string) => {\n   *       const ctxInternal = restate.internal.asInternal(ctx);\n   *       const controller = new AbortController();\n   *       const cancellation = ctxInternal.cancellation()\n   *         .map(() => {\n   *            controller.abort();\n   *            throw new restate.TerminalError(\"Cancelled\");\n   *         });\n   *\n   *       return RestatePromise.race([\n   *         ctx.run(() => fetch(`https://api.example.com/greet/${name}`, { signal: controller.signal })),\n   *         cancellation,\n   *       ]);\n   *     },\n   *   },\n   *   options: { explicitCancellation: true },\n   * });\n   * ```\n   *\n   * @example Handle cancellation, perform cleanup, then listen for the next cancellation\n   * ```ts\n   * const greeter = restate.service({\n   *   name: \"greeter\",\n   *   handlers: {\n   *     greet: async (ctx: restate.Context, name: string) => {\n   *       const ctxInternal = restate.internal.asInternal(ctx);\n   *       try {\n   *         return await RestatePromise.race([\n   *           ctx.run(() => longRunningTask(name)),\n   *           ctxInternal.cancellation().map(() => { throw new restate.TerminalError(\"Cancelled\") }),\n   *         ]);\n   *       } catch (e) {\n   *         // Perform cleanup\n   *         await ctx.run(() => cleanupResources(name));\n   *\n   *         // After cancellation is resolved, ctx.cancellation() returns a fresh promise.\n   *         // Race cleanup confirmation against the next cancellation signal.\n   *         await RestatePromise.race([\n   *           ctx.run(() => confirmCleanup(name)),\n   *           ctxInternal.cancellation().map(() => { throw new restate.TerminalError(\"Canceled during cleanup\") }),\n   *         ]);\n   *       }\n   *     },\n   *   },\n   *   options: { explicitCancellation: true },\n   * });\n   * ```\n   *\n   * @experimental\n   */\n  cancellation(): RestatePromise<void>;\n\n  /**\n   * Cancel all previous calls made from this handler.\n   *\n   * This method **MUST** only be used when the handler (or its parent service/endpoint) is configured\n   * with `explicitCancellation: true`. Without configuring this option, this operation will always be a no-op.\n   *\n   * @return the invocation id of the canceled calls.\n   * @experimental\n   */\n  cancelPreviousCalls(): RestatePromise<InvocationId[]>;\n\n  /**\n   * Get state from the Restate runtime, apply the given `projection` to it,\n   * and record in the journal only the result of the projection.\n   *\n   * Use this to read big state values when you need only a small part of them:\n   * unlike `ctx.get`, the complete state value is not recorded in the journal,\n   * only its projection.\n   *\n   * It will appear in the UI as run(project:state_key).\n   *\n   * This method **MUST** only be used within Virtual Object and Workflow handlers.\n   *\n   * **NOTE:** Requires Restate >= 1.8 with service protocol V8 enabled, and **does not** work with request/response protocol mode (e.g. with AWS Lambda).\n   *\n   * @param name key of the state to retrieve\n   * @param projection function receiving the state value, or `null` if the state is empty.\n   * @param options serde for the state value, and serde for the projection result.\n   * @returns a {@link RestatePromise} resolved with the result of the projection.\n   *\n   * @example\n   * ```ts\n   * const ctxInternal = restate.internal.asInternal(ctx);\n   * const itemsCount = await ctxInternal.getProject<Item[], number>(\n   *   \"items\",\n   *   (items) => items?.length ?? 0\n   * );\n   * ```\n   *\n   * @experimental\n   */\n  getProject<TValue, TResult>(\n    name: string,\n    projection: (value: TValue | null) => TResult | Promise<TResult>,\n    options?: GetProjectOptions<TValue, TResult>\n  ): RestatePromise<TResult>;\n}\n\n/**\n * Options for {@link ContextInternal.getProject}.\n *\n * @experimental\n */\nexport type GetProjectOptions<TValue, TResult> = {\n  /**\n   * Serde used to deserialize the state value.\n   */\n  serde?: Serde<TValue>;\n\n  /**\n   * Serde used to serialize the projection result, recorded in the journal.\n   *\n   * If not set, defaults to {@link GetProjectOptions.serde} when that is set,\n   * otherwise to the default serde.\n   */\n  resultSerde?: Serde<TResult>;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,WAAW,KAA+B;AACxD,QAAO"}

package/dist/package.cjs

@@ -1,6 +1,6 @@
 
 //#region package.json
-var version = "1.17.2";
+var version = "1.17.3";
 
 //#endregion
 Object.defineProperty(exports, 'version', {

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "1.17.2";
+var version = "1.17.3";
 
 //#endregion
 export { version };

package/dist/package.js.map

@@ -1 +1 @@
-{"version":3,"file":"package.js","names":[],"sources":["../package.json"],"sourcesContent":["{\n  \"name\": \"@restatedev/restate-sdk\",\n  \"version\": \"1.17.2\",\n  \"description\": \"Typescript SDK for Restate\",\n  \"author\": \"Restate Developers\",\n  \"email\": \"code@restate.dev\",\n  \"license\": \"MIT\",\n  \"homepage\": \"https://github.com/restatedev/sdk-typescript#readme\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/restatedev/sdk-typescript.git\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/restatedev/sdk-typescript/issues\"\n  },\n  \"type\": \"module\",\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.cts\",\n  \"exports\": {\n    \".\": {\n      \"import\": \"./dist/index.js\",\n      \"require\": \"./dist/index.cjs\"\n    },\n    \"./fetch\": {\n      \"import\": \"./dist/fetch.js\",\n      \"require\": \"./dist/fetch.cjs\"\n    },\n    \"./lambda\": {\n      \"import\": \"./dist/lambda.js\",\n      \"require\": \"./dist/lambda.cjs\"\n    },\n    \"./node\": {\n      \"import\": \"./dist/node.js\",\n      \"require\": \"./dist/node.cjs\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"README.md\"\n  ],\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"scripts\": {\n    \"test\": \"turbo run _test --filter={.}...\",\n    \"_test\": \"vitest run\",\n    \"build\": \"turbo run _build --filter={.}...\",\n    \"_build\": \"tsc --noEmit && tsdown\",\n    \"dev\": \"tsc --noEmit --watch\",\n    \"clean\": \"rm -rf dist *.tsbuildinfo .turbo\",\n    \"check:types\": \"turbo run _check:types --filter={.}...\",\n    \"_check:types\": \"tsc --noEmit --project tsconfig.build.json\",\n    \"lint\": \"eslint .\",\n    \"check:exports\": \"turbo run _check:exports --filter={.}...\",\n    \"_check:exports\": \"attw --pack .\",\n    \"check:api\": \"turbo run _check:api --filter={.}...\",\n    \"_check:api\": \"api-extractor run --local && api-extractor run --local --config api-extractor.fetch.json && api-extractor run --local --config api-extractor.lambda.json && api-extractor run --local --config api-extractor.node.json\",\n    \"prepublishOnly\": \"pnpm -w verify\"\n  },\n  \"dependencies\": {\n    \"@restatedev/restate-sdk-core\": \"workspace:*\"\n  },\n  \"devDependencies\": {\n    \"@types/aws-lambda\": \"^8.10.115\"\n  },\n  \"typesVersions\": {\n    \"*\": {\n      \"fetch\": [\n        \"./dist/fetch.d.ts\"\n      ],\n      \"lambda\": [\n        \"./dist/lambda.d.ts\"\n      ],\n      \"node\": [\n        \"./dist/node.d.ts\"\n      ]\n    }\n  }\n}\n"],"mappings":";cAEa"}
+{"version":3,"file":"package.js","names":[],"sources":["../package.json"],"sourcesContent":["{\n  \"name\": \"@restatedev/restate-sdk\",\n  \"version\": \"1.17.3\",\n  \"description\": \"Typescript SDK for Restate\",\n  \"author\": \"Restate Developers\",\n  \"email\": \"code@restate.dev\",\n  \"license\": \"MIT\",\n  \"homepage\": \"https://github.com/restatedev/sdk-typescript#readme\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/restatedev/sdk-typescript.git\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/restatedev/sdk-typescript/issues\"\n  },\n  \"type\": \"module\",\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.cts\",\n  \"exports\": {\n    \".\": {\n      \"import\": \"./dist/index.js\",\n      \"require\": \"./dist/index.cjs\"\n    },\n    \"./fetch\": {\n      \"import\": \"./dist/fetch.js\",\n      \"require\": \"./dist/fetch.cjs\"\n    },\n    \"./lambda\": {\n      \"import\": \"./dist/lambda.js\",\n      \"require\": \"./dist/lambda.cjs\"\n    },\n    \"./node\": {\n      \"import\": \"./dist/node.js\",\n      \"require\": \"./dist/node.cjs\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"README.md\"\n  ],\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"scripts\": {\n    \"test\": \"turbo run _test --filter={.}...\",\n    \"_test\": \"vitest run\",\n    \"build\": \"turbo run _build --filter={.}...\",\n    \"_build\": \"tsc --noEmit && tsdown\",\n    \"dev\": \"tsc --noEmit --watch\",\n    \"clean\": \"rm -rf dist *.tsbuildinfo .turbo\",\n    \"check:types\": \"turbo run _check:types --filter={.}...\",\n    \"_check:types\": \"tsc --noEmit --project tsconfig.build.json\",\n    \"lint\": \"eslint .\",\n    \"check:exports\": \"turbo run _check:exports --filter={.}...\",\n    \"_check:exports\": \"attw --pack .\",\n    \"check:api\": \"turbo run _check:api --filter={.}...\",\n    \"_check:api\": \"api-extractor run --local && api-extractor run --local --config api-extractor.fetch.json && api-extractor run --local --config api-extractor.lambda.json && api-extractor run --local --config api-extractor.node.json\",\n    \"prepublishOnly\": \"pnpm -w verify\"\n  },\n  \"dependencies\": {\n    \"@restatedev/restate-sdk-core\": \"workspace:*\"\n  },\n  \"devDependencies\": {\n    \"@types/aws-lambda\": \"^8.10.115\"\n  },\n  \"typesVersions\": {\n    \"*\": {\n      \"fetch\": [\n        \"./dist/fetch.d.ts\"\n      ],\n      \"lambda\": [\n        \"./dist/lambda.d.ts\"\n      ],\n      \"node\": [\n        \"./dist/node.d.ts\"\n      ]\n    }\n  }\n}\n"],"mappings":";cAEa"}

package/dist/promises.cjs

@@ -234,10 +234,11 @@ var ConstRestatePromise = class ConstRestatePromise extends InternalRestatePromi
 * Promises executor, gluing VM with I/O and Promises given to user space.
 */
 var PromisesExecutor = class {
-	constructor(coreVm, outputPump, runClosuresTracker, externalProgressChannel, errorCallback) {
+	constructor(coreVm, outputPump, runClosuresTracker, ephemeralRequestTracker, externalProgressChannel, errorCallback) {
 		this.coreVm = coreVm;
 		this.outputPump = outputPump;
 		this.runClosuresTracker = runClosuresTracker;
+		this.ephemeralRequestTracker = ephemeralRequestTracker;
 		this.externalProgressChannel = externalProgressChannel;
 		this.errorCallback = errorCallback;
 	}
@@ -263,6 +264,9 @@ var PromisesExecutor = class {
 				} else if (doProgressResult === "CancelSignalReceived") {
 					restatePromise.tryCancel();
 					return;
+				} else if ("EphemeralNotificationReady" in doProgressResult) {
+					const completionId = doProgressResult.EphemeralNotificationReady;
+					await this.ephemeralRequestTracker.complete(completionId, this.coreVm.take_ephemeral_notification(completionId));
 				} else {
 					this.runClosuresTracker.executeRun(doProgressResult.ExecuteRun);
 					await (0, node_timers_promises.setImmediate)();

package/dist/promises.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"promises.d.cts","names":[],"sources":["../src/promises.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;iBA8CgB,uBAAuB,QAAQ,UAAU,eAAe"}
+{"version":3,"file":"promises.d.cts","names":[],"sources":["../src/promises.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;iBAkDgB,uBAAuB,QAAQ,UAAU,eAAe"}

package/dist/promises.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promises.d.ts","names":[],"sources":["../src/promises.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;iBA8CgB,uBAAuB,QAAQ,UAAU,eAAe"}
+{"version":3,"file":"promises.d.ts","names":[],"sources":["../src/promises.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;iBAkDgB,uBAAuB,QAAQ,UAAU,eAAe"}

package/dist/promises.js

@@ -232,10 +232,11 @@ var ConstRestatePromise = class ConstRestatePromise extends InternalRestatePromi
 * Promises executor, gluing VM with I/O and Promises given to user space.
 */
 var PromisesExecutor = class {
-	constructor(coreVm, outputPump, runClosuresTracker, externalProgressChannel, errorCallback) {
+	constructor(coreVm, outputPump, runClosuresTracker, ephemeralRequestTracker, externalProgressChannel, errorCallback) {
 		this.coreVm = coreVm;
 		this.outputPump = outputPump;
 		this.runClosuresTracker = runClosuresTracker;
+		this.ephemeralRequestTracker = ephemeralRequestTracker;
 		this.externalProgressChannel = externalProgressChannel;
 		this.errorCallback = errorCallback;
 	}
@@ -261,6 +262,9 @@ var PromisesExecutor = class {
 				} else if (doProgressResult === "CancelSignalReceived") {
 					restatePromise.tryCancel();
 					return;
+				} else if ("EphemeralNotificationReady" in doProgressResult) {
+					const completionId = doProgressResult.EphemeralNotificationReady;
+					await this.ephemeralRequestTracker.complete(completionId, this.coreVm.take_ephemeral_notification(completionId));
 				} else {
 					this.runClosuresTracker.executeRun(doProgressResult.ExecuteRun);
 					await setImmediate();