@rvoh/dream 0.42.3 → 0.43.0-beta.2

package/dist/cjs/src/Dream.js

@@ -41,14 +41,12 @@ const CreateOrFindByFailedToCreateAndFind_js_1 = require("./errors/CreateOrFindB
 const CreateOrUpdateByFailedToCreateAndUpdate_js_1 = require("./errors/CreateOrUpdateByFailedToCreateAndUpdate.js");
 const GlobalNameNotSet_js_1 = require("./errors/dream-app/GlobalNameNotSet.js");
 const DreamMissingRequiredOverride_js_1 = require("./errors/DreamMissingRequiredOverride.js");
-const MissingSerializersDefinition_js_1 = require("./errors/MissingSerializersDefinition.js");
 const NonExistentScopeProvidedToResort_js_1 = require("./errors/NonExistentScopeProvidedToResort.js");
 const CalendarDate_js_1 = require("./helpers/CalendarDate.js");
 const cloneDeepSafe_js_1 = require("./helpers/cloneDeepSafe.js");
 const DateTime_js_1 = require("./helpers/DateTime.js");
 const cachedTypeForAttribute_js_1 = require("./helpers/db/cachedTypeForAttribute.js");
 const isJsonColumn_js_1 = require("./helpers/db/types/isJsonColumn.js");
-const inferSerializerFromDreamOrViewModel_js_1 = require("./helpers/inferSerializerFromDreamOrViewModel.js");
 const notEqual_js_1 = require("./helpers/notEqual.js");
 const typechecks_js_1 = require("./helpers/typechecks.js");
 class Dream {
@@ -489,6 +487,17 @@ class Dream {
             ...new Set([...columns, ...this.virtualAttributes.map(attr => attr.property)]),
         ];
     }
+    /**
+     * @internal
+     *
+     * Returns true if the column is a column in the database
+     *
+     * @param columnName - the name of the property you are checking for
+     * @returns boolean
+     */
+    static isColumn(columnName) {
+        return this.prototype.isColumn(columnName);
+    }
     /**
      * @internal
      *
@@ -720,7 +729,7 @@ class Dream {
         try {
             const dreamModel = this.new({
                 ...attributes,
-                ...(extraOpts?.createWith || {}),
+                ...extraOpts?.createWith,
             });
             await dreamModel.save();
             return dreamModel;
@@ -774,7 +783,7 @@ class Dream {
         try {
             return await this.create({
                 ...attributes,
-                ...(extraOpts?.with || {}),
+                ...extraOpts?.with,
             }, skipHooks ? { skipHooks } : undefined);
         }
         catch (err) {
@@ -2142,6 +2151,17 @@ class Dream {
          */
         this.unshadowColumnPropertyPrototypeAccessors();
     }
