@restatedev/restate-sdk-cloudflare-workers 1.6.0 → 1.7.0

package/dist/esm/src/types/discovery.d.ts

@@ -1,46 +1,138 @@
-export declare enum ProtocolMode {
-    BIDI_STREAM = "BIDI_STREAM",
-    REQUEST_RESPONSE = "REQUEST_RESPONSE"
-}
-export declare enum ServiceType {
-    VIRTUAL_OBJECT = "VIRTUAL_OBJECT",
-    SERVICE = "SERVICE",
-    WORKFLOW = "WORKFLOW"
+/**
+ * This file was automatically generated by json-schema-to-typescript.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
+ * and run json-schema-to-typescript to regenerate this file.
+ */
+export type ProtocolMode = "BIDI_STREAM" | "REQUEST_RESPONSE";
+export type ServiceType = "VIRTUAL_OBJECT" | "SERVICE" | "WORKFLOW";
+/**
+ * If unspecified, defaults to EXCLUSIVE for Virtual Object or WORKFLOW for Workflows. This should be unset for Services.
+ */
+export type HandlerType = "WORKFLOW" | "EXCLUSIVE" | "SHARED";
+/**
+ * Restate endpoint manifest v3
+ */
+export interface Endpoint {
+    protocolMode?: ProtocolMode;
+    /**
+     * Minimum supported protocol version
+     */
+    minProtocolVersion: number;
+    /**
+     * Maximum supported protocol version
+     */
+    maxProtocolVersion: number;
+    services: Service[];
 }
-export declare enum ServiceHandlerType {
-    WORKFLOW = "WORKFLOW",
-    EXCLUSIVE = "EXCLUSIVE",
-    SHARED = "SHARED"
+export interface Service {
+    name: string;
+    /**
+     * Documentation for this service definition. No format is enforced, but generally Markdown is assumed.
+     */
+    documentation?: string;
+    ty: ServiceType;
+    handlers: Handler[];
+    /**
+     * Inactivity timeout duration, expressed in milliseconds.
+     */
+    inactivityTimeout?: number;
+    /**
+     * Abort timeout duration, expressed in milliseconds.
+     */
+    abortTimeout?: number;
+    /**
+     * Journal retention duration, expressed in milliseconds.
+     */
+    journalRetention?: number;
+    /**
+     * Idempotency retention duration, expressed in milliseconds. When ServiceType == WORKFLOW, this option will be applied only to the shared handlers. See workflowCompletionRetention for more details.
+     */
+    idempotencyRetention?: number;
+    /**
+     * If true, lazy state is enabled.
+     */
+    enableLazyState?: boolean;
+    /**
+     * If true, the service cannot be invoked from the HTTP nor Kafka ingress.
+     */
+    ingressPrivate?: boolean;
+    /**
+     * Custom metadata of this service definition. This metadata is shown on the Admin API when querying the service definition.
+     */
+    metadata?: {
+        [k: string]: string;
+    };
 }
-export type InputPayload = {
-    required?: boolean;
-    contentType?: string;
-    jsonSchema?: any;
-};
-export type OutputPayload = {
-    contentType?: string;
-    setContentTypeIfEmpty: boolean;
-    jsonSchema?: any;
-};
 export interface Handler {
     name: string;
-    ty?: ServiceHandlerType;
+    /**
+     * Documentation for this handler definition. No format is enforced, but generally Markdown is assumed.
+     */
+    documentation?: string;
+    ty?: HandlerType;
     input?: InputPayload;
     output?: OutputPayload;
-    metadata?: Record<string, string>;
-    documentation?: string;
+    /**
+     * Inactivity timeout duration, expressed in milliseconds.
+     */
+    inactivityTimeout?: number;
+    /**
+     * Abort timeout duration, expressed in milliseconds.
+     */
+    abortTimeout?: number;
+    /**
+     * Journal retention duration, expressed in milliseconds.
+     */
+    journalRetention?: number;
+    /**
+     * Idempotency retention duration, expressed in milliseconds. This is NOT VALID when HandlerType == WORKFLOW
+     */
+    idempotencyRetention?: number;
+    /**
+     * Workflow completion retention duration, expressed in milliseconds. This is valid ONLY when HandlerType == WORKFLOW
+     */
+    workflowCompletionRetention?: number;
+    /**
+     * If true, lazy state is enabled.
+     */
+    enableLazyState?: boolean;
+    /**
+     * If true, the service cannot be invoked from the HTTP nor Kafka ingress.
+     */
+    ingressPrivate?: boolean;
+    /**
+     * Custom metadata of this handler definition. This metadata is shown on the Admin API when querying the service/handler definition.
+     */
+    metadata?: {
+        [k: string]: string;
+    };
 }
-export interface Service {
-    name: string;
-    ty: ServiceType;
-    handlers: Handler[];
-    metadata?: Record<string, string>;
-    documentations?: string;
+/**
+ * Description of an input payload. This will be used by Restate to validate incoming requests.
+ */
+export interface InputPayload {
+    /**
+     * If true, a body MUST be sent with a content-type, even if the body length is zero.
+     */
+    required?: boolean;
+    /**
+     * Content type of the input. It can accept wildcards, in the same format as the 'Accept' header. When this field is unset, it implies emptiness, meaning no content-type/body is expected.
+     */
+    contentType?: string;
+    jsonSchema?: unknown;
 }
-export interface Endpoint {
-    protocolMode: ProtocolMode;
-    minProtocolVersion: number;
-    maxProtocolVersion: number;
-    services: Service[];
+/**
+ * Description of an output payload.
+ */
+export interface OutputPayload {
+    /**
+     * Content type set on output. This will be used by Restate to set the output content type at the ingress.
+     */
+    contentType?: string;
+    /**
+     * If true, the specified content-type is set even if the output is empty.
+     */
+    setContentTypeIfEmpty?: boolean;
+    jsonSchema?: unknown;
 }
 //# sourceMappingURL=discovery.d.ts.map

package/dist/esm/src/types/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../../src/types/discovery.ts"],"names":[],"mappings":"AAWA,oBAAY,YAAY;IACtB,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;CACtC;AAED,oBAAY,WAAW;IACrB,cAAc,mBAAmB;IACjC,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAED,oBAAY,kBAAkB;IAC5B,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,OAAO,CAAC;IAE/B,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,WAAW,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../../src/types/discovery.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,SAAS,GAAG,UAAU,CAAC;AACpE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AACD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,EAAE,EAAE,WAAW,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KACrB,CAAC;CACH;AACD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;OAEG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KACrB,CAAC;CACH;AACD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AACD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/esm/src/types/discovery.js

@@ -1,28 +1,8 @@
-/*
- * Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH
- *
- * This file is part of the Restate SDK for Node.js/TypeScript,
- * which is released under the MIT license.
- *
- * You can find a copy of the license in file LICENSE in the root
- * directory of this repository or package, or at
- * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE
+/* eslint-disable */
+/**
+ * This file was automatically generated by json-schema-to-typescript.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
+ * and run json-schema-to-typescript to regenerate this file.
  */
-export var ProtocolMode;
-(function (ProtocolMode) {
-    ProtocolMode["BIDI_STREAM"] = "BIDI_STREAM";
-    ProtocolMode["REQUEST_RESPONSE"] = "REQUEST_RESPONSE";
-})(ProtocolMode || (ProtocolMode = {}));
-export var ServiceType;
-(function (ServiceType) {
-    ServiceType["VIRTUAL_OBJECT"] = "VIRTUAL_OBJECT";
-    ServiceType["SERVICE"] = "SERVICE";
-    ServiceType["WORKFLOW"] = "WORKFLOW";
-})(ServiceType || (ServiceType = {}));
-export var ServiceHandlerType;
-(function (ServiceHandlerType) {
-    ServiceHandlerType["WORKFLOW"] = "WORKFLOW";
-    ServiceHandlerType["EXCLUSIVE"] = "EXCLUSIVE";
-    ServiceHandlerType["SHARED"] = "SHARED";
-})(ServiceHandlerType || (ServiceHandlerType = {}));
+export {};
 //# sourceMappingURL=discovery.js.map

package/dist/esm/src/types/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../../src/types/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,2CAA2B,CAAA;IAC3B,qDAAqC,CAAA;AACvC,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB;AAED,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,gDAAiC,CAAA;IACjC,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;AACvB,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAED,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,2CAAqB,CAAA;IACrB,6CAAuB,CAAA;IACvB,uCAAiB,CAAA;AACnB,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B"}
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../../src/types/discovery.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;GAIG"}

package/dist/esm/src/types/errors.d.ts

@@ -2,8 +2,10 @@ export declare const INTERNAL_ERROR_CODE = 500;
 export declare const TIMEOUT_ERROR_CODE = 408;
 export declare const CANCEL_ERROR_CODE = 409;
 export declare const UNKNOWN_ERROR_CODE = 500;
+export declare const CLOSED_ERROR_CODE = 598;
 export declare const SUSPENDED_ERROR_CODE = 599;
 export declare function ensureError(e: unknown): Error;
+export declare function logError(log: Console, e: unknown): void;
 export declare class RestateError extends Error {
     readonly code: number;
     name: string;

package/dist/esm/src/types/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/types/errors.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAGtC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAmB7C;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,SAAkB;gBAEjB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE;CAI3E;AAID,qBAAa,aAAc,SAAQ,YAAY;IACtC,IAAI,SAAmB;gBAElB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE;CAG3E;AAED,qBAAa,YAAa,SAAQ,aAAa;IACtC,IAAI,SAAkB;;CAK9B;AAED,qBAAa,cAAe,SAAQ,aAAa;IACxC,IAAI,SAAoB;;CAKhC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/types/errors.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAGtC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAmB7C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,QAiBhD;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,SAAkB;gBAEjB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE;CAI3E;AAID,qBAAa,aAAc,SAAQ,YAAY;IACtC,IAAI,SAAmB;gBAElB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE;CAG3E;AAED,qBAAa,YAAa,SAAQ,aAAa;IACtC,IAAI,SAAkB;;CAK9B;AAED,qBAAa,cAAe,SAAQ,aAAa;IACxC,IAAI,SAAoB;;CAKhC"}

package/dist/esm/src/types/errors.js

@@ -14,6 +14,7 @@ export const TIMEOUT_ERROR_CODE = 408;
 export const CANCEL_ERROR_CODE = 409;
 export const UNKNOWN_ERROR_CODE = 500;
 // From shared core!
+export const CLOSED_ERROR_CODE = 598;
 export const SUSPENDED_ERROR_CODE = 599;
 export function ensureError(e) {
     if (e instanceof Error) {
@@ -34,6 +35,22 @@ export function ensureError(e) {
     }
     return new Error("Non-Error value: " + msg);
 }
+export function logError(log, e) {
+    if (e instanceof RestateError) {
+        if (e.code === SUSPENDED_ERROR_CODE) {
+            log.info("Invocation suspended");
+            return;
+        }
+        else if (e.code === CLOSED_ERROR_CODE) {
+            log.error("DANGER! The invocation is closed, but some related operation is still running. \n" +
+                "This might indicate that a RestatePromise is being awaited on an asynchronous task, outside the handler, or you're awaiting a RestatePromise inside a ctx.run.\n" +
+                "This is dangerous, and can lead the service to deadlock. Please fix the issue.\n" +
+                "Diagnostic: ", e);
+            return;
+        }
+    }
+    log.warn("Error when processing a Restate context operation.\n", e);
+}
 export class RestateError extends Error {
     code;
     name = "RestateError";

package/dist/esm/src/types/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,uDAAuD;AAEvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC,oBAAoB;AACpB,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,MAAM,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACzE,+BAA+B;QAC/B,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,OAAiB,EAAE;YAC3C,SAAS,EAAE,CAAC,CAAC,IAAc;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC;IACR,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,GAAG,0BAA0B,CAAC;IACnC,CAAC;IAED,OAAO,IAAI,KAAK,CAAC,mBAAmB,GAAG,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrB,IAAI,CAAS;IACtB,IAAI,GAAG,cAAc,CAAC;IAE7B,YAAY,OAAe,EAAE,OAA6C;QACxE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,SAAS,IAAI,mBAAmB,CAAC;IACxD,CAAC;CACF;AAED,mCAAmC;AACnC,oDAAoD;AACpD,MAAM,OAAO,aAAc,SAAQ,YAAY;IACtC,IAAI,GAAG,eAAe,CAAC;IAE9B,YAAY,OAAe,EAAE,OAA6C;QACxE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,aAAa;IACtC,IAAI,GAAG,cAAc,CAAC;IAE7B;QACE,KAAK,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,aAAa;IACxC,IAAI,GAAG,gBAAgB,CAAC;IAE/B;QACE,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACvD,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,uDAAuD;AAEvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC,oBAAoB;AACpB,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,MAAM,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACzE,+BAA+B;QAC/B,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,OAAiB,EAAE;YAC3C,SAAS,EAAE,CAAC,CAAC,IAAc;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC;IACR,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,GAAG,0BAA0B,CAAC;IACnC,CAAC;IAED,OAAO,IAAI,KAAK,CAAC,mBAAmB,GAAG,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAY,EAAE,CAAU;IAC/C,IAAI,CAAC,YAAY,YAAY,EAAE,CAAC;QAC9B,IAAI,CAAC,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;YACpC,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YACxC,GAAG,CAAC,KAAK,CACP,mFAAmF;gBACjF,kKAAkK;gBAClK,kFAAkF;gBAClF,cAAc,EAChB,CAAC,CACF,CAAC;YACF,OAAO;QACT,CAAC;IACH,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,sDAAsD,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrB,IAAI,CAAS;IACtB,IAAI,GAAG,cAAc,CAAC;IAE7B,YAAY,OAAe,EAAE,OAA6C;QACxE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,SAAS,IAAI,mBAAmB,CAAC;IACxD,CAAC;CACF;AAED,mCAAmC;AACnC,oDAAoD;AACpD,MAAM,OAAO,aAAc,SAAQ,YAAY;IACtC,IAAI,GAAG,eAAe,CAAC;IAE9B,YAAY,OAAe,EAAE,OAA6C;QACxE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,aAAa;IACtC,IAAI,GAAG,cAAc,CAAC;IAE7B;QACE,KAAK,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,aAAa;IACxC,IAAI,GAAG,gBAAgB,CAAC;IAE/B;QACE,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/esm/src/types/rpc.d.ts

@@ -1,5 +1,5 @@
 import type { Context, GenericCall, GenericSend, InvocationHandle, InvocationPromise, ObjectContext, ObjectSharedContext, TypedState, UntypedState, WorkflowContext, WorkflowSharedContext } from "../context.js";
-import { type ServiceHandler, type ServiceDefinition, type ObjectHandler, type VirtualObjectDefinition, type WorkflowHandler, type WorkflowDefinition, type WorkflowSharedHandler, type Serde } from "@restatedev/restate-sdk-core";
+import { type ServiceHandler, type ServiceDefinition, type ObjectHandler, type VirtualObjectDefinition, type WorkflowHandler, type WorkflowDefinition, type WorkflowSharedHandler, type Serde, type Duration } from "@restatedev/restate-sdk-core";
 export type ClientCallOptions<I, O> = {
     input?: Serde<I>;
     output?: Serde<O>;
@@ -19,7 +19,32 @@ export declare class Opts<I, O> {
 }
 export type ClientSendOptions<I> = {
     input?: Serde<I>;
-    delay?: number;
+    /**
+     * Makes a type-safe one-way RPC to the specified target service, after a delay specified by the
+     * milliseconds' argument.
+     * This method is like setting up a fault-tolerant cron job that enqueues the message in a
+     * message queue.
+     * The handler calling this function does not have to stay active for the delay time.
+     *
+     * Both the delay timer and the message are durably stored in Restate and guaranteed to be reliably
+     * delivered. The delivery happens no earlier than specified through the delay, but may happen
+     * later, if the target service is down, or backpressuring the system.
+     *
+     * The delay message is journaled for durable execution and will thus not be duplicated when the
+     * handler is re-invoked for retries or after suspending.
+     *
+     * This call will return immediately; the message sending happens asynchronously in the background.
+     * Despite that, the message is guaranteed to be sent, because the completion of the invocation that
+     * triggers the send (calls this function) happens logically after the sending. That means that any
+     * failure where the message does not reach Restate also cannot complete this invocation, and will
+     * hence recover this handler and (through the durable execution) recover the message to be sent.
+     *
+     * @example
+     * ```ts
+     * ctx.serviceSendClient(Service).anotherAction(1337, { delay: { seconds: 60 } });
+     * ```
+     */
+    delay?: Duration | number;
     headers?: Record<string, string>;
     idempotencyKey?: string;
 };
@@ -51,8 +76,10 @@ export declare enum HandlerKind {
 }
 export type ServiceHandlerOpts<I, O> = {
     /**
-     * Define the acceptable content-type. Wildcards can be used, e.g. `application/*` or `* / *`.
-     * If not provided, the `input.contentType` will be used instead.
+     * Define the acceptable content-type for this handler when a request is received at the ingress.
+     * Wildcards can be used, e.g. `application/*` or `* / *`.
+     *
+     * If not provided, the `input.contentType` will be used instead as default.
      *
      * Setting this value has no effect on the input serde.
      * If you want to customize how to deserialize the input, you still need to provide an `input` serde.
@@ -84,78 +111,75 @@ export type ServiceHandlerOpts<I, O> = {
      * Additional metadata for the handler.
      */
     metadata?: Record<string, string>;
-};
-export type ObjectHandlerOpts<I, O> = {
     /**
-     * Define the acceptable content-type. Wildcards can be used, e.g. `application/*` or `* / *`.
-     * If not provided, the `input.contentType` will be used instead.
+     * The retention duration of idempotent requests to this handler.
      *
-     * Setting this value has no effect on the input serde.
-     * If you want to customize how to deserialize the input, you still need to provide an `input` serde.
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
      */
-    accept?: string;
+    idempotencyRetention?: Duration | number;
     /**
-     * The Serde to use for deserializing the input parameter.
-     * defaults to: restate.serde.json
+     * The journal retention for invocations to this handler.
      *
-     * Provide a custom Serde if the input is not JSON, or use:
-     * restate.serde.binary the skip serialization/deserialization altogether.
-     * in that case, the input parameter is a Uint8Array.
-     */
-    input?: Serde<I>;
-    /**
-     * The Serde to use for serializing the output.
-     * defaults to: restate.serde.json
+     * In case the request has an idempotency key, the `idempotencyRetention` caps the journal retention time.
      *
-     * Provide a custom Serde if the output is not JSON, or use:
-     * restate.serde.binary the skip serialization/deserialization altogether.
-     * in that case, the output parameter is a Uint8Array.
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
      */
-    output?: Serde<O>;
-    /**
-     * An additional description for the handler, for documentation purposes.
-     */
-    description?: string;
-    /**
-     * Additional metadata for the handler.
-     */
-    metadata?: Record<string, string>;
-};
-export type WorkflowHandlerOpts<I, O> = {
+    journalRetention?: Duration | number;
     /**
-     * Define the acceptable content-type. Wildcards can be used, e.g. `application/*` or `* / *`.
-     * If not provided, the `input.contentType` will be used instead.
+     * This timer guards against stalled invocations. Once it expires, Restate triggers a graceful
+     * termination by asking the invocation to suspend (which preserves intermediate progress).
      *
-     * Setting this value has no effect on the input serde.
-     * If you want to customize how to deserialize the input, you still need to provide an `input` serde.
+     * The `abortTimeout` is used to abort the invocation, in case it doesn't react to the request to
+     * suspend.
+     *
+     * This overrides the inactivity timeout set for the service and the default set in restate-server.
+     *
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
      */
-    accept?: string;
+    inactivityTimeout?: Duration | number;
     /**
-     * The Serde to use for deserializing the input parameter.
-     * defaults to: restate.serde.json
+     * This timer guards against stalled invocations that are supposed to terminate. The abort timeout
+     * is started after the [inactivityTimeout] has expired and the invocation has been asked to
+     * gracefully terminate. Once the timer expires, it will abort the invocation.
      *
-     * Provide a custom Serde if the input is not JSON, or use:
-     * restate.serde.binary the skip serialization/deserialization altogether.
-     * in that case, the input parameter is a Uint8Array.
+     * This timer potentially *interrupts* user code. If the user code needs longer to gracefully
+     * terminate, then this value needs to be set accordingly.
+     *
+     * This overrides the abort timeout set for the service and the default set in restate-server.
+     *
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
      */
-    input?: Serde<I>;
+    abortTimeout?: Duration | number;
     /**
-     * The Serde to use for serializing the output.
-     * defaults to: restate.serde.json
+     * When set to `true` this handler cannot be invoked from the restate-server HTTP and Kafka ingress,
+     * but only from other services.
      *
-     * Provide a custom Serde if the output is not JSON, or use:
-     * restate.serde.binary the skip serialization/deserialization altogether.
-     * in that case, the output parameter is a Uint8Array.
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
      */
-    output?: Serde<O>;
+    ingressPrivate?: boolean;
+};
+export type ObjectHandlerOpts<I, O> = ServiceHandlerOpts<I, O> & {
     /**
-     * An additional description for the handler, for documentation purposes.
+     * When set to `true`, lazy state will be enabled for all invocations to this handler.
+     *
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
      */
-    description?: string;
+    enableLazyState?: boolean;
+};
+export type WorkflowHandlerOpts<I, O> = ServiceHandlerOpts<I, O> & {
     /**
-     * Additional metadata for the handler.
+     * When set to `true`, lazy state will be enabled for all invocations to this handler.
+     *
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
      */
-    metadata?: Record<string, string>;
+    enableLazyState?: boolean;
 };
 export declare class HandlerWrapper {
     readonly kind: HandlerKind;
@@ -164,6 +188,12 @@ export declare class HandlerWrapper {
     readonly outputSerde: Serde<unknown>;
     readonly description?: string | undefined;
     readonly metadata?: Record<string, string> | undefined;
+    readonly idempotencyRetention?: (Duration | number) | undefined;
+    readonly journalRetention?: (Duration | number) | undefined;
+    readonly inactivityTimeout?: (Duration | number) | undefined;
+    readonly abortTimeout?: (Duration | number) | undefined;
+    readonly ingressPrivate?: boolean | undefined;
+    readonly enableLazyState?: boolean | undefined;
     static from(kind: HandlerKind, handler: Function, opts?: ServiceHandlerOpts<unknown, unknown> | ObjectHandlerOpts<unknown, unknown> | WorkflowHandlerOpts<unknown, unknown>): HandlerWrapper;
     static fromHandler(handler: any): HandlerWrapper | undefined;
     readonly accept?: string;
@@ -265,6 +295,65 @@ export declare namespace handlers {
 export type ServiceOpts<U> = {
     [K in keyof U]: U[K] extends ServiceHandler<U[K], Context> ? U[K] : ServiceHandler<U[K], Context>;
 };
+export type ServiceOptions = {
+    /**
+     * The retention duration of idempotent requests to this service.
+     *
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
+     */
+    idempotencyRetention?: Duration | number;
+    /**
+     * The journal retention. When set, this applies to all requests to all handlers of this service.
+     *
+     * In case the request has an idempotency key, the `idempotencyRetention` caps the journal retention
+     * time.
+     *
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
+     *
+     * @return this
+     */
+    journalRetention?: Duration | number;
+    /**
+     * This timer guards against stalled invocations. Once it expires, Restate triggers a graceful
+     * termination by asking the invocation to suspend (which preserves intermediate progress).
+     *
+     * The `abortTimeout` is used to abort the invocation, in case it doesn't react to the request to
+     * suspend.
+     *
+     * This overrides the default inactivity timeout configured in the restate-server for all
+     * invocations to this service.
+     *
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
+     */
+    inactivityTimeout?: Duration | number;
+    /**
+     * This timer guards against stalled service/handler invocations that are supposed to terminate. The
+     * abort timeout is started after the `inactivityTimeout` has expired and the service/handler
+     * invocation has been asked to gracefully terminate. Once the timer expires, it will abort the
+     * service/handler invocation.
+     *
+     * This timer potentially *interrupts* user code. If the user code needs longer to gracefully
+     * terminate, then this value needs to be set accordingly.
+     *
+     * This overrides the default abort timeout configured in the restate-server for all invocations to
+     * this service.
+     *
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
+     */
+    abortTimeout?: Duration | number;
+    /**
+     * When set to `true` this service, with all its handlers, cannot be invoked from the restate-server
+     * HTTP and Kafka ingress, but only from other services.
+     *
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
+     */
+    ingressPrivate?: boolean;
+};
 /**
  * Define a Restate service.
  *
@@ -317,10 +406,20 @@ export declare const service: <P extends string, M>(service: {
     handlers: ServiceOpts<M> & ThisType<M>;
     description?: string;
     metadata?: Record<string, string>;
+    options?: ServiceOptions;
 }) => ServiceDefinition<P, M>;
 export type ObjectOpts<U> = {
     [K in keyof U]: U[K] extends ObjectHandler<U[K], ObjectContext<any>> ? U[K] : U[K] extends ObjectHandler<U[K], ObjectSharedContext<any>> ? U[K] : ObjectHandler<U[K], ObjectContext<any>> | ObjectHandler<U[K], ObjectSharedContext<any>>;
 };
+export type ObjectOptions = ServiceOptions & {
+    /**
+     * When set to `true`, lazy state will be enabled for all invocations to this service.
+     *
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
+     */
+    enableLazyState?: boolean;
+};
 /**
  * Define a Restate virtual object.
  *
@@ -380,6 +479,7 @@ export declare const object: <P extends string, M>(object: {
     handlers: ObjectOpts<M> & ThisType<M>;
     description?: string;
     metadata?: Record<string, string>;
+    options?: ObjectOptions;
 }) => VirtualObjectDefinition<P, M>;
 /**
  * A workflow handlers is a type that describes the handlers for a workflow.
@@ -393,6 +493,22 @@ export type WorkflowOpts<U> = {
 } & {
     [K in keyof U]: K extends "workflowSubmit" | "workflowAttach" | "workflowOutput" ? `${K} is a reserved keyword` : K extends "run" ? U[K] extends WorkflowHandler<U[K], WorkflowContext<any>> ? U[K] : "An handler named 'run' must take as a first argument a WorkflowContext, and must return a Promise" : U[K] extends WorkflowSharedHandler<U[K], WorkflowSharedContext<any>> ? U[K] : "An handler other then 'run' must accept as a first argument a WorkflowSharedContext";
 };
+export type WorkflowOptions = ServiceOptions & {
+    /**
+     * The retention duration for this workflow.
+     *
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
+     */
+    workflowRetention?: Duration | number;
+    /**
+     * When set to `true`, lazy state will be enabled for all invocations to this service.
+     *
+     * *NOTE:* You can set this field only if you register this endpoint against restate-server >= 1.4,
+     * otherwise the service discovery will fail.
+     */
+    enableLazyState?: boolean;
+};
 /**
  * Define a Restate workflow.
  *
@@ -438,5 +554,6 @@ export declare const workflow: <P extends string, M>(workflow: {
     handlers: WorkflowOpts<M> & ThisType<M>;
     description?: string;
     metadata?: Record<string, string>;
+    options?: WorkflowOptions;
 }) => WorkflowDefinition<P, M>;
 //# sourceMappingURL=rpc.d.ts.map