@rvoh/psychic 0.26.2 → 0.27.0

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/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/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) {

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

@@ -7,8 +7,9 @@ SELECT pg_type.typname AS enum_type, pg_enum.enumlabel AS enum_label FROM pg_typ
 `.execute(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/esm/src/bin/helpers/enumsFileStr.js

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

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

@@ -1,6 +1,7 @@
 import { spawn } from 'child_process';
 import { createServer } from 'net';
 import sleep from '../../../spec/helpers/sleep.js';
+import UnexpectedUndefined from '../../error/UnexpectedUndefined.js';
 const devServerProcesses = {};
 export async function launchDevServer(key, { port = 3000, cmd = 'yarn client', timeout = 5000 } = {}) {
     if (devServerProcesses[key])
@@ -8,6 +9,8 @@ export async function launchDevServer(key, { port = 3000, cmd = 'yarn client', t
     if (process.env.DEBUG === '1')
         console.log('Starting server...');
     const [_cmd, ...args] = cmd.split(' ');
+    if (_cmd === undefined)
+        throw new UnexpectedUndefined();
     const proc = spawn(_cmd, args, {
         detached: true,
         env: {

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

@@ -0,0 +1,11 @@
+export default 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.`;
+    }
+}

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

@@ -1,6 +1,7 @@
 import { hyphenize, standardizeFullyQualifiedModelName } from '@rvoh/dream';
 import * as fs from 'fs/promises';
 import { existsSync } from 'node:fs';
+import UnexpectedUndefined from '../error/UnexpectedUndefined.js';
 import EnvInternal from '../helpers/EnvInternal.js';
 import psychicFileAndDirPaths from '../helpers/path/psychicFileAndDirPaths.js';
 import psychicPath from '../helpers/path/psychicPath.js';
@@ -20,6 +21,10 @@ export default async function generateController({ fullyQualifiedControllerName,
         if (controllerNameParts.length > (isAdmin ? 1 : 0)) {
             // Write the ancestor controller
             const [baseAncestorName, baseAncestorImportStatement] = baseAncestorNameAndImport(controllerNameParts, isAdmin, { forBaseController: true });
+            if (baseAncestorName === undefined)
+                throw new UnexpectedUndefined();
+            if (baseAncestorImportStatement === undefined)
+                throw new UnexpectedUndefined();
             const baseControllerName = [...controllerNameParts, 'BaseController'].join('/');
             const { absDirPath, absFilePath } = psychicFileAndDirPaths(psychicPath('controllers'), baseControllerName + `.ts`);
             await fs.mkdir(absDirPath, { recursive: true });
@@ -32,12 +37,18 @@ export default async function generateController({ fullyQualifiedControllerName,
                 }));
             }
         }
