Class EnforcingEntityLoader<TFields, TIDField, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>

Enforcing entity loader. All normal loads are batched, cached, and authorized against the entity's EntityPrivacyPolicy. All loads through this loader will throw if the load is not successful.

Type Parameters

TFields extends Record<string, any>
TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>
TViewerContext extends ViewerContext
TEntity extends ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields>
TPrivacyPolicy extends EntityPrivacyPolicy<TFields, TIDField, TViewerContext, TEntity, TSelectedFields>
TSelectedFields extends keyof TFields = keyof TFields

Index

Constructors

constructor

Methods

loadByCompositeFieldEqualingAsync loadByFieldEqualingAsync loadByIDAsync loadByIDNullableAsync loadManyByCompositeFieldEqualingAsync loadManyByCompositeFieldEqualingManyAsync loadManyByFieldEqualingAsync loadManyByFieldEqualingManyAsync loadManyByIDsAsync loadManyByIDsNullableAsync

Constructors

constructor

new EnforcingEntityLoader<
    TFields extends Record<string, any>,
    TIDField extends string | number | symbol,
    TViewerContext extends ViewerContext,
    TEntity extends
        ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields>,
    TPrivacyPolicy extends
        EntityPrivacyPolicy<
            TFields,
            TIDField,
            TViewerContext,
            TEntity,
            TSelectedFields,
        >,
    TSelectedFields extends string
    | number
    | symbol = keyof TFields,
>(
    entityLoader: AuthorizationResultBasedEntityLoader<
        TFields,
        TIDField,
        TViewerContext,
        TEntity,
        TPrivacyPolicy,
        TSelectedFields,
    >,
): EnforcingEntityLoader<
    TFields,
    TIDField,
    TViewerContext,
    TEntity,
    TPrivacyPolicy,
    TSelectedFields,
>
Type Parameters
- TFields extends Record<string, any>
- TIDField extends string | number | symbol
- TViewerContext extends ViewerContext
- TEntity extends ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields>
- TPrivacyPolicy extends EntityPrivacyPolicy<TFields, TIDField, TViewerContext, TEntity, TSelectedFields>
- TSelectedFields extends string | number | symbol = keyof TFields
Parameters
- entityLoader: AuthorizationResultBasedEntityLoader<
      TFields,
      TIDField,
      TViewerContext,
      TEntity,
      TPrivacyPolicy,
      TSelectedFields,
  >
Returns EnforcingEntityLoader<
    TFields,
    TIDField,
    TViewerContext,
    TEntity,
    TPrivacyPolicy,
    TSelectedFields,
>
- Defined in packages/entity/src/EnforcingEntityLoader.ts:29

Methods

loadByCompositeFieldEqualingAsync

loadByCompositeFieldEqualingAsync<
    N extends EntityCompositeField<Pick<TFields, TSelectedFields>>,
>(
    compositeField: N,
    compositeFieldValue: EntityCompositeFieldValue<
        Pick<TFields, TSelectedFields>,
        N,
    >,
): Promise<TEntity | null>
Load an entity where compositeField equals compositeFieldValue, or null if no entity exists.
Type Parameters
- N extends EntityCompositeField<Pick<TFields, TSelectedFields>>
Parameters
- compositeField: N
  composite field being queried
- compositeFieldValue: EntityCompositeFieldValue<Pick<TFields, TSelectedFields>, N>
  compositeField value being queried
Returns Promise<TEntity | null>
entity where compositeField equals compositeFieldValue, or null if no entity matches the condition.

Throws
when multiple entities match the condition

Throws
EntityNotAuthorizedError when viewer is not authorized to view the returned entity
- Defined in packages/entity/src/EnforcingEntityLoader.ts:154

loadByFieldEqualingAsync

loadByFieldEqualingAsync<N extends string | number | symbol>(
uniqueFieldName: N,
fieldValue: NonNullable<TFields[N]>,
): Promise<TEntity | null>
Load an entity where fieldName equals fieldValue, or null if no entity exists.
Type Parameters
- N extends string | number | symbol
Parameters
- uniqueFieldName: N
  entity field being queried
- fieldValue: NonNullable<TFields[N]>
  uniqueFieldName field value being queried
