@brickkit/core 0.5.0 → 0.6.1
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/README.md +1 -1
- package/dist/chunks/errors.d.ts +20 -9
- package/dist/chunks/errors.d.ts.map +1 -1
- package/dist/chunks/errors.js +83 -38
- package/dist/chunks/errors.js.map +1 -1
- package/dist/index.d.ts +34 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8 -3
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -88,7 +88,7 @@ Brick.app({
|
|
|
88
88
|
});
|
|
89
89
|
```
|
|
90
90
|
|
|
91
|
-
Only actions
|
|
91
|
+
Only actions with `expose: "mcp"` or `expose: "both"` are exposed as MCP tools. The MCP
|
|
92
92
|
options are those of Effect's `McpServer.layerHttp`.
|
|
93
93
|
|
|
94
94
|
## Entry points
|
package/dist/chunks/errors.d.ts
CHANGED
|
@@ -4,11 +4,11 @@ import { Rpc } from "effect/rpc";
|
|
|
4
4
|
import { Tool } from "effect/ai";
|
|
5
5
|
import { HttpMethod } from "effect/http/HttpMethod";
|
|
6
6
|
//#region src/native/contracts.d.ts
|
|
7
|
-
|
|
7
|
+
type ActionSchemas<I extends Schema.Top, O extends Schema.Top, Errors extends readonly Schema.Top[]> = {
|
|
8
8
|
input: I;
|
|
9
9
|
output: O;
|
|
10
10
|
errors: Errors;
|
|
11
|
-
|
|
11
|
+
expose?: "http" | "mcp" | "both";
|
|
12
12
|
description?: string;
|
|
13
13
|
title?: string;
|
|
14
14
|
tool?: {
|
|
@@ -17,15 +17,22 @@ declare const action: <const N extends string, I extends Schema.Top, O extends S
|
|
|
17
17
|
readonly idempotent?: boolean;
|
|
18
18
|
readonly openWorld?: boolean;
|
|
19
19
|
};
|
|
20
|
-
}
|
|
20
|
+
};
|
|
21
|
+
declare const action: <const N extends string, I extends Schema.Top, O extends Schema.Top, const Errors extends readonly Schema.Top[]>(name: N,
|
|
22
|
+
/**
|
|
23
|
+
* HTTP route, or the schemas when omitted. `path` defaults to `/${name}`;
|
|
24
|
+
* omit it for `expose: "mcp"` tool-only actions.
|
|
25
|
+
*/
|
|
26
|
+
path: `/${string}` | ActionSchemas<I, O, Errors>, schemas?: ActionSchemas<I, O, Errors>) => (<Failure extends Errors[number]["Type"], R>(handler: (input: I["Type"]) => Effect.Effect<O["Type"], Failure, R>) => Readonly<{
|
|
21
27
|
handler: (input: I["Type"]) => Effect.Effect<O["Type"], Failure, Exclude<R, import("effect/Tracer").ParentSpan>>;
|
|
22
28
|
httpHandler: ({ payload }: {
|
|
23
29
|
payload: I["Type"];
|
|
24
30
|
}) => Effect.Effect<O["Type"], Failure, Exclude<R, import("effect/Tracer").ParentSpan>>;
|
|
25
31
|
name: N;
|
|
26
|
-
endpoint: HttpApiEndpoint.HttpApiEndpoint<N, "POST", `/${string}`, never, never, [I extends Schema.Struct.Fields ? Schema.Struct<I> : I extends readonly Schema.Constraint[] ? I[number] : I] extends [never] ? never : [I extends Schema.Struct.Fields ? Schema.Struct<I> : I extends readonly Schema.Constraint[] ? I[number] : I] extends [Schema.Constraint] ? Schema.toCodecJson<Schema.Constraint & (I extends Schema.Struct.Fields ? Schema.Struct<I> : I extends readonly Schema.Constraint[] ? I[number] : I)> : never, never, [Exclude<Extract<O extends readonly (infer A)[] ? A : O, Schema.Top>, HttpApiSchema.WithHeaders<Schema.Top, Schema.Top
|
|
32
|
+
endpoint: HttpApiEndpoint.HttpApiEndpoint<N, "POST", `/${string}`, never, never, [I extends Schema.Struct.Fields ? Schema.Struct<I> : I extends readonly Schema.Constraint[] ? I[number] : I] extends [never] ? never : [I extends Schema.Struct.Fields ? Schema.Struct<I> : I extends readonly Schema.Constraint[] ? I[number] : I] extends [Schema.Constraint] ? Schema.toCodecJson<Schema.Constraint & (I extends Schema.Struct.Fields ? Schema.Struct<I> : I extends readonly Schema.Constraint[] ? I[number] : I)> : never, never, [Exclude<Extract<O extends readonly (infer A)[] ? A : O, Schema.Top>, HttpApiSchema.StreamSchema | HttpApiSchema.WithHeaders<Schema.Top, Schema.Top>>] extends [never] ? ((O extends readonly (infer A)[] ? A : O) extends (infer Success) ? Success extends HttpApiSchema.StreamSchema ? Success : never : never) | ((O extends readonly (infer A)[] ? A : O) extends (infer Success_1) ? Success_1 extends HttpApiSchema.WithHeaders<infer _Inner extends Schema.Top, infer _Headers extends Schema.Top> ? HttpApiSchema.WithHeaders<_Inner extends HttpApiSchema.StreamSchema ? _Inner : Schema.toCodecJson<_Inner>, Schema.toCodecStringTree<_Headers>> : never : never) : ((O extends readonly (infer A)[] ? A : O) extends (infer Success) ? Success extends HttpApiSchema.StreamSchema ? Success : never : never) | ((O extends readonly (infer A)[] ? A : O) extends (infer Success_1) ? Success_1 extends HttpApiSchema.WithHeaders<infer _Inner extends Schema.Top, infer _Headers extends Schema.Top> ? HttpApiSchema.WithHeaders<_Inner extends HttpApiSchema.StreamSchema ? _Inner : Schema.toCodecJson<_Inner>, Schema.toCodecStringTree<_Headers>> : never : never) | Schema.toCodecJson<Exclude<Extract<O extends readonly (infer A)[] ? A : O, Schema.Top>, HttpApiSchema.StreamSchema | HttpApiSchema.WithHeaders<Schema.Top, Schema.Top>>>, [Schema.Union<readonly [Schema.Union<Errors>]>] extends [Schema.Constraint] ? Schema.toCodecJson<Schema.Constraint & Schema.Union<readonly [Schema.Union<Errors>]>> : never, never, never>;
|
|
27
33
|
method: HttpMethod;
|
|
28
34
|
path: `/${string}`;
|
|
35
|
+
http: boolean;
|
|
29
36
|
rpc: Rpc.Rpc<N, I extends Schema.Struct.Fields ? Schema.Struct<I> : I, O, Schema.Union<Errors>, never, never>;
|
|
30
37
|
tool: Tool.Tool<N, {
|
|
31
38
|
readonly parameters: I;
|
|
@@ -36,9 +43,10 @@ declare const action: <const N extends string, I extends Schema.Top, O extends S
|
|
|
36
43
|
mcp: boolean;
|
|
37
44
|
}>) & Readonly<{
|
|
38
45
|
name: N;
|
|
39
|
-
endpoint: HttpApiEndpoint.HttpApiEndpoint<N, "POST", `/${string}`, never, never, [I extends Schema.Struct.Fields ? Schema.Struct<I> : I extends readonly Schema.Constraint[] ? I[number] : I] extends [never] ? never : [I extends Schema.Struct.Fields ? Schema.Struct<I> : I extends readonly Schema.Constraint[] ? I[number] : I] extends [Schema.Constraint] ? Schema.toCodecJson<Schema.Constraint & (I extends Schema.Struct.Fields ? Schema.Struct<I> : I extends readonly Schema.Constraint[] ? I[number] : I)> : never, never, [Exclude<Extract<O extends readonly (infer A)[] ? A : O, Schema.Top>, HttpApiSchema.WithHeaders<Schema.Top, Schema.Top
|
|
46
|
+
endpoint: HttpApiEndpoint.HttpApiEndpoint<N, "POST", `/${string}`, never, never, [I extends Schema.Struct.Fields ? Schema.Struct<I> : I extends readonly Schema.Constraint[] ? I[number] : I] extends [never] ? never : [I extends Schema.Struct.Fields ? Schema.Struct<I> : I extends readonly Schema.Constraint[] ? I[number] : I] extends [Schema.Constraint] ? Schema.toCodecJson<Schema.Constraint & (I extends Schema.Struct.Fields ? Schema.Struct<I> : I extends readonly Schema.Constraint[] ? I[number] : I)> : never, never, [Exclude<Extract<O extends readonly (infer A)[] ? A : O, Schema.Top>, HttpApiSchema.StreamSchema | HttpApiSchema.WithHeaders<Schema.Top, Schema.Top>>] extends [never] ? ((O extends readonly (infer A)[] ? A : O) extends (infer Success) ? Success extends HttpApiSchema.StreamSchema ? Success : never : never) | ((O extends readonly (infer A)[] ? A : O) extends (infer Success_1) ? Success_1 extends HttpApiSchema.WithHeaders<infer _Inner extends Schema.Top, infer _Headers extends Schema.Top> ? HttpApiSchema.WithHeaders<_Inner extends HttpApiSchema.StreamSchema ? _Inner : Schema.toCodecJson<_Inner>, Schema.toCodecStringTree<_Headers>> : never : never) : ((O extends readonly (infer A)[] ? A : O) extends (infer Success) ? Success extends HttpApiSchema.StreamSchema ? Success : never : never) | ((O extends readonly (infer A)[] ? A : O) extends (infer Success_1) ? Success_1 extends HttpApiSchema.WithHeaders<infer _Inner extends Schema.Top, infer _Headers extends Schema.Top> ? HttpApiSchema.WithHeaders<_Inner extends HttpApiSchema.StreamSchema ? _Inner : Schema.toCodecJson<_Inner>, Schema.toCodecStringTree<_Headers>> : never : never) | Schema.toCodecJson<Exclude<Extract<O extends readonly (infer A)[] ? A : O, Schema.Top>, HttpApiSchema.StreamSchema | HttpApiSchema.WithHeaders<Schema.Top, Schema.Top>>>, [Schema.Union<readonly [Schema.Union<Errors>]>] extends [Schema.Constraint] ? Schema.toCodecJson<Schema.Constraint & Schema.Union<readonly [Schema.Union<Errors>]>> : never, never, never>;
|
|
40
47
|
method: HttpMethod;
|
|
41
48
|
path: `/${string}`;
|
|
49
|
+
http: boolean;
|
|
42
50
|
rpc: Rpc.Rpc<N, I extends Schema.Struct.Fields ? Schema.Struct<I> : I, O, Schema.Union<Errors>, never, never>;
|
|
43
51
|
tool: Tool.Tool<N, {
|
|
44
52
|
readonly parameters: I;
|
|
@@ -54,17 +62,18 @@ type ParamCodec<S> = [S] extends [never] ? never : S extends Schema.Top ? Schema
|
|
|
54
62
|
type PayloadCodec<S> = [S] extends [never] ? never : S extends Schema.Top ? Schema.toCodecJson<S> : never;
|
|
55
63
|
type SuccessCodec<S> = [S] extends [never] ? typeof HttpApiSchema.NoContent : S extends Schema.Top ? Schema.toCodecJson<S> : never;
|
|
56
64
|
type ErrorCodec<E extends readonly Schema.Top[]> = [E] extends [never] ? never : Schema.toCodecJson<Schema.Union<[Schema.Union<E>]>>;
|
|
57
|
-
|
|
58
|
-
declare const endpoint: <const N extends string, const M extends HttpMethod, const I extends Record<string, Schema.Top>, O extends Schema.Top, const Errors extends readonly Schema.Top[]>(name: N, method: M, path: `/${string}`, schemas: {
|
|
65
|
+
type EndpointSchemas<M extends HttpMethod, I extends Record<string, Schema.Top>, O extends Schema.Top, Errors extends readonly Schema.Top[]> = {
|
|
59
66
|
readonly input: I & Record<Exclude<keyof I, HttpInputKey>, never> & (M extends HttpMethod.NoBody ? {
|
|
60
67
|
readonly payload?: never;
|
|
61
68
|
} : unknown);
|
|
62
69
|
readonly output: O;
|
|
63
70
|
readonly errors: Errors;
|
|
64
|
-
readonly
|
|
71
|
+
readonly expose?: "http" | "mcp" | "both";
|
|
65
72
|
readonly description?: string;
|
|
66
73
|
readonly title?: string;
|
|
67
|
-
}
|
|
74
|
+
};
|
|
75
|
+
/** Typed HTTP request parts also form the input contract for local/RPC/tool calls. */
|
|
76
|
+
declare const endpoint: <const N extends string, const M extends HttpMethod, const I extends Record<string, Schema.Top>, O extends Schema.Top, const Errors extends readonly Schema.Top[]>(name: N, method: M, path: `/${string}` | EndpointSchemas<M, I, O, Errors>, schemas?: EndpointSchemas<M, I, O, Errors>) => (<Failure extends Errors[number]["Type"], R>(handler: (input: Schema.Struct.View<I & Record<Exclude<keyof I, HttpInputKey>, never> & (M extends HttpMethod.NoBody ? {
|
|
68
77
|
readonly payload?: never;
|
|
69
78
|
} : unknown), "Type", Schema.Struct.TypeOptionalKeys<I & Record<Exclude<keyof I, HttpInputKey>, never> & (M extends HttpMethod.NoBody ? {
|
|
70
79
|
readonly payload?: never;
|
|
@@ -89,6 +98,7 @@ declare const endpoint: <const N extends string, const M extends HttpMethod, con
|
|
|
89
98
|
} : unknown)>>) => Effect.Effect<O["Type"], Failure, Exclude<R, import("effect/Tracer").ParentSpan>>;
|
|
90
99
|
name: N;
|
|
91
100
|
path: `/${string}`;
|
|
101
|
+
http: boolean;
|
|
92
102
|
rpc: Rpc.Rpc<N, Schema.Struct<I & Record<Exclude<keyof I, HttpInputKey>, never> & (M extends HttpMethod.NoBody ? {
|
|
93
103
|
readonly payload?: never;
|
|
94
104
|
} : unknown)>, O, Schema.Union<Errors>, never, never>;
|
|
@@ -106,6 +116,7 @@ declare const endpoint: <const N extends string, const M extends HttpMethod, con
|
|
|
106
116
|
method: HttpMethod;
|
|
107
117
|
endpoint: HttpApiEndpoint.HttpApiEndpoint<N, M, `/${string}`, ParamCodec<Part<I, "params">>, ParamCodec<Part<I, "query">>, PayloadCodec<Part<I, "payload">>, ParamCodec<Part<I, "headers">>, SuccessCodec<O>, ErrorCodec<Errors>, never, never>;
|
|
108
118
|
path: `/${string}`;
|
|
119
|
+
http: boolean;
|
|
109
120
|
rpc: Rpc.Rpc<N, Schema.Struct<I & Record<Exclude<keyof I, HttpInputKey>, never> & (M extends HttpMethod.NoBody ? {
|
|
110
121
|
readonly payload?: never;
|
|
111
122
|
} : unknown)>, O, Schema.Union<Errors>, never, never>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/native/contracts.ts","../../src/native/errors.ts"],"mappings":";;;;;;
|
|
1
|
+
{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/native/contracts.ts","../../src/native/errors.ts"],"mappings":";;;;;;KA8DK,cACH,UAAU,OAAO,KACjB,UAAU,OAAO,KACjB,wBAAwB,OAAO;EAE/B,OAAO;EACP,QAAQ;EACR,QAAQ;EACR;EACA;EACA;EACA;aACW;aACA;aACA;aACA;;;cAqFA,eACL,kBACN,UAAU,OAAO,KACjB,UAAU,OAAO,WACX,wBAAwB,OAAO,OAErC,MAAM;;;;;AAKN,qBAAqB,cAAc,GAAG,GAAG,SACzC,UAAU,cAAc,GAAG,GAAG,cA/BX,gBAAO,wBAAiC,GAAC,UAAA,OAAA,cAAA,OAAA,OAAA,WAAA,SAAA,OAAA;;;;;;;EAZxC,QAAA;;;;;;;;;;;;;;EAAA,QAAA;;;;;;;;;;;;KA+DjB;KACA,KAAK,GAAG,UAAU,gBAAgB,gBAAgB,IAAI,EAAE;KAExD,WAAW,MAAM,6BAElB,UAAU,OAAO,MACf,OAAO,kBAAkB;KAG1B,aAAa,MAAM,6BAEpB,UAAU,OAAO,MACf,OAAO,YAAY;KAGpB,aAAa,MAAM,4BACb,cAAc,YACrB,UAAU,OAAO,MACf,OAAO,YAAY;KAGpB,WAAW,mBAAmB,OAAO,UAAU,6BAEhD,OAAO,YAAY,OAAO,OAAO,OAAO,MAAM;KAE7C,gBACH,UAAU,YACV,UAAU,eAAe,OAAO,MAChC,UAAU,OAAO,KACjB,wBAAwB,OAAO;WAEtB,OAAO,IACd,OAAO,cAAc,GAAG,yBACvB,UAAU,WAAW;aAAoB;;WACnC,QAAQ;WACR,QAAQ;WACR;WACA;WACA;;;cAIE,iBACL,wBACA,UAAU,kBACV,UAAU,eAAe,OAAO,MACtC,UAAU,OAAO,WACX,wBAAwB,OAAO,OAErC,MAAM,GACN,QAAQ,GACR,qBAAqB,gBAAgB,GAAG,GAAG,GAAG,SAC9C,UAAU,gBAAgB,GAAG,GAAG,GAAG,cAmEhB,gBAAgB,wBAAwB,GAAC,UAExD,OAAK,OAAA,OAAA,KAAA,IAAA,OAAA,cAAA,GAAA,yBAAA,UAAA,WAAA;WAxF6C;;WAAA;;WAAA;mBAyF/C,OAAO,OAAO,WAAW,SAAS,OAAE;EAKrB,QAAA;;;aA9FgC;;aAAA;;aAAA;;;aAAA;;aAAA;;aAAA;;;;;;aAAA;;;;eAAA;;;;;;;;;EAmFlC,QAAA;;;;;aAnFkC;;;;eAAA;;;;;;;;;;;;;;cCjO3C,mBAAmB;;;;cAKnB,qBAAqB;;;;cAKrB,kBAAkB;;;;cAKlB,iBAAiB;;;;cAKjB,iBAAiB;;;;cAKjB,4BAA4B"}
|
package/dist/chunks/errors.js
CHANGED
|
@@ -9,44 +9,70 @@ const redactedDefect = Schema.Unknown.pipe(Schema.decodeTo(Schema.Unknown, {
|
|
|
9
9
|
encode: SchemaGetter.transform(() => ({ message: "Internal server error" }))
|
|
10
10
|
}));
|
|
11
11
|
const errorWrapper = (error) => Schema.Union([error]).annotate({ httpApiStatus: SchemaAST.resolveAt("httpApiStatus")(error.ast) ?? 500 });
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
12
|
+
/**
|
|
13
|
+
* Codec resolution (e.g. non-string-encodable path params) fails deep inside
|
|
14
|
+
* Effect with no mention of the route. Attribute it before rethrowing.
|
|
15
|
+
*/
|
|
16
|
+
const attributed = (label, build) => {
|
|
17
|
+
try {
|
|
18
|
+
return build();
|
|
19
|
+
} catch (error) {
|
|
20
|
+
throw new Error(`${label}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
|
|
21
|
+
}
|
|
22
|
+
};
|
|
23
|
+
/**
|
|
24
|
+
* Probe one string-tree part (params/query/headers) in isolation so a
|
|
25
|
+
* non-encodable schema fails naming the action, route and part. `make()`
|
|
26
|
+
* never validates path/params consistency, so the fixed probe path only
|
|
27
|
+
* exercises codec resolution and cannot false-positive.
|
|
28
|
+
*/
|
|
29
|
+
const checkStringPart = (label, part, schema) => {
|
|
30
|
+
try {
|
|
31
|
+
HttpApiEndpoint.get("__brick_probe__", "/__brick_probe__", { [part]: schema });
|
|
32
|
+
} catch (error) {
|
|
33
|
+
throw new Error(`${label}: "${part}" cannot be encoded into a URL. params, query and headers only support structural schemas (String, Number, Boolean, UUID, Literal, enums, Dates and arrays of those); move rich objects into payload. Cause: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
|
|
34
|
+
}
|
|
35
|
+
};
|
|
36
|
+
const defineAction = (name, route, options) => {
|
|
37
|
+
const label = `Brick.action("${name}", "${route}")`;
|
|
38
|
+
const errors = options.errors.map((error) => errorWrapper(error));
|
|
39
|
+
attributed(label, () => HttpApiEndpoint.post(name, route, {
|
|
40
|
+
payload: options.input,
|
|
41
|
+
success: options.output,
|
|
42
|
+
error: Schema.Union([Schema.Union(options.errors)])
|
|
43
|
+
}));
|
|
44
|
+
let endpoint = attributed(label, () => HttpApiEndpoint.post(name, route, {
|
|
45
|
+
payload: options.input,
|
|
46
|
+
success: options.output,
|
|
22
47
|
error: errors
|
|
23
|
-
});
|
|
24
|
-
if (
|
|
25
|
-
if (
|
|
48
|
+
}));
|
|
49
|
+
if (options.description) endpoint = endpoint.annotate(OpenApi.Description, options.description);
|
|
50
|
+
if (options.title) endpoint = endpoint.annotate(OpenApi.Summary, options.title);
|
|
26
51
|
let tool = Tool.make(name, {
|
|
27
|
-
parameters:
|
|
28
|
-
success:
|
|
29
|
-
failure: Schema.Union(
|
|
30
|
-
description:
|
|
52
|
+
parameters: options.input,
|
|
53
|
+
success: options.output,
|
|
54
|
+
failure: Schema.Union(options.errors),
|
|
55
|
+
description: options.description
|
|
31
56
|
});
|
|
32
|
-
if (
|
|
33
|
-
if (
|
|
34
|
-
if (
|
|
35
|
-
if (
|
|
36
|
-
if (
|
|
57
|
+
if (options.title) tool = tool.annotate(Tool.Title, options.title);
|
|
58
|
+
if (options.tool?.readOnly !== void 0) tool = tool.annotate(Tool.Readonly, options.tool.readOnly);
|
|
59
|
+
if (options.tool?.destructive !== void 0) tool = tool.annotate(Tool.Destructive, options.tool.destructive);
|
|
60
|
+
if (options.tool?.idempotent !== void 0) tool = tool.annotate(Tool.Idempotent, options.tool.idempotent);
|
|
61
|
+
if (options.tool?.openWorld !== void 0) tool = tool.annotate(Tool.OpenWorld, options.tool.openWorld);
|
|
37
62
|
const contract = Object.freeze({
|
|
38
63
|
name,
|
|
39
64
|
endpoint,
|
|
40
65
|
method: "POST",
|
|
41
|
-
path,
|
|
66
|
+
path: route,
|
|
67
|
+
http: (options.expose ?? "http") !== "mcp",
|
|
42
68
|
rpc: Rpc.make(name, {
|
|
43
|
-
payload:
|
|
44
|
-
success:
|
|
45
|
-
error: Schema.Union(
|
|
69
|
+
payload: options.input,
|
|
70
|
+
success: options.output,
|
|
71
|
+
error: Schema.Union(options.errors),
|
|
46
72
|
defect: redactedDefect
|
|
47
73
|
}),
|
|
48
74
|
tool,
|
|
49
|
-
mcp:
|
|
75
|
+
mcp: (options.expose ?? "http") !== "http"
|
|
50
76
|
});
|
|
51
77
|
const implement = (handler) => {
|
|
52
78
|
const invoke = (input) => handler(input).pipe(Effect.withSpan(`brick.action.${name}`));
|
|
@@ -63,31 +89,50 @@ const action = (name, path, schemas) => {
|
|
|
63
89
|
});
|
|
64
90
|
return Object.freeze(Object.assign(implement, contract));
|
|
65
91
|
};
|
|
92
|
+
const action = (name, path, schemas) => {
|
|
93
|
+
const options = typeof path === "string" ? schemas : path;
|
|
94
|
+
if (!options) throw new Error(`Brick.action("${name}") requires input, output and error schemas`);
|
|
95
|
+
const route = typeof path === "string" ? path : `/${name}`;
|
|
96
|
+
if (route.includes("/:")) throw new Error(`Brick.action("${name}") path "${route}" has :param segments, but Brick.action only sends the input as a JSON payload and never fills params. Use Brick.endpoint with a params schema instead.`);
|
|
97
|
+
return defineAction(name, route, options);
|
|
98
|
+
};
|
|
66
99
|
/** Typed HTTP request parts also form the input contract for local/RPC/tool calls. */
|
|
67
100
|
const endpoint = (name, method, path, schemas) => {
|
|
68
|
-
const
|
|
69
|
-
|
|
70
|
-
|
|
101
|
+
const options = typeof path === "string" ? schemas : path;
|
|
102
|
+
if (!options) throw new Error(`Brick.endpoint("${name}") requires input, output and error schemas`);
|
|
103
|
+
const route = typeof path === "string" ? path : `/${name}`;
|
|
104
|
+
const label = `Brick.endpoint("${name}", "${method}", "${route}")`;
|
|
105
|
+
const requestSchema = Schema.Struct(options.input);
|
|
106
|
+
const base = defineAction(name, route, {
|
|
107
|
+
...options,
|
|
71
108
|
input: requestSchema
|
|
72
109
|
});
|
|
73
|
-
const parts =
|
|
110
|
+
const parts = options.input;
|
|
111
|
+
for (const part of [
|
|
112
|
+
"params",
|
|
113
|
+
"query",
|
|
114
|
+
"headers"
|
|
115
|
+
]) {
|
|
116
|
+
const schema = parts[part];
|
|
117
|
+
if (schema !== void 0) checkStringPart(label, part, schema);
|
|
118
|
+
}
|
|
74
119
|
const endpointOptions = {
|
|
75
120
|
...parts.params !== void 0 ? { params: parts.params } : {},
|
|
76
121
|
...parts.query !== void 0 ? { query: parts.query } : {},
|
|
77
122
|
...parts.payload !== void 0 ? { payload: parts.payload } : {},
|
|
78
123
|
...parts.headers !== void 0 ? { headers: parts.headers } : {},
|
|
79
|
-
success:
|
|
80
|
-
error: Schema.Union([Schema.Union(
|
|
124
|
+
success: options.output,
|
|
125
|
+
error: Schema.Union([Schema.Union(options.errors)])
|
|
81
126
|
};
|
|
82
|
-
HttpApiEndpoint.make(method)(name,
|
|
83
|
-
const http = HttpApiEndpoint.make(method)(name,
|
|
127
|
+
attributed(label, () => HttpApiEndpoint.make(method)(name, route, endpointOptions));
|
|
128
|
+
const http = attributed(label, () => HttpApiEndpoint.make(method)(name, route, {
|
|
84
129
|
...parts.params !== void 0 ? { params: parts.params } : {},
|
|
85
130
|
...parts.query !== void 0 ? { query: parts.query } : {},
|
|
86
131
|
...parts.payload !== void 0 ? { payload: parts.payload } : {},
|
|
87
132
|
...parts.headers !== void 0 ? { headers: parts.headers } : {},
|
|
88
|
-
success:
|
|
89
|
-
error:
|
|
90
|
-
});
|
|
133
|
+
success: options.output,
|
|
134
|
+
error: options.errors.map(errorWrapper)
|
|
135
|
+
}));
|
|
91
136
|
const metadata = {
|
|
92
137
|
...base,
|
|
93
138
|
name,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.js","names":[],"sources":["../../src/native/contracts.ts","../../src/native/errors.ts"],"sourcesContent":["import { Effect, Schema, SchemaAST, SchemaGetter } from \"effect\";\nimport { HttpApiEndpoint, HttpApiSchema, OpenApi } from \"effect/http-api\";\nimport { Rpc } from \"effect/rpc\";\nimport { Tool } from \"effect/ai\";\nimport type { HttpMethod } from \"effect/http/HttpMethod\";\n\nconst redactedDefect = Schema.Unknown.pipe(\n Schema.decodeTo(Schema.Unknown, {\n decode: SchemaGetter.transform(() => new Error(\"Internal server error\")),\n encode: SchemaGetter.transform(() => ({\n message: \"Internal server error\",\n })),\n }),\n);\n\nconst errorWrapper = <E extends Schema.Top>(error: E) =>\n Schema.Union([error]).annotate({\n httpApiStatus:\n SchemaAST.resolveAt<number>(\"httpApiStatus\")(error.ast) ?? 500,\n });\nexport const action = <\n const N extends string,\n I extends Schema.Top,\n O extends Schema.Top,\n const Errors extends readonly Schema.Top[],\n>(\n name: N,\n path: `/${string}`,\n schemas: {\n input: I;\n output: O;\n errors: Errors;\n mcp?: boolean;\n description?: string;\n title?: string;\n tool?: {\n readonly readOnly?: boolean;\n readonly destructive?: boolean;\n readonly idempotent?: boolean;\n readonly openWorld?: boolean;\n };\n },\n) => {\n const errors = schemas.errors.map((error) => errorWrapper(error));\n const typedEndpoint = HttpApiEndpoint.post(name, path, {\n payload: schemas.input,\n success: schemas.output,\n error: Schema.Union([Schema.Union(schemas.errors)]),\n });\n // Native private ErrorNoStream cannot reduce arrays with open schema members.\n // Mapping the identical error schemas preserves all Type/EncodingServices slots.\n let endpoint = HttpApiEndpoint.post(name, path, {\n payload: schemas.input,\n success: schemas.output,\n error: errors,\n }) as unknown as typeof typedEndpoint;\n if (schemas.description)\n endpoint = endpoint.annotate(OpenApi.Description, schemas.description);\n if (schemas.title)\n endpoint = endpoint.annotate(OpenApi.Summary, schemas.title);\n let tool = Tool.make(name, {\n parameters: schemas.input,\n success: schemas.output,\n failure: Schema.Union(schemas.errors),\n description: schemas.description,\n });\n if (schemas.title) tool = tool.annotate(Tool.Title, schemas.title);\n if (schemas.tool?.readOnly !== undefined)\n tool = tool.annotate(Tool.Readonly, schemas.tool.readOnly);\n if (schemas.tool?.destructive !== undefined)\n tool = tool.annotate(Tool.Destructive, schemas.tool.destructive);\n if (schemas.tool?.idempotent !== undefined)\n tool = tool.annotate(Tool.Idempotent, schemas.tool.idempotent);\n if (schemas.tool?.openWorld !== undefined)\n tool = tool.annotate(Tool.OpenWorld, schemas.tool.openWorld);\n const contract = Object.freeze({\n name,\n endpoint,\n method: \"POST\" as HttpMethod,\n path,\n rpc: Rpc.make(name, {\n payload: schemas.input,\n success: schemas.output,\n error: Schema.Union(schemas.errors),\n defect: redactedDefect,\n }),\n tool,\n mcp: schemas.mcp === true,\n });\n const implement = <Failure extends Errors[number][\"Type\"], R>(\n handler: (input: I[\"Type\"]) => Effect.Effect<O[\"Type\"], Failure, R>,\n ) => {\n const invoke = (input: I[\"Type\"]) =>\n handler(input).pipe(Effect.withSpan(`brick.action.${name}`));\n return Object.freeze({\n ...contract,\n handler: invoke,\n httpHandler: ({ payload }: { payload: I[\"Type\"] }) => invoke(payload),\n });\n };\n Object.defineProperty(implement, \"name\", {\n value: name,\n writable: true,\n configurable: true,\n });\n return Object.freeze(Object.assign(implement, contract));\n};\n\ntype HttpInputKey = \"params\" | \"query\" | \"payload\" | \"headers\";\ntype Part<I, K extends HttpInputKey> = K extends keyof I ? I[K] : never;\n\ntype ParamCodec<S> = [S] extends [never]\n ? never\n : S extends Schema.Top\n ? Schema.toCodecStringTree<S>\n : never;\n\ntype PayloadCodec<S> = [S] extends [never]\n ? never\n : S extends Schema.Top\n ? Schema.toCodecJson<S>\n : never;\n\ntype SuccessCodec<S> = [S] extends [never]\n ? typeof HttpApiSchema.NoContent\n : S extends Schema.Top\n ? Schema.toCodecJson<S>\n : never;\n\ntype ErrorCodec<E extends readonly Schema.Top[]> = [E] extends [never]\n ? never\n : Schema.toCodecJson<Schema.Union<[Schema.Union<E>]>>;\n\n/** Typed HTTP request parts also form the input contract for local/RPC/tool calls. */\nexport const endpoint = <\n const N extends string,\n const M extends HttpMethod,\n const I extends Record<string, Schema.Top>,\n O extends Schema.Top,\n const Errors extends readonly Schema.Top[],\n>(\n name: N,\n method: M,\n path: `/${string}`,\n schemas: {\n readonly input: I &\n Record<Exclude<keyof I, HttpInputKey>, never> &\n (M extends HttpMethod.NoBody ? { readonly payload?: never } : unknown);\n readonly output: O;\n readonly errors: Errors;\n readonly mcp?: boolean;\n readonly description?: string;\n readonly title?: string;\n },\n) => {\n const requestSchema = Schema.Struct(schemas.input);\n const base = action(name, path, { ...schemas, input: requestSchema });\n const parts = schemas.input;\n const endpointOptions = {\n ...(parts.params !== undefined\n ? { params: parts.params as Part<I, \"params\"> }\n : {}),\n ...(parts.query !== undefined\n ? { query: parts.query as Part<I, \"query\"> }\n : {}),\n ...(parts.payload !== undefined\n ? {\n payload: parts.payload as Part<I, \"payload\"> &\n HttpApiEndpoint.PayloadConstraintCodecs<M>,\n }\n : {}),\n ...(parts.headers !== undefined\n ? { headers: parts.headers as Part<I, \"headers\"> }\n : {}),\n success: schemas.output,\n error: Schema.Union([Schema.Union(schemas.errors)]),\n };\n const typed = (HttpApiEndpoint.make(method) as any)(\n name,\n path,\n endpointOptions,\n ) as HttpApiEndpoint.HttpApiEndpoint<\n N,\n M,\n `/${string}`,\n ParamCodec<Part<I, \"params\">>,\n ParamCodec<Part<I, \"query\">>,\n PayloadCodec<Part<I, \"payload\">>,\n ParamCodec<Part<I, \"headers\">>,\n SuccessCodec<O>,\n ErrorCodec<Errors>\n >;\n\n const http = (HttpApiEndpoint.make(method) as any)(name, path, {\n ...(parts.params !== undefined ? { params: parts.params } : {}),\n ...(parts.query !== undefined ? { query: parts.query } : {}),\n ...(parts.payload !== undefined ? { payload: parts.payload } : {}),\n ...(parts.headers !== undefined ? { headers: parts.headers } : {}),\n success: schemas.output,\n error: schemas.errors.map(errorWrapper),\n }) as unknown as typeof typed;\n const metadata = {\n ...base,\n name,\n method: method as HttpMethod,\n endpoint: http,\n };\n const implement = <Failure extends Errors[number][\"Type\"], R>(\n handler: (\n input: typeof requestSchema.Type,\n ) => Effect.Effect<O[\"Type\"], Failure, R>,\n ) => {\n const implemented = base(handler);\n return Object.freeze({\n ...implemented,\n method: method as HttpMethod,\n endpoint: http,\n httpHandler: implemented.handler,\n });\n };\n Object.defineProperty(implement, \"name\", {\n value: name,\n writable: true,\n configurable: true,\n });\n return Object.freeze(Object.assign(implement, metadata));\n};\n","import { Schema } from \"effect\";\n\nexport class BadRequest extends Schema.TaggedError<BadRequest>()(\n \"BadRequest\",\n { message: Schema.String },\n { httpApiStatus: 400 },\n) {}\nexport class Unauthorized extends Schema.TaggedError<Unauthorized>()(\n \"Unauthorized\",\n { message: Schema.String },\n { httpApiStatus: 401 },\n) {}\nexport class Forbidden extends Schema.TaggedError<Forbidden>()(\n \"Forbidden\",\n { message: Schema.String },\n { httpApiStatus: 403 },\n) {}\nexport class NotFound extends Schema.TaggedError<NotFound>()(\n \"NotFound\",\n { message: Schema.String },\n { httpApiStatus: 404 },\n) {}\nexport class Conflict extends Schema.TaggedError<Conflict>()(\n \"Conflict\",\n { message: Schema.String },\n { httpApiStatus: 409 },\n) {}\nexport class InternalServerError extends Schema.TaggedError<InternalServerError>()(\n \"InternalServerError\",\n { message: Schema.String },\n { httpApiStatus: 500 },\n) {}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"errors.js","names":[],"sources":["../../src/native/contracts.ts","../../src/native/errors.ts"],"sourcesContent":["import { Effect, Schema, SchemaAST, SchemaGetter } from \"effect\";\nimport { HttpApiEndpoint, HttpApiSchema, OpenApi } from \"effect/http-api\";\nimport { Rpc } from \"effect/rpc\";\nimport { Tool } from \"effect/ai\";\nimport type { HttpMethod } from \"effect/http/HttpMethod\";\n\nconst redactedDefect = Schema.Unknown.pipe(\n Schema.decodeTo(Schema.Unknown, {\n decode: SchemaGetter.transform(() => new Error(\"Internal server error\")),\n encode: SchemaGetter.transform(() => ({\n message: \"Internal server error\",\n })),\n }),\n);\n\nconst errorWrapper = <E extends Schema.Top>(error: E) =>\n Schema.Union([error]).annotate({\n httpApiStatus:\n SchemaAST.resolveAt<number>(\"httpApiStatus\")(error.ast) ?? 500,\n });\n\n/**\n * Codec resolution (e.g. non-string-encodable path params) fails deep inside\n * Effect with no mention of the route. Attribute it before rethrowing.\n */\nconst attributed = <T>(label: string, build: () => T): T => {\n try {\n return build();\n } catch (error) {\n throw new Error(\n `${label}: ${error instanceof Error ? error.message : String(error)}`,\n { cause: error },\n );\n }\n};\n\n/**\n * Probe one string-tree part (params/query/headers) in isolation so a\n * non-encodable schema fails naming the action, route and part. `make()`\n * never validates path/params consistency, so the fixed probe path only\n * exercises codec resolution and cannot false-positive.\n */\nconst checkStringPart = (\n label: string,\n part: \"params\" | \"query\" | \"headers\",\n schema: Schema.Top,\n) => {\n try {\n (HttpApiEndpoint.get as any)(\"__brick_probe__\", \"/__brick_probe__\", {\n [part]: schema,\n });\n } catch (error) {\n throw new Error(\n `${label}: \"${part}\" cannot be encoded into a URL. ` +\n `params, query and headers only support structural schemas ` +\n `(String, Number, Boolean, UUID, Literal, enums, Dates and arrays of those); ` +\n `move rich objects into payload. ` +\n `Cause: ${error instanceof Error ? error.message : String(error)}`,\n { cause: error },\n );\n }\n};\ntype ActionSchemas<\n I extends Schema.Top,\n O extends Schema.Top,\n Errors extends readonly Schema.Top[],\n> = {\n input: I;\n output: O;\n errors: Errors;\n expose?: \"http\" | \"mcp\" | \"both\";\n description?: string;\n title?: string;\n tool?: {\n readonly readOnly?: boolean;\n readonly destructive?: boolean;\n readonly idempotent?: boolean;\n readonly openWorld?: boolean;\n };\n};\n\nconst defineAction = <\n const N extends string,\n I extends Schema.Top,\n O extends Schema.Top,\n const Errors extends readonly Schema.Top[],\n>(\n name: N,\n route: `/${string}`,\n options: ActionSchemas<I, O, Errors>,\n) => {\n const label = `Brick.action(\"${name}\", \"${route}\")`;\n const errors = options.errors.map((error) => errorWrapper(error));\n const typedEndpoint = attributed(label, () =>\n HttpApiEndpoint.post(name, route, {\n payload: options.input,\n success: options.output,\n error: Schema.Union([Schema.Union(options.errors)]),\n }),\n );\n // Native private ErrorNoStream cannot reduce arrays with open schema members.\n // Mapping the identical error schemas preserves all Type/EncodingServices slots.\n let endpoint = attributed(label, () =>\n HttpApiEndpoint.post(name, route, {\n payload: options.input,\n success: options.output,\n error: errors,\n }),\n ) as unknown as typeof typedEndpoint;\n if (options.description)\n endpoint = endpoint.annotate(OpenApi.Description, options.description);\n if (options.title)\n endpoint = endpoint.annotate(OpenApi.Summary, options.title);\n let tool = Tool.make(name, {\n parameters: options.input,\n success: options.output,\n failure: Schema.Union(options.errors),\n description: options.description,\n });\n if (options.title) tool = tool.annotate(Tool.Title, options.title);\n if (options.tool?.readOnly !== undefined)\n tool = tool.annotate(Tool.Readonly, options.tool.readOnly);\n if (options.tool?.destructive !== undefined)\n tool = tool.annotate(Tool.Destructive, options.tool.destructive);\n if (options.tool?.idempotent !== undefined)\n tool = tool.annotate(Tool.Idempotent, options.tool.idempotent);\n if (options.tool?.openWorld !== undefined)\n tool = tool.annotate(Tool.OpenWorld, options.tool.openWorld);\n const contract = Object.freeze({\n name,\n endpoint,\n method: \"POST\" as HttpMethod,\n path: route,\n http: (options.expose ?? \"http\") !== \"mcp\",\n rpc: Rpc.make(name, {\n payload: options.input,\n success: options.output,\n error: Schema.Union(options.errors),\n defect: redactedDefect,\n }),\n tool,\n mcp: (options.expose ?? \"http\") !== \"http\",\n });\n const implement = <Failure extends Errors[number][\"Type\"], R>(\n handler: (input: I[\"Type\"]) => Effect.Effect<O[\"Type\"], Failure, R>,\n ) => {\n const invoke = (input: I[\"Type\"]) =>\n handler(input).pipe(Effect.withSpan(`brick.action.${name}`));\n return Object.freeze({\n ...contract,\n handler: invoke,\n httpHandler: ({ payload }: { payload: I[\"Type\"] }) => invoke(payload),\n });\n };\n Object.defineProperty(implement, \"name\", {\n value: name,\n writable: true,\n configurable: true,\n });\n return Object.freeze(Object.assign(implement, contract));\n};\n\nexport const action = <\n const N extends string,\n I extends Schema.Top,\n O extends Schema.Top,\n const Errors extends readonly Schema.Top[],\n>(\n name: N,\n /**\n * HTTP route, or the schemas when omitted. `path` defaults to `/${name}`;\n * omit it for `expose: \"mcp\"` tool-only actions.\n */\n path: `/${string}` | ActionSchemas<I, O, Errors>,\n schemas?: ActionSchemas<I, O, Errors>,\n) => {\n const options = (typeof path === \"string\" ? schemas : path) as\n | ActionSchemas<I, O, Errors>\n | undefined;\n if (!options)\n throw new Error(\n `Brick.action(\"${name}\") requires input, output and error schemas`,\n );\n const route = (typeof path === \"string\" ? path : `/${name}`) as `/${string}`;\n if (route.includes(\"/:\")) {\n throw new Error(\n `Brick.action(\"${name}\") path \"${route}\" has :param segments, but ` +\n `Brick.action only sends the input as a JSON payload and never fills params. ` +\n `Use Brick.endpoint with a params schema instead.`,\n );\n }\n return defineAction(name, route, options);\n};\n\ntype HttpInputKey = \"params\" | \"query\" | \"payload\" | \"headers\";\ntype Part<I, K extends HttpInputKey> = K extends keyof I ? I[K] : never;\n\ntype ParamCodec<S> = [S] extends [never]\n ? never\n : S extends Schema.Top\n ? Schema.toCodecStringTree<S>\n : never;\n\ntype PayloadCodec<S> = [S] extends [never]\n ? never\n : S extends Schema.Top\n ? Schema.toCodecJson<S>\n : never;\n\ntype SuccessCodec<S> = [S] extends [never]\n ? typeof HttpApiSchema.NoContent\n : S extends Schema.Top\n ? Schema.toCodecJson<S>\n : never;\n\ntype ErrorCodec<E extends readonly Schema.Top[]> = [E] extends [never]\n ? never\n : Schema.toCodecJson<Schema.Union<[Schema.Union<E>]>>;\n\ntype EndpointSchemas<\n M extends HttpMethod,\n I extends Record<string, Schema.Top>,\n O extends Schema.Top,\n Errors extends readonly Schema.Top[],\n> = {\n readonly input: I &\n Record<Exclude<keyof I, HttpInputKey>, never> &\n (M extends HttpMethod.NoBody ? { readonly payload?: never } : unknown);\n readonly output: O;\n readonly errors: Errors;\n readonly expose?: \"http\" | \"mcp\" | \"both\";\n readonly description?: string;\n readonly title?: string;\n};\n\n/** Typed HTTP request parts also form the input contract for local/RPC/tool calls. */\nexport const endpoint = <\n const N extends string,\n const M extends HttpMethod,\n const I extends Record<string, Schema.Top>,\n O extends Schema.Top,\n const Errors extends readonly Schema.Top[],\n>(\n name: N,\n method: M,\n path: `/${string}` | EndpointSchemas<M, I, O, Errors>,\n schemas?: EndpointSchemas<M, I, O, Errors>,\n) => {\n const options = (typeof path === \"string\" ? schemas : path) as\n | EndpointSchemas<M, I, O, Errors>\n | undefined;\n if (!options)\n throw new Error(\n `Brick.endpoint(\"${name}\") requires input, output and error schemas`,\n );\n const route = (typeof path === \"string\" ? path : `/${name}`) as `/${string}`;\n const label = `Brick.endpoint(\"${name}\", \"${method}\", \"${route}\")`;\n const requestSchema = Schema.Struct(options.input);\n const base = defineAction(name, route, { ...options, input: requestSchema });\n const parts = options.input;\n for (const part of [\"params\", \"query\", \"headers\"] as const) {\n const schema = parts[part] as Schema.Top | undefined;\n if (schema !== undefined) checkStringPart(label, part, schema);\n }\n const endpointOptions = {\n ...(parts.params !== undefined\n ? { params: parts.params as Part<I, \"params\"> }\n : {}),\n ...(parts.query !== undefined\n ? { query: parts.query as Part<I, \"query\"> }\n : {}),\n ...(parts.payload !== undefined\n ? {\n payload: parts.payload as Part<I, \"payload\"> &\n HttpApiEndpoint.PayloadConstraintCodecs<M>,\n }\n : {}),\n ...(parts.headers !== undefined\n ? { headers: parts.headers as Part<I, \"headers\"> }\n : {}),\n success: options.output,\n error: Schema.Union([Schema.Union(options.errors)]),\n };\n const typed = attributed(label, () =>\n (HttpApiEndpoint.make(method) as any)(name, route, endpointOptions),\n ) as HttpApiEndpoint.HttpApiEndpoint<\n N,\n M,\n `/${string}`,\n ParamCodec<Part<I, \"params\">>,\n ParamCodec<Part<I, \"query\">>,\n PayloadCodec<Part<I, \"payload\">>,\n ParamCodec<Part<I, \"headers\">>,\n SuccessCodec<O>,\n ErrorCodec<Errors>\n >;\n\n const http = attributed(label, () =>\n (HttpApiEndpoint.make(method) as any)(name, route, {\n ...(parts.params !== undefined ? { params: parts.params } : {}),\n ...(parts.query !== undefined ? { query: parts.query } : {}),\n ...(parts.payload !== undefined ? { payload: parts.payload } : {}),\n ...(parts.headers !== undefined ? { headers: parts.headers } : {}),\n success: options.output,\n error: options.errors.map(errorWrapper),\n }),\n ) as unknown as typeof typed;\n const metadata = {\n ...base,\n name,\n method: method as HttpMethod,\n endpoint: http,\n };\n const implement = <Failure extends Errors[number][\"Type\"], R>(\n handler: (\n input: typeof requestSchema.Type,\n ) => Effect.Effect<O[\"Type\"], Failure, R>,\n ) => {\n const implemented = base(handler);\n return Object.freeze({\n ...implemented,\n method: method as HttpMethod,\n endpoint: http,\n httpHandler: implemented.handler,\n });\n };\n Object.defineProperty(implement, \"name\", {\n value: name,\n writable: true,\n configurable: true,\n });\n return Object.freeze(Object.assign(implement, metadata));\n};\n","import { Schema } from \"effect\";\n\nexport class BadRequest extends Schema.TaggedError<BadRequest>()(\n \"BadRequest\",\n { message: Schema.String },\n { httpApiStatus: 400 },\n) {}\nexport class Unauthorized extends Schema.TaggedError<Unauthorized>()(\n \"Unauthorized\",\n { message: Schema.String },\n { httpApiStatus: 401 },\n) {}\nexport class Forbidden extends Schema.TaggedError<Forbidden>()(\n \"Forbidden\",\n { message: Schema.String },\n { httpApiStatus: 403 },\n) {}\nexport class NotFound extends Schema.TaggedError<NotFound>()(\n \"NotFound\",\n { message: Schema.String },\n { httpApiStatus: 404 },\n) {}\nexport class Conflict extends Schema.TaggedError<Conflict>()(\n \"Conflict\",\n { message: Schema.String },\n { httpApiStatus: 409 },\n) {}\nexport class InternalServerError extends Schema.TaggedError<InternalServerError>()(\n \"InternalServerError\",\n { message: Schema.String },\n { httpApiStatus: 500 },\n) {}\n"],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -19,6 +19,8 @@ interface ActionConstraint {
|
|
|
19
19
|
readonly rpc: Rpc.Any;
|
|
20
20
|
readonly tool: Tool.Any;
|
|
21
21
|
readonly mcp: boolean;
|
|
22
|
+
/** False for tool-only actions: served over MCP/RPC but never mounted on HTTP. */
|
|
23
|
+
readonly http: boolean;
|
|
22
24
|
readonly endpoint: HttpApiEndpoint.Constraint;
|
|
23
25
|
readonly method: string;
|
|
24
26
|
readonly path: `/${string}`;
|
|
@@ -94,11 +96,24 @@ declare function route<E, R>(method: Parameters<typeof HttpRouter.add>[0], path:
|
|
|
94
96
|
//#region src/native/index.d.ts
|
|
95
97
|
/** Effect-native contracts and scoped HTTP applications. */
|
|
96
98
|
export declare const Brick: Readonly<{
|
|
97
|
-
action: <const N extends string, I extends import("effect/Schema").Top, O extends import("effect/Schema").Top, const Errors extends readonly import("effect/Schema").Top[]>(name: N, path: `/${string}
|
|
99
|
+
action: <const N extends string, I extends import("effect/Schema").Top, O extends import("effect/Schema").Top, const Errors extends readonly import("effect/Schema").Top[]>(name: N, path: `/${string}` | {
|
|
98
100
|
input: I;
|
|
99
101
|
output: O;
|
|
100
102
|
errors: Errors;
|
|
101
|
-
|
|
103
|
+
expose?: "http" | "mcp" | "both";
|
|
104
|
+
description?: string;
|
|
105
|
+
title?: string;
|
|
106
|
+
tool?: {
|
|
107
|
+
readonly readOnly?: boolean;
|
|
108
|
+
readonly destructive?: boolean;
|
|
109
|
+
readonly idempotent?: boolean;
|
|
110
|
+
readonly openWorld?: boolean;
|
|
111
|
+
};
|
|
112
|
+
}, schemas?: {
|
|
113
|
+
input: I;
|
|
114
|
+
output: O;
|
|
115
|
+
errors: Errors;
|
|
116
|
+
expose?: "http" | "mcp" | "both";
|
|
102
117
|
description?: string;
|
|
103
118
|
title?: string;
|
|
104
119
|
tool?: {
|
|
@@ -113,9 +128,10 @@ export declare const Brick: Readonly<{
|
|
|
113
128
|
payload: I["Type"];
|
|
114
129
|
}) => import("effect/Effect").Effect<O["Type"], Failure, Exclude<R, import("effect/Tracer").ParentSpan>>;
|
|
115
130
|
name: N;
|
|
116
|
-
endpoint: import("effect/http-api/HttpApiEndpoint").HttpApiEndpoint<N, "POST", `/${string}`, never, never, [I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I extends readonly import("effect/Schema").Constraint[] ? I[number] : I] extends [never] ? never : [I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I extends readonly import("effect/Schema").Constraint[] ? I[number] : I] extends [import("effect/Schema").Constraint] ? import("effect/Schema").toCodecJson<import("effect/Schema").Constraint & (I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I extends readonly import("effect/Schema").Constraint[] ? I[number] : I)> : never, never, [Exclude<Extract<O extends readonly (infer A)[] ? A : O, import("effect/Schema").Top>, import("effect/http-api/HttpApiSchema").
|
|
131
|
+
endpoint: import("effect/http-api/HttpApiEndpoint").HttpApiEndpoint<N, "POST", `/${string}`, never, never, [I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I extends readonly import("effect/Schema").Constraint[] ? I[number] : I] extends [never] ? never : [I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I extends readonly import("effect/Schema").Constraint[] ? I[number] : I] extends [import("effect/Schema").Constraint] ? import("effect/Schema").toCodecJson<import("effect/Schema").Constraint & (I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I extends readonly import("effect/Schema").Constraint[] ? I[number] : I)> : never, never, [Exclude<Extract<O extends readonly (infer A)[] ? A : O, import("effect/Schema").Top>, import("effect/http-api/HttpApiSchema").StreamSchema | import("effect/http-api/HttpApiSchema").WithHeaders<import("effect/Schema").Top, import("effect/Schema").Top>>] extends [never] ? ((O extends readonly (infer A)[] ? A : O) extends (infer Success) ? Success extends import("effect/http-api/HttpApiSchema").StreamSchema ? Success : never : never) | ((O extends readonly (infer A)[] ? A : O) extends (infer Success_1) ? Success_1 extends import("effect/http-api/HttpApiSchema").WithHeaders<infer _Inner extends import("effect/Schema").Top, infer _Headers extends import("effect/Schema").Top> ? import("effect/http-api/HttpApiSchema").WithHeaders<_Inner extends import("effect/http-api/HttpApiSchema").StreamSchema ? _Inner : import("effect/Schema").toCodecJson<_Inner>, import("effect/Schema").toCodecStringTree<_Headers>> : never : never) : ((O extends readonly (infer A)[] ? A : O) extends (infer Success) ? Success extends import("effect/http-api/HttpApiSchema").StreamSchema ? Success : never : never) | ((O extends readonly (infer A)[] ? A : O) extends (infer Success_1) ? Success_1 extends import("effect/http-api/HttpApiSchema").WithHeaders<infer _Inner extends import("effect/Schema").Top, infer _Headers extends import("effect/Schema").Top> ? import("effect/http-api/HttpApiSchema").WithHeaders<_Inner extends import("effect/http-api/HttpApiSchema").StreamSchema ? _Inner : import("effect/Schema").toCodecJson<_Inner>, import("effect/Schema").toCodecStringTree<_Headers>> : never : never) | import("effect/Schema").toCodecJson<Exclude<Extract<O extends readonly (infer A)[] ? A : O, import("effect/Schema").Top>, import("effect/http-api/HttpApiSchema").StreamSchema | import("effect/http-api/HttpApiSchema").WithHeaders<import("effect/Schema").Top, import("effect/Schema").Top>>>, [import("effect/Schema").Union<readonly [import("effect/Schema").Union<Errors>]>] extends [import("effect/Schema").Constraint] ? import("effect/Schema").toCodecJson<import("effect/Schema").Constraint & import("effect/Schema").Union<readonly [import("effect/Schema").Union<Errors>]>> : never, never, never>;
|
|
117
132
|
method: import("effect/http/HttpMethod").HttpMethod;
|
|
118
133
|
path: `/${string}`;
|
|
134
|
+
http: boolean;
|
|
119
135
|
rpc: import("effect/rpc/Rpc").Rpc<N, I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I, O, import("effect/Schema").Union<Errors>, never, never>;
|
|
120
136
|
tool: import("effect/ai/Tool").Tool<N, {
|
|
121
137
|
readonly parameters: I;
|
|
@@ -126,9 +142,10 @@ export declare const Brick: Readonly<{
|
|
|
126
142
|
mcp: boolean;
|
|
127
143
|
}>) & Readonly<{
|
|
128
144
|
name: N;
|
|
129
|
-
endpoint: import("effect/http-api/HttpApiEndpoint").HttpApiEndpoint<N, "POST", `/${string}`, never, never, [I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I extends readonly import("effect/Schema").Constraint[] ? I[number] : I] extends [never] ? never : [I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I extends readonly import("effect/Schema").Constraint[] ? I[number] : I] extends [import("effect/Schema").Constraint] ? import("effect/Schema").toCodecJson<import("effect/Schema").Constraint & (I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I extends readonly import("effect/Schema").Constraint[] ? I[number] : I)> : never, never, [Exclude<Extract<O extends readonly (infer A)[] ? A : O, import("effect/Schema").Top>, import("effect/http-api/HttpApiSchema").
|
|
145
|
+
endpoint: import("effect/http-api/HttpApiEndpoint").HttpApiEndpoint<N, "POST", `/${string}`, never, never, [I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I extends readonly import("effect/Schema").Constraint[] ? I[number] : I] extends [never] ? never : [I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I extends readonly import("effect/Schema").Constraint[] ? I[number] : I] extends [import("effect/Schema").Constraint] ? import("effect/Schema").toCodecJson<import("effect/Schema").Constraint & (I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I extends readonly import("effect/Schema").Constraint[] ? I[number] : I)> : never, never, [Exclude<Extract<O extends readonly (infer A)[] ? A : O, import("effect/Schema").Top>, import("effect/http-api/HttpApiSchema").StreamSchema | import("effect/http-api/HttpApiSchema").WithHeaders<import("effect/Schema").Top, import("effect/Schema").Top>>] extends [never] ? ((O extends readonly (infer A)[] ? A : O) extends (infer Success) ? Success extends import("effect/http-api/HttpApiSchema").StreamSchema ? Success : never : never) | ((O extends readonly (infer A)[] ? A : O) extends (infer Success_1) ? Success_1 extends import("effect/http-api/HttpApiSchema").WithHeaders<infer _Inner extends import("effect/Schema").Top, infer _Headers extends import("effect/Schema").Top> ? import("effect/http-api/HttpApiSchema").WithHeaders<_Inner extends import("effect/http-api/HttpApiSchema").StreamSchema ? _Inner : import("effect/Schema").toCodecJson<_Inner>, import("effect/Schema").toCodecStringTree<_Headers>> : never : never) : ((O extends readonly (infer A)[] ? A : O) extends (infer Success) ? Success extends import("effect/http-api/HttpApiSchema").StreamSchema ? Success : never : never) | ((O extends readonly (infer A)[] ? A : O) extends (infer Success_1) ? Success_1 extends import("effect/http-api/HttpApiSchema").WithHeaders<infer _Inner extends import("effect/Schema").Top, infer _Headers extends import("effect/Schema").Top> ? import("effect/http-api/HttpApiSchema").WithHeaders<_Inner extends import("effect/http-api/HttpApiSchema").StreamSchema ? _Inner : import("effect/Schema").toCodecJson<_Inner>, import("effect/Schema").toCodecStringTree<_Headers>> : never : never) | import("effect/Schema").toCodecJson<Exclude<Extract<O extends readonly (infer A)[] ? A : O, import("effect/Schema").Top>, import("effect/http-api/HttpApiSchema").StreamSchema | import("effect/http-api/HttpApiSchema").WithHeaders<import("effect/Schema").Top, import("effect/Schema").Top>>>, [import("effect/Schema").Union<readonly [import("effect/Schema").Union<Errors>]>] extends [import("effect/Schema").Constraint] ? import("effect/Schema").toCodecJson<import("effect/Schema").Constraint & import("effect/Schema").Union<readonly [import("effect/Schema").Union<Errors>]>> : never, never, never>;
|
|
130
146
|
method: import("effect/http/HttpMethod").HttpMethod;
|
|
131
147
|
path: `/${string}`;
|
|
148
|
+
http: boolean;
|
|
132
149
|
rpc: import("effect/rpc/Rpc").Rpc<N, I extends import("effect/Schema").Struct.Fields ? import("effect/Schema").Struct<I> : I, O, import("effect/Schema").Union<Errors>, never, never>;
|
|
133
150
|
tool: import("effect/ai/Tool").Tool<N, {
|
|
134
151
|
readonly parameters: I;
|
|
@@ -138,13 +155,22 @@ export declare const Brick: Readonly<{
|
|
|
138
155
|
}, never>;
|
|
139
156
|
mcp: boolean;
|
|
140
157
|
}>;
|
|
141
|
-
endpoint: <const N extends string, const M extends import("effect/http/HttpMethod").HttpMethod, const I extends Record<string, import("effect/Schema").Top>, O extends import("effect/Schema").Top, const Errors extends readonly import("effect/Schema").Top[]>(name: N, method: M, path: `/${string}
|
|
158
|
+
endpoint: <const N extends string, const M extends import("effect/http/HttpMethod").HttpMethod, const I extends Record<string, import("effect/Schema").Top>, O extends import("effect/Schema").Top, const Errors extends readonly import("effect/Schema").Top[]>(name: N, method: M, path: `/${string}` | {
|
|
159
|
+
readonly input: I & Record<Exclude<keyof I, "payload" | "params" | "query" | "headers">, never> & (M extends import("effect/http/HttpMethod").HttpMethod.NoBody ? {
|
|
160
|
+
readonly payload?: never;
|
|
161
|
+
} : unknown);
|
|
162
|
+
readonly output: O;
|
|
163
|
+
readonly errors: Errors;
|
|
164
|
+
readonly expose?: "http" | "mcp" | "both";
|
|
165
|
+
readonly description?: string;
|
|
166
|
+
readonly title?: string;
|
|
167
|
+
}, schemas?: {
|
|
142
168
|
readonly input: I & Record<Exclude<keyof I, "payload" | "params" | "query" | "headers">, never> & (M extends import("effect/http/HttpMethod").HttpMethod.NoBody ? {
|
|
143
169
|
readonly payload?: never;
|
|
144
170
|
} : unknown);
|
|
145
171
|
readonly output: O;
|
|
146
172
|
readonly errors: Errors;
|
|
147
|
-
readonly
|
|
173
|
+
readonly expose?: "http" | "mcp" | "both";
|
|
148
174
|
readonly description?: string;
|
|
149
175
|
readonly title?: string;
|
|
150
176
|
}) => (<Failure extends Errors[number]["Type"], R>(handler: (input: import("effect/Schema").Struct.View<I & Record<Exclude<keyof I, "payload" | "params" | "query" | "headers">, never> & (M extends import("effect/http/HttpMethod").HttpMethod.NoBody ? {
|
|
@@ -172,6 +198,7 @@ export declare const Brick: Readonly<{
|
|
|
172
198
|
} : unknown)>>) => import("effect/Effect").Effect<O["Type"], Failure, Exclude<R, import("effect/Tracer").ParentSpan>>;
|
|
173
199
|
name: N;
|
|
174
200
|
path: `/${string}`;
|
|
201
|
+
http: boolean;
|
|
175
202
|
rpc: import("effect/rpc/Rpc").Rpc<N, import("effect/Schema").Struct<I & Record<Exclude<keyof I, "payload" | "params" | "query" | "headers">, never> & (M extends import("effect/http/HttpMethod").HttpMethod.NoBody ? {
|
|
176
203
|
readonly payload?: never;
|
|
177
204
|
} : unknown)>, O, import("effect/Schema").Union<Errors>, never, never>;
|
|
@@ -189,6 +216,7 @@ export declare const Brick: Readonly<{
|
|
|
189
216
|
method: import("effect/http/HttpMethod").HttpMethod;
|
|
190
217
|
endpoint: import("effect/http-api/HttpApiEndpoint").HttpApiEndpoint<N, M, `/${string}`, ["params" extends (infer T) ? T extends "params" ? T extends keyof I ? I[T] : never : never : never] extends [never] ? never : ("params" extends (infer T_1) ? T_1 extends "params" ? T_1 extends keyof I ? I[T_1] : never : never : never) extends (infer T_2) ? T_2 extends ("params" extends (infer T_3) ? T_3 extends "params" ? T_3 extends keyof I ? I[T_3] : never : never : never) ? T_2 extends import("effect/Schema").Top ? import("effect/Schema").toCodecStringTree<T_2> : never : never : never, ["query" extends (infer T_4) ? T_4 extends "query" ? T_4 extends keyof I ? I[T_4] : never : never : never] extends [never] ? never : ("query" extends (infer T_5) ? T_5 extends "query" ? T_5 extends keyof I ? I[T_5] : never : never : never) extends (infer T_6) ? T_6 extends ("query" extends (infer T_7) ? T_7 extends "query" ? T_7 extends keyof I ? I[T_7] : never : never : never) ? T_6 extends import("effect/Schema").Top ? import("effect/Schema").toCodecStringTree<T_6> : never : never : never, ["payload" extends (infer T_8) ? T_8 extends "payload" ? T_8 extends keyof I ? I[T_8] : never : never : never] extends [never] ? never : ("payload" extends (infer T_9) ? T_9 extends "payload" ? T_9 extends keyof I ? I[T_9] : never : never : never) extends (infer T_10) ? T_10 extends ("payload" extends (infer T_11) ? T_11 extends "payload" ? T_11 extends keyof I ? I[T_11] : never : never : never) ? T_10 extends import("effect/Schema").Top ? import("effect/Schema").toCodecJson<T_10> : never : never : never, ["headers" extends (infer T_12) ? T_12 extends "headers" ? T_12 extends keyof I ? I[T_12] : never : never : never] extends [never] ? never : ("headers" extends (infer T_13) ? T_13 extends "headers" ? T_13 extends keyof I ? I[T_13] : never : never : never) extends (infer T_14) ? T_14 extends ("headers" extends (infer T_15) ? T_15 extends "headers" ? T_15 extends keyof I ? I[T_15] : never : never : never) ? T_14 extends import("effect/Schema").Top ? import("effect/Schema").toCodecStringTree<T_14> : never : never : never, [O] extends [never] ? import("effect/http-api/HttpApiSchema").NoContent : O extends import("effect/Schema").Top ? import("effect/Schema").toCodecJson<O> : never, [Errors] extends [never] ? never : import("effect/Schema").toCodecJson<import("effect/Schema").Union<[import("effect/Schema").Union<Errors>]>>, never, never>;
|
|
191
218
|
path: `/${string}`;
|
|
219
|
+
http: boolean;
|
|
192
220
|
rpc: import("effect/rpc/Rpc").Rpc<N, import("effect/Schema").Struct<I & Record<Exclude<keyof I, "payload" | "params" | "query" | "headers">, never> & (M extends import("effect/http/HttpMethod").HttpMethod.NoBody ? {
|
|
193
221
|
readonly payload?: never;
|
|
194
222
|
} : unknown)>, O, import("effect/Schema").Union<Errors>, never, never>;
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":["_$__kernel0.ActionConstraint","errors"],"sources":["../src/native/transports.ts","../src/native/kernel.ts","../src/native/route.ts","../src/native/index.ts","../src/native-app-entry.ts","../src/secrets.ts"],"mappings":";;;;;;;UAMiB,wBAAwB;WAC9B,KAAK,IAAI;WACT,MAAM,KAAK;WACX;;KAEC,gBAAgB,UAAU,eAAe,oBACnD,2BAEI,IAAI,eAAe,QAAQ,aAAa,IAAI,WAAW,QAAQ,sBAIzD,IAAI,eAAe,QAAQ,aAC3B,IAAI,WAAW,QAAQ,YAC/B,MAAM,QAAQ,kBAAkB;KAExB,gBAAgB,UAAU,eAAe,oBACnD,2BACqB,KAAK,gBAAgB,QAAQ,uBAE5C,KAAK,gBAAgB,QAAQ,aACjC,MAAM,QAAQ,kBAAkB;iBAuDpB,gBAAgB,UAAU,eAAe,kBACvD,SAAS,GACT,SAAS,kBAAkB,UAAU,gBACpC,MAAM,aAEP,MAAM,MAAM,kBAAkB,UAAU,aACxC,WAAW,aAAa,aAAa,KAAK,gBAAgB;;;UC5D3C;WACN,KAAK,IAAI;WACT,MAAM,KAAK;WACX;WACA,UAAU,gBAAgB;WAC1B;WACA;WACA,aACJ,kBACA,OAAO;WACH,iBACJ,kBACA,OAAO;;KAET,UAAU,UAAU,eAAe,qBACtC,QAAQ;KACE,aAAa,UAAU,eAAe,qBAAqB,QACrE,OAAO,SAAS,WAAW,QAAQ,iBACnC,kBAAkB,oBAAoB,MAAM;KAElC,iBAAiB,UAAU,eAAe,wBACnD,WAAW,wBAEN,gBAAgB,gBACd,EAAE,gBACA,OAAO,SAAS,WAAW,EAAE,kBAC7B,gBAAgB,eAAe,EAAE,oBAGnC,OAAO,SAAS,WAAW,EAAE,kBAC7B,gBAAgB,gBACd,EAAE,gBACA,OAAO,SAAS,WAAW,EAAE,kBAC7B,gBAAgB,eAAe,EAAE,oBAEzC,gBAAgB,WAAW,EAAE,kBAC7B,gBAAgB,mBAAmB,EAAE,yBACnC;cACK,gBACL,wBACA,UAAU,eAAe,mBAE/B,MAAM,GACN;WAAoB,SAAS;MAAG;;;
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":["_$__kernel0.ActionConstraint","errors"],"sources":["../src/native/transports.ts","../src/native/kernel.ts","../src/native/route.ts","../src/native/index.ts","../src/native-app-entry.ts","../src/secrets.ts"],"mappings":";;;;;;;UAMiB,wBAAwB;WAC9B,KAAK,IAAI;WACT,MAAM,KAAK;WACX;;KAEC,gBAAgB,UAAU,eAAe,oBACnD,2BAEI,IAAI,eAAe,QAAQ,aAAa,IAAI,WAAW,QAAQ,sBAIzD,IAAI,eAAe,QAAQ,aAC3B,IAAI,WAAW,QAAQ,YAC/B,MAAM,QAAQ,kBAAkB;KAExB,gBAAgB,UAAU,eAAe,oBACnD,2BACqB,KAAK,gBAAgB,QAAQ,uBAE5C,KAAK,gBAAgB,QAAQ,aACjC,MAAM,QAAQ,kBAAkB;iBAuDpB,gBAAgB,UAAU,eAAe,kBACvD,SAAS,GACT,SAAS,kBAAkB,UAAU,gBACpC,MAAM,aAEP,MAAM,MAAM,kBAAkB,UAAU,aACxC,WAAW,aAAa,aAAa,KAAK,gBAAgB;;;UC5D3C;WACN,KAAK,IAAI;WACT,MAAM,KAAK;WACX;;WAEA;WACA,UAAU,gBAAgB;WAC1B;WACA;WACA,aACJ,kBACA,OAAO;WACH,iBACJ,kBACA,OAAO;;KAET,UAAU,UAAU,eAAe,qBACtC,QAAQ;KACE,aAAa,UAAU,eAAe,qBAAqB,QACrE,OAAO,SAAS,WAAW,QAAQ,iBACnC,kBAAkB,oBAAoB,MAAM;KAElC,iBAAiB,UAAU,eAAe,wBACnD,WAAW,wBAEN,gBAAgB,gBACd,EAAE,gBACA,OAAO,SAAS,WAAW,EAAE,kBAC7B,gBAAgB,eAAe,EAAE,oBAGnC,OAAO,SAAS,WAAW,EAAE,kBAC7B,gBAAgB,gBACd,EAAE,gBACA,OAAO,SAAS,WAAW,EAAE,kBAC7B,gBAAgB,eAAe,EAAE,oBAEzC,gBAAgB,WAAW,EAAE,kBAC7B,gBAAgB,mBAAmB,EAAE,yBACnC;cACK,gBACL,wBACA,UAAU,eAAe,mBAE/B,MAAM,GACN;WAAoB,SAAS;MAAG;;;EAmBd,OAAA,aAAa,aAAa,GAAG,UAAU;;iBAG3C,qBACR,wBACA,UAAU,eAAe,mBAC/B,GAAG,kBAAkB,QAAQ,GAAG,MAAG;;;;iBA2DrB,YACR,wBACA,UAAU,eAAe,mBAC/B,GAAG,kBAAkB,QAAQ,GAAG,MAAG,MAAA,oBAAA,WAAA,aAAA,QAAA,iBAAA,+BAAA,wCAAA,gDAAA,qCAAA,QAAA,QAAA,QAAA,aAAA,mBAAA,aAAA,aAAA,GAAA,UAAA,aAAA,aAAA,iBAAA,gCAAA,wCAAA,gDAAA,qCAAA;UAiGpB;WACN;WACA,SAAS,eAAe;WACxB,OAAO,aAAa;;KAE1B,UAAU,mBAAmB,uBAAuB;KACpD,gBAAgB,mBAAmB,uBACtC,yBAAwB,KACpB,UAAU,oBACR,iBAAiB;UAIR;WACN;aAAiB;;WACjB,MAAM,kBAAkB,UAAU;;KAExC,sBACH,mBAAmB,qBACnB,KACE,yBAAwB,KACxB,UAAU,qBAEH;WAAqB;IAClB,aAAa,gBAAgB,gBAAgB,0BAEhD;WAAqB;IAClB,aAAa,gBAAgB,gBAAgB;;iBAM3C,UACR,mBAAmB,qBACzB,SACM,UAAU,iBAChB,iBACA,iBACA,iBACA;WACS,UAAU;WACV,OAAO,MAAM,MAClB,gBAAgB,KAChB,sBAAsB,GAAG,KACzB,QAAQ,SAAS,WAAW,aAC9B;WAGO,aAAa;WACb,SAAS,MAAM,MAAM,SAAS,SAAS;WACvC;aAAkB;;WAClB;aAAoB;aAAyB;;IACvD;;;;IADsC;IAA8B;;EA2G9C,OAAA,MAAM,aAEvB,IAAI,UAAU,MAAM,MAAM,kBAAkB,aAC5C,WAAW;;;EAzMe,QAAA,SAAA,YAAU,QAAQ;EAlC9B,aAAA;EA2DE,eAAA;;;;KC5OjB,OAAO,KAAK,QACf,GACA,MAAM,QAAQ,kBAAkB,oBAAoB,WAAW;;iBAIjD,MAAM,GAAG,GACvB,QAAQ,kBAAkB,WAAW,SACrC,oBACA,SAAS,OAAO,OAAO,mBAAmB,oBAAoB,GAAG,KAChE,MAAM,oBAAoB,WAAW,aAAa,OAAO;;;;qBCV/C,OAAK;;;;;;;;;eAkBgtD;eAAoC;eAAmC;eAAkC;;;;;;;;;;eAAzG;eAAoC;eAAmC;eAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAAsoP,gBAAA,wBAAe,GAAA,UAAA,+BAAA,OAAA,KAAA,IAAA,OAAA,cAAA,0DAAA,2CAAA,WAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAnvR,SAAA,oCAAA,SAAA,QAAA;;;;;KCtBjuB,iBAAiB,kBAAkB;wBAE/B,iBAAiB,iBAAiB,SAAS;;;;;;;;;;;;;;;;;;;;;;;UCgB1C;EACf,IAAI;;;qBAIO,WAAW;UAIP;;EAEf;;;KAIU,gBAAgB,MAAM,OAAO;qBAK5B,UAAU;WACZ;WACA,SAAS;UACV;UACA;EAEI,YAAA,cAAc,UAAS;;MAM/B;;EAKJ,QAAQ;;;;;EASR,UAAU,GAAG,KAAK,gBAAgB,IAAI,UAAU;;EAMhD,SAAS,IAAI,gBAAgB;;EAM7B,IAAI,MAAM,oBAAoB;UAWtB;UAQA;;EAmCR,MAAM,SAAQ,eAA2B;;EAOzC,QAAQ,SAAQ,eAA2B;;EAW3C,MAAM,SAAQ;;;;;;wBASA,OACd,cACA,UAAS,gBACR;;;;;wBAYa,eACd;EAAQ,SAAS;IAChB;;wBAkBa,YACd;EAAQ,SAAS;IAChB;EAAQ;EAAc;EAAqB;;;wBAU9B,eAAe,cAAc;;wBAK7B,gBACd,QAAQ;;wBAQM"}
|
package/dist/index.js
CHANGED
|
@@ -44,7 +44,7 @@ const service = (name, options) => {
|
|
|
44
44
|
const { actions } = options;
|
|
45
45
|
for (const [key, value] of Object.entries(actions)) if (key !== value.endpoint.identifier) throw new Error("Action key and identifier differ");
|
|
46
46
|
let group = HttpApiGroup.make(name);
|
|
47
|
-
for (const a of Object.values(actions)) group = group.add(a.endpoint);
|
|
47
|
+
for (const a of Object.values(actions)) if (a.http) group = group.add(a.endpoint);
|
|
48
48
|
return Object.freeze({
|
|
49
49
|
name,
|
|
50
50
|
actions: Object.freeze({ ...actions }),
|
|
@@ -57,7 +57,10 @@ function compileService(s) {
|
|
|
57
57
|
const checkedImplementation = HttpApiBuilder.group(runtimeApi, String(s.name), (h) => Effect.gen(function* () {
|
|
58
58
|
const context = yield* Effect.context();
|
|
59
59
|
const handlers = {};
|
|
60
|
-
for (const a of Object.values(s.actions))
|
|
60
|
+
for (const a of Object.values(s.actions)) {
|
|
61
|
+
if (!a.http) continue;
|
|
62
|
+
handlers[a.endpoint.identifier] = (input) => Effect.flatMap(Effect.context(), (requestContext) => a.httpHandler(input).pipe(Effect.provideContext(Context.merge(context, requestContext))));
|
|
63
|
+
}
|
|
61
64
|
return h.handleAll(handlers);
|
|
62
65
|
}));
|
|
63
66
|
return Object.freeze({
|
|
@@ -154,6 +157,7 @@ function app(options) {
|
|
|
154
157
|
if (names.has(s.name)) throw new Error(`Duplicate service: ${s.name}`);
|
|
155
158
|
names.add(s.name);
|
|
156
159
|
for (const a of Object.values(s.actions)) {
|
|
160
|
+
if (!a.http) continue;
|
|
157
161
|
const route = `${a.method} ${a.path}`;
|
|
158
162
|
if (paths.has(route)) throw new Error(`Duplicate route: ${route}`);
|
|
159
163
|
paths.add(route);
|
|
@@ -180,7 +184,8 @@ function app(options) {
|
|
|
180
184
|
name: a.endpoint.identifier,
|
|
181
185
|
method: a.method,
|
|
182
186
|
path: a.path,
|
|
183
|
-
mcp: a.mcp
|
|
187
|
+
mcp: a.mcp,
|
|
188
|
+
http: a.http
|
|
184
189
|
}))
|
|
185
190
|
}))
|
|
186
191
|
};
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/native/transports.ts","../src/native/route.ts","../src/native/kernel.ts","../src/native/index.ts","../src/native-app-entry.ts","../src/secrets.ts"],"sourcesContent":["import { Context, Effect, Layer, Scope } from \"effect\";\nimport { HttpRouter, HttpServerRequest } from \"effect/http\";\nimport { Rpc, RpcGroup, RpcSerialization, RpcServer } from \"effect/rpc\";\nimport { McpServer, Tool, Toolkit } from \"effect/ai\";\nimport type { ActionConstraint, Requirements } from \"./kernel\";\n\nexport interface TransportAction extends ActionConstraint {\n readonly rpc: Rpc.Any;\n readonly tool: Tool.Any;\n readonly mcp: boolean;\n}\nexport type RpcRequirements<A extends Record<string, TransportAction>> =\n Exclude<\n [unknown] extends [\n Rpc.ServicesServer<A[keyof A][\"rpc\"]> | Rpc.Middleware<A[keyof A][\"rpc\"]>,\n ]\n ? never\n :\n | Rpc.ServicesServer<A[keyof A][\"rpc\"]>\n | Rpc.Middleware<A[keyof A][\"rpc\"]>,\n Scope.Scope | HttpServerRequest.HttpServerRequest\n >;\nexport type McpRequirements<A extends Record<string, TransportAction>> =\n Exclude<\n [unknown] extends [Tool.HandlerServices<A[keyof A][\"tool\"]>]\n ? never\n : Tool.HandlerServices<A[keyof A][\"tool\"]>,\n Scope.Scope | HttpServerRequest.HttpServerRequest\n >;\n\n/** The same schema-only metadata can construct groups on both sides of the wire. */\nexport const rpcGroup = <\n const A extends Record<string, { readonly rpc: Rpc.Any }>,\n>(\n actions: A,\n): RpcGroup.RpcGroup<A[keyof A][\"rpc\"]> =>\n RpcGroup.make(...Object.values(actions).map((action) => action.rpc));\n\nexport function rpcRoutes<const A extends Record<string, TransportAction>>(\n actions: A,\n options: { readonly path: `/${string}` },\n): Layer.Layer<\n never,\n never,\n HttpRouter.HttpRouter | Requirements<A> | RpcRequirements<A>\n> {\n const group = rpcGroup(actions);\n const build = Effect.gen(function* () {\n const context = yield* Effect.context<\n Requirements<A> | RpcRequirements<A>\n >();\n return Object.fromEntries(\n Object.values(actions).map((action) => [\n action.rpc._tag,\n (input: never) =>\n Effect.flatMap(Effect.context<never>(), (current) =>\n action\n .handler(input)\n .pipe(\n Effect.provideContext(\n Context.merge(context, current) as Context.Context<unknown>,\n ),\n ),\n ),\n ]),\n ) as unknown as RpcGroup.HandlersFrom<A[keyof A][\"rpc\"]>;\n });\n return RpcServer.layerHttp({\n group,\n path: options.path,\n protocol: \"http\",\n disableFatalDefects: true,\n }).pipe(\n Layer.provide(group.toLayer(build)),\n Layer.provide(RpcSerialization.layerJson),\n ) as Layer.Layer<\n never,\n never,\n HttpRouter.HttpRouter | Requirements<A> | RpcRequirements<A>\n >;\n}\n\nexport function mcpRoutes<const A extends Record<string, TransportAction>>(\n actions: A,\n options: Parameters<typeof McpServer.layerHttp>[0],\n): Layer.Layer<\n never,\n Layer.Error<ReturnType<typeof McpServer.layerHttp>>,\n HttpRouter.HttpRouter | Requirements<A> | McpRequirements<A>\n> {\n const exposed = Object.values(actions).filter((action) => action.mcp);\n const tools = Toolkit.make(...exposed.map((action) => action.tool));\n const build = Effect.gen(function* () {\n const context = yield* Effect.context<\n Requirements<A> | McpRequirements<A>\n >();\n return Object.fromEntries(\n exposed.map((action) => [\n action.tool.name,\n (input: never) =>\n Effect.flatMap(Effect.context<never>(), (current) =>\n action\n .handler(input)\n .pipe(\n Effect.provideContext(\n Context.merge(context, current) as Context.Context<unknown>,\n ),\n ),\n ),\n ]),\n ) as Toolkit.HandlersFrom<Toolkit.Tools<typeof tools>>;\n });\n return Layer.effectDiscard(McpServer.registerToolkit(tools)).pipe(\n Layer.provide(tools.toLayer(build)),\n Layer.provide(McpServer.layerHttp(options)),\n ) as Layer.Layer<\n never,\n Layer.Error<ReturnType<typeof McpServer.layerHttp>>,\n HttpRouter.HttpRouter | Requirements<A> | McpRequirements<A>\n >;\n}\n","import { Context, Effect, Layer, Scope } from \"effect\";\nimport {\n HttpRouter,\n HttpServerRequest,\n type HttpServerResponse,\n} from \"effect/http\";\n\ntype Static<R> = Exclude<\n R,\n Scope.Scope | HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext\n>;\n\n/** Capture application services once, and use request services at invocation. */\nexport function route<E, R>(\n method: Parameters<typeof HttpRouter.add>[0],\n path: `/${string}`,\n handler: Effect.Effect<HttpServerResponse.HttpServerResponse, E, R>,\n): Layer.Layer<never, never, HttpRouter.HttpRouter | Static<R>> {\n // Native Request markers cannot reduce Exclude<R, R> while R is open.\n // All application services are captured above the request; raw route failures\n // are handled by the native HTTP runtime rather than failing layer startup.\n return Layer.unwrap(\n Effect.gen(function* () {\n const context = yield* Effect.context<Static<R>>();\n return HttpRouter.add(\n method,\n path,\n Effect.flatMap(Effect.context<never>(), (current) =>\n handler.pipe(\n Effect.provideContext(\n Context.merge(context, current) as Context.Context<R>,\n ),\n ),\n ),\n );\n }),\n ) as Layer.Layer<never, never, HttpRouter.HttpRouter | Static<R>>;\n}\n","import { Context, Effect, Exit, Fiber, Layer, Scope } from \"effect\";\nimport {\n HttpApi,\n HttpApiBuilder,\n HttpApiEndpoint,\n HttpApiGroup,\n HttpApiScalar,\n OpenApi,\n} from \"effect/http-api\";\nimport {\n HttpEffect,\n HttpRouter,\n HttpServer,\n HttpServerRequest,\n HttpServerResponse,\n} from \"effect/http\";\nimport type { Rpc } from \"effect/rpc\";\nimport type { Tool, McpServer } from \"effect/ai\";\nimport {\n rpcRoutes,\n mcpRoutes,\n type RpcRequirements,\n type McpRequirements,\n} from \"./transports\";\nimport { route } from \"./route\";\n\nexport { action } from \"./contracts\";\n\nexport interface ActionConstraint {\n readonly rpc: Rpc.Any;\n readonly tool: Tool.Any;\n readonly mcp: boolean;\n readonly endpoint: HttpApiEndpoint.Constraint;\n readonly method: string;\n readonly path: `/${string}`;\n readonly handler: (\n ...args: never[]\n ) => Effect.Effect<unknown, unknown, unknown>;\n readonly httpHandler: (\n ...args: never[]\n ) => Effect.Effect<unknown, unknown, unknown>;\n}\ntype Endpoints<A extends Record<string, ActionConstraint>> =\n A[keyof A][\"endpoint\"];\nexport type Requirements<A extends Record<string, ActionConstraint>> = Exclude<\n Effect.Services<ReturnType<A[keyof A][\"handler\"]>>,\n HttpServerRequest.HttpServerRequest | Scope.Scope\n>;\nexport type HttpRequirements<A extends Record<string, ActionConstraint>> = {\n [K in keyof A]:\n | ([unknown] extends [\n HttpApiEndpoint.ExcludeProvided<\n A[K][\"endpoint\"],\n | Effect.Services<ReturnType<A[K][\"handler\"]>>\n | HttpApiEndpoint.ServerServices<A[K][\"endpoint\"]>\n >,\n ]\n ? Effect.Services<ReturnType<A[K][\"handler\"]>>\n : HttpApiEndpoint.ExcludeProvided<\n A[K][\"endpoint\"],\n | Effect.Services<ReturnType<A[K][\"handler\"]>>\n | HttpApiEndpoint.ServerServices<A[K][\"endpoint\"]>\n >)\n | HttpApiEndpoint.Middleware<A[K][\"endpoint\"]>\n | HttpApiEndpoint.MiddlewareServices<A[K][\"endpoint\"]>;\n}[keyof A];\nexport const service = <\n const N extends string,\n const A extends Record<string, ActionConstraint>,\n>(\n name: N,\n options: { readonly actions: A },\n) => {\n const { actions } = options;\n for (const [key, value] of Object.entries(actions))\n if (key !== value.endpoint.identifier)\n throw new Error(\"Action key and identifier differ\");\n // Enumeration preserves the union of the exact endpoints; Object.values erases it.\n let group: HttpApiGroup.HttpApiGroup<N, HttpApiEndpoint.Constraint> =\n HttpApiGroup.make(name) as unknown as HttpApiGroup.HttpApiGroup<\n N,\n HttpApiEndpoint.Constraint\n >;\n for (const a of Object.values(actions)) group = group.add(a.endpoint);\n return Object.freeze({\n name,\n actions: Object.freeze({ ...actions }),\n group: group as HttpApiGroup.HttpApiGroup<N, Endpoints<A>>,\n });\n};\nexport function compileService<\n const N extends string,\n const A extends Record<string, ActionConstraint>,\n>(s: ReturnType<typeof service<N, A>>) {\n const api = HttpApi.make(\"brick\").add(s.group);\n // Native generics cannot reduce Extract<Group<N>, {identifier: N}> with open N.\n // This internal view erases only the enumerated correlation; public API retains it.\n const runtimeApi = api as unknown as HttpApi.HttpApi<\n \"brick\",\n HttpApiGroup.HttpApiGroup<string, HttpApiEndpoint.Constraint>\n >;\n type RuntimeGroup = HttpApiGroup.HttpApiGroup<\n string,\n HttpApiEndpoint.Constraint\n >;\n type Built = Effect.Effect<\n HttpApiBuilder.Handlers<\n never,\n Record<string, HttpApiEndpoint.Constraint>,\n string\n >,\n never,\n HttpRequirements<A>\n >;\n const implementation = HttpApiBuilder.group<\n \"brick\",\n RuntimeGroup,\n string,\n Built\n >(runtimeApi, String(s.name), (h) =>\n Effect.gen(function* () {\n const context = yield* Effect.context<HttpRequirements<A>>();\n const handlers: Record<\n string,\n HttpApiEndpoint.Handler<HttpApiEndpoint.Constraint, unknown, never>\n > = {};\n for (const a of Object.values(s.actions)) {\n handlers[a.endpoint.identifier] = (input) =>\n Effect.flatMap(Effect.context<never>(), (requestContext) =>\n a\n .httpHandler(input as never)\n .pipe(\n Effect.provideContext(\n Context.merge(\n context,\n requestContext,\n ) as Context.Context<unknown>,\n ),\n ),\n );\n }\n return h.handleAll(handlers);\n }),\n );\n const checkedImplementation = implementation as Layer.Layer<\n HttpApiGroup.Service<\"brick\", N>,\n never,\n HttpRequirements<A>\n >;\n return Object.freeze({ api, implementation: checkedImplementation });\n}\nexport function layer<\n const N extends string,\n const A extends Record<string, ActionConstraint>,\n>(s: ReturnType<typeof service<N, A>>) {\n const compiled = compileService(s);\n return HttpApiBuilder.layer(compiled.api).pipe(\n Layer.provide(compiled.implementation),\n Layer.provide(HttpServer.layerServices),\n );\n}\nexport const mount = <A, E>(\n routes: Layer.Layer<A, E, HttpRouter.HttpRouter>,\n) => {\n let handler: ((request: Request) => Promise<Response>) | undefined;\n let startup: Promise<void> | undefined;\n let startupFiber: Fiber.Fiber<void, E> | undefined;\n let closing: Promise<void> | undefined;\n const scope = Scope.makeUnsafe();\n let disposed = false;\n const active = new Map<\n AbortSignal,\n {\n readonly controller: AbortController;\n readonly done: Promise<void>;\n readonly complete: () => void;\n }\n >();\n const ready = (): Promise<void> => {\n if (disposed)\n return Promise.reject(new Error(\"Brick application is disposed\"));\n if (!startup) {\n // Metadata inspection is side-effect free. The app owns and can interrupt\n // the startup fiber, including an acquisition which has not completed.\n startupFiber = Effect.runFork(\n Effect.gen(function* () {\n const context = yield* Layer.buildWithScope(\n Layer.provideMerge(routes, HttpRouter.layer),\n scope,\n );\n const router = Context.get(context, HttpRouter.HttpRouter);\n const tracked = Effect.gen(function* () {\n const request = yield* HttpServerRequest.HttpServerRequest;\n if (request.source instanceof Request) {\n const entry = active.get(request.source.signal);\n if (entry)\n yield* Effect.addFinalizer(() => Effect.sync(entry.complete));\n }\n return yield* router.asHttpEffect();\n });\n handler = HttpEffect.toWebHandlerWith<\n A | HttpRouter.HttpRouter,\n Scope.Scope | HttpServerRequest.HttpServerRequest,\n never\n >(context)(tracked);\n }),\n );\n startup = Effect.runPromise(Fiber.join(startupFiber));\n startup.catch(() => {});\n }\n return startup;\n };\n const fetch = async (request: Request): Promise<Response> => {\n await ready();\n if (disposed || !handler) throw new Error(\"Brick application is disposed\");\n const controller = new AbortController();\n const abort = () => controller.abort(request.signal.reason);\n request.signal.addEventListener(\"abort\", abort, { once: true });\n if (request.signal.aborted) abort();\n const internal = new Request(request, { signal: controller.signal });\n let resolve!: () => void;\n const done = new Promise<void>((yes) => {\n resolve = yes;\n });\n const complete = () => {\n request.signal.removeEventListener(\"abort\", abort);\n active.delete(internal.signal);\n resolve();\n };\n active.set(internal.signal, { controller, done, complete });\n try {\n return await handler(internal);\n } catch (error) {\n complete();\n throw error;\n }\n };\n const dispose = (): Promise<void> => {\n disposed = true;\n closing ??= (async () => {\n if (startupFiber) await Effect.runPromise(Fiber.interrupt(startupFiber));\n const requests = [...active.values()];\n for (const request of requests) request.controller.abort();\n await Promise.all(requests.map((request) => request.done));\n await Effect.runPromise(Scope.close(scope, Exit.void));\n })();\n return closing;\n };\n return Object.freeze({ fetch, ready, dispose });\n};\n\nexport interface ServiceConstraint {\n readonly name: string;\n readonly actions: Record<string, ActionConstraint>;\n readonly group: HttpApiGroup.Constraint;\n}\ntype AppGroups<S extends readonly ServiceConstraint[]> = S[number][\"group\"];\ntype AppRequirements<S extends readonly ServiceConstraint[]> =\n S[number] extends infer V\n ? V extends ServiceConstraint\n ? HttpRequirements<V[\"actions\"]>\n : never\n : never;\n\nexport interface Transports {\n readonly rpc?: { readonly path: `/${string}` };\n readonly mcp?: Parameters<typeof McpServer.layerHttp>[0];\n}\ntype TransportRequirements<\n S extends readonly ServiceConstraint[],\n T,\n> = S[number] extends infer V\n ? V extends ServiceConstraint\n ?\n | (T extends { readonly rpc: object }\n ? Requirements<V[\"actions\"]> | RpcRequirements<V[\"actions\"]>\n : never)\n | (T extends { readonly mcp: object }\n ? Requirements<V[\"actions\"]> | McpRequirements<V[\"actions\"]>\n : never)\n : never\n : never;\n\n/** Compose closed applications. Handler and schema requirements must be supplied. */\nexport function app<\n const S extends readonly ServiceConstraint[],\n E,\n const T extends Transports = {},\n RoutesA = never,\n RoutesE = never,\n RoutesR = never,\n>(options: {\n readonly services: S;\n readonly layer: Layer.Layer<\n | AppRequirements<S>\n | TransportRequirements<S, T>\n | Exclude<RoutesR, HttpRouter.HttpRouter>,\n E,\n never\n >;\n readonly transports?: T;\n readonly routes?: Layer.Layer<RoutesA, RoutesE, RoutesR>;\n readonly docs?: { readonly path: `/${string}` };\n readonly client?: { readonly module: string; readonly exportName?: string };\n}) {\n let api: HttpApi.HttpApi<\"brick\", HttpApiGroup.Constraint> = HttpApi.make(\n \"brick\",\n ) as unknown as HttpApi.HttpApi<\"brick\", HttpApiGroup.Constraint>;\n let implementation: Layer.Layer<never, never, unknown> = Layer.empty;\n const names = new Set<string>();\n const paths = new Set<string>();\n for (const s of options.services) {\n if (names.has(s.name)) throw new Error(`Duplicate service: ${s.name}`);\n names.add(s.name);\n for (const a of Object.values(s.actions)) {\n const route = `${a.method} ${a.path}`;\n if (paths.has(route)) throw new Error(`Duplicate route: ${route}`);\n paths.add(route);\n }\n // All groups are enumerated once; these casts retain that exact tuple union.\n api = api.add(s.group);\n const compiled = compileService(\n s as ReturnType<typeof service<string, Record<string, ActionConstraint>>>,\n );\n implementation = Layer.merge(implementation, compiled.implementation);\n }\n const typedApi = api as HttpApi.HttpApi<\"brick\", AppGroups<S>>;\n const typedImplementation = implementation as Layer.Layer<\n HttpApiGroup.Service<\"brick\", S[number][\"name\"]>,\n never,\n AppRequirements<S>\n >;\n const http = HttpApiBuilder.layer(typedApi).pipe(\n Layer.provide(typedImplementation),\n );\n const actions: Record<string, ActionConstraint> = {};\n if (options.transports?.rpc || options.transports?.mcp) {\n for (const s of options.services)\n for (const a of Object.values(s.actions)) {\n if (Object.hasOwn(actions, a.rpc._tag))\n throw new Error(`Duplicate transport action: ${a.rpc._tag}`);\n actions[a.rpc._tag] = a;\n }\n }\n const rpc = options.transports?.rpc\n ? rpcRoutes(actions, options.transports.rpc)\n : Layer.empty;\n const mcp = options.transports?.mcp\n ? mcpRoutes(actions, options.transports.mcp)\n : Layer.empty;\n // Built-in diagnostics. Registered before user routes so the framework\n // endpoints win on collision, matching the pre-Effect server behavior.\n const architecture = {\n version: \"1.0.0\",\n services: options.services.map((s) => ({\n name: s.name,\n actions: Object.values(s.actions).map((a) => ({\n name: a.endpoint.identifier,\n method: a.method,\n path: a.path,\n mcp: a.mcp,\n })),\n })),\n };\n const builtin = Layer.mergeAll(\n route(\n \"GET\",\n \"/_health\",\n Effect.succeed(\n HttpServerResponse.jsonUnsafe({\n status: \"ok\",\n uptime: process.uptime(),\n timestamp: Date.now(),\n }),\n ),\n ),\n route(\n \"GET\",\n \"/_brick/services\",\n Effect.succeed(HttpServerResponse.jsonUnsafe(architecture)),\n ),\n );\n // Each protocol uses the same dependency graph and memo map, so a scoped pool\n // is acquired once and released by the application's owner.\n const routes = Layer.mergeAll(\n http,\n rpc,\n mcp,\n builtin,\n options.routes ?? Layer.empty,\n ).pipe(Layer.provide(options.layer), Layer.provide(HttpServer.layerServices));\n const withDocs = options.docs\n ? Layer.merge(routes, HttpApiScalar.layer(typedApi, options.docs))\n : routes;\n // Native group lookup does not reduce open tuple unions. All implementations\n // above match the validated groups and the input layer closes their services.\n const mounted = mount(\n withDocs as Layer.Layer<\n never,\n E | RoutesE | Layer.Error<ReturnType<typeof mcpRoutes>>,\n HttpRouter.HttpRouter\n >,\n );\n return Object.freeze({\n ...mounted,\n kind: \"brick-native-app\" as const,\n services: Object.freeze([...options.services]),\n client: options.client && Object.freeze({ ...options.client }),\n layer: withDocs as Layer.Layer<\n never,\n E | RoutesE | Layer.Error<ReturnType<typeof mcpRoutes>>,\n HttpRouter.HttpRouter\n >,\n api: typedApi,\n openApi: () => OpenApi.fromApi(typedApi),\n });\n}\n","import { action, app, compileService, layer, mount, service } from \"./kernel\";\nimport { endpoint } from \"./contracts\";\nimport { route } from \"./route\";\nimport { rpcGroup } from \"./transports\";\nimport * as errors from \"./errors\";\n\n/** Effect-native contracts and scoped HTTP applications. */\nexport const Brick = Object.freeze({\n action,\n endpoint,\n service,\n app,\n compileService,\n layer,\n mount,\n errors,\n rpcGroup,\n route,\n});\nexport * from \"./errors\";\nexport type {\n ActionConstraint,\n Requirements,\n ServiceConstraint,\n} from \"./kernel\";\n","import { HttpApi } from \"effect/http-api\";\nimport type { app } from \"./native/kernel\";\n\nexport type NativeBrickApp = ReturnType<typeof app>;\n\nexport function isNativeBrickApp(value: unknown): value is NativeBrickApp {\n return (\n typeof value === \"object\" &&\n value !== null &&\n \"kind\" in value &&\n value.kind === \"brick-native-app\" &&\n \"fetch\" in value &&\n typeof value.fetch === \"function\" &&\n \"ready\" in value &&\n typeof value.ready === \"function\" &&\n \"dispose\" in value &&\n typeof value.dispose === \"function\" &&\n \"api\" in value &&\n HttpApi.isHttpApi(value.api) &&\n \"services\" in value &&\n Array.isArray(value.services) &&\n \"openApi\" in value &&\n typeof value.openApi === \"function\"\n );\n}\n","/**\n * Type-safe secrets & environment variables.\n *\n * Declare each secret once at module scope instead of scattering untyped\n * `process.env.FOO` reads:\n *\n * const port = secret(\"PORT\").default(\"3333\").transform(Number).require();\n * const baseUrl = secret(\"BASE_URL\").url().require();\n * const key = secret(\"STRIPE_KEY\").validate((v) =>\n * v.startsWith(\"sk_\") || \"must start with sk_\"\n * ).require();\n *\n * Values resolve from the environment (Bun populates `process.env` from\n * `.env` locally; in prod the same env source applies — a future\n * `SecretSource` such as AWS can slot in without touching call sites).\n *\n * Resolution order per secret: test/session override → source (`process.env`\n * by default) → declared `default`. `resolveSecrets()` validates every\n * registered secret at boot and throws listing all missing required ones.\n */\n\nexport interface SecretSource {\n get(name: string): string | undefined;\n}\n\n/** Default source: `process.env` (Bun loads `.env` into it automatically). */\nexport const envSource: SecretSource = {\n get: (name: string) => process.env[name],\n};\n\nexport interface SecretOptions {\n /** Fallback when the source has no value. Secrets without a default are required. */\n default?: string;\n}\n\n/** A validator: return `true`/`void` when ok, `false`/reason/`throw` when not. */\nexport type SecretValidator<T> = (value: T) => void | boolean | string;\n\nconst registry = new Map<string, SecretRef<any>>();\nconst overrides = new Map<string, string | undefined>();\n\nexport class SecretRef<T = string> {\n readonly name: string;\n readonly options: SecretOptions;\n private transformFn?: (raw: string) => T;\n private validators: SecretValidator<T>[] = [];\n\n constructor(name: string, options: SecretOptions = {}) {\n this.name = name;\n this.options = options;\n }\n\n /** True when a default was declared (i.e. the secret is optional). */\n get hasDefault(): boolean {\n return this.options.default !== undefined;\n }\n\n /** Fallback used when the source has no value. Makes the secret optional. */\n default(value: string): this {\n this.options.default = value;\n return this;\n }\n\n /**\n * Convert the raw string (e.g. `Number`, `JSON.parse`, `v === \"true\"`).\n * Runs before validators; a throwing transform fails resolution.\n */\n transform<U>(fn: (raw: string) => U): SecretRef<U> {\n this.transformFn = fn as unknown as (raw: string) => T;\n return this as unknown as SecretRef<U>;\n }\n\n /** Run a custom check on the (transformed) value at every resolution. */\n validate(fn: SecretValidator<T>): this {\n this.validators.push(fn);\n return this;\n }\n\n /** Shorthand validator: value must parse as a URL. String refs only. */\n url(this: SecretRef<string>): SecretRef<string> {\n this.validators.push((v) => {\n try {\n new URL(v);\n } catch {\n return \"must be a valid URL\";\n }\n });\n return this;\n }\n\n private resolveRaw(source: SecretSource): string | undefined {\n if (overrides.has(this.name)) {\n const v = overrides.get(this.name);\n if (v !== undefined) return v;\n }\n return source.get(this.name) ?? this.options.default;\n }\n\n private coerce(raw: string): T {\n let value: T;\n if (this.transformFn) {\n try {\n value = this.transformFn(raw);\n } catch (err) {\n throw new Error(\n `Invalid value for secret \"${this.name}\": transform failed (${err instanceof Error ? err.message : String(err)})`,\n );\n }\n } else {\n value = raw as unknown as T;\n }\n for (const fn of this.validators) {\n let result: void | boolean | string;\n try {\n result = fn(value);\n } catch (err) {\n throw new Error(\n `Invalid value for secret \"${this.name}\": ${err instanceof Error ? err.message : String(err)}`,\n );\n }\n if (result === false) {\n throw new Error(\n `Invalid value for secret \"${this.name}\": validation failed`,\n );\n }\n if (typeof result === \"string\") {\n throw new Error(`Invalid value for secret \"${this.name}\": ${result}`);\n }\n }\n return value;\n }\n\n /** Resolved (transformed, validated) value or `undefined`. Never throws on missing. */\n value(source: SecretSource = envSource): T | undefined {\n const raw = this.resolveRaw(source);\n if (raw === undefined) return undefined;\n return this.coerce(raw);\n }\n\n /** Resolved value, or throws naming the missing/invalid secret. */\n require(source: SecretSource = envSource): T {\n const raw = this.resolveRaw(source);\n if (raw === undefined) {\n throw new Error(\n `Missing required secret \"${this.name}\": set it in .env (local) or the environment (prod)`,\n );\n }\n return this.coerce(raw);\n }\n\n /** True when a value would resolve (override, source, or default). */\n isSet(source: SecretSource = envSource): boolean {\n return this.resolveRaw(source) !== undefined;\n }\n}\n\n/**\n * Declare a secret. Idempotent: re-declaring the same name returns the\n * original ref (first declaration wins) so module re-evaluation is safe.\n */\nexport function secret(\n name: string,\n options: SecretOptions = {},\n): SecretRef<string> {\n const existing = registry.get(name);\n if (existing) return existing;\n const ref = new SecretRef<string>(name, options);\n registry.set(name, ref);\n return ref;\n}\n\n/**\n * Validate every registered secret at boot. Throws a single error listing\n * all missing required secrets. Returns the resolved values.\n */\nexport function resolveSecrets(\n opts: { source?: SecretSource } = {},\n): Record<string, unknown> {\n const source = opts.source ?? envSource;\n const missing: string[] = [];\n const resolved: Record<string, unknown> = {};\n for (const ref of registry.values()) {\n const v = ref.value(source);\n if (v === undefined) missing.push(ref.name);\n else resolved[ref.name] = v;\n }\n if (missing.length > 0) {\n throw new Error(\n `Missing required secrets: ${missing.join(\", \")}. Set them in .env (local) or the environment (prod)`,\n );\n }\n return resolved;\n}\n\n/** Metadata for introspection (values never exposed — future dashboard use). */\nexport function listSecrets(\n opts: { source?: SecretSource } = {},\n): Array<{ name: string; hasDefault: boolean; isSet: boolean }> {\n const source = opts.source ?? envSource;\n return [...registry.values()].map((ref) => ({\n hasDefault: ref.hasDefault,\n isSet: ref.isSet(source),\n name: ref.name,\n }));\n}\n\n/** Test/session override for one secret (`undefined` clears the override). */\nexport function overrideSecret(name: string, value: string | undefined): void {\n overrides.set(name, value);\n}\n\n/** Bulk overrides (test/session scoped). */\nexport function overrideSecrets(\n values: Record<string, string | undefined>,\n): void {\n for (const [name, value] of Object.entries(values)) {\n overrides.set(name, value);\n }\n}\n\n/** Clear registry and overrides. Test-only. */\nexport function resetSecrets(): void {\n registry.clear();\n overrides.clear();\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/native/transports.ts","../src/native/route.ts","../src/native/kernel.ts","../src/native/index.ts","../src/native-app-entry.ts","../src/secrets.ts"],"sourcesContent":["import { Context, Effect, Layer, Scope } from \"effect\";\nimport { HttpRouter, HttpServerRequest } from \"effect/http\";\nimport { Rpc, RpcGroup, RpcSerialization, RpcServer } from \"effect/rpc\";\nimport { McpServer, Tool, Toolkit } from \"effect/ai\";\nimport type { ActionConstraint, Requirements } from \"./kernel\";\n\nexport interface TransportAction extends ActionConstraint {\n readonly rpc: Rpc.Any;\n readonly tool: Tool.Any;\n readonly mcp: boolean;\n}\nexport type RpcRequirements<A extends Record<string, TransportAction>> =\n Exclude<\n [unknown] extends [\n Rpc.ServicesServer<A[keyof A][\"rpc\"]> | Rpc.Middleware<A[keyof A][\"rpc\"]>,\n ]\n ? never\n :\n | Rpc.ServicesServer<A[keyof A][\"rpc\"]>\n | Rpc.Middleware<A[keyof A][\"rpc\"]>,\n Scope.Scope | HttpServerRequest.HttpServerRequest\n >;\nexport type McpRequirements<A extends Record<string, TransportAction>> =\n Exclude<\n [unknown] extends [Tool.HandlerServices<A[keyof A][\"tool\"]>]\n ? never\n : Tool.HandlerServices<A[keyof A][\"tool\"]>,\n Scope.Scope | HttpServerRequest.HttpServerRequest\n >;\n\n/** The same schema-only metadata can construct groups on both sides of the wire. */\nexport const rpcGroup = <\n const A extends Record<string, { readonly rpc: Rpc.Any }>,\n>(\n actions: A,\n): RpcGroup.RpcGroup<A[keyof A][\"rpc\"]> =>\n RpcGroup.make(...Object.values(actions).map((action) => action.rpc));\n\nexport function rpcRoutes<const A extends Record<string, TransportAction>>(\n actions: A,\n options: { readonly path: `/${string}` },\n): Layer.Layer<\n never,\n never,\n HttpRouter.HttpRouter | Requirements<A> | RpcRequirements<A>\n> {\n const group = rpcGroup(actions);\n const build = Effect.gen(function* () {\n const context = yield* Effect.context<\n Requirements<A> | RpcRequirements<A>\n >();\n return Object.fromEntries(\n Object.values(actions).map((action) => [\n action.rpc._tag,\n (input: never) =>\n Effect.flatMap(Effect.context<never>(), (current) =>\n action\n .handler(input)\n .pipe(\n Effect.provideContext(\n Context.merge(context, current) as Context.Context<unknown>,\n ),\n ),\n ),\n ]),\n ) as unknown as RpcGroup.HandlersFrom<A[keyof A][\"rpc\"]>;\n });\n return RpcServer.layerHttp({\n group,\n path: options.path,\n protocol: \"http\",\n disableFatalDefects: true,\n }).pipe(\n Layer.provide(group.toLayer(build)),\n Layer.provide(RpcSerialization.layerJson),\n ) as Layer.Layer<\n never,\n never,\n HttpRouter.HttpRouter | Requirements<A> | RpcRequirements<A>\n >;\n}\n\nexport function mcpRoutes<const A extends Record<string, TransportAction>>(\n actions: A,\n options: Parameters<typeof McpServer.layerHttp>[0],\n): Layer.Layer<\n never,\n Layer.Error<ReturnType<typeof McpServer.layerHttp>>,\n HttpRouter.HttpRouter | Requirements<A> | McpRequirements<A>\n> {\n const exposed = Object.values(actions).filter((action) => action.mcp);\n const tools = Toolkit.make(...exposed.map((action) => action.tool));\n const build = Effect.gen(function* () {\n const context = yield* Effect.context<\n Requirements<A> | McpRequirements<A>\n >();\n return Object.fromEntries(\n exposed.map((action) => [\n action.tool.name,\n (input: never) =>\n Effect.flatMap(Effect.context<never>(), (current) =>\n action\n .handler(input)\n .pipe(\n Effect.provideContext(\n Context.merge(context, current) as Context.Context<unknown>,\n ),\n ),\n ),\n ]),\n ) as Toolkit.HandlersFrom<Toolkit.Tools<typeof tools>>;\n });\n return Layer.effectDiscard(McpServer.registerToolkit(tools)).pipe(\n Layer.provide(tools.toLayer(build)),\n Layer.provide(McpServer.layerHttp(options)),\n ) as Layer.Layer<\n never,\n Layer.Error<ReturnType<typeof McpServer.layerHttp>>,\n HttpRouter.HttpRouter | Requirements<A> | McpRequirements<A>\n >;\n}\n","import { Context, Effect, Layer, Scope } from \"effect\";\nimport {\n HttpRouter,\n HttpServerRequest,\n type HttpServerResponse,\n} from \"effect/http\";\n\ntype Static<R> = Exclude<\n R,\n Scope.Scope | HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext\n>;\n\n/** Capture application services once, and use request services at invocation. */\nexport function route<E, R>(\n method: Parameters<typeof HttpRouter.add>[0],\n path: `/${string}`,\n handler: Effect.Effect<HttpServerResponse.HttpServerResponse, E, R>,\n): Layer.Layer<never, never, HttpRouter.HttpRouter | Static<R>> {\n // Native Request markers cannot reduce Exclude<R, R> while R is open.\n // All application services are captured above the request; raw route failures\n // are handled by the native HTTP runtime rather than failing layer startup.\n return Layer.unwrap(\n Effect.gen(function* () {\n const context = yield* Effect.context<Static<R>>();\n return HttpRouter.add(\n method,\n path,\n Effect.flatMap(Effect.context<never>(), (current) =>\n handler.pipe(\n Effect.provideContext(\n Context.merge(context, current) as Context.Context<R>,\n ),\n ),\n ),\n );\n }),\n ) as Layer.Layer<never, never, HttpRouter.HttpRouter | Static<R>>;\n}\n","import { Context, Effect, Exit, Fiber, Layer, Scope } from \"effect\";\nimport {\n HttpApi,\n HttpApiBuilder,\n HttpApiEndpoint,\n HttpApiGroup,\n HttpApiScalar,\n OpenApi,\n} from \"effect/http-api\";\nimport {\n HttpEffect,\n HttpRouter,\n HttpServer,\n HttpServerRequest,\n HttpServerResponse,\n} from \"effect/http\";\nimport type { Rpc } from \"effect/rpc\";\nimport type { Tool, McpServer } from \"effect/ai\";\nimport {\n rpcRoutes,\n mcpRoutes,\n type RpcRequirements,\n type McpRequirements,\n} from \"./transports\";\nimport { route } from \"./route\";\n\nexport { action } from \"./contracts\";\n\nexport interface ActionConstraint {\n readonly rpc: Rpc.Any;\n readonly tool: Tool.Any;\n readonly mcp: boolean;\n /** False for tool-only actions: served over MCP/RPC but never mounted on HTTP. */\n readonly http: boolean;\n readonly endpoint: HttpApiEndpoint.Constraint;\n readonly method: string;\n readonly path: `/${string}`;\n readonly handler: (\n ...args: never[]\n ) => Effect.Effect<unknown, unknown, unknown>;\n readonly httpHandler: (\n ...args: never[]\n ) => Effect.Effect<unknown, unknown, unknown>;\n}\ntype Endpoints<A extends Record<string, ActionConstraint>> =\n A[keyof A][\"endpoint\"];\nexport type Requirements<A extends Record<string, ActionConstraint>> = Exclude<\n Effect.Services<ReturnType<A[keyof A][\"handler\"]>>,\n HttpServerRequest.HttpServerRequest | Scope.Scope\n>;\nexport type HttpRequirements<A extends Record<string, ActionConstraint>> = {\n [K in keyof A]:\n | ([unknown] extends [\n HttpApiEndpoint.ExcludeProvided<\n A[K][\"endpoint\"],\n | Effect.Services<ReturnType<A[K][\"handler\"]>>\n | HttpApiEndpoint.ServerServices<A[K][\"endpoint\"]>\n >,\n ]\n ? Effect.Services<ReturnType<A[K][\"handler\"]>>\n : HttpApiEndpoint.ExcludeProvided<\n A[K][\"endpoint\"],\n | Effect.Services<ReturnType<A[K][\"handler\"]>>\n | HttpApiEndpoint.ServerServices<A[K][\"endpoint\"]>\n >)\n | HttpApiEndpoint.Middleware<A[K][\"endpoint\"]>\n | HttpApiEndpoint.MiddlewareServices<A[K][\"endpoint\"]>;\n}[keyof A];\nexport const service = <\n const N extends string,\n const A extends Record<string, ActionConstraint>,\n>(\n name: N,\n options: { readonly actions: A },\n) => {\n const { actions } = options;\n for (const [key, value] of Object.entries(actions))\n if (key !== value.endpoint.identifier)\n throw new Error(\"Action key and identifier differ\");\n // Enumeration preserves the union of the exact endpoints; Object.values erases it.\n let group: HttpApiGroup.HttpApiGroup<N, HttpApiEndpoint.Constraint> =\n HttpApiGroup.make(name) as unknown as HttpApiGroup.HttpApiGroup<\n N,\n HttpApiEndpoint.Constraint\n >;\n // Tool-only actions (expose: \"mcp\") stay in the record for MCP/RPC and\n // in-process calls, but mount no HTTP route.\n for (const a of Object.values(actions))\n if (a.http) group = group.add(a.endpoint);\n return Object.freeze({\n name,\n actions: Object.freeze({ ...actions }),\n group: group as HttpApiGroup.HttpApiGroup<N, Endpoints<A>>,\n });\n};\nexport function compileService<\n const N extends string,\n const A extends Record<string, ActionConstraint>,\n>(s: ReturnType<typeof service<N, A>>) {\n const api = HttpApi.make(\"brick\").add(s.group);\n // Native generics cannot reduce Extract<Group<N>, {identifier: N}> with open N.\n // This internal view erases only the enumerated correlation; public API retains it.\n const runtimeApi = api as unknown as HttpApi.HttpApi<\n \"brick\",\n HttpApiGroup.HttpApiGroup<string, HttpApiEndpoint.Constraint>\n >;\n type RuntimeGroup = HttpApiGroup.HttpApiGroup<\n string,\n HttpApiEndpoint.Constraint\n >;\n type Built = Effect.Effect<\n HttpApiBuilder.Handlers<\n never,\n Record<string, HttpApiEndpoint.Constraint>,\n string\n >,\n never,\n HttpRequirements<A>\n >;\n const implementation = HttpApiBuilder.group<\n \"brick\",\n RuntimeGroup,\n string,\n Built\n >(runtimeApi, String(s.name), (h) =>\n Effect.gen(function* () {\n const context = yield* Effect.context<HttpRequirements<A>>();\n const handlers: Record<\n string,\n HttpApiEndpoint.Handler<HttpApiEndpoint.Constraint, unknown, never>\n > = {};\n for (const a of Object.values(s.actions)) {\n if (!a.http) continue;\n handlers[a.endpoint.identifier] = (input) =>\n Effect.flatMap(Effect.context<never>(), (requestContext) =>\n a\n .httpHandler(input as never)\n .pipe(\n Effect.provideContext(\n Context.merge(\n context,\n requestContext,\n ) as Context.Context<unknown>,\n ),\n ),\n );\n }\n return h.handleAll(handlers);\n }),\n );\n const checkedImplementation = implementation as Layer.Layer<\n HttpApiGroup.Service<\"brick\", N>,\n never,\n HttpRequirements<A>\n >;\n return Object.freeze({ api, implementation: checkedImplementation });\n}\nexport function layer<\n const N extends string,\n const A extends Record<string, ActionConstraint>,\n>(s: ReturnType<typeof service<N, A>>) {\n const compiled = compileService(s);\n return HttpApiBuilder.layer(compiled.api).pipe(\n Layer.provide(compiled.implementation),\n Layer.provide(HttpServer.layerServices),\n );\n}\nexport const mount = <A, E>(\n routes: Layer.Layer<A, E, HttpRouter.HttpRouter>,\n) => {\n let handler: ((request: Request) => Promise<Response>) | undefined;\n let startup: Promise<void> | undefined;\n let startupFiber: Fiber.Fiber<void, E> | undefined;\n let closing: Promise<void> | undefined;\n const scope = Scope.makeUnsafe();\n let disposed = false;\n const active = new Map<\n AbortSignal,\n {\n readonly controller: AbortController;\n readonly done: Promise<void>;\n readonly complete: () => void;\n }\n >();\n const ready = (): Promise<void> => {\n if (disposed)\n return Promise.reject(new Error(\"Brick application is disposed\"));\n if (!startup) {\n // Metadata inspection is side-effect free. The app owns and can interrupt\n // the startup fiber, including an acquisition which has not completed.\n startupFiber = Effect.runFork(\n Effect.gen(function* () {\n const context = yield* Layer.buildWithScope(\n Layer.provideMerge(routes, HttpRouter.layer),\n scope,\n );\n const router = Context.get(context, HttpRouter.HttpRouter);\n const tracked = Effect.gen(function* () {\n const request = yield* HttpServerRequest.HttpServerRequest;\n if (request.source instanceof Request) {\n const entry = active.get(request.source.signal);\n if (entry)\n yield* Effect.addFinalizer(() => Effect.sync(entry.complete));\n }\n return yield* router.asHttpEffect();\n });\n handler = HttpEffect.toWebHandlerWith<\n A | HttpRouter.HttpRouter,\n Scope.Scope | HttpServerRequest.HttpServerRequest,\n never\n >(context)(tracked);\n }),\n );\n startup = Effect.runPromise(Fiber.join(startupFiber));\n startup.catch(() => {});\n }\n return startup;\n };\n const fetch = async (request: Request): Promise<Response> => {\n await ready();\n if (disposed || !handler) throw new Error(\"Brick application is disposed\");\n const controller = new AbortController();\n const abort = () => controller.abort(request.signal.reason);\n request.signal.addEventListener(\"abort\", abort, { once: true });\n if (request.signal.aborted) abort();\n const internal = new Request(request, { signal: controller.signal });\n let resolve!: () => void;\n const done = new Promise<void>((yes) => {\n resolve = yes;\n });\n const complete = () => {\n request.signal.removeEventListener(\"abort\", abort);\n active.delete(internal.signal);\n resolve();\n };\n active.set(internal.signal, { controller, done, complete });\n try {\n return await handler(internal);\n } catch (error) {\n complete();\n throw error;\n }\n };\n const dispose = (): Promise<void> => {\n disposed = true;\n closing ??= (async () => {\n if (startupFiber) await Effect.runPromise(Fiber.interrupt(startupFiber));\n const requests = [...active.values()];\n for (const request of requests) request.controller.abort();\n await Promise.all(requests.map((request) => request.done));\n await Effect.runPromise(Scope.close(scope, Exit.void));\n })();\n return closing;\n };\n return Object.freeze({ fetch, ready, dispose });\n};\n\nexport interface ServiceConstraint {\n readonly name: string;\n readonly actions: Record<string, ActionConstraint>;\n readonly group: HttpApiGroup.Constraint;\n}\ntype AppGroups<S extends readonly ServiceConstraint[]> = S[number][\"group\"];\ntype AppRequirements<S extends readonly ServiceConstraint[]> =\n S[number] extends infer V\n ? V extends ServiceConstraint\n ? HttpRequirements<V[\"actions\"]>\n : never\n : never;\n\nexport interface Transports {\n readonly rpc?: { readonly path: `/${string}` };\n readonly mcp?: Parameters<typeof McpServer.layerHttp>[0];\n}\ntype TransportRequirements<\n S extends readonly ServiceConstraint[],\n T,\n> = S[number] extends infer V\n ? V extends ServiceConstraint\n ?\n | (T extends { readonly rpc: object }\n ? Requirements<V[\"actions\"]> | RpcRequirements<V[\"actions\"]>\n : never)\n | (T extends { readonly mcp: object }\n ? Requirements<V[\"actions\"]> | McpRequirements<V[\"actions\"]>\n : never)\n : never\n : never;\n\n/** Compose closed applications. Handler and schema requirements must be supplied. */\nexport function app<\n const S extends readonly ServiceConstraint[],\n E,\n const T extends Transports = {},\n RoutesA = never,\n RoutesE = never,\n RoutesR = never,\n>(options: {\n readonly services: S;\n readonly layer: Layer.Layer<\n | AppRequirements<S>\n | TransportRequirements<S, T>\n | Exclude<RoutesR, HttpRouter.HttpRouter>,\n E,\n never\n >;\n readonly transports?: T;\n readonly routes?: Layer.Layer<RoutesA, RoutesE, RoutesR>;\n readonly docs?: { readonly path: `/${string}` };\n readonly client?: { readonly module: string; readonly exportName?: string };\n}) {\n let api: HttpApi.HttpApi<\"brick\", HttpApiGroup.Constraint> = HttpApi.make(\n \"brick\",\n ) as unknown as HttpApi.HttpApi<\"brick\", HttpApiGroup.Constraint>;\n let implementation: Layer.Layer<never, never, unknown> = Layer.empty;\n const names = new Set<string>();\n const paths = new Set<string>();\n for (const s of options.services) {\n if (names.has(s.name)) throw new Error(`Duplicate service: ${s.name}`);\n names.add(s.name);\n for (const a of Object.values(s.actions)) {\n if (!a.http) continue;\n const route = `${a.method} ${a.path}`;\n if (paths.has(route)) throw new Error(`Duplicate route: ${route}`);\n paths.add(route);\n }\n // All groups are enumerated once; these casts retain that exact tuple union.\n api = api.add(s.group);\n const compiled = compileService(\n s as ReturnType<typeof service<string, Record<string, ActionConstraint>>>,\n );\n implementation = Layer.merge(implementation, compiled.implementation);\n }\n const typedApi = api as HttpApi.HttpApi<\"brick\", AppGroups<S>>;\n const typedImplementation = implementation as Layer.Layer<\n HttpApiGroup.Service<\"brick\", S[number][\"name\"]>,\n never,\n AppRequirements<S>\n >;\n const http = HttpApiBuilder.layer(typedApi).pipe(\n Layer.provide(typedImplementation),\n );\n const actions: Record<string, ActionConstraint> = {};\n if (options.transports?.rpc || options.transports?.mcp) {\n for (const s of options.services)\n for (const a of Object.values(s.actions)) {\n if (Object.hasOwn(actions, a.rpc._tag))\n throw new Error(`Duplicate transport action: ${a.rpc._tag}`);\n actions[a.rpc._tag] = a;\n }\n }\n const rpc = options.transports?.rpc\n ? rpcRoutes(actions, options.transports.rpc)\n : Layer.empty;\n const mcp = options.transports?.mcp\n ? mcpRoutes(actions, options.transports.mcp)\n : Layer.empty;\n // Built-in diagnostics. Registered before user routes so the framework\n // endpoints win on collision, matching the pre-Effect server behavior.\n const architecture = {\n version: \"1.0.0\",\n services: options.services.map((s) => ({\n name: s.name,\n actions: Object.values(s.actions).map((a) => ({\n name: a.endpoint.identifier,\n method: a.method,\n path: a.path,\n mcp: a.mcp,\n http: a.http,\n })),\n })),\n };\n const builtin = Layer.mergeAll(\n route(\n \"GET\",\n \"/_health\",\n Effect.succeed(\n HttpServerResponse.jsonUnsafe({\n status: \"ok\",\n uptime: process.uptime(),\n timestamp: Date.now(),\n }),\n ),\n ),\n route(\n \"GET\",\n \"/_brick/services\",\n Effect.succeed(HttpServerResponse.jsonUnsafe(architecture)),\n ),\n );\n // Each protocol uses the same dependency graph and memo map, so a scoped pool\n // is acquired once and released by the application's owner.\n const routes = Layer.mergeAll(\n http,\n rpc,\n mcp,\n builtin,\n options.routes ?? Layer.empty,\n ).pipe(Layer.provide(options.layer), Layer.provide(HttpServer.layerServices));\n const withDocs = options.docs\n ? Layer.merge(routes, HttpApiScalar.layer(typedApi, options.docs))\n : routes;\n // Native group lookup does not reduce open tuple unions. All implementations\n // above match the validated groups and the input layer closes their services.\n const mounted = mount(\n withDocs as Layer.Layer<\n never,\n E | RoutesE | Layer.Error<ReturnType<typeof mcpRoutes>>,\n HttpRouter.HttpRouter\n >,\n );\n return Object.freeze({\n ...mounted,\n kind: \"brick-native-app\" as const,\n services: Object.freeze([...options.services]),\n client: options.client && Object.freeze({ ...options.client }),\n layer: withDocs as Layer.Layer<\n never,\n E | RoutesE | Layer.Error<ReturnType<typeof mcpRoutes>>,\n HttpRouter.HttpRouter\n >,\n api: typedApi,\n openApi: () => OpenApi.fromApi(typedApi),\n });\n}\n","import { action, app, compileService, layer, mount, service } from \"./kernel\";\nimport { endpoint } from \"./contracts\";\nimport { route } from \"./route\";\nimport { rpcGroup } from \"./transports\";\nimport * as errors from \"./errors\";\n\n/** Effect-native contracts and scoped HTTP applications. */\nexport const Brick = Object.freeze({\n action,\n endpoint,\n service,\n app,\n compileService,\n layer,\n mount,\n errors,\n rpcGroup,\n route,\n});\nexport * from \"./errors\";\nexport type {\n ActionConstraint,\n Requirements,\n ServiceConstraint,\n} from \"./kernel\";\n","import { HttpApi } from \"effect/http-api\";\nimport type { app } from \"./native/kernel\";\n\nexport type NativeBrickApp = ReturnType<typeof app>;\n\nexport function isNativeBrickApp(value: unknown): value is NativeBrickApp {\n return (\n typeof value === \"object\" &&\n value !== null &&\n \"kind\" in value &&\n value.kind === \"brick-native-app\" &&\n \"fetch\" in value &&\n typeof value.fetch === \"function\" &&\n \"ready\" in value &&\n typeof value.ready === \"function\" &&\n \"dispose\" in value &&\n typeof value.dispose === \"function\" &&\n \"api\" in value &&\n HttpApi.isHttpApi(value.api) &&\n \"services\" in value &&\n Array.isArray(value.services) &&\n \"openApi\" in value &&\n typeof value.openApi === \"function\"\n );\n}\n","/**\n * Type-safe secrets & environment variables.\n *\n * Declare each secret once at module scope instead of scattering untyped\n * `process.env.FOO` reads:\n *\n * const port = secret(\"PORT\").default(\"3333\").transform(Number).require();\n * const baseUrl = secret(\"BASE_URL\").url().require();\n * const key = secret(\"STRIPE_KEY\").validate((v) =>\n * v.startsWith(\"sk_\") || \"must start with sk_\"\n * ).require();\n *\n * Values resolve from the environment (Bun populates `process.env` from\n * `.env` locally; in prod the same env source applies — a future\n * `SecretSource` such as AWS can slot in without touching call sites).\n *\n * Resolution order per secret: test/session override → source (`process.env`\n * by default) → declared `default`. `resolveSecrets()` validates every\n * registered secret at boot and throws listing all missing required ones.\n */\n\nexport interface SecretSource {\n get(name: string): string | undefined;\n}\n\n/** Default source: `process.env` (Bun loads `.env` into it automatically). */\nexport const envSource: SecretSource = {\n get: (name: string) => process.env[name],\n};\n\nexport interface SecretOptions {\n /** Fallback when the source has no value. Secrets without a default are required. */\n default?: string;\n}\n\n/** A validator: return `true`/`void` when ok, `false`/reason/`throw` when not. */\nexport type SecretValidator<T> = (value: T) => void | boolean | string;\n\nconst registry = new Map<string, SecretRef<any>>();\nconst overrides = new Map<string, string | undefined>();\n\nexport class SecretRef<T = string> {\n readonly name: string;\n readonly options: SecretOptions;\n private transformFn?: (raw: string) => T;\n private validators: SecretValidator<T>[] = [];\n\n constructor(name: string, options: SecretOptions = {}) {\n this.name = name;\n this.options = options;\n }\n\n /** True when a default was declared (i.e. the secret is optional). */\n get hasDefault(): boolean {\n return this.options.default !== undefined;\n }\n\n /** Fallback used when the source has no value. Makes the secret optional. */\n default(value: string): this {\n this.options.default = value;\n return this;\n }\n\n /**\n * Convert the raw string (e.g. `Number`, `JSON.parse`, `v === \"true\"`).\n * Runs before validators; a throwing transform fails resolution.\n */\n transform<U>(fn: (raw: string) => U): SecretRef<U> {\n this.transformFn = fn as unknown as (raw: string) => T;\n return this as unknown as SecretRef<U>;\n }\n\n /** Run a custom check on the (transformed) value at every resolution. */\n validate(fn: SecretValidator<T>): this {\n this.validators.push(fn);\n return this;\n }\n\n /** Shorthand validator: value must parse as a URL. String refs only. */\n url(this: SecretRef<string>): SecretRef<string> {\n this.validators.push((v) => {\n try {\n new URL(v);\n } catch {\n return \"must be a valid URL\";\n }\n });\n return this;\n }\n\n private resolveRaw(source: SecretSource): string | undefined {\n if (overrides.has(this.name)) {\n const v = overrides.get(this.name);\n if (v !== undefined) return v;\n }\n return source.get(this.name) ?? this.options.default;\n }\n\n private coerce(raw: string): T {\n let value: T;\n if (this.transformFn) {\n try {\n value = this.transformFn(raw);\n } catch (err) {\n throw new Error(\n `Invalid value for secret \"${this.name}\": transform failed (${err instanceof Error ? err.message : String(err)})`,\n );\n }\n } else {\n value = raw as unknown as T;\n }\n for (const fn of this.validators) {\n let result: void | boolean | string;\n try {\n result = fn(value);\n } catch (err) {\n throw new Error(\n `Invalid value for secret \"${this.name}\": ${err instanceof Error ? err.message : String(err)}`,\n );\n }\n if (result === false) {\n throw new Error(\n `Invalid value for secret \"${this.name}\": validation failed`,\n );\n }\n if (typeof result === \"string\") {\n throw new Error(`Invalid value for secret \"${this.name}\": ${result}`);\n }\n }\n return value;\n }\n\n /** Resolved (transformed, validated) value or `undefined`. Never throws on missing. */\n value(source: SecretSource = envSource): T | undefined {\n const raw = this.resolveRaw(source);\n if (raw === undefined) return undefined;\n return this.coerce(raw);\n }\n\n /** Resolved value, or throws naming the missing/invalid secret. */\n require(source: SecretSource = envSource): T {\n const raw = this.resolveRaw(source);\n if (raw === undefined) {\n throw new Error(\n `Missing required secret \"${this.name}\": set it in .env (local) or the environment (prod)`,\n );\n }\n return this.coerce(raw);\n }\n\n /** True when a value would resolve (override, source, or default). */\n isSet(source: SecretSource = envSource): boolean {\n return this.resolveRaw(source) !== undefined;\n }\n}\n\n/**\n * Declare a secret. Idempotent: re-declaring the same name returns the\n * original ref (first declaration wins) so module re-evaluation is safe.\n */\nexport function secret(\n name: string,\n options: SecretOptions = {},\n): SecretRef<string> {\n const existing = registry.get(name);\n if (existing) return existing;\n const ref = new SecretRef<string>(name, options);\n registry.set(name, ref);\n return ref;\n}\n\n/**\n * Validate every registered secret at boot. Throws a single error listing\n * all missing required secrets. Returns the resolved values.\n */\nexport function resolveSecrets(\n opts: { source?: SecretSource } = {},\n): Record<string, unknown> {\n const source = opts.source ?? envSource;\n const missing: string[] = [];\n const resolved: Record<string, unknown> = {};\n for (const ref of registry.values()) {\n const v = ref.value(source);\n if (v === undefined) missing.push(ref.name);\n else resolved[ref.name] = v;\n }\n if (missing.length > 0) {\n throw new Error(\n `Missing required secrets: ${missing.join(\", \")}. Set them in .env (local) or the environment (prod)`,\n );\n }\n return resolved;\n}\n\n/** Metadata for introspection (values never exposed — future dashboard use). */\nexport function listSecrets(\n opts: { source?: SecretSource } = {},\n): Array<{ name: string; hasDefault: boolean; isSet: boolean }> {\n const source = opts.source ?? envSource;\n return [...registry.values()].map((ref) => ({\n hasDefault: ref.hasDefault,\n isSet: ref.isSet(source),\n name: ref.name,\n }));\n}\n\n/** Test/session override for one secret (`undefined` clears the override). */\nexport function overrideSecret(name: string, value: string | undefined): void {\n overrides.set(name, value);\n}\n\n/** Bulk overrides (test/session scoped). */\nexport function overrideSecrets(\n values: Record<string, string | undefined>,\n): void {\n for (const [name, value] of Object.entries(values)) {\n overrides.set(name, value);\n }\n}\n\n/** Clear registry and overrides. Test-only. */\nexport function resetSecrets(): void {\n registry.clear();\n overrides.clear();\n}\n"],"mappings":"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"}
|