+    /**
+     * @internal
+     *
+     * Returns true if the column is a column in the database
+     *
+     * @param columnName - the name of the property you are checking for
+     * @returns boolean
+     */
+    isColumn(columnName) {
+        return this.columns().has(columnName);
+    }
     /**
      * Returns true if the columnName passed is marked by a
      * Virtual attribute decorator
@@ -2150,9 +2170,7 @@ class Dream {
      * @returns A boolean
      */
     isVirtualColumn(columnName) {
-        return this.constructor.virtualAttributes
-            .map(attr => attr.property)
-            .includes(columnName);
+        return !!this.constructor.virtualAttributes.find(attr => attr.property === columnName);
     }
     /**
      * Returns an object with column names for keys, and an
@@ -2926,31 +2944,6 @@ class Dream {
     async reload() {
         await (0, reload_js_1.default)(this);
     }
-    /**
-     * Serializes an instance. You can specify a serializer key,
-     * or else the default will be used
-     *
-     * ```ts
-     * // uses the default serializer provided in the model's `serializers` getter
-     * await user.serialize()
-     *
-     * // uses the summary serializer provided in the model's `serializers` getter
-     * await user.serialize({ serializerKey: 'summary' })
-     * ```
-     *
-     * @param args.casing - Which casing to use when serializing (camel or snake, default camel)
-     * @param args.serializerKey - The key to use when referencing the object returned by the `serializers` getter on the given model instance (defaults to "default")
-     * @returns A serialized representation of the model
-     */
-    serialize({ casing = null, serializerKey } = {}) {
-        const serializerClass = (0, inferSerializerFromDreamOrViewModel_js_1.default)(this, serializerKey?.toString());
-        if (!serializerClass)
-            throw new MissingSerializersDefinition_js_1.default(this.constructor);
-        const serializer = new serializerClass(this);
-        if (casing)
-            serializer.casing(casing);
-        return serializer.render();
-    }
     /**
      * Takes the attributes passed in and sets their values,
      * leveraging any custom setters defined for these attributes.

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

@@ -81,7 +81,12 @@ class DreamBin {
         await (0, generateDream_js_1.default)({ fullyQualifiedModelName, columnsWithTypes, options });
     }
     static async generateStiChild(fullyQualifiedModelName, fullyQualifiedParentName, columnsWithTypes, options) {
-        await (0, generateDream_js_1.default)({ fullyQualifiedModelName, columnsWithTypes, options, fullyQualifiedParentName });
+        await (0, generateDream_js_1.default)({
+            fullyQualifiedModelName,
+            columnsWithTypes,
+            options: { ...options, stiBaseSerializer: false },
+            fullyQualifiedParentName,
+        });
     }
     static async generateMigration(migrationName, columnsWithTypes) {
         await (0, generateMigration_js_1.default)({ migrationName, columnsWithTypes });

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

@@ -46,6 +46,7 @@ class DreamCLI {
             .alias('generate:dream')
             .alias('g:dream')
             .option('--no-serializer')
+            .option('--sti-base-serializer', 'Omits the serializer from the dream model, but does create the serializer so it can be extended by STI children')
             .description('create a new Dream model')
             .argument('<modelName>', 'the name of the model to create, e.g. Post or Settings/CommunicationPreferences')
             .argument('[columnsWithTypes...]', 'properties of the model property1:text/string/enum/etc. property2:text/string/enum/etc. ... propertyN:text/string/enum/etc.')

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

@@ -61,8 +61,11 @@ function extractValidationOptionsFromArgs(type, args) {
             }
         case 'requiredBelongsTo':
             return {};
-        default:
-            throw new Error(`Unhandled validation type when caching options: ${type}`);
+        default: {
+            // protection so that if a new ValidationType is ever added, this will throw a type error at build time
+            const _never = type;
+            throw new Error(`Unhandled ValidationType: ${_never}`);
+        }
     }
 }
 class ValidationInstantiationError extends Error {

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

@@ -5,6 +5,7 @@ const pluralize_esm_1 = require("pluralize-esm");
 const ConnectedToDB_js_1 = require("../db/ConnectedToDB.js");
 const SoftDelete_js_1 = require("../decorators/class/SoftDelete.js");
 const associationToGetterSetterProp_js_1 = require("../decorators/field/association/associationToGetterSetterProp.js");
+const index_js_1 = require("../dream-app/index.js");
 const AssociationDeclaredWithoutAssociatedDreamClass_js_1 = require("../errors/associations/AssociationDeclaredWithoutAssociatedDreamClass.js");
 const CannotAssociateThroughPolymorphic_js_1 = require("../errors/associations/CannotAssociateThroughPolymorphic.js");
 const CannotJoinPolymorphicBelongsToError_js_1 = require("../errors/associations/CannotJoinPolymorphicBelongsToError.js");
@@ -21,6 +22,8 @@ const LeftJoinPreloadIncompatibleWithFindEach_js_1 = require("../errors/LeftJoin
 const MissingRequiredCallbackFunctionToPluckEach_js_1 = require("../errors/MissingRequiredCallbackFunctionToPluckEach.js");
 const NoUpdateAllOnJoins_js_1 = require("../errors/NoUpdateAllOnJoins.js");
 const NoUpdateOnAssociationQuery_js_1 = require("../errors/NoUpdateOnAssociationQuery.js");
+const CannotPaginateWithLimit_js_1 = require("../errors/pagination/CannotPaginateWithLimit.js");
+const CannotPaginateWithOffset_js_1 = require("../errors/pagination/CannotPaginateWithOffset.js");
 const RecordNotFound_js_1 = require("../errors/RecordNotFound.js");
 const UnexpectedUndefined_js_1 = require("../errors/UnexpectedUndefined.js");
 const CalendarDate_js_1 = require("../helpers/CalendarDate.js");
@@ -38,19 +41,16 @@ const snakeify_js_1 = require("../helpers/snakeify.js");
 const typechecks_js_1 = require("../helpers/typechecks.js");
 const uniq_js_1 = require("../helpers/uniq.js");
 const curried_ops_statement_js_1 = require("../ops/curried-ops-statement.js");
-const index_js_1 = require("../ops/index.js");
+const index_js_2 = require("../ops/index.js");
 const ops_statement_js_1 = require("../ops/ops-statement.js");
 const constants_js_1 = require("./constants.js");
+const computedPaginatePage_js_1 = require("./internal/computedPaginatePage.js");
 const executeDatabaseQuery_js_1 = require("./internal/executeDatabaseQuery.js");
 const extractAssociationMetadataFromAssociationName_js_1 = require("./internal/extractAssociationMetadataFromAssociationName.js");
 const orderByDirection_js_1 = require("./internal/orderByDirection.js");
 const shouldBypassDefaultScope_js_1 = require("./internal/shouldBypassDefaultScope.js");
 const SimilarityBuilder_js_1 = require("./internal/similarity/SimilarityBuilder.js");
 const sqlResultToDreamInstance_js_1 = require("./internal/sqlResultToDreamInstance.js");
-const index_js_2 = require("../dream-app/index.js");
-const CannotPaginateWithLimit_js_1 = require("../errors/pagination/CannotPaginateWithLimit.js");
-const CannotPaginateWithOffset_js_1 = require("../errors/pagination/CannotPaginateWithOffset.js");
-const computedPaginatePage_js_1 = require("./internal/computedPaginatePage.js");
 class Query extends ConnectedToDB_js_1.default {
     /**
      * @internal
@@ -301,7 +301,7 @@ class Query extends ConnectedToDB_js_1.default {
             baseSelectQuery: opts.baseSelectQuery || this.baseSelectQuery,
             passthroughOnStatement: {
                 ...this.passthroughOnStatement,
-                ...(opts.passthroughOnStatement || {}),
+                ...opts.passthroughOnStatement,
             },
             where: opts.where === null ? [] : [...this.whereStatements, ...(opts.where || [])],
             whereNot: opts.whereNot === null ? [] : [...this.whereNotStatements, ...(opts.whereNot || [])],
@@ -442,13 +442,13 @@ class Query extends ConnectedToDB_js_1.default {
         let lastId = null;
         do {
             if (lastId)
-                records = await query.where({ [this.dreamInstance.primaryKey]: index_js_1.default.greaterThan(lastId) }).all();
+                records = await query.where({ [this.dreamInstance.primaryKey]: index_js_2.default.greaterThan(lastId) }).all();
             else
                 records = await query.all();
             for (const record of records) {
                 await cb(record);
             }
-            lastId = records[records.length - 1]?.primaryKeyValue;
+            lastId = records.at(-1)?.primaryKeyValue;
         } while (records.length > 0 && records.length === batchSize);
     }
     /**
@@ -1003,8 +1003,11 @@ class Query extends ConnectedToDB_js_1.default {
                 return this.buildUpdate({});
             // TODO: in the future, we should support insert type, but don't yet, since inserts are done outside
             // the query class for some reason.
-            default:
-                throw new Error('never');
+            default: {
+                // protection so that if a new QueryType is ever added, this will throw a type error at build time
+                const _never = type;
+                throw new Error(`Unhandled QueryType: ${_never}`);
+            }
         }
     }
     /**
@@ -1452,7 +1455,7 @@ class Query extends ConnectedToDB_js_1.default {
             throw new CannotPaginateWithOffset_js_1.default();
         const page = (0, computedPaginatePage_js_1.default)(opts.page);
         const recordCount = await this.count();
-        const pageSize = opts.pageSize || index_js_2.default.getOrFail().paginationPageSize;
+        const pageSize = opts.pageSize || index_js_1.default.getOrFail().paginationPageSize;
         const pageCount = Math.ceil(recordCount / pageSize);
         const results = await this.limit(pageSize)
             .offset((page - 1) * pageSize)
@@ -1974,7 +1977,7 @@ class Query extends ConnectedToDB_js_1.default {
                 pluckedData[dreamClassToHydrateColumns.length + index]));
             return {
                 dream: hydratedDream,
-                pointsToPrimaryKey: pluckedData[pluckedData.length - 1],
+                pointsToPrimaryKey: pluckedData.at(-1),
             };
         });
         this.hydrateAssociation(dreams, association, preloadedDreamsAndWhatTheyPointTo);
@@ -2480,7 +2483,7 @@ class Query extends ConnectedToDB_js_1.default {
             val = val();
         }
         else if (val === constants_js_1.DreamConst.passthrough) {
-            const column = attr.split('.').pop();
+            const column = attr.split('.').at(-1);
             if (this.passthroughOnStatement[column] === undefined)
                 throw new MissingRequiredPassthroughForAssociationAndClause_js_1.default(column);
             val = this.passthroughOnStatement[column];

package/dist/cjs/src/dream/constants.js

@@ -14,25 +14,23 @@ exports.DreamConst = {
     required: RequiredAttribute,
 };
 exports.openapiPrimitiveTypes = [
-    'string',
     'boolean',
-    'number',
-    'date',
     'date-time',
-    'double',
+    'date',
     'integer',
     'null',
+    'number',
+    'string',
 ];
 exports.openapiShorthandPrimitiveTypes = [
     ...exports.openapiPrimitiveTypes,
-    'decimal',
-    'string[]',
     'boolean[]',
-    'number[]',
-    'date[]',
     'date-time[]',
+    'date[]',
+    'decimal',
     'decimal[]',
-    'double[]',
     'integer[]',
     'json',
+    'number[]',
+    'string[]',
 ];

package/dist/cjs/src/dream/internal/checkSingleValidation.js

@@ -50,8 +50,11 @@ function checkSingleValidation(dream, validation) {
             if (associationMetadata === undefined)
                 throw new UnexpectedUndefined_js_1.default();
             return !!(value || dream[associationMetadata.foreignKey()]);
-        default:
-            throw new Error(`Unhandled validation type found while running validations: ${validation.type}`);
+        default: {
+            // protection so that if a new ValidationType is ever added, this will throw a type error at build time
+            const _never = validation.type;
+            throw new Error(`Unhandled ValidationType: ${_never}`);
+        }
     }
 }
 function isBlank(value) {

package/dist/cjs/src/dream/internal/findOrCreateBy.js

@@ -9,7 +9,7 @@ async function findOrCreateBy(dreamClass, txn = null, attributes, extraOpts = {}
         return existingRecord;
     const dreamModel = dreamClass.new({
         ...attributes,
-        ...(extraOpts?.createWith || {}),
+        ...extraOpts?.createWith,
     });
     await dreamModel.txn(txn).save();
     return dreamModel;

package/dist/cjs/src/dream/internal/orderByDirection.js

@@ -9,7 +9,10 @@ function orderByDirection(dir) {
             return (0, kysely_1.sql) `asc nulls first`;
         case 'desc':
             return (0, kysely_1.sql) `desc nulls last`;
-        default:
-            throw new Error(`Unrecognized orderBy direction: ${dir}`);
+        default: {
+            // protection so that if a new OrderDir is ever added, this will throw a type error at build time
+            const _never = dir;
+            throw new Error(`Unhandled OrderDir: ${_never}`);
+        }
     }
 }

package/dist/cjs/src/dream/internal/updateOrCreateBy.js

@@ -13,6 +13,6 @@ async function updateOrCreateBy(dreamClass, txn = null, attributes, extraOpts =
     }
     return await dreamClass.txn(txn).create({
         ...attributes,
-        ...(extraOpts?.with || {}),
+        ...extraOpts?.with,
     }, skipHooks ? { skipHooks } : undefined);
 }

package/dist/cjs/src/dream-app/helpers/DreamImporter.js

@@ -31,11 +31,11 @@ class DreamImporter {
     }
     static async importSerializers(pathToSerializers, importCb) {
         const serializerPaths = await DreamImporter.ls(pathToSerializers);
-        const serializerClasses = (await Promise.all(serializerPaths.map(serializerPath => importCb(serializerPath).then(serializerClass => [
+        const pathsNamesAndSerializers = (await Promise.all(serializerPaths.map(serializerPath => importCb(serializerPath).then(serializerClass => [
             serializerPath,
             serializerClass,
         ]))));
-        return serializerClasses;
+        return pathsNamesAndSerializers;
     }
 }
 exports.default = DreamImporter;

package/dist/cjs/src/dream-app/helpers/importers/importModels.js

@@ -73,7 +73,7 @@ function setCachedModels(models) {
 }
 function getModelsOrFail() {
     if (!_models)
-        throw new Error('Must call loadModels before calling getModelsOrFail');
+        throw new Error('Must call importModels before calling getModelsOrFail');
     return _models;
 }
 function getModelsOrBlank() {

package/dist/cjs/src/dream-app/helpers/importers/importSerializers.js

@@ -5,7 +5,7 @@ exports.setCachedSerializers = setCachedSerializers;
 exports.getSerializersOrFail = getSerializersOrFail;
 exports.getSerializersOrBlank = getSerializersOrBlank;
 const SerializerNameConflict_js_1 = require("../../../errors/dream-app/SerializerNameConflict.js");
-const index_js_1 = require("../../../serializer/index.js");
+const isDreamSerializer_js_1 = require("../../../serializer/helpers/isDreamSerializer.js");
 const DreamImporter_js_1 = require("../DreamImporter.js");
 const globalSerializerKeyFromPath_js_1 = require("../globalSerializerKeyFromPath.js");
 let _serializers;
@@ -13,41 +13,20 @@ async function importSerializers(serializersPath, serializerImportCb) {
     if (_serializers)
         return _serializers;
     const serializerClasses = await DreamImporter_js_1.default.importSerializers(serializersPath, serializerImportCb);
-    /**
-     * Certain features (e.g. building OpenAPI specs from Attribute and RendersOne/Many decorators)
-     * need static access to things set up by decorators. Stage 3 Decorators change the context that is available
-     * at decoration time such that the class of a property being decorated is only avilable during instance instantiation. In order
-     * to only apply static values once, on boot, `globallyInitializingDecorators` is set to true on DreamSerializer, and all serializers are instantiated.
-     */
-    index_js_1.default['globallyInitializingDecorators'] = true;
     _serializers = {};
     for (const [serializerPath, allSerializers] of serializerClasses) {
         Object.keys(allSerializers).forEach(key => {
             const potentialSerializer = allSerializers[key];
-            if (potentialSerializer?.isDreamSerializer) {
+            if (potentialSerializer && (0, isDreamSerializer_js_1.default)(potentialSerializer)) {
                 const serializerKey = (0, globalSerializerKeyFromPath_js_1.default)(serializerPath, serializersPath, key);
                 if (_serializers[serializerKey])
                     throw new SerializerNameConflict_js_1.default(serializerKey);
-                const serializerClass = potentialSerializer;
-                serializerClass['setGlobalName'](serializerKey);
-                /**
-                 * Certain features (e.g. building OpenAPI specs from Attribute and RendersOne/Many decorators)
-                 * need static access to things set up by decorators. Stage 3 Decorators change the context that is available
-                 * at decoration time such that the class of a property being decorated is only avilable during instance instantiation. In order
-                 * to only apply static values once, on boot, `globallyInitializingDecorators` is set to true on DreamSerializer, and all serializers are instantiated.
-                 */
-                new serializerClass({});
+                const serializer = potentialSerializer;
+                serializer['globalName'] = serializerKey;
                 _serializers[serializerKey] = potentialSerializer;
             }
         });
     }
-    /**
-     * Certain features (e.g. building OpenAPI specs from Attribute and RendersOne/Many decorators)
-     * need static access to things set up by decorators. Stage 3 Decorators change the context that is available
-     * at decoration time such that the class of a property being decorated is only avilable during instance instantiation. In order
-     * to only apply static values once, on boot, `globallyInitializingDecorators` is set to true on DreamSerializer, and all serializers are instantiated.
-     */
-    index_js_1.default['globallyInitializingDecorators'] = false;
     return _serializers;
 }
 function setCachedSerializers(serializers) {
@@ -55,7 +34,7 @@ function setCachedSerializers(serializers) {
 }
 function getSerializersOrFail() {
     if (!_serializers)
-        throw new Error('Must call loadSerializers before calling getSerializersOrFail');
+        throw new Error('Must call importSerializers before calling getSerializersOrFail');
     return _serializers;
 }
 function getSerializersOrBlank() {

package/dist/cjs/src/dream-app/index.js

@@ -317,8 +317,11 @@ Try setting it to something valid, like:
             case 'paginationPageSize':
                 this._paginationPageSize = options;
                 break;
-            default:
-                throw new Error(`Unhandled applyOption encountered in Dreamconf: ${applyOption}`);
+            default: {
+                // protection so that if a new ApplyOpt is ever added, this will throw a type error at build time
+                const _never = applyOption;
+                throw new Error(`Unhandled ApplyOpt: ${_never}`);
+            }
         }
     }
     on(hookEventType, cb) {

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

@@ -15,8 +15,11 @@ class Encrypt {
             case 'aes-192-gcm':
             case 'aes-128-gcm':
                 return (0, encryptAESGCM_js_1.default)(algorithm, data, key);
-            default:
-                throw new Error(`unrecognized algorith provided to encrypt: ${algorithm}`);
+            default: {
+                // protection so that if a new EncryptAlgorithm is ever added, this will throw a type error at build time
+                const _never = algorithm;
+                throw new Error(`Unhandled EncryptAlgorithm: ${_never}`);
+            }
         }
     }
     static decrypt(encrypted, { algorithm, key }, legacyOpts) {
@@ -36,8 +39,11 @@ class Encrypt {
                 catch {
                     return null;
                 }
-            default:
-                throw new Error(`unrecognized algorith provided to decrypt: ${algorithm}`);
+            default: {
+                // protection so that if a new EncryptAlgorithm is ever added, this will throw a type error at build time
+                const _never = algorithm;
+                throw new Error(`Unhandled EncryptAlgorithm: ${_never}`);
+            }
         }
     }
     static attemptDecryptionWithLegacyKeys(encrypted, { algorithm, key }, legacyOpts) {
@@ -54,8 +60,11 @@ class Encrypt {
                 return (0, generateKeyAESGCM_js_1.default)(192);
             case 'aes-128-gcm':
                 return (0, generateKeyAESGCM_js_1.default)(128);
-            default:
-                throw new Error(`unrecognized algorithm provided to generateKey: ${algorithm}`);
+            default: {
+                // protection so that if a new EncryptAlgorithm is ever added, this will throw a type error at build time
+                const _never = algorithm;
+                throw new Error(`Unhandled EncryptAlgorithm: ${_never}`);
+            }
         }
     }
     static validateKey(base64EncodedKey, algorithm) {
@@ -66,8 +75,11 @@ class Encrypt {
                 return (0, validateKeyAESGCM_js_1.default)(base64EncodedKey, 192);
             case 'aes-128-gcm':
                 return (0, validateKeyAESGCM_js_1.default)(base64EncodedKey, 128);
-            default:
-                throw new Error(`unrecognized algorith provided to validateKey: ${algorithm}`);
+            default: {
+                // protection so that if a new EncryptAlgorithm is ever added, this will throw a type error at build time
+                const _never = algorithm;
+                throw new Error(`Unhandled EncryptAlgorithm: ${_never}`);
+            }
         }
     }
 }

