joist-core 2.3.0-next.97 → 2.3.0-next.99

package/build/index.d.mts

@@ -1,6 +1,3 @@
-import { Temporal, maybeRequireTemporal, requireTemporal } from "./temporal.mjs";
-import { BigIntSerde, CustomSerde, CustomSerdeAdapter, DateSerde, DecimalToNumberSerde, EnumArrayFieldSerde, EnumFieldSerde, JsonSerde, KeySerde, PlainDateSerde, PlainDateTimeSerde, PlainTimeSerde, PrimitiveSerde, ScalarCodec, SuperstructSerde, TimestampCodec, ZodSerde, ZonedDateTimeSerde } from "./serde.mjs";
-import { Column, ColumnDescriptors } from "./columns.mjs";
 import { ActualFactoryOpts, ColumnsOf, EntityOf, FactoryExtrasOf, FieldsOf, FilterOf, GraphQLFilterOf, InheritanceTypeOf, OptIdsOf, OptsOf, OrderOf, RelationsOf, RootTypeNameOf, TypeMap, TypeMapEntry, TypeNameOf } from "./typeMap.mjs";
 import { Changes, EntityChanges, EnumCollectionFieldStatus, FieldStatus, ManyToManyFieldStatus, ManyToOneFieldStatus, OneToManyFieldStatus, PrimitiveFieldStatus, newChangesProxy } from "./changes.mjs";
 import { deepNormalizeHint, normalizeHint } from "./normalizeHints.mjs";
