@brickkit/core 0.6.1 → 0.7.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/dist/index.js CHANGED
@@ -1,374 +1,60 @@
1
- import { c as action, l as endpoint, s as errors_exports } from "./chunks/errors.js";
2
- import { Context, Effect, Exit, Fiber, Layer, Scope } from "effect";
3
- import { HttpApi, HttpApiBuilder, HttpApiGroup, HttpApiScalar, OpenApi } from "effect/http-api";
4
- import { HttpEffect, HttpRouter, HttpServer, HttpServerRequest, HttpServerResponse } from "effect/http";
5
- import { RpcGroup, RpcSerialization, RpcServer } from "effect/rpc";
6
- import { McpServer, Toolkit } from "effect/ai";
7
- //#region src/native/transports.ts
8
- /** The same schema-only metadata can construct groups on both sides of the wire. */
9
- const rpcGroup = (actions) => RpcGroup.make(...Object.values(actions).map((action) => action.rpc));
10
- function rpcRoutes(actions, options) {
11
- const group = rpcGroup(actions);
12
- const build = Effect.gen(function* () {
13
- const context = yield* Effect.context();
14
- return Object.fromEntries(Object.values(actions).map((action) => [action.rpc._tag, (input) => Effect.flatMap(Effect.context(), (current) => action.handler(input).pipe(Effect.provideContext(Context.merge(context, current))))]));
15
- });
16
- return RpcServer.layerHttp({
17
- group,
18
- path: options.path,
19
- protocol: "http",
20
- disableFatalDefects: true
21
- }).pipe(Layer.provide(group.toLayer(build)), Layer.provide(RpcSerialization.layerJson));
22
- }
23
- function mcpRoutes(actions, options) {
24
- const exposed = Object.values(actions).filter((action) => action.mcp);
25
- const tools = Toolkit.make(...exposed.map((action) => action.tool));
26
- const build = Effect.gen(function* () {
27
- const context = yield* Effect.context();
28
- return Object.fromEntries(exposed.map((action) => [action.tool.name, (input) => Effect.flatMap(Effect.context(), (current) => action.handler(input).pipe(Effect.provideContext(Context.merge(context, current))))]));
29
- });
30
- return Layer.effectDiscard(McpServer.registerToolkit(tools)).pipe(Layer.provide(tools.toLayer(build)), Layer.provide(McpServer.layerHttp(options)));
31
- }
32
- //#endregion
33
- //#region src/native/route.ts
34
- /** Capture application services once, and use request services at invocation. */
35
- function route(method, path, handler) {
36
- return Layer.unwrap(Effect.gen(function* () {
37
- const context = yield* Effect.context();
38
- return HttpRouter.add(method, path, Effect.flatMap(Effect.context(), (current) => handler.pipe(Effect.provideContext(Context.merge(context, current)))));
39
- }));
40
- }
41
- //#endregion
42
- //#region src/native/kernel.ts
43
- const service = (name, options) => {
44
- const { actions } = options;
45
- for (const [key, value] of Object.entries(actions)) if (key !== value.endpoint.identifier) throw new Error("Action key and identifier differ");
46
- let group = HttpApiGroup.make(name);
47
- for (const a of Object.values(actions)) if (a.http) group = group.add(a.endpoint);
48
- return Object.freeze({
49
- name,
50
- actions: Object.freeze({ ...actions }),
51
- group
52
- });
53
- };
54
- function compileService(s) {
55
- const api = HttpApi.make("brick").add(s.group);
56
- const runtimeApi = api;
57
- const checkedImplementation = HttpApiBuilder.group(runtimeApi, String(s.name), (h) => Effect.gen(function* () {
58
- const context = yield* Effect.context();
59
- const handlers = {};
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
- }
64
- return h.handleAll(handlers);
65
- }));
66
- return Object.freeze({
67
- api,
68
- implementation: checkedImplementation
69
- });
70
- }
71
- function layer(s) {
72
- const compiled = compileService(s);
73
- return HttpApiBuilder.layer(compiled.api).pipe(Layer.provide(compiled.implementation), Layer.provide(HttpServer.layerServices));
74
- }
75
- const mount = (routes) => {
76
- let handler;
77
- let startup;
78
- let startupFiber;
79
- let closing;
80
- const scope = Scope.makeUnsafe();
81
- let disposed = false;
82
- const active = /* @__PURE__ */ new Map();
83
- const ready = () => {
84
- if (disposed) return Promise.reject(/* @__PURE__ */ new Error("Brick application is disposed"));
85
- if (!startup) {
86
- startupFiber = Effect.runFork(Effect.gen(function* () {
87
- const context = yield* Layer.buildWithScope(Layer.provideMerge(routes, HttpRouter.layer), scope);
88
- const router = Context.get(context, HttpRouter.HttpRouter);
89
- const tracked = Effect.gen(function* () {
90
- const request = yield* HttpServerRequest.HttpServerRequest;
91
- if (request.source instanceof Request) {
92
- const entry = active.get(request.source.signal);
93
- if (entry) yield* Effect.addFinalizer(() => Effect.sync(entry.complete));
94
- }
95
- return yield* router.asHttpEffect();
96
- });
97
- handler = HttpEffect.toWebHandlerWith(context)(tracked);
98
- }));
99
- startup = Effect.runPromise(Fiber.join(startupFiber));
100
- startup.catch(() => {});
101
- }
102
- return startup;
103
- };
104
- const fetch = async (request) => {
105
- await ready();
106
- if (disposed || !handler) throw new Error("Brick application is disposed");
107
- const controller = new AbortController();
108
- const abort = () => controller.abort(request.signal.reason);
109
- request.signal.addEventListener("abort", abort, { once: true });
110
- if (request.signal.aborted) abort();
111
- const internal = new Request(request, { signal: controller.signal });
112
- let resolve;
113
- const done = new Promise((yes) => {
114
- resolve = yes;
115
- });
116
- const complete = () => {
117
- request.signal.removeEventListener("abort", abort);
118
- active.delete(internal.signal);
119
- resolve();
120
- };
121
- active.set(internal.signal, {
122
- controller,
123
- done,
124
- complete
125
- });
126
- try {
127
- return await handler(internal);
128
- } catch (error) {
129
- complete();
130
- throw error;
131
- }
132
- };
133
- const dispose = () => {
134
- disposed = true;
135
- closing ??= (async () => {
136
- if (startupFiber) await Effect.runPromise(Fiber.interrupt(startupFiber));
137
- const requests = [...active.values()];
138
- for (const request of requests) request.controller.abort();
139
- await Promise.all(requests.map((request) => request.done));
140
- await Effect.runPromise(Scope.close(scope, Exit.void));
141
- })();
142
- return closing;
143
- };
144
- return Object.freeze({
145
- fetch,
146
- ready,
147
- dispose
148
- });
149
- };
150
- /** Compose closed applications. Handler and schema requirements must be supplied. */
151
- function app(options) {
152
- let api = HttpApi.make("brick");
153
- let implementation = Layer.empty;
154
- const names = /* @__PURE__ */ new Set();
155
- const paths = /* @__PURE__ */ new Set();
156
- for (const s of options.services) {
157
- if (names.has(s.name)) throw new Error(`Duplicate service: ${s.name}`);
158
- names.add(s.name);
159
- for (const a of Object.values(s.actions)) {
160
- if (!a.http) continue;
161
- const route = `${a.method} ${a.path}`;
162
- if (paths.has(route)) throw new Error(`Duplicate route: ${route}`);
163
- paths.add(route);
164
- }
165
- api = api.add(s.group);
166
- const compiled = compileService(s);
167
- implementation = Layer.merge(implementation, compiled.implementation);
168
- }
169
- const typedApi = api;
170
- const typedImplementation = implementation;
171
- const http = HttpApiBuilder.layer(typedApi).pipe(Layer.provide(typedImplementation));
172
- const actions = {};
173
- if (options.transports?.rpc || options.transports?.mcp) for (const s of options.services) for (const a of Object.values(s.actions)) {
174
- if (Object.hasOwn(actions, a.rpc._tag)) throw new Error(`Duplicate transport action: ${a.rpc._tag}`);
175
- actions[a.rpc._tag] = a;
176
- }
177
- const rpc = options.transports?.rpc ? rpcRoutes(actions, options.transports.rpc) : Layer.empty;
178
- const mcp = options.transports?.mcp ? mcpRoutes(actions, options.transports.mcp) : Layer.empty;
179
- const architecture = {
180
- version: "1.0.0",
181
- services: options.services.map((s) => ({
182
- name: s.name,
183
- actions: Object.values(s.actions).map((a) => ({
184
- name: a.endpoint.identifier,
185
- method: a.method,
186
- path: a.path,
187
- mcp: a.mcp,
188
- http: a.http
189
- }))
190
- }))
191
- };
192
- const builtin = Layer.mergeAll(route("GET", "/_health", Effect.succeed(HttpServerResponse.jsonUnsafe({
193
- status: "ok",
194
- uptime: process.uptime(),
195
- timestamp: Date.now()
196
- }))), route("GET", "/_brick/services", Effect.succeed(HttpServerResponse.jsonUnsafe(architecture))));
197
- const routes = Layer.mergeAll(http, rpc, mcp, builtin, options.routes ?? Layer.empty).pipe(Layer.provide(options.layer), Layer.provide(HttpServer.layerServices));
198
- const withDocs = options.docs ? Layer.merge(routes, HttpApiScalar.layer(typedApi, options.docs)) : routes;
199
- const mounted = mount(withDocs);
200
- return Object.freeze({
201
- ...mounted,
202
- kind: "brick-native-app",
203
- services: Object.freeze([...options.services]),
204
- client: options.client && Object.freeze({ ...options.client }),
205
- layer: withDocs,
206
- api: typedApi,
207
- openApi: () => OpenApi.fromApi(typedApi)
208
- });
209
- }
210
- //#endregion
211
- //#region src/native/index.ts
212
- /** Effect-native contracts and scoped HTTP applications. */
213
- const Brick = Object.freeze({
214
- action,
215
- endpoint,
216
- service,
217
- app,
218
- compileService,
219
- layer,
220
- mount,
221
- errors: errors_exports,
222
- rpcGroup,
223
- route
224
- });
225
- //#endregion
226
- //#region src/native-app-entry.ts
227
- function isNativeBrickApp(value) {
228
- return typeof value === "object" && value !== null && "kind" in value && value.kind === "brick-native-app" && "fetch" in value && typeof value.fetch === "function" && "ready" in value && typeof value.ready === "function" && "dispose" in value && typeof value.dispose === "function" && "api" in value && HttpApi.isHttpApi(value.api) && "services" in value && Array.isArray(value.services) && "openApi" in value && typeof value.openApi === "function";
229
- }
230
- //#endregion
231
- //#region src/secrets.ts
232
- /** Default source: `process.env` (Bun loads `.env` into it automatically). */
233
- const envSource = { get: (name) => process.env[name] };
234
- const registry = /* @__PURE__ */ new Map();
235
- const overrides = /* @__PURE__ */ new Map();
236
- var SecretRef = class {
237
- name;
238
- options;
239
- transformFn;
240
- validators = [];
241
- constructor(name, options = {}) {
242
- this.name = name;
243
- this.options = options;
244
- }
245
- /** True when a default was declared (i.e. the secret is optional). */
246
- get hasDefault() {
247
- return this.options.default !== void 0;
248
- }
249
- /** Fallback used when the source has no value. Makes the secret optional. */
250
- default(value) {
251
- this.options.default = value;
252
- return this;
253
- }
254
- /**
255
- * Convert the raw string (e.g. `Number`, `JSON.parse`, `v === "true"`).
256
- * Runs before validators; a throwing transform fails resolution.
257
- */
258
- transform(fn) {
259
- this.transformFn = fn;
260
- return this;
261
- }
262
- /** Run a custom check on the (transformed) value at every resolution. */
263
- validate(fn) {
264
- this.validators.push(fn);
265
- return this;
266
- }
267
- /** Shorthand validator: value must parse as a URL. String refs only. */
268
- url() {
269
- this.validators.push((v) => {
270
- try {
271
- new URL(v);
272
- } catch {
273
- return "must be a valid URL";
274
- }
275
- });
276
- return this;
277
- }
278
- resolveRaw(source) {
279
- if (overrides.has(this.name)) {
280
- const v = overrides.get(this.name);
281
- if (v !== void 0) return v;
282
- }
283
- return source.get(this.name) ?? this.options.default;
284
- }
285
- coerce(raw) {
286
- let value;
287
- if (this.transformFn) try {
288
- value = this.transformFn(raw);
289
- } catch (err) {
290
- throw new Error(`Invalid value for secret "${this.name}": transform failed (${err instanceof Error ? err.message : String(err)})`);
291
- }
292
- else value = raw;
293
- for (const fn of this.validators) {
294
- let result;
295
- try {
296
- result = fn(value);
297
- } catch (err) {
298
- throw new Error(`Invalid value for secret "${this.name}": ${err instanceof Error ? err.message : String(err)}`);
1
+ import { $ as foreignKey, $t as getGlobalRegistry, A as getTableName, At as setActionAccess, B as lte, Bt as defineResourcePlugin, C as desc, Ct as overrideSecrets, D as generateSQLiteIndexDdl, Dt as generateOpenApiSpec, E as eq, Et as secret, F as is, Ft as requireBrickApp, G as relations, Gt as defineAction, H as not, Ht as getPluginActionRoute, I as isNotNull, It as compileRoutePlan, J as defineDatabase, Jt as t, K as sql, Kt as Type, L as isNull, Lt as createActionHandler, M as gte, Mt as compileBrickApplication, N as ilike, Nt as loadCompiledBrickApp, O as generateSQLiteTableDdl, Ot as ACTION_ACCESS_KEY, P as inArray, Pt as isBrickApp, Q as createSQLiteDatabase, Qt as ServiceRegistry, R as like, Rt as executeCompiledRoute, S as createDatabase, St as overrideSecret, T as ensureSQLiteFts, Tt as resolveSecrets, U as notInArray, Ut as getPluginEndpoints, V as ne, Vt as defineServicePlugin, W as or, Wt as buildErrorHelpers, X as createPostgresDatabase, Xt as toErrorResponse, Y as isDatabaseHandle, Yt as validateWithSchema, Z as blob, _ as Table, _t as swaggerDocsHTML, at as text, b as attachDatabase, bt as envSource, c as createMcpHandler, ct as isTool, d as defineEffectResourcePlugin, dt as endpointPaths, en as resetGlobalRegistry, et as index, f as defineEffectServicePlugin, ft as resolveEndpointDb, g as defineResource, gt as scalarDocsHTML, h as defineService, ht as registerReferenceRoute, it as sqliteTable, j as gt, jt as bindCompiledApplication, k as getTableColumns, kt as getActionAccess, l as createMcpRegistry, lt as brick, m as ServiceImpl, mt as referencePlugin, n as defineEffectAction, nt as primaryKey, o as createServiceProxy, ot as uniqueIndex, p as defineEffectService, pt as toOpenApiPath, q as syncSchema, qt as getCompiledCheck, r as defineEffectTool, rt as real, s as UnknownToolError, st as defineTool, tt as integer, u as effectBrick, ut as createEndpointHandler, v as and, vt as requestLoggingPlugin, w as ensureResourceIndexes, wt as resetSecrets, x as buildFtsMatchQuery, xt as listSecrets, y as asc, yt as SecretRef, z as lt, zt as compilerRuntime } from "./chunks/effect.js";
2
+ import { n as ValidationError, t as ActionExecutionError } from "./chunks/types.js";
3
+ import { BrickServerError, BrickTransportError, createBrickClient, isBrickServerError, isBrickTransportError } from "./client.js";
4
+ //#region src/compiler/emit.ts
5
+ /** Emits framework code only. User callbacks remain closures bound separately. */
6
+ function emitHandlerFactory(route) {
7
+ const name = JSON.stringify(route.action);
8
+ const fields = route.input ? "params, body, query, headers, request, set" : "headers, request, set";
9
+ const input = ["let input;"];
10
+ if (route.input) {
11
+ input.push("let coercedQuery = query;");
12
+ if (route.coercions.length) {
13
+ input.push("if (query) {", "coercedQuery = { ...query };");
14
+ for (const [index, coercion] of route.coercions.entries()) {
15
+ const key = JSON.stringify(coercion.key);
16
+ input.push(`const v${index} = query[${key}];`);
17
+ if (coercion.type === "number") input.push(`if (v${index} !== undefined) { const n${index} = Number(v${index}); if (!Number.isNaN(n${index})) coercedQuery[${key}] = n${index}; }`);
18
+ else input.push(`if (v${index} === "true" || v${index} === "1") coercedQuery[${key}] = true; else if (v${index} === "false" || v${index} === "0") coercedQuery[${key}] = false;`);
299
19
  }
300
- if (result === false) throw new Error(`Invalid value for secret "${this.name}": validation failed`);
301
- if (typeof result === "string") throw new Error(`Invalid value for secret "${this.name}": ${result}`);
20
+ input.push("}");
302
21
  }
303
- return value;
304
- }
305
- /** Resolved (transformed, validated) value or `undefined`. Never throws on missing. */
306
- value(source = envSource) {
307
- const raw = this.resolveRaw(source);
308
- if (raw === void 0) return void 0;
309
- return this.coerce(raw);
310
- }
311
- /** Resolved value, or throws naming the missing/invalid secret. */
312
- require(source = envSource) {
313
- const raw = this.resolveRaw(source);
314
- if (raw === void 0) throw new Error(`Missing required secret "${this.name}": set it in .env (local) or the environment (prod)`);
315
- return this.coerce(raw);
316
- }
317
- /** True when a value would resolve (override, source, or default). */
318
- isSet(source = envSource) {
319
- return this.resolveRaw(source) !== void 0;
320
- }
22
+ input.push(`input = mergeInput(${route.inputPrecedence.map((source) => source === "query" ? "coercedQuery" : source).join(", ")});`);
23
+ if (route.inputSchema?.type === "object") input.push("input ??= {};");
24
+ }
25
+ const asyncStages = route.context || route.authorize;
26
+ const context = route.context ? "const extra = await contextHook(ctx); if (extra) Object.assign(ctx, extra);" : "";
27
+ const validation = route.input ? `checkDepth(input, ${name}); validate(inputChecker, input, ${name}, "input");` : "";
28
+ const authorization = route.authorize ? `if (!await authorize({ ctx, input, user: ctx.user })) deny(${name}, ctx.user);` : "";
29
+ const output = route.output ? `validate(outputChecker, result, ${name}, "output");` : "";
30
+ const execute = asyncStages ? `const result = await execute({ input, ctx, error: errorBuilder });\n${output}\nreturn result;` : `const result = execute({ input, ctx, error: errorBuilder });
31
+ if (isThenable(result)) return Promise.resolve(result).then(value => {
32
+ ${route.output ? `validate(outputChecker, value, ${name}, "output");` : ""}
33
+ return value;
34
+ }).catch(err => mapError(err, set, ctx));
35
+ ${output}
36
+ return result;`;
37
+ return `function bindAction(binding, runtime) {
38
+ const { execute, contextHook, authorize, inputChecker, outputChecker, errorBuilder, logger, cachedDb, service } = binding;
39
+ const { nextSequence, defaultRequest, emptyServices, mergeInput, checkDepth, validate, deny, mapError, isThenable } = runtime;
40
+ return ${asyncStages ? "async " : ""}function brickAction({ ${fields} }) {
41
+ const seq = nextSequence();
42
+ const traceId = (headers && headers["x-trace-id"]) || "tr_" + seq;
43
+ const requestId = (headers && headers["x-request-id"]) || "req_" + seq;
44
+ if (set?.headers) { set.headers["x-trace-id"] = traceId; set.headers["x-request-id"] = requestId; }
45
+ ${input.join("\n")}
46
+ const ctx = { request: request instanceof Request ? request : defaultRequest, traceId, requestId,
47
+ db: cachedDb ?? service.getDb(), logger, services: emptyServices, metadata: { headers }, _resolved: true };
48
+ try {
49
+ ${context}
50
+ ${validation}
51
+ ${authorization}
52
+ ${execute}
53
+ } catch (err) { return mapError(err, set, ctx); }
321
54
  };
322
- /**
323
- * Declare a secret. Idempotent: re-declaring the same name returns the
324
- * original ref (first declaration wins) so module re-evaluation is safe.
325
- */
326
- function secret(name, options = {}) {
327
- const existing = registry.get(name);
328
- if (existing) return existing;
329
- const ref = new SecretRef(name, options);
330
- registry.set(name, ref);
331
- return ref;
332
- }
333
- /**
334
- * Validate every registered secret at boot. Throws a single error listing
335
- * all missing required secrets. Returns the resolved values.
336
- */
337
- function resolveSecrets(opts = {}) {
338
- const source = opts.source ?? envSource;
339
- const missing = [];
340
- const resolved = {};
341
- for (const ref of registry.values()) {
342
- const v = ref.value(source);
343
- if (v === void 0) missing.push(ref.name);
344
- else resolved[ref.name] = v;
345
- }
346
- if (missing.length > 0) throw new Error(`Missing required secrets: ${missing.join(", ")}. Set them in .env (local) or the environment (prod)`);
347
- return resolved;
348
- }
349
- /** Metadata for introspection (values never exposed — future dashboard use). */
350
- function listSecrets(opts = {}) {
351
- const source = opts.source ?? envSource;
352
- return [...registry.values()].map((ref) => ({
353
- hasDefault: ref.hasDefault,
354
- isSet: ref.isSet(source),
355
- name: ref.name
356
- }));
357
- }
358
- /** Test/session override for one secret (`undefined` clears the override). */
359
- function overrideSecret(name, value) {
360
- overrides.set(name, value);
361
- }
362
- /** Bulk overrides (test/session scoped). */
363
- function overrideSecrets(values) {
364
- for (const [name, value] of Object.entries(values)) overrides.set(name, value);
365
- }
366
- /** Clear registry and overrides. Test-only. */
367
- function resetSecrets() {
368
- registry.clear();
369
- overrides.clear();
55
+ }`;
370
56
  }
371
57
  //#endregion
372
- export { Brick, SecretRef, envSource, isNativeBrickApp, listSecrets, overrideSecret, overrideSecrets, resetSecrets, resolveSecrets, secret };
58
+ export { ACTION_ACCESS_KEY, ActionExecutionError, BrickServerError, BrickTransportError, SecretRef, ServiceImpl, ServiceRegistry, Table, Type, UnknownToolError, ValidationError, and, asc, attachDatabase, bindCompiledApplication, blob, brick, buildErrorHelpers, buildFtsMatchQuery, compileBrickApplication, compileRoutePlan, compilerRuntime, createActionHandler, createBrickClient, createDatabase, createEndpointHandler, createMcpHandler, createMcpRegistry, createPostgresDatabase, createSQLiteDatabase, createServiceProxy, defineAction, defineDatabase, defineEffectAction, defineEffectResourcePlugin, defineEffectService, defineEffectServicePlugin, defineEffectTool, defineResource, defineResourcePlugin, defineService, defineServicePlugin, defineTool, desc, effectBrick, emitHandlerFactory, endpointPaths, ensureResourceIndexes, ensureSQLiteFts, envSource, eq, executeCompiledRoute, foreignKey, generateOpenApiSpec, generateSQLiteIndexDdl, generateSQLiteTableDdl, getActionAccess, getCompiledCheck, getGlobalRegistry, getPluginActionRoute, getPluginEndpoints, getTableColumns, getTableName, gt, gte, ilike, inArray, index, integer, is, isBrickApp, isBrickServerError, isBrickTransportError, isDatabaseHandle, isNotNull, isNull, isTool, like, listSecrets, loadCompiledBrickApp, lt, lte, ne, not, notInArray, or, overrideSecret, overrideSecrets, primaryKey, real, referencePlugin, registerReferenceRoute, relations, requestLoggingPlugin, requireBrickApp, resetGlobalRegistry, resetSecrets, resolveEndpointDb, resolveSecrets, scalarDocsHTML, secret, setActionAccess, sql, sqliteTable, swaggerDocsHTML, syncSchema, t, text, toErrorResponse, toOpenApiPath, uniqueIndex, validateWithSchema };
373
59
 
374
60
  //# sourceMappingURL=index.js.map
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 /** 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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"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../src/compiler/emit.ts"],"sourcesContent":["import type { RouteIR } from \"./ir\";\n\n/** Emits framework code only. User callbacks remain closures bound separately. */\nexport function emitHandlerFactory(route: RouteIR): string {\n const name = JSON.stringify(route.action);\n const fields = route.input\n ? \"params, body, query, headers, request, set\"\n : \"headers, request, set\";\n const input: string[] = [\"let input;\"];\n if (route.input) {\n input.push(\"let coercedQuery = query;\");\n if (route.coercions.length) {\n input.push(\"if (query) {\", \"coercedQuery = { ...query };\");\n for (const [index, coercion] of route.coercions.entries()) {\n const key = JSON.stringify(coercion.key);\n input.push(`const v${index} = query[${key}];`);\n if (coercion.type === \"number\")\n input.push(\n `if (v${index} !== undefined) { const n${index} = Number(v${index}); if (!Number.isNaN(n${index})) coercedQuery[${key}] = n${index}; }`,\n );\n else\n input.push(\n `if (v${index} === \"true\" || v${index} === \"1\") coercedQuery[${key}] = true; else if (v${index} === \"false\" || v${index} === \"0\") coercedQuery[${key}] = false;`,\n );\n }\n input.push(\"}\");\n }\n input.push(\n `input = mergeInput(${route.inputPrecedence.map((source) => (source === \"query\" ? \"coercedQuery\" : source)).join(\", \")});`,\n );\n if ((route.inputSchema as { type?: string } | undefined)?.type === \"object\")\n input.push(\"input ??= {};\");\n }\n const asyncStages = route.context || route.authorize;\n const context = route.context\n ? \"const extra = await contextHook(ctx); if (extra) Object.assign(ctx, extra);\"\n : \"\";\n const validation = route.input\n ? `checkDepth(input, ${name}); validate(inputChecker, input, ${name}, \"input\");`\n : \"\";\n const authorization = route.authorize\n ? `if (!await authorize({ ctx, input, user: ctx.user })) deny(${name}, ctx.user);`\n : \"\";\n const output = route.output\n ? `validate(outputChecker, result, ${name}, \"output\");`\n : \"\";\n const execute = asyncStages\n ? `const result = await execute({ input, ctx, error: errorBuilder });\\n${output}\\nreturn result;`\n : `const result = execute({ input, ctx, error: errorBuilder });\nif (isThenable(result)) return Promise.resolve(result).then(value => {\n ${route.output ? `validate(outputChecker, value, ${name}, \"output\");` : \"\"}\n return value;\n}).catch(err => mapError(err, set, ctx));\n${output}\nreturn result;`;\n return `function bindAction(binding, runtime) {\nconst { execute, contextHook, authorize, inputChecker, outputChecker, errorBuilder, logger, cachedDb, service } = binding;\nconst { nextSequence, defaultRequest, emptyServices, mergeInput, checkDepth, validate, deny, mapError, isThenable } = runtime;\nreturn ${asyncStages ? \"async \" : \"\"}function brickAction({ ${fields} }) {\nconst seq = nextSequence();\nconst traceId = (headers && headers[\"x-trace-id\"]) || \"tr_\" + seq;\nconst requestId = (headers && headers[\"x-request-id\"]) || \"req_\" + seq;\nif (set?.headers) { set.headers[\"x-trace-id\"] = traceId; set.headers[\"x-request-id\"] = requestId; }\n${input.join(\"\\n\")}\nconst ctx = { request: request instanceof Request ? request : defaultRequest, traceId, requestId,\n db: cachedDb ?? service.getDb(), logger, services: emptyServices, metadata: { headers }, _resolved: true };\ntry {\n${context}\n${validation}\n${authorization}\n${execute}\n} catch (err) { return mapError(err, set, ctx); }\n};\n}`;\n}\n"],"mappings":";;;;;AAGA,SAAgB,mBAAmB,OAAwB;CACzD,MAAM,OAAO,KAAK,UAAU,MAAM,MAAM;CACxC,MAAM,SAAS,MAAM,QACjB,+CACA;CACJ,MAAM,QAAkB,CAAC,YAAY;CACrC,IAAI,MAAM,OAAO;EACf,MAAM,KAAK,2BAA2B;EACtC,IAAI,MAAM,UAAU,QAAQ;GAC1B,MAAM,KAAK,gBAAgB,8BAA8B;GACzD,KAAK,MAAM,CAAC,OAAO,aAAa,MAAM,UAAU,QAAQ,GAAG;IACzD,MAAM,MAAM,KAAK,UAAU,SAAS,GAAG;IACvC,MAAM,KAAK,UAAU,MAAM,WAAW,IAAI,GAAG;IAC7C,IAAI,SAAS,SAAS,UACpB,MAAM,KACJ,QAAQ,MAAM,2BAA2B,MAAM,aAAa,MAAM,wBAAwB,MAAM,kBAAkB,IAAI,OAAO,MAAM,IACrI;SAEA,MAAM,KACJ,QAAQ,MAAM,kBAAkB,MAAM,yBAAyB,IAAI,sBAAsB,MAAM,mBAAmB,MAAM,yBAAyB,IAAI,WACvJ;GACJ;GACA,MAAM,KAAK,GAAG;EAChB;EACA,MAAM,KACJ,sBAAsB,MAAM,gBAAgB,KAAK,WAAY,WAAW,UAAU,iBAAiB,MAAO,CAAC,CAAC,KAAK,IAAI,EAAE,GACzH;EACA,IAAK,MAAM,aAA+C,SAAS,UACjE,MAAM,KAAK,eAAe;CAC9B;CACA,MAAM,cAAc,MAAM,WAAW,MAAM;CAC3C,MAAM,UAAU,MAAM,UAClB,gFACA;CACJ,MAAM,aAAa,MAAM,QACrB,qBAAqB,KAAK,mCAAmC,KAAK,eAClE;CACJ,MAAM,gBAAgB,MAAM,YACxB,8DAA8D,KAAK,gBACnE;CACJ,MAAM,SAAS,MAAM,SACjB,mCAAmC,KAAK,gBACxC;CACJ,MAAM,UAAU,cACZ,uEAAuE,OAAO,oBAC9E;;IAEF,MAAM,SAAS,kCAAkC,KAAK,gBAAgB,GAAG;;;EAG3E,OAAO;;CAEP,OAAO;;;SAGA,cAAc,WAAW,GAAG,yBAAyB,OAAO;;;;;EAKnE,MAAM,KAAK,IAAI,EAAE;;;;EAIjB,QAAQ;EACR,WAAW;EACX,cAAc;EACd,QAAQ;;;;AAIV"}
package/dist/pg.d.ts CHANGED
@@ -1,9 +1,9 @@
1
- import { bigint, bigserial, boolean, char, check, date, decimal, doublePrecision, foreignKey, index, integer, interval, json, jsonb, numeric, pgEnum, pgSchema, pgTable, pgView, primaryKey, real, serial, smallint, text, time, timestamp, uniqueIndex, uuid, varchar } from "drizzle-orm/pg-core";
2
- import { defineRelations, defineRelations as defineRelations$1, sql } from "drizzle-orm";
3
1
  import { PostgresJsDatabase, PostgresJsDatabase as PostgresJsDatabase$1 } from "drizzle-orm/postgres-js";
2
+ import { relations, sql } from "drizzle-orm";
3
+ import { bigint, bigserial, boolean, char, check, date, decimal, doublePrecision, foreignKey, index, integer, interval, json, jsonb, numeric, pgEnum, pgSchema, pgTable, pgView, primaryKey, real, serial, smallint, text, time, timestamp, uniqueIndex, uuid, varchar } from "drizzle-orm/pg-core";
4
4
  //#region src/db/pg.d.ts
5
5
  /** Typed Postgres Drizzle instance, as held by `defineDatabase({engine})`. */
6
- export type PgDatabase<TSchema extends Record<string, unknown> = Record<string, unknown>> = PostgresJsDatabase$1<ReturnType<typeof defineRelations$1<TSchema>>>;
6
+ export type PgDatabase<TSchema extends Record<string, unknown> = Record<string, unknown>> = PostgresJsDatabase$1<TSchema>;
7
7
  //#endregion
8
- export { type PostgresJsDatabase, bigint, bigserial, boolean, char, check, date, decimal, type defineRelations, doublePrecision, foreignKey, index, integer, interval, json, jsonb, numeric, pgEnum, pgSchema, pgTable, pgView, primaryKey, real, serial, smallint, sql, text, time, timestamp, uniqueIndex, uuid, varchar };
8
+ export { type PostgresJsDatabase, bigint, bigserial, boolean, char, check, date, decimal, doublePrecision, foreignKey, index, integer, interval, json, jsonb, numeric, pgEnum, pgSchema, pgTable, pgView, primaryKey, real, relations, serial, smallint, sql, text, time, timestamp, uniqueIndex, uuid, varchar };
9
9
  //# sourceMappingURL=pg.d.ts.map
package/dist/pg.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"pg.d.ts","names":["defineRelations","PostgresJsDatabase"],"sources":["../src/db/pg.ts"],"mappings":";;;;;YAiDY,WACV,gBAAgB,0BAA0B,2BACxCC,qBAAmB,kBAAkBD,kBAAgB"}
1
+ {"version":3,"file":"pg.d.ts","names":["PostgresJsDatabase"],"sources":["../src/db/pg.ts"],"mappings":";;;;;YAgDY,WACV,gBAAgB,0BAA0B,2BACxCA,qBAAmB"}
package/dist/pg.js CHANGED
@@ -1,3 +1,3 @@
1
+ import { relations, sql } from "drizzle-orm";
1
2
  import { bigint, bigserial, boolean, char, check, date, decimal, doublePrecision, foreignKey, index, integer, interval, json, jsonb, numeric, pgEnum, pgSchema, pgTable, pgView, primaryKey, real, serial, smallint, text, time, timestamp, uniqueIndex, uuid, varchar } from "drizzle-orm/pg-core";
2
- import { defineRelations, sql } from "drizzle-orm";
3
- export { bigint, bigserial, boolean, char, check, date, decimal, defineRelations, doublePrecision, foreignKey, index, integer, interval, json, jsonb, numeric, pgEnum, pgSchema, pgTable, pgView, primaryKey, real, serial, smallint, sql, text, time, timestamp, uniqueIndex, uuid, varchar };
3
+ export { bigint, bigserial, boolean, char, check, date, decimal, doublePrecision, foreignKey, index, integer, interval, json, jsonb, numeric, pgEnum, pgSchema, pgTable, pgView, primaryKey, real, relations, serial, smallint, sql, text, time, timestamp, uniqueIndex, uuid, varchar };
package/package.json CHANGED
@@ -1,11 +1,12 @@
1
1
  {
2
2
  "name": "@brickkit/core",
3
- "version": "0.6.1",
3
+ "version": "0.7.1",
4
4
  "description": "Core engine primitives for the Brick-TS framework",
5
5
  "keywords": [
6
6
  "typescript",
7
7
  "bun",
8
8
  "backend-framework",
9
+ "elysia",
9
10
  "drizzle-orm",
10
11
  "typebox",
11
12
  "rest-api",
@@ -24,13 +25,17 @@
24
25
  "import": "./dist/index.js",
25
26
  "types": "./dist/index.d.ts"
26
27
  },
27
- "./contracts": {
28
- "types": "./dist/contracts.d.ts",
29
- "import": "./dist/contracts.js"
28
+ "./client": {
29
+ "import": "./dist/client.js",
30
+ "types": "./dist/client.d.ts"
30
31
  },
31
32
  "./pg": {
32
33
  "import": "./dist/pg.js",
33
34
  "types": "./dist/pg.d.ts"
35
+ },
36
+ "./effect": {
37
+ "import": "./dist/effect.js",
38
+ "types": "./dist/effect.d.ts"
34
39
  }
35
40
  },
36
41
  "publishConfig": {
@@ -55,12 +60,10 @@
55
60
  },
56
61
  "dependencies": {
57
62
  "@sinclair/typebox": "^0.34.52",
58
- "drizzle-orm": "1.0.0-rc.5-5935859",
59
- "effect": "4.0.4",
60
- "postgres": "^3.4.9",
61
- "@effect/sql-pg": "4.0.4",
62
- "@effect/sql-sqlite-bun": "4.0.4",
63
- "pg": "^8.16.3"
63
+ "drizzle-orm": "^0.45.2",
64
+ "effect": "^4",
65
+ "elysia": "2.0.0-beta.29",
66
+ "postgres": "^3.4.9"
64
67
  },
65
68
  "devDependencies": {
66
69
  "@types/bun": "^1.4.3",