@rvoh/psychic 0.26.3 → 0.27.2

package/README.md

@@ -1,12 +1,14 @@
-> ATTENTION: we are currently in the process of releasing this code to the world, as of the afternoon of March 10th, 2025. This notice will be removed, and the version of this repo will be bumped to 1.0.0, once all of the repos have been migrated to the new spaces and we can verify that it is all working. This is anticipated to take 1 day.
+> ATTENTION: we are currently in the process of releasing this code to the world, as of the afternoon of March 10th, 2025. This notice will be removed, and the version of this repo will be bumped to 1.0.0, once all of the repos have been migrated to the new spaces and we can verify that it is all working. This is anticipated to be done in early April, 2025.
 
 # Psychic
 
-Psychic is a typescript first Node framework built on top of [kysely](http://kysely.dev) and heavily inspired by Ruby on Rails. It provides a light-weight routing layer around [expressjs](https://expressjs.com) to create a familiar MVC pattern for those coming from a conventional MVC framework, a type-safe ORM with an incredibly powerful autocomplete API, elegant redis and socket.io bindings for distributed websocket applications, the ability to couple with a front-end framework (like react, angular, etc...) and write specs that drive through your front end, while still maintaining a back end-centric context from which to write specs.
+Psychic is a typescript first Node framework built on top of [kysely](http://kysely.dev) and heavily inspired by Ruby on Rails. It provides a light-weight routing layer around [expressjs](https://expressjs.com) to create a familiar MVC pattern for those coming from a conventional MVC framework, and...
 
-For more comprehensive documentation, please see [The official Psychic guides](https://psychicframework.com). We will also be publishing api docs shortly, but the Psychic guides should be comprehensive enough to provide an understanding of the technology and how to use it.
+Introducing [dream](https://psychicframework.com/docs/models/overview)!, a robust, type-safe ORM with an incredibly powerful autocomplete API, through associations, polymorphism, single table inheritence, deep OpenAPI integration, and much more.
+
+In addition, psychic also provides elegant redis and socket.io bindings for distributed websocket applications, a powerful background job system integrated with bullmq to enable you to easily send any of your application code into redis for background processing, the ability to couple with a front-end framework (like nextjs, react, angular etc...) and write specs that drive through your front end, while still maintaining a back end-centric context from which to compose, and much more!
 
-NOTE: doing so will create the new app in the psychic folder, so once done testing remember to remove it.
+For more comprehensive documentation, please see [The official Psychic guides](https://psychicframework.com). We will also be publishing api docs shortly, but the Psychic guides should be comprehensive enough to provide an understanding of the technology and how to use it.
 
 ## Questions?
 

package/dist/cjs/src/bin/helpers/enumsAndTheirValues.js

@@ -10,8 +10,9 @@ SELECT pg_type.typname AS enum_type, pg_enum.enumlabel AS enum_label FROM pg_typ
 `.execute((0, dream_1.db)('primary'));
     const rowData = {};
     rows.forEach(row => {
-        rowData[row.enumType] ||= [];
-        rowData[row.enumType].push(row.enumLabel);
+        const enumType = row.enumType;
+        rowData[enumType] ||= [];
+        rowData[enumType].push(row.enumLabel);
     });
     return rowData;
 }

package/dist/cjs/src/bin/helpers/enumsFileStr.js

@@ -9,7 +9,7 @@ async function enumsFileStr() {
     let enumsFileStr = (0, autogeneratedFileDisclaimer_js_1.default)();
     Object.keys(enums).forEach(enumName => {
         const exportedTypeName = (0, pascalizeFileName_js_1.default)(enumName) + 'Values';
-        const values = enums[enumName];
+        const values = enums[enumName] || [];
         enumsFileStr += `\
 export const ${exportedTypeName} = [
   ${values.map(val => `'${val}'`).join(',\n  ')}

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

@@ -27,6 +27,20 @@ class PsychicBin {
         if (!bypassDreamSync)
             await dream_1.DreamBin.sync(() => { });
         await PsychicBin.syncTypes();
+        const psychicApp = index_js_1.default.getOrFail();
+        dream_1.DreamCLI.logger.logStartProgress('running post-sync operations...');
+        // call post-sync command in a separate process, so that newly-generated
+        // types can be reloaded and brought into all classes.
+        await dream_1.DreamCLI.spawn(psychicApp.psyCmd('post-sync'), {
+            onStdout: message => {
+                dream_1.DreamCLI.logger.logContinueProgress(`[post-sync]` + ' ' + message, {
+                    logPrefixColor: 'cyan',
+                });
+            },
+        });
+        dream_1.DreamCLI.logger.logEndProgress();
+    }
+    static async postSync() {
         const psychicApp = index_js_1.default.getOrFail();
         await PsychicBin.syncOpenapiJson();
         if (psychicApp.openapi?.syncEnumsToClient) {

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

@@ -50,6 +50,14 @@ class PsychicCLI {
             await index_js_1.default.sync();
             process.exit();
         });
+        program
+            .command('post-sync')
+            .description('an internal command that runs as the second stage of the `sync` command, since after types are rebuit, the application needs to be reloaded before autogenerating certain files, since those files will need to leverage the updated types')
+            .action(async () => {
+            await initializePsychicApplication();
+            await index_js_1.default.postSync();
+            process.exit();
+        });
         program
             .command('sync:routes')
             .description('reads the routes generated by your app and generates a cache file, which is then used to give autocomplete support to the route helper, amoongst other things.')

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

@@ -6,6 +6,7 @@ exports.stopDevServers = stopDevServers;
 const child_process_1 = require("child_process");
 const net_1 = require("net");
 const sleep_js_1 = require("../../../spec/helpers/sleep.js");
+const UnexpectedUndefined_js_1 = require("../../error/UnexpectedUndefined.js");
 const devServerProcesses = {};
 async function launchDevServer(key, { port = 3000, cmd = 'yarn client', timeout = 5000 } = {}) {
     if (devServerProcesses[key])
@@ -13,6 +14,8 @@ async function launchDevServer(key, { port = 3000, cmd = 'yarn client', timeout
     if (process.env.DEBUG === '1')
         console.log('Starting server...');
     const [_cmd, ...args] = cmd.split(' ');
+    if (_cmd === undefined)
+        throw new UnexpectedUndefined_js_1.default();
     const proc = (0, child_process_1.spawn)(_cmd, args, {
         detached: true,
         env: {

package/dist/cjs/src/error/UnexpectedUndefined.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class UnexpectedUndefined extends Error {
+    constructor() {
+        super();
+    }
+    get message() {
+        return `Undefined detected where it should never happen since we are iterating 
+over keys of an internal object that should not have undefined values.
+
+This was added as part of activating noUncheckedIndexedAccess in tsconfig.`;
+    }
+}
+exports.default = UnexpectedUndefined;

package/dist/cjs/src/error/psychic-application/init-missing-package-manager.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class PsychicApplicationInitMissingPackageManager extends Error {
+    constructor() {
+        super();
+    }
+    get message() {
+        return `
+must set packageManager when initializing a new PsychicApplication.
+
+within conf/app.ts, you must have a call to "#set('packageManager', '<YOUR_CHOSEN_PACKAGE_MANAGER>')", i.e.
+
+  // conf/app.ts
+  export default async (app: PsychicApplication) => {
+    await app.set('packageManager', 'yarn')
+  }
+    `;
+    }
+}
+exports.default = PsychicApplicationInitMissingPackageManager;

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

@@ -4,6 +4,7 @@ exports.default = generateController;
 const dream_1 = require("@rvoh/dream");
 const fs = require("fs/promises");
 const node_fs_1 = require("node:fs");
+const UnexpectedUndefined_js_1 = require("../error/UnexpectedUndefined.js");
 const EnvInternal_js_1 = require("../helpers/EnvInternal.js");
 const psychicFileAndDirPaths_js_1 = require("../helpers/path/psychicFileAndDirPaths.js");
 const psychicPath_js_1 = require("../helpers/path/psychicPath.js");
@@ -23,6 +24,10 @@ async function generateController({ fullyQualifiedControllerName, fullyQualified
         if (controllerNameParts.length > (isAdmin ? 1 : 0)) {
             // Write the ancestor controller
             const [baseAncestorName, baseAncestorImportStatement] = baseAncestorNameAndImport(controllerNameParts, isAdmin, { forBaseController: true });
+            if (baseAncestorName === undefined)
+                throw new UnexpectedUndefined_js_1.default();
+            if (baseAncestorImportStatement === undefined)
+                throw new UnexpectedUndefined_js_1.default();
             const baseControllerName = [...controllerNameParts, 'BaseController'].join('/');
             const { absDirPath, absFilePath } = (0, psychicFileAndDirPaths_js_1.default)((0, psychicPath_js_1.default)('controllers'), baseControllerName + `.ts`);
             await fs.mkdir(absDirPath, { recursive: true });
@@ -35,12 +40,18 @@ async function generateController({ fullyQualifiedControllerName, fullyQualified
                 }));
             }
         }
-        controllerNameParts.push(allControllerNameParts[index]);
+        const namedPart = allControllerNameParts[index];
+        if (namedPart)
+            controllerNameParts.push(namedPart);
     }
     // Write the controller
     const [ancestorName, ancestorImportStatement] = baseAncestorNameAndImport(controllerNameParts, isAdmin, {
         forBaseController: false,
     });
+    if (ancestorName === undefined)
+        throw new UnexpectedUndefined_js_1.default();
+    if (ancestorImportStatement === undefined)
+        throw new UnexpectedUndefined_js_1.default();
     const { relFilePath, absDirPath, absFilePath } = (0, psychicFileAndDirPaths_js_1.default)((0, psychicPath_js_1.default)('controllers'), fullyQualifiedControllerName + `.ts`);
     await fs.mkdir(absDirPath, { recursive: true });
     try {

package/dist/cjs/src/generate/helpers/addResourceToRoutes.js

@@ -4,6 +4,7 @@ exports.default = addResourceToRoutes;
 exports.addResourceToRoutes_routeToRegexAndReplacements = addResourceToRoutes_routeToRegexAndReplacements;
 const fs = require("fs/promises");
 const path = require("path");
+const UnexpectedUndefined_js_1 = require("../../error/UnexpectedUndefined.js");
 const psychicPath_js_1 = require("../../helpers/path/psychicPath.js");
 const index_js_1 = require("../../psychic-application/index.js");
 async function addResourceToRoutes(route) {
@@ -13,6 +14,8 @@ async function addResourceToRoutes(route) {
     const matchesAndReplacements = addResourceToRoutes_routeToRegexAndReplacements(route);
     for (let index = 0; index < matchesAndReplacements.length; index++) {
         const matchAndReplacement = matchesAndReplacements[index];
+        if (matchAndReplacement === undefined)
+            throw new UnexpectedUndefined_js_1.default();
         if (matchAndReplacement.regex.test(routes)) {
             routes = routes.replace(matchAndReplacement.regex, matchAndReplacement.replacement +
                 closeBrackets(index, indent(matchesAndReplacements.length - index - 1)) +

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

@@ -2,8 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = openapiJsonPath;
 const path = require("path");
+const UnexpectedUndefined_js_1 = require("../error/UnexpectedUndefined.js");
 const index_js_1 = require("../psychic-application/index.js");
 function openapiJsonPath(openapiName = 'default') {
     const psychicApp = index_js_1.default.getOrFail();
-    return path.join(psychicApp.apiRoot, psychicApp.openapi[openapiName].outputFilename);
+    const namedOpenapi = psychicApp.openapi[openapiName];
+    if (namedOpenapi === undefined)
+        throw new UnexpectedUndefined_js_1.default();
+    return path.join(psychicApp.apiRoot, namedOpenapi.outputFilename);
 }

package/dist/cjs/src/i18n/provider.js

@@ -51,7 +51,10 @@ function applyInterpolations(i18nPathString, str, interpolations) {
     return str;
 }
 function _i18n(i18nHash, i18nPath) {
-    const translation = i18nHash[i18nPath[0]];
+    const index = i18nPath[0];
+    if (index === undefined)
+        throw new TranslationMissing();
+    const translation = i18nHash[index];
     if (translation === undefined)
         throw new TranslationMissing();
     if (typeof translation === 'string')

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

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const dream_1 = require("@rvoh/dream");
 const fs = require("fs/promises");
 const lodash_es_1 = require("lodash-es");
+const UnexpectedUndefined_js_1 = require("../error/UnexpectedUndefined.js");
 const EnvInternal_js_1 = require("../helpers/EnvInternal.js");
 const openapiJsonPath_js_1 = require("../helpers/openapiJsonPath.js");
 const index_js_1 = require("../psychic-application/index.js");
@@ -89,22 +91,30 @@ class OpenapiAppRenderer {
                 if (EnvInternal_js_1.default.isDebug)
                     console.log(`Processing OpenAPI key ${key} for controller ${controllerName}`);
                 const renderer = controller.openapi[key];
+                if (renderer === undefined)
+                    throw new UnexpectedUndefined_js_1.default();
                 finalOutput.components.schemas = {
                     ...finalOutput.components.schemas,
                     ...renderer.toSchemaObject(openapiName, processedSchemas),
                 };
                 const endpointPayload = renderer.toPathObject(openapiName, processedSchemas, routes);
+                if (endpointPayload === undefined)
+                    throw new UnexpectedUndefined_js_1.default();
                 const path = Object.keys(endpointPayload)[0];
-                const method = Object.keys(endpointPayload[path]).find(key => types_js_1.HttpMethods.includes(key));
+                if (path === undefined)
+                    throw new UnexpectedUndefined_js_1.default();
+                const endpointPayloadPath = endpointPayload[path];
+                if (endpointPayloadPath === undefined)
+                    throw new UnexpectedUndefined_js_1.default();
+                const method = Object.keys(endpointPayloadPath).find(key => types_js_1.HttpMethods.includes(key));
                 if (!finalOutput.paths[path]) {
                     finalOutput.paths[path] = { parameters: [] };
                 }
-                const pathObj = finalOutput.paths[path];
-                const otherPathObj = endpointPayload[path];
-                pathObj[method] = otherPathObj[method];
-                pathObj.parameters = this.combineParameters([
-                    ...pathObj.parameters,
-                    ...endpointPayload[path].parameters,
+                const finalPathObject = finalOutput.paths[path];
+                finalPathObject[method] = endpointPayloadPath[method];
+                finalPathObject.parameters = this.combineParameters([
+                    ...finalPathObject.parameters,
+                    ...endpointPayloadPath.parameters,
                 ]);
             }
         }
@@ -112,24 +122,26 @@ class OpenapiAppRenderer {
     }
     static combineParameters(parameters) {
         const groupedParams = (0, lodash_es_1.groupBy)(parameters, 'name');
-        const result = Object.keys(groupedParams).map(paramName => {
-            const identicalParams = groupedParams[paramName];
+        return (0, dream_1.compact)(Object.keys(groupedParams).map(paramName => {
+            const identicalParams = groupedParams[paramName] || [];
             return identicalParams.reduce((compositeParam, param) => {
+                if (compositeParam === undefined)
+                    throw new UnexpectedUndefined_js_1.default();
                 compositeParam.description ||= param.description;
-                if (compositeParam.allowEmptyValue !== undefined)
+                if (param.allowEmptyValue !== undefined)
                     compositeParam.allowEmptyValue = param.allowEmptyValue;
-                if (compositeParam.allowReserved !== undefined)
+                if (param.allowReserved !== undefined)
                     compositeParam.allowReserved = param.allowReserved;
-                if (compositeParam.required !== undefined)
+                if (param.required !== undefined)
                     compositeParam.required = param.required;
                 return compositeParam;
             }, identicalParams[0]);
-        });
-        return result;
+        }));
     }
     static sortedSchemaPayload(schema) {
         const sortedPaths = Object.keys(schema.paths).sort();
-        const sortedSchemas = Object.keys(schema.components.schemas).sort();
+        const schemas = schema.components.schemas || {};
+        const sortedSchemaNames = Object.keys(schemas).sort();
         const sortedSchema = { ...schema };
         // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
         sortedSchema.paths = sortedPaths.reduce((agg, path) => {
@@ -140,9 +152,9 @@ class OpenapiAppRenderer {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
         }, {});
         // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-        sortedSchema.components.schemas = sortedSchemas.reduce((agg, key) => {
+        sortedSchema.components.schemas = sortedSchemaNames.reduce((agg, key) => {
             // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-            agg[key] = schema.components.schemas[key];
+            agg[key] = schemas[key];
             // eslint-disable-next-line @typescript-eslint/no-unsafe-return
             return agg;
             // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/dist/cjs/src/openapi-renderer/body-segment.js

@@ -174,8 +174,9 @@ class OpenapiBodySegmentRenderer {
         if (bodySegment.nullable) {
             data.nullable = true;
         }
-        if (bodySegment.description) {
-            data.description = bodySegment.description;
+        const description = bodySegment.description;
+        if (description) {
+            data.description = description;
         }
         return data;
     }

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

@@ -103,19 +103,22 @@ class OpenapiEndpointRenderer {
                 },
             },
         };
+        const outputPath = output[path];
+        if (outputPath === undefined)
+            throw new Error(`no output for path ${path}`);
         if (this.summary) {
-            output[path][method].summary = this.summary;
+            outputPath[method].summary = this.summary;
         }
         if (this.description) {
-            output[path][method].description = this.description;
+            outputPath[method].description = this.description;
         }
         if (this.security) {
-            output[path][method].security = this.security;
+            outputPath[method].security = this.security;
         }
         if (requestBody) {
-            output[path][method]['requestBody'] = requestBody;
+            outputPath[method]['requestBody'] = requestBody;
         }
-        output[path][method].responses = responses;
+        outputPath[method].responses = responses;
         return output;
     }
     /**
@@ -263,8 +266,10 @@ class OpenapiEndpointRenderer {
             ? {}
             : this.openapiOpts(openapiName)?.defaults?.headers || {};
         const headers = { ...defaultHeaders, ...(this.headers || []) };
-        return (Object.keys(headers).map((headerName) => {
+        return ((0, dream_1.compact)(Object.keys(headers).map((headerName) => {
             const header = headers[headerName];
+            if (header === undefined)
+                return null;
             const data = {
                 in: 'header',
                 name: headerName,
@@ -278,7 +283,7 @@ class OpenapiEndpointRenderer {
                 data.schema.format = header.format;
             }
             return data;
-        }) || []);
+        })) || []);
     }
     /**
      * @internal
@@ -292,20 +297,20 @@ class OpenapiEndpointRenderer {
             let output = {
                 in: 'query',
                 name: queryName,
-                description: queryParam.description || queryName,
+                description: queryParam?.description || queryName,
                 allowReserved: true,
                 ...queryParam,
                 schema: {
                     type: 'string',
                 },
             };
-            if (typeof queryParam.allowEmptyValue === 'boolean') {
+            if (typeof queryParam?.allowEmptyValue === 'boolean') {
                 output.allowEmptyValue = queryParam.allowEmptyValue;
             }
-            if (typeof queryParam.allowReserved === 'boolean') {
+            if (typeof queryParam?.allowReserved === 'boolean') {
                 output.allowReserved = queryParam.allowReserved;
             }
-            if (queryParam.schema) {
+            if (queryParam?.schema) {
                 output = {
                     ...output,
                     // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
@@ -617,10 +622,16 @@ class OpenapiEndpointRenderer {
                 ...defaultResponses,
             });
         Object.keys(psychicAndConfigLevelDefaults).forEach(key => {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
             if (!responseData[key]) {
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
-                responseData[key] = psychicAndConfigLevelDefaults[key];
+                const data = psychicAndConfigLevelDefaults[key];
+                switch (key) {
+                    case 'summary':
+                    case 'description':
+                        responseData[key] = data;
+                        break;
+                    default:
+                        responseData[key] = data;
+                }
             }
         });
         return responseData;
@@ -677,6 +688,8 @@ class OpenapiEndpointRenderer {
      */
     parseSingleEntitySerializerResponseShape() {
         const serializerClass = this.getSerializerClasses()[0];
+        if (serializerClass === undefined)
+            throw new Error('getSerializerClasses returned no serializer classes');
         const serializerKey = serializerClass.openapiName;
         // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
         const serializerObject = this.accountForNullableOption({
@@ -818,7 +831,9 @@ class OpenapiEndpointRenderer {
             const modelClass = dreamOrSerializerOrViewModel;
             const modelPrototype = modelClass.prototype;
             const serializerKey = modelPrototype.serializers[this.serializerKey || 'default'];
-            return dreamApp.serializers[serializerKey] || null;
+            if (serializerKey === undefined)
+                throw new Error(`no serializerKey for ${this.serializerKey || 'default'}`);
+            return dreamApp.serializers[serializerKey] ?? null;
         }
     }
 }

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const dream_1 = require("@rvoh/dream");
 const CannotFlattenMultiplePolymorphicRendersOneAssociations_js_1 = require("../error/openapi/CannotFlattenMultiplePolymorphicRendersOneAssociations.js");
+const UnexpectedUndefined_js_1 = require("../error/UnexpectedUndefined.js");
 const EnvInternal_js_1 = require("../helpers/EnvInternal.js");
 const index_js_1 = require("../psychic-application/index.js");
 const body_segment_js_1 = require("./body-segment.js");
@@ -80,6 +81,9 @@ class OpenapiSerializerRenderer {
         let finalOutput = { ...serializerPayload };
         let flattenedPolymorphicSchemas = [];
         let flattenedPolymorphicAssociation;
+        const finalOutputForSerializerKey = finalOutput[serializerKey];
+        if (finalOutputForSerializerKey === undefined)
+            throw new UnexpectedUndefined_js_1.default();
         associations.forEach(association => {
             const associatedSerializers = dream_1.DreamSerializer.getAssociatedSerializersForOpenapi(association);
             if (!associatedSerializers)
@@ -118,10 +122,10 @@ Error: ${this.serializerClass.name} missing explicit serializer definition for $
                     ...finalOutput,
                     [serializerKey]: {
                         anyOf: [
-                            { ...finalOutput[serializerKey] },
+                            { ...finalOutputForSerializerKey },
                             {
                                 allOf: [
-                                    { ...finalOutput[serializerKey] },
+                                    { ...finalOutputForSerializerKey },
                                     { anyOf: flattenedPolymorphicSchemas.map(schema => ({ $schema: schema })) },
                                 ],
                             },
@@ -134,7 +138,7 @@ Error: ${this.serializerClass.name} missing explicit serializer definition for $
                     ...finalOutput,
                     [serializerKey]: {
                         allOf: [
-                            { ...finalOutput[serializerKey] },
+                            { ...finalOutputForSerializerKey },
                             { anyOf: flattenedPolymorphicSchemas.map(schema => ({ $schema: schema })) },
                         ],
                     },
@@ -154,22 +158,27 @@ Error: ${this.serializerClass.name} missing explicit serializer definition for $
      */
     addSingleSerializerAssociationToOutput({ associatedSerializers, finalOutput, serializerKey, association, }) {
         const associatedSerializer = associatedSerializers[0];
+        if (associatedSerializer === undefined)
+            throw new UnexpectedUndefined_js_1.default();
         const associatedSerializerKey = associatedSerializer.openapiName;
         if (EnvInternal_js_1.default.isDebug)
             index_js_1.default.log(`Processing serializer ${associatedSerializerKey}`);
         let flattenedData;
+        const finalOutputForSerializerKey = finalOutput[serializerKey];
+        if (finalOutputForSerializerKey === undefined)
+            throw new UnexpectedUndefined_js_1.default();
         switch (association.type) {
             case 'RendersMany':
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access
                 ;
-                finalOutput[serializerKey].properties[association.field] = {
+                finalOutputForSerializerKey.properties[association.field] = {
                     type: 'array',
                     items: {
                         $ref: `#/components/schemas/${associatedSerializerKey}`,
                     },
                 };
-                finalOutput[serializerKey].required = (0, dream_1.uniq)([
-                    ...(finalOutput[serializerKey].required || []),
+                finalOutputForSerializerKey.required = (0, dream_1.uniq)([
+                    ...(finalOutputForSerializerKey.required || []),
                     association.field,
                 ]);
                 break;
@@ -181,8 +190,8 @@ Error: ${this.serializerClass.name} missing explicit serializer definition for $
                     });
                     finalOutput[serializerKey].properties = flattenedData;
                     if (!association.optional) {
-                        finalOutput[serializerKey].required = (0, dream_1.uniq)([
-                            ...(finalOutput[serializerKey].required || []),
+                        finalOutputForSerializerKey.required = (0, dream_1.uniq)([
+                            ...(finalOutputForSerializerKey.required || []),
                             ...Object.keys(flattenedData),
                         ]);
                     }
@@ -193,8 +202,8 @@ Error: ${this.serializerClass.name} missing explicit serializer definition for $
                     finalOutput[serializerKey].properties[association.field] = this.accountForNullableOption({
                         $ref: `#/components/schemas/${associatedSerializerKey}`,
                     }, association.optional);
-                    finalOutput[serializerKey].required = (0, dream_1.uniq)([
-                        ...(finalOutput[serializerKey].required || []),
+                    finalOutputForSerializerKey.required = (0, dream_1.uniq)([
+                        ...(finalOutputForSerializerKey.required || []),
                         association.field,
                     ]);
                 }
@@ -244,6 +253,9 @@ Error: ${this.serializerClass.name} missing explicit serializer definition for $
      * each pointing to its respective target serializer.
      */
     addMultiSerializerAssociationToOutput({ associatedSerializers, finalOutput, serializerKey, association, flattenedPolymorphicSchemas, flattenedPolymorphicAssociation, }) {
+        const finalOutputForSerializerKey = finalOutput[serializerKey];
+        if (finalOutputForSerializerKey === undefined)
+            throw new UnexpectedUndefined_js_1.default();
         if (association.flatten) {
             if (flattenedPolymorphicSchemas.length)
                 throw new CannotFlattenMultiplePolymorphicRendersOneAssociations_js_1.default(this.serializerClass, association.field);
@@ -271,8 +283,8 @@ Error: ${this.serializerClass.name} missing explicit serializer definition for $
                 const associatedSerializerKey = associatedSerializer.openapiName;
                 if (EnvInternal_js_1.default.isDebug)
                     index_js_1.default.log(`Processing serializer ${associatedSerializerKey}`);
-                finalOutput[serializerKey].required = (0, dream_1.uniq)([
-                    ...(finalOutput[serializerKey].required || []),
+                finalOutputForSerializerKey.required = (0, dream_1.uniq)([
+                    ...(finalOutputForSerializerKey.required || []),
                     association.field,
                 ]);
                 switch (association.type) {