@rvoh/psychic 0.24.1

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

@@ -0,0 +1,196 @@
+import { camelize, globalClassNameFromFullyQualifiedModelName, standardizeFullyQualifiedModelName, uniq, } from '@rvoh/dream';
+import relativePsychicPath from '../../helpers/path/relativePsychicPath.js';
+import updirsFromPath from '../../helpers/path/updirsFromPath.js';
+export default function generateResourceControllerSpecContent({ fullyQualifiedControllerName, route, fullyQualifiedModelName, columnsWithTypes, }) {
+    fullyQualifiedModelName = standardizeFullyQualifiedModelName(fullyQualifiedModelName);
+    const modelClassName = globalClassNameFromFullyQualifiedModelName(fullyQualifiedModelName);
+    const modelVariableName = camelize(modelClassName);
+    const importStatements = [
+        importStatementForModel(fullyQualifiedControllerName, fullyQualifiedModelName),
+        importStatementForModel(fullyQualifiedControllerName, 'User'),
+        importStatementForModelFactory(fullyQualifiedControllerName, fullyQualifiedModelName),
+        importStatementForModelFactory(fullyQualifiedControllerName, 'User'),
+    ];
+    const specUnitUpdirs = updirsFromPath(fullyQualifiedControllerName);
+    const originalStringKeyValues = [];
+    const updatedStringKeyValues = [];
+    const originalStringAttributeChecks = [];
+    const updatedStringAttributeChecks = [];
+    for (const attribute of columnsWithTypes) {
+        const [attributeName, attributeType] = attribute.split(':');
+        const originalName = `The ${fullyQualifiedModelName} ${attributeName}`;
+        const updatedName = `Updated ${fullyQualifiedModelName} ${attributeName}`;
+        switch (attributeType) {
+            case 'string':
+            case 'text':
+                originalStringKeyValues.push(`${attributeName}: '${originalName}',`);
+                updatedStringKeyValues.push(`${attributeName}: '${updatedName}',`);
+                originalStringAttributeChecks.push(`expect(${modelVariableName}.${attributeName}).toEqual('${originalName}')`);
+                updatedStringAttributeChecks.push(`expect(${modelVariableName}.${attributeName}).toEqual('${updatedName}')`);
+                break;
+            default:
+            // noop
+        }
+    }
+    return `\
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+import { UpdateableProperties } from '@rvoh/dream'
+import { PsychicServer } from '@rvohealth/psychic'
+import { specRequest as request } from '@rvoh/psychic-spec-helpers'${uniq(importStatements).join('')}
+import { addEndUserAuthHeader } from '${specUnitUpdirs}helpers/authentication'
+
+describe('${fullyQualifiedControllerName}', () => {
+  let user: User
+
+  beforeEach(async () => {
+    await request.init(PsychicServer)
+    user = await createUser()
+  })
+
+  describe('GET index', () => {
+    function subject(expectedStatus: number = 200) {
+      return request.get('/${route}', expectedStatus, {
+        headers: addEndUserAuthHeader(request, user, {}),
+      })
+    }
+
+    it('returns the index of ${fullyQualifiedModelName}s', async () => {
+      const ${modelVariableName} = await create${modelClassName}({
+        user${originalStringKeyValues.length ? ',\n        ' + originalStringKeyValues.join(',\n        ') : ''}
+      })
+      const results = (await subject()).body
+
+      expect(results).toEqual([
+        expect.objectContaining({
+          id: ${modelVariableName}.id,
+        }),
+      ])
+    })
+
+    context('${modelClassName}s created by another User', () => {
+      it('are omitted', async () => {
+        await create${modelClassName}()
+        const results = (await subject()).body
+
+        expect(results).toEqual([])
+      })
+    })
+  })
+
+  describe('GET show', () => {
+    function subject(${modelVariableName}: ${modelClassName}, expectedStatus: number = 200) {
+      return request.get(\`/${route}/\${${modelVariableName}.id}\`, expectedStatus, {
+        headers: addEndUserAuthHeader(request, user, {}),
+      })
+    }
+
+    it('returns the specified ${fullyQualifiedModelName}', async () => {
+      const ${modelVariableName} = await create${modelClassName}({
+        user${originalStringKeyValues.length ? ',\n        ' + originalStringKeyValues.join(',\n        ') : ''}
+      })
+      const results = (await subject(${modelVariableName})).body
+
+      expect(results).toEqual(
+        expect.objectContaining({
+          id: ${modelVariableName}.id,${originalStringKeyValues.length ? '\n          ' + originalStringKeyValues.join('\n          ') : ''}
+        }),
+      )
+    })
+
+    context('${fullyQualifiedModelName} created by another User', () => {
+      it('is not found', async () => {
+        const otherUser${modelClassName} = await create${modelClassName}()
+        await subject(otherUser${modelClassName}, 404)
+      })
+    })
+  })
+
+  describe('POST create', () => {
+    function subject(data: UpdateableProperties<${modelClassName}>, expectedStatus: number = 201) {
+      return request.post('/${route}', expectedStatus, {
+        data,
+        headers: addEndUserAuthHeader(request, user, {}),
+      })
+    }
+
+    it('creates a ${fullyQualifiedModelName} for this User', async () => {
+      const results = (await subject({
+        ${originalStringKeyValues.length ? originalStringKeyValues.join(',\n        ') : ''}
+      })).body
+      const ${modelVariableName} = await ${modelClassName}.findOrFailBy({ userId: user.id })
+
+      expect(results).toEqual(
+        expect.objectContaining({
+          id: ${modelVariableName}.id,${originalStringKeyValues.length ? '\n          ' + originalStringKeyValues.join('\n          ') : ''}
+        }),
+      )
+    })
+  })
+
+  describe('PATCH update', () => {
+    function subject(${modelVariableName}: ${modelClassName}, data: UpdateableProperties<${modelClassName}>, expectedStatus: number = 204) {
+      return request.patch(\`/${route}/\${${modelVariableName}.id}\`, expectedStatus, {
+        data,
+        headers: addEndUserAuthHeader(request, user, {}),
+      })
+    }
+
+    it('updates the ${fullyQualifiedModelName}', async () => {
+      const ${modelVariableName} = await create${modelClassName}({
+        user${originalStringKeyValues.length ? ',\n        ' + originalStringKeyValues.join(',\n        ') : ''}
+      })
+      await subject(${modelVariableName}, {
+        ${updatedStringKeyValues.length ? updatedStringKeyValues.join(',\n        ') : ''}
+      })
+
+      await ${modelVariableName}.reload()
+      ${updatedStringAttributeChecks.join('\n      ')}
+    })
+
+    context('a ${fullyQualifiedModelName} created by another User', () => {
+      it('is not updated', async () => {
+        const ${modelVariableName} = await create${modelClassName}({
+          ${originalStringKeyValues.length ? originalStringKeyValues.join(',\n          ') : ''}
+        })
+        await subject(${modelVariableName}, {
+          ${updatedStringKeyValues.length ? updatedStringKeyValues.join(',\n          ') : ''}
+        }, 404)
+
+        await ${modelVariableName}.reload()
+        ${originalStringAttributeChecks.join('\n        ')}
+      })
+    })
+  })
+
+  describe('DELETE destroy', () => {
+    function subject(${modelVariableName}: ${modelClassName}, expectedStatus: number = 204) {
+      return request.delete(\`/${route}/\${${modelVariableName}.id}\`, expectedStatus, {
+        headers: addEndUserAuthHeader(request, user, {}),
+      })
+    }
+
+    it('deletes the ${fullyQualifiedModelName}', async () => {
+      const ${modelVariableName} = await create${modelClassName}({ user })
+      await subject(${modelVariableName})
+
+      expect(await ${modelClassName}.find(${modelVariableName}.id)).toBeNull()
+    })
+
+    context('a ${fullyQualifiedModelName} created by another User', () => {
+      it('is not deleted', async () => {
+        const ${modelVariableName} = await create${modelClassName}()
+        await subject(${modelVariableName}, 404)
+
+        expect(await ${modelClassName}.find(${modelVariableName}.id)).toMatchDreamModel(${modelVariableName})
+      })
+    })
+  })
+})
+`;
+}
+function importStatementForModel(originModelName, destinationModelName = originModelName) {
+    return `\nimport ${globalClassNameFromFullyQualifiedModelName(destinationModelName)} from '${relativePsychicPath('controllerSpecs', 'models', originModelName, destinationModelName)}'`;
+}
+function importStatementForModelFactory(originModelName, destinationModelName = originModelName) {
+    return `\nimport create${globalClassNameFromFullyQualifiedModelName(destinationModelName)} from '${relativePsychicPath('controllerSpecs', 'factories', originModelName, destinationModelName)}'`;
+}

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

