@restatedev/restate-sdk-clients 1.9.1 → 1.10.1

package/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/dist/_virtual/rolldown_runtime.cjs

@@ -0,0 +1,25 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/api.cjs

@@ -0,0 +1,47 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+let __restatedev_restate_sdk_core = require("@restatedev/restate-sdk-core");
+__restatedev_restate_sdk_core = require_rolldown_runtime.__toESM(__restatedev_restate_sdk_core);
+
+//#region src/api.ts
+var Opts = class Opts {
+	/**
+	* Create a call configuration from the provided options.
+	*
+	* @param opts the call configuration
+	*/
+	static from(opts) {
+		return new Opts(opts);
+	}
+	constructor(opts) {
+		this.opts = opts;
+	}
+};
+var SendOpts = class SendOpts {
+	/**
+	* @param opts Create send options
+	*/
+	static from(opts) {
+		return new SendOpts(opts);
+	}
+	delay() {
+		if (this.opts.delay !== void 0) return (0, __restatedev_restate_sdk_core.millisOrDurationToMillis)(this.opts.delay);
+	}
+	constructor(opts) {
+		this.opts = opts;
+	}
+};
+let rpc;
+(function(_rpc) {
+	_rpc.opts = (opts) => Opts.from(opts);
+	_rpc.sendOpts = (opts) => SendOpts.from(opts);
+})(rpc || (rpc = {}));
+
+//#endregion
+exports.Opts = Opts;
+exports.SendOpts = SendOpts;
+Object.defineProperty(exports, 'rpc', {
+  enumerable: true,
+  get: function () {
+    return rpc;
+  }
+});

package/dist/api.d.cts

