joist-core 2.3.0 → 2.4.0

package/build/index.d.cts

@@ -0,0 +1,180 @@
+import { ActualFactoryOpts, ColumnsOf, EntityOf, FactoryExtrasOf, FieldsOf, FilterOf, GraphQLFilterOf, InheritanceTypeOf, OptIdsOf, OptsOf, OrderOf, RelationsOf, RootTypeNameOf, TypeMap, TypeMapEntry, TypeNameOf } from "./typeMap.cjs";
+import { Changes, EntityChanges, EnumCollectionFieldStatus, FieldStatus, ManyToManyFieldStatus, ManyToOneFieldStatus, OneToManyFieldStatus, PrimitiveFieldStatus, newChangesProxy } from "./changes.cjs";
+import { deepNormalizeHint, normalizeHint } from "./normalizeHints.cjs";
+import { Collection, LoadedCollection, isCollection, isLoadedCollection } from "./relations/Collection.cjs";
+import { AbstractRelationImpl } from "./relations/AbstractRelationImpl.cjs";
+import { CustomCollection, hasCustomCollection } from "./relations/CustomCollection.cjs";
+import { EnumMetadata } from "./EnumMetadata.cjs";
+import { EnumCollection, EnumCollectionImpl, LoadedEnumCollection, hasEnumCollection } from "./relations/EnumCollection.cjs";
+import { CustomReference, hasCustomReference } from "./relations/CustomReference.cjs";
+import { AsyncMethod, LoadedMethod, hasAsyncMethod } from "./relations/hasAsyncMethod.cjs";
+import { LoadedProperty, Property, PropertyImpl, hasProperty, hasReactiveProperty, isLoadedProperty, isProperty } from "./relations/hasProperty.cjs";
+import { AsyncProperty, AsyncPropertyImpl, hasAsyncProperty, isAsyncProperty, isLoadedAsyncProperty } from "./relations/AsyncProperty.cjs";
+import { LazyField, LazyFieldImpl, hasLazyField, isLazyField, isLoadedLazyField } from "./relations/LazyField.cjs";
+import { hasManyDerived } from "./relations/hasManyDerived.cjs";
+import { hasManyThrough } from "./relations/hasManyThrough.cjs";
+import { LoadedReference, Reference, isLoadedReference, isReference } from "./relations/Reference.cjs";
+import { hasOneDerived } from "./relations/hasOneDerived.cjs";
+import { hasOneThrough } from "./relations/hasOneThrough.cjs";
+import { Relation, isRelation } from "./relations/Relation.cjs";
+import { LargeCollection } from "./relations/LargeCollection.cjs";
+import { ManyToManyCollection, hasManyToMany } from "./relations/ManyToManyCollection.cjs";
+import { ManyToManyLargeCollection, hasLargeManyToMany } from "./relations/ManyToManyLargeCollection.cjs";
+import { ManyToOneReference, ManyToOneReferenceImpl, hasOne, isManyToOneReference } from "./relations/ManyToOneReference.cjs";
+import { OneToManyCollection, hasMany } from "./relations/OneToManyCollection.cjs";
+import { OneToManyLargeCollection, hasLargeMany } from "./relations/OneToManyLargeCollection.cjs";
+import { OneToOneReference, OneToOneReferenceImpl, hasOneToOne, isLoadedOneToOneReference, isOneToOneReference } from "./relations/OneToOneReference.cjs";
+import { PolymorphicReference, PolymorphicReferenceImpl, hasOnePolymorphic, isPolymorphicReference } from "./relations/PolymorphicReference.cjs";
+import { ReactiveField, hasReactiveField, isReactiveField } from "./relations/ReactiveField.cjs";
+import { ReactiveGetter, hasReactiveGetter, isReactiveGetter } from "./relations/ReactiveGetter.cjs";
+import { ReactiveManyToMany, ReactiveManyToManyImpl, hasReactiveManyToMany, isReactiveManyToMany } from "./relations/ReactiveManyToMany.cjs";
+import { JoinRowTodo, Todo } from "./flush/Todo.cjs";
+import { ReactionLogger, setReactionLogging } from "./logging/ReactionLogger.cjs";
+import { JoinColumnValue, JoinRow, JoinRowOperation, ManyToManyLike } from "./flush/JoinRows.cjs";
+import { ReactiveManyToManyOtherSide, ReactiveManyToManyOtherSideImpl, hasReactiveManyToManyOtherSide, isReactiveManyToManyOtherSide } from "./relations/ReactiveManyToManyOtherSide.cjs";
+import { hasAsyncReactiveField, isAsyncReactiveField } from "./relations/AsyncReactiveField.cjs";
+import { ReactiveReference, ReactiveReferenceImpl, hasReactiveReference, isReactiveReference } from "./relations/ReactiveReference.cjs";
+import { LoadedReadOnlyCollection, ReadOnlyCollection, isLoadedReadOnlyCollection, isReadOnlyCollection } from "./relations/ReadOnlyCollection.cjs";
+import { RecursiveCycleError } from "./relations/RecursiveCycleError.cjs";
+import { hasRecursiveChildren, hasRecursiveM2m, hasRecursiveParents } from "./relations/RecursiveCollection.cjs";
+import "./relations/index.cjs";
+import { CrossJoinTable, JoinTable, LateralJoinTable, ParsedCteClause, ParsedFindQuery, ParsedGroupBy, ParsedOrderBy, ParsedSelect, ParsedTable, PrimaryTable, addTablePerClassJoinsAndClassTag, findFilterField, getTables, maybeAddIdNotNulls, maybeAddOrderBy, parseAlias, parseFindQuery } from "./queries/find/QueryParser.cjs";
+import { ColumnCondition, ExistsCondition, ParsedExpressionCondition, ParsedExpressionFilter, ParsedValueFilter, RawCondition } from "./queries/parsedConditions.cjs";
+import { AndCondition, ConditionGroup, DomainPredicate, OrCondition, PredicateBrand, SqlCondition, SqlPredicate } from "./queries/conditions.cjs";
+import { Alias, AliasBrand, AliasColumn, AliasMgmt, EntityAlias, PolyAlias, PrimitiveAlias, alias, aliases, getAliasMetadata, getAliasMgmt, getMaybeCtiAlias, isAlias, newAliasProxy } from "./queries/find/Aliases.cjs";
+import { BooleanGraphQLFilter, EntityGraphQLFilter, GraphQLFilterAndSettings, GraphQLFilterWithAlias, Operator, ValueGraphQLFilter, opToFn, operators } from "./queries/find/EntityGraphQLFilter.cjs";
+import { AliasFn, ResolvedScope, Scope, ScopeFilterFragment, ScopeFn, ScopeJoinFilter, ScopeQuery, isScope, isScopeJoinFilter, isSelectAllFilter, newScopeFn, resolveScope } from "./queries/find/scopes.cjs";
+import { BooleanFilter, EntityFilter, EntityFilterObject, ExpressionCondition, ExpressionFilter, FilterAndSettings, FilterWithAlias, FindFilter, OrderBy, UniqueFilter, ValueFilter, mergeFindOptions } from "./queries/find/EntityFilter.cjs";
+import { abbreviation, asNew, assertNever, cleanSql, cleanStringValue, fail, failIfAnyRejected, indexBy, partition, zeroTo } from "./utils.cjs";
+import { DeepNew, LoadHint, Loadable, Loaded, MarkLoaded, NestedLoadHint, New, RelationsIn, assertLoaded, ensureLoaded, isLoaded, isNew, maybePopulateThen, unsafeLoaded } from "./loading/loadHints.cjs";
+import { Reactable, Reacted, ReactiveHint, ReactiveTarget, convertToLoadHint, isTypeOrSubType, reverseReactiveHint } from "./reactivity/reactiveHints.cjs";
+import { GenericError, ValidationCode, ValidationError, ValidationErrors, ValidationRule, ValidationRuleInternal, ValidationRuleResult, cannotBeChanged, cannotBeUpdated, maxValueRule, minValueRule, mustBeSubType, newRequiredLazyFieldRule, newRequiredRule, rangeValueRule } from "./rules.cjs";
+import { ConfigApi, EntityHook, resetBootFlag } from "./config.cjs";
+import { Temporal, maybeRequireTemporal, requireTemporal } from "./serde/temporal.cjs";
+import { BigIntSerde, CustomSerde, CustomSerdeAdapter, DateSerde, DecimalToNumberSerde, EnumArrayFieldSerde, EnumFieldSerde, JsonSerde, KeySerde, PlainDateSerde, PlainDateTimeSerde, PlainTimeSerde, PrimitiveSerde, ScalarCodec, SuperstructSerde, TimestampCodec, ZodSerde, ZonedDateTimeSerde } from "./serde/serde.cjs";
+import { Column, ColumnDescriptors } from "./serde/columns.cjs";
+import { DeleteOp, InsertFixup, InsertOp, OpColumn, UpdateOp, generateOps } from "./drivers/EntityWriter.cjs";
+import { PojoRowData, RowData, emptyRowData } from "./RowData.cjs";
+import { FieldColumn, FieldSerde, PolyComponent, PolymorphicKeySerde, SimpleFieldSerde, TimestampSerde, hasSerde, polymorphicField } from "./serde/fieldSerde.cjs";
+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.cjs";
+import { getDefaultDependencies } from "./defaults.cjs";
+import { Lens, getLens, getLensPath, isAllSqlPaths, isLensLoaded, isLensLoadedPath, lensPathToLoadHint, lensToLoadHint, lensToPath, loadLens, loadLensPath, mapPathsToTarget } from "./loading/loadLens.cjs";
+import { partitionHint } from "./preloading/partitionHint.cjs";
+import { SubqueryRenderer, buildValueCondition, buildWhereClause } from "./queries/renderConditions.cjs";
+import { AliasAssigner } from "./queries/sql/AliasAssigner.cjs";
+import { CaseElse, CaseWhen } from "./queries/sql/expressions/case.cjs";
+import { ExprFromInput, ExprInput } from "./queries/sql/expressions/types.cjs";
+import { expr } from "./queries/sql/expressions/expression.cjs";
+import { CustomColumnConfig, CustomColumnInput, CustomColumnInputs, CustomColumnType, CustomTable, CustomTableDefinition, CustomTableFor, declareTable } from "./queries/sql/custom.cjs";
+import { CollectionJoin, EntityColumn, PolyReference, PrimitiveColumn, ReferenceColumn, ReferenceJoin, Table, TableBrand, TableFilter, TableFor, TableMgmt, TableSourceBrand, TableSourceMgmt, getTableMetadata, getTableMgmt, isTable, newTableProxy, table, tableMgmt, tables } from "./queries/sql/Tables.cjs";
+import { CheckScope, Clauses, EntityQuery, ExistsQuery, ExpressionOrderBy, MaybeNull, NameOf, NotWidened, OrderByDirection, OrderByKeys, Query, QueryArg, QueryCondition, QueryJoin, QueryJoinInput, QueryJoinList, QueryRow, QuerySelect, QuerySource, QueryValue, RecursiveOptions, ResolvedJoins, ScalarQuery, SetQuery, Subquery, SubqueryBrand, WithInput, WithSource, entityQueryBrand, query, queryMaybe, recursiveQuery, sql, subqueryBrand } from "./queries/sql/query.cjs";
+import { ArrayAggOptions, Expr, ExprBrand, ExprLike, InnerJoin, LeftJoin, exprBrand } from "./queries/sql/Expr.cjs";
+import { JoinTree } from "./queries/sql/JoinTree.cjs";
+import { ConditionBuilder } from "./queries/ConditionBuilder.cjs";
+import { EntityField, EntityFields, SettableFields } from "./EntityFields.cjs";
+import { EntityOrId, HintNode } from "./loading/HintTree.cjs";
+import { JoinResult, PreloadHydrator, PreloadPlugin } from "./plugins/PreloadPlugin.cjs";
+import { Driver, DriverQueryResult } from "./drivers/Driver.cjs";
+import { DeleteStatement, ExecuteResult, InsertStatement, InsertValues, MutationReturning, MutationStatement, UpdateStatement, UpdateValues } from "./queries/sql/execute.cjs";
+import { skipCondition } from "./queries/skipCondition.cjs";
+import { InstanceData } from "./InstanceData.cjs";
+import { PendingChange, PendingCreate, PendingDelete, PendingM2M, PendingUpdate } from "./flush/PendingChanges.cjs";
+import { Plugin } from "./PluginManager.cjs";
+import { buildCteSql, buildRawQuery } from "./queries/find/buildFindQuery.cjs";
+import { ParsedEntityFilter, makeLike, mapToDb, parseEntityFilter, parseValueFilter } from "./queries/valueFilters.cjs";
+import { filterSoftDeletes, lazyExcludedSelects, maybeAddNotSoftDeleted, stiSubtypeFilter } from "./queries/entityQueryUtils.cjs";
+import { optimizeCollectionJoins } from "./queries/find/QueryParser.collectionJoins.cjs";
+import { visitConditions } from "./queries/find/QueryVisitor.cjs";
+import { configureMetadata, getConstructorFromTaggedId, getMetadataForTable, getMetadataForType, maybeGetConstructorFromReference } from "./configure.cjs";
+import { RuntimeConfig, getRuntimeConfig, setRuntimeConfig } from "./runtimeConfig.cjs";
+import { driverApi } from "./drivers/driverApi.cjs";
+import { IdAssigner, RandomUuidAssigner, SequenceIdAssigner, TestUuidAssigner } from "./drivers/IdAssigner.cjs";
+import "./drivers/index.cjs";
+import { getField, isChangeableField, isFieldSet, setField } from "./fields.cjs";
+import { lazyField } from "./newEntity.cjs";
+import { UnknownProperty, getLazyFields, getProperties } from "./getProperties.cjs";
+import { CustomJsonKeyHint, EntityKeyJsonHint, JsonHint, JsonPayload, Jsonable, JsonableValue, NestedJsonHint, ToJsonHint, toJSON } from "./json.cjs";
+import { assertIdIsTagged, assertIdsAreTagged, deTagId, deTagIds, ensureTagged, isTaggedId, keyToNumber, keyToTaggedId, maybeResolveReferenceToId, setTaggedIdDelimiter, tagFromId, tagId, tagIds, taggedIdPrefix, toIdOf, toTaggedId, unsafeDeTagIds } from "./keys.cjs";
+import { kq, kqDot, kqStar } from "./queries/sql/keywords.cjs";
+import { FactoryEntityOpt, FactoryOpts, defaultValue, factories, getTestIndex, isFactoryCreation, maybeBranchValue, maybeNew, maybeNewPoly, newTestInstance, noValue, setFactoryLogging, testIndex } from "./newTestInstance.cjs";
+import { setFactoryWriter } from "./logging/FactoryLogger.cjs";
+import { FieldLogger, FieldLoggerWatch, WriteFn, noopFieldLogger } from "./logging/FieldLogger.cjs";
+import { ImmutableEntitiesPlugin } from "./plugins/ImmutableEntitiesPlugin.cjs";
+import { JsonAggregatePreloader } from "./preloading/JsonAggregatePreloader.cjs";
+import { nowUTC } from "./nowUTC.cjs";
+import { plainDateMapper, plainDateTimeMapper, plainTimeMapper, zonedDateTimeMapper } from "./serde/temporalMappers.cjs";
+import { isInTrustedContext, runInTrustedContext } from "./trusted.cjs";
+import { buildUnnestCte, ensureRectangularArraySizes } from "./queries/unnest.cjs";
+import { DeepPartialOrNull, updatePartial, upsert } from "./upsert.cjs";
+import { StubbedRelation, WithLoaded, ensureWithLoaded, withLoaded } from "./loading/withLoaded.cjs";
+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.cjs";
+import { Entity, IdType, isEntity } from "./Entity.cjs";
+import { BaseEntity, getInstanceData } from "./BaseEntity.cjs";
+import { newPgConnectionConfig } from "joist-utils";
+//#region src/index.d.ts
+declare const testing: {
+  isAllSqlPaths: typeof isAllSqlPaths;
+  getDefaultDependencies: typeof getDefaultDependencies;
+  partitionHint: typeof partitionHint;
+};
+declare const internals: {
+  buildWhereClause: typeof buildWhereClause;
+};
+interface Flavoring<FlavorT> {
+  _type?: FlavorT;
+}
+type Flavor<T, FlavorT> = T & Flavoring<FlavorT>;
+/**
+ * Sets each value in `values` on the current entity.
+ *
+ * The default behavior is that passing a value as either `null` or `undefined` will set
+ * the field as `undefined`, i.e. automatic `null` to `undefined` conversion.
+ *
+ * However, if you pass `ignoreUndefined: true`, then any opt that is `undefined` will be treated
+ * as "do not set", and `null` will still mean "set to `undefined`". This is useful for implementing
+ * APIs were an input of `undefined` means "do not set / noop" and `null` means "unset".
+ *
+ * Note that constructors _always_ call this method, but if the call is coming from `em.hydrate`, we
+ * use `values` being a primary key to short-circuit and let hydration callers assign the values
+ * returned by the serde `fromRow` methods.
+ */
+declare function setOpts<T extends Entity>(entity: T, values: Partial<OptsOf<T>> | undefined, opts?: {
+  partial?: boolean;
+  calledFromConstructor?: boolean;
+}): void;
+/**
+ * Applies some standard behavior & protections to `entity[key] = value`. I.e.
+ *
+ * - We don't set over AsyncProperties/relations/etc., and instead call current.set(value)
+ * - We catch missing/invalid field names
+ * - We handle FactoryInitialValues
+ */
+declare function setOpt<T extends Entity>(meta: EntityMetadata<T>, entity: T, key: string, _value: any, partial?: boolean, calledFromConstructor?: boolean): void;
+declare function ensureNotDeleted(entity: Entity, ignore?: "pending"): void;
+/** Adds `null` to every key in `T` to accept partial-update-style input. */
+type PartialOrNull<T> = { [P in keyof T]?: T[P] | null; };
+declare function getRequiredKeys<T extends Entity>(entity: T): string[];
+declare function getRequiredKeys<T extends Entity>(type: EntityConstructor<T>): string[];
+declare function getRelations(entity: Entity): AbstractRelationImpl<any, any>[];
+declare function getRelationEntries(entity: Entity): [string, AbstractRelationImpl<any, any>][];
+/** Casts a "maybe abstract" cstr to a concrete cstr when the calling code knows it's safe. */
+declare function asConcreteCstr<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>): EntityConstructor<T>;
+/**
+ * Thrown when `.id` is accessed on an entity that does not have an id yet.
+ *
+ * For Postgres, entities are actually allowed to have ids pre-INSERT, if you call
+ * `em.assignNewIds()`. Other databases typically require INSERTs to trigger the auto
+ * id assignment.
+ */
+declare class NoIdError extends Error {}
+/** Throws a `NoIdError` for `entity`, i.e. because `id` was called before being saved. */
+declare function failNoIdYet(entity: string): never;
+/**
+ * Add a static function since getters can't have type guards.
+ *
+ * See https://github.com/microsoft/TypeScript/issues/43368
+ */
+declare function isNewEntity<T extends Entity>(entity: T): entity is New<T>;
+//#endregion
+export { type ActualFactoryOpts, type Alias, AliasAssigner, type AliasBrand, type AliasColumn, AliasFn, type AliasMgmt, type AndCondition, type ArrayAggOptions, type AsyncMethod, type AsyncProperty, AsyncPropertyImpl, BaseEntity, BigIntSerde, BooleanFilter, BooleanGraphQLFilter, type CaseElse, type CaseWhen, Changes, type CheckScope, type Clauses, type Collection, type CollectionJoin, Column, type ColumnCondition, ColumnDescriptors, type ColumnsOf, ConditionBuilder, type ConditionGroup, ConfigApi, CrossJoinTable, CustomCollection, type CustomColumnConfig, type CustomColumnInput, type CustomColumnInputs, type CustomColumnType, CustomJsonKeyHint, CustomReference, CustomSerde, CustomSerdeAdapter, type CustomTable, type CustomTableDefinition, type CustomTableFor, DateSerde, DecimalToNumberSerde, type DeepNew, type DeepPartialOrNull, DeleteOp, type DeleteStatement, type DomainPredicate, type Driver, type DriverQueryResult, type Entity, type EntityAlias, EntityChanges, type EntityColumn, EntityConstructor, type EntityField, type EntityFields, EntityFilter, EntityFilterObject, EntityGraphQLFilter, type EntityHook, EntityKeyJsonHint, EntityManager, EntityManagerHook, EntityManagerInternalApi, EntityManagerMode, EntityManagerOpts, EntityMetadata, type EntityOf, type EntityOrId, type EntityQuery, EnumArrayFieldSerde, type EnumCollection, EnumCollectionFieldStatus, EnumCollectionImpl, EnumField, EnumFieldSerde, type EnumMetadata, type ExecuteResult, type ExistsCondition, type ExistsQuery, type Expr, type ExprBrand, type ExprFromInput, type ExprInput, type ExprLike, ExpressionCondition, ExpressionFilter, type ExpressionOrderBy, type FactoryEntityOpt, type FactoryExtrasOf, type FactoryOpts, Field, FieldColumn, FieldLogger, FieldLoggerWatch, FieldSerde, FieldStatus, type FieldsOf, FilterAndSettings, type FilterOf, FilterWithAlias, FindCountFilterOptions, FindFilter, FindFilterOptions, FindGqlFilterOptions, FindOperation, Flavor, FlushOptions, type GenericError, GraphQLFilterAndSettings, type GraphQLFilterOf, GraphQLFilterWithAlias, type HintNode, IdAssigner, IdOf, type IdType, ImmutableEntitiesPlugin, type InheritanceTypeOf, type InnerJoin, InsertFixup, InsertOp, type InsertStatement, type InsertValues, InstanceData, type JoinColumnValue, type JoinResult, type JoinRow, JoinRowOperation, type JoinRowTodo, JoinTable, type JoinTree, JsonAggregatePreloader, JsonHint, JsonPayload, JsonSerde, Jsonable, JsonableValue, KeySerde, type LargeCollection, LargeOneToManyField, LateralJoinTable, type LazyField, LazyFieldImpl, type LeftJoin, Lens, type LoadHint, type Loadable, type Loaded, type LoadedCollection, type LoadedEnumCollection, type LoadedMethod, type LoadedProperty, type LoadedReadOnlyCollection, type LoadedReference, LoaderCache, ManyToManyCollection, ManyToManyEnumField, ManyToManyField, ManyToManyFieldStatus, ManyToManyLargeCollection, type ManyToManyLike, ManyToOneField, ManyToOneFieldStatus, type ManyToOneReference, ManyToOneReferenceImpl, type MarkLoaded, MaybeAbstractEntityConstructor, type MaybeNull, type MutationReturning, type MutationStatement, type NameOf, NestedJsonHint, type NestedLoadHint, type New, NoIdError, NotFoundError, type NotWidened, OneToManyCollection, OneToManyField, OneToManyFieldStatus, OneToManyLargeCollection, OneToOneField, type OneToOneReference, OneToOneReferenceImpl, OpColumn, Operator, type OptIdsOf, type OptsOf, type OrCondition, OrderBy, type OrderByDirection, type OrderByKeys, type OrderOf, ParsedCteClause, type ParsedEntityFilter, type ParsedExpressionCondition, type ParsedExpressionFilter, ParsedFindQuery, ParsedGroupBy, ParsedOrderBy, ParsedSelect, ParsedTable, type ParsedValueFilter, PartialOrNull, type PendingChange, type PendingCreate, type PendingDelete, type PendingM2M, type PendingUpdate, PlainDateSerde, PlainDateTimeSerde, PlainTimeSerde, Plugin, PojoRowData, type PolyAlias, PolyComponent, type PolyReference, PolymorphicField, PolymorphicFieldComponent, PolymorphicKeySerde, type PolymorphicReference, PolymorphicReferenceImpl, type PredicateBrand, type PreloadHydrator, type PreloadPlugin, PrimaryKeyField, PrimaryTable, type PrimitiveAlias, type PrimitiveColumn, PrimitiveField, PrimitiveFieldStatus, PrimitiveSerde, type Property, PropertyImpl, type Query, type QueryArg, type QueryCondition, type QueryJoin, type QueryJoinInput, type QueryJoinList, type QueryRow, type QuerySelect, type QuerySource, type QueryValue, RandomUuidAssigner, type RawCondition, type Reactable, type Reacted, ReactionLogger, type ReactiveField, type ReactiveGetter, type ReactiveHint, type ReactiveManyToMany, ReactiveManyToManyImpl, type ReactiveManyToManyOtherSide, ReactiveManyToManyOtherSideImpl, type ReactiveReference, ReactiveReferenceImpl, type ReactiveTarget, type ReadOnlyCollection, ReadOnlyError, RecursiveCycleError, type RecursiveOptions, type Reference, type ReferenceColumn, type ReferenceJoin, type Relation, type RelationsIn, type RelationsOf, type ResolvedJoins, ResolvedScope, type RootTypeNameOf, RowData, type RuntimeConfig, ScalarCodec, type ScalarQuery, Scope, ScopeFilterFragment, ScopeFn, ScopeJoinFilter, ScopeQuery, SequenceIdAssigner, SerdeField, type SetQuery, type SettableFields, SimpleFieldSerde, type SqlCondition, type SqlPredicate, StubbedRelation, type Subquery, type SubqueryBrand, SubqueryRenderer, SuperstructSerde, type Table, type TableBrand, type TableFilter, type TableFor, type TableMgmt, type TableSourceBrand, type TableSourceMgmt, TaggedId, Temporal, TestUuidAssigner, TimestampCodec, TimestampFields, TimestampSerde, ToJsonHint, Todo, TooManyError, type TypeMap, type TypeMapEntry, type TypeNameOf, UniqueFilter, UnknownProperty, UpdateOp, type UpdateStatement, type UpdateValues, ValidationCode, type ValidationError, ValidationErrors, type ValidationRule, type ValidationRuleInternal, type ValidationRuleResult, ValueFilter, ValueGraphQLFilter, type WithInput, type WithLoaded, type WithSource, WriteFn, ZodSerde, ZonedDateTimeSerde, abbreviation, addTablePerClassJoinsAndClassTag, alias, aliases, appendStack, asConcreteCstr, asNew, assertIdIsTagged, assertIdsAreTagged, assertLoaded, assertNever, buildCteSql, buildRawQuery, buildUnnestCte, buildValueCondition, buildWhereClause, cannotBeChanged, cannotBeUpdated, cleanSql, cleanStringValue, configureMetadata, convertToLoadHint, createRowFromEntityData, deTagId, deTagIds, declareTable, deepNormalizeHint, defaultValue, driverAfterBegin, driverAfterCommit, driverApi, driverBeforeBegin, driverBeforeCommit, emptyRowData, ensureLoaded, ensureNotDeleted, ensureRectangularArraySizes, ensureTagged, ensureWithLoaded, entityQueryBrand, expr, exprBrand, factories, fail, failIfAnyRejected, failNoIdYet, filterSoftDeletes, findFilterField, generateOps, getAliasMetadata, getAliasMgmt, getBaseAndSelfMetas, getBaseMeta, getBaseSelfAndSubMetas, getConstructorFromTaggedId, getDefaultEntityLimit, getEmInternalApi, getField, getInstanceData, getLazyFields, getLens, getLensPath, getMaybeCtiAlias, getMetadata, getMetadataForField, getMetadataForTable, getMetadataForType, getProperties, getRelationEntries, getRelations, getRequiredKeys, getRuntimeConfig, getSubMetas, getTableMetadata, getTableMgmt, getTables, getTestIndex, hasAsyncMethod, hasAsyncProperty, hasAsyncReactiveField, hasCustomCollection, hasCustomReference, hasEnumCollection, hasLargeMany, hasLargeManyToMany, hasLazyField, hasMany, hasManyDerived, hasManyThrough, hasManyToMany, hasOne, hasOneDerived, hasOnePolymorphic, hasOneThrough, hasOneToOne, hasProperty, hasReactiveField, hasReactiveGetter, hasReactiveManyToMany, hasReactiveManyToManyOtherSide, hasReactiveProperty, hasReactiveReference, hasRecursiveChildren, hasRecursiveM2m, hasRecursiveParents, hasSerde, indexBy, internals, isAlias, isAllSqlPaths, isAsyncProperty, isAsyncReactiveField, isChangeableField, isCollection, isCollectionField, isDefined, isEntity, isFactoryCreation, isFieldSet, isId, isInTrustedContext, isKey, isLazyField, isLensLoaded, isLensLoadedPath, isLoaded, isLoadedAsyncProperty, isLoadedCollection, isLoadedLazyField, isLoadedOneToOneReference, isLoadedProperty, isLoadedReadOnlyCollection, isLoadedReference, isManyToManyEnumField, isManyToManyField, isManyToOneField, isManyToOneReference, isNew, isNewEntity, isOneToManyField, isOneToOneField, isOneToOneReference, isPolymorphicField, isPolymorphicReference, isProperty, isReactiveField, isReactiveGetter, isReactiveManyToMany, isReactiveManyToManyOtherSide, isReactiveReference, isReadOnlyCollection, isReference, isReferenceField, isRelation, isScope, isScopeJoinFilter, isSelectAllFilter, isTable, isTaggedId, isTypeOrSubType, keyToNumber, keyToTaggedId, kq, kqDot, kqStar, lazyExcludedSelects, lazyField, lensPathToLoadHint, lensToLoadHint, lensToPath, loadLens, loadLensPath, makeLike, mapPathsToTarget, mapToDb, maxValueRule, maybeAddIdNotNulls, maybeAddNotSoftDeleted, maybeAddOrderBy, maybeBranchValue, maybeGetConstructorFromReference, maybeNew, maybeNewPoly, maybePopulateThen, maybeRequireTemporal, maybeResolveReferenceToId, mergeFindOptions, minValueRule, mustBeSubType, newAliasProxy, newChangesProxy, newPgConnectionConfig, newRequiredLazyFieldRule, newRequiredRule, newScopeFn, newTableProxy, newTestInstance, noValue, noopFieldLogger, normalizeHint, nowUTC, opToFn, operators, optimizeCollectionJoins, parseAlias, parseEntityFilter, parseFindQuery, parseValueFilter, partition, plainDateMapper, plainDateTimeMapper, plainTimeMapper, polymorphicField, query, queryMaybe, rangeValueRule, recursiveQuery, requireTemporal, resetBootFlag, resetDefaultEntityLimit, resolveScope, reverseReactiveHint, runInTrustedContext, sameEntity, sameReference, setDefaultEntityLimit, setFactoryLogging, setFactoryWriter, setField, setLastNow, setOpt, setOpts, setReactionLogging, setRuntimeConfig, setTaggedIdDelimiter, skipCondition, sql, stiSubtypeFilter, subqueryBrand, table, tableMgmt, tables, tagFromId, tagId, tagIds, taggedIdPrefix, testIndex, testing, toIdOf, toJSON, toTaggedId, unsafeDeTagIds, unsafeLoaded, updatePartial, upsert, visitConditions, withLoaded, zeroTo, zonedDateTimeMapper };
+//# sourceMappingURL=index.d.cts.map

