@rvoh/psychic 2.3.9 → 3.0.0-alpha.2

package/dist/cjs/src/controller/helpers/logIfDevelopment.js

@@ -3,20 +3,20 @@ import colorize from '../../cli/helpers/colorize.js';
 import EnvInternal from '../../helpers/EnvInternal.js';
 import { httpMethodBgColor } from './httpMethodColor.js';
 import { statusCodeBgColor } from './statusCodeColor.js';
-export default function logIfDevelopment({ req, res, startTime, fallbackStatusCode = 200, }) {
+export default function logIfDevelopment({ ctx, startTime, fallbackStatusCode = 200, }) {
     if (!EnvInternal.isDevelopment)
         return;
-    const method = colorize(` ${req.method.toUpperCase()} `, {
+    const method = colorize(` ${ctx.method.toUpperCase()} `, {
         color: 'black',
-        bgColor: httpMethodBgColor(req.method.toLowerCase()),
+        bgColor: httpMethodBgColor(ctx.method.toLowerCase()),
     });
-    const computedStatus = res.statusCode || fallbackStatusCode;
+    const computedStatus = ctx.status || fallbackStatusCode;
     const statusBgColor = statusCodeBgColor(computedStatus);
     const status = colorize(` ${computedStatus} `, {
         color: 'black',
         bgColor: statusBgColor,
     });
-    const url = colorize(req.url, { color: 'green' });
+    const url = colorize(ctx.url, { color: 'green' });
     const benchmark = colorize(`${Date.now() - startTime}ms`, { color: 'gray' });
     DreamCLI.logger.log(`${method} ${url} ${status} ${benchmark}`, { logPrefix: '' });
 }

package/dist/cjs/src/controller/index.js

@@ -1,6 +1,7 @@
 import { Dream, DreamApp } from '@rvoh/dream';
 import { GlobalNameNotSet } from '@rvoh/dream/errors';
 import { DreamSerializerBuilder, ObjectSerializerBuilder } from '@rvoh/dream/system';
+import fastJsonStringify from 'fast-json-stringify';
 import ParamValidationError from '../error/controller/ParamValidationError.js';
 import HttpStatusBadGateway from '../error/http/BadGateway.js';
 import HttpStatusBadRequest from '../error/http/BadRequest.js';
@@ -36,6 +37,7 @@ import HttpStatusUnsupportedMediaType from '../error/http/UnsupportedMediaType.j
 import EnvInternal from '../helpers/EnvInternal.js';
 import toJson from '../helpers/toJson.js';
 import OpenapiPayloadValidator from '../openapi-renderer/helpers/OpenapiPayloadValidator.js';
+import { cacheStringify, getCachedStringify } from '../openapi-renderer/helpers/stringify-cache.js';
 import PsychicApp from '../psychic-app/index.js';
 import Params from '../server/params.js';
 import Session from '../session/index.js';
@@ -173,17 +175,20 @@ export default class PsychicController {
     get isPsychicControllerInstance() {
         return true;
     }
-    req;
-    res;
+    ctx;
     session;
     action;
     renderOpts;
     startTime;
-    constructor(req, res, { action, }) {
+    _responseSent = false;
+    constructor(ctx, { action, }) {
         this.startTime = Date.now();
-        this.req = req;
-        this.res = res;
-        this.session = new Session(req, res);
+        this.ctx = ctx;
+        // Koa defaults ctx.status to 404, but Express defaulted res.statusCode to 200.
+        // Set 200 here so controller response methods (ok, json, etc.) and OpenAPI
+        // response-body validation see the correct default status.
+        this.ctx.status = 200;
+        this.session = new Session(ctx);
         this.action = action;
         // TODO: read casing from Dream app config
         this.renderOpts = {
@@ -208,7 +213,7 @@ export default class PsychicController {
      * ```
      */
     get headers() {
-        return this.req.headers;
+        return this.ctx.request.headers;
     }
     /**
      * Gets the combined parameters from the HTTP request. This includes URL parameters,
@@ -234,10 +239,14 @@ export default class PsychicController {
     get params() {
         this.validateParams();
         const query = this.getCachedQuery();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+        const body = this.ctx.request.body ?? {};
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+        const routeParams = this.ctx.params ?? {};
         const params = {
             ...query,
-            ...this.req.body,
-            ...this.req.params,
+            ...body,
+            ...routeParams,
         };
         return params;
     }
@@ -249,7 +258,7 @@ export default class PsychicController {
         if (this._cachedQuery)
             return this._cachedQuery;
         const openapiEndpointRenderer = this.currentOpenapiRenderer;
-        const query = this.req.query;
+        const query = this.ctx.request.query;
         if (openapiEndpointRenderer) {
             // validateOpenapiQuery will modify the query passed into it to conform
             // to the openapi shape with regards to arrays, since these are notoriously
@@ -585,26 +594,92 @@ export default class PsychicController {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     data) {
         this.validateOpenapiResponseBody(data);
-        this.expressSendJson(data);
+        this.koaSendJson(data);
     }
-    expressSendJson(
+    koaSendJson(
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    data, statusCode = this.res.statusCode) {
-        this.res.type('json').status(statusCode).send(toJson(data, PsychicApp.getOrFail().sanitizeResponseJson));
+    data, statusCode = this.ctx.status || 200) {
+        // In Express, calling res.json() after a response was already sent was a no-op.
+        // In Koa, ctx.body/ctx.status are plain assignments, so the last write wins.
+        // Guard here to preserve Express-like semantics for user code that falls through
+        // after sending a response (e.g. this.noContent() without a return).
+        if (this._responseSent)
+            return;
+        this.ctx.status = statusCode;
+        // Try to use fast-json-stringify if an OpenAPI schema exists for this endpoint
+        const stringifyFn = this.currentOpenapiRenderer?.['disableFastJson']
+            ? undefined
+            : this.getFastJsonStringifyFunction(statusCode);
+        if (stringifyFn) {
+            this.ctx.type = 'application/json';
+            this.ctx.body = stringifyFn(data);
+        }
+        else {
+            // Fall back to toJson() if no OpenAPI schema exists
+            this.ctx.type = 'json';
+            this.ctx.body = toJson(data);
+        }
+        this._responseSent = true;
         this.logIfDevelopment();
     }
-    expressSendStatus(statusCode) {
-        this.res.sendStatus(statusCode);
+    /**
+     * @internal
+     *
+     * Attempts to retrieve or create a cached fast-json-stringify function
+     * for the current endpoint and status code. Returns undefined if no
+     * OpenAPI schema exists or if the controller's globalName is not set.
+     *
+     * @param statusCode - the HTTP status code
+     * @returns A stringify function, or undefined if no schema exists
+     */
+    getFastJsonStringifyFunction(statusCode) {
+        const openapiEndpointRenderer = this.currentOpenapiRenderer;
+        if (!openapiEndpointRenderer)
+            return undefined;
+        const controllerClass = this.constructor;
+        // If globalName is not set (e.g., in some unit tests), fall back to toJson()
+        if (!controllerClass._globalName)
+            return undefined;
+        // Try each openapiName until we find a schema
+        for (const openapiName of this.computedOpenapiNames) {
+            const validator = new OpenapiPayloadValidator(openapiName, openapiEndpointRenderer);
+            const schemaWithComponents = validator.getResponseSchemaWithComponents(statusCode);
+            if (!schemaWithComponents)
+                continue;
+            // Generate cache key
+            const cacheKey = `${controllerClass.globalName}#${this.action}|${openapiName}|${statusCode}`;
+            // Check cache first
+            const cachedStringify = getCachedStringify(cacheKey);
+            if (cachedStringify)
+                return cachedStringify;
+            // Compile and cache the stringify function
+            // If compilation fails, let the error propagate (dead programs tell no lies)
+            const stringifyFn = fastJsonStringify(schemaWithComponents);
+            cacheStringify(cacheKey, stringifyFn);
+            return stringifyFn;
+        }
+        return undefined;
+    }
+    koaSendStatus(statusCode) {
+        if (this._responseSent)
+            return;
+        this.ctx.status = statusCode;
+        this.ctx.body = '';
+        this._responseSent = true;
         this.logIfDevelopment();
     }
-    expressRedirect(statusCode, newLocation) {
-        this.res.redirect(statusCode, newLocation);
+    koaRedirect(statusCode, newLocation) {
+        if (this._responseSent)
+            return;
+        this.ctx.status = statusCode;
+        this.ctx.redirect(newLocation);
+        this._responseSent = true;
         this.logIfDevelopment();
     }
     logIfDevelopment() {
         if (!EnvInternal.isDevelopment)
             return;
-        logIfDevelopment({ req: this.req, res: this.res, startTime: this.startTime });
+        logIfDevelopment({ ctx: this.ctx, startTime: this.startTime });
     }
     defaultSerializerPassthrough = {};
     /**
@@ -662,7 +737,7 @@ export default class PsychicController {
      */
     respond(data = {}, opts = {}) {
         const openapiData = this.constructor.openapi[this.action];
-        this.res.status(openapiData?.['status'] || 200);
+        this.ctx.status = openapiData?.['status'] || 200;
         this.json(data, opts);
     }
     /**
@@ -695,7 +770,7 @@ export default class PsychicController {
         const realStatus = (typeof HttpStatusCodeMap[status] === 'string'
             ? HttpStatusCodeMap[HttpStatusCodeMap[status]]
             : HttpStatusCodeMap[status]);
-        this.res.status(realStatus);
+        this.ctx.status = realStatus;
         this.json(body);
     }
     /**
@@ -714,7 +789,7 @@ export default class PsychicController {
      * ```
      */
     redirect(path) {
-        this.res.redirect(path);
+        this.ctx.redirect(path);
     }
     // begin: http status codes
     /**
@@ -756,7 +831,7 @@ export default class PsychicController {
      */
     // 201
     created(data = {}, opts = {}) {
-        this.res.status(201);
+        this.ctx.status = 201;
         this.json(data, opts);
     }
     /**
@@ -778,17 +853,17 @@ export default class PsychicController {
      */
     // 202
     accepted(data = {}, opts = {}) {
-        this.res.status(202);
+        this.ctx.status = 202;
         this.json(data, opts);
     }
     // 203
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     nonAuthoritativeInformation(message = undefined) {
         if (message) {
-            this.expressSendJson(message, 203);
+            this.koaSendJson(message, 203);
         }
         else {
-            this.expressSendStatus(203);
+            this.koaSendStatus(203);
         }
     }
     /**
@@ -808,39 +883,39 @@ export default class PsychicController {
      */
     // 204
     noContent() {
-        this.expressSendStatus(204);
+        this.koaSendStatus(204);
     }
     // 205
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     resetContent(message = undefined) {
-        this.res.status(205);
+        this.ctx.status = 205;
         this.json(message);
     }
     // 208
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     alreadyReported(message = undefined) {
-        this.res.status(208);
+        this.ctx.status = 208;
         this.json(message);
     }
     // 301
     movedPermanently(newLocation) {
-        this.expressRedirect(301, newLocation);
+        this.koaRedirect(301, newLocation);
     }
     // 302
     found(newLocation) {
-        this.expressRedirect(302, newLocation);
+        this.koaRedirect(302, newLocation);
     }
     // 303
     seeOther(newLocation) {
-        this.expressRedirect(303, newLocation);
+        this.koaRedirect(303, newLocation);
     }
     // 307
     temporaryRedirect(newLocation) {
-        this.expressRedirect(307, newLocation);
+        this.koaRedirect(307, newLocation);
     }
     // 308
     permanentRedirect(newLocation) {
-        this.expressRedirect(308, newLocation);
+        this.koaRedirect(308, newLocation);
     }
     /**
      * Throws an HTTP 400 Bad Request error. Use this when the client request
@@ -1077,7 +1152,7 @@ export default class PsychicController {
      */
     async runAction() {
         await this.runBeforeActions();
-        if (this.res.headersSent)
+        if (this._responseSent || this.ctx.headerSent)
             return;
         this.validateParams();
         // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
@@ -1104,8 +1179,10 @@ export default class PsychicController {
         const openapiEndpointRenderer = this.currentOpenapiRenderer;
         if (!openapiEndpointRenderer)
             return;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+        const body = this.ctx.request.body;
         this.computedOpenapiNames.forEach(openapiName => {
-            new OpenapiPayloadValidator(openapiName, openapiEndpointRenderer).validateOpenapiRequestBody(this.req.body);
+            new OpenapiPayloadValidator(openapiName, openapiEndpointRenderer).validateOpenapiRequestBody(body);
         });
     }
     /**
@@ -1121,7 +1198,7 @@ export default class PsychicController {
         if (!openapiEndpointRenderer)
             return;
         this.computedOpenapiNames.forEach(openapiName => {
-            new OpenapiPayloadValidator(openapiName, openapiEndpointRenderer).validateOpenapiHeaders(this.req.headers);
+            new OpenapiPayloadValidator(openapiName, openapiEndpointRenderer).validateOpenapiHeaders(this.ctx.request.headers);
         });
     }
     /**
@@ -1137,7 +1214,7 @@ export default class PsychicController {
         if (!openapiEndpointRenderer)
             return;
         this.computedOpenapiNames.forEach(openapiName => {
-            new OpenapiPayloadValidator(openapiName, openapiEndpointRenderer).validateOpenapiQuery(this.req.query);
+            new OpenapiPayloadValidator(openapiName, openapiEndpointRenderer).validateOpenapiQuery(this.ctx.request.query);
         });
     }
     /**
@@ -1156,7 +1233,7 @@ export default class PsychicController {
         if (!openapiEndpointRenderer)
             return;
         this.computedOpenapiNames.forEach(openapiName => {
-            new OpenapiPayloadValidator(openapiName, openapiEndpointRenderer).validateOpenapiResponseBody(data, this.res.statusCode);
+            new OpenapiPayloadValidator(openapiName, openapiEndpointRenderer).validateOpenapiResponseBody(data, this.ctx.status);
         });
     }
     /**
@@ -1175,7 +1252,7 @@ export default class PsychicController {
     async runBeforeActions() {
         const beforeActions = this.constructor.controllerHooks.filter(hook => hook.shouldFireForAction(this.action));
         for (const hook of beforeActions) {
-            if (this.res.headersSent)
+            if (this._responseSent || this.ctx.headerSent)
                 return;
             if (hook.isStatic) {
                 // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access

package/dist/cjs/src/devtools/helpers/launchDevServer.js

@@ -31,7 +31,6 @@ export async function launchDevServer(key, { port = 3000, cmd = 'pnpm client', t
             onStdOut(txt);
         }
         else {
-            // eslint-disable-next-line no-console
             console.log(txt);
         }
     });

package/dist/cjs/src/error/router/cannot-commit-routes-without-koa-app.js

@@ -0,0 +1,12 @@
+export default class CannotCommitRoutesWithoutKoaApp extends Error {
+    get message() {
+        return `
+      When instantiating a PsychicRouter, if no Koa app is provided as the
+      first argument, you are not able to commit your routes. Make sure
+      to provide an actual Koa app before commiting, like so:
+
+        const app = new Koa()
+        new PsychicRouter(app, ...)
+    `;
+    }
+}

package/dist/cjs/src/helpers/toJson.js

@@ -1,15 +1,9 @@
-import { sanitizeString } from '@rvoh/dream/utils';
-export default function toJson(data, sanitize) {
+export default function toJson(data) {
     /**
      * 'undefined' is invalid json, and `JSON.stringify(undefined)` returns `undefined`
      * so follow the pattern established by Express and return '{}' for `undefined`
      */
     if (data === undefined)
         return '{}';
-    if (sanitize) {
-        return JSON.stringify(data, (_, x) => (typeof x !== 'string' ? x : sanitizeString(x))).replace(/\\\\/g, '\\');
-    }
-    else {
-        return JSON.stringify(data);
-    }
+    return JSON.stringify(data);
 }

package/dist/cjs/src/helpers/validateOpenApiSchema.js

@@ -126,7 +126,7 @@ const BIGINT_REGEX = /^-?\d+(\.0*)?$/;
 /**
  * Formats AJV errors into a more readable format
  */
-function formatAjvErrors(ajvErrors) {
+export function formatAjvErrors(ajvErrors) {
     return ajvErrors.map(error => ({
         instancePath: error.instancePath,
         schemaPath: error.schemaPath,

package/dist/cjs/src/openapi-renderer/endpoint.js

@@ -40,6 +40,7 @@ export default class OpenapiEndpointRenderer {
     omitDefaultResponses;
     defaultResponse;
     validate = undefined;
+    disableFastJson = false;
     /**
      * instantiates a new OpenapiEndpointRenderer.
      * This class is used by the `@Openapi` decorator
@@ -54,7 +55,7 @@ export default class OpenapiEndpointRenderer {
      * const json = JSON.encode(openapiJsonContents, null, 2)
      * ```
      */
-    constructor(dreamsOrSerializers, controllerClass, action, { requestBody, headers, many, paginate, cursorPaginate, scrollPaginate, query, responses, serializerKey, status, tags, security, pathParams, description, summary, omitDefaultHeaders, omitDefaultResponses, defaultResponse, validate, } = {}) {
+    constructor(dreamsOrSerializers, controllerClass, action, { requestBody, headers, many, paginate, cursorPaginate, scrollPaginate, query, responses, serializerKey, status, tags, security, pathParams, description, summary, omitDefaultHeaders, omitDefaultResponses, defaultResponse, validate, disableFastJson, } = {}) {
         this.dreamsOrSerializers = dreamsOrSerializers;
         this.controllerClass = controllerClass;
         this.action = action;
@@ -83,6 +84,7 @@ export default class OpenapiEndpointRenderer {
                 : omitDefaultResponses;
         this.defaultResponse = defaultResponse;
         this.validate = validate;
+        this.disableFastJson = disableFastJson ?? false;
     }
     /**
      * @internal

package/dist/cjs/src/openapi-renderer/helpers/OpenapiPayloadValidator.js

@@ -1,8 +1,9 @@
 import OpenapiRequestValidationFailure from '../../error/openapi/OpenapiRequestValidationFailure.js';
 import OpenapiResponseValidationFailure from '../../error/openapi/OpenapResponseValidationFailure.js';
-import validateOpenApiSchema from '../../helpers/validateOpenApiSchema.js';
+import { createValidator, formatAjvErrors, } from '../../helpers/validateOpenApiSchema.js';
 import PsychicApp from '../../psychic-app/index.js';
 import suppressResponseEnumsConfig from './suppressResponseEnumsConfig.js';
+import { cacheValidator, getCachedValidator } from './validator-cache.js';
 /**
  * @internal
  *
@@ -157,16 +158,46 @@ export default class OpenapiPayloadValidator {
         const openapiEndpointRenderer = this.openapiEndpointRenderer;
         const openapiName = this.openapiName;
         if (openapiEndpointRenderer.shouldValidateResponseBody(openapiName)) {
-            const openapiResponseBody = openapiEndpointRenderer['parseResponses']({
-                openapiName,
-                renderOpts: this.renderOpts,
-            }).openapi?.[statusCode.toString()];
-            const schema = openapiResponseBody?.['content']?.['application/json']?.['schema'];
+            const schema = this.getResponseSchema(statusCode);
             if (schema) {
                 this.validateOrFail(data, schema, 'responseBody');
             }
         }
     }
+    /**
+     * @internal
+     *
+     * Retrieves the OpenAPI response schema for a given status code.
+     * Returns undefined if no schema is defined for this endpoint/status code.
+     *
+     * @param statusCode - the HTTP status code
+     * @returns The response schema, or undefined if not found
+     */
+    getResponseSchema(statusCode) {
+        const openapiEndpointRenderer = this.openapiEndpointRenderer;
+        const openapiName = this.openapiName;
+        const openapiResponseBody = openapiEndpointRenderer['parseResponses']({
+            openapiName,
+            renderOpts: this.renderOpts,
+        }).openapi?.[statusCode.toString()];
+        return openapiResponseBody?.['content']?.['application/json']?.['schema'];
+    }
+    /**
+     * @internal
+     *
+     * Retrieves the OpenAPI response schema for a given status code with
+     * all components merged in. This is the schema format needed by
+     * fast-json-stringify and AJV validators.
+     *
+     * @param statusCode - the HTTP status code
+     * @returns The response schema with components, or undefined if not found
+     */
+    getResponseSchemaWithComponents(statusCode) {
+        const schema = this.getResponseSchema(statusCode);
+        if (!schema)
+            return undefined;
+        return this.addComponentsToSchema(schema);
+    }
     /**
      * @internal
      *
@@ -241,12 +272,47 @@ export default class OpenapiPayloadValidator {
     validateOrFail(
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     data, openapiSchema, target) {
-        const validationResults = validateOpenApiSchema(data || {}, this.addComponentsToSchema(openapiSchema), this.getAjvOptions(target));
-        if (!validationResults.isValid) {
+        const cacheKey = this.getCacheKey(target);
+        const schemaWithComponents = this.addComponentsToSchema(openapiSchema);
+        const ajvOptions = this.getAjvOptions(target);
+        const validator = getCachedValidator(cacheKey) ||
+            this.compileAndCacheValidator(cacheKey, schemaWithComponents, ajvOptions);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const clonedData = structuredClone(data || {});
+        const isValid = validator(clonedData);
+        if (!isValid) {
             const errorClass = target === 'responseBody' ? OpenapiResponseValidationFailure : OpenapiRequestValidationFailure;
-            throw new errorClass(validationResults.errors || [], target);
+            throw new errorClass(formatAjvErrors(validator.errors || []), target);
         }
     }
+    /**
+     * @internal
+     *
+     * Generates a cache key for the validator based on controller, action, openapiName, and target.
+     *
+     * @param target - the validation target (one of: 'requestBody', 'query', 'headers', 'responseBody')
+     * @returns cache key string
+     */
+    getCacheKey(target) {
+        const controllerClass = this.openapiEndpointRenderer['controllerClass'];
+        const actionName = this.openapiEndpointRenderer['action'];
+        return `${controllerClass.globalName}#${actionName}|${this.openapiName}|${target}`;
+    }
+    /**
+     * @internal
+     *
+     * Compiles a validator using AJV and caches it for future use.
+     *
+     * @param cacheKey - the cache key for this validator
+     * @param schema - the schema to compile
+     * @param options - AJV options
+     * @returns compiled validator function
+     */
+    compileAndCacheValidator(cacheKey, schema, options) {
+        const validator = createValidator(schema, options);
+        cacheValidator(cacheKey, validator);
+        return validator;
+    }
     /**
      * @internal
      *

package/dist/cjs/src/openapi-renderer/helpers/stringify-cache.js

@@ -0,0 +1,55 @@
+/**
+ * @internal
+ *
+ * Cache for compiled fast-json-stringify functions.
+ * Eliminates redundant schema compilation on every request by storing
+ * stringify functions keyed by controller, action, openapiName, and status code.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const _stringifyCache = {};
+/**
+ * @internal
+ *
+ * Retrieves a cached stringify function if it exists.
+ *
+ * @param cacheKey - The cache key identifying the stringify function
+ * @returns The cached stringify function, or undefined if not found
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function getCachedStringify(cacheKey) {
+    return _stringifyCache[cacheKey];
+}
+/**
+ * @internal
+ *
+ * Stores a compiled stringify function in the cache.
+ *
+ * @param cacheKey - The cache key identifying the stringify function
+ * @param stringifyFn - The compiled fast-json-stringify function to cache
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function cacheStringify(cacheKey, stringifyFn) {
+    _stringifyCache[cacheKey] = stringifyFn;
+}
+/**
+ * @internal
+ *
+ * Clears a specific stringify function from the cache.
+ * Used in test environments to ensure test isolation.
+ *
+ * @param cacheKey - The cache key identifying the stringify function to clear
+ */
+export function _testOnlyClearStringify(cacheKey) {
+    delete _stringifyCache[cacheKey];
+}
+/**
+ * @internal
+ *
+ * Clears all stringify functions from the cache.
+ * Used in test environments to ensure test isolation.
+ */
+export function _testOnlyClearStringifyCache() {
+    Object.keys(_stringifyCache).forEach(key => {
+        delete _stringifyCache[key];
+    });
+}

package/dist/cjs/src/openapi-renderer/helpers/validator-cache.js

@@ -0,0 +1,52 @@
+/**
+ * @internal
+ *
+ * Cache for compiled AJV validator functions.
+ * Eliminates redundant schema compilation on every request by storing
+ * validators keyed by controller, action, openapiName, and validation target.
+ */
+const _validatorCache = {};
+/**
+ * @internal
+ *
+ * Retrieves a cached validator function if it exists.
+ *
+ * @param cacheKey - The cache key identifying the validator
+ * @returns The cached validator function, or undefined if not found
+ */
+export function getCachedValidator(cacheKey) {
+    return _validatorCache[cacheKey];
+}
+/**
+ * @internal
+ *
+ * Stores a compiled validator function in the cache.
+ *
+ * @param cacheKey - The cache key identifying the validator
+ * @param validator - The compiled AJV validator function to cache
+ */
+export function cacheValidator(cacheKey, validator) {
+    _validatorCache[cacheKey] = validator;
+}
+/**
+ * @internal
+ *
+ * Clears a specific validator from the cache.
+ * Used in test environments to ensure test isolation.
+ *
+ * @param cacheKey - The cache key identifying the validator to clear
+ */
+export function _testOnlyClearValidator(cacheKey) {
+    delete _validatorCache[cacheKey];
+}
+/**
+ * @internal
+ *
+ * Clears all validators from the cache.
+ * Used in test environments to ensure test isolation.
+ */
+export function _testOnlyClearValidatorCache() {
+    Object.keys(_validatorCache).forEach(key => {
+        delete _validatorCache[key];
+    });
+}

package/dist/cjs/src/psychic-app/helpers/import/importControllers.js

@@ -32,7 +32,7 @@ importCb) {
              * at decoration time such that the class of a property being decorated is only avilable during instance instantiation. In order
              * to only apply static values once, on boot, `globallyInitializingDecorators` is set to true on Dream, and all Dream models are instantiated.
              */
-            new controllerClass({}, {}, { action: 'a' });
+            new controllerClass({}, { action: 'a' });
         }
     }
     PsychicController['globallyInitializingDecorators'] = false;