RecordType

Public class

A record type is a type that can be stored in a record store. It is created with createRecordType.

class RecordType<
  R extends UnknownRecord,
  RequiredProperties extends keyof Omit<R, 'id' | 'typeName'>,
> {}

UnknownRecord

packages/store/src/lib/RecordType.ts

Constructor

Public constructor

Constructs a new instance of the RecordType class

R['typeName']

{
  readonly createDefaultProperties: () => Exclude<
    OmitMeta<R>,
    RequiredProperties
  >
  readonly ephemeralKeys?: {
    readonly [K in Exclude<
      keyof R,
      'id' | 'typeName'
    >]: boolean
  }
  readonly scope?: RecordScope
  readonly validator?: StoreValidator<R>
}

StoreValidator

Properties

createDefaultProperties

Public readonly property

readonly createDefaultProperties: () => Exclude<
  OmitMeta<R>,
  RequiredProperties
>

ephemeralKeys

Public readonly property

readonly ephemeralKeys?: {
  readonly [K in Exclude<keyof R, 'id' | 'typeName'>]: boolean
}

ephemeralKeySet

Public readonly property

readonly ephemeralKeySet: ReadonlySet<string>

isInstance

Public property

Check whether a record is an instance of this record type.

const result = recordType.isInstance(someRecord)

isInstance: (record?: UnknownRecord) => record is R

UnknownRecord

scope

Public readonly property

readonly scope: RecordScope

typeName

Public readonly property

The unique type associated with this record.

readonly typeName: R['typeName']

validator

Public readonly property

readonly validator: StoreValidator<R>

StoreValidator

Methods

clone()

Public method

Clone a record of this type.

clone(record: R): R

R

R

The cloned record.

create()

Public method

Create a new record of this type.

create(
  properties: Pick<R, RequiredProperties> &
    Omit<Partial<R>, RequiredProperties>
): R

Pick<R, RequiredProperties> &
  Omit<Partial<R>, RequiredProperties>

R

The new record.

createCustomId()

Public method

Create a new ID for this record type based on the given ID.

const id = recordType.createCustomId('myId')

createCustomId(id: string): IdOf<R>

string

IdOf<R>

The new ID.

IdOf

createId()

Public method

Create a new ID for this record type.

const id = recordType.createId()

createId(customUniquePart?: string): IdOf<R>

string

IdOf<R>

The new ID.

IdOf

isId()

Public method

Check whether an id is an id of this type.

const result = recordType.isIn('someId')

isId(id?: string): id is IdOf<R>

string

id is IdOf<R>

Whether the id is an id of this type.

IdOf

parseId()

Public method

Takes an id like user:123 and returns the part after the colon 123

parseId(id: IdOf<R>): string

IdOf<R>

string

IdOf

validate()

Public method

Check that the passed in record passes the validations for this type. Returns its input correctly typed if it does, but throws an error otherwise.

validate(record: unknown, recordBefore?: R): R

unknown

R

R

withDefaultProperties()

Public method

Create a new RecordType that has the same type name as this RecordType and includes the given default properties.

const authorType = createRecordType('author', () => ({ living: true }))
const deadAuthorType = authorType.withDefaultProperties({ living: false })

withDefaultProperties<
  DefaultProps extends Omit<Partial<R>, 'id' | 'typeName'>,
>(
  createDefaultProperties: () => DefaultProps
): RecordType<R, Exclude<RequiredProperties, keyof DefaultProps>>

() => DefaultProps

RecordType<R, Exclude<RequiredProperties, keyof DefaultProps>>

The new RecordType.

RecordType