@@ -0,0 +1,224 @@
+import { Duration, JournalValueCodec, Serde, Service, ServiceDefinitionFrom, VirtualObject, VirtualObjectDefinitionFrom, Workflow, WorkflowDefinitionFrom } from "@restatedev/restate-sdk-core";
+
+//#region src/api.d.ts
+
+/**
+ * A remote client for a Restate service.
+ *
+ * Use the following client to interact with services defined
+ * - `serviceClient` to create a client for a service.
+ * - `workflowClient` to create a client for a workflow.
+ * - `objectClient` to create a client for a virtual object.
+ *
+ */
+interface Ingress {
+  /**
+   * Create a client from a {@link ServiceDefinition}.
+   */
+  serviceClient<D>(opts: ServiceDefinitionFrom<D>): IngressClient<Service<D>>;
+  /**
+   * Create a client from a {@link WorkflowDefinition}.
+   *
+   * @param key the key of the workflow.
+   */
+  workflowClient<D>(opts: WorkflowDefinitionFrom<D>, key: string): IngressWorkflowClient<Workflow<D>>;
+  /**
+   * Create a client from a {@link VirtualObjectDefinition}.
+   * @param key the key of the virtual object.
+   */
+  objectClient<D>(opts: VirtualObjectDefinitionFrom<D>, key: string): IngressClient<VirtualObject<D>>;
+  /**
+   * Create a client from a {@link ServiceDefinition}.
+   */
+  serviceSendClient<D>(opts: ServiceDefinitionFrom<D>): IngressSendClient<Service<D>>;
+  /**
+   * Create a client from a {@link VirtualObjectDefinition}.
+   */
+  objectSendClient<D>(opts: VirtualObjectDefinitionFrom<D>, key: string): IngressSendClient<VirtualObject<D>>;
+  /**
+   * Resolve an awakeable from the ingress client.
+   */
+  resolveAwakeable<T>(id: string, payload?: T): Promise<void>;
+  /**
+   * Reject an awakeable from the ingress client.
+   */
+  rejectAwakeable(id: string, reason: string): Promise<void>;
+  /**
+   * Obtain the result of a service that was asynchronously submitted (via a sendClient).
+   *
+   * @param send either the send response or the workflow submission as obtained by the respective clients.
+   */
+  result<T>(send: Send<T> | WorkflowSubmission<T>): Promise<T>;
+}
+interface IngressCallOptions<I$1 = unknown, O$1 = unknown> {
+  /**
+   * Key to use for idempotency key.
+   *
+   * See https://docs.restate.dev/operate/invocation#invoke-a-handler-idempotently for more details.
+   */
+  idempotencyKey?: string;
+  /**
+   * Headers to attach to the request.
+   */
+  headers?: Record<string, string>;
+  input?: Serde<I$1>;
+  output?: Serde<O$1>;
+  /**
+   * Timeout to be used when executing the request. In milliseconds.
+   *
+   * Same as {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal#aborting_a_fetch_with_timeout_or_explicit_abort | AbortSignal.timeout()}.
+   *
+   * This field is exclusive with `signal`, and using both of them will result in a runtime failure.
+   */
+  timeout?: number;
+  /**
+   * Signal to abort the underlying `fetch` operation. See {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal}.
+   *
+   * This field is exclusive with `timeout`, and using both of them will result in a runtime failure.
+   */
+  signal?: AbortSignal;
+}
+interface IngressSendOptions<I$1> extends IngressCallOptions<I$1, void> {
+  /**
+   * If set, the invocation will be enqueued now to be executed after the provided delay. In milliseconds.
+   */
+  delay?: number | Duration;
+}
+declare class Opts<I$1, O$1> {
+  readonly opts: IngressCallOptions<I$1, O$1>;
+  /**
+   * Create a call configuration from the provided options.
+   *
+   * @param opts the call configuration
+   */
+  static from<I$1 = unknown, O$1 = unknown>(opts: IngressCallOptions<I$1, O$1>): Opts<I$1, O$1>;
+  constructor(opts: IngressCallOptions<I$1, O$1>);
+}
+declare class SendOpts<I$1 = unknown> {
+  readonly opts: IngressSendOptions<I$1>;
+  /**
+   * @param opts Create send options
+   */
+  static from<I$1 = unknown>(opts: IngressSendOptions<I$1>): SendOpts<I$1>;
+  delay(): number | undefined;
+  constructor(opts: IngressSendOptions<I$1>);
+}
+type InferArgType<P$1> = P$1 extends [infer A, ...any[]] ? A : unknown;
+type IngressClient<M> = { [K in keyof M as M[K] extends never ? never : K]: M[K] extends ((arg: any, ...args: infer P) => PromiseLike<infer O>) ? (...args: [...P, ...[opts?: Opts<InferArgType<P>, O>]]) => PromiseLike<O> : never };
+declare namespace rpc {
+  const opts: <I$1, O$1>(opts: IngressCallOptions<I$1, O$1>) => Opts<I$1, O$1>;
+  const sendOpts: <I$1>(opts: IngressSendOptions<I$1>) => SendOpts<I$1>;
+}
+/**
+ * Represents the output of a workflow.
+ */
+interface Output<O$1> {
+  /**
+   * Whether the output is ready.
+   */
+  ready: boolean;
+  /**
+   * The output of the workflow.
+   */
+  result: O$1;
+}
+/**
+ * Represents a successful workflow submission.
+ *
+ */
+type WorkflowSubmission<T> = {
+  /**
+   * The invocation id of the workflow. You can use that id to
+   * with the introspection tools (restate cli, logging, metrics)
+   *
+   */
+  readonly invocationId: string;
+  readonly status: "Accepted" | "PreviouslyAccepted";
+  readonly attachable: true;
+};
+/**
+ * A client for a workflow.
+ *
+ * This client represents the workflow definition, with the following additional methods:
+ * - `workflowSubmit` to submit the workflow.
+ * - `workflowAttach` to attach to the workflow and wait for its completion
+ * - `workflowOutput` to check if the workflow's output is ready/available.
+ *
+ * Once a workflow is submitted, it can be attached to, and the output can be retrieved.
+ *
+ * @typeParam M the type of the workflow.
+ */
+type IngressWorkflowClient<M> = Omit<{ [K in keyof M as M[K] extends never ? never : K]: M[K] extends ((arg: any, ...args: infer P) => PromiseLike<infer O>) ? (...args: [...P, ...[opts?: Opts<InferArgType<P>, O>]]) => PromiseLike<O> : never } & {
+  /**
+   * Submit this workflow.
+   *
+   * This instructs restate to execute the 'run' handler of the workflow, idempotently.
+   * The workflow will be executed asynchronously, and the promise will resolve when the workflow has been accepted.
+   * Please note that submitting a workflow does not wait for it to completion, and it is safe to retry the submission,
+   * in case of failure.
+   *
+   * @param argument the same argument type as defined by the 'run' handler.
+   */
+  workflowSubmit: M extends Record<string, unknown> ? M["run"] extends ((arg: any, ...args: infer I) => Promise<infer O>) ? (...args: [...I, ...[opts?: SendOpts<InferArgType<I>>]]) => Promise<WorkflowSubmission<O>> : never : never;
+  /**
+   * Attach to this workflow.
+   *
+   * This instructs restate to attach to the workflow and wait for it to complete.
+   * It is only possible to 'attach' to a workflow that has been previously submitted.
+   * The promise will resolve when the workflow has completed either successfully with a result,
+   * or be rejected with an error.
+   * This operation is safe to retry many times, and it will always return the same result.
+   *
+   * @returns a promise that resolves when the workflow has completed.
+   */
+  workflowAttach: M extends Record<string, unknown> ? M["run"] extends ((...args: any) => Promise<infer O>) ? (opts?: Opts<void, O>) => Promise<O> : never : never;
+  /**
+   * Try retrieving the output of this workflow.
+   *
+   * This instructs restate to check if the workflow's output is ready/available.
+   * The returned Output object will have a 'ready' field set to true if the output is ready.
+   * If the output is ready, the 'result' field will contain the output.
+   * note: that this operation will not wait for the workflow to complete, to do so use 'workflowAttach'.
+   *
+   * @returns a promise that resolves if the workflow's output is ready/available.
+   */
+  workflowOutput: M extends Record<string, unknown> ? M["run"] extends ((...args: any) => Promise<infer O>) ? (opts?: Opts<void, O>) => Promise<Output<O>> : never : never;
+}, "run">;
+/**
+ * A send response.
+ *
+ * @typeParam T the type of the response.
+ */
+type Send<T = unknown> = {
+  /**
+   * The invocation id of the send.
+   */
+  invocationId: string;
+  /**
+   * The status of the send.
+   */
+  status: "Accepted" | "PreviouslyAccepted";
+  attachable: boolean;
+};
+type IngressSendClient<M> = { [K in keyof M as M[K] extends never ? never : K]: M[K] extends ((arg: any, ...args: infer P) => infer O) ? (...args: [...P, ...[opts?: SendOpts<InferArgType<P>>]]) => Promise<Send<O>> : never };
+type ConnectionOpts = {
+  /**
+   * Restate ingress URL.
+   * For example: http://localhost:8080
+   */
+  url: string;
+  /**
+   * Headers to attach on every request.
+   * Use this to attach authentication headers.
+   */
+  headers?: Record<string, string>;
+  /**
+   * Codec to use for input/outputs. Check {@link JournalValueCodec} for more details
+   *
+   * @experimental
+   */
+  journalValueCodec?: JournalValueCodec;
+};
+//#endregion
+export { ConnectionOpts, InferArgType, Ingress, IngressCallOptions, IngressClient, IngressSendClient, IngressSendOptions, IngressWorkflowClient, Opts, Output, Send, SendOpts, WorkflowSubmission, rpc };
+//# sourceMappingURL=api.d.cts.map