@@ -0,0 +1,3 @@
+export default function migrationTimestamp() {
+    return new Date().getTime();
+}

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

@@ -0,0 +1,16 @@
+import { generateDream, standardizeFullyQualifiedModelName } from '@rvoh/dream';
+import pluralize from 'pluralize-esm';
+import generateController from './controller.js';
+import addResourceToRoutes from './helpers/addResourceToRoutes.js';
+export default async function generateResource({ route, fullyQualifiedModelName, columnsWithTypes, }) {
+    await generateDream({ fullyQualifiedModelName, columnsWithTypes, options: { serializer: true } });
+    route = pluralize(route);
+    await generateController({
+        fullyQualifiedControllerName: standardizeFullyQualifiedModelName(route),
+        fullyQualifiedModelName,
+        actions: ['create', 'index', 'show', 'update', 'destroy'],
+        columnsWithTypes,
+        resourceSpecs: true,
+    });
+    await addResourceToRoutes(route);
+}

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

@@ -0,0 +1,3 @@
+import { Env } from '@rvoh/dream';
+const EnvInternal = new Env();
+export default EnvInternal;

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

@@ -0,0 +1,68 @@
+import { basicLogo } from '../psychic-application/logo.js';
+export default function autogeneratedFileDisclaimer(startComment = '\n/*', endComment = '\n*/') {
+    return `\
+${startComment}
+--#--#--#--#--#--#--#--#--#--#--#--#--#--#--#
+#--#--#--#--#--#--#--#--#--#--#--#--#--#--#--
+--#--#--#--#--#--#--#--#--#--#--#--#--#--#--#
+#--#--#--#--#--#--#--#--#--#--#--#--#--#--#--
+      BEGIN AUTOGENERATED MESSAGE
+--#--#--#--#--#--#--#--#--#--#--#--#--#--#--#
+#--#--#--#--#--#--#--#--#--#--#--#--#--#--#--
+--#--#--#--#--#--#--#--#--#--#--#--#--#--#--#
+#--#--#--#--#--#--#--#--#--#--#--#--#--#--#--
+
+
+${basicLogo()}
+
+This file was automatically generated by my cat, Aster.
+He does not want you mucking about with his files,
+and we are pretty lax on trimming his nails.
+
+I mean, we have him pretty well fenced in but he is an
+escape artist and he still manages to get fleas!
+
+My point is, don't go mucking about with his files!
+
+He actually has a hopefully well-tempered message for
+us humans, he says:
+
+"
+  Dear pathetic humans,
+
+  Here is a haiku to keep you in line
+
+  don't dare go mucking
+  with my files, I lyke them fine
+  prettierignore
+"
+
+Sorry, that's the best we are ganna get from him
+when you ask him to add a disclaimer to all
+autogenerated files on a SUNDAY, when the sun
+is hitting the perfect spot in the living room
+for a mid-morning nap! He can get saucy, and he
+is looking over my shoulder and would like me to
+remind all humans that
+
+"
+a.) I have sharp claws.
+b.) All laptops are ok sleeping places for your
+    cat overlords. when we decide to sleep on
+    them, it is because they are our beds, and
+    we just loan them out to you so you can go
+    out and get us the right food.
+"
+
+--#--#--#--#--#--#--#--#--#--#--#--#--#--#--#
+#--#--#--#--#--#--#--#--#--#--#--#--#--#--#--
+--#--#--#--#--#--#--#--#--#--#--#--#--#--#--#
+#--#--#--#--#--#--#--#--#--#--#--#--#--#--#--
+      END AUTOGENERATED MESSAGE
+--#--#--#--#--#--#--#--#--#--#--#--#--#--#--#
+#--#--#--#--#--#--#--#--#--#--#--#--#--#--#--
+--#--#--#--#--#--#--#--#--#--#--#--#--#--#--#
+#--#--#--#--#--#--#--#--#--#--#--#--#--#--#--
+${endComment}
+`;
+}

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

