PrimitiveModelCodec
Defined in: packages/common/src/codecs/models/primitive-model.ts:4
A bidirectional codec that transforms between application types and wire formats. Supports format-specific encoding (JSON vs msgpack).
Extends
Section titled “Extends”Codec<T,TWire>
Type Parameters
Section titled “Type Parameters”T = unknown
The application/runtime type (e.g., bigint, string, Uint8Array)
TWire = T
The wire format type (may differ based on format, e.g., bigint → string in JSON)
Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new PrimitiveModelCodec<
T,TWire>(metadata):PrimitiveModelCodec<T,TWire>
Defined in: packages/common/src/codecs/models/primitive-model.ts:7
Parameters
Section titled “Parameters”metadata
Section titled “metadata”PrimitiveModelMetadata | () => PrimitiveModelMetadata
Returns
Section titled “Returns”PrimitiveModelCodec<T, TWire>
Overrides
Section titled “Overrides”Methods
Section titled “Methods”decode()
Section titled “decode()”decode(
value,format):T
Defined in: packages/common/src/codecs/models/primitive-model.ts:38
Decode a value from wire format
Parameters
Section titled “Parameters”The wire value
TWire | null | undefined
format
Section titled “format”The wire format (json or msgpack)
Returns
Section titled “Returns”T
The decoded application value
Overrides
Section titled “Overrides”decodeOptional()
Section titled “decodeOptional()”decodeOptional(
value,format):T|undefined
Defined in: packages/common/src/codecs/models/primitive-model.ts:43
Decode an optional value from wire format (preserves undefined vs default distinction)
Parameters
Section titled “Parameters”The wire value
TWire | null | undefined
format
Section titled “format”The wire format (json or msgpack)
Returns
Section titled “Returns”T | undefined
The decoded application value, or undefined if wire value was undefined
Overrides
Section titled “Overrides”defaultValue()
Section titled “defaultValue()”defaultValue():
T
Defined in: packages/common/src/codecs/models/primitive-model.ts:18
The default value for this type (used to determine if a value should be omitted during encoding)
Returns
Section titled “Returns”T
Overrides
Section titled “Overrides”encode()
Section titled “encode()”encode(
value,format):TWire
Defined in: packages/common/src/codecs/models/primitive-model.ts:28
Encode a value, always returning the value regardless of if it is default
Parameters
Section titled “Parameters”The application value
T | null | undefined
format
Section titled “format”The wire format (json or msgpack)
Returns
Section titled “Returns”TWire
The encoded value, or the default if it is undefined or null
Overrides
Section titled “Overrides”encodeOptional()
Section titled “encodeOptional()”encodeOptional(
value,format):TWire|undefined
Defined in: packages/common/src/codecs/models/primitive-model.ts:33
Encode a value, omitting it if set to the default value.
Parameters
Section titled “Parameters”The application value
T | null | undefined
format
Section titled “format”The wire format (json or msgpack)
Returns
Section titled “Returns”TWire | undefined
The encoded value, or undefined if it equals the default (will be omitted)
Overrides
Section titled “Overrides”isDefaultValue()
Section titled “isDefaultValue()”isDefaultValue(
value):boolean
Defined in: packages/common/src/codecs/models/primitive-model.ts:23
Check if a value equals the default value (determines if it should be omitted during encoding) Override this method for custom default comparison logic, otherwise defaults to default value equality
Parameters
Section titled “Parameters”T
The value to check
Returns
Section titled “Returns”boolean
True if value equals default