@brickkit/cli 0.2.0 → 0.2.2

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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Chandraprakash-Darji
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -15,37 +15,42 @@ const app = brick({ title: "Pages API", version: "1.0.0" });
15
15
  app.listen(3333);
16
16
  ```
17
17
 
18
- Prefer a single source of truth? Define the client contract once and derive
19
- the server from it — no separate `services` list:
18
+ Build the backend directly from registered services:
20
19
 
21
20
  ```ts
22
- import { brickFromContract } from "@brickkit/cli";
23
- import { defineAppContract } from "@brickkit/core/client";
24
-
25
- export const contract = defineAppContract({
26
- page: pagesResource,
27
- billing: { charge: chargeAction },
28
- });
29
- export type AppServer = typeof contract;
21
+ import { brick } from "@brickkit/cli";
22
+ import { pagesService, billingService } from "./services";
30
23
 
31
- const app = brickFromContract(contract);
24
+ const app = brick({ services: [pagesService, billingService] });
32
25
  ```
33
26
 
34
- Frontends then call it fully typed via `createBrickClient<AppServer>()`
35
- (`@brickkit/core/client`, type-only import). See
36
- `www/content/docs/(brick)/typed-client.mdx` for routing, error handling, and
37
- options.
27
+ The typed HTTP client is available from `@brickkit/core/client`. See
28
+ `www/content/docs/(brick)/typed-client.mdx` for routing and error handling.
38
29
 
39
30
  The `brick` binary ships in this package for local dev and inspection:
40
31
 
41
32
  ```sh
42
33
  brick dev --port 4000
43
34
  brick gen openapi --output openapi.json
35
+ brick gen client src/app.ts
44
36
  brick info
45
37
  ```
46
38
 
47
39
  Source: <https://github.com/Chandraprakash-Darji/brick>.
48
40
 
41
+ ## Action routes
42
+
43
+ Each action exposes exactly one route: `method` defaults to POST, and `path`
44
+ defaults to `/api/{service}/{action}` (or your configured prefix). Explicit
45
+ methods are honored regardless of the action name. A custom `path` includes
46
+ its own prefix and replaces the default path. OpenAPI describes the same
47
+ method and path, including path parameters.
48
+
49
+ To expose a read action over GET, declare `method: "GET"`. Action names beginning
50
+ with `get`, `list`, `find`, or `read` no longer add a GET alias. Custom paths no
51
+ longer expose default action aliases or an additional method. Resource CRUD
52
+ routes keep their REST methods.
53
+
49
54
  ## Compiler
50
55
 
51
56
  The server compiles specialized JavaScript handlers for all resource CRUD and
@@ -61,3 +66,97 @@ bun dist/brick/server.js
61
66
 
62
67
  See [the compilation plan and artifact contract](COMPILER.md) for implemented
63
68
  stages, limitations and the next optimizations.
69
+
70
+ ## Automatic typed client with Vite
71
+
72
+ Add `brickClient` before your framework plugins. Its entry can be any module
73
+ whose default export is a `BrickApp`; construct the app without calling
74
+ `.listen()` there:
75
+
76
+ ```ts
77
+ // src/api/app.ts
78
+ import { brick } from "@brickkit/cli";
79
+ import { pagesService } from "./services";
80
+
81
+ export default brick({ prefix: "/v2", services: [pagesService] });
82
+ ```
83
+
84
+ ```ts
85
+ // vite.config.ts
86
+ import { brickClient } from "@brickkit/cli/vite";
87
+
88
+ export default defineConfig({
89
+ plugins: [
90
+ brickClient({ entry: "./src/api/app.ts" }),
91
+ // TanStack Start, React, or other framework plugins
92
+ ],
93
+ });
94
+ ```
95
+
96
+ Vite creates `_brick/contract.ts` before loading the frontend and before
97
+ production builds. The prefix and selected services come from the app. Backend
98
+ edits regenerate the file; unchanged metadata does not rewrite it. There is no
99
+ separate generation command or manually maintained action list.
100
+
101
+ ```ts
102
+ // src/client.ts
103
+ import { createBrickClient } from "@brickkit/core/client";
104
+ import { contract } from "../_brick/contract";
105
+
106
+ export const api = createBrickClient({
107
+ baseUrl: "http://localhost:8085",
108
+ contract,
109
+ });
110
+ ```
111
+
112
+ The generated file contains transport types and route metadata, with no runtime
113
+ imports or backend handlers. HTTP actions are grouped by service name; dotted
114
+ action names become nested namespaces. Resources use their names at the root
115
+ and their normal REST routes. MCP-only tools are excluded. Add `_brick/` to
116
+ `.gitignore`; customize its location with `output` in the plugin options.
117
+
118
+ For TanStack Start or another embedded server, import the app from
119
+ `virtual:brick-app` in server code and forward requests to `app.fetch(request)`.
120
+ Vite tracks the entry and its dependencies for backend hot reload. Browser
121
+ imports of this server module are rejected. Add
122
+ `/// <reference types="@brickkit/cli/vite/client" />` to your Vite environment
123
+ declarations. See `examples/pages` for a complete Start integration.
124
+
125
+ Generation evaluates the app entry, so the configuration it needs to construct
126
+ the app must be available in development and at build time. Keep startup jobs
127
+ and connection-opening initialization in request handlers or your server
128
+ bootstrap, outside the app definition module. Input/output types
129
+ come from JSON transport schemas; absent schemas produce `unknown`. Unresolved
130
+ schema references and non-JSON transport types fail generation explicitly.
131
+ This integration requires Vite 8; the normal server entry point has no Vite
132
+ runtime dependency. `generateClientContract(app)` exposes the source generator
133
+ for non-Vite tooling.
134
+
135
+ ## Generate a typed client without Vite
136
+
137
+ Use the standalone Bun CLI with any module whose default export is a `BrickApp`:
138
+
139
+ ```sh
140
+ brick gen client src/app.ts
141
+ brick gen client src/app.ts --output frontend/src/contract.ts
142
+ ```
143
+
144
+ The default output is `_brick/contract.ts`, relative to the working directory.
145
+ The app's selected services and prefix determine its contents, just as with the
146
+ Vite plugin. The command evaluates the entry without calling `.listen()`; keep
147
+ the listener in a separate server bootstrap. Vite is not required or loaded.
148
+
149
+ Run generation before your frontend's development server, build, and type check,
150
+ and rerun after changing backend definitions. You can add a package script:
151
+
152
+ ```json
153
+ {
154
+ "scripts": {
155
+ "gen:client": "brick gen client src/app.ts"
156
+ }
157
+ }
158
+ ```
159
+
160
+ Import the generated `contract` with `createBrickClient({ baseUrl, contract })`
161
+ as shown above. The command creates parent directories and leaves an unchanged
162
+ contract file untouched. Add the generated output to `.gitignore`.
package/dist/bin.js CHANGED
@@ -1,6 +1,35 @@
1
1
  #!/usr/bin/env bun
2
2
  import { n as startDevServer, t as buildApplication } from "./build.js";
3
+ import { t as generateClientContract } from "./client-contract.js";
3
4
  import { generateOpenApiSpec, getGlobalRegistry } from "@brickkit/core";
5
+ import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
6
+ import { dirname, join, resolve } from "node:path";
7
+ import { pathToFileURL } from "node:url";
8
+ import { randomUUID } from "node:crypto";
9
+ //#region src/client-contract-file.ts
10
+ /** Generate a client contract without loading Vite or starting a server. */
11
+ async function writeClientContract(entryPath, outputPath) {
12
+ const entry = resolve(entryPath);
13
+ const output = resolve(outputPath ?? "_brick/contract.ts");
14
+ if (entry === output) throw new Error("Brick: contract output must not overwrite the app entry.");
15
+ const { default: app } = await import(pathToFileURL(entry).href);
16
+ if (!app || typeof app.endpoint !== "function" || !app.definition) throw new Error("Brick: the entry module must default-export a BrickApp created by brick().");
17
+ const source = generateClientContract(app);
18
+ if (await readFile(output, "utf8").catch((error) => {
19
+ if (error.code !== "ENOENT") throw error;
20
+ }) !== source) {
21
+ await mkdir(dirname(output), { recursive: true });
22
+ const temporary = join(dirname(output), `.brick-contract-${randomUUID()}.tmp`);
23
+ try {
24
+ await writeFile(temporary, source, { flag: "wx" });
25
+ await rename(temporary, output);
26
+ } finally {
27
+ await rm(temporary, { force: true });
28
+ }
29
+ }
30
+ return output;
31
+ }
32
+ //#endregion
4
33
  //#region src/bin.ts
5
34
  const args = process.argv.slice(2);
6
35
  const command = args[0] || "dev";
@@ -42,6 +71,14 @@ async function main() {
42
71
  }
43
72
  case "gen": {
44
73
  const subCommand = args[1];
74
+ if (subCommand === "client") {
75
+ const entry = args[2];
76
+ if (!entry || entry.startsWith("-")) throw new Error("Usage: brick gen client <entry> [--output <file>]");
77
+ if (args.length > 3 && (args[3] !== "--output" || !args[4] || args[4].startsWith("-") || args.length > 5)) throw new Error("Usage: brick gen client <entry> [--output <file>]");
78
+ const output = await writeClientContract(entry, args[4]);
79
+ console.log(`Client contract written to ${output}`);
80
+ break;
81
+ }
45
82
  if (subCommand === "openapi") {
46
83
  const outIdx = args.indexOf("--output");
47
84
  const outputFile = outIdx !== -1 ? args[outIdx + 1] : void 0;
@@ -53,7 +90,7 @@ async function main() {
53
90
  } else console.log(jsonOutput);
54
91
  break;
55
92
  }
56
- console.error(`Unknown generator: ${subCommand}. Available: openapi`);
93
+ console.error(`Unknown generator: ${subCommand}. Available: openapi, client`);
57
94
  process.exit(1);
58
95
  break;
59
96
  }
@@ -72,6 +109,7 @@ Usage:
72
109
  brick start [entry] Start production server
73
110
  brick build <entry> [--outdir <dir>] Compile definitions into a Bun server
74
111
  brick gen openapi [--output <file>] Generate OpenAPI 3.1 JSON specification
112
+ brick gen client <entry> [--output <file>] Generate a typed browser client contract
75
113
  brick info Export architecture JSON schema
