@rvoh/psychic 0.33.0 → 0.34.1

package/README.md

@@ -1,4 +1,4 @@
-> ATTENTION: we are currently in the process of releasing this code to the world, as of the afternoon of March 10th, 2025. This notice will be removed, and the version of this repo will be bumped to 1.0.0, once all of the repos have been migrated to the new spaces and we can verify that it is all working. This is anticipated to be done in early April, 2025.
+> ATTENTION: we are currently in the process of releasing this code to the world, as of the afternoon of May 2nd, 2025. This notice will be removed, and the version of this repo will be bumped to 1.0.0, once all of the repos have been migrated to the new spaces and we can verify that it is all working. This is anticipated to be done sometime in the next month
 
 # Psychic
 

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

@@ -69,9 +69,6 @@ class PsychicBin {
     static async postSync() {
         const psychicApp = index_js_1.default.getOrFail();
         await PsychicBin.syncOpenapiJson();
-        if (psychicApp.openapi?.syncEnumsToClient) {
-            await this.syncClientEnums();
-        }
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         let output = {};
         for (const hook of psychicApp.specialHooks.sync) {
@@ -105,12 +102,17 @@ class PsychicBin {
         await (0, generateRouteTypes_js_1.default)(routes);
         dream_1.DreamCLI.logger.logEndProgress();
     }
-    static async syncClientEnums() {
+    static async syncClientEnums(outfile) {
         dream_1.DreamCLI.logger.logStartProgress(`syncing client enums...`);
-        const psychicApp = index_js_1.default.getOrFail();
-        const apiPath = path.join(psychicApp.clientRoot, psychicApp.client.apiPath);
         const enumsStr = await (0, enumsFileStr_js_1.default)();
-        await fs.writeFile(`${apiPath}/enums.ts`, enumsStr);
+        try {
+            const dir = path.dirname(outfile);
+            await fs.mkdir(dir, { recursive: true });
+        }
+        catch {
+            // noop
+        }
+        await fs.writeFile(outfile, enumsStr, {});
         dream_1.DreamCLI.logger.logEndProgress();
     }
 }

package/dist/cjs/src/cli/helpers/PackageManager.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = __importDefault(require("../../psychic-app/index.js"));
+class PackageManager {
+    static get packageManager() {
+        return index_js_1.default.getOrFail().packageManager;
+    }
+    static add(dependencyOrDependencies, { dev } = {}) {
+        const dependency = Array.isArray(dependencyOrDependencies)
+            ? dependencyOrDependencies.join(' ')
+            : dependencyOrDependencies;
+        if (dev) {
+            switch (this.packageManager) {
+                case 'npm':
+                    return `${this.packageManager} install --save-dev ${dependency}`;
+                default:
+                    return `${this.packageManager} add -D ${dependency}`;
+            }
+        }
+        else {
+            switch (this.packageManager) {
+                case 'npm':
+                    return `${this.packageManager} install ${dependency}`;
+                default:
+                    return `${this.packageManager} add ${dependency}`;
+            }
+        }
+    }
+    static run(cmd) {
+        switch (this.packageManager) {
+            case 'npm':
+                return `npm run ${cmd}`;
+            default:
+                return `${this.packageManager} ${cmd}`;
+        }
+    }
+}
+exports.default = PackageManager;

package/dist/cjs/src/cli/helpers/cli-prompt.js

@@ -0,0 +1,45 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = cliPrompt;
+const readline = __importStar(require("node:readline"));
+const input = process.stdin;
+const output = process.stdout;
+async function cliPrompt(question) {
+    const rl = readline.createInterface({
+        input,
+        output,
+    });
+    return new Promise(resolve => {
+        if (process.env.BYPASS_CLI_PROMPT === '1')
+            resolve('');
+        else {
+            rl.question(question, value => {
+                rl.close();
+                resolve(value);
+            });
+        }
+    });
+}

package/dist/cjs/src/cli/helpers/cli-select.js

@@ -0,0 +1,135 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yoctocolors_1 = __importDefault(require("yoctocolors"));
+const readline = __importStar(require("readline"));
+const input = process.stdin;
+const output = process.stdout;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+class CLISelect {
+    question;
+    selectIndex = 0;
+    options;
+    selector = '>';
+    isFirstTimeShowMenu = true;
+    cb = null;
+    constructor(question, options) {
+        this.question = question;
+        this.options = options;
+    }
+    async run() {
+        this.init();
+        return new Promise(accept => {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-explicit-any
+            this.cb = accept;
+        });
+    }
+    keyPressedHandler(_, key) {
+        if (key) {
+            const optionLength = this.options.length - 1;
+            if (key.name === 'down' && this.selectIndex < optionLength) {
+                this.selectIndex += 1;
+                this.createOptionMenu();
+            }
+            else if (key.name === 'up' && this.selectIndex > 0) {
+                this.selectIndex -= 1;
+                this.createOptionMenu();
+            }
+            else if (key.name === 'return') {
+                this.cb?.(this.options[this.selectIndex]);
+                input.removeAllListeners('keypress');
+                output.write('\n');
+                input.setRawMode(false);
+                input.pause();
+            }
+            else if (key.name === 'escape' || (key.name === 'c' && key.ctrl)) {
+                this.close();
+            }
+        }
+    }
+    ansiEraseLines(count) {
+        //adapted from sindresorhus ansi-escape module
+        const ESC = '\u001B[';
+        const eraseLine = ESC + '2K';
+        const cursorUp = (count = 1) => ESC + count + 'A';
+        const cursorLeft = ESC + 'G';
+        let clear = '';
+        for (let i = 0; i < count; i++) {
+            clear += eraseLine + (i < count - 1 ? cursorUp() : '');
+        }
+        if (count) {
+            clear += cursorLeft;
+        }
+        return clear;
+    }
+    init() {
+        console.log(`\n${this.question}`);
+        readline.emitKeypressEvents(input);
+        this.start();
+    }
+    start() {
+        //setup the input for reading
+        input.setRawMode(true);
+        input.resume();
+        input.on('keypress', (event, key) => this.keyPressedHandler(event, key));
+        if (this.selectIndex >= 0) {
+            this.createOptionMenu();
+        }
+    }
+    close = () => {
+        input.setRawMode(false);
+        input.pause();
+        process.exit(0);
+    };
+    getPadding(num = 10) {
+        let text = ' ';
+        for (let i = 0; i < num; i++) {
+            text += ' ';
+        }
+        return text;
+    }
+    createOptionMenu() {
+        const optionLength = this.options.length;
+        if (this.isFirstTimeShowMenu) {
+            this.isFirstTimeShowMenu = false;
+        }
+        else {
+            output.write(this.ansiEraseLines(optionLength));
+        }
+        const padding = this.getPadding(0);
+        const cursor = yoctocolors_1.default.magenta(this.selector);
+        for (let i = 0; i < optionLength; i++) {
+            const selectedOption = i === this.selectIndex
+                ? `${cursor} ${this.options[i]}`
+                : `${cursor.replace(/.*/, ' ')} ${this.options[i]}`;
+            const ending = i !== optionLength - 1 ? '\n' : '';
+            output.write(padding + selectedOption + ending);
+        }
+    }
+}
+exports.default = CLISelect;

package/dist/cjs/src/cli/helpers/colorize.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = colorize;
+const yoctocolors_1 = __importDefault(require("yoctocolors"));
+function colorize(text, { color, bgColor, }) {
+    const foregroundApplied = color ? yoctocolors_1.default[color](text) : text;
+    return bgColor ? yoctocolors_1.default[bgColor](foregroundApplied) : foregroundApplied;
+}

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

@@ -5,6 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const dream_1 = require("@rvoh/dream");
 const index_js_1 = __importDefault(require("../bin/index.js"));
+const reduxBindings_js_1 = __importDefault(require("../generate/openapi/reduxBindings.js"));
+const syncEnums_js_1 = __importDefault(require("../generate/initializer/syncEnums.js"));
 class PsychicCLI {
     static provide(program, { initializePsychicApp, seedDb, }) {
         dream_1.DreamCLI.generateDreamCli(program, {
@@ -37,6 +39,37 @@ class PsychicCLI {
             await index_js_1.default.generateController(controllerName, actions);
             process.exit();
         });
+        program
+            .command('generate:openapi:redux')
+            .alias('g:openapi:redux')
+            .description('generates openapi redux bindings to connect one of your openapi files to one of your clients')
+            .option('--schema-file', 'the path from your api root to the openapi file you wish to use to generate your schema, i.e. ./openapi/openapi.json')
+            .option('--api-file', 'the path to the boilerplate api file that will be used to scaffold your backend endpoints together with, i.e. ../client/app/api.ts')
+            .option('--api-import', 'the camelCased name of the export from your api module, i.e. emptyBackendApi')
+            .option('--output-file', 'the path to the file that will contain your typescript openapi redux bindings, i.e. ../client/app/myBackendApi.ts')
+            .option('--export-name', 'the camelCased name to use for your exported api, i.e. myBackendApi')
+            .action(async ({ schemaFile, apiFile, apiImport, outputFile, exportName, }) => {
+            await initializePsychicApp();
+            await (0, reduxBindings_js_1.default)({
+                exportName,
+                schemaFile,
+                apiFile,
+                apiImport,
+                outputFile,
+            });
+            process.exit();
+        });
+        program
+            .command('generate:initializer:sync-enums')
+            .alias('g:initializer:sync-enums')
+            .description('generates an initializer in your app for syncing enums to a particular path.')
+            .argument('<outfile>', 'the path from your backend directory to the location which you want the enums copied. Should end with .ts, i.e. "../client/src/api/enums.ts"')
+            .option('--initializer-filename', 'the name you want the file to be in your initializers folder. defaults to `sync-enums.ts`')
+            .action(async (outfile, { initializerName, }) => {
+            await initializePsychicApp();
+            await (0, syncEnums_js_1.default)(outfile, initializerName);
+            process.exit();
+        });
         program
             .command('routes')
             .description('examines your current models, building a type-map of the associations so that the ORM can understand your relational setup. This is commited to your repo, and synced to the dream repo for consumption within the underlying library.')
@@ -75,6 +108,15 @@ class PsychicCLI {
             await index_js_1.default.syncOpenapiJson();
             process.exit();
         });
+        program
+            .command('sync:client:enums')
+            .argument('<outfile>', 'the path from your backend directory to the location which you want the enums copied. Should end with .ts, i.e. "../client/src/api/enums.ts"')
+            .description('syncs your backend enums to a location of your choosing')
+            .action(async (outfile) => {
+            await initializePsychicApp();
+            await index_js_1.default.syncClientEnums(outfile);
+            process.exit();
+        });
     }
 }
 exports.default = PsychicCLI;

package/dist/cjs/src/generate/helpers/reduxBindings/printFinalStepsMessage.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = printFinalStepsMessage;
+const dream_1 = require("@rvoh/dream");
+const colorize_js_1 = __importDefault(require("../../../cli/helpers/colorize.js"));
+function printFinalStepsMessage(opts) {
+    const importLine = (0, colorize_js_1.default)(`+ import { ${opts.exportName} } from '${opts.apiFile}'`, { color: 'green' });
+    const reducerLine = (0, colorize_js_1.default)(`    + [${opts.exportName}.reducerPath]: ${opts.exportName}.reducer,`, {
+        color: 'green',
+    });
+    const middlewareLine = (0, colorize_js_1.default)(`  + middleware: gDM => gDM().concat(${opts.exportName}.middleware),`, {
+        color: 'green',
+    });
+    dream_1.DreamCLI.logger.log(`
+Finished generating redux bindings for your application,
+but to wire them into your app, we're going to need your help.
+Be sure to add the following to your root store to bind your new
+api module into your redux app, i.e.
+
+// add this line, fix the import path if necessary
+${importLine}
+
+export const store = configureStore({
+  reducer: {
+    // ...
+    // add this line
+${reducerLine}
+  },
+  
+  // add this line
+${middlewareLine}
+})
+`, { logPrefix: '' });
+}

package/dist/cjs/src/generate/helpers/reduxBindings/promptForOptions.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = promptForOptions;
+const dream_1 = require("@rvoh/dream");
+const cli_prompt_js_1 = __importDefault(require("../../../cli/helpers/cli-prompt.js"));
+const index_js_1 = __importDefault(require("../../../psychic-app/index.js"));
+async function promptForOptions(options) {
+    if (!options.schemaFile) {
+        const defaultVal = './openapi/openapi.json';
+        const answer = await (0, cli_prompt_js_1.default)(`\
+What would you like the schemaFile to be?
+
+The schemaFile is the openapi file that @rtk-query/codegen-openapi will read to produce
+all of its redux bindings. If not provided, it will default to
+
+  ${defaultVal}
+`);
+        options.schemaFile = answer || defaultVal;
+    }
+    if (!options.exportName) {
+        const defaultVal = `${(0, dream_1.camelize)(index_js_1.default.getOrFail().appName)}Api`;
+        const answer = await (0, cli_prompt_js_1.default)(`\
+What would you like the exportName to be?
+
+The exportName is used to name the final output of the @rtk-query/codegen-openapi utility.
+It will encase all of the backend endpoints that have been consumed via the specified openapi
+file. We recommend naming it something like the name of your app, i.e.
+
+  ${defaultVal}
+`);
+        options.exportName = answer || defaultVal;
+    }
+    if (!options.outputFile) {
+        const defaultVal = `../client/app/api/${(0, dream_1.camelize)(options.exportName)}.ts`;
+        const answer = await (0, cli_prompt_js_1.default)(`\
+What would you like the outputFile to be?
+
+The outputFile is the path to the generated openapi redux bindings. If not provided,
+it will default to:
+
+  ${defaultVal}
+`);
+        options.outputFile = answer || defaultVal;
+    }
+    if (!options.apiFile) {
+        const defaultVal = '../client/app/api/api.ts';
+        const answer = await (0, cli_prompt_js_1.default)(`\
+What would you like the path to your apiFile to be?
+
+The apiFile option specifies which base api file to use to mix in your backend endpoints with.
+This option is provided by the @rtk-query/codegen-openapi library to enable you to define
+custom api behavior, such as defining a base url, adding header preparation steps, etc...
+
+We expect you to provide this path with the api root in mind, so you will need to consider
+how to travel to the desired filepath from within your psychic project, i.e.
+
+  ${defaultVal}
+`);
+        options.apiFile = answer || defaultVal;
+    }
+    if (!options.apiImport) {
+        const defaultVal = `empty${(0, dream_1.pascalize)(options.exportName)}`;
+        const answer = await (0, cli_prompt_js_1.default)(`\
+What would you like the path to your apiImport to be?
+
+The apiImport option specifies the export key for the api module being exported from the
+file found at the apiFile path.
+
+This option is provided by the @rtk-query/codegen-openapi library to inform it of which
+named export in your apiFile it should be mixing your backend api with. If not provided,
+it will default to
+
+  ${defaultVal}
+`);
+        options.apiImport = answer || defaultVal;
+    }
+    return options;
+}

package/dist/cjs/src/generate/helpers/reduxBindings/writeApiFile.js

@@ -0,0 +1,93 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = writeApiFile;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+async function writeApiFile({ apiFile, apiImport }) {
+    const destDir = path.dirname(apiFile);
+    try {
+        await fs.access(apiFile);
+        return; // early return if the file already exists
+    }
+    catch {
+        // noop
+    }
+    try {
+        await fs.access(destDir);
+    }
+    catch {
+        await fs.mkdir(destDir, { recursive: true });
+    }
+    const contents = `\
+// Or from '@reduxjs/toolkit/query' if not using the auto-generated hooks
+import { createApi, fetchBaseQuery } from '@reduxjs/toolkit/query/react'
+import { RootState } from '../store' // update this to the correct path to your app's store
+
+function baseUrl() {
+  // add custom code here for determining your application's baseUrl
+  // this would generally be something different, depending on if you
+  // are in dev/test/production environments. For dev, you might want
+  // http://localhost:7777, while test may be http://localhost:7778, or
+  // some other port, depending on how you have your spec hooks configured.
+  // for production, it should be the real host for your application, i.e.
+  // https://myapi.com
+
+  return 'http://localhost:7777'
+}
+
+// initialize an empty api service that we'll inject endpoints into later as needed
+export const ${apiImport} = createApi({
+  // forces cache to bust any time a component is mounted
+  refetchOnMountOrArgChange: true,
+  keepUnusedDataFor: 0,
+
+  baseQuery: fetchBaseQuery({
+    baseUrl: baseURL(),
+    credentials: 'include',
+
+    // we recommend that you use a function like this for preparing
+    // headers, so that you can make sure any necessary auth tokens
+    // used by your app can be applied to the headers when any requests
+    // are made to your backend api.
+    // prepareHeaders: (headers, { getState }) => {
+    //   return new Promise(resolve => {
+    //     function checkToken() {
+    //       const token = (getState() as RootState).app.authToken
+    //       if (token) {
+    //         headers.set('Authorization', \`Bearer \${token}\`)
+    //         resolve(headers)
+    //       } else {
+    //         setTimeout(checkToken, 500) // try again in 500ms
+    //       }
+    //     }
+    //     checkToken()
+    //   })
+    // },
+  }),
+  endpoints: () => ({}),
+})`;
+    await fs.writeFile(apiFile, contents);
+}

package/dist/cjs/src/generate/helpers/reduxBindings/writeInitializer.js

@@ -0,0 +1,76 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = writeInitializer;
+const dream_1 = require("@rvoh/dream");
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const psychicPath_js_1 = __importDefault(require("../../../helpers/path/psychicPath.js"));
+async function writeInitializer({ exportName }) {
+    const pascalized = (0, dream_1.pascalize)(exportName);
+    const camelized = (0, dream_1.camelize)(exportName);
+    const destDir = path.join((0, psychicPath_js_1.default)('conf'), 'initializers', 'openapi');
+    const initializerFilename = `${camelized}.ts`;
+    const initializerPath = path.join(destDir, initializerFilename);
+    try {
+        await fs.access(initializerPath);
+        return; // early return if the file already exists
+    }
+    catch {
+        // noop
+    }
+    try {
+        await fs.access(destDir);
+    }
+    catch {
+        await fs.mkdir(destDir, { recursive: true });
+    }
+    const filePath = path.join('.', 'src', 'conf', 'openapi', `${camelized}.openapi-codegen.json`);
+    const contents = `\
+import { DreamCLI } from '@rvoh/dream'
+import { PsychicApp } from '@rvoh/psychic'
+import AppEnv from '../AppEnv.js'
+
+export default function initialize${pascalized}(psy: PsychicApp) {
+  psy.on('sync', async () => {
+    if (AppEnv.isDevelopmentOrTest) {
+      DreamCLI.logger.logStartProgress(\`[${camelized}] syncing...\`)
+      await DreamCLI.spawn('npx @rtk-query/codegen-openapi ${filePath}', {
+        onStdout: message => {
+          DreamCLI.logger.logContinueProgress(\`[${camelized}]\` + ' ' + message, {
+            logPrefixColor: 'green',
+          })
+        },
+      })
+      DreamCLI.logger.logEndProgress()
+    }
+  })
+}\
+`;
+    await fs.writeFile(initializerPath, contents);
+}