package/build/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0Ba;;;;;cACA;2BAAA;;UAyRH,UAAU;EAClB,QAAQ;;KAGE,OAAO,GAAG,WAAW,IAAI,UAAU;;;;;;;;;;;;;;;iBAgB/B,QAAQ,UAAU,QAChC,QAAQ,GACR,QAAQ,QAAQ,OAAO,iBACvB;EAAS;EAAmB;;;;;;;;;iBAoBd,OAAO,UAAU,QAC/B,MAAM,eAAe,IACrB,QAAQ,GACR,aACA,aACA,mBACA;iBAwDc,iBAAiB,QAAQ,QAAQ;;KAOrC,cAAc,QACvB,WAAW,KAAK,EAAE;iBAGL,gBAAgB,UAAU,QAAQ,QAAQ;iBAC1C,gBAAgB,UAAU,QAAQ,MAAM,kBAAkB;iBAO1D,aAAa,QAAQ,SAAS;iBAM9B,mBAAmB,QAAQ,kBAAkB;;iBAO7C,eAAe,UAAU,QAAQ,MAAM,+BAA+B,KAAK,kBAAkB;;;;;;;;cAWhG,kBAAkB;;iBAGf,YAAY;;;;;;iBASZ,YAAY,UAAU,QAAQ,QAAQ,IAAI,UAAU,IAAI"}