package/dist/api.d.cts.map

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

package/dist/api.d.ts

@@ -0,0 +1,224 @@
+import { Duration, JournalValueCodec, Serde, Service, ServiceDefinitionFrom, VirtualObject, VirtualObjectDefinitionFrom, Workflow, WorkflowDefinitionFrom } from "@restatedev/restate-sdk-core";
+
+//#region src/api.d.ts
+
+/**
+ * A remote client for a Restate service.
+ *
+ * Use the following client to interact with services defined
+ * - `serviceClient` to create a client for a service.
+ * - `workflowClient` to create a client for a workflow.
+ * - `objectClient` to create a client for a virtual object.
+ *
+ */
+interface Ingress {
+  /**
+   * Create a client from a {@link ServiceDefinition}.
+   */
+  serviceClient<D>(opts: ServiceDefinitionFrom<D>): IngressClient<Service<D>>;
+  /**
+   * Create a client from a {@link WorkflowDefinition}.
+   *
+   * @param key the key of the workflow.
+   */
+  workflowClient<D>(opts: WorkflowDefinitionFrom<D>, key: string): IngressWorkflowClient<Workflow<D>>;
+  /**
+   * Create a client from a {@link VirtualObjectDefinition}.
+   * @param key the key of the virtual object.
+   */
+  objectClient<D>(opts: VirtualObjectDefinitionFrom<D>, key: string): IngressClient<VirtualObject<D>>;
+  /**
+   * Create a client from a {@link ServiceDefinition}.
+   */
+  serviceSendClient<D>(opts: ServiceDefinitionFrom<D>): IngressSendClient<Service<D>>;
+  /**
+   * Create a client from a {@link VirtualObjectDefinition}.
+   */
+  objectSendClient<D>(opts: VirtualObjectDefinitionFrom<D>, key: string): IngressSendClient<VirtualObject<D>>;
+  /**
+   * Resolve an awakeable from the ingress client.
+   */
+  resolveAwakeable<T>(id: string, payload?: T): Promise<void>;
+  /**
+   * Reject an awakeable from the ingress client.
+   */
+  rejectAwakeable(id: string, reason: string): Promise<void>;
+  /**
+   * Obtain the result of a service that was asynchronously submitted (via a sendClient).
+   *
+   * @param send either the send response or the workflow submission as obtained by the respective clients.
+   */
+  result<T>(send: Send<T> | WorkflowSubmission<T>): Promise<T>;
+}
+interface IngressCallOptions<I$1 = unknown, O$1 = unknown> {
+  /**
+   * Key to use for idempotency key.
+   *
+   * See https://docs.restate.dev/operate/invocation#invoke-a-handler-idempotently for more details.
+   */
+  idempotencyKey?: string;
+  /**
+   * Headers to attach to the request.
+   */
+  headers?: Record<string, string>;
+  input?: Serde<I$1>;
+  output?: Serde<O$1>;
+  /**
+   * Timeout to be used when executing the request. In milliseconds.
+   *
+   * Same as {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal#aborting_a_fetch_with_timeout_or_explicit_abort | AbortSignal.timeout()}.
+   *
+   * This field is exclusive with `signal`, and using both of them will result in a runtime failure.
+   */
+  timeout?: number;
+  /**
+   * Signal to abort the underlying `fetch` operation. See {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal}.
+   *
+   * This field is exclusive with `timeout`, and using both of them will result in a runtime failure.
+   */
+  signal?: AbortSignal;
+}
+interface IngressSendOptions<I$1> extends IngressCallOptions<I$1, void> {
+  /**
+   * If set, the invocation will be enqueued now to be executed after the provided delay. In milliseconds.
+   */
+  delay?: number | Duration;
+}
+declare class Opts<I$1, O$1> {
+  readonly opts: IngressCallOptions<I$1, O$1>;
+  /**
+   * Create a call configuration from the provided options.
+   *
+   * @param opts the call configuration
+   */
+  static from<I$1 = unknown, O$1 = unknown>(opts: IngressCallOptions<I$1, O$1>): Opts<I$1, O$1>;
+  constructor(opts: IngressCallOptions<I$1, O$1>);
+}
+declare class SendOpts<I$1 = unknown> {
+  readonly opts: IngressSendOptions<I$1>;
+  /**
+   * @param opts Create send options
+   */
+  static from<I$1 = unknown>(opts: IngressSendOptions<I$1>): SendOpts<I$1>;
+  delay(): number | undefined;
+  constructor(opts: IngressSendOptions<I$1>);
+}
+type InferArgType<P$1> = P$1 extends [infer A, ...any[]] ? A : unknown;
+type IngressClient<M> = { [K in keyof M as M[K] extends never ? never : K]: M[K] extends ((arg: any, ...args: infer P) => PromiseLike<infer O>) ? (...args: [...P, ...[opts?: Opts<InferArgType<P>, O>]]) => PromiseLike<O> : never };
+declare namespace rpc {
+  const opts: <I$1, O$1>(opts: IngressCallOptions<I$1, O$1>) => Opts<I$1, O$1>;
+  const sendOpts: <I$1>(opts: IngressSendOptions<I$1>) => SendOpts<I$1>;
+}
+/**
+ * Represents the output of a workflow.
+ */
+interface Output<O$1> {
+  /**
+   * Whether the output is ready.
+   */
+  ready: boolean;
+  /**
+   * The output of the workflow.
+   */
+  result: O$1;
+}
+/**
+ * Represents a successful workflow submission.
+ *
+ */
+type WorkflowSubmission<T> = {
+  /**
+   * The invocation id of the workflow. You can use that id to
+   * with the introspection tools (restate cli, logging, metrics)
+   *
+   */
+  readonly invocationId: string;
+  readonly status: "Accepted" | "PreviouslyAccepted";
+  readonly attachable: true;
+};
+/**
+ * A client for a workflow.
+ *
+ * This client represents the workflow definition, with the following additional methods:
+ * - `workflowSubmit` to submit the workflow.
+ * - `workflowAttach` to attach to the workflow and wait for its completion
+ * - `workflowOutput` to check if the workflow's output is ready/available.
+ *
+ * Once a workflow is submitted, it can be attached to, and the output can be retrieved.
+ *
+ * @typeParam M the type of the workflow.
+ */
+type IngressWorkflowClient<M> = Omit<{ [K in keyof M as M[K] extends never ? never : K]: M[K] extends ((arg: any, ...args: infer P) => PromiseLike<infer O>) ? (...args: [...P, ...[opts?: Opts<InferArgType<P>, O>]]) => PromiseLike<O> : never } & {
+  /**
+   * Submit this workflow.
+   *
+   * This instructs restate to execute the 'run' handler of the workflow, idempotently.
+   * The workflow will be executed asynchronously, and the promise will resolve when the workflow has been accepted.
+   * Please note that submitting a workflow does not wait for it to completion, and it is safe to retry the submission,
+   * in case of failure.
+   *
+   * @param argument the same argument type as defined by the 'run' handler.
+   */
+  workflowSubmit: M extends Record<string, unknown> ? M["run"] extends ((arg: any, ...args: infer I) => Promise<infer O>) ? (...args: [...I, ...[opts?: SendOpts<InferArgType<I>>]]) => Promise<WorkflowSubmission<O>> : never : never;
+  /**
+   * Attach to this workflow.
+   *
+   * This instructs restate to attach to the workflow and wait for it to complete.
+   * It is only possible to 'attach' to a workflow that has been previously submitted.
+   * The promise will resolve when the workflow has completed either successfully with a result,
+   * or be rejected with an error.
+   * This operation is safe to retry many times, and it will always return the same result.
+   *
+   * @returns a promise that resolves when the workflow has completed.
+   */
+  workflowAttach: M extends Record<string, unknown> ? M["run"] extends ((...args: any) => Promise<infer O>) ? (opts?: Opts<void, O>) => Promise<O> : never : never;
+  /**
+   * Try retrieving the output of this workflow.
+   *
+   * This instructs restate to check if the workflow's output is ready/available.
+   * The returned Output object will have a 'ready' field set to true if the output is ready.
+   * If the output is ready, the 'result' field will contain the output.
+   * note: that this operation will not wait for the workflow to complete, to do so use 'workflowAttach'.
+   *
+   * @returns a promise that resolves if the workflow's output is ready/available.
+   */
+  workflowOutput: M extends Record<string, unknown> ? M["run"] extends ((...args: any) => Promise<infer O>) ? (opts?: Opts<void, O>) => Promise<Output<O>> : never : never;
+}, "run">;
+/**
+ * A send response.
+ *
+ * @typeParam T the type of the response.
+ */
+type Send<T = unknown> = {
+  /**
+   * The invocation id of the send.
+   */
+  invocationId: string;
+  /**
+   * The status of the send.
+   */
+  status: "Accepted" | "PreviouslyAccepted";
+  attachable: boolean;
+};
+type IngressSendClient<M> = { [K in keyof M as M[K] extends never ? never : K]: M[K] extends ((arg: any, ...args: infer P) => infer O) ? (...args: [...P, ...[opts?: SendOpts<InferArgType<P>>]]) => Promise<Send<O>> : never };
+type ConnectionOpts = {
+  /**
+   * Restate ingress URL.
+   * For example: http://localhost:8080
+   */
+  url: string;
+  /**
+   * Headers to attach on every request.
+   * Use this to attach authentication headers.
+   */
+  headers?: Record<string, string>;
+  /**
+   * Codec to use for input/outputs. Check {@link JournalValueCodec} for more details
+   *
+   * @experimental
+   */
+  journalValueCodec?: JournalValueCodec;
+};
+//#endregion
+export { ConnectionOpts, InferArgType, Ingress, IngressCallOptions, IngressClient, IngressSendClient, IngressSendOptions, IngressWorkflowClient, Opts, Output, Send, SendOpts, WorkflowSubmission, rpc };
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

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

