@brickkit/cli 0.3.0-beta.0 → 0.3.0-beta.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.
@@ -1 +1 @@
1
- {"version":3,"file":"client-contract.js","names":[],"sources":["../src/client-contract.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { Service } from \"@brickkit/core\";\nimport type { BrickClientAction } from \"@brickkit/core/client\";\nimport type { BrickApp } from \"./endpoints\";\n\n/** Generate browser metadata and transport types from the app's selected services. */\nexport function generateClientContract(app: BrickApp): string {\n const { services, prefix } = app.definition;\n const contract: Record<string, any> = Object.create(null);\n const types: Record<string, any> = Object.create(null);\n const resourceActions = new Set<unknown>();\n const schemas = new SchemaTypes();\n for (const service of services) {\n addResources(service, prefix, contract, types, resourceActions, schemas);\n }\n for (const service of services) {\n addServiceActions(\n service,\n prefix,\n contract,\n types,\n resourceActions,\n schemas,\n );\n }\n return `// Generated by the Brick Vite plugin. Do not edit.\nimport type { BrickClientAction } from \"@brickkit/core/client\";\n\n${schemas.renderContract(namespaceType(types))}\n\nexport const contract: AppContract = JSON.parse(${JSON.stringify(JSON.stringify(contract))});\n`;\n}\n\nfunction addResources(\n service: Service<any, any>,\n prefix: string,\n contract: Record<string, any>,\n types: Record<string, any>,\n resourceActions: Set<unknown>,\n schemas: SchemaTypes,\n) {\n for (const resource of service.listResources()) {\n if (Object.hasOwn(contract, resource.name))\n throw new Error(`Brick client: duplicate namespace '${resource.name}'`);\n const node: Record<string, any> = Object.create(null);\n const typeNode: Record<string, any> = Object.create(null);\n contract[resource.name] = node;\n types[resource.name] = typeNode;\n const enabled = new Set(service.listActions());\n for (const [operation, method, item] of [\n [\"list\", \"GET\", false],\n [\"create\", \"POST\", false],\n [\"get\", \"GET\", true],\n [\"update\", \"PATCH\", true],\n [\"delete\", \"DELETE\", true],\n ] as const) {\n const action = resource.actions[operation];\n resourceActions.add(action);\n if (!enabled.has(action)) continue;\n const itemPath = item ? `/:${resource.idField}` : \"\";\n const path = `${prefix}/${resource.name}${itemPath}`;\n node[operation] = {\n kind: \"action\",\n name: action.name,\n serviceName: service.name,\n config: { path, method },\n };\n const inputType = schemas.generate(action.config.input);\n // The runtime list result always includes these metadata fields.\n const outputSchema =\n operation === \"list\"\n ? {\n ...action.config.output,\n required: [\n ...new Set([\n ...(action.config.output?.required ?? []),\n \"items\",\n \"total\",\n \"limit\",\n \"offset\",\n \"pageCount\",\n \"hasMore\",\n \"nextCursor\",\n ]),\n ],\n }\n : action.config.output;\n typeNode[operation] = actionType(\n inputType,\n schemas.generate(outputSchema),\n action.config.errors,\n );\n }\n }\n}\n\nfunction addServiceActions(\n service: Service<any, any>,\n prefix: string,\n contract: Record<string, any>,\n types: Record<string, any>,\n resourceActions: Set<unknown>,\n schemas: SchemaTypes,\n) {\n const namespace: Record<string, any> =\n contract[service.name] ?? Object.create(null);\n const namespaceTypes: Record<string, any> =\n types[service.name] ?? Object.create(null);\n contract[service.name] = namespace;\n types[service.name] = namespaceTypes;\n for (const action of service.listActions()) {\n if (resourceActions.has(action)) continue;\n const { input, output, errors, path, method } = action.config;\n let inputType: string;\n let outputType: string;\n try {\n inputType = input ? schemas.generate(input) : \"unknown\";\n outputType = output ? schemas.generate(output) : \"unknown\";\n } catch (error) {\n throw new Error(\n `Brick client: cannot generate '${service.name}.${action.name}': ${(error as Error).message}`,\n );\n }\n const metadata: BrickClientAction = {\n kind: \"action\",\n name: action.name,\n serviceName: service.name,\n config: {\n path: path ?? `${prefix}/${service.name}/${action.name}`,\n method: method ?? \"POST\",\n },\n };\n insertAction(\n namespace,\n namespaceTypes,\n metadata,\n actionType(inputType, outputType, errors),\n );\n }\n}\n\nfunction insertAction(\n node: Record<string, any>,\n typeNode: Record<string, any>,\n metadata: BrickClientAction,\n type: string,\n) {\n const segments = metadata.name.split(\".\");\n for (const segment of segments.slice(0, -1)) {\n if (\n Object.hasOwn(typeNode, segment) &&\n typeof typeNode[segment] === \"string\"\n ) {\n throw new Error(\n `Brick client: action namespace collision at '${metadata.serviceName}.${metadata.name}'`,\n );\n }\n node[segment] ??= Object.create(null);\n typeNode[segment] ??= Object.create(null);\n node = node[segment];\n typeNode = typeNode[segment];\n }\n const leaf = segments.at(-1)!;\n if (Object.hasOwn(node, leaf))\n throw new Error(\n `Brick client: action namespace collision at '${metadata.serviceName}.${metadata.name}'`,\n );\n node[leaf] = metadata;\n typeNode[leaf] = type;\n}\n\nfunction actionType(\n input: string,\n output: string,\n errors: Record<string, unknown> | undefined,\n): string {\n const codes = Object.keys(errors ?? {});\n const errorsType = codes.length\n ? `Record<${codes.map((code) => JSON.stringify(code)).join(\" | \")}, { message: string; status?: number }>`\n : \"{}\";\n return `BrickClientAction<${input}, ${output}, ${errorsType}>`;\n}\n\nfunction namespaceType(node: Record<string, any>): string {\n return `{\\n${Object.entries(node)\n .map(\n ([key, value]) =>\n ` ${JSON.stringify(key)}: ${typeof value === \"string\" ? value : namespaceType(value)};`,\n )\n .join(\"\\n\")}\\n}`;\n}\n\n// Emit transport types from schemas, rather than importing backend callbacks or databases.\nclass SchemaTypes {\n private readonly aliases = new Map<string, string>();\n private readonly names = new Set([\n \"AppContract\",\n \"BrickClientAction\",\n \"contract\",\n ]);\n\n // Internal tokens cannot occur in JSON-escaped property names or literals.\n private readonly fragments: { body: string; size: number; hash: string }[] =\n [];\n private readonly fragmentIds = new Map<string, number>();\n\n private fragment(body: string): string {\n let id = this.fragmentIds.get(body);\n if (id === undefined) {\n id = this.fragments.length;\n const size =\n body.replace(/\\0(\\d+)\\0/g, \"\").length +\n [...body.matchAll(/\\0(\\d+)\\0/g)].reduce(\n (total, match) => total + this.fragments[Number(match[1])]!.size,\n 0,\n );\n const shape = body.replace(\n /\\0(\\d+)\\0/g,\n (_, child) => this.fragments[Number(child)]!.hash,\n );\n const hash = createHash(\"sha256\").update(shape).digest(\"hex\");\n this.fragments.push({ body, size, hash });\n this.fragmentIds.set(body, id);\n }\n return `\\0${id}\\0`;\n }\n\n renderContract(contract: string): string {\n const uses = this.fragments.map(() => 0);\n const count = (body: string, multiplier: number) => {\n for (const match of body.matchAll(/\\0(\\d+)\\0/g))\n uses[Number(match[1])]! += multiplier;\n };\n count(contract, 1);\n for (const body of this.aliases.values()) count(body, 1);\n const shared = new Map<number, string>();\n // Parents are interned after their children. Once a parent is shared, its\n // children occur only once in its declaration, avoiding overlapping savings.\n for (let id = this.fragments.length - 1; id >= 0; id--) {\n const { body, size, hash } = this.fragments[id]!;\n const nameBase = `BrickSchema_${hash.slice(0, 12)}`;\n let name = nameBase;\n let suffix = 2;\n while (this.names.has(name)) name = `${nameBase}_${suffix++}`;\n const declarationCost = `export type ${name} = ;\\n\\n`.length;\n if (\n uses[id]! > 1 &&\n (uses[id]! - 1) * size > uses[id]! * name.length + declarationCost\n ) {\n this.names.add(name);\n shared.set(id, name);\n }\n count(body, shared.has(id) ? 1 : uses[id]!);\n }\n const rendered: string[] = [];\n const declarations: string[] = [];\n for (let id = 0; id < this.fragments.length; id++) {\n const body = this.fragments[id]!.body.replace(\n /\\0(\\d+)\\0/g,\n (_, child) => rendered[Number(child)]!,\n );\n const name = shared.get(id);\n // Child aliases can make a parent too small to justify sharing it.\n if (\n name &&\n (uses[id]! - 1) * body.length >\n uses[id]! * name.length + `export type ${name} = ;\\n\\n`.length\n ) {\n declarations.push(`export type ${name} = ${body};\\n\\n`);\n rendered.push(name);\n } else rendered.push(body);\n }\n const render = (body: string) =>\n body.replace(/\\0(\\d+)\\0/g, (_, id) => rendered[Number(id)]!);\n return (\n declarations.join(\"\") +\n [...this.aliases]\n .map(([name, type]) => `export type ${name} = ${render(type)};\\n\\n`)\n .join(\"\") +\n `export type AppContract = ${render(contract)};`\n );\n }\n\n generate(root: any): string {\n // IDs belong to this schema document. Separate actions may reuse the same ID.\n const ids = new Map<string, any>();\n const references: { ref: string; base: any }[] = [];\n const resources = new Map<unknown, any>();\n const active = new Set<unknown>();\n const visit = (schema: any, base: any) => {\n if (!schema || typeof schema !== \"object\" || active.has(schema)) return;\n const currentBase =\n typeof schema.$id === \"string\" && schema.$id ? schema : base;\n if (!resources.has(schema)) resources.set(schema, currentBase);\n if (typeof schema.$ref === \"string\")\n references.push({ ref: schema.$ref, base: currentBase });\n active.add(schema);\n try {\n if (typeof schema.$id === \"string\" && schema.$id)\n ids.set(schema.$id, schema);\n for (const key of [\n \"properties\",\n \"patternProperties\",\n \"$defs\",\n \"definitions\",\n ]) {\n for (const child of Object.values(schema[key] ?? {}))\n visit(child, currentBase);\n }\n for (const key of [\"anyOf\", \"oneOf\", \"allOf\", \"prefixItems\"]) {\n for (const child of schema[key] ?? []) visit(child, currentBase);\n }\n for (const key of [\"items\", \"additionalProperties\", \"not\"]) {\n if (Array.isArray(schema[key]))\n schema[key].forEach((child: any) => visit(child, currentBase));\n else visit(schema[key], currentBase);\n }\n } finally {\n active.delete(schema);\n }\n };\n visit(root, root);\n\n const resolve = (reference: string, base: any): any => {\n const hashIndex = reference.indexOf(\"#\");\n const id = hashIndex === -1 ? reference : reference.slice(0, hashIndex);\n const fragment =\n hashIndex === -1 ? undefined : reference.slice(hashIndex + 1);\n let target = id ? ids.get(id) : base;\n if (fragment) {\n if (!fragment.startsWith(\"/\")) return undefined;\n try {\n for (const part of decodeURIComponent(fragment).slice(1).split(\"/\")) {\n const key = part.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\");\n if (!target || !Object.hasOwn(target, key)) return undefined;\n target = target[key];\n }\n } catch {\n return undefined;\n }\n }\n return typeof target === \"boolean\" ||\n (target && typeof target === \"object\")\n ? target\n : undefined;\n };\n const targets = new Set(\n references\n .map(({ ref, base }) => resolve(ref, base))\n .filter((value) => value !== undefined),\n );\n const names = new Map<any, string>();\n const emit = (schema: any, inline = false, base: any = root): string => {\n const body = emitInline(schema, inline, base);\n // References already have document-scoped aliases; scalars stay inline.\n if (\n schema &&\n !schema.$ref &&\n !Object.hasOwn(schema, \"const\") &&\n (schema.anyOf ||\n schema.oneOf ||\n schema.allOf ||\n schema.enum?.length > 1 ||\n schema.type === \"array\" ||\n schema.type === \"object\")\n )\n return this.fragment(body);\n return body;\n };\n const emitInline = (schema: any, inline: boolean, base: any): string => {\n if (schema === undefined || schema === true) return \"unknown\";\n if (schema === false || (schema.not && !Object.keys(schema.not).length))\n return \"never\";\n const currentBase =\n schema &&\n typeof schema === \"object\" &&\n typeof schema.$id === \"string\" &&\n schema.$id\n ? schema\n : base;\n if (!inline && targets.has(schema)) {\n const existing = names.get(schema);\n if (existing) return existing;\n // Titles provide readable names; generated TypeBox IDs remain usable fallbacks.\n const hint = schema.title ?? schema.$id ?? \"Schema\";\n let nameBase = String(hint).replace(/[^a-zA-Z0-9_$]/g, \"_\");\n if (!/^[a-zA-Z_$]/.test(nameBase)) nameBase = `Schema_${nameBase}`;\n nameBase = `Brick${nameBase}`;\n let name = nameBase;\n let suffix = 2;\n while (this.names.has(name)) {\n name = `${nameBase}_${suffix}`;\n suffix += 1;\n }\n this.names.add(name);\n names.set(schema, name);\n // names is reserved before the body is rendered, so recursive refs terminate.\n this.aliases.set(name, emit(schema, true, currentBase));\n return name;\n }\n if (schema.$ref) {\n const target = resolve(schema.$ref, currentBase);\n if (target === undefined)\n throw new Error(`unresolved schema reference '${schema.$ref}'`);\n const targetBase =\n target && typeof target === \"object\"\n ? (resources.get(target) ?? root)\n : currentBase;\n return emit(target, false, targetBase);\n }\n if (Object.hasOwn(schema, \"const\")) return JSON.stringify(schema.const);\n if (schema.enum)\n return (\n schema.enum\n .map((value: unknown) => JSON.stringify(value))\n .join(\" | \") || \"never\"\n );\n if (schema.anyOf || schema.oneOf)\n return `(${(schema.anyOf ?? schema.oneOf).map((child: any) => emit(child, false, currentBase)).join(\" | \")})`;\n if (schema.allOf)\n return `(${schema.allOf.map((child: any) => emit(child, false, currentBase)).join(\" & \")})`;\n switch (schema.type) {\n case \"string\":\n return \"string\";\n case \"number\":\n case \"integer\":\n return \"number\";\n case \"boolean\":\n return \"boolean\";\n case \"null\":\n return \"null\";\n case \"undefined\":\n case \"void\":\n return \"undefined\";\n case \"array\":\n if (Array.isArray(schema.items))\n return `[${schema.items.map((child: any) => emit(child, false, currentBase)).join(\", \")}]`;\n return `Array<${emit(schema.items, false, currentBase)}>`;\n case \"object\": {\n const entries = Object.entries(schema.properties ?? {});\n const properties = entries.map(\n ([key, value]) =>\n `${JSON.stringify(key)}${schema.required?.includes(key) ? \"\" : \"?\"}: ${emit(value, false, currentBase)};`,\n );\n // additionalProperties applies to keys matched by neither properties\n // nor patternProperties, so union it instead of discarding it.\n const indexParts = Object.values(schema.patternProperties ?? {}).map(\n (child) => emit(child, false, currentBase),\n );\n if (schema.additionalProperties) {\n indexParts.push(\n emit(schema.additionalProperties, false, currentBase),\n );\n }\n let indexType: string | undefined;\n if (indexParts.length) {\n // TS index signatures must also cover declared keys, so widen\n // with their types; otherwise the intersection below rejects\n // valid values. Over-approximating is safe: the server validates.\n for (const [, value] of entries) {\n const propType = emit(value, false, currentBase);\n if (!indexParts.includes(propType)) indexParts.push(propType);\n }\n indexType = indexParts.join(\" | \");\n }\n const object = `{ ${properties.join(\" \")} }`;\n if (indexType) {\n const index = `{ [key: string]: ${indexType} }`;\n return properties.length ? `${object} & ${index}` : index;\n }\n return object;\n }\n case undefined:\n return \"unknown\";\n default:\n throw new Error(`unsupported transport schema type '${schema.type}'`);\n }\n };\n return emit(root);\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"client-contract.js","names":[],"sources":["../src/client-contract.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { getPluginActionRoute, type Service } from \"@brickkit/core\";\nimport type { BrickClientAction } from \"@brickkit/core/client\";\nimport type { BrickApp } from \"./endpoints\";\n\n/** Generate browser metadata and transport types from the app's selected services. */\nexport function generateClientContract(app: BrickApp): string {\n const { services, prefix } = app.definition;\n const contract: Record<string, any> = Object.create(null);\n const types: Record<string, any> = Object.create(null);\n const schemas = new SchemaTypes();\n for (const service of services) {\n addServiceActions(service, prefix, contract, types, schemas);\n }\n return `// Generated by the Brick Vite plugin. Do not edit.\nimport type { BrickClientAction } from \"@brickkit/core/client\";\n\n${schemas.renderContract(namespaceType(types))}\n\nexport const contract: AppContract = JSON.parse(${JSON.stringify(JSON.stringify(contract))});\n`;\n}\n\nfunction addServiceActions(\n service: Service<any, any>,\n prefix: string,\n contract: Record<string, any>,\n types: Record<string, any>,\n schemas: SchemaTypes,\n) {\n const namespace: Record<string, any> =\n contract[service.name] ?? Object.create(null);\n const namespaceTypes: Record<string, any> =\n types[service.name] ?? Object.create(null);\n contract[service.name] = namespace;\n types[service.name] = namespaceTypes;\n for (const action of service.listActions()) {\n const pluginRoute = getPluginActionRoute(action, prefix);\n if (pluginRoute === false) continue;\n const { input, output, errors, path, method } = action.config;\n let inputType: string;\n let outputType: string;\n try {\n inputType = input ? schemas.generate(input) : \"unknown\";\n outputType = output ? schemas.generate(output) : \"unknown\";\n } catch (error) {\n throw new Error(\n `Brick client: cannot generate '${service.name}.${action.name}': ${(error as Error).message}`,\n );\n }\n const metadata: BrickClientAction = {\n kind: \"action\",\n name: action.name,\n serviceName: service.name,\n config: {\n path:\n pluginRoute?.path ??\n path ??\n `${prefix}/${service.name}/${action.name}`,\n method: pluginRoute?.method ?? method ?? \"POST\",\n },\n };\n insertAction(\n pluginRoute?.clientPath ? contract : namespace,\n pluginRoute?.clientPath ? types : namespaceTypes,\n metadata,\n actionType(inputType, outputType, errors),\n pluginRoute?.clientPath,\n );\n }\n}\n\nfunction insertAction(\n node: Record<string, any>,\n typeNode: Record<string, any>,\n metadata: BrickClientAction,\n type: string,\n clientPath?: readonly string[],\n) {\n const segments = clientPath ?? metadata.name.split(\".\");\n for (const segment of segments.slice(0, -1)) {\n if (\n Object.hasOwn(typeNode, segment) &&\n typeof typeNode[segment] === \"string\"\n ) {\n throw new Error(\n `Brick client: action namespace collision at '${metadata.serviceName}.${metadata.name}'`,\n );\n }\n node[segment] ??= Object.create(null);\n typeNode[segment] ??= Object.create(null);\n node = node[segment];\n typeNode = typeNode[segment];\n }\n const leaf = segments.at(-1)!;\n if (Object.hasOwn(node, leaf))\n throw new Error(\n `Brick client: action namespace collision at '${metadata.serviceName}.${metadata.name}'`,\n );\n node[leaf] = metadata;\n typeNode[leaf] = type;\n}\n\nfunction actionType(\n input: string,\n output: string,\n errors: Record<string, unknown> | undefined,\n): string {\n const codes = Object.keys(errors ?? {});\n const errorsType = codes.length\n ? `Record<${codes.map((code) => JSON.stringify(code)).join(\" | \")}, { message: string; status?: number }>`\n : \"{}\";\n return `BrickClientAction<${input}, ${output}, ${errorsType}>`;\n}\n\nfunction namespaceType(node: Record<string, any>): string {\n return `{\\n${Object.entries(node)\n .map(\n ([key, value]) =>\n ` ${JSON.stringify(key)}: ${typeof value === \"string\" ? value : namespaceType(value)};`,\n )\n .join(\"\\n\")}\\n}`;\n}\n\n// Emit transport types from schemas, rather than importing backend callbacks or databases.\nclass SchemaTypes {\n private readonly aliases = new Map<string, string>();\n private readonly names = new Set([\n \"AppContract\",\n \"BrickClientAction\",\n \"contract\",\n ]);\n\n // Internal tokens cannot occur in JSON-escaped property names or literals.\n private readonly fragments: { body: string; size: number; hash: string }[] =\n [];\n private readonly fragmentIds = new Map<string, number>();\n\n private fragment(body: string): string {\n let id = this.fragmentIds.get(body);\n if (id === undefined) {\n id = this.fragments.length;\n const size =\n body.replace(/\\0(\\d+)\\0/g, \"\").length +\n [...body.matchAll(/\\0(\\d+)\\0/g)].reduce(\n (total, match) => total + this.fragments[Number(match[1])]!.size,\n 0,\n );\n const shape = body.replace(\n /\\0(\\d+)\\0/g,\n (_, child) => this.fragments[Number(child)]!.hash,\n );\n const hash = createHash(\"sha256\").update(shape).digest(\"hex\");\n this.fragments.push({ body, size, hash });\n this.fragmentIds.set(body, id);\n }\n return `\\0${id}\\0`;\n }\n\n renderContract(contract: string): string {\n const uses = this.fragments.map(() => 0);\n const count = (body: string, multiplier: number) => {\n for (const match of body.matchAll(/\\0(\\d+)\\0/g))\n uses[Number(match[1])]! += multiplier;\n };\n count(contract, 1);\n for (const body of this.aliases.values()) count(body, 1);\n const shared = new Map<number, string>();\n // Parents are interned after their children. Once a parent is shared, its\n // children occur only once in its declaration, avoiding overlapping savings.\n for (let id = this.fragments.length - 1; id >= 0; id--) {\n const { body, size, hash } = this.fragments[id]!;\n const nameBase = `BrickSchema_${hash.slice(0, 12)}`;\n let name = nameBase;\n let suffix = 2;\n while (this.names.has(name)) name = `${nameBase}_${suffix++}`;\n const declarationCost = `export type ${name} = ;\\n\\n`.length;\n if (\n uses[id]! > 1 &&\n (uses[id]! - 1) * size > uses[id]! * name.length + declarationCost\n ) {\n this.names.add(name);\n shared.set(id, name);\n }\n count(body, shared.has(id) ? 1 : uses[id]!);\n }\n const rendered: string[] = [];\n const declarations: string[] = [];\n for (let id = 0; id < this.fragments.length; id++) {\n const body = this.fragments[id]!.body.replace(\n /\\0(\\d+)\\0/g,\n (_, child) => rendered[Number(child)]!,\n );\n const name = shared.get(id);\n // Child aliases can make a parent too small to justify sharing it.\n if (\n name &&\n (uses[id]! - 1) * body.length >\n uses[id]! * name.length + `export type ${name} = ;\\n\\n`.length\n ) {\n declarations.push(`export type ${name} = ${body};\\n\\n`);\n rendered.push(name);\n } else rendered.push(body);\n }\n const render = (body: string) =>\n body.replace(/\\0(\\d+)\\0/g, (_, id) => rendered[Number(id)]!);\n return (\n declarations.join(\"\") +\n [...this.aliases]\n .map(([name, type]) => `export type ${name} = ${render(type)};\\n\\n`)\n .join(\"\") +\n `export type AppContract = ${render(contract)};`\n );\n }\n\n generate(root: any): string {\n // IDs belong to this schema document. Separate actions may reuse the same ID.\n const ids = new Map<string, any>();\n const references: { ref: string; base: any }[] = [];\n const resources = new Map<unknown, any>();\n const active = new Set<unknown>();\n const visit = (schema: any, base: any) => {\n if (!schema || typeof schema !== \"object\" || active.has(schema)) return;\n const currentBase =\n typeof schema.$id === \"string\" && schema.$id ? schema : base;\n if (!resources.has(schema)) resources.set(schema, currentBase);\n if (typeof schema.$ref === \"string\")\n references.push({ ref: schema.$ref, base: currentBase });\n active.add(schema);\n try {\n if (typeof schema.$id === \"string\" && schema.$id)\n ids.set(schema.$id, schema);\n for (const key of [\n \"properties\",\n \"patternProperties\",\n \"$defs\",\n \"definitions\",\n ]) {\n for (const child of Object.values(schema[key] ?? {}))\n visit(child, currentBase);\n }\n for (const key of [\"anyOf\", \"oneOf\", \"allOf\", \"prefixItems\"]) {\n for (const child of schema[key] ?? []) visit(child, currentBase);\n }\n for (const key of [\"items\", \"additionalProperties\", \"not\"]) {\n if (Array.isArray(schema[key]))\n schema[key].forEach((child: any) => visit(child, currentBase));\n else visit(schema[key], currentBase);\n }\n } finally {\n active.delete(schema);\n }\n };\n visit(root, root);\n\n const resolve = (reference: string, base: any): any => {\n const hashIndex = reference.indexOf(\"#\");\n const id = hashIndex === -1 ? reference : reference.slice(0, hashIndex);\n const fragment =\n hashIndex === -1 ? undefined : reference.slice(hashIndex + 1);\n let target = id ? ids.get(id) : base;\n if (fragment) {\n if (!fragment.startsWith(\"/\")) return undefined;\n try {\n for (const part of decodeURIComponent(fragment).slice(1).split(\"/\")) {\n const key = part.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\");\n if (!target || !Object.hasOwn(target, key)) return undefined;\n target = target[key];\n }\n } catch {\n return undefined;\n }\n }\n return typeof target === \"boolean\" ||\n (target && typeof target === \"object\")\n ? target\n : undefined;\n };\n const targets = new Set(\n references\n .map(({ ref, base }) => resolve(ref, base))\n .filter((value) => value !== undefined),\n );\n const names = new Map<any, string>();\n const emit = (schema: any, inline = false, base: any = root): string => {\n const body = emitInline(schema, inline, base);\n // References already have document-scoped aliases; scalars stay inline.\n if (\n schema &&\n !schema.$ref &&\n !Object.hasOwn(schema, \"const\") &&\n (schema.anyOf ||\n schema.oneOf ||\n schema.allOf ||\n schema.enum?.length > 1 ||\n schema.type === \"array\" ||\n schema.type === \"object\")\n )\n return this.fragment(body);\n return body;\n };\n const emitInline = (schema: any, inline: boolean, base: any): string => {\n if (schema === undefined || schema === true) return \"unknown\";\n if (schema === false || (schema.not && !Object.keys(schema.not).length))\n return \"never\";\n const currentBase =\n schema &&\n typeof schema === \"object\" &&\n typeof schema.$id === \"string\" &&\n schema.$id\n ? schema\n : base;\n if (!inline && targets.has(schema)) {\n const existing = names.get(schema);\n if (existing) return existing;\n // Titles provide readable names; generated TypeBox IDs remain usable fallbacks.\n const hint = schema.title ?? schema.$id ?? \"Schema\";\n let nameBase = String(hint).replace(/[^a-zA-Z0-9_$]/g, \"_\");\n if (!/^[a-zA-Z_$]/.test(nameBase)) nameBase = `Schema_${nameBase}`;\n nameBase = `Brick${nameBase}`;\n let name = nameBase;\n let suffix = 2;\n while (this.names.has(name)) {\n name = `${nameBase}_${suffix}`;\n suffix += 1;\n }\n this.names.add(name);\n names.set(schema, name);\n // names is reserved before the body is rendered, so recursive refs terminate.\n this.aliases.set(name, emit(schema, true, currentBase));\n return name;\n }\n if (schema.$ref) {\n const target = resolve(schema.$ref, currentBase);\n if (target === undefined)\n throw new Error(`unresolved schema reference '${schema.$ref}'`);\n const targetBase =\n target && typeof target === \"object\"\n ? (resources.get(target) ?? root)\n : currentBase;\n return emit(target, false, targetBase);\n }\n if (Object.hasOwn(schema, \"const\")) return JSON.stringify(schema.const);\n if (schema.enum)\n return (\n schema.enum\n .map((value: unknown) => JSON.stringify(value))\n .join(\" | \") || \"never\"\n );\n if (schema.anyOf || schema.oneOf)\n return `(${(schema.anyOf ?? schema.oneOf).map((child: any) => emit(child, false, currentBase)).join(\" | \")})`;\n if (schema.allOf)\n return `(${schema.allOf.map((child: any) => emit(child, false, currentBase)).join(\" & \")})`;\n switch (schema.type) {\n case \"string\":\n return \"string\";\n case \"number\":\n case \"integer\":\n return \"number\";\n case \"boolean\":\n return \"boolean\";\n case \"null\":\n return \"null\";\n case \"undefined\":\n case \"void\":\n return \"undefined\";\n case \"array\":\n if (Array.isArray(schema.items))\n return `[${schema.items.map((child: any) => emit(child, false, currentBase)).join(\", \")}]`;\n return `Array<${emit(schema.items, false, currentBase)}>`;\n case \"object\": {\n const entries = Object.entries(schema.properties ?? {});\n const properties = entries.map(\n ([key, value]) =>\n `${JSON.stringify(key)}${schema.required?.includes(key) ? \"\" : \"?\"}: ${emit(value, false, currentBase)};`,\n );\n // additionalProperties applies to keys matched by neither properties\n // nor patternProperties, so union it instead of discarding it.\n const indexParts = Object.values(schema.patternProperties ?? {}).map(\n (child) => emit(child, false, currentBase),\n );\n if (schema.additionalProperties) {\n indexParts.push(\n emit(schema.additionalProperties, false, currentBase),\n );\n }\n let indexType: string | undefined;\n if (indexParts.length) {\n // TS index signatures must also cover declared keys, so widen\n // with their types; otherwise the intersection below rejects\n // valid values. Over-approximating is safe: the server validates.\n for (const [, value] of entries) {\n const propType = emit(value, false, currentBase);\n if (!indexParts.includes(propType)) indexParts.push(propType);\n }\n indexType = indexParts.join(\" | \");\n }\n const object = `{ ${properties.join(\" \")} }`;\n if (indexType) {\n const index = `{ [key: string]: ${indexType} }`;\n return properties.length ? `${object} & ${index}` : index;\n }\n return object;\n }\n case undefined:\n return \"unknown\";\n default:\n throw new Error(`unsupported transport schema type '${schema.type}'`);\n }\n };\n return emit(root);\n }\n}\n"],"mappings":"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"}
@@ -1,4 +1,58 @@
1
- import { CompiledRoutePlan, ResourceReadQueries, Service } from "@brickkit/core";
1
+ import { Elysia } from "elysia";
2
+ import { CompiledRoutePlan, DatabaseHandle, Service } from "@brickkit/core";
3
+ //#region src/endpoints.d.ts
4
+ type EndpointMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
5
+ /** Logger subset handed to endpoint handlers (mirrors action context loggers). */
6
+ interface EndpointLogger {
7
+ info: (...args: any[]) => void;
8
+ warn: (...args: any[]) => void;
9
+ error: (...args: any[]) => void;
10
+ debug: (...args: any[]) => void;
11
+ }
12
+ /** Context for raw endpoint handlers: Elysia route fields + Brick extras. */
13
+ interface EndpointContext {
14
+ params: Record<string, string>;
15
+ query: Record<string, string | undefined>;
16
+ body: unknown;
17
+ headers: Record<string, string>;
18
+ request: Request;
19
+ /** Elysia response setter (status/headers). Mutate like in `app.get`. */
20
+ set: {
21
+ status?: number;
22
+ headers: Record<string, string>;
23
+ };
24
+ /** Drizzle db from `service` (or first service with one); `undefined` when none. */
25
+ db: any;
26
+ logger: EndpointLogger;
27
+ traceId: string;
28
+ requestId: string;
29
+ }
30
+ interface EndpointDefinition {
31
+ method: EndpointMethod;
32
+ /** Elysia-style path, e.g. `/p/:slug`. */
33
+ path: string;
34
+ handler: (ctx: EndpointContext) => unknown | Promise<unknown>;
35
+ /** Db source: instance or registered service name. Defaults to first service with a db. */
36
+ service?: Service<any, any> | string;
37
+ /** Explicit database handle, independent of a service. */
38
+ database?: DatabaseHandle<unknown>;
39
+ summary?: string;
40
+ description?: string;
41
+ tags?: string[];
42
+ }
43
+ /** The app object returned by `brick`: Elysia plus `endpoint()`. */
44
+ type BrickApp = Elysia<any, any, any, any, any, any, any> & {
45
+ /** Service definitions and prefix selected when this app was constructed. */
46
+ readonly definition: {
47
+ readonly services: readonly Service<any, any>[];
48
+ readonly prefix: string;
49
+ };
50
+ /** Register a raw endpoint (outside the JSON action mesh). */
51
+ endpoint(def: EndpointDefinition): void;
52
+ /** All endpoints registered via `endpoint()` (declaration order). */
53
+ listEndpoints(): EndpointDefinition[];
54
+ };
55
+ //#endregion
2
56
  //#region src/compiler/ir.d.ts