package/build/index.d.mts

@@ -0,0 +1,180 @@
+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";
+import { Collection, LoadedCollection, isCollection, isLoadedCollection } from "./relations/Collection.mjs";
+import { AbstractRelationImpl } from "./relations/AbstractRelationImpl.mjs";
+import { CustomCollection, hasCustomCollection } from "./relations/CustomCollection.mjs";
+import { EnumMetadata } from "./EnumMetadata.mjs";
+import { EnumCollection, EnumCollectionImpl, LoadedEnumCollection, hasEnumCollection } from "./relations/EnumCollection.mjs";
+import { CustomReference, hasCustomReference } from "./relations/CustomReference.mjs";
+import { AsyncMethod, LoadedMethod, hasAsyncMethod } from "./relations/hasAsyncMethod.mjs";
+import { LoadedProperty, Property, PropertyImpl, hasProperty, hasReactiveProperty, isLoadedProperty, isProperty } from "./relations/hasProperty.mjs";
+import { AsyncProperty, AsyncPropertyImpl, hasAsyncProperty, isAsyncProperty, isLoadedAsyncProperty } from "./relations/AsyncProperty.mjs";
+import { LazyField, LazyFieldImpl, hasLazyField, isLazyField, isLoadedLazyField } from "./relations/LazyField.mjs";
+import { hasManyDerived } from "./relations/hasManyDerived.mjs";
+import { hasManyThrough } from "./relations/hasManyThrough.mjs";
+import { LoadedReference, Reference, isLoadedReference, isReference } from "./relations/Reference.mjs";
+import { hasOneDerived } from "./relations/hasOneDerived.mjs";
+import { hasOneThrough } from "./relations/hasOneThrough.mjs";
+import { Relation, isRelation } from "./relations/Relation.mjs";
+import { LargeCollection } from "./relations/LargeCollection.mjs";
+import { ManyToManyCollection, hasManyToMany } from "./relations/ManyToManyCollection.mjs";
+import { ManyToManyLargeCollection, hasLargeManyToMany } from "./relations/ManyToManyLargeCollection.mjs";
+import { ManyToOneReference, ManyToOneReferenceImpl, hasOne, isManyToOneReference } from "./relations/ManyToOneReference.mjs";
+import { OneToManyCollection, hasMany } from "./relations/OneToManyCollection.mjs";
+import { OneToManyLargeCollection, hasLargeMany } from "./relations/OneToManyLargeCollection.mjs";
+import { OneToOneReference, OneToOneReferenceImpl, hasOneToOne, isLoadedOneToOneReference, isOneToOneReference } from "./relations/OneToOneReference.mjs";
+import { PolymorphicReference, PolymorphicReferenceImpl, hasOnePolymorphic, isPolymorphicReference } from "./relations/PolymorphicReference.mjs";
+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 "./flush/Todo.mjs";
+import { ReactionLogger, setReactionLogging } from "./logging/ReactionLogger.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";
+import { LoadedReadOnlyCollection, ReadOnlyCollection, isLoadedReadOnlyCollection, isReadOnlyCollection } from "./relations/ReadOnlyCollection.mjs";
+import { RecursiveCycleError } from "./relations/RecursiveCycleError.mjs";
+import { hasRecursiveChildren, hasRecursiveM2m, hasRecursiveParents } from "./relations/RecursiveCollection.mjs";
+import "./relations/index.mjs";
+import { CrossJoinTable, JoinTable, LateralJoinTable, ParsedCteClause, ParsedFindQuery, ParsedGroupBy, ParsedOrderBy, ParsedSelect, ParsedTable, PrimaryTable, addTablePerClassJoinsAndClassTag, findFilterField, getTables, maybeAddIdNotNulls, maybeAddOrderBy, parseAlias, parseFindQuery } from "./queries/find/QueryParser.mjs";
+import { ColumnCondition, ExistsCondition, ParsedExpressionCondition, ParsedExpressionFilter, ParsedValueFilter, RawCondition } from "./queries/parsedConditions.mjs";
+import { AndCondition, ConditionGroup, DomainPredicate, OrCondition, PredicateBrand, SqlCondition, SqlPredicate } from "./queries/conditions.mjs";
+import { Alias, AliasBrand, AliasColumn, AliasMgmt, EntityAlias, PolyAlias, PrimitiveAlias, alias, aliases, getAliasMetadata, getAliasMgmt, getMaybeCtiAlias, isAlias, newAliasProxy } from "./queries/find/Aliases.mjs";
+import { BooleanGraphQLFilter, EntityGraphQLFilter, GraphQLFilterAndSettings, GraphQLFilterWithAlias, Operator, ValueGraphQLFilter, opToFn, operators } from "./queries/find/EntityGraphQLFilter.mjs";
+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 "./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 "./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 "./loading/loadLens.mjs";
+import { partitionHint } from "./preloading/partitionHint.mjs";
+import { SubqueryRenderer, buildValueCondition, buildWhereClause } from "./queries/renderConditions.mjs";
+import { AliasAssigner } from "./queries/sql/AliasAssigner.mjs";
+import { CaseElse, CaseWhen } from "./queries/sql/expressions/case.mjs";
+import { ExprFromInput, ExprInput } from "./queries/sql/expressions/types.mjs";
+import { expr } from "./queries/sql/expressions/expression.mjs";
+import { CustomColumnConfig, CustomColumnInput, CustomColumnInputs, CustomColumnType, CustomTable, CustomTableDefinition, CustomTableFor, declareTable } from "./queries/sql/custom.mjs";
+import { CollectionJoin, EntityColumn, PolyReference, PrimitiveColumn, ReferenceColumn, ReferenceJoin, Table, TableBrand, TableFilter, TableFor, TableMgmt, TableSourceBrand, TableSourceMgmt, getTableMetadata, getTableMgmt, isTable, newTableProxy, table, tableMgmt, tables } from "./queries/sql/Tables.mjs";
+import { CheckScope, Clauses, EntityQuery, ExistsQuery, ExpressionOrderBy, MaybeNull, NameOf, NotWidened, OrderByDirection, OrderByKeys, Query, QueryArg, QueryCondition, QueryJoin, QueryJoinInput, QueryJoinList, QueryRow, QuerySelect, QuerySource, QueryValue, RecursiveOptions, ResolvedJoins, ScalarQuery, SetQuery, Subquery, SubqueryBrand, WithInput, WithSource, entityQueryBrand, query, queryMaybe, recursiveQuery, sql, subqueryBrand } from "./queries/sql/query.mjs";
+import { ArrayAggOptions, Expr, ExprBrand, ExprLike, InnerJoin, LeftJoin, exprBrand } from "./queries/sql/Expr.mjs";
+import { JoinTree } from "./queries/sql/JoinTree.mjs";
+import { ConditionBuilder } from "./queries/ConditionBuilder.mjs";
+import { EntityField, EntityFields, SettableFields } from "./EntityFields.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 "./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";
+import { filterSoftDeletes, lazyExcludedSelects, maybeAddNotSoftDeleted, stiSubtypeFilter } from "./queries/entityQueryUtils.mjs";
+import { optimizeCollectionJoins } from "./queries/find/QueryParser.collectionJoins.mjs";
+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 "./drivers/driverApi.mjs";
+import { IdAssigner, RandomUuidAssigner, SequenceIdAssigner, TestUuidAssigner } from "./drivers/IdAssigner.mjs";
+import "./drivers/index.mjs";
+import { getField, isChangeableField, isFieldSet, setField } from "./fields.mjs";
+import { lazyField } from "./newEntity.mjs";
+import { UnknownProperty, getLazyFields, getProperties } from "./getProperties.mjs";
+import { CustomJsonKeyHint, EntityKeyJsonHint, JsonHint, JsonPayload, Jsonable, JsonableValue, NestedJsonHint, ToJsonHint, toJSON } from "./json.mjs";
+import { assertIdIsTagged, assertIdsAreTagged, deTagId, deTagIds, ensureTagged, isTaggedId, keyToNumber, keyToTaggedId, maybeResolveReferenceToId, setTaggedIdDelimiter, tagFromId, tagId, tagIds, taggedIdPrefix, toIdOf, toTaggedId, unsafeDeTagIds } from "./keys.mjs";
+import { kq, kqDot, kqStar } from "./queries/sql/keywords.mjs";
+import { FactoryEntityOpt, FactoryOpts, defaultValue, factories, getTestIndex, isFactoryCreation, maybeBranchValue, maybeNew, maybeNewPoly, newTestInstance, noValue, setFactoryLogging, testIndex } from "./newTestInstance.mjs";
+import { setFactoryWriter } from "./logging/FactoryLogger.mjs";
+import { FieldLogger, FieldLoggerWatch, WriteFn, noopFieldLogger } from "./logging/FieldLogger.mjs";
+import { ImmutableEntitiesPlugin } from "./plugins/ImmutableEntitiesPlugin.mjs";
+import { JsonAggregatePreloader } from "./preloading/JsonAggregatePreloader.mjs";
+import { nowUTC } from "./nowUTC.mjs";
+import { plainDateMapper, plainDateTimeMapper, plainTimeMapper, zonedDateTimeMapper } from "./serde/temporalMappers.mjs";
+import { isInTrustedContext, runInTrustedContext } from "./trusted.mjs";
+import { buildUnnestCte, ensureRectangularArraySizes } from "./queries/unnest.mjs";
+import { DeepPartialOrNull, updatePartial, upsert } from "./upsert.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";
+import { newPgConnectionConfig } from "joist-utils";
+//#region src/index.d.ts
+declare const testing: {
+  isAllSqlPaths: typeof isAllSqlPaths;
+  getDefaultDependencies: typeof getDefaultDependencies;
+  partitionHint: typeof partitionHint;
+};
+declare const internals: {
+  buildWhereClause: typeof buildWhereClause;
+};
+interface Flavoring<FlavorT> {
+  _type?: FlavorT;
+}
+type Flavor<T, FlavorT> = T & Flavoring<FlavorT>;
+/**
+ * Sets each value in `values` on the current entity.
+ *
+ * The default behavior is that passing a value as either `null` or `undefined` will set
+ * the field as `undefined`, i.e. automatic `null` to `undefined` conversion.
+ *
+ * However, if you pass `ignoreUndefined: true`, then any opt that is `undefined` will be treated
+ * as "do not set", and `null` will still mean "set to `undefined`". This is useful for implementing
+ * APIs were an input of `undefined` means "do not set / noop" and `null` means "unset".
+ *
+ * Note that constructors _always_ call this method, but if the call is coming from `em.hydrate`, we
+ * use `values` being a primary key to short-circuit and let hydration callers assign the values
+ * returned by the serde `fromRow` methods.
+ */
+declare function setOpts<T extends Entity>(entity: T, values: Partial<OptsOf<T>> | undefined, opts?: {
+  partial?: boolean;
+  calledFromConstructor?: boolean;
+}): void;
+/**
+ * Applies some standard behavior & protections to `entity[key] = value`. I.e.
+ *
+ * - We don't set over AsyncProperties/relations/etc., and instead call current.set(value)
+ * - We catch missing/invalid field names
+ * - We handle FactoryInitialValues
+ */
+declare function setOpt<T extends Entity>(meta: EntityMetadata<T>, entity: T, key: string, _value: any, partial?: boolean, calledFromConstructor?: boolean): void;
+declare function ensureNotDeleted(entity: Entity, ignore?: "pending"): void;
+/** Adds `null` to every key in `T` to accept partial-update-style input. */
+type PartialOrNull<T> = { [P in keyof T]?: T[P] | null; };
+declare function getRequiredKeys<T extends Entity>(entity: T): string[];
+declare function getRequiredKeys<T extends Entity>(type: EntityConstructor<T>): string[];
+declare function getRelations(entity: Entity): AbstractRelationImpl<any, any>[];
+declare function getRelationEntries(entity: Entity): [string, AbstractRelationImpl<any, any>][];
+/** Casts a "maybe abstract" cstr to a concrete cstr when the calling code knows it's safe. */
+declare function asConcreteCstr<T extends Entity>(cstr: MaybeAbstractEntityConstructor<T>): EntityConstructor<T>;
+/**
+ * Thrown when `.id` is accessed on an entity that does not have an id yet.
+ *
+ * For Postgres, entities are actually allowed to have ids pre-INSERT, if you call
+ * `em.assignNewIds()`. Other databases typically require INSERTs to trigger the auto
+ * id assignment.
+ */
+declare class NoIdError extends Error {}
+/** Throws a `NoIdError` for `entity`, i.e. because `id` was called before being saved. */
+declare function failNoIdYet(entity: string): never;
+/**
+ * Add a static function since getters can't have type guards.
+ *
+ * See https://github.com/microsoft/TypeScript/issues/43368
+ */
+declare function isNewEntity<T extends Entity>(entity: T): entity is New<T>;
+//#endregion
+export { type ActualFactoryOpts, type Alias, AliasAssigner, type AliasBrand, type AliasColumn, AliasFn, type AliasMgmt, type AndCondition, type ArrayAggOptions, type AsyncMethod, type AsyncProperty, AsyncPropertyImpl, BaseEntity, BigIntSerde, BooleanFilter, BooleanGraphQLFilter, type CaseElse, type CaseWhen, Changes, type CheckScope, type Clauses, type Collection, type CollectionJoin, Column, type ColumnCondition, ColumnDescriptors, type ColumnsOf, ConditionBuilder, type ConditionGroup, ConfigApi, CrossJoinTable, CustomCollection, type CustomColumnConfig, type CustomColumnInput, type CustomColumnInputs, type CustomColumnType, CustomJsonKeyHint, CustomReference, CustomSerde, CustomSerdeAdapter, type CustomTable, type CustomTableDefinition, type CustomTableFor, DateSerde, DecimalToNumberSerde, type DeepNew, type DeepPartialOrNull, DeleteOp, type DeleteStatement, type DomainPredicate, type Driver, type DriverQueryResult, type Entity, type EntityAlias, EntityChanges, type EntityColumn, EntityConstructor, type EntityField, type EntityFields, EntityFilter, EntityFilterObject, EntityGraphQLFilter, type EntityHook, EntityKeyJsonHint, EntityManager, EntityManagerHook, EntityManagerInternalApi, EntityManagerMode, EntityManagerOpts, EntityMetadata, type EntityOf, type EntityOrId, type EntityQuery, EnumArrayFieldSerde, type EnumCollection, EnumCollectionFieldStatus, EnumCollectionImpl, EnumField, EnumFieldSerde, type EnumMetadata, type ExecuteResult, type ExistsCondition, type ExistsQuery, type Expr, type ExprBrand, type ExprFromInput, type ExprInput, type ExprLike, ExpressionCondition, ExpressionFilter, type ExpressionOrderBy, type FactoryEntityOpt, type FactoryExtrasOf, type FactoryOpts, Field, FieldColumn, FieldLogger, FieldLoggerWatch, FieldSerde, FieldStatus, type FieldsOf, FilterAndSettings, type FilterOf, FilterWithAlias, FindCountFilterOptions, FindFilter, FindFilterOptions, FindGqlFilterOptions, FindOperation, Flavor, FlushOptions, type GenericError, GraphQLFilterAndSettings, type GraphQLFilterOf, GraphQLFilterWithAlias, type HintNode, IdAssigner, IdOf, type IdType, ImmutableEntitiesPlugin, type InheritanceTypeOf, type InnerJoin, InsertFixup, InsertOp, type InsertStatement, type InsertValues, InstanceData, type JoinColumnValue, type JoinResult, type JoinRow, JoinRowOperation, type JoinRowTodo, JoinTable, type JoinTree, JsonAggregatePreloader, JsonHint, JsonPayload, JsonSerde, Jsonable, JsonableValue, KeySerde, type LargeCollection, LargeOneToManyField, LateralJoinTable, type LazyField, LazyFieldImpl, type LeftJoin, Lens, type LoadHint, type Loadable, type Loaded, type LoadedCollection, type LoadedEnumCollection, type LoadedMethod, type LoadedProperty, type LoadedReadOnlyCollection, type LoadedReference, LoaderCache, ManyToManyCollection, ManyToManyEnumField, ManyToManyField, ManyToManyFieldStatus, ManyToManyLargeCollection, type ManyToManyLike, ManyToOneField, ManyToOneFieldStatus, type ManyToOneReference, ManyToOneReferenceImpl, type MarkLoaded, MaybeAbstractEntityConstructor, type MaybeNull, type MutationReturning, type MutationStatement, type NameOf, NestedJsonHint, type NestedLoadHint, type New, NoIdError, NotFoundError, type NotWidened, OneToManyCollection, OneToManyField, OneToManyFieldStatus, OneToManyLargeCollection, OneToOneField, type OneToOneReference, OneToOneReferenceImpl, OpColumn, Operator, type OptIdsOf, type OptsOf, type OrCondition, OrderBy, type OrderByDirection, type OrderByKeys, type OrderOf, ParsedCteClause, type ParsedEntityFilter, type ParsedExpressionCondition, type ParsedExpressionFilter, ParsedFindQuery, ParsedGroupBy, ParsedOrderBy, ParsedSelect, ParsedTable, type ParsedValueFilter, PartialOrNull, type PendingChange, type PendingCreate, type PendingDelete, type PendingM2M, type PendingUpdate, PlainDateSerde, PlainDateTimeSerde, PlainTimeSerde, Plugin, PojoRowData, type PolyAlias, PolyComponent, type PolyReference, PolymorphicField, PolymorphicFieldComponent, PolymorphicKeySerde, type PolymorphicReference, PolymorphicReferenceImpl, type PredicateBrand, type PreloadHydrator, type PreloadPlugin, PrimaryKeyField, PrimaryTable, type PrimitiveAlias, type PrimitiveColumn, PrimitiveField, PrimitiveFieldStatus, PrimitiveSerde, type Property, PropertyImpl, type Query, type QueryArg, type QueryCondition, type QueryJoin, type QueryJoinInput, type QueryJoinList, type QueryRow, type QuerySelect, type QuerySource, type QueryValue, RandomUuidAssigner, type RawCondition, type Reactable, type Reacted, ReactionLogger, type ReactiveField, type ReactiveGetter, type ReactiveHint, type ReactiveManyToMany, ReactiveManyToManyImpl, type ReactiveManyToManyOtherSide, ReactiveManyToManyOtherSideImpl, type ReactiveReference, ReactiveReferenceImpl, type ReactiveTarget, type ReadOnlyCollection, ReadOnlyError, RecursiveCycleError, type RecursiveOptions, type Reference, type ReferenceColumn, type ReferenceJoin, type Relation, type RelationsIn, type RelationsOf, type ResolvedJoins, ResolvedScope, type RootTypeNameOf, RowData, type RuntimeConfig, ScalarCodec, type ScalarQuery, Scope, ScopeFilterFragment, ScopeFn, ScopeJoinFilter, ScopeQuery, SequenceIdAssigner, SerdeField, type SetQuery, type SettableFields, SimpleFieldSerde, type SqlCondition, type SqlPredicate, StubbedRelation, type Subquery, type SubqueryBrand, SubqueryRenderer, SuperstructSerde, type Table, type TableBrand, type TableFilter, type TableFor, type TableMgmt, type TableSourceBrand, type TableSourceMgmt, TaggedId, Temporal, TestUuidAssigner, TimestampCodec, TimestampFields, TimestampSerde, ToJsonHint, Todo, TooManyError, type TypeMap, type TypeMapEntry, type TypeNameOf, UniqueFilter, UnknownProperty, UpdateOp, type UpdateStatement, type UpdateValues, ValidationCode, type ValidationError, ValidationErrors, type ValidationRule, type ValidationRuleInternal, type ValidationRuleResult, ValueFilter, ValueGraphQLFilter, type WithInput, type WithLoaded, type WithSource, WriteFn, ZodSerde, ZonedDateTimeSerde, abbreviation, addTablePerClassJoinsAndClassTag, alias, aliases, appendStack, asConcreteCstr, asNew, assertIdIsTagged, assertIdsAreTagged, assertLoaded, assertNever, buildCteSql, buildRawQuery, buildUnnestCte, buildValueCondition, buildWhereClause, cannotBeChanged, cannotBeUpdated, cleanSql, cleanStringValue, configureMetadata, convertToLoadHint, createRowFromEntityData, deTagId, deTagIds, declareTable, deepNormalizeHint, defaultValue, driverAfterBegin, driverAfterCommit, driverApi, driverBeforeBegin, driverBeforeCommit, emptyRowData, ensureLoaded, ensureNotDeleted, ensureRectangularArraySizes, ensureTagged, ensureWithLoaded, entityQueryBrand, expr, exprBrand, factories, fail, failIfAnyRejected, failNoIdYet, filterSoftDeletes, findFilterField, generateOps, getAliasMetadata, getAliasMgmt, getBaseAndSelfMetas, getBaseMeta, getBaseSelfAndSubMetas, getConstructorFromTaggedId, getDefaultEntityLimit, getEmInternalApi, getField, getInstanceData, getLazyFields, getLens, getLensPath, getMaybeCtiAlias, getMetadata, getMetadataForField, getMetadataForTable, getMetadataForType, getProperties, getRelationEntries, getRelations, getRequiredKeys, getRuntimeConfig, getSubMetas, getTableMetadata, getTableMgmt, getTables, getTestIndex, hasAsyncMethod, hasAsyncProperty, hasAsyncReactiveField, hasCustomCollection, hasCustomReference, hasEnumCollection, hasLargeMany, hasLargeManyToMany, hasLazyField, hasMany, hasManyDerived, hasManyThrough, hasManyToMany, hasOne, hasOneDerived, hasOnePolymorphic, hasOneThrough, hasOneToOne, hasProperty, hasReactiveField, hasReactiveGetter, hasReactiveManyToMany, hasReactiveManyToManyOtherSide, hasReactiveProperty, hasReactiveReference, hasRecursiveChildren, hasRecursiveM2m, hasRecursiveParents, hasSerde, indexBy, internals, isAlias, isAllSqlPaths, isAsyncProperty, isAsyncReactiveField, isChangeableField, isCollection, isCollectionField, isDefined, isEntity, isFactoryCreation, isFieldSet, isId, isInTrustedContext, isKey, isLazyField, isLensLoaded, isLensLoadedPath, isLoaded, isLoadedAsyncProperty, isLoadedCollection, isLoadedLazyField, isLoadedOneToOneReference, isLoadedProperty, isLoadedReadOnlyCollection, isLoadedReference, isManyToManyEnumField, isManyToManyField, isManyToOneField, isManyToOneReference, isNew, isNewEntity, isOneToManyField, isOneToOneField, isOneToOneReference, isPolymorphicField, isPolymorphicReference, isProperty, isReactiveField, isReactiveGetter, isReactiveManyToMany, isReactiveManyToManyOtherSide, isReactiveReference, isReadOnlyCollection, isReference, isReferenceField, isRelation, isScope, isScopeJoinFilter, isSelectAllFilter, isTable, isTaggedId, isTypeOrSubType, keyToNumber, keyToTaggedId, kq, kqDot, kqStar, lazyExcludedSelects, lazyField, lensPathToLoadHint, lensToLoadHint, lensToPath, loadLens, loadLensPath, makeLike, mapPathsToTarget, mapToDb, maxValueRule, maybeAddIdNotNulls, maybeAddNotSoftDeleted, maybeAddOrderBy, maybeBranchValue, maybeGetConstructorFromReference, maybeNew, maybeNewPoly, maybePopulateThen, maybeRequireTemporal, maybeResolveReferenceToId, mergeFindOptions, minValueRule, mustBeSubType, newAliasProxy, newChangesProxy, newPgConnectionConfig, newRequiredLazyFieldRule, newRequiredRule, newScopeFn, newTableProxy, newTestInstance, noValue, noopFieldLogger, normalizeHint, nowUTC, opToFn, operators, optimizeCollectionJoins, parseAlias, parseEntityFilter, parseFindQuery, parseValueFilter, partition, plainDateMapper, plainDateTimeMapper, plainTimeMapper, polymorphicField, query, queryMaybe, rangeValueRule, recursiveQuery, requireTemporal, resetBootFlag, resetDefaultEntityLimit, resolveScope, reverseReactiveHint, runInTrustedContext, sameEntity, sameReference, setDefaultEntityLimit, setFactoryLogging, setFactoryWriter, setField, setLastNow, setOpt, setOpts, setReactionLogging, setRuntimeConfig, setTaggedIdDelimiter, skipCondition, sql, stiSubtypeFilter, subqueryBrand, table, tableMgmt, tables, tagFromId, tagId, tagIds, taggedIdPrefix, testIndex, testing, toIdOf, toJSON, toTaggedId, unsafeDeTagIds, unsafeLoaded, updatePartial, upsert, visitConditions, withLoaded, zeroTo, zonedDateTimeMapper };
+//# sourceMappingURL=index.d.mts.map