package/dist/api.js

@@ -0,0 +1,39 @@
+import { millisOrDurationToMillis } from "@restatedev/restate-sdk-core";
+
+//#region src/api.ts
+var Opts = class Opts {
+	/**
+	* Create a call configuration from the provided options.
+	*
+	* @param opts the call configuration
+	*/
+	static from(opts) {
+		return new Opts(opts);
+	}
+	constructor(opts) {
+		this.opts = opts;
+	}
+};
+var SendOpts = class SendOpts {
+	/**
+	* @param opts Create send options
+	*/
+	static from(opts) {
+		return new SendOpts(opts);
+	}
+	delay() {
+		if (this.opts.delay !== void 0) return millisOrDurationToMillis(this.opts.delay);
+	}
+	constructor(opts) {
+		this.opts = opts;
+	}
+};
+let rpc;
+(function(_rpc) {
+	_rpc.opts = (opts) => Opts.from(opts);
+	_rpc.sendOpts = (opts) => SendOpts.from(opts);
+})(rpc || (rpc = {}));
+
+//#endregion
+export { Opts, SendOpts, rpc };
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","names":["opts: IngressCallOptions<I, O>","opts: IngressSendOptions<I>"],"sources":["../src/api.ts"],"sourcesContent":["import type {\n  Service,\n  VirtualObjectDefinitionFrom,\n  Workflow,\n  VirtualObject,\n  ServiceDefinitionFrom,\n  WorkflowDefinitionFrom,\n  Serde,\n  Duration,\n  JournalValueCodec,\n} from \"@restatedev/restate-sdk-core\";\nimport { millisOrDurationToMillis } from \"@restatedev/restate-sdk-core\";\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * A remote client for a Restate service.\n *\n * Use the following client to interact with services defined\n * - `serviceClient` to create a client for a service.\n * - `workflowClient` to create a client for a workflow.\n * - `objectClient` to create a client for a virtual object.\n *\n */\nexport interface Ingress {\n  /**\n   * Create a client from a {@link ServiceDefinition}.\n   */\n  serviceClient<D>(opts: ServiceDefinitionFrom<D>): IngressClient<Service<D>>;\n\n  /**\n   * Create a client from a {@link WorkflowDefinition}.\n   *\n   * @param key the key of the workflow.\n   */\n  workflowClient<D>(\n    opts: WorkflowDefinitionFrom<D>,\n    key: string\n  ): IngressWorkflowClient<Workflow<D>>;\n\n  /**\n   * Create a client from a {@link VirtualObjectDefinition}.\n   * @param key the key of the virtual object.\n   */\n  objectClient<D>(\n    opts: VirtualObjectDefinitionFrom<D>,\n    key: string\n  ): IngressClient<VirtualObject<D>>;\n\n  /**\n   * Create a client from a {@link ServiceDefinition}.\n   */\n  serviceSendClient<D>(\n    opts: ServiceDefinitionFrom<D>\n  ): IngressSendClient<Service<D>>;\n\n  /**\n   * Create a client from a {@link VirtualObjectDefinition}.\n   */\n  objectSendClient<D>(\n    opts: VirtualObjectDefinitionFrom<D>,\n    key: string\n  ): IngressSendClient<VirtualObject<D>>;\n\n  /**\n   * Resolve an awakeable from the ingress client.\n   */\n  resolveAwakeable<T>(id: string, payload?: T): Promise<void>;\n\n  /**\n   * Reject an awakeable from the ingress client.\n   */\n  rejectAwakeable(id: string, reason: string): Promise<void>;\n\n  /**\n   * Obtain the result of a service that was asynchronously submitted (via a sendClient).\n   *\n   * @param send either the send response or the workflow submission as obtained by the respective clients.\n   */\n  result<T>(send: Send<T> | WorkflowSubmission<T>): Promise<T>;\n}\n\nexport interface IngressCallOptions<I = unknown, O = unknown> {\n  /**\n   * Key to use for idempotency key.\n   *\n   * See https://docs.restate.dev/operate/invocation#invoke-a-handler-idempotently for more details.\n   */\n  idempotencyKey?: string;\n\n  /**\n   * Headers to attach to the request.\n   */\n  headers?: Record<string, string>;\n\n  input?: Serde<I>;\n\n  output?: Serde<O>;\n\n  /**\n   * Timeout to be used when executing the request. In milliseconds.\n   *\n   * Same as {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal#aborting_a_fetch_with_timeout_or_explicit_abort | AbortSignal.timeout()}.\n   *\n   * This field is exclusive with `signal`, and using both of them will result in a runtime failure.\n   */\n  timeout?: number;\n\n  /**\n   * Signal to abort the underlying `fetch` operation. See {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal}.\n   *\n   * This field is exclusive with `timeout`, and using both of them will result in a runtime failure.\n   */\n  signal?: AbortSignal;\n}\n\nexport interface IngressSendOptions<I> extends IngressCallOptions<I, void> {\n  /**\n   * If set, the invocation will be enqueued now to be executed after the provided delay. In milliseconds.\n   */\n  delay?: number | Duration;\n}\n\nexport class Opts<I, O> {\n  /**\n   * Create a call configuration from the provided options.\n   *\n   * @param opts the call configuration\n   */\n  public static from<I = unknown, O = unknown>(\n    opts: IngressCallOptions<I, O>\n  ): Opts<I, O> {\n    return new Opts(opts);\n  }\n\n  constructor(readonly opts: IngressCallOptions<I, O>) {}\n}\n\nexport class SendOpts<I = unknown> {\n  /**\n   * @param opts Create send options\n   */\n  public static from<I = unknown>(opts: IngressSendOptions<I>): SendOpts<I> {\n    return new SendOpts(opts);\n  }\n\n  delay(): number | undefined {\n    if (this.opts.delay !== undefined) {\n      return millisOrDurationToMillis(this.opts.delay);\n    }\n    return undefined;\n  }\n\n  constructor(readonly opts: IngressSendOptions<I>) {}\n}\n\nexport type InferArgType<P> = P extends [infer A, ...any[]] ? A : unknown;\n\nexport type IngressClient<M> = {\n  [K in keyof M as M[K] extends never ? never : K]: M[K] extends (\n    arg: any,\n    ...args: infer P\n  ) => PromiseLike<infer O>\n    ? (...args: [...P, ...[opts?: Opts<InferArgType<P>, O>]]) => PromiseLike<O>\n    : never;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-namespace\nexport namespace rpc {\n  export const opts = <I, O>(opts: IngressCallOptions<I, O>) => Opts.from(opts);\n\n  export const sendOpts = <I>(opts: IngressSendOptions<I>) =>\n    SendOpts.from(opts);\n}\n\n/**\n * Represents the output of a workflow.\n */\nexport interface Output<O> {\n  /**\n   * Whether the output is ready.\n   */\n  ready: boolean;\n\n  /**\n   * The output of the workflow.\n   */\n  result: O;\n}\n\n/**\n * Represents a successful workflow submission.\n *\n */\n/* eslint-disable-next-line @typescript-eslint/no-unused-vars */\nexport type WorkflowSubmission<T> = {\n  /**\n   * The invocation id of the workflow. You can use that id to\n   * with the introspection tools (restate cli, logging, metrics)\n   *\n   */\n  readonly invocationId: string;\n  readonly status: \"Accepted\" | \"PreviouslyAccepted\";\n  readonly attachable: true;\n};\n\n/**\n * A client for a workflow.\n *\n * This client represents the workflow definition, with the following additional methods:\n * - `workflowSubmit` to submit the workflow.\n * - `workflowAttach` to attach to the workflow and wait for its completion\n * - `workflowOutput` to check if the workflow's output is ready/available.\n *\n * Once a workflow is submitted, it can be attached to, and the output can be retrieved.\n *\n * @typeParam M the type of the workflow.\n */\nexport type IngressWorkflowClient<M> = Omit<\n  {\n    [K in keyof M as M[K] extends never ? never : K]: M[K] extends (\n      arg: any,\n      ...args: infer P\n    ) => PromiseLike<infer O>\n      ? (\n          ...args: [...P, ...[opts?: Opts<InferArgType<P>, O>]]\n        ) => PromiseLike<O>\n      : never;\n  } & {\n    /**\n     * Submit this workflow.\n     *\n     * This instructs restate to execute the 'run' handler of the workflow, idempotently.\n     * The workflow will be executed asynchronously, and the promise will resolve when the workflow has been accepted.\n     * Please note that submitting a workflow does not wait for it to completion, and it is safe to retry the submission,\n     * in case of failure.\n     *\n     * @param argument the same argument type as defined by the 'run' handler.\n     */\n    workflowSubmit: M extends Record<string, unknown>\n      ? M[\"run\"] extends (arg: any, ...args: infer I) => Promise<infer O>\n        ? (\n            ...args: [...I, ...[opts?: SendOpts<InferArgType<I>>]]\n          ) => Promise<WorkflowSubmission<O>>\n        : never\n      : never;\n\n    /**\n     * Attach to this workflow.\n     *\n     * This instructs restate to attach to the workflow and wait for it to complete.\n     * It is only possible to 'attach' to a workflow that has been previously submitted.\n     * The promise will resolve when the workflow has completed either successfully with a result,\n     * or be rejected with an error.\n     * This operation is safe to retry many times, and it will always return the same result.\n     *\n     * @returns a promise that resolves when the workflow has completed.\n     */\n    workflowAttach: M extends Record<string, unknown>\n      ? M[\"run\"] extends (...args: any) => Promise<infer O>\n        ? (opts?: Opts<void, O>) => Promise<O>\n        : never\n      : never;\n\n    /**\n     * Try retrieving the output of this workflow.\n     *\n     * This instructs restate to check if the workflow's output is ready/available.\n     * The returned Output object will have a 'ready' field set to true if the output is ready.\n     * If the output is ready, the 'result' field will contain the output.\n     * note: that this operation will not wait for the workflow to complete, to do so use 'workflowAttach'.\n     *\n     * @returns a promise that resolves if the workflow's output is ready/available.\n     */\n    workflowOutput: M extends Record<string, unknown>\n      ? M[\"run\"] extends (...args: any) => Promise<infer O>\n        ? (opts?: Opts<void, O>) => Promise<Output<O>>\n        : never\n      : never;\n  },\n  \"run\"\n>;\n\n/**\n * A send response.\n *\n * @typeParam T the type of the response.\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport type Send<T = unknown> = {\n  /**\n   * The invocation id of the send.\n   */\n  invocationId: string;\n\n  /**\n   * The status of the send.\n   */\n  status: \"Accepted\" | \"PreviouslyAccepted\";\n\n  attachable: boolean;\n};\n\nexport type IngressSendClient<M> = {\n  [K in keyof M as M[K] extends never ? never : K]: M[K] extends (\n    arg: any,\n    ...args: infer P\n  ) => infer O\n    ? (\n        ...args: [...P, ...[opts?: SendOpts<InferArgType<P>>]]\n      ) => Promise<Send<O>>\n    : never;\n};\n\nexport type ConnectionOpts = {\n  /**\n   * Restate ingress URL.\n   * For example: http://localhost:8080\n   */\n  url: string;\n  /**\n   * Headers to attach on every request.\n   * Use this to attach authentication headers.\n   */\n  headers?: Record<string, string>;\n\n  /**\n   * Codec to use for input/outputs. Check {@link JournalValueCodec} for more details\n   *\n   * @experimental\n   */\n  journalValueCodec?: JournalValueCodec;\n};\n"],"mappings":";;;AA2HA,IAAa,OAAb,MAAa,KAAW;;;;;;CAMtB,OAAc,KACZ,MACY;AACZ,SAAO,IAAI,KAAK,KAAK;;CAGvB,YAAY,AAASA,MAAgC;EAAhC;;;AAGvB,IAAa,WAAb,MAAa,SAAsB;;;;CAIjC,OAAc,KAAkB,MAA0C;AACxE,SAAO,IAAI,SAAS,KAAK;;CAG3B,QAA4B;AAC1B,MAAI,KAAK,KAAK,UAAU,OACtB,QAAO,yBAAyB,KAAK,KAAK,MAAM;;CAKpD,YAAY,AAASC,MAA6B;EAA7B;;;;;cAgBM,SAAmC,KAAK,KAAK,KAAK;kBAEjD,SAC1B,SAAS,KAAK,KAAK"}