Returns Promise<TEntity | null>
entity where uniqueFieldName equals fieldValue, or null if no entity matches the condition.

Throws
when multiple entities match the condition

Throws
EntityNotAuthorizedError when viewer is not authorized to view the returned entity
- Defined in packages/entity/src/EnforcingEntityLoader.ts:135

loadByIDAsync

loadByIDAsync(id: TFields[TIDField]): Promise<TEntity>
Loads an entity by a specified ID.
Parameters
- id: TFields[TIDField]
  ID of the entity
Returns Promise<TEntity>
entity matching ID

Throws
EntityNotAuthorizedError when viewer is not authorized to view the returned entity

Throws
EntityNotFoundError when no entity exists for ID
- Defined in packages/entity/src/EnforcingEntityLoader.ts:174

loadByIDNullableAsync

loadByIDNullableAsync(id: TFields[TIDField]): Promise<TEntity | null>
Load an entity by a specified ID, or return null if non-existent.
Parameters
- id: TFields[TIDField]
  ID of the entity
Returns Promise<TEntity | null>
entity for matching ID, or null if no entity exists for ID.

Throws
EntityNotAuthorizedError when viewer is not authorized to view the returned entity

Throws
when multiple entities are found matching the condition
- Defined in packages/entity/src/EnforcingEntityLoader.ts:186

loadManyByCompositeFieldEqualingAsync

loadManyByCompositeFieldEqualingAsync<
    N extends EntityCompositeField<Pick<TFields, TSelectedFields>>,
>(
    compositeField: N,
    compositeFieldValue: EntityCompositeFieldValue<
        Pick<TFields, TSelectedFields>,
        N,
    >,
): Promise<readonly TEntity[]>
Load many entities where compositeField equals compositeFieldValue.
Type Parameters
- N extends EntityCompositeField<Pick<TFields, TSelectedFields>>
Parameters
- compositeField: N
  composite field being queried
- compositeFieldValue: EntityCompositeFieldValue<Pick<TFields, TSelectedFields>, N>
  compositeField value being queried
Returns Promise<readonly TEntity[]>
array of entities that match the query for compositeFieldValue

Throws
EntityNotAuthorizedError when viewer is not authorized to view one or more of the returned entities
- Defined in packages/entity/src/EnforcingEntityLoader.ts:114

loadManyByCompositeFieldEqualingManyAsync

loadManyByCompositeFieldEqualingManyAsync<
    N extends EntityCompositeField<Pick<TFields, TSelectedFields>>,
>(
    compositeField: N,
    compositeFieldValues: readonly EntityCompositeFieldValue<
        Pick<TFields, TSelectedFields>,
        N,
    >[],
): Promise<
    ReadonlyMap<EntityCompositeFieldValue<TFields, N>, readonly TEntity[]>,
>
Load many entities where compositeField is one of compositeFieldValues.
Type Parameters
- N extends EntityCompositeField<Pick<TFields, TSelectedFields>>
Parameters
- compositeField: N
  composite field being queried
- compositeFieldValues: readonly EntityCompositeFieldValue<Pick<TFields, TSelectedFields>, N>[]
  compositeField values being queried
Returns Promise<ReadonlyMap<EntityCompositeFieldValue<TFields, N>, readonly TEntity[]>>
map from compositeFieldValue to entities that match the query for that compositeFieldValue

Throws
EntityNotAuthorizedError when viewer is not authorized to view one or more of the returned entities
- Defined in packages/entity/src/EnforcingEntityLoader.ts:67

loadManyByFieldEqualingAsync

loadManyByFieldEqualingAsync<N extends string | number | symbol>(
fieldName: N,
fieldValue: NonNullable<TFields[N]>,
): Promise<readonly TEntity[]>
Load many entities where fieldName equals fieldValue.
Type Parameters
- N extends string | number | symbol
Parameters
- fieldName: N
  entity field being queried
- fieldValue: NonNullable<TFields[N]>
  fieldName field value being queried
Returns Promise<readonly TEntity[]>
array of entities that match the query for fieldValue

Throws
EntityNotAuthorizedError when viewer is not authorized to view one or more of the returned entities
- Defined in packages/entity/src/EnforcingEntityLoader.ts:96

