@restatedev/restate-sdk-core 1.16.9 → 1.17.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +3 -0
- package/dist/index.d.cts +2 -1
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/interface.cjs +71 -0
- package/dist/interface.d.cts +83 -0
- package/dist/interface.d.cts.map +1 -0
- package/dist/interface.d.ts +78 -0
- package/dist/interface.d.ts.map +1 -0
- package/dist/interface.js +65 -0
- package/dist/interface.js.map +1 -0
- package/package.json +1 -1
package/dist/index.cjs
CHANGED
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
const require_serde_api = require('./serde_api.cjs');
|
|
2
2
|
const require_duration = require('./duration.cjs');
|
|
3
|
+
const require_interface = require('./interface.cjs');
|
|
3
4
|
|
|
4
5
|
exports.durationToMillis = require_duration.durationToMillis;
|
|
6
|
+
exports.iface = require_interface.iface;
|
|
7
|
+
exports.makeHandlerDescriptor = require_interface.makeHandlerDescriptor;
|
|
5
8
|
exports.millisOrDurationToMillis = require_duration.millisOrDurationToMillis;
|
|
6
9
|
Object.defineProperty(exports, 'serde', {
|
|
7
10
|
enumerable: true,
|
package/dist/index.d.cts
CHANGED
|
@@ -3,4 +3,5 @@ import { StandardJSONSchemaV1, StandardSchemaV1, StandardTypedV1 } from "./stand
|
|
|
3
3
|
import { Serde, serde } from "./serde_api.cjs";
|
|
4
4
|
import { Duration, durationToMillis, millisOrDurationToMillis } from "./duration.cjs";
|
|
5
5
|
import { JournalValueCodec } from "./entry_codec.cjs";
|
|
6
|
-
|
|
6
|
+
import { Descriptor, HandlerDescriptor, ImplementedDefinition, ImplementedObjectDefinition, ImplementedServiceDefinition, ImplementedWorkflowDefinition, InferInput, InferOutput, ObjectDescriptor, SerdeType, ServiceDescriptor, ServiceInterface, WorkflowDescriptor, iface, makeHandlerDescriptor } from "./interface.cjs";
|
|
7
|
+
export { type ArgType, type Descriptor, type Duration, type HandlerDescriptor, type HandlerReturnType, type ImplementedDefinition, type ImplementedObjectDefinition, type ImplementedServiceDefinition, type ImplementedWorkflowDefinition, type InferInput, type InferOutput, type JournalValueCodec, type ObjectDescriptor, type ObjectHandler, type ObjectSharedHandler, type RestateContext, type RestateObjectContext, type RestateObjectSharedContext, type RestateWorkflowContext, type RestateWorkflowSharedContext, type Serde, type SerdeType, type Service, type ServiceDefinition, type ServiceDefinitionFrom, type ServiceDescriptor, type ServiceHandler, type ServiceInterface, type StandardJSONSchemaV1, type StandardSchemaV1, type StandardTypedV1, type VirtualObject, type VirtualObjectDefinition, type VirtualObjectDefinitionFrom, type Workflow, type WorkflowDefinition, type WorkflowDefinitionFrom, type WorkflowDescriptor, type WorkflowHandler, type WorkflowSharedHandler, durationToMillis, iface, makeHandlerDescriptor, millisOrDurationToMillis, serde };
|
package/dist/index.d.ts
CHANGED
|
@@ -5,4 +5,6 @@ export type { Duration } from "./duration.js";
|
|
|
5
5
|
export { durationToMillis, millisOrDurationToMillis } from "./duration.js";
|
|
6
6
|
export type { JournalValueCodec } from "./entry_codec.js";
|
|
7
7
|
export type { StandardTypedV1, StandardSchemaV1, StandardJSONSchemaV1, } from "./standard_schema.js";
|
|
8
|
+
export { iface, makeHandlerDescriptor } from "./interface.js";
|
|
9
|
+
export type { ServiceInterface, HandlerDescriptor, Descriptor, ServiceDescriptor, ObjectDescriptor, WorkflowDescriptor, ImplementedServiceDefinition, ImplementedObjectDefinition, ImplementedWorkflowDefinition, ImplementedDefinition, InferInput, InferOutput, SerdeType, } from "./interface.js";
|
|
8
10
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,YAAY,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,OAAO,EACP,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,QAAQ,EACR,sBAAsB,EACtB,OAAO,EACP,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE3E,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,YAAY,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,OAAO,EACP,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,QAAQ,EACR,sBAAsB,EACtB,OAAO,EACP,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE3E,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,4BAA4B,EAC5B,2BAA2B,EAC3B,6BAA6B,EAC7B,qBAAqB,EACrB,UAAU,EACV,WAAW,EACX,SAAS,GACV,MAAM,gBAAgB,CAAC"}
|
package/dist/index.js
CHANGED
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA2BH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA2BH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAU3E,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
const require_serde_api = require('./serde_api.cjs');
|
|
2
|
+
|
|
3
|
+
//#region src/interface.ts
|
|
4
|
+
function makeHandlerDescriptor(inputSerde, outputSerde, shared) {
|
|
5
|
+
return {
|
|
6
|
+
_inputSerde: inputSerde,
|
|
7
|
+
_outputSerde: outputSerde,
|
|
8
|
+
_shared: shared
|
|
9
|
+
};
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Declare a service interface (contract) as a runtime value carrying handler
|
|
13
|
+
* names + input/output serdes, without an implementation. Place it in a shared
|
|
14
|
+
* package that both the server (via `implement()`) and callers (via
|
|
15
|
+
* `ctx.serviceClient(iface)` / `connect().serviceClient(iface)`) import.
|
|
16
|
+
*
|
|
17
|
+
* @example
|
|
18
|
+
* ```ts
|
|
19
|
+
* const greeter = iface.service("greeter", {
|
|
20
|
+
* greet: iface.schemas({ input: GreetReq, output: GreetRes }),
|
|
21
|
+
* ping: iface.json<void, string>(),
|
|
22
|
+
* });
|
|
23
|
+
* ```
|
|
24
|
+
*/
|
|
25
|
+
const iface = {
|
|
26
|
+
service: function(name, handlers) {
|
|
27
|
+
return {
|
|
28
|
+
name,
|
|
29
|
+
_kind: "service",
|
|
30
|
+
_handlers: handlers
|
|
31
|
+
};
|
|
32
|
+
},
|
|
33
|
+
object: function(name, handlers) {
|
|
34
|
+
return {
|
|
35
|
+
name,
|
|
36
|
+
_kind: "object",
|
|
37
|
+
_handlers: handlers
|
|
38
|
+
};
|
|
39
|
+
},
|
|
40
|
+
workflow: function(name, handlers) {
|
|
41
|
+
return {
|
|
42
|
+
name,
|
|
43
|
+
_kind: "workflow",
|
|
44
|
+
_handlers: handlers
|
|
45
|
+
};
|
|
46
|
+
},
|
|
47
|
+
json: function() {
|
|
48
|
+
return makeHandlerDescriptor(void 0, void 0, false);
|
|
49
|
+
},
|
|
50
|
+
serdes: function(opts) {
|
|
51
|
+
return makeHandlerDescriptor(opts.input, opts.output, false);
|
|
52
|
+
},
|
|
53
|
+
schemas: function(opts) {
|
|
54
|
+
return makeHandlerDescriptor(opts.input ? require_serde_api.serde.schema(opts.input) : void 0, opts.output ? require_serde_api.serde.schema(opts.output) : void 0, false);
|
|
55
|
+
},
|
|
56
|
+
shared: {
|
|
57
|
+
json: function() {
|
|
58
|
+
return makeHandlerDescriptor(void 0, void 0, true);
|
|
59
|
+
},
|
|
60
|
+
serdes: function(opts) {
|
|
61
|
+
return makeHandlerDescriptor(opts.input, opts.output, true);
|
|
62
|
+
},
|
|
63
|
+
schemas: function(opts) {
|
|
64
|
+
return makeHandlerDescriptor(opts.input ? require_serde_api.serde.schema(opts.input) : void 0, opts.output ? require_serde_api.serde.schema(opts.output) : void 0, true);
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
};
|
|
68
|
+
|
|
69
|
+
//#endregion
|
|
70
|
+
exports.iface = iface;
|
|
71
|
+
exports.makeHandlerDescriptor = makeHandlerDescriptor;
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import { ServiceDefinition, VirtualObjectDefinition, WorkflowDefinition } from "./core.cjs";
|
|
2
|
+
import { StandardSchemaV1 } from "./standard_schema.cjs";
|
|
3
|
+
import { Serde } from "./serde_api.cjs";
|
|
4
|
+
|
|
5
|
+
//#region src/interface.d.ts
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Minimal descriptor stored in {@link Descriptor}._handlers per handler.
|
|
9
|
+
*/
|
|
10
|
+
type HandlerDescriptor<I$1 = any, O$1 = any, Shared extends boolean = boolean> = {
|
|
11
|
+
readonly _inputSerde?: Serde<I$1>;
|
|
12
|
+
readonly _outputSerde?: Serde<O$1>;
|
|
13
|
+
/** @internal virtual-object handler shared/exclusive marker (phantom + runtime) */
|
|
14
|
+
readonly _shared?: Shared;
|
|
15
|
+
};
|
|
16
|
+
declare function makeHandlerDescriptor<I$1, O$1, Shared extends boolean = false>(inputSerde?: Serde<I$1>, outputSerde?: Serde<O$1>, shared?: Shared): HandlerDescriptor<I$1, O$1, Shared>;
|
|
17
|
+
/** Recover the input type declared by a {@link HandlerDescriptor}. */
|
|
18
|
+
type InferInput<D> = D extends HandlerDescriptor<infer I, any, any> ? I : any;
|
|
19
|
+
/** Recover the output type declared by a {@link HandlerDescriptor}. */
|
|
20
|
+
type InferOutput<D> = D extends HandlerDescriptor<any, infer O, any> ? O : any;
|
|
21
|
+
/** Recover the value type carried by a {@link Serde}. */
|
|
22
|
+
type SerdeType<S> = S extends Serde<infer T> ? T : never;
|
|
23
|
+
type Descriptor<P extends string = string, H extends Record<string, HandlerDescriptor> = Record<string, HandlerDescriptor>, Kind extends "service" | "object" | "workflow" = "service" | "object" | "workflow"> = {
|
|
24
|
+
readonly name: P;
|
|
25
|
+
readonly _kind: Kind;
|
|
26
|
+
readonly _handlers: H;
|
|
27
|
+
};
|
|
28
|
+
type ServiceDescriptor<P extends string = string, H extends Record<string, HandlerDescriptor> = Record<string, HandlerDescriptor>> = Descriptor<P, H, "service">;
|
|
29
|
+
type ObjectDescriptor<P extends string = string, H extends Record<string, HandlerDescriptor> = Record<string, HandlerDescriptor>> = Descriptor<P, H, "object">;
|
|
30
|
+
type WorkflowDescriptor<P extends string = string, H extends Record<string, HandlerDescriptor> = Record<string, HandlerDescriptor>> = Descriptor<P, H, "workflow">;
|
|
31
|
+
/** Implemented definition — a Descriptor that is also bindable to an endpoint. */
|
|
32
|
+
type ImplementedServiceDefinition<P extends string, H extends Record<string, HandlerDescriptor>> = ServiceDefinition<P, any> & ServiceDescriptor<P, H>;
|
|
33
|
+
type ImplementedObjectDefinition<P extends string, H extends Record<string, HandlerDescriptor>> = VirtualObjectDefinition<P, any> & ObjectDescriptor<P, H>;
|
|
34
|
+
type ImplementedWorkflowDefinition<P extends string, H extends Record<string, HandlerDescriptor>> = WorkflowDefinition<P, any> & WorkflowDescriptor<P, H>;
|
|
35
|
+
type ImplementedDefinition<P extends string, H extends Record<string, HandlerDescriptor>, Kind extends "service" | "object" | "workflow"> = Kind extends "service" ? ImplementedServiceDefinition<P, H> : Kind extends "object" ? ImplementedObjectDefinition<P, H> : ImplementedWorkflowDefinition<P, H>;
|
|
36
|
+
/** The shape of the {@link iface} service-interface declaration API. */
|
|
37
|
+
interface ServiceInterface {
|
|
38
|
+
service<P extends string, H extends Record<string, HandlerDescriptor>>(name: P, handlers: H): ServiceDescriptor<P, H>;
|
|
39
|
+
object<P extends string, H extends Record<string, HandlerDescriptor>>(name: P, handlers: H): ObjectDescriptor<P, H>;
|
|
40
|
+
workflow<P extends string, H extends Record<string, HandlerDescriptor>>(name: P, handlers: H): WorkflowDescriptor<P, H>;
|
|
41
|
+
/** `json<I, O>()` — type params, default JSON serde. */
|
|
42
|
+
json<I$1 = void, O$1 = void>(): HandlerDescriptor<I$1, O$1, false>;
|
|
43
|
+
/** `serdes({ input, output })` — explicit Serde per direction. */
|
|
44
|
+
serdes<SI extends Serde<any>, SO extends Serde<any>>(opts: {
|
|
45
|
+
input?: SI;
|
|
46
|
+
output?: SO;
|
|
47
|
+
}): HandlerDescriptor<SerdeType<SI>, SerdeType<SO>, false>;
|
|
48
|
+
/** `schemas({ input, output })` — Standard Schema per direction. */
|
|
49
|
+
schemas<SI extends StandardSchemaV1<any>, SO extends StandardSchemaV1<any>>(opts: {
|
|
50
|
+
input?: SI;
|
|
51
|
+
output?: SO;
|
|
52
|
+
}): HandlerDescriptor<StandardSchemaV1.InferOutput<NonNullable<SI>>, StandardSchemaV1.InferOutput<NonNullable<SO>>, false>;
|
|
53
|
+
/** Shared (read-only) virtual-object / non-`run` workflow handler declarators. */
|
|
54
|
+
shared: {
|
|
55
|
+
json<I$1 = void, O$1 = void>(): HandlerDescriptor<I$1, O$1, true>;
|
|
56
|
+
serdes<SI extends Serde<any>, SO extends Serde<any>>(opts: {
|
|
57
|
+
input?: SI;
|
|
58
|
+
output?: SO;
|
|
59
|
+
}): HandlerDescriptor<SerdeType<SI>, SerdeType<SO>, true>;
|
|
60
|
+
schemas<SI extends StandardSchemaV1<any>, SO extends StandardSchemaV1<any>>(opts: {
|
|
61
|
+
input?: SI;
|
|
62
|
+
output?: SO;
|
|
63
|
+
}): HandlerDescriptor<StandardSchemaV1.InferOutput<NonNullable<SI>>, StandardSchemaV1.InferOutput<NonNullable<SO>>, true>;
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Declare a service interface (contract) as a runtime value carrying handler
|
|
68
|
+
* names + input/output serdes, without an implementation. Place it in a shared
|
|
69
|
+
* package that both the server (via `implement()`) and callers (via
|
|
70
|
+
* `ctx.serviceClient(iface)` / `connect().serviceClient(iface)`) import.
|
|
71
|
+
*
|
|
72
|
+
* @example
|
|
73
|
+
* ```ts
|
|
74
|
+
* const greeter = iface.service("greeter", {
|
|
75
|
+
* greet: iface.schemas({ input: GreetReq, output: GreetRes }),
|
|
76
|
+
* ping: iface.json<void, string>(),
|
|
77
|
+
* });
|
|
78
|
+
* ```
|
|
79
|
+
*/
|
|
80
|
+
declare const iface: ServiceInterface;
|
|
81
|
+
//#endregion
|
|
82
|
+
export { Descriptor, HandlerDescriptor, ImplementedDefinition, ImplementedObjectDefinition, ImplementedServiceDefinition, ImplementedWorkflowDefinition, InferInput, InferOutput, ObjectDescriptor, SerdeType, ServiceDescriptor, ServiceInterface, WorkflowDescriptor, iface, makeHandlerDescriptor };
|
|
83
|
+
//# sourceMappingURL=interface.d.cts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"interface.d.cts","names":[],"sources":["../src/interface.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAwBA;AAK+B,KALnB,iBAKmB,CAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,eAAA,OAAA,GAAA,OAAA,CAAA,GAAA;EAAN,SAAA,WAAA,CAAA,EAAA,KAAA,CAAM,GAAN,CAAA;EACO,SAAA,YAAA,CAAA,EAAN,KAAM,CAAA,GAAA,CAAA;EAAN;EAEL,SAAA,OAAA,CAAA,EAAA,MAAA;CAAM;AAGX,iBAAA,qBAAqB,CAAA,GAAA,EAAA,GAAA,EAAA,eAAA,OAAA,GAAA,KAAA,CAAA,CAAA,UAAA,CAAA,EACtB,KADsB,CAChB,GADgB,CAAA,EAAA,WAAA,CAAA,EAErB,KAFqB,CAEf,GAFe,CAAA,EAAA,MAAA,CAAA,EAG1B,MAH0B,CAAA,EAIlC,iBAJkC,CAIhB,GAJgB,EAIb,GAJa,EAIV,MAJU,CAAA;;AACtB,KAYH,UAZG,CAAA,CAAA,CAAA,GAab,CAba,SAaH,iBAbG,CAAA,KAAA,EAAA,EAAA,GAAA,EAAA,GAAA,CAAA,GAaoC,CAbpC,GAAA,GAAA;;AACC,KAcJ,WAdI,CAAA,CAAA,CAAA,GAed,CAfc,SAeJ,iBAfI,CAAA,GAAA,EAAA,KAAA,EAAA,EAAA,GAAA,CAAA,GAemC,CAfnC,GAAA,GAAA;;AAEK,KAeT,SAfS,CAAA,CAAA,CAAA,GAeM,CAfN,SAegB,KAfhB,CAAA,KAAA,EAAA,CAAA,GAeiC,CAfjC,GAAA,KAAA;AAAG,KA0BZ,UA1BY,CAAA,UAAA,MAAA,GAAA,MAAA,EAAA,UA4BZ,MA5BY,CAAA,MAAA,EA4BG,iBA5BH,CAAA,GA4BwB,MA5BxB,CAAA,MAAA,EA8BpB,iBA9BoB,CAAA,EAAA,aAAA,SAAA,GAAA,QAAA,GAAA,UAAA,GAAA,SAAA,GAAA,QAAA,GAAA,UAAA,CAAA,GAAA;EAAG,SAAA,IAAA,EAqCV,CArCU;EAAxB,SAAA,KAAA,EAsCe,IAtCf;EAAiB,SAAA,SAAA,EAuCE,CAvCF;AASpB,CAAA;AACE,KAgCU,iBAhCV,CAAA,UAAA,MAAA,GAAA,MAAA,EAAA,UAkCU,MAlCV,CAAA,MAAA,EAkCyB,iBAlCzB,CAAA,GAkC8C,MAlC9C,CAAA,MAAA,EAoCE,iBApCF,CAAA,CAAA,GAsCE,UAtCF,CAsCa,CAtCb,EAsCgB,CAtChB,EAAA,SAAA,CAAA;AAAU,KAwCA,gBAxCA,CAAA,UAAA,MAAA,GAAA,MAAA,EAAA,UA0CA,MA1CA,CAAA,MAAA,EA0Ce,iBA1Cf,CAAA,GA0CoC,MA1CpC,CAAA,MAAA,EA4CR,iBA5CQ,CAAA,CAAA,GA8CR,UA9CQ,CA8CG,CA9CH,EA8CM,CA9CN,EAAA,QAAA,CAAA;AAAuC,KAgDvC,kBAhDuC,CAAA,UAAA,MAAA,GAAA,MAAA,EAAA,UAkDvC,MAlDuC,CAAA,MAAA,EAkDxB,iBAlDwB,CAAA,GAkDH,MAlDG,CAAA,MAAA,EAoD/C,iBApD+C,CAAA,CAAA,GAsD/C,UAtD+C,CAsDpC,CAtDoC,EAsDjC,CAtDiC,EAAA,UAAA,CAAA;;AAEvC,KAuDA,4BAvDW,CAAA,UAAA,MAAA,EAAA,UAyDX,MAzDW,CAAA,MAAA,EAyDI,iBAzDJ,CAAA,CAAA,GA0DnB,iBA1DmB,CA0DD,CA1DC,EAAA,GAAA,CAAA,GA0DS,iBA1DT,CA0D2B,CA1D3B,EA0D8B,CA1D9B,CAAA;AACrB,KA2DU,2BA3DV,CAAA,UAAA,MAAA,EAAA,UA6DU,MA7DV,CAAA,MAAA,EA6DyB,iBA7DzB,CAAA,CAAA,GA8DE,uBA9DF,CA8D0B,CA9D1B,EAAA,GAAA,CAAA,GA8DoC,gBA9DpC,CA8DqD,CA9DrD,EA8DwD,CA9DxD,CAAA;AAAU,KAgEA,6BAhEA,CAAA,UAAA,MAAA,EAAA,UAkEA,MAlEA,CAAA,MAAA,EAkEe,iBAlEf,CAAA,CAAA,GAmER,kBAnEQ,CAmEW,CAnEX,EAAA,GAAA,CAAA,GAmEqB,kBAnErB,CAmEwC,CAnExC,EAmE2C,CAnE3C,CAAA;AAAuC,KAqEvC,qBArEuC,CAAA,UAAA,MAAA,EAAA,UAuEvC,MAvEuC,CAAA,MAAA,EAuExB,iBAvEwB,CAAA,EAAA,aAAA,SAAA,GAAA,QAAA,GAAA,UAAA,CAAA,GAyE/C,IAzE+C,SAAA,SAAA,GA0E/C,4BA1E+C,CA0ElB,CA1EkB,EA0Ef,CA1Ee,CAAA,GA2E/C,IA3E+C,SAAA,QAAA,GA4E7C,2BA5E6C,CA4EjB,CA5EiB,EA4Ed,CA5Ec,CAAA,GA6E7C,6BA7E6C,CA6Ef,CA7Ee,EA6EZ,CA7EY,CAAA;;AAEvC,UA8EK,gBAAA,CA9EI;EAAM,OAAA,CAAA,UAAA,MAAA,EAAA,UA+EW,MA/EX,CAAA,MAAA,EA+E0B,iBA/E1B,CAAA,CAAA,CAAA,IAAA,EAgFjB,CAhFiB,EAAA,QAAA,EAiFb,CAjFa,CAAA,EAkFtB,iBAlFsB,CAkFJ,CAlFI,EAkFD,CAlFC,CAAA;EAAU,MAAA,CAAA,UAAA,MAAA,EAAA,UAmFA,MAnFA,CAAA,MAAA,EAmFe,iBAnFf,CAAA,CAAA,CAAA,IAAA,EAoF3B,CApF2B,EAAA,QAAA,EAqFvB,CArFuB,CAAA,EAsFhC,gBAtFgC,CAsFf,CAtFe,EAsFZ,CAtFY,CAAA;EAAiB,QAAA,CAAA,UAAA,MAAA,EAAA,UAuFf,MAvFe,CAAA,MAAA,EAuFA,iBAvFA,CAAA,CAAA,CAAA,IAAA,EAwF5C,CAxF4C,EAAA,QAAA,EAyFxC,CAzFwC,CAAA,EA0FjD,kBA1FiD,CA0F9B,CA1F8B,EA0F3B,CA1F2B,CAAA;EAAC;EAW3C,IAAA,CAAA,MAAA,IAAU,EAAA,MAAA,IAAA,CAAA,EAAA,EAiFQ,iBAjFR,CAiF0B,GAjF1B,EAiF6B,GAjF7B,EAAA,KAAA,CAAA;EAEK;EAAf,MAAA,CAAA,WAiFQ,KAjFR,CAAA,GAAA,CAAA,EAAA,WAiF+B,KAjF/B,CAAA,GAAA,CAAA,CAAA,CAAA,IAAA,EAAA;IAER,KAAA,CAAA,EAgFQ,EAhFR;IAF4C,MAAA,CAAA,EAmFnC,EAnFmC;EAS/B,CAAA,CAAA,EA2EX,iBA3EW,CA2EO,SA3EP,CA2EiB,EA3EjB,CAAA,EA2EsB,SA3EtB,CA2EgC,EA3EhC,CAAA,EAAA,KAAA,CAAA;EACC;EACI,OAAA,CAAA,WA4EP,gBA5EO,CAAA,GAAA,CAAA,EAAA,WA6EP,gBA7EO,CAAA,GAAA,CAAA,CAAA,CAAA,IAAA,EAAA;IAAC,KAAA,CAAA,EA+EX,EA/EW;IAGX,MAAA,CAAA,EA6EC,EA7ED;EAEe,CAAA,CAAA,EA4ErB,iBA5EqB,CA6EvB,gBAAA,CAAiB,WA7EM,CA6EM,WA7EN,CA6EkB,EA7ElB,CAAA,CAAA,EA8EvB,gBAAA,CAAiB,WA9EM,CA8EM,WA9EN,CA8EkB,EA9ElB,CAAA,CAAA,EAAA,KAAA,CAAA;EAAf;EAER,MAAA,EAAA;IAF4C,IAAA,CAAA,MAAA,IAAA,EAAA,MAAA,IAAA,CAAA,EAAA,EAmFhB,iBAnFgB,CAmFE,GAnFF,EAmFK,GAnFL,EAAA,IAAA,CAAA;IAIjC,MAAA,CAAA,WAgFO,KAhFP,CAAA,GAAA,CAAA,EAAA,WAgF8B,KAhF9B,CAAA,GAAA,CAAA,CAAA,CAAA,IAAA,EAAA;MAAG,KAAA,CAAA,EAiFJ,EAjFI;MAAd,MAAA,CAAA,EAkFW,EAlFX;IAAU,CAAA,CAAA,EAmFN,iBAnFM,CAmFY,SAnFZ,CAmFsB,EAnFtB,CAAA,EAmF2B,SAnF3B,CAmFqC,EAnFrC,CAAA,EAAA,IAAA,CAAA;IAEF,OAAA,CAAA,WAmFK,gBAnFW,CAAA,GAAA,CAAA,EAAA,WAoFX,gBApFW,CAAA,GAAA,CAAA,CAAA,CAAA,IAAA,EAAA;MAED,KAAA,CAAA,EAoFb,EApFa;MAAf,MAAA,CAAA,EAqFG,EArFH;IAER,CAAA,CAAA,EAoFI,iBApFJ,CAqFE,gBAAA,CAAiB,WArFnB,CAqF+B,WArF/B,CAqF2C,EArF3C,CAAA,CAAA,EAsFE,gBAAA,CAAiB,WAtFnB,CAsF+B,WAtF/B,CAsF2C,EAtF3C,CAAA,CAAA,EAAA,IAAA,CAAA;EAF4C,CAAA;;;;;AAMhD;;;;;;;;;AASA;;AAEY,cA2FC,KA3FD,EA2FQ,gBA3FR"}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import type { Serde } from "./serde_api.js";
|
|
2
|
+
import type { StandardSchemaV1 } from "./standard_schema.js";
|
|
3
|
+
import type { ServiceDefinition, VirtualObjectDefinition, WorkflowDefinition } from "./core.js";
|
|
4
|
+
/**
|
|
5
|
+
* Minimal descriptor stored in {@link Descriptor}._handlers per handler.
|
|
6
|
+
*/
|
|
7
|
+
export type HandlerDescriptor<I = any, O = any, Shared extends boolean = boolean> = {
|
|
8
|
+
readonly _inputSerde?: Serde<I>;
|
|
9
|
+
readonly _outputSerde?: Serde<O>;
|
|
10
|
+
/** @internal virtual-object handler shared/exclusive marker (phantom + runtime) */
|
|
11
|
+
readonly _shared?: Shared;
|
|
12
|
+
};
|
|
13
|
+
export declare function makeHandlerDescriptor<I, O, Shared extends boolean = false>(inputSerde?: Serde<I>, outputSerde?: Serde<O>, shared?: Shared): HandlerDescriptor<I, O, Shared>;
|
|
14
|
+
/** Recover the input type declared by a {@link HandlerDescriptor}. */
|
|
15
|
+
export type InferInput<D> = D extends HandlerDescriptor<infer I, any, any> ? I : any;
|
|
16
|
+
/** Recover the output type declared by a {@link HandlerDescriptor}. */
|
|
17
|
+
export type InferOutput<D> = D extends HandlerDescriptor<any, infer O, any> ? O : any;
|
|
18
|
+
/** Recover the value type carried by a {@link Serde}. */
|
|
19
|
+
export type SerdeType<S> = S extends Serde<infer T> ? T : never;
|
|
20
|
+
export type Descriptor<P extends string = string, H extends Record<string, HandlerDescriptor> = Record<string, HandlerDescriptor>, Kind extends "service" | "object" | "workflow" = "service" | "object" | "workflow"> = {
|
|
21
|
+
readonly name: P;
|
|
22
|
+
readonly _kind: Kind;
|
|
23
|
+
readonly _handlers: H;
|
|
24
|
+
};
|
|
25
|
+
export type ServiceDescriptor<P extends string = string, H extends Record<string, HandlerDescriptor> = Record<string, HandlerDescriptor>> = Descriptor<P, H, "service">;
|
|
26
|
+
export type ObjectDescriptor<P extends string = string, H extends Record<string, HandlerDescriptor> = Record<string, HandlerDescriptor>> = Descriptor<P, H, "object">;
|
|
27
|
+
export type WorkflowDescriptor<P extends string = string, H extends Record<string, HandlerDescriptor> = Record<string, HandlerDescriptor>> = Descriptor<P, H, "workflow">;
|
|
28
|
+
/** Implemented definition — a Descriptor that is also bindable to an endpoint. */
|
|
29
|
+
export type ImplementedServiceDefinition<P extends string, H extends Record<string, HandlerDescriptor>> = ServiceDefinition<P, any> & ServiceDescriptor<P, H>;
|
|
30
|
+
export type ImplementedObjectDefinition<P extends string, H extends Record<string, HandlerDescriptor>> = VirtualObjectDefinition<P, any> & ObjectDescriptor<P, H>;
|
|
31
|
+
export type ImplementedWorkflowDefinition<P extends string, H extends Record<string, HandlerDescriptor>> = WorkflowDefinition<P, any> & WorkflowDescriptor<P, H>;
|
|
32
|
+
export type ImplementedDefinition<P extends string, H extends Record<string, HandlerDescriptor>, Kind extends "service" | "object" | "workflow"> = Kind extends "service" ? ImplementedServiceDefinition<P, H> : Kind extends "object" ? ImplementedObjectDefinition<P, H> : ImplementedWorkflowDefinition<P, H>;
|
|
33
|
+
/** The shape of the {@link iface} service-interface declaration API. */
|
|
34
|
+
export interface ServiceInterface {
|
|
35
|
+
service<P extends string, H extends Record<string, HandlerDescriptor>>(name: P, handlers: H): ServiceDescriptor<P, H>;
|
|
36
|
+
object<P extends string, H extends Record<string, HandlerDescriptor>>(name: P, handlers: H): ObjectDescriptor<P, H>;
|
|
37
|
+
workflow<P extends string, H extends Record<string, HandlerDescriptor>>(name: P, handlers: H): WorkflowDescriptor<P, H>;
|
|
38
|
+
/** `json<I, O>()` — type params, default JSON serde. */
|
|
39
|
+
json<I = void, O = void>(): HandlerDescriptor<I, O, false>;
|
|
40
|
+
/** `serdes({ input, output })` — explicit Serde per direction. */
|
|
41
|
+
serdes<SI extends Serde<any>, SO extends Serde<any>>(opts: {
|
|
42
|
+
input?: SI;
|
|
43
|
+
output?: SO;
|
|
44
|
+
}): HandlerDescriptor<SerdeType<SI>, SerdeType<SO>, false>;
|
|
45
|
+
/** `schemas({ input, output })` — Standard Schema per direction. */
|
|
46
|
+
schemas<SI extends StandardSchemaV1<any>, SO extends StandardSchemaV1<any>>(opts: {
|
|
47
|
+
input?: SI;
|
|
48
|
+
output?: SO;
|
|
49
|
+
}): HandlerDescriptor<StandardSchemaV1.InferOutput<NonNullable<SI>>, StandardSchemaV1.InferOutput<NonNullable<SO>>, false>;
|
|
50
|
+
/** Shared (read-only) virtual-object / non-`run` workflow handler declarators. */
|
|
51
|
+
shared: {
|
|
52
|
+
json<I = void, O = void>(): HandlerDescriptor<I, O, true>;
|
|
53
|
+
serdes<SI extends Serde<any>, SO extends Serde<any>>(opts: {
|
|
54
|
+
input?: SI;
|
|
55
|
+
output?: SO;
|
|
56
|
+
}): HandlerDescriptor<SerdeType<SI>, SerdeType<SO>, true>;
|
|
57
|
+
schemas<SI extends StandardSchemaV1<any>, SO extends StandardSchemaV1<any>>(opts: {
|
|
58
|
+
input?: SI;
|
|
59
|
+
output?: SO;
|
|
60
|
+
}): HandlerDescriptor<StandardSchemaV1.InferOutput<NonNullable<SI>>, StandardSchemaV1.InferOutput<NonNullable<SO>>, true>;
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Declare a service interface (contract) as a runtime value carrying handler
|
|
65
|
+
* names + input/output serdes, without an implementation. Place it in a shared
|
|
66
|
+
* package that both the server (via `implement()`) and callers (via
|
|
67
|
+
* `ctx.serviceClient(iface)` / `connect().serviceClient(iface)`) import.
|
|
68
|
+
*
|
|
69
|
+
* @example
|
|
70
|
+
* ```ts
|
|
71
|
+
* const greeter = iface.service("greeter", {
|
|
72
|
+
* greet: iface.schemas({ input: GreetReq, output: GreetRes }),
|
|
73
|
+
* ping: iface.json<void, string>(),
|
|
74
|
+
* });
|
|
75
|
+
* ```
|
|
76
|
+
*/
|
|
77
|
+
export declare const iface: ServiceInterface;
|
|
78
|
+
//# sourceMappingURL=interface.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* Copyright (c) 2023-2026 - Restate Software, Inc., Restate GmbH
|
|
3
|
+
*
|
|
4
|
+
* This file is part of the Restate SDK for Node.js/TypeScript,
|
|
5
|
+
* which is released under the MIT license.
|
|
6
|
+
*
|
|
7
|
+
* You can find a copy of the license in file LICENSE in the root
|
|
8
|
+
* directory of this repository or package, or at
|
|
9
|
+
* https://github.com/restatedev/sdk-typescript/blob/main/LICENSE
|
|
10
|
+
*/
|
|
11
|
+
/* eslint-disable @typescript-eslint/no-explicit-any */
|
|
12
|
+
import { serde } from "./serde_api.js";
|
|
13
|
+
export function makeHandlerDescriptor(inputSerde, outputSerde, shared) {
|
|
14
|
+
return {
|
|
15
|
+
_inputSerde: inputSerde,
|
|
16
|
+
_outputSerde: outputSerde,
|
|
17
|
+
_shared: shared,
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Declare a service interface (contract) as a runtime value carrying handler
|
|
22
|
+
* names + input/output serdes, without an implementation. Place it in a shared
|
|
23
|
+
* package that both the server (via `implement()`) and callers (via
|
|
24
|
+
* `ctx.serviceClient(iface)` / `connect().serviceClient(iface)`) import.
|
|
25
|
+
*
|
|
26
|
+
* @example
|
|
27
|
+
* ```ts
|
|
28
|
+
* const greeter = iface.service("greeter", {
|
|
29
|
+
* greet: iface.schemas({ input: GreetReq, output: GreetRes }),
|
|
30
|
+
* ping: iface.json<void, string>(),
|
|
31
|
+
* });
|
|
32
|
+
* ```
|
|
33
|
+
*/
|
|
34
|
+
export const iface = {
|
|
35
|
+
service: function (name, handlers) {
|
|
36
|
+
return { name, _kind: "service", _handlers: handlers };
|
|
37
|
+
},
|
|
38
|
+
object: function (name, handlers) {
|
|
39
|
+
return { name, _kind: "object", _handlers: handlers };
|
|
40
|
+
},
|
|
41
|
+
workflow: function (name, handlers) {
|
|
42
|
+
return { name, _kind: "workflow", _handlers: handlers };
|
|
43
|
+
},
|
|
44
|
+
json: function () {
|
|
45
|
+
return makeHandlerDescriptor(undefined, undefined, false);
|
|
46
|
+
},
|
|
47
|
+
serdes: function (opts) {
|
|
48
|
+
return makeHandlerDescriptor(opts.input, opts.output, false);
|
|
49
|
+
},
|
|
50
|
+
schemas: function (opts) {
|
|
51
|
+
return makeHandlerDescriptor(opts.input ? serde.schema(opts.input) : undefined, opts.output ? serde.schema(opts.output) : undefined, false);
|
|
52
|
+
},
|
|
53
|
+
shared: {
|
|
54
|
+
json: function () {
|
|
55
|
+
return makeHandlerDescriptor(undefined, undefined, true);
|
|
56
|
+
},
|
|
57
|
+
serdes: function (opts) {
|
|
58
|
+
return makeHandlerDescriptor(opts.input, opts.output, true);
|
|
59
|
+
},
|
|
60
|
+
schemas: function (opts) {
|
|
61
|
+
return makeHandlerDescriptor(opts.input ? serde.schema(opts.input) : undefined, opts.output ? serde.schema(opts.output) : undefined, true);
|
|
62
|
+
},
|
|
63
|
+
},
|
|
64
|
+
};
|
|
65
|
+
//# sourceMappingURL=interface.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"interface.js","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,uDAAuD;AAGvD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAsBvC,MAAM,UAAU,qBAAqB,CACnC,UAAqB,EACrB,WAAsB,EACtB,MAAe;IAEf,OAAO;QACL,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,WAAW;QACzB,OAAO,EAAE,MAAM;KAChB,CAAC;AACJ,CAAC;AA4ID;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,KAAK,GAAqB;IACrC,OAAO,EAAE,UAGP,IAAO,EAAE,QAAW;QACpB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACzD,CAAC;IACD,MAAM,EAAE,UAGN,IAAO,EAAE,QAAW;QACpB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACxD,CAAC;IACD,QAAQ,EAAE,UAGR,IAAO,EAAE,QAAW;QACpB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,EAAE;QACJ,OAAO,qBAAqB,CAAc,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,EAAE,UAAwD,IAG/D;QACC,OAAO,qBAAqB,CAC1B,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,MAAM,EACX,KAAK,CACN,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,UAGP,IAGD;QAKC,OAAO,qBAAqB,CAC1B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EACjD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EACnD,KAAK,CACN,CAAC;IACJ,CAAC;IACD,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,OAAO,qBAAqB,CAAa,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,EAAE,UAAwD,IAG/D;YACC,OAAO,qBAAqB,CAC1B,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,MAAM,EACX,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,UAGP,IAGD;YAKC,OAAO,qBAAqB,CAC1B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EACjD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EACnD,IAAI,CACL,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}
|