@@ -0,0 +1,17 @@
+const DEFAULT_COOKIE_MAX_AGE_DAYS = 31;
+export default function cookieMaxAgeFromCookieOpts(cookieOpts) {
+    const defaultMaxAge = DEFAULT_COOKIE_MAX_AGE_DAYS * 60 * 60 * 24 * 1000;
+    if (!cookieOpts)
+        return defaultMaxAge;
+    if (!cookieOpts.milliseconds &&
+        !cookieOpts.seconds &&
+        !cookieOpts.minutes &&
+        !cookieOpts.hours &&
+        !cookieOpts.days)
+        return defaultMaxAge;
+    return ((cookieOpts.milliseconds || 0) +
+        (cookieOpts.seconds ? cookieOpts.seconds * 1000 : 0) +
+        (cookieOpts.minutes ? cookieOpts.minutes * 60 * 1000 : 0) +
+        (cookieOpts.hours ? cookieOpts.hours * 60 * 60 * 1000 : 0) +
+        (cookieOpts.days ? cookieOpts.days * 60 * 60 * 24 * 1000 : 0));
+}

package/dist/esm/src/helpers/error/errorIsRescuableHttpError.js

@@ -0,0 +1,5 @@
+import { rescuableHttpErrorClasses } from './httpErrorClasses.js';
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export default function errorIsRescuableHttpError(err) {
+    return !!rescuableHttpErrorClasses().find(klass => err instanceof klass);
+}