package/dist/index.cjs

@@ -0,0 +1,22 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_api = require('./api.cjs');
+const require_ingress = require('./ingress.cjs');
+let __restatedev_restate_sdk_core = require("@restatedev/restate-sdk-core");
+__restatedev_restate_sdk_core = require_rolldown_runtime.__toESM(__restatedev_restate_sdk_core);
+
+exports.HttpCallError = require_ingress.HttpCallError;
+exports.Opts = require_api.Opts;
+exports.SendOpts = require_api.SendOpts;
+exports.connect = require_ingress.connect;
+Object.defineProperty(exports, 'rpc', {
+  enumerable: true,
+  get: function () {
+    return require_api.rpc;
+  }
+});
+Object.defineProperty(exports, 'serde', {
+  enumerable: true,
+  get: function () {
+    return __restatedev_restate_sdk_core.serde;
+  }
+});

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+import { ConnectionOpts, InferArgType, Ingress, IngressCallOptions, IngressClient, IngressSendClient, IngressSendOptions, IngressWorkflowClient, Opts, Output, Send, SendOpts, WorkflowSubmission, rpc } from "./api.cjs";
+import { HttpCallError, connect } from "./ingress.cjs";
+import { Duration, JournalValueCodec, Serde, Service, ServiceDefinition, ServiceDefinitionFrom, VirtualObject, VirtualObjectDefinition, VirtualObjectDefinitionFrom, Workflow, WorkflowDefinition, WorkflowDefinitionFrom, serde } from "@restatedev/restate-sdk-core";
+export { type ConnectionOpts, type Duration, HttpCallError, type InferArgType, type Ingress, type IngressCallOptions, type IngressClient, type IngressSendClient, type IngressSendOptions, type IngressWorkflowClient, type JournalValueCodec, Opts, type Output, type Send, SendOpts, type Serde, type Service, type ServiceDefinition, type ServiceDefinitionFrom, type VirtualObject, type VirtualObjectDefinition, type VirtualObjectDefinitionFrom, type Workflow, type WorkflowDefinition, type WorkflowDefinitionFrom, type WorkflowSubmission, connect, rpc, serde };