@forinda/kickjs 0.1.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 +173 -0
- package/dist/index.d.ts +248 -0
- package/dist/index.js +1099 -0
- package/dist/index.js.map +1 -0
- package/package.json +62 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/decorators/http.ts","../src/utils/errors.ts","../src/core/base-controller.ts","../src/core/request-tracker.ts","../src/utils/injection.ts","../src/utils/reactive.ts","../src/shared/types.ts","../src/core/diagnostics.ts","../src/core/application.ts","../src/core/server.ts","../src/infrastructure/container.ts","../src/utils/logger.ts","../src/shared/config.ts"],"sourcesContent":["export {\n Controller,\n Get,\n Post,\n Put,\n Patch,\n Delete,\n listRegisteredControllers,\n registerController,\n resetControllerRegistry\n} from './decorators/http';\nexport type { RouteOptions, RouteValidation, ControllerConstructor } from './decorators/http';\n\nexport { BaseController } from './core/base-controller';\nexport { RequestTracker } from './core/request-tracker';\nexport { AppDiagnostics } from './core/diagnostics';\nexport { createApp, bootstrap } from './core/application';\nexport type { CreateAppOptions, CreateAppResult, BootstrapOptions, BootstrapContext } from './core/application';\n\nexport {\n configureApp,\n getAppConfig,\n resolveConfig,\n resetAppConfig\n} from './shared/config';\nexport type { AppConfig, ResolvedAppConfig } from './shared/config';\n\nexport { TYPES } from './shared/types';\nexport type { AppState, RequestState, RequestLogEntry } from './shared/types';\n\nexport { createError, AppError, isAppError } from './utils/errors';\nexport type { AppErrorOptions } from './utils/errors';\n\nexport {\n Inject,\n Injectable,\n MultiInject,\n Named,\n Optional,\n Tagged,\n Unmanaged\n} from './utils/injection';\nexport type { BindingIdentifier } from './utils/injection';\n","import 'reflect-metadata';\nimport type { RequestHandler } from 'express';\n\nexport type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';\n\nexport interface ControllerOptions {\n path?: string;\n autoRegister?: boolean;\n tags?: string[];\n}\n\nexport interface ControllerMetadata {\n basePath: string;\n tags?: string[];\n}\n\nexport type SchemaLike = {\n safeParse?: (data: unknown) => { success: boolean; data?: unknown; error?: unknown };\n parse?: (data: unknown) => unknown;\n validate?: (\n data: unknown,\n options?: Record<string, unknown>\n ) => { error?: { details?: Array<{ message: string }> }; value: unknown };\n};\n\nexport interface RouteValidation {\n params?: SchemaLike;\n query?: SchemaLike;\n body?: SchemaLike;\n}\n\nexport interface RouteOptions {\n path?: string;\n middlewares?: RequestHandler[];\n validate?: RouteValidation;\n}\n\nexport interface RouteDefinition {\n method: HttpMethod;\n path: string;\n propertyKey: string | symbol;\n middlewares: RequestHandler[];\n validation?: RouteValidation;\n}\n\nexport type ControllerConstructor<T = unknown> = new (...args: never[]) => T;\n\nconst CONTROLLER_KEY = Symbol('core:controller');\nconst ROUTES_KEY = Symbol('core:routes');\n\nconst controllerRegistry = new Set<ControllerConstructor>();\n\nexport function Controller(pathOrOptions: string | ControllerOptions = '/') {\n const options = normalizeControllerOptions(pathOrOptions);\n\n return function <T extends ControllerConstructor>(target: T) {\n Reflect.defineMetadata(\n CONTROLLER_KEY,\n {\n basePath: options.path,\n tags: options.tags\n } satisfies ControllerMetadata,\n target\n );\n\n if (!Reflect.hasMetadata(ROUTES_KEY, target)) {\n Reflect.defineMetadata(ROUTES_KEY, [] as RouteDefinition[], target);\n }\n\n if (options.autoRegister !== false) {\n controllerRegistry.add(target);\n }\n };\n}\n\nexport function Get(path?: string | RouteOptions, ...middlewares: RequestHandler[]) {\n return createRouteDecorator('get')(path, ...middlewares);\n}\n\nexport function Post(path?: string | RouteOptions, ...middlewares: RequestHandler[]) {\n return createRouteDecorator('post')(path, ...middlewares);\n}\n\nexport function Put(path?: string | RouteOptions, ...middlewares: RequestHandler[]) {\n return createRouteDecorator('put')(path, ...middlewares);\n}\n\nexport function Patch(path?: string | RouteOptions, ...middlewares: RequestHandler[]) {\n return createRouteDecorator('patch')(path, ...middlewares);\n}\n\nexport function Delete(path?: string | RouteOptions, ...middlewares: RequestHandler[]) {\n return createRouteDecorator('delete')(path, ...middlewares);\n}\n\nexport function listRegisteredControllers(): ControllerConstructor[] {\n return Array.from(controllerRegistry);\n}\n\nexport function registerController(controller: ControllerConstructor) {\n controllerRegistry.add(controller);\n}\n\nexport function resetControllerRegistry() {\n controllerRegistry.clear();\n}\n\nexport const DecoratorMetadata = {\n CONTROLLER_KEY,\n ROUTES_KEY\n} as const;\n\nfunction createRouteDecorator(method: HttpMethod) {\n return (pathOrOptions?: string | RouteOptions, ...middlewares: RequestHandler[]) =>\n function (target: object, propertyKey: string | symbol) {\n const controller = target.constructor;\n const routes: RouteDefinition[] = Reflect.getMetadata(ROUTES_KEY, controller) ?? [];\n const normalized = normalizeRouteOptions(pathOrOptions, middlewares);\n routes.push({\n method,\n path: normalized.path,\n propertyKey,\n middlewares: normalized.middlewares,\n validation: normalized.validation\n });\n Reflect.defineMetadata(ROUTES_KEY, routes, controller);\n };\n}\n\nfunction normalizeControllerOptions(pathOrOptions: string | ControllerOptions): Required<ControllerOptions> {\n if (typeof pathOrOptions === 'string') {\n return {\n path: normalizePath(pathOrOptions),\n autoRegister: true,\n tags: []\n };\n }\n\n return {\n path: normalizePath(pathOrOptions.path ?? '/'),\n autoRegister: pathOrOptions.autoRegister ?? true,\n tags: pathOrOptions.tags ?? []\n };\n}\n\nfunction normalizeRouteOptions(pathOrOptions: string | RouteOptions | undefined, extraMiddlewares: RequestHandler[]) {\n const base: RouteOptions = normalizeRouteOptionObject(pathOrOptions);\n const middlewares = [...(base.middlewares ?? []), ...extraMiddlewares];\n\n return {\n path: normalizeRoutePath(base.path ?? '/'),\n middlewares,\n validation: base.validate\n };\n}\n\nfunction normalizeRouteOptionObject(pathOrOptions: string | RouteOptions | undefined): RouteOptions {\n if (typeof pathOrOptions === 'string') {\n return { path: pathOrOptions };\n }\n\n if (typeof pathOrOptions === 'object' && pathOrOptions !== null) {\n return { ...pathOrOptions };\n }\n\n return {};\n}\n\nfunction normalizePath(path: string) {\n if (!path || path === '/') {\n return '/';\n }\n\n const withLeading = path.startsWith('/') ? path : `/${path}`;\n return withLeading.endsWith('/') && withLeading !== '/' ? withLeading.slice(0, -1) : withLeading;\n}\n\nfunction normalizeRoutePath(path: string) {\n if (!path || path === '/') {\n return '';\n }\n\n const cleaned = path.startsWith('/') ? path.slice(1) : path;\n return cleaned.endsWith('/') ? cleaned.slice(0, -1) : cleaned;\n}\n","export interface AppErrorOptions {\n status?: number;\n cause?: unknown;\n details?: Record<string, unknown>;\n}\n\nexport class AppError extends Error {\n readonly code: string;\n readonly status?: number;\n readonly details?: Record<string, unknown>;\n\n constructor(code: string, message: string, options: AppErrorOptions = {}) {\n super(message);\n this.code = code;\n this.status = options.status;\n this.details = options.details;\n\n if (options.cause) {\n // @ts-expect-error cause is standard on Error but not typed in older TS libs\n this.cause = options.cause;\n }\n\n this.name = 'AppError';\n }\n}\n\nexport function createError(code: string, message: string, options: AppErrorOptions = {}) {\n return new AppError(code, message, options);\n}\n\nexport function isAppError(error: unknown): error is AppError {\n return error instanceof AppError;\n}\n","import type { Response } from 'express';\nimport { createError, type AppErrorOptions } from '../utils/errors';\nimport { RequestTracker } from './request-tracker';\nimport type { RequestState } from '../shared/types';\n\nexport abstract class BaseController {\n protected constructor(private readonly requestTracker: RequestTracker) {}\n\n protected abstract controllerId(): string;\n\n protected ok<T>(res: Response, payload: T) {\n return this.respond(res, 200, payload);\n }\n\n protected created<T>(res: Response, payload: T) {\n return this.respond(res, 201, payload);\n }\n\n protected accepted<T>(res: Response, payload: T) {\n return this.respond(res, 202, payload);\n }\n\n protected noContent(res: Response) {\n return this.respond(res, 204);\n }\n\n protected respond<T>(res: Response, status: number, payload?: T) {\n this.requestTracker.recordResponse(res, status, payload);\n if (payload === undefined) {\n res.status(status).end();\n } else {\n res.status(status).json(payload);\n }\n return res;\n }\n\n protected logDebug(res: Response, message: string, metadata?: Record<string, unknown>) {\n this.requestTracker.log(res, `[${this.controllerId()}] ${message}`, 'debug', metadata);\n }\n\n protected logInfo(res: Response, message: string, metadata?: Record<string, unknown>) {\n this.requestTracker.log(res, `[${this.controllerId()}] ${message}`, 'info', metadata);\n }\n\n protected logWarn(res: Response, message: string, metadata?: Record<string, unknown>) {\n this.requestTracker.log(res, `[${this.controllerId()}] ${message}`, 'warn', metadata);\n }\n\n protected logError(res: Response, message: string, metadata?: Record<string, unknown>) {\n this.requestTracker.log(res, `[${this.controllerId()}] ${message}`, 'error', metadata);\n }\n\n protected mergeRequestMetadata(res: Response, patch: Record<string, unknown>) {\n const current = this.requestTracker.get(res)?.state.metadata[this.controllerId()];\n const currentRecord = typeof current === 'object' && current !== null ? (current as Record<string, unknown>) : {};\n\n const namespacedPatch: Record<string, unknown> = {\n [this.controllerId()]: {\n ...currentRecord,\n ...patch\n }\n };\n\n this.requestTracker.mergeMetadata(res, namespacedPatch);\n }\n\n protected getRequestState(res: Response): RequestState | undefined {\n return this.requestTracker.get(res)?.state;\n }\n\n protected fail(code: string, message: string, options?: AppErrorOptions): never {\n throw createError(code, message, options);\n }\n}\n","import { randomUUID } from 'node:crypto';\nimport type { NextFunction, Request, Response } from 'express';\nimport { Inject, Injectable } from '../utils/injection';\nimport { createReactive, type Reactive, type ReactiveRegistry } from '../utils/reactive';\nimport { TYPES, type RequestLogEntry, type RequestState } from '../shared/types';\nimport type { ResolvedAppConfig } from '../shared/config';\nimport type { AppLogger } from '../utils/logger';\nimport { isAppError } from '../utils/errors';\n\ndeclare module 'express-serve-static-core' {\n interface Locals {\n requestState?: Reactive<RequestState>;\n }\n}\n\n@Injectable()\nexport class RequestTracker {\n constructor(\n @Inject(TYPES.StateRegistry) private readonly registry: ReactiveRegistry,\n @Inject(TYPES.Config) private readonly config: ResolvedAppConfig,\n @Inject(TYPES.Logger) private readonly logger: AppLogger\n ) {}\n\n middleware() {\n return (req: Request, res: Response, next: NextFunction) => {\n const id = randomUUID();\n const requestState = createReactive<RequestState>(\n {\n id,\n method: req.method,\n path: req.originalUrl ?? req.url,\n startedAt: Date.now(),\n logs: [],\n metadata: {}\n },\n {\n id,\n label: `request:${req.method} ${req.originalUrl ?? req.url}`,\n registry: this.registry,\n trackHistory: this.config.telemetry.trackReactiveHistory,\n maxHistory: this.config.telemetry.requestHistoryLimit\n }\n );\n\n res.locals.requestState = requestState;\n\n req.on('error', (error: Error) => {\n this.recordError(res, error);\n });\n\n res.on('finish', () => {\n this.finalise(res);\n });\n\n res.on('close', () => {\n this.finalise(res);\n });\n\n res.on('error', (error: Error) => {\n this.recordError(res, error);\n });\n\n next();\n };\n }\n\n get(res: Response): Reactive<RequestState> | undefined {\n return res.locals.requestState;\n }\n\n log(res: Response, message: string, level: RequestLogEntry['level'] = 'info', metadata?: Record<string, unknown>) {\n const store = this.get(res);\n if (!store) {\n return;\n }\n\n const entry: RequestLogEntry = {\n timestamp: Date.now(),\n level,\n message,\n metadata\n };\n\n store.state.logs = [...store.state.logs, entry];\n\n this.dispatchLog(level, `[${store.state.method} ${store.state.path}] ${message}`, {\n requestId: store.state.id,\n ...metadata\n });\n }\n\n mergeMetadata(res: Response, patch: Record<string, unknown>) {\n const store = this.get(res);\n if (!store) {\n return;\n }\n\n store.state.metadata = {\n ...store.state.metadata,\n ...patch\n };\n }\n\n recordResponse(res: Response, status: number, payload?: unknown) {\n const store = this.get(res);\n if (!store) {\n return;\n }\n\n store.state.status = status;\n store.state.response = payload;\n }\n\n recordError(res: Response, error: unknown) {\n const store = this.get(res);\n if (!store) {\n return;\n }\n\n const errorMessage = error instanceof Error ? error.message : String(error);\n store.state.error = errorMessage;\n if (isAppError(error)) {\n store.state.errorCode = error.code;\n this.mergeMetadata(res, { errorCode: error.code, errorDetails: error.details });\n }\n\n this.log(res, errorMessage, 'error', {\n errorCode: isAppError(error) ? error.code : undefined\n });\n }\n\n private finalise(res: Response) {\n const store = this.get(res);\n if (!store) {\n return;\n }\n\n store.state.status = res.statusCode;\n store.state.endedAt = Date.now();\n store.state.durationMs = store.state.endedAt - store.state.startedAt;\n\n this.dispatchLog('debug', `Request completed with ${res.statusCode}`, {\n requestId: store.state.id,\n durationMs: store.state.durationMs\n });\n }\n\n private dispatchLog(level: RequestLogEntry['level'], message: string, metadata?: Record<string, unknown>) {\n switch (level) {\n case 'debug':\n this.logger.debug(message, metadata);\n break;\n case 'info':\n this.logger.info(message, metadata);\n break;\n case 'warn':\n this.logger.warn(message, metadata);\n break;\n case 'error':\n this.logger.error(message, metadata);\n break;\n }\n }\n}\n","import type { ServiceIdentifier as InversifyServiceIdentifier } from 'inversify';\nimport {\n inject as inversifyInject,\n injectable as inversifyInjectable,\n multiInject as inversifyMultiInject,\n named as inversifyNamed,\n optional as inversifyOptional,\n tagged as inversifyTagged,\n unmanaged as inversifyUnmanaged\n} from 'inversify';\n\nexport type BindingIdentifier<T = unknown> = InversifyServiceIdentifier<T>;\n\nexport function Injectable(): ClassDecorator;\nexport function Injectable(): ClassDecorator {\n return inversifyInjectable();\n}\n\nexport function Inject<T = unknown>(identifier: BindingIdentifier<T>) {\n return inversifyInject(identifier);\n}\n\nexport function Optional() {\n return inversifyOptional();\n}\n\nexport function MultiInject<T = unknown>(identifier: BindingIdentifier<T>) {\n return inversifyMultiInject(identifier);\n}\n\nexport function Named(name: string | number | symbol) {\n return inversifyNamed(name);\n}\n\nexport function Tagged(metadataKey: string | number | symbol, metadataValue: unknown) {\n return inversifyTagged(metadataKey, metadataValue);\n}\n\nexport function Unmanaged() {\n return inversifyUnmanaged();\n}\n","import { randomUUID } from 'node:crypto';\n\nexport interface ReactiveChangeDetails<TState> {\n property: keyof TState;\n value: TState[keyof TState];\n previous: TState[keyof TState];\n timestamp: number;\n}\n\nexport type ReactiveWatcher<TState> = (state: TState, details: ReactiveChangeDetails<TState>) => void;\n\nexport interface Reactive<TState> {\n readonly id: string;\n readonly label?: string;\n state: TState;\n watch(watcher: ReactiveWatcher<TState>): () => void;\n snapshot(): TState;\n history(): ReactiveChangeDetails<TState>[];\n}\n\nexport interface CreateReactiveOptions {\n id?: string;\n label?: string;\n registry?: ReactiveRegistry;\n trackHistory?: boolean;\n maxHistory?: number;\n}\n\nexport class ReactiveRegistry {\n private readonly stores = new Map<string, Reactive<unknown>>();\n\n register<TState>(store: Reactive<TState>) {\n this.stores.set(store.id, store as Reactive<unknown>);\n }\n\n unregister(id: string) {\n this.stores.delete(id);\n }\n\n get<TState>(id: string): Reactive<TState> | undefined {\n return this.stores.get(id) as Reactive<TState> | undefined;\n }\n\n list() {\n return Array.from(this.stores.values()).map((store) => ({\n id: store.id,\n label: store.label,\n snapshot: store.snapshot(),\n history: store.history()\n }));\n }\n}\n\nexport function createReactive<TState extends Record<string, unknown>>(\n initial: TState,\n options: CreateReactiveOptions = {}\n): Reactive<TState> {\n const listeners = new Set<ReactiveWatcher<TState>>();\n const target = { ...initial } as TState;\n const history: ReactiveChangeDetails<TState>[] = [];\n const historyEnabled = options.trackHistory ?? true;\n const maxHistory = options.maxHistory ?? 100;\n const reactiveId = options.id ?? randomUUID();\n\n const proxy = new Proxy(target, {\n set(current, prop: string | symbol, value) {\n if (typeof prop === 'symbol') {\n return Reflect.set(current, prop, value);\n }\n\n const typedProp = prop as keyof TState;\n const previous = current[typedProp];\n const didChange = previous !== value;\n const result = Reflect.set(current, typedProp, value);\n\n if (didChange) {\n const change: ReactiveChangeDetails<TState> = {\n property: typedProp,\n value: value as TState[keyof TState],\n previous,\n timestamp: Date.now()\n };\n\n if (historyEnabled) {\n history.push(change);\n if (history.length > maxHistory) {\n history.shift();\n }\n }\n\n listeners.forEach((listener) => listener(proxy, change));\n }\n\n return result;\n }\n });\n\n const store: Reactive<TState> = {\n id: reactiveId,\n label: options.label,\n state: proxy,\n watch(watcher) {\n listeners.add(watcher);\n return () => listeners.delete(watcher);\n },\n snapshot() {\n return structuredClone(target);\n },\n history() {\n return historyEnabled ? [...history] : [];\n }\n };\n\n options.registry?.register(store);\n\n return store;\n}\n","export const TYPES = {\n AppState: Symbol.for('kick:AppState'),\n Config: Symbol.for('kick:Config'),\n Diagnostics: Symbol.for('kick:Diagnostics'),\n Logger: Symbol.for('kick:Logger'),\n StateRegistry: Symbol.for('kick:StateRegistry'),\n RequestTracker: Symbol.for('kick:RequestTracker')\n} as const;\n\nexport interface AppState extends Record<string, unknown> {\n bootedAt: number;\n metadata: Record<string, unknown>;\n}\n\nexport interface RequestLogEntry {\n timestamp: number;\n level: 'debug' | 'info' | 'warn' | 'error';\n message: string;\n metadata?: Record<string, unknown>;\n}\n\nexport interface RequestState extends Record<string, unknown> {\n id: string;\n method: string;\n path: string;\n status?: number;\n startedAt: number;\n endedAt?: number;\n durationMs?: number;\n error?: string;\n errorCode?: string;\n response?: unknown;\n logs: RequestLogEntry[];\n metadata: Record<string, unknown>;\n}\n","import { Inject, Injectable } from '../utils/injection';\nimport { ReactiveRegistry } from '../utils/reactive';\nimport { TYPES, type RequestState } from '../shared/types';\nimport type { ResolvedAppConfig } from '../shared/config';\n\nexport interface StoreSnapshot {\n id: string;\n label?: string;\n snapshot: Record<string, unknown>;\n history: ReadonlyArray<unknown>;\n}\n\nexport interface RequestSnapshot extends RequestState {}\n\n@Injectable()\nexport class AppDiagnostics {\n constructor(\n @Inject(TYPES.StateRegistry) private readonly registry: ReactiveRegistry,\n @Inject(TYPES.Config) private readonly config: ResolvedAppConfig\n ) {}\n\n settings() {\n return this.config;\n }\n\n stores(): StoreSnapshot[] {\n return this.registry.list().map((entry) => ({\n id: entry.id,\n label: entry.label,\n snapshot: entry.snapshot as Record<string, unknown>,\n history: entry.history\n }));\n }\n\n requests(): RequestSnapshot[] {\n return this.registry\n .list()\n .filter((entry) => entry.label?.startsWith('request:'))\n .map((entry) => entry.snapshot as RequestSnapshot);\n }\n}\n","import 'reflect-metadata';\nimport express, { type Application, type NextFunction, type Request, type Response } from 'express';\nimport type { Server } from 'http';\nimport type { Container } from 'inversify';\nimport { AppDiagnostics } from './diagnostics';\nimport { RequestTracker } from './request-tracker';\nimport { registerControllers } from './server';\nimport { buildContainer } from '../infrastructure/container';\nimport { resolveConfig, type AppConfig, type ResolvedAppConfig } from '../shared/config';\nimport { TYPES } from '../shared/types';\nimport { createError, isAppError } from '../utils/errors';\n\nexport interface CreateAppOptions {\n controllers?: Array<new (...args: never[]) => unknown>;\n container?: Container;\n additionalMiddleware?: Array<(req: Request, res: Response, next: NextFunction) => void>;\n config?: AppConfig;\n configureContainer?: (container: Container) => void;\n}\n\nexport interface CreateAppResult {\n app: Application;\n container: Container;\n requestTracker: RequestTracker;\n diagnostics: AppDiagnostics;\n config: ResolvedAppConfig;\n}\n\nexport interface BootstrapOptions extends CreateAppOptions {\n port?: number | string;\n}\n\nexport interface BootstrapContext {\n app: Application;\n server: Server;\n container: Container;\n requestTracker: RequestTracker;\n diagnostics: AppDiagnostics;\n config: ResolvedAppConfig;\n shutdown(): void;\n}\n\nexport function createApp(options: CreateAppOptions = {}): CreateAppResult {\n const config = resolveConfig(options.config);\n const container = options.container ?? buildContainer(config);\n\n options.configureContainer?.(container);\n\n const app = express();\n const requestTracker = container.get<RequestTracker>(TYPES.RequestTracker);\n const diagnostics = container.get<AppDiagnostics>(TYPES.Diagnostics);\n\n app.use(express.json());\n\n options.additionalMiddleware?.forEach((middleware) => {\n app.use(middleware);\n });\n\n app.use(requestTracker.middleware());\n\n registerControllers(app, container, {\n controllers: options.controllers,\n prefix: config.prefix\n });\n\n if (config.healthEndpoint !== false) {\n app.get(config.healthEndpoint, (_req, res) => {\n res.json({ status: 'ok' });\n });\n }\n\n app.use((err: unknown, _req: Request, res: Response, _next: NextFunction) => {\n const appError = isAppError(err)\n ? err\n : createError('INTERNAL_ERROR', err instanceof Error ? err.message : 'Unexpected error', {\n cause: err,\n status: 500\n });\n\n if (err instanceof Error && err.stack) {\n requestTracker.mergeMetadata(res, { errorStack: err.stack });\n }\n\n requestTracker.recordError(res, appError);\n\n const status = Number.isFinite(appError.status) ? Number(appError.status) : 500;\n const payload: Record<string, unknown> = {\n error: {\n code: appError.code,\n message: appError.message\n }\n };\n\n if (appError.details) {\n (payload.error as Record<string, unknown>).details = appError.details;\n }\n\n requestTracker.recordResponse(res, status, payload);\n\n if (!res.headersSent) {\n res.status(status).json(payload);\n }\n });\n\n return { app, container, requestTracker, diagnostics, config };\n}\n\nexport async function bootstrap(options: BootstrapOptions = {}): Promise<BootstrapContext> {\n const { app, container, requestTracker, diagnostics, config } = createApp(options);\n const port = Number(options.port ?? process.env.PORT ?? 3000);\n\n const server = app.listen(port, () => {\n // eslint-disable-next-line no-console\n console.log(`🚀 Server listening on http://localhost:${port}`);\n });\n\n const shutdown = () => {\n server.close(() => {\n // eslint-disable-next-line no-console\n console.log('HTTP server closed');\n });\n };\n\n process.once('SIGINT', shutdown);\n process.once('SIGTERM', shutdown);\n\n return { app, server, container, requestTracker, diagnostics, config, shutdown };\n}\n","import { createHash } from 'node:crypto';\nimport type { Application, NextFunction, Request, RequestHandler, Response } from 'express';\nimport { Container } from 'inversify';\nimport 'reflect-metadata';\nimport {\n DecoratorMetadata,\n type RouteDefinition,\n type ControllerConstructor,\n listRegisteredControllers,\n RouteValidation,\n SchemaLike\n} from '../decorators/http';\nimport { Injectable } from '../utils/injection';\nimport { createError } from '../utils/errors';\nimport { TYPES } from '../shared/types';\nimport { RequestTracker } from './request-tracker';\n\nexport interface ServerOptions {\n controllers?: ControllerConstructor[];\n prefix?: string;\n}\n\nconst appRouteRegistry = new WeakMap<Application, Set<string>>();\n\nexport function registerControllers(app: Application, container: Container, options: ServerOptions = {}) {\n const controllers = options.controllers ?? listRegisteredControllers();\n const prefix = options.prefix ?? '';\n const requestTracker = container.get<RequestTracker>(TYPES.RequestTracker);\n\n controllers.forEach((ControllerClass) => {\n ensureInjectable(ControllerClass);\n const controllerMetadata = Reflect.getMetadata(DecoratorMetadata.CONTROLLER_KEY, ControllerClass);\n if (!controllerMetadata) {\n return;\n }\n\n if (!container.isBound(ControllerClass)) {\n container.bind(ControllerClass).toSelf().inSingletonScope();\n }\n\n const instance = container.get<unknown>(ControllerClass) as Record<string | symbol, unknown>;\n const routes: RouteDefinition[] = Reflect.getMetadata(DecoratorMetadata.ROUTES_KEY, ControllerClass) ?? [];\n\n routes.forEach((route) => {\n const handler = instance[route.propertyKey];\n\n if (typeof handler !== 'function') {\n throw new Error(`Route handler ${String(route.propertyKey)} on ${ControllerClass.name} is not a function`);\n }\n\n const fullPath = buildRoutePath(prefix, controllerMetadata.basePath, route.path);\n const routeHash = registerRouteSignature(app, route.method, fullPath, ControllerClass.name, route.propertyKey);\n\n const boundHandler = (handler as (...args: unknown[]) => unknown).bind(instance);\n const validationMiddleware = buildValidationMiddleware(route.validation);\n const routeMetadataMiddleware: RequestHandler = (_req, res, next) => {\n requestTracker.mergeMetadata(res, {\n route: fullPath,\n method: route.method.toUpperCase(),\n routeHash\n });\n next();\n };\n\n const pipeline: RequestHandler[] = [routeMetadataMiddleware, ...validationMiddleware, ...route.middlewares];\n\n app[route.method](fullPath, ...pipeline, async (req: Request, res: Response, next: NextFunction) => {\n try {\n const result = await Promise.resolve(boundHandler(req, res, next));\n if (result !== undefined && !res.headersSent) {\n res.json(result);\n }\n } catch (error) {\n next(error);\n }\n });\n });\n });\n}\n\nfunction ensureInjectable(constructor: ControllerConstructor) {\n if (!Reflect.hasOwnMetadata('inversify:paramtypes', constructor)) {\n Injectable()(constructor as never);\n }\n}\n\nfunction buildRoutePath(prefix: string, basePath: string, routePath: string) {\n const segments = [...toSegments(prefix), ...toSegments(basePath), ...toSegments(routePath)];\n if (segments.length === 0) {\n return '/';\n }\n return `/${segments.join('/')}`;\n}\n\nfunction toSegments(segment: string | undefined) {\n if (!segment || segment === '/') {\n return [];\n }\n\n const trimmed = segment.replace(/^\\/+|\\/+$/g, '');\n return trimmed ? [trimmed] : [];\n}\n\nfunction registerRouteSignature(\n app: Application,\n method: string,\n path: string,\n controllerName: string,\n propertyKey: string | symbol\n) {\n let registry = appRouteRegistry.get(app);\n if (!registry) {\n registry = new Set<string>();\n appRouteRegistry.set(app, registry);\n }\n\n const normalized = `${method.toLowerCase()}:${path.toLowerCase()}`;\n const hash = createHash('sha256').update(normalized).digest('hex');\n\n if (registry.has(hash)) {\n throw createError('ROUTE_CONFLICT', `Duplicate route detected for [${method.toUpperCase()}] ${path}`, {\n details: {\n controller: controllerName,\n handler: String(propertyKey)\n }\n });\n }\n\n registry.add(hash);\n return hash;\n}\n\nfunction buildValidationMiddleware(validation?: RouteValidation): RequestHandler[] {\n if (!validation) {\n return [];\n }\n\n const middleware: RequestHandler = (req, _res, next) => {\n try {\n if (validation.params) {\n req.params = runSchema(validation.params, req.params, 'params');\n }\n if (validation.query) {\n req.query = runSchema(validation.query, req.query, 'query');\n }\n if (validation.body) {\n req.body = runSchema(validation.body, req.body, 'body');\n }\n next();\n } catch (error) {\n next(error);\n }\n };\n\n return [middleware];\n}\n\nfunction runSchema(schema: SchemaLike, value: unknown, target: 'params' | 'query' | 'body') {\n if (isZodSchema(schema)) {\n if (typeof schema.safeParse === 'function') {\n const result = schema.safeParse(value);\n if (!result.success) {\n const issues = Array.isArray((result.error as { issues?: Array<{ message: string }> })?.issues)\n ? (result.error as { issues: Array<{ message: string }> }).issues.map((issue) => issue.message)\n : [(result.error as { message?: string }).message].filter(Boolean);\n throw validationError(target, issues);\n }\n return result.data;\n }\n\n try {\n return schema.parse(value);\n } catch (error) {\n const issues = extractErrorMessages(error);\n throw validationError(target, issues);\n }\n }\n\n if (isJoiSchema(schema)) {\n const { error, value: validated } = schema.validate(value, { abortEarly: false, stripUnknown: true });\n if (error) {\n throw validationError(\n target,\n error.details?.map((detail: { message: string }) => detail.message)\n );\n }\n return validated;\n }\n\n throw createError('VALIDATION_UNSUPPORTED', 'Unsupported validation schema provided', {\n details: { target }\n });\n}\n\nfunction isZodSchema(schema: SchemaLike): schema is { safeParse?: (value: unknown) => { success: boolean; data: unknown; error?: any }; parse: (value: unknown) => unknown } {\n if (typeof schema !== 'object' || schema === null) {\n return false;\n }\n return typeof (schema as { safeParse?: unknown }).safeParse === 'function' || typeof (schema as { parse?: unknown }).parse === 'function';\n}\n\nfunction isJoiSchema(schema: SchemaLike): schema is { validate: (value: unknown, options?: unknown) => { error?: any; value: any } } {\n if (typeof schema !== 'object' || schema === null) {\n return false;\n }\n return typeof (schema as { validate?: unknown }).validate === 'function';\n}\n\nfunction validationError(target: string, issues?: Array<string | undefined>) {\n return createError('VALIDATION_ERROR', `Invalid ${target}`, {\n status: 400,\n details: {\n target,\n issues: issues?.filter((issue): issue is string => Boolean(issue))\n }\n });\n}\n\nfunction extractErrorMessages(error: unknown) {\n if (!error) {\n return [] as string[];\n }\n\n if (Array.isArray((error as { issues?: Array<{ message: string }> }).issues)) {\n return (error as { issues: Array<{ message: string }> }).issues.map((issue) => issue.message);\n }\n\n if (error instanceof Error && error.message) {\n return [error.message];\n }\n\n return [String(error)];\n}\n","import { Container } from 'inversify';\nimport { AppDiagnostics } from '../core/diagnostics';\nimport { RequestTracker } from '../core/request-tracker';\nimport { createReactive, ReactiveRegistry, type Reactive } from '../utils/reactive';\nimport { createLogger } from '../utils/logger';\nimport { TYPES, type AppState } from '../shared/types';\nimport type { ResolvedAppConfig } from '../shared/config';\n\nexport function buildContainer(resolvedConfig: ResolvedAppConfig) {\n const container = new Container({ defaultScope: 'Singleton' });\n\n const registry = new ReactiveRegistry();\n container.bind<ReactiveRegistry>(TYPES.StateRegistry).toConstantValue(registry);\n container.bind(TYPES.Config).toConstantValue(resolvedConfig);\n container.bind(TYPES.Logger).toConstantValue(createLogger(resolvedConfig.logging));\n\n const appState = createReactive<AppState>(\n {\n bootedAt: Date.now(),\n metadata: {}\n },\n {\n id: 'app:state',\n label: 'application:state',\n registry,\n trackHistory: resolvedConfig.telemetry.trackReactiveHistory,\n maxHistory: resolvedConfig.telemetry.requestHistoryLimit\n }\n );\n\n container.bind<Reactive<AppState>>(TYPES.AppState).toConstantValue(appState);\n container.bind<RequestTracker>(TYPES.RequestTracker).to(RequestTracker).inSingletonScope();\n container.bind<AppDiagnostics>(TYPES.Diagnostics).to(AppDiagnostics).inSingletonScope();\n\n return container;\n}\n","export type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nexport interface LoggerConfig {\n level?: LogLevel;\n}\n\nexport interface AppLogger {\n readonly level: LogLevel;\n debug(message: string, metadata?: Record<string, unknown>): void;\n info(message: string, metadata?: Record<string, unknown>): void;\n warn(message: string, metadata?: Record<string, unknown>): void;\n error(message: string, metadata?: Record<string, unknown>): void;\n}\n\nconst LEVEL_WEIGHT: Record<LogLevel, number> = {\n debug: 10,\n info: 20,\n warn: 30,\n error: 40\n};\n\nexport class ConsoleLogger implements AppLogger {\n public readonly level: LogLevel;\n\n constructor(level: LogLevel = 'info') {\n this.level = level;\n }\n\n debug(message: string, metadata?: Record<string, unknown>) {\n this.log('debug', message, metadata);\n }\n\n info(message: string, metadata?: Record<string, unknown>) {\n this.log('info', message, metadata);\n }\n\n warn(message: string, metadata?: Record<string, unknown>) {\n this.log('warn', message, metadata);\n }\n\n error(message: string, metadata?: Record<string, unknown>) {\n this.log('error', message, metadata);\n }\n\n private log(level: LogLevel, message: string, metadata?: Record<string, unknown>) {\n if (!this.shouldLog(level)) {\n return;\n }\n\n const payload = metadata ? [message, metadata] : [message];\n switch (level) {\n case 'debug':\n console.debug(...payload);\n break;\n case 'info':\n console.info(...payload);\n break;\n case 'warn':\n console.warn(...payload);\n break;\n case 'error':\n console.error(...payload);\n break;\n }\n }\n\n private shouldLog(level: LogLevel) {\n return LEVEL_WEIGHT[level] >= LEVEL_WEIGHT[this.level];\n }\n}\n\nexport function createLogger(config: LoggerConfig = {}): AppLogger {\n return new ConsoleLogger(config.level);\n}\n","import type { LoggerConfig } from '../utils/logger';\n\nexport interface TelemetryConfig {\n trackReactiveHistory?: boolean;\n requestHistoryLimit?: number;\n}\n\nexport interface AppConfig {\n prefix?: string;\n healthEndpoint?: string | false;\n logging?: LoggerConfig;\n telemetry?: TelemetryConfig;\n}\n\nexport interface ResolvedAppConfig {\n prefix: string;\n healthEndpoint: string | false;\n logging: Required<LoggerConfig>;\n telemetry: Required<TelemetryConfig>;\n}\n\nconst DEFAULT_CONFIG: ResolvedAppConfig = {\n prefix: '',\n healthEndpoint: '/health',\n logging: {\n level: 'info'\n },\n telemetry: {\n trackReactiveHistory: true,\n requestHistoryLimit: 250\n }\n};\n\nlet currentConfig: ResolvedAppConfig = { ...DEFAULT_CONFIG };\n\nexport function configureApp(config: AppConfig) {\n currentConfig = mergeConfig(currentConfig, config);\n}\n\nexport function getAppConfig(): ResolvedAppConfig {\n return currentConfig;\n}\n\nexport function resolveConfig(overrides?: AppConfig): ResolvedAppConfig {\n if (!overrides) {\n return currentConfig;\n }\n\n return mergeConfig(currentConfig, overrides);\n}\n\nexport function resetAppConfig() {\n currentConfig = { ...DEFAULT_CONFIG };\n}\n\nfunction mergeConfig(base: ResolvedAppConfig, overrides: AppConfig): ResolvedAppConfig {\n return {\n prefix: overrides.prefix ?? base.prefix,\n healthEndpoint: overrides.healthEndpoint ?? base.healthEndpoint,\n logging: {\n level: overrides.logging?.level ?? base.logging.level\n },\n telemetry: {\n trackReactiveHistory: overrides.telemetry?.trackReactiveHistory ?? base.telemetry.trackReactiveHistory,\n requestHistoryLimit: overrides.telemetry?.requestHistoryLimit ?? base.telemetry.requestHistoryLimit\n }\n };\n}\n"],"mappings":"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","names":["CONTROLLER_KEY","Symbol","ROUTES_KEY","controllerRegistry","Set","Controller","pathOrOptions","options","normalizeControllerOptions","target","Reflect","defineMetadata","basePath","path","tags","hasMetadata","autoRegister","add","Get","middlewares","createRouteDecorator","Post","Put","Patch","Delete","listRegisteredControllers","Array","from","registerController","controller","resetControllerRegistry","clear","DecoratorMetadata","method","propertyKey","routes","getMetadata","normalized","normalizeRouteOptions","push","validation","normalizePath","extraMiddlewares","base","normalizeRouteOptionObject","normalizeRoutePath","validate","withLeading","startsWith","endsWith","slice","cleaned","AppError","Error","code","status","details","message","options","cause","name","createError","isAppError","error","BaseController","requestTracker","ok","res","payload","respond","created","accepted","noContent","status","recordResponse","undefined","end","json","logDebug","message","metadata","log","controllerId","logInfo","logWarn","logError","mergeRequestMetadata","patch","current","get","state","currentRecord","namespacedPatch","mergeMetadata","getRequestState","fail","code","options","createError","import_node_crypto","Injectable","inversifyInjectable","Inject","identifier","inversifyInject","Optional","inversifyOptional","MultiInject","inversifyMultiInject","Named","name","inversifyNamed","Tagged","metadataKey","metadataValue","inversifyTagged","Unmanaged","inversifyUnmanaged","ReactiveRegistry","stores","Map","register","store","set","id","unregister","delete","get","list","Array","from","values","map","label","snapshot","history","createReactive","initial","options","listeners","Set","target","historyEnabled","trackHistory","maxHistory","reactiveId","randomUUID","proxy","Proxy","current","prop","value","Reflect","typedProp","previous","didChange","result","change","property","timestamp","Date","now","push","length","shift","forEach","listener","state","watch","watcher","add","structuredClone","registry","TYPES","AppState","Symbol","for","Config","Diagnostics","Logger","StateRegistry","RequestTracker","RequestTracker","registry","config","logger","middleware","req","res","next","id","randomUUID","requestState","createReactive","method","path","originalUrl","url","startedAt","Date","now","logs","metadata","label","trackHistory","telemetry","trackReactiveHistory","maxHistory","requestHistoryLimit","locals","on","error","recordError","finalise","get","log","message","level","store","entry","timestamp","state","dispatchLog","requestId","mergeMetadata","patch","recordResponse","status","payload","response","errorMessage","Error","String","isAppError","errorCode","code","errorDetails","details","undefined","statusCode","endedAt","durationMs","debug","info","warn","StateRegistry","Config","Logger","AppDiagnostics","registry","config","settings","stores","list","map","entry","id","label","snapshot","history","requests","filter","startsWith","StateRegistry","Config","import_reflect_metadata","import_node_crypto","import_reflect_metadata","appRouteRegistry","WeakMap","registerControllers","app","container","options","controllers","listRegisteredControllers","prefix","requestTracker","get","TYPES","RequestTracker","forEach","ControllerClass","ensureInjectable","controllerMetadata","Reflect","getMetadata","DecoratorMetadata","CONTROLLER_KEY","isBound","bind","toSelf","inSingletonScope","instance","routes","ROUTES_KEY","route","handler","propertyKey","Error","String","name","fullPath","buildRoutePath","basePath","path","routeHash","registerRouteSignature","method","boundHandler","validationMiddleware","buildValidationMiddleware","validation","routeMetadataMiddleware","_req","res","next","mergeMetadata","toUpperCase","pipeline","middlewares","req","result","Promise","resolve","undefined","headersSent","json","error","constructor","hasOwnMetadata","Injectable","routePath","segments","toSegments","length","join","segment","trimmed","replace","controllerName","registry","Set","set","normalized","toLowerCase","hash","createHash","update","digest","has","createError","details","controller","add","middleware","_res","params","runSchema","query","body","schema","value","target","isZodSchema","safeParse","success","issues","Array","isArray","map","issue","message","filter","Boolean","validationError","data","parse","extractErrorMessages","isJoiSchema","validated","validate","abortEarly","stripUnknown","detail","status","import_inversify","LEVEL_WEIGHT","debug","info","warn","error","ConsoleLogger","level","message","metadata","log","shouldLog","payload","console","createLogger","config","buildContainer","resolvedConfig","container","Container","defaultScope","registry","ReactiveRegistry","bind","TYPES","StateRegistry","toConstantValue","Config","Logger","createLogger","logging","appState","createReactive","bootedAt","Date","now","metadata","id","label","trackHistory","telemetry","trackReactiveHistory","maxHistory","requestHistoryLimit","AppState","RequestTracker","to","inSingletonScope","Diagnostics","AppDiagnostics","DEFAULT_CONFIG","prefix","healthEndpoint","logging","level","telemetry","trackReactiveHistory","requestHistoryLimit","currentConfig","configureApp","config","mergeConfig","getAppConfig","resolveConfig","overrides","resetAppConfig","base","createApp","options","config","resolveConfig","container","buildContainer","configureContainer","app","express","requestTracker","get","TYPES","RequestTracker","diagnostics","Diagnostics","use","json","additionalMiddleware","forEach","middleware","registerControllers","controllers","prefix","healthEndpoint","_req","res","status","err","_next","appError","isAppError","createError","Error","message","cause","stack","mergeMetadata","errorStack","recordError","Number","isFinite","payload","error","code","details","recordResponse","headersSent","bootstrap","port","process","env","PORT","server","listen","console","log","shutdown","close","once"]}
|
package/package.json
ADDED
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@forinda/kickjs",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Express + TypeScript + Inversify starter with reactive state, request telemetry, and Spring Boot-style decorators.",
|
|
5
|
+
"main": "dist/index.js",
|
|
6
|
+
"types": "dist/index.d.ts",
|
|
7
|
+
"exports": {
|
|
8
|
+
".": {
|
|
9
|
+
"require": "./dist/index.js",
|
|
10
|
+
"types": "./dist/index.d.ts"
|
|
11
|
+
}
|
|
12
|
+
},
|
|
13
|
+
"files": [
|
|
14
|
+
"dist"
|
|
15
|
+
],
|
|
16
|
+
"scripts": {
|
|
17
|
+
"clean": "rm -rf dist",
|
|
18
|
+
"dev": "ts-node-dev --respawn --transpile-only src/main.ts",
|
|
19
|
+
"check": "tsc --noEmit",
|
|
20
|
+
"build": "tsup",
|
|
21
|
+
"start": "node dist/index.js",
|
|
22
|
+
"prepublishOnly": "npm run build && npm run check && npm test",
|
|
23
|
+
"test": "vitest run",
|
|
24
|
+
"test:watch": "vitest",
|
|
25
|
+
"prepare": "husky"
|
|
26
|
+
},
|
|
27
|
+
"keywords": [
|
|
28
|
+
"express",
|
|
29
|
+
"typescript",
|
|
30
|
+
"inversify",
|
|
31
|
+
"decorators",
|
|
32
|
+
"starter"
|
|
33
|
+
],
|
|
34
|
+
"author": "",
|
|
35
|
+
"license": "MIT",
|
|
36
|
+
"engines": {
|
|
37
|
+
"node": ">=18.17"
|
|
38
|
+
},
|
|
39
|
+
"publishConfig": {
|
|
40
|
+
"access": "public"
|
|
41
|
+
},
|
|
42
|
+
"dependencies": {
|
|
43
|
+
"express": "^5.1.0",
|
|
44
|
+
"inversify": "^7.10.0",
|
|
45
|
+
"reflect-metadata": "^0.2.2"
|
|
46
|
+
},
|
|
47
|
+
"devDependencies": {
|
|
48
|
+
"@swc/core": "^1.7.28",
|
|
49
|
+
"@types/express": "^5.0.3",
|
|
50
|
+
"@types/node": "^24.5.2",
|
|
51
|
+
"@vitest/coverage-v8": "^3.2.4",
|
|
52
|
+
"husky": "^9.1.7",
|
|
53
|
+
"joi": "^18.0.1",
|
|
54
|
+
"node-mocks-http": "^1.17.2",
|
|
55
|
+
"ts-node": "^10.9.2",
|
|
56
|
+
"ts-node-dev": "^2.0.0",
|
|
57
|
+
"tsup": "^8.5.0",
|
|
58
|
+
"typescript": "^5.9.2",
|
|
59
|
+
"vitest": "^3.2.4",
|
|
60
|
+
"zod": "^4.1.9"
|
|
61
|
+
}
|
|
62
|
+
}
|