@rexeus/typeweaver-gen 0.10.5 → 0.12.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.
Files changed (8) hide show
  1. package/dist/index.cjs +384 -45
  2. package/dist/index.d.cts +25 -3
  3. package/dist/index.d.cts.map +1 -1
  4. package/dist/index.d.mts +25 -3
  5. package/dist/index.d.mts.map +1 -1
  6. package/dist/index.mjs +384 -45
  7. package/dist/index.mjs.map +1 -1
  8. package/package.json +3 -3
package/dist/index.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"sources":["../src/errors/DerivedResponseCycleError.ts","../src/errors/DuplicateOperationIdError.ts","../src/errors/DuplicateRouteError.ts","../src/errors/EmptyOperationResponsesError.ts","../src/errors/EmptyResourceOperationsError.ts","../src/errors/EmptySpecResourcesError.ts","../src/errors/InvalidDerivedResponseError.ts","../src/errors/InvalidOperationIdError.ts","../src/errors/InvalidRequestSchemaError.ts","../src/errors/InvalidResourceNameError.ts","../src/errors/MissingDerivedResponseParentError.ts","../src/errors/PathParameterMismatchError.ts","../src/helpers/namingUtils.ts","../src/helpers/routePath.ts","../src/validation/derivedResponseValidation.ts","../src/normalizeSpec.ts","../src/plugins/types.ts","../src/plugins/BasePlugin.ts","../src/plugins/pluginRegistry.ts","../src/helpers/path.ts","../src/helpers/templateEngine.ts","../src/plugins/errors/MissingCanonicalResponseError.ts","../src/plugins/pluginContext.ts","../src/helpers/jsdoc.ts","../src/helpers/routeSort.ts"],"sourcesContent":["export class DerivedResponseCycleError extends Error {\n public constructor(responseName: string) {\n super(`Derived response '${responseName}' contains a cyclic lineage.`);\n this.name = \"DerivedResponseCycleError\";\n }\n}\n","export class DuplicateOperationIdError extends Error {\n public constructor(operationId: string) {\n super(\n `Operation ID '${operationId}' must be globally unique within a spec.`\n );\n this.name = \"DuplicateOperationIdError\";\n }\n}\n","export class DuplicateRouteError extends Error {\n public constructor(method: string, path: string, normalizedPath: string) {\n super(\n `Route '${method} ${path}' conflicts with an existing route using normalized path '${normalizedPath}'.`\n );\n this.name = \"DuplicateRouteError\";\n }\n}\n","export class EmptyOperationResponsesError extends Error {\n public constructor(operationId: string) {\n super(`Operation '${operationId}' must declare at least one response.`);\n this.name = \"EmptyOperationResponsesError\";\n }\n}\n","export class EmptyResourceOperationsError extends Error {\n public constructor(resourceName: string) {\n super(`Resource '${resourceName}' must contain at least one operation.`);\n this.name = \"EmptyResourceOperationsError\";\n }\n}\n","export class EmptySpecResourcesError extends Error {\n public constructor() {\n super(\"Spec definition must contain at least one resource.\");\n this.name = \"EmptySpecResourcesError\";\n }\n}\n","export class InvalidDerivedResponseError extends Error {\n public constructor(responseName: string) {\n super(\n `Derived response '${responseName}' contains invalid lineage metadata.`\n );\n this.name = \"InvalidDerivedResponseError\";\n }\n}\n","export class InvalidOperationIdError extends Error {\n public constructor(operationId: string) {\n super(\n `Operation ID '${operationId}' is invalid. Use camelCase (preferred) or PascalCase. snake_case and kebab-case are not supported.`\n );\n this.name = \"InvalidOperationIdError\";\n }\n}\n","import type { NormalizedRequest } from \"../NormalizedSpec.js\";\n\nexport class InvalidRequestSchemaError extends Error {\n public constructor(\n operationId: string,\n requestPart: keyof NormalizedRequest\n ) {\n super(\n `Operation '${operationId}' has an invalid request.${requestPart} schema definition.`\n );\n this.name = \"InvalidRequestSchemaError\";\n }\n}\n","export class InvalidResourceNameError extends Error {\n public constructor(resourceName: string) {\n super(\n `Resource name '${resourceName}' is invalid. Use camelCase singular nouns when possible; PascalCase is also supported. snake_case and kebab-case are not supported.`\n );\n this.name = \"InvalidResourceNameError\";\n }\n}\n","export class MissingDerivedResponseParentError extends Error {\n public constructor(responseName: string, parentName: string) {\n super(\n `Derived response '${responseName}' references missing canonical parent '${parentName}'.`\n );\n this.name = \"MissingDerivedResponseParentError\";\n }\n}\n","export class PathParameterMismatchError extends Error {\n public constructor(\n operationId: string,\n path: string,\n pathParams: readonly string[],\n requestParams: readonly string[]\n ) {\n super(\n `Operation '${operationId}' has mismatched path parameters for '${path}'. Path params: [${pathParams.join(\n \", \"\n )}], request.param keys: [${requestParams.join(\", \")}].`\n );\n this.name = \"PathParameterMismatchError\";\n }\n}\n","import { isCamelCase, isPascalCase } from \"polycase\";\n\nconst startsWithDigit = (value: string): boolean => /^[0-9]/u.test(value);\n\nconst isSupportedIdentifierName = (value: string): boolean => {\n if (startsWithDigit(value)) {\n return false;\n }\n\n return isCamelCase(value) || isPascalCase(value);\n};\n\nexport const isSupportedOperationId = (value: string): boolean => {\n return isSupportedIdentifierName(value);\n};\n\nexport const isSupportedResourceName = (value: string): boolean => {\n return isSupportedIdentifierName(value);\n};\n","const PATH_PARAMETER_PATTERN = /:([A-Za-z0-9_]+)/g;\n\nexport const normalizeRoutePath = (path: string): string => {\n const segments = path.split(\"/\").filter(Boolean);\n\n if (segments.length === 0) {\n return \"/\";\n }\n\n return `/${segments.map(segment => (segment.startsWith(\":\") ? \":\" : segment)).join(\"/\")}`;\n};\n\nexport const getPathParameterNames = (path: string): string[] => {\n return Array.from(\n path.matchAll(PATH_PARAMETER_PATTERN),\n match => match[1] as string\n );\n};\n","import {\n HttpStatusCodeNameMap,\n isNamedResponseDefinition,\n} from \"@rexeus/typeweaver-core\";\nimport type {\n ResponseDefinition,\n SpecDefinition,\n} from \"@rexeus/typeweaver-core\";\nimport {\n DerivedResponseCycleError,\n InvalidDerivedResponseError,\n MissingDerivedResponseParentError,\n} from \"../errors/index.js\";\nimport type { NormalizedResponse } from \"../NormalizedSpec.js\";\n\nexport const validateDerivedResponseMetadata = (\n response: ResponseDefinition\n): void => {\n const derived = response.derived;\n\n if (derived === undefined) {\n return;\n }\n\n if (derived.parentName === response.name) {\n throw new DerivedResponseCycleError(response.name);\n }\n\n if (derived.lineage.length === 0) {\n throw new InvalidDerivedResponseError(response.name);\n }\n\n if (derived.lineage.at(-1) !== response.name) {\n throw new InvalidDerivedResponseError(response.name);\n }\n\n if (derived.lineage.length !== derived.depth) {\n throw new InvalidDerivedResponseError(response.name);\n }\n\n if (new Set(derived.lineage).size !== derived.lineage.length) {\n throw new DerivedResponseCycleError(response.name);\n }\n\n if (derived.depth > 1 && derived.lineage.at(-2) !== derived.parentName) {\n throw new InvalidDerivedResponseError(response.name);\n }\n};\n\nexport const collectCanonicalResponseDefinitions = (\n definition: SpecDefinition\n): Map<string, ResponseDefinition> => {\n const canonicalResponses = new Map<string, ResponseDefinition>();\n\n for (const resource of Object.values(definition.resources)) {\n for (const operation of resource.operations) {\n for (const response of operation.responses) {\n if (!isNamedResponseDefinition(response)) {\n continue;\n }\n\n validateDerivedResponseMetadata(response);\n\n canonicalResponses.set(response.name, response);\n }\n }\n }\n\n return canonicalResponses;\n};\n\nexport const getDerivedResponseChain = (\n response: ResponseDefinition,\n canonicalResponses: ReadonlyMap<string, ResponseDefinition>\n): readonly string[] => {\n const chain: string[] = [response.name];\n const visitedResponseNames = new Set(chain);\n let parentName = response.derived?.parentName;\n\n while (parentName !== undefined) {\n if (visitedResponseNames.has(parentName)) {\n throw new DerivedResponseCycleError(response.name);\n }\n\n const parentResponse = canonicalResponses.get(parentName);\n\n if (parentResponse === undefined) {\n throw new MissingDerivedResponseParentError(response.name, parentName);\n }\n\n chain.unshift(parentResponse.name);\n visitedResponseNames.add(parentResponse.name);\n parentName = parentResponse.derived?.parentName;\n }\n\n return chain;\n};\n\nexport const validateDerivedResponseGraph = (\n canonicalResponses: ReadonlyMap<string, ResponseDefinition>\n): void => {\n for (const response of canonicalResponses.values()) {\n validateDerivedResponseAgainstCanonicalGraph(response, canonicalResponses);\n }\n};\n\nconst validateDerivedResponseAgainstCanonicalGraph = (\n response: ResponseDefinition,\n canonicalResponses: ReadonlyMap<string, ResponseDefinition>\n): void => {\n if (response.derived === undefined) {\n return;\n }\n\n const chain = getDerivedResponseChain(response, canonicalResponses);\n const materializedLineage = chain.slice(1);\n\n if (response.derived.depth !== materializedLineage.length) {\n throw new InvalidDerivedResponseError(response.name);\n }\n\n if (\n materializedLineage.length !== response.derived.lineage.length ||\n materializedLineage.some(\n (lineageEntry, index) => lineageEntry !== response.derived?.lineage[index]\n )\n ) {\n throw new InvalidDerivedResponseError(response.name);\n }\n};\n\nconst validateInlineDerivedResponses = (\n definition: SpecDefinition,\n canonicalResponses: ReadonlyMap<string, ResponseDefinition>\n): void => {\n for (const resource of Object.values(definition.resources)) {\n for (const operation of resource.operations) {\n for (const response of operation.responses) {\n if (isNamedResponseDefinition(response)) {\n continue;\n }\n\n validateDerivedResponseMetadata(response);\n validateDerivedResponseAgainstCanonicalGraph(\n response,\n canonicalResponses\n );\n }\n }\n }\n};\n\nexport const normalizeResponseDefinition = (\n response: ResponseDefinition\n): NormalizedResponse => {\n return {\n name: response.name,\n statusCode: response.statusCode,\n statusCodeName: HttpStatusCodeNameMap[response.statusCode],\n description: response.description,\n header: response.header,\n body: response.body,\n kind: response.derived === undefined ? \"response\" : \"derived-response\",\n derivedFrom: response.derived?.parentName,\n lineage: response.derived?.lineage,\n depth: response.derived?.depth,\n };\n};\n\nexport const collectCanonicalResponses = (\n definition: SpecDefinition\n): Map<string, NormalizedResponse> => {\n const canonicalResponseDefinitions =\n collectCanonicalResponseDefinitions(definition);\n\n validateDerivedResponseGraph(canonicalResponseDefinitions);\n validateInlineDerivedResponses(definition, canonicalResponseDefinitions);\n\n return new Map(\n Array.from(\n canonicalResponseDefinitions.entries(),\n ([responseName, response]) => [\n responseName,\n normalizeResponseDefinition(response),\n ]\n )\n );\n};\n","import {\n isNamedResponseDefinition,\n validateUniqueResponseNames,\n} from \"@rexeus/typeweaver-core\";\nimport type {\n RequestDefinition,\n ResourceDefinition,\n ResponseDefinition,\n SpecDefinition,\n} from \"@rexeus/typeweaver-core\";\nimport { z } from \"zod\";\nimport {\n DuplicateOperationIdError,\n DuplicateRouteError,\n EmptyOperationResponsesError,\n EmptyResourceOperationsError,\n EmptySpecResourcesError,\n InvalidOperationIdError,\n InvalidRequestSchemaError,\n InvalidResourceNameError,\n PathParameterMismatchError,\n} from \"./errors/index.js\";\nimport {\n isSupportedOperationId,\n isSupportedResourceName,\n} from \"./helpers/namingUtils.js\";\nimport {\n getPathParameterNames,\n normalizeRoutePath,\n} from \"./helpers/routePath.js\";\nimport {\n collectCanonicalResponses,\n normalizeResponseDefinition,\n} from \"./validation/index.js\";\nimport type {\n NormalizedOperation,\n NormalizedRequest,\n NormalizedResponseUsage,\n NormalizedSpec,\n} from \"./NormalizedSpec.js\";\n\nconst isZodType = (schema: unknown): schema is z.ZodType => {\n return schema instanceof z.ZodType;\n};\n\nconst isZodObject = (\n schema: unknown\n): schema is z.ZodObject<z.core.$ZodShape> => {\n return schema instanceof z.ZodObject;\n};\n\nconst validateRequestSchema = (\n operationId: string,\n requestPart: keyof NormalizedRequest,\n schema: unknown\n): void => {\n if (!isZodType(schema)) {\n throw new InvalidRequestSchemaError(operationId, requestPart);\n }\n\n if (requestPart === \"param\" && !isZodObject(schema)) {\n throw new InvalidRequestSchemaError(operationId, requestPart);\n }\n};\n\nconst validateRequest = (\n operationId: string,\n path: string,\n request: RequestDefinition\n): NormalizedRequest | undefined => {\n if (request.header !== undefined) {\n validateRequestSchema(operationId, \"header\", request.header);\n }\n\n if (request.param !== undefined) {\n validateRequestSchema(operationId, \"param\", request.param);\n }\n\n if (request.query !== undefined) {\n validateRequestSchema(operationId, \"query\", request.query);\n }\n\n if (request.body !== undefined) {\n validateRequestSchema(operationId, \"body\", request.body);\n }\n\n const pathParams = getPathParameterNames(path);\n const requestParams =\n request.param === undefined ? [] : Object.keys(request.param.shape);\n\n if (\n pathParams.length !== requestParams.length ||\n pathParams.some(pathParam => !requestParams.includes(pathParam))\n ) {\n throw new PathParameterMismatchError(\n operationId,\n path,\n pathParams,\n requestParams\n );\n }\n\n if (\n request.header === undefined &&\n request.param === undefined &&\n request.query === undefined &&\n request.body === undefined\n ) {\n return undefined;\n }\n\n return {\n header: request.header,\n param: request.param,\n query: request.query,\n body: request.body,\n };\n};\n\nconst normalizeOperationResponses = (\n responses: readonly ResponseDefinition[]\n): NormalizedResponseUsage[] => {\n return responses.map(response => {\n if (isNamedResponseDefinition(response)) {\n return {\n responseName: response.name,\n source: \"canonical\",\n };\n }\n\n return {\n responseName: response.name,\n source: \"inline\",\n response: normalizeResponseDefinition(response),\n };\n });\n};\n\nconst normalizeOperation = (\n operationIds: Set<string>,\n routeKeys: Set<string>,\n operation: ResourceDefinition[\"operations\"][number]\n): NormalizedOperation => {\n if (!isSupportedOperationId(operation.operationId)) {\n throw new InvalidOperationIdError(operation.operationId);\n }\n\n if (operationIds.has(operation.operationId)) {\n throw new DuplicateOperationIdError(operation.operationId);\n }\n\n operationIds.add(operation.operationId);\n\n const normalizedPath = normalizeRoutePath(operation.path);\n const routeKey = `${operation.method}:${normalizedPath}`;\n\n if (routeKeys.has(routeKey)) {\n throw new DuplicateRouteError(\n operation.method,\n operation.path,\n normalizedPath\n );\n }\n\n routeKeys.add(routeKey);\n\n if (operation.responses.length === 0) {\n throw new EmptyOperationResponsesError(operation.operationId);\n }\n\n return {\n operationId: operation.operationId,\n method: operation.method,\n path: operation.path,\n summary: operation.summary,\n request: validateRequest(\n operation.operationId,\n operation.path,\n operation.request\n ),\n responses: normalizeOperationResponses(operation.responses),\n };\n};\n\nexport const normalizeSpec = (definition: SpecDefinition): NormalizedSpec => {\n const resourceEntries = Object.entries(definition.resources);\n\n if (resourceEntries.length === 0) {\n throw new EmptySpecResourcesError();\n }\n\n validateUniqueResponseNames(definition.resources);\n const canonicalResponses = collectCanonicalResponses(definition);\n const operationIds = new Set<string>();\n const routeKeys = new Set<string>();\n\n return {\n resources: resourceEntries.map(([resourceName, resource]) => {\n if (!isSupportedResourceName(resourceName)) {\n throw new InvalidResourceNameError(resourceName);\n }\n\n if (resource.operations.length === 0) {\n throw new EmptyResourceOperationsError(resourceName);\n }\n\n return {\n name: resourceName,\n operations: resource.operations.map(operation =>\n normalizeOperation(operationIds, routeKeys, operation)\n ),\n };\n }),\n responses: Array.from(canonicalResponses.values()),\n };\n};\n","import type { NormalizedResponse, NormalizedSpec } from \"../NormalizedSpec.js\";\n\n/**\n * Configuration for a typeweaver plugin\n */\nexport type PluginConfig = Record<string, unknown>;\n\n/**\n * Context provided to plugins during initialization and finalization\n */\nexport type PluginContext = {\n readonly outputDir: string;\n readonly inputDir: string;\n readonly config: PluginConfig;\n};\n\nexport type OperationOutputPaths = {\n readonly outputDir: string;\n readonly requestFile: string;\n readonly requestFileName: string;\n readonly responseFile: string;\n readonly responseFileName: string;\n readonly requestValidationFile: string;\n readonly requestValidationFileName: string;\n readonly responseValidationFile: string;\n readonly responseValidationFileName: string;\n readonly clientFile: string;\n readonly clientFileName: string;\n};\n\n/**\n * Context provided to plugins during generation\n */\nexport type GeneratorContext = PluginContext & {\n readonly normalizedSpec: NormalizedSpec;\n readonly coreDir: string;\n readonly responsesOutputDir: string;\n readonly specOutputDir: string;\n\n readonly getCanonicalResponse: (responseName: string) => NormalizedResponse;\n readonly getCanonicalResponseOutputFile: (responseName: string) => string;\n readonly getCanonicalResponseImportPath: (params: {\n readonly importerDir: string;\n readonly responseName: string;\n }) => string;\n readonly getSpecImportPath: (params: {\n readonly importerDir: string;\n }) => string;\n readonly getOperationDefinitionAccessor: (params: {\n readonly resourceName: string;\n readonly operationId: string;\n }) => string;\n readonly getOperationOutputPaths: (params: {\n readonly resourceName: string;\n readonly operationId: string;\n }) => OperationOutputPaths;\n readonly getResourceOutputDir: (resourceName: string) => string;\n readonly writeFile: (relativePath: string, content: string) => void;\n readonly renderTemplate: (templatePath: string, data: unknown) => string;\n readonly addGeneratedFile: (relativePath: string) => void;\n readonly getGeneratedFiles: () => string[];\n};\n\n/**\n * Plugin metadata\n */\nexport type PluginMetadata = {\n readonly name: string;\n readonly depends?: readonly string[];\n};\n\n/**\n * typeweaver plugin interface\n */\nexport type TypeweaverPlugin = PluginMetadata & {\n /**\n * Initialize the plugin\n * Called before any generation happens\n */\n initialize?(context: PluginContext): Promise<void> | void;\n\n /**\n * Collect and transform resources\n * Allows plugins to modify the resource collection\n */\n collectResources?(\n normalizedSpec: NormalizedSpec\n ): Promise<NormalizedSpec> | NormalizedSpec;\n\n /**\n * Main generation logic\n * Called with all resources and utilities\n */\n generate?(context: GeneratorContext): Promise<void> | void;\n\n /**\n * Finalize the plugin\n * Called after all generation is complete\n */\n finalize?(context: PluginContext): Promise<void> | void;\n};\n\n/**\n * Plugin constructor type\n */\nexport type PluginConstructor = new (config?: PluginConfig) => TypeweaverPlugin;\n\n/**\n * Plugin module export\n */\nexport type PluginModule = {\n default: PluginConstructor;\n};\n\n/**\n * Plugin registration entry\n */\nexport type PluginRegistration = {\n name: string;\n plugin: TypeweaverPlugin;\n config?: PluginConfig;\n};\n\n/**\n * typeweaver configuration\n */\nexport type TypeweaverConfig = {\n input: string;\n output: string;\n plugins?: (string | [string, PluginConfig])[];\n format?: boolean;\n clean?: boolean;\n};\n\n/**\n * Plugin loading error\n */\nexport class PluginLoadError extends Error {\n constructor(\n public pluginName: string,\n message: string\n ) {\n super(`Failed to load plugin '${pluginName}': ${message}`);\n this.name = \"PluginLoadError\";\n }\n}\n\n/**\n * Plugin dependency error\n */\nexport class PluginDependencyError extends Error {\n constructor(\n public pluginName: string,\n public missingDependency: string,\n message?: string\n ) {\n super(\n message ??\n `Plugin '${pluginName}' depends on '${missingDependency}' which is not loaded`\n );\n this.name = \"PluginDependencyError\";\n }\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { NormalizedSpec } from \"../NormalizedSpec.js\";\nimport type {\n GeneratorContext,\n PluginConfig,\n PluginContext,\n TypeweaverPlugin,\n} from \"./types.js\";\n\n/**\n * Base class for typeweaver plugins\n * Provides default implementations and common utilities\n */\nexport abstract class BasePlugin implements TypeweaverPlugin {\n abstract name: string;\n description?: string;\n author?: string;\n depends?: string[];\n\n protected config: PluginConfig;\n\n constructor(config: PluginConfig = {}) {\n this.config = config;\n }\n\n /**\n * Default implementation - override in subclasses if needed\n */\n async initialize(_context: PluginContext): Promise<void> {\n // Default: no initialization needed\n }\n\n /**\n * Default implementation - override in subclasses if needed\n */\n collectResources(normalizedSpec: NormalizedSpec): NormalizedSpec {\n return normalizedSpec;\n }\n\n /**\n * Main generation logic - must be implemented by subclasses\n */\n abstract generate(context: GeneratorContext): Promise<void> | void;\n\n /**\n * Default implementation - override in subclasses if needed\n */\n async finalize(_context: PluginContext): Promise<void> {\n // Default: no finalization needed\n }\n\n protected copyLibFiles(\n context: GeneratorContext,\n libSourceDir: string,\n libNamespace: string\n ): void {\n if (!fs.existsSync(libSourceDir)) return;\n\n const libDir = path.join(context.outputDir, \"lib\", libNamespace);\n\n fs.cpSync(libSourceDir, libDir, { recursive: true });\n\n const libIndexPath = path.join(\"lib\", libNamespace, \"index.ts\");\n if (fs.existsSync(path.join(libDir, \"index.ts\"))) {\n context.addGeneratedFile(libIndexPath);\n }\n }\n}\n","import { PluginDependencyError } from \"./types.js\";\nimport type { PluginRegistration, TypeweaverPlugin } from \"./types.js\";\n\nexport type PluginRegistryApi = {\n readonly register: (plugin: TypeweaverPlugin, config?: unknown) => void;\n readonly get: (name: string) => PluginRegistration | undefined;\n readonly getAll: () => PluginRegistration[];\n readonly has: (name: string) => boolean;\n readonly clear: () => void;\n};\n\nexport function createPluginRegistry(): PluginRegistryApi {\n const plugins = new Map<string, PluginRegistration>();\n let sortedRegistrations: PluginRegistration[] | undefined;\n\n const invalidateSortedRegistrations = (): void => {\n sortedRegistrations = undefined;\n };\n\n return {\n register: (plugin: TypeweaverPlugin, config?: unknown): void => {\n if (plugins.has(plugin.name)) {\n console.info(\n `Skipping duplicate registration of required plugin: ${plugin.name}`\n );\n return;\n }\n\n const registration: PluginRegistration = {\n name: plugin.name,\n plugin,\n config: config as Record<string, unknown>,\n };\n\n plugins.set(plugin.name, registration);\n invalidateSortedRegistrations();\n console.info(`Registered plugin: ${plugin.name}`);\n },\n get: (name: string) => plugins.get(name),\n getAll: () => {\n if (sortedRegistrations === undefined) {\n sortedRegistrations = sortPluginRegistrations(\n Array.from(plugins.values())\n );\n }\n\n return [...sortedRegistrations];\n },\n has: (name: string) => plugins.has(name),\n clear: () => {\n plugins.clear();\n invalidateSortedRegistrations();\n },\n };\n}\n\nfunction sortPluginRegistrations(\n registrations: readonly PluginRegistration[]\n): PluginRegistration[] {\n const registrationsByName = new Map(\n registrations.map(registration => [registration.name, registration])\n );\n const visiting = new Set<string>();\n const visited = new Set<string>();\n const sorted: PluginRegistration[] = [];\n\n for (const registration of registrations) {\n visitPlugin({\n registration,\n registrationsByName,\n visiting,\n visited,\n sorted,\n dependencyPath: [],\n });\n }\n\n return sorted;\n}\n\nfunction visitPlugin(params: {\n readonly registration: PluginRegistration;\n readonly registrationsByName: ReadonlyMap<string, PluginRegistration>;\n readonly visiting: Set<string>;\n readonly visited: Set<string>;\n readonly sorted: PluginRegistration[];\n readonly dependencyPath: readonly string[];\n}): void {\n const {\n registration,\n registrationsByName,\n visiting,\n visited,\n sorted,\n dependencyPath,\n } = params;\n\n if (visited.has(registration.name)) {\n return;\n }\n\n if (visiting.has(registration.name)) {\n const cyclePath = [...dependencyPath, registration.name].join(\" -> \");\n throw new PluginDependencyError(\n registration.name,\n registration.name,\n `Detected plugin dependency cycle: ${cyclePath}`\n );\n }\n\n visiting.add(registration.name);\n\n for (const dependencyName of registration.plugin.depends ?? []) {\n const dependency = registrationsByName.get(dependencyName);\n if (dependency === undefined) {\n throw new PluginDependencyError(registration.name, dependencyName);\n }\n\n visitPlugin({\n registration: dependency,\n registrationsByName,\n visiting,\n visited,\n sorted,\n dependencyPath: [...dependencyPath, registration.name],\n });\n }\n\n visiting.delete(registration.name);\n visited.add(registration.name);\n sorted.push(registration);\n}\n","import path from \"node:path\";\n\nexport function relative(from: string, to: string): string {\n const relativePath = path.relative(from, to);\n\n const posixPath = relativePath.split(path.sep).join(\"/\");\n\n if (\n posixPath === \"..\" ||\n posixPath.startsWith(\"./\") ||\n posixPath.startsWith(\"../\")\n ) {\n return posixPath;\n }\n\n return `./${posixPath}`;\n}\n","function escapeHtml(input: string): string {\n return input\n .replaceAll(\"&\", \"&amp;\")\n .replaceAll(\"<\", \"&lt;\")\n .replaceAll(\">\", \"&gt;\")\n .replaceAll('\"', \"&quot;\")\n .replaceAll(\"'\", \"&#39;\");\n}\n\nfunction stringifyTemplateValue(value: unknown): string {\n if (value === undefined || value === null) {\n return \"\";\n }\n\n return String(value);\n}\n\nexport function renderTemplate(\n template: string,\n data: Record<string, unknown>\n): string {\n const outputChunks: string[] = [];\n const expressionPattern = /<%[=-]?[\\s\\S]*?%>/g;\n let currentIndex = 0;\n let match: RegExpExecArray | null = expressionPattern.exec(template);\n\n while (match !== null) {\n const [tag] = match;\n const tagStart = match.index;\n\n outputChunks.push(\n `__output.push(${JSON.stringify(template.slice(currentIndex, tagStart))});`\n );\n\n if (tag.startsWith(\"<%=\")) {\n const expression = tag.slice(3, -2).trim();\n outputChunks.push(`__output.push(__escape(__stringify(${expression})));`);\n } else if (tag.startsWith(\"<%-\")) {\n const expression = tag.slice(3, -2).trim();\n outputChunks.push(`__output.push(__stringify(${expression}));`);\n } else {\n outputChunks.push(tag.slice(2, -2));\n }\n\n currentIndex = tagStart + tag.length;\n match = expressionPattern.exec(template);\n }\n\n outputChunks.push(\n `__output.push(${JSON.stringify(template.slice(currentIndex))});`\n );\n\n const render = new Function(\n \"data\",\n \"__escape\",\n \"__stringify\",\n // This intentionally relies on `new Function()` sloppy mode so `with (data)`\n // can expose template variables as bare identifiers during rendering.\n // The tests pin the expected collision behavior: own properties on `data`\n // (including names like `name` or `toString`) must win over outer built-ins.\n `const __output = []; with (data) { ${outputChunks.join(\"\\n\")} } return __output.join(\"\");`\n ) as (\n data: Record<string, unknown>,\n escape: typeof escapeHtml,\n stringify: typeof stringifyTemplateValue\n ) => string;\n\n return render(data, escapeHtml, stringifyTemplateValue);\n}\n","export class MissingCanonicalResponseError extends Error {\n public override readonly name = \"MissingCanonicalResponseError\";\n\n public constructor(public readonly responseName: string) {\n super(\n `Missing canonical response '${responseName}' in the normalized spec.`\n );\n }\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { pascalCase } from \"polycase\";\nimport { relative } from \"../helpers/path.js\";\nimport { renderTemplate } from \"../helpers/templateEngine.js\";\nimport { MissingCanonicalResponseError } from \"./errors/MissingCanonicalResponseError.js\";\nimport type { NormalizedResponse, NormalizedSpec } from \"../NormalizedSpec.js\";\nimport type { GeneratorContext, PluginConfig, PluginContext } from \"./types.js\";\n\nexport type PluginContextBuilderApi = {\n readonly createPluginContext: (params: {\n outputDir: string;\n inputDir: string;\n config: PluginConfig;\n }) => PluginContext;\n readonly createGeneratorContext: (params: {\n readonly outputDir: string;\n readonly inputDir: string;\n readonly config: PluginConfig;\n readonly normalizedSpec: NormalizedSpec;\n readonly templateDir: string;\n readonly coreDir: string;\n readonly responsesOutputDir: string;\n readonly specOutputDir: string;\n }) => GeneratorContext;\n readonly getGeneratedFiles: () => string[];\n readonly clearGeneratedFiles: () => void;\n};\n\nexport function createPluginContextBuilder(): PluginContextBuilderApi {\n const generatedFiles = new Set<string>();\n\n const createPluginContext = (params: {\n outputDir: string;\n inputDir: string;\n config: PluginConfig;\n }): PluginContext => {\n return {\n outputDir: params.outputDir,\n inputDir: params.inputDir,\n config: params.config,\n };\n };\n\n const createGeneratorContext = (params: {\n readonly outputDir: string;\n readonly inputDir: string;\n readonly config: PluginConfig;\n readonly normalizedSpec: NormalizedSpec;\n readonly templateDir: string;\n readonly coreDir: string;\n readonly responsesOutputDir: string;\n readonly specOutputDir: string;\n }): GeneratorContext => {\n const pluginContext = createPluginContext(params);\n const canonicalResponsesByName = new Map<string, NormalizedResponse>(\n params.normalizedSpec.responses.map(response => [response.name, response])\n );\n\n const getResourceOutputDir = (resourceName: string): string => {\n return path.join(params.outputDir, resourceName);\n };\n\n const getOperationOutputPaths = (config: {\n readonly resourceName: string;\n readonly operationId: string;\n }) => {\n const outputDir = getResourceOutputDir(config.resourceName);\n const fileBase = pascalCase(config.operationId);\n const requestFileName = `${fileBase}Request.ts`;\n const responseFileName = `${fileBase}Response.ts`;\n const requestValidationFileName = `${fileBase}RequestValidator.ts`;\n const responseValidationFileName = `${fileBase}ResponseValidator.ts`;\n const clientFileName = `${fileBase}Client.ts`;\n\n return {\n outputDir,\n requestFile: path.join(outputDir, requestFileName),\n requestFileName,\n responseFile: path.join(outputDir, responseFileName),\n responseFileName,\n requestValidationFile: path.join(outputDir, requestValidationFileName),\n requestValidationFileName,\n responseValidationFile: path.join(\n outputDir,\n responseValidationFileName\n ),\n responseValidationFileName,\n clientFile: path.join(outputDir, clientFileName),\n clientFileName,\n };\n };\n\n const getCanonicalResponse = (responseName: string): NormalizedResponse => {\n const response = canonicalResponsesByName.get(responseName);\n\n if (response === undefined) {\n throw new MissingCanonicalResponseError(responseName);\n }\n\n return response;\n };\n\n const getCanonicalResponseOutputFile = (responseName: string): string => {\n return path.join(\n params.responsesOutputDir,\n `${pascalCase(responseName)}Response.ts`\n );\n };\n\n return {\n ...pluginContext,\n normalizedSpec: params.normalizedSpec,\n coreDir: params.coreDir,\n responsesOutputDir: params.responsesOutputDir,\n specOutputDir: params.specOutputDir,\n getCanonicalResponse,\n getCanonicalResponseOutputFile,\n getCanonicalResponseImportPath: config => {\n return relative(\n config.importerDir,\n getCanonicalResponseOutputFile(config.responseName).replace(\n /\\.ts$/,\n \".js\"\n )\n );\n },\n getSpecImportPath: config => {\n return relative(\n config.importerDir,\n path.join(params.specOutputDir, \"spec.js\")\n );\n },\n getOperationDefinitionAccessor: config => {\n return (\n `getOperationDefinition(` +\n `spec, ` +\n `${JSON.stringify(config.resourceName)}, ` +\n `${JSON.stringify(config.operationId)}` +\n `)`\n );\n },\n getOperationOutputPaths,\n getResourceOutputDir,\n\n writeFile: (relativePath: string, content: string) => {\n const fullPath = path.join(params.outputDir, relativePath);\n const dir = path.dirname(fullPath);\n\n fs.mkdirSync(dir, { recursive: true });\n fs.writeFileSync(fullPath, content);\n generatedFiles.add(relativePath);\n\n console.info(`Generated: ${relativePath}`);\n },\n\n renderTemplate: (templatePath: string, data: unknown) => {\n const fullTemplatePath = path.isAbsolute(templatePath)\n ? templatePath\n : path.join(params.templateDir, templatePath);\n\n const template = fs.readFileSync(fullTemplatePath, \"utf8\");\n return renderTemplate(\n template,\n (data ?? {}) as Record<string, unknown>\n );\n },\n\n addGeneratedFile: (relativePath: string) => {\n generatedFiles.add(relativePath);\n },\n\n getGeneratedFiles: () => {\n return Array.from(generatedFiles);\n },\n };\n };\n\n return {\n createPluginContext,\n createGeneratorContext,\n getGeneratedFiles: () => Array.from(generatedFiles),\n clearGeneratedFiles: () => generatedFiles.clear(),\n };\n}\n","export type CreateJSDocCommentOptions = {\n readonly indentation?: string;\n};\n\nconst BLOCK_COMMENT_END_PATTERN = /\\*\\//g;\nconst LINE_BREAK_PATTERN = /\\r\\n?/g;\n\nexport function createJSDocComment(\n text: string | undefined,\n options: CreateJSDocCommentOptions = {}\n): string | undefined {\n const normalizedText = text?.replace(LINE_BREAK_PATTERN, \"\\n\");\n const trimmedText = normalizedText?.trim();\n\n if (!trimmedText) return undefined;\n\n const indentation = options.indentation ?? \"\";\n const lines = trimmedText\n .replace(BLOCK_COMMENT_END_PATTERN, \"*\\\\/\")\n .split(\"\\n\");\n\n return [\n `${indentation}/**`,\n ...lines.map(line => `${indentation} * ${line}`),\n `${indentation} */`,\n ].join(\"\\n\");\n}\n","import { HttpMethod } from \"@rexeus/typeweaver-core\";\n\n/**\n * HTTP method priority for route ordering.\n * Lower numbers = higher priority (sorted first).\n */\nconst METHOD_PRIORITY: Record<string, number> = {\n [HttpMethod.GET]: 1,\n [HttpMethod.POST]: 2,\n [HttpMethod.PUT]: 3,\n [HttpMethod.PATCH]: 4,\n [HttpMethod.DELETE]: 5,\n [HttpMethod.OPTIONS]: 6,\n [HttpMethod.HEAD]: 7,\n};\n\n/**\n * Returns the sort priority for an HTTP method.\n * Unrecognized methods default to priority 999.\n */\nexport const getMethodPriority = (method: string): number =>\n METHOD_PRIORITY[method] ?? 999;\n\n/**\n * Compares two path segments for route ordering.\n * Returns negative if a should come before b, positive if after.\n *\n * Order: static segments before parameters, then alphabetically.\n */\nconst comparePathSegments = (a: string, b: string): number => {\n const aIsParam = a.startsWith(\":\");\n const bIsParam = b.startsWith(\":\");\n\n if (aIsParam !== bIsParam) {\n return aIsParam ? 1 : -1;\n }\n\n return a.localeCompare(b);\n};\n\n/**\n * Compares two routes for ordering.\n * Routes are sorted by:\n * 1. Path depth (shallow to deep)\n * 2. Static segments before parameters\n * 3. Alphabetical within same segment type\n * 4. HTTP method priority\n */\nexport const compareRoutes = (\n a: { method: string; path: string },\n b: { method: string; path: string }\n): number => {\n const aSegments = a.path.split(\"/\").filter(Boolean);\n const bSegments = b.path.split(\"/\").filter(Boolean);\n\n if (aSegments.length !== bSegments.length) {\n return aSegments.length - bSegments.length;\n }\n\n for (let i = 0; i < aSegments.length; i++) {\n const cmp = comparePathSegments(aSegments[i]!, bSegments[i]!);\n if (cmp !== 0) {\n return cmp;\n }\n }\n\n return getMethodPriority(a.method) - getMethodPriority(b.method);\n};\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":["isZodObject"],"sources":["../src/errors/DerivedResponseCycleError.ts","../src/errors/DuplicateOperationIdError.ts","../src/errors/DuplicateRouteError.ts","../src/errors/EmptyOperationResponsesError.ts","../src/errors/EmptyResourceOperationsError.ts","../src/errors/EmptySpecResourcesError.ts","../src/errors/InvalidDerivedResponseError.ts","../src/errors/InvalidOperationIdError.ts","../src/errors/InvalidRequestSchemaError.ts","../src/errors/InvalidResourceNameError.ts","../src/errors/MissingDerivedResponseParentError.ts","../src/errors/PathParameterMismatchError.ts","../src/bodyNormalization.ts","../src/helpers/namingUtils.ts","../src/helpers/routePath.ts","../src/validation/derivedResponseValidation.ts","../src/normalizeSpec.ts","../src/plugins/types.ts","../src/plugins/BasePlugin.ts","../src/plugins/pluginRegistry.ts","../src/helpers/path.ts","../src/helpers/templateEngine.ts","../src/plugins/errors/MissingCanonicalResponseError.ts","../src/plugins/pluginContext.ts","../src/helpers/jsdoc.ts","../src/helpers/routeSort.ts"],"sourcesContent":["export class DerivedResponseCycleError extends Error {\n public constructor(responseName: string) {\n super(`Derived response '${responseName}' contains a cyclic lineage.`);\n this.name = \"DerivedResponseCycleError\";\n }\n}\n","export class DuplicateOperationIdError extends Error {\n public constructor(operationId: string) {\n super(\n `Operation ID '${operationId}' must be globally unique within a spec.`\n );\n this.name = \"DuplicateOperationIdError\";\n }\n}\n","export class DuplicateRouteError extends Error {\n public constructor(method: string, path: string, normalizedPath: string) {\n super(\n `Route '${method} ${path}' conflicts with an existing route using normalized path '${normalizedPath}'.`\n );\n this.name = \"DuplicateRouteError\";\n }\n}\n","export class EmptyOperationResponsesError extends Error {\n public constructor(operationId: string) {\n super(`Operation '${operationId}' must declare at least one response.`);\n this.name = \"EmptyOperationResponsesError\";\n }\n}\n","export class EmptyResourceOperationsError extends Error {\n public constructor(resourceName: string) {\n super(`Resource '${resourceName}' must contain at least one operation.`);\n this.name = \"EmptyResourceOperationsError\";\n }\n}\n","export class EmptySpecResourcesError extends Error {\n public constructor() {\n super(\"Spec definition must contain at least one resource.\");\n this.name = \"EmptySpecResourcesError\";\n }\n}\n","export class InvalidDerivedResponseError extends Error {\n public constructor(responseName: string) {\n super(\n `Derived response '${responseName}' contains invalid lineage metadata.`\n );\n this.name = \"InvalidDerivedResponseError\";\n }\n}\n","export class InvalidOperationIdError extends Error {\n public constructor(operationId: string) {\n super(\n `Operation ID '${operationId}' is invalid. Use camelCase (preferred) or PascalCase. snake_case and kebab-case are not supported.`\n );\n this.name = \"InvalidOperationIdError\";\n }\n}\n","import type { NormalizedRequest } from \"../NormalizedSpec.js\";\n\nexport class InvalidRequestSchemaError extends Error {\n public constructor(\n operationId: string,\n requestPart: keyof NormalizedRequest\n ) {\n super(\n `Operation '${operationId}' has an invalid request.${requestPart} schema definition.`\n );\n this.name = \"InvalidRequestSchemaError\";\n }\n}\n","export class InvalidResourceNameError extends Error {\n public constructor(resourceName: string) {\n super(\n `Resource name '${resourceName}' is invalid. Use camelCase singular nouns when possible; PascalCase is also supported. snake_case and kebab-case are not supported.`\n );\n this.name = \"InvalidResourceNameError\";\n }\n}\n","export class MissingDerivedResponseParentError extends Error {\n public constructor(responseName: string, parentName: string) {\n super(\n `Derived response '${responseName}' references missing canonical parent '${parentName}'.`\n );\n this.name = \"MissingDerivedResponseParentError\";\n }\n}\n","export class PathParameterMismatchError extends Error {\n public constructor(\n operationId: string,\n path: string,\n pathParams: readonly string[],\n requestParams: readonly string[]\n ) {\n super(\n `Operation '${operationId}' has mismatched path parameters for '${path}'. Path params: [${pathParams.join(\n \", \"\n )}], request.param keys: [${requestParams.join(\", \")}].`\n );\n this.name = \"PathParameterMismatchError\";\n }\n}\n","import type { HttpBodySchema, HttpHeaderSchema } from \"@rexeus/typeweaver-core\";\nimport { z } from \"zod\";\nimport type {\n NormalizedBodyMediaTypeSource,\n NormalizedBodyTransport,\n NormalizedHttpBody,\n NormalizedSpecWarning,\n NormalizedSpecWarningLocation,\n} from \"./NormalizedSpec.js\";\n\nexport type NormalizeBodyInput = {\n readonly bodySchema?: HttpBodySchema;\n readonly headerSchema?: HttpHeaderSchema;\n readonly location: NormalizedSpecWarningLocation;\n};\n\nexport type NormalizeBodyResult = {\n readonly body?: NormalizedHttpBody;\n readonly warnings: readonly NormalizedSpecWarning[];\n};\n\ntype ZodObjectWithShape = z.ZodObject<Record<string, z.ZodType>> & {\n readonly shape: Record<string, z.ZodType>;\n};\n\ntype ContentTypeHeaderResult =\n | { readonly kind: \"absent\" }\n | { readonly kind: \"ambiguous\" }\n | { readonly kind: \"literal\"; readonly value: string };\n\ntype ZodTypeDefinition = {\n readonly type?: string;\n readonly innerType?: z.ZodType;\n readonly schema?: z.ZodType;\n readonly in?: z.ZodType;\n readonly out?: z.ZodType;\n};\n\nconst JSON_BODY_SCHEMA_TYPES = new Set([\n \"array\",\n \"boolean\",\n \"enum\",\n \"intersection\",\n \"literal\",\n \"null\",\n \"number\",\n \"object\",\n \"record\",\n \"tuple\",\n \"union\",\n]);\n\nexport const normalizeBody = (\n input: NormalizeBodyInput\n): NormalizeBodyResult => {\n if (input.bodySchema === undefined) {\n return { warnings: [] };\n }\n\n const warnings: NormalizedSpecWarning[] = [];\n const contentTypeHeader = extractContentTypeHeader(input.headerSchema);\n\n if (contentTypeHeader.kind === \"literal\") {\n return {\n body: createNormalizedBody({\n schema: input.bodySchema,\n mediaType: contentTypeHeader.value,\n mediaTypeSource: \"content-type-header\",\n }),\n warnings,\n };\n }\n\n if (contentTypeHeader.kind === \"ambiguous\") {\n warnings.push({\n code: \"ambiguous-content-type-header\",\n message:\n \"Content-Type header is present but does not have one unambiguous literal value; inferred body media type instead.\",\n location: input.location,\n });\n } else {\n warnings.push({\n code: \"missing-content-type-header\",\n message:\n \"Body schema is present without a Content-Type header; inferred body media type from schema.\",\n location: input.location,\n });\n }\n\n const inferred = inferBodyMediaType(input.bodySchema);\n\n if (inferred.mediaTypeSource === \"raw-fallback\") {\n warnings.push({\n code: \"raw-body-media-type-fallback\",\n message:\n \"Body schema does not imply a concrete media type; used application/octet-stream raw transport fallback.\",\n location: input.location,\n });\n }\n\n return {\n body: createNormalizedBody({\n schema: input.bodySchema,\n ...inferred,\n }),\n warnings,\n };\n};\n\nconst createNormalizedBody = (input: {\n readonly schema: HttpBodySchema;\n readonly mediaType: string;\n readonly mediaTypeSource: NormalizedBodyMediaTypeSource;\n}): NormalizedHttpBody => {\n return {\n schema: input.schema,\n mediaType: input.mediaType,\n mediaTypeSource: input.mediaTypeSource,\n transport: resolveTransport(input.mediaType),\n };\n};\n\nconst extractContentTypeHeader = (\n headerSchema: HttpHeaderSchema | undefined\n): ContentTypeHeaderResult => {\n const headerObject = unwrapOptional(headerSchema);\n\n if (headerObject === undefined || !isZodObject(headerObject)) {\n return { kind: \"absent\" };\n }\n\n const contentTypeEntries = Object.entries(headerObject.shape).filter(\n ([headerName]) => headerName.toLowerCase() === \"content-type\"\n );\n\n if (contentTypeEntries.length === 0) {\n return { kind: \"absent\" };\n }\n\n const literalValues = contentTypeEntries.flatMap(([, schema]) =>\n extractStringLiteralValues(schema)\n );\n const distinctValues = new Set(literalValues);\n\n if (contentTypeEntries.length === 1 && distinctValues.size === 1) {\n const [value] = distinctValues;\n\n return value === undefined\n ? { kind: \"ambiguous\" }\n : { kind: \"literal\", value };\n }\n\n return { kind: \"ambiguous\" };\n};\n\nconst inferBodyMediaType = (\n schema: HttpBodySchema\n): {\n readonly mediaType: string;\n readonly mediaTypeSource: NormalizedBodyMediaTypeSource;\n} => {\n const inferenceSchema = unwrapMediaInferenceSchema(schema);\n const schemaType = getSchemaType(inferenceSchema);\n\n if (isTextBodySchema(inferenceSchema)) {\n return { mediaType: \"text/plain\", mediaTypeSource: \"body-schema\" };\n }\n\n if (schemaType === \"any\" || schemaType === \"unknown\") {\n return {\n mediaType: \"application/octet-stream\",\n mediaTypeSource: \"raw-fallback\",\n };\n }\n\n if (schemaType !== undefined && JSON_BODY_SCHEMA_TYPES.has(schemaType)) {\n return { mediaType: \"application/json\", mediaTypeSource: \"body-schema\" };\n }\n\n return {\n mediaType: \"application/octet-stream\",\n mediaTypeSource: \"raw-fallback\",\n };\n};\n\nconst isTextBodySchema = (schema: z.ZodType | undefined): boolean => {\n const schemaType = getSchemaType(schema);\n\n if (schemaType === \"string\") {\n return true;\n }\n\n if (schemaType === \"literal\") {\n const values = literalSchemaValues(schema);\n\n return (\n values.length > 0 && values.every(value => typeof value === \"string\")\n );\n }\n\n if (schemaType === \"enum\") {\n const values = enumSchemaValues(schema);\n\n return (\n values.length > 0 && values.every(value => typeof value === \"string\")\n );\n }\n\n return false;\n};\n\nexport const resolveTransport = (\n mediaType: string\n): NormalizedBodyTransport => {\n const normalizedMediaType = mediaType.split(\";\")[0]?.trim().toLowerCase();\n\n if (\n normalizedMediaType === \"application/json\" ||\n normalizedMediaType?.endsWith(\"+json\") === true\n ) {\n return \"json\";\n }\n\n if (normalizedMediaType?.startsWith(\"text/\") === true) {\n return \"text\";\n }\n\n if (normalizedMediaType === \"application/x-www-form-urlencoded\") {\n return \"form-url-encoded\";\n }\n\n if (normalizedMediaType === \"multipart/form-data\") {\n return \"multipart\";\n }\n\n return \"raw\";\n};\n\nconst unwrapMediaInferenceSchema = (\n schema: z.ZodType | undefined\n): z.ZodType | undefined => {\n const visitedSchemas = new Set<z.ZodType>();\n let current = schema;\n\n while (current !== undefined && !visitedSchemas.has(current)) {\n visitedSchemas.add(current);\n\n const definition = getSchemaDefinition(current);\n const schemaType = definition?.type;\n\n if (\n schemaType === \"optional\" ||\n schemaType === \"nullable\" ||\n schemaType === \"default\" ||\n schemaType === \"catch\" ||\n schemaType === \"prefault\" ||\n schemaType === \"readonly\"\n ) {\n current = definition?.innerType;\n continue;\n }\n\n if (schemaType === \"pipe\") {\n const outputType = getSchemaType(definition?.out);\n\n if (outputType === undefined || outputType === \"transform\") {\n return undefined;\n }\n\n current = definition?.out;\n continue;\n }\n\n if (schemaType === \"effects\") {\n current = definition?.schema;\n continue;\n }\n\n return current;\n }\n\n return current;\n};\n\nconst unwrapOptional = <TSchema extends z.ZodType>(\n schema: TSchema | z.ZodOptional<TSchema> | undefined\n): TSchema | undefined => {\n return schema instanceof z.ZodOptional\n ? (schema.unwrap() as TSchema)\n : schema;\n};\n\nconst isZodObject = (schema: z.ZodType): schema is ZodObjectWithShape => {\n return getSchemaType(schema) === \"object\" && \"shape\" in schema;\n};\n\nconst extractStringLiteralValues = (schema: z.ZodType): readonly string[] => {\n const unwrappedSchema = unwrapOptional(schema);\n\n if (unwrappedSchema === undefined) {\n return [];\n }\n\n if (getSchemaType(unwrappedSchema) === \"literal\") {\n return literalSchemaValues(unwrappedSchema).filter(\n (value): value is string => typeof value === \"string\"\n );\n }\n\n if (getSchemaType(unwrappedSchema) === \"enum\") {\n return enumSchemaValues(unwrappedSchema).filter(\n (value): value is string => typeof value === \"string\"\n );\n }\n\n return [];\n};\n\nconst literalSchemaValues = (\n schema: z.ZodType | undefined\n): readonly unknown[] => {\n const literalSchema = schema as\n | {\n readonly values?: ReadonlySet<unknown>;\n }\n | undefined;\n\n return Array.from(literalSchema?.values ?? []);\n};\n\nconst enumSchemaValues = (\n schema: z.ZodType | undefined\n): readonly unknown[] => {\n const enumSchema = schema as\n | {\n readonly options?: readonly unknown[];\n readonly enum?: Record<string, unknown>;\n readonly def?: {\n readonly entries?: Record<string, unknown>;\n readonly values?: readonly unknown[];\n };\n }\n | undefined;\n\n return (\n enumSchema?.options ??\n enumSchema?.def?.values ??\n Object.values(enumSchema?.def?.entries ?? enumSchema?.enum ?? {})\n );\n};\n\nconst getSchemaType = (schema: z.ZodType | undefined): string | undefined => {\n return getSchemaDefinition(schema)?.type;\n};\n\nconst getSchemaDefinition = (\n schema: z.ZodType | undefined\n): ZodTypeDefinition | undefined => {\n const schemaWithDefinition = schema as\n | {\n readonly def?: ZodTypeDefinition;\n readonly _def?: ZodTypeDefinition;\n }\n | undefined;\n\n return schemaWithDefinition?.def ?? schemaWithDefinition?._def;\n};\n","import { isCamelCase, isPascalCase } from \"polycase\";\n\nconst startsWithDigit = (value: string): boolean => /^[0-9]/u.test(value);\n\nconst isSupportedIdentifierName = (value: string): boolean => {\n if (startsWithDigit(value)) {\n return false;\n }\n\n return isCamelCase(value) || isPascalCase(value);\n};\n\nexport const isSupportedOperationId = (value: string): boolean => {\n return isSupportedIdentifierName(value);\n};\n\nexport const isSupportedResourceName = (value: string): boolean => {\n return isSupportedIdentifierName(value);\n};\n","const PATH_PARAMETER_PATTERN = /:([A-Za-z0-9_]+)/g;\n\nexport const normalizeRoutePath = (path: string): string => {\n const segments = path.split(\"/\").filter(Boolean);\n\n if (segments.length === 0) {\n return \"/\";\n }\n\n return `/${segments.map(segment => (segment.startsWith(\":\") ? \":\" : segment)).join(\"/\")}`;\n};\n\nexport const getPathParameterNames = (path: string): string[] => {\n return Array.from(\n path.matchAll(PATH_PARAMETER_PATTERN),\n match => match[1] as string\n );\n};\n","import {\n HttpStatusCodeNameMap,\n isNamedResponseDefinition,\n} from \"@rexeus/typeweaver-core\";\nimport type {\n ResponseDefinition,\n SpecDefinition,\n} from \"@rexeus/typeweaver-core\";\nimport { normalizeBody } from \"../bodyNormalization.js\";\nimport {\n DerivedResponseCycleError,\n InvalidDerivedResponseError,\n MissingDerivedResponseParentError,\n} from \"../errors/index.js\";\nimport type {\n NormalizedResponse,\n NormalizedSpecWarning,\n NormalizedSpecWarningLocation,\n} from \"../NormalizedSpec.js\";\n\nexport type NormalizeResponseDefinitionResult = {\n readonly response: NormalizedResponse;\n readonly warnings: readonly NormalizedSpecWarning[];\n};\n\nexport type CollectCanonicalResponsesResult = {\n readonly responses: Map<string, NormalizedResponse>;\n readonly warnings: readonly NormalizedSpecWarning[];\n};\n\nexport const validateDerivedResponseMetadata = (\n response: ResponseDefinition\n): void => {\n const derived = response.derived;\n\n if (derived === undefined) {\n return;\n }\n\n if (derived.parentName === response.name) {\n throw new DerivedResponseCycleError(response.name);\n }\n\n if (derived.lineage.length === 0) {\n throw new InvalidDerivedResponseError(response.name);\n }\n\n if (derived.lineage.at(-1) !== response.name) {\n throw new InvalidDerivedResponseError(response.name);\n }\n\n if (derived.lineage.length !== derived.depth) {\n throw new InvalidDerivedResponseError(response.name);\n }\n\n if (new Set(derived.lineage).size !== derived.lineage.length) {\n throw new DerivedResponseCycleError(response.name);\n }\n\n if (derived.depth > 1 && derived.lineage.at(-2) !== derived.parentName) {\n throw new InvalidDerivedResponseError(response.name);\n }\n};\n\nexport const collectCanonicalResponseDefinitions = (\n definition: SpecDefinition\n): Map<string, ResponseDefinition> => {\n const canonicalResponses = new Map<string, ResponseDefinition>();\n\n for (const resource of Object.values(definition.resources)) {\n for (const operation of resource.operations) {\n for (const response of operation.responses) {\n if (!isNamedResponseDefinition(response)) {\n continue;\n }\n\n validateDerivedResponseMetadata(response);\n\n canonicalResponses.set(response.name, response);\n }\n }\n }\n\n return canonicalResponses;\n};\n\nexport const getDerivedResponseChain = (\n response: ResponseDefinition,\n canonicalResponses: ReadonlyMap<string, ResponseDefinition>\n): readonly string[] => {\n const chain: string[] = [response.name];\n const visitedResponseNames = new Set(chain);\n let parentName = response.derived?.parentName;\n\n while (parentName !== undefined) {\n if (visitedResponseNames.has(parentName)) {\n throw new DerivedResponseCycleError(response.name);\n }\n\n const parentResponse = canonicalResponses.get(parentName);\n\n if (parentResponse === undefined) {\n throw new MissingDerivedResponseParentError(response.name, parentName);\n }\n\n chain.unshift(parentResponse.name);\n visitedResponseNames.add(parentResponse.name);\n parentName = parentResponse.derived?.parentName;\n }\n\n return chain;\n};\n\nexport const validateDerivedResponseGraph = (\n canonicalResponses: ReadonlyMap<string, ResponseDefinition>\n): void => {\n for (const response of canonicalResponses.values()) {\n validateDerivedResponseAgainstCanonicalGraph(response, canonicalResponses);\n }\n};\n\nconst validateDerivedResponseAgainstCanonicalGraph = (\n response: ResponseDefinition,\n canonicalResponses: ReadonlyMap<string, ResponseDefinition>\n): void => {\n if (response.derived === undefined) {\n return;\n }\n\n const chain = getDerivedResponseChain(response, canonicalResponses);\n const materializedLineage = chain.slice(1);\n\n if (response.derived.depth !== materializedLineage.length) {\n throw new InvalidDerivedResponseError(response.name);\n }\n\n if (\n materializedLineage.length !== response.derived.lineage.length ||\n materializedLineage.some(\n (lineageEntry, index) => lineageEntry !== response.derived?.lineage[index]\n )\n ) {\n throw new InvalidDerivedResponseError(response.name);\n }\n};\n\nconst validateInlineDerivedResponses = (\n definition: SpecDefinition,\n canonicalResponses: ReadonlyMap<string, ResponseDefinition>\n): void => {\n for (const resource of Object.values(definition.resources)) {\n for (const operation of resource.operations) {\n for (const response of operation.responses) {\n if (isNamedResponseDefinition(response)) {\n continue;\n }\n\n validateDerivedResponseMetadata(response);\n validateDerivedResponseAgainstCanonicalGraph(\n response,\n canonicalResponses\n );\n }\n }\n }\n};\n\nexport const normalizeResponseDefinition = (\n response: ResponseDefinition,\n location: Omit<NormalizedSpecWarningLocation, \"part\">\n): NormalizeResponseDefinitionResult => {\n const body = normalizeBody({\n bodySchema: response.body,\n headerSchema: response.header,\n location: { ...location, part: \"response.body\" },\n });\n\n return {\n response: {\n name: response.name,\n statusCode: response.statusCode,\n statusCodeName: HttpStatusCodeNameMap[response.statusCode],\n description: response.description,\n header: response.header,\n body: body.body,\n kind: response.derived === undefined ? \"response\" : \"derived-response\",\n derivedFrom: response.derived?.parentName,\n lineage: response.derived?.lineage,\n depth: response.derived?.depth,\n },\n warnings: body.warnings,\n };\n};\n\nexport const collectCanonicalResponses = (\n definition: SpecDefinition\n): CollectCanonicalResponsesResult => {\n const canonicalResponseDefinitions =\n collectCanonicalResponseDefinitions(definition);\n const warnings: NormalizedSpecWarning[] = [];\n\n validateDerivedResponseGraph(canonicalResponseDefinitions);\n validateInlineDerivedResponses(definition, canonicalResponseDefinitions);\n\n const responses = new Map<string, NormalizedResponse>();\n\n for (const [responseName, response] of canonicalResponseDefinitions) {\n const normalized = normalizeResponseDefinition(response, {\n responseName,\n statusCode: response.statusCode,\n });\n\n responses.set(responseName, normalized.response);\n warnings.push(...normalized.warnings);\n }\n\n return { responses, warnings };\n};\n","import {\n isNamedResponseDefinition,\n validateUniqueResponseNames,\n} from \"@rexeus/typeweaver-core\";\nimport type {\n RequestDefinition,\n ResourceDefinition,\n ResponseDefinition,\n SpecDefinition,\n} from \"@rexeus/typeweaver-core\";\nimport { z } from \"zod\";\nimport { normalizeBody } from \"./bodyNormalization.js\";\nimport {\n DuplicateOperationIdError,\n DuplicateRouteError,\n EmptyOperationResponsesError,\n EmptyResourceOperationsError,\n EmptySpecResourcesError,\n InvalidOperationIdError,\n InvalidRequestSchemaError,\n InvalidResourceNameError,\n PathParameterMismatchError,\n} from \"./errors/index.js\";\nimport {\n isSupportedOperationId,\n isSupportedResourceName,\n} from \"./helpers/namingUtils.js\";\nimport {\n getPathParameterNames,\n normalizeRoutePath,\n} from \"./helpers/routePath.js\";\nimport {\n collectCanonicalResponses,\n normalizeResponseDefinition,\n} from \"./validation/index.js\";\nimport type {\n NormalizedOperation,\n NormalizedRequest,\n NormalizedResponseUsage,\n NormalizedSpec,\n NormalizedSpecWarning,\n} from \"./NormalizedSpec.js\";\n\ntype ValidateRequestResult = {\n readonly request?: NormalizedRequest;\n readonly warnings: readonly NormalizedSpecWarning[];\n};\n\ntype NormalizeOperationResponsesResult = {\n readonly responses: readonly NormalizedResponseUsage[];\n readonly warnings: readonly NormalizedSpecWarning[];\n};\n\ntype NormalizeOperationResult = {\n readonly operation: NormalizedOperation;\n readonly warnings: readonly NormalizedSpecWarning[];\n};\n\nconst isZodType = (schema: unknown): schema is z.ZodType => {\n return schema instanceof z.ZodType;\n};\n\nconst isZodObject = (\n schema: unknown\n): schema is z.ZodObject<z.core.$ZodShape> => {\n return schema instanceof z.ZodObject;\n};\n\nconst validateRequestSchema = (\n operationId: string,\n requestPart: keyof NormalizedRequest,\n schema: unknown\n): void => {\n if (!isZodType(schema)) {\n throw new InvalidRequestSchemaError(operationId, requestPart);\n }\n\n if (requestPart === \"param\" && !isZodObject(schema)) {\n throw new InvalidRequestSchemaError(operationId, requestPart);\n }\n};\n\nconst validateRequest = (\n resourceName: string,\n operationId: string,\n path: string,\n request: RequestDefinition\n): ValidateRequestResult => {\n if (request.header !== undefined) {\n validateRequestSchema(operationId, \"header\", request.header);\n }\n\n if (request.param !== undefined) {\n validateRequestSchema(operationId, \"param\", request.param);\n }\n\n if (request.query !== undefined) {\n validateRequestSchema(operationId, \"query\", request.query);\n }\n\n if (request.body !== undefined) {\n validateRequestSchema(operationId, \"body\", request.body);\n }\n\n const pathParams = getPathParameterNames(path);\n const requestParams =\n request.param === undefined ? [] : Object.keys(request.param.shape);\n\n if (\n pathParams.length !== requestParams.length ||\n pathParams.some(pathParam => !requestParams.includes(pathParam))\n ) {\n throw new PathParameterMismatchError(\n operationId,\n path,\n pathParams,\n requestParams\n );\n }\n\n if (\n request.header === undefined &&\n request.param === undefined &&\n request.query === undefined &&\n request.body === undefined\n ) {\n return { warnings: [] };\n }\n\n const body = normalizeBody({\n bodySchema: request.body,\n headerSchema: request.header,\n location: { resourceName, operationId, part: \"request.body\" },\n });\n\n return {\n request: {\n header: request.header,\n param: request.param,\n query: request.query,\n body: body.body,\n },\n warnings: body.warnings,\n };\n};\n\nconst normalizeOperationResponses = (\n resourceName: string,\n operationId: string,\n responses: readonly ResponseDefinition[]\n): NormalizeOperationResponsesResult => {\n const warnings: NormalizedSpecWarning[] = [];\n const normalizedResponses = responses.map(response => {\n if (isNamedResponseDefinition(response)) {\n return {\n responseName: response.name,\n source: \"canonical\",\n } satisfies NormalizedResponseUsage;\n }\n\n const normalized = normalizeResponseDefinition(response, {\n resourceName,\n operationId,\n responseName: response.name,\n statusCode: response.statusCode,\n });\n\n warnings.push(...normalized.warnings);\n\n return {\n responseName: response.name,\n source: \"inline\",\n response: normalized.response,\n } satisfies NormalizedResponseUsage;\n });\n\n return { responses: normalizedResponses, warnings };\n};\n\nconst normalizeOperation = (\n resourceName: string,\n operationIds: Set<string>,\n routeKeys: Set<string>,\n operation: ResourceDefinition[\"operations\"][number]\n): NormalizeOperationResult => {\n if (!isSupportedOperationId(operation.operationId)) {\n throw new InvalidOperationIdError(operation.operationId);\n }\n\n if (operationIds.has(operation.operationId)) {\n throw new DuplicateOperationIdError(operation.operationId);\n }\n\n operationIds.add(operation.operationId);\n\n const normalizedPath = normalizeRoutePath(operation.path);\n const routeKey = `${operation.method}:${normalizedPath}`;\n\n if (routeKeys.has(routeKey)) {\n throw new DuplicateRouteError(\n operation.method,\n operation.path,\n normalizedPath\n );\n }\n\n routeKeys.add(routeKey);\n\n if (operation.responses.length === 0) {\n throw new EmptyOperationResponsesError(operation.operationId);\n }\n\n const request = validateRequest(\n resourceName,\n operation.operationId,\n operation.path,\n operation.request\n );\n const responses = normalizeOperationResponses(\n resourceName,\n operation.operationId,\n operation.responses\n );\n\n return {\n operation: {\n operationId: operation.operationId,\n method: operation.method,\n path: operation.path,\n summary: operation.summary,\n request: request.request,\n responses: responses.responses,\n },\n warnings: [...request.warnings, ...responses.warnings],\n };\n};\n\nexport const normalizeSpec = (definition: SpecDefinition): NormalizedSpec => {\n const resourceEntries = Object.entries(definition.resources);\n\n if (resourceEntries.length === 0) {\n throw new EmptySpecResourcesError();\n }\n\n validateUniqueResponseNames(definition.resources);\n const canonicalResponses = collectCanonicalResponses(definition);\n const operationIds = new Set<string>();\n const routeKeys = new Set<string>();\n const warnings: NormalizedSpecWarning[] = [...canonicalResponses.warnings];\n\n return {\n resources: resourceEntries.map(([resourceName, resource]) => {\n if (!isSupportedResourceName(resourceName)) {\n throw new InvalidResourceNameError(resourceName);\n }\n\n if (resource.operations.length === 0) {\n throw new EmptyResourceOperationsError(resourceName);\n }\n\n return {\n name: resourceName,\n operations: resource.operations.map(operation => {\n const normalized = normalizeOperation(\n resourceName,\n operationIds,\n routeKeys,\n operation\n );\n\n warnings.push(...normalized.warnings);\n\n return normalized.operation;\n }),\n };\n }),\n responses: Array.from(canonicalResponses.responses.values()),\n warnings,\n };\n};\n","import type { NormalizedResponse, NormalizedSpec } from \"../NormalizedSpec.js\";\n\n/**\n * Configuration for a typeweaver plugin\n */\nexport type PluginConfig = Record<string, unknown>;\n\n/**\n * Context provided to plugins during initialization and finalization\n */\nexport type PluginContext = {\n readonly outputDir: string;\n readonly inputDir: string;\n readonly config: PluginConfig;\n};\n\nexport type OperationOutputPaths = {\n readonly outputDir: string;\n readonly requestFile: string;\n readonly requestFileName: string;\n readonly responseFile: string;\n readonly responseFileName: string;\n readonly requestValidationFile: string;\n readonly requestValidationFileName: string;\n readonly responseValidationFile: string;\n readonly responseValidationFileName: string;\n readonly clientFile: string;\n readonly clientFileName: string;\n};\n\n/**\n * Context provided to plugins during generation\n */\nexport type GeneratorContext = PluginContext & {\n readonly normalizedSpec: NormalizedSpec;\n readonly coreDir: string;\n readonly responsesOutputDir: string;\n readonly specOutputDir: string;\n\n readonly getCanonicalResponse: (responseName: string) => NormalizedResponse;\n readonly getCanonicalResponseOutputFile: (responseName: string) => string;\n readonly getCanonicalResponseImportPath: (params: {\n readonly importerDir: string;\n readonly responseName: string;\n }) => string;\n readonly getSpecImportPath: (params: {\n readonly importerDir: string;\n }) => string;\n readonly getOperationDefinitionAccessor: (params: {\n readonly resourceName: string;\n readonly operationId: string;\n }) => string;\n readonly getOperationOutputPaths: (params: {\n readonly resourceName: string;\n readonly operationId: string;\n }) => OperationOutputPaths;\n readonly getResourceOutputDir: (resourceName: string) => string;\n readonly writeFile: (relativePath: string, content: string) => void;\n readonly renderTemplate: (templatePath: string, data: unknown) => string;\n readonly addGeneratedFile: (relativePath: string) => void;\n readonly getGeneratedFiles: () => string[];\n};\n\n/**\n * Plugin metadata\n */\nexport type PluginMetadata = {\n readonly name: string;\n readonly depends?: readonly string[];\n};\n\n/**\n * typeweaver plugin interface\n */\nexport type TypeweaverPlugin = PluginMetadata & {\n /**\n * Initialize the plugin\n * Called before any generation happens\n */\n initialize?(context: PluginContext): Promise<void> | void;\n\n /**\n * Collect and transform resources\n * Allows plugins to modify the resource collection\n */\n collectResources?(\n normalizedSpec: NormalizedSpec\n ): Promise<NormalizedSpec> | NormalizedSpec;\n\n /**\n * Main generation logic\n * Called with all resources and utilities\n */\n generate?(context: GeneratorContext): Promise<void> | void;\n\n /**\n * Finalize the plugin\n * Called after all generation is complete\n */\n finalize?(context: PluginContext): Promise<void> | void;\n};\n\n/**\n * Plugin constructor type\n */\nexport type PluginConstructor = new (config?: PluginConfig) => TypeweaverPlugin;\n\n/**\n * Plugin module export\n */\nexport type PluginModule = {\n default: PluginConstructor;\n};\n\n/**\n * Plugin registration entry\n */\nexport type PluginRegistration = {\n name: string;\n plugin: TypeweaverPlugin;\n config?: PluginConfig;\n};\n\n/**\n * typeweaver configuration\n */\nexport type TypeweaverConfig = {\n input: string;\n output: string;\n plugins?: (string | [string, PluginConfig])[];\n format?: boolean;\n clean?: boolean;\n};\n\n/**\n * Plugin loading error\n */\nexport class PluginLoadError extends Error {\n constructor(\n public pluginName: string,\n message: string\n ) {\n super(`Failed to load plugin '${pluginName}': ${message}`);\n this.name = \"PluginLoadError\";\n }\n}\n\n/**\n * Plugin dependency error\n */\nexport class PluginDependencyError extends Error {\n constructor(\n public pluginName: string,\n public missingDependency: string,\n message?: string\n ) {\n super(\n message ??\n `Plugin '${pluginName}' depends on '${missingDependency}' which is not loaded`\n );\n this.name = \"PluginDependencyError\";\n }\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { NormalizedSpec } from \"../NormalizedSpec.js\";\nimport type {\n GeneratorContext,\n PluginConfig,\n PluginContext,\n TypeweaverPlugin,\n} from \"./types.js\";\n\n/**\n * Base class for typeweaver plugins\n * Provides default implementations and common utilities\n */\nexport abstract class BasePlugin implements TypeweaverPlugin {\n abstract name: string;\n description?: string;\n author?: string;\n depends?: string[];\n\n protected config: PluginConfig;\n\n constructor(config: PluginConfig = {}) {\n this.config = config;\n }\n\n /**\n * Default implementation - override in subclasses if needed\n */\n async initialize(_context: PluginContext): Promise<void> {\n // Default: no initialization needed\n }\n\n /**\n * Default implementation - override in subclasses if needed\n */\n collectResources(normalizedSpec: NormalizedSpec): NormalizedSpec {\n return normalizedSpec;\n }\n\n /**\n * Main generation logic - must be implemented by subclasses\n */\n abstract generate(context: GeneratorContext): Promise<void> | void;\n\n /**\n * Default implementation - override in subclasses if needed\n */\n async finalize(_context: PluginContext): Promise<void> {\n // Default: no finalization needed\n }\n\n protected copyLibFiles(\n context: GeneratorContext,\n libSourceDir: string,\n libNamespace: string\n ): void {\n if (!fs.existsSync(libSourceDir)) return;\n\n const libDir = path.join(context.outputDir, \"lib\", libNamespace);\n\n fs.cpSync(libSourceDir, libDir, { recursive: true });\n\n const libIndexPath = path.join(\"lib\", libNamespace, \"index.ts\");\n if (fs.existsSync(path.join(libDir, \"index.ts\"))) {\n context.addGeneratedFile(libIndexPath);\n }\n }\n}\n","import { PluginDependencyError } from \"./types.js\";\nimport type { PluginRegistration, TypeweaverPlugin } from \"./types.js\";\n\nexport type PluginRegistryApi = {\n readonly register: (plugin: TypeweaverPlugin, config?: unknown) => void;\n readonly get: (name: string) => PluginRegistration | undefined;\n readonly getAll: () => PluginRegistration[];\n readonly has: (name: string) => boolean;\n readonly clear: () => void;\n};\n\nexport function createPluginRegistry(): PluginRegistryApi {\n const plugins = new Map<string, PluginRegistration>();\n let sortedRegistrations: PluginRegistration[] | undefined;\n\n const invalidateSortedRegistrations = (): void => {\n sortedRegistrations = undefined;\n };\n\n return {\n register: (plugin: TypeweaverPlugin, config?: unknown): void => {\n if (plugins.has(plugin.name)) {\n console.info(\n `Skipping duplicate registration of required plugin: ${plugin.name}`\n );\n return;\n }\n\n const registration: PluginRegistration = {\n name: plugin.name,\n plugin,\n config: config as Record<string, unknown>,\n };\n\n plugins.set(plugin.name, registration);\n invalidateSortedRegistrations();\n console.info(`Registered plugin: ${plugin.name}`);\n },\n get: (name: string) => plugins.get(name),\n getAll: () => {\n if (sortedRegistrations === undefined) {\n sortedRegistrations = sortPluginRegistrations(\n Array.from(plugins.values())\n );\n }\n\n return [...sortedRegistrations];\n },\n has: (name: string) => plugins.has(name),\n clear: () => {\n plugins.clear();\n invalidateSortedRegistrations();\n },\n };\n}\n\nfunction sortPluginRegistrations(\n registrations: readonly PluginRegistration[]\n): PluginRegistration[] {\n const registrationsByName = new Map(\n registrations.map(registration => [registration.name, registration])\n );\n const visiting = new Set<string>();\n const visited = new Set<string>();\n const sorted: PluginRegistration[] = [];\n\n for (const registration of registrations) {\n visitPlugin({\n registration,\n registrationsByName,\n visiting,\n visited,\n sorted,\n dependencyPath: [],\n });\n }\n\n return sorted;\n}\n\nfunction visitPlugin(params: {\n readonly registration: PluginRegistration;\n readonly registrationsByName: ReadonlyMap<string, PluginRegistration>;\n readonly visiting: Set<string>;\n readonly visited: Set<string>;\n readonly sorted: PluginRegistration[];\n readonly dependencyPath: readonly string[];\n}): void {\n const {\n registration,\n registrationsByName,\n visiting,\n visited,\n sorted,\n dependencyPath,\n } = params;\n\n if (visited.has(registration.name)) {\n return;\n }\n\n if (visiting.has(registration.name)) {\n const cyclePath = [...dependencyPath, registration.name].join(\" -> \");\n throw new PluginDependencyError(\n registration.name,\n registration.name,\n `Detected plugin dependency cycle: ${cyclePath}`\n );\n }\n\n visiting.add(registration.name);\n\n for (const dependencyName of registration.plugin.depends ?? []) {\n const dependency = registrationsByName.get(dependencyName);\n if (dependency === undefined) {\n throw new PluginDependencyError(registration.name, dependencyName);\n }\n\n visitPlugin({\n registration: dependency,\n registrationsByName,\n visiting,\n visited,\n sorted,\n dependencyPath: [...dependencyPath, registration.name],\n });\n }\n\n visiting.delete(registration.name);\n visited.add(registration.name);\n sorted.push(registration);\n}\n","import path from \"node:path\";\n\nexport function relative(from: string, to: string): string {\n const relativePath = path.relative(from, to);\n\n const posixPath = relativePath.split(path.sep).join(\"/\");\n\n if (\n posixPath === \"..\" ||\n posixPath.startsWith(\"./\") ||\n posixPath.startsWith(\"../\")\n ) {\n return posixPath;\n }\n\n return `./${posixPath}`;\n}\n","function escapeHtml(input: string): string {\n return input\n .replaceAll(\"&\", \"&amp;\")\n .replaceAll(\"<\", \"&lt;\")\n .replaceAll(\">\", \"&gt;\")\n .replaceAll('\"', \"&quot;\")\n .replaceAll(\"'\", \"&#39;\");\n}\n\nfunction stringifyTemplateValue(value: unknown): string {\n if (value === undefined || value === null) {\n return \"\";\n }\n\n return String(value);\n}\n\nexport function renderTemplate(\n template: string,\n data: Record<string, unknown>\n): string {\n const outputChunks: string[] = [];\n const expressionPattern = /<%[=-]?[\\s\\S]*?%>/g;\n let currentIndex = 0;\n let match: RegExpExecArray | null = expressionPattern.exec(template);\n\n while (match !== null) {\n const [tag] = match;\n const tagStart = match.index;\n\n outputChunks.push(\n `__output.push(${JSON.stringify(template.slice(currentIndex, tagStart))});`\n );\n\n if (tag.startsWith(\"<%=\")) {\n const expression = tag.slice(3, -2).trim();\n outputChunks.push(`__output.push(__escape(__stringify(${expression})));`);\n } else if (tag.startsWith(\"<%-\")) {\n const expression = tag.slice(3, -2).trim();\n outputChunks.push(`__output.push(__stringify(${expression}));`);\n } else {\n outputChunks.push(tag.slice(2, -2));\n }\n\n currentIndex = tagStart + tag.length;\n match = expressionPattern.exec(template);\n }\n\n outputChunks.push(\n `__output.push(${JSON.stringify(template.slice(currentIndex))});`\n );\n\n const render = new Function(\n \"data\",\n \"__escape\",\n \"__stringify\",\n // This intentionally relies on `new Function()` sloppy mode so `with (data)`\n // can expose template variables as bare identifiers during rendering.\n // The tests pin the expected collision behavior: own properties on `data`\n // (including names like `name` or `toString`) must win over outer built-ins.\n `const __output = []; with (data) { ${outputChunks.join(\"\\n\")} } return __output.join(\"\");`\n ) as (\n data: Record<string, unknown>,\n escape: typeof escapeHtml,\n stringify: typeof stringifyTemplateValue\n ) => string;\n\n return render(data, escapeHtml, stringifyTemplateValue);\n}\n","export class MissingCanonicalResponseError extends Error {\n public override readonly name = \"MissingCanonicalResponseError\";\n\n public constructor(public readonly responseName: string) {\n super(\n `Missing canonical response '${responseName}' in the normalized spec.`\n );\n }\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { pascalCase } from \"polycase\";\nimport { relative } from \"../helpers/path.js\";\nimport { renderTemplate } from \"../helpers/templateEngine.js\";\nimport { MissingCanonicalResponseError } from \"./errors/MissingCanonicalResponseError.js\";\nimport type { NormalizedResponse, NormalizedSpec } from \"../NormalizedSpec.js\";\nimport type { GeneratorContext, PluginConfig, PluginContext } from \"./types.js\";\n\ntype SafeGeneratedFilePath = {\n readonly fullPath: string;\n readonly generatedPath: string;\n};\n\ntype FileSystemError = Error & {\n readonly code?: string;\n};\n\nconst WINDOWS_DRIVE_PREFIX_PATTERN = /^[a-zA-Z]:/;\n\nfunction pathContainsParentTraversal(projectPath: string): boolean {\n return projectPath.split(\"/\").includes(\"..\");\n}\n\nfunction pathEndsWithDirectorySeparator(projectPath: string): boolean {\n return projectPath.endsWith(\"/\");\n}\n\nfunction pathNamesCurrentDirectory(projectPath: string): boolean {\n return projectPath === \".\" || projectPath.endsWith(\"/.\");\n}\n\nfunction resolveSafeGeneratedFilePath(\n outputDir: string,\n requestedPath: string\n): SafeGeneratedFilePath {\n if (requestedPath.length === 0) {\n throwUnsafeGeneratedFilePath(requestedPath, \"path must not be empty\");\n }\n\n const projectPath = requestedPath.replace(/\\\\/g, \"/\");\n\n if (\n path.isAbsolute(requestedPath) ||\n path.posix.isAbsolute(projectPath) ||\n path.win32.isAbsolute(requestedPath) ||\n path.win32.isAbsolute(projectPath) ||\n WINDOWS_DRIVE_PREFIX_PATTERN.test(requestedPath)\n ) {\n throwUnsafeGeneratedFilePath(\n requestedPath,\n \"absolute paths are not allowed\"\n );\n }\n\n if (pathContainsParentTraversal(projectPath)) {\n throwUnsafeGeneratedFilePath(\n requestedPath,\n \"path contains parent-directory traversal\"\n );\n }\n\n if (pathEndsWithDirectorySeparator(projectPath)) {\n throwUnsafeGeneratedFilePath(\n requestedPath,\n \"path must name a file inside the output directory\"\n );\n }\n\n if (pathNamesCurrentDirectory(projectPath)) {\n throwUnsafeGeneratedFilePath(\n requestedPath,\n \"path must name a file inside the output directory\"\n );\n }\n\n const generatedPath = path.posix.normalize(projectPath);\n\n if (generatedPath === \".\") {\n throwUnsafeGeneratedFilePath(\n requestedPath,\n \"path must name a file inside the output directory\"\n );\n }\n\n if (pathContainsParentTraversal(generatedPath)) {\n throwUnsafeGeneratedFilePath(\n requestedPath,\n \"path contains parent-directory traversal\"\n );\n }\n\n const outputRoot = path.resolve(outputDir);\n const fullPath = path.resolve(outputRoot, toNativePath(generatedPath));\n\n if (!isStrictlyInsidePath(fullPath, outputRoot)) {\n throwUnsafeGeneratedFilePath(\n requestedPath,\n \"path escapes the output directory\"\n );\n }\n\n assertGeneratedPathHasNoSymlinkComponents({\n outputRoot,\n generatedPath,\n requestedPath,\n });\n\n return { fullPath, generatedPath };\n}\n\nfunction toNativePath(projectPath: string): string {\n return projectPath.split(\"/\").join(path.sep);\n}\n\nfunction assertGeneratedPathHasNoSymlinkComponents(config: {\n readonly outputRoot: string;\n readonly generatedPath: string;\n readonly requestedPath: string;\n}): void {\n assertExistingPathIsNotSymlink(config.outputRoot, config.requestedPath);\n\n let currentPath = config.outputRoot;\n\n for (const segment of config.generatedPath.split(\"/\")) {\n currentPath = path.join(currentPath, segment);\n\n const pathStats = getExistingPathStats(currentPath);\n\n if (pathStats === undefined) {\n return;\n }\n\n assertPathStatsIsNotSymlink(pathStats, config.requestedPath);\n\n if (!pathStats.isDirectory()) {\n return;\n }\n }\n}\n\nfunction assertExistingPathIsNotSymlink(\n absolutePath: string,\n requestedPath: string\n): void {\n const pathStats = getExistingPathStats(absolutePath);\n\n if (pathStats === undefined) {\n return;\n }\n\n assertPathStatsIsNotSymlink(pathStats, requestedPath);\n}\n\nfunction assertPathStatsIsNotSymlink(\n pathStats: fs.Stats,\n requestedPath: string\n): void {\n if (!pathStats.isSymbolicLink()) {\n return;\n }\n\n throwUnsafeGeneratedFilePath(requestedPath, \"path contains a symbolic link\");\n}\n\nfunction getExistingPathStats(absolutePath: string): fs.Stats | undefined {\n try {\n return fs.lstatSync(absolutePath);\n } catch (error) {\n if (isMissingPathError(error)) {\n return undefined;\n }\n\n throw error;\n }\n}\n\nfunction isMissingPathError(error: unknown): boolean {\n if (!(error instanceof Error)) {\n return false;\n }\n\n return [\"ENOENT\", \"ENOTDIR\"].includes((error as FileSystemError).code ?? \"\");\n}\n\nfunction isStrictlyInsidePath(childPath: string, parentPath: string): boolean {\n const relativePath = path.relative(parentPath, childPath);\n\n return (\n relativePath !== \"\" &&\n relativePath !== \"..\" &&\n !relativePath.startsWith(`..${path.sep}`) &&\n !path.isAbsolute(relativePath)\n );\n}\n\nfunction throwUnsafeGeneratedFilePath(\n requestedPath: string,\n reason: string\n): never {\n throw new Error(\n `Unsafe generated file path '${requestedPath}': ${reason}. ` +\n `Generated writes must stay inside the output directory.`\n );\n}\n\nfunction revalidateGeneratedWritePath(\n outputDir: string,\n generatedPath: string\n): SafeGeneratedFilePath {\n return resolveSafeGeneratedFilePath(outputDir, generatedPath);\n}\n\nfunction writeGeneratedFileByReplacingDestination(config: {\n readonly outputDir: string;\n readonly generatedPath: string;\n readonly content: string;\n}): SafeGeneratedFilePath {\n const existingPath = revalidateGeneratedWritePath(\n config.outputDir,\n config.generatedPath\n );\n const existingFileMode = getExistingFileMode(existingPath.fullPath);\n const tempParentPath = revalidateGeneratedWritePath(\n config.outputDir,\n config.generatedPath\n );\n const destinationDir = path.dirname(tempParentPath.fullPath);\n const tempDir = fs.mkdtempSync(path.join(destinationDir, \".typeweaver-\"));\n const tempFile = path.join(tempDir, \"generated.tmp\");\n\n try {\n revalidateGeneratedWritePath(config.outputDir, config.generatedPath);\n fs.writeFileSync(tempFile, config.content, {\n flag: \"wx\",\n mode: existingFileMode ?? 0o666,\n });\n\n if (existingFileMode !== undefined) {\n fs.chmodSync(tempFile, existingFileMode);\n }\n\n const writablePath = revalidateGeneratedWritePath(\n config.outputDir,\n config.generatedPath\n );\n fs.renameSync(tempFile, writablePath.fullPath);\n\n return writablePath;\n } finally {\n fs.rmSync(tempDir, { recursive: true, force: true });\n }\n}\n\nfunction getExistingFileMode(absolutePath: string): number | undefined {\n const pathStats = getExistingPathStats(absolutePath);\n\n if (pathStats?.isFile() !== true) {\n return undefined;\n }\n\n return pathStats.mode & 0o777;\n}\n\nexport type PluginContextBuilderApi = {\n readonly createPluginContext: (params: {\n outputDir: string;\n inputDir: string;\n config: PluginConfig;\n }) => PluginContext;\n readonly createGeneratorContext: (params: {\n readonly outputDir: string;\n readonly inputDir: string;\n readonly config: PluginConfig;\n readonly normalizedSpec: NormalizedSpec;\n readonly templateDir: string;\n readonly coreDir: string;\n readonly responsesOutputDir: string;\n readonly specOutputDir: string;\n }) => GeneratorContext;\n readonly getGeneratedFiles: () => string[];\n readonly clearGeneratedFiles: () => void;\n};\n\nexport function createPluginContextBuilder(): PluginContextBuilderApi {\n const generatedFiles = new Set<string>();\n\n const createPluginContext = (params: {\n outputDir: string;\n inputDir: string;\n config: PluginConfig;\n }): PluginContext => {\n return {\n outputDir: params.outputDir,\n inputDir: params.inputDir,\n config: params.config,\n };\n };\n\n const createGeneratorContext = (params: {\n readonly outputDir: string;\n readonly inputDir: string;\n readonly config: PluginConfig;\n readonly normalizedSpec: NormalizedSpec;\n readonly templateDir: string;\n readonly coreDir: string;\n readonly responsesOutputDir: string;\n readonly specOutputDir: string;\n }): GeneratorContext => {\n const pluginContext = createPluginContext(params);\n const canonicalResponsesByName = new Map<string, NormalizedResponse>(\n params.normalizedSpec.responses.map(response => [response.name, response])\n );\n\n const getResourceOutputDir = (resourceName: string): string => {\n return path.join(params.outputDir, resourceName);\n };\n\n const getOperationOutputPaths = (config: {\n readonly resourceName: string;\n readonly operationId: string;\n }) => {\n const outputDir = getResourceOutputDir(config.resourceName);\n const fileBase = pascalCase(config.operationId);\n const requestFileName = `${fileBase}Request.ts`;\n const responseFileName = `${fileBase}Response.ts`;\n const requestValidationFileName = `${fileBase}RequestValidator.ts`;\n const responseValidationFileName = `${fileBase}ResponseValidator.ts`;\n const clientFileName = `${fileBase}Client.ts`;\n\n return {\n outputDir,\n requestFile: path.join(outputDir, requestFileName),\n requestFileName,\n responseFile: path.join(outputDir, responseFileName),\n responseFileName,\n requestValidationFile: path.join(outputDir, requestValidationFileName),\n requestValidationFileName,\n responseValidationFile: path.join(\n outputDir,\n responseValidationFileName\n ),\n responseValidationFileName,\n clientFile: path.join(outputDir, clientFileName),\n clientFileName,\n };\n };\n\n const getCanonicalResponse = (responseName: string): NormalizedResponse => {\n const response = canonicalResponsesByName.get(responseName);\n\n if (response === undefined) {\n throw new MissingCanonicalResponseError(responseName);\n }\n\n return response;\n };\n\n const getCanonicalResponseOutputFile = (responseName: string): string => {\n return path.join(\n params.responsesOutputDir,\n `${pascalCase(responseName)}Response.ts`\n );\n };\n\n return {\n ...pluginContext,\n normalizedSpec: params.normalizedSpec,\n coreDir: params.coreDir,\n responsesOutputDir: params.responsesOutputDir,\n specOutputDir: params.specOutputDir,\n getCanonicalResponse,\n getCanonicalResponseOutputFile,\n getCanonicalResponseImportPath: config => {\n return relative(\n config.importerDir,\n getCanonicalResponseOutputFile(config.responseName).replace(\n /\\.ts$/,\n \".js\"\n )\n );\n },\n getSpecImportPath: config => {\n return relative(\n config.importerDir,\n path.join(params.specOutputDir, \"spec.js\")\n );\n },\n getOperationDefinitionAccessor: config => {\n return (\n `getOperationDefinition(` +\n `spec, ` +\n `${JSON.stringify(config.resourceName)}, ` +\n `${JSON.stringify(config.operationId)}` +\n `)`\n );\n },\n getOperationOutputPaths,\n getResourceOutputDir,\n\n writeFile: (relativePath: string, content: string) => {\n const safePath = resolveSafeGeneratedFilePath(\n params.outputDir,\n relativePath\n );\n const dir = path.dirname(safePath.fullPath);\n\n fs.mkdirSync(dir, { recursive: true });\n const writablePath = revalidateGeneratedWritePath(\n params.outputDir,\n safePath.generatedPath\n );\n const generatedFile = writeGeneratedFileByReplacingDestination({\n outputDir: params.outputDir,\n generatedPath: writablePath.generatedPath,\n content,\n });\n generatedFiles.add(generatedFile.generatedPath);\n\n console.info(`Generated: ${generatedFile.generatedPath}`);\n },\n\n renderTemplate: (templatePath: string, data: unknown) => {\n const fullTemplatePath = path.isAbsolute(templatePath)\n ? templatePath\n : path.join(params.templateDir, templatePath);\n\n const template = fs.readFileSync(fullTemplatePath, \"utf8\");\n return renderTemplate(\n template,\n (data ?? {}) as Record<string, unknown>\n );\n },\n\n addGeneratedFile: (relativePath: string) => {\n const safePath = resolveSafeGeneratedFilePath(\n params.outputDir,\n relativePath\n );\n\n generatedFiles.add(safePath.generatedPath);\n },\n\n getGeneratedFiles: () => {\n return Array.from(generatedFiles);\n },\n };\n };\n\n return {\n createPluginContext,\n createGeneratorContext,\n getGeneratedFiles: () => Array.from(generatedFiles),\n clearGeneratedFiles: () => generatedFiles.clear(),\n };\n}\n","export type CreateJSDocCommentOptions = {\n readonly indentation?: string;\n};\n\nconst BLOCK_COMMENT_END_PATTERN = /\\*\\//g;\nconst LINE_BREAK_PATTERN = /\\r\\n?/g;\n\nexport function createJSDocComment(\n text: string | undefined,\n options: CreateJSDocCommentOptions = {}\n): string | undefined {\n const normalizedText = text?.replace(LINE_BREAK_PATTERN, \"\\n\");\n const trimmedText = normalizedText?.trim();\n\n if (!trimmedText) return undefined;\n\n const indentation = options.indentation ?? \"\";\n const lines = trimmedText\n .replace(BLOCK_COMMENT_END_PATTERN, \"*\\\\/\")\n .split(\"\\n\");\n\n return [\n `${indentation}/**`,\n ...lines.map(line => `${indentation} * ${line}`),\n `${indentation} */`,\n ].join(\"\\n\");\n}\n","import { HttpMethod } from \"@rexeus/typeweaver-core\";\n\n/**\n * HTTP method priority for route ordering.\n * Lower numbers = higher priority (sorted first).\n */\nconst METHOD_PRIORITY: Record<string, number> = {\n [HttpMethod.GET]: 1,\n [HttpMethod.POST]: 2,\n [HttpMethod.PUT]: 3,\n [HttpMethod.PATCH]: 4,\n [HttpMethod.DELETE]: 5,\n [HttpMethod.OPTIONS]: 6,\n [HttpMethod.HEAD]: 7,\n};\n\n/**\n * Returns the sort priority for an HTTP method.\n * Unrecognized methods default to priority 999.\n */\nexport const getMethodPriority = (method: string): number =>\n METHOD_PRIORITY[method] ?? 999;\n\n/**\n * Compares two path segments for route ordering.\n * Returns negative if a should come before b, positive if after.\n *\n * Order: static segments before parameters, then alphabetically.\n */\nconst comparePathSegments = (a: string, b: string): number => {\n const aIsParam = a.startsWith(\":\");\n const bIsParam = b.startsWith(\":\");\n\n if (aIsParam !== bIsParam) {\n return aIsParam ? 1 : -1;\n }\n\n return a.localeCompare(b);\n};\n\n/**\n * Compares two routes for ordering.\n * Routes are sorted by:\n * 1. Path depth (shallow to deep)\n * 2. Static segments before parameters\n * 3. Alphabetical within same segment type\n * 4. HTTP method priority\n */\nexport const compareRoutes = (\n a: { method: string; path: string },\n b: { method: string; path: string }\n): number => {\n const aSegments = a.path.split(\"/\").filter(Boolean);\n const bSegments = b.path.split(\"/\").filter(Boolean);\n\n if (aSegments.length !== bSegments.length) {\n return aSegments.length - bSegments.length;\n }\n\n for (let i = 0; i < aSegments.length; i++) {\n const cmp = comparePathSegments(aSegments[i]!, bSegments[i]!);\n if (cmp !== 0) {\n return cmp;\n }\n }\n\n return getMethodPriority(a.method) - getMethodPriority(b.method);\n};\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rexeus/typeweaver-gen",
3
- "version": "0.10.5",
3
+ "version": "0.12.0",
4
4
  "description": "Template-driven engine that turns structured API definitions into production-ready artifacts. Powered by Typeweaver 🧵✨",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -48,11 +48,11 @@
48
48
  "homepage": "https://github.com/rexeus/typeweaver#readme",
49
49
  "peerDependencies": {
50
50
  "zod": "^4.3.0",
51
- "@rexeus/typeweaver-core": "^0.10.5"
51
+ "@rexeus/typeweaver-core": "^0.12.0"
52
52
  },
53
53
  "devDependencies": {
54
54
  "zod": "^4.3.6",
55
- "@rexeus/typeweaver-core": "^0.10.5"
55
+ "@rexeus/typeweaver-core": "^0.12.0"
56
56
  },
57
57
  "dependencies": {
58
58
  "polycase": "^1.1.0"