-        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();
+    if (ancestorImportStatement === undefined)
+        throw new UnexpectedUndefined();
     const { relFilePath, absDirPath, absFilePath } = psychicFileAndDirPaths(psychicPath('controllers'), fullyQualifiedControllerName + `.ts`);
     await fs.mkdir(absDirPath, { recursive: true });
     try {

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

@@ -1,5 +1,6 @@
 import * as fs from 'fs/promises';
 import * as path from 'path';
+import UnexpectedUndefined from '../../error/UnexpectedUndefined.js';
 import psychicPath from '../../helpers/path/psychicPath.js';
 import PsychicApplication from '../../psychic-application/index.js';
 export default async function addResourceToRoutes(route) {
@@ -9,6 +10,8 @@ export default 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();
         if (matchAndReplacement.regex.test(routes)) {
             routes = routes.replace(matchAndReplacement.regex, matchAndReplacement.replacement +
                 closeBrackets(index, indent(matchesAndReplacements.length - index - 1)) +

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

@@ -1,6 +1,10 @@
 import * as path from 'path';
+import UnexpectedUndefined from '../error/UnexpectedUndefined.js';
 import PsychicApplication from '../psychic-application/index.js';
 export default function openapiJsonPath(openapiName = 'default') {
     const psychicApp = PsychicApplication.getOrFail();
-    return path.join(psychicApp.apiRoot, psychicApp.openapi[openapiName].outputFilename);
+    const namedOpenapi = psychicApp.openapi[openapiName];
+    if (namedOpenapi === undefined)
+        throw new UnexpectedUndefined();
+    return path.join(psychicApp.apiRoot, namedOpenapi.outputFilename);
 }

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

@@ -46,7 +46,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/esm/src/openapi-renderer/app.js

@@ -1,5 +1,7 @@
+import { compact } from '@rvoh/dream';
 import * as fs from 'fs/promises';
 import { groupBy } from 'lodash-es';
+import UnexpectedUndefined from '../error/UnexpectedUndefined.js';
 import EnvInternal from '../helpers/EnvInternal.js';
 import openapiJsonPath from '../helpers/openapiJsonPath.js';
 import PsychicApplication from '../psychic-application/index.js';
@@ -87,22 +89,30 @@ export default class OpenapiAppRenderer {
                 if (EnvInternal.isDebug)
                     console.log(`Processing OpenAPI key ${key} for controller ${controllerName}`);
                 const renderer = controller.openapi[key];
+                if (renderer === undefined)
+                    throw new UnexpectedUndefined();
                 finalOutput.components.schemas = {
                     ...finalOutput.components.schemas,
                     ...renderer.toSchemaObject(openapiName, processedSchemas),
                 };
                 const endpointPayload = renderer.toPathObject(openapiName, processedSchemas, routes);
+                if (endpointPayload === undefined)
+                    throw new UnexpectedUndefined();
                 const path = Object.keys(endpointPayload)[0];
-                const method = Object.keys(endpointPayload[path]).find(key => HttpMethods.includes(key));
+                if (path === undefined)
+                    throw new UnexpectedUndefined();
+                const endpointPayloadPath = endpointPayload[path];
+                if (endpointPayloadPath === undefined)
+                    throw new UnexpectedUndefined();
+                const method = Object.keys(endpointPayloadPath).find(key => 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,
                 ]);
             }
         }
@@ -110,24 +120,26 @@ export default class OpenapiAppRenderer {
     }
     static combineParameters(parameters) {
         const groupedParams = groupBy(parameters, 'name');
-        const result = Object.keys(groupedParams).map(paramName => {
-            const identicalParams = groupedParams[paramName];
+        return compact(Object.keys(groupedParams).map(paramName => {
+            const identicalParams = groupedParams[paramName] || [];
             return identicalParams.reduce((compositeParam, param) => {
+                if (compositeParam === undefined)
+                    throw new UnexpectedUndefined();
                 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) => {
@@ -138,9 +150,9 @@ export default 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/esm/src/openapi-renderer/body-segment.js

@@ -172,8 +172,9 @@ export default 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/esm/src/openapi-renderer/endpoint.js

@@ -100,19 +100,22 @@ export default 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;
     }
     /**
@@ -260,8 +263,10 @@ export default class OpenapiEndpointRenderer {
             ? {}
             : this.openapiOpts(openapiName)?.defaults?.headers || {};
         const headers = { ...defaultHeaders, ...(this.headers || []) };
-        return (Object.keys(headers).map((headerName) => {
+        return (compact(Object.keys(headers).map((headerName) => {
             const header = headers[headerName];
+            if (header === undefined)
+                return null;
             const data = {
                 in: 'header',
                 name: headerName,
@@ -275,7 +280,7 @@ export default class OpenapiEndpointRenderer {
                 data.schema.format = header.format;
             }
             return data;
-        }) || []);
+        })) || []);
     }
     /**
      * @internal
@@ -289,20 +294,20 @@ export default 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
@@ -614,10 +619,16 @@ export default 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;
@@ -674,6 +685,8 @@ export default 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({
@@ -815,7 +828,9 @@ export default 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/esm/src/openapi-renderer/serializer.js

@@ -1,5 +1,6 @@
 import { DreamSerializer, uniq, } from '@rvoh/dream';
 import CannotFlattenMultiplePolymorphicRendersOneAssociations from '../error/openapi/CannotFlattenMultiplePolymorphicRendersOneAssociations.js';
+import UnexpectedUndefined from '../error/UnexpectedUndefined.js';
 import EnvInternal from '../helpers/EnvInternal.js';
 import PsychicApplication from '../psychic-application/index.js';
 import OpenapiBodySegmentRenderer from './body-segment.js';
@@ -78,6 +79,9 @@ export default class OpenapiSerializerRenderer {
         let finalOutput = { ...serializerPayload };
         let flattenedPolymorphicSchemas = [];
         let flattenedPolymorphicAssociation;
+        const finalOutputForSerializerKey = finalOutput[serializerKey];
+        if (finalOutputForSerializerKey === undefined)
+            throw new UnexpectedUndefined();
         associations.forEach(association => {
             const associatedSerializers = DreamSerializer.getAssociatedSerializersForOpenapi(association);
             if (!associatedSerializers)
@@ -116,10 +120,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 })) },
                                 ],
                             },
@@ -132,7 +136,7 @@ Error: ${this.serializerClass.name} missing explicit serializer definition for $
                     ...finalOutput,
                     [serializerKey]: {
                         allOf: [
-                            { ...finalOutput[serializerKey] },
+                            { ...finalOutputForSerializerKey },
                             { anyOf: flattenedPolymorphicSchemas.map(schema => ({ $schema: schema })) },
                         ],
                     },
@@ -152,22 +156,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();
         const associatedSerializerKey = associatedSerializer.openapiName;
         if (EnvInternal.isDebug)
             PsychicApplication.log(`Processing serializer ${associatedSerializerKey}`);
         let flattenedData;
+        const finalOutputForSerializerKey = finalOutput[serializerKey];
+        if (finalOutputForSerializerKey === undefined)
+            throw new UnexpectedUndefined();
         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 = uniq([
-                    ...(finalOutput[serializerKey].required || []),
+                finalOutputForSerializerKey.required = uniq([
+                    ...(finalOutputForSerializerKey.required || []),
                     association.field,
                 ]);
                 break;
@@ -179,8 +188,8 @@ Error: ${this.serializerClass.name} missing explicit serializer definition for $
                     });
                     finalOutput[serializerKey].properties = flattenedData;
                     if (!association.optional) {
-                        finalOutput[serializerKey].required = uniq([
-                            ...(finalOutput[serializerKey].required || []),
+                        finalOutputForSerializerKey.required = uniq([
+                            ...(finalOutputForSerializerKey.required || []),
                             ...Object.keys(flattenedData),
                         ]);
                     }
@@ -191,8 +200,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 = uniq([
-                        ...(finalOutput[serializerKey].required || []),
+                    finalOutputForSerializerKey.required = uniq([
+                        ...(finalOutputForSerializerKey.required || []),
                         association.field,
                     ]);
                 }
@@ -242,6 +251,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();
         if (association.flatten) {
             if (flattenedPolymorphicSchemas.length)
                 throw new CannotFlattenMultiplePolymorphicRendersOneAssociations(this.serializerClass, association.field);
@@ -269,8 +281,8 @@ Error: ${this.serializerClass.name} missing explicit serializer definition for $
                 const associatedSerializerKey = associatedSerializer.openapiName;
                 if (EnvInternal.isDebug)
                     PsychicApplication.log(`Processing serializer ${associatedSerializerKey}`);
-                finalOutput[serializerKey].required = uniq([
-                    ...(finalOutput[serializerKey].required || []),
+                finalOutputForSerializerKey.required = uniq([
+                    ...(finalOutputForSerializerKey.required || []),
                     association.field,
                 ]);
                 switch (association.type) {

package/dist/types/src/error/UnexpectedUndefined.d.ts

@@ -0,0 +1,4 @@
+export default class UnexpectedUndefined extends Error {
+    constructor();
+    get message(): string;
+}

package/dist/types/src/generate/helpers/generateControllerContent.d.ts

@@ -2,7 +2,7 @@ export default function generateControllerContent({ ancestorName, ancestorImport
     ancestorName: string;
     ancestorImportStatement: string;
     fullyQualifiedControllerName: string;
-    fullyQualifiedModelName?: string;
-    actions?: string[];
-    omitOpenApi?: boolean;
+    fullyQualifiedModelName?: string | undefined;
+    actions?: string[] | undefined;
+    omitOpenApi?: boolean | undefined;
 }): string;

package/package.json

@@ -2,9 +2,12 @@
   "type": "module",
   "name": "@rvoh/psychic",
   "description": "Typescript web framework",
-  "version": "0.26.2",
+  "version": "0.27.0",
   "author": "RVOHealth",
-  "repository": "https://github.com/rvohealth/psychic.git",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rvohealth/psychic.git"
+  },
   "license": "MIT",
   "main": "./dist/cjs/src/index.js",
   "module": "./dist/esm/src/index.js",
@@ -27,7 +30,7 @@
     "psycore": "PSYCHIC_CORE_DEVELOPMENT=1 yarn psyts",
     "gpsycore": "PSYCHIC_CORE_DEVELOPMENT=1 tsx ./global-cli/main.ts",
     "build": "echo \"building cjs...\" && rm -rf dist && npx tsc -p ./tsconfig.cjs.build.json && echo \"building esm...\" && npx tsc -p ./tsconfig.esm.build.json",
-    "build:core": "rm -rf dist && echo \"building core app to esm...\" && npx tsc -p ./tsconfig.esm.build.core.json && echo \"building core app to cjs...\" && npx tsc -p ./tsconfig.cjs.build.core.json",
+    "build:test-app": "rm -rf dist && echo \"building test app to esm...\" && npx tsc -p ./tsconfig.esm.build.test-app.json && echo \"building test app to cjs...\" && npx tsc -p ./tsconfig.cjs.build.test-app.json",
     "dev": "PSYCHIC_CORE_DEVELOPMENT=1 NODE_ENV=development tsx ./test-app/main.ts",
     "console": "PSYCHIC_CORE_DEVELOPMENT=1 tsx ./test-app/src/conf/repl.ts",
     "uspec": "PSYCHIC_CORE_DEVELOPMENT=1 vitest --config ./spec/unit/vite.config.ts",
@@ -86,8 +89,8 @@
     "typedoc": "^0.26.6",
     "typescript": "^5.5.4",
     "typescript-eslint": "=7.18.0",
-    "vitest": "^3.0.8",
+    "vitest": "^3.0.9",
     "winston": "^3.14.2"
   },
   "packageManager": "yarn@4.7.0"
-}
+}