@celerity-sdk/cli 0.3.1 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +106 -5
- package/dist/extract/cli.cjs +369 -47
- package/dist/extract/cli.cjs.map +1 -1
- package/dist/extract/cli.js +370 -48
- package/dist/extract/cli.js.map +1 -1
- package/dist/index.cjs +369 -47
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +21 -3
- package/dist/index.d.ts +21 -3
- package/dist/index.js +370 -48
- package/dist/index.js.map +1 -1
- package/package.json +4 -4
- package/schemas/handler-manifest.v1.schema.json +56 -11
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/extract/metadata-app.ts","../src/extract/serializer.ts","../src/extract/path-utils.ts","../src/extract/identity.ts"],"sourcesContent":["import \"reflect-metadata\";\nimport createDebug from \"debug\";\nimport type {\n Type,\n InjectionToken,\n Provider,\n FunctionHandlerDefinition,\n} from \"@celerity-sdk/types\";\nimport {\n buildModuleGraph,\n getClassDependencyTokens,\n getProviderDependencyTokens,\n} from \"@celerity-sdk/core\";\nimport type { ModuleGraph } from \"@celerity-sdk/core\";\n\nconst debug = createDebug(\"celerity:cli\");\n\nexport type ScannedProvider = {\n token: InjectionToken;\n providerType: \"class\" | \"factory\" | \"value\";\n dependencies: InjectionToken[];\n};\n\nexport type ScannedModule = {\n controllerClasses: Type[];\n functionHandlers: FunctionHandlerDefinition[];\n providers: ScannedProvider[];\n};\n\nfunction scanProvider(\n provider: Type | (Provider & { provide: InjectionToken }),\n seenTokens: Set<InjectionToken>,\n): ScannedProvider | null {\n if (typeof provider === \"function\") {\n if (seenTokens.has(provider)) return null;\n seenTokens.add(provider);\n return {\n token: provider,\n providerType: \"class\",\n dependencies: getClassDependencyTokens(provider),\n };\n }\n\n const typed = provider as Provider & { provide: InjectionToken };\n if (seenTokens.has(typed.provide)) return null;\n seenTokens.add(typed.provide);\n\n return {\n token: typed.provide,\n providerType: \"useFactory\" in typed ? \"factory\" : \"useClass\" in typed ? \"class\" : \"value\",\n dependencies: getProviderDependencyTokens(typed),\n };\n}\n\n/**\n * Builds a scanned module from the root module class using the shared\n * `buildModuleGraph` from core. Collects all handler classes, function\n * handler definitions, and provider dependency information without\n * instantiating anything.\n *\n * Inherits circular import detection from the shared graph builder.\n */\nexport function buildScannedModule(rootModule: Type): ScannedModule {\n const graph: ModuleGraph = buildModuleGraph(rootModule);\n const controllerClasses: Type[] = [];\n const functionHandlers: FunctionHandlerDefinition[] = [];\n const providers: ScannedProvider[] = [];\n const seenTokens = new Set<InjectionToken>();\n\n for (const [moduleClass, node] of graph) {\n debug(\n \"scan: module %s — %d providers, %d controllers\",\n moduleClass.name,\n node.providers.length,\n node.controllers.length,\n );\n for (const provider of node.providers) {\n const scanned = scanProvider(provider, seenTokens);\n if (scanned) providers.push(scanned);\n }\n\n for (const controller of node.controllers) {\n controllerClasses.push(controller);\n if (!seenTokens.has(controller)) {\n seenTokens.add(controller);\n providers.push({\n token: controller,\n providerType: \"class\",\n dependencies: getClassDependencyTokens(controller),\n });\n }\n }\n\n functionHandlers.push(...node.functionHandlers);\n }\n\n return { controllerClasses, functionHandlers, providers };\n}\n\nexport type DependencyDiagnostic = {\n consumer: string;\n dependency: string;\n};\n\n/**\n * Validates that all scanned providers have resolvable dependencies.\n * Returns an array of diagnostics for each unresolvable dependency.\n * A token is resolvable if it's registered or is a class (implicitly constructable).\n */\nexport function validateScannedDependencies(scanned: ScannedModule): DependencyDiagnostic[] {\n const registeredTokens = new Set<InjectionToken>(scanned.providers.map((p) => p.token));\n const diagnostics: DependencyDiagnostic[] = [];\n const visited = new Set<InjectionToken>();\n\n function walk(token: InjectionToken, deps: InjectionToken[]): void {\n if (visited.has(token)) return;\n visited.add(token);\n\n for (const dep of deps) {\n if (registeredTokens.has(dep)) {\n const provider = scanned.providers.find((p) => p.token === dep);\n if (provider) {\n walk(dep, provider.dependencies);\n }\n } else if (typeof dep === \"function\") {\n walk(dep, getClassDependencyTokens(dep as Type));\n } else {\n diagnostics.push({\n consumer: serializeToken(token),\n dependency: serializeToken(dep),\n });\n }\n }\n }\n\n for (const provider of scanned.providers) {\n walk(provider.token, provider.dependencies);\n }\n\n return diagnostics;\n}\n\nfunction serializeToken(token: InjectionToken): string {\n if (typeof token === \"function\") return token.name;\n if (typeof token === \"symbol\") return token.description ?? \"Symbol()\";\n return String(token);\n}\n","import \"reflect-metadata\";\nimport type { Type, HttpMethod, InjectionToken } from \"@celerity-sdk/types\";\nimport {\n CONTROLLER_METADATA,\n HTTP_METHOD_METADATA,\n ROUTE_PATH_METADATA,\n GUARD_PROTECTEDBY_METADATA,\n GUARD_CUSTOM_METADATA,\n PUBLIC_METADATA,\n CUSTOM_METADATA,\n} from \"@celerity-sdk/core\";\nimport type { ControllerMetadata } from \"@celerity-sdk/core\";\nimport type { ScannedModule } from \"./metadata-app\";\nimport type {\n HandlerManifest,\n ClassHandlerEntry,\n FunctionHandlerEntry,\n DependencyGraph,\n DependencyNode,\n} from \"./types\";\nimport { joinHandlerPath } from \"./path-utils\";\nimport {\n deriveClassResourceName,\n deriveClassHandlerName,\n deriveClassHandlerFunction,\n deriveCodeLocation,\n deriveFunctionResourceName,\n deriveFunctionHandlerFunction,\n} from \"./identity\";\n\nexport type SerializeOptions = {\n projectRoot: string;\n};\n\nexport function serializeManifest(\n scanned: ScannedModule,\n sourceFile: string,\n options: SerializeOptions,\n): HandlerManifest {\n const handlers: ClassHandlerEntry[] = [];\n const functionHandlers: FunctionHandlerEntry[] = [];\n\n for (const controllerClass of scanned.controllerClasses) {\n const entries = serializeClassHandler(controllerClass, sourceFile, options);\n handlers.push(...entries);\n }\n\n for (const fnHandler of scanned.functionHandlers) {\n const entry = serializeFunctionHandler(fnHandler, sourceFile, options);\n if (entry) {\n functionHandlers.push(entry);\n }\n }\n\n return {\n version: \"1.0.0\",\n handlers,\n functionHandlers,\n dependencyGraph: serializeDependencyGraph(scanned),\n };\n}\n\ntype ClassMeta = {\n prefix: string;\n protectedBy: string[];\n customGuardName: string | undefined;\n customMetadata: Record<string, unknown>;\n};\n\nfunction extractClassMeta(controllerClass: Type): ClassMeta | null {\n const controllerMeta: ControllerMetadata | undefined = Reflect.getOwnMetadata(\n CONTROLLER_METADATA,\n controllerClass,\n );\n if (!controllerMeta) return null;\n\n return {\n prefix: controllerMeta.prefix ?? \"\",\n protectedBy: Reflect.getOwnMetadata(GUARD_PROTECTEDBY_METADATA, controllerClass) ?? [],\n customGuardName: Reflect.getOwnMetadata(GUARD_CUSTOM_METADATA, controllerClass),\n customMetadata: Reflect.getOwnMetadata(CUSTOM_METADATA, controllerClass) ?? {},\n };\n}\n\nfunction buildMethodAnnotations(\n classMeta: ClassMeta,\n prototype: object,\n methodName: string,\n httpMethod: HttpMethod,\n fullPath: string,\n): Record<string, string | string[] | boolean> {\n const annotations: Record<string, string | string[] | boolean> = {};\n\n annotations[\"celerity.handler.http\"] = true;\n annotations[\"celerity.handler.http.method\"] = httpMethod;\n annotations[\"celerity.handler.http.path\"] = fullPath;\n\n const methodProtectedBy: string[] =\n Reflect.getOwnMetadata(GUARD_PROTECTEDBY_METADATA, prototype, methodName) ?? [];\n const allProtectedBy = [...classMeta.protectedBy, ...methodProtectedBy];\n if (allProtectedBy.length > 0) {\n annotations[\"celerity.handler.guard.protectedBy\"] = allProtectedBy;\n }\n if (classMeta.customGuardName) {\n annotations[\"celerity.handler.guard.custom\"] = classMeta.customGuardName;\n }\n\n const isPublic: boolean = Reflect.getOwnMetadata(PUBLIC_METADATA, prototype, methodName) === true;\n if (isPublic) {\n annotations[\"celerity.handler.public\"] = true;\n }\n\n const methodCustomMetadata: Record<string, unknown> =\n Reflect.getOwnMetadata(CUSTOM_METADATA, prototype, methodName) ?? {};\n const customMetadata = { ...classMeta.customMetadata, ...methodCustomMetadata };\n for (const [key, value] of Object.entries(customMetadata)) {\n if (value === undefined) continue;\n annotations[`celerity.handler.metadata.${key}`] = serializeAnnotationValue(value);\n }\n\n return annotations;\n}\n\nfunction serializeClassHandler(\n controllerClass: Type,\n sourceFile: string,\n options: SerializeOptions,\n): ClassHandlerEntry[] {\n const classMeta = extractClassMeta(controllerClass);\n if (!classMeta) return [];\n\n const className = controllerClass.name;\n const prototype = controllerClass.prototype as object;\n const methods = Object.getOwnPropertyNames(prototype).filter((n) => n !== \"constructor\");\n const entries: ClassHandlerEntry[] = [];\n\n for (const methodName of methods) {\n const httpMethod: HttpMethod | undefined = Reflect.getOwnMetadata(\n HTTP_METHOD_METADATA,\n prototype,\n methodName,\n );\n if (!httpMethod) continue;\n\n const routePath: string =\n Reflect.getOwnMetadata(ROUTE_PATH_METADATA, prototype, methodName) ?? \"/\";\n const fullPath = joinHandlerPath(classMeta.prefix, routePath);\n const annotations = buildMethodAnnotations(\n classMeta,\n prototype,\n methodName,\n httpMethod,\n fullPath,\n );\n\n entries.push({\n resourceName: deriveClassResourceName(className, methodName),\n className,\n methodName,\n sourceFile,\n handlerType: \"http\",\n annotations,\n spec: {\n handlerName: deriveClassHandlerName(className, methodName),\n codeLocation: deriveCodeLocation(sourceFile, options.projectRoot),\n handler: deriveClassHandlerFunction(sourceFile, className, methodName),\n },\n });\n }\n\n return entries;\n}\n\nfunction serializeFunctionHandler(\n definition: { metadata: Record<string, unknown>; handler: (...args: unknown[]) => unknown },\n sourceFile: string,\n options: SerializeOptions,\n): FunctionHandlerEntry | null {\n // Function handlers don't have a reliable export name from the definition alone.\n // The CLI entry point will need to derive this from the module's named exports.\n // For now, use \"handler\" as a placeholder — the CLI enriches this.\n const exportName = (definition.metadata.handlerName as string) ?? \"handler\";\n const customMetadata = (definition.metadata.customMetadata as Record<string, unknown>) ?? {};\n\n const annotations: Record<string, string | string[] | boolean> = {};\n\n const path = definition.metadata.path as string | undefined;\n const method = definition.metadata.method as string | undefined;\n if (path !== undefined && method !== undefined) {\n annotations[\"celerity.handler.http\"] = true;\n annotations[\"celerity.handler.http.method\"] = method;\n annotations[\"celerity.handler.http.path\"] = path;\n }\n\n for (const [key, value] of Object.entries(customMetadata)) {\n if (value === undefined) continue;\n annotations[`celerity.handler.metadata.${key}`] = serializeAnnotationValue(value);\n }\n\n return {\n resourceName: deriveFunctionResourceName(exportName),\n exportName,\n sourceFile,\n ...(Object.keys(annotations).length > 0 ? { annotations } : {}),\n spec: {\n handlerName: exportName,\n codeLocation: deriveCodeLocation(sourceFile, options.projectRoot),\n handler: deriveFunctionHandlerFunction(sourceFile, exportName),\n },\n };\n}\n\nfunction serializeAnnotationValue(value: unknown): string | string[] | boolean {\n if (typeof value === \"boolean\") return value;\n if (typeof value === \"string\") return value;\n if (Array.isArray(value) && value.every((v) => typeof v === \"string\")) {\n return value as string[];\n }\n return JSON.stringify(value);\n}\n\nexport function serializeToken(token: InjectionToken): string {\n if (typeof token === \"function\") return token.name;\n if (typeof token === \"symbol\") return token.description ?? \"Symbol()\";\n return token;\n}\n\nexport function tokenType(token: InjectionToken): \"class\" | \"string\" | \"symbol\" {\n if (typeof token === \"function\") return \"class\";\n if (typeof token === \"symbol\") return \"symbol\";\n return \"string\";\n}\n\nfunction serializeDependencyGraph(scanned: ScannedModule): DependencyGraph {\n const nodes: DependencyNode[] = scanned.providers.map((provider) => ({\n token: serializeToken(provider.token),\n tokenType: tokenType(provider.token),\n providerType: provider.providerType,\n dependencies: provider.dependencies.map(serializeToken),\n }));\n\n return { nodes };\n}\n","export { joinHandlerPath } from \"@celerity-sdk/common\";\n","import { basename, dirname, relative } from \"node:path\";\n\n/**\n * Derives a resource name for a class-based handler method.\n * Format: camelCase(className) + \"_\" + methodName\n *\n * @example deriveClassResourceName(\"OrdersHandler\", \"getOrder\") => \"ordersHandler_getOrder\"\n */\nexport function deriveClassResourceName(className: string, methodName: string): string {\n const camelClass = className.charAt(0).toLowerCase() + className.slice(1);\n return `${camelClass}_${methodName}`;\n}\n\n/**\n * Derives a handler name for a class-based handler method.\n * Format: className + \"-\" + methodName\n *\n * @example deriveClassHandlerName(\"OrdersHandler\", \"getOrder\") => \"OrdersHandler-getOrder\"\n */\nexport function deriveClassHandlerName(className: string, methodName: string): string {\n return `${className}-${methodName}`;\n}\n\n/**\n * Derives the handler function reference for a class-based handler.\n * Format: moduleBaseName + \".\" + className + \".\" + methodName\n *\n * @example deriveClassHandlerFunction(\"src/handlers/orders.ts\", \"OrdersHandler\", \"getOrder\")\n * => \"orders.OrdersHandler.getOrder\"\n */\nexport function deriveClassHandlerFunction(\n sourceFile: string,\n className: string,\n methodName: string,\n): string {\n const base = basename(sourceFile).replace(/\\.[^.]+$/, \"\");\n return `${base}.${className}.${methodName}`;\n}\n\n/**\n * Derives a resource name for a function-based handler.\n * Uses the export name directly.\n *\n * @example deriveFunctionResourceName(\"getOrder\") => \"getOrder\"\n */\nexport function deriveFunctionResourceName(exportName: string): string {\n return exportName;\n}\n\n/**\n * Derives the handler function reference for a function-based handler.\n * Format: moduleBaseName + \".\" + exportName\n *\n * @example deriveFunctionHandlerFunction(\"src/handlers/orders.ts\", \"getOrder\")\n * => \"orders.getOrder\"\n */\nexport function deriveFunctionHandlerFunction(sourceFile: string, exportName: string): string {\n const base = basename(sourceFile).replace(/\\.[^.]+$/, \"\");\n return `${base}.${exportName}`;\n}\n\n/**\n * Derives the code location from a source file path relative to the project root.\n * Returns the directory prefixed with \"./\"\n *\n * @example deriveCodeLocation(\"src/handlers/orders.ts\", \"/project\") => \"./src/handlers\"\n */\nexport function deriveCodeLocation(sourceFile: string, projectRoot: string): string {\n const rel = relative(projectRoot, sourceFile);\n const dir = dirname(rel);\n return dir === \".\" ? \"./\" : `./${dir}`;\n}\n"],"mappings":"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","names":["createDebug","buildModuleGraph","getClassDependencyTokens","getProviderDependencyTokens","debug","createDebug","scanProvider","provider","seenTokens","has","add","token","providerType","dependencies","getClassDependencyTokens","typed","provide","getProviderDependencyTokens","buildScannedModule","rootModule","graph","buildModuleGraph","controllerClasses","functionHandlers","providers","Set","moduleClass","node","name","length","controllers","scanned","push","controller","validateScannedDependencies","registeredTokens","map","p","diagnostics","visited","walk","deps","dep","find","consumer","serializeToken","dependency","description","String","CONTROLLER_METADATA","HTTP_METHOD_METADATA","ROUTE_PATH_METADATA","GUARD_PROTECTEDBY_METADATA","GUARD_CUSTOM_METADATA","PUBLIC_METADATA","CUSTOM_METADATA","joinHandlerPath","basename","dirname","relative","deriveClassResourceName","className","methodName","camelClass","charAt","toLowerCase","slice","deriveClassHandlerName","deriveClassHandlerFunction","sourceFile","base","basename","replace","deriveFunctionResourceName","exportName","deriveFunctionHandlerFunction","deriveCodeLocation","projectRoot","rel","relative","dir","dirname","serializeManifest","scanned","sourceFile","options","handlers","functionHandlers","controllerClass","controllerClasses","entries","serializeClassHandler","push","fnHandler","entry","serializeFunctionHandler","version","dependencyGraph","serializeDependencyGraph","extractClassMeta","controllerMeta","Reflect","getOwnMetadata","CONTROLLER_METADATA","prefix","protectedBy","GUARD_PROTECTEDBY_METADATA","customGuardName","GUARD_CUSTOM_METADATA","customMetadata","CUSTOM_METADATA","buildMethodAnnotations","classMeta","prototype","methodName","httpMethod","fullPath","annotations","methodProtectedBy","allProtectedBy","length","isPublic","PUBLIC_METADATA","methodCustomMetadata","key","value","Object","undefined","serializeAnnotationValue","className","name","methods","getOwnPropertyNames","filter","n","HTTP_METHOD_METADATA","routePath","ROUTE_PATH_METADATA","joinHandlerPath","resourceName","deriveClassResourceName","handlerType","spec","handlerName","deriveClassHandlerName","codeLocation","deriveCodeLocation","projectRoot","handler","deriveClassHandlerFunction","definition","exportName","metadata","path","method","deriveFunctionResourceName","keys","deriveFunctionHandlerFunction","Array","isArray","every","v","JSON","stringify","serializeToken","token","description","tokenType","nodes","providers","map","provider","providerType","dependencies"]}
|
|
1
|
+
{"version":3,"sources":["../src/extract/metadata-app.ts","../src/extract/serializer.ts","../src/extract/path-utils.ts","../src/extract/identity.ts"],"sourcesContent":["import \"reflect-metadata\";\nimport createDebug from \"debug\";\nimport type {\n Type,\n InjectionToken,\n Provider,\n FunctionHandlerDefinition,\n GuardDefinition,\n} from \"@celerity-sdk/types\";\nimport {\n buildModuleGraph,\n getClassDependencyTokens,\n getProviderDependencyTokens,\n} from \"@celerity-sdk/core\";\nimport type { ModuleGraph } from \"@celerity-sdk/core\";\n\nconst debug = createDebug(\"celerity:cli\");\n\nexport type ScannedProvider = {\n token: InjectionToken;\n providerType: \"class\" | \"factory\" | \"value\";\n dependencies: InjectionToken[];\n};\n\nexport type ScannedModule = {\n controllerClasses: Type[];\n functionHandlers: FunctionHandlerDefinition[];\n guardClasses: Type[];\n functionGuards: GuardDefinition[];\n providers: ScannedProvider[];\n};\n\nfunction scanProvider(\n provider: Type | (Provider & { provide: InjectionToken }),\n seenTokens: Set<InjectionToken>,\n): ScannedProvider | null {\n if (typeof provider === \"function\") {\n if (seenTokens.has(provider)) return null;\n seenTokens.add(provider);\n return {\n token: provider,\n providerType: \"class\",\n dependencies: getClassDependencyTokens(provider),\n };\n }\n\n const typed = provider as Provider & { provide: InjectionToken };\n if (seenTokens.has(typed.provide)) return null;\n seenTokens.add(typed.provide);\n\n return {\n token: typed.provide,\n providerType: \"useFactory\" in typed ? \"factory\" : \"useClass\" in typed ? \"class\" : \"value\",\n dependencies: getProviderDependencyTokens(typed),\n };\n}\n\n/**\n * Builds a scanned module from the root module class using the shared\n * `buildModuleGraph` from core. Collects all handler classes, function\n * handler definitions, and provider dependency information without\n * instantiating anything.\n *\n * Inherits circular import detection from the shared graph builder.\n */\nexport function buildScannedModule(rootModule: Type): ScannedModule {\n const graph: ModuleGraph = buildModuleGraph(rootModule);\n const controllerClasses: Type[] = [];\n const functionHandlers: FunctionHandlerDefinition[] = [];\n const guardClasses: Type[] = [];\n const functionGuards: GuardDefinition[] = [];\n const providers: ScannedProvider[] = [];\n const seenTokens = new Set<InjectionToken>();\n\n for (const [moduleClass, node] of graph) {\n debug(\n \"scan: module %s — %d providers, %d controllers, %d guards\",\n moduleClass.name,\n node.providers.length,\n node.controllers.length,\n node.guards.length,\n );\n for (const provider of node.providers) {\n const scanned = scanProvider(provider, seenTokens);\n if (scanned) providers.push(scanned);\n }\n\n for (const controller of node.controllers) {\n controllerClasses.push(controller);\n if (!seenTokens.has(controller)) {\n seenTokens.add(controller);\n providers.push({\n token: controller,\n providerType: \"class\",\n dependencies: getClassDependencyTokens(controller),\n });\n }\n }\n\n for (const guard of node.guards) {\n if (typeof guard === \"function\") {\n guardClasses.push(guard);\n if (!seenTokens.has(guard)) {\n seenTokens.add(guard);\n providers.push({\n token: guard,\n providerType: \"class\",\n dependencies: getClassDependencyTokens(guard),\n });\n }\n } else {\n functionGuards.push(guard);\n }\n }\n\n functionHandlers.push(...node.functionHandlers);\n }\n\n return { controllerClasses, functionHandlers, guardClasses, functionGuards, providers };\n}\n\nexport type DependencyDiagnostic = {\n consumer: string;\n dependency: string;\n};\n\n/**\n * Validates that all scanned providers have resolvable dependencies.\n * Returns an array of diagnostics for each unresolvable dependency.\n * A token is resolvable if it's registered or is a class (implicitly constructable).\n */\nexport function validateScannedDependencies(scanned: ScannedModule): DependencyDiagnostic[] {\n const registeredTokens = new Set<InjectionToken>(scanned.providers.map((p) => p.token));\n const diagnostics: DependencyDiagnostic[] = [];\n const visited = new Set<InjectionToken>();\n\n function walk(token: InjectionToken, deps: InjectionToken[]): void {\n if (visited.has(token)) return;\n visited.add(token);\n\n for (const dep of deps) {\n if (registeredTokens.has(dep)) {\n const provider = scanned.providers.find((p) => p.token === dep);\n if (provider) {\n walk(dep, provider.dependencies);\n }\n } else if (typeof dep === \"function\") {\n walk(dep, getClassDependencyTokens(dep as Type));\n } else {\n diagnostics.push({\n consumer: serializeToken(token),\n dependency: serializeToken(dep),\n });\n }\n }\n }\n\n for (const provider of scanned.providers) {\n walk(provider.token, provider.dependencies);\n }\n\n return diagnostics;\n}\n\nfunction serializeToken(token: InjectionToken): string {\n if (typeof token === \"function\") return token.name;\n if (typeof token === \"symbol\") return token.description ?? \"Symbol()\";\n return String(token);\n}\n","import \"reflect-metadata\";\nimport type {\n Type,\n HttpMethod,\n InjectionToken,\n GuardDefinition,\n FunctionHandlerDefinition,\n} from \"@celerity-sdk/types\";\nimport {\n CONTROLLER_METADATA,\n HTTP_METHOD_METADATA,\n ROUTE_PATH_METADATA,\n WEBSOCKET_CONTROLLER_METADATA,\n WEBSOCKET_EVENT_METADATA,\n CONSUMER_METADATA,\n CONSUMER_HANDLER_METADATA,\n SCHEDULE_HANDLER_METADATA,\n INVOKE_METADATA,\n GUARD_PROTECTEDBY_METADATA,\n GUARD_CUSTOM_METADATA,\n PUBLIC_METADATA,\n CUSTOM_METADATA,\n USE_RESOURCE_METADATA,\n} from \"@celerity-sdk/core\";\nimport type {\n ControllerMetadata,\n WebSocketEventMetadata,\n ConsumerHandlerMetadata,\n ScheduleHandlerMetadata,\n InvokeMetadata,\n ConsumerMetadata,\n} from \"@celerity-sdk/core\";\nimport type { ScannedModule } from \"./metadata-app\";\nimport type {\n HandlerManifest,\n ClassHandlerEntry,\n FunctionHandlerEntry,\n GuardHandlerEntry,\n DependencyGraph,\n DependencyNode,\n} from \"./types\";\nimport { joinHandlerPath } from \"./path-utils\";\nimport {\n deriveClassResourceName,\n deriveClassHandlerName,\n deriveClassHandlerFunction,\n deriveCodeLocation,\n deriveFunctionResourceName,\n deriveFunctionHandlerFunction,\n} from \"./identity\";\n\nexport type SerializeOptions = {\n projectRoot: string;\n};\n\nexport function serializeManifest(\n scanned: ScannedModule,\n sourceFile: string,\n options: SerializeOptions,\n): HandlerManifest {\n const handlers: ClassHandlerEntry[] = [];\n const functionHandlers: FunctionHandlerEntry[] = [];\n const guardHandlers: GuardHandlerEntry[] = [];\n\n for (const controllerClass of scanned.controllerClasses) {\n const entries = serializeClassHandlers(controllerClass, sourceFile, options);\n handlers.push(...entries);\n }\n\n for (const fnHandler of scanned.functionHandlers) {\n const entry = serializeFunctionHandler(fnHandler, sourceFile, options);\n if (entry) {\n functionHandlers.push(entry);\n }\n }\n\n for (const guardClass of scanned.guardClasses) {\n const entry = serializeClassGuard(guardClass, sourceFile, options);\n if (entry) {\n guardHandlers.push(entry);\n }\n }\n\n for (const fnGuard of scanned.functionGuards) {\n const entry = serializeFunctionGuard(fnGuard, sourceFile, options);\n if (entry) {\n guardHandlers.push(entry);\n }\n }\n\n return {\n version: \"1.0.0\",\n handlers,\n functionHandlers,\n guardHandlers,\n dependencyGraph: serializeDependencyGraph(scanned),\n };\n}\n\n// ---------------------------------------------------------------------------\n// Controller meta extraction\n// ---------------------------------------------------------------------------\n\ntype ControllerType = \"http\" | \"websocket\" | \"consumer\";\n\ntype ControllerMeta = {\n controllerType: ControllerType;\n prefix: string;\n sourceId?: string;\n protectedBy: string[];\n customGuardName: string | undefined;\n customMetadata: Record<string, unknown>;\n resourceRefs: string[];\n};\n\nfunction extractControllerMeta(controllerClass: Type): ControllerMeta | null {\n const httpMeta: ControllerMetadata | undefined = Reflect.getOwnMetadata(\n CONTROLLER_METADATA,\n controllerClass,\n );\n if (httpMeta) {\n return {\n controllerType: \"http\",\n prefix: httpMeta.prefix ?? \"\",\n ...extractSharedClassMeta(controllerClass),\n };\n }\n\n const isWebSocket: boolean | undefined = Reflect.getOwnMetadata(\n WEBSOCKET_CONTROLLER_METADATA,\n controllerClass,\n );\n if (isWebSocket) {\n return {\n controllerType: \"websocket\",\n prefix: \"\",\n ...extractSharedClassMeta(controllerClass),\n };\n }\n\n const consumerMeta: ConsumerMetadata | undefined = Reflect.getOwnMetadata(\n CONSUMER_METADATA,\n controllerClass,\n );\n if (consumerMeta) {\n return {\n controllerType: \"consumer\",\n prefix: \"\",\n sourceId: consumerMeta.sourceId,\n ...extractSharedClassMeta(controllerClass),\n };\n }\n\n return null;\n}\n\nfunction extractSharedClassMeta(controllerClass: Type) {\n return {\n protectedBy:\n (Reflect.getOwnMetadata(GUARD_PROTECTEDBY_METADATA, controllerClass) as string[]) ?? [],\n customGuardName: Reflect.getOwnMetadata(GUARD_CUSTOM_METADATA, controllerClass) as\n | string\n | undefined,\n customMetadata:\n (Reflect.getOwnMetadata(CUSTOM_METADATA, controllerClass) as Record<string, unknown>) ?? {},\n resourceRefs:\n (Reflect.getOwnMetadata(USE_RESOURCE_METADATA, controllerClass) as string[]) ?? [],\n };\n}\n\n// ---------------------------------------------------------------------------\n// Shared annotation helpers\n// ---------------------------------------------------------------------------\n\nfunction appendSharedAnnotations(\n annotations: Record<string, string | string[] | boolean>,\n meta: ControllerMeta,\n prototype: object,\n methodName: string,\n): void {\n const methodProtectedBy: string[] =\n Reflect.getOwnMetadata(GUARD_PROTECTEDBY_METADATA, prototype, methodName) ?? [];\n const allProtectedBy = [...meta.protectedBy, ...methodProtectedBy];\n if (allProtectedBy.length > 0) {\n annotations[\"celerity.handler.guard.protectedBy\"] = allProtectedBy;\n }\n if (meta.customGuardName) {\n annotations[\"celerity.handler.guard.custom\"] = meta.customGuardName;\n }\n\n const isPublic: boolean = Reflect.getOwnMetadata(PUBLIC_METADATA, prototype, methodName) === true;\n if (isPublic) {\n annotations[\"celerity.handler.public\"] = true;\n }\n\n const methodCustomMetadata: Record<string, unknown> =\n Reflect.getOwnMetadata(CUSTOM_METADATA, prototype, methodName) ?? {};\n const customMetadata = { ...meta.customMetadata, ...methodCustomMetadata };\n for (const [key, value] of Object.entries(customMetadata)) {\n if (value === undefined) continue;\n annotations[`celerity.handler.metadata.${key}`] = serializeAnnotationValue(value);\n }\n\n const methodResourceRefs: string[] =\n Reflect.getOwnMetadata(USE_RESOURCE_METADATA, prototype, methodName) ?? [];\n const allResourceRefs = [...new Set([...meta.resourceRefs, ...methodResourceRefs])];\n if (allResourceRefs.length > 0) {\n annotations[\"celerity.handler.resource.ref\"] = allResourceRefs;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Type-specific annotation builders (class handlers)\n// ---------------------------------------------------------------------------\n\nfunction buildHttpAnnotations(\n meta: ControllerMeta,\n prototype: object,\n methodName: string,\n httpMethod: HttpMethod,\n fullPath: string,\n): Record<string, string | string[] | boolean> {\n const annotations: Record<string, string | string[] | boolean> = {};\n annotations[\"celerity.handler.http\"] = true;\n annotations[\"celerity.handler.http.method\"] = httpMethod;\n annotations[\"celerity.handler.http.path\"] = fullPath;\n appendSharedAnnotations(annotations, meta, prototype, methodName);\n return annotations;\n}\n\nfunction buildWebSocketAnnotations(\n meta: ControllerMeta,\n prototype: object,\n methodName: string,\n wsEvent: WebSocketEventMetadata,\n): Record<string, string | string[] | boolean> {\n const annotations: Record<string, string | string[] | boolean> = {};\n annotations[\"celerity.handler.websocket\"] = true;\n annotations[\"celerity.handler.websocket.route\"] = wsEvent.route;\n annotations[\"celerity.handler.websocket.eventType\"] = wsEvent.eventType;\n appendSharedAnnotations(annotations, meta, prototype, methodName);\n return annotations;\n}\n\nfunction buildConsumerAnnotations(\n meta: ControllerMeta,\n prototype: object,\n methodName: string,\n consumerHandler: ConsumerHandlerMetadata,\n): Record<string, string | string[] | boolean> {\n const annotations: Record<string, string | string[] | boolean> = {};\n annotations[\"celerity.handler.consumer\"] = true;\n if (meta.sourceId) {\n annotations[\"celerity.handler.consumer.sourceId\"] = meta.sourceId;\n }\n if (consumerHandler.route) {\n annotations[\"celerity.handler.consumer.route\"] = consumerHandler.route;\n }\n appendSharedAnnotations(annotations, meta, prototype, methodName);\n return annotations;\n}\n\nfunction buildScheduleAnnotations(\n meta: ControllerMeta,\n prototype: object,\n methodName: string,\n scheduleMeta: ScheduleHandlerMetadata,\n): Record<string, string | string[] | boolean> {\n const annotations: Record<string, string | string[] | boolean> = {};\n annotations[\"celerity.handler.schedule\"] = true;\n if (scheduleMeta.scheduleId) {\n annotations[\"celerity.handler.schedule.scheduleId\"] = scheduleMeta.scheduleId;\n }\n if (scheduleMeta.schedule) {\n annotations[\"celerity.handler.schedule.expression\"] = scheduleMeta.schedule;\n }\n appendSharedAnnotations(annotations, meta, prototype, methodName);\n return annotations;\n}\n\nfunction buildCustomAnnotations(\n meta: ControllerMeta,\n prototype: object,\n methodName: string,\n invokeMeta: InvokeMetadata,\n): Record<string, string | string[] | boolean> {\n const annotations: Record<string, string | string[] | boolean> = {};\n annotations[\"celerity.handler.custom\"] = true;\n annotations[\"celerity.handler.custom.name\"] = invokeMeta.name;\n appendSharedAnnotations(annotations, meta, prototype, methodName);\n return annotations;\n}\n\n// ---------------------------------------------------------------------------\n// Class handler serialization\n// ---------------------------------------------------------------------------\n\nfunction serializeClassHandlers(\n controllerClass: Type,\n sourceFile: string,\n options: SerializeOptions,\n): ClassHandlerEntry[] {\n const meta = extractControllerMeta(controllerClass);\n if (!meta) return [];\n\n const className = controllerClass.name;\n const prototype = controllerClass.prototype as object;\n const methods = Object.getOwnPropertyNames(prototype).filter((n) => n !== \"constructor\");\n const entries: ClassHandlerEntry[] = [];\n\n for (const methodName of methods) {\n // Type-specific handler decorator for the controller type.\n const typeEntry = serializeControllerTypeMethod(\n meta,\n className,\n prototype,\n methodName,\n sourceFile,\n options,\n );\n if (typeEntry) entries.push(typeEntry);\n\n // Cross-cutting: @ScheduleHandler on any controller type.\n const scheduleMeta: ScheduleHandlerMetadata | undefined = Reflect.getOwnMetadata(\n SCHEDULE_HANDLER_METADATA,\n prototype,\n methodName,\n );\n if (scheduleMeta) {\n entries.push({\n resourceName: deriveClassResourceName(className, methodName),\n className,\n methodName,\n sourceFile,\n handlerType: \"schedule\",\n annotations: buildScheduleAnnotations(meta, prototype, methodName, scheduleMeta),\n spec: {\n handlerName: deriveClassHandlerName(className, methodName),\n codeLocation: deriveCodeLocation(sourceFile, options.projectRoot),\n handler: deriveClassHandlerFunction(sourceFile, className, methodName),\n },\n });\n }\n\n // Cross-cutting: @Invoke on any controller type.\n const invokeMeta: InvokeMetadata | undefined = Reflect.getOwnMetadata(\n INVOKE_METADATA,\n prototype,\n methodName,\n );\n if (invokeMeta) {\n entries.push({\n resourceName: deriveClassResourceName(className, methodName),\n className,\n methodName,\n sourceFile,\n handlerType: \"custom\",\n annotations: buildCustomAnnotations(meta, prototype, methodName, invokeMeta),\n spec: {\n handlerName: deriveClassHandlerName(className, methodName),\n codeLocation: deriveCodeLocation(sourceFile, options.projectRoot),\n handler: deriveClassHandlerFunction(sourceFile, className, methodName),\n },\n });\n }\n }\n\n return entries;\n}\n\nfunction serializeControllerTypeMethod(\n meta: ControllerMeta,\n className: string,\n prototype: object,\n methodName: string,\n sourceFile: string,\n options: SerializeOptions,\n): ClassHandlerEntry | null {\n switch (meta.controllerType) {\n case \"http\":\n return serializeHttpMethod(meta, className, prototype, methodName, sourceFile, options);\n case \"websocket\":\n return serializeWebSocketMethod(meta, className, prototype, methodName, sourceFile, options);\n case \"consumer\":\n return serializeConsumerMethod(meta, className, prototype, methodName, sourceFile, options);\n default:\n return null;\n }\n}\n\nfunction serializeHttpMethod(\n meta: ControllerMeta,\n className: string,\n prototype: object,\n methodName: string,\n sourceFile: string,\n options: SerializeOptions,\n): ClassHandlerEntry | null {\n const httpMethod: HttpMethod | undefined = Reflect.getOwnMetadata(\n HTTP_METHOD_METADATA,\n prototype,\n methodName,\n );\n if (!httpMethod) return null;\n\n const routePath: string =\n Reflect.getOwnMetadata(ROUTE_PATH_METADATA, prototype, methodName) ?? \"/\";\n const fullPath = joinHandlerPath(meta.prefix, routePath);\n\n return {\n resourceName: deriveClassResourceName(className, methodName),\n className,\n methodName,\n sourceFile,\n handlerType: \"http\",\n annotations: buildHttpAnnotations(meta, prototype, methodName, httpMethod, fullPath),\n spec: {\n handlerName: deriveClassHandlerName(className, methodName),\n codeLocation: deriveCodeLocation(sourceFile, options.projectRoot),\n handler: deriveClassHandlerFunction(sourceFile, className, methodName),\n },\n };\n}\n\nfunction serializeWebSocketMethod(\n meta: ControllerMeta,\n className: string,\n prototype: object,\n methodName: string,\n sourceFile: string,\n options: SerializeOptions,\n): ClassHandlerEntry | null {\n const wsEvent: WebSocketEventMetadata | undefined = Reflect.getOwnMetadata(\n WEBSOCKET_EVENT_METADATA,\n prototype,\n methodName,\n );\n if (!wsEvent) return null;\n\n return {\n resourceName: deriveClassResourceName(className, methodName),\n className,\n methodName,\n sourceFile,\n handlerType: \"websocket\",\n annotations: buildWebSocketAnnotations(meta, prototype, methodName, wsEvent),\n spec: {\n handlerName: deriveClassHandlerName(className, methodName),\n codeLocation: deriveCodeLocation(sourceFile, options.projectRoot),\n handler: deriveClassHandlerFunction(sourceFile, className, methodName),\n },\n };\n}\n\nfunction serializeConsumerMethod(\n meta: ControllerMeta,\n className: string,\n prototype: object,\n methodName: string,\n sourceFile: string,\n options: SerializeOptions,\n): ClassHandlerEntry | null {\n const consumerHandler: ConsumerHandlerMetadata | undefined = Reflect.getOwnMetadata(\n CONSUMER_HANDLER_METADATA,\n prototype,\n methodName,\n );\n if (!consumerHandler) return null;\n\n return {\n resourceName: deriveClassResourceName(className, methodName),\n className,\n methodName,\n sourceFile,\n handlerType: \"consumer\",\n annotations: buildConsumerAnnotations(meta, prototype, methodName, consumerHandler),\n spec: {\n handlerName: deriveClassHandlerName(className, methodName),\n codeLocation: deriveCodeLocation(sourceFile, options.projectRoot),\n handler: deriveClassHandlerFunction(sourceFile, className, methodName),\n },\n };\n}\n\n// ---------------------------------------------------------------------------\n// Function handler serialization\n// ---------------------------------------------------------------------------\n\nfunction serializeFunctionHandler(\n definition: FunctionHandlerDefinition,\n sourceFile: string,\n options: SerializeOptions,\n): FunctionHandlerEntry | null {\n // \"workflow\" is not part of v0 — skip unsupported handler types.\n const supported = [\"http\", \"websocket\", \"consumer\", \"schedule\", \"custom\"] as const;\n type SupportedType = (typeof supported)[number];\n if (!supported.includes(definition.type as SupportedType)) return null;\n\n const exportName = (definition.metadata.handlerName as string) ?? \"handler\";\n const customMetadata = (definition.metadata.customMetadata as Record<string, unknown>) ?? {};\n const handlerType = definition.type as SupportedType;\n\n const annotations: Record<string, string | string[] | boolean> = {};\n\n buildFunctionTypeAnnotations(annotations, definition);\n\n for (const [key, value] of Object.entries(customMetadata)) {\n if (value === undefined) continue;\n annotations[`celerity.handler.metadata.${key}`] = serializeAnnotationValue(value);\n }\n\n return {\n resourceName: deriveFunctionResourceName(exportName),\n exportName,\n sourceFile,\n handlerType,\n ...(Object.keys(annotations).length > 0 ? { annotations } : {}),\n spec: {\n handlerName: exportName,\n codeLocation: deriveCodeLocation(sourceFile, options.projectRoot),\n handler: deriveFunctionHandlerFunction(sourceFile, exportName),\n },\n };\n}\n\nfunction buildFunctionTypeAnnotations(\n annotations: Record<string, string | string[] | boolean>,\n definition: FunctionHandlerDefinition,\n): void {\n const meta = definition.metadata;\n\n switch (definition.type) {\n case \"http\": {\n const path = meta.path as string | undefined;\n const method = meta.method as string | undefined;\n if (path !== undefined && method !== undefined) {\n annotations[\"celerity.handler.http\"] = true;\n annotations[\"celerity.handler.http.method\"] = method;\n annotations[\"celerity.handler.http.path\"] = path;\n }\n break;\n }\n case \"websocket\": {\n annotations[\"celerity.handler.websocket\"] = true;\n const route = meta.route as string | undefined;\n if (route) {\n annotations[\"celerity.handler.websocket.route\"] = route;\n }\n break;\n }\n case \"consumer\": {\n annotations[\"celerity.handler.consumer\"] = true;\n const route = meta.route as string | undefined;\n if (route) {\n annotations[\"celerity.handler.consumer.route\"] = route;\n }\n break;\n }\n case \"schedule\": {\n annotations[\"celerity.handler.schedule\"] = true;\n const scheduleId = meta.scheduleId as string | undefined;\n if (scheduleId) {\n annotations[\"celerity.handler.schedule.scheduleId\"] = scheduleId;\n }\n const schedule = meta.schedule as string | undefined;\n if (schedule) {\n annotations[\"celerity.handler.schedule.expression\"] = schedule;\n }\n break;\n }\n case \"custom\": {\n annotations[\"celerity.handler.custom\"] = true;\n const name = meta.name as string | undefined;\n if (name) {\n annotations[\"celerity.handler.custom.name\"] = name;\n }\n break;\n }\n }\n}\n\n// ---------------------------------------------------------------------------\n// Guard serialization (unchanged)\n// ---------------------------------------------------------------------------\n\ntype GuardMeta = {\n guardName: string;\n customMetadata: Record<string, unknown>;\n};\n\nfunction extractGuardMeta(guardClass: Type): GuardMeta | null {\n const guardName: string | undefined = Reflect.getOwnMetadata(GUARD_CUSTOM_METADATA, guardClass);\n if (!guardName) return null;\n\n return {\n guardName,\n customMetadata: Reflect.getOwnMetadata(CUSTOM_METADATA, guardClass) ?? {},\n };\n}\n\nfunction serializeClassGuard(\n guardClass: Type,\n sourceFile: string,\n options: SerializeOptions,\n): GuardHandlerEntry | null {\n const meta = extractGuardMeta(guardClass);\n if (!meta) return null;\n\n const className = guardClass.name;\n const methodName = \"check\";\n const annotations: Record<string, string | string[] | boolean> = {\n \"celerity.handler.guard.custom\": meta.guardName,\n };\n\n for (const [key, value] of Object.entries(meta.customMetadata)) {\n if (value === undefined) continue;\n annotations[`celerity.handler.metadata.${key}`] = serializeAnnotationValue(value);\n }\n\n return {\n resourceName: deriveClassResourceName(className, methodName),\n guardName: meta.guardName,\n sourceFile,\n guardType: \"class\",\n className,\n annotations,\n spec: {\n handlerName: deriveClassHandlerName(className, methodName),\n codeLocation: deriveCodeLocation(sourceFile, options.projectRoot),\n handler: deriveClassHandlerFunction(sourceFile, className, methodName),\n },\n };\n}\n\nfunction serializeFunctionGuard(\n definition: GuardDefinition,\n sourceFile: string,\n options: SerializeOptions,\n): GuardHandlerEntry | null {\n const guardName = definition.name;\n if (!guardName) return null;\n\n const meta = (definition.metadata ?? {}) as {\n customMetadata?: Record<string, unknown>;\n };\n const customMetadata = meta.customMetadata ?? {};\n\n const annotations: Record<string, string | string[] | boolean> = {\n \"celerity.handler.guard.custom\": guardName,\n };\n\n for (const [key, value] of Object.entries(customMetadata)) {\n if (value === undefined) continue;\n annotations[`celerity.handler.metadata.${key}`] = serializeAnnotationValue(value);\n }\n\n const exportName = guardName;\n\n return {\n resourceName: deriveFunctionResourceName(exportName),\n guardName,\n sourceFile,\n guardType: \"function\",\n exportName,\n annotations,\n spec: {\n handlerName: exportName,\n codeLocation: deriveCodeLocation(sourceFile, options.projectRoot),\n handler: deriveFunctionHandlerFunction(sourceFile, exportName),\n },\n };\n}\n\n// ---------------------------------------------------------------------------\n// Utilities\n// ---------------------------------------------------------------------------\n\nfunction serializeAnnotationValue(value: unknown): string | string[] | boolean {\n if (typeof value === \"boolean\") return value;\n if (typeof value === \"string\") return value;\n if (Array.isArray(value) && value.every((v) => typeof v === \"string\")) {\n return value as string[];\n }\n return JSON.stringify(value);\n}\n\nexport function serializeToken(token: InjectionToken): string {\n if (typeof token === \"function\") return token.name;\n if (typeof token === \"symbol\") return token.description ?? \"Symbol()\";\n return token;\n}\n\nexport function tokenType(token: InjectionToken): \"class\" | \"string\" | \"symbol\" {\n if (typeof token === \"function\") return \"class\";\n if (typeof token === \"symbol\") return \"symbol\";\n return \"string\";\n}\n\nfunction serializeDependencyGraph(scanned: ScannedModule): DependencyGraph {\n const nodes: DependencyNode[] = scanned.providers.map((provider) => ({\n token: serializeToken(provider.token),\n tokenType: tokenType(provider.token),\n providerType: provider.providerType,\n dependencies: provider.dependencies.map(serializeToken),\n }));\n\n return { nodes };\n}\n","export { joinHandlerPath } from \"@celerity-sdk/common\";\n","import { basename, dirname, relative } from \"node:path\";\n\n/**\n * Derives a resource name for a class-based handler method.\n * Format: camelCase(className) + \"_\" + methodName\n *\n * @example deriveClassResourceName(\"OrdersHandler\", \"getOrder\") => \"ordersHandler_getOrder\"\n */\nexport function deriveClassResourceName(className: string, methodName: string): string {\n const camelClass = className.charAt(0).toLowerCase() + className.slice(1);\n return `${camelClass}_${methodName}`;\n}\n\n/**\n * Derives a handler name for a class-based handler method.\n * Format: className + \"-\" + methodName\n *\n * @example deriveClassHandlerName(\"OrdersHandler\", \"getOrder\") => \"OrdersHandler-getOrder\"\n */\nexport function deriveClassHandlerName(className: string, methodName: string): string {\n return `${className}-${methodName}`;\n}\n\n/**\n * Derives the handler function reference for a class-based handler.\n * Format: moduleBaseName + \".\" + className + \".\" + methodName\n *\n * @example deriveClassHandlerFunction(\"src/handlers/orders.ts\", \"OrdersHandler\", \"getOrder\")\n * => \"orders.OrdersHandler.getOrder\"\n */\nexport function deriveClassHandlerFunction(\n sourceFile: string,\n className: string,\n methodName: string,\n): string {\n const base = basename(sourceFile).replace(/\\.[^.]+$/, \"\");\n return `${base}.${className}.${methodName}`;\n}\n\n/**\n * Derives a resource name for a function-based handler.\n * Uses the export name directly.\n *\n * @example deriveFunctionResourceName(\"getOrder\") => \"getOrder\"\n */\nexport function deriveFunctionResourceName(exportName: string): string {\n return exportName;\n}\n\n/**\n * Derives the handler function reference for a function-based handler.\n * Format: moduleBaseName + \".\" + exportName\n *\n * @example deriveFunctionHandlerFunction(\"src/handlers/orders.ts\", \"getOrder\")\n * => \"orders.getOrder\"\n */\nexport function deriveFunctionHandlerFunction(sourceFile: string, exportName: string): string {\n const base = basename(sourceFile).replace(/\\.[^.]+$/, \"\");\n return `${base}.${exportName}`;\n}\n\n/**\n * Derives the code location from a source file path relative to the project root.\n * Returns the directory prefixed with \"./\"\n *\n * @example deriveCodeLocation(\"src/handlers/orders.ts\", \"/project\") => \"./src/handlers\"\n */\nexport function deriveCodeLocation(sourceFile: string, projectRoot: string): string {\n const rel = relative(projectRoot, sourceFile);\n const dir = dirname(rel);\n return dir === \".\" ? \"./\" : `./${dir}`;\n}\n"],"mappings":"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","names":["createDebug","buildModuleGraph","getClassDependencyTokens","getProviderDependencyTokens","debug","createDebug","scanProvider","provider","seenTokens","has","add","token","providerType","dependencies","getClassDependencyTokens","typed","provide","getProviderDependencyTokens","buildScannedModule","rootModule","graph","buildModuleGraph","controllerClasses","functionHandlers","guardClasses","functionGuards","providers","Set","moduleClass","node","name","length","controllers","guards","scanned","push","controller","guard","validateScannedDependencies","registeredTokens","map","p","diagnostics","visited","walk","deps","dep","find","consumer","serializeToken","dependency","description","String","CONTROLLER_METADATA","HTTP_METHOD_METADATA","ROUTE_PATH_METADATA","WEBSOCKET_CONTROLLER_METADATA","WEBSOCKET_EVENT_METADATA","CONSUMER_METADATA","CONSUMER_HANDLER_METADATA","SCHEDULE_HANDLER_METADATA","INVOKE_METADATA","GUARD_PROTECTEDBY_METADATA","GUARD_CUSTOM_METADATA","PUBLIC_METADATA","CUSTOM_METADATA","USE_RESOURCE_METADATA","joinHandlerPath","basename","dirname","relative","deriveClassResourceName","className","methodName","camelClass","charAt","toLowerCase","slice","deriveClassHandlerName","deriveClassHandlerFunction","sourceFile","base","basename","replace","deriveFunctionResourceName","exportName","deriveFunctionHandlerFunction","deriveCodeLocation","projectRoot","rel","relative","dir","dirname","serializeManifest","scanned","sourceFile","options","handlers","functionHandlers","guardHandlers","controllerClass","controllerClasses","entries","serializeClassHandlers","push","fnHandler","entry","serializeFunctionHandler","guardClass","guardClasses","serializeClassGuard","fnGuard","functionGuards","serializeFunctionGuard","version","dependencyGraph","serializeDependencyGraph","extractControllerMeta","httpMeta","Reflect","getOwnMetadata","CONTROLLER_METADATA","controllerType","prefix","extractSharedClassMeta","isWebSocket","WEBSOCKET_CONTROLLER_METADATA","consumerMeta","CONSUMER_METADATA","sourceId","protectedBy","GUARD_PROTECTEDBY_METADATA","customGuardName","GUARD_CUSTOM_METADATA","customMetadata","CUSTOM_METADATA","resourceRefs","USE_RESOURCE_METADATA","appendSharedAnnotations","annotations","meta","prototype","methodName","methodProtectedBy","allProtectedBy","length","isPublic","PUBLIC_METADATA","methodCustomMetadata","key","value","Object","undefined","serializeAnnotationValue","methodResourceRefs","allResourceRefs","Set","buildHttpAnnotations","httpMethod","fullPath","buildWebSocketAnnotations","wsEvent","route","eventType","buildConsumerAnnotations","consumerHandler","buildScheduleAnnotations","scheduleMeta","scheduleId","schedule","buildCustomAnnotations","invokeMeta","name","className","methods","getOwnPropertyNames","filter","n","typeEntry","serializeControllerTypeMethod","SCHEDULE_HANDLER_METADATA","resourceName","deriveClassResourceName","handlerType","spec","handlerName","deriveClassHandlerName","codeLocation","deriveCodeLocation","projectRoot","handler","deriveClassHandlerFunction","INVOKE_METADATA","serializeHttpMethod","serializeWebSocketMethod","serializeConsumerMethod","HTTP_METHOD_METADATA","routePath","ROUTE_PATH_METADATA","joinHandlerPath","WEBSOCKET_EVENT_METADATA","CONSUMER_HANDLER_METADATA","definition","supported","includes","type","exportName","metadata","buildFunctionTypeAnnotations","deriveFunctionResourceName","keys","deriveFunctionHandlerFunction","path","method","extractGuardMeta","guardName","guardType","Array","isArray","every","v","JSON","stringify","serializeToken","token","description","tokenType","nodes","providers","map","provider","providerType","dependencies"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@celerity-sdk/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Build-time extraction tool for Celerity decorator metadata",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
@@ -38,9 +38,9 @@
|
|
|
38
38
|
"dependencies": {
|
|
39
39
|
"debug": "^4.4.0",
|
|
40
40
|
"reflect-metadata": "^0.2.0",
|
|
41
|
-
"@celerity-sdk/
|
|
42
|
-
"@celerity-sdk/
|
|
43
|
-
"@celerity-sdk/
|
|
41
|
+
"@celerity-sdk/types": "^0.4.0",
|
|
42
|
+
"@celerity-sdk/common": "^0.4.0",
|
|
43
|
+
"@celerity-sdk/core": "^0.4.0"
|
|
44
44
|
},
|
|
45
45
|
"devDependencies": {
|
|
46
46
|
"ajv": "^8.17.0"
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
-
"$id": "https://celerityframework.
|
|
3
|
+
"$id": "https://celerityframework.io/schemas/handler-manifest.v1.schema.json",
|
|
4
4
|
"title": "Celerity Handler Manifest",
|
|
5
|
-
"description": "Output schema for
|
|
5
|
+
"description": "Output schema for Celerity language-specific extractor tools. Describes all handlers discovered in a Celerity application module via language-specific metadata scanning. Consumed by the Celerity CLI to merge with blueprint infrastructure configuration.",
|
|
6
6
|
"type": "object",
|
|
7
|
-
"required": ["version", "handlers", "functionHandlers", "dependencyGraph"],
|
|
7
|
+
"required": ["version", "handlers", "functionHandlers", "guardHandlers", "dependencyGraph"],
|
|
8
8
|
"additionalProperties": false,
|
|
9
9
|
"properties": {
|
|
10
10
|
"version": {
|
|
@@ -13,14 +13,19 @@
|
|
|
13
13
|
},
|
|
14
14
|
"handlers": {
|
|
15
15
|
"type": "array",
|
|
16
|
-
"description": "Class-based handlers discovered from
|
|
16
|
+
"description": "Class-based handlers discovered from annotated controller or consumer classes.",
|
|
17
17
|
"items": { "$ref": "#/$defs/ClassHandlerEntry" }
|
|
18
18
|
},
|
|
19
19
|
"functionHandlers": {
|
|
20
20
|
"type": "array",
|
|
21
|
-
"description": "Function-based handlers registered via
|
|
21
|
+
"description": "Function-based handlers registered via framework-provided handler registration functions.",
|
|
22
22
|
"items": { "$ref": "#/$defs/FunctionHandlerEntry" }
|
|
23
23
|
},
|
|
24
|
+
"guardHandlers": {
|
|
25
|
+
"type": "array",
|
|
26
|
+
"description": "Guard handlers discovered from annotated guard classes or guard registration functions.",
|
|
27
|
+
"items": { "$ref": "#/$defs/GuardHandlerEntry" }
|
|
28
|
+
},
|
|
24
29
|
"dependencyGraph": { "$ref": "#/$defs/DependencyGraph" }
|
|
25
30
|
},
|
|
26
31
|
"$defs": {
|
|
@@ -37,7 +42,7 @@
|
|
|
37
42
|
},
|
|
38
43
|
"Annotations": {
|
|
39
44
|
"type": "object",
|
|
40
|
-
"description": "Key-value annotations using the 'celerity.handler.*' namespace. Well-known keys:\n- celerity.handler.http (boolean) — true if this is an HTTP handler\n- celerity.handler.http.method (string) — HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)\n- celerity.handler.http.path (string) — full route path using {param} format\n- celerity.handler.guard.protectedBy (string[]) — guard names protecting this handler\n- celerity.handler.guard.custom (string) — custom guard name from
|
|
45
|
+
"description": "Key-value annotations using the 'celerity.handler.*' namespace. Well-known keys:\n- celerity.handler.http (boolean) — true if this is an HTTP handler\n- celerity.handler.http.method (string) — HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)\n- celerity.handler.http.path (string) — full route path using {param} format\n- celerity.handler.websocket (boolean) — true if this is a WebSocket handler\n- celerity.handler.websocket.route (string) — WebSocket route path\n- celerity.handler.websocket.eventType (string) — WebSocket event type (connect, message, disconnect)\n- celerity.handler.consumer (boolean) — true if this is a consumer handler\n- celerity.handler.consumer.sourceId (string) — consumer source identifier\n- celerity.handler.consumer.route (string) — consumer route path\n- celerity.handler.schedule (boolean) — true if this is a schedule handler\n- celerity.handler.schedule.scheduleId (string) — schedule identifier\n- celerity.handler.schedule.expression (string) — schedule expression (e.g. rate(1 day), cron(...))\n- celerity.handler.custom (boolean) — true if this is a custom/invocable handler\n- celerity.handler.custom.name (string) — custom handler name\n- celerity.handler.guard.protectedBy (string[]) — guard names protecting this handler\n- celerity.handler.guard.custom (string) — custom guard name from guard annotations\n- celerity.handler.public (boolean) — true if handler opts out of guards\n- celerity.handler.metadata.* (any annotation value) — user-defined metadata annotations",
|
|
41
46
|
"additionalProperties": { "$ref": "#/$defs/AnnotationValue" }
|
|
42
47
|
},
|
|
43
48
|
"ClassHandlerSpec": {
|
|
@@ -87,7 +92,7 @@
|
|
|
87
92
|
},
|
|
88
93
|
"ClassHandlerEntry": {
|
|
89
94
|
"type": "object",
|
|
90
|
-
"description": "A single handler method discovered from
|
|
95
|
+
"description": "A single handler method discovered from an annotated controller or consumer class.",
|
|
91
96
|
"required": ["resourceName", "className", "methodName", "sourceFile", "handlerType", "annotations", "spec"],
|
|
92
97
|
"additionalProperties": false,
|
|
93
98
|
"properties": {
|
|
@@ -109,8 +114,8 @@
|
|
|
109
114
|
},
|
|
110
115
|
"handlerType": {
|
|
111
116
|
"type": "string",
|
|
112
|
-
"enum": ["http", "websocket", "consumer", "schedule"],
|
|
113
|
-
"description": "The type of handler, derived from the
|
|
117
|
+
"enum": ["http", "websocket", "consumer", "schedule", "custom"],
|
|
118
|
+
"description": "The type of handler, derived from the handler's annotations."
|
|
114
119
|
},
|
|
115
120
|
"annotations": { "$ref": "#/$defs/Annotations" },
|
|
116
121
|
"spec": { "$ref": "#/$defs/ClassHandlerSpec" }
|
|
@@ -118,8 +123,8 @@
|
|
|
118
123
|
},
|
|
119
124
|
"FunctionHandlerEntry": {
|
|
120
125
|
"type": "object",
|
|
121
|
-
"description": "A function-based handler registered via
|
|
122
|
-
"required": ["resourceName", "exportName", "sourceFile", "spec"],
|
|
126
|
+
"description": "A function-based handler registered via a framework-provided handler registration function.",
|
|
127
|
+
"required": ["resourceName", "exportName", "sourceFile", "handlerType", "spec"],
|
|
123
128
|
"additionalProperties": false,
|
|
124
129
|
"properties": {
|
|
125
130
|
"resourceName": {
|
|
@@ -134,10 +139,50 @@
|
|
|
134
139
|
"type": "string",
|
|
135
140
|
"description": "Absolute path to the source file containing the handler."
|
|
136
141
|
},
|
|
142
|
+
"handlerType": {
|
|
143
|
+
"type": "string",
|
|
144
|
+
"enum": ["http", "websocket", "consumer", "schedule", "custom"],
|
|
145
|
+
"description": "The type of handler."
|
|
146
|
+
},
|
|
137
147
|
"annotations": { "$ref": "#/$defs/Annotations" },
|
|
138
148
|
"spec": { "$ref": "#/$defs/FunctionHandlerSpec" }
|
|
139
149
|
}
|
|
140
150
|
},
|
|
151
|
+
"GuardHandlerEntry": {
|
|
152
|
+
"type": "object",
|
|
153
|
+
"description": "A guard handler discovered from an annotated guard class or a guard registration function.",
|
|
154
|
+
"required": ["resourceName", "guardName", "sourceFile", "guardType", "annotations", "spec"],
|
|
155
|
+
"additionalProperties": false,
|
|
156
|
+
"properties": {
|
|
157
|
+
"resourceName": {
|
|
158
|
+
"type": "string",
|
|
159
|
+
"description": "Blueprint resource name for the guard."
|
|
160
|
+
},
|
|
161
|
+
"guardName": {
|
|
162
|
+
"type": "string",
|
|
163
|
+
"description": "The guard name as declared via the guard annotation or registration function."
|
|
164
|
+
},
|
|
165
|
+
"sourceFile": {
|
|
166
|
+
"type": "string",
|
|
167
|
+
"description": "Absolute path to the source file containing the guard."
|
|
168
|
+
},
|
|
169
|
+
"guardType": {
|
|
170
|
+
"type": "string",
|
|
171
|
+
"enum": ["class", "function"],
|
|
172
|
+
"description": "Whether this guard was defined as a class or a function."
|
|
173
|
+
},
|
|
174
|
+
"className": {
|
|
175
|
+
"type": "string",
|
|
176
|
+
"description": "Name of the guard class. Present for class-based guards only."
|
|
177
|
+
},
|
|
178
|
+
"exportName": {
|
|
179
|
+
"type": "string",
|
|
180
|
+
"description": "The named export used to register this guard. Present for function-based guards only."
|
|
181
|
+
},
|
|
182
|
+
"annotations": { "$ref": "#/$defs/Annotations" },
|
|
183
|
+
"spec": { "$ref": "#/$defs/ClassHandlerSpec" }
|
|
184
|
+
}
|
|
185
|
+
},
|
|
141
186
|
"DependencyNode": {
|
|
142
187
|
"type": "object",
|
|
143
188
|
"description": "A provider or controller in the DI dependency graph.",
|