package/dist/cjs/src/errors/serializers/AttemptedToDeriveDescendentSerializersFromNonSerializer.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_util_1 = require("node:util");
+class AttemptedToDeriveDescendentSerializersFromNonSerializer extends Error {
+    serializer;
+    constructor(serializer) {
+        super();
+        this.serializer = serializer;
+    }
+    get message() {
+        return `
+Attempted to derive descendent serializers from non serializer:
+${(0, node_util_1.inspect)(this.serializer)}`;
+    }
+}
+exports.default = AttemptedToDeriveDescendentSerializersFromNonSerializer;

package/dist/cjs/src/errors/serializers/DelegationTargetDoesNotExist.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class DelegationTargetDoesNotExist extends Error {
+    delegationTarget;
+    constructor(delegationTarget) {
+        super();
+        this.delegationTarget = delegationTarget;
+    }
+    get message() {
+        return `Attempted to delegate to \`${this.delegationTarget}\`, but \`${this.delegationTarget}\` does not exist.`;
+    }
+}
+exports.default = DelegationTargetDoesNotExist;

package/dist/cjs/src/errors/serializers/MissingSerializersDefinition.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class MissingSerializersDefinition extends Error {
+    viewModel;
+    constructor(viewModel) {
+        super();
+        this.viewModel = viewModel;
+    }
+    get message() {
+        const className = this.viewModel?.sanitizedConstructorName ?? this.viewModel.constructor.name;
+        return `
+Missing serializers definition on class \`${className}\`
+
+Try something like this in your ${className}'s serializer getter:
+
+class ${className} {
+  public get serializers(): DreamSerializers<${className}> {
+    return {
+      default: '${className}Serializer'
+    }
+  }
+  ...
+}`;
+    }
+}
+exports.default = MissingSerializersDefinition;