76
114
  `);
77
115
  process.exit(0);
package/dist/bin.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"bin.js","names":[],"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env bun\nimport { startDevServer } from \"./runner\";\nimport { buildApplication } from \"./build\";\nimport { getGlobalRegistry, generateOpenApiSpec } from \"@brickkit/core\";\n\nconst args = process.argv.slice(2);\nconst command = args[0] || \"dev\";\n\nasync function main() {\n switch (command) {\n case \"dev\":\n case \"start\": {\n const entry = args[1] && !args[1].startsWith(\"-\") ? args[1] : undefined;\n const portArgIdx = args.indexOf(\"--port\");\n const port = portArgIdx !== -1 ? Number(args[portArgIdx + 1]) : 4000;\n\n await startDevServer({ entry, port });\n break;\n }\n\n case \"build\": {\n const entry = args[1] && !args[1].startsWith(\"-\") ? args[1] : undefined;\n if (!entry)\n throw new Error(\n \"Usage: brick build <definitions.ts> [--outdir <directory>] [--prefix <path>] [--port <number>]\",\n );\n const value = (flag: string) => {\n const index = args.indexOf(flag);\n if (index === -1) return undefined;\n if (!args[index + 1] || args[index + 1]!.startsWith(\"--\"))\n throw new Error(`Missing value for ${flag}`);\n return args[index + 1];\n };\n const port = value(\"--port\");\n const result = await buildApplication({\n entry,\n outdir: value(\"--outdir\"),\n prefix: value(\"--prefix\"),\n port: port === undefined ? undefined : Number(port),\n requestLogging: !args.includes(\"--no-request-logging\"),\n });\n for (const warning of result.ir.diagnostics)\n console.warn(`[Brick compiler] ${warning}`);\n console.log(\n `Compiled ${result.ir.services.length} services / ${result.ir.routes.length} routes`,\n );\n console.log(`IR: ${result.outdir}/brick-ir.json`);\n console.log(`Run: bun ${result.entry}`);\n break;\n }\n\n case \"gen\": {\n const subCommand = args[1];\n if (subCommand === \"openapi\") {\n const outIdx = args.indexOf(\"--output\");\n const outputFile = outIdx !== -1 ? args[outIdx + 1] : undefined;\n\n const spec = generateOpenApiSpec();\n const jsonOutput = JSON.stringify(spec, null, 2);\n\n if (outputFile) {\n await Bun.write(outputFile, jsonOutput);\n console.log(`✅ OpenAPI 3.1 specification written to ${outputFile}`);\n } else {\n console.log(jsonOutput);\n }\n break;\n }\n console.error(`Unknown generator: ${subCommand}. Available: openapi`);\n process.exit(1);\n break;\n }\n\n case \"info\":\n case \"services\": {\n const registry = getGlobalRegistry();\n console.log(JSON.stringify(registry.exportArchitecture(), null, 2));\n break;\n }\n\n default:\n console.log(`\n🧱 Brick-TS CLI\n\nUsage:\n brick dev [entry] [--port <number>] Start development server with live reload\n brick start [entry] Start production server\n brick build <entry> [--outdir <dir>] Compile definitions into a Bun server\n brick gen openapi [--output <file>] Generate OpenAPI 3.1 JSON specification\n brick info Export architecture JSON schema\n`);\n process.exit(0);\n }\n}\n\nmain().catch((err) => {\n console.error(\"Fatal error:\", err);\n process.exit(1);\n});\n"],"mappings":";;;;AAKA,MAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AACjC,MAAM,UAAU,KAAK,MAAM;AAE3B,eAAe,OAAO;CACpB,QAAQ,SAAR;EACE,KAAK;EACL,KAAK,SAAS;GACZ,MAAM,QAAQ,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,WAAW,GAAG,IAAI,KAAK,KAAK,KAAA;GAC9D,MAAM,aAAa,KAAK,QAAQ,QAAQ;GACxC,MAAM,OAAO,eAAe,KAAK,OAAO,KAAK,aAAa,EAAE,IAAI;GAEhE,MAAM,eAAe;IAAE;IAAO;GAAK,CAAC;GACpC;EACF;EAEA,KAAK,SAAS;GACZ,MAAM,QAAQ,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,WAAW,GAAG,IAAI,KAAK,KAAK,KAAA;GAC9D,IAAI,CAAC,OACH,MAAM,IAAI,MACR,gGACF;GACF,MAAM,SAAS,SAAiB;IAC9B,MAAM,QAAQ,KAAK,QAAQ,IAAI;IAC/B,IAAI,UAAU,IAAI,OAAO,KAAA;IACzB,IAAI,CAAC,KAAK,QAAQ,MAAM,KAAK,QAAQ,EAAE,CAAE,WAAW,IAAI,GACtD,MAAM,IAAI,MAAM,qBAAqB,MAAM;IAC7C,OAAO,KAAK,QAAQ;GACtB;GACA,MAAM,OAAO,MAAM,QAAQ;GAC3B,MAAM,SAAS,MAAM,iBAAiB;IACpC;IACA,QAAQ,MAAM,UAAU;IACxB,QAAQ,MAAM,UAAU;IACxB,MAAM,SAAS,KAAA,IAAY,KAAA,IAAY,OAAO,IAAI;IAClD,gBAAgB,CAAC,KAAK,SAAS,sBAAsB;GACvD,CAAC;GACD,KAAK,MAAM,WAAW,OAAO,GAAG,aAC9B,QAAQ,KAAK,oBAAoB,SAAS;GAC5C,QAAQ,IACN,YAAY,OAAO,GAAG,SAAS,OAAO,cAAc,OAAO,GAAG,OAAO,OAAO,QAC9E;GACA,QAAQ,IAAI,OAAO,OAAO,OAAO,eAAe;GAChD,QAAQ,IAAI,YAAY,OAAO,OAAO;GACtC;EACF;EAEA,KAAK,OAAO;GACV,MAAM,aAAa,KAAK;GACxB,IAAI,eAAe,WAAW;IAC5B,MAAM,SAAS,KAAK,QAAQ,UAAU;IACtC,MAAM,aAAa,WAAW,KAAK,KAAK,SAAS,KAAK,KAAA;IAEtD,MAAM,OAAO,oBAAoB;IACjC,MAAM,aAAa,KAAK,UAAU,MAAM,MAAM,CAAC;IAE/C,IAAI,YAAY;KACd,MAAM,IAAI,MAAM,YAAY,UAAU;KACtC,QAAQ,IAAI,0CAA0C,YAAY;IACpE,OACE,QAAQ,IAAI,UAAU;IAExB;GACF;GACA,QAAQ,MAAM,sBAAsB,WAAW,qBAAqB;GACpE,QAAQ,KAAK,CAAC;GACd;EACF;EAEA,KAAK;EACL,KAAK,YAAY;GACf,MAAM,WAAW,kBAAkB;GACnC,QAAQ,IAAI,KAAK,UAAU,SAAS,mBAAmB,GAAG,MAAM,CAAC,CAAC;GAClE;EACF;EAEA;GACE,QAAQ,IAAI;;;;;;;;;CASjB;GACK,QAAQ,KAAK,CAAC;CAClB;AACF;AAEA,KAAK,CAAC,CAAC,OAAO,QAAQ;CACpB,QAAQ,MAAM,gBAAgB,GAAG;CACjC,QAAQ,KAAK,CAAC;AAChB,CAAC"}
1
+ {"version":3,"file":"bin.js","names":[],"sources":["../src/client-contract-file.ts","../src/bin.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { mkdir, readFile, rename, rm, writeFile } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { generateClientContract } from \"./client-contract\";\nimport type { BrickApp } from \"./endpoints\";\n\n/** Generate a client contract without loading Vite or starting a server. */\nexport async function writeClientContract(\n entryPath: string,\n outputPath?: string,\n) {\n const entry = resolve(entryPath);\n const output = resolve(outputPath ?? \"_brick/contract.ts\");\n if (entry === output)\n throw new Error(\"Brick: contract output must not overwrite the app entry.\");\n const { default: app } = await import(pathToFileURL(entry).href);\n if (!app || typeof app.endpoint !== \"function\" || !app.definition)\n throw new Error(\n \"Brick: the entry module must default-export a BrickApp created by brick().\",\n );\n const source = generateClientContract(app as BrickApp);\n const previous = await readFile(output, \"utf8\").catch((error) => {\n if (error.code !== \"ENOENT\") throw error;\n return undefined;\n });\n if (previous !== source) {\n await mkdir(dirname(output), { recursive: true });\n const temporary = join(\n dirname(output),\n `.brick-contract-${randomUUID()}.tmp`,\n );\n try {\n await writeFile(temporary, source, { flag: \"wx\" });\n await rename(temporary, output);\n } finally {\n await rm(temporary, { force: true });\n }\n }\n return output;\n}\n","#!/usr/bin/env bun\nimport { startDevServer } from \"./runner\";\nimport { buildApplication } from \"./build\";\nimport { writeClientContract } from \"./client-contract-file\";\nimport { getGlobalRegistry, generateOpenApiSpec } from \"@brickkit/core\";\n\nconst args = process.argv.slice(2);\nconst command = args[0] || \"dev\";\n\nasync function main() {\n switch (command) {\n case \"dev\":\n case \"start\": {\n const entry = args[1] && !args[1].startsWith(\"-\") ? args[1] : undefined;\n const portArgIdx = args.indexOf(\"--port\");\n const port = portArgIdx !== -1 ? Number(args[portArgIdx + 1]) : 4000;\n\n await startDevServer({ entry, port });\n break;\n }\n\n case \"build\": {\n const entry = args[1] && !args[1].startsWith(\"-\") ? args[1] : undefined;\n if (!entry)\n throw new Error(\n \"Usage: brick build <definitions.ts> [--outdir <directory>] [--prefix <path>] [--port <number>]\",\n );\n const value = (flag: string) => {\n const index = args.indexOf(flag);\n if (index === -1) return undefined;\n if (!args[index + 1] || args[index + 1]!.startsWith(\"--\"))\n throw new Error(`Missing value for ${flag}`);\n return args[index + 1];\n };\n const port = value(\"--port\");\n const result = await buildApplication({\n entry,\n outdir: value(\"--outdir\"),\n prefix: value(\"--prefix\"),\n port: port === undefined ? undefined : Number(port),\n requestLogging: !args.includes(\"--no-request-logging\"),\n });\n for (const warning of result.ir.diagnostics)\n console.warn(`[Brick compiler] ${warning}`);\n console.log(\n `Compiled ${result.ir.services.length} services / ${result.ir.routes.length} routes`,\n );\n console.log(`IR: ${result.outdir}/brick-ir.json`);\n console.log(`Run: bun ${result.entry}`);\n break;\n }\n\n case \"gen\": {\n const subCommand = args[1];\n if (subCommand === \"client\") {\n const entry = args[2];\n if (!entry || entry.startsWith(\"-\"))\n throw new Error(\"Usage: brick gen client <entry> [--output <file>]\");\n if (\n args.length > 3 &&\n (args[3] !== \"--output\" ||\n !args[4] ||\n args[4].startsWith(\"-\") ||\n args.length > 5)\n )\n throw new Error(\"Usage: brick gen client <entry> [--output <file>]\");\n const output = await writeClientContract(entry, args[4]);\n console.log(`Client contract written to ${output}`);\n break;\n }\n if (subCommand === \"openapi\") {\n const outIdx = args.indexOf(\"--output\");\n const outputFile = outIdx !== -1 ? args[outIdx + 1] : undefined;\n\n const spec = generateOpenApiSpec();\n const jsonOutput = JSON.stringify(spec, null, 2);\n\n if (outputFile) {\n await Bun.write(outputFile, jsonOutput);\n console.log(`✅ OpenAPI 3.1 specification written to ${outputFile}`);\n } else {\n console.log(jsonOutput);\n }\n break;\n }\n console.error(\n `Unknown generator: ${subCommand}. Available: openapi, client`,\n );\n process.exit(1);\n break;\n }\n\n case \"info\":\n case \"services\": {\n const registry = getGlobalRegistry();\n console.log(JSON.stringify(registry.exportArchitecture(), null, 2));\n break;\n }\n\n default:\n console.log(`\n🧱 Brick-TS CLI\n\nUsage:\n brick dev [entry] [--port <number>] Start development server with live reload\n brick start [entry] Start production server\n brick build <entry> [--outdir <dir>] Compile definitions into a Bun server\n brick gen openapi [--output <file>] Generate OpenAPI 3.1 JSON specification\n brick gen client <entry> [--output <file>] Generate a typed browser client contract\n brick info Export architecture JSON schema\n`);\n process.exit(0);\n }\n}\n\nmain().catch((err) => {\n console.error(\"Fatal error:\", err);\n process.exit(1);\n});\n"],"mappings":"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"}
package/dist/build.js CHANGED
@@ -335,6 +335,10 @@ function brick(options = {}) {
335
335
  };
336
336
  for (const def of options.endpoints ?? []) mountEndpoint(def);
337
337
  const brickApp = app;
338
+ Object.defineProperty(brickApp, "definition", { value: Object.freeze({
339
+ services: Object.freeze([...services]),
340
+ prefix
341
+ }) });
338
342
  brickApp.endpoint = (def) => {
339
343
  mountEndpoint(def);
340
344
  };
package/dist/build.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"build.js","names":["resolve"],"sources":["../src/request-logger.ts","../src/docs.ts","../src/endpoints.ts","../src/server.ts","../src/runner.ts","../src/build.ts"],"sourcesContent":["import { Elysia, type Context } from \"elysia\";\n\nexport interface RequestLoggingOptions {\n enabled?: boolean;\n logger?: (msg: string) => void;\n}\n\nfunction formatLog(\n method: string,\n path: string,\n status: string | number,\n elapsedMs: number,\n): string {\n return `${method} ${path} → ${String(status)} (${elapsedMs}ms)`;\n}\n\n/**\n * Status carried by the thrown error (Elysia sets e.g. 404 on NotFoundError\n * while `set.status` may still hold the 200 default when onError runs).\n */\nfunction thrownStatus(error: unknown): number | undefined {\n if (typeof error === \"object\" && error !== null && \"status\" in error) {\n const status: unknown = error.status;\n if (typeof status === \"number\") return status;\n }\n return undefined;\n}\n\n/**\n * Elysia plugin that logs each request as `METHOD path → status (elapsedms)`.\n * Timing is tracked per-Request via a WeakMap. The onError hook only logs and\n * returns undefined so existing error mapping is preserved. Logging only —\n * no CORS headers are set here.\n *\n * Hooks are registered with `{ as: \"global\" }` so they propagate to the\n * parent app when mounted via `app.use(...)` — Elysia scopes plain instance\n * hooks to the plugin's own routes. Timing is captured in onBeforeHandle\n * because onRequest offers no `as` option and is never propagated from a\n * used instance. Unmatched routes (no beforeHandle) fall back to Date.now().\n */\nexport function requestLoggingPlugin(opts: RequestLoggingOptions = {}): Elysia {\n const plugin = new Elysia();\n const enabled = opts.enabled ?? true;\n if (!enabled) return plugin;\n const logger = opts.logger ?? console.log;\n const startedAt = new WeakMap<object, number>();\n\n const markStarted = ({ request }: Pick<Context, \"request\">): void => {\n startedAt.set(request, Date.now());\n };\n\n const logSuccess = ({\n request,\n set,\n }: Pick<Context, \"request\" | \"set\">): void => {\n const start = startedAt.get(request) ?? Date.now();\n const path = new URL(request.url).pathname;\n logger(\n formatLog(request.method, path, set.status ?? 200, Date.now() - start),\n );\n };\n\n const logError = ({\n request,\n set,\n error,\n }: Pick<Context, \"request\" | \"set\"> & { error?: unknown }): undefined => {\n if (request) {\n const start = startedAt.get(request) ?? Date.now();\n const path = new URL(request.url).pathname;\n const status = thrownStatus(error) ?? set.status ?? 500;\n logger(formatLog(request.method, path, status, Date.now() - start));\n }\n return undefined;\n };\n\n plugin.onBeforeHandle({ as: \"global\" }, markStarted);\n plugin.onAfterHandle({ as: \"global\" }, logSuccess);\n plugin.onError({ as: \"global\" }, logError);\n\n return plugin;\n}\n","import { Elysia, type Context } from \"elysia\";\n\nexport interface ReferenceOptions {\n path?: string;\n title?: string;\n specUrl?: string;\n}\n\n/** Renders the Scalar API reference page for the given OpenAPI URL. */\nexport function scalarDocsHTML(specUrl: string, title: string): string {\n return `<!doctype html>\n<html>\n <head>\n <title>${title} — API Reference</title>\n <meta charset=\"utf-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n <link rel=\"icon\" type=\"image/svg+xml\" href=\"https://scalar.com/favicon.svg\" />\n <style>\n body { margin: 0; padding: 0; height: 100vh; }\n </style>\n </head>\n <body>\n <script\n id=\"api-reference\"\n data-url=\"${specUrl}\"\n data-configuration='{\"theme\": \"purple\", \"layout\": \"modern\"}'\n src=\"https://cdn.jsdelivr.net/npm/@scalar/api-reference\">\n </script>\n </body>\n</html>`;\n}\n\n/** Standalone Elysia plugin serving GET <path> with the Scalar HTML page. */\nexport function referencePlugin(opts: ReferenceOptions = {}): Elysia {\n const path = opts.path ?? \"/reference\";\n const title = opts.title ?? \"Brick-TS API Mesh\";\n const specUrl = opts.specUrl ?? \"/openapi.json\";\n const plugin = new Elysia();\n plugin.get(path, ({ set }: Context) => {\n set.headers[\"content-type\"] = \"text/html; charset=utf-8\";\n return scalarDocsHTML(specUrl, title);\n });\n return plugin;\n}\n\n/** Mounts the Scalar reference route onto an existing app. */\nexport function registerReferenceRoute(\n app: Elysia,\n opts: ReferenceOptions = {},\n): Elysia {\n return app.use(referencePlugin(opts)) as Elysia;\n}\n\n/** Renders the Swagger UI page. */\nexport function swaggerDocsHTML(specUrl: string, title: string): string {\n return `<!DOCTYPE html>\n<html lang=\"en\">\n <head>\n <meta charset=\"UTF-8\">\n <title>${title} — Swagger UI</title>\n <link rel=\"stylesheet\" type=\"text/css\" href=\"https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css\" />\n <style>\n html { box-sizing: border-box; overflow: -moz-scrollbars-vertical; overflow-y: scroll; }\n *, *:before, *:after { box-sizing: inherit; }\n body { margin:0; background: #fafafa; }\n </style>\n </head>\n <body>\n <div id=\"swagger-ui\"></div>\n <script src=\"https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js\" charset=\"UTF-8\"></script>\n <script src=\"https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-standalone-preset.js\" charset=\"UTF-8\"></script>\n <script>\n window.onload = function() {\n SwaggerUIBundle({\n url: \"${specUrl}\",\n dom_id: '#swagger-ui',\n deepLinking: true,\n presets: [\n SwaggerUIBundle.presets.apis,\n SwaggerUIStandalonePreset\n ],\n plugins: [\n SwaggerUIBundle.plugins.DownloadUrl\n ],\n layout: \"StandaloneLayout\"\n });\n };\n </script>\n </body>\n</html>`;\n}\n","import type { Elysia } from \"elysia\";\nimport type { Service, DatabaseHandle } from \"@brickkit/core\";\nimport { ActionExecutionError, ValidationError } from \"@brickkit/core\";\n\nexport type EndpointMethod = \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\n/** Logger subset handed to endpoint handlers (mirrors action context loggers). */\nexport interface EndpointLogger {\n info: (...args: any[]) => void;\n warn: (...args: any[]) => void;\n error: (...args: any[]) => void;\n debug: (...args: any[]) => void;\n}\n\n/** Context for raw endpoint handlers: Elysia route fields + Brick extras. */\nexport interface EndpointContext {\n params: Record<string, string>;\n query: Record<string, string | undefined>;\n body: unknown;\n headers: Record<string, string>;\n request: Request;\n /** Elysia response setter (status/headers). Mutate like in `app.get`. */\n set: { status?: number; headers: Record<string, string> };\n /** Drizzle db from `service` (or first service with one); `undefined` when none. */\n db: any;\n logger: EndpointLogger;\n traceId: string;\n requestId: string;\n}\n\nexport interface EndpointDefinition {\n method: EndpointMethod;\n /** Elysia-style path, e.g. `/p/:slug`. */\n path: string;\n handler: (ctx: EndpointContext) => unknown | Promise<unknown>;\n /** Db source: instance or registered service name. Defaults to first service with a db. */\n service?: Service<any, any> | string;\n /** Explicit database handle, independent of a service. */\n database?: DatabaseHandle<unknown>;\n summary?: string;\n description?: string;\n tags?: string[];\n}\n\n/** Resolve the db for an endpoint: explicit service first, else first service holding one. */\nexport function resolveEndpointDb(\n service: Service<any, any> | string | undefined,\n services: Service<any, any>[],\n): any {\n if (service) {\n const svc =\n typeof service === \"string\"\n ? services.find((s) => s.name === service)\n : (service as Service<any, any>);\n return svc?.getDb() ?? undefined;\n }\n for (const svc of services) {\n const db = svc.getDb();\n if (db) return db;\n }\n return undefined;\n}\n\n/** Wrap a raw handler with trace ids, logger, db, and mesh-consistent error mapping. */\nexport function createEndpointHandler(\n def: EndpointDefinition,\n services: Service<any, any>[],\n): (elysiaCtx: any) => Promise<unknown> {\n return async ({ params, body, query, headers, request, set }: any) => {\n const traceId =\n headers?.[\"x-trace-id\"] ||\n `tr_${Math.random().toString(36).substring(2, 10)}`;\n const requestId =\n headers?.[\"x-request-id\"] ||\n `req_${Math.random().toString(36).substring(2, 10)}`;\n\n if (set?.headers) {\n set.headers[\"x-trace-id\"] = traceId;\n set.headers[\"x-request-id\"] = requestId;\n }\n\n const tag = `endpoint:${def.method} ${def.path}`;\n const ctx: EndpointContext = {\n body,\n db: def.database\n ? def.database.getDb()\n : resolveEndpointDb(def.service, services),\n headers: headers ?? {},\n logger: {\n info: (...args) => console.log(`[${tag}]`, ...args),\n warn: (...args) => console.warn(`[${tag}]`, ...args),\n error: (...args) => console.error(`[${tag}]`, ...args),\n debug: (...args) => console.debug(`[${tag}]`, ...args),\n },\n params: params ?? {},\n query: query ?? {},\n request:\n request instanceof Request\n ? request\n : new Request(`http://localhost${def.path}`, {\n headers: new Headers((headers as Record<string, string>) ?? {}),\n method: def.method,\n }),\n requestId,\n set,\n traceId,\n };\n\n try {\n return await def.handler(ctx);\n } catch (err: any) {\n if (err instanceof ValidationError) {\n set.status = err.status || 400;\n return err.toJSON();\n }\n if (err instanceof ActionExecutionError) {\n set.status = err.status || 400;\n return err.toJSON();\n }\n if (typeof err?.status === \"number\") {\n set.status = err.status;\n return { message: err.message || \"Endpoint error\", status: err.status };\n }\n set.status = 500;\n return {\n message: err?.message || \"An unexpected error occurred\",\n status: 500,\n };\n }\n };\n}\n\n/** `/p/:slug` → `/p/{slug}` for OpenAPI. */\nexport function toOpenApiPath(elysiaPath: string): string {\n return elysiaPath.replace(/:([A-Za-z0-9_]+)/g, \"{$1}\");\n}\n\n/** Parameter names (`:slug`) extracted for the OpenAPI path item. */\nfunction pathParamNames(elysiaPath: string): string[] {\n return [...elysiaPath.matchAll(/:([A-Za-z0-9_]+)/g)].map((m) => m[1]);\n}\n\n/** OpenAPI `paths` fragment for declared endpoints (raw HTML included). */\nexport function endpointPaths(defs: EndpointDefinition[]): Record<string, any> {\n const paths: Record<string, any> = {};\n for (const def of defs) {\n const openApiPath = toOpenApiPath(def.path);\n if (!paths[openApiPath]) paths[openApiPath] = {};\n const params = pathParamNames(def.path).map((name) => ({\n in: \"path\",\n name,\n required: true,\n schema: { type: \"string\" },\n }));\n paths[openApiPath][def.method.toLowerCase()] = {\n ...(def.summary ? { summary: def.summary } : {}),\n ...(def.description ? { description: def.description } : {}),\n ...(def.tags ? { tags: def.tags } : {}),\n ...(params.length > 0 ? { parameters: params } : {}),\n responses: { 200: { description: \"Successful response\" } },\n };\n }\n return paths;\n}\n\n/** The app object returned by `brick`: Elysia plus `endpoint()`. */\nexport type BrickApp = Elysia<any, any, any, any, any, any, any> & {\n /** Register a raw endpoint (outside the JSON action mesh). */\n endpoint(def: EndpointDefinition): void;\n /** All endpoints registered via `endpoint()` (declaration order). */\n listEndpoints(): EndpointDefinition[];\n};\n","import { Elysia } from \"elysia\";\nimport { compileBrickApplication, type CompiledApplication } from \"./compiler\";\nimport {\n type Service,\n getGlobalRegistry,\n generateOpenApiSpec,\n resolveSecrets,\n type SecretSource,\n} from \"@brickkit/core\";\nimport {\n requestLoggingPlugin,\n type RequestLoggingOptions,\n} from \"./request-logger\";\nimport {\n scalarDocsHTML,\n swaggerDocsHTML,\n registerReferenceRoute,\n type ReferenceOptions,\n} from \"./docs\";\nimport {\n createEndpointHandler,\n endpointPaths,\n type BrickApp,\n type EndpointDefinition,\n} from \"./endpoints\";\n\nexport interface CreateServerOptions {\n port?: number;\n /** Generate specialized handlers once at startup (default true). */\n compiler?: boolean;\n /** Ahead-of-time handlers already bound to the supplied services. */\n compilation?: CompiledApplication;\n services?: Service<any, any>[];\n prefix?: string;\n title?: string;\n version?: string;\n description?: string;\n docs?: boolean;\n openApiPath?: string;\n docsPath?: string;\n swaggerPath?: string;\n requestLogging?: boolean | RequestLoggingOptions; // default true\n reference?: boolean | ReferenceOptions; // default false, path \"/reference\"\n secrets?: { source?: SecretSource; validate?: boolean };\n /** Raw endpoints (outside the JSON action mesh), mounted at startup. */\n endpoints?: EndpointDefinition[];\n}\n\nexport {\n compileRoutePlan,\n executeCompiledRoute,\n createActionHandler,\n} from \"./action-handler\";\n\nexport function brick(options: CreateServerOptions = {}): BrickApp {\n const prefix = options.prefix ?? options.compilation?.ir.prefix ?? \"/api\";\n const title = options.title ?? \"Brick-TS API Mesh\";\n const version = options.version ?? \"1.0.0\";\n const compiled = options.compiler !== false;\n const enableDocs = options.docs ?? true;\n const openApiPath = options.openApiPath ?? \"/openapi.json\";\n const docsPath = options.docsPath ?? \"/docs\";\n const swaggerPath = options.swaggerPath ?? \"/swagger\";\n\n const app = new Elysia();\n\n // Fail fast on missing required secrets before serving anything.\n // No-op when no secrets are registered.\n if (options.secrets?.validate !== false) {\n resolveSecrets({ source: options.secrets?.source });\n }\n\n // Diagnostics & health\n app.get(\"/_health\", () => ({\n status: \"ok\",\n uptime: process.uptime(),\n timestamp: Date.now(),\n }));\n\n // Serialize stable metadata once; registry changes invalidate the snapshot.\n app.get(\n \"/_brick/services\",\n compiled\n ? cachedJsonRoute(\n () => getGlobalRegistry().exportArchitecture(),\n () => {\n const registry = getGlobalRegistry();\n return [registry, registry.revision] as const;\n },\n )\n : () => getGlobalRegistry().exportArchitecture(),\n );\n\n // Request logging first so every route below is timed.\n const requestLogging = options.requestLogging ?? true;\n if (requestLogging !== false) {\n const pluginOpts = requestLogging === true ? {} : requestLogging;\n if (pluginOpts.enabled !== false) {\n app.use(requestLoggingPlugin(pluginOpts));\n }\n }\n\n // Scalar API reference (opt-in). Defaults to openApiPath for the spec URL.\n const reference = options.reference ?? false;\n if (reference !== false) {\n const refOpts = reference === true ? {} : reference;\n const settings = {\n path: refOpts.path ?? \"/reference\",\n title: refOpts.title ?? title,\n specUrl: refOpts.specUrl ?? openApiPath,\n };\n if (compiled)\n app.get(\n settings.path,\n htmlResponse(scalarDocsHTML(settings.specUrl, settings.title)),\n );\n else registerReferenceRoute(app, settings);\n }\n\n const services = options.services ?? getGlobalRegistry().list();\n\n // Precompute plans and freeze immutable plans across all services\n for (const service of services) {\n if (typeof (service as any).build === \"function\") {\n (service as any).build();\n }\n }\n\n // Raw endpoints declared via options or app.endpoint() (declaration order).\n const endpointDefs: EndpointDefinition[] = [];\n let endpointRevision = 0;\n\n // OpenAPI 3.1 & Interactive Documentation Endpoints\n if (enableDocs) {\n const buildSpec = () => {\n const spec = generateOpenApiSpec({\n title,\n version,\n description: options.description,\n prefix,\n services,\n });\n // Raw endpoints show up in the spec alongside the action mesh.\n return {\n ...spec,\n paths: { ...spec.paths, ...endpointPaths(endpointDefs) },\n };\n };\n app.get(\n openApiPath,\n compiled\n ? cachedJsonRoute(\n buildSpec,\n () =>\n [\n getGlobalRegistry(),\n getGlobalRegistry().revision + endpointRevision,\n ] as const,\n )\n : buildSpec,\n );\n\n if (compiled) {\n app.get(docsPath, htmlResponse(scalarDocsHTML(openApiPath, title)));\n app.get(swaggerPath, htmlResponse(swaggerDocsHTML(openApiPath, title)));\n } else {\n app.get(docsPath, ({ set }) => {\n set.headers[\"content-type\"] = \"text/html; charset=utf-8\";\n return scalarDocsHTML(openApiPath, title);\n });\n\n app.get(swaggerPath, ({ set }) => {\n set.headers[\"content-type\"] = \"text/html; charset=utf-8\";\n return swaggerDocsHTML(openApiPath, title);\n });\n }\n }\n\n // Dedicated Route Registry\n const registeredRoutes = new Set<string>();\n\n const mountRoute = (\n method: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\",\n path: string,\n handler: any,\n ) => {\n const routeKey = `${method} ${path}`;\n if (registeredRoutes.has(routeKey)) {\n return;\n }\n registeredRoutes.add(routeKey);\n\n switch (method) {\n case \"GET\":\n app.get(path, handler);\n break;\n case \"POST\":\n app.post(path, handler);\n break;\n case \"PUT\":\n app.put(path, handler);\n break;\n case \"PATCH\":\n app.patch(path, handler);\n break;\n case \"DELETE\":\n app.delete(path, handler);\n break;\n }\n };\n\n // Raw endpoints (outside the JSON action mesh).\n const mountEndpoint = (def: EndpointDefinition) => {\n endpointDefs.push(def);\n endpointRevision++;\n mountRoute(def.method, def.path, createEndpointHandler(def, services));\n };\n\n for (const def of options.endpoints ?? []) {\n mountEndpoint(def);\n }\n\n const brickApp = app as unknown as BrickApp;\n brickApp.endpoint = (def: EndpointDefinition) => {\n mountEndpoint(def);\n };\n brickApp.listEndpoints = () => [...endpointDefs];\n\n const compilation =\n options.compilation ??\n compileBrickApplication({\n services,\n prefix,\n mode: options.compiler === false ? \"generic\" : \"specialized\",\n });\n if (\n compilation.ir.prefix !== prefix ||\n JSON.stringify(compilation.ir.services) !==\n JSON.stringify(services.map((service) => service.name))\n ) {\n throw new Error(\n \"Brick compiler: server services/prefix differ from the bound compilation\",\n );\n }\n for (const route of compilation.routes)\n mountRoute(route.ir.method, route.ir.path, route.handler);\n\n return brickApp;\n}\n\nfunction htmlResponse(html: string): Response {\n return new Response(html, {\n headers: { \"content-type\": \"text/html; charset=utf-8\" },\n });\n}\n\n/** Reuse serialized JSON, without sharing a mutable response body between requests. */\nfunction cachedJsonRoute(\n build: () => unknown,\n revision: () => readonly [unknown, number],\n) {\n let [owner, version] = revision();\n let json = JSON.stringify(build());\n return ({ set }: { set: { headers: Record<string, unknown> } }) => {\n const [currentOwner, currentVersion] = revision();\n if (currentOwner !== owner || currentVersion !== version) {\n json = JSON.stringify(build());\n owner = currentOwner;\n version = currentVersion;\n }\n set.headers[\"content-type\"] = \"application/json;charset=utf-8\";\n return json;\n };\n}\n","import { existsSync } from \"fs\";\nimport { resolve } from \"path\";\nimport { getGlobalRegistry } from \"@brickkit/core\";\nimport { brick } from \"./server\";\n\nexport interface DevServerOptions {\n port?: number;\n entry?: string;\n prefix?: string;\n}\n\nexport async function startDevServer(options: DevServerOptions = {}) {\n const port = options.port ?? (Number(process.env.PORT) || 4000);\n const entry = options.entry;\n\n if (entry) {\n const resolvedEntry = resolve(process.cwd(), entry);\n if (existsSync(resolvedEntry)) {\n console.log(`[Brick-TS] Loading application entry: ${resolvedEntry}`);\n await import(resolvedEntry);\n } else {\n console.warn(`[Brick-TS] Specified entry not found: ${resolvedEntry}`);\n }\n }\n\n const registry = getGlobalRegistry();\n const services = registry.list();\n\n console.log(`\\n🧱 Brick-TS Development Server`);\n console.log(` Registered Services: ${services.length}`);\n\n for (const svc of services) {\n console.log(` • ${svc.name} (${svc.listActions().length} actions)`);\n if (typeof (svc as any).listResources === \"function\") {\n for (const res of (svc as any).listResources()) {\n console.log(\n ` -> Resource: /api/${res.name} (REST: GET, POST, /:id: GET, PATCH, DELETE)`,\n );\n }\n }\n for (const act of svc.listActions()) {\n console.log(` -> Action: /api/${svc.name}/${act.name}`);\n }\n }\n\n const app = brick({\n port,\n prefix: options.prefix,\n });\n\n app.listen(port);\n\n console.log(`\\n⚡ API Gateway running on: http://localhost:${port}`);\n console.log(`🩺 Health check: http://localhost:${port}/_health`);\n console.log(\n `🗺️ Architecture graph: http://localhost:${port}/_brick/services\\n`,\n );\n\n return app;\n}\n","import { mkdtemp, mkdir, rename, rm } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { getGlobalRegistry } from \"@brickkit/core\";\nimport { compileBrickApplication, emitCompiledApplication } from \"./compiler\";\n\nexport interface BuildApplicationOptions {\n /** A module that registers services, without starting a server. */\n entry: string;\n outdir?: string;\n prefix?: string;\n port?: number;\n requestLogging?: boolean;\n}\n\n/** Analyze definitions and bundle the emitted handlers with the user's callbacks. */\nexport async function buildApplication(options: BuildApplicationOptions) {\n const entry = resolve(options.entry);\n if (!(await Bun.file(entry).exists()))\n throw new Error(`Brick compiler: entry not found: ${entry}`);\n const outdir = resolve(options.outdir ?? \"dist/brick\");\n if (\n entry === join(outdir, \"server.js\") ||\n entry === join(outdir, \"routes.js\")\n )\n throw new Error(\n \"Brick compiler: output would overwrite the application entry\",\n );\n const port = options.port ?? 4000;\n if (!Number.isInteger(port) || port < 0 || port > 65535)\n throw new Error(\n \"Brick compiler: port must be an integer between 0 and 65535\",\n );\n await import(pathToFileURL(entry).href);\n const services = getGlobalRegistry().list();\n if (!services.length)\n throw new Error(\n \"Brick compiler: entry registered no services; use a definitions module\",\n );\n const compilation = compileBrickApplication({\n services,\n prefix: options.prefix,\n });\n await mkdir(dirname(outdir), { recursive: true });\n const staging = await mkdtemp(join(dirname(outdir), \".brick-build-\"));\n try {\n await Bun.write(\n join(staging, \"routes.js\"),\n emitCompiledApplication(compilation.ir),\n );\n const source = `import ${JSON.stringify(entry)};\nimport { brick } from \"@brickkit/cli\";\nimport { getGlobalRegistry } from \"@brickkit/core\";\nimport { bind } from \"./routes.js\";\nconst services = getGlobalRegistry().list();\nexport const app = brick({ services, compilation: bind(services), requestLogging: ${options.requestLogging ?? true} });\nif (import.meta.main) {\n const port = Number(process.env.PORT ?? ${port});\n if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error(\"Invalid PORT\");\n app.listen(port);\n console.log(\"Brick compiled server listening on http://localhost:\" + app.server.port);\n const stop = async () => { await app.stop(); process.exit(0); };\n process.once(\"SIGINT\", stop);\n process.once(\"SIGTERM\", stop);\n}\n`;\n await Bun.write(join(staging, \"entry.ts\"), source);\n const result = await Bun.build({\n entrypoints: [join(staging, \"entry.ts\")],\n target: \"bun\",\n format: \"esm\",\n outdir: staging,\n naming: \"server.js\",\n sourcemap: \"external\",\n });\n if (!result.success)\n throw new AggregateError(result.logs, \"Brick compiler: bundling failed\");\n await Bun.write(\n join(staging, \"brick-ir.json\"),\n JSON.stringify(compilation.ir, null, 2) + \"\\n\",\n );\n await mkdir(outdir, { recursive: true });\n for (const name of [\n \"routes.js\",\n \"brick-ir.json\",\n \"server.js.map\",\n \"server.js\",\n ])\n await rename(join(staging, name), join(outdir, name));\n return { outdir, entry: join(outdir, \"server.js\"), ir: compilation.ir };\n } finally {\n await rm(staging, { recursive: true, force: true });\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"build.js","names":["resolve"],"sources":["../src/request-logger.ts","../src/docs.ts","../src/endpoints.ts","../src/server.ts","../src/runner.ts","../src/build.ts"],"sourcesContent":["import { Elysia, type Context } from \"elysia\";\n\nexport interface RequestLoggingOptions {\n enabled?: boolean;\n logger?: (msg: string) => void;\n}\n\nfunction formatLog(\n method: string,\n path: string,\n status: string | number,\n elapsedMs: number,\n): string {\n return `${method} ${path} → ${String(status)} (${elapsedMs}ms)`;\n}\n\n/**\n * Status carried by the thrown error (Elysia sets e.g. 404 on NotFoundError\n * while `set.status` may still hold the 200 default when onError runs).\n */\nfunction thrownStatus(error: unknown): number | undefined {\n if (typeof error === \"object\" && error !== null && \"status\" in error) {\n const status: unknown = error.status;\n if (typeof status === \"number\") return status;\n }\n return undefined;\n}\n\n/**\n * Elysia plugin that logs each request as `METHOD path → status (elapsedms)`.\n * Timing is tracked per-Request via a WeakMap. The onError hook only logs and\n * returns undefined so existing error mapping is preserved. Logging only —\n * no CORS headers are set here.\n *\n * Hooks are registered with `{ as: \"global\" }` so they propagate to the\n * parent app when mounted via `app.use(...)` — Elysia scopes plain instance\n * hooks to the plugin's own routes. Timing is captured in onBeforeHandle\n * because onRequest offers no `as` option and is never propagated from a\n * used instance. Unmatched routes (no beforeHandle) fall back to Date.now().\n */\nexport function requestLoggingPlugin(opts: RequestLoggingOptions = {}): Elysia {\n const plugin = new Elysia();\n const enabled = opts.enabled ?? true;\n if (!enabled) return plugin;\n const logger = opts.logger ?? console.log;\n const startedAt = new WeakMap<object, number>();\n\n const markStarted = ({ request }: Pick<Context, \"request\">): void => {\n startedAt.set(request, Date.now());\n };\n\n const logSuccess = ({\n request,\n set,\n }: Pick<Context, \"request\" | \"set\">): void => {\n const start = startedAt.get(request) ?? Date.now();\n const path = new URL(request.url).pathname;\n logger(\n formatLog(request.method, path, set.status ?? 200, Date.now() - start),\n );\n };\n\n const logError = ({\n request,\n set,\n error,\n }: Pick<Context, \"request\" | \"set\"> & { error?: unknown }): undefined => {\n if (request) {\n const start = startedAt.get(request) ?? Date.now();\n const path = new URL(request.url).pathname;\n const status = thrownStatus(error) ?? set.status ?? 500;\n logger(formatLog(request.method, path, status, Date.now() - start));\n }\n return undefined;\n };\n\n plugin.onBeforeHandle({ as: \"global\" }, markStarted);\n plugin.onAfterHandle({ as: \"global\" }, logSuccess);\n plugin.onError({ as: \"global\" }, logError);\n\n return plugin;\n}\n","import { Elysia, type Context } from \"elysia\";\n\nexport interface ReferenceOptions {\n path?: string;\n title?: string;\n specUrl?: string;\n}\n\n/** Renders the Scalar API reference page for the given OpenAPI URL. */\nexport function scalarDocsHTML(specUrl: string, title: string): string {\n return `<!doctype html>\n<html>\n <head>\n <title>${title} — API Reference</title>\n <meta charset=\"utf-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n <link rel=\"icon\" type=\"image/svg+xml\" href=\"https://scalar.com/favicon.svg\" />\n <style>\n body { margin: 0; padding: 0; height: 100vh; }\n </style>\n </head>\n <body>\n <script\n id=\"api-reference\"\n data-url=\"${specUrl}\"\n data-configuration='{\"theme\": \"purple\", \"layout\": \"modern\"}'\n src=\"https://cdn.jsdelivr.net/npm/@scalar/api-reference\">\n </script>\n </body>\n</html>`;\n}\n\n/** Standalone Elysia plugin serving GET <path> with the Scalar HTML page. */\nexport function referencePlugin(opts: ReferenceOptions = {}): Elysia {\n const path = opts.path ?? \"/reference\";\n const title = opts.title ?? \"Brick-TS API Mesh\";\n const specUrl = opts.specUrl ?? \"/openapi.json\";\n const plugin = new Elysia();\n plugin.get(path, ({ set }: Context) => {\n set.headers[\"content-type\"] = \"text/html; charset=utf-8\";\n return scalarDocsHTML(specUrl, title);\n });\n return plugin;\n}\n\n/** Mounts the Scalar reference route onto an existing app. */\nexport function registerReferenceRoute(\n app: Elysia,\n opts: ReferenceOptions = {},\n): Elysia {\n return app.use(referencePlugin(opts)) as Elysia;\n}\n\n/** Renders the Swagger UI page. */\nexport function swaggerDocsHTML(specUrl: string, title: string): string {\n return `<!DOCTYPE html>\n<html lang=\"en\">\n <head>\n <meta charset=\"UTF-8\">\n <title>${title} — Swagger UI</title>\n <link rel=\"stylesheet\" type=\"text/css\" href=\"https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css\" />\n <style>\n html { box-sizing: border-box; overflow: -moz-scrollbars-vertical; overflow-y: scroll; }\n *, *:before, *:after { box-sizing: inherit; }\n body { margin:0; background: #fafafa; }\n </style>\n </head>\n <body>\n <div id=\"swagger-ui\"></div>\n <script src=\"https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js\" charset=\"UTF-8\"></script>\n <script src=\"https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-standalone-preset.js\" charset=\"UTF-8\"></script>\n <script>\n window.onload = function() {\n SwaggerUIBundle({\n url: \"${specUrl}\",\n dom_id: '#swagger-ui',\n deepLinking: true,\n presets: [\n SwaggerUIBundle.presets.apis,\n SwaggerUIStandalonePreset\n ],\n plugins: [\n SwaggerUIBundle.plugins.DownloadUrl\n ],\n layout: \"StandaloneLayout\"\n });\n };\n </script>\n </body>\n</html>`;\n}\n","import type { Elysia } from \"elysia\";\nimport type { Service, DatabaseHandle } from \"@brickkit/core\";\nimport { ActionExecutionError, ValidationError } from \"@brickkit/core\";\n\nexport type EndpointMethod = \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\n/** Logger subset handed to endpoint handlers (mirrors action context loggers). */\nexport interface EndpointLogger {\n info: (...args: any[]) => void;\n warn: (...args: any[]) => void;\n error: (...args: any[]) => void;\n debug: (...args: any[]) => void;\n}\n\n/** Context for raw endpoint handlers: Elysia route fields + Brick extras. */\nexport interface EndpointContext {\n params: Record<string, string>;\n query: Record<string, string | undefined>;\n body: unknown;\n headers: Record<string, string>;\n request: Request;\n /** Elysia response setter (status/headers). Mutate like in `app.get`. */\n set: { status?: number; headers: Record<string, string> };\n /** Drizzle db from `service` (or first service with one); `undefined` when none. */\n db: any;\n logger: EndpointLogger;\n traceId: string;\n requestId: string;\n}\n\nexport interface EndpointDefinition {\n method: EndpointMethod;\n /** Elysia-style path, e.g. `/p/:slug`. */\n path: string;\n handler: (ctx: EndpointContext) => unknown | Promise<unknown>;\n /** Db source: instance or registered service name. Defaults to first service with a db. */\n service?: Service<any, any> | string;\n /** Explicit database handle, independent of a service. */\n database?: DatabaseHandle<unknown>;\n summary?: string;\n description?: string;\n tags?: string[];\n}\n\n/** Resolve the db for an endpoint: explicit service first, else first service holding one. */\nexport function resolveEndpointDb(\n service: Service<any, any> | string | undefined,\n services: Service<any, any>[],\n): any {\n if (service) {\n const svc =\n typeof service === \"string\"\n ? services.find((s) => s.name === service)\n : (service as Service<any, any>);\n return svc?.getDb() ?? undefined;\n }\n for (const svc of services) {\n const db = svc.getDb();\n if (db) return db;\n }\n return undefined;\n}\n\n/** Wrap a raw handler with trace ids, logger, db, and mesh-consistent error mapping. */\nexport function createEndpointHandler(\n def: EndpointDefinition,\n services: Service<any, any>[],\n): (elysiaCtx: any) => Promise<unknown> {\n return async ({ params, body, query, headers, request, set }: any) => {\n const traceId =\n headers?.[\"x-trace-id\"] ||\n `tr_${Math.random().toString(36).substring(2, 10)}`;\n const requestId =\n headers?.[\"x-request-id\"] ||\n `req_${Math.random().toString(36).substring(2, 10)}`;\n\n if (set?.headers) {\n set.headers[\"x-trace-id\"] = traceId;\n set.headers[\"x-request-id\"] = requestId;\n }\n\n const tag = `endpoint:${def.method} ${def.path}`;\n const ctx: EndpointContext = {\n body,\n db: def.database\n ? def.database.getDb()\n : resolveEndpointDb(def.service, services),\n headers: headers ?? {},\n logger: {\n info: (...args) => console.log(`[${tag}]`, ...args),\n warn: (...args) => console.warn(`[${tag}]`, ...args),\n error: (...args) => console.error(`[${tag}]`, ...args),\n debug: (...args) => console.debug(`[${tag}]`, ...args),\n },\n params: params ?? {},\n query: query ?? {},\n request:\n request instanceof Request\n ? request\n : new Request(`http://localhost${def.path}`, {\n headers: new Headers((headers as Record<string, string>) ?? {}),\n method: def.method,\n }),\n requestId,\n set,\n traceId,\n };\n\n try {\n return await def.handler(ctx);\n } catch (err: any) {\n if (err instanceof ValidationError) {\n set.status = err.status || 400;\n return err.toJSON();\n }\n if (err instanceof ActionExecutionError) {\n set.status = err.status || 400;\n return err.toJSON();\n }\n if (typeof err?.status === \"number\") {\n set.status = err.status;\n return { message: err.message || \"Endpoint error\", status: err.status };\n }\n set.status = 500;\n return {\n message: err?.message || \"An unexpected error occurred\",\n status: 500,\n };\n }\n };\n}\n\n/** `/p/:slug` → `/p/{slug}` for OpenAPI. */\nexport function toOpenApiPath(elysiaPath: string): string {\n return elysiaPath.replace(/:([A-Za-z0-9_]+)/g, \"{$1}\");\n}\n\n/** Parameter names (`:slug`) extracted for the OpenAPI path item. */\nfunction pathParamNames(elysiaPath: string): string[] {\n return [...elysiaPath.matchAll(/:([A-Za-z0-9_]+)/g)].map((m) => m[1]);\n}\n\n/** OpenAPI `paths` fragment for declared endpoints (raw HTML included). */\nexport function endpointPaths(defs: EndpointDefinition[]): Record<string, any> {\n const paths: Record<string, any> = {};\n for (const def of defs) {\n const openApiPath = toOpenApiPath(def.path);\n if (!paths[openApiPath]) paths[openApiPath] = {};\n const params = pathParamNames(def.path).map((name) => ({\n in: \"path\",\n name,\n required: true,\n schema: { type: \"string\" },\n }));\n paths[openApiPath][def.method.toLowerCase()] = {\n ...(def.summary ? { summary: def.summary } : {}),\n ...(def.description ? { description: def.description } : {}),\n ...(def.tags ? { tags: def.tags } : {}),\n ...(params.length > 0 ? { parameters: params } : {}),\n responses: { 200: { description: \"Successful response\" } },\n };\n }\n return paths;\n}\n\n/** The app object returned by `brick`: Elysia plus `endpoint()`. */\nexport type BrickApp = Elysia<any, any, any, any, any, any, any> & {\n /** Service definitions and prefix selected when this app was constructed. */\n readonly definition: {\n readonly services: readonly Service<any, any>[];\n readonly prefix: string;\n };\n /** Register a raw endpoint (outside the JSON action mesh). */\n endpoint(def: EndpointDefinition): void;\n /** All endpoints registered via `endpoint()` (declaration order). */\n listEndpoints(): EndpointDefinition[];\n};\n","import { Elysia } from \"elysia\";\nimport { compileBrickApplication, type CompiledApplication } from \"./compiler\";\nimport {\n type Service,\n getGlobalRegistry,\n generateOpenApiSpec,\n resolveSecrets,\n type SecretSource,\n} from \"@brickkit/core\";\nimport {\n requestLoggingPlugin,\n type RequestLoggingOptions,\n} from \"./request-logger\";\nimport {\n scalarDocsHTML,\n swaggerDocsHTML,\n registerReferenceRoute,\n type ReferenceOptions,\n} from \"./docs\";\nimport {\n createEndpointHandler,\n endpointPaths,\n type BrickApp,\n type EndpointDefinition,\n} from \"./endpoints\";\n\nexport interface CreateServerOptions {\n port?: number;\n /** Generate specialized handlers once at startup (default true). */\n compiler?: boolean;\n /** Ahead-of-time handlers already bound to the supplied services. */\n compilation?: CompiledApplication;\n services?: Service<any, any>[];\n prefix?: string;\n title?: string;\n version?: string;\n description?: string;\n docs?: boolean;\n openApiPath?: string;\n docsPath?: string;\n swaggerPath?: string;\n requestLogging?: boolean | RequestLoggingOptions; // default true\n reference?: boolean | ReferenceOptions; // default false, path \"/reference\"\n secrets?: { source?: SecretSource; validate?: boolean };\n /** Raw endpoints (outside the JSON action mesh), mounted at startup. */\n endpoints?: EndpointDefinition[];\n}\n\nexport {\n compileRoutePlan,\n executeCompiledRoute,\n createActionHandler,\n} from \"./action-handler\";\n\nexport function brick(options: CreateServerOptions = {}): BrickApp {\n const prefix = options.prefix ?? options.compilation?.ir.prefix ?? \"/api\";\n const title = options.title ?? \"Brick-TS API Mesh\";\n const version = options.version ?? \"1.0.0\";\n const compiled = options.compiler !== false;\n const enableDocs = options.docs ?? true;\n const openApiPath = options.openApiPath ?? \"/openapi.json\";\n const docsPath = options.docsPath ?? \"/docs\";\n const swaggerPath = options.swaggerPath ?? \"/swagger\";\n\n const app = new Elysia();\n\n // Fail fast on missing required secrets before serving anything.\n // No-op when no secrets are registered.\n if (options.secrets?.validate !== false) {\n resolveSecrets({ source: options.secrets?.source });\n }\n\n // Diagnostics & health\n app.get(\"/_health\", () => ({\n status: \"ok\",\n uptime: process.uptime(),\n timestamp: Date.now(),\n }));\n\n // Serialize stable metadata once; registry changes invalidate the snapshot.\n app.get(\n \"/_brick/services\",\n compiled\n ? cachedJsonRoute(\n () => getGlobalRegistry().exportArchitecture(),\n () => {\n const registry = getGlobalRegistry();\n return [registry, registry.revision] as const;\n },\n )\n : () => getGlobalRegistry().exportArchitecture(),\n );\n\n // Request logging first so every route below is timed.\n const requestLogging = options.requestLogging ?? true;\n if (requestLogging !== false) {\n const pluginOpts = requestLogging === true ? {} : requestLogging;\n if (pluginOpts.enabled !== false) {\n app.use(requestLoggingPlugin(pluginOpts));\n }\n }\n\n // Scalar API reference (opt-in). Defaults to openApiPath for the spec URL.\n const reference = options.reference ?? false;\n if (reference !== false) {\n const refOpts = reference === true ? {} : reference;\n const settings = {\n path: refOpts.path ?? \"/reference\",\n title: refOpts.title ?? title,\n specUrl: refOpts.specUrl ?? openApiPath,\n };\n if (compiled)\n app.get(\n settings.path,\n htmlResponse(scalarDocsHTML(settings.specUrl, settings.title)),\n );\n else registerReferenceRoute(app, settings);\n }\n\n const services = options.services ?? getGlobalRegistry().list();\n\n // Precompute plans and freeze immutable plans across all services\n for (const service of services) {\n if (typeof (service as any).build === \"function\") {\n (service as any).build();\n }\n }\n\n // Raw endpoints declared via options or app.endpoint() (declaration order).\n const endpointDefs: EndpointDefinition[] = [];\n let endpointRevision = 0;\n\n // OpenAPI 3.1 & Interactive Documentation Endpoints\n if (enableDocs) {\n const buildSpec = () => {\n const spec = generateOpenApiSpec({\n title,\n version,\n description: options.description,\n prefix,\n services,\n });\n // Raw endpoints show up in the spec alongside the action mesh.\n return {\n ...spec,\n paths: { ...spec.paths, ...endpointPaths(endpointDefs) },\n };\n };\n app.get(\n openApiPath,\n compiled\n ? cachedJsonRoute(\n buildSpec,\n () =>\n [\n getGlobalRegistry(),\n getGlobalRegistry().revision + endpointRevision,\n ] as const,\n )\n : buildSpec,\n );\n\n if (compiled) {\n app.get(docsPath, htmlResponse(scalarDocsHTML(openApiPath, title)));\n app.get(swaggerPath, htmlResponse(swaggerDocsHTML(openApiPath, title)));\n } else {\n app.get(docsPath, ({ set }) => {\n set.headers[\"content-type\"] = \"text/html; charset=utf-8\";\n return scalarDocsHTML(openApiPath, title);\n });\n\n app.get(swaggerPath, ({ set }) => {\n set.headers[\"content-type\"] = \"text/html; charset=utf-8\";\n return swaggerDocsHTML(openApiPath, title);\n });\n }\n }\n\n // Dedicated Route Registry\n const registeredRoutes = new Set<string>();\n\n const mountRoute = (\n method: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\",\n path: string,\n handler: any,\n ) => {\n const routeKey = `${method} ${path}`;\n if (registeredRoutes.has(routeKey)) {\n return;\n }\n registeredRoutes.add(routeKey);\n\n switch (method) {\n case \"GET\":\n app.get(path, handler);\n break;\n case \"POST\":\n app.post(path, handler);\n break;\n case \"PUT\":\n app.put(path, handler);\n break;\n case \"PATCH\":\n app.patch(path, handler);\n break;\n case \"DELETE\":\n app.delete(path, handler);\n break;\n }\n };\n\n // Raw endpoints (outside the JSON action mesh).\n const mountEndpoint = (def: EndpointDefinition) => {\n endpointDefs.push(def);\n endpointRevision++;\n mountRoute(def.method, def.path, createEndpointHandler(def, services));\n };\n\n for (const def of options.endpoints ?? []) {\n mountEndpoint(def);\n }\n\n const brickApp = app as unknown as BrickApp;\n Object.defineProperty(brickApp, \"definition\", {\n value: Object.freeze({ services: Object.freeze([...services]), prefix }),\n });\n brickApp.endpoint = (def: EndpointDefinition) => {\n mountEndpoint(def);\n };\n brickApp.listEndpoints = () => [...endpointDefs];\n\n const compilation =\n options.compilation ??\n compileBrickApplication({\n services,\n prefix,\n mode: options.compiler === false ? \"generic\" : \"specialized\",\n });\n if (\n compilation.ir.prefix !== prefix ||\n JSON.stringify(compilation.ir.services) !==\n JSON.stringify(services.map((service) => service.name))\n ) {\n throw new Error(\n \"Brick compiler: server services/prefix differ from the bound compilation\",\n );\n }\n for (const route of compilation.routes)\n mountRoute(route.ir.method, route.ir.path, route.handler);\n\n return brickApp;\n}\n\nfunction htmlResponse(html: string): Response {\n return new Response(html, {\n headers: { \"content-type\": \"text/html; charset=utf-8\" },\n });\n}\n\n/** Reuse serialized JSON, without sharing a mutable response body between requests. */\nfunction cachedJsonRoute(\n build: () => unknown,\n revision: () => readonly [unknown, number],\n) {\n let [owner, version] = revision();\n let json = JSON.stringify(build());\n return ({ set }: { set: { headers: Record<string, unknown> } }) => {\n const [currentOwner, currentVersion] = revision();\n if (currentOwner !== owner || currentVersion !== version) {\n json = JSON.stringify(build());\n owner = currentOwner;\n version = currentVersion;\n }\n set.headers[\"content-type\"] = \"application/json;charset=utf-8\";\n return json;\n };\n}\n","import { existsSync } from \"fs\";\nimport { resolve } from \"path\";\nimport { getGlobalRegistry } from \"@brickkit/core\";\nimport { brick } from \"./server\";\n\nexport interface DevServerOptions {\n port?: number;\n entry?: string;\n prefix?: string;\n}\n\nexport async function startDevServer(options: DevServerOptions = {}) {\n const port = options.port ?? (Number(process.env.PORT) || 4000);\n const entry = options.entry;\n\n if (entry) {\n const resolvedEntry = resolve(process.cwd(), entry);\n if (existsSync(resolvedEntry)) {\n console.log(`[Brick-TS] Loading application entry: ${resolvedEntry}`);\n await import(resolvedEntry);\n } else {\n console.warn(`[Brick-TS] Specified entry not found: ${resolvedEntry}`);\n }\n }\n\n const registry = getGlobalRegistry();\n const services = registry.list();\n\n console.log(`\\n🧱 Brick-TS Development Server`);\n console.log(` Registered Services: ${services.length}`);\n\n for (const svc of services) {\n console.log(` • ${svc.name} (${svc.listActions().length} actions)`);\n if (typeof (svc as any).listResources === \"function\") {\n for (const res of (svc as any).listResources()) {\n console.log(\n ` -> Resource: /api/${res.name} (REST: GET, POST, /:id: GET, PATCH, DELETE)`,\n );\n }\n }\n for (const act of svc.listActions()) {\n console.log(` -> Action: /api/${svc.name}/${act.name}`);\n }\n }\n\n const app = brick({\n port,\n prefix: options.prefix,\n });\n\n app.listen(port);\n\n console.log(`\\n⚡ API Gateway running on: http://localhost:${port}`);\n console.log(`🩺 Health check: http://localhost:${port}/_health`);\n console.log(\n `🗺️ Architecture graph: http://localhost:${port}/_brick/services\\n`,\n );\n\n return app;\n}\n","import { mkdtemp, mkdir, rename, rm } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { getGlobalRegistry } from \"@brickkit/core\";\nimport { compileBrickApplication, emitCompiledApplication } from \"./compiler\";\n\nexport interface BuildApplicationOptions {\n /** A module that registers services, without starting a server. */\n entry: string;\n outdir?: string;\n prefix?: string;\n port?: number;\n requestLogging?: boolean;\n}\n\n/** Analyze definitions and bundle the emitted handlers with the user's callbacks. */\nexport async function buildApplication(options: BuildApplicationOptions) {\n const entry = resolve(options.entry);\n if (!(await Bun.file(entry).exists()))\n throw new Error(`Brick compiler: entry not found: ${entry}`);\n const outdir = resolve(options.outdir ?? \"dist/brick\");\n if (\n entry === join(outdir, \"server.js\") ||\n entry === join(outdir, \"routes.js\")\n )\n throw new Error(\n \"Brick compiler: output would overwrite the application entry\",\n );\n const port = options.port ?? 4000;\n if (!Number.isInteger(port) || port < 0 || port > 65535)\n throw new Error(\n \"Brick compiler: port must be an integer between 0 and 65535\",\n );\n await import(pathToFileURL(entry).href);\n const services = getGlobalRegistry().list();\n if (!services.length)\n throw new Error(\n \"Brick compiler: entry registered no services; use a definitions module\",\n );\n const compilation = compileBrickApplication({\n services,\n prefix: options.prefix,\n });\n await mkdir(dirname(outdir), { recursive: true });\n const staging = await mkdtemp(join(dirname(outdir), \".brick-build-\"));\n try {\n await Bun.write(\n join(staging, \"routes.js\"),\n emitCompiledApplication(compilation.ir),\n );\n const source = `import ${JSON.stringify(entry)};\nimport { brick } from \"@brickkit/cli\";\nimport { getGlobalRegistry } from \"@brickkit/core\";\nimport { bind } from \"./routes.js\";\nconst services = getGlobalRegistry().list();\nexport const app = brick({ services, compilation: bind(services), requestLogging: ${options.requestLogging ?? true} });\nif (import.meta.main) {\n const port = Number(process.env.PORT ?? ${port});\n if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error(\"Invalid PORT\");\n app.listen(port);\n console.log(\"Brick compiled server listening on http://localhost:\" + app.server.port);\n const stop = async () => { await app.stop(); process.exit(0); };\n process.once(\"SIGINT\", stop);\n process.once(\"SIGTERM\", stop);\n}\n`;\n await Bun.write(join(staging, \"entry.ts\"), source);\n const result = await Bun.build({\n entrypoints: [join(staging, \"entry.ts\")],\n target: \"bun\",\n format: \"esm\",\n outdir: staging,\n naming: \"server.js\",\n sourcemap: \"external\",\n });\n if (!result.success)\n throw new AggregateError(result.logs, \"Brick compiler: bundling failed\");\n await Bun.write(\n join(staging, \"brick-ir.json\"),\n JSON.stringify(compilation.ir, null, 2) + \"\\n\",\n );\n await mkdir(outdir, { recursive: true });\n for (const name of [\n \"routes.js\",\n \"brick-ir.json\",\n \"server.js.map\",\n \"server.js\",\n ])\n await rename(join(staging, name), join(outdir, name));\n return { outdir, entry: join(outdir, \"server.js\"), ir: compilation.ir };\n } finally {\n await rm(staging, { recursive: true, force: true });\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,168 @@
1
+ //#region src/client-contract.ts
2
+ /** Generate browser metadata and transport types from the app's selected services. */
3
+ function generateClientContract(app) {
4
+ const { services, prefix } = app.definition;
5
+ const contract = Object.create(null);
6
+ const types = Object.create(null);
7
+ const resourceActions = /* @__PURE__ */ new Set();
8
+ for (const service of services) addResources(service, prefix, contract, types, resourceActions);
9
+ for (const service of services) addServiceActions(service, prefix, contract, types, resourceActions);
10
+ return `// Generated by the Brick Vite plugin. Do not edit.
11
+ import type { BrickClientAction } from "@brickkit/core/client";
12
+
13
+ export type AppContract = ${namespaceType(types)};
14
+
15
+ export const contract: AppContract = JSON.parse(${JSON.stringify(JSON.stringify(contract))});
16
+ `;
17
+ }
18
+ function addResources(service, prefix, contract, types, resourceActions) {
19
+ for (const resource of service.listResources()) {
20
+ if (Object.hasOwn(contract, resource.name)) throw new Error(`Brick client: duplicate namespace '${resource.name}'`);
21
+ const node = Object.create(null);
22
+ const typeNode = Object.create(null);
23
+ contract[resource.name] = node;
24
+ types[resource.name] = typeNode;
25
+ const enabled = new Set(service.listActions());
26
+ for (const [operation, method, item] of [
27
+ [
28
+ "list",
29
+ "GET",
30
+ false
31
+ ],
32
+ [
33
+ "create",
34
+ "POST",
35
+ false
36
+ ],
37
+ [
38
+ "get",
39
+ "GET",
40
+ true
41
+ ],
42
+ [
43
+ "update",
44
+ "PATCH",
45
+ true
46
+ ],
47
+ [
48
+ "delete",
49
+ "DELETE",
50
+ true
51
+ ]
52
+ ]) {
53
+ const action = resource.actions[operation];
54
+ resourceActions.add(action);
55
+ if (!enabled.has(action)) continue;
56
+ const itemPath = item ? `/:${resource.idField}` : "";
57
+ const path = `${prefix}/${resource.name}${itemPath}`;
58
+ node[operation] = {
59
+ kind: "action",
60
+ name: action.name,
61
+ serviceName: service.name,
62
+ config: {
63
+ path,
64
+ method
65
+ }
66
+ };
67
+ typeNode[operation] = actionType(schemaType(action.config.input), schemaType(operation === "list" ? {
68
+ ...action.config.output,
69
+ required: [.../* @__PURE__ */ new Set([
70
+ ...action.config.output?.required ?? [],
71
+ "items",
72
+ "total",
73
+ "limit",
74
+ "offset",
75
+ "pageCount",
76
+ "hasMore",
77
+ "nextCursor"
78
+ ])]
79
+ } : action.config.output), action.config.errors);
80
+ }
81
+ }
82
+ }
83
+ function addServiceActions(service, prefix, contract, types, resourceActions) {
84
+ const namespace = contract[service.name] ?? Object.create(null);
85
+ const namespaceTypes = types[service.name] ?? Object.create(null);
86
+ contract[service.name] = namespace;
87
+ types[service.name] = namespaceTypes;
88
+ for (const action of service.listActions()) {
89
+ if (resourceActions.has(action)) continue;
90
+ const { input, output, errors, path, method } = action.config;
91
+ let inputType;
92
+ let outputType;
93
+ try {
94
+ inputType = input ? schemaType(input) : "unknown";
95
+ outputType = output ? schemaType(output) : "unknown";
96
+ } catch (error) {
97
+ throw new Error(`Brick client: cannot generate '${service.name}.${action.name}': ${error.message}`);
98
+ }
99
+ insertAction(namespace, namespaceTypes, {
100
+ kind: "action",
101
+ name: action.name,
102
+ serviceName: service.name,
103
+ config: {
104
+ path: path ?? `${prefix}/${service.name}/${action.name}`,
105
+ method: method ?? "POST"
106
+ }
107
+ }, actionType(inputType, outputType, errors));
108
+ }
109
+ }
110
+ function insertAction(node, typeNode, metadata, type) {
111
+ const segments = metadata.name.split(".");
112
+ for (const segment of segments.slice(0, -1)) {
113
+ if (Object.hasOwn(typeNode, segment) && typeof typeNode[segment] === "string") throw new Error(`Brick client: action namespace collision at '${metadata.serviceName}.${metadata.name}'`);
114
+ node[segment] ??= Object.create(null);
115
+ typeNode[segment] ??= Object.create(null);
116
+ node = node[segment];
117
+ typeNode = typeNode[segment];
118
+ }
119
+ const leaf = segments.at(-1);
120
+ if (Object.hasOwn(node, leaf)) throw new Error(`Brick client: action namespace collision at '${metadata.serviceName}.${metadata.name}'`);
121
+ node[leaf] = metadata;
122
+ typeNode[leaf] = type;
123
+ }
124
+ function actionType(input, output, errors) {
125
+ const codes = Object.keys(errors ?? {});
126
+ return `BrickClientAction<${input}, ${output}, ${codes.length ? `Record<${codes.map((code) => JSON.stringify(code)).join(" | ")}, { message: string; status?: number }>` : "{}"}>`;
127
+ }
128
+ function namespaceType(node) {
129
+ return `{\n${Object.entries(node).map(([key, value]) => ` ${JSON.stringify(key)}: ${typeof value === "string" ? value : namespaceType(value)};`).join("\n")}\n}`;
130
+ }
131
+ function schemaType(schema) {
132
+ if (schema === void 0) return "unknown";
133
+ if (schema === true) return "unknown";
134
+ if (schema === false || schema.not && !Object.keys(schema.not).length) return "never";
135
+ if (schema.$ref) throw new Error(`unresolved schema reference '${schema.$ref}'`);
136
+ if (Object.hasOwn(schema, "const")) return JSON.stringify(schema.const);
137
+ if (schema.enum) return schema.enum.map((value) => JSON.stringify(value)).join(" | ") || "never";
138
+ if (schema.anyOf || schema.oneOf) return `(${(schema.anyOf ?? schema.oneOf).map(schemaType).join(" | ")})`;
139
+ if (schema.allOf) return `(${schema.allOf.map(schemaType).join(" & ")})`;
140
+ switch (schema.type) {
141
+ case "string": return "string";
142
+ case "number":
143
+ case "integer": return "number";
144
+ case "boolean": return "boolean";
145
+ case "null": return "null";
146
+ case "undefined":
147
+ case "void": return "undefined";
148
+ case "array": return arraySchemaType(schema);
149
+ case "object": return objectSchemaType(schema);
150
+ case void 0: return "unknown";
151
+ default: throw new Error(`unsupported transport schema type '${schema.type}'`);
152
+ }
153
+ }
154
+ function arraySchemaType(schema) {
155
+ if (Array.isArray(schema.items)) return `[${schema.items.map(schemaType).join(", ")}]`;
156
+ return `Array<${schema.items ? schemaType(schema.items) : "unknown"}>`;
157
+ }
158
+ function objectSchemaType(schema) {
159
+ const object = `{ ${Object.entries(schema.properties ?? {}).map(([key, value]) => `${JSON.stringify(key)}${schema.required?.includes(key) ? "" : "?"}: ${schemaType(value)};`).join(" ")} }`;
160
+ const patterns = Object.values(schema.patternProperties ?? {});
161
+ if (patterns.length) return `${object} & Record<string, ${patterns.map(schemaType).join(" | ")}>`;
162
+ if (schema.additionalProperties) return `${object} & Record<string, ${schema.additionalProperties === true ? "unknown" : schemaType(schema.additionalProperties)}>`;
163
+ return object;
164
+ }
165
+ //#endregion
166
+ export { generateClientContract as t };
167
+
168
+ //# sourceMappingURL=client-contract.js.map