@rvoh/dream 2.5.1 → 2.5.3

package/dist/cjs/src/Dream.js

@@ -47,7 +47,6 @@ import MissingSerializersDefinition from './errors/serializers/MissingSerializer
 import areEqual from './helpers/areEqual.js';
 import cloneDeepSafe from './helpers/cloneDeepSafe.js';
 import compact from './helpers/compact.js';
-import cachedTypeForAttribute from './helpers/db/cachedTypeForAttribute.js';
 import isJsonColumn from './helpers/db/types/isJsonColumn.js';
 import notEqual from './helpers/notEqual.js';
 import { inferSerializersFromDreamClassOrViewModelClass } from './serializer/helpers/inferSerializerFromDreamOrViewModel.js';
@@ -2701,14 +2700,6 @@ export default class Dream {
     getAttributes() {
         return { ...this.currentAttributes };
     }
-    /**
-     * @internal
-     *
-     * Returns the db type stored within the database
-     */
-    static cachedTypeFor(attribute) {
-        return cachedTypeForAttribute(this, attribute);
-    }
     /**
      * Returns the attributes that have changed since
      * being persisted to the database, with the values

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

@@ -7,6 +7,7 @@ import EnvInternal from '../helpers/EnvInternal.js';
 import loadRepl from '../helpers/loadRepl.js';
 import sspawn from '../helpers/sspawn.js';
 import DreamCliLogger from './logger/DreamCliLogger.js';
+import colorize from './logger/loggable/colorize.js';
 export const CLI_INDENT = '                  ';
 const INDENT = CLI_INDENT;
 export const baseColumnsWithTypesDescription = `space separated snake-case (except for belongs_to model name) properties like this:
@@ -90,8 +91,8 @@ export default class DreamCLI {
         program
             .command('sync')
             .description('Generates types from the current state of the database.')
-            .option('--schema-only')
-            .action(async (options = {}) => {
+            .option('--schema-only', 'sync database schema types only', false)
+            .action(async (options) => {
             await initializeDreamApp({ bypassDreamIntegrityChecks: true });
             await DreamBin.sync(() => { }, options);
             process.exit();
@@ -135,11 +136,11 @@ export default class DreamCLI {
             .description('Generates a Dream model with corresponding spec factory, serializer, and migration.')
             .option('--no-serializer')
             .option('--connection-name <connectionName>', 'the db connection you want this attached to (defaults to the default db connection)', 'default')
-            .option('--sti-base-serializer')
+            .option('--sti-base-serializer', 'creates a generically typed base serializer that includes the child type in the output so consuming applications can determine shape based on type', false)
             .option('--table-name <tableName>', 'explicit table name to use instead of the auto-generated one (useful when model namespaces produce long names)')
             .option('--model-name <modelName>', 'explicit model class name to use instead of the auto-generated one (e.g. --model-name=Kitchen for Room/Kitchen)')
-            .option('--admin-serializers', 'generate admin serializer variants (AdminSerializer and AdminSummarySerializer) in addition to the default serializers')
-            .option('--internal-serializers', 'generate internal serializer variants (InternalSerializer and InternalSummarySerializer) in addition to the default serializers')
+            .option('--admin-serializers', 'generate admin serializer variants (AdminSerializer and AdminSummarySerializer) in addition to the default serializers', false)
+            .option('--internal-serializers', 'generate internal serializer variants (InternalSerializer and InternalSummarySerializer) in addition to the default serializers', false)
             .argument('<modelName>', 'the name of the model to create, e.g. Post or Settings/CommunicationPreferences')
             .argument('[columnsWithTypes...]', columnsWithTypesDescription)
             .action(async (modelName, columnsWithTypes, options) => {
@@ -154,8 +155,8 @@ export default class DreamCLI {
             .option('--no-serializer')
             .option('--connection-name', 'the db connection you want this model attached to (defaults to the default connection)', 'default')
             .option('--model-name <modelName>', 'explicit model class name to use instead of the auto-generated one (e.g. --model-name=Kitchen for Room/Kitchen)')
-            .option('--admin-serializers', 'generate admin serializer variants (AdminSerializer and AdminSummarySerializer) in addition to the default serializers')
-            .option('--internal-serializers', 'generate internal serializer variants (InternalSerializer and InternalSummarySerializer) in addition to the default serializers')
+            .option('--admin-serializers', 'generate admin serializer variants (AdminSerializer and AdminSummarySerializer) in addition to the default serializers', false)
+            .option('--internal-serializers', 'generate internal serializer variants (InternalSerializer and InternalSummarySerializer) in addition to the default serializers', false)
             .argument('<childModelName>', 'the name of the model to create, e.g. Post or Settings/CommunicationPreferences')
             .argument('<extends>', 'just the word "extends"')
             .argument('<parentModelName>', `fully qualified name of the parent model, e.g.:
@@ -200,7 +201,7 @@ ${INDENT}    to extend the Coach model in src/app/models/Health/Coach: Health/Co
         program
             .command('db:migrate')
             .description('Runs any outstanding database migrations.')
-            .option('--skip-sync', 'skips syncing local schema after running migrations')
+            .option('--skip-sync', 'skips syncing local schema after running migrations', false)
             .action(async ({ skipSync }) => {
             await initializeDreamApp({ bypassDreamIntegrityChecks: true });
             await DreamBin.dbMigrate();
@@ -213,7 +214,7 @@ ${INDENT}    to extend the Coach model in src/app/models/Health/Coach: Health/Co
             .command('db:rollback')
             .description('Rolls back the specified number of migration steps (defaults to 1)')
             .option('--steps <number>', 'number of steps back to travel', myParseInt, 1)
-            .option('--skip-sync', 'skips syncing local schema after running migrations')
+            .option('--skip-sync', 'skips syncing local schema after running migrations', false)
             .action(async ({ steps, skipSync }) => {
             await initializeDreamApp({ bypassDreamIntegrityChecks: true });
             await DreamBin.dbRollback({ steps });
@@ -235,12 +236,39 @@ ${INDENT}    to extend the Coach model in src/app/models/Health/Coach: Health/Co
             .description('Runs db:drop (safely), db:create, db:migrate, and db:seed')
             .action(async () => {
             await initializeDreamApp({ bypassDreamIntegrityChecks: true, bypassDbConnectionsDuringInit: true });
+            const arrows = colorize('⭣⭣⭣', { color: 'green' }) + '\n';
+            DreamCLI.logger.log(colorize('db:drop', { color: 'green' }), {
+                logPrefix: ' ',
+                logPrefixColor: 'green',
+            });
             await DreamBin.dbDrop();
+            DreamCLI.logger.log(arrows, { logPrefix: ' ' });
+            DreamCLI.logger.log(colorize('db:create', { color: 'green' }), {
+                logPrefix: ' ',
+                logPrefixColor: 'green',
+            });
             await DreamBin.dbCreate();
+            DreamCLI.logger.log(arrows, { logPrefix: ' ' });
             await initializeDreamApp({ bypassDreamIntegrityChecks: true });
+            DreamCLI.logger.log(colorize('db:migrate', { color: 'green' }), {
+                logPrefix: ' ',
+                logPrefixColor: 'green',
+            });
             await DreamBin.dbMigrate();
+            DreamCLI.logger.log(arrows, { logPrefix: ' ' });
+            DreamCLI.logger.log(colorize('sync', { color: 'green' }), {
+                logPrefix: ' ',
+                logPrefixColor: 'green',
+            });
             await DreamBin.sync(onSync);
-            await seedDb();
+            DreamCLI.logger.log(arrows, { logPrefix: ' ' });
+            DreamCLI.logger.log(colorize('db:seed', { color: 'green' }), {
+                logPrefix: ' ',
+                logPrefixColor: 'green',
+            });
+            await DreamCLI.logger.logProgress('seeding db...', async () => {
+                await seedDb();
+            });
             process.exit();
         });
         program

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

@@ -1,25 +1,126 @@
+import c from 'yoctocolors';
 import DreamCliLoggableText from './loggable/DreamCliLoggableText.js';
+const SPINNER_FRAMES = ['✺', '✹', '✸', '✷', '✶', '✵', '✴', '✵', '✶', '✷', '✸', '✹'];
+const EYE_FRAMES = ['─', '◡', '◯', '◉', '●', '◉', '◯', '◡'];
+const SPINNER_INTERVAL_MS = 200;
+function formatElapsed(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
 export default class DreamCliLogger {
+    spinner = null;
     log(text, { logPrefix, logPrefixColor, logPrefixBgColor } = {}) {
         const loggable = new DreamCliLoggableText(text, {
             logPrefix,
-            logPrefixColor: logPrefixColor || 'green',
+            logPrefixColor: logPrefixColor || 'greenBright',
             logPrefixBgColor,
         });
         loggable.render();
     }
     async logProgress(text, cb, { logPrefix = '✺ ┌', logPrefixColor, logPrefixBgColor } = {}) {
-        this.log(text, { logPrefix, logPrefixColor, logPrefixBgColor });
+        this.logStartProgress(text, { logPrefix, logPrefixColor, logPrefixBgColor });
         await cb();
         this.logEndProgress();
     }
-    logStartProgress(text, { logPrefix = '✺ ┌', logPrefixColor, logPrefixBgColor } = {}) {
-        this.log(text, { logPrefix, logPrefixColor, logPrefixBgColor });
+    logStartProgress(text, { logPrefixColor, logPrefixBgColor } = {}) {
+        if (!process.stdout.isTTY) {
+            this.log(text, { logPrefix: '✺ ┌', logPrefixColor: logPrefixColor || 'greenBright', logPrefixBgColor });
+            return;
+        }
+        this.startTopSpinner(text);
+    }
+    startTopSpinner(text) {
+        const renderFrame = (frameIndex) => {
+            const star = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length];
+            process.stdout.write(`${this.escapeSequence('clearLine')}${c.yellow(`${star} ┌`)} ${c.yellow(text)}`);
+        };
+        renderFrame(0);
+        const interval = setInterval(() => {
+            if (this.spinner && !this.spinner.committed) {
+                this.spinner.frameIndex++;
+                renderFrame(this.spinner.frameIndex);
+            }
+        }, SPINNER_INTERVAL_MS);
+        this.spinner = {
+            actionText: text,
+            startTime: Date.now(),
+            frameIndex: 0,
+            interval,
+            committed: false,
+        };
+    }
+    startBottomSpinner() {
+        if (!process.stdout.isTTY || !this.spinner)
+            return;
+        const renderFrame = (frameIndex) => {
+            const eye = EYE_FRAMES[frameIndex % EYE_FRAMES.length];
+            process.stdout.write(`${this.escapeSequence('clearLine')}${c.yellow(eye)} ${c.yellow(`└ ${this.spinner.actionText}`)}`);
+        };
+        this.spinner.frameIndex = 0;
+        renderFrame(0);
+        this.spinner.interval = setInterval(() => {
+            if (this.spinner) {
+                this.spinner.frameIndex++;
+                renderFrame(this.spinner.frameIndex);
+            }
+        }, SPINNER_INTERVAL_MS);
     }
     logContinueProgress(text, { logPrefix = '  ├', logPrefixColor, logPrefixBgColor } = {}) {
-        this.log(text, { logPrefix, logPrefixColor, logPrefixBgColor });
+        if (this.spinner && !this.spinner.committed) {
+            clearInterval(this.spinner.interval);
+            // Overwrite the yellow animated header with green past-tense text before marking
+            // the spinner as committed
+            process.stdout.write(`${this.escapeSequence('clearLine')}${c.greenBright('✺ ┌')} ${c.greenBright(this.spinner.actionText)}\n`);
+            this.spinner.committed = true;
+            this.log(text, { logPrefix, logPrefixColor, logPrefixBgColor });
+            this.startBottomSpinner();
+        }
+        else if (this.spinner?.committed) {
+            // Clear the bottom running... spinner, log sub-line, then re-show it
+            clearInterval(this.spinner.interval);
+            this.clearLine();
+            this.log(text, { logPrefix, logPrefixColor, logPrefixBgColor });
+            this.startBottomSpinner();
+        }
+        else {
+            this.log(text, { logPrefix, logPrefixColor, logPrefixBgColor });
+        }
     }
     logEndProgress(text = 'complete', { logPrefix = '  └', logPrefixColor, logPrefixBgColor } = {}) {
-        this.log(text, { logPrefix, logPrefixColor, logPrefixBgColor });
+        if (!this.spinner) {
+            this.log(text, { logPrefix, logPrefixColor, logPrefixBgColor });
+            return;
+        }
+        const spinner = this.spinner;
+        this.spinner = null;
+        clearInterval(spinner.interval);
+        const elapsed = Date.now() - spinner.startTime;
+        const elapsedStr = formatElapsed(elapsed);
+        if (!spinner.committed) {
+            // No sub-lines: overwrite the spinner in-place with the green completed header
+            process.stdout.write(`${this.escapeSequence('clearLine')}${c.greenBright('✺ ┌')} ${c.greenBright(spinner.actionText)}\n`);
+        }
+        else {
+            // Has sub-lines: clear the bottom running... spinner line
+            if (process.stdout.isTTY)
+                this.clearLine();
+        }
+        this.log(c.greenBright(`done in ${elapsedStr}\n`), {
+            logPrefix,
+            logPrefixColor: logPrefixColor || 'greenBright',
+            logPrefixBgColor,
+        });
+    }
+    clearLine() {
+        process.stdout.write(this.escapeSequence('clearLine'));
+    }
+    escapeSequence(sequence) {
+        switch (sequence) {
+            case 'clearLine':
+                return `\r\x1b[2K`;
+            default:
+                throw new Error(`unexpected sequence: ${sequence}`);
+        }
     }
 }

package/dist/cjs/src/db/helpers/syncDbTypesFiles.js

@@ -28,8 +28,8 @@ export default async function syncDbTypesFiles(connectionName) {
     const kyselyCodegenCmd = `kysely-codegen ${dialect} ${url} ${includePattern} ${excludePattern} ${outfile}`;
     await sspawn(kyselyCodegenCmd, {
         onStdout: message => {
-            DreamCLI.logger.logContinueProgress(colorize(`[db]`, { color: 'cyan' }) + ' ' + message, {
-                logPrefixColor: 'cyan',
+            DreamCLI.logger.logContinueProgress(colorize(`[db]`, { color: 'greenBright' }) + ' ' + message, {
+                logPrefixColor: 'greenBright',
             });
         },
     });

package/dist/cjs/src/decorators/field/Encrypted.js

@@ -1,5 +1,6 @@
 import InternalEncrypt from '../../encrypt/InternalEncrypt.js';
 import DoNotSetEncryptedFieldsDirectly from '../../errors/DoNotSetEncryptedFieldsDirectly.js';
+import columnAllowsNull from '../../helpers/db/columnAllowsNull.js';
 import pascalize from '../../helpers/pascalize.js';
 export default function Encrypted(encryptedColumnName) {
     return function (_, context) {
@@ -29,7 +30,7 @@ export default function Encrypted(encryptedColumnName) {
             ;
             dreamClass['virtualAttributes'].push({
                 property: key,
-                type: 'string',
+                type: columnAllowsNull(dreamClass, encryptedKey) ? ['string', 'null'] : 'string',
             });
             if (!Object.getOwnPropertyDescriptor(dreamClass, 'explicitUnsafeParamColumns')) {
                 // This pattern allows `explicitUnsafeParamColumns` on a base STI class and on

package/dist/cjs/src/dream/QueryDriver/Postgres.js

@@ -157,13 +157,13 @@ export default class PostgresQueryDriver extends KyselyQueryDriver {
         const client = await loadPgClient({ useSystemDb: true, connectionName });
         if (EnvInternal.boolean('DREAM_CORE_DEVELOPMENT')) {
             const replicaTestWorkerDatabaseName = `replica_test_${dbConf.name}`;
-            DreamCLI.logger.logContinueProgress(`creating fake replica test database ${replicaTestWorkerDatabaseName}...`, { logPrefix: '  ├ [db]', logPrefixColor: 'cyan' });
+            DreamCLI.logger.logContinueProgress(`creating fake replica test database ${replicaTestWorkerDatabaseName}...`, { logPrefix: '  ├ [db]', logPrefixColor: 'greenBright' });
             await client.query(`DROP DATABASE IF EXISTS ${replicaTestWorkerDatabaseName};`);
             await client.query(`CREATE DATABASE ${replicaTestWorkerDatabaseName} TEMPLATE ${dbConf.name};`);
         }
         for (let i = 2; i <= parallelTests; i++) {
             const workerDatabaseName = `${dbConf.name}_${i}`;
-            DreamCLI.logger.logContinueProgress(`creating duplicate test database ${workerDatabaseName} for concurrent tests...`, { logPrefix: '  ├ [db]', logPrefixColor: 'cyan' });
+            DreamCLI.logger.logContinueProgress(`creating duplicate test database ${workerDatabaseName} for concurrent tests...`, { logPrefix: '  ├ [db]', logPrefixColor: 'greenBright' });
             await client.query(`DROP DATABASE IF EXISTS ${workerDatabaseName};`);
             await client.query(`CREATE DATABASE ${workerDatabaseName} TEMPLATE ${dbConf.name};`);
         }

package/dist/cjs/src/dream/QueryDriver/helpers/kysely/runMigration.js

@@ -88,8 +88,8 @@ function migratedActionPastTense(mode) {
 function logResults(results, mode) {
     results?.forEach(it => {
         if (it.status === 'Success') {
-            DreamCLI.logger.logContinueProgress(colorize(`[db]`, { color: 'cyan' }) +
-                ` migration "${it.migrationName}" was ${migratedActionPastTense(mode)} successfully`, { logPrefixColor: 'cyan' });
+            DreamCLI.logger.logContinueProgress(colorize(`[db]`, { color: 'greenBright' }) +
+                ` migration "${it.migrationName}" was ${migratedActionPastTense(mode)} successfully`, { logPrefixColor: 'greenBright' });
         }
         else if (it.status === 'Error') {
             DreamCLI.logger.logContinueProgress(JSON.stringify(it, null, 2));

package/dist/cjs/src/dream/QueryDriver/helpers/pg/dropDb.js

@@ -22,14 +22,14 @@ async function maybeDropDuplicateDatabases(client, dbName) {
         return;
     if (EnvInternal.boolean('DREAM_CORE_DEVELOPMENT')) {
         const replicaTestWorkerDatabaseName = `replica_test_${dbName}`;
-        DreamCLI.logger.logContinueProgress(`dropping fake replica test database ${replicaTestWorkerDatabaseName}`, { logPrefix: '  ├ [db]', logPrefixColor: 'cyan' });
+        DreamCLI.logger.logContinueProgress(`dropping fake replica test database ${replicaTestWorkerDatabaseName}`, { logPrefix: '  ├ [db]', logPrefixColor: 'greenBright' });
         await client.query(`DROP DATABASE IF EXISTS ${replicaTestWorkerDatabaseName};`);
     }
     for (let i = 2; i <= parallelTests; i++) {
         const workerDatabaseName = `${dbName}_${i}`;
         DreamCLI.logger.logContinueProgress(`dropping duplicate test database ${workerDatabaseName}`, {
             logPrefix: '  ├ [db]',
-            logPrefixColor: 'cyan',
+            logPrefixColor: 'greenBright',
         });
         await client.query(`DROP DATABASE IF EXISTS ${workerDatabaseName};`);
     }

package/dist/cjs/src/helpers/db/columnAllowsNull.js

@@ -0,0 +1,3 @@
+export default function columnAllowsNull(dreamClass, attribute) {
+    return dreamClass.prototype.schema[dreamClass.table]?.['columns']?.[attribute]?.['allowNull'] ?? false;
+}

package/dist/cjs/src/helpers/db/normalizeDataForDb.js

@@ -1,3 +1,4 @@
+import cachedTypeForAttribute from './cachedTypeForAttribute.js';
 import DataTypeColumnTypeMismatch from '../../errors/db/DataTypeColumnTypeMismatch.js';
 import BaseClockTime from '../../utils/datetime/BaseClockTime.js';
 import CalendarDate from '../../utils/datetime/CalendarDate.js';
@@ -7,7 +8,7 @@ import { DateTime } from '../../utils/datetime/DateTime.js';
 import normalizeUnicode from '../normalizeUnicode.js';
 import { DATE_OR_DATE_ARRAY_COLUMN_CHECK_REGEXP, DATETIME_OR_DATETIME_ARRAY_COLUMN_CHECK_REGEXP, STRING_OR_STRING_ARRAY_COLUMN_CHECK_REGEXP, TIME_WITH_TIMEZONE_COLUMN_CHECK_REGEXP, TIME_WITHOUT_TIMEZONE_COLUMN_CHECK_REGEXP, } from './types/helpers.js';
 export function normalizeDataForDb({ val, dreamClass, column, }) {
-    const columnType = dreamClass['cachedTypeFor'](column);
+    const columnType = cachedTypeForAttribute(dreamClass, column);
     if (val instanceof DateTime || DATETIME_OR_DATETIME_ARRAY_COLUMN_CHECK_REGEXP.test(columnType)) {
         return dateTimeOrDateToSql(DateTime, val);
         //

package/dist/cjs/src/helpers/db/types/isDatabaseArrayColumn.js

@@ -1,3 +1,4 @@
+import cachedTypeForAttribute from '../cachedTypeForAttribute.js';
 export default function isDatabaseArrayColumn(dreamClass, column) {
-    return /\[\]$/.test(dreamClass['cachedTypeFor'](column));
+    return /\[\]$/.test(cachedTypeForAttribute(dreamClass, column));
 }

package/dist/cjs/src/helpers/db/types/isDatetimeOrDatetimeArrayColumn.js

@@ -1,4 +1,5 @@
+import cachedTypeForAttribute from '../cachedTypeForAttribute.js';
 import { DATETIME_OR_DATETIME_ARRAY_COLUMN_CHECK_REGEXP } from './helpers.js';
 export default function isDatetimeOrDatetimeArrayColumn(dreamClass, column) {
-    return DATETIME_OR_DATETIME_ARRAY_COLUMN_CHECK_REGEXP.test(dreamClass['cachedTypeFor'](column));
+    return DATETIME_OR_DATETIME_ARRAY_COLUMN_CHECK_REGEXP.test(cachedTypeForAttribute(dreamClass, column));
 }

package/dist/cjs/src/helpers/db/types/isJsonColumn.js

@@ -1,3 +1,4 @@
+import cachedTypeForAttribute from '../cachedTypeForAttribute.js';
 export default function isJsonColumn(dreamClass, column) {
-    return ['json', 'jsonb'].includes(dreamClass['cachedTypeFor'](column));
+    return ['json', 'jsonb'].includes(cachedTypeForAttribute(dreamClass, column));
 }

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

@@ -1,5 +1,6 @@
 import { sql } from 'kysely';
 import AnyRequiresArrayColumn from '../errors/ops/AnyRequiresArrayColumn.js';
+import cachedTypeForAttribute from '../helpers/db/cachedTypeForAttribute.js';
 import isDatabaseArrayColumn from '../helpers/db/types/isDatabaseArrayColumn.js';
 import CurriedOpsStatement from './curried-ops-statement.js';
 import OpsStatement from './ops-statement.js';
@@ -10,7 +11,7 @@ const ops = {
         const column = fieldName.replace(/^.*\./, '');
         if (!isDatabaseArrayColumn(dreamClass, column))
             throw new AnyRequiresArrayColumn(dreamClass, column);
-        const castType = dreamClass['cachedTypeFor'](column);
+        const castType = cachedTypeForAttribute(dreamClass, column);
         return new OpsStatement('@>', sql `ARRAY[${sql.join([value])}]::${sql.raw(castType)}`);
     }),
     like: (like) => new OpsStatement('like', like),

package/dist/esm/src/Dream.js

@@ -47,7 +47,6 @@ import MissingSerializersDefinition from './errors/serializers/MissingSerializer
 import areEqual from './helpers/areEqual.js';
 import cloneDeepSafe from './helpers/cloneDeepSafe.js';
 import compact from './helpers/compact.js';
-import cachedTypeForAttribute from './helpers/db/cachedTypeForAttribute.js';
 import isJsonColumn from './helpers/db/types/isJsonColumn.js';
 import notEqual from './helpers/notEqual.js';
 import { inferSerializersFromDreamClassOrViewModelClass } from './serializer/helpers/inferSerializerFromDreamOrViewModel.js';
@@ -2701,14 +2700,6 @@ export default class Dream {
     getAttributes() {
         return { ...this.currentAttributes };
     }
-    /**
-     * @internal
-     *
-     * Returns the db type stored within the database
-     */
-    static cachedTypeFor(attribute) {
-        return cachedTypeForAttribute(this, attribute);
-    }
     /**
      * Returns the attributes that have changed since
      * being persisted to the database, with the values

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

@@ -7,6 +7,7 @@ import EnvInternal from '../helpers/EnvInternal.js';
 import loadRepl from '../helpers/loadRepl.js';
 import sspawn from '../helpers/sspawn.js';
 import DreamCliLogger from './logger/DreamCliLogger.js';
+import colorize from './logger/loggable/colorize.js';
 export const CLI_INDENT = '                  ';
 const INDENT = CLI_INDENT;
 export const baseColumnsWithTypesDescription = `space separated snake-case (except for belongs_to model name) properties like this:
@@ -90,8 +91,8 @@ export default class DreamCLI {
         program
             .command('sync')
             .description('Generates types from the current state of the database.')
-            .option('--schema-only')
-            .action(async (options = {}) => {
+            .option('--schema-only', 'sync database schema types only', false)
+            .action(async (options) => {
             await initializeDreamApp({ bypassDreamIntegrityChecks: true });
             await DreamBin.sync(() => { }, options);
             process.exit();
@@ -135,11 +136,11 @@ export default class DreamCLI {
             .description('Generates a Dream model with corresponding spec factory, serializer, and migration.')
             .option('--no-serializer')
             .option('--connection-name <connectionName>', 'the db connection you want this attached to (defaults to the default db connection)', 'default')
-            .option('--sti-base-serializer')
+            .option('--sti-base-serializer', 'creates a generically typed base serializer that includes the child type in the output so consuming applications can determine shape based on type', false)
             .option('--table-name <tableName>', 'explicit table name to use instead of the auto-generated one (useful when model namespaces produce long names)')
             .option('--model-name <modelName>', 'explicit model class name to use instead of the auto-generated one (e.g. --model-name=Kitchen for Room/Kitchen)')
-            .option('--admin-serializers', 'generate admin serializer variants (AdminSerializer and AdminSummarySerializer) in addition to the default serializers')
-            .option('--internal-serializers', 'generate internal serializer variants (InternalSerializer and InternalSummarySerializer) in addition to the default serializers')
+            .option('--admin-serializers', 'generate admin serializer variants (AdminSerializer and AdminSummarySerializer) in addition to the default serializers', false)
+            .option('--internal-serializers', 'generate internal serializer variants (InternalSerializer and InternalSummarySerializer) in addition to the default serializers', false)
             .argument('<modelName>', 'the name of the model to create, e.g. Post or Settings/CommunicationPreferences')
             .argument('[columnsWithTypes...]', columnsWithTypesDescription)
             .action(async (modelName, columnsWithTypes, options) => {
@@ -154,8 +155,8 @@ export default class DreamCLI {
             .option('--no-serializer')
             .option('--connection-name', 'the db connection you want this model attached to (defaults to the default connection)', 'default')
             .option('--model-name <modelName>', 'explicit model class name to use instead of the auto-generated one (e.g. --model-name=Kitchen for Room/Kitchen)')
-            .option('--admin-serializers', 'generate admin serializer variants (AdminSerializer and AdminSummarySerializer) in addition to the default serializers')
-            .option('--internal-serializers', 'generate internal serializer variants (InternalSerializer and InternalSummarySerializer) in addition to the default serializers')
+            .option('--admin-serializers', 'generate admin serializer variants (AdminSerializer and AdminSummarySerializer) in addition to the default serializers', false)
+            .option('--internal-serializers', 'generate internal serializer variants (InternalSerializer and InternalSummarySerializer) in addition to the default serializers', false)
             .argument('<childModelName>', 'the name of the model to create, e.g. Post or Settings/CommunicationPreferences')
             .argument('<extends>', 'just the word "extends"')
             .argument('<parentModelName>', `fully qualified name of the parent model, e.g.:
@@ -200,7 +201,7 @@ ${INDENT}    to extend the Coach model in src/app/models/Health/Coach: Health/Co
         program
             .command('db:migrate')
             .description('Runs any outstanding database migrations.')
-            .option('--skip-sync', 'skips syncing local schema after running migrations')
+            .option('--skip-sync', 'skips syncing local schema after running migrations', false)
             .action(async ({ skipSync }) => {
             await initializeDreamApp({ bypassDreamIntegrityChecks: true });
             await DreamBin.dbMigrate();
@@ -213,7 +214,7 @@ ${INDENT}    to extend the Coach model in src/app/models/Health/Coach: Health/Co
             .command('db:rollback')
             .description('Rolls back the specified number of migration steps (defaults to 1)')
             .option('--steps <number>', 'number of steps back to travel', myParseInt, 1)
-            .option('--skip-sync', 'skips syncing local schema after running migrations')
+            .option('--skip-sync', 'skips syncing local schema after running migrations', false)
             .action(async ({ steps, skipSync }) => {
             await initializeDreamApp({ bypassDreamIntegrityChecks: true });
             await DreamBin.dbRollback({ steps });
@@ -235,12 +236,39 @@ ${INDENT}    to extend the Coach model in src/app/models/Health/Coach: Health/Co
             .description('Runs db:drop (safely), db:create, db:migrate, and db:seed')
             .action(async () => {
             await initializeDreamApp({ bypassDreamIntegrityChecks: true, bypassDbConnectionsDuringInit: true });
+            const arrows = colorize('⭣⭣⭣', { color: 'green' }) + '\n';
+            DreamCLI.logger.log(colorize('db:drop', { color: 'green' }), {
+                logPrefix: ' ',
+                logPrefixColor: 'green',
+            });
             await DreamBin.dbDrop();
+            DreamCLI.logger.log(arrows, { logPrefix: ' ' });
+            DreamCLI.logger.log(colorize('db:create', { color: 'green' }), {
+                logPrefix: ' ',
+                logPrefixColor: 'green',
+            });
             await DreamBin.dbCreate();
+            DreamCLI.logger.log(arrows, { logPrefix: ' ' });
             await initializeDreamApp({ bypassDreamIntegrityChecks: true });
+            DreamCLI.logger.log(colorize('db:migrate', { color: 'green' }), {
+                logPrefix: ' ',
+                logPrefixColor: 'green',
+            });
             await DreamBin.dbMigrate();
+            DreamCLI.logger.log(arrows, { logPrefix: ' ' });
+            DreamCLI.logger.log(colorize('sync', { color: 'green' }), {
+                logPrefix: ' ',
+                logPrefixColor: 'green',
+            });
             await DreamBin.sync(onSync);
-            await seedDb();
+            DreamCLI.logger.log(arrows, { logPrefix: ' ' });
+            DreamCLI.logger.log(colorize('db:seed', { color: 'green' }), {
+                logPrefix: ' ',
+                logPrefixColor: 'green',
+            });
+            await DreamCLI.logger.logProgress('seeding db...', async () => {
+                await seedDb();
+            });
             process.exit();
         });
         program