package/dist/cjs/src/errors/serializers/MissingSerializersDefinitionForKey.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class MissingSerializersDefinitionForKey extends Error {
+    viewModel;
+    serializerKey;
+    constructor(viewModel, serializerKey) {
+        super();
+        this.viewModel = viewModel;
+        this.serializerKey = serializerKey;
+    }
+    get message() {
+        const className = this.viewModel?.sanitizedConstructorName ?? this.viewModel.constructor.name;
+        return `
+Missing serializers definition for \`${this.serializerKey}\` on class \`${className}\`
+
+Try something like this in your ${className}'s serializer getter:
+
+class ${className} {
+  public get serializers(): DreamSerializers<${className}> {
+    return {
+      default: '${className}Serializer'
+      ${this.serializerKey}: '<the_global_name_of_a_serializer>'
+    }
+  }
+  ...
+}`;
+    }
+}
+exports.default = MissingSerializersDefinitionForKey;

package/dist/cjs/src/errors/serializers/NoGlobalSerializerForSpecifiedKey.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class NoGlobalSerializerForSpecifiedKey extends Error {
+    viewModel;
+    serializerKey;
+    globalName;
+    constructor(viewModel, serializerKey, globalName) {
+        super();
+        this.viewModel = viewModel;
+        this.serializerKey = serializerKey;
+        this.globalName = globalName;
+    }
+    get message() {
+        const className = this.viewModel?.sanitizedConstructorName ?? this.viewModel.constructor.name;
+        return `
+${className} specified a global name of "${this.globalName}" for serializer key "${this.serializerKey}",
+but no serializer corresponds to "${this.globalName}".
+`;
+    }
+}
+exports.default = NoGlobalSerializerForSpecifiedKey;

