@rvoh/psychic 2.1.0 → 2.2.0

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

@@ -0,0 +1,341 @@
+import { DreamCLI } from '@rvoh/dream/system';
+import * as cp from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import colorize from '../../cli/helpers/colorize.js';
+/**
+ * Class-based OpenAPI specification diff tool
+ *
+ * Compares current OpenAPI specs against the head branch using oasdiff
+ *
+ * Example usages:
+ *
+ * Instance-based usage
+ *    const diffTool = new OpenApiSpecDiff()
+ *    diffTool.compare(openapiConfigs)
+ *
+ * Factory method usage
+ *    const diffTool = OpenApiSpecDiff.create()
+ *    diffTool.compare(openapiConfigs)
+ *
+ * Static method usage (backward compatibility)
+ *    OpenApiSpecDiff.compare(openapiConfigs)
+ */
+export class OpenApiSpecDiff {
+    /**
+     * The configuration for the oasdiff command
+     */
+    oasdiffConfig;
+    /**
+     * Compares a list of OpenAPI specifications between the current branch and the head branch.
+     *
+     * Uses `oasdiff` under the hood to detect breaking and non-breaking changes for each file,
+     * helping you review and validate API updates with confidence before merging.
+     *
+     * This tool only runs for configurations where `checkDiffs` is enabled.
+     *
+     * @param openapiConfigs - An array of tuples containing the OpenAPI file name and its configuration.
+     * @example
+     * ```ts
+     * const openapiConfigs: [string, PsychicOpenapiConfig][] = [
+     *   ['openapi', { outputFilepath: 'openapi.json' }],
+     * ]
+     * OpenApiSpecDiff.compare(openapiConfigs)
+     * ```
+     */
+    compare(openapiConfigs) {
+        const results = [];
+        this.oasdiffConfig = this.getOasDiffConfig();
+        const comparing = colorize(`🔍 Comparing current OpenAPI Specs against ${this.oasdiffConfig.headBranch}...`, { color: 'cyanBright' });
+        DreamCLI.logger.logStartProgress(comparing, { logPrefixColor: 'cyanBright' });
+        DreamCLI.logger.logContinueProgress(`\n`, { logPrefixColor: 'cyanBright' });
+        for (const [openapiName, config] of openapiConfigs) {
+            const result = this.compareConfig(openapiName, config);
+            results.push(result);
+        }
+        this.processResults(results);
+    }
+    /**
+     * Checks if oasdiff is installed locally
+     */
+    hasOasDiffInstalled() {
+        try {
+            cp.execSync('oasdiff --version', { stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Fetch the head branch of a remote using git remote show origin
+     * default to main if not set
+     */
+    getHeadBranch() {
+        let head = '';
+        const output = cp.execSync('git remote show origin', { encoding: 'utf-8' });
+        const lines = output.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('HEAD branch:')) {
+                head = trimmed.replace('HEAD branch:', '').trim() || 'main';
+            }
+        }
+        return head;
+    }
+    /**
+     * Validates that oasdiff is installed and builds the oasdiff config
+     */
+    getOasDiffConfig() {
+        const headBranch = this.getHeadBranch();
+        if (this.hasOasDiffInstalled()) {
+            DreamCLI.logger.logContinueProgress('🎉 oasdiff package found\n');
+            return {
+                command: 'oasdiff',
+                baseArgs: [],
+                headBranch,
+            };
+        }
+        throw new Error(`⚠️ oasdiff not found.
+    
+      Install it via the instructions here:
+        https://github.com/tufin/oasdiff
+      `);
+    }
+    /**
+     * Runs oasdiff command and returns the output
+     */
+    runOasDiffCommand(subcommand, mainPath, currentPath, flags) {
+        if (!this.oasdiffConfig) {
+            throw new Error('OasDiff config not initialized');
+        }
+        const args = [...this.oasdiffConfig.baseArgs, subcommand, mainPath, currentPath];
+        if (flags && flags.length > 0) {
+            args.push(...flags.map(flag => `--${flag}`));
+        }
+        try {
+            const output = cp.execFileSync(this.oasdiffConfig.command, args, {
+                shell: true,
+                encoding: 'utf8',
+                cwd: process.cwd(),
+                stdio: 'pipe',
+            });
+            return output.trim();
+        }
+        catch (error) {
+            const errorOutput = error instanceof Error ? error.message : String(error);
+            return errorOutput;
+        }
+    }
+    /**
+     * Compares two OpenAPI files using oasdiff
+     */
+    compareSpecs(mainFilePath, currentFilePath) {
+        if (!this.oasdiffConfig) {
+            throw new Error('OasDiff config not initialized');
+        }
+        const breakingChanges = this.runOasDiffCommand('breaking', mainFilePath, currentFilePath);
+        const changelogChanges = this.runOasDiffCommand('changelog', mainFilePath, currentFilePath);
+        const breaking = breakingChanges && !breakingChanges.includes('Command failed')
+            ? breakingChanges.split('\n').filter(line => line.trim())
+            : [];
+        const changelog = changelogChanges && !changelogChanges.includes('Command failed')
+            ? changelogChanges.split('\n').filter(line => line.trim())
+            : [];
+        const failedToCompare = breakingChanges.includes('Command failed')
+            ? breakingChanges
+            : changelogChanges.includes('Command failed')
+                ? changelogChanges
+                : '';
+        return {
+            breaking,
+            changelog,
+            error: failedToCompare,
+        };
+    }
+    /**
+     * Creates a temporary file path for the head branch content
+     */
+    createTempFilePath(filePath) {
+        const tempFileName = `temp_main_${path.basename(filePath)}`;
+        return path.join(path.dirname(filePath), tempFileName);
+    }
+    /**
+     * Retrieves head branch content for a file
+     */
+    getHeadBranchContent(filePath) {
+        if (!this.oasdiffConfig) {
+            throw new Error('OasDiff config not initialized');
+        }
+        const branchRef = process.env.CI === '1' ? `origin/${this.oasdiffConfig.headBranch}` : this.oasdiffConfig.headBranch;
+        return cp.execSync(`git show ${branchRef}:${filePath}`, {
+            encoding: 'utf8',
+            cwd: process.cwd(),
+        });
+    }
+    /**
+     * Compares a single OpenAPI file against head branch
+     */
+    compareConfig(openapiName, config) {
+        const result = {
+            file: openapiName,
+            hasChanges: false,
+            breaking: [],
+            changelog: [],
+        };
+        const currentFilePath = config.outputFilepath;
+        if (!fs.existsSync(currentFilePath)) {
+            result.error = `File ${config.outputFilepath} does not exist in current branch`;
+            return result;
+        }
+        const tempMainFilePath = this.createTempFilePath(config.outputFilepath);
+        const mainContent = this.getHeadBranchContent(config.outputFilepath);
+        fs.mkdirSync(path.dirname(tempMainFilePath), { recursive: true });
+        fs.writeFileSync(tempMainFilePath, mainContent);
+        try {
+            const { breaking, changelog, error } = this.compareSpecs(tempMainFilePath, currentFilePath);
+            result.breaking = breaking;
+            result.changelog = changelog;
+            result.hasChanges = breaking.length > 0 || changelog.length > 0;
+            result.error = error ?? '';
+        }
+        catch (error) {
+            result.error = `Could not retrieve ${config.outputFilepath} from ${this.oasdiffConfig?.headBranch} branch: ${String(error)}`;
+        }
+        finally {
+            if (fs.existsSync(tempMainFilePath)) {
+                fs.unlinkSync(tempMainFilePath);
+            }
+        }
+        return result;
+    }
+    /**
+     * Process and display the comparison results
+     */
+    processResults(results) {
+        let hasAnyChanges = false;
+        let hasBreakingChanges = false;
+        for (const result of results) {
+            if (result.error) {
+                this.logError(result);
+            }
+            else if (result.hasChanges) {
+                this.logChanges(result);
+                hasAnyChanges = true;
+                if (result.breaking.length > 0) {
+                    this.logBreakingChanges(result);
+                    hasBreakingChanges = true;
+                }
+                if (result.changelog.length > 0) {
+                    this.logChangelog(result);
+                }
+            }
+            else {
+                this.logNoChanges(result);
+            }
+        }
+        this.logSummary(hasAnyChanges, hasBreakingChanges);
+    }
+    /**
+     * Log error for a comparison result
+     */
+    logError(result) {
+        const file = colorize(`❌ ${result.file}`, { color: 'whiteBright' });
+        const error = colorize(`${result.error}`, { color: 'redBright' });
+        DreamCLI.logger.logContinueProgress(`${file}: ${error}`, { logPrefixColor: 'redBright' });
+    }
+    /**
+     * Log changes for a comparison result
+     */
+    logChanges(result) {
+        const file = colorize(`${result.file}`, { color: 'whiteBright' });
+        const changes = colorize('HAS CHANGES', { color: 'yellowBright' });
+        DreamCLI.logger.logContinueProgress(`${file}: ${changes}`, { logPrefixColor: 'yellowBright' });
+    }
+    /**
+     * Log breaking changes for a comparison result
+     */
+    logBreakingChanges(result) {
+        DreamCLI.logger.logContinueProgress(`   ${colorize(`🚨 BREAKING CHANGES:`, { color: 'redBright' })}`, {
+            logPrefixColor: 'redBright',
+        });
+        result.breaking.forEach(change => {
+            DreamCLI.logger.logContinueProgress(`      ${colorize(`• ${change}`, { color: 'redBright' })}`, {
+                logPrefixColor: 'redBright',
+            });
+        });
+    }
+    /**
+     * Log changelog for a comparison result
+     */
+    logChangelog(result) {
+        DreamCLI.logger.logContinueProgress(`   ${colorize(`📋 CHANGELOG:`, { color: 'blueBright' })}`, {
+            logPrefixColor: 'blueBright',
+        });
+        const changelogLines = result.changelog;
+        changelogLines.forEach(line => {
+            DreamCLI.logger.logContinueProgress(`      ${colorize(line, { color: 'whiteBright' })}`, {
+                logPrefixBgColor: 'bgWhite',
+                logPrefixColor: 'white',
+            });
+        });
+    }
+    /**
+     * Log no changes for a comparison result
+     */
+    logNoChanges(result) {
+        const file = colorize(`${result.file}`, { color: 'whiteBright' });
+        const changes = colorize('No changes', { color: 'greenBright' });
+        DreamCLI.logger.logContinueProgress(`${file}: ${changes}`, { logPrefixColor: 'greenBright' });
+    }
+    /**
+     * Log final summary and handle exit conditions
+     */
+    logSummary(hasAnyChanges, hasBreakingChanges) {
+        DreamCLI.logger.logContinueProgress(`\n${colorize(`${'='.repeat(60)}`, { color: 'gray' })}`, {
+            logPrefixColor: 'gray',
+        });
+        if (hasBreakingChanges) {
+            DreamCLI.logger.logContinueProgress(`${colorize(`🚨 CRITICAL:`, { color: 'redBright' })} ${colorize(`Breaking changes detected in current branch compared to ${this.oasdiffConfig?.headBranch}! Review before merging.`, { color: 'whiteBright' })}`, { logPrefixColor: 'redBright' });
+            DreamCLI.logger.logContinueProgress(`${colorize(`${'='.repeat(60)}`, { color: 'gray' })}`, {
+                logPrefixColor: 'gray',
+            });
+            DreamCLI.logger.logContinueProgress('\n'.repeat(5), {
+                logPrefixColor: 'gray',
+            });
+            throw new BreakingChangesDetectedInOpenApiSpecError(this.oasdiffConfig);
+        }
+        else if (hasAnyChanges) {
+            const summary = colorize(`📊 Summary: Some OpenAPI files have non-breaking changes in current branch compared to ${this.oasdiffConfig?.headBranch}`, { color: 'yellow' });
+            DreamCLI.logger.logContinueProgress(summary, { logPrefixColor: 'yellow' });
+        }
+        else {
+            const summary = colorize(`📊 Summary: All OpenAPI files in current branch are identical to ${this.oasdiffConfig?.headBranch} branch`, { color: 'green' });
+            DreamCLI.logger.logContinueProgress(summary, { logPrefixColor: 'green' });
+        }
+    }
+    /**
+     * Static factory method for convenience
+     */
+    static create() {
+        return new OpenApiSpecDiff();
+    }
+    /**
+     * Static method to maintain compatibility with functional approach
+     */
+    static compare(openapiConfigs) {
+        const instance = OpenApiSpecDiff.create();
+        instance.compare(openapiConfigs);
+    }
+}
+export class BreakingChangesDetectedInOpenApiSpecError extends Error {
+    oasdiffConfig;
+    constructor(oasdiffConfig) {
+        super();
+        this.oasdiffConfig = oasdiffConfig;
+        this.name = 'BreakingChangesDetectedInOpenApiSpecError';
+    }
+    get message() {
+        return `Breaking changes detected in current branch compared to ${this.oasdiffConfig.headBranch}! Review before merging.`;
+    }
+}

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

@@ -9,7 +9,9 @@ import OpenapiAppRenderer from '../openapi-renderer/app.js';
 import PsychicApp from '../psychic-app/index.js';
 import enumsFileStr from './helpers/enumsFileStr.js';
 import generateRouteTypes from './helpers/generateRouteTypes.js';
+import { OpenApiSpecDiff } from './helpers/OpenApiSpecDiff.js';
 import printRoutes from './helpers/printRoutes.js';
+export { BreakingChangesDetectedInOpenApiSpecError } from './helpers/OpenApiSpecDiff.js';
 export default class PsychicBin {
     static async generateController(controllerName, actions) {
         await generateController({
@@ -59,6 +61,11 @@ export default class PsychicBin {
             await new ASTPsychicTypesBuilder().build();
         });
     }
+    static openapiDiff() {
+        const psychicApp = PsychicApp.getOrFail();
+        const openapiConfigsWithCheckDiffs = Object.entries(psychicApp.openapi).filter(([, config]) => config.checkDiffs);
+        OpenApiSpecDiff.compare(openapiConfigsWithCheckDiffs);
+    }
     static async syncOpenapiTypescriptFiles() {
         DreamCLI.logger.logStartProgress(`syncing openapi types...`);
         // https://rvohealth.atlassian.net/browse/PDTC-8359

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

@@ -1,5 +1,5 @@
 import { DreamCLI } from '@rvoh/dream/system';
-import PsychicBin from '../bin/index.js';
+import PsychicBin, { BreakingChangesDetectedInOpenApiSpecError } from '../bin/index.js';
 import generateController from '../generate/controller.js';
 import generateSyncEnumsInitializer from '../generate/initializer/syncEnums.js';
 import generateSyncOpenapiTypescriptInitializer from '../generate/initializer/syncOpenapiTypescript.js';
@@ -196,6 +196,27 @@ export default class PsychicCLI {
             await PsychicBin.syncOpenapiJson();
             process.exit();
         });
+        program
+            .command('diff:openapi')
+            .description('compares the current branch open api spec file(s) with the main/master/head branch open api spec file(s)')
+            .option('-f', '--fail-on-breaking', 'fail on spec changes that are breaking')
+            .action(async (options) => {
+            await initializePsychicApp();
+            try {
+                PsychicBin.openapiDiff();
+            }
+            catch (error) {
+                if (error instanceof BreakingChangesDetectedInOpenApiSpecError) {
+                    if (options.failOnBreaking) {
+                        console.error(error.message);
+                        process.exit(1);
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+        });
     }
     /**
      * @internal

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

@@ -131,7 +131,7 @@ export default class PsychicController {
     /**
      * @internal
      *
-     * Used for displaying routes when running `yarn psy routes`
+     * Used for displaying routes when running `pnpm psy routes`
      * cli command
      */
     static get disaplayName() {

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

@@ -6,7 +6,7 @@ import UnexpectedUndefined from '../../error/UnexpectedUndefined.js';
 import PsychicApp from '../../psychic-app/index.js';
 const devServerProcesses = {};
 const debugEnabled = debuglog('psychic').enabled;
-export async function launchDevServer(key, { port = 3000, cmd = 'yarn client', timeout = 5000 } = {}) {
+export async function launchDevServer(key, { port = 3000, cmd = 'pnpm client', timeout = 5000 } = {}) {
     if (devServerProcesses[key])
         return;
     if (debugEnabled)

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

@@ -10,7 +10,7 @@ within conf/app.ts, you must have a call to "#set('packageManager', '<YOUR_CHOSE
 
   // conf/app.ts
   export default async (psy: PsychicApp) => {
-    psy.set('packageManager', 'yarn')
+    psy.set('packageManager', 'pnpm')
   }
     `;
     }

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

@@ -87,8 +87,9 @@ function parseAttribute(attribute) {
     const [rawAttributeName, rawAttributeType, , enumValues] = attribute.split(':');
     if (!rawAttributeName || !rawAttributeType)
         return null;
+    const sanitizedAttrType = camelize(rawAttributeType)?.toLowerCase();
     // Handle belongs_to relationships
-    if (rawAttributeType === 'belongs_to') {
+    if (sanitizedAttrType === 'belongsto') {
         // For belongs_to relationships, convert "Ticketing/Ticket" to "ticket"
         const attributeName = camelize(rawAttributeName.split('/').pop());
         return { attributeName, attributeType: 'belongs_to', isArray: false, enumValues };
@@ -105,8 +106,9 @@ function parseAttribute(attribute) {
     return { attributeName, attributeType, isArray, enumValues };
 }
 function processAttributeByType({ attributeType, attributeName, isArray, enumValues, dotNotationVariable, fullyQualifiedModelName, attributeData, }) {
-    switch (attributeType) {
-        case 'belongs_to':
+    const sanitizedAttributeType = camelize(attributeType).toLowerCase();
+    switch (sanitizedAttributeType) {
+        case 'belongsto':
             // belongs_to relationships are NOT included in comparable attributes or create/update data
             // They are only tracked for original values in update contexts
             break;

package/dist/cjs/src/generate/helpers/syncOpenapiTypescript/installOpenapiTypescript.js

@@ -8,7 +8,7 @@ export default async function installOpenapiTypescript() {
     try {
         await DreamCLI.spawn(cmd);
     }
-    catch (err) {
+    catch {
         console.log(`Failed to install openapi-typescript as a dev dependency. Please make sure the following command succeeds:
 
 "${cmd}"

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

@@ -298,6 +298,7 @@ function associationOpenapi(attribute, DataTypeForOpenapi, alreadyExtractedDesce
         if (associatedClass === undefined) {
             let serializerCheck;
             try {
+                // eslint-disable-next-line @typescript-eslint/no-unused-expressions
                 ;
                 DataTypeForOpenapi?.prototype?.serializers;
             }

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

@@ -57,7 +57,7 @@ export default class OpenapiAppRenderer {
             openapi: '3.1.0',
             info: {
                 version: openapiConfig?.info?.version || 'unknown version',
-                title: openapiConfig?.info?.title || 'unknown title',
+                title: openapiConfig?.info?.title || `${psychicApp.appName} | ${openapiName}`,
                 description: openapiConfig?.info?.description || 'The autogenerated openapi spec for your app',
             },
             paths: {},

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

@@ -0,0 +1,341 @@
+import { DreamCLI } from '@rvoh/dream/system';
+import * as cp from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import colorize from '../../cli/helpers/colorize.js';
+/**
+ * Class-based OpenAPI specification diff tool
+ *
+ * Compares current OpenAPI specs against the head branch using oasdiff
+ *
+ * Example usages:
+ *
+ * Instance-based usage
+ *    const diffTool = new OpenApiSpecDiff()
+ *    diffTool.compare(openapiConfigs)
+ *
+ * Factory method usage
+ *    const diffTool = OpenApiSpecDiff.create()
+ *    diffTool.compare(openapiConfigs)
+ *
+ * Static method usage (backward compatibility)
+ *    OpenApiSpecDiff.compare(openapiConfigs)
+ */
+export class OpenApiSpecDiff {
+    /**
+     * The configuration for the oasdiff command
+     */
+    oasdiffConfig;
+    /**
+     * Compares a list of OpenAPI specifications between the current branch and the head branch.
+     *
+     * Uses `oasdiff` under the hood to detect breaking and non-breaking changes for each file,
+     * helping you review and validate API updates with confidence before merging.
+     *
+     * This tool only runs for configurations where `checkDiffs` is enabled.
+     *
+     * @param openapiConfigs - An array of tuples containing the OpenAPI file name and its configuration.
+     * @example
+     * ```ts
+     * const openapiConfigs: [string, PsychicOpenapiConfig][] = [
+     *   ['openapi', { outputFilepath: 'openapi.json' }],
+     * ]
+     * OpenApiSpecDiff.compare(openapiConfigs)
+     * ```
+     */
+    compare(openapiConfigs) {
+        const results = [];
+        this.oasdiffConfig = this.getOasDiffConfig();
+        const comparing = colorize(`🔍 Comparing current OpenAPI Specs against ${this.oasdiffConfig.headBranch}...`, { color: 'cyanBright' });
+        DreamCLI.logger.logStartProgress(comparing, { logPrefixColor: 'cyanBright' });
+        DreamCLI.logger.logContinueProgress(`\n`, { logPrefixColor: 'cyanBright' });
+        for (const [openapiName, config] of openapiConfigs) {
+            const result = this.compareConfig(openapiName, config);
+            results.push(result);
+        }
+        this.processResults(results);
+    }
+    /**
+     * Checks if oasdiff is installed locally
+     */
+    hasOasDiffInstalled() {
+        try {
+            cp.execSync('oasdiff --version', { stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Fetch the head branch of a remote using git remote show origin
+     * default to main if not set
+     */
+    getHeadBranch() {
+        let head = '';
+        const output = cp.execSync('git remote show origin', { encoding: 'utf-8' });
+        const lines = output.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('HEAD branch:')) {
+                head = trimmed.replace('HEAD branch:', '').trim() || 'main';
+            }
+        }
+        return head;
+    }
+    /**
+     * Validates that oasdiff is installed and builds the oasdiff config
+     */
+    getOasDiffConfig() {
+        const headBranch = this.getHeadBranch();
+        if (this.hasOasDiffInstalled()) {
+            DreamCLI.logger.logContinueProgress('🎉 oasdiff package found\n');
+            return {
+                command: 'oasdiff',
+                baseArgs: [],
+                headBranch,
+            };
+        }
+        throw new Error(`⚠️ oasdiff not found.
+    
+      Install it via the instructions here:
+        https://github.com/tufin/oasdiff
+      `);
+    }
+    /**
+     * Runs oasdiff command and returns the output
+     */
+    runOasDiffCommand(subcommand, mainPath, currentPath, flags) {
+        if (!this.oasdiffConfig) {
+            throw new Error('OasDiff config not initialized');
+        }
+        const args = [...this.oasdiffConfig.baseArgs, subcommand, mainPath, currentPath];
+        if (flags && flags.length > 0) {
+            args.push(...flags.map(flag => `--${flag}`));
+        }
+        try {
+            const output = cp.execFileSync(this.oasdiffConfig.command, args, {
+                shell: true,
+                encoding: 'utf8',
+                cwd: process.cwd(),
+                stdio: 'pipe',
+            });
+            return output.trim();
+        }
+        catch (error) {
+            const errorOutput = error instanceof Error ? error.message : String(error);
+            return errorOutput;
+        }
+    }
+    /**
+     * Compares two OpenAPI files using oasdiff
+     */
+    compareSpecs(mainFilePath, currentFilePath) {
+        if (!this.oasdiffConfig) {
+            throw new Error('OasDiff config not initialized');
+        }
+        const breakingChanges = this.runOasDiffCommand('breaking', mainFilePath, currentFilePath);
+        const changelogChanges = this.runOasDiffCommand('changelog', mainFilePath, currentFilePath);
+        const breaking = breakingChanges && !breakingChanges.includes('Command failed')
+            ? breakingChanges.split('\n').filter(line => line.trim())
+            : [];
+        const changelog = changelogChanges && !changelogChanges.includes('Command failed')
+            ? changelogChanges.split('\n').filter(line => line.trim())
+            : [];
+        const failedToCompare = breakingChanges.includes('Command failed')
+            ? breakingChanges
+            : changelogChanges.includes('Command failed')
+                ? changelogChanges
+                : '';
+        return {
+            breaking,
+            changelog,
+            error: failedToCompare,
+        };
+    }
+    /**
+     * Creates a temporary file path for the head branch content
+     */
+    createTempFilePath(filePath) {
+        const tempFileName = `temp_main_${path.basename(filePath)}`;
+        return path.join(path.dirname(filePath), tempFileName);
+    }
+    /**
+     * Retrieves head branch content for a file
+     */
+    getHeadBranchContent(filePath) {
+        if (!this.oasdiffConfig) {
+            throw new Error('OasDiff config not initialized');
+        }
+        const branchRef = process.env.CI === '1' ? `origin/${this.oasdiffConfig.headBranch}` : this.oasdiffConfig.headBranch;
+        return cp.execSync(`git show ${branchRef}:${filePath}`, {
+            encoding: 'utf8',
+            cwd: process.cwd(),
+        });
+    }
+    /**
+     * Compares a single OpenAPI file against head branch
+     */
+    compareConfig(openapiName, config) {
+        const result = {
+            file: openapiName,
+            hasChanges: false,
+            breaking: [],
+            changelog: [],
+        };
+        const currentFilePath = config.outputFilepath;
+        if (!fs.existsSync(currentFilePath)) {
+            result.error = `File ${config.outputFilepath} does not exist in current branch`;
+            return result;
+        }
+        const tempMainFilePath = this.createTempFilePath(config.outputFilepath);
+        const mainContent = this.getHeadBranchContent(config.outputFilepath);
+        fs.mkdirSync(path.dirname(tempMainFilePath), { recursive: true });
+        fs.writeFileSync(tempMainFilePath, mainContent);
+        try {
+            const { breaking, changelog, error } = this.compareSpecs(tempMainFilePath, currentFilePath);
+            result.breaking = breaking;
+            result.changelog = changelog;
+            result.hasChanges = breaking.length > 0 || changelog.length > 0;
+            result.error = error ?? '';
+        }
+        catch (error) {
+            result.error = `Could not retrieve ${config.outputFilepath} from ${this.oasdiffConfig?.headBranch} branch: ${String(error)}`;
+        }
+        finally {
+            if (fs.existsSync(tempMainFilePath)) {
+                fs.unlinkSync(tempMainFilePath);
+            }
+        }
+        return result;
+    }
+    /**
+     * Process and display the comparison results
+     */
+    processResults(results) {
+        let hasAnyChanges = false;
+        let hasBreakingChanges = false;
+        for (const result of results) {
+            if (result.error) {
+                this.logError(result);
+            }
+            else if (result.hasChanges) {
+                this.logChanges(result);
+                hasAnyChanges = true;
+                if (result.breaking.length > 0) {
+                    this.logBreakingChanges(result);
+                    hasBreakingChanges = true;
+                }
+                if (result.changelog.length > 0) {
+                    this.logChangelog(result);
+                }
+            }
+            else {
+                this.logNoChanges(result);
+            }
+        }
+        this.logSummary(hasAnyChanges, hasBreakingChanges);
+    }
+    /**
+     * Log error for a comparison result
+     */
+    logError(result) {
+        const file = colorize(`❌ ${result.file}`, { color: 'whiteBright' });
+        const error = colorize(`${result.error}`, { color: 'redBright' });
+        DreamCLI.logger.logContinueProgress(`${file}: ${error}`, { logPrefixColor: 'redBright' });
+    }
+    /**
+     * Log changes for a comparison result
+     */
+    logChanges(result) {
+        const file = colorize(`${result.file}`, { color: 'whiteBright' });
+        const changes = colorize('HAS CHANGES', { color: 'yellowBright' });
+        DreamCLI.logger.logContinueProgress(`${file}: ${changes}`, { logPrefixColor: 'yellowBright' });
+    }
+    /**
+     * Log breaking changes for a comparison result
+     */
+    logBreakingChanges(result) {
+        DreamCLI.logger.logContinueProgress(`   ${colorize(`🚨 BREAKING CHANGES:`, { color: 'redBright' })}`, {
+            logPrefixColor: 'redBright',
+        });
+        result.breaking.forEach(change => {
+            DreamCLI.logger.logContinueProgress(`      ${colorize(`• ${change}`, { color: 'redBright' })}`, {
+                logPrefixColor: 'redBright',
+            });
+        });
+    }
+    /**
+     * Log changelog for a comparison result
+     */
+    logChangelog(result) {
+        DreamCLI.logger.logContinueProgress(`   ${colorize(`📋 CHANGELOG:`, { color: 'blueBright' })}`, {
+            logPrefixColor: 'blueBright',
+        });
+        const changelogLines = result.changelog;
+        changelogLines.forEach(line => {
+            DreamCLI.logger.logContinueProgress(`      ${colorize(line, { color: 'whiteBright' })}`, {
+                logPrefixBgColor: 'bgWhite',
+                logPrefixColor: 'white',
+            });
+        });
+    }
+    /**
+     * Log no changes for a comparison result
+     */
+    logNoChanges(result) {
+        const file = colorize(`${result.file}`, { color: 'whiteBright' });
+        const changes = colorize('No changes', { color: 'greenBright' });
+        DreamCLI.logger.logContinueProgress(`${file}: ${changes}`, { logPrefixColor: 'greenBright' });
+    }
+    /**
+     * Log final summary and handle exit conditions
+     */
+    logSummary(hasAnyChanges, hasBreakingChanges) {
+        DreamCLI.logger.logContinueProgress(`\n${colorize(`${'='.repeat(60)}`, { color: 'gray' })}`, {
+            logPrefixColor: 'gray',
+        });
+        if (hasBreakingChanges) {
+            DreamCLI.logger.logContinueProgress(`${colorize(`🚨 CRITICAL:`, { color: 'redBright' })} ${colorize(`Breaking changes detected in current branch compared to ${this.oasdiffConfig?.headBranch}! Review before merging.`, { color: 'whiteBright' })}`, { logPrefixColor: 'redBright' });
+            DreamCLI.logger.logContinueProgress(`${colorize(`${'='.repeat(60)}`, { color: 'gray' })}`, {
+                logPrefixColor: 'gray',
+            });
+            DreamCLI.logger.logContinueProgress('\n'.repeat(5), {
+                logPrefixColor: 'gray',
+            });
+            throw new BreakingChangesDetectedInOpenApiSpecError(this.oasdiffConfig);
+        }
+        else if (hasAnyChanges) {
+            const summary = colorize(`📊 Summary: Some OpenAPI files have non-breaking changes in current branch compared to ${this.oasdiffConfig?.headBranch}`, { color: 'yellow' });
+            DreamCLI.logger.logContinueProgress(summary, { logPrefixColor: 'yellow' });
+        }
+        else {
+            const summary = colorize(`📊 Summary: All OpenAPI files in current branch are identical to ${this.oasdiffConfig?.headBranch} branch`, { color: 'green' });
+            DreamCLI.logger.logContinueProgress(summary, { logPrefixColor: 'green' });
+        }
+    }
+    /**
+     * Static factory method for convenience
+     */
+    static create() {
+        return new OpenApiSpecDiff();
+    }
+    /**
+     * Static method to maintain compatibility with functional approach
+     */
+    static compare(openapiConfigs) {
+        const instance = OpenApiSpecDiff.create();
+        instance.compare(openapiConfigs);
+    }
+}
+export class BreakingChangesDetectedInOpenApiSpecError extends Error {
+    oasdiffConfig;
+    constructor(oasdiffConfig) {
+        super();
+        this.oasdiffConfig = oasdiffConfig;
+        this.name = 'BreakingChangesDetectedInOpenApiSpecError';
+    }
+    get message() {
+        return `Breaking changes detected in current branch compared to ${this.oasdiffConfig.headBranch}! Review before merging.`;
+    }
+}

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

@@ -9,7 +9,9 @@ import OpenapiAppRenderer from '../openapi-renderer/app.js';
 import PsychicApp from '../psychic-app/index.js';
 import enumsFileStr from './helpers/enumsFileStr.js';
 import generateRouteTypes from './helpers/generateRouteTypes.js';
+import { OpenApiSpecDiff } from './helpers/OpenApiSpecDiff.js';
 import printRoutes from './helpers/printRoutes.js';
+export { BreakingChangesDetectedInOpenApiSpecError } from './helpers/OpenApiSpecDiff.js';
 export default class PsychicBin {
     static async generateController(controllerName, actions) {
         await generateController({
@@ -59,6 +61,11 @@ export default class PsychicBin {
             await new ASTPsychicTypesBuilder().build();
         });
     }
+    static openapiDiff() {
+        const psychicApp = PsychicApp.getOrFail();
+        const openapiConfigsWithCheckDiffs = Object.entries(psychicApp.openapi).filter(([, config]) => config.checkDiffs);
+        OpenApiSpecDiff.compare(openapiConfigsWithCheckDiffs);
+    }
     static async syncOpenapiTypescriptFiles() {
         DreamCLI.logger.logStartProgress(`syncing openapi types...`);
         // https://rvohealth.atlassian.net/browse/PDTC-8359

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

@@ -1,5 +1,5 @@
 import { DreamCLI } from '@rvoh/dream/system';
-import PsychicBin from '../bin/index.js';
+import PsychicBin, { BreakingChangesDetectedInOpenApiSpecError } from '../bin/index.js';
 import generateController from '../generate/controller.js';
 import generateSyncEnumsInitializer from '../generate/initializer/syncEnums.js';
 import generateSyncOpenapiTypescriptInitializer from '../generate/initializer/syncOpenapiTypescript.js';
@@ -196,6 +196,27 @@ export default class PsychicCLI {
             await PsychicBin.syncOpenapiJson();
             process.exit();
         });
+        program
+            .command('diff:openapi')
+            .description('compares the current branch open api spec file(s) with the main/master/head branch open api spec file(s)')
+            .option('-f', '--fail-on-breaking', 'fail on spec changes that are breaking')
+            .action(async (options) => {
+            await initializePsychicApp();
+            try {
+                PsychicBin.openapiDiff();
+            }
+            catch (error) {
+                if (error instanceof BreakingChangesDetectedInOpenApiSpecError) {
+                    if (options.failOnBreaking) {
+                        console.error(error.message);
+                        process.exit(1);
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+        });
     }
     /**
      * @internal

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

@@ -131,7 +131,7 @@ export default class PsychicController {
     /**
      * @internal
      *
-     * Used for displaying routes when running `yarn psy routes`
+     * Used for displaying routes when running `pnpm psy routes`
      * cli command
      */
     static get disaplayName() {

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

@@ -6,7 +6,7 @@ import UnexpectedUndefined from '../../error/UnexpectedUndefined.js';
 import PsychicApp from '../../psychic-app/index.js';
 const devServerProcesses = {};
 const debugEnabled = debuglog('psychic').enabled;
-export async function launchDevServer(key, { port = 3000, cmd = 'yarn client', timeout = 5000 } = {}) {
+export async function launchDevServer(key, { port = 3000, cmd = 'pnpm client', timeout = 5000 } = {}) {
     if (devServerProcesses[key])
         return;
     if (debugEnabled)

package/dist/esm/src/error/psychic-app/init-missing-package-manager.js

@@ -10,7 +10,7 @@ within conf/app.ts, you must have a call to "#set('packageManager', '<YOUR_CHOSE
 
   // conf/app.ts
   export default async (psy: PsychicApp) => {
-    psy.set('packageManager', 'yarn')
+    psy.set('packageManager', 'pnpm')
   }
     `;
     }

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

@@ -87,8 +87,9 @@ function parseAttribute(attribute) {
     const [rawAttributeName, rawAttributeType, , enumValues] = attribute.split(':');
     if (!rawAttributeName || !rawAttributeType)
         return null;
+    const sanitizedAttrType = camelize(rawAttributeType)?.toLowerCase();
     // Handle belongs_to relationships
-    if (rawAttributeType === 'belongs_to') {
+    if (sanitizedAttrType === 'belongsto') {
         // For belongs_to relationships, convert "Ticketing/Ticket" to "ticket"
         const attributeName = camelize(rawAttributeName.split('/').pop());
         return { attributeName, attributeType: 'belongs_to', isArray: false, enumValues };
@@ -105,8 +106,9 @@ function parseAttribute(attribute) {
     return { attributeName, attributeType, isArray, enumValues };
 }
 function processAttributeByType({ attributeType, attributeName, isArray, enumValues, dotNotationVariable, fullyQualifiedModelName, attributeData, }) {
-    switch (attributeType) {
-        case 'belongs_to':
+    const sanitizedAttributeType = camelize(attributeType).toLowerCase();
+    switch (sanitizedAttributeType) {
+        case 'belongsto':
             // belongs_to relationships are NOT included in comparable attributes or create/update data
             // They are only tracked for original values in update contexts
             break;

package/dist/esm/src/generate/helpers/syncOpenapiTypescript/installOpenapiTypescript.js

@@ -8,7 +8,7 @@ export default async function installOpenapiTypescript() {
     try {
         await DreamCLI.spawn(cmd);
     }
-    catch (err) {
+    catch {
         console.log(`Failed to install openapi-typescript as a dev dependency. Please make sure the following command succeeds:
 
 "${cmd}"

package/dist/esm/src/openapi-renderer/SerializerOpenapiRenderer.js

@@ -298,6 +298,7 @@ function associationOpenapi(attribute, DataTypeForOpenapi, alreadyExtractedDesce
         if (associatedClass === undefined) {
             let serializerCheck;
             try {
+                // eslint-disable-next-line @typescript-eslint/no-unused-expressions
                 ;
                 DataTypeForOpenapi?.prototype?.serializers;
             }

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

@@ -57,7 +57,7 @@ export default class OpenapiAppRenderer {
             openapi: '3.1.0',
             info: {
                 version: openapiConfig?.info?.version || 'unknown version',
-                title: openapiConfig?.info?.title || 'unknown title',
+                title: openapiConfig?.info?.title || `${psychicApp.appName} | ${openapiName}`,
                 description: openapiConfig?.info?.description || 'The autogenerated openapi spec for your app',
             },
             paths: {},

package/dist/types/src/bin/helpers/OpenApiSpecDiff.d.ts

@@ -0,0 +1,138 @@
+import type { DefaultPsychicOpenapiOptions } from '../../psychic-app/index.js';
+/**
+ * Interface to hold the result of a comparison
+ * between the current local OpenAPI specification and the head branch
+ * for a given OpenAPI file
+ */
+export interface ComparisonResult {
+    file: string;
+    hasChanges: boolean;
+    breaking: string[];
+    changelog: string[];
+    error?: string;
+}
+/**
+ * Interface to hold the configuration for oasdiff
+ */
+export interface OasDiffConfig {
+    command: string;
+    baseArgs: string[];
+    headBranch: string;
+}
+export type PsychicOpenapiConfig = DefaultPsychicOpenapiOptions;
+/**
+ * Class-based OpenAPI specification diff tool
+ *
+ * Compares current OpenAPI specs against the head branch using oasdiff
+ *
+ * Example usages:
+ *
+ * Instance-based usage
+ *    const diffTool = new OpenApiSpecDiff()
+ *    diffTool.compare(openapiConfigs)
+ *
+ * Factory method usage
+ *    const diffTool = OpenApiSpecDiff.create()
+ *    diffTool.compare(openapiConfigs)
+ *
+ * Static method usage (backward compatibility)
+ *    OpenApiSpecDiff.compare(openapiConfigs)
+ */
+export declare class OpenApiSpecDiff {
+    /**
+     * The configuration for the oasdiff command
+     */
+    private oasdiffConfig?;
+    /**
+     * Compares a list of OpenAPI specifications between the current branch and the head branch.
+     *
+     * Uses `oasdiff` under the hood to detect breaking and non-breaking changes for each file,
+     * helping you review and validate API updates with confidence before merging.
+     *
+     * This tool only runs for configurations where `checkDiffs` is enabled.
+     *
+     * @param openapiConfigs - An array of tuples containing the OpenAPI file name and its configuration.
+     * @example
+     * ```ts
+     * const openapiConfigs: [string, PsychicOpenapiConfig][] = [
+     *   ['openapi', { outputFilepath: 'openapi.json' }],
+     * ]
+     * OpenApiSpecDiff.compare(openapiConfigs)
+     * ```
+     */
+    compare(openapiConfigs: [string, PsychicOpenapiConfig][]): void;
+    /**
+     * Checks if oasdiff is installed locally
+     */
+    private hasOasDiffInstalled;
+    /**
+     * Fetch the head branch of a remote using git remote show origin
+     * default to main if not set
+     */
+    private getHeadBranch;
+    /**
+     * Validates that oasdiff is installed and builds the oasdiff config
+     */
+    private getOasDiffConfig;
+    /**
+     * Runs oasdiff command and returns the output
+     */
+    private runOasDiffCommand;
+    /**
+     * Compares two OpenAPI files using oasdiff
+     */
+    private compareSpecs;
+    /**
+     * Creates a temporary file path for the head branch content
+     */
+    private createTempFilePath;
+    /**
+     * Retrieves head branch content for a file
+     */
+    private getHeadBranchContent;
+    /**
+     * Compares a single OpenAPI file against head branch
+     */
+    private compareConfig;
+    /**
+     * Process and display the comparison results
+     */
+    private processResults;
+    /**
+     * Log error for a comparison result
+     */
+    private logError;
+    /**
+     * Log changes for a comparison result
+     */
+    private logChanges;
+    /**
+     * Log breaking changes for a comparison result
+     */
+    private logBreakingChanges;
+    /**
+     * Log changelog for a comparison result
+     */
+    private logChangelog;
+    /**
+     * Log no changes for a comparison result
+     */
+    private logNoChanges;
+    /**
+     * Log final summary and handle exit conditions
+     */
+    private logSummary;
+    /**
+     * Static factory method for convenience
+     */
+    static create(): OpenApiSpecDiff;
+    /**
+     * Static method to maintain compatibility with functional approach
+     */
+    static compare(openapiConfigs: [string, PsychicOpenapiConfig][]): void;
+}
+export declare class BreakingChangesDetectedInOpenApiSpecError extends Error {
+    private readonly oasdiffConfig;
+    constructor(oasdiffConfig: OasDiffConfig);
+    get message(): string;
+}

package/dist/types/src/bin/index.d.ts

@@ -1,3 +1,4 @@
+export { BreakingChangesDetectedInOpenApiSpecError } from './helpers/OpenApiSpecDiff.js';
 export default class PsychicBin {
     static generateController(controllerName: string, actions: string[]): Promise<void>;
     static generateResource(route: string, fullyQualifiedModelName: string, columnsWithTypes: string[], options: {
@@ -14,6 +15,7 @@ export default class PsychicBin {
     }): Promise<void>;
     static postSync(): Promise<void>;
     static syncTypes(): Promise<void>;
+    static openapiDiff(): void;
     static syncOpenapiTypescriptFiles(): Promise<void>;
     static syncOpenapiJson(): Promise<void>;
     static syncRoutes(): Promise<void>;

package/dist/types/src/controller/index.d.ts

@@ -76,7 +76,7 @@ export default class PsychicController {
     /**
      * @internal
      *
-     * Used for displaying routes when running `yarn psy routes`
+     * Used for displaying routes when running `pnpm psy routes`
      * cli command
      */
     static get disaplayName(): string;

package/dist/types/src/psychic-app/index.d.ts

@@ -491,6 +491,34 @@ interface PsychicOpenapiBaseOptions {
      * ```
      */
     validate?: OpenapiValidateOption;
+    /**
+     * Enables automatic comparison of OpenAPI specifications between the current
+     * working branch and the main/master/head branch.
+     *
+     * When set to `true`, Psychic will perform a diff check between the OpenAPI spec
+     * in the current branch and the one in the main/master/head branch. This is done using the
+     * `OpenApiSpecDiff` tool, which analyzes structural and semantic differences
+     * between the two specs.
+     *
+     * This feature is useful for catching unintended changes to your API contract
+     * before they are merged, especially breaking changes that could affect downstream
+     * consumers or integrations.
+     *
+     * Typical use cases include CI/CD validation, pull request checks, or local
+     * development sanity checks.
+     *
+     * Example usage:
+     * ```ts
+     * psy.set('openapi', {
+     *   ...
+     *   checkDiffs: true,
+     *   ...
+     * });
+     * ```
+     *
+  
+     */
+    checkDiffs?: boolean;
 }
 interface PsychicOpenapiInfo {
     version: string;

package/package.json

@@ -2,7 +2,7 @@
   "type": "module",
   "name": "@rvoh/psychic",
   "description": "Typescript web framework",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "author": "RVOHealth",
   "repository": {
     "type": "git",
@@ -48,28 +48,29 @@
     "dist/**/*"
   ],
   "scripts": {
-    "client": "yarn --cwd=./client start",
-    "client:fspec": "VITE_PSYCHIC_ENV=test BROWSER=none yarn --cwd=./client start",
-    "psy": "NODE_ENV=${NODE_ENV:-test} yarn psyts",
+    "client": "cd client && pnpm start",
+    "client:fspec": "cd client && VITE_PSYCHIC_ENV=test BROWSER=none pnpm start",
+    "psy": "NODE_ENV=${NODE_ENV:-test} pnpm psyts",
     "psyjs": "node ./dist/test-app/src/cli/index.js",
     "psyts": "NODE_ENV=${NODE_ENV:-test} tsx ./test-app/src/cli/index.ts",
     "gpsy": "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: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",
-    "types:esm:trace": "rm -rf dist && npx tsc -p ./tsconfig.esm.build.json --generateTrace ./typetrace --diagnostics && yarn analyze-trace ./typetrace --skipMillis 100 --forceMillis 300",
+    "types:esm:trace": "rm -rf dist && npx tsc -p ./tsconfig.esm.build.json --generateTrace ./typetrace --diagnostics && pnpm analyze-trace ./typetrace --skipMillis 100 --forceMillis 300",
     "dev": "nodemon --quiet --no-stdin",
     "console": "tsx ./test-app/src/conf/repl.ts",
     "uspec": "vitest --config ./spec/unit/vite.config.ts",
     "fspec": "vitest run --config=./spec/features/vite.config.ts",
-    "format": "yarn run prettier . --write",
-    "lint": "yarn run eslint --no-warn-ignored \"src/**/*.ts\" \"spec/**/*.ts\" \"test-app/**/*.ts\" && yarn run prettier . --check",
-    "prepack": "yarn build"
+    "format": "pnpm prettier . --write",
+    "lint": "pnpm eslint --no-warn-ignored \"src/**/*.ts\" \"spec/**/*.ts\" \"test-app/**/*.ts\" && pnpm prettier . --check",
+    "prepack": "pnpm build"
   },
   "dependencies": {
     "@types/cookie-parser": "^1.4.8",
     "@types/cors": "^2.8.17",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
+    "body-parser": "^2.2.1",
     "commander": "^12.1.0",
     "cookie-parser": "^1.4.7",
     "cors": "^2.8.5",
@@ -85,11 +86,12 @@
     "openapi-typescript": "^7.8.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.19.0",
+    "@eslint/js": "^9.39.1",
     "@jest-mock/express": "^3.0.0",
     "@rvoh/dream": "^2.0.3",
     "@rvoh/dream-spec-helpers": "^2.0.0",
     "@rvoh/psychic-spec-helpers": "^2.0.0",
+    "@types/body-parser": "^1.19.6",
     "@types/express": "^5.0.6",
     "@types/express-session": "^1.18.2",
     "@types/node": "^22.17.1",
@@ -97,13 +99,14 @@
     "@types/passport-local": "^1",
     "@types/pg": "^8.11.8",
     "@types/supertest": "^6.0.3",
+    "@typescript-eslint/parser": "^8.48.1",
     "@typescript/analyze-trace": "^0.10.1",
-    "eslint": "^9.19.0",
+    "eslint": "^9.39.1",
     "express": "^5.2.1",
     "express-session": "^1.18.2",
     "jsdom": "^26.1.0",
     "kysely": "^0.28.5",
-    "kysely-codegen": "~0.17.0",
+    "kysely-codegen": "~0.19.0",
     "luxon-jest-matchers": "^0.1.14",
     "nodemon": "^3.1.11",
     "openapi-typescript": "^7.8.0",
@@ -117,9 +120,9 @@
     "tsx": "^4.19.3",
     "typedoc": "^0.26.6",
     "typescript": "^5.5.4",
-    "typescript-eslint": "=7.18.0",
+    "typescript-eslint": "^8.48.1",
     "vitest": "^4.0.9",
     "winston": "^3.14.2"
   },
-  "packageManager": "yarn@4.7.0"
+  "packageManager": "pnpm@10.24.0+sha512.01ff8ae71b4419903b65c60fb2dc9d34cf8bb6e06d03bde112ef38f7a34d6904c424ba66bea5cdcf12890230bf39f9580473140ed9c946fef328b6e5238a345a"
 }