package/build/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0Ba;;;;;cACA;2BAAA;;UAyRH,UAAU;EAClB,QAAQ;;KAGE,OAAO,GAAG,WAAW,IAAI,UAAU;;;;;;;;;;;;;;;iBAgB/B,QAAQ,UAAU,QAChC,QAAQ,GACR,QAAQ,QAAQ,OAAO,iBACvB;EAAS;EAAmB;;;;;;;;;iBAoBd,OAAO,UAAU,QAC/B,MAAM,eAAe,IACrB,QAAQ,GACR,aACA,aACA,mBACA;iBAwDc,iBAAiB,QAAQ,QAAQ;;KAOrC,cAAc,QACvB,WAAW,KAAK,EAAE;iBAGL,gBAAgB,UAAU,QAAQ,QAAQ;iBAC1C,gBAAgB,UAAU,QAAQ,MAAM,kBAAkB;iBAO1D,aAAa,QAAQ,SAAS;iBAM9B,mBAAmB,QAAQ,kBAAkB;;iBAO7C,eAAe,UAAU,QAAQ,MAAM,+BAA+B,KAAK,kBAAkB;;;;;;;;cAWhG,kBAAkB;;iBAGf,YAAY;;;;;;iBASZ,YAAY,UAAU,QAAQ,QAAQ,IAAI,UAAU,IAAI"}