@rvoh/dream 0.31.1 → 0.31.2

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

@@ -13,20 +13,25 @@ import sspawn from '../helpers/sspawn.js';
 import writeSyncFile from './helpers/sync.js';
 export default class DreamBin {
     static async sync(onSync) {
+        DreamCLI.logger.logStartProgress('writing db schema...');
         await writeSyncFile();
+        DreamCLI.logger.logEndProgress();
+        DreamCLI.logger.logStartProgress('building dream schema...');
         await this.buildDreamSchema();
+        DreamCLI.logger.logEndProgress();
+        DreamCLI.logger.logStartProgress('running sync hooks...');
         await onSync();
+        DreamCLI.logger.logEndProgress();
     }
     static async buildDreamSchema() {
-        const spinner = DreamCLI.logger.log('writing dream schema...', { spinner: true });
         await new SchemaBuilder().build();
-        spinner.stop();
     }
     static async dbCreate() {
         const connectionRetriever = new ConnectionConfRetriever();
         const primaryDbConf = connectionRetriever.getConnectionConf('primary');
-        const spinner = DreamCLI.logger.log(`creating ${primaryDbConf.name}...`, { spinner: true });
+        DreamCLI.logger.logStartProgress(`creating ${primaryDbConf.name}...`);
         await createDb('primary');
+        DreamCLI.logger.logEndProgress();
         // TODO: add support for creating replicas. Began doing it below, but it is very tricky,
         // and we don't need it at the moment, so kicking off for future development when we have more time
         // to flesh this out.
@@ -35,13 +40,13 @@ export default class DreamBin {
         //   console.log(`creating ${process.env[replicaDbConf.name]}`)
         //   await createDb('replica')
         // }
-        spinner.stop();
     }
     static async dbDrop() {
         const connectionRetriever = new ConnectionConfRetriever();
         const primaryDbConf = connectionRetriever.getConnectionConf('primary');
-        const spinner = DreamCLI.logger.log(`dropping ${primaryDbConf.name}...`, { spinner: true });
+        DreamCLI.logger.logStartProgress(`dropping ${primaryDbConf.name}...`);
         await _dropDb('primary');
+        DreamCLI.logger.logEndProgress();
         // TODO: add support for dropping replicas. Began doing it below, but it is very tricky,
         // and we don't need it at the moment, so kicking off for future development when we have more time
         // to flesh this out.
@@ -50,27 +55,26 @@ export default class DreamBin {
         //   console.log(`dropping ${process.env[replicaDbConf.name]}`)
         //   await _dropDb('replica')
         // }
-        spinner.stop();
     }
     static async dbMigrate() {
         const connectionRetriever = new ConnectionConfRetriever();
         const primaryDbConf = connectionRetriever.getConnectionConf('primary');
-        const spinner = DreamCLI.logger.log(`migrating ${primaryDbConf.name}...`, { spinner: true });
+        DreamCLI.logger.logStartProgress(`migrating ${primaryDbConf.name}...`);
         await runMigration({ mode: 'migrate' });
         await this.duplicateDatabase();
-        spinner.stop();
+        DreamCLI.logger.logEndProgress();
     }
     static async dbRollback(opts) {
         const connectionRetriever = new ConnectionConfRetriever();
         const primaryDbConf = connectionRetriever.getConnectionConf('primary');
-        const spinner = DreamCLI.logger.log(`rolling back ${primaryDbConf.name}...`, { spinner: true });
+        DreamCLI.logger.logStartProgress(`rolling back ${primaryDbConf.name}...`);
         let step = opts.steps;
         while (step > 0) {
             await runMigration({ mode: 'rollback' });
             step -= 1;
         }
         await this.duplicateDatabase();
-        spinner.stop();
+        DreamCLI.logger.logEndProgress();
     }
     static async generateDream(fullyQualifiedModelName, columnsWithTypes, options) {
         await generateDream({ fullyQualifiedModelName, columnsWithTypes, options });
@@ -85,8 +89,9 @@ export default class DreamBin {
     // It is only made private so that people don't mistakenly try
     // to use it to generate docs for their apps.
     static async buildDocs() {
-        DreamCLI.logger.log('generating docs...');
+        DreamCLI.logger.logStartProgress('generating docs...');
         await sspawn('yarn typedoc src/index.ts --tsconfig ./tsconfig.esm.build.json --out docs');
+        DreamCLI.logger.logEndProgress();
     }
     static async duplicateDatabase() {
         const parallelTests = DreamApplication.getOrFail().parallelTests;
@@ -97,22 +102,16 @@ export default class DreamBin {
         const client = await loadPgClient({ useSystemDb: true });
         if (process.env.DREAM_CORE_DEVELOPMENT === '1') {
             const replicaTestWorkerDatabaseName = `replica_test_${dbConf.name}`;
-            const spinner = DreamCLI.logger.log(`creating fake replica test database ${replicaTestWorkerDatabaseName}...`, {
-                spinner: true,
-            });
+            DreamCLI.logger.logContinueProgress(`creating fake replica test database ${replicaTestWorkerDatabaseName}...`);
             await client.query(`DROP DATABASE IF EXISTS ${replicaTestWorkerDatabaseName};`);
             await client.query(`CREATE DATABASE ${replicaTestWorkerDatabaseName} TEMPLATE ${dbConf.name};`);
-            spinner.stop();
         }
         for (let i = 2; i <= parallelTests; i++) {
             const workerDatabaseName = `${dbConf.name}_${i}`;
             console.log(`creating duplicate test database ${workerDatabaseName} for concurrent tests`);
-            const spinner = DreamCLI.logger.log(`creating duplicate test database ${workerDatabaseName} for concurrent tests...`, {
-                spinner: true,
-            });
+            DreamCLI.logger.logContinueProgress(`creating duplicate test database ${workerDatabaseName} for concurrent tests...`);
             await client.query(`DROP DATABASE IF EXISTS ${workerDatabaseName};`);
             await client.query(`CREATE DATABASE ${workerDatabaseName} TEMPLATE ${dbConf.name};`);
-            spinner.stop();
         }
         await client.end();
     }

package/dist/esm/src/cli/logger/DreamCliLogger.js

@@ -1,54 +1,20 @@
-import DreamCliLoggableSpinner from './loggable/DreamCliLoggableSpinner.js';
 import DreamCliLoggableText from './loggable/DreamCliLoggableText.js';
 export default class DreamCliLogger {
-    logs = [];
-    log(text, { permanent = false, spinner = false, logPrefix, logPrefixColor, logPrefixBgColor, spinnerPrefixColor = 'greenBright', spinnerPrefixBgColor, } = {}) {
-        const loggable = spinner
-            ? new DreamCliLoggableSpinner({
-                text,
-                permanent: false,
-                spinner: 'noise',
-                color: spinnerPrefixColor,
-                bgColor: spinnerPrefixBgColor,
-            })
-            : new DreamCliLoggableText(text, {
-                permanent,
-                logPrefix,
-                logPrefixColor: logPrefixColor || (permanent ? 'green' : 'yellow'),
-                logPrefixBgColor,
-            });
-        this.logs.push(loggable);
-        // re-render everything
-        this.render();
-        return loggable;
-    }
-    render() {
-        this.clear();
-        let skipNext = false;
-        this.logs.forEach(loggable => {
-            if (skipNext) {
-                skipNext = false;
-                return;
-            }
-            loggable.render();
+    log(text, { logPrefix, logPrefixColor, logPrefixBgColor } = {}) {
+        const loggable = new DreamCliLoggableText(text, {
+            logPrefix,
+            logPrefixColor: logPrefixColor || 'green',
+            logPrefixBgColor,
         });
+        loggable.render();
     }
-    get spinners() {
-        return this.logs.filter(log => log instanceof DreamCliLoggableSpinner);
+    logStartProgress(text, { logPrefix = '✺ ┌', logPrefixColor, logPrefixBgColor } = {}) {
+        this.log(text, { logPrefix, logPrefixColor, logPrefixBgColor });
     }
-    /*
-     * remove all logs that are not marked permanent,
-     * then clear STDOUT and re-render with only
-     * the permanent logs remaining.
-     */
-    purge() {
-        this.logs = this.logs.filter(log => log.permanent);
-        this.render();
+    logContinueProgress(text, { logPrefix = '✺ ├', logPrefixColor, logPrefixBgColor } = {}) {
+        this.log(text, { logPrefix, logPrefixColor, logPrefixBgColor });
     }
-    clear() {
-        console.clear();
-        // @ts-expect-error this works fine with no args provided
-        process.stdout.clearLine?.();
-        process.stdout.cursorTo?.(0);
+    logEndProgress(text = 'complete', { logPrefix = '✺ └', logPrefixColor, logPrefixBgColor } = {}) {
+        this.log(text, { logPrefix, logPrefixColor, logPrefixBgColor });
     }
 }

package/dist/esm/src/cli/logger/loggable/DreamCliLoggable.js

@@ -1,11 +1,9 @@
 import colorize from './colorize.js';
 export default class DreamCliLoggable {
-    permanent;
     logPrefix;
     logPrefixColor;
     logPrefixBgColor;
-    constructor({ permanent, logPrefix = '✺', logPrefixColor, logPrefixBgColor, }) {
-        this.permanent = permanent;
+    constructor({ logPrefix = '✺', logPrefixColor, logPrefixBgColor, }) {
         this.logPrefix = logPrefix;
         this.logPrefixColor = logPrefixColor;
         this.logPrefixBgColor = logPrefixBgColor;

package/dist/esm/src/cli/logger/loggable/DreamCliLoggableText.js

@@ -4,8 +4,8 @@ export default class DreamCliLoggableText extends DreamCliLoggable {
     text;
     color;
     bgColor;
-    constructor(text, { permanent, logPrefix, color, bgColor, logPrefixColor, logPrefixBgColor, }) {
-        super({ permanent, logPrefix });
+    constructor(text, { logPrefix, color, bgColor, logPrefixColor, logPrefixBgColor, }) {
+        super({ logPrefix });
         this.text = text;
         this.color = color;
         this.bgColor = bgColor;

package/dist/esm/src/decorators/Decorators.js

@@ -27,13 +27,13 @@ export default class Decorators {
      *
      * ```ts
      * class UserSettings extends ApplicationModel {
-     *   @Deco.BelongsTo('User')
+     *   @deco.BelongsTo('User')
      *   public user: User
      *   public userId: DreamColumn<UserSettings, 'userId'>
      * }
      *
      * class User extends ApplicationModel {
-     *   @Deco.HasOne('UserSettings')
+     *   @deco.HasOne('UserSettings')
      *   public userSettings: UserSettings
      * }
      * ```
@@ -55,12 +55,12 @@ export default class Decorators {
      *
      * ```ts
      * class User extends ApplicationModel {
-     *   @Deco.HasMany('Post')
+     *   @deco.HasMany('Post')
      *   public posts: Post[]
      * }
      *
      * class Post extends ApplicationModel {
-     *   @Deco.BelongsTo('User')
+     *   @deco.BelongsTo('User')
      *   public user: User
      *   public userId: DreamColumn<Post, 'userId'>
      * }
@@ -80,12 +80,12 @@ export default class Decorators {
      *
      * ```ts
      * class User extends ApplicationModel {
-     *   @Deco.HasOne('UserSettings')
+     *   @deco.HasOne('UserSettings')
      *   public userSettings: UserSettings
      * }
      *
      * class UserSettings extends ApplicationModel {
-     *   @Deco.BelongsTo('User')
+     *   @deco.BelongsTo('User')
      *   public user: User
      *   public userId: DreamColumn<UserSettings, 'userId'>
      * }
@@ -108,14 +108,14 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.Encrypted()
+     *   @deco.Encrypted()
      *   // automatically sets `encryptedSsn` to the encrypted value that
      *   // `ssn` is set to in new/create/update, e.g., `await user.update({ ssn })`
      *   public ssn: string
      *
      *   // automatically sets `myEncryptedPhone` to the encrypted value that
      *   // `phone` is set to new/create/update, e.g., `await user.update({ phone })`
-     *   @Deco.Encrypted('myEncryptedPhone)
+     *   @deco.Encrypted('myEncryptedPhone)
      *   public phone: string
      * }
      * ```
@@ -132,7 +132,7 @@ export default class Decorators {
      *
      * ```ts
      * class Collar {
-     *   @Deco.Scope({ default: true })
+     *   @deco.Scope({ default: true })
      *   public static hideHiddenCollars(query: Query<Collar>) {
      *     return query.where({ hidden: false })
      *   }
@@ -154,7 +154,7 @@ export default class Decorators {
      *
      * ```ts
      * class Balloon {
-     *   @Deco.Sortable({ scope: 'user' })
+     *   @deco.Sortable({ scope: 'user' })
      *   public position: DreamColumn<Balloon, 'position'>
      * }
      * ```
@@ -172,7 +172,7 @@ export default class Decorators {
      *
      * ```ts
      * class Sandbag {
-     *   @Deco.Validate()
+     *   @deco.Validate()
      *   public validateWeight(this: Sandbag) {
      *     if (!this.weight) return
      *
@@ -197,7 +197,7 @@ export default class Decorators {
      *
      * ```ts
      * class Balloon {
-     *   @Deco.Validates('numericality', { min: 0, max: 100 })
+     *   @deco.Validates('numericality', { min: 0, max: 100 })
      *   public volume: DreamColumn<Balloon, 'volume'>
      * }
      * ```
@@ -231,7 +231,7 @@ export default class Decorators {
      *
      * ```ts
      * class BodyMeasurement {
-     *   @Deco.Virtual()
+     *   @deco.Virtual()
      *   public get lbs() {
      *     const self: User = this
      *     return gramsToLbs(self.getAttribute('grams') ?? 0)
@@ -242,7 +242,7 @@ export default class Decorators {
      *     self.setAttribute('grams', lbsToGrams(lbs))
      *   }
      *
-     *   @Deco.Virtual()
+     *   @deco.Virtual()
      *   public get kilograms() {
      *     const self: User = this
      *     return gramsToKilograms(self.getAttribute('grams') ?? 0)
@@ -258,10 +258,10 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.Virtual()
+     *   @deco.Virtual()
      *   public password: string
      *
-     *   @Deco.BeforeSave()
+     *   @deco.BeforeSave()
      *   public hasPassword() {
      *     this.setAttribute('hashedPassword', preferredHashingAlgorithm(this.password))
      *   }
@@ -278,7 +278,7 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.BeforeCreate()
+     *   @deco.BeforeCreate()
      *   public doSomething() {
      *     console.log('hi!')
      *   }
@@ -296,7 +296,7 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.BeforeSave()
+     *   @deco.BeforeSave()
      *   public doSomething() {
      *     console.log('hi!')
      *   }
@@ -314,7 +314,7 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.BeforeUpdate()
+     *   @deco.BeforeUpdate()
      *   public doSomething() {
      *     console.log('hi!')
      *   }
@@ -332,7 +332,7 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.BeforeDestroy()
+     *   @deco.BeforeDestroy()
      *   public doSomething() {
      *     console.log('hi!')
      *   }
@@ -349,7 +349,7 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.AfterCreate()
+     *   @deco.AfterCreate()
      *   public doSomething() {
      *     console.log('hi!')
      *   }
@@ -367,7 +367,7 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.AfterCreateCommit()
+     *   @deco.AfterCreateCommit()
      *   public doSomething() {
      *     console.log('hi!')
      *   }
@@ -384,7 +384,7 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.AfterSave()
+     *   @deco.AfterSave()
      *   public doSomething() {
      *     console.log('hi!')
      *   }
@@ -402,7 +402,7 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.AfterSaveCommit()
+     *   @deco.AfterSaveCommit()
      *   public doSomething() {
      *     console.log('hi!')
      *   }
@@ -420,7 +420,7 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.AfterUpdate()
+     *   @deco.AfterUpdate()
      *   public doSomething() {
      *     console.log('hi!')
      *   }
@@ -438,7 +438,7 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.AfterUpdateCommit()
+     *   @deco.AfterUpdateCommit()
      *   public doSomething() {
      *     console.log('hi!')
      *   }
@@ -456,7 +456,7 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.AfterDestroy()
+     *   @deco.AfterDestroy()
      *   public doSomething() {
      *     console.log('hi!')
      *   }
@@ -474,7 +474,7 @@ export default class Decorators {
      *
      * ```ts
      * class User {
-     *   @Deco.AfterDestroyCommit()
+     *   @deco.AfterDestroyCommit()
      *   public doSomething() {
      *     console.log('hi!')
      *   }

package/dist/esm/src/decorators/field/association/BelongsTo.js

@@ -8,13 +8,13 @@ import { applyGetterAndSetter, associationPrimaryKeyAccessors, blankAssociations
  *
  * ```ts
  * class UserSettings extends ApplicationModel {
- *   @Deco.BelongsTo('User')
+ *   @deco.BelongsTo('User')
  *   public user: User
  *   public userId: DreamColumn<UserSettings, 'userId'>
  * }
  *
  * class User extends ApplicationModel {
- *   @Deco.HasOne('UserSettings')
+ *   @deco.HasOne('UserSettings')
  *   public userSettings: UserSettings
  * }
  * ```

package/dist/esm/src/decorators/field/association/HasMany.js

@@ -7,12 +7,12 @@ import { applyGetterAndSetter, associationPrimaryKeyAccessors, blankAssociations
  *
  * ```ts
  * class User extends ApplicationModel {
- *   @Deco.HasMany('Post')
+ *   @deco.HasMany('Post')
  *   public posts: Post[]
  * }
  *
  * class Post extends ApplicationModel {
- *   @Deco.BelongsTo('User')
+ *   @deco.BelongsTo('User')
  *   public user: User
  *   public userId: DreamColumn<Post, 'userId'>
  * }

package/dist/esm/src/decorators/field/association/HasOne.js

@@ -7,12 +7,12 @@ import { applyGetterAndSetter, associationPrimaryKeyAccessors, blankAssociations
  *
  * ```ts
  * class User extends ApplicationModel {
- *   @Deco.HasOne('UserSettings')
+ *   @deco.HasOne('UserSettings')
  *   public userSettings: UserSettings
  * }
  *
  * class UserSettings extends ApplicationModel {
- *   @Deco.BelongsTo('User')
+ *   @deco.BelongsTo('User')
  *   public user: User
  *   public userId: DreamColumn<UserSettings, 'userId'>
  * }

package/dist/esm/src/decorators/field/lifecycle/AfterCreateCommit.js

@@ -8,7 +8,7 @@ import { blankHooksFactory } from './shared.js';
  * is complete.
  *
  * class User extends ApplicationModel {
- *   @Deco.AfterCreateCommit()
+ *   @deco.AfterCreateCommit()
  *   public doSomething() {
  *     ...
  *   }

package/dist/esm/src/decorators/field/lifecycle/AfterDestroyCommit.js

@@ -8,7 +8,7 @@ import { blankHooksFactory } from './shared.js';
  * is complete.
  *
  * class User extends ApplicationModel {
- *   @Deco.AfterDestroyCommit()
+ *   @deco.AfterDestroyCommit()
  *   public doSomething() {
  *     ...
  *   }

package/dist/esm/src/decorators/field/lifecycle/AfterSaveCommit.js

@@ -8,7 +8,7 @@ import { blankHooksFactory } from './shared.js';
  * is complete.
  *
  * class User extends ApplicationModel {
- *   @Deco.AfterSaveCommit()
+ *   @deco.AfterSaveCommit()
  *   public doSomething() {
  *     ...
  *   }

package/dist/esm/src/decorators/field/lifecycle/AfterUpdateCommit.js

@@ -8,7 +8,7 @@ import { blankHooksFactory } from './shared.js';
  * is complete.
  *
  * class User extends ApplicationModel {
- *   @Deco.AfterUpdateCommit()
+ *   @deco.AfterUpdateCommit()
  *   public doSomething() {
  *     ...
  *   }

package/dist/esm/src/decorators/field/validation/Validates.js

@@ -51,7 +51,7 @@ function extractValidationOptionsFromArgs(type, args) {
           When validating using "length", the second argument must be a number representing
           the min length, or else an object expressing both min and max length, like so:
 
-          @Deco.Validates('length', { min: 4, max: 32 })
+          @deco.Validates('length', { min: 4, max: 32 })
         `);
             }
         case 'requiredBelongsTo':

package/dist/esm/src/dream/DreamClassTransactionBuilder.js

@@ -513,10 +513,10 @@ export default class DreamClassTransactionBuilder {
      *
      * ```ts
      * class Post {
-     *   @Deco.HasMany('LocalizedText')
+     *   @deco.HasMany('LocalizedText')
      *   public localizedTexts: LocalizedText[]
      *
-     *   @Deco.HasOne('LocalizedText', {
+     *   @deco.HasOne('LocalizedText', {
      *     where: { locale: DreamConst.passthrough },
      *   })
      *   public currentLocalizedText: LocalizedText

package/dist/esm/src/dream/Query.js

@@ -761,10 +761,10 @@ export default class Query extends ConnectedToDB {
      *
      * ```ts
      * class Post {
-     *   @Deco.HasMany('LocalizedText')
+     *   @deco.HasMany('LocalizedText')
      *   public localizedTexts: LocalizedText[]
      *
-     *   @Deco.HasOne('LocalizedText', {
+     *   @deco.HasOne('LocalizedText', {
      *     on: { locale: DreamConst.passthrough },
      *   })
      *   public currentLocalizedText: LocalizedText

package/dist/esm/src/helpers/cli/generateDreamContent.js

@@ -35,7 +35,7 @@ export default function generateDreamContent({ fullyQualifiedModelName, columnsW
             case 'belongs_to':
                 modelImportStatements.push(associationImportStatement);
                 return `
-@Deco.BelongsTo('${fullyQualifiedAssociatedModelName}'${descriptors.includes('optional') ? ', { optional: true }' : ''})
+@deco.BelongsTo('${fullyQualifiedAssociatedModelName}'${descriptors.includes('optional') ? ', { optional: true }' : ''})
 public ${associationName}: ${associationModelName}${descriptors.includes('optional') ? ' | null' : ''}
 public ${associationName}Id: DreamColumn<${modelClassName}, '${associationName}Id'>
 `;
@@ -73,7 +73,7 @@ public ${camelize(attributeName)}: ${getAttributeType(attribute, modelClassName)
     return `\
 import { ${uniq(dreamImports).join(', ')} } from '@rvoh/dream'${uniq(modelImportStatements).join('')}
 
-const Deco = new Decorators<InstanceType<typeof ${modelClassName}>>()
+const deco = new Decorators<InstanceType<typeof ${modelClassName}>>()
 
 ${isSTI ? `\n@STI(${parentModelClassName})` : ''}
 export default class ${modelClassName} extends ${isSTI ? parentModelClassName : 'ApplicationModel'} {

package/dist/esm/src/helpers/db/runMigration.js

@@ -86,14 +86,14 @@ function migratedActionPastTense(mode) {
 function logResults(results, mode) {
     results?.forEach(it => {
         if (it.status === 'Success') {
-            DreamCLI.logger.log(colorize(`[db]`, { color: 'cyan' }) +
-                ` migration "${it.migrationName}" was ${migratedActionPastTense(mode)} successfully`, { permanent: true, logPrefix: '├', logPrefixColor: 'cyan' });
+            DreamCLI.logger.logContinueProgress(colorize(`[db]`, { color: 'cyan' }) +
+                ` migration "${it.migrationName}" was ${migratedActionPastTense(mode)} successfully`, { logPrefixColor: 'cyan' });
         }
         else if (it.status === 'Error') {
-            DreamCLI.logger.log(JSON.stringify(it, null, 2), { permanent: true });
-            DreamCLI.logger.log(colorize(`failed to ${migratedActionCurrentTense(mode)} migration "${it.migrationName}"`, {
+            DreamCLI.logger.logContinueProgress(JSON.stringify(it, null, 2));
+            DreamCLI.logger.logContinueProgress(colorize(`failed to ${migratedActionCurrentTense(mode)} migration "${it.migrationName}"`, {
                 color: 'redBright',
-            }), { permanent: true });
+            }));
         }
     });
 }

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

@@ -3,15 +3,41 @@ export default function sspawn(command, opts = {}) {
     return new Promise((accept, reject) => {
         ssspawn(command, opts).on('close', code => {
             if (code !== 0)
-                reject(new Error(code?.toString()));
+                reject(code);
             accept({});
         });
     });
 }
 export function ssspawn(command, opts = {}) {
-    return spawn(command, {
-        stdio: 'inherit',
+    const proc = spawn(command, {
+        // even though github security scans want to remove this,
+        // it is necessary to allow the cli util to run as the current
+        // user. This is only done to provision a new psychic application,
+        // so it is safe from unknown execution contexts.
         shell: true,
         ...opts,
     });
+    // NOTE: adding this stdout spy so that
+    // when this cli utility runs node commands,
+    // it can properly hijack the stdout from the command
+    proc.stdout.on('data', chunk => {
+        const txt = chunk?.toString()?.trim();
+        if (typeof txt !== 'string' || !txt)
+            return;
+        if (opts?.onStdout) {
+            opts?.onStdout?.(txt);
+        }
+        else {
+            console.log(txt);
+        }
+    });
+    proc.stdout.on('error', err => {
+        console.log('sspawn error!');
+        console.error(err);
+    });
+    proc.on('error', err => {
+        console.log('sspawn error!');
+        console.error(err);
+    });
+    return proc;
 }

package/dist/esm/src/serializer/decorators/associations/RendersMany.js

@@ -13,12 +13,12 @@ import { isSerializable } from './shared.js';
  *
  * ```ts
  * class User extends ApplicationModel {
- *   @Deco.HasOne('Settings')
+ *   @deco.HasOne('Settings')
  *   public settings: Settings
  * }
  *
  * class Post extends ApplicationModel {
- *   @Deco.BelongsTo('User')
+ *   @deco.BelongsTo('User')
  *   public user: User
  * }
  *