package/dist/esm/src/helpers/error/httpErrorClasses.js

@@ -0,0 +1,72 @@
+import HttpStatusBadGateway from '../../error/http/BadGateway.js';
+import HttpStatusBadRequest from '../../error/http/BadRequest.js';
+import HttpStatusConflict from '../../error/http/Conflict.js';
+import HttpStatusExpectationFailed from '../../error/http/ExpectationFailed.js';
+import HttpStatusFailedDependency from '../../error/http/FailedDependency.js';
+import HttpStatusForbidden from '../../error/http/Forbidden.js';
+import HttpStatusGatewayTimeout from '../../error/http/GatewayTimeout.js';
+import HttpStatusGone from '../../error/http/Gone.js';
+import HttpStatusImATeapot from '../../error/http/ImATeapot.js';
+import HttpStatusInsufficientStorage from '../../error/http/InsufficientStorage.js';
+import HttpStatusInternalServerError from '../../error/http/InternalServerError.js';
+import HttpStatusLocked from '../../error/http/Locked.js';
+import HttpStatusMethodNotAllowed from '../../error/http/MethodNotAllowed.js';
+import HttpStatusMisdirectedRequest from '../../error/http/MisdirectedRequest.js';
+import HttpStatusNotAcceptable from '../../error/http/NotAcceptable.js';
+import HttpStatusNotExtended from '../../error/http/NotExtended.js';
+import HttpStatusNotFound from '../../error/http/NotFound.js';
+import HttpStatusNotImplemented from '../../error/http/NotImplemented.js';
+import HttpStatusContentTooLarge from '../../error/http/ContentTooLarge.js';
+import HttpStatusPaymentRequired from '../../error/http/PaymentRequired.js';
+import HttpStatusPreconditionFailed from '../../error/http/PreconditionFailed.js';
+import HttpStatusPreconditionRequired from '../../error/http/PreconditionRequired.js';
+import HttpStatusProxyAuthenticationRequired from '../../error/http/ProxyAuthenticationRequired.js';
+import HttpStatusRequestHeaderFieldsTooLarge from '../../error/http/RequestHeaderFieldsTooLarge.js';
+import HttpStatusServiceUnavailable from '../../error/http/ServiceUnavailable.js';
+import HttpStatusTooManyRequests from '../../error/http/TooManyRequests.js';
+import HttpStatusUnauthorized from '../../error/http/Unauthorized.js';
+import HttpStatusUnavailableForLegalReasons from '../../error/http/UnavailableForLegalReasons.js';
+import HttpStatusUnprocessableContent from '../../error/http/UnprocessableContent.js';
+import HttpStatusUnsupportedMediaType from '../../error/http/UnsupportedMediaType.js';
+export default function httpErrorClasses() {
+    const clientErrorClasses = [
+        HttpStatusBadRequest, // 400
+        HttpStatusUnauthorized, // 401
+        HttpStatusPaymentRequired, // 402
+        HttpStatusForbidden, // 403
+        HttpStatusNotFound, // 404
+        HttpStatusMethodNotAllowed, // 405
+        HttpStatusNotAcceptable, // 406
+        HttpStatusProxyAuthenticationRequired, // 407
+        HttpStatusConflict, // 409
+        HttpStatusGone, // 410
+        HttpStatusPreconditionFailed, // 412
+        HttpStatusContentTooLarge, // 413
+        HttpStatusUnsupportedMediaType, // 415
+        HttpStatusExpectationFailed, // 417
+        HttpStatusImATeapot, // 418
+        HttpStatusMisdirectedRequest, // 421
+        HttpStatusUnprocessableContent, // 422
+        HttpStatusLocked, // 423
+        HttpStatusFailedDependency, // 424
+        HttpStatusPreconditionRequired, // 428
+        HttpStatusTooManyRequests, // 429
+        HttpStatusRequestHeaderFieldsTooLarge, // 431
+        HttpStatusUnavailableForLegalReasons, // 451
+    ];
+    const serverErrorClasses = [
+        HttpStatusInternalServerError, // 500
+        HttpStatusNotImplemented, // 501
+        HttpStatusBadGateway, // 502
+        HttpStatusServiceUnavailable, // 503
+        HttpStatusGatewayTimeout, // 504
+        HttpStatusInsufficientStorage, // 507
+        HttpStatusNotExtended, // 510
+    ];
+    return [...clientErrorClasses, ...serverErrorClasses];
+}
+export function rescuableHttpErrorClasses() {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const unrescuableClasses = [HttpStatusInternalServerError];
+    return httpErrorClasses().filter(klass => !unrescuableClasses.includes(klass));
+}

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