3
57
  type RouteMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
4
58
  interface RouteIR {
@@ -6,7 +60,7 @@ interface RouteIR {
6
60
  readonly path: string;
7
61
  readonly service: string;
8
62
  readonly action: string;
9
- readonly kind: "action" | "resource";
63
+ readonly kind: "action";
10
64
  readonly input: boolean;
11
65
  readonly output: boolean;
12
66
  readonly context: boolean;
@@ -26,7 +80,11 @@ interface BrickIR {
26
80
  readonly prefix: string;
27
81
  readonly services: readonly string[];
28
82
  readonly routes: readonly RouteIR[];
29
- readonly reads: readonly ResourceReadQueries[];
83
+ readonly preparations: readonly {
84
+ service: string;
85
+ name: string;
86
+ metadata: unknown;
87
+ }[];
30
88
  readonly diagnostics: readonly string[];
31
89
  }
32
90
  //#endregion
@@ -70,6 +128,11 @@ declare function emitHandlerFactory(route: RouteIR): string;
70
128
  declare function emitCompiledApplication(ir: BrickIR, runtimeImport?: string): string;
71
129
  //#endregion
72
130
  //#region src/compiler.d.ts
131
+ type ApplicationBinder = (services: Service<any, any>[]) => CompiledApplication;
132
+ /** Build artifact bootstrap: bind generated handlers while evaluating the original app. */
133
+ declare function loadCompiledBrickApp(load: () => Promise<{
134
+ default: unknown;
135
+ }>, ir: BrickIR, bind: ApplicationBinder): Promise<BrickApp>;
73
136
  interface CompiledRoute {
74
137
  readonly ir: RouteIR;
75
138
  readonly handler: CompiledHandler;
@@ -87,5 +150,5 @@ declare function compileBrickApplication(options: {
87
150
  /** Build artifact binder: consumes emitted functions, with no runtime handler code generation. */
88
151
  declare function bindCompiledApplication(ir: BrickIR, services: Service<any, any>[], factories: readonly HandlerFactory[]): CompiledApplication;
89
152
  //#endregion
90
- export { emitCompiledApplication as a, HandlerFactory as c, RouteMethod as d, compileBrickApplication as i, BrickIR as l, CompiledRoute as n, emitHandlerFactory as o, bindCompiledApplication as r, CompiledHandler as s, CompiledApplication as t, RouteIR as u };
153
+ export { EndpointMethod as _, loadCompiledBrickApp as a, CompiledHandler as c, RouteIR as d, RouteMethod as f, EndpointLogger as g, EndpointDefinition as h, compileBrickApplication as i, HandlerFactory as l, EndpointContext as m, CompiledRoute as n, emitCompiledApplication as o, BrickApp as p, bindCompiledApplication as r, emitHandlerFactory as s, CompiledApplication as t, BrickIR as u };
91
154
  //# sourceMappingURL=compiler.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"compiler.d.ts","names":[],"sources":["../src/compiler/ir.ts","../src/compiler/runtime.ts","../src/compiler/emit.ts","../src/compiler.ts"],"mappings":";;KAOY;UACK;WACN,QAAQ;WACR;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;aACE;aACA;;;WAGF;WACA;;UAEM;WACN;WACA;WACA;WACA;WACA,iBAAiB;WACjB,gBAAgB;WAChB;;;;KC5BC,mBAAmB,2BAA2B;KAC9C,kBACV,SAAS,mBACT,gBAAgB,oBACb;;iBAaI,WAAW,YAAY,aAAa;iBAWpC,SACP,OAAO,YAAY,oCACnB,gBACA,gBACA;iBAeO,SAAS,UAAU;;;;;;;;;;;;;;;;cAaf,iBAAe;;;;;;;EAON,aAAA;EAEL,OAAA;;;;;iBCxED,mBAAmB,OAAO;;iBA0E1B,wBACd,IAAI,SACJ;;;UCzDe;WACN,IAAI;WACJ,SAAS;;UAEH;WACN,IAAI;WACJ,iBAAiB;;;iBAsBZ,wBAAwB;EACtC,UAAU;EACV;EACA;IACE;;iBAsBY,wBACd,IAAI,SACJ,UAAU,qBACV,oBAAoB,mBACnB"}
1
+ {"version":3,"file":"compiler.d.ts","names":["_$__endpoints0.BrickApp"],"sources":["../src/endpoints.ts","../src/compiler/ir.ts","../src/compiler/runtime.ts","../src/compiler/emit.ts","../src/compiler.ts"],"mappings":";;;KAIY;;UAGK;EACf,UAAU;EACV,UAAU;EACV,WAAW;EACX,WAAW;;;UAII;EACf,QAAQ;EACR,OAAO;EACP;EACA,SAAS;EACT,SAAS;;EAET;IAAO;IAAiB,SAAS;;;EAEjC;EACA,QAAQ;EACR;EACA;;UAGe;EACf,QAAQ;;EAER;EACA,UAAU,KAAK,8BAA8B;;EAE7C,UAAU;;EAEV,WAAW;EACX;EACA;EACA;;;KA6HU,WAAW;;WAEZ;aACE,mBAAmB;aACnB;;;EAGX,SAAS,KAAK;;EAEd,iBAAiB;;;;KCzKP;UACK;WACN,QAAQ;WACR;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;aACE;aACA;;;WAGF;WACA;;UAEM;WACN;WACA;WACA;WACA;WACA,iBAAiB;WACjB;IACP;IACA;IACA;;WAEO;;;;KC/BC,mBAAmB,2BAA2B;KAC9C,kBACV,SAAS,mBACT,gBAAgB,oBACb;;iBAaI,WAAW,YAAY,aAAa;iBAWpC,SACP,OAAO,YAAY,oCACnB,gBACA,gBACA;iBAeO,SAAS,UAAU;;;;;;;;;;;;;;;;cAaf,iBAAe;;;;;;;EAON,aAAA;EAEL,OAAA;;;;;iBCxED,mBAAmB,OAAO;;iBA0E1B,wBACd,IAAI,SACJ;;;KC/DG,qBAAqB,UAAU,wBAAwB;;iBAWtC,qBACpB,YAAY;EAAU;IACtB,IAAI,SACJ,MAAM,oBAAiB,QAAjBA;UAqBS;WACN,IAAI;WACJ,SAAS;;UAEH;WACN,IAAI;WACJ,iBAAiB;;;iBAsBZ,wBAAwB;EACtC,UAAU;EACV;EACA;IACE;;iBAyBY,wBACd,IAAI,SACJ,UAAU,qBACV,oBAAoB,mBACnB"}
package/dist/compiler.js CHANGED
@@ -1,2 +1,2 @@
1
- import { i as emitHandlerFactory, n as compileBrickApplication, r as emitCompiledApplication, t as bindCompiledApplication } from "./compiler2.js";
2
- export { bindCompiledApplication, compileBrickApplication, emitCompiledApplication, emitHandlerFactory };
1
+ import { a as emitCompiledApplication, n as compileBrickApplication, o as emitHandlerFactory, r as loadCompiledBrickApp, t as bindCompiledApplication } from "./compiler2.js";
2
+ export { bindCompiledApplication, compileBrickApplication, emitCompiledApplication, emitHandlerFactory, loadCompiledBrickApp };
@@ -1,2 +1,2 @@
1
- import { a as emitCompiledApplication, c as HandlerFactory, d as RouteMethod, i as compileBrickApplication, l as BrickIR, n as CompiledRoute, o as emitHandlerFactory, r as bindCompiledApplication, s as CompiledHandler, t as CompiledApplication, u as RouteIR } from "./compiler.js";
2
- export { type BrickIR, CompiledApplication, type CompiledHandler, CompiledRoute, type HandlerFactory, type RouteIR, type RouteMethod, bindCompiledApplication, compileBrickApplication, emitCompiledApplication, emitHandlerFactory };
1
+ import { a as loadCompiledBrickApp, c as CompiledHandler, d as RouteIR, f as RouteMethod, i as compileBrickApplication, l as HandlerFactory, n as CompiledRoute, o as emitCompiledApplication, r as bindCompiledApplication, s as emitHandlerFactory, t as CompiledApplication, u as BrickIR } from "./compiler.js";
2
+ export { type BrickIR, CompiledApplication, type CompiledHandler, CompiledRoute, type HandlerFactory, type RouteIR, type RouteMethod, bindCompiledApplication, compileBrickApplication, emitCompiledApplication, emitHandlerFactory, loadCompiledBrickApp };
package/dist/compiler2.js CHANGED
@@ -1,4 +1,6 @@
1
- import { ActionExecutionError, ValidationError, buildErrorHelpers, describeResourceReads, getCompiledCheck, prepareResourceReads, prepareResourceWrites } from "@brickkit/core";
1
+ import { ActionExecutionError, ValidationError, buildErrorHelpers, getCompiledCheck, getPluginActionRoute } from "@brickkit/core";
2
+ import { resolve } from "node:path";
3
+ import { pathToFileURL } from "node:url";
2
4
  //#region src/action-handler.ts
3
5
  let _srvSeq = 0;
4
6
  const EMPTY_SERVICES$1 = Object.freeze({});
@@ -8,6 +10,26 @@ function isNonEmpty$1(obj) {
8
10
  for (const _ in obj) return true;
9
11
  return false;
10
12
  }
13
+ const MAX_INPUT_DEPTH = 128;
14
+ function inputTooDeep(value) {
15
+ if (!value || typeof value !== "object") return false;
16
+ const stack = [{
17
+ node: value,
18
+ depth: 0
19
+ }];
20
+ while (stack.length > 0) {
21
+ const { node, depth } = stack.pop();
22
+ if (depth > MAX_INPUT_DEPTH) return true;
23
+ if (node && typeof node === "object") {
24
+ const children = Array.isArray(node) ? node : Object.values(node);
25
+ for (const child of children) if (child && typeof child === "object") stack.push({
26
+ node: child,
27
+ depth: depth + 1
28
+ });
29
+ }
30
+ }
31
+ return false;
32
+ }
11
33
  function compileRoutePlan(service, action, routePath, method) {
12
34
  const actionName = action.name;
13
35
  const serviceName = service.name;
@@ -16,7 +38,8 @@ function compileRoutePlan(service, action, routePath, method) {
16
38
  const outputSchema = action.config?.output;
17
39
  const hasInput = Boolean(inputSchema);
18
40
  const inputChecker = inputSchema ? getCompiledCheck(inputSchema) : void 0;
19
- const outputChecker = outputSchema ? getCompiledCheck(outputSchema) : void 0;
41
+ const runtimeOutputSchema = action.outputValidationSchema ?? outputSchema;
42
+ const outputChecker = runtimeOutputSchema ? getCompiledCheck(runtimeOutputSchema) : void 0;
20
43
  let coercions;
21
44
  if (inputSchema && typeof inputSchema.properties === "object") {
22
45
  const list = [];
@@ -130,6 +153,10 @@ async function executeCompiledRoute(plan, elysiaCtx) {
130
153
  }
131
154
  if (input === void 0 && plan.action.config?.input?.type === "object") input = {};
132
155
  if (plan.hasInput && plan.inputChecker) {
156
+ if (inputTooDeep(input)) throw new ValidationError(`Validation failed for action '${plan.actionName}' input`, [{
157
+ path: "",
158
+ message: "Input exceeds maximum nesting depth"
159
+ }]);
133
160
  if (!plan.inputChecker.Check(input)) {
134
161
  const errors = Array.from(plan.inputChecker.Errors(input)).map((err) => ({
135
162
  path: err.path,
@@ -203,14 +230,19 @@ function analyzeApplication(services, prefix = "/api") {
203
230
  const diagnostics = [];
204
231
  const add = (service, action, method, path, kind) => {
205
232
  if (!path.startsWith("/")) throw new Error(`Brick compiler: invalid route '${method} ${path}'`);
206
- const key = `${method} ${path}`;
233
+ const plugin = getPluginActionRoute(action, prefix) !== void 0;
234
+ const key = `${method} ${path.replace(/:[^/]+/g, ":param")}`;
207
235
  const previous = registered.get(key);
208
236
  if (previous) {
209
- diagnostics.push(`${key}: '${service.name}.${action.name}' shadowed by '${previous}' (first registration wins)`);
237
+ if (plugin || previous.plugin) throw new Error(`Brick compiler: duplicate plugin route '${method} ${path}'`);
238
+ diagnostics.push(`${key}: '${service.name}.${action.name}' shadowed by '${previous.name}' (first registration wins)`);
210
239
  return;
211
240
  }
212
241
  if (typeof action.config.execute !== "function") throw new Error(`Brick compiler: '${service.name}.${action.name}' has no execute handler`);
213
- registered.set(key, `${service.name}.${action.name}`);
242
+ registered.set(key, {
243
+ name: `${service.name}.${action.name}`,
244
+ plugin
245
+ });
214
246
  const readLike = method === "GET" || action.name.startsWith("get") || action.name.endsWith(".get") || action.name.startsWith("list") || action.name.endsWith(".list") || action.name.startsWith("find") || action.name.startsWith("read");
215
247
  const coercions = [];
216
248
  for (const [key, prop] of Object.entries(action.config.input?.properties ?? {})) if (prop.type === "number" || prop.type === "integer") coercions.push({
@@ -249,55 +281,17 @@ function analyzeApplication(services, prefix = "/api") {
249
281
  action
250
282
  });
251
283
  };
252
- for (const service of services) {
253
- for (const resource of service.listResources()) {
254
- const collection = `${prefix}/${resource.name}`;
255
- const item = `${collection}/:id`;
256
- for (const [operation, method, path] of [
257
- [
258
- "list",
259
- "GET",
260
- collection
261
- ],
262
- [
263
- "create",
264
- "POST",
265
- collection
266
- ],
267
- [
268
- "get",
269
- "GET",
270
- item
271
- ],
272
- [
273
- "update",
274
- "PATCH",
275
- item
276
- ],
277
- [
278
- "update",
279
- "PUT",
280
- item
281
- ],
282
- [
283
- "delete",
284
- "DELETE",
285
- item
286
- ]
287
- ]) {
288
- const action = resource.actions[operation];
289
- if (action) add(service, action, method, path, "resource");
290
- }
291
- }
292
- for (const action of service.listActions()) {
293
- const path = action.config.path ?? `${prefix}/${service.name}/${action.name}`;
294
- add(service, action, action.config.method ?? "POST", path, "action");
295
- }
284
+ for (const service of services) for (const action of service.listActions()) {
285
+ const pluginRoute = getPluginActionRoute(action, prefix);
286
+ if (pluginRoute === false) continue;
287
+ const path = pluginRoute?.path ?? action.config.path ?? `${prefix}/${service.name}/${action.name}`;
288
+ add(service, action, pluginRoute?.method ?? action.config.method ?? "POST", path, "action");
296
289
  }
297
- const reads = services.flatMap((service) => service.listResources().flatMap((resource) => {
298
- const queries = describeResourceReads(service, resource);
299
- return queries ? [queries] : [];
300
- }));
290
+ const preparations = services.flatMap((service) => service.listPreparations().map((contribution) => ({
291
+ service: service.name,
292
+ name: contribution.name,
293
+ metadata: schemaSnapshot(contribution.describe?.())
294
+ })));
301
295
  return {
302
296
  ir: freezeIR({
303
297
  version: 1,
@@ -305,7 +299,7 @@ function analyzeApplication(services, prefix = "/api") {
305
299
  prefix,
306
300
  services: [...names],
307
301
  routes,
308
- reads,
302
+ preparations,
309
303
  diagnostics
310
304
  }),
311
305
  bindings
@@ -421,7 +415,38 @@ const compilerRuntime = Object.freeze({
421
415
  }
422
416
  });
423
417
  //#endregion
418
+ //#region src/app-entry.ts
419
+ function isBrickApp(app) {
420
+ if (!app || typeof app !== "object") return false;
421
+ return "endpoint" in app && typeof app.endpoint === "function" && "fetch" in app && typeof app.fetch === "function" && "listen" in app && typeof app.listen === "function" && "definition" in app && !!app.definition && typeof app.definition === "object" && "services" in app.definition && Array.isArray(app.definition.services) && "prefix" in app.definition && typeof app.definition.prefix === "string";
422
+ }
423
+ function requireBrickApp(app) {
424
+ if (!isBrickApp(app)) throw new Error("Brick: the entry module must default-export a BrickApp created by brick().");
425
+ if (app.server) throw new Error("Brick: the app entry must not call .listen(); use a separate server bootstrap.");
426
+ return app;
427
+ }
428
+ async function loadBrickApp(entry) {
429
+ return requireBrickApp((await import(pathToFileURL(resolve(entry)).href)).default);
430
+ }
431
+ //#endregion
424
432
  //#region src/compiler.ts
433
+ const buildBindings = /* @__PURE__ */ new Map();
434
+ function applicationKey(services, prefix = "/api") {
435
+ return JSON.stringify([prefix, services.map((service) => service.name)]);
436
+ }
437
+ /** Build artifact bootstrap: bind generated handlers while evaluating the original app. */
438
+ async function loadCompiledBrickApp(load, ir, bind) {
439
+ const key = JSON.stringify([ir.prefix, ir.services]);
440
+ if (buildBindings.has(key)) throw new Error("Brick compiler: overlapping compiled app imports");
441
+ buildBindings.set(key, bind);
442
+ try {
443
+ const app = requireBrickApp((await load()).default);
444
+ if (applicationKey(app.definition.services, app.definition.prefix) !== key) throw new Error("Brick compiler: app services/prefix changed; rebuild the application");
445
+ return app;
446
+ } finally {
447
+ buildBindings.delete(key);
448
+ }
449
+ }
425
450
  function bindAnalyzed(ir, bindings, factories) {
426
451
  if (factories.length !== ir.routes.length) throw new Error("Brick compiler: handler factory count does not match IR");
427
452
  const routes = ir.routes.map((route, index) => {
@@ -440,12 +465,11 @@ function bindAnalyzed(ir, bindings, factories) {
440
465
  }
441
466
  /** Startup compiler: analyzes once, generates JS once, then binds live callbacks. */
442
467
  function compileBrickApplication(options) {
468
+ const bind = buildBindings.get(applicationKey(options.services, options.prefix));
469
+ if (bind && options.mode !== "generic") return bind(options.services);
443
470
  const { ir, bindings } = analyzeApplication(options.services, options.prefix);
444
471
  const factories = options.mode === "generic" ? ir.routes.map(() => (plan) => (context) => executeCompiledRoute(plan, context)) : ir.routes.map((route) => new Function(`return (${emitHandlerFactory(route)});`)());
445
- if (options.mode !== "generic") for (const service of options.services) {
446
- prepareResourceReads(service);
447
- prepareResourceWrites(service);
448
- }
472
+ if (options.mode !== "generic") for (const service of options.services) service.prepareContributions();
449
473
  return bindAnalyzed(ir, bindings, factories);
450
474
  }
451
475
  /** Build artifact binder: consumes emitted functions, with no runtime handler code generation. */
@@ -453,13 +477,10 @@ function bindCompiledApplication(ir, services, factories) {
453
477
  if (ir.version !== 1 || ir.target !== "bun-elysia") throw new Error("Brick compiler: unsupported IR version or target; rebuild the application");
454
478
  const analyzed = analyzeApplication(services, ir.prefix);
455
479
  if (JSON.stringify(analyzed.ir) !== JSON.stringify(ir)) throw new Error("Brick compiler: application definitions differ from the compiled IR; rebuild the application");
456
- for (const service of services) {
457
- prepareResourceReads(service);
458
- prepareResourceWrites(service);
459
- }
480
+ for (const service of services) service.prepareContributions();
460
481
  return bindAnalyzed(ir, analyzed.bindings, factories);
461
482
  }
462
483
  //#endregion
463
- export { emitHandlerFactory as i, compileBrickApplication as n, emitCompiledApplication as r, bindCompiledApplication as t };
484
+ export { emitCompiledApplication as a, loadBrickApp as i, compileBrickApplication as n, emitHandlerFactory as o, loadCompiledBrickApp as r, bindCompiledApplication as t };
464
485
 
465
486
  //# sourceMappingURL=compiler2.js.map