a schema node for nested record-like javascript object types

Type Parameters

  • REC extends {
        [key: string]: any;
    } = {
        [key: string]: any;
    }

Hierarchy

Properties

value?: REC

the value held by this schema node. used as a storage for interceptors to interact and read decoded value
it can also used as a means for storing default values for the encoder to utilize.
but besides those two scenarios, it should typically be left unassigned.
this also comes in handy when annotating types both for the encoder or decoder

name?: string

name of the node, used for object property key naming by parent SchemaRecordNode

doc?: string | true

an optional doc string for this schema node, that should be cleared when MINIFY is true
to achive that, you would want to write your doc strings as follows:

declare const [DEBUG, MINIFY, BUNDLE]: [boolean, boolean, boolean]
const my_schema_node: SPrimitive<number> {
type: "u4l",
doc: MINIFY || "a stupid description of this 32-bit unsinged little piece of endian."
}
type: "record"

a mandatory kind descriptior of the primitive kind

args: [child_start?: number, child_end?: number]

args that should be passed on to either the type specific encoder or decoder

children: SRecordChild<keyof REC & string, REC[keyof REC], string>[] = []

an array collection of child element. typically used by non-leaf nodes, such as SchemaRecordNode and SchemaTupleNode

Methods

  • manually set this schema's type to the provided type_name, and also register the new type_name to global type_registery if register = true.
    this is the only easy way to register type_names of sub-sub-classes of abstract SchemaNode.
    check out SHeadArray to see how it extends SArray, but registers its own type_name = "headarray" that's different from its parent class's type_name = "array"

    Type Parameters

    • NewTypeName extends string

    Parameters

    • type_name: NewTypeName
    • register: boolean = true

    Returns SRecord<REC> & {
        type: NewTypeName;
    }

  • Type Parameters

    • Name extends string

    Parameters

    • name: Name

    Returns SRecord<REC> & {
        name: Name;
    }

  • Parameters

    • Rest ...children: SRecordChild<keyof REC & string, REC[keyof REC], string>[]

    Returns Require<SRecord<REC>, "children">

  • Parameters

    • value: REC & {}

    Returns Require<SRecord<REC>, "value">

  • Parameters

    • Rest ...args: [child_start?: number, child_end?: number]

    Returns SRecord<REC>

  • Parameters

    • Rest ...args: [child_start?: number, child_end?: number]

    Returns SRecord<REC>

  • an abstract static method that creates an instance of this schema class, using a regular javascript object

    Parameters

    • schema_obj: ClassFieldsOf<SRecord<{
          [key: string]: any;
      }>>

    Returns SRecord<{
        [key: string]: any;
    }>

  • describe how an instance of this schema node should be encoded into bytes

    Parameters

    • value: REC & {}
    • Rest ...args: [child_start?: number, child_end?: number]

    Returns Uint8Array

  • describe bytes from a buffer should decode a value for this schema node

    Parameters

    • buf: Uint8Array
    • offset: number
    • Rest ...args: [child_start?: number, child_end?: number]

    Returns Decoded<REC, number>

Constructors

  • Type Parameters

    • REC extends {
          [key: string]: any;
      } = {
          [key: string]: any;
      }

    Parameters

    • Rest ...children: SRecordChild<keyof REC & string, REC[keyof REC], string>[]

    Returns SRecord<REC>

Generated using TypeDoc