@@ -0,0 +1,11 @@
+export default async function importFileWithDefault(filePath) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    const file = await import(filePath);
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-return
+    if (file?.default?.default)
+        return file.default.default;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-return
+    if (file?.default)
+        return file.default;
+    return file;
+}

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

@@ -0,0 +1,9 @@
+export default async function importFileWithNamedExport(filePath, namedExport = 'default') {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    const file = await import(filePath);
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-return
+    if (file?.default?.[namedExport])
+        return file.default[namedExport];
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+    return file[namedExport];
+}

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

@@ -0,0 +1,3 @@
+export default function isOpenapiError(error) {
+    return error?.name && error?.status && error?.path && error?.errors?.length;
+}

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

@@ -0,0 +1,5 @@
+export default function isUuid(val) {
+    if (typeof val !== 'string')
+        return false;
+    return /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$/.test(val);
+}

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

@@ -0,0 +1,3 @@
+import * as dotenv from 'dotenv';
+import EnvInternal from './EnvInternal.js';
+dotenv.config({ path: EnvInternal.isTest ? '.env.test' : '.env' });

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

@@ -0,0 +1,6 @@
+import * as path from 'path';
+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);
+}

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

@@ -0,0 +1,7 @@
+import { capitalize, pascalize } from '@rvoh/dream';
+export default function pascalizeFileName(route) {
+    return route
+        .split('/')
+        .map(segment => capitalize(pascalize(segment)))
+        .join('');
+}