loadManyByFieldEqualingManyAsync

loadManyByFieldEqualingManyAsync<N extends string | number | symbol>(
fieldName: N,
fieldValues: readonly NonNullable<TFields[N]>[],
): Promise<ReadonlyMap<NonNullable<TFields[N]>, readonly TEntity[]>>
Load many entities where fieldName is one of fieldValues.
Type Parameters
- N extends string | number | symbol
Parameters
- fieldName: N
  entity field being queried
- fieldValues: readonly NonNullable<TFields[N]>[]
  fieldName field values being queried
Returns Promise<ReadonlyMap<NonNullable<TFields[N]>, readonly TEntity[]>>
map from fieldValue to entities that match the query for that fieldValue

Throws
EntityNotAuthorizedError when viewer is not authorized to view one or more of the returned entities
- Defined in packages/entity/src/EnforcingEntityLoader.ts:47

loadManyByIDsAsync

loadManyByIDsAsync(
ids: readonly TFields[TIDField][],
): Promise<ReadonlyMap<TFields[TIDField], TEntity>>
Loads many entities for a list of IDs.
Parameters
- ids: readonly TFields[TIDField][]
  IDs of the entities to load
Returns Promise<ReadonlyMap<TFields[TIDField], TEntity>>
map from ID to corresponding entity result, where result error can be UnauthorizedError or EntityNotFoundError.

Throws
EntityNotAuthorizedError when viewer is not authorized to view one or more of the returned entities

Throws
EntityNotFoundError when no entity exists for one or more of the IDs
- Defined in packages/entity/src/EnforcingEntityLoader.ts:198

loadManyByIDsNullableAsync

loadManyByIDsNullableAsync(
ids: readonly TFields[TIDField][],
): Promise<ReadonlyMap<TFields[TIDField], TEntity | null>>
Loads many entities for a list of IDs, returning null for any IDs that are non-existent.
Parameters
- ids: readonly TFields[TIDField][]
  IDs of the entities to load
Returns Promise<ReadonlyMap<TFields[TIDField], TEntity | null>>
map from ID to nullable corresponding entity

Throws
EntityNotAuthorizedError when viewer is not authorized to view one or more of the returned entities
- Defined in packages/entity/src/EnforcingEntityLoader.ts:211

Class EnforcingEntityLoader<TFields, TIDField, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>

Type Parameters

Index

Constructors

Methods

Constructors

constructor

Type Parameters

Parameters

Returns EnforcingEntityLoader< TFields, TIDField, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields,>

Methods

loadByCompositeFieldEqualingAsync

Type Parameters

Parameters

Returns Promise<TEntity | null>

Throws

Throws

loadByFieldEqualingAsync

Type Parameters

Parameters

Returns Promise<TEntity | null>

Throws

Throws

loadByIDAsync

Parameters

Returns Promise<TEntity>

Throws

Throws

loadByIDNullableAsync

Parameters

Returns Promise<TEntity | null>

Throws

Throws

loadManyByCompositeFieldEqualingAsync

Type Parameters

Parameters

Returns Promise<readonly TEntity[]>

Throws

loadManyByCompositeFieldEqualingManyAsync

Type Parameters

Parameters

Returns Promise<ReadonlyMap<EntityCompositeFieldValue<TFields, N>, readonly TEntity[]>>

Throws

loadManyByFieldEqualingAsync

Type Parameters

Parameters

Returns Promise<readonly TEntity[]>

Throws

loadManyByFieldEqualingManyAsync

Type Parameters

Parameters

Returns Promise<ReadonlyMap<NonNullable<TFields[N]>, readonly TEntity[]>>

Throws

loadManyByIDsAsync

Parameters

Returns Promise<ReadonlyMap<TFields[TIDField], TEntity>>

Throws

Throws

loadManyByIDsNullableAsync

Parameters

Returns Promise<ReadonlyMap<TFields[TIDField], TEntity | null>>

Throws

Settings

On This Page

Returns EnforcingEntityLoader<
TFields,
TIDField,
TViewerContext,
TEntity,
TPrivacyPolicy,
TSelectedFields,
>