@open-mercato/shared 0.6.8-develop.6963.1.04a6d320e9 → 0.6.8-develop.6969.1.7a32706312
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/lib/openapi/generator.js +5 -4
- package/dist/lib/openapi/generator.js.map +2 -2
- package/dist/lib/ratelimit/helpers.js +11 -1
- package/dist/lib/ratelimit/helpers.js.map +2 -2
- package/dist/lib/ratelimit/index.js +3 -1
- package/dist/lib/ratelimit/index.js.map +2 -2
- package/dist/lib/ratelimit/service.js +11 -1
- package/dist/lib/ratelimit/service.js.map +2 -2
- package/dist/lib/version.js +1 -1
- package/dist/lib/version.js.map +1 -1
- package/package.json +2 -2
- package/src/lib/openapi/__tests__/access-control-metadata.test.ts +69 -0
- package/src/lib/openapi/generator.ts +9 -4
- package/src/lib/openapi/types.ts +7 -0
- package/src/lib/ratelimit/__tests__/helpers.test.ts +46 -1
- package/src/lib/ratelimit/__tests__/service.test.ts +113 -0
- package/src/lib/ratelimit/helpers.ts +24 -0
- package/src/lib/ratelimit/index.ts +2 -1
- package/src/lib/ratelimit/service.ts +13 -1
- package/src/lib/ratelimit/types.ts +14 -0
|
@@ -881,6 +881,7 @@ function buildOpenApiDocument(modules, options = {}) {
|
|
|
881
881
|
paths: {}
|
|
882
882
|
};
|
|
883
883
|
ensureSecurityComponents(doc);
|
|
884
|
+
const includeAccessControlMetadata = options.includeAccessControlMetadata !== false;
|
|
884
885
|
const tags = /* @__PURE__ */ new Map();
|
|
885
886
|
for (const moduleEntry of modules) {
|
|
886
887
|
const defaultTag = moduleEntry.info?.title ?? toTitle(moduleEntry.id);
|
|
@@ -907,10 +908,10 @@ function buildOpenApiDocument(modules, options = {}) {
|
|
|
907
908
|
const requireAuth = meta?.["requireAuth"] === true;
|
|
908
909
|
const descriptionParts = [];
|
|
909
910
|
if (baseDescription) descriptionParts.push(baseDescription);
|
|
910
|
-
if (Array.isArray(requireFeatures) && requireFeatures.length) {
|
|
911
|
+
if (includeAccessControlMetadata && Array.isArray(requireFeatures) && requireFeatures.length) {
|
|
911
912
|
descriptionParts.push(`Requires features: ${requireFeatures.join(", ")}`);
|
|
912
913
|
}
|
|
913
|
-
if (Array.isArray(requireRoles) && requireRoles.length) {
|
|
914
|
+
if (includeAccessControlMetadata && Array.isArray(requireRoles) && requireRoles.length) {
|
|
914
915
|
descriptionParts.push(`Requires roles: ${requireRoles.join(", ")}`);
|
|
915
916
|
}
|
|
916
917
|
const querySchema = methodDoc?.query;
|
|
@@ -949,8 +950,8 @@ function buildOpenApiDocument(modules, options = {}) {
|
|
|
949
950
|
source: curlSample
|
|
950
951
|
}
|
|
951
952
|
],
|
|
952
|
-
...Array.isArray(requireFeatures) && requireFeatures.length ? { "x-require-features": requireFeatures } : {},
|
|
953
|
-
...Array.isArray(requireRoles) && requireRoles.length ? { "x-require-roles": requireRoles } : {},
|
|
953
|
+
...includeAccessControlMetadata && Array.isArray(requireFeatures) && requireFeatures.length ? { "x-require-features": requireFeatures } : {},
|
|
954
|
+
...includeAccessControlMetadata && Array.isArray(requireRoles) && requireRoles.length ? { "x-require-roles": requireRoles } : {},
|
|
954
955
|
...requireAuth ? { "x-require-auth": true } : {},
|
|
955
956
|
...methodDoc?.extensions ?? {}
|
|
956
957
|
};
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../src/lib/openapi/generator.ts"],
|
|
4
|
-
"sourcesContent": ["import { z, type ZodTypeAny } from 'zod'\nimport type { Module, ModuleApi, ModuleApiLegacy, ModuleApiRouteFile, HttpMethod } from '@open-mercato/shared/modules/registry'\nimport type {\n OpenApiDocument,\n OpenApiDocumentOptions,\n OpenApiMethodDoc,\n OpenApiRequestBodyDoc,\n OpenApiResponseDoc,\n OpenApiRouteDoc,\n} from './types'\n\ntype PathParamInfo = {\n name: string\n catchAll?: boolean\n optional?: boolean\n}\n\ntype ParameterLocation = 'query' | 'path' | 'header'\n\ntype JsonSchema = Record<string, unknown>\n\ntype SchemaConversionContext = {\n memo: WeakMap<ZodTypeAny, JsonSchema>\n}\n\ntype ExampleGenerationContext = {\n stack: WeakSet<ZodTypeAny>\n}\n\ntype ExampleMap = {\n query?: unknown\n body?: unknown\n path?: Record<string, unknown>\n headers?: Record<string, unknown>\n}\n\nconst HTTP_METHODS: HttpMethod[] = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE']\n\nfunction resolveType(def: any): string | undefined {\n if (!def) return undefined\n if (typeof def.typeName === 'string' && def.typeName.length) return def.typeName\n if (typeof def.type === 'string' && def.type.length) return def.type\n return undefined\n}\n\nfunction getShape(def: any): Record<string, ZodTypeAny> {\n if (!def) return {}\n const shape = typeof def.shape === 'function' ? def.shape() : def.shape\n if (shape && typeof shape === 'object') return shape as Record<string, ZodTypeAny>\n return {}\n}\n\nfunction normalizeChecks(checks: any[] | undefined): Array<{ kind?: string; value?: unknown; extra?: Record<string, unknown> }> {\n if (!Array.isArray(checks)) return []\n return checks.map((check) => {\n if (!check) return {}\n const base = (check as any)?._zod?.def ?? (check as any)?.def ?? check\n const kind = typeof (check as any)?.kind === 'string'\n ? (check as any).kind\n : typeof base?.check === 'string'\n ? base.check\n : undefined\n const value =\n base?.value ??\n base?.minimum ??\n base?.maximum ??\n base?.exact ??\n base?.length ??\n base?.limit ??\n base?.includes ??\n base?.min ??\n base?.max\n return { kind, value, extra: base && typeof base === 'object' ? base : undefined }\n })\n}\n\nconst DEFAULT_EXAMPLE_VALUES = {\n string: 'string',\n number: 1,\n integer: 1,\n boolean: true,\n uuid: '00000000-0000-4000-8000-000000000000',\n email: 'user@example.com',\n url: 'https://example.com/resource',\n datetime: new Date('2025-01-01T00:00:00.000Z').toISOString(),\n}\n\nfunction toTitle(str: string): string {\n if (!str) return ''\n return str\n .split(/[_\\-\\s]+/)\n .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n .join(' ')\n}\n\nfunction normalizePath(path: string): { path: string; params: PathParamInfo[] } {\n const segments = path.split('/').filter((seg) => seg.length > 0)\n const params: PathParamInfo[] = []\n const normalized = segments\n .map((seg) => {\n const catchAll = seg.match(/^\\[\\.\\.\\.(.+)\\]$/)\n if (catchAll) {\n params.push({ name: catchAll[1], catchAll: true })\n return `{${catchAll[1]}}`\n }\n const optCatchAll = seg.match(/^\\[\\[\\.\\.\\.(.+)\\]\\]$/)\n if (optCatchAll) {\n params.push({ name: optCatchAll[1], catchAll: true, optional: true })\n return `{${optCatchAll[1]}}`\n }\n const dyn = seg.match(/^\\[(.+)\\]$/)\n if (dyn) {\n params.push({ name: dyn[1] })\n return `{${dyn[1]}}`\n }\n return seg\n })\n .join('/')\n return { path: '/' + normalized, params }\n}\n\nfunction unwrap(schema?: ZodTypeAny): {\n schema: ZodTypeAny | undefined\n optional: boolean\n nullable: boolean\n defaultValue?: unknown\n} {\n if (!schema) {\n return { schema: undefined, optional: true, nullable: false }\n }\n\n let current: ZodTypeAny = schema\n let optional = false\n let nullable = false\n let defaultValue: unknown\n // eslint-disable-next-line no-constant-condition\n while (true) {\n const def = (current as any)?._def\n if (!def) {\n return { schema: current, optional, nullable, defaultValue }\n }\n const typeName = resolveType(def)\n if (typeName === 'ZodOptional' || typeName === 'optional') {\n optional = true\n current = (current as any)._def.innerType\n continue\n }\n if (typeName === 'ZodNullable' || typeName === 'nullable') {\n nullable = true\n current = (current as any)._def.innerType\n continue\n }\n if (typeName === 'ZodDefault' || typeName === 'default') {\n optional = true\n const rawDefault = (current as any)._def.defaultValue\n defaultValue = typeof rawDefault === 'function' ? rawDefault() : rawDefault\n current = (current as any)._def.innerType\n continue\n }\n if (typeName === 'ZodPipeline' || typeName === 'pipe') {\n current = (current as any)._def.out ?? (current as any)._def.innerType ?? (current as any)._def.schema\n continue\n }\n if (typeName === 'transformer') {\n current = (current as any)._def.output\n continue\n }\n if (typeName === 'ZodLazy' || typeName === 'lazy') {\n const getter = (current as any)._def.getter\n current = typeof getter === 'function' ? getter() : current\n if (current === schema) break\n continue\n }\n if (typeName === 'ZodPromise' || typeName === 'promise') {\n current = (current as any)._def.type\n continue\n }\n if (typeName === 'ZodCatch' || typeName === 'catch') {\n current = (current as any)._def.innerType\n continue\n }\n if (typeName === 'ZodReadonly' || typeName === 'readonly') {\n current = (current as any)._def.innerType\n continue\n }\n if (typeName === 'ZodBranded' || typeName === 'branded') {\n current = (current as any)._def.type\n continue\n }\n break\n }\n return { schema: current, optional, nullable, defaultValue }\n}\n\n/**\n * Extract the description from a zod schema, walking through wrappers like optional/nullable/default.\n * Returns the first description found, or undefined if none exists.\n */\nfunction extractZodDescription(schema?: ZodTypeAny): string | undefined {\n if (!schema) return undefined\n\n let current: ZodTypeAny | undefined = schema\n while (current) {\n // In Zod 4/zod-mini, description is stored directly on the schema object\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const directDescription = (current as any).description\n if (typeof directDescription === 'string' && directDescription.length > 0) {\n return directDescription\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const def = (current as any)?._def as Record<string, unknown> | undefined\n if (!def) return undefined\n\n // Also check _def.description for Zod 3 compatibility\n if (typeof def.description === 'string' && def.description.length > 0) {\n return def.description\n }\n\n // Walk through wrappers to find description on inner types\n const typeName = resolveType(def)\n if (\n typeName === 'ZodOptional' || typeName === 'optional' ||\n typeName === 'ZodNullable' || typeName === 'nullable' ||\n typeName === 'ZodDefault' || typeName === 'default' ||\n typeName === 'ZodCatch' || typeName === 'catch' ||\n typeName === 'ZodReadonly' || typeName === 'readonly'\n ) {\n current = def.innerType as ZodTypeAny | undefined\n continue\n }\n if (typeName === 'ZodBranded' || typeName === 'branded') {\n current = def.type as ZodTypeAny | undefined\n continue\n }\n if (typeName === 'ZodPipeline' || typeName === 'pipe') {\n current = (def.out ?? def.innerType ?? def.schema) as ZodTypeAny | undefined\n continue\n }\n if (typeName === 'transformer') {\n current = def.output as ZodTypeAny | undefined\n continue\n }\n if (typeName === 'ZodLazy' || typeName === 'lazy') {\n const getter = def.getter\n const next = typeof getter === 'function' ? (getter as () => ZodTypeAny)() : current\n if (next === current) break\n current = next\n continue\n }\n if (typeName === 'ZodPromise' || typeName === 'promise') {\n current = def.type as ZodTypeAny | undefined\n continue\n }\n // No more wrappers to unwrap\n break\n }\n return undefined\n}\n\nfunction zodToJsonSchema(schema?: ZodTypeAny, ctx?: SchemaConversionContext): JsonSchema | undefined {\n if (!schema) return undefined\n const context: SchemaConversionContext = ctx ?? { memo: new WeakMap<ZodTypeAny, JsonSchema>() }\n\n const cached = context.memo.get(schema)\n if (cached) return cached\n\n const placeholder: JsonSchema = {}\n context.memo.set(schema, placeholder)\n\n const { schema: inner, nullable } = unwrap(schema)\n if (!inner) {\n if (nullable) placeholder.nullable = true\n return placeholder\n }\n\n if (inner !== schema && typeof inner === 'object') {\n if (!context.memo.has(inner as ZodTypeAny)) {\n context.memo.set(inner as ZodTypeAny, placeholder)\n }\n }\n\n const def = (inner as any)._def\n if (!def) return placeholder\n const typeName = resolveType(def) as string | undefined\n\n const result = placeholder\n\n switch (typeName) {\n case 'ZodString':\n case 'string': {\n result.type = 'string'\n const checks = normalizeChecks(def.checks)\n for (const check of checks) {\n if (!check.kind) continue\n if (check.kind === 'uuid' || check.extra?.format === 'uuid') {\n result.format = 'uuid'\n } else if (check.kind === 'email' || check.extra?.format === 'email') {\n result.format = 'email'\n } else if (check.kind === 'url' || check.extra?.format === 'uri' || check.extra?.format === 'url') {\n result.format = 'uri'\n } else if (check.kind === 'regex' && check.extra?.pattern instanceof RegExp) {\n result.pattern = check.extra.pattern.source\n } else if (check.kind === 'string_format' && typeof check.extra?.format === 'string') {\n if (check.extra.format === 'regex' && check.extra.pattern != null) {\n result.pattern = check.extra.pattern instanceof RegExp\n ? check.extra.pattern.source\n : String(check.extra.pattern)\n } else {\n result.format = check.extra.format\n }\n } else if (check.kind === 'datetime' || check.extra?.format === 'date-time') {\n result.format = 'date-time'\n } else if (['length', 'len', 'exact_length'].includes(check.kind ?? '')) {\n if (typeof check.value === 'number') {\n result.minLength = check.value\n result.maxLength = check.value\n }\n } else if (check.kind === 'min' || check.kind === 'min_length') {\n if (typeof check.value === 'number') result.minLength = check.value\n } else if (check.kind === 'max' || check.kind === 'max_length') {\n if (typeof check.value === 'number') result.maxLength = check.value\n }\n }\n break\n }\n case 'ZodNumber':\n case 'number': {\n result.type = 'number'\n const checks = normalizeChecks(def.checks)\n for (const check of checks) {\n if (!check.kind) continue\n if (check.kind === 'int' || check.kind === 'isInteger') result.type = 'integer'\n if ((check.kind === 'min' || check.kind === 'gte') && typeof check.value === 'number') result.minimum = check.value\n if ((check.kind === 'max' || check.kind === 'lte') && typeof check.value === 'number') result.maximum = check.value\n if (check.kind === 'multipleOf' && typeof check.value === 'number') result.multipleOf = check.value\n }\n break\n }\n case 'ZodBigInt':\n case 'bigint':\n result.type = 'integer'\n result.format = 'int64'\n break\n case 'ZodBoolean':\n case 'boolean':\n result.type = 'boolean'\n break\n case 'ZodLiteral':\n case 'literal': {\n const value = def.value ?? (Array.isArray(def.values) ? def.values[0] : undefined)\n result.type = typeof value\n result.enum = [value]\n break\n }\n case 'ZodEnum':\n case 'enum': {\n const entries = def.values ?? def.entries\n const values = Array.isArray(entries) ? entries : entries ? Object.values(entries) : []\n const enumerators = values.filter((v: unknown) => typeof v === 'string' || typeof v === 'number')\n const allString = enumerators.every((v: unknown) => typeof v === 'string')\n result.type = allString ? 'string' : 'number'\n result.enum = enumerators\n break\n }\n case 'ZodNativeEnum': {\n const values = Object.values(def.values).filter((v) => typeof v === 'string' || typeof v === 'number')\n const allString = values.every((v) => typeof v === 'string')\n result.type = allString ? 'string' : 'number'\n result.enum = values\n break\n }\n case 'ZodUnion':\n case 'union': {\n const options = def.options || []\n result.oneOf = options.map((option: ZodTypeAny) => zodToJsonSchema(option, context) ?? {})\n break\n }\n case 'ZodIntersection':\n case 'intersection': {\n result.allOf = [\n zodToJsonSchema(def.left, context) ?? {},\n zodToJsonSchema(def.right, context) ?? {},\n ]\n break\n }\n case 'ZodPipeline':\n case 'pipe': {\n const resolved = zodToJsonSchema(def.out ?? def.innerType ?? def.schema, context) ?? {}\n Object.assign(result, resolved)\n break\n }\n case 'ZodLazy':\n case 'lazy': {\n const next = typeof def.getter === 'function' ? def.getter() : undefined\n const resolved = next ? zodToJsonSchema(next, context) : undefined\n if (resolved) Object.assign(result, resolved)\n break\n }\n case 'ZodPromise':\n case 'promise': {\n const resolved = zodToJsonSchema(def.type, context)\n if (resolved) Object.assign(result, resolved)\n break\n }\n case 'ZodCatch':\n case 'catch': {\n const resolved = zodToJsonSchema(def.innerType ?? def.type, context)\n if (resolved) Object.assign(result, resolved)\n break\n }\n case 'ZodReadonly':\n case 'readonly': {\n const resolved = zodToJsonSchema(def.innerType ?? def.type, context)\n if (resolved) Object.assign(result, resolved)\n break\n }\n case 'ZodArray':\n case 'array': {\n const elementSchema =\n def.type && typeof def.type === 'object'\n ? def.type\n : (def.element && typeof def.element === 'object' ? def.element : undefined)\n result.type = 'array'\n result.items = zodToJsonSchema(elementSchema as ZodTypeAny, context) ?? {}\n if (typeof def.minLength === 'number') result.minItems = def.minLength\n if (typeof def.maxLength === 'number') result.maxItems = def.maxLength\n const checks = normalizeChecks(def.checks)\n for (const check of checks) {\n if (check.kind === 'min_length' && typeof check.value === 'number') result.minItems = check.value\n if (check.kind === 'max_length' && typeof check.value === 'number') result.maxItems = check.value\n if (check.kind === 'length' && typeof check.value === 'number') {\n result.minItems = check.value\n result.maxItems = check.value\n }\n }\n break\n }\n case 'ZodTuple':\n case 'tuple': {\n const items = def.items || []\n result.type = 'array'\n result.prefixItems = items.map((item: ZodTypeAny) => zodToJsonSchema(item, context) ?? {})\n result.minItems = items.length\n result.maxItems = items.length\n break\n }\n case 'ZodRecord':\n case 'record': {\n result.type = 'object'\n const valueSchema = def.valueType ?? def.value\n const valueType = valueSchema ? resolveType(valueSchema._def) : undefined\n if (!valueType || valueType === 'ZodUnknown' || valueType === 'unknown' || valueType === 'ZodAny' || valueType === 'any') {\n result.additionalProperties = true\n } else {\n result.additionalProperties = zodToJsonSchema(valueSchema, context) ?? true\n }\n break\n }\n case 'ZodObject':\n case 'object': {\n result.type = 'object'\n const shape = getShape(def)\n const properties: Record<string, JsonSchema> = {}\n const required: string[] = []\n for (const [key, rawSchema] of Object.entries(shape)) {\n const unwrapped = unwrap(rawSchema as ZodTypeAny)\n const childSchema = zodToJsonSchema(unwrapped.schema, context)\n if (!childSchema) continue\n const baseSchema = childSchema\n let propertySchema: JsonSchema = baseSchema\n if (unwrapped.nullable) {\n propertySchema = {\n anyOf: [{ type: 'null' }, propertySchema],\n }\n }\n if (unwrapped.defaultValue !== undefined) {\n if (propertySchema === baseSchema) {\n propertySchema = { allOf: [baseSchema], default: unwrapped.defaultValue }\n } else {\n propertySchema = { ...propertySchema, default: unwrapped.defaultValue }\n }\n }\n properties[key] = propertySchema\n if (!unwrapped.optional) required.push(key)\n }\n result.properties = properties\n if (required.length > 0) result.required = required\n if (def.unknownKeys === 'passthrough') {\n result.additionalProperties = true\n } else if (def.catchall) {\n const catchallType = resolveType(def.catchall._def)\n if (catchallType === 'ZodNever' || catchallType === 'never') {\n result.additionalProperties = false\n } else if (!catchallType || catchallType === 'ZodUnknown' || catchallType === 'unknown' || catchallType === 'ZodAny' || catchallType === 'any') {\n result.additionalProperties = true\n } else {\n result.additionalProperties = zodToJsonSchema(def.catchall, context) ?? true\n }\n } else {\n result.additionalProperties = false\n }\n break\n }\n case 'ZodDate':\n case 'date':\n result.type = 'string'\n result.format = 'date-time'\n break\n case 'ZodNull':\n case 'null':\n result.type = 'null'\n break\n case 'ZodVoid':\n case 'void':\n case 'ZodNever':\n case 'never':\n break\n case 'ZodAny':\n case 'any':\n case 'ZodUnknown':\n case 'unknown':\n case 'ZodNaN':\n case 'nan':\n default:\n break\n }\n\n if (nullable) {\n if (result.type && result.type !== 'null') {\n result.nullable = true\n } else if (!result.type) {\n const clone = { ...result }\n result.anyOf = [{ type: 'null' }, clone]\n }\n }\n\n return result\n}\n\nfunction generateExample(schema?: ZodTypeAny, ctx?: ExampleGenerationContext): unknown {\n if (!schema) return undefined\n if ((typeof schema !== 'object' || schema === null) && typeof schema !== 'function') return undefined\n const trackable = schema as object\n const context: ExampleGenerationContext = ctx ?? { stack: new WeakSet<ZodTypeAny>() }\n if (context.stack.has(trackable as ZodTypeAny)) return undefined\n context.stack.add(trackable as ZodTypeAny)\n\n try {\n const { schema: inner, optional, nullable, defaultValue } = unwrap(schema)\n if (!inner) {\n if (defaultValue !== undefined) return defaultValue\n if (nullable) return null\n if (optional) return undefined\n return undefined\n }\n const def = (inner as any)._def\n const typeName = resolveType(def) as string | undefined\n if (defaultValue !== undefined) return defaultValue\n\n if (nullable) return null\n if (optional) return undefined\n\n switch (typeName) {\n case 'ZodString':\n case 'string': {\n const checks = normalizeChecks(def?.checks)\n for (const check of checks) {\n if (!check.kind && !check.extra?.format) continue\n if (check.kind === 'uuid' || check.extra?.format === 'uuid') return DEFAULT_EXAMPLE_VALUES.uuid\n if (check.kind === 'email' || check.extra?.format === 'email') return DEFAULT_EXAMPLE_VALUES.email\n if (check.kind === 'url' || check.extra?.format === 'url' || check.extra?.format === 'uri') return DEFAULT_EXAMPLE_VALUES.url\n if (check.kind === 'datetime' || check.extra?.format === 'date-time') return DEFAULT_EXAMPLE_VALUES.datetime\n }\n return DEFAULT_EXAMPLE_VALUES.string\n }\n case 'ZodNumber':\n case 'number': {\n const checks = normalizeChecks(def?.checks)\n const isInt = checks.some((check) => check.kind === 'int' || check.kind === 'isInteger')\n return isInt ? DEFAULT_EXAMPLE_VALUES.integer : DEFAULT_EXAMPLE_VALUES.number\n }\n case 'ZodBigInt':\n case 'bigint':\n return BigInt(1)\n case 'ZodBoolean':\n case 'boolean':\n return DEFAULT_EXAMPLE_VALUES.boolean\n case 'ZodEnum':\n case 'enum': {\n const entries = def?.values ?? def?.entries\n const values = Array.isArray(entries) ? entries : entries ? Object.values(entries) : []\n return values[0]\n }\n case 'ZodNativeEnum': {\n const values = Object.values(def?.values || [])\n return values[0]\n }\n case 'ZodLiteral':\n case 'literal':\n return def?.value ?? (Array.isArray(def?.values) ? def.values[0] : undefined)\n case 'ZodArray':\n case 'array': {\n const elementSchema =\n def?.type && typeof def.type === 'object'\n ? def.type\n : (def?.element && typeof def.element === 'object' ? def.element : undefined)\n const child = generateExample(elementSchema, context)\n return child === undefined ? [] : [child]\n }\n case 'ZodTuple':\n case 'tuple': {\n const items = def?.items || []\n return items.map((item: ZodTypeAny) => generateExample(item, context))\n }\n case 'ZodObject':\n case 'object': {\n const shape = getShape(def)\n const obj: Record<string, unknown> = {}\n for (const [key, value] of Object.entries(shape)) {\n const example = generateExample(value as ZodTypeAny, context)\n if (example !== undefined) obj[key] = example\n }\n return obj\n }\n case 'ZodRecord':\n case 'record': {\n const valueExample = generateExample(def?.valueType ?? def?.value, context)\n return valueExample === undefined ? {} : { key: valueExample }\n }\n case 'ZodUnion':\n case 'union': {\n const options = def?.options || []\n return options.length ? generateExample(options[0], context) : undefined\n }\n case 'ZodPipeline':\n case 'pipe':\n return generateExample(def?.out ?? def?.innerType ?? def?.schema, context)\n case 'ZodLazy':\n case 'lazy': {\n const next = typeof def?.getter === 'function' ? def.getter() : undefined\n return next ? generateExample(next, context) : undefined\n }\n case 'ZodPromise':\n case 'promise':\n return generateExample(def?.type, context)\n case 'ZodCatch':\n case 'catch':\n return generateExample(def?.innerType ?? def?.type, context)\n case 'ZodReadonly':\n case 'readonly':\n return generateExample(def?.innerType ?? def?.type, context)\n case 'ZodIntersection':\n case 'intersection': {\n const left = generateExample(def?.left, context)\n const right = generateExample(def?.right, context)\n if (typeof left === 'object' && left && typeof right === 'object' && right) {\n return { ...(left as object), ...(right as object) }\n }\n return left ?? right\n }\n case 'ZodDate':\n case 'date':\n return DEFAULT_EXAMPLE_VALUES.datetime\n default:\n return undefined\n }\n } finally {\n context.stack.delete(trackable as ZodTypeAny)\n }\n}\n\nfunction buildParameters(\n schema: ZodTypeAny | undefined,\n location: ParameterLocation,\n pathParamNames?: PathParamInfo[]\n): Array<Record<string, unknown>> {\n if (!schema && location !== 'path') return []\n\n const params: Array<Record<string, unknown>> = []\n\n if (location === 'path' && pathParamNames && pathParamNames.length) {\n const merged = mergePathParamSchemas(schema, pathParamNames)\n for (const { name, schema: paramSchema, optional } of merged) {\n const jsonSchema = zodToJsonSchema(paramSchema)\n const example = generateExample(paramSchema)\n const description = extractZodDescription(paramSchema)\n params.push({\n name,\n in: 'path',\n required: !optional,\n schema: jsonSchema ?? { type: 'string' },\n example,\n ...(description ? { description } : {}),\n })\n }\n return params\n }\n\n if (!schema) return params\n\n const { schema: unwrapped } = unwrap(schema)\n if (!unwrapped) return params\n const def = (unwrapped as any)._def\n const typeName = resolveType(def) as string | undefined\n if (typeName === 'ZodObject' || typeName === 'object') {\n const shape = getShape(def)\n for (const [key, raw] of Object.entries(shape)) {\n const details = unwrap(raw as ZodTypeAny)\n if (!details.schema) continue\n const jsonSchema = zodToJsonSchema(details.schema)\n const example = generateExample(details.schema)\n const description = extractZodDescription(raw as ZodTypeAny)\n params.push({\n name: key,\n in: location,\n required: location === 'path' ? true : !details.optional,\n schema: jsonSchema ?? {},\n example,\n ...(description ? { description } : {}),\n })\n }\n } else {\n const jsonSchema = zodToJsonSchema(unwrapped)\n const example = generateExample(unwrapped)\n const description = extractZodDescription(unwrapped)\n params.push({\n name: location === 'header' ? 'X-Custom-Header' : 'value',\n in: location,\n required: location === 'path',\n schema: jsonSchema ?? {},\n example,\n ...(description ? { description } : {}),\n })\n }\n\n return params\n}\n\nfunction mergePathParamSchemas(schema: ZodTypeAny | undefined, params: PathParamInfo[]) {\n const merged: Array<{ name: string; schema: ZodTypeAny | undefined; optional: boolean }> = []\n const map: Record<string, ZodTypeAny> = {}\n if (schema) {\n const { schema: unwrapped } = unwrap(schema)\n if (unwrapped && (unwrapped as any)._def && (resolveType((unwrapped as any)._def) === 'ZodObject' || resolveType((unwrapped as any)._def) === 'object')) {\n const shape = getShape((unwrapped as any)._def)\n for (const [key, value] of Object.entries(shape)) {\n map[key] = value as ZodTypeAny\n }\n }\n }\n for (const param of params) {\n merged.push({\n name: param.name,\n schema: map[param.name],\n optional: !!param.optional,\n })\n }\n return merged\n}\n\nfunction buildRequestBody(request?: OpenApiRequestBodyDoc): Record<string, unknown> | undefined {\n if (!request) return undefined\n const schema = zodToJsonSchema(request.schema)\n const example = request.example ?? generateExample(request.schema)\n const contentType = request.contentType ?? 'application/json'\n return {\n required: true,\n content: {\n [contentType]: {\n schema: schema ?? {},\n example,\n },\n },\n description: request.description,\n }\n}\n\nfunction buildResponses(\n method: HttpMethod,\n responses?: OpenApiResponseDoc[],\n errors?: OpenApiResponseDoc[],\n metadata?: any\n): Record<string, unknown> {\n const entries: Record<string, unknown> = {}\n const list = [...(responses ?? [])]\n const errorList = [...(errors ?? [])]\n const inferredList: OpenApiResponseDoc[] = []\n if (metadata?.requireAuth) {\n inferredList.push({\n status: 401,\n description: 'Unauthorized',\n schema: z.object({ error: z.string() }),\n xAutoGenerated: true,\n })\n }\n if (Array.isArray(metadata?.requireFeatures) && metadata.requireFeatures.length) {\n inferredList.push({\n status: 403,\n description: 'Forbidden \u2013 missing required features',\n schema: z.object({ error: z.string() }),\n xAutoGenerated: true,\n })\n }\n if (!list.some((res) => res.status >= 200 && res.status < 300)) {\n const fallbackStatus = method === 'POST' ? 201 : method === 'DELETE' ? 204 : 200\n list.push({\n status: fallbackStatus,\n description: fallbackStatus === 204 ? 'Success' : 'Success response',\n })\n }\n const setEntry = (res: OpenApiResponseDoc, options?: { skipIfPresent?: boolean }) => {\n const status = String(res.status || 200)\n if (options?.skipIfPresent && Object.prototype.hasOwnProperty.call(entries, status)) return\n const mediaType = res.mediaType ?? 'application/json'\n const schema = res.schema ? zodToJsonSchema(res.schema) : undefined\n const example = res.schema ? res.example ?? generateExample(res.schema) : res.example\n const isNoContent = res.status === 204\n entries[status] = {\n description: res.description ?? '',\n ...(isNoContent\n ? {}\n : {\n content: {\n [mediaType]: {\n schema: schema ?? { type: 'object' },\n ...(example !== undefined ? { example } : {}),\n },\n },\n }),\n ...(res.xAutoGenerated ? { 'x-autoGenerated': true } : {}),\n }\n }\n for (const res of [...list, ...errorList]) setEntry(res)\n for (const res of inferredList) setEntry(res, { skipIfPresent: true })\n return entries\n}\n\nfunction buildSecurity(metadata: any, methodDoc?: OpenApiMethodDoc, defaults?: string[]) {\n const securitySchemes = new Set<string>()\n if (Array.isArray(methodDoc?.security)) methodDoc.security.forEach((s) => securitySchemes.add(s))\n if (metadata?.requireAuth) securitySchemes.add('bearerAuth')\n if (defaults) defaults.forEach((s) => securitySchemes.add(s))\n if (securitySchemes.size === 0) return undefined\n return Array.from(securitySchemes.values()).map((scheme) => ({ [scheme]: [] }))\n}\n\nfunction collectExamples(\n querySchema?: ZodTypeAny,\n bodySchema?: ZodTypeAny,\n pathSchema?: ZodTypeAny,\n headerSchema?: ZodTypeAny,\n metadata?: any\n): ExampleMap {\n const examples: ExampleMap = {}\n const queryExample = querySchema ? generateExample(querySchema) : undefined\n if (queryExample && typeof queryExample === 'object') examples.query = queryExample\n const bodyExample = bodySchema ? generateExample(bodySchema) : undefined\n if (bodyExample !== undefined) examples.body = bodyExample\n const pathExample = pathSchema ? generateExample(pathSchema) : undefined\n if (pathExample && typeof pathExample === 'object') examples.path = pathExample as Record<string, unknown>\n const headerExample = headerSchema ? generateExample(headerSchema) : undefined\n if (headerExample && typeof headerExample === 'object') examples.headers = headerExample as Record<string, unknown>\n if (metadata?.requireAuth) {\n if (!examples.headers) examples.headers = {}\n if (typeof examples.headers.authorization !== 'string') {\n examples.headers.authorization = 'Bearer <token>'\n }\n }\n return examples\n}\n\nfunction toFormUrlEncoded(value: unknown): string {\n if (!value || typeof value !== 'object') return ''\n const params = new URLSearchParams()\n for (const [key, raw] of Object.entries(value as Record<string, unknown>)) {\n if (raw === undefined) continue\n params.append(key, raw === null ? '' : String(raw))\n }\n return params.toString()\n}\n\nfunction stringifyBodyExample(value: unknown, mediaType?: string): string {\n if (value === undefined) return ''\n if (mediaType === 'application/x-www-form-urlencoded') {\n return toFormUrlEncoded(value)\n }\n if (!mediaType || mediaType === 'application/json') {\n try {\n return JSON.stringify(value, null, 2)\n } catch {\n return ''\n }\n }\n if (typeof value === 'string') return value\n try {\n return JSON.stringify(value, null, 2)\n } catch {\n return String(value)\n }\n}\n\nfunction buildQueryString(example: unknown): string {\n if (!example || typeof example !== 'object') return ''\n const parts: string[] = []\n for (const [key, value] of Object.entries(example as Record<string, unknown>)) {\n if (value === undefined || value === null) continue\n const encoded = encodeURIComponent(String(value))\n parts.push(`${encodeURIComponent(key)}=${encoded}`)\n }\n return parts.length ? `?${parts.join('&')}` : ''\n}\n\nfunction injectPathExamples(path: string, params: PathParamInfo[], examples?: Record<string, unknown>): string {\n if (!params.length) return path\n let result = path\n for (const param of params) {\n const placeholder = `{${param.name}}`\n const example = examples && examples[param.name] !== undefined ? examples[param.name] : `:${param.name}`\n result = result.replace(placeholder, String(example))\n }\n return result\n}\n\nfunction buildCurlSample(\n method: HttpMethod,\n path: string,\n params: PathParamInfo[],\n examples: ExampleMap,\n baseUrl: string,\n metadata: any,\n requestBody?: OpenApiRequestBodyDoc\n): string {\n const lines: string[] = []\n const pathWithExamples = injectPathExamples(path, params, examples.path)\n const query = buildQueryString(examples.query)\n const url = baseUrl.replace(/\\/$/, '') + pathWithExamples + query\n lines.push(`curl -X ${method} \"${url}\"`)\n\n lines.push(' -H \"Accept: application/json\"')\n\n const headers: Record<string, unknown> = { ...(examples.headers ?? {}) }\n if (metadata?.requireAuth && !headers.Authorization && !headers.authorization) {\n headers.Authorization = 'Bearer <token>'\n }\n for (const [key, value] of Object.entries(headers)) {\n lines.push(` -H \"${key.replace(/\"/g, '')}: ${String(value).replace(/\"/g, '')}\"`)\n }\n\n const bodyExample = examples.body ?? requestBody?.example\n const requestContentType = requestBody?.contentType ?? 'application/json'\n if (bodyExample !== undefined) {\n lines.push(` -H \"Content-Type: ${requestContentType}\"`)\n const serialized = stringifyBodyExample(bodyExample, requestContentType)\n if (serialized) {\n const escapedSerialized = escapeShellDoubleQuotes(serialized)\n lines.push(` -d \"${escapedSerialized}\"`)\n }\n }\n\n return lines.join(' \\\\\\n')\n}\n\nfunction escapeShellDoubleQuotes(value: string): string {\n return value.replace(/[\\\\`\"$]/g, '\\\\$&')\n}\n\nfunction ensureSecurityComponents(doc: OpenApiDocument) {\n if (!doc.components) doc.components = {}\n if (!doc.components.securitySchemes) doc.components.securitySchemes = {}\n if (!doc.components.securitySchemes.bearerAuth) {\n doc.components.securitySchemes.bearerAuth = {\n type: 'http',\n scheme: 'bearer',\n bearerFormat: 'JWT',\n description: 'Send an `Authorization: Bearer <token>` header with a valid API token.',\n }\n }\n}\n\nfunction resolveOperationId(moduleId: string, path: string, method: HttpMethod): string {\n const cleaned = normalizeOperationIdSegment(path)\n return [moduleId, method.toLowerCase(), cleaned].filter(Boolean).join('_')\n}\n\nfunction normalizeOperationIdSegment(input: string): string {\n let output = ''\n let previousUnderscore = false\n\n for (const character of input) {\n const codePoint = character.charCodeAt(0)\n const isLower = codePoint >= 97 && codePoint <= 122\n const isUpper = codePoint >= 65 && codePoint <= 90\n const isNumber = codePoint >= 48 && codePoint <= 57\n const isAlphaNumeric = isLower || isUpper || isNumber\n\n if (isAlphaNumeric) {\n output += character\n previousUnderscore = false\n continue\n }\n\n if (!previousUnderscore) {\n output += '_'\n previousUnderscore = true\n }\n }\n\n while (output.startsWith('_')) output = output.slice(1)\n while (output.endsWith('_')) output = output.slice(0, -1)\n\n return output\n}\n\nfunction collectRouteDoc(api: ModuleApi, moduleId: string): OpenApiRouteDoc | undefined {\n if ('handlers' in api) {\n const route = api as ModuleApiRouteFile & { docs?: OpenApiRouteDoc }\n if (route.docs) return route.docs\n const maybe = (route.handlers as any)?.openApi\n if (maybe && typeof maybe === 'object') return maybe as OpenApiRouteDoc\n } else {\n const legacy = api as ModuleApiLegacy & { docs?: OpenApiMethodDoc }\n if (legacy.docs) {\n return {\n methods: { [legacy.method]: legacy.docs },\n }\n }\n const maybe = (legacy.handler as any)?.openApi\n if (maybe && typeof maybe === 'object') {\n return {\n methods: { [legacy.method]: maybe as OpenApiMethodDoc },\n }\n }\n }\n return undefined\n}\n\nexport function buildOpenApiDocument(modules: Module[], options: OpenApiDocumentOptions = {}): OpenApiDocument {\n const doc: OpenApiDocument = {\n openapi: '3.1.0',\n info: {\n title: options.title ?? 'Open Mercato API',\n version: options.version ?? '1.0.0',\n description: options.description,\n },\n servers: options.servers,\n paths: {},\n }\n\n ensureSecurityComponents(doc)\n\n const tags = new Map<string, string | undefined>()\n\n for (const moduleEntry of modules) {\n const defaultTag = moduleEntry.info?.title ?? toTitle(moduleEntry.id)\n if (defaultTag) tags.set(defaultTag, moduleEntry.info?.description)\n\n const apis = moduleEntry.apis ?? []\n for (const api of apis) {\n const routeDoc = collectRouteDoc(api, moduleEntry.id)\n const moduleTag = routeDoc?.tag ?? defaultTag\n const normalized = normalizePath((api as any).path ?? (api as any).path ?? '')\n const pathKey = normalized.path\n if (!doc.paths[pathKey]) doc.paths[pathKey] = {}\n const availableMethods: HttpMethod[] =\n 'handlers' in api\n ? HTTP_METHODS.filter((method) => typeof (api as ModuleApiRouteFile).handlers?.[method] === 'function')\n : [api.method as HttpMethod]\n\n for (const method of availableMethods) {\n const methodLower = method.toLowerCase() as Lowercase<HttpMethod>\n const existing = doc.paths[pathKey][methodLower]\n if (existing) continue\n\n const metadata = 'handlers' in api ? (api as ModuleApiRouteFile).metadata?.[method] : undefined\n const methodDoc = routeDoc?.methods?.[method]\n const summary = methodDoc?.summary ?? routeDoc?.summary ?? `${method} ${pathKey}`\n const baseDescription = methodDoc?.description ?? routeDoc?.description\n const meta = metadata && typeof metadata === 'object' ? (metadata as Record<string, unknown>) : undefined\n const requireFeatures = Array.isArray(meta?.['requireFeatures'])\n ? (meta!['requireFeatures'] as string[])\n : undefined\n const requireRoles = Array.isArray(meta?.['requireRoles'])\n ? (meta!['requireRoles'] as string[])\n : undefined\n const requireAuth = meta?.['requireAuth'] === true\n const descriptionParts: string[] = []\n if (baseDescription) descriptionParts.push(baseDescription)\n if (Array.isArray(requireFeatures) && requireFeatures.length) {\n descriptionParts.push(`Requires features: ${requireFeatures.join(', ')}`)\n }\n if (Array.isArray(requireRoles) && requireRoles.length) {\n descriptionParts.push(`Requires roles: ${requireRoles.join(', ')}`)\n }\n\n const querySchema = methodDoc?.query\n const pathSchema = methodDoc?.pathParams ?? routeDoc?.pathParams\n const headerSchema = methodDoc?.headers\n const requestBody = methodDoc?.requestBody\n const examples = collectExamples(querySchema, requestBody?.schema, pathSchema, headerSchema, metadata)\n const curlSample = buildCurlSample(\n method,\n pathKey,\n normalized.params,\n examples,\n options.baseUrlForExamples ?? 'https://api.open-mercato.local',\n metadata,\n requestBody\n )\n\n doc.paths[pathKey][methodLower] = {\n operationId: methodDoc?.operationId ?? resolveOperationId(moduleEntry.id, pathKey, method),\n summary,\n description: descriptionParts.length ? descriptionParts.join('\\n\\n') : undefined,\n tags: methodDoc?.tags ?? (moduleTag ? [moduleTag] : undefined),\n deprecated: methodDoc?.deprecated,\n externalDocs: methodDoc?.externalDocs,\n parameters: [\n ...buildParameters(pathSchema, 'path', normalized.params),\n ...buildParameters(querySchema, 'query'),\n ...buildParameters(headerSchema, 'header'),\n ].filter(Boolean),\n requestBody: buildRequestBody(requestBody),\n responses: buildResponses(method, methodDoc?.responses, methodDoc?.errors, metadata),\n security: buildSecurity(metadata, methodDoc, options.defaultSecurity),\n 'x-codeSamples': methodDoc?.codeSamples ?? [\n {\n lang: 'curl',\n label: 'cURL',\n source: curlSample,\n },\n ],\n ...(Array.isArray(requireFeatures) && requireFeatures.length ? { 'x-require-features': requireFeatures } : {}),\n ...(Array.isArray(requireRoles) && requireRoles.length ? { 'x-require-roles': requireRoles } : {}),\n ...(requireAuth ? { 'x-require-auth': true } : {}),\n ...(methodDoc?.extensions ?? {}),\n }\n }\n }\n }\n\n doc.tags = Array.from(tags.entries()).map(([name, description]) => ({\n name,\n description: description ?? undefined,\n }))\n\n return doc\n}\n\nfunction formatMarkdownTable(rows: Array<[string, string, string, string]>): string {\n if (!rows.length) return ''\n const header = ['Name', 'Location', 'Type', 'Description']\n const align = ['---', '---', '---', '---']\n const lines = [\n `| ${header.join(' | ')} |`,\n `| ${align.join(' | ')} |`,\n ...rows.map((row) => `| ${row.join(' | ')} |`),\n ]\n return lines.join('\\n')\n}\n\nfunction schemaTypeLabel(schema: any): string {\n if (!schema) return 'any'\n if (schema.type) return schema.type\n if (schema.oneOf) return schema.oneOf.map(schemaTypeLabel).join(' | ')\n if (schema.allOf) return schema.allOf.map(schemaTypeLabel).join(' & ')\n return 'any'\n}\n\nfunction schemaHasDetails(schema: unknown): boolean {\n if (!schema || typeof schema !== 'object') return false\n const schemaObj = schema as Record<string, unknown>\n if (Array.isArray(schemaObj.enum) && schemaObj.enum.length) return true\n if (schemaObj.const !== undefined) return true\n if (typeof schemaObj.format === 'string') return true\n if (Array.isArray(schemaObj.oneOf) && schemaObj.oneOf.some((s: unknown) => schemaHasDetails(s))) return true\n if (Array.isArray(schemaObj.anyOf) && schemaObj.anyOf.some((s: unknown) => schemaHasDetails(s))) return true\n if (Array.isArray(schemaObj.allOf) && schemaObj.allOf.some((s: unknown) => schemaHasDetails(s))) return true\n if (schemaObj.items && schemaHasDetails(schemaObj.items)) return true\n if (schemaObj.properties && Object.keys(schemaObj.properties as Record<string, unknown>).length) return true\n if (Array.isArray(schemaObj.prefixItems) && schemaObj.prefixItems.some((s: unknown) => schemaHasDetails(s))) return true\n if (schemaObj.type && schemaObj.type !== 'object') return true\n return false\n}\n\ntype ContentSelection = {\n mediaType: string\n entry: any\n}\n\ntype DisplaySnippet = {\n value: string\n language: string\n}\n\nfunction selectContentVariant(content?: Record<string, any>): ContentSelection | undefined {\n if (!content) return undefined\n const entries = Object.entries(content)\n if (!entries.length) return undefined\n const preferred = [\n 'application/json',\n 'application/x-www-form-urlencoded',\n 'multipart/form-data',\n 'text/plain',\n ]\n for (const mediaType of preferred) {\n const match = entries.find(([type]) => type === mediaType)\n if (match) {\n const [selectedType, entry] = match\n return { mediaType: selectedType, entry }\n }\n }\n const [mediaType, entry] = entries[0]\n return { mediaType, entry }\n}\n\nfunction formatExampleForDisplay(example: unknown, mediaType?: string): DisplaySnippet | null {\n if (example === undefined) return null\n if (mediaType === 'application/x-www-form-urlencoded') {\n const encoded = toFormUrlEncoded(example)\n if (!encoded) return null\n return { value: encoded, language: 'text' }\n }\n if (mediaType === 'multipart/form-data') {\n if (example && typeof example === 'object') {\n const lines = Object.entries(example as Record<string, unknown>).map(([key, value]) => {\n const rendered = value === undefined || value === null ? '' : String(value)\n return `${key}=${rendered}`\n })\n if (lines.length) {\n return { value: lines.join('\\n'), language: 'text' }\n }\n }\n if (typeof example === 'string') {\n return { value: example, language: 'text' }\n }\n }\n if (!mediaType || mediaType === 'application/json') {\n try {\n return { value: JSON.stringify(example, null, 2), language: 'json' }\n } catch {\n return null\n }\n }\n if (typeof example === 'string') {\n return { value: example, language: 'text' }\n }\n try {\n return { value: JSON.stringify(example, null, 2), language: 'json' }\n } catch {\n return { value: String(example), language: 'text' }\n }\n}\n\nfunction formatSchemaForDisplay(schema: any): DisplaySnippet | null {\n if (!schema) return null\n try {\n return { value: JSON.stringify(schema, null, 2), language: 'json' }\n } catch {\n return null\n }\n}\n\nexport function generateMarkdownFromOpenApi(doc: OpenApiDocument): string {\n const lines: string[] = []\n lines.push(`# ${doc.info.title}`)\n lines.push('')\n lines.push(`Version: ${doc.info.version}`)\n if (doc.info.description) {\n lines.push('')\n lines.push(doc.info.description)\n }\n if (doc.servers && doc.servers.length) {\n lines.push('')\n lines.push('## Servers')\n for (const server of doc.servers) {\n lines.push(`- ${server.url}${server.description ? ` \u2013 ${server.description}` : ''}`)\n }\n }\n\n const sortedPaths = Object.keys(doc.paths).sort((a, b) => a.localeCompare(b))\n for (const path of sortedPaths) {\n const operations = doc.paths[path]\n const methods = Object.keys(operations).sort((a, b) => a.localeCompare(b))\n for (const method of methods) {\n const op: any = operations[method]\n lines.push('')\n lines.push(`## ${method.toUpperCase()} \\`${path}\\``)\n if (op.summary) {\n lines.push('')\n lines.push(op.summary)\n }\n if (op.description) {\n lines.push('')\n lines.push(op.description)\n }\n if (op.tags && op.tags.length) {\n lines.push('')\n lines.push(`**Tags:** ${op.tags.join(', ')}`)\n }\n if (op['x-require-auth']) {\n lines.push('')\n lines.push(`**Requires authentication.**`)\n }\n if (op['x-require-features']) {\n lines.push('')\n lines.push(`**Features:** ${(op['x-require-features'] as string[]).join(', ')}`)\n }\n if (op['x-require-roles']) {\n lines.push('')\n lines.push(`**Roles:** ${(op['x-require-roles'] as string[]).join(', ')}`)\n }\n\n const parameters = (op.parameters as any[]) ?? []\n if (parameters.length) {\n lines.push('')\n lines.push('### Parameters')\n const rows: Array<[string, string, string, string]> = parameters.map((p) => {\n const requiredLabel = p.required ? 'Required' : 'Optional'\n const descriptionParts = [requiredLabel, p.description].filter(Boolean)\n return [\n p.name,\n p.in,\n schemaTypeLabel(p.schema),\n descriptionParts.join('. '),\n ]\n })\n lines.push(formatMarkdownTable(rows))\n }\n\n if (op.requestBody) {\n const selection = selectContentVariant(op.requestBody.content)\n if (selection) {\n const { mediaType, entry } = selection\n const example = entry?.example ?? entry?.examples?.default?.value\n const formatted = formatExampleForDisplay(example, mediaType)\n const schemaFormatted =\n entry?.schema && schemaHasDetails(entry.schema) ? formatSchemaForDisplay(entry.schema) : null\n lines.push('')\n lines.push('### Request Body')\n lines.push('')\n lines.push(`Content-Type: \\`${mediaType}\\``)\n if (formatted) {\n lines.push('')\n lines.push(`\\`\\`\\`${formatted.language}`)\n lines.push(formatted.value)\n lines.push('```')\n } else if (schemaFormatted) {\n lines.push('')\n lines.push(`\\`\\`\\`${schemaFormatted.language}`)\n lines.push(schemaFormatted.value)\n lines.push('```')\n } else {\n lines.push('')\n lines.push('No example available for this content type.')\n }\n }\n }\n\n const responses = op.responses ?? {}\n const responseStatuses = Object.keys(responses).sort((a, b) => a.localeCompare(b))\n if (responseStatuses.length) {\n lines.push('')\n lines.push('### Responses')\n for (const status of responseStatuses) {\n const response = responses[status]\n if (response?.['x-autoGenerated']) continue\n lines.push('')\n lines.push(`**${status}** \u2013 ${response.description || 'Response'}`)\n const selection = selectContentVariant(response.content)\n if (selection) {\n const { mediaType, entry } = selection\n const example = entry?.example ?? entry?.examples?.default?.value\n const formatted = formatExampleForDisplay(example, mediaType)\n const schemaFormatted =\n entry?.schema && schemaHasDetails(entry.schema) ? formatSchemaForDisplay(entry.schema) : null\n lines.push('')\n lines.push(`Content-Type: \\`${mediaType}\\``)\n if (formatted) {\n lines.push('')\n lines.push(`\\`\\`\\`${formatted.language}`)\n lines.push(formatted.value)\n lines.push('```')\n } else if (schemaFormatted) {\n lines.push('')\n lines.push(`\\`\\`\\`${schemaFormatted.language}`)\n lines.push(schemaFormatted.value)\n lines.push('```')\n }\n }\n }\n }\n\n const samples = op['x-codeSamples'] as any[] | undefined\n if (samples && samples.length) {\n const curl = samples.find((sample) => String(sample.lang).toLowerCase() === 'curl') ?? samples[0]\n if (curl?.source) {\n lines.push('')\n lines.push('### Example')\n lines.push('')\n lines.push('```bash')\n lines.push(curl.source)\n lines.push('```')\n }\n }\n }\n }\n\n return lines.join('\\n')\n}\n"],
|
|
5
|
-
"mappings": "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",
|
|
4
|
+
"sourcesContent": ["import { z, type ZodTypeAny } from 'zod'\nimport type { Module, ModuleApi, ModuleApiLegacy, ModuleApiRouteFile, HttpMethod } from '@open-mercato/shared/modules/registry'\nimport type {\n OpenApiDocument,\n OpenApiDocumentOptions,\n OpenApiMethodDoc,\n OpenApiRequestBodyDoc,\n OpenApiResponseDoc,\n OpenApiRouteDoc,\n} from './types'\n\ntype PathParamInfo = {\n name: string\n catchAll?: boolean\n optional?: boolean\n}\n\ntype ParameterLocation = 'query' | 'path' | 'header'\n\ntype JsonSchema = Record<string, unknown>\n\ntype SchemaConversionContext = {\n memo: WeakMap<ZodTypeAny, JsonSchema>\n}\n\ntype ExampleGenerationContext = {\n stack: WeakSet<ZodTypeAny>\n}\n\ntype ExampleMap = {\n query?: unknown\n body?: unknown\n path?: Record<string, unknown>\n headers?: Record<string, unknown>\n}\n\nconst HTTP_METHODS: HttpMethod[] = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE']\n\nfunction resolveType(def: any): string | undefined {\n if (!def) return undefined\n if (typeof def.typeName === 'string' && def.typeName.length) return def.typeName\n if (typeof def.type === 'string' && def.type.length) return def.type\n return undefined\n}\n\nfunction getShape(def: any): Record<string, ZodTypeAny> {\n if (!def) return {}\n const shape = typeof def.shape === 'function' ? def.shape() : def.shape\n if (shape && typeof shape === 'object') return shape as Record<string, ZodTypeAny>\n return {}\n}\n\nfunction normalizeChecks(checks: any[] | undefined): Array<{ kind?: string; value?: unknown; extra?: Record<string, unknown> }> {\n if (!Array.isArray(checks)) return []\n return checks.map((check) => {\n if (!check) return {}\n const base = (check as any)?._zod?.def ?? (check as any)?.def ?? check\n const kind = typeof (check as any)?.kind === 'string'\n ? (check as any).kind\n : typeof base?.check === 'string'\n ? base.check\n : undefined\n const value =\n base?.value ??\n base?.minimum ??\n base?.maximum ??\n base?.exact ??\n base?.length ??\n base?.limit ??\n base?.includes ??\n base?.min ??\n base?.max\n return { kind, value, extra: base && typeof base === 'object' ? base : undefined }\n })\n}\n\nconst DEFAULT_EXAMPLE_VALUES = {\n string: 'string',\n number: 1,\n integer: 1,\n boolean: true,\n uuid: '00000000-0000-4000-8000-000000000000',\n email: 'user@example.com',\n url: 'https://example.com/resource',\n datetime: new Date('2025-01-01T00:00:00.000Z').toISOString(),\n}\n\nfunction toTitle(str: string): string {\n if (!str) return ''\n return str\n .split(/[_\\-\\s]+/)\n .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n .join(' ')\n}\n\nfunction normalizePath(path: string): { path: string; params: PathParamInfo[] } {\n const segments = path.split('/').filter((seg) => seg.length > 0)\n const params: PathParamInfo[] = []\n const normalized = segments\n .map((seg) => {\n const catchAll = seg.match(/^\\[\\.\\.\\.(.+)\\]$/)\n if (catchAll) {\n params.push({ name: catchAll[1], catchAll: true })\n return `{${catchAll[1]}}`\n }\n const optCatchAll = seg.match(/^\\[\\[\\.\\.\\.(.+)\\]\\]$/)\n if (optCatchAll) {\n params.push({ name: optCatchAll[1], catchAll: true, optional: true })\n return `{${optCatchAll[1]}}`\n }\n const dyn = seg.match(/^\\[(.+)\\]$/)\n if (dyn) {\n params.push({ name: dyn[1] })\n return `{${dyn[1]}}`\n }\n return seg\n })\n .join('/')\n return { path: '/' + normalized, params }\n}\n\nfunction unwrap(schema?: ZodTypeAny): {\n schema: ZodTypeAny | undefined\n optional: boolean\n nullable: boolean\n defaultValue?: unknown\n} {\n if (!schema) {\n return { schema: undefined, optional: true, nullable: false }\n }\n\n let current: ZodTypeAny = schema\n let optional = false\n let nullable = false\n let defaultValue: unknown\n // eslint-disable-next-line no-constant-condition\n while (true) {\n const def = (current as any)?._def\n if (!def) {\n return { schema: current, optional, nullable, defaultValue }\n }\n const typeName = resolveType(def)\n if (typeName === 'ZodOptional' || typeName === 'optional') {\n optional = true\n current = (current as any)._def.innerType\n continue\n }\n if (typeName === 'ZodNullable' || typeName === 'nullable') {\n nullable = true\n current = (current as any)._def.innerType\n continue\n }\n if (typeName === 'ZodDefault' || typeName === 'default') {\n optional = true\n const rawDefault = (current as any)._def.defaultValue\n defaultValue = typeof rawDefault === 'function' ? rawDefault() : rawDefault\n current = (current as any)._def.innerType\n continue\n }\n if (typeName === 'ZodPipeline' || typeName === 'pipe') {\n current = (current as any)._def.out ?? (current as any)._def.innerType ?? (current as any)._def.schema\n continue\n }\n if (typeName === 'transformer') {\n current = (current as any)._def.output\n continue\n }\n if (typeName === 'ZodLazy' || typeName === 'lazy') {\n const getter = (current as any)._def.getter\n current = typeof getter === 'function' ? getter() : current\n if (current === schema) break\n continue\n }\n if (typeName === 'ZodPromise' || typeName === 'promise') {\n current = (current as any)._def.type\n continue\n }\n if (typeName === 'ZodCatch' || typeName === 'catch') {\n current = (current as any)._def.innerType\n continue\n }\n if (typeName === 'ZodReadonly' || typeName === 'readonly') {\n current = (current as any)._def.innerType\n continue\n }\n if (typeName === 'ZodBranded' || typeName === 'branded') {\n current = (current as any)._def.type\n continue\n }\n break\n }\n return { schema: current, optional, nullable, defaultValue }\n}\n\n/**\n * Extract the description from a zod schema, walking through wrappers like optional/nullable/default.\n * Returns the first description found, or undefined if none exists.\n */\nfunction extractZodDescription(schema?: ZodTypeAny): string | undefined {\n if (!schema) return undefined\n\n let current: ZodTypeAny | undefined = schema\n while (current) {\n // In Zod 4/zod-mini, description is stored directly on the schema object\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const directDescription = (current as any).description\n if (typeof directDescription === 'string' && directDescription.length > 0) {\n return directDescription\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const def = (current as any)?._def as Record<string, unknown> | undefined\n if (!def) return undefined\n\n // Also check _def.description for Zod 3 compatibility\n if (typeof def.description === 'string' && def.description.length > 0) {\n return def.description\n }\n\n // Walk through wrappers to find description on inner types\n const typeName = resolveType(def)\n if (\n typeName === 'ZodOptional' || typeName === 'optional' ||\n typeName === 'ZodNullable' || typeName === 'nullable' ||\n typeName === 'ZodDefault' || typeName === 'default' ||\n typeName === 'ZodCatch' || typeName === 'catch' ||\n typeName === 'ZodReadonly' || typeName === 'readonly'\n ) {\n current = def.innerType as ZodTypeAny | undefined\n continue\n }\n if (typeName === 'ZodBranded' || typeName === 'branded') {\n current = def.type as ZodTypeAny | undefined\n continue\n }\n if (typeName === 'ZodPipeline' || typeName === 'pipe') {\n current = (def.out ?? def.innerType ?? def.schema) as ZodTypeAny | undefined\n continue\n }\n if (typeName === 'transformer') {\n current = def.output as ZodTypeAny | undefined\n continue\n }\n if (typeName === 'ZodLazy' || typeName === 'lazy') {\n const getter = def.getter\n const next = typeof getter === 'function' ? (getter as () => ZodTypeAny)() : current\n if (next === current) break\n current = next\n continue\n }\n if (typeName === 'ZodPromise' || typeName === 'promise') {\n current = def.type as ZodTypeAny | undefined\n continue\n }\n // No more wrappers to unwrap\n break\n }\n return undefined\n}\n\nfunction zodToJsonSchema(schema?: ZodTypeAny, ctx?: SchemaConversionContext): JsonSchema | undefined {\n if (!schema) return undefined\n const context: SchemaConversionContext = ctx ?? { memo: new WeakMap<ZodTypeAny, JsonSchema>() }\n\n const cached = context.memo.get(schema)\n if (cached) return cached\n\n const placeholder: JsonSchema = {}\n context.memo.set(schema, placeholder)\n\n const { schema: inner, nullable } = unwrap(schema)\n if (!inner) {\n if (nullable) placeholder.nullable = true\n return placeholder\n }\n\n if (inner !== schema && typeof inner === 'object') {\n if (!context.memo.has(inner as ZodTypeAny)) {\n context.memo.set(inner as ZodTypeAny, placeholder)\n }\n }\n\n const def = (inner as any)._def\n if (!def) return placeholder\n const typeName = resolveType(def) as string | undefined\n\n const result = placeholder\n\n switch (typeName) {\n case 'ZodString':\n case 'string': {\n result.type = 'string'\n const checks = normalizeChecks(def.checks)\n for (const check of checks) {\n if (!check.kind) continue\n if (check.kind === 'uuid' || check.extra?.format === 'uuid') {\n result.format = 'uuid'\n } else if (check.kind === 'email' || check.extra?.format === 'email') {\n result.format = 'email'\n } else if (check.kind === 'url' || check.extra?.format === 'uri' || check.extra?.format === 'url') {\n result.format = 'uri'\n } else if (check.kind === 'regex' && check.extra?.pattern instanceof RegExp) {\n result.pattern = check.extra.pattern.source\n } else if (check.kind === 'string_format' && typeof check.extra?.format === 'string') {\n if (check.extra.format === 'regex' && check.extra.pattern != null) {\n result.pattern = check.extra.pattern instanceof RegExp\n ? check.extra.pattern.source\n : String(check.extra.pattern)\n } else {\n result.format = check.extra.format\n }\n } else if (check.kind === 'datetime' || check.extra?.format === 'date-time') {\n result.format = 'date-time'\n } else if (['length', 'len', 'exact_length'].includes(check.kind ?? '')) {\n if (typeof check.value === 'number') {\n result.minLength = check.value\n result.maxLength = check.value\n }\n } else if (check.kind === 'min' || check.kind === 'min_length') {\n if (typeof check.value === 'number') result.minLength = check.value\n } else if (check.kind === 'max' || check.kind === 'max_length') {\n if (typeof check.value === 'number') result.maxLength = check.value\n }\n }\n break\n }\n case 'ZodNumber':\n case 'number': {\n result.type = 'number'\n const checks = normalizeChecks(def.checks)\n for (const check of checks) {\n if (!check.kind) continue\n if (check.kind === 'int' || check.kind === 'isInteger') result.type = 'integer'\n if ((check.kind === 'min' || check.kind === 'gte') && typeof check.value === 'number') result.minimum = check.value\n if ((check.kind === 'max' || check.kind === 'lte') && typeof check.value === 'number') result.maximum = check.value\n if (check.kind === 'multipleOf' && typeof check.value === 'number') result.multipleOf = check.value\n }\n break\n }\n case 'ZodBigInt':\n case 'bigint':\n result.type = 'integer'\n result.format = 'int64'\n break\n case 'ZodBoolean':\n case 'boolean':\n result.type = 'boolean'\n break\n case 'ZodLiteral':\n case 'literal': {\n const value = def.value ?? (Array.isArray(def.values) ? def.values[0] : undefined)\n result.type = typeof value\n result.enum = [value]\n break\n }\n case 'ZodEnum':\n case 'enum': {\n const entries = def.values ?? def.entries\n const values = Array.isArray(entries) ? entries : entries ? Object.values(entries) : []\n const enumerators = values.filter((v: unknown) => typeof v === 'string' || typeof v === 'number')\n const allString = enumerators.every((v: unknown) => typeof v === 'string')\n result.type = allString ? 'string' : 'number'\n result.enum = enumerators\n break\n }\n case 'ZodNativeEnum': {\n const values = Object.values(def.values).filter((v) => typeof v === 'string' || typeof v === 'number')\n const allString = values.every((v) => typeof v === 'string')\n result.type = allString ? 'string' : 'number'\n result.enum = values\n break\n }\n case 'ZodUnion':\n case 'union': {\n const options = def.options || []\n result.oneOf = options.map((option: ZodTypeAny) => zodToJsonSchema(option, context) ?? {})\n break\n }\n case 'ZodIntersection':\n case 'intersection': {\n result.allOf = [\n zodToJsonSchema(def.left, context) ?? {},\n zodToJsonSchema(def.right, context) ?? {},\n ]\n break\n }\n case 'ZodPipeline':\n case 'pipe': {\n const resolved = zodToJsonSchema(def.out ?? def.innerType ?? def.schema, context) ?? {}\n Object.assign(result, resolved)\n break\n }\n case 'ZodLazy':\n case 'lazy': {\n const next = typeof def.getter === 'function' ? def.getter() : undefined\n const resolved = next ? zodToJsonSchema(next, context) : undefined\n if (resolved) Object.assign(result, resolved)\n break\n }\n case 'ZodPromise':\n case 'promise': {\n const resolved = zodToJsonSchema(def.type, context)\n if (resolved) Object.assign(result, resolved)\n break\n }\n case 'ZodCatch':\n case 'catch': {\n const resolved = zodToJsonSchema(def.innerType ?? def.type, context)\n if (resolved) Object.assign(result, resolved)\n break\n }\n case 'ZodReadonly':\n case 'readonly': {\n const resolved = zodToJsonSchema(def.innerType ?? def.type, context)\n if (resolved) Object.assign(result, resolved)\n break\n }\n case 'ZodArray':\n case 'array': {\n const elementSchema =\n def.type && typeof def.type === 'object'\n ? def.type\n : (def.element && typeof def.element === 'object' ? def.element : undefined)\n result.type = 'array'\n result.items = zodToJsonSchema(elementSchema as ZodTypeAny, context) ?? {}\n if (typeof def.minLength === 'number') result.minItems = def.minLength\n if (typeof def.maxLength === 'number') result.maxItems = def.maxLength\n const checks = normalizeChecks(def.checks)\n for (const check of checks) {\n if (check.kind === 'min_length' && typeof check.value === 'number') result.minItems = check.value\n if (check.kind === 'max_length' && typeof check.value === 'number') result.maxItems = check.value\n if (check.kind === 'length' && typeof check.value === 'number') {\n result.minItems = check.value\n result.maxItems = check.value\n }\n }\n break\n }\n case 'ZodTuple':\n case 'tuple': {\n const items = def.items || []\n result.type = 'array'\n result.prefixItems = items.map((item: ZodTypeAny) => zodToJsonSchema(item, context) ?? {})\n result.minItems = items.length\n result.maxItems = items.length\n break\n }\n case 'ZodRecord':\n case 'record': {\n result.type = 'object'\n const valueSchema = def.valueType ?? def.value\n const valueType = valueSchema ? resolveType(valueSchema._def) : undefined\n if (!valueType || valueType === 'ZodUnknown' || valueType === 'unknown' || valueType === 'ZodAny' || valueType === 'any') {\n result.additionalProperties = true\n } else {\n result.additionalProperties = zodToJsonSchema(valueSchema, context) ?? true\n }\n break\n }\n case 'ZodObject':\n case 'object': {\n result.type = 'object'\n const shape = getShape(def)\n const properties: Record<string, JsonSchema> = {}\n const required: string[] = []\n for (const [key, rawSchema] of Object.entries(shape)) {\n const unwrapped = unwrap(rawSchema as ZodTypeAny)\n const childSchema = zodToJsonSchema(unwrapped.schema, context)\n if (!childSchema) continue\n const baseSchema = childSchema\n let propertySchema: JsonSchema = baseSchema\n if (unwrapped.nullable) {\n propertySchema = {\n anyOf: [{ type: 'null' }, propertySchema],\n }\n }\n if (unwrapped.defaultValue !== undefined) {\n if (propertySchema === baseSchema) {\n propertySchema = { allOf: [baseSchema], default: unwrapped.defaultValue }\n } else {\n propertySchema = { ...propertySchema, default: unwrapped.defaultValue }\n }\n }\n properties[key] = propertySchema\n if (!unwrapped.optional) required.push(key)\n }\n result.properties = properties\n if (required.length > 0) result.required = required\n if (def.unknownKeys === 'passthrough') {\n result.additionalProperties = true\n } else if (def.catchall) {\n const catchallType = resolveType(def.catchall._def)\n if (catchallType === 'ZodNever' || catchallType === 'never') {\n result.additionalProperties = false\n } else if (!catchallType || catchallType === 'ZodUnknown' || catchallType === 'unknown' || catchallType === 'ZodAny' || catchallType === 'any') {\n result.additionalProperties = true\n } else {\n result.additionalProperties = zodToJsonSchema(def.catchall, context) ?? true\n }\n } else {\n result.additionalProperties = false\n }\n break\n }\n case 'ZodDate':\n case 'date':\n result.type = 'string'\n result.format = 'date-time'\n break\n case 'ZodNull':\n case 'null':\n result.type = 'null'\n break\n case 'ZodVoid':\n case 'void':\n case 'ZodNever':\n case 'never':\n break\n case 'ZodAny':\n case 'any':\n case 'ZodUnknown':\n case 'unknown':\n case 'ZodNaN':\n case 'nan':\n default:\n break\n }\n\n if (nullable) {\n if (result.type && result.type !== 'null') {\n result.nullable = true\n } else if (!result.type) {\n const clone = { ...result }\n result.anyOf = [{ type: 'null' }, clone]\n }\n }\n\n return result\n}\n\nfunction generateExample(schema?: ZodTypeAny, ctx?: ExampleGenerationContext): unknown {\n if (!schema) return undefined\n if ((typeof schema !== 'object' || schema === null) && typeof schema !== 'function') return undefined\n const trackable = schema as object\n const context: ExampleGenerationContext = ctx ?? { stack: new WeakSet<ZodTypeAny>() }\n if (context.stack.has(trackable as ZodTypeAny)) return undefined\n context.stack.add(trackable as ZodTypeAny)\n\n try {\n const { schema: inner, optional, nullable, defaultValue } = unwrap(schema)\n if (!inner) {\n if (defaultValue !== undefined) return defaultValue\n if (nullable) return null\n if (optional) return undefined\n return undefined\n }\n const def = (inner as any)._def\n const typeName = resolveType(def) as string | undefined\n if (defaultValue !== undefined) return defaultValue\n\n if (nullable) return null\n if (optional) return undefined\n\n switch (typeName) {\n case 'ZodString':\n case 'string': {\n const checks = normalizeChecks(def?.checks)\n for (const check of checks) {\n if (!check.kind && !check.extra?.format) continue\n if (check.kind === 'uuid' || check.extra?.format === 'uuid') return DEFAULT_EXAMPLE_VALUES.uuid\n if (check.kind === 'email' || check.extra?.format === 'email') return DEFAULT_EXAMPLE_VALUES.email\n if (check.kind === 'url' || check.extra?.format === 'url' || check.extra?.format === 'uri') return DEFAULT_EXAMPLE_VALUES.url\n if (check.kind === 'datetime' || check.extra?.format === 'date-time') return DEFAULT_EXAMPLE_VALUES.datetime\n }\n return DEFAULT_EXAMPLE_VALUES.string\n }\n case 'ZodNumber':\n case 'number': {\n const checks = normalizeChecks(def?.checks)\n const isInt = checks.some((check) => check.kind === 'int' || check.kind === 'isInteger')\n return isInt ? DEFAULT_EXAMPLE_VALUES.integer : DEFAULT_EXAMPLE_VALUES.number\n }\n case 'ZodBigInt':\n case 'bigint':\n return BigInt(1)\n case 'ZodBoolean':\n case 'boolean':\n return DEFAULT_EXAMPLE_VALUES.boolean\n case 'ZodEnum':\n case 'enum': {\n const entries = def?.values ?? def?.entries\n const values = Array.isArray(entries) ? entries : entries ? Object.values(entries) : []\n return values[0]\n }\n case 'ZodNativeEnum': {\n const values = Object.values(def?.values || [])\n return values[0]\n }\n case 'ZodLiteral':\n case 'literal':\n return def?.value ?? (Array.isArray(def?.values) ? def.values[0] : undefined)\n case 'ZodArray':\n case 'array': {\n const elementSchema =\n def?.type && typeof def.type === 'object'\n ? def.type\n : (def?.element && typeof def.element === 'object' ? def.element : undefined)\n const child = generateExample(elementSchema, context)\n return child === undefined ? [] : [child]\n }\n case 'ZodTuple':\n case 'tuple': {\n const items = def?.items || []\n return items.map((item: ZodTypeAny) => generateExample(item, context))\n }\n case 'ZodObject':\n case 'object': {\n const shape = getShape(def)\n const obj: Record<string, unknown> = {}\n for (const [key, value] of Object.entries(shape)) {\n const example = generateExample(value as ZodTypeAny, context)\n if (example !== undefined) obj[key] = example\n }\n return obj\n }\n case 'ZodRecord':\n case 'record': {\n const valueExample = generateExample(def?.valueType ?? def?.value, context)\n return valueExample === undefined ? {} : { key: valueExample }\n }\n case 'ZodUnion':\n case 'union': {\n const options = def?.options || []\n return options.length ? generateExample(options[0], context) : undefined\n }\n case 'ZodPipeline':\n case 'pipe':\n return generateExample(def?.out ?? def?.innerType ?? def?.schema, context)\n case 'ZodLazy':\n case 'lazy': {\n const next = typeof def?.getter === 'function' ? def.getter() : undefined\n return next ? generateExample(next, context) : undefined\n }\n case 'ZodPromise':\n case 'promise':\n return generateExample(def?.type, context)\n case 'ZodCatch':\n case 'catch':\n return generateExample(def?.innerType ?? def?.type, context)\n case 'ZodReadonly':\n case 'readonly':\n return generateExample(def?.innerType ?? def?.type, context)\n case 'ZodIntersection':\n case 'intersection': {\n const left = generateExample(def?.left, context)\n const right = generateExample(def?.right, context)\n if (typeof left === 'object' && left && typeof right === 'object' && right) {\n return { ...(left as object), ...(right as object) }\n }\n return left ?? right\n }\n case 'ZodDate':\n case 'date':\n return DEFAULT_EXAMPLE_VALUES.datetime\n default:\n return undefined\n }\n } finally {\n context.stack.delete(trackable as ZodTypeAny)\n }\n}\n\nfunction buildParameters(\n schema: ZodTypeAny | undefined,\n location: ParameterLocation,\n pathParamNames?: PathParamInfo[]\n): Array<Record<string, unknown>> {\n if (!schema && location !== 'path') return []\n\n const params: Array<Record<string, unknown>> = []\n\n if (location === 'path' && pathParamNames && pathParamNames.length) {\n const merged = mergePathParamSchemas(schema, pathParamNames)\n for (const { name, schema: paramSchema, optional } of merged) {\n const jsonSchema = zodToJsonSchema(paramSchema)\n const example = generateExample(paramSchema)\n const description = extractZodDescription(paramSchema)\n params.push({\n name,\n in: 'path',\n required: !optional,\n schema: jsonSchema ?? { type: 'string' },\n example,\n ...(description ? { description } : {}),\n })\n }\n return params\n }\n\n if (!schema) return params\n\n const { schema: unwrapped } = unwrap(schema)\n if (!unwrapped) return params\n const def = (unwrapped as any)._def\n const typeName = resolveType(def) as string | undefined\n if (typeName === 'ZodObject' || typeName === 'object') {\n const shape = getShape(def)\n for (const [key, raw] of Object.entries(shape)) {\n const details = unwrap(raw as ZodTypeAny)\n if (!details.schema) continue\n const jsonSchema = zodToJsonSchema(details.schema)\n const example = generateExample(details.schema)\n const description = extractZodDescription(raw as ZodTypeAny)\n params.push({\n name: key,\n in: location,\n required: location === 'path' ? true : !details.optional,\n schema: jsonSchema ?? {},\n example,\n ...(description ? { description } : {}),\n })\n }\n } else {\n const jsonSchema = zodToJsonSchema(unwrapped)\n const example = generateExample(unwrapped)\n const description = extractZodDescription(unwrapped)\n params.push({\n name: location === 'header' ? 'X-Custom-Header' : 'value',\n in: location,\n required: location === 'path',\n schema: jsonSchema ?? {},\n example,\n ...(description ? { description } : {}),\n })\n }\n\n return params\n}\n\nfunction mergePathParamSchemas(schema: ZodTypeAny | undefined, params: PathParamInfo[]) {\n const merged: Array<{ name: string; schema: ZodTypeAny | undefined; optional: boolean }> = []\n const map: Record<string, ZodTypeAny> = {}\n if (schema) {\n const { schema: unwrapped } = unwrap(schema)\n if (unwrapped && (unwrapped as any)._def && (resolveType((unwrapped as any)._def) === 'ZodObject' || resolveType((unwrapped as any)._def) === 'object')) {\n const shape = getShape((unwrapped as any)._def)\n for (const [key, value] of Object.entries(shape)) {\n map[key] = value as ZodTypeAny\n }\n }\n }\n for (const param of params) {\n merged.push({\n name: param.name,\n schema: map[param.name],\n optional: !!param.optional,\n })\n }\n return merged\n}\n\nfunction buildRequestBody(request?: OpenApiRequestBodyDoc): Record<string, unknown> | undefined {\n if (!request) return undefined\n const schema = zodToJsonSchema(request.schema)\n const example = request.example ?? generateExample(request.schema)\n const contentType = request.contentType ?? 'application/json'\n return {\n required: true,\n content: {\n [contentType]: {\n schema: schema ?? {},\n example,\n },\n },\n description: request.description,\n }\n}\n\nfunction buildResponses(\n method: HttpMethod,\n responses?: OpenApiResponseDoc[],\n errors?: OpenApiResponseDoc[],\n metadata?: any\n): Record<string, unknown> {\n const entries: Record<string, unknown> = {}\n const list = [...(responses ?? [])]\n const errorList = [...(errors ?? [])]\n const inferredList: OpenApiResponseDoc[] = []\n if (metadata?.requireAuth) {\n inferredList.push({\n status: 401,\n description: 'Unauthorized',\n schema: z.object({ error: z.string() }),\n xAutoGenerated: true,\n })\n }\n if (Array.isArray(metadata?.requireFeatures) && metadata.requireFeatures.length) {\n inferredList.push({\n status: 403,\n description: 'Forbidden \u2013 missing required features',\n schema: z.object({ error: z.string() }),\n xAutoGenerated: true,\n })\n }\n if (!list.some((res) => res.status >= 200 && res.status < 300)) {\n const fallbackStatus = method === 'POST' ? 201 : method === 'DELETE' ? 204 : 200\n list.push({\n status: fallbackStatus,\n description: fallbackStatus === 204 ? 'Success' : 'Success response',\n })\n }\n const setEntry = (res: OpenApiResponseDoc, options?: { skipIfPresent?: boolean }) => {\n const status = String(res.status || 200)\n if (options?.skipIfPresent && Object.prototype.hasOwnProperty.call(entries, status)) return\n const mediaType = res.mediaType ?? 'application/json'\n const schema = res.schema ? zodToJsonSchema(res.schema) : undefined\n const example = res.schema ? res.example ?? generateExample(res.schema) : res.example\n const isNoContent = res.status === 204\n entries[status] = {\n description: res.description ?? '',\n ...(isNoContent\n ? {}\n : {\n content: {\n [mediaType]: {\n schema: schema ?? { type: 'object' },\n ...(example !== undefined ? { example } : {}),\n },\n },\n }),\n ...(res.xAutoGenerated ? { 'x-autoGenerated': true } : {}),\n }\n }\n for (const res of [...list, ...errorList]) setEntry(res)\n for (const res of inferredList) setEntry(res, { skipIfPresent: true })\n return entries\n}\n\nfunction buildSecurity(metadata: any, methodDoc?: OpenApiMethodDoc, defaults?: string[]) {\n const securitySchemes = new Set<string>()\n if (Array.isArray(methodDoc?.security)) methodDoc.security.forEach((s) => securitySchemes.add(s))\n if (metadata?.requireAuth) securitySchemes.add('bearerAuth')\n if (defaults) defaults.forEach((s) => securitySchemes.add(s))\n if (securitySchemes.size === 0) return undefined\n return Array.from(securitySchemes.values()).map((scheme) => ({ [scheme]: [] }))\n}\n\nfunction collectExamples(\n querySchema?: ZodTypeAny,\n bodySchema?: ZodTypeAny,\n pathSchema?: ZodTypeAny,\n headerSchema?: ZodTypeAny,\n metadata?: any\n): ExampleMap {\n const examples: ExampleMap = {}\n const queryExample = querySchema ? generateExample(querySchema) : undefined\n if (queryExample && typeof queryExample === 'object') examples.query = queryExample\n const bodyExample = bodySchema ? generateExample(bodySchema) : undefined\n if (bodyExample !== undefined) examples.body = bodyExample\n const pathExample = pathSchema ? generateExample(pathSchema) : undefined\n if (pathExample && typeof pathExample === 'object') examples.path = pathExample as Record<string, unknown>\n const headerExample = headerSchema ? generateExample(headerSchema) : undefined\n if (headerExample && typeof headerExample === 'object') examples.headers = headerExample as Record<string, unknown>\n if (metadata?.requireAuth) {\n if (!examples.headers) examples.headers = {}\n if (typeof examples.headers.authorization !== 'string') {\n examples.headers.authorization = 'Bearer <token>'\n }\n }\n return examples\n}\n\nfunction toFormUrlEncoded(value: unknown): string {\n if (!value || typeof value !== 'object') return ''\n const params = new URLSearchParams()\n for (const [key, raw] of Object.entries(value as Record<string, unknown>)) {\n if (raw === undefined) continue\n params.append(key, raw === null ? '' : String(raw))\n }\n return params.toString()\n}\n\nfunction stringifyBodyExample(value: unknown, mediaType?: string): string {\n if (value === undefined) return ''\n if (mediaType === 'application/x-www-form-urlencoded') {\n return toFormUrlEncoded(value)\n }\n if (!mediaType || mediaType === 'application/json') {\n try {\n return JSON.stringify(value, null, 2)\n } catch {\n return ''\n }\n }\n if (typeof value === 'string') return value\n try {\n return JSON.stringify(value, null, 2)\n } catch {\n return String(value)\n }\n}\n\nfunction buildQueryString(example: unknown): string {\n if (!example || typeof example !== 'object') return ''\n const parts: string[] = []\n for (const [key, value] of Object.entries(example as Record<string, unknown>)) {\n if (value === undefined || value === null) continue\n const encoded = encodeURIComponent(String(value))\n parts.push(`${encodeURIComponent(key)}=${encoded}`)\n }\n return parts.length ? `?${parts.join('&')}` : ''\n}\n\nfunction injectPathExamples(path: string, params: PathParamInfo[], examples?: Record<string, unknown>): string {\n if (!params.length) return path\n let result = path\n for (const param of params) {\n const placeholder = `{${param.name}}`\n const example = examples && examples[param.name] !== undefined ? examples[param.name] : `:${param.name}`\n result = result.replace(placeholder, String(example))\n }\n return result\n}\n\nfunction buildCurlSample(\n method: HttpMethod,\n path: string,\n params: PathParamInfo[],\n examples: ExampleMap,\n baseUrl: string,\n metadata: any,\n requestBody?: OpenApiRequestBodyDoc\n): string {\n const lines: string[] = []\n const pathWithExamples = injectPathExamples(path, params, examples.path)\n const query = buildQueryString(examples.query)\n const url = baseUrl.replace(/\\/$/, '') + pathWithExamples + query\n lines.push(`curl -X ${method} \"${url}\"`)\n\n lines.push(' -H \"Accept: application/json\"')\n\n const headers: Record<string, unknown> = { ...(examples.headers ?? {}) }\n if (metadata?.requireAuth && !headers.Authorization && !headers.authorization) {\n headers.Authorization = 'Bearer <token>'\n }\n for (const [key, value] of Object.entries(headers)) {\n lines.push(` -H \"${key.replace(/\"/g, '')}: ${String(value).replace(/\"/g, '')}\"`)\n }\n\n const bodyExample = examples.body ?? requestBody?.example\n const requestContentType = requestBody?.contentType ?? 'application/json'\n if (bodyExample !== undefined) {\n lines.push(` -H \"Content-Type: ${requestContentType}\"`)\n const serialized = stringifyBodyExample(bodyExample, requestContentType)\n if (serialized) {\n const escapedSerialized = escapeShellDoubleQuotes(serialized)\n lines.push(` -d \"${escapedSerialized}\"`)\n }\n }\n\n return lines.join(' \\\\\\n')\n}\n\nfunction escapeShellDoubleQuotes(value: string): string {\n return value.replace(/[\\\\`\"$]/g, '\\\\$&')\n}\n\nfunction ensureSecurityComponents(doc: OpenApiDocument) {\n if (!doc.components) doc.components = {}\n if (!doc.components.securitySchemes) doc.components.securitySchemes = {}\n if (!doc.components.securitySchemes.bearerAuth) {\n doc.components.securitySchemes.bearerAuth = {\n type: 'http',\n scheme: 'bearer',\n bearerFormat: 'JWT',\n description: 'Send an `Authorization: Bearer <token>` header with a valid API token.',\n }\n }\n}\n\nfunction resolveOperationId(moduleId: string, path: string, method: HttpMethod): string {\n const cleaned = normalizeOperationIdSegment(path)\n return [moduleId, method.toLowerCase(), cleaned].filter(Boolean).join('_')\n}\n\nfunction normalizeOperationIdSegment(input: string): string {\n let output = ''\n let previousUnderscore = false\n\n for (const character of input) {\n const codePoint = character.charCodeAt(0)\n const isLower = codePoint >= 97 && codePoint <= 122\n const isUpper = codePoint >= 65 && codePoint <= 90\n const isNumber = codePoint >= 48 && codePoint <= 57\n const isAlphaNumeric = isLower || isUpper || isNumber\n\n if (isAlphaNumeric) {\n output += character\n previousUnderscore = false\n continue\n }\n\n if (!previousUnderscore) {\n output += '_'\n previousUnderscore = true\n }\n }\n\n while (output.startsWith('_')) output = output.slice(1)\n while (output.endsWith('_')) output = output.slice(0, -1)\n\n return output\n}\n\nfunction collectRouteDoc(api: ModuleApi, moduleId: string): OpenApiRouteDoc | undefined {\n if ('handlers' in api) {\n const route = api as ModuleApiRouteFile & { docs?: OpenApiRouteDoc }\n if (route.docs) return route.docs\n const maybe = (route.handlers as any)?.openApi\n if (maybe && typeof maybe === 'object') return maybe as OpenApiRouteDoc\n } else {\n const legacy = api as ModuleApiLegacy & { docs?: OpenApiMethodDoc }\n if (legacy.docs) {\n return {\n methods: { [legacy.method]: legacy.docs },\n }\n }\n const maybe = (legacy.handler as any)?.openApi\n if (maybe && typeof maybe === 'object') {\n return {\n methods: { [legacy.method]: maybe as OpenApiMethodDoc },\n }\n }\n }\n return undefined\n}\n\nexport function buildOpenApiDocument(modules: Module[], options: OpenApiDocumentOptions = {}): OpenApiDocument {\n const doc: OpenApiDocument = {\n openapi: '3.1.0',\n info: {\n title: options.title ?? 'Open Mercato API',\n version: options.version ?? '1.0.0',\n description: options.description,\n },\n servers: options.servers,\n paths: {},\n }\n\n ensureSecurityComponents(doc)\n\n const includeAccessControlMetadata = options.includeAccessControlMetadata !== false\n const tags = new Map<string, string | undefined>()\n\n for (const moduleEntry of modules) {\n const defaultTag = moduleEntry.info?.title ?? toTitle(moduleEntry.id)\n if (defaultTag) tags.set(defaultTag, moduleEntry.info?.description)\n\n const apis = moduleEntry.apis ?? []\n for (const api of apis) {\n const routeDoc = collectRouteDoc(api, moduleEntry.id)\n const moduleTag = routeDoc?.tag ?? defaultTag\n const normalized = normalizePath((api as any).path ?? (api as any).path ?? '')\n const pathKey = normalized.path\n if (!doc.paths[pathKey]) doc.paths[pathKey] = {}\n const availableMethods: HttpMethod[] =\n 'handlers' in api\n ? HTTP_METHODS.filter((method) => typeof (api as ModuleApiRouteFile).handlers?.[method] === 'function')\n : [api.method as HttpMethod]\n\n for (const method of availableMethods) {\n const methodLower = method.toLowerCase() as Lowercase<HttpMethod>\n const existing = doc.paths[pathKey][methodLower]\n if (existing) continue\n\n const metadata = 'handlers' in api ? (api as ModuleApiRouteFile).metadata?.[method] : undefined\n const methodDoc = routeDoc?.methods?.[method]\n const summary = methodDoc?.summary ?? routeDoc?.summary ?? `${method} ${pathKey}`\n const baseDescription = methodDoc?.description ?? routeDoc?.description\n const meta = metadata && typeof metadata === 'object' ? (metadata as Record<string, unknown>) : undefined\n const requireFeatures = Array.isArray(meta?.['requireFeatures'])\n ? (meta!['requireFeatures'] as string[])\n : undefined\n const requireRoles = Array.isArray(meta?.['requireRoles'])\n ? (meta!['requireRoles'] as string[])\n : undefined\n const requireAuth = meta?.['requireAuth'] === true\n const descriptionParts: string[] = []\n if (baseDescription) descriptionParts.push(baseDescription)\n if (includeAccessControlMetadata && Array.isArray(requireFeatures) && requireFeatures.length) {\n descriptionParts.push(`Requires features: ${requireFeatures.join(', ')}`)\n }\n if (includeAccessControlMetadata && Array.isArray(requireRoles) && requireRoles.length) {\n descriptionParts.push(`Requires roles: ${requireRoles.join(', ')}`)\n }\n\n const querySchema = methodDoc?.query\n const pathSchema = methodDoc?.pathParams ?? routeDoc?.pathParams\n const headerSchema = methodDoc?.headers\n const requestBody = methodDoc?.requestBody\n const examples = collectExamples(querySchema, requestBody?.schema, pathSchema, headerSchema, metadata)\n const curlSample = buildCurlSample(\n method,\n pathKey,\n normalized.params,\n examples,\n options.baseUrlForExamples ?? 'https://api.open-mercato.local',\n metadata,\n requestBody\n )\n\n doc.paths[pathKey][methodLower] = {\n operationId: methodDoc?.operationId ?? resolveOperationId(moduleEntry.id, pathKey, method),\n summary,\n description: descriptionParts.length ? descriptionParts.join('\\n\\n') : undefined,\n tags: methodDoc?.tags ?? (moduleTag ? [moduleTag] : undefined),\n deprecated: methodDoc?.deprecated,\n externalDocs: methodDoc?.externalDocs,\n parameters: [\n ...buildParameters(pathSchema, 'path', normalized.params),\n ...buildParameters(querySchema, 'query'),\n ...buildParameters(headerSchema, 'header'),\n ].filter(Boolean),\n requestBody: buildRequestBody(requestBody),\n responses: buildResponses(method, methodDoc?.responses, methodDoc?.errors, metadata),\n security: buildSecurity(metadata, methodDoc, options.defaultSecurity),\n 'x-codeSamples': methodDoc?.codeSamples ?? [\n {\n lang: 'curl',\n label: 'cURL',\n source: curlSample,\n },\n ],\n ...(includeAccessControlMetadata && Array.isArray(requireFeatures) && requireFeatures.length\n ? { 'x-require-features': requireFeatures }\n : {}),\n ...(includeAccessControlMetadata && Array.isArray(requireRoles) && requireRoles.length\n ? { 'x-require-roles': requireRoles }\n : {}),\n ...(requireAuth ? { 'x-require-auth': true } : {}),\n ...(methodDoc?.extensions ?? {}),\n }\n }\n }\n }\n\n doc.tags = Array.from(tags.entries()).map(([name, description]) => ({\n name,\n description: description ?? undefined,\n }))\n\n return doc\n}\n\nfunction formatMarkdownTable(rows: Array<[string, string, string, string]>): string {\n if (!rows.length) return ''\n const header = ['Name', 'Location', 'Type', 'Description']\n const align = ['---', '---', '---', '---']\n const lines = [\n `| ${header.join(' | ')} |`,\n `| ${align.join(' | ')} |`,\n ...rows.map((row) => `| ${row.join(' | ')} |`),\n ]\n return lines.join('\\n')\n}\n\nfunction schemaTypeLabel(schema: any): string {\n if (!schema) return 'any'\n if (schema.type) return schema.type\n if (schema.oneOf) return schema.oneOf.map(schemaTypeLabel).join(' | ')\n if (schema.allOf) return schema.allOf.map(schemaTypeLabel).join(' & ')\n return 'any'\n}\n\nfunction schemaHasDetails(schema: unknown): boolean {\n if (!schema || typeof schema !== 'object') return false\n const schemaObj = schema as Record<string, unknown>\n if (Array.isArray(schemaObj.enum) && schemaObj.enum.length) return true\n if (schemaObj.const !== undefined) return true\n if (typeof schemaObj.format === 'string') return true\n if (Array.isArray(schemaObj.oneOf) && schemaObj.oneOf.some((s: unknown) => schemaHasDetails(s))) return true\n if (Array.isArray(schemaObj.anyOf) && schemaObj.anyOf.some((s: unknown) => schemaHasDetails(s))) return true\n if (Array.isArray(schemaObj.allOf) && schemaObj.allOf.some((s: unknown) => schemaHasDetails(s))) return true\n if (schemaObj.items && schemaHasDetails(schemaObj.items)) return true\n if (schemaObj.properties && Object.keys(schemaObj.properties as Record<string, unknown>).length) return true\n if (Array.isArray(schemaObj.prefixItems) && schemaObj.prefixItems.some((s: unknown) => schemaHasDetails(s))) return true\n if (schemaObj.type && schemaObj.type !== 'object') return true\n return false\n}\n\ntype ContentSelection = {\n mediaType: string\n entry: any\n}\n\ntype DisplaySnippet = {\n value: string\n language: string\n}\n\nfunction selectContentVariant(content?: Record<string, any>): ContentSelection | undefined {\n if (!content) return undefined\n const entries = Object.entries(content)\n if (!entries.length) return undefined\n const preferred = [\n 'application/json',\n 'application/x-www-form-urlencoded',\n 'multipart/form-data',\n 'text/plain',\n ]\n for (const mediaType of preferred) {\n const match = entries.find(([type]) => type === mediaType)\n if (match) {\n const [selectedType, entry] = match\n return { mediaType: selectedType, entry }\n }\n }\n const [mediaType, entry] = entries[0]\n return { mediaType, entry }\n}\n\nfunction formatExampleForDisplay(example: unknown, mediaType?: string): DisplaySnippet | null {\n if (example === undefined) return null\n if (mediaType === 'application/x-www-form-urlencoded') {\n const encoded = toFormUrlEncoded(example)\n if (!encoded) return null\n return { value: encoded, language: 'text' }\n }\n if (mediaType === 'multipart/form-data') {\n if (example && typeof example === 'object') {\n const lines = Object.entries(example as Record<string, unknown>).map(([key, value]) => {\n const rendered = value === undefined || value === null ? '' : String(value)\n return `${key}=${rendered}`\n })\n if (lines.length) {\n return { value: lines.join('\\n'), language: 'text' }\n }\n }\n if (typeof example === 'string') {\n return { value: example, language: 'text' }\n }\n }\n if (!mediaType || mediaType === 'application/json') {\n try {\n return { value: JSON.stringify(example, null, 2), language: 'json' }\n } catch {\n return null\n }\n }\n if (typeof example === 'string') {\n return { value: example, language: 'text' }\n }\n try {\n return { value: JSON.stringify(example, null, 2), language: 'json' }\n } catch {\n return { value: String(example), language: 'text' }\n }\n}\n\nfunction formatSchemaForDisplay(schema: any): DisplaySnippet | null {\n if (!schema) return null\n try {\n return { value: JSON.stringify(schema, null, 2), language: 'json' }\n } catch {\n return null\n }\n}\n\nexport function generateMarkdownFromOpenApi(doc: OpenApiDocument): string {\n const lines: string[] = []\n lines.push(`# ${doc.info.title}`)\n lines.push('')\n lines.push(`Version: ${doc.info.version}`)\n if (doc.info.description) {\n lines.push('')\n lines.push(doc.info.description)\n }\n if (doc.servers && doc.servers.length) {\n lines.push('')\n lines.push('## Servers')\n for (const server of doc.servers) {\n lines.push(`- ${server.url}${server.description ? ` \u2013 ${server.description}` : ''}`)\n }\n }\n\n const sortedPaths = Object.keys(doc.paths).sort((a, b) => a.localeCompare(b))\n for (const path of sortedPaths) {\n const operations = doc.paths[path]\n const methods = Object.keys(operations).sort((a, b) => a.localeCompare(b))\n for (const method of methods) {\n const op: any = operations[method]\n lines.push('')\n lines.push(`## ${method.toUpperCase()} \\`${path}\\``)\n if (op.summary) {\n lines.push('')\n lines.push(op.summary)\n }\n if (op.description) {\n lines.push('')\n lines.push(op.description)\n }\n if (op.tags && op.tags.length) {\n lines.push('')\n lines.push(`**Tags:** ${op.tags.join(', ')}`)\n }\n if (op['x-require-auth']) {\n lines.push('')\n lines.push(`**Requires authentication.**`)\n }\n if (op['x-require-features']) {\n lines.push('')\n lines.push(`**Features:** ${(op['x-require-features'] as string[]).join(', ')}`)\n }\n if (op['x-require-roles']) {\n lines.push('')\n lines.push(`**Roles:** ${(op['x-require-roles'] as string[]).join(', ')}`)\n }\n\n const parameters = (op.parameters as any[]) ?? []\n if (parameters.length) {\n lines.push('')\n lines.push('### Parameters')\n const rows: Array<[string, string, string, string]> = parameters.map((p) => {\n const requiredLabel = p.required ? 'Required' : 'Optional'\n const descriptionParts = [requiredLabel, p.description].filter(Boolean)\n return [\n p.name,\n p.in,\n schemaTypeLabel(p.schema),\n descriptionParts.join('. '),\n ]\n })\n lines.push(formatMarkdownTable(rows))\n }\n\n if (op.requestBody) {\n const selection = selectContentVariant(op.requestBody.content)\n if (selection) {\n const { mediaType, entry } = selection\n const example = entry?.example ?? entry?.examples?.default?.value\n const formatted = formatExampleForDisplay(example, mediaType)\n const schemaFormatted =\n entry?.schema && schemaHasDetails(entry.schema) ? formatSchemaForDisplay(entry.schema) : null\n lines.push('')\n lines.push('### Request Body')\n lines.push('')\n lines.push(`Content-Type: \\`${mediaType}\\``)\n if (formatted) {\n lines.push('')\n lines.push(`\\`\\`\\`${formatted.language}`)\n lines.push(formatted.value)\n lines.push('```')\n } else if (schemaFormatted) {\n lines.push('')\n lines.push(`\\`\\`\\`${schemaFormatted.language}`)\n lines.push(schemaFormatted.value)\n lines.push('```')\n } else {\n lines.push('')\n lines.push('No example available for this content type.')\n }\n }\n }\n\n const responses = op.responses ?? {}\n const responseStatuses = Object.keys(responses).sort((a, b) => a.localeCompare(b))\n if (responseStatuses.length) {\n lines.push('')\n lines.push('### Responses')\n for (const status of responseStatuses) {\n const response = responses[status]\n if (response?.['x-autoGenerated']) continue\n lines.push('')\n lines.push(`**${status}** \u2013 ${response.description || 'Response'}`)\n const selection = selectContentVariant(response.content)\n if (selection) {\n const { mediaType, entry } = selection\n const example = entry?.example ?? entry?.examples?.default?.value\n const formatted = formatExampleForDisplay(example, mediaType)\n const schemaFormatted =\n entry?.schema && schemaHasDetails(entry.schema) ? formatSchemaForDisplay(entry.schema) : null\n lines.push('')\n lines.push(`Content-Type: \\`${mediaType}\\``)\n if (formatted) {\n lines.push('')\n lines.push(`\\`\\`\\`${formatted.language}`)\n lines.push(formatted.value)\n lines.push('```')\n } else if (schemaFormatted) {\n lines.push('')\n lines.push(`\\`\\`\\`${schemaFormatted.language}`)\n lines.push(schemaFormatted.value)\n lines.push('```')\n }\n }\n }\n }\n\n const samples = op['x-codeSamples'] as any[] | undefined\n if (samples && samples.length) {\n const curl = samples.find((sample) => String(sample.lang).toLowerCase() === 'curl') ?? samples[0]\n if (curl?.source) {\n lines.push('')\n lines.push('### Example')\n lines.push('')\n lines.push('```bash')\n lines.push(curl.source)\n lines.push('```')\n }\n }\n }\n }\n\n return lines.join('\\n')\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": ["mediaType", "entry"]
|
|
7
7
|
}
|
|
@@ -3,11 +3,19 @@ import { z } from "zod";
|
|
|
3
3
|
const RATE_LIMIT_ERROR_KEY = "api.errors.rateLimit";
|
|
4
4
|
const RATE_LIMIT_ERROR_FALLBACK = "Too many requests. Please try again later.";
|
|
5
5
|
const RATE_LIMIT_FALLBACK_KEY = "global";
|
|
6
|
+
const RATE_LIMIT_UNAVAILABLE_KEY = "api.errors.rateLimitUnavailable";
|
|
7
|
+
const RATE_LIMIT_UNAVAILABLE_FALLBACK = "Service temporarily unavailable. Please try again later.";
|
|
6
8
|
const rateLimitErrorSchema = z.object({
|
|
7
9
|
error: z.string().describe("Rate limit exceeded message")
|
|
8
10
|
});
|
|
9
|
-
async function checkRateLimit(rateLimiterService, config, key, errorMessage) {
|
|
11
|
+
async function checkRateLimit(rateLimiterService, config, key, errorMessage, options = {}) {
|
|
10
12
|
const result = await rateLimiterService.consume(key, config);
|
|
13
|
+
if (result.degraded && options.failClosed) {
|
|
14
|
+
return NextResponse.json(
|
|
15
|
+
{ error: options.unavailableMessage ?? RATE_LIMIT_UNAVAILABLE_FALLBACK },
|
|
16
|
+
{ status: 503 }
|
|
17
|
+
);
|
|
18
|
+
}
|
|
11
19
|
if (!result.allowed) {
|
|
12
20
|
const retryAfterSec = Math.ceil(result.msBeforeNext / 1e3);
|
|
13
21
|
return NextResponse.json(
|
|
@@ -41,6 +49,8 @@ export {
|
|
|
41
49
|
RATE_LIMIT_ERROR_FALLBACK,
|
|
42
50
|
RATE_LIMIT_ERROR_KEY,
|
|
43
51
|
RATE_LIMIT_FALLBACK_KEY,
|
|
52
|
+
RATE_LIMIT_UNAVAILABLE_FALLBACK,
|
|
53
|
+
RATE_LIMIT_UNAVAILABLE_KEY,
|
|
44
54
|
checkRateLimit,
|
|
45
55
|
getClientIp,
|
|
46
56
|
rateLimitErrorSchema
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../src/lib/ratelimit/helpers.ts"],
|
|
4
|
-
"sourcesContent": ["import { NextResponse } from 'next/server'\nimport { z } from 'zod'\nimport type { RateLimitConfig } from './types'\nimport type { RateLimiterService } from './service'\n\nexport const RATE_LIMIT_ERROR_KEY = 'api.errors.rateLimit'\nexport const RATE_LIMIT_ERROR_FALLBACK = 'Too many requests. Please try again later.'\nexport const RATE_LIMIT_FALLBACK_KEY = 'global'\n\nexport const rateLimitErrorSchema = z.object({\n error: z.string().describe('Rate limit exceeded message'),\n})\n\n/**\n * Check rate limit for a request. Returns a 429 NextResponse if rate limited, or null if allowed.\n * Rate limit headers (X-RateLimit-*, Retry-After) are only included on 429 responses.\n */\nexport async function checkRateLimit(\n rateLimiterService: RateLimiterService,\n config: RateLimitConfig,\n key: string,\n errorMessage: string,\n): Promise<NextResponse | null> {\n const result = await rateLimiterService.consume(key, config)\n\n if (!result.allowed) {\n const retryAfterSec = Math.ceil(result.msBeforeNext / 1000)\n return NextResponse.json(\n { error: errorMessage },\n {\n status: 429,\n headers: {\n 'Retry-After': String(retryAfterSec),\n 'X-RateLimit-Limit': String(config.points),\n 'X-RateLimit-Remaining': String(result.remainingPoints),\n 'X-RateLimit-Reset': String(retryAfterSec),\n },\n },\n )\n }\n\n return null\n}\n\n/**\n * Extract client IP from a request, respecting reverse proxy trust depth.\n *\n * @param trustProxyDepth Number of trusted reverse proxies between the client and the app.\n * - 0 (default): Do not trust proxy-provided IP headers; return null.\n * - 1: One trusted proxy (e.g. nginx) \u2014 the last entry in X-Forwarded-For is the client IP;\n * X-Real-IP is accepted only as a single-proxy fallback when X-Forwarded-For is absent.\n * - N: N trusted proxies \u2014 the Nth-from-last entry is the client IP. If the\n * forwarded chain is shorter than N, return null rather than trusting an\n * attacker-controlled entry.\n *\n * With depth=0, X-Forwarded-For and X-Real-IP are ignored entirely to prevent spoofing.\n */\nexport function getClientIp(req: Request, trustProxyDepth: number = 0): string | null {\n const forwarded = req.headers.get('x-forwarded-for')\n if (!Number.isInteger(trustProxyDepth) || trustProxyDepth <= 0) {\n return null\n }\n\n if (forwarded) {\n const ips = forwarded.split(',').map((ip) => ip.trim())\n const clientIndex = ips.length - trustProxyDepth\n return clientIndex >= 0 ? ips[clientIndex] || null : null\n }\n return trustProxyDepth === 1 ? req.headers.get('x-real-ip')?.trim() || null : null\n}\n"],
|
|
5
|
-
"mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS;AAIX,MAAM,uBAAuB;AAC7B,MAAM,4BAA4B;AAClC,MAAM,0BAA0B;
|
|
4
|
+
"sourcesContent": ["import { NextResponse } from 'next/server'\nimport { z } from 'zod'\nimport type { RateLimitConfig } from './types'\nimport type { RateLimiterService } from './service'\n\nexport const RATE_LIMIT_ERROR_KEY = 'api.errors.rateLimit'\nexport const RATE_LIMIT_ERROR_FALLBACK = 'Too many requests. Please try again later.'\nexport const RATE_LIMIT_FALLBACK_KEY = 'global'\nexport const RATE_LIMIT_UNAVAILABLE_KEY = 'api.errors.rateLimitUnavailable'\nexport const RATE_LIMIT_UNAVAILABLE_FALLBACK = 'Service temporarily unavailable. Please try again later.'\n\nexport const rateLimitErrorSchema = z.object({\n error: z.string().describe('Rate limit exceeded message'),\n})\n\nexport type CheckRateLimitOptions = {\n /**\n * Reject with 503 when the limiter could not reach its backing store, instead of\n * letting the request through uncounted. Use on state-mutating endpoints, where an\n * unenforced limit is worse than a rejected request.\n */\n failClosed?: boolean\n /** Body message for the 503 emitted by `failClosed`. */\n unavailableMessage?: string\n}\n\n/**\n * Check rate limit for a request. Returns a 429 NextResponse if rate limited, or null if allowed.\n * Rate limit headers (X-RateLimit-*, Retry-After) are only included on 429 responses.\n *\n * With `options.failClosed`, a degraded limiter (backing store unreachable) yields a 503\n * instead of an allowed request. Without it the call behaves exactly as before and fails open.\n */\nexport async function checkRateLimit(\n rateLimiterService: RateLimiterService,\n config: RateLimitConfig,\n key: string,\n errorMessage: string,\n options: CheckRateLimitOptions = {},\n): Promise<NextResponse | null> {\n const result = await rateLimiterService.consume(key, config)\n\n if (result.degraded && options.failClosed) {\n return NextResponse.json(\n { error: options.unavailableMessage ?? RATE_LIMIT_UNAVAILABLE_FALLBACK },\n { status: 503 },\n )\n }\n\n if (!result.allowed) {\n const retryAfterSec = Math.ceil(result.msBeforeNext / 1000)\n return NextResponse.json(\n { error: errorMessage },\n {\n status: 429,\n headers: {\n 'Retry-After': String(retryAfterSec),\n 'X-RateLimit-Limit': String(config.points),\n 'X-RateLimit-Remaining': String(result.remainingPoints),\n 'X-RateLimit-Reset': String(retryAfterSec),\n },\n },\n )\n }\n\n return null\n}\n\n/**\n * Extract client IP from a request, respecting reverse proxy trust depth.\n *\n * @param trustProxyDepth Number of trusted reverse proxies between the client and the app.\n * - 0 (default): Do not trust proxy-provided IP headers; return null.\n * - 1: One trusted proxy (e.g. nginx) \u2014 the last entry in X-Forwarded-For is the client IP;\n * X-Real-IP is accepted only as a single-proxy fallback when X-Forwarded-For is absent.\n * - N: N trusted proxies \u2014 the Nth-from-last entry is the client IP. If the\n * forwarded chain is shorter than N, return null rather than trusting an\n * attacker-controlled entry.\n *\n * With depth=0, X-Forwarded-For and X-Real-IP are ignored entirely to prevent spoofing.\n */\nexport function getClientIp(req: Request, trustProxyDepth: number = 0): string | null {\n const forwarded = req.headers.get('x-forwarded-for')\n if (!Number.isInteger(trustProxyDepth) || trustProxyDepth <= 0) {\n return null\n }\n\n if (forwarded) {\n const ips = forwarded.split(',').map((ip) => ip.trim())\n const clientIndex = ips.length - trustProxyDepth\n return clientIndex >= 0 ? ips[clientIndex] || null : null\n }\n return trustProxyDepth === 1 ? req.headers.get('x-real-ip')?.trim() || null : null\n}\n"],
|
|
5
|
+
"mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS;AAIX,MAAM,uBAAuB;AAC7B,MAAM,4BAA4B;AAClC,MAAM,0BAA0B;AAChC,MAAM,6BAA6B;AACnC,MAAM,kCAAkC;AAExC,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,OAAO,EAAE,OAAO,EAAE,SAAS,6BAA6B;AAC1D,CAAC;AAoBD,eAAsB,eACpB,oBACA,QACA,KACA,cACA,UAAiC,CAAC,GACJ;AAC9B,QAAM,SAAS,MAAM,mBAAmB,QAAQ,KAAK,MAAM;AAE3D,MAAI,OAAO,YAAY,QAAQ,YAAY;AACzC,WAAO,aAAa;AAAA,MAClB,EAAE,OAAO,QAAQ,sBAAsB,gCAAgC;AAAA,MACvE,EAAE,QAAQ,IAAI;AAAA,IAChB;AAAA,EACF;AAEA,MAAI,CAAC,OAAO,SAAS;AACnB,UAAM,gBAAgB,KAAK,KAAK,OAAO,eAAe,GAAI;AAC1D,WAAO,aAAa;AAAA,MAClB,EAAE,OAAO,aAAa;AAAA,MACtB;AAAA,QACE,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,eAAe,OAAO,aAAa;AAAA,UACnC,qBAAqB,OAAO,OAAO,MAAM;AAAA,UACzC,yBAAyB,OAAO,OAAO,eAAe;AAAA,UACtD,qBAAqB,OAAO,aAAa;AAAA,QAC3C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAeO,SAAS,YAAY,KAAc,kBAA0B,GAAkB;AACpF,QAAM,YAAY,IAAI,QAAQ,IAAI,iBAAiB;AACnD,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,mBAAmB,GAAG;AAC9D,WAAO;AAAA,EACT;AAEA,MAAI,WAAW;AACb,UAAM,MAAM,UAAU,MAAM,GAAG,EAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;AACtD,UAAM,cAAc,IAAI,SAAS;AACjC,WAAO,eAAe,IAAI,IAAI,WAAW,KAAK,OAAO;AAAA,EACvD;AACA,SAAO,oBAAoB,IAAI,IAAI,QAAQ,IAAI,WAAW,GAAG,KAAK,KAAK,OAAO;AAChF;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
import { RateLimiterService } from "./service.js";
|
|
2
2
|
import { readRateLimitConfig, readEndpointRateLimitConfig } from "./config.js";
|
|
3
|
-
import { checkRateLimit, getClientIp, RATE_LIMIT_ERROR_KEY, RATE_LIMIT_ERROR_FALLBACK, RATE_LIMIT_FALLBACK_KEY, rateLimitErrorSchema } from "./helpers.js";
|
|
3
|
+
import { checkRateLimit, getClientIp, RATE_LIMIT_ERROR_KEY, RATE_LIMIT_ERROR_FALLBACK, RATE_LIMIT_FALLBACK_KEY, RATE_LIMIT_UNAVAILABLE_KEY, RATE_LIMIT_UNAVAILABLE_FALLBACK, rateLimitErrorSchema } from "./helpers.js";
|
|
4
4
|
export {
|
|
5
5
|
RATE_LIMIT_ERROR_FALLBACK,
|
|
6
6
|
RATE_LIMIT_ERROR_KEY,
|
|
7
7
|
RATE_LIMIT_FALLBACK_KEY,
|
|
8
|
+
RATE_LIMIT_UNAVAILABLE_FALLBACK,
|
|
9
|
+
RATE_LIMIT_UNAVAILABLE_KEY,
|
|
8
10
|
RateLimiterService,
|
|
9
11
|
checkRateLimit,
|
|
10
12
|
getClientIp,
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../src/lib/ratelimit/index.ts"],
|
|
4
|
-
"sourcesContent": ["export { RateLimiterService } from './service'\nexport { readRateLimitConfig, readEndpointRateLimitConfig } from './config'\nexport { checkRateLimit, getClientIp, RATE_LIMIT_ERROR_KEY, RATE_LIMIT_ERROR_FALLBACK, RATE_LIMIT_FALLBACK_KEY, rateLimitErrorSchema } from './helpers'\nexport type { RateLimitConfig, RateLimitResult, RateLimitStrategy, RateLimitGlobalConfig } from './types'\n"],
|
|
5
|
-
"mappings": "AAAA,SAAS,0BAA0B;AACnC,SAAS,qBAAqB,mCAAmC;AACjE,SAAS,gBAAgB,aAAa,sBAAsB,2BAA2B,yBAAyB,4BAA4B;",
|
|
4
|
+
"sourcesContent": ["export { RateLimiterService } from './service'\nexport { readRateLimitConfig, readEndpointRateLimitConfig } from './config'\nexport { checkRateLimit, getClientIp, RATE_LIMIT_ERROR_KEY, RATE_LIMIT_ERROR_FALLBACK, RATE_LIMIT_FALLBACK_KEY, RATE_LIMIT_UNAVAILABLE_KEY, RATE_LIMIT_UNAVAILABLE_FALLBACK, rateLimitErrorSchema } from './helpers'\nexport type { CheckRateLimitOptions } from './helpers'\nexport type { RateLimitConfig, RateLimitResult, RateLimitStrategy, RateLimitGlobalConfig } from './types'\n"],
|
|
5
|
+
"mappings": "AAAA,SAAS,0BAA0B;AACnC,SAAS,qBAAqB,mCAAmC;AACjE,SAAS,gBAAgB,aAAa,sBAAsB,2BAA2B,yBAAyB,4BAA4B,iCAAiC,4BAA4B;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { RateLimiterMemory, RateLimiterRedis, RateLimiterRes } from "rate-limiter-flexible";
|
|
2
|
+
import { createLogger } from "../logger/index.js";
|
|
2
3
|
import { parseRedisUrl } from "../redis/connection.js";
|
|
4
|
+
const logger = createLogger("ratelimit");
|
|
3
5
|
class RateLimiterService {
|
|
4
6
|
constructor(globalConfig) {
|
|
5
7
|
this.limiters = /* @__PURE__ */ new Map();
|
|
@@ -29,7 +31,12 @@ class RateLimiterService {
|
|
|
29
31
|
if (error instanceof RateLimiterRes) {
|
|
30
32
|
return this.toResult(error, false);
|
|
31
33
|
}
|
|
32
|
-
|
|
34
|
+
logger.error("Rate limiter unavailable, request was not counted", {
|
|
35
|
+
err: error,
|
|
36
|
+
keyPrefix: config.keyPrefix,
|
|
37
|
+
strategy: this.globalConfig.strategy
|
|
38
|
+
});
|
|
39
|
+
return this.degradedResult(config);
|
|
33
40
|
}
|
|
34
41
|
}
|
|
35
42
|
async get(key, config) {
|
|
@@ -73,6 +80,9 @@ class RateLimiterService {
|
|
|
73
80
|
disabledResult(config) {
|
|
74
81
|
return { allowed: true, remainingPoints: config.points, msBeforeNext: 0, consumedPoints: 0 };
|
|
75
82
|
}
|
|
83
|
+
degradedResult(config) {
|
|
84
|
+
return { ...this.disabledResult(config), degraded: true };
|
|
85
|
+
}
|
|
76
86
|
getOrCreateLimiter(config) {
|
|
77
87
|
const cacheKey = `${config.keyPrefix ?? "default"}:${config.points}:${config.duration}:${config.blockDuration ?? 0}`;
|
|
78
88
|
let limiter = this.limiters.get(cacheKey);
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../src/lib/ratelimit/service.ts"],
|
|
4
|
-
"sourcesContent": ["import { RateLimiterMemory, RateLimiterRedis, RateLimiterRes } from 'rate-limiter-flexible'\nimport { parseRedisUrl } from '../redis/connection'\nimport type { RateLimitConfig, RateLimitResult, RateLimitGlobalConfig } from './types'\n\n/** Narrow interface for the ioredis client \u2014 only the methods we actually use. */\ninterface RedisClient {\n disconnect(): void\n}\n\nexport class RateLimiterService {\n private globalConfig: RateLimitGlobalConfig\n private limiters = new Map<string, RateLimiterMemory | RateLimiterRedis>()\n private redisClient: RedisClient | null = null\n\n readonly trustProxyDepth: number\n\n constructor(globalConfig: RateLimitGlobalConfig) {\n this.globalConfig = globalConfig\n this.trustProxyDepth = globalConfig.trustProxyDepth ?? 0\n }\n\n async initialize(): Promise<void> {\n if (this.globalConfig.strategy === 'redis' && this.globalConfig.redisUrl) {\n const { default: Redis } = await import('ioredis')\n this.redisClient = new Redis({\n ...parseRedisUrl(this.globalConfig.redisUrl),\n enableOfflineQueue: false,\n maxRetriesPerRequest: 1,\n })\n }\n }\n\n async consume(key: string, config: RateLimitConfig): Promise<RateLimitResult> {\n if (!this.globalConfig.enabled) {\n return this.disabledResult(config)\n }\n\n const limiter = this.getOrCreateLimiter(config)\n\n try {\n const res = await limiter.consume(key, 1)\n return this.toResult(res, true)\n } catch (error) {\n if (error instanceof RateLimiterRes) {\n return this.toResult(error, false)\n }\n return this.
|
|
5
|
-
"mappings": "AAAA,SAAS,mBAAmB,kBAAkB,sBAAsB;AACpE,SAAS,qBAAqB;
|
|
4
|
+
"sourcesContent": ["import { RateLimiterMemory, RateLimiterRedis, RateLimiterRes } from 'rate-limiter-flexible'\nimport { createLogger } from '../logger'\nimport { parseRedisUrl } from '../redis/connection'\nimport type { RateLimitConfig, RateLimitResult, RateLimitGlobalConfig } from './types'\n\nconst logger = createLogger('ratelimit')\n\n/** Narrow interface for the ioredis client \u2014 only the methods we actually use. */\ninterface RedisClient {\n disconnect(): void\n}\n\nexport class RateLimiterService {\n private globalConfig: RateLimitGlobalConfig\n private limiters = new Map<string, RateLimiterMemory | RateLimiterRedis>()\n private redisClient: RedisClient | null = null\n\n readonly trustProxyDepth: number\n\n constructor(globalConfig: RateLimitGlobalConfig) {\n this.globalConfig = globalConfig\n this.trustProxyDepth = globalConfig.trustProxyDepth ?? 0\n }\n\n async initialize(): Promise<void> {\n if (this.globalConfig.strategy === 'redis' && this.globalConfig.redisUrl) {\n const { default: Redis } = await import('ioredis')\n this.redisClient = new Redis({\n ...parseRedisUrl(this.globalConfig.redisUrl),\n enableOfflineQueue: false,\n maxRetriesPerRequest: 1,\n })\n }\n }\n\n async consume(key: string, config: RateLimitConfig): Promise<RateLimitResult> {\n if (!this.globalConfig.enabled) {\n return this.disabledResult(config)\n }\n\n const limiter = this.getOrCreateLimiter(config)\n\n try {\n const res = await limiter.consume(key, 1)\n return this.toResult(res, true)\n } catch (error) {\n if (error instanceof RateLimiterRes) {\n return this.toResult(error, false)\n }\n logger.error('Rate limiter unavailable, request was not counted', {\n err: error,\n keyPrefix: config.keyPrefix,\n strategy: this.globalConfig.strategy,\n })\n return this.degradedResult(config)\n }\n }\n\n async get(key: string, config: RateLimitConfig): Promise<RateLimitResult | null> {\n if (!this.globalConfig.enabled) return null\n\n const limiter = this.getOrCreateLimiter(config)\n const res = await limiter.get(key)\n return res ? this.toResult(res, res.remainingPoints > 0) : null\n }\n\n async delete(key: string, config: RateLimitConfig): Promise<void> {\n if (!this.globalConfig.enabled) return\n const limiter = this.getOrCreateLimiter(config)\n await limiter.delete(key)\n }\n\n async penalty(key: string, points: number, config: RateLimitConfig): Promise<RateLimitResult> {\n if (!this.globalConfig.enabled) {\n return this.disabledResult(config)\n }\n const limiter = this.getOrCreateLimiter(config)\n const res = await limiter.penalty(key, points)\n return this.toResult(res, res.remainingPoints > 0)\n }\n\n async reward(key: string, points: number, config: RateLimitConfig): Promise<RateLimitResult> {\n if (!this.globalConfig.enabled) {\n return this.disabledResult(config)\n }\n const limiter = this.getOrCreateLimiter(config)\n const res = await limiter.reward(key, points)\n return this.toResult(res, true)\n }\n\n async block(key: string, durationSec: number, config: RateLimitConfig): Promise<void> {\n if (!this.globalConfig.enabled) return\n const limiter = this.getOrCreateLimiter(config)\n await limiter.block(key, durationSec)\n }\n\n async destroy(): Promise<void> {\n if (this.redisClient) {\n this.redisClient.disconnect()\n }\n this.limiters.clear()\n }\n\n private disabledResult(config: RateLimitConfig): RateLimitResult {\n return { allowed: true, remainingPoints: config.points, msBeforeNext: 0, consumedPoints: 0 }\n }\n\n private degradedResult(config: RateLimitConfig): RateLimitResult {\n return { ...this.disabledResult(config), degraded: true }\n }\n\n private getOrCreateLimiter(config: RateLimitConfig): RateLimiterMemory | RateLimiterRedis {\n const cacheKey = `${config.keyPrefix ?? 'default'}:${config.points}:${config.duration}:${config.blockDuration ?? 0}`\n\n let limiter = this.limiters.get(cacheKey)\n if (limiter) return limiter\n\n const prefix = [this.globalConfig.keyPrefix, config.keyPrefix].filter(Boolean).join(':')\n\n const baseOpts = {\n keyPrefix: prefix,\n points: config.points,\n duration: config.duration,\n blockDuration: config.blockDuration ?? 0,\n }\n\n if (this.globalConfig.strategy === 'redis' && this.redisClient) {\n const insuranceLimiter = new RateLimiterMemory(baseOpts)\n limiter = new RateLimiterRedis({\n ...baseOpts,\n storeClient: this.redisClient,\n insuranceLimiter,\n rejectIfRedisNotReady: false,\n })\n } else {\n limiter = new RateLimiterMemory(baseOpts)\n }\n\n this.limiters.set(cacheKey, limiter)\n return limiter\n }\n\n private toResult(res: RateLimiterRes, allowed: boolean): RateLimitResult {\n return {\n allowed,\n remainingPoints: Math.max(res.remainingPoints, 0),\n msBeforeNext: res.msBeforeNext,\n consumedPoints: res.consumedPoints,\n }\n }\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
package/dist/lib/version.js
CHANGED
package/dist/lib/version.js.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/lib/version.ts"],
|
|
4
|
-
"sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.6.8-develop.
|
|
4
|
+
"sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.6.8-develop.6969.1.7a32706312';\nexport const appVersion = APP_VERSION;\n"],
|
|
5
5
|
"mappings": "AACO,MAAM,cAAc;AACpB,MAAM,aAAa;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@open-mercato/shared",
|
|
3
|
-
"version": "0.6.8-develop.
|
|
3
|
+
"version": "0.6.8-develop.6969.1.7a32706312",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -105,7 +105,7 @@
|
|
|
105
105
|
"@mikro-orm/core": "^7.1.8",
|
|
106
106
|
"@mikro-orm/decorators": "^7.1.8",
|
|
107
107
|
"@mikro-orm/postgresql": "^7.1.8",
|
|
108
|
-
"@open-mercato/cache": "0.6.8-develop.
|
|
108
|
+
"@open-mercato/cache": "0.6.8-develop.6969.1.7a32706312",
|
|
109
109
|
"@types/sanitize-html": "^2.16.1",
|
|
110
110
|
"dotenv": "^17.4.2",
|
|
111
111
|
"pino": "^10.3.1",
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { buildOpenApiDocument, generateMarkdownFromOpenApi } from '../generator'
|
|
2
|
+
import type { Module, ModuleApiRouteFile } from '../../../modules/registry'
|
|
3
|
+
|
|
4
|
+
const routePath = '/example/records'
|
|
5
|
+
|
|
6
|
+
function makeModule(): Module {
|
|
7
|
+
const api: ModuleApiRouteFile = {
|
|
8
|
+
path: routePath,
|
|
9
|
+
metadata: {
|
|
10
|
+
GET: {
|
|
11
|
+
requireAuth: true,
|
|
12
|
+
requireFeatures: ['example.records.view'],
|
|
13
|
+
requireRoles: ['admin'],
|
|
14
|
+
},
|
|
15
|
+
},
|
|
16
|
+
handlers: { GET: async () => new Response(null) },
|
|
17
|
+
docs: {
|
|
18
|
+
tag: 'Example',
|
|
19
|
+
methods: { GET: { description: 'List records', responses: [{ status: 200, description: 'Records' }] } },
|
|
20
|
+
},
|
|
21
|
+
}
|
|
22
|
+
return { id: 'example', apis: [api] }
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
function buildOperation(includeAccessControlMetadata?: boolean) {
|
|
26
|
+
const doc = buildOpenApiDocument([makeModule()], { includeAccessControlMetadata })
|
|
27
|
+
return { doc, operation: doc.paths[routePath]?.get as Record<string, unknown> }
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
describe('buildOpenApiDocument access-control metadata', () => {
|
|
31
|
+
it('exposes feature and role identifiers by default', () => {
|
|
32
|
+
const { operation } = buildOperation()
|
|
33
|
+
|
|
34
|
+
expect(operation.description).toContain('Requires features: example.records.view')
|
|
35
|
+
expect(operation.description).toContain('Requires roles: admin')
|
|
36
|
+
expect(operation['x-require-features']).toEqual(['example.records.view'])
|
|
37
|
+
expect(operation['x-require-roles']).toEqual(['admin'])
|
|
38
|
+
})
|
|
39
|
+
|
|
40
|
+
it('strips feature and role identifiers when access-control metadata is excluded', () => {
|
|
41
|
+
const { operation } = buildOperation(false)
|
|
42
|
+
|
|
43
|
+
expect(operation.description).toBe('List records')
|
|
44
|
+
expect(operation['x-require-features']).toBeUndefined()
|
|
45
|
+
expect(operation['x-require-roles']).toBeUndefined()
|
|
46
|
+
})
|
|
47
|
+
|
|
48
|
+
it('keeps the authentication requirement and security scheme when identifiers are stripped', () => {
|
|
49
|
+
const { operation } = buildOperation(false)
|
|
50
|
+
|
|
51
|
+
expect(operation['x-require-auth']).toBe(true)
|
|
52
|
+
expect(operation.security).toBeDefined()
|
|
53
|
+
expect((operation.responses as Record<string, unknown>)['401']).toBeDefined()
|
|
54
|
+
})
|
|
55
|
+
|
|
56
|
+
it('keeps the identifiers out of the generated markdown', () => {
|
|
57
|
+
const { doc: publicDoc } = buildOperation(false)
|
|
58
|
+
const { doc: privateDoc } = buildOperation()
|
|
59
|
+
|
|
60
|
+
const publicMarkdown = generateMarkdownFromOpenApi(publicDoc)
|
|
61
|
+
const privateMarkdown = generateMarkdownFromOpenApi(privateDoc)
|
|
62
|
+
|
|
63
|
+
expect(publicMarkdown).not.toContain('example.records.view')
|
|
64
|
+
expect(publicMarkdown).not.toContain('**Roles:**')
|
|
65
|
+
expect(publicMarkdown).toContain('Requires authentication.')
|
|
66
|
+
expect(privateMarkdown).toContain('example.records.view')
|
|
67
|
+
expect(privateMarkdown).toContain('**Roles:** admin')
|
|
68
|
+
})
|
|
69
|
+
})
|
|
@@ -1049,6 +1049,7 @@ export function buildOpenApiDocument(modules: Module[], options: OpenApiDocument
|
|
|
1049
1049
|
|
|
1050
1050
|
ensureSecurityComponents(doc)
|
|
1051
1051
|
|
|
1052
|
+
const includeAccessControlMetadata = options.includeAccessControlMetadata !== false
|
|
1052
1053
|
const tags = new Map<string, string | undefined>()
|
|
1053
1054
|
|
|
1054
1055
|
for (const moduleEntry of modules) {
|
|
@@ -1086,10 +1087,10 @@ export function buildOpenApiDocument(modules: Module[], options: OpenApiDocument
|
|
|
1086
1087
|
const requireAuth = meta?.['requireAuth'] === true
|
|
1087
1088
|
const descriptionParts: string[] = []
|
|
1088
1089
|
if (baseDescription) descriptionParts.push(baseDescription)
|
|
1089
|
-
if (Array.isArray(requireFeatures) && requireFeatures.length) {
|
|
1090
|
+
if (includeAccessControlMetadata && Array.isArray(requireFeatures) && requireFeatures.length) {
|
|
1090
1091
|
descriptionParts.push(`Requires features: ${requireFeatures.join(', ')}`)
|
|
1091
1092
|
}
|
|
1092
|
-
if (Array.isArray(requireRoles) && requireRoles.length) {
|
|
1093
|
+
if (includeAccessControlMetadata && Array.isArray(requireRoles) && requireRoles.length) {
|
|
1093
1094
|
descriptionParts.push(`Requires roles: ${requireRoles.join(', ')}`)
|
|
1094
1095
|
}
|
|
1095
1096
|
|
|
@@ -1130,8 +1131,12 @@ export function buildOpenApiDocument(modules: Module[], options: OpenApiDocument
|
|
|
1130
1131
|
source: curlSample,
|
|
1131
1132
|
},
|
|
1132
1133
|
],
|
|
1133
|
-
...(Array.isArray(requireFeatures) && requireFeatures.length
|
|
1134
|
-
|
|
1134
|
+
...(includeAccessControlMetadata && Array.isArray(requireFeatures) && requireFeatures.length
|
|
1135
|
+
? { 'x-require-features': requireFeatures }
|
|
1136
|
+
: {}),
|
|
1137
|
+
...(includeAccessControlMetadata && Array.isArray(requireRoles) && requireRoles.length
|
|
1138
|
+
? { 'x-require-roles': requireRoles }
|
|
1139
|
+
: {}),
|
|
1135
1140
|
...(requireAuth ? { 'x-require-auth': true } : {}),
|
|
1136
1141
|
...(methodDoc?.extensions ?? {}),
|
|
1137
1142
|
}
|
package/src/lib/openapi/types.ts
CHANGED
|
@@ -59,6 +59,13 @@ export type OpenApiDocumentOptions = {
|
|
|
59
59
|
servers?: Array<{ url: string; description?: string }>
|
|
60
60
|
baseUrlForExamples?: string
|
|
61
61
|
defaultSecurity?: OpenApiSecurityScheme[]
|
|
62
|
+
/**
|
|
63
|
+
* Emit the ACL metadata of every operation — the `Requires features/roles`
|
|
64
|
+
* description lines and the `x-require-features` / `x-require-roles`
|
|
65
|
+
* extensions. Defaults to `true`; documentation endpoints serving anonymous
|
|
66
|
+
* callers set it to `false` so internal feature identifiers stay private.
|
|
67
|
+
*/
|
|
68
|
+
includeAccessControlMetadata?: boolean
|
|
62
69
|
}
|
|
63
70
|
|
|
64
71
|
export type OpenApiDocument = {
|
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
import { RateLimiterService } from '../service'
|
|
2
|
-
import {
|
|
2
|
+
import {
|
|
3
|
+
checkRateLimit,
|
|
4
|
+
getClientIp,
|
|
5
|
+
RATE_LIMIT_ERROR_KEY,
|
|
6
|
+
RATE_LIMIT_ERROR_FALLBACK,
|
|
7
|
+
RATE_LIMIT_UNAVAILABLE_FALLBACK,
|
|
8
|
+
} from '../helpers'
|
|
3
9
|
import { readEndpointRateLimitConfig } from '../config'
|
|
4
10
|
import type { RateLimitConfig, RateLimitGlobalConfig } from '../types'
|
|
5
11
|
|
|
@@ -84,6 +90,45 @@ describe('checkRateLimit', () => {
|
|
|
84
90
|
expect(result).toBeNull()
|
|
85
91
|
}
|
|
86
92
|
})
|
|
93
|
+
|
|
94
|
+
describe('degraded limiter', () => {
|
|
95
|
+
function createDegradedService(): RateLimiterService {
|
|
96
|
+
const degraded = createService()
|
|
97
|
+
jest.spyOn(degraded, 'consume').mockResolvedValue({
|
|
98
|
+
allowed: true,
|
|
99
|
+
remainingPoints: limitConfig.points,
|
|
100
|
+
msBeforeNext: 0,
|
|
101
|
+
consumedPoints: 0,
|
|
102
|
+
degraded: true,
|
|
103
|
+
})
|
|
104
|
+
return degraded
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
it('returns 503 when failClosed is set', async () => {
|
|
108
|
+
service = createDegradedService()
|
|
109
|
+
const response = await checkRateLimit(service, limitConfig, 'ip7', 'Rate limited', {
|
|
110
|
+
failClosed: true,
|
|
111
|
+
})
|
|
112
|
+
expect(response).not.toBeNull()
|
|
113
|
+
expect(response!.status).toBe(503)
|
|
114
|
+
expect(await response!.json()).toEqual({ error: RATE_LIMIT_UNAVAILABLE_FALLBACK })
|
|
115
|
+
})
|
|
116
|
+
|
|
117
|
+
it('uses the supplied unavailableMessage in the 503 body', async () => {
|
|
118
|
+
service = createDegradedService()
|
|
119
|
+
const response = await checkRateLimit(service, limitConfig, 'ip8', 'Rate limited', {
|
|
120
|
+
failClosed: true,
|
|
121
|
+
unavailableMessage: 'Payments are briefly unavailable.',
|
|
122
|
+
})
|
|
123
|
+
expect(await response!.json()).toEqual({ error: 'Payments are briefly unavailable.' })
|
|
124
|
+
})
|
|
125
|
+
|
|
126
|
+
it('keeps failing open when failClosed is not set', async () => {
|
|
127
|
+
service = createDegradedService()
|
|
128
|
+
const response = await checkRateLimit(service, limitConfig, 'ip9', 'Rate limited')
|
|
129
|
+
expect(response).toBeNull()
|
|
130
|
+
})
|
|
131
|
+
})
|
|
87
132
|
})
|
|
88
133
|
|
|
89
134
|
describe('getClientIp', () => {
|
|
@@ -1,6 +1,17 @@
|
|
|
1
|
+
import { RateLimiterMemory, RateLimiterRedis, RateLimiterRes } from 'rate-limiter-flexible'
|
|
2
|
+
import {
|
|
3
|
+
registerLoggerExtension,
|
|
4
|
+
resetLoggerExtension,
|
|
5
|
+
type LoggerExtensionRecord,
|
|
6
|
+
} from '../../logger'
|
|
1
7
|
import { RateLimiterService } from '../service'
|
|
2
8
|
import type { RateLimitConfig, RateLimitGlobalConfig } from '../types'
|
|
3
9
|
|
|
10
|
+
jest.mock('ioredis', () => ({
|
|
11
|
+
__esModule: true,
|
|
12
|
+
default: jest.fn().mockImplementation(() => ({ disconnect: jest.fn() })),
|
|
13
|
+
}))
|
|
14
|
+
|
|
4
15
|
function createConfig(overrides: Partial<RateLimitGlobalConfig> = {}): RateLimitGlobalConfig {
|
|
5
16
|
return {
|
|
6
17
|
enabled: true,
|
|
@@ -148,6 +159,108 @@ describe('RateLimiterService', () => {
|
|
|
148
159
|
})
|
|
149
160
|
})
|
|
150
161
|
|
|
162
|
+
describe('degraded limiter', () => {
|
|
163
|
+
const logRecords: LoggerExtensionRecord[] = []
|
|
164
|
+
|
|
165
|
+
beforeEach(() => {
|
|
166
|
+
logRecords.length = 0
|
|
167
|
+
registerLoggerExtension({ emit: (record) => logRecords.push(record) })
|
|
168
|
+
jest.spyOn(console, 'error').mockImplementation(() => {})
|
|
169
|
+
})
|
|
170
|
+
|
|
171
|
+
afterEach(() => {
|
|
172
|
+
resetLoggerExtension()
|
|
173
|
+
jest.restoreAllMocks()
|
|
174
|
+
})
|
|
175
|
+
|
|
176
|
+
it('flags the result as degraded when the backing store fails', async () => {
|
|
177
|
+
jest.spyOn(RateLimiterMemory.prototype, 'consume').mockRejectedValue(new Error('store unreachable'))
|
|
178
|
+
service = new RateLimiterService(createConfig())
|
|
179
|
+
|
|
180
|
+
const result = await service.consume('key1', defaultLimitConfig)
|
|
181
|
+
expect(result.degraded).toBe(true)
|
|
182
|
+
expect(result.allowed).toBe(true)
|
|
183
|
+
expect(logRecords).toEqual([
|
|
184
|
+
expect.objectContaining({
|
|
185
|
+
level: 'error',
|
|
186
|
+
namespace: 'ratelimit',
|
|
187
|
+
message: 'Rate limiter unavailable, request was not counted',
|
|
188
|
+
}),
|
|
189
|
+
])
|
|
190
|
+
})
|
|
191
|
+
|
|
192
|
+
it('does not flag a real rejection as degraded', async () => {
|
|
193
|
+
service = new RateLimiterService(createConfig())
|
|
194
|
+
for (let i = 0; i < defaultLimitConfig.points; i++) {
|
|
195
|
+
await service.consume('key2', defaultLimitConfig)
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
const result = await service.consume('key2', defaultLimitConfig)
|
|
199
|
+
expect(result.allowed).toBe(false)
|
|
200
|
+
expect(result.degraded).toBeFalsy()
|
|
201
|
+
})
|
|
202
|
+
|
|
203
|
+
it('does not flag a config-disabled result as degraded', async () => {
|
|
204
|
+
service = new RateLimiterService(createConfig({ enabled: false }))
|
|
205
|
+
|
|
206
|
+
const result = await service.consume('key3', defaultLimitConfig)
|
|
207
|
+
expect(result.allowed).toBe(true)
|
|
208
|
+
expect(result.degraded).toBeFalsy()
|
|
209
|
+
})
|
|
210
|
+
|
|
211
|
+
// Which failure modes actually reach `degraded` under the redis strategy: the store
|
|
212
|
+
// abstraction absorbs a plain outage through the in-memory insurance limiter, so only
|
|
213
|
+
// an error it re-throws gets there.
|
|
214
|
+
describe('redis strategy', () => {
|
|
215
|
+
async function createRedisService(): Promise<RateLimiterService> {
|
|
216
|
+
const redisService = new RateLimiterService(createConfig({
|
|
217
|
+
strategy: 'redis',
|
|
218
|
+
redisUrl: 'redis://localhost:6379',
|
|
219
|
+
}))
|
|
220
|
+
await redisService.initialize()
|
|
221
|
+
return redisService
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
function buildLimiter(redisService: RateLimiterService): unknown {
|
|
225
|
+
const internals = redisService as unknown as {
|
|
226
|
+
getOrCreateLimiter: (config: RateLimitConfig) => unknown
|
|
227
|
+
}
|
|
228
|
+
return internals.getOrCreateLimiter(defaultLimitConfig)
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
it('flags an error the redis limiter re-throws as degraded', async () => {
|
|
232
|
+
service = await createRedisService()
|
|
233
|
+
expect(buildLimiter(service)).toBeInstanceOf(RateLimiterRedis)
|
|
234
|
+
jest.spyOn(RateLimiterRedis.prototype, 'consume').mockRejectedValue(new Error('redis down'))
|
|
235
|
+
|
|
236
|
+
const result = await service.consume('redis-key', defaultLimitConfig)
|
|
237
|
+
|
|
238
|
+
expect(result.degraded).toBe(true)
|
|
239
|
+
expect(result.allowed).toBe(true)
|
|
240
|
+
expect(logRecords).toEqual([
|
|
241
|
+
expect.objectContaining({
|
|
242
|
+
level: 'error',
|
|
243
|
+
namespace: 'ratelimit',
|
|
244
|
+
message: 'Rate limiter unavailable, request was not counted',
|
|
245
|
+
}),
|
|
246
|
+
])
|
|
247
|
+
})
|
|
248
|
+
|
|
249
|
+
it('does not flag a resolved redis decision as degraded, including one the insurance limiter produced', async () => {
|
|
250
|
+
service = await createRedisService()
|
|
251
|
+
expect(buildLimiter(service)).toBeInstanceOf(RateLimiterRedis)
|
|
252
|
+
jest.spyOn(RateLimiterRedis.prototype, 'consume')
|
|
253
|
+
.mockResolvedValue(new RateLimiterRes(2, 0, 1, undefined))
|
|
254
|
+
|
|
255
|
+
const result = await service.consume('redis-key', defaultLimitConfig)
|
|
256
|
+
|
|
257
|
+
expect(result.allowed).toBe(true)
|
|
258
|
+
expect(result.degraded).toBeFalsy()
|
|
259
|
+
expect(logRecords).toEqual([])
|
|
260
|
+
})
|
|
261
|
+
})
|
|
262
|
+
})
|
|
263
|
+
|
|
151
264
|
describe('limiter caching', () => {
|
|
152
265
|
it('reuses the same limiter for the same config', async () => {
|
|
153
266
|
service = new RateLimiterService(createConfig())
|
|
@@ -6,23 +6,47 @@ import type { RateLimiterService } from './service'
|
|
|
6
6
|
export const RATE_LIMIT_ERROR_KEY = 'api.errors.rateLimit'
|
|
7
7
|
export const RATE_LIMIT_ERROR_FALLBACK = 'Too many requests. Please try again later.'
|
|
8
8
|
export const RATE_LIMIT_FALLBACK_KEY = 'global'
|
|
9
|
+
export const RATE_LIMIT_UNAVAILABLE_KEY = 'api.errors.rateLimitUnavailable'
|
|
10
|
+
export const RATE_LIMIT_UNAVAILABLE_FALLBACK = 'Service temporarily unavailable. Please try again later.'
|
|
9
11
|
|
|
10
12
|
export const rateLimitErrorSchema = z.object({
|
|
11
13
|
error: z.string().describe('Rate limit exceeded message'),
|
|
12
14
|
})
|
|
13
15
|
|
|
16
|
+
export type CheckRateLimitOptions = {
|
|
17
|
+
/**
|
|
18
|
+
* Reject with 503 when the limiter could not reach its backing store, instead of
|
|
19
|
+
* letting the request through uncounted. Use on state-mutating endpoints, where an
|
|
20
|
+
* unenforced limit is worse than a rejected request.
|
|
21
|
+
*/
|
|
22
|
+
failClosed?: boolean
|
|
23
|
+
/** Body message for the 503 emitted by `failClosed`. */
|
|
24
|
+
unavailableMessage?: string
|
|
25
|
+
}
|
|
26
|
+
|
|
14
27
|
/**
|
|
15
28
|
* Check rate limit for a request. Returns a 429 NextResponse if rate limited, or null if allowed.
|
|
16
29
|
* Rate limit headers (X-RateLimit-*, Retry-After) are only included on 429 responses.
|
|
30
|
+
*
|
|
31
|
+
* With `options.failClosed`, a degraded limiter (backing store unreachable) yields a 503
|
|
32
|
+
* instead of an allowed request. Without it the call behaves exactly as before and fails open.
|
|
17
33
|
*/
|
|
18
34
|
export async function checkRateLimit(
|
|
19
35
|
rateLimiterService: RateLimiterService,
|
|
20
36
|
config: RateLimitConfig,
|
|
21
37
|
key: string,
|
|
22
38
|
errorMessage: string,
|
|
39
|
+
options: CheckRateLimitOptions = {},
|
|
23
40
|
): Promise<NextResponse | null> {
|
|
24
41
|
const result = await rateLimiterService.consume(key, config)
|
|
25
42
|
|
|
43
|
+
if (result.degraded && options.failClosed) {
|
|
44
|
+
return NextResponse.json(
|
|
45
|
+
{ error: options.unavailableMessage ?? RATE_LIMIT_UNAVAILABLE_FALLBACK },
|
|
46
|
+
{ status: 503 },
|
|
47
|
+
)
|
|
48
|
+
}
|
|
49
|
+
|
|
26
50
|
if (!result.allowed) {
|
|
27
51
|
const retryAfterSec = Math.ceil(result.msBeforeNext / 1000)
|
|
28
52
|
return NextResponse.json(
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export { RateLimiterService } from './service'
|
|
2
2
|
export { readRateLimitConfig, readEndpointRateLimitConfig } from './config'
|
|
3
|
-
export { checkRateLimit, getClientIp, RATE_LIMIT_ERROR_KEY, RATE_LIMIT_ERROR_FALLBACK, RATE_LIMIT_FALLBACK_KEY, rateLimitErrorSchema } from './helpers'
|
|
3
|
+
export { checkRateLimit, getClientIp, RATE_LIMIT_ERROR_KEY, RATE_LIMIT_ERROR_FALLBACK, RATE_LIMIT_FALLBACK_KEY, RATE_LIMIT_UNAVAILABLE_KEY, RATE_LIMIT_UNAVAILABLE_FALLBACK, rateLimitErrorSchema } from './helpers'
|
|
4
|
+
export type { CheckRateLimitOptions } from './helpers'
|
|
4
5
|
export type { RateLimitConfig, RateLimitResult, RateLimitStrategy, RateLimitGlobalConfig } from './types'
|
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
import { RateLimiterMemory, RateLimiterRedis, RateLimiterRes } from 'rate-limiter-flexible'
|
|
2
|
+
import { createLogger } from '../logger'
|
|
2
3
|
import { parseRedisUrl } from '../redis/connection'
|
|
3
4
|
import type { RateLimitConfig, RateLimitResult, RateLimitGlobalConfig } from './types'
|
|
4
5
|
|
|
6
|
+
const logger = createLogger('ratelimit')
|
|
7
|
+
|
|
5
8
|
/** Narrow interface for the ioredis client — only the methods we actually use. */
|
|
6
9
|
interface RedisClient {
|
|
7
10
|
disconnect(): void
|
|
@@ -44,7 +47,12 @@ export class RateLimiterService {
|
|
|
44
47
|
if (error instanceof RateLimiterRes) {
|
|
45
48
|
return this.toResult(error, false)
|
|
46
49
|
}
|
|
47
|
-
|
|
50
|
+
logger.error('Rate limiter unavailable, request was not counted', {
|
|
51
|
+
err: error,
|
|
52
|
+
keyPrefix: config.keyPrefix,
|
|
53
|
+
strategy: this.globalConfig.strategy,
|
|
54
|
+
})
|
|
55
|
+
return this.degradedResult(config)
|
|
48
56
|
}
|
|
49
57
|
}
|
|
50
58
|
|
|
@@ -97,6 +105,10 @@ export class RateLimiterService {
|
|
|
97
105
|
return { allowed: true, remainingPoints: config.points, msBeforeNext: 0, consumedPoints: 0 }
|
|
98
106
|
}
|
|
99
107
|
|
|
108
|
+
private degradedResult(config: RateLimitConfig): RateLimitResult {
|
|
109
|
+
return { ...this.disabledResult(config), degraded: true }
|
|
110
|
+
}
|
|
111
|
+
|
|
100
112
|
private getOrCreateLimiter(config: RateLimitConfig): RateLimiterMemory | RateLimiterRedis {
|
|
101
113
|
const cacheKey = `${config.keyPrefix ?? 'default'}:${config.points}:${config.duration}:${config.blockDuration ?? 0}`
|
|
102
114
|
|
|
@@ -18,6 +18,20 @@ export interface RateLimitResult {
|
|
|
18
18
|
msBeforeNext: number
|
|
19
19
|
/** Total points consumed in the current window */
|
|
20
20
|
consumedPoints: number
|
|
21
|
+
/**
|
|
22
|
+
* True when the limiter could not produce a real decision, so `allowed` is a
|
|
23
|
+
* fallback. Callers guarding state-mutating endpoints SHOULD fail closed on this
|
|
24
|
+
* instead of letting the request through. Absent (falsy) when rate limiting is
|
|
25
|
+
* switched off by configuration.
|
|
26
|
+
*
|
|
27
|
+
* Set for every error that escapes the limiter itself: building the limiter fails,
|
|
28
|
+
* or `consume()` rejects with anything other than a `RateLimiterRes` quota
|
|
29
|
+
* rejection. With the `redis` strategy an unreachable store is normally absorbed
|
|
30
|
+
* one level lower by the in-memory insurance limiter — requests stay counted
|
|
31
|
+
* per process and the result is a real decision, so `degraded` stays falsy; it is
|
|
32
|
+
* set when that fallback layer fails too.
|
|
33
|
+
*/
|
|
34
|
+
degraded?: boolean
|
|
21
35
|
}
|
|
22
36
|
|
|
23
37
|
export type RateLimitStrategy = 'memory' | 'redis'
|