package/dist/esm/src/helpers/path/psychicFileAndDirPaths.js

@@ -0,0 +1,13 @@
+import * as path from 'path';
+import PsychicApplication from '../../psychic-application/index.js';
+export default function (relDirPath, partialFilePath) {
+    const psychicApp = PsychicApplication.getOrFail();
+    const relFilePath = path.join(relDirPath, partialFilePath);
+    const absFilePath = path.join(psychicApp.apiRoot, relFilePath);
+    const absDirPath = absFilePath.replace(/\/[^/]+$/, '');
+    return {
+        relFilePath,
+        absDirPath,
+        absFilePath,
+    };
+}

package/dist/esm/src/helpers/path/psychicPath.js

@@ -0,0 +1,15 @@
+import { dreamPath } from '@rvoh/dream';
+import PsychicApplication from '../../psychic-application/index.js';
+export default function (dreamPathType) {
+    const psychicApp = PsychicApplication.getOrFail();
+    switch (dreamPathType) {
+        case 'apiRoutes':
+            return psychicApp.paths.apiRoutes;
+        case 'controllers':
+            return psychicApp.paths.controllers;
+        case 'controllerSpecs':
+            return psychicApp.paths.controllerSpecs;
+        default:
+            return dreamPath(dreamPathType);
+    }
+}

package/dist/esm/src/helpers/path/relativePsychicPath.js

@@ -0,0 +1,39 @@
+import { pascalize, sharedPathPrefix, standardizeFullyQualifiedModelName } from '@rvoh/dream';
+import psychicPath from './psychicPath.js';
+import updirsFromPath from './updirsFromPath.js';
+export default function (originDreamPathType, destinationDreamPathType, fullyQualifiedOriginModelName, fullyQualifiedDestinationModelName = fullyQualifiedOriginModelName) {
+    fullyQualifiedOriginModelName = standardizeFullyQualifiedModelName(fullyQualifiedOriginModelName);
+    fullyQualifiedDestinationModelName = pascalize(fullyQualifiedDestinationModelName);
+    let pathToRemove = fullyQualifiedOriginModelName;
+    if (originDreamPathType === destinationDreamPathType) {
+        const sharedPrefixLength = sharedPathPrefix(fullyQualifiedOriginModelName, fullyQualifiedDestinationModelName).length;
+        pathToRemove = fullyQualifiedOriginModelName.slice(sharedPrefixLength);
+        fullyQualifiedDestinationModelName = fullyQualifiedDestinationModelName.slice(sharedPrefixLength);
+    }
+    const numAdditionalUpdirs = pathToRemove.split('/').length - 1;
+    let additionalUpdirs = '';
+    for (let i = 0; i < numAdditionalUpdirs; i++) {
+        additionalUpdirs = `../${additionalUpdirs}`;
+    }
+    const baseRelativePath = psychicPathTypeRelativePath(originDreamPathType, destinationDreamPathType);
+    let destinationPath = additionalUpdirs + (baseRelativePath.length ? baseRelativePath + '/' : '');
+    if (destinationPath[0] !== '.')
+        destinationPath = `./${destinationPath}`;
+    switch (destinationDreamPathType) {
+        case 'db':
+            return destinationPath;
+        case 'factories':
+            return `${destinationPath}${fullyQualifiedDestinationModelName}Factory`;
+        case 'serializers':
+            return `${destinationPath}${fullyQualifiedDestinationModelName}Serializer`;
+        default:
+            return `${destinationPath}${fullyQualifiedDestinationModelName}`;
+    }
+}
+export function psychicPathTypeRelativePath(originDreamPathType, destinationDreamPathType) {
+    const originPath = psychicPath(originDreamPathType);
+    const destinationPath = psychicPath(destinationDreamPathType);
+    const sharedPrefixLength = sharedPathPrefix(originPath, destinationPath).length;
+    const originPathToRemove = originPath.slice(sharedPrefixLength);
+    return updirsFromPath(originPathToRemove) + destinationPath.slice(sharedPrefixLength);
+}