package/dist/cjs/src/errors/serializers/NoSerializerFoundForRendersOneAndMany.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class NoSerializerFoundForRendersOneAndMany extends Error {
+    associationName;
+    constructor(associationName) {
+        super();
+        this.associationName = associationName;
+    }
+    get message() {
+        return `
+Attempted to render \`rendersOne\` / \`rendersMany\`
+\`${this.associationName}\`, but could not locate a
+serializer.`;
+    }
+}
+exports.default = NoSerializerFoundForRendersOneAndMany;

package/dist/cjs/src/errors/serializers/NonDreamSerializerDerivedFromGlobalSerializerForSpecifiedKey.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_util_1 = require("node:util");
+class NonDreamSerializerDerivedFromGlobalSerializerForSpecifiedKey extends Error {
+    viewModel;
+    serializerKey;
+    globalName;
+    serializer;
+    constructor(viewModel, serializerKey, globalName, serializer) {
+        super();
+        this.viewModel = viewModel;
+        this.serializerKey = serializerKey;
+        this.globalName = globalName;
+        this.serializer = serializer;
+    }
+    get message() {
+        const className = this.viewModel?.sanitizedConstructorName ?? this.viewModel.constructor.name;
+        return `
+${className} specified a global name of "${this.globalName}" for serializer key "${this.serializerKey}",
+but the derived serializer is not a Dream serializer:
+
+${(0, node_util_1.inspect)(this.serializer)}
+`;
+    }
+}
+exports.default = NonDreamSerializerDerivedFromGlobalSerializerForSpecifiedKey;