@@ -31,9 +28,9 @@ import { PolymorphicReference, PolymorphicReferenceImpl, hasOnePolymorphic, isPo
 import { ReactiveField, hasReactiveField, isReactiveField } from "./relations/ReactiveField.mjs";
 import { ReactiveGetter, hasReactiveGetter, isReactiveGetter } from "./relations/ReactiveGetter.mjs";
 import { ReactiveManyToMany, ReactiveManyToManyImpl, hasReactiveManyToMany, isReactiveManyToMany } from "./relations/ReactiveManyToMany.mjs";
-import { JoinRowTodo, Todo } from "./Todo.mjs";
+import { JoinRowTodo, Todo } from "./flush/Todo.mjs";
 import { ReactionLogger, setReactionLogging } from "./logging/ReactionLogger.mjs";
-import { JoinColumnValue, JoinRow, JoinRowOperation, ManyToManyLike } from "./JoinRows.mjs";
+import { JoinColumnValue, JoinRow, JoinRowOperation, ManyToManyLike } from "./flush/JoinRows.mjs";
 import { ReactiveManyToManyOtherSide, ReactiveManyToManyOtherSideImpl, hasReactiveManyToManyOtherSide, isReactiveManyToManyOtherSide } from "./relations/ReactiveManyToManyOtherSide.mjs";
 import { hasAsyncReactiveField, isAsyncReactiveField } from "./relations/AsyncReactiveField.mjs";
 import { ReactiveReference, ReactiveReferenceImpl, hasReactiveReference, isReactiveReference } from "./relations/ReactiveReference.mjs";
@@ -49,16 +46,19 @@ import { BooleanGraphQLFilter, EntityGraphQLFilter, GraphQLFilterAndSettings, Gr
 import { AliasFn, ResolvedScope, Scope, ScopeFilterFragment, ScopeFn, ScopeJoinFilter, ScopeQuery, isScope, isScopeJoinFilter, isSelectAllFilter, newScopeFn, resolveScope } from "./queries/find/scopes.mjs";
 import { BooleanFilter, EntityFilter, EntityFilterObject, ExpressionCondition, ExpressionFilter, FilterAndSettings, FilterWithAlias, FindFilter, OrderBy, UniqueFilter, ValueFilter, mergeFindOptions } from "./queries/find/EntityFilter.mjs";
 import { abbreviation, asNew, assertNever, cleanSql, cleanStringValue, fail, failIfAnyRejected, indexBy, partition, zeroTo } from "./utils.mjs";
-import { DeepNew, LoadHint, Loadable, Loaded, MarkLoaded, NestedLoadHint, New, RelationsIn, assertLoaded, ensureLoaded, isLoaded, isNew, maybePopulateThen, unsafeLoaded } from "./loadHints.mjs";
-import { Reactable, Reacted, ReactiveHint, ReactiveTarget, convertToLoadHint, isTypeOrSubType, reverseReactiveHint } from "./reactiveHints.mjs";
+import { DeepNew, LoadHint, Loadable, Loaded, MarkLoaded, NestedLoadHint, New, RelationsIn, assertLoaded, ensureLoaded, isLoaded, isNew, maybePopulateThen, unsafeLoaded } from "./loading/loadHints.mjs";
+import { Reactable, Reacted, ReactiveHint, ReactiveTarget, convertToLoadHint, isTypeOrSubType, reverseReactiveHint } from "./reactivity/reactiveHints.mjs";
 import { GenericError, ValidationCode, ValidationError, ValidationErrors, ValidationRule, ValidationRuleInternal, ValidationRuleResult, cannotBeChanged, cannotBeUpdated, maxValueRule, minValueRule, mustBeSubType, newRequiredLazyFieldRule, newRequiredRule, rangeValueRule } from "./rules.mjs";
 import { ConfigApi, EntityHook, resetBootFlag } from "./config.mjs";
+import { Temporal, maybeRequireTemporal, requireTemporal } from "./serde/temporal.mjs";
+import { BigIntSerde, CustomSerde, CustomSerdeAdapter, DateSerde, DecimalToNumberSerde, EnumArrayFieldSerde, EnumFieldSerde, JsonSerde, KeySerde, PlainDateSerde, PlainDateTimeSerde, PlainTimeSerde, PrimitiveSerde, ScalarCodec, SuperstructSerde, TimestampCodec, ZodSerde, ZonedDateTimeSerde } from "./serde/serde.mjs";
+import { Column, ColumnDescriptors } from "./serde/columns.mjs";
 import { DeleteOp, InsertFixup, InsertOp, OpColumn, UpdateOp, generateOps } from "./drivers/EntityWriter.mjs";
 import { PojoRowData, RowData, emptyRowData } from "./RowData.mjs";
-import { FieldColumn, FieldSerde, PolyComponent, PolymorphicKeySerde, SimpleFieldSerde, TimestampSerde, hasSerde, polymorphicField } from "./fieldSerde.mjs";
+import { FieldColumn, FieldSerde, PolyComponent, PolymorphicKeySerde, SimpleFieldSerde, TimestampSerde, hasSerde, polymorphicField } from "./serde/fieldSerde.mjs";
 import { EntityMetadata, EnumField, Field, LargeOneToManyField, ManyToManyEnumField, ManyToManyField, ManyToOneField, OneToManyField, OneToOneField, PolymorphicField, PolymorphicFieldComponent, PrimaryKeyField, PrimitiveField, SerdeField, getBaseAndSelfMetas, getBaseMeta, getBaseSelfAndSubMetas, getMetadata, getMetadataForField, getSubMetas, isCollectionField, isManyToManyEnumField, isManyToManyField, isManyToOneField, isOneToManyField, isOneToOneField, isPolymorphicField, isReferenceField } from "./EntityMetadata.mjs";
 import { getDefaultDependencies } from "./defaults.mjs";
-import { Lens, getLens, getLensPath, isAllSqlPaths, isLensLoaded, isLensLoadedPath, lensPathToLoadHint, lensToLoadHint, lensToPath, loadLens, loadLensPath, mapPathsToTarget } from "./loadLens.mjs";
+import { Lens, getLens, getLensPath, isAllSqlPaths, isLensLoaded, isLensLoadedPath, lensPathToLoadHint, lensToLoadHint, lensToPath, loadLens, loadLensPath, mapPathsToTarget } from "./loading/loadLens.mjs";
 import { partitionHint } from "./preloading/partitionHint.mjs";
 import { SubqueryRenderer, buildValueCondition, buildWhereClause } from "./queries/renderConditions.mjs";
 import { AliasAssigner } from "./queries/sql/AliasAssigner.mjs";
@@ -70,13 +70,13 @@ import { ArrayAggOptions, Expr, ExprBrand, ExprLike, InnerJoin, LeftJoin, exprBr
 import { CollectionJoin, EntityColumn, PolyReference, PrimitiveColumn, ReferenceColumn, ReferenceJoin, Table, TableBrand, TableFilter, TableFor, TableMgmt, getTableMetadata, getTableMgmt, isTable, newTableProxy, table, tableMgmt, tables } from "./queries/sql/Tables.mjs";
 import { ConditionBuilder } from "./queries/ConditionBuilder.mjs";
 import { EntityField, EntityFields, SettableFields } from "./EntityFields.mjs";
-import { EntityOrId, HintNode } from "./HintTree.mjs";
+import { EntityOrId, HintNode } from "./loading/HintTree.mjs";
 import { JoinResult, PreloadHydrator, PreloadPlugin } from "./plugins/PreloadPlugin.mjs";
 import { Driver, DriverQueryResult } from "./drivers/Driver.mjs";
 import { DeleteStatement, ExecuteResult, InsertStatement, InsertValues, MutationReturning, MutationStatement, UpdateStatement, UpdateValues } from "./queries/sql/execute.mjs";
 import { skipCondition } from "./queries/skipCondition.mjs";
 import { InstanceData } from "./InstanceData.mjs";
-import { PendingChange, PendingCreate, PendingDelete, PendingM2M, PendingUpdate } from "./PendingChanges.mjs";
+import { PendingChange, PendingCreate, PendingDelete, PendingM2M, PendingUpdate } from "./flush/PendingChanges.mjs";
 import { Plugin } from "./PluginManager.mjs";
 import { buildCteSql, buildRawQuery } from "./queries/find/buildFindQuery.mjs";
 import { ParsedEntityFilter, makeLike, mapToDb, parseEntityFilter, parseValueFilter } from "./queries/valueFilters.mjs";
@@ -85,7 +85,7 @@ import { optimizeCollectionJoins } from "./queries/find/QueryParser.collectionJo
 import { visitConditions } from "./queries/find/QueryVisitor.mjs";
 import { configureMetadata, getConstructorFromTaggedId, getMetadataForTable, getMetadataForType, maybeGetConstructorFromReference } from "./configure.mjs";
 import { RuntimeConfig, getRuntimeConfig, setRuntimeConfig } from "./runtimeConfig.mjs";
-import { driverApi } from "./driverApi.mjs";
+import { driverApi } from "./drivers/driverApi.mjs";
 import { IdAssigner, RandomUuidAssigner, SequenceIdAssigner, TestUuidAssigner } from "./drivers/IdAssigner.mjs";
 import "./drivers/index.mjs";
 import { getField, isChangeableField, isFieldSet, setField } from "./fields.mjs";
@@ -100,11 +100,11 @@ import { FieldLogger, FieldLoggerWatch, WriteFn, noopFieldLogger } from "./loggi
 import { ImmutableEntitiesPlugin } from "./plugins/ImmutableEntitiesPlugin.mjs";
 import { JsonAggregatePreloader } from "./preloading/JsonAggregatePreloader.mjs";
 import { nowUTC } from "./nowUTC.mjs";
-import { plainDateMapper, plainDateTimeMapper, plainTimeMapper, zonedDateTimeMapper } from "./temporalMappers.mjs";
+import { plainDateMapper, plainDateTimeMapper, plainTimeMapper, zonedDateTimeMapper } from "./serde/temporalMappers.mjs";
 import { isInTrustedContext, runInTrustedContext } from "./trusted.mjs";
-import { buildUnnestCte, ensureRectangularArraySizes } from "./unnest.mjs";
+import { buildUnnestCte, ensureRectangularArraySizes } from "./queries/unnest.mjs";
 import { DeepPartialOrNull, updatePartial, upsert } from "./upsert.mjs";
-import { StubbedRelation, WithLoaded, ensureWithLoaded, withLoaded } from "./withLoaded.mjs";
+import { StubbedRelation, WithLoaded, ensureWithLoaded, withLoaded } from "./loading/withLoaded.mjs";
 import { EntityConstructor, EntityManager, EntityManagerHook, EntityManagerInternalApi, EntityManagerMode, EntityManagerOpts, FindCountFilterOptions, FindFilterOptions, FindGqlFilterOptions, FindOperation, FlushOptions, IdOf, LoaderCache, MaybeAbstractEntityConstructor, NotFoundError, ReadOnlyError, TaggedId, TimestampFields, TooManyError, appendStack, createRowFromEntityData, driverAfterBegin, driverAfterCommit, driverBeforeBegin, driverBeforeCommit, getDefaultEntityLimit, getEmInternalApi, isDefined, isId, isKey, resetDefaultEntityLimit, sameEntity, sameReference, setDefaultEntityLimit, setLastNow } from "./EntityManager.mjs";
 import { Entity, IdType, isEntity } from "./Entity.mjs";
 import { BaseEntity, getInstanceData } from "./BaseEntity.mjs";

package/build/index.js

@@ -1,70 +1,66 @@
-import { Column } from "./columns.js";
 import { isCollection, isLoadedCollection } from "./relations/Collection.js";
-import { Temporal, maybeRequireTemporal, requireTemporal } from "./temporal.js";
-import { getField, isChangeableField, isFieldSet, setField } from "./fields.js";
-import { Todo } from "./Todo.js";
-import { ReactionLogger, setReactionLogging } from "./logging/ReactionLogger.js";
-import { isInTrustedContext, runInTrustedContext } from "./trusted.js";
-import { JoinRowOperation } from "./JoinRows.js";
 import { AbstractRelationImpl } from "./relations/AbstractRelationImpl.js";
+import { CustomCollection, hasCustomCollection } from "./relations/CustomCollection.js";
 import { EnumCollectionImpl, hasEnumCollection } from "./relations/EnumCollection.js";
-import { kq, kqDot, kqStar } from "./queries/sql/keywords.js";
-import { PojoRowData, emptyRowData } from "./RowData.js";
+import { CustomReference, hasCustomReference } from "./relations/CustomReference.js";
+import { deepNormalizeHint, normalizeHint } from "./normalizeHints.js";
+import { hasReactiveGetter, isReactiveGetter } from "./relations/ReactiveGetter.js";
+import { isRelation } from "./relations/Relation.js";
+import { isLoadedReadOnlyCollection, isReadOnlyCollection } from "./relations/ReadOnlyCollection.js";
 import { RecursiveCycleError } from "./relations/RecursiveCycleError.js";
+import { hasRecursiveChildren, hasRecursiveM2m, hasRecursiveParents } from "./relations/RecursiveCollection.js";
+import { convertToLoadHint, isTypeOrSubType, reverseReactiveHint } from "./reactivity/reactiveHints.js";
+import { assertLoaded, ensureLoaded, isLoaded, isNew, maybePopulateThen, unsafeLoaded } from "./loading/loadHints.js";
+import { hasAsyncMethod } from "./relations/hasAsyncMethod.js";
 import { PropertyImpl, hasProperty, hasReactiveProperty, isLoadedProperty, isProperty } from "./relations/hasProperty.js";
+import { AsyncPropertyImpl, hasAsyncProperty, isAsyncProperty, isLoadedAsyncProperty } from "./relations/AsyncProperty.js";
+import { Temporal, maybeRequireTemporal, requireTemporal } from "./serde/temporal.js";
+import { getField, isChangeableField, isFieldSet, setField } from "./fields.js";
+import { assertIdIsTagged, assertIdsAreTagged, deTagId, deTagIds, ensureTagged, isTaggedId, keyToNumber, keyToTaggedId, maybeResolveReferenceToId, setTaggedIdDelimiter, tagFromId, tagId, tagIds, toIdOf, toTaggedId, unsafeDeTagIds } from "./keys.js";
+import { kq, kqDot, kqStar } from "./queries/sql/keywords.js";
+import { PojoRowData, emptyRowData } from "./RowData.js";
 import { LazyFieldImpl, hasLazyField, isLazyField, isLoadedLazyField } from "./relations/LazyField.js";
-import "./typeMap.js";
-import { newChangesProxy } from "./changes.js";
+import { hasManyDerived } from "./relations/hasManyDerived.js";
+import { hasManyThrough } from "./relations/hasManyThrough.js";
+import { isLoadedReference, isReference } from "./relations/Reference.js";
+import { hasOneDerived } from "./relations/hasOneDerived.js";
+import { hasOneThrough } from "./relations/hasOneThrough.js";
+import { ManyToManyCollection, hasManyToMany } from "./relations/ManyToManyCollection.js";
+import { ManyToManyLargeCollection, hasLargeManyToMany } from "./relations/ManyToManyLargeCollection.js";
 import { skipCondition } from "./queries/skipCondition.js";
 import { alias, aliases, getAliasMetadata, getAliasMgmt, getMaybeCtiAlias, isAlias, newAliasProxy } from "./queries/find/Aliases.js";
 import { isScope, isScopeJoinFilter, isSelectAllFilter, newScopeFn, resolveScope } from "./queries/find/scopes.js";
 import { makeLike, mapToDb, parseEntityFilter, parseValueFilter } from "./queries/valueFilters.js";
 import { ConditionBuilder } from "./queries/ConditionBuilder.js";
 import { filterSoftDeletes, lazyExcludedSelects, maybeAddNotSoftDeleted, stiSubtypeFilter } from "./queries/entityQueryUtils.js";
-import { exprBrand } from "./queries/sql/Expr.js";
 import { visitConditions } from "./queries/find/QueryVisitor.js";
+import { exprBrand } from "./queries/sql/Expr.js";
 import { addTablePerClassJoinsAndClassTag, findFilterField, getTables, maybeAddIdNotNulls, maybeAddOrderBy, parseAlias, parseFindQuery } from "./queries/find/QueryParser.js";
 import { OneToManyCollection, hasMany } from "./relations/OneToManyCollection.js";
 import { ManyToOneReferenceImpl, hasOne, isManyToOneReference } from "./relations/ManyToOneReference.js";
-import { isLoadedReference, isReference } from "./relations/Reference.js";
+import { OneToManyLargeCollection, hasLargeMany } from "./relations/OneToManyLargeCollection.js";
 import { ReactiveReferenceImpl, hasReactiveReference, isReactiveReference } from "./relations/ReactiveReference.js";
 import { OneToOneReferenceImpl, hasOneToOne, isLoadedOneToOneReference, isOneToOneReference } from "./relations/OneToOneReference.js";
-import { hasReactiveGetter, isReactiveGetter } from "./relations/ReactiveGetter.js";
-import { isRelation } from "./relations/Relation.js";
-import { isLoadedReadOnlyCollection, isReadOnlyCollection } from "./relations/ReadOnlyCollection.js";
-import { hasRecursiveChildren, hasRecursiveM2m, hasRecursiveParents } from "./relations/RecursiveCollection.js";
-import { convertToLoadHint, isTypeOrSubType, reverseReactiveHint } from "./reactiveHints.js";
-import { deepNormalizeHint, normalizeHint } from "./normalizeHints.js";
-import { assertLoaded, ensureLoaded, isLoaded, isNew, maybePopulateThen, unsafeLoaded } from "./loadHints.js";
-import { abbreviation, asNew, assertNever, cleanSql, cleanStringValue, fail, failIfAnyRejected, indexBy, partition, zeroTo } from "./utils.js";
-import { UnknownProperty, getLazyFields, getProperties } from "./getProperties.js";
-import { lazyField } from "./newEntity.js";
-import { CustomCollection, hasCustomCollection } from "./relations/CustomCollection.js";
-import { CustomReference, hasCustomReference } from "./relations/CustomReference.js";
-import { hasAsyncMethod } from "./relations/hasAsyncMethod.js";
-import { AsyncPropertyImpl, hasAsyncProperty, isAsyncProperty, isLoadedAsyncProperty } from "./relations/AsyncProperty.js";
-import { hasManyDerived } from "./relations/hasManyDerived.js";
-import { hasManyThrough } from "./relations/hasManyThrough.js";
-import { hasOneDerived } from "./relations/hasOneDerived.js";
-import { hasOneThrough } from "./relations/hasOneThrough.js";
-import { ManyToManyCollection, hasManyToMany } from "./relations/ManyToManyCollection.js";
-import { ManyToManyLargeCollection, hasLargeManyToMany } from "./relations/ManyToManyLargeCollection.js";
-import { OneToManyLargeCollection, hasLargeMany } from "./relations/OneToManyLargeCollection.js";
 import { PolymorphicReferenceImpl, hasOnePolymorphic, isPolymorphicReference } from "./relations/PolymorphicReference.js";
 import { ReactiveFieldImpl, hasReactiveField, isReactiveField } from "./relations/ReactiveField.js";
 import { ReactiveManyToManyImpl, hasReactiveManyToMany, isReactiveManyToMany } from "./relations/ReactiveManyToMany.js";
 import { ReactiveManyToManyOtherSideImpl, hasReactiveManyToManyOtherSide, isReactiveManyToManyOtherSide } from "./relations/ReactiveManyToManyOtherSide.js";
 import { AsyncReactiveFieldImpl, hasAsyncReactiveField, isAsyncReactiveField } from "./relations/AsyncReactiveField.js";
 import "./relations/index.js";
-import { assertIdIsTagged, assertIdsAreTagged, deTagId, deTagIds, ensureTagged, isTaggedId, keyToNumber, keyToTaggedId, maybeResolveReferenceToId, setTaggedIdDelimiter, tagFromId, tagId, tagIds, toIdOf, toTaggedId, unsafeDeTagIds } from "./keys.js";
-import { FieldColumn, PolyComponent, PolymorphicKeySerde, SimpleFieldSerde, hasSerde, polymorphicField } from "./fieldSerde.js";
+import { abbreviation, asNew, assertNever, cleanSql, cleanStringValue, fail, failIfAnyRejected, indexBy, partition, zeroTo } from "./utils.js";
+import { lazyField } from "./newEntity.js";
+import { UnknownProperty, getLazyFields, getProperties } from "./getProperties.js";
+import "./typeMap.js";
+import { newChangesProxy } from "./changes.js";
 import { ValidationCode, ValidationErrors, cannotBeChanged, cannotBeUpdated, maxValueRule, minValueRule, mustBeSubType, newRequiredLazyFieldRule, newRequiredRule, rangeValueRule } from "./rules.js";
 import { getRuntimeConfig, setRuntimeConfig } from "./runtimeConfig.js";
+import { FieldColumn, PolyComponent, PolymorphicKeySerde, SimpleFieldSerde, hasSerde, polymorphicField } from "./serde/fieldSerde.js";
 import { configureMetadata, getConstructorFromTaggedId, getMetadataForTable, getMetadataForType, maybeGetConstructorFromReference } from "./configure.js";
 import { ConfigApi, resetBootFlag } from "./config.js";
 import { getBaseAndSelfMetas, getBaseMeta, getBaseSelfAndSubMetas, getMetadata, getMetadataForField, getSubMetas, isCollectionField, isManyToManyEnumField, isManyToManyField, isManyToOneField, isOneToManyField, isOneToOneField, isPolymorphicField, isReferenceField } from "./EntityMetadata.js";
+import { isInTrustedContext, runInTrustedContext } from "./trusted.js";
 import { getDefaultDependencies } from "./defaults.js";
-import { getLens, getLensPath, isAllSqlPaths, isLensLoaded, isLensLoadedPath, lensPathToLoadHint, lensToLoadHint, lensToPath, loadLens, loadLensPath, mapPathsToTarget } from "./loadLens.js";
+import { getLens, getLensPath, isAllSqlPaths, isLensLoaded, isLensLoadedPath, lensPathToLoadHint, lensToLoadHint, lensToPath, loadLens, loadLensPath, mapPathsToTarget } from "./loading/loadLens.js";
 import { setFactoryWriter } from "./logging/FactoryLogger.js";
 import { FactoryInitialValue, defaultValue, factories, getTestIndex, isFactoryCreation, maybeBranchValue, maybeNew, maybeNewPoly, newTestInstance, noValue, setFactoryLogging, testIndex } from "./newTestInstance.js";
 import { partitionHint } from "./preloading/partitionHint.js";
@@ -75,24 +71,28 @@ import { getTableMetadata, getTableMgmt, isTable, newTableProxy, table, tableMgm
 import { mergeFindOptions } from "./queries/find/EntityFilter.js";
 import { expr } from "./queries/sql/expressions/expression.js";
 import { InstanceData } from "./InstanceData.js";
+import { JoinRowOperation } from "./flush/JoinRows.js";
 import { Plugin } from "./PluginManager.js";
 import { buildCteSql, buildRawQuery } from "./queries/find/buildFindQuery.js";
 import { optimizeCollectionJoins } from "./queries/find/QueryParser.collectionJoins.js";
+import { Todo } from "./flush/Todo.js";
+import { plainDateMapper, plainDateTimeMapper, plainTimeMapper, zonedDateTimeMapper } from "./serde/temporalMappers.js";
+import { buildUnnestCte, ensureRectangularArraySizes } from "./queries/unnest.js";
 import { generateOps } from "./drivers/EntityWriter.js";
-import { buildUnnestCte, ensureRectangularArraySizes } from "./unnest.js";
-import { BigIntSerde, CustomSerdeAdapter, DateSerde, DecimalToNumberSerde, EnumArrayFieldSerde, EnumFieldSerde, JsonSerde, KeySerde, PlainDateSerde, PlainDateTimeSerde, PlainTimeSerde, PrimitiveSerde, SuperstructSerde, ZodSerde, ZonedDateTimeSerde } from "./serde.js";
-import { plainDateMapper, plainDateTimeMapper, plainTimeMapper, zonedDateTimeMapper } from "./temporalMappers.js";
-import { driverApi } from "./driverApi.js";
+import { driverApi } from "./drivers/driverApi.js";
 import { RandomUuidAssigner, SequenceIdAssigner, TestUuidAssigner } from "./drivers/IdAssigner.js";
 import "./drivers/index.js";
 import { toJSON } from "./json.js";
 import { FieldLogger, noopFieldLogger } from "./logging/FieldLogger.js";
+import { ReactionLogger, setReactionLogging } from "./logging/ReactionLogger.js";
 import { ImmutableEntitiesPlugin } from "./plugins/ImmutableEntitiesPlugin.js";
 import { JsonAggregatePreloader } from "./preloading/JsonAggregatePreloader.js";
 import { entityQueryBrand, query, queryMaybe, recursiveQuery, sql, subqueryBrand } from "./queries/sql/query.js";
 import { nowUTC } from "./nowUTC.js";
+import { BigIntSerde, CustomSerdeAdapter, DateSerde, DecimalToNumberSerde, EnumArrayFieldSerde, EnumFieldSerde, JsonSerde, KeySerde, PlainDateSerde, PlainDateTimeSerde, PlainTimeSerde, PrimitiveSerde, SuperstructSerde, ZodSerde, ZonedDateTimeSerde } from "./serde/serde.js";
+import { Column } from "./serde/columns.js";
 import { updatePartial, upsert } from "./upsert.js";
-import { StubbedRelation, ensureWithLoaded, withLoaded } from "./withLoaded.js";
+import { StubbedRelation, ensureWithLoaded, withLoaded } from "./loading/withLoaded.js";
 import { EntityManager, NotFoundError, ReadOnlyError, TooManyError, appendStack, createRowFromEntityData, driverAfterBegin, driverAfterCommit, driverBeforeBegin, driverBeforeCommit, getDefaultEntityLimit, getEmInternalApi, isDefined, isId, isKey, resetDefaultEntityLimit, sameEntity, sameReference, setDefaultEntityLimit, setLastNow } from "./EntityManager.js";
 import { isEntity } from "./Entity.js";
 import { BaseEntity, getInstanceData } from "./BaseEntity.js";

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { getInstanceData } from \"./BaseEntity.ts\";\nimport { getDefaultDependencies } from \"./defaults.ts\";\nimport { type Entity } from \"./Entity.ts\";\nimport { type EntityConstructor, type MaybeAbstractEntityConstructor } from \"./EntityManager.ts\";\nimport { type EntityMetadata, getBaseMeta, getMetadata } from \"./EntityMetadata.ts\";\nimport { getField, setField } from \"./fields.ts\";\nimport { getProperties } from \"./getProperties.ts\";\nimport { type New } from \"./loadHints.ts\";\nimport { isAllSqlPaths } from \"./loadLens.ts\";\nimport { FactoryInitialValue } from \"./newTestInstance.ts\";\nimport { partitionHint } from \"./preloading/partitionHint.ts\";\nimport { buildWhereClause } from \"./queries/renderConditions.ts\";\nimport { AbstractRelationImpl } from \"./relations/AbstractRelationImpl.ts\";\nimport { AsyncReactiveFieldImpl } from \"./relations/AsyncReactiveField.ts\";\nimport {\n  isAsyncProperty,\n  isAsyncReactiveField,\n  isLazyField,\n  isProperty,\n  isReactiveField,\n  isReactiveGetter,\n} from \"./relations/index.ts\";\nimport { ReactiveFieldImpl } from \"./relations/ReactiveField.ts\";\nimport { type OptsOf } from \"./typeMap.ts\";\nimport { fail } from \"./utils.ts\";\n\nexport const testing = { isAllSqlPaths, getDefaultDependencies, partitionHint };\nexport const internals = { buildWhereClause };\nexport { newPgConnectionConfig } from \"joist-utils\";\nexport { AliasAssigner } from \"./queries/sql/AliasAssigner.ts\";\nexport {\n  type AndCondition,\n  type ConditionGroup,\n  type DomainPredicate,\n  type OrCondition,\n  type PredicateBrand,\n  type SqlCondition,\n  type SqlPredicate,\n} from \"./queries/conditions.ts\";\n// Domain aliases belong to em.find; physical table expressions belong to em.query/em.execute.\nexport {\n  alias,\n  aliases,\n  getAliasMetadata,\n  getAliasMgmt,\n  getMaybeCtiAlias,\n  isAlias,\n  newAliasProxy,\n  type Alias,\n  type AliasBrand,\n  type AliasMgmt,\n  type AliasColumn,\n  type EntityAlias,\n  type PolyAlias,\n  type PrimitiveAlias,\n} from \"./queries/find/Aliases.ts\";\nexport {\n  table,\n  tables,\n  tableMgmt,\n  getTableMetadata,\n  getTableMgmt,\n  isTable,\n  newTableProxy,\n  type Table,\n  type TableFilter,\n  type TableBrand,\n  type TableFor,\n  type TableMgmt,\n  type ReferenceJoin,\n  type PrimitiveColumn,\n  type EntityColumn,\n  type ReferenceColumn,\n  type CollectionJoin,\n  type PolyReference,\n} from \"./queries/sql/Tables.ts\";\nexport { BaseEntity, getInstanceData } from \"./BaseEntity.ts\";\nexport { ConditionBuilder } from \"./queries/ConditionBuilder.ts\";\nexport { type Entity, type IdType, isEntity } from \"./Entity.ts\";\nexport type * from \"./EntityFields.ts\";\nexport * from \"./queries/find/EntityFilter.ts\";\nexport * from \"./queries/find/EntityGraphQLFilter.ts\";\nexport * from \"./EntityManager.ts\";\nexport * from \"./EntityMetadata.ts\";\nexport type {\n  DeleteStatement,\n  ExecuteResult,\n  InsertStatement,\n  InsertValues,\n  MutationReturning,\n  MutationStatement,\n  UpdateStatement,\n  UpdateValues,\n} from \"./queries/sql/execute.ts\";\nexport type { EnumMetadata } from \"./EnumMetadata.ts\";\n// `em.query`'s expression surface. Only the user-facing types are re-exported: the runtime half\n// (BaseExpr, asNode, deferredCondition, the FnExpr/TemplateExpr node classes) stays internal to\n// joist-core, so `toSql`/`decode`/`encode` never show up as something a user could call.\nexport {\n  type ArrayAggOptions,\n  type Expr,\n  type ExprBrand,\n  exprBrand,\n  type ExprLike,\n  type InnerJoin,\n  type LeftJoin,\n} from \"./queries/sql/Expr.ts\";\nexport {\n  expr,\n  type CaseElse,\n  type CaseWhen,\n  type ExprFromInput,\n  type ExprInput,\n} from \"./queries/sql/expressions/expression.ts\";\nexport { skipCondition } from \"./queries/skipCondition.ts\";\nexport type { EntityOrId, HintNode } from \"./HintTree.ts\";\nexport { InstanceData } from \"./InstanceData.ts\";\nexport { type JoinColumnValue, type JoinRow, JoinRowOperation, type ManyToManyLike } from \"./JoinRows.ts\";\nexport type * from \"./PendingChanges.ts\";\nexport { Plugin } from \"./PluginManager.ts\";\nexport * from \"./queries/find/QueryParser.ts\";\nexport * from \"./queries/find/buildFindQuery.ts\";\nexport * from \"./queries/renderConditions.ts\";\nexport type {\n  ColumnCondition,\n  ExistsCondition,\n  ParsedExpressionCondition,\n  ParsedExpressionFilter,\n  ParsedValueFilter,\n  RawCondition,\n} from \"./queries/parsedConditions.ts\";\nexport {\n  type ParsedEntityFilter,\n  makeLike,\n  mapToDb,\n  parseEntityFilter,\n  parseValueFilter,\n} from \"./queries/valueFilters.ts\";\nexport {\n  filterSoftDeletes,\n  lazyExcludedSelects,\n  maybeAddNotSoftDeleted,\n  stiSubtypeFilter,\n} from \"./queries/entityQueryUtils.ts\";\nexport * from \"./queries/find/QueryParser.collectionJoins.ts\";\nexport { visitConditions } from \"./queries/find/QueryVisitor.ts\";\nexport * from \"./RowData.ts\";\nexport { type JoinRowTodo, Todo } from \"./Todo.ts\";\nexport * from \"./changes.ts\";\nexport { ConfigApi, type EntityHook, resetBootFlag } from \"./config.ts\";\nexport {\n  configureMetadata,\n  getConstructorFromTaggedId,\n  getMetadataForTable,\n  getMetadataForType,\n  maybeGetConstructorFromReference,\n} from \"./configure.ts\";\nexport { driverApi } from \"./driverApi.ts\";\nexport * from \"./drivers/index.ts\";\nexport { getField, isChangeableField, isFieldSet, setField } from \"./fields.ts\";\nexport * from \"./getProperties.ts\";\nexport * from \"./json.ts\";\nexport * from \"./keys.ts\";\nexport { kq, kqDot, kqStar } from \"./queries/sql/keywords.ts\";\nexport {\n  assertLoaded,\n  type DeepNew,\n  ensureLoaded,\n  isLoaded,\n  isNew,\n  type Loadable,\n  type Loaded,\n  type LoadHint,\n  type MarkLoaded,\n  maybePopulateThen,\n  type NestedLoadHint,\n  type New,\n  type RelationsIn,\n  unsafeLoaded,\n} from \"./loadHints.ts\";\nexport * from \"./loadLens.ts\";\nexport { setFactoryWriter } from \"./logging/FactoryLogger.ts\";\nexport * from \"./logging/FieldLogger.ts\";\nexport { ReactionLogger, setReactionLogging } from \"./logging/ReactionLogger.ts\";\nexport { lazyField } from \"./newEntity.ts\";\nexport {\n  defaultValue,\n  factories,\n  type FactoryEntityOpt,\n  type FactoryOpts,\n  getTestIndex,\n  isFactoryCreation,\n  maybeBranchValue,\n  maybeNew,\n  maybeNewPoly,\n  newTestInstance,\n  noValue,\n  setFactoryLogging,\n  testIndex,\n} from \"./newTestInstance.ts\";\nexport { deepNormalizeHint, normalizeHint } from \"./normalizeHints.ts\";\nexport { ImmutableEntitiesPlugin } from \"./plugins/ImmutableEntitiesPlugin.ts\";\nexport type { JoinResult, PreloadHydrator, PreloadPlugin } from \"./plugins/PreloadPlugin.ts\";\nexport { JsonAggregatePreloader } from \"./preloading/JsonAggregatePreloader.ts\";\n// `em.query`'s query surface; the parse pipeline (SubqueryHandle, parseUserQuery, Plan) stays internal\nexport {\n  type CheckScope,\n  type Clauses,\n  type EntityQuery,\n  type ExpressionOrderBy,\n  type ExistsQuery,\n  entityQueryBrand,\n  type MaybeNull,\n  type NameOf,\n  type NotWidened,\n  type OrderByDirection,\n  type OrderByKeys,\n  type Query,\n  type QueryArg,\n  type QueryCondition,\n  type QueryJoin,\n  type QueryJoins,\n  type QueryRow,\n  type QuerySelect,\n  type QuerySource,\n  type QueryValue,\n  recursiveQuery,\n  type RecursiveOptions,\n  type ScalarQuery,\n  type SetQuery,\n  query,\n  queryMaybe,\n  sql,\n  type Subquery,\n  type SubqueryBrand,\n  subqueryBrand,\n  type WithInput,\n  type WithSource,\n} from \"./queries/sql/query.ts\";\nexport {\n  convertToLoadHint,\n  isTypeOrSubType,\n  type Reactable,\n  type Reacted,\n  type ReactiveHint,\n  type ReactiveTarget,\n  reverseReactiveHint,\n} from \"./reactiveHints.ts\";\nexport * from \"./relations/index.ts\";\nexport {\n  cannotBeChanged,\n  cannotBeUpdated,\n  type GenericError,\n  maxValueRule,\n  minValueRule,\n  mustBeSubType,\n  newRequiredLazyFieldRule,\n  newRequiredRule,\n  rangeValueRule,\n  ValidationCode,\n  type ValidationError,\n  ValidationErrors,\n  type ValidationRule,\n  type ValidationRuleInternal,\n  type ValidationRuleResult,\n} from \"./rules.ts\";\nexport { getRuntimeConfig, setRuntimeConfig, type RuntimeConfig } from \"./runtimeConfig.ts\";\nexport { nowUTC } from \"./nowUTC.ts\";\nexport * from \"./serde.ts\";\nexport * from \"./columns.ts\";\nexport * from \"./fieldSerde.ts\";\nexport * from \"./queries/find/scopes.ts\";\nexport { maybeRequireTemporal, requireTemporal, Temporal } from \"./temporal.ts\";\nexport * from \"./temporalMappers.ts\";\nexport { isInTrustedContext, runInTrustedContext } from \"./trusted.ts\";\nexport type * from \"./typeMap.ts\";\nexport { buildUnnestCte, ensureRectangularArraySizes } from \"./unnest.ts\";\nexport { type DeepPartialOrNull, updatePartial, upsert } from \"./upsert.ts\";\nexport {\n  abbreviation,\n  asNew,\n  assertNever,\n  cleanSql,\n  cleanStringValue,\n  fail,\n  failIfAnyRejected,\n  indexBy,\n  partition,\n  zeroTo,\n} from \"./utils.ts\";\nexport { ensureWithLoaded, StubbedRelation, type WithLoaded, withLoaded } from \"./withLoaded.ts\";\n\n// https://spin.atomicobject.com/2018/01/15/typescript-flexible-nominal-typing/\ninterface Flavoring<FlavorT> {\n  _type?: FlavorT;\n}\n\nexport type Flavor<T, FlavorT> = T & Flavoring<FlavorT>;\n\n/**\n * Sets each value in `values` on the current entity.\n *\n * The default behavior is that passing a value as either `null` or `undefined` will set\n * the field as `undefined`, i.e. automatic `null` to `undefined` conversion.\n *\n * However, if you pass `ignoreUndefined: true`, then any opt that is `undefined` will be treated\n * as \"do not set\", and `null` will still mean \"set to `undefined`\". This is useful for implementing\n * APIs were an input of `undefined` means \"do not set / noop\" and `null` means \"unset\".\n *\n * Note that constructors _always_ call this method, but if the call is coming from `em.hydrate`, we\n * use `values` being a primary key to short-circuit and let hydration callers assign the values\n * returned by the serde `fromRow` methods.\n */\nexport function setOpts<T extends Entity>(\n  entity: T,\n  values: Partial<OptsOf<T>> | undefined,\n  opts?: { partial?: boolean; calledFromConstructor?: boolean },\n): void {\n  const { calledFromConstructor = false, partial } = opts || {};\n  // If `values` is undefined, we're being called by `createPartial` that will do its\n  // own opt handling, but we still want the sync defaults applied after this opts handling.\n  if (values !== undefined) {\n    const meta = getMetadata(entity);\n    for (const [key, _value] of Object.entries(values as {})) {\n      setOpt(meta, entity, key, _value, partial, calledFromConstructor);\n    }\n  }\n}\n\n/**\n * Applies some standard behavior & protections to `entity[key] = value`. I.e.\n *\n * - We don't set over AsyncProperties/relations/etc., and instead call current.set(value)\n * - We catch missing/invalid field names\n * - We handle FactoryInitialValues\n */\nexport function setOpt<T extends Entity>(\n  meta: EntityMetadata<T>,\n  entity: T,\n  key: string,\n  _value: any,\n  partial = false,\n  calledFromConstructor = false,\n): void {\n  const field = meta.allFields[key];\n  if (!field) {\n    // Allow setting non-field properties like fullName setters\n    const prop = getProperties(meta)[key];\n    if (!prop) {\n      throw new Error(`Unknown field ${key}`);\n    }\n  }\n\n  // If partial is set, we treat undefined as a noop\n  if (partial && _value === undefined) return;\n  // Ignore the STI discriminator, em.register will set this accordingly\n  if (meta.inheritanceType === \"sti\" && getBaseMeta(meta).stiDiscriminatorField === key) return;\n\n  // We let optional opts fields be `| null` for convenience, and convert to undefined.\n  const value = _value === null ? undefined : _value;\n\n  // Use `getField` to side-step `id` blowing up on new entities that are setting an\n  // explicit id; otherwise use `entity[key]` to get back the relation.\n  const current = key === \"id\" ? getField(entity, key) : (entity as any)[key];\n\n  if (current instanceof AbstractRelationImpl) {\n    if (calledFromConstructor) {\n      current.setFromOpts(value);\n    } else {\n      current.set(value);\n    }\n  } else if (isLazyField(current)) {\n    current.set(value);\n  } else if (isProperty(current) || isAsyncProperty(current) || isReactiveGetter(current)) {\n    throw new Error(`Invalid argument, cannot set over ${key} ${current.constructor.name}`);\n  } else if (isReactiveField(current) || isAsyncReactiveField(current)) {\n    if (value instanceof FactoryInitialValue) {\n      if (current instanceof ReactiveFieldImpl) {\n        current.setFactoryValue(value.value);\n      } else if (current instanceof AsyncReactiveFieldImpl) {\n        current.setFactoryValue(value.value);\n      } else {\n        throw new Error(`Unhandled case ${current.constructor.name}`);\n      }\n    } else {\n      throw new Error(`Invalid argument, cannot set over ${key} ${current.constructor.name}`);\n    }\n  } else {\n    // If setting an explicit id, go through setField, otherwise use\n    // `entity[key]` to set the value directly to that we go through setters.\n    if (key === \"id\" && entity.isNewEntity) {\n      setField(entity, key, value);\n    } else {\n      (entity as any)[key] = value;\n    }\n  }\n}\n\nexport function ensureNotDeleted(entity: Entity, ignore?: \"pending\"): void {\n  if (entity.isDeletedEntity && (ignore === undefined || getInstanceData(entity).isDeletedAndFlushed)) {\n    fail(`${entity} is marked as deleted`);\n  }\n}\n\n/** Adds `null` to every key in `T` to accept partial-update-style input. */\nexport type PartialOrNull<T> = {\n  [P in keyof T]?: T[P] | null;\n};\n\nexport function getRequiredKeys<T extends Entity>(entity: T): string[];\nexport function getRequiredKeys<T extends Entity>(type: EntityConstructor<T>): string[];\nexport function getRequiredKeys<T extends Entity>(entityOrType: T | EntityConstructor<T>): string[] {\n  return Object.values(getMetadata(entityOrType as any).fields)\n    .filter((f) => f.required)\n    .map((f) => f.fieldName);\n}\n\nexport function getRelations(entity: Entity): AbstractRelationImpl<any, any>[] {\n  return Object.entries(getProperties(getMetadata(entity)))\n    .filter(([, v]) => v instanceof AbstractRelationImpl)\n    .map(([name]) => (entity as any)[name]);\n}\n\nexport function getRelationEntries(entity: Entity): [string, AbstractRelationImpl<any, any>][] {\n  return Object.entries(getProperties(getMetadata(entity)))\n    .filter(([, v]) => v instanceof AbstractRelationImpl)\n    .map(([name]) => [name, (entity as any)[name]]);\n}\n\n/** Casts a \"maybe abstract\" cstr to a concrete cstr when the calling code knows it's safe. */\nexport function asConcreteCstr<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>): EntityConstructor<T> {\n  return cstr as any;\n}\n\n/**\n * Thrown when `.id` is accessed on an entity that does not have an id yet.\n *\n * For Postgres, entities are actually allowed to have ids pre-INSERT, if you call\n * `em.assignNewIds()`. Other databases typically require INSERTs to trigger the auto\n * id assignment.\n */\nexport class NoIdError extends Error {}\n\n/** Throws a `NoIdError` for `entity`, i.e. because `id` was called before being saved. */\nexport function failNoIdYet(entity: string): never {\n  throw new NoIdError(`${entity} has no id yet`);\n}\n\n/**\n * Add a static function since getters can't have type guards.\n *\n * See https://github.com/microsoft/TypeScript/issues/43368\n */\nexport function isNewEntity<T extends Entity>(entity: T): entity is New<T> {\n  return entity.isNewEntity;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { getInstanceData } from \"src/BaseEntity.ts\";\nimport { getDefaultDependencies } from \"src/defaults.ts\";\nimport { type Entity } from \"src/Entity.ts\";\nimport { type EntityConstructor, type MaybeAbstractEntityConstructor } from \"src/EntityManager.ts\";\nimport { type EntityMetadata, getBaseMeta, getMetadata } from \"src/EntityMetadata.ts\";\nimport { getField, setField } from \"src/fields.ts\";\nimport { getProperties } from \"src/getProperties.ts\";\nimport type { New } from \"src/loading/loadHints.ts\";\nimport { isAllSqlPaths } from \"src/loading/loadLens.ts\";\nimport { FactoryInitialValue } from \"src/newTestInstance.ts\";\nimport { partitionHint } from \"src/preloading/partitionHint.ts\";\nimport { buildWhereClause } from \"src/queries/renderConditions.ts\";\nimport { AbstractRelationImpl } from \"src/relations/AbstractRelationImpl.ts\";\nimport { AsyncReactiveFieldImpl } from \"src/relations/AsyncReactiveField.ts\";\nimport {\n  isAsyncProperty,\n  isAsyncReactiveField,\n  isLazyField,\n  isProperty,\n  isReactiveField,\n  isReactiveGetter,\n} from \"src/relations/index.ts\";\nimport { ReactiveFieldImpl } from \"src/relations/ReactiveField.ts\";\nimport { type OptsOf } from \"src/typeMap.ts\";\nimport { fail } from \"src/utils.ts\";\n\nexport const testing = { isAllSqlPaths, getDefaultDependencies, partitionHint };\nexport const internals = { buildWhereClause };\nexport { newPgConnectionConfig } from \"joist-utils\";\nexport { AliasAssigner } from \"src/queries/sql/AliasAssigner.ts\";\nexport {\n  type AndCondition,\n  type ConditionGroup,\n  type DomainPredicate,\n  type OrCondition,\n  type PredicateBrand,\n  type SqlCondition,\n  type SqlPredicate,\n} from \"src/queries/conditions.ts\";\n// Domain aliases belong to em.find; physical table expressions belong to em.query/em.execute.\nexport {\n  alias,\n  aliases,\n  getAliasMetadata,\n  getAliasMgmt,\n  getMaybeCtiAlias,\n  isAlias,\n  newAliasProxy,\n  type Alias,\n  type AliasBrand,\n  type AliasMgmt,\n  type AliasColumn,\n  type EntityAlias,\n  type PolyAlias,\n  type PrimitiveAlias,\n} from \"src/queries/find/Aliases.ts\";\nexport {\n  table,\n  tables,\n  tableMgmt,\n  getTableMetadata,\n  getTableMgmt,\n  isTable,\n  newTableProxy,\n  type Table,\n  type TableFilter,\n  type TableBrand,\n  type TableFor,\n  type TableMgmt,\n  type ReferenceJoin,\n  type PrimitiveColumn,\n  type EntityColumn,\n  type ReferenceColumn,\n  type CollectionJoin,\n  type PolyReference,\n} from \"src/queries/sql/Tables.ts\";\nexport { BaseEntity, getInstanceData } from \"src/BaseEntity.ts\";\nexport { ConditionBuilder } from \"src/queries/ConditionBuilder.ts\";\nexport { type Entity, type IdType, isEntity } from \"src/Entity.ts\";\nexport type * from \"src/EntityFields.ts\";\nexport * from \"src/queries/find/EntityFilter.ts\";\nexport * from \"src/queries/find/EntityGraphQLFilter.ts\";\nexport * from \"src/EntityManager.ts\";\nexport * from \"src/EntityMetadata.ts\";\nexport type {\n  DeleteStatement,\n  ExecuteResult,\n  InsertStatement,\n  InsertValues,\n  MutationReturning,\n  MutationStatement,\n  UpdateStatement,\n  UpdateValues,\n} from \"src/queries/sql/execute.ts\";\nexport type { EnumMetadata } from \"src/EnumMetadata.ts\";\n// `em.query`'s expression surface. Only the user-facing types are re-exported: the runtime half\n// (BaseExpr, asNode, deferredCondition, the FnExpr/TemplateExpr node classes) stays internal to\n// joist-core, so `toSql`/`decode`/`encode` never show up as something a user could call.\nexport {\n  type ArrayAggOptions,\n  type Expr,\n  type ExprBrand,\n  exprBrand,\n  type ExprLike,\n  type InnerJoin,\n  type LeftJoin,\n} from \"src/queries/sql/Expr.ts\";\nexport {\n  expr,\n  type CaseElse,\n  type CaseWhen,\n  type ExprFromInput,\n  type ExprInput,\n} from \"src/queries/sql/expressions/expression.ts\";\nexport { skipCondition } from \"src/queries/skipCondition.ts\";\nexport type { EntityOrId, HintNode } from \"src/loading/HintTree.ts\";\nexport { InstanceData } from \"src/InstanceData.ts\";\nexport { type JoinColumnValue, type JoinRow, JoinRowOperation, type ManyToManyLike } from \"src/flush/JoinRows.ts\";\nexport type * from \"src/flush/PendingChanges.ts\";\nexport { Plugin } from \"src/PluginManager.ts\";\nexport * from \"src/queries/find/QueryParser.ts\";\nexport * from \"src/queries/find/buildFindQuery.ts\";\nexport * from \"src/queries/renderConditions.ts\";\nexport type {\n  ColumnCondition,\n  ExistsCondition,\n  ParsedExpressionCondition,\n  ParsedExpressionFilter,\n  ParsedValueFilter,\n  RawCondition,\n} from \"src/queries/parsedConditions.ts\";\nexport {\n  type ParsedEntityFilter,\n  makeLike,\n  mapToDb,\n  parseEntityFilter,\n  parseValueFilter,\n} from \"src/queries/valueFilters.ts\";\nexport {\n  filterSoftDeletes,\n  lazyExcludedSelects,\n  maybeAddNotSoftDeleted,\n  stiSubtypeFilter,\n} from \"src/queries/entityQueryUtils.ts\";\nexport * from \"src/queries/find/QueryParser.collectionJoins.ts\";\nexport { visitConditions } from \"src/queries/find/QueryVisitor.ts\";\nexport * from \"src/RowData.ts\";\nexport { type JoinRowTodo, Todo } from \"src/flush/Todo.ts\";\nexport * from \"src/changes.ts\";\nexport { ConfigApi, type EntityHook, resetBootFlag } from \"src/config.ts\";\nexport {\n  configureMetadata,\n  getConstructorFromTaggedId,\n  getMetadataForTable,\n  getMetadataForType,\n  maybeGetConstructorFromReference,\n} from \"src/configure.ts\";\nexport { driverApi } from \"src/drivers/driverApi.ts\";\nexport * from \"src/drivers/index.ts\";\nexport { getField, isChangeableField, isFieldSet, setField } from \"src/fields.ts\";\nexport * from \"src/getProperties.ts\";\nexport * from \"src/json.ts\";\nexport * from \"src/keys.ts\";\nexport { kq, kqDot, kqStar } from \"src/queries/sql/keywords.ts\";\nexport {\n  assertLoaded,\n  type DeepNew,\n  ensureLoaded,\n  isLoaded,\n  isNew,\n  type Loadable,\n  type Loaded,\n  type LoadHint,\n  type MarkLoaded,\n  maybePopulateThen,\n  type NestedLoadHint,\n  type New,\n  type RelationsIn,\n  unsafeLoaded,\n} from \"src/loading/loadHints.ts\";\nexport * from \"src/loading/loadLens.ts\";\nexport { setFactoryWriter } from \"src/logging/FactoryLogger.ts\";\nexport * from \"src/logging/FieldLogger.ts\";\nexport { ReactionLogger, setReactionLogging } from \"src/logging/ReactionLogger.ts\";\nexport { lazyField } from \"src/newEntity.ts\";\nexport {\n  defaultValue,\n  factories,\n  type FactoryEntityOpt,\n  type FactoryOpts,\n  getTestIndex,\n  isFactoryCreation,\n  maybeBranchValue,\n  maybeNew,\n  maybeNewPoly,\n  newTestInstance,\n  noValue,\n  setFactoryLogging,\n  testIndex,\n} from \"src/newTestInstance.ts\";\nexport { deepNormalizeHint, normalizeHint } from \"src/normalizeHints.ts\";\nexport { ImmutableEntitiesPlugin } from \"src/plugins/ImmutableEntitiesPlugin.ts\";\nexport type { JoinResult, PreloadHydrator, PreloadPlugin } from \"src/plugins/PreloadPlugin.ts\";\nexport { JsonAggregatePreloader } from \"src/preloading/JsonAggregatePreloader.ts\";\n// `em.query`'s query surface; the parse pipeline (SubqueryHandle, parseUserQuery, Plan) stays internal\nexport {\n  type CheckScope,\n  type Clauses,\n  type EntityQuery,\n  type ExpressionOrderBy,\n  type ExistsQuery,\n  entityQueryBrand,\n  type MaybeNull,\n  type NameOf,\n  type NotWidened,\n  type OrderByDirection,\n  type OrderByKeys,\n  type Query,\n  type QueryArg,\n  type QueryCondition,\n  type QueryJoin,\n  type QueryJoins,\n  type QueryRow,\n  type QuerySelect,\n  type QuerySource,\n  type QueryValue,\n  recursiveQuery,\n  type RecursiveOptions,\n  type ScalarQuery,\n  type SetQuery,\n  query,\n  queryMaybe,\n  sql,\n  type Subquery,\n  type SubqueryBrand,\n  subqueryBrand,\n  type WithInput,\n  type WithSource,\n} from \"src/queries/sql/query.ts\";\nexport {\n  convertToLoadHint,\n  isTypeOrSubType,\n  type Reactable,\n  type Reacted,\n  type ReactiveHint,\n  type ReactiveTarget,\n  reverseReactiveHint,\n} from \"src/reactivity/reactiveHints.ts\";\nexport * from \"src/relations/index.ts\";\nexport {\n  cannotBeChanged,\n  cannotBeUpdated,\n  type GenericError,\n  maxValueRule,\n  minValueRule,\n  mustBeSubType,\n  newRequiredLazyFieldRule,\n  newRequiredRule,\n  rangeValueRule,\n  ValidationCode,\n  type ValidationError,\n  ValidationErrors,\n  type ValidationRule,\n  type ValidationRuleInternal,\n  type ValidationRuleResult,\n} from \"src/rules.ts\";\nexport { getRuntimeConfig, setRuntimeConfig, type RuntimeConfig } from \"src/runtimeConfig.ts\";\nexport { nowUTC } from \"src/nowUTC.ts\";\nexport * from \"src/serde/serde.ts\";\nexport * from \"src/serde/columns.ts\";\nexport * from \"src/serde/fieldSerde.ts\";\nexport * from \"src/queries/find/scopes.ts\";\nexport { maybeRequireTemporal, requireTemporal, Temporal } from \"src/serde/temporal.ts\";\nexport * from \"src/serde/temporalMappers.ts\";\nexport { isInTrustedContext, runInTrustedContext } from \"src/trusted.ts\";\nexport type * from \"src/typeMap.ts\";\nexport { buildUnnestCte, ensureRectangularArraySizes } from \"src/queries/unnest.ts\";\nexport { type DeepPartialOrNull, updatePartial, upsert } from \"src/upsert.ts\";\nexport {\n  abbreviation,\n  asNew,\n  assertNever,\n  cleanSql,\n  cleanStringValue,\n  fail,\n  failIfAnyRejected,\n  indexBy,\n  partition,\n  zeroTo,\n} from \"src/utils.ts\";\nexport { ensureWithLoaded, StubbedRelation, type WithLoaded, withLoaded } from \"src/loading/withLoaded.ts\";\n\n// https://spin.atomicobject.com/2018/01/15/typescript-flexible-nominal-typing/\ninterface Flavoring<FlavorT> {\n  _type?: FlavorT;\n}\n\nexport type Flavor<T, FlavorT> = T & Flavoring<FlavorT>;\n\n/**\n * Sets each value in `values` on the current entity.\n *\n * The default behavior is that passing a value as either `null` or `undefined` will set\n * the field as `undefined`, i.e. automatic `null` to `undefined` conversion.\n *\n * However, if you pass `ignoreUndefined: true`, then any opt that is `undefined` will be treated\n * as \"do not set\", and `null` will still mean \"set to `undefined`\". This is useful for implementing\n * APIs were an input of `undefined` means \"do not set / noop\" and `null` means \"unset\".\n *\n * Note that constructors _always_ call this method, but if the call is coming from `em.hydrate`, we\n * use `values` being a primary key to short-circuit and let hydration callers assign the values\n * returned by the serde `fromRow` methods.\n */\nexport function setOpts<T extends Entity>(\n  entity: T,\n  values: Partial<OptsOf<T>> | undefined,\n  opts?: { partial?: boolean; calledFromConstructor?: boolean },\n): void {\n  const { calledFromConstructor = false, partial } = opts || {};\n  // If `values` is undefined, we're being called by `createPartial` that will do its\n  // own opt handling, but we still want the sync defaults applied after this opts handling.\n  if (values !== undefined) {\n    const meta = getMetadata(entity);\n    for (const [key, _value] of Object.entries(values as {})) {\n      setOpt(meta, entity, key, _value, partial, calledFromConstructor);\n    }\n  }\n}\n\n/**\n * Applies some standard behavior & protections to `entity[key] = value`. I.e.\n *\n * - We don't set over AsyncProperties/relations/etc., and instead call current.set(value)\n * - We catch missing/invalid field names\n * - We handle FactoryInitialValues\n */\nexport function setOpt<T extends Entity>(\n  meta: EntityMetadata<T>,\n  entity: T,\n  key: string,\n  _value: any,\n  partial = false,\n  calledFromConstructor = false,\n): void {\n  const field = meta.allFields[key];\n  if (!field) {\n    // Allow setting non-field properties like fullName setters\n    const prop = getProperties(meta)[key];\n    if (!prop) {\n      throw new Error(`Unknown field ${key}`);\n    }\n  }\n\n  // If partial is set, we treat undefined as a noop\n  if (partial && _value === undefined) return;\n  // Ignore the STI discriminator, em.register will set this accordingly\n  if (meta.inheritanceType === \"sti\" && getBaseMeta(meta).stiDiscriminatorField === key) return;\n\n  // We let optional opts fields be `| null` for convenience, and convert to undefined.\n  const value = _value === null ? undefined : _value;\n\n  // Use `getField` to side-step `id` blowing up on new entities that are setting an\n  // explicit id; otherwise use `entity[key]` to get back the relation.\n  const current = key === \"id\" ? getField(entity, key) : (entity as any)[key];\n\n  if (current instanceof AbstractRelationImpl) {\n    if (calledFromConstructor) {\n      current.setFromOpts(value);\n    } else {\n      current.set(value);\n    }\n  } else if (isLazyField(current)) {\n    current.set(value);\n  } else if (isProperty(current) || isAsyncProperty(current) || isReactiveGetter(current)) {\n    throw new Error(`Invalid argument, cannot set over ${key} ${current.constructor.name}`);\n  } else if (isReactiveField(current) || isAsyncReactiveField(current)) {\n    if (value instanceof FactoryInitialValue) {\n      if (current instanceof ReactiveFieldImpl) {\n        current.setFactoryValue(value.value);\n      } else if (current instanceof AsyncReactiveFieldImpl) {\n        current.setFactoryValue(value.value);\n      } else {\n        throw new Error(`Unhandled case ${current.constructor.name}`);\n      }\n    } else {\n      throw new Error(`Invalid argument, cannot set over ${key} ${current.constructor.name}`);\n    }\n  } else {\n    // If setting an explicit id, go through setField, otherwise use\n    // `entity[key]` to set the value directly to that we go through setters.\n    if (key === \"id\" && entity.isNewEntity) {\n      setField(entity, key, value);\n    } else {\n      (entity as any)[key] = value;\n    }\n  }\n}\n\nexport function ensureNotDeleted(entity: Entity, ignore?: \"pending\"): void {\n  if (entity.isDeletedEntity && (ignore === undefined || getInstanceData(entity).isDeletedAndFlushed)) {\n    fail(`${entity} is marked as deleted`);\n  }\n}\n\n/** Adds `null` to every key in `T` to accept partial-update-style input. */\nexport type PartialOrNull<T> = {\n  [P in keyof T]?: T[P] | null;\n};\n\nexport function getRequiredKeys<T extends Entity>(entity: T): string[];\nexport function getRequiredKeys<T extends Entity>(type: EntityConstructor<T>): string[];\nexport function getRequiredKeys<T extends Entity>(entityOrType: T | EntityConstructor<T>): string[] {\n  return Object.values(getMetadata(entityOrType as any).fields)\n    .filter((f) => f.required)\n    .map((f) => f.fieldName);\n}\n\nexport function getRelations(entity: Entity): AbstractRelationImpl<any, any>[] {\n  return Object.entries(getProperties(getMetadata(entity)))\n    .filter(([, v]) => v instanceof AbstractRelationImpl)\n    .map(([name]) => (entity as any)[name]);\n}\n\nexport function getRelationEntries(entity: Entity): [string, AbstractRelationImpl<any, any>][] {\n  return Object.entries(getProperties(getMetadata(entity)))\n    .filter(([, v]) => v instanceof AbstractRelationImpl)\n    .map(([name]) => [name, (entity as any)[name]]);\n}\n\n/** Casts a \"maybe abstract\" cstr to a concrete cstr when the calling code knows it's safe. */\nexport function asConcreteCstr<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>): EntityConstructor<T> {\n  return cstr as any;\n}\n\n/**\n * Thrown when `.id` is accessed on an entity that does not have an id yet.\n *\n * For Postgres, entities are actually allowed to have ids pre-INSERT, if you call\n * `em.assignNewIds()`. Other databases typically require INSERTs to trigger the auto\n * id assignment.\n */\nexport class NoIdError extends Error {}\n\n/** Throws a `NoIdError` for `entity`, i.e. because `id` was called before being saved. */\nexport function failNoIdYet(entity: string): never {\n  throw new NoIdError(`${entity} has no id yet`);\n}\n\n/**\n * Add a static function since getters can't have type guards.\n *\n * See https://github.com/microsoft/TypeScript/issues/43368\n */\nexport function isNewEntity<T extends Entity>(entity: T): entity is New<T> {\n  return entity.isNewEntity;\n}\n"],"mappings":"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"}

package/build/json.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_relations_AbstractRelationImpl = require("./relations/AbstractRelationImpl.cjs");
-const require_relations_hasProperty = require("./relations/hasProperty.cjs");
-const require_relations_ReactiveGetter = require("./relations/ReactiveGetter.cjs");
-const require_reactiveHints = require("./reactiveHints.cjs");
 const require_normalizeHints = require("./normalizeHints.cjs");
+const require_relations_ReactiveGetter = require("./relations/ReactiveGetter.cjs");
+const require_reactivity_reactiveHints = require("./reactivity/reactiveHints.cjs");
+const require_relations_hasProperty = require("./relations/hasProperty.cjs");
 const require_relations_ReactiveField = require("./relations/ReactiveField.cjs");
 const require_relations_AsyncReactiveField = require("./relations/AsyncReactiveField.cjs");
 require("./relations/index.cjs");
@@ -14,7 +14,7 @@ const require_Entity = require("./Entity.cjs");
 async function toJSON(entityOrList, hint) {
 	if (Array.isArray(entityOrList) && entityOrList.length === 0) return [];
 	const entity = Array.isArray(entityOrList) ? entityOrList[0] : entityOrList;
-	const loadHint = require_reactiveHints.convertToLoadHint(require_EntityMetadata.getMetadata(entity), hint, true);
+	const loadHint = require_reactivity_reactiveHints.convertToLoadHint(require_EntityMetadata.getMetadata(entity), hint, true);
 	await entity.em.populate(entityOrList, loadHint);
 	const normHint = require_normalizeHints.normalizeHint(hint);
 	if (Array.isArray(entityOrList)) {

package/build/json.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"json.cjs","names":["convertToLoadHint","getMetadata","normalizeHint","AbstractRelationImpl","ReactiveFieldImpl","ReactiveGetterImpl","AsyncReactiveFieldImpl","PropertyImpl","isEntity"],"sources":["../src/json.ts"],"sourcesContent":["import { type Entity, isEntity } from \"./Entity.ts\";\nimport { type IdOf } from \"./EntityManager.ts\";\nimport { getMetadata } from \"./EntityMetadata.ts\";\nimport { normalizeHint } from \"./normalizeHints.ts\";\nimport { convertToLoadHint } from \"./reactiveHints.ts\";\nimport { AbstractRelationImpl } from \"./relations/AbstractRelationImpl.ts\";\nimport { AsyncReactiveFieldImpl } from \"./relations/AsyncReactiveField.ts\";\nimport { PropertyImpl } from \"./relations/hasProperty.ts\";\nimport {\n  type AsyncMethod,\n  type Collection,\n  type Property,\n  type ReactiveGetter,\n  type Reference,\n} from \"./relations/index.ts\";\nimport { ReactiveFieldImpl } from \"./relations/ReactiveField.ts\";\nimport { ReactiveGetterImpl } from \"./relations/ReactiveGetter.ts\";\n\n/**\n * A JSON hint of a single key, multiple keys, or nested keys and sub-hints.\n *\n * JSON hints are much like load hints/reactive hints:\n *\n * - Similar to load hints, they specify which relations should be loaded from the database\n * - Similar to reactive hints, they include specific fields to output\n * - Unlike either, they can include completely custom keys that are lambdas to generate custom values\n */\nexport type JsonHint<T extends Entity> =\n  | (keyof Jsonable<T> & string)\n  | ReadonlyArray<keyof Jsonable<T> & string>\n  | NestedJsonHint<T>;\n\n/** For object literal/nested hints, we allow mapping both entity keys 1:1 & custom keys via a lambdas. */\nexport type NestedJsonHint<T extends Entity> = EntityKeyJsonHint<T> | CustomJsonKeyHint<T>;\n\n/** Foreach `Jsonable` key, we can provide a sub-hint, or just a boolean to include/exclude. */\nexport type EntityKeyJsonHint<T extends Entity> = {\n  // The `as K` makes `bookIds` as a hint work...\n  [K in keyof Jsonable<T> as `${K}`]?: (Jsonable<T>[K] extends infer U extends Entity ? JsonHint<U> : {}) | boolean;\n};\n\nexport type CustomJsonKeyHint<T> = {\n  [key: string]: (entity: T) => any;\n};\n\n/**\n * Describes the JSON payload for `Entity.toJSON` to produce.\n *\n * - `[\"firstName\", \"lastName\"]` will produce a JSON payload with just those fields\n * - `{ author: { books: \"title\" } }` will produce a JSON payload with the author's books' titles\n *\n * We only accept object literals & arrays to `toJSON` to avoid a `JSON.stringify` oddity.\n */\nexport type ToJsonHint<T extends Entity> = NestedJsonHint<T> | ReadonlyArray<keyof Jsonable<T> & string>;\n\n/** The keys in `T` that we can put into a JSON payload. */\nexport type Jsonable<T extends Entity> = {\n  -readonly [K in keyof T as JsonableValue<T[K]> extends never ? never : K]: JsonableValue<T[K]>;\n};\n\n// this should probably be `keyof T` as long as they aren't methods/AsyncMethods.\n// so primitives, enums, references, collections, async properties, but also random getters.\nexport type JsonableValue<V> =\n  V extends Reference<any, infer U, any>\n    ? U\n    : V extends Collection<any, infer U>\n      ? U\n      : V extends AsyncMethod<any, any, any>\n        ? never\n        : V extends Property<any, infer P>\n          ? DropUndefined<P>\n          : V extends ReactiveGetter<any, infer P>\n            ? P\n            : V;\n\n/**\n * Provides an API to put an entity, or list of entities, into a JSON payload.\n *\n * The `hint` parameter is a JSON hint that describes what to include in the payload,\n *\n * - fields like `id`, `name`, etc.\n * - relations like m2o, o2m, m2m, and o2o\n *   - relations are allowed to provide nested hints, just like nested load hints\n * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`\n */\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entity: T,\n  hint: H,\n): Promise<JsonPayload<T, H>>;\n\n/**\n * Provides an API to put an entity, or list of entities, into a JSON payload.\n *\n * The `hint` parameter is a JSON hint that describes what to include in the payload,\n *\n * - fields like `id`, `name`, etc.\n * - relations like m2o, o2m, m2m, and o2o\n *   - relations are allowed to provide nested hints, just like nested load hints\n * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`\n */\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entities: readonly T[],\n  hint: H,\n): Promise<JsonPayload<T, H>[]>;\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entityOrList: T | readonly T[],\n  hint: H,\n): Promise<JsonPayload<T, H> | JsonPayload<T, H>[]> {\n  // If called with a list, and nothing there, just early return\n  if (Array.isArray(entityOrList) && entityOrList.length === 0) return [];\n\n  // Otherwise probe to get our first entity\n  const entity = Array.isArray(entityOrList) ? entityOrList[0] : entityOrList;\n  const loadHint = convertToLoadHint(getMetadata(entity), hint as any, true);\n  await entity.em.populate(entityOrList, loadHint);\n  const normHint = normalizeHint(hint as any);\n\n  if (Array.isArray(entityOrList)) {\n    const list = [] as any;\n    await Promise.all(\n      entityOrList.map((entity) => {\n        const json = {};\n        list.push(json);\n        return copyToPayload(json, entity, normHint);\n      }),\n    );\n    return list;\n  } else {\n    const json = {};\n    await copyToPayload(json, entity, normHint);\n    return json as any;\n  }\n}\n\n/**\n * Statically types the return value of `toJSON` based on the given `hint`.\n */\nexport type JsonPayload<T, H> = {\n  [HK in keyof NormalizeHint<H> & string]: HK extends keyof T\n    ? JsonPayloadKey<T, H, HK, HK>\n    : HK extends `${infer TK extends string & keyof T}Id`\n      ? JsonPayloadKey<T, H, TK, HK>\n      : HK extends `${infer SK extends string}Ids` // bookIds -> books\n        ? // Very naive singularization to see if the guessed bookIds -> books actually exists on T to map 1:1\n          `${SK}s` extends keyof T\n          ? JsonPayloadKey<T, H, `${SK}s`, HK>\n          : JsonPayloadCustom<NormalizeHint<H>[HK]>\n        : JsonPayloadCustom<NormalizeHint<H>[HK]>;\n};\n\ntype JsonPayloadKey<T, H, TK extends keyof T, HK extends keyof NormalizeHint<H>> =\n  T[TK] extends Reference<any, infer U, any>\n    ? JsonPayloadReference<U, NormalizeHint<H>[HK]>\n    : T[TK] extends Collection<any, infer U>\n      ? JsonPayloadCollection<U, NormalizeHint<H>[HK]>\n      : T[TK] extends Property<any, infer U>\n        ? JsonPayloadProperty<U, NormalizeHint<H>[HK]>\n        : T[TK] extends ReactiveGetter<any, infer V>\n          ? V\n          : T[TK];\n\n// If the hint is empty, we just output the id as a string.\ntype JsonPayloadReference<U, H> = IsEmpty<H> extends true ? string : JsonPayload<U, H>;\n\ntype JsonPayloadCollection<U extends Entity, H> =\n  // If this is `books: true`, use the id\n  H extends true\n    ? IdOf<U>[]\n    : // If this is `{}`, use the id\n      IsEmpty<H> extends true\n      ? IdOf<U>[]\n      : // Otherwise it's a nested hint\n        JsonPayload<U, H>[];\n\ntype JsonPayloadProperty<P, H> =\n  // If an async property returns an entity, treat it like a reference\n  P extends Entity | undefined\n    ? JsonPayloadReference<P, H>\n    : // If an async property returns an entity[], treat it like a collection\n      P extends (infer U extends Entity)[] | undefined\n      ? JsonPayloadCollection<U, H>\n      : // Otherwise leave it as-is\n        P;\n\ntype JsonPayloadCustom<H> = H extends (...args: any) => infer V ? UnwrapPromise<V> : H;\n\ntype UnwrapPromise<T> = T extends Promise<infer U> ? U : T;\n\n/** Recursively copies the fields of `hint` from `entity` into the `payload`. */\nasync function copyToPayload(payload: Record<string, {}>, entity: any, hint: object): Promise<void> {\n  // Look at each key in the hint and determine\n  for (const [payloadKey, nestedHint] of Object.entries(hint)) {\n    const nextHint = normalizeHint(nestedHint);\n    // Watch for `companyId`\n    let entityKey = payloadKey;\n    if (!(entityKey in entity)) {\n      const field = Object.values(getMetadata(entity).allFields).find((f) => f.fieldIdName === payloadKey);\n      if (field) {\n        entityKey = field.fieldName;\n      }\n    }\n    // Look for custom props\n    if (!(entityKey in entity)) {\n      if (typeof nestedHint !== \"function\") {\n        throw new Error(`Entity does not have a property ${payloadKey}`);\n      }\n      payload[payloadKey] = await nestedHint(entity);\n    } else {\n      const value = entity[entityKey];\n      if (isPrimitive(value)) {\n        payload[payloadKey] = value;\n      } else if (\n        value instanceof AbstractRelationImpl ||\n        value instanceof ReactiveFieldImpl ||\n        value instanceof ReactiveGetterImpl ||\n        value instanceof AsyncReactiveFieldImpl ||\n        value instanceof PropertyImpl\n      ) {\n        await copyToPayloadValue(payload, payloadKey, value.get, nextHint);\n      } else {\n        throw new Error(`Unable to encode value ${value} to JSON`);\n      }\n    }\n  }\n}\n\nfunction copyToPayloadValue(payload: any, key: any, value: any, nextHint: any): Promise<unknown> | undefined {\n  if (value === undefined || value === null || isPrimitive(value)) {\n    payload[key] = value;\n  } else if (isEntity(value)) {\n    if (nextHint && Object.keys(nextHint).length > 0) {\n      payload[key] = {};\n      return copyToPayload(payload[key], value, nextHint);\n    } else {\n      payload[key] = value.id;\n    }\n  } else if (Array.isArray(value)) {\n    const list = [] as any[];\n    payload[key] = list;\n    if (nextHint && Object.keys(nextHint).length > 0) {\n      return Promise.all(\n        value.map(async (item, i) => {\n          if (isEntity(item)) {\n            list[i] = {};\n            return copyToPayload(list[i], item, nextHint);\n          } else {\n            // This is probably undefined\n            list[i] = item;\n          }\n        }),\n      );\n    } else {\n      // This is assuming an array of entities...\n      for (const item of value) list.push(item.id);\n    }\n  } else {\n    payload[key] = value;\n  }\n}\n\nfunction isPrimitive(value: any): boolean {\n  return value === null || typeof value !== \"object\";\n}\n\ntype DropUndefined<T> = T extends infer U extends Entity | undefined ? U : T;\n\n// A copy/paste of NormalizeHint w/o the `DropSuffix` stuff\ntype NormalizeHint<H> = H extends string\n  ? Record<H, {}>\n  : H extends ReadonlyArray<any>\n    ? Record<H[number], {}>\n    : { [K in keyof H]: H[K] };\n\ntype IsEmpty<T> = keyof T extends never ? true : false;\n"],"mappings":";;;;;;;;;;;;;AAwGA,eAAsB,OACpB,cACA,MACkD;CAElD,IAAI,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,GAAG,OAAO,CAAC;CAGtE,MAAM,SAAS,MAAM,QAAQ,YAAY,IAAI,aAAa,KAAK;CAC/D,MAAM,WAAWA,sBAAAA,kBAAkBC,uBAAAA,YAAY,MAAM,GAAG,MAAa,IAAI;CACzE,MAAM,OAAO,GAAG,SAAS,cAAc,QAAQ;CAC/C,MAAM,WAAWC,uBAAAA,cAAc,IAAW;CAE1C,IAAI,MAAM,QAAQ,YAAY,GAAG;EAC/B,MAAM,OAAO,CAAC;EACd,MAAM,QAAQ,IACZ,aAAa,KAAK,WAAW;GAC3B,MAAM,OAAO,CAAC;GACd,KAAK,KAAK,IAAI;GACd,OAAO,cAAc,MAAM,QAAQ,QAAQ;EAC7C,CAAC,CACH;EACA,OAAO;CACT,OAAO;EACL,MAAM,OAAO,CAAC;EACd,MAAM,cAAc,MAAM,QAAQ,QAAQ;EAC1C,OAAO;CACT;AACF;;AAyDA,eAAe,cAAc,SAA6B,QAAa,MAA6B;CAElG,KAAK,MAAM,CAAC,YAAY,eAAe,OAAO,QAAQ,IAAI,GAAG;EAC3D,MAAM,WAAWA,uBAAAA,cAAc,UAAU;EAEzC,IAAI,YAAY;EAChB,IAAI,EAAE,aAAa,SAAS;GAC1B,MAAM,QAAQ,OAAO,OAAOD,uBAAAA,YAAY,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,MAAM,EAAE,gBAAgB,UAAU;GACnG,IAAI,OACF,YAAY,MAAM;EAEtB;EAEA,IAAI,EAAE,aAAa,SAAS;GAC1B,IAAI,OAAO,eAAe,YACxB,MAAM,IAAI,MAAM,mCAAmC,YAAY;GAEjE,QAAQ,cAAc,MAAM,WAAW,MAAM;EAC/C,OAAO;GACL,MAAM,QAAQ,OAAO;GACrB,IAAI,YAAY,KAAK,GACnB,QAAQ,cAAc;QACjB,IACL,iBAAiBE,uCAAAA,wBACjB,iBAAiBC,gCAAAA,qBACjB,iBAAiBC,iCAAAA,sBACjB,iBAAiBC,qCAAAA,0BACjB,iBAAiBC,8BAAAA,cAEjB,MAAM,mBAAmB,SAAS,YAAY,MAAM,KAAK,QAAQ;QAEjE,MAAM,IAAI,MAAM,0BAA0B,MAAM,SAAS;EAE7D;CACF;AACF;AAEA,SAAS,mBAAmB,SAAc,KAAU,OAAY,UAA6C;CAC3G,IAAI,UAAU,KAAA,KAAa,UAAU,QAAQ,YAAY,KAAK,GAC5D,QAAQ,OAAO;MACV,IAAIC,eAAAA,SAAS,KAAK,GAAG;EAC1B,IAAI,YAAY,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GAAG;GAChD,QAAQ,OAAO,CAAC;GAChB,OAAO,cAAc,QAAQ,MAAM,OAAO,QAAQ;EACpD,OACE,QAAQ,OAAO,MAAM;CAEzB,OAAO,IAAI,MAAM,QAAQ,KAAK,GAAG;EAC/B,MAAM,OAAO,CAAC;EACd,QAAQ,OAAO;EACf,IAAI,YAAY,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GAC7C,OAAO,QAAQ,IACb,MAAM,IAAI,OAAO,MAAM,MAAM;GAC3B,IAAIA,eAAAA,SAAS,IAAI,GAAG;IAClB,KAAK,KAAK,CAAC;IACX,OAAO,cAAc,KAAK,IAAI,MAAM,QAAQ;GAC9C,OAEE,KAAK,KAAK;EAEd,CAAC,CACH;OAGA,KAAK,MAAM,QAAQ,OAAO,KAAK,KAAK,KAAK,EAAE;CAE/C,OACE,QAAQ,OAAO;AAEnB;AAEA,SAAS,YAAY,OAAqB;CACxC,OAAO,UAAU,QAAQ,OAAO,UAAU;AAC5C"}
+{"version":3,"file":"json.cjs","names":["convertToLoadHint","getMetadata","normalizeHint","AbstractRelationImpl","ReactiveFieldImpl","ReactiveGetterImpl","AsyncReactiveFieldImpl","PropertyImpl","isEntity"],"sources":["../src/json.ts"],"sourcesContent":["import { type Entity, isEntity } from \"src/Entity.ts\";\nimport { type IdOf } from \"src/EntityManager.ts\";\nimport { getMetadata } from \"src/EntityMetadata.ts\";\nimport { normalizeHint } from \"src/normalizeHints.ts\";\nimport { convertToLoadHint } from \"src/reactivity/reactiveHints.ts\";\nimport { AbstractRelationImpl } from \"src/relations/AbstractRelationImpl.ts\";\nimport { AsyncReactiveFieldImpl } from \"src/relations/AsyncReactiveField.ts\";\nimport { PropertyImpl } from \"src/relations/hasProperty.ts\";\nimport {\n  type AsyncMethod,\n  type Collection,\n  type Property,\n  type ReactiveGetter,\n  type Reference,\n} from \"src/relations/index.ts\";\nimport { ReactiveFieldImpl } from \"src/relations/ReactiveField.ts\";\nimport { ReactiveGetterImpl } from \"src/relations/ReactiveGetter.ts\";\n\n/**\n * A JSON hint of a single key, multiple keys, or nested keys and sub-hints.\n *\n * JSON hints are much like load hints/reactive hints:\n *\n * - Similar to load hints, they specify which relations should be loaded from the database\n * - Similar to reactive hints, they include specific fields to output\n * - Unlike either, they can include completely custom keys that are lambdas to generate custom values\n */\nexport type JsonHint<T extends Entity> =\n  | (keyof Jsonable<T> & string)\n  | ReadonlyArray<keyof Jsonable<T> & string>\n  | NestedJsonHint<T>;\n\n/** For object literal/nested hints, we allow mapping both entity keys 1:1 & custom keys via a lambdas. */\nexport type NestedJsonHint<T extends Entity> = EntityKeyJsonHint<T> | CustomJsonKeyHint<T>;\n\n/** Foreach `Jsonable` key, we can provide a sub-hint, or just a boolean to include/exclude. */\nexport type EntityKeyJsonHint<T extends Entity> = {\n  // The `as K` makes `bookIds` as a hint work...\n  [K in keyof Jsonable<T> as `${K}`]?: (Jsonable<T>[K] extends infer U extends Entity ? JsonHint<U> : {}) | boolean;\n};\n\nexport type CustomJsonKeyHint<T> = {\n  [key: string]: (entity: T) => any;\n};\n\n/**\n * Describes the JSON payload for `Entity.toJSON` to produce.\n *\n * - `[\"firstName\", \"lastName\"]` will produce a JSON payload with just those fields\n * - `{ author: { books: \"title\" } }` will produce a JSON payload with the author's books' titles\n *\n * We only accept object literals & arrays to `toJSON` to avoid a `JSON.stringify` oddity.\n */\nexport type ToJsonHint<T extends Entity> = NestedJsonHint<T> | ReadonlyArray<keyof Jsonable<T> & string>;\n\n/** The keys in `T` that we can put into a JSON payload. */\nexport type Jsonable<T extends Entity> = {\n  -readonly [K in keyof T as JsonableValue<T[K]> extends never ? never : K]: JsonableValue<T[K]>;\n};\n\n// this should probably be `keyof T` as long as they aren't methods/AsyncMethods.\n// so primitives, enums, references, collections, async properties, but also random getters.\nexport type JsonableValue<V> =\n  V extends Reference<any, infer U, any>\n    ? U\n    : V extends Collection<any, infer U>\n      ? U\n      : V extends AsyncMethod<any, any, any>\n        ? never\n        : V extends Property<any, infer P>\n          ? DropUndefined<P>\n          : V extends ReactiveGetter<any, infer P>\n            ? P\n            : V;\n\n/**\n * Provides an API to put an entity, or list of entities, into a JSON payload.\n *\n * The `hint` parameter is a JSON hint that describes what to include in the payload,\n *\n * - fields like `id`, `name`, etc.\n * - relations like m2o, o2m, m2m, and o2o\n *   - relations are allowed to provide nested hints, just like nested load hints\n * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`\n */\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entity: T,\n  hint: H,\n): Promise<JsonPayload<T, H>>;\n\n/**\n * Provides an API to put an entity, or list of entities, into a JSON payload.\n *\n * The `hint` parameter is a JSON hint that describes what to include in the payload,\n *\n * - fields like `id`, `name`, etc.\n * - relations like m2o, o2m, m2m, and o2o\n *   - relations are allowed to provide nested hints, just like nested load hints\n * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`\n */\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entities: readonly T[],\n  hint: H,\n): Promise<JsonPayload<T, H>[]>;\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entityOrList: T | readonly T[],\n  hint: H,\n): Promise<JsonPayload<T, H> | JsonPayload<T, H>[]> {\n  // If called with a list, and nothing there, just early return\n  if (Array.isArray(entityOrList) && entityOrList.length === 0) return [];\n\n  // Otherwise probe to get our first entity\n  const entity = Array.isArray(entityOrList) ? entityOrList[0] : entityOrList;\n  const loadHint = convertToLoadHint(getMetadata(entity), hint as any, true);\n  await entity.em.populate(entityOrList, loadHint);\n  const normHint = normalizeHint(hint as any);\n\n  if (Array.isArray(entityOrList)) {\n    const list = [] as any;\n    await Promise.all(\n      entityOrList.map((entity) => {\n        const json = {};\n        list.push(json);\n        return copyToPayload(json, entity, normHint);\n      }),\n    );\n    return list;\n  } else {\n    const json = {};\n    await copyToPayload(json, entity, normHint);\n    return json as any;\n  }\n}\n\n/**\n * Statically types the return value of `toJSON` based on the given `hint`.\n */\nexport type JsonPayload<T, H> = {\n  [HK in keyof NormalizeHint<H> & string]: HK extends keyof T\n    ? JsonPayloadKey<T, H, HK, HK>\n    : HK extends `${infer TK extends string & keyof T}Id`\n      ? JsonPayloadKey<T, H, TK, HK>\n      : HK extends `${infer SK extends string}Ids` // bookIds -> books\n        ? // Very naive singularization to see if the guessed bookIds -> books actually exists on T to map 1:1\n          `${SK}s` extends keyof T\n          ? JsonPayloadKey<T, H, `${SK}s`, HK>\n          : JsonPayloadCustom<NormalizeHint<H>[HK]>\n        : JsonPayloadCustom<NormalizeHint<H>[HK]>;\n};\n\ntype JsonPayloadKey<T, H, TK extends keyof T, HK extends keyof NormalizeHint<H>> =\n  T[TK] extends Reference<any, infer U, any>\n    ? JsonPayloadReference<U, NormalizeHint<H>[HK]>\n    : T[TK] extends Collection<any, infer U>\n      ? JsonPayloadCollection<U, NormalizeHint<H>[HK]>\n      : T[TK] extends Property<any, infer U>\n        ? JsonPayloadProperty<U, NormalizeHint<H>[HK]>\n        : T[TK] extends ReactiveGetter<any, infer V>\n          ? V\n          : T[TK];\n\n// If the hint is empty, we just output the id as a string.\ntype JsonPayloadReference<U, H> = IsEmpty<H> extends true ? string : JsonPayload<U, H>;\n\ntype JsonPayloadCollection<U extends Entity, H> =\n  // If this is `books: true`, use the id\n  H extends true\n    ? IdOf<U>[]\n    : // If this is `{}`, use the id\n      IsEmpty<H> extends true\n      ? IdOf<U>[]\n      : // Otherwise it's a nested hint\n        JsonPayload<U, H>[];\n\ntype JsonPayloadProperty<P, H> =\n  // If an async property returns an entity, treat it like a reference\n  P extends Entity | undefined\n    ? JsonPayloadReference<P, H>\n    : // If an async property returns an entity[], treat it like a collection\n      P extends (infer U extends Entity)[] | undefined\n      ? JsonPayloadCollection<U, H>\n      : // Otherwise leave it as-is\n        P;\n\ntype JsonPayloadCustom<H> = H extends (...args: any) => infer V ? UnwrapPromise<V> : H;\n\ntype UnwrapPromise<T> = T extends Promise<infer U> ? U : T;\n\n/** Recursively copies the fields of `hint` from `entity` into the `payload`. */\nasync function copyToPayload(payload: Record<string, {}>, entity: any, hint: object): Promise<void> {\n  // Look at each key in the hint and determine\n  for (const [payloadKey, nestedHint] of Object.entries(hint)) {\n    const nextHint = normalizeHint(nestedHint);\n    // Watch for `companyId`\n    let entityKey = payloadKey;\n    if (!(entityKey in entity)) {\n      const field = Object.values(getMetadata(entity).allFields).find((f) => f.fieldIdName === payloadKey);\n      if (field) {\n        entityKey = field.fieldName;\n      }\n    }\n    // Look for custom props\n    if (!(entityKey in entity)) {\n      if (typeof nestedHint !== \"function\") {\n        throw new Error(`Entity does not have a property ${payloadKey}`);\n      }\n      payload[payloadKey] = await nestedHint(entity);\n    } else {\n      const value = entity[entityKey];\n      if (isPrimitive(value)) {\n        payload[payloadKey] = value;\n      } else if (\n        value instanceof AbstractRelationImpl ||\n        value instanceof ReactiveFieldImpl ||\n        value instanceof ReactiveGetterImpl ||\n        value instanceof AsyncReactiveFieldImpl ||\n        value instanceof PropertyImpl\n      ) {\n        await copyToPayloadValue(payload, payloadKey, value.get, nextHint);\n      } else {\n        throw new Error(`Unable to encode value ${value} to JSON`);\n      }\n    }\n  }\n}\n\nfunction copyToPayloadValue(payload: any, key: any, value: any, nextHint: any): Promise<unknown> | undefined {\n  if (value === undefined || value === null || isPrimitive(value)) {\n    payload[key] = value;\n  } else if (isEntity(value)) {\n    if (nextHint && Object.keys(nextHint).length > 0) {\n      payload[key] = {};\n      return copyToPayload(payload[key], value, nextHint);\n    } else {\n      payload[key] = value.id;\n    }\n  } else if (Array.isArray(value)) {\n    const list = [] as any[];\n    payload[key] = list;\n    if (nextHint && Object.keys(nextHint).length > 0) {\n      return Promise.all(\n        value.map(async (item, i) => {\n          if (isEntity(item)) {\n            list[i] = {};\n            return copyToPayload(list[i], item, nextHint);\n          } else {\n            // This is probably undefined\n            list[i] = item;\n          }\n        }),\n      );\n    } else {\n      // This is assuming an array of entities...\n      for (const item of value) list.push(item.id);\n    }\n  } else {\n    payload[key] = value;\n  }\n}\n\nfunction isPrimitive(value: any): boolean {\n  return value === null || typeof value !== \"object\";\n}\n\ntype DropUndefined<T> = T extends infer U extends Entity | undefined ? U : T;\n\n// A copy/paste of NormalizeHint w/o the `DropSuffix` stuff\ntype NormalizeHint<H> = H extends string\n  ? Record<H, {}>\n  : H extends ReadonlyArray<any>\n    ? Record<H[number], {}>\n    : { [K in keyof H]: H[K] };\n\ntype IsEmpty<T> = keyof T extends never ? true : false;\n"],"mappings":";;;;;;;;;;;;;AAwGA,eAAsB,OACpB,cACA,MACkD;CAElD,IAAI,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,GAAG,OAAO,CAAC;CAGtE,MAAM,SAAS,MAAM,QAAQ,YAAY,IAAI,aAAa,KAAK;CAC/D,MAAM,WAAWA,iCAAAA,kBAAkBC,uBAAAA,YAAY,MAAM,GAAG,MAAa,IAAI;CACzE,MAAM,OAAO,GAAG,SAAS,cAAc,QAAQ;CAC/C,MAAM,WAAWC,uBAAAA,cAAc,IAAW;CAE1C,IAAI,MAAM,QAAQ,YAAY,GAAG;EAC/B,MAAM,OAAO,CAAC;EACd,MAAM,QAAQ,IACZ,aAAa,KAAK,WAAW;GAC3B,MAAM,OAAO,CAAC;GACd,KAAK,KAAK,IAAI;GACd,OAAO,cAAc,MAAM,QAAQ,QAAQ;EAC7C,CAAC,CACH;EACA,OAAO;CACT,OAAO;EACL,MAAM,OAAO,CAAC;EACd,MAAM,cAAc,MAAM,QAAQ,QAAQ;EAC1C,OAAO;CACT;AACF;;AAyDA,eAAe,cAAc,SAA6B,QAAa,MAA6B;CAElG,KAAK,MAAM,CAAC,YAAY,eAAe,OAAO,QAAQ,IAAI,GAAG;EAC3D,MAAM,WAAWA,uBAAAA,cAAc,UAAU;EAEzC,IAAI,YAAY;EAChB,IAAI,EAAE,aAAa,SAAS;GAC1B,MAAM,QAAQ,OAAO,OAAOD,uBAAAA,YAAY,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,MAAM,EAAE,gBAAgB,UAAU;GACnG,IAAI,OACF,YAAY,MAAM;EAEtB;EAEA,IAAI,EAAE,aAAa,SAAS;GAC1B,IAAI,OAAO,eAAe,YACxB,MAAM,IAAI,MAAM,mCAAmC,YAAY;GAEjE,QAAQ,cAAc,MAAM,WAAW,MAAM;EAC/C,OAAO;GACL,MAAM,QAAQ,OAAO;GACrB,IAAI,YAAY,KAAK,GACnB,QAAQ,cAAc;QACjB,IACL,iBAAiBE,uCAAAA,wBACjB,iBAAiBC,gCAAAA,qBACjB,iBAAiBC,iCAAAA,sBACjB,iBAAiBC,qCAAAA,0BACjB,iBAAiBC,8BAAAA,cAEjB,MAAM,mBAAmB,SAAS,YAAY,MAAM,KAAK,QAAQ;QAEjE,MAAM,IAAI,MAAM,0BAA0B,MAAM,SAAS;EAE7D;CACF;AACF;AAEA,SAAS,mBAAmB,SAAc,KAAU,OAAY,UAA6C;CAC3G,IAAI,UAAU,KAAA,KAAa,UAAU,QAAQ,YAAY,KAAK,GAC5D,QAAQ,OAAO;MACV,IAAIC,eAAAA,SAAS,KAAK,GAAG;EAC1B,IAAI,YAAY,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GAAG;GAChD,QAAQ,OAAO,CAAC;GAChB,OAAO,cAAc,QAAQ,MAAM,OAAO,QAAQ;EACpD,OACE,QAAQ,OAAO,MAAM;CAEzB,OAAO,IAAI,MAAM,QAAQ,KAAK,GAAG;EAC/B,MAAM,OAAO,CAAC;EACd,QAAQ,OAAO;EACf,IAAI,YAAY,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GAC7C,OAAO,QAAQ,IACb,MAAM,IAAI,OAAO,MAAM,MAAM;GAC3B,IAAIA,eAAAA,SAAS,IAAI,GAAG;IAClB,KAAK,KAAK,CAAC;IACX,OAAO,cAAc,KAAK,IAAI,MAAM,QAAQ;GAC9C,OAEE,KAAK,KAAK;EAEd,CAAC,CACH;OAGA,KAAK,MAAM,QAAQ,OAAO,KAAK,KAAK,KAAK,EAAE;CAE/C,OACE,QAAQ,OAAO;AAEnB;AAEA,SAAS,YAAY,OAAqB;CACxC,OAAO,UAAU,QAAQ,OAAO,UAAU;AAC5C"}

package/build/json.js

@@ -1,8 +1,8 @@
 import { AbstractRelationImpl } from "./relations/AbstractRelationImpl.js";
-import { PropertyImpl } from "./relations/hasProperty.js";
-import { ReactiveGetterImpl } from "./relations/ReactiveGetter.js";
-import { convertToLoadHint } from "./reactiveHints.js";
 import { normalizeHint } from "./normalizeHints.js";
+import { ReactiveGetterImpl } from "./relations/ReactiveGetter.js";
+import { convertToLoadHint } from "./reactivity/reactiveHints.js";
+import { PropertyImpl } from "./relations/hasProperty.js";
 import { ReactiveFieldImpl } from "./relations/ReactiveField.js";
 import { AsyncReactiveFieldImpl } from "./relations/AsyncReactiveField.js";
 import "./relations/index.js";

package/build/json.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.js","names":[],"sources":["../src/json.ts"],"sourcesContent":["import { type Entity, isEntity } from \"./Entity.ts\";\nimport { type IdOf } from \"./EntityManager.ts\";\nimport { getMetadata } from \"./EntityMetadata.ts\";\nimport { normalizeHint } from \"./normalizeHints.ts\";\nimport { convertToLoadHint } from \"./reactiveHints.ts\";\nimport { AbstractRelationImpl } from \"./relations/AbstractRelationImpl.ts\";\nimport { AsyncReactiveFieldImpl } from \"./relations/AsyncReactiveField.ts\";\nimport { PropertyImpl } from \"./relations/hasProperty.ts\";\nimport {\n  type AsyncMethod,\n  type Collection,\n  type Property,\n  type ReactiveGetter,\n  type Reference,\n} from \"./relations/index.ts\";\nimport { ReactiveFieldImpl } from \"./relations/ReactiveField.ts\";\nimport { ReactiveGetterImpl } from \"./relations/ReactiveGetter.ts\";\n\n/**\n * A JSON hint of a single key, multiple keys, or nested keys and sub-hints.\n *\n * JSON hints are much like load hints/reactive hints:\n *\n * - Similar to load hints, they specify which relations should be loaded from the database\n * - Similar to reactive hints, they include specific fields to output\n * - Unlike either, they can include completely custom keys that are lambdas to generate custom values\n */\nexport type JsonHint<T extends Entity> =\n  | (keyof Jsonable<T> & string)\n  | ReadonlyArray<keyof Jsonable<T> & string>\n  | NestedJsonHint<T>;\n\n/** For object literal/nested hints, we allow mapping both entity keys 1:1 & custom keys via a lambdas. */\nexport type NestedJsonHint<T extends Entity> = EntityKeyJsonHint<T> | CustomJsonKeyHint<T>;\n\n/** Foreach `Jsonable` key, we can provide a sub-hint, or just a boolean to include/exclude. */\nexport type EntityKeyJsonHint<T extends Entity> = {\n  // The `as K` makes `bookIds` as a hint work...\n  [K in keyof Jsonable<T> as `${K}`]?: (Jsonable<T>[K] extends infer U extends Entity ? JsonHint<U> : {}) | boolean;\n};\n\nexport type CustomJsonKeyHint<T> = {\n  [key: string]: (entity: T) => any;\n};\n\n/**\n * Describes the JSON payload for `Entity.toJSON` to produce.\n *\n * - `[\"firstName\", \"lastName\"]` will produce a JSON payload with just those fields\n * - `{ author: { books: \"title\" } }` will produce a JSON payload with the author's books' titles\n *\n * We only accept object literals & arrays to `toJSON` to avoid a `JSON.stringify` oddity.\n */\nexport type ToJsonHint<T extends Entity> = NestedJsonHint<T> | ReadonlyArray<keyof Jsonable<T> & string>;\n\n/** The keys in `T` that we can put into a JSON payload. */\nexport type Jsonable<T extends Entity> = {\n  -readonly [K in keyof T as JsonableValue<T[K]> extends never ? never : K]: JsonableValue<T[K]>;\n};\n\n// this should probably be `keyof T` as long as they aren't methods/AsyncMethods.\n// so primitives, enums, references, collections, async properties, but also random getters.\nexport type JsonableValue<V> =\n  V extends Reference<any, infer U, any>\n    ? U\n    : V extends Collection<any, infer U>\n      ? U\n      : V extends AsyncMethod<any, any, any>\n        ? never\n        : V extends Property<any, infer P>\n          ? DropUndefined<P>\n          : V extends ReactiveGetter<any, infer P>\n            ? P\n            : V;\n\n/**\n * Provides an API to put an entity, or list of entities, into a JSON payload.\n *\n * The `hint` parameter is a JSON hint that describes what to include in the payload,\n *\n * - fields like `id`, `name`, etc.\n * - relations like m2o, o2m, m2m, and o2o\n *   - relations are allowed to provide nested hints, just like nested load hints\n * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`\n */\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entity: T,\n  hint: H,\n): Promise<JsonPayload<T, H>>;\n\n/**\n * Provides an API to put an entity, or list of entities, into a JSON payload.\n *\n * The `hint` parameter is a JSON hint that describes what to include in the payload,\n *\n * - fields like `id`, `name`, etc.\n * - relations like m2o, o2m, m2m, and o2o\n *   - relations are allowed to provide nested hints, just like nested load hints\n * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`\n */\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entities: readonly T[],\n  hint: H,\n): Promise<JsonPayload<T, H>[]>;\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entityOrList: T | readonly T[],\n  hint: H,\n): Promise<JsonPayload<T, H> | JsonPayload<T, H>[]> {\n  // If called with a list, and nothing there, just early return\n  if (Array.isArray(entityOrList) && entityOrList.length === 0) return [];\n\n  // Otherwise probe to get our first entity\n  const entity = Array.isArray(entityOrList) ? entityOrList[0] : entityOrList;\n  const loadHint = convertToLoadHint(getMetadata(entity), hint as any, true);\n  await entity.em.populate(entityOrList, loadHint);\n  const normHint = normalizeHint(hint as any);\n\n  if (Array.isArray(entityOrList)) {\n    const list = [] as any;\n    await Promise.all(\n      entityOrList.map((entity) => {\n        const json = {};\n        list.push(json);\n        return copyToPayload(json, entity, normHint);\n      }),\n    );\n    return list;\n  } else {\n    const json = {};\n    await copyToPayload(json, entity, normHint);\n    return json as any;\n  }\n}\n\n/**\n * Statically types the return value of `toJSON` based on the given `hint`.\n */\nexport type JsonPayload<T, H> = {\n  [HK in keyof NormalizeHint<H> & string]: HK extends keyof T\n    ? JsonPayloadKey<T, H, HK, HK>\n    : HK extends `${infer TK extends string & keyof T}Id`\n      ? JsonPayloadKey<T, H, TK, HK>\n      : HK extends `${infer SK extends string}Ids` // bookIds -> books\n        ? // Very naive singularization to see if the guessed bookIds -> books actually exists on T to map 1:1\n          `${SK}s` extends keyof T\n          ? JsonPayloadKey<T, H, `${SK}s`, HK>\n          : JsonPayloadCustom<NormalizeHint<H>[HK]>\n        : JsonPayloadCustom<NormalizeHint<H>[HK]>;\n};\n\ntype JsonPayloadKey<T, H, TK extends keyof T, HK extends keyof NormalizeHint<H>> =\n  T[TK] extends Reference<any, infer U, any>\n    ? JsonPayloadReference<U, NormalizeHint<H>[HK]>\n    : T[TK] extends Collection<any, infer U>\n      ? JsonPayloadCollection<U, NormalizeHint<H>[HK]>\n      : T[TK] extends Property<any, infer U>\n        ? JsonPayloadProperty<U, NormalizeHint<H>[HK]>\n        : T[TK] extends ReactiveGetter<any, infer V>\n          ? V\n          : T[TK];\n\n// If the hint is empty, we just output the id as a string.\ntype JsonPayloadReference<U, H> = IsEmpty<H> extends true ? string : JsonPayload<U, H>;\n\ntype JsonPayloadCollection<U extends Entity, H> =\n  // If this is `books: true`, use the id\n  H extends true\n    ? IdOf<U>[]\n    : // If this is `{}`, use the id\n      IsEmpty<H> extends true\n      ? IdOf<U>[]\n      : // Otherwise it's a nested hint\n        JsonPayload<U, H>[];\n\ntype JsonPayloadProperty<P, H> =\n  // If an async property returns an entity, treat it like a reference\n  P extends Entity | undefined\n    ? JsonPayloadReference<P, H>\n    : // If an async property returns an entity[], treat it like a collection\n      P extends (infer U extends Entity)[] | undefined\n      ? JsonPayloadCollection<U, H>\n      : // Otherwise leave it as-is\n        P;\n\ntype JsonPayloadCustom<H> = H extends (...args: any) => infer V ? UnwrapPromise<V> : H;\n\ntype UnwrapPromise<T> = T extends Promise<infer U> ? U : T;\n\n/** Recursively copies the fields of `hint` from `entity` into the `payload`. */\nasync function copyToPayload(payload: Record<string, {}>, entity: any, hint: object): Promise<void> {\n  // Look at each key in the hint and determine\n  for (const [payloadKey, nestedHint] of Object.entries(hint)) {\n    const nextHint = normalizeHint(nestedHint);\n    // Watch for `companyId`\n    let entityKey = payloadKey;\n    if (!(entityKey in entity)) {\n      const field = Object.values(getMetadata(entity).allFields).find((f) => f.fieldIdName === payloadKey);\n      if (field) {\n        entityKey = field.fieldName;\n      }\n    }\n    // Look for custom props\n    if (!(entityKey in entity)) {\n      if (typeof nestedHint !== \"function\") {\n        throw new Error(`Entity does not have a property ${payloadKey}`);\n      }\n      payload[payloadKey] = await nestedHint(entity);\n    } else {\n      const value = entity[entityKey];\n      if (isPrimitive(value)) {\n        payload[payloadKey] = value;\n      } else if (\n        value instanceof AbstractRelationImpl ||\n        value instanceof ReactiveFieldImpl ||\n        value instanceof ReactiveGetterImpl ||\n        value instanceof AsyncReactiveFieldImpl ||\n        value instanceof PropertyImpl\n      ) {\n        await copyToPayloadValue(payload, payloadKey, value.get, nextHint);\n      } else {\n        throw new Error(`Unable to encode value ${value} to JSON`);\n      }\n    }\n  }\n}\n\nfunction copyToPayloadValue(payload: any, key: any, value: any, nextHint: any): Promise<unknown> | undefined {\n  if (value === undefined || value === null || isPrimitive(value)) {\n    payload[key] = value;\n  } else if (isEntity(value)) {\n    if (nextHint && Object.keys(nextHint).length > 0) {\n      payload[key] = {};\n      return copyToPayload(payload[key], value, nextHint);\n    } else {\n      payload[key] = value.id;\n    }\n  } else if (Array.isArray(value)) {\n    const list = [] as any[];\n    payload[key] = list;\n    if (nextHint && Object.keys(nextHint).length > 0) {\n      return Promise.all(\n        value.map(async (item, i) => {\n          if (isEntity(item)) {\n            list[i] = {};\n            return copyToPayload(list[i], item, nextHint);\n          } else {\n            // This is probably undefined\n            list[i] = item;\n          }\n        }),\n      );\n    } else {\n      // This is assuming an array of entities...\n      for (const item of value) list.push(item.id);\n    }\n  } else {\n    payload[key] = value;\n  }\n}\n\nfunction isPrimitive(value: any): boolean {\n  return value === null || typeof value !== \"object\";\n}\n\ntype DropUndefined<T> = T extends infer U extends Entity | undefined ? U : T;\n\n// A copy/paste of NormalizeHint w/o the `DropSuffix` stuff\ntype NormalizeHint<H> = H extends string\n  ? Record<H, {}>\n  : H extends ReadonlyArray<any>\n    ? Record<H[number], {}>\n    : { [K in keyof H]: H[K] };\n\ntype IsEmpty<T> = keyof T extends never ? true : false;\n"],"mappings":";;;;;;;;;;;;AAwGA,eAAsB,OACpB,cACA,MACkD;CAElD,IAAI,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,GAAG,OAAO,CAAC;CAGtE,MAAM,SAAS,MAAM,QAAQ,YAAY,IAAI,aAAa,KAAK;CAC/D,MAAM,WAAW,kBAAkB,YAAY,MAAM,GAAG,MAAa,IAAI;CACzE,MAAM,OAAO,GAAG,SAAS,cAAc,QAAQ;CAC/C,MAAM,WAAW,cAAc,IAAW;CAE1C,IAAI,MAAM,QAAQ,YAAY,GAAG;EAC/B,MAAM,OAAO,CAAC;EACd,MAAM,QAAQ,IACZ,aAAa,KAAK,WAAW;GAC3B,MAAM,OAAO,CAAC;GACd,KAAK,KAAK,IAAI;GACd,OAAO,cAAc,MAAM,QAAQ,QAAQ;EAC7C,CAAC,CACH;EACA,OAAO;CACT,OAAO;EACL,MAAM,OAAO,CAAC;EACd,MAAM,cAAc,MAAM,QAAQ,QAAQ;EAC1C,OAAO;CACT;AACF;;AAyDA,eAAe,cAAc,SAA6B,QAAa,MAA6B;CAElG,KAAK,MAAM,CAAC,YAAY,eAAe,OAAO,QAAQ,IAAI,GAAG;EAC3D,MAAM,WAAW,cAAc,UAAU;EAEzC,IAAI,YAAY;EAChB,IAAI,EAAE,aAAa,SAAS;GAC1B,MAAM,QAAQ,OAAO,OAAO,YAAY,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,MAAM,EAAE,gBAAgB,UAAU;GACnG,IAAI,OACF,YAAY,MAAM;EAEtB;EAEA,IAAI,EAAE,aAAa,SAAS;GAC1B,IAAI,OAAO,eAAe,YACxB,MAAM,IAAI,MAAM,mCAAmC,YAAY;GAEjE,QAAQ,cAAc,MAAM,WAAW,MAAM;EAC/C,OAAO;GACL,MAAM,QAAQ,OAAO;GACrB,IAAI,YAAY,KAAK,GACnB,QAAQ,cAAc;QACjB,IACL,iBAAiB,wBACjB,iBAAiB,qBACjB,iBAAiB,sBACjB,iBAAiB,0BACjB,iBAAiB,cAEjB,MAAM,mBAAmB,SAAS,YAAY,MAAM,KAAK,QAAQ;QAEjE,MAAM,IAAI,MAAM,0BAA0B,MAAM,SAAS;EAE7D;CACF;AACF;AAEA,SAAS,mBAAmB,SAAc,KAAU,OAAY,UAA6C;CAC3G,IAAI,UAAU,KAAA,KAAa,UAAU,QAAQ,YAAY,KAAK,GAC5D,QAAQ,OAAO;MACV,IAAI,SAAS,KAAK,GAAG;EAC1B,IAAI,YAAY,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GAAG;GAChD,QAAQ,OAAO,CAAC;GAChB,OAAO,cAAc,QAAQ,MAAM,OAAO,QAAQ;EACpD,OACE,QAAQ,OAAO,MAAM;CAEzB,OAAO,IAAI,MAAM,QAAQ,KAAK,GAAG;EAC/B,MAAM,OAAO,CAAC;EACd,QAAQ,OAAO;EACf,IAAI,YAAY,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GAC7C,OAAO,QAAQ,IACb,MAAM,IAAI,OAAO,MAAM,MAAM;GAC3B,IAAI,SAAS,IAAI,GAAG;IAClB,KAAK,KAAK,CAAC;IACX,OAAO,cAAc,KAAK,IAAI,MAAM,QAAQ;GAC9C,OAEE,KAAK,KAAK;EAEd,CAAC,CACH;OAGA,KAAK,MAAM,QAAQ,OAAO,KAAK,KAAK,KAAK,EAAE;CAE/C,OACE,QAAQ,OAAO;AAEnB;AAEA,SAAS,YAAY,OAAqB;CACxC,OAAO,UAAU,QAAQ,OAAO,UAAU;AAC5C"}
+{"version":3,"file":"json.js","names":[],"sources":["../src/json.ts"],"sourcesContent":["import { type Entity, isEntity } from \"src/Entity.ts\";\nimport { type IdOf } from \"src/EntityManager.ts\";\nimport { getMetadata } from \"src/EntityMetadata.ts\";\nimport { normalizeHint } from \"src/normalizeHints.ts\";\nimport { convertToLoadHint } from \"src/reactivity/reactiveHints.ts\";\nimport { AbstractRelationImpl } from \"src/relations/AbstractRelationImpl.ts\";\nimport { AsyncReactiveFieldImpl } from \"src/relations/AsyncReactiveField.ts\";\nimport { PropertyImpl } from \"src/relations/hasProperty.ts\";\nimport {\n  type AsyncMethod,\n  type Collection,\n  type Property,\n  type ReactiveGetter,\n  type Reference,\n} from \"src/relations/index.ts\";\nimport { ReactiveFieldImpl } from \"src/relations/ReactiveField.ts\";\nimport { ReactiveGetterImpl } from \"src/relations/ReactiveGetter.ts\";\n\n/**\n * A JSON hint of a single key, multiple keys, or nested keys and sub-hints.\n *\n * JSON hints are much like load hints/reactive hints:\n *\n * - Similar to load hints, they specify which relations should be loaded from the database\n * - Similar to reactive hints, they include specific fields to output\n * - Unlike either, they can include completely custom keys that are lambdas to generate custom values\n */\nexport type JsonHint<T extends Entity> =\n  | (keyof Jsonable<T> & string)\n  | ReadonlyArray<keyof Jsonable<T> & string>\n  | NestedJsonHint<T>;\n\n/** For object literal/nested hints, we allow mapping both entity keys 1:1 & custom keys via a lambdas. */\nexport type NestedJsonHint<T extends Entity> = EntityKeyJsonHint<T> | CustomJsonKeyHint<T>;\n\n/** Foreach `Jsonable` key, we can provide a sub-hint, or just a boolean to include/exclude. */\nexport type EntityKeyJsonHint<T extends Entity> = {\n  // The `as K` makes `bookIds` as a hint work...\n  [K in keyof Jsonable<T> as `${K}`]?: (Jsonable<T>[K] extends infer U extends Entity ? JsonHint<U> : {}) | boolean;\n};\n\nexport type CustomJsonKeyHint<T> = {\n  [key: string]: (entity: T) => any;\n};\n\n/**\n * Describes the JSON payload for `Entity.toJSON` to produce.\n *\n * - `[\"firstName\", \"lastName\"]` will produce a JSON payload with just those fields\n * - `{ author: { books: \"title\" } }` will produce a JSON payload with the author's books' titles\n *\n * We only accept object literals & arrays to `toJSON` to avoid a `JSON.stringify` oddity.\n */\nexport type ToJsonHint<T extends Entity> = NestedJsonHint<T> | ReadonlyArray<keyof Jsonable<T> & string>;\n\n/** The keys in `T` that we can put into a JSON payload. */\nexport type Jsonable<T extends Entity> = {\n  -readonly [K in keyof T as JsonableValue<T[K]> extends never ? never : K]: JsonableValue<T[K]>;\n};\n\n// this should probably be `keyof T` as long as they aren't methods/AsyncMethods.\n// so primitives, enums, references, collections, async properties, but also random getters.\nexport type JsonableValue<V> =\n  V extends Reference<any, infer U, any>\n    ? U\n    : V extends Collection<any, infer U>\n      ? U\n      : V extends AsyncMethod<any, any, any>\n        ? never\n        : V extends Property<any, infer P>\n          ? DropUndefined<P>\n          : V extends ReactiveGetter<any, infer P>\n            ? P\n            : V;\n\n/**\n * Provides an API to put an entity, or list of entities, into a JSON payload.\n *\n * The `hint` parameter is a JSON hint that describes what to include in the payload,\n *\n * - fields like `id`, `name`, etc.\n * - relations like m2o, o2m, m2m, and o2o\n *   - relations are allowed to provide nested hints, just like nested load hints\n * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`\n */\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entity: T,\n  hint: H,\n): Promise<JsonPayload<T, H>>;\n\n/**\n * Provides an API to put an entity, or list of entities, into a JSON payload.\n *\n * The `hint` parameter is a JSON hint that describes what to include in the payload,\n *\n * - fields like `id`, `name`, etc.\n * - relations like m2o, o2m, m2m, and o2o\n *   - relations are allowed to provide nested hints, just like nested load hints\n * - custom fields like `fullName: (entity) => entity.firstName + ' ' + entity.lastName`\n */\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entities: readonly T[],\n  hint: H,\n): Promise<JsonPayload<T, H>[]>;\nexport async function toJSON<T extends Entity, const H extends JsonHint<T>>(\n  entityOrList: T | readonly T[],\n  hint: H,\n): Promise<JsonPayload<T, H> | JsonPayload<T, H>[]> {\n  // If called with a list, and nothing there, just early return\n  if (Array.isArray(entityOrList) && entityOrList.length === 0) return [];\n\n  // Otherwise probe to get our first entity\n  const entity = Array.isArray(entityOrList) ? entityOrList[0] : entityOrList;\n  const loadHint = convertToLoadHint(getMetadata(entity), hint as any, true);\n  await entity.em.populate(entityOrList, loadHint);\n  const normHint = normalizeHint(hint as any);\n\n  if (Array.isArray(entityOrList)) {\n    const list = [] as any;\n    await Promise.all(\n      entityOrList.map((entity) => {\n        const json = {};\n        list.push(json);\n        return copyToPayload(json, entity, normHint);\n      }),\n    );\n    return list;\n  } else {\n    const json = {};\n    await copyToPayload(json, entity, normHint);\n    return json as any;\n  }\n}\n\n/**\n * Statically types the return value of `toJSON` based on the given `hint`.\n */\nexport type JsonPayload<T, H> = {\n  [HK in keyof NormalizeHint<H> & string]: HK extends keyof T\n    ? JsonPayloadKey<T, H, HK, HK>\n    : HK extends `${infer TK extends string & keyof T}Id`\n      ? JsonPayloadKey<T, H, TK, HK>\n      : HK extends `${infer SK extends string}Ids` // bookIds -> books\n        ? // Very naive singularization to see if the guessed bookIds -> books actually exists on T to map 1:1\n          `${SK}s` extends keyof T\n          ? JsonPayloadKey<T, H, `${SK}s`, HK>\n          : JsonPayloadCustom<NormalizeHint<H>[HK]>\n        : JsonPayloadCustom<NormalizeHint<H>[HK]>;\n};\n\ntype JsonPayloadKey<T, H, TK extends keyof T, HK extends keyof NormalizeHint<H>> =\n  T[TK] extends Reference<any, infer U, any>\n    ? JsonPayloadReference<U, NormalizeHint<H>[HK]>\n    : T[TK] extends Collection<any, infer U>\n      ? JsonPayloadCollection<U, NormalizeHint<H>[HK]>\n      : T[TK] extends Property<any, infer U>\n        ? JsonPayloadProperty<U, NormalizeHint<H>[HK]>\n        : T[TK] extends ReactiveGetter<any, infer V>\n          ? V\n          : T[TK];\n\n// If the hint is empty, we just output the id as a string.\ntype JsonPayloadReference<U, H> = IsEmpty<H> extends true ? string : JsonPayload<U, H>;\n\ntype JsonPayloadCollection<U extends Entity, H> =\n  // If this is `books: true`, use the id\n  H extends true\n    ? IdOf<U>[]\n    : // If this is `{}`, use the id\n      IsEmpty<H> extends true\n      ? IdOf<U>[]\n      : // Otherwise it's a nested hint\n        JsonPayload<U, H>[];\n\ntype JsonPayloadProperty<P, H> =\n  // If an async property returns an entity, treat it like a reference\n  P extends Entity | undefined\n    ? JsonPayloadReference<P, H>\n    : // If an async property returns an entity[], treat it like a collection\n      P extends (infer U extends Entity)[] | undefined\n      ? JsonPayloadCollection<U, H>\n      : // Otherwise leave it as-is\n        P;\n\ntype JsonPayloadCustom<H> = H extends (...args: any) => infer V ? UnwrapPromise<V> : H;\n\ntype UnwrapPromise<T> = T extends Promise<infer U> ? U : T;\n\n/** Recursively copies the fields of `hint` from `entity` into the `payload`. */\nasync function copyToPayload(payload: Record<string, {}>, entity: any, hint: object): Promise<void> {\n  // Look at each key in the hint and determine\n  for (const [payloadKey, nestedHint] of Object.entries(hint)) {\n    const nextHint = normalizeHint(nestedHint);\n    // Watch for `companyId`\n    let entityKey = payloadKey;\n    if (!(entityKey in entity)) {\n      const field = Object.values(getMetadata(entity).allFields).find((f) => f.fieldIdName === payloadKey);\n      if (field) {\n        entityKey = field.fieldName;\n      }\n    }\n    // Look for custom props\n    if (!(entityKey in entity)) {\n      if (typeof nestedHint !== \"function\") {\n        throw new Error(`Entity does not have a property ${payloadKey}`);\n      }\n      payload[payloadKey] = await nestedHint(entity);\n    } else {\n      const value = entity[entityKey];\n      if (isPrimitive(value)) {\n        payload[payloadKey] = value;\n      } else if (\n        value instanceof AbstractRelationImpl ||\n        value instanceof ReactiveFieldImpl ||\n        value instanceof ReactiveGetterImpl ||\n        value instanceof AsyncReactiveFieldImpl ||\n        value instanceof PropertyImpl\n      ) {\n        await copyToPayloadValue(payload, payloadKey, value.get, nextHint);\n      } else {\n        throw new Error(`Unable to encode value ${value} to JSON`);\n      }\n    }\n  }\n}\n\nfunction copyToPayloadValue(payload: any, key: any, value: any, nextHint: any): Promise<unknown> | undefined {\n  if (value === undefined || value === null || isPrimitive(value)) {\n    payload[key] = value;\n  } else if (isEntity(value)) {\n    if (nextHint && Object.keys(nextHint).length > 0) {\n      payload[key] = {};\n      return copyToPayload(payload[key], value, nextHint);\n    } else {\n      payload[key] = value.id;\n    }\n  } else if (Array.isArray(value)) {\n    const list = [] as any[];\n    payload[key] = list;\n    if (nextHint && Object.keys(nextHint).length > 0) {\n      return Promise.all(\n        value.map(async (item, i) => {\n          if (isEntity(item)) {\n            list[i] = {};\n            return copyToPayload(list[i], item, nextHint);\n          } else {\n            // This is probably undefined\n            list[i] = item;\n          }\n        }),\n      );\n    } else {\n      // This is assuming an array of entities...\n      for (const item of value) list.push(item.id);\n    }\n  } else {\n    payload[key] = value;\n  }\n}\n\nfunction isPrimitive(value: any): boolean {\n  return value === null || typeof value !== \"object\";\n}\n\ntype DropUndefined<T> = T extends infer U extends Entity | undefined ? U : T;\n\n// A copy/paste of NormalizeHint w/o the `DropSuffix` stuff\ntype NormalizeHint<H> = H extends string\n  ? Record<H, {}>\n  : H extends ReadonlyArray<any>\n    ? Record<H[number], {}>\n    : { [K in keyof H]: H[K] };\n\ntype IsEmpty<T> = keyof T extends never ? true : false;\n"],"mappings":";;;;;;;;;;;;AAwGA,eAAsB,OACpB,cACA,MACkD;CAElD,IAAI,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,GAAG,OAAO,CAAC;CAGtE,MAAM,SAAS,MAAM,QAAQ,YAAY,IAAI,aAAa,KAAK;CAC/D,MAAM,WAAW,kBAAkB,YAAY,MAAM,GAAG,MAAa,IAAI;CACzE,MAAM,OAAO,GAAG,SAAS,cAAc,QAAQ;CAC/C,MAAM,WAAW,cAAc,IAAW;CAE1C,IAAI,MAAM,QAAQ,YAAY,GAAG;EAC/B,MAAM,OAAO,CAAC;EACd,MAAM,QAAQ,IACZ,aAAa,KAAK,WAAW;GAC3B,MAAM,OAAO,CAAC;GACd,KAAK,KAAK,IAAI;GACd,OAAO,cAAc,MAAM,QAAQ,QAAQ;EAC7C,CAAC,CACH;EACA,OAAO;CACT,OAAO;EACL,MAAM,OAAO,CAAC;EACd,MAAM,cAAc,MAAM,QAAQ,QAAQ;EAC1C,OAAO;CACT;AACF;;AAyDA,eAAe,cAAc,SAA6B,QAAa,MAA6B;CAElG,KAAK,MAAM,CAAC,YAAY,eAAe,OAAO,QAAQ,IAAI,GAAG;EAC3D,MAAM,WAAW,cAAc,UAAU;EAEzC,IAAI,YAAY;EAChB,IAAI,EAAE,aAAa,SAAS;GAC1B,MAAM,QAAQ,OAAO,OAAO,YAAY,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,MAAM,EAAE,gBAAgB,UAAU;GACnG,IAAI,OACF,YAAY,MAAM;EAEtB;EAEA,IAAI,EAAE,aAAa,SAAS;GAC1B,IAAI,OAAO,eAAe,YACxB,MAAM,IAAI,MAAM,mCAAmC,YAAY;GAEjE,QAAQ,cAAc,MAAM,WAAW,MAAM;EAC/C,OAAO;GACL,MAAM,QAAQ,OAAO;GACrB,IAAI,YAAY,KAAK,GACnB,QAAQ,cAAc;QACjB,IACL,iBAAiB,wBACjB,iBAAiB,qBACjB,iBAAiB,sBACjB,iBAAiB,0BACjB,iBAAiB,cAEjB,MAAM,mBAAmB,SAAS,YAAY,MAAM,KAAK,QAAQ;QAEjE,MAAM,IAAI,MAAM,0BAA0B,MAAM,SAAS;EAE7D;CACF;AACF;AAEA,SAAS,mBAAmB,SAAc,KAAU,OAAY,UAA6C;CAC3G,IAAI,UAAU,KAAA,KAAa,UAAU,QAAQ,YAAY,KAAK,GAC5D,QAAQ,OAAO;MACV,IAAI,SAAS,KAAK,GAAG;EAC1B,IAAI,YAAY,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GAAG;GAChD,QAAQ,OAAO,CAAC;GAChB,OAAO,cAAc,QAAQ,MAAM,OAAO,QAAQ;EACpD,OACE,QAAQ,OAAO,MAAM;CAEzB,OAAO,IAAI,MAAM,QAAQ,KAAK,GAAG;EAC/B,MAAM,OAAO,CAAC;EACd,QAAQ,OAAO;EACf,IAAI,YAAY,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GAC7C,OAAO,QAAQ,IACb,MAAM,IAAI,OAAO,MAAM,MAAM;GAC3B,IAAI,SAAS,IAAI,GAAG;IAClB,KAAK,KAAK,CAAC;IACX,OAAO,cAAc,KAAK,IAAI,MAAM,QAAQ;GAC9C,OAEE,KAAK,KAAK;EAEd,CAAC,CACH;OAGA,KAAK,MAAM,QAAQ,OAAO,KAAK,KAAK,KAAK,EAAE;CAE/C,OACE,QAAQ,OAAO;AAEnB;AAEA,SAAS,YAAY,OAAqB;CACxC,OAAO,UAAU,QAAQ,OAAO,UAAU;AAC5C"}

package/build/keys.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_utils = require("./utils.cjs");
 require("./relations/index.cjs");
+const require_utils = require("./utils.cjs");
 const require_EntityMetadata = require("./EntityMetadata.cjs");
 require("./EntityManager.cjs");
 const require_Entity = require("./Entity.cjs");

package/build/keys.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"keys.cjs","names":["assertNever","isEntity","BaseEntity","getMetadata","fail"],"sources":["../src/keys.ts"],"sourcesContent":["import { BaseEntity } from \"./BaseEntity.ts\";\nimport { type Entity, type IdType, isEntity } from \"./Entity.ts\";\nimport { type EntityConstructor, type IdOf, type TaggedId } from \"./EntityManager.ts\";\nimport { type EntityMetadata, getMetadata } from \"./EntityMetadata.ts\";\nimport { type Reference } from \"./relations/index.ts\";\nimport { assertNever, fail } from \"./utils.ts\";\n\nlet tagDelimiter: string | undefined = \":\";\n\n/** Sets the process-wide tagged-id format during metadata boot. */\nexport function setTaggedIdDelimiter(delimiter: string | undefined): void {\n  tagDelimiter = delimiter;\n}\n\n// I'm not entirely sure this is still necessary, but use a small subset of EntityMetadata so\n// that this file doesn't have to import the type and potentially create import cycles.\ntype HasTagName = {\n  tagName: string;\n  /** The database column type, i.e. used to do `::type` casts in Postgres. */\n  idDbType: \"bigint\" | \"int\" | \"uuid\" | \"text\";\n};\n\n/** Converts our internal/always-tagged `id` to the domain entity's `id` type (could be a number or uuid). */\nexport function toIdOf<T extends Entity>(meta: EntityMetadata<T>, id: TaggedId | undefined): IdOf<T> | undefined {\n  if (!id) return undefined;\n  switch (meta.idType) {\n    case \"number\":\n      return Number(deTagId(meta, id)) as IdOf<T>;\n    case \"tagged-string\":\n      return id as IdOf<T>;\n    case \"untagged-string\":\n      return deTagId(meta, id) as IdOf<T>;\n    default:\n      return assertNever(meta.idType);\n  }\n}\n\n// Before a referred-to object is saved, we keep its instance in our data\n// map, and then assume it will be persisted before we're asked to persist\nexport function maybeResolveReferenceToId(\n  value: Entity | Reference<any, any, any> | string | undefined,\n): TaggedId | undefined {\n  return typeof value === \"string\" ? value : value?.idTaggedMaybe;\n}\n\n/** Converts `value` to a number, i.e. for string ids, unless its undefined. */\nexport function keyToNumber(meta: HasTagName, value: string | number): number;\nexport function keyToNumber(meta: HasTagName, value: string | number | undefined): number | undefined;\nexport function keyToNumber(meta: HasTagName, value: any): number | undefined {\n  if (value === undefined || value === null) {\n    return undefined;\n  } else if (typeof value === \"number\") {\n    return value;\n  } else if (typeof value === \"string\") {\n    if (tagDelimiter === undefined) {\n      const id = value.startsWith(meta.tagName) ? value.slice(meta.tagName.length) : value;\n      return maybeNumberUnlessUuid(meta, id);\n    }\n    const delimiterIndex = value.indexOf(tagDelimiter);\n    if (delimiterIndex === -1) {\n      return maybeNumberUnlessUuid(meta, value);\n    }\n    const tag = value.slice(0, delimiterIndex);\n    if (tag !== meta.tagName) {\n      throw new Error(`Invalid tagged id, expected tag ${meta.tagName}, got ${value}`);\n    }\n    return maybeNumberUnlessUuid(meta, value.slice(delimiterIndex + tagDelimiter.length));\n  } else {\n    throw new Error(`Invalid key ${value}`);\n  }\n}\n\n// UUIDs, text, and bigints are strings at the database boundary, so lie to the type system and pretend they're numbers.\nfunction maybeNumberUnlessUuid(meta: HasTagName, key: string): number {\n  switch (meta.idDbType) {\n    case \"bigint\":\n    case \"uuid\":\n    case \"text\":\n      return key as any;\n    case \"int\":\n      return Number(key);\n    default:\n      assertNever(meta.idDbType);\n  }\n}\n\n/** Converts `dbValue` (big int, int, uuid) to a tagged string, unless its undefined. */\nexport function keyToTaggedId(meta: HasTagName, dbValue: string | number): TaggedId | undefined {\n  if (dbValue === undefined || dbValue === null) return undefined;\n  return `${meta.tagName}${tagDelimiter ?? \"\"}${dbValue}`;\n}\n\n/** Fails if any keys are untagged; internal batch-loader keys must always be tagged. */\nexport function assertIdsAreTagged(keys: readonly string[]): void {\n  for (const key of keys) {\n    const isTagged = tagDelimiter === undefined ? validSlugId.test(key) : key.indexOf(tagDelimiter) !== -1;\n    if (!isTagged) throw new Error(`Key ${key} is missing a tag`);\n  }\n}\n\nconst validSlugId = /^([a-z]+)(\\d+)$/i;\nconst uuidIshId = /[0-9a-z-]+/i;\n\n/** Returns whether `id` is tagged and a probably-correct value. */\nexport function isTaggedId(id: string | number): boolean;\n/** Returns whether `id` is tagged and the tag matches `meta`'s tag. */\nexport function isTaggedId(meta: EntityMetadata, id: string): boolean;\nexport function isTaggedId(metaOrId: string | number | HasTagName, id?: string): boolean {\n  if (typeof metaOrId === \"number\") {\n    // number overload\n    return false;\n  } else if (typeof metaOrId === \"string\") {\n    // string overload\n    return tagDelimiter === undefined ? validSlugId.test(metaOrId) : hasTagDelimiter(metaOrId);\n  } else {\n    // meta + string overload\n    return isTaggedIdForMeta(metaOrId, id!);\n  }\n}\n\nexport function assertIdIsTagged(id: string): void {\n  if (!isTaggedId(id)) {\n    throw new Error(`Key is not tagged ${id}`);\n  }\n}\n\n/** We accept an entity in case this is m2o storing a not-yet-saved entity. */\nexport function toTaggedId(meta: HasTagName, id: IdType): TaggedId;\nexport function toTaggedId(meta: HasTagName, id: IdType | undefined): TaggedId | undefined;\nexport function toTaggedId(meta: HasTagName, id: IdType | undefined): TaggedId | undefined {\n  if (typeof id === \"number\") {\n    return `${meta.tagName}${tagDelimiter ?? \"\"}${id}`;\n  } else if (typeof id === \"string\") {\n    // This seems odd, but is covered by a unit test, so I guess we need it?\n    if (id === \"\") return undefined;\n    if (tagDelimiter === undefined) {\n      const tag = validSlugId.exec(id)?.[1];\n      if (tag && tag !== meta.tagName) {\n        throw new Error(`Invalid tagged id, expected tag ${meta.tagName}, got ${id}`);\n      }\n      return tag ? id : `${meta.tagName}${id}`;\n    } else {\n      const i = id.indexOf(tagDelimiter);\n      if (i === -1) return `${meta.tagName}${tagDelimiter}${id}`;\n      const tag = id.slice(0, i);\n      if (tag !== meta.tagName) {\n        throw new Error(`Invalid tagged id, expected tag ${meta.tagName}, got ${id}`);\n      }\n    }\n  }\n  return id;\n}\n\n/** Similar to `toTaggedId`, but we accept an entity for handling relations to not-yet-saved entities. */\nexport function ensureTagged<T extends Entity>(\n  meta: HasTagName,\n  value: T | string | number | undefined,\n): T | TaggedId | undefined {\n  return isEntity(value) ? value : toTaggedId(meta, value);\n}\n\n/** Tags a potentially untagged id, while our API inputs still accept either tagged or untagged ids. */\nexport function tagId(meta: HasTagName, id: string | number): string;\nexport function tagId(cstr: EntityConstructor<any>, id: string | number): string;\nexport function tagId(meta: HasTagName, id: string | number | null | undefined): string | undefined;\nexport function tagId(cstr: EntityConstructor<any>, id: string | number | null | undefined): string | undefined;\nexport function tagId(\n  metaOrCstr: HasTagName | EntityConstructor<any>,\n  id: string | number | null | undefined,\n): string | undefined {\n  const meta = metadata(metaOrCstr);\n  const tag = meta.tagName;\n  if (typeof id === \"number\") {\n    return `${tag}${tagDelimiter ?? \"\"}${id}`;\n  }\n  if (id === null || id === undefined) {\n    return undefined;\n  }\n  if (tagDelimiter === undefined) {\n    const existingTag = validSlugId.exec(id)?.[1];\n    if (existingTag && existingTag !== tag) {\n      throw new Error(`Invalid tagged id, expected tag ${tag}, got ${id}`);\n    }\n    return existingTag ? id : `${tag}${id}`;\n  }\n  // Avoid using includes/split, for a faster indexOf + length + startsWith\n  const delimiterIndex = id.indexOf(tagDelimiter);\n  if (delimiterIndex !== -1) {\n    if (delimiterIndex !== tag.length || !id.startsWith(tag)) {\n      throw new Error(`Invalid tagged id, expected tag ${tag}, got ${id}`);\n    }\n    return id;\n  }\n  return `${tag}${tagDelimiter}${id}`;\n}\n\n/** Adds the tag prefixes. */\nexport function tagIds(meta: HasTagName, keys: readonly (string | number)[]): readonly string[];\nexport function tagIds(cstr: EntityConstructor<any>, keys: readonly (string | number)[]): readonly string[];\nexport function tagIds(\n  metaOrCstr: HasTagName | EntityConstructor<any>,\n  keys: readonly (string | number)[],\n): readonly string[] {\n  return keys.map((k) => tagId(metaOrCstr as any, k));\n}\n\nexport function deTagId(meta: HasTagName, id: string | number): string;\nexport function deTagId(meta: HasTagName, id: string | number | undefined): string | undefined;\nexport function deTagId(entity: Entity): string;\nexport function deTagId(entityOrMeta: Entity | HasTagName, id?: string | number): string | undefined {\n  const meta = entityOrMeta instanceof BaseEntity ? getMetadata(entityOrMeta) : (entityOrMeta as HasTagName);\n  id = id ?? (entityOrMeta as Entity).id;\n  return id === undefined ? undefined : keyToNumber(meta, id).toString();\n}\n\n/** Removes the tag prefixes so we can use the keys for SQL operations. */\nexport function deTagIds(meta: HasTagName, keys: readonly string[]): readonly string[] {\n  const deTagged = Array(keys.length);\n  for (let i = 0; i < keys.length; i++) deTagged[i] = deTagId(meta, keys[i]);\n  return deTagged;\n}\n\n/** Removes the tag prefixes so we can use the keys for SQL operations. */\nexport function unsafeDeTagIds(keys: readonly string[]): readonly string[] {\n  const deTagged = Array(keys.length);\n  for (let i = 0; i < keys.length; i++) {\n    if (tagDelimiter === undefined) {\n      deTagged[i] = validSlugId.exec(keys[i])?.[2];\n    } else {\n      const delimiterIndex = keys[i].indexOf(tagDelimiter);\n      deTagged[i] = delimiterIndex === -1 ? undefined : keys[i].slice(delimiterIndex + tagDelimiter.length);\n    }\n  }\n  return deTagged;\n}\n\n/** Given a tagged id, returns its tag. */\nexport function tagFromId(id: string): string {\n  if (tagDelimiter === undefined) {\n    return validSlugId.exec(id)?.[1] ?? fail(`Unknown tagged id format: \"${id}\"`);\n  }\n  const delimiterIndex = id.indexOf(tagDelimiter);\n  return delimiterIndex > 0 && delimiterIndex + tagDelimiter.length < id.length\n    ? id.slice(0, delimiterIndex)\n    : fail(`Unknown tagged id format: \"${id}\"`);\n}\n\n/** Returns the metadata needed to format an id. */\nfunction metadata(metaOrCstr: HasTagName | EntityConstructor<any>): HasTagName {\n  return typeof metaOrCstr === \"function\" ? getMetadata(metaOrCstr) : metaOrCstr;\n}\n\n/** Returns whether `id` has the tag and database id shape required by `meta`. */\nfunction isTaggedIdForMeta(meta: HasTagName, id: string): boolean {\n  if (tagDelimiter === undefined) {\n    return validSlugId.exec(id)?.[1] === meta.tagName;\n  }\n  const delimiterIndex = id.indexOf(tagDelimiter);\n  if (delimiterIndex === -1) return false;\n  const tag = id.slice(0, delimiterIndex);\n  const untaggedId = id.slice(delimiterIndex + tagDelimiter.length);\n  if (meta.tagName !== tag) return false;\n  switch (meta.idDbType) {\n    case \"int\":\n    case \"bigint\":\n      return !Number.isNaN(Number(untaggedId));\n    case \"uuid\":\n      return uuidIshId.test(untaggedId);\n    case \"text\":\n      return true;\n    default:\n      return assertNever(meta.idDbType);\n  }\n}\n\n/** Returns whether `id` has a non-empty tag and value separated by the configured delimiter. */\nfunction hasTagDelimiter(id: string): boolean {\n  if (tagDelimiter === undefined) return false;\n  const delimiterIndex = id.indexOf(tagDelimiter);\n  return delimiterIndex > 0 && delimiterIndex + tagDelimiter.length < id.length;\n}\n"],"mappings":"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"}
+{"version":3,"file":"keys.cjs","names":["assertNever","isEntity","BaseEntity","getMetadata","fail"],"sources":["../src/keys.ts"],"sourcesContent":["import { BaseEntity } from \"src/BaseEntity.ts\";\nimport { type Entity, type IdType, isEntity } from \"src/Entity.ts\";\nimport { type EntityConstructor, type IdOf, type TaggedId } from \"src/EntityManager.ts\";\nimport { type EntityMetadata, getMetadata } from \"src/EntityMetadata.ts\";\nimport { type Reference } from \"src/relations/index.ts\";\nimport { assertNever, fail } from \"src/utils.ts\";\n\nlet tagDelimiter: string | undefined = \":\";\n\n/** Sets the process-wide tagged-id format during metadata boot. */\nexport function setTaggedIdDelimiter(delimiter: string | undefined): void {\n  tagDelimiter = delimiter;\n}\n\n// I'm not entirely sure this is still necessary, but use a small subset of EntityMetadata so\n// that this file doesn't have to import the type and potentially create import cycles.\ntype HasTagName = {\n  tagName: string;\n  /** The database column type, i.e. used to do `::type` casts in Postgres. */\n  idDbType: \"bigint\" | \"int\" | \"uuid\" | \"text\";\n};\n\n/** Converts our internal/always-tagged `id` to the domain entity's `id` type (could be a number or uuid). */\nexport function toIdOf<T extends Entity>(meta: EntityMetadata<T>, id: TaggedId | undefined): IdOf<T> | undefined {\n  if (!id) return undefined;\n  switch (meta.idType) {\n    case \"number\":\n      return Number(deTagId(meta, id)) as IdOf<T>;\n    case \"tagged-string\":\n      return id as IdOf<T>;\n    case \"untagged-string\":\n      return deTagId(meta, id) as IdOf<T>;\n    default:\n      return assertNever(meta.idType);\n  }\n}\n\n// Before a referred-to object is saved, we keep its instance in our data\n// map, and then assume it will be persisted before we're asked to persist\nexport function maybeResolveReferenceToId(\n  value: Entity | Reference<any, any, any> | string | undefined,\n): TaggedId | undefined {\n  return typeof value === \"string\" ? value : value?.idTaggedMaybe;\n}\n\n/** Converts `value` to a number, i.e. for string ids, unless its undefined. */\nexport function keyToNumber(meta: HasTagName, value: string | number): number;\nexport function keyToNumber(meta: HasTagName, value: string | number | undefined): number | undefined;\nexport function keyToNumber(meta: HasTagName, value: any): number | undefined {\n  if (value === undefined || value === null) {\n    return undefined;\n  } else if (typeof value === \"number\") {\n    return value;\n  } else if (typeof value === \"string\") {\n    if (tagDelimiter === undefined) {\n      const id = value.startsWith(meta.tagName) ? value.slice(meta.tagName.length) : value;\n      return maybeNumberUnlessUuid(meta, id);\n    }\n    const delimiterIndex = value.indexOf(tagDelimiter);\n    if (delimiterIndex === -1) {\n      return maybeNumberUnlessUuid(meta, value);\n    }\n    const tag = value.slice(0, delimiterIndex);\n    if (tag !== meta.tagName) {\n      throw new Error(`Invalid tagged id, expected tag ${meta.tagName}, got ${value}`);\n    }\n    return maybeNumberUnlessUuid(meta, value.slice(delimiterIndex + tagDelimiter.length));\n  } else {\n    throw new Error(`Invalid key ${value}`);\n  }\n}\n\n// UUIDs, text, and bigints are strings at the database boundary, so lie to the type system and pretend they're numbers.\nfunction maybeNumberUnlessUuid(meta: HasTagName, key: string): number {\n  switch (meta.idDbType) {\n    case \"bigint\":\n    case \"uuid\":\n    case \"text\":\n      return key as any;\n    case \"int\":\n      return Number(key);\n    default:\n      assertNever(meta.idDbType);\n  }\n}\n\n/** Converts `dbValue` (big int, int, uuid) to a tagged string, unless its undefined. */\nexport function keyToTaggedId(meta: HasTagName, dbValue: string | number): TaggedId | undefined {\n  if (dbValue === undefined || dbValue === null) return undefined;\n  return `${meta.tagName}${tagDelimiter ?? \"\"}${dbValue}`;\n}\n\n/** Fails if any keys are untagged; internal batch-loader keys must always be tagged. */\nexport function assertIdsAreTagged(keys: readonly string[]): void {\n  for (const key of keys) {\n    const isTagged = tagDelimiter === undefined ? validSlugId.test(key) : key.indexOf(tagDelimiter) !== -1;\n    if (!isTagged) throw new Error(`Key ${key} is missing a tag`);\n  }\n}\n\nconst validSlugId = /^([a-z]+)(\\d+)$/i;\nconst uuidIshId = /[0-9a-z-]+/i;\n\n/** Returns whether `id` is tagged and a probably-correct value. */\nexport function isTaggedId(id: string | number): boolean;\n/** Returns whether `id` is tagged and the tag matches `meta`'s tag. */\nexport function isTaggedId(meta: EntityMetadata, id: string): boolean;\nexport function isTaggedId(metaOrId: string | number | HasTagName, id?: string): boolean {\n  if (typeof metaOrId === \"number\") {\n    // number overload\n    return false;\n  } else if (typeof metaOrId === \"string\") {\n    // string overload\n    return tagDelimiter === undefined ? validSlugId.test(metaOrId) : hasTagDelimiter(metaOrId);\n  } else {\n    // meta + string overload\n    return isTaggedIdForMeta(metaOrId, id!);\n  }\n}\n\nexport function assertIdIsTagged(id: string): void {\n  if (!isTaggedId(id)) {\n    throw new Error(`Key is not tagged ${id}`);\n  }\n}\n\n/** We accept an entity in case this is m2o storing a not-yet-saved entity. */\nexport function toTaggedId(meta: HasTagName, id: IdType): TaggedId;\nexport function toTaggedId(meta: HasTagName, id: IdType | undefined): TaggedId | undefined;\nexport function toTaggedId(meta: HasTagName, id: IdType | undefined): TaggedId | undefined {\n  if (typeof id === \"number\") {\n    return `${meta.tagName}${tagDelimiter ?? \"\"}${id}`;\n  } else if (typeof id === \"string\") {\n    // This seems odd, but is covered by a unit test, so I guess we need it?\n    if (id === \"\") return undefined;\n    if (tagDelimiter === undefined) {\n      const tag = validSlugId.exec(id)?.[1];\n      if (tag && tag !== meta.tagName) {\n        throw new Error(`Invalid tagged id, expected tag ${meta.tagName}, got ${id}`);\n      }\n      return tag ? id : `${meta.tagName}${id}`;\n    } else {\n      const i = id.indexOf(tagDelimiter);\n      if (i === -1) return `${meta.tagName}${tagDelimiter}${id}`;\n      const tag = id.slice(0, i);\n      if (tag !== meta.tagName) {\n        throw new Error(`Invalid tagged id, expected tag ${meta.tagName}, got ${id}`);\n      }\n    }\n  }\n  return id;\n}\n\n/** Similar to `toTaggedId`, but we accept an entity for handling relations to not-yet-saved entities. */\nexport function ensureTagged<T extends Entity>(\n  meta: HasTagName,\n  value: T | string | number | undefined,\n): T | TaggedId | undefined {\n  return isEntity(value) ? value : toTaggedId(meta, value);\n}\n\n/** Tags a potentially untagged id, while our API inputs still accept either tagged or untagged ids. */\nexport function tagId(meta: HasTagName, id: string | number): string;\nexport function tagId(cstr: EntityConstructor<any>, id: string | number): string;\nexport function tagId(meta: HasTagName, id: string | number | null | undefined): string | undefined;\nexport function tagId(cstr: EntityConstructor<any>, id: string | number | null | undefined): string | undefined;\nexport function tagId(\n  metaOrCstr: HasTagName | EntityConstructor<any>,\n  id: string | number | null | undefined,\n): string | undefined {\n  const meta = metadata(metaOrCstr);\n  const tag = meta.tagName;\n  if (typeof id === \"number\") {\n    return `${tag}${tagDelimiter ?? \"\"}${id}`;\n  }\n  if (id === null || id === undefined) {\n    return undefined;\n  }\n  if (tagDelimiter === undefined) {\n    const existingTag = validSlugId.exec(id)?.[1];\n    if (existingTag && existingTag !== tag) {\n      throw new Error(`Invalid tagged id, expected tag ${tag}, got ${id}`);\n    }\n    return existingTag ? id : `${tag}${id}`;\n  }\n  // Avoid using includes/split, for a faster indexOf + length + startsWith\n  const delimiterIndex = id.indexOf(tagDelimiter);\n  if (delimiterIndex !== -1) {\n    if (delimiterIndex !== tag.length || !id.startsWith(tag)) {\n      throw new Error(`Invalid tagged id, expected tag ${tag}, got ${id}`);\n    }\n    return id;\n  }\n  return `${tag}${tagDelimiter}${id}`;\n}\n\n/** Adds the tag prefixes. */\nexport function tagIds(meta: HasTagName, keys: readonly (string | number)[]): readonly string[];\nexport function tagIds(cstr: EntityConstructor<any>, keys: readonly (string | number)[]): readonly string[];\nexport function tagIds(\n  metaOrCstr: HasTagName | EntityConstructor<any>,\n  keys: readonly (string | number)[],\n): readonly string[] {\n  return keys.map((k) => tagId(metaOrCstr as any, k));\n}\n\nexport function deTagId(meta: HasTagName, id: string | number): string;\nexport function deTagId(meta: HasTagName, id: string | number | undefined): string | undefined;\nexport function deTagId(entity: Entity): string;\nexport function deTagId(entityOrMeta: Entity | HasTagName, id?: string | number): string | undefined {\n  const meta = entityOrMeta instanceof BaseEntity ? getMetadata(entityOrMeta) : (entityOrMeta as HasTagName);\n  id = id ?? (entityOrMeta as Entity).id;\n  return id === undefined ? undefined : keyToNumber(meta, id).toString();\n}\n\n/** Removes the tag prefixes so we can use the keys for SQL operations. */\nexport function deTagIds(meta: HasTagName, keys: readonly string[]): readonly string[] {\n  const deTagged = Array(keys.length);\n  for (let i = 0; i < keys.length; i++) deTagged[i] = deTagId(meta, keys[i]);\n  return deTagged;\n}\n\n/** Removes the tag prefixes so we can use the keys for SQL operations. */\nexport function unsafeDeTagIds(keys: readonly string[]): readonly string[] {\n  const deTagged = Array(keys.length);\n  for (let i = 0; i < keys.length; i++) {\n    if (tagDelimiter === undefined) {\n      deTagged[i] = validSlugId.exec(keys[i])?.[2];\n    } else {\n      const delimiterIndex = keys[i].indexOf(tagDelimiter);\n      deTagged[i] = delimiterIndex === -1 ? undefined : keys[i].slice(delimiterIndex + tagDelimiter.length);\n    }\n  }\n  return deTagged;\n}\n\n/** Given a tagged id, returns its tag. */\nexport function tagFromId(id: string): string {\n  if (tagDelimiter === undefined) {\n    return validSlugId.exec(id)?.[1] ?? fail(`Unknown tagged id format: \"${id}\"`);\n  }\n  const delimiterIndex = id.indexOf(tagDelimiter);\n  return delimiterIndex > 0 && delimiterIndex + tagDelimiter.length < id.length\n    ? id.slice(0, delimiterIndex)\n    : fail(`Unknown tagged id format: \"${id}\"`);\n}\n\n/** Returns the metadata needed to format an id. */\nfunction metadata(metaOrCstr: HasTagName | EntityConstructor<any>): HasTagName {\n  return typeof metaOrCstr === \"function\" ? getMetadata(metaOrCstr) : metaOrCstr;\n}\n\n/** Returns whether `id` has the tag and database id shape required by `meta`. */\nfunction isTaggedIdForMeta(meta: HasTagName, id: string): boolean {\n  if (tagDelimiter === undefined) {\n    return validSlugId.exec(id)?.[1] === meta.tagName;\n  }\n  const delimiterIndex = id.indexOf(tagDelimiter);\n  if (delimiterIndex === -1) return false;\n  const tag = id.slice(0, delimiterIndex);\n  const untaggedId = id.slice(delimiterIndex + tagDelimiter.length);\n  if (meta.tagName !== tag) return false;\n  switch (meta.idDbType) {\n    case \"int\":\n    case \"bigint\":\n      return !Number.isNaN(Number(untaggedId));\n    case \"uuid\":\n      return uuidIshId.test(untaggedId);\n    case \"text\":\n      return true;\n    default:\n      return assertNever(meta.idDbType);\n  }\n}\n\n/** Returns whether `id` has a non-empty tag and value separated by the configured delimiter. */\nfunction hasTagDelimiter(id: string): boolean {\n  if (tagDelimiter === undefined) return false;\n  const delimiterIndex = id.indexOf(tagDelimiter);\n  return delimiterIndex > 0 && delimiterIndex + tagDelimiter.length < id.length;\n}\n"],"mappings":"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"}