package/dist/esm/src/helpers/path/updirsFromPath.js

@@ -0,0 +1,8 @@
+export default function updirsFromPath(path) {
+    return path.length === 0
+        ? ''
+        : path
+            .split('/')
+            .map(() => '../')
+            .join('');
+}

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

@@ -0,0 +1,7 @@
+import { promises as fs } from 'fs';
+export async function loadFile(filepath) {
+    return await fs.readFile(filepath);
+}
+export async function writeFile(filepath, contents) {
+    return await fs.writeFile(filepath, contents);
+}

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

@@ -0,0 +1,11 @@
+import { isObject } from './typechecks.js';
+export default function pathifyNestedObject(obj, prefix = '') {
+    return Object.keys(obj).reduce((acc, k) => {
+        const pre = prefix.length ? prefix + '/' : '';
+        if (isObject(obj[k]))
+            Object.assign(acc, pathifyNestedObject(obj[k], pre + k));
+        else
+            acc[pre + k] = obj[k];
+        return acc;
+    }, {});
+}

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

@@ -0,0 +1,22 @@
+import { spawn } from 'child_process';
+export default function sspawn(command, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+opts = {}) {
+    return new Promise((accept, reject) => {
+        ssspawn(command, opts).on('close', code => {
+            if (code !== 0)
+                reject(new Error(code?.toString()));
+            accept({});
+        });
+    });
+}
+export function ssspawn(command, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+opts = {}) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+    return spawn(command, {
+        stdio: 'inherit',
+        shell: true,
+        ...opts,
+    });
+}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,16 @@
+export function isString(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+x) {
+    return typeof x === 'string' || x instanceof String;
+}
+export function isObject(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+x) {
+    if (x === null)
+        return false;
+    if (isString(x))
+        return false;
+    if (Array.isArray(x))
+        return false;
+    return typeof x === 'object';
+}

package/dist/esm/src/i18n/conf/I18nDefaultLocales.js

@@ -0,0 +1,29 @@
+const I18nDefaultLocales = [
+    'de-DE',
+    'en-AU',
+    'en-BZ',
+    'en-CA',
+    'en-cb',
+    'en-GB',
+    'en-IE',
+    'en-IN',
+    'en-JM',
+    'en-MT',
+    'en-MY',
+    'en-NZ',
+    'en-PH',
+    'en-SG',
+    'en-TT',
+    'en-US',
+    'en-ZA',
+    'en-ZW',
+    'es-ES',
+    'fr-FR',
+    'it-IT',
+    'ja-JP',
+    'ko-KR',
+    'pt-BR',
+    'zh-CN',
+    'zh-TW',
+];
+export default I18nDefaultLocales;

package/dist/esm/src/i18n/conf/types.js

@@ -0,0 +1 @@
+export {};