Class CRAction<Type, Shape, Snapshot>

CRDT-backed Schema.org Action.

Schema.org: An action performed by a direct agent and indirect participants upon a direct object.

Type Parameters

Type = "Action"
Shape extends CRActionDefaultShape<Type> = CRActionDefaultShape<Type>
Snapshot extends Partial<CRStructSnapshot<Shape>> = Partial<CRStructSnapshot<Shape>>

Hierarchy (View Summary)

CRThing<Type, Shape, Snapshot>
- CRAction

Implements

CRActionState<Type>

Constructors

constructor

new CRAction<
    Type = "Action",
    Shape extends CRActionDefaultShape<Type> = CRActionDefaultShape<Type>,
    Snapshot extends
        Partial<CRStructSnapshot<Shape>> = Partial<CRStructSnapshot<Shape>>,
>(
    snapshot?: Snapshot,
    defaultShape?: Partial<Shape>,
    crdtProperties?: Partial<
        Record<Extract<keyof Shape, string>, "map" | "text" | "set" | "list">,
    >,
): CRAction<Type, Shape, Snapshot>
Type Parameters
- Type = "Action"
- Shape extends CRActionDefaultShape<Type> = CRActionDefaultShape<Type>
- Snapshot extends Partial<CRStructSnapshot<Shape>> = Partial<CRStructSnapshot<Shape>>
Parameters
- Optionalsnapshot: Snapshot
- OptionaldefaultShape: Partial<Shape>
- OptionalcrdtProperties: Partial<Record<Extract<keyof Shape, string>, "map" | "text" | "set" | "list">>
Returns CRAction<Type, Shape, Snapshot>
Overrides CRThing.constructor
- Defined in src/CRAction/class.ts:82

Properties

`Readonly`@id

"@id": string

JSON-LD identifier for this node.

`Readonly`@type

"@type": Type

Schema.org type name for this node.

actionProcess

actionProcess: Readonly<CRSet<CRActionProcess>>

Schema.org actionProcess: Description of the process by which the action was performed.

actionStatus

actionStatus: CRActionStatus

Schema.org actionStatus: Indicates the current disposition of the Action.

`Readonly`additionalType

additionalType: Readonly<CRSet<string>>

Schema.org additionalType: An additional type for the item.

agent

agent: Readonly<CRSet<CRActionPersonOrOrganization>>

Schema.org agent: The direct performer or driver of the action.

`Readonly`alternateName

alternateName: Readonly<CRSet<string>>

Schema.org alternateName: An alias for the item.

`Readonly`description

description: Readonly<CRText>

Schema.org description: A description of the item.

`Readonly`disambiguatingDescription

disambiguatingDescription: Readonly<CRText>

Schema.org disambiguatingDescription: A short description used to disambiguate the item from other, similar items.

endTime

endTime: string

Schema.org endTime: When the action ended.

error

error: Readonly<CRSet<CRActionThing>>

Schema.org error: For failed actions, more information on the cause.

`Protected` `Readonly`formatValidators

formatValidators: SchemaCRDTFormatValidators<Shape>

`Readonly`identifier

identifier: Readonly<
    string
    | CRIdReferenceValue
    | CRTypedIdReferenceValue<"PropertyValue">,
>

Schema.org identifier.

image

image: Readonly<CRSet<CRThingImage>>

Schema.org image: An image of the item.

instrument

instrument: Readonly<CRSet<CRActionThing>>

Schema.org instrument: The object that helped the agent perform the action.

location

location: Readonly<CRSet<CRActionLocation>>

Schema.org location: Where the action takes place.

mainEntityOfPage

mainEntityOfPage: Readonly<CRSet<CRThingMainEntityOfPage>>

Schema.org mainEntityOfPage: A page or other CreativeWork for which this thing is the main entity being described.

`Readonly`name

name: Readonly<CRText>

Schema.org name: The name of the item.

object

object: Readonly<CRSet<CRActionThing>>

Schema.org object: The object upon which the action is carried out.

owner

owner: Readonly<CRSet<CRThingOwner>>

Schema.org owner: A person or organization who owns this Thing.

participant

participant: Readonly<CRSet<CRActionPersonOrOrganization>>

Schema.org participant: Other co-agents that participated indirectly.

potentialAction

potentialAction: Readonly<CRSet<CRThingPotentialAction>>

Schema.org potentialAction: A potential Action for this Thing.

provider

provider: Readonly<CRSet<CRActionPersonOrOrganization>>

Schema.org provider: The service provider, operator or performer.

result

result: Readonly<CRSet<CRActionThing>>

Schema.org result: The result produced in the action.

`Readonly`sameAs

sameAs: Readonly<CRSet<string>>

Schema.org sameAs: URL of a reference Web page that unambiguously indicates the item's identity.

startTime

startTime: string

Schema.org startTime: When the action started.

`Readonly`subjectOf

subjectOf: Readonly<CRSet<CRThingSubjectOf>>

Schema.org subjectOf: A CreativeWork or Event about this Thing.

target

target: Readonly<CRSet<CRActionTarget>>

Schema.org target: An EntryPoint or URL target for the Action.

url

url: string

Schema.org url: URL of the item.

Methods

[iterator]

"[iterator]"(): IterableIterator<[keyof Shape, Shape[keyof Shape]]>
Iterates over the current live field entries.

Returns IterableIterator<[keyof Shape, Shape[keyof Shape]]>
Inherited from CRThing.[iterator]
- Defined in src/CRThing/class.ts:850

acknowledge

acknowledge(): void
Emits the current acknowledgement frontier for each field.

Returns void
Inherited from CRThing.acknowledge
- Defined in src/CRThing/class.ts:713

addEventListener

addEventListener<K extends keyof SchemaCRDTEventMap<Shape>>(
    type: K,
    listener: SchemaCRDTEventListenerFor<Shape, K> | null,
    options?: boolean | AddEventListenerOptions,
): void
Registers an event listener.
Type Parameters
- K extends keyof SchemaCRDTEventMap<Shape>
Parameters
- type: K
  The event type to listen for.
- listener: SchemaCRDTEventListenerFor<Shape, K> | null
  The listener to register.
- Optionaloptions: boolean | AddEventListenerOptions
  Listener registration options.
Returns void
Inherited from CRThing.addEventListener
- Defined in src/CRThing/class.ts:863

clear

clear(): void
Resets every field in the replica back to its default value.

Returns void
Inherited from CRThing.clear
- Defined in src/CRThing/class.ts:788

clone

clone(): Shape
Returns a cloned plain object view of the current replica fields.

Returns Shape
The current field values keyed by field name.
Inherited from CRThing.clone
- Defined in src/CRThing/class.ts:799

entries

entries<K extends string | number | symbol>(): [K, Shape[K]][]
Returns cloned key-value pairs for the current replica state.
Type Parameters
- K extends string | number | symbol
Returns [K, Shape[K]][]
The current field entries.
Inherited from CRThing.entries
- Defined in src/CRThing/class.ts:817

garbageCollect

garbageCollect(frontiers: Partial<Record<keyof Shape, string>>[]): void
Removes overwritten identifiers that every provided frontier has acknowledged.
Parameters
- frontiers: Partial<Record<keyof Shape, string>>[]
  A collection of acknowledgement frontiers to compact against.
Returns void
Inherited from CRThing.garbageCollect
- Defined in src/CRThing/class.ts:736

getCanonicalPresentation

getCanonicalPresentation(
options?: SchemaCRDTCanonicalPresentationOptions,
): Promise<string>
Returns canonical N-Quads for signing or hashing the live JSON-LD view.

This canonicalizes the live Schema.org presentation from toJSONLD(). If an application needs to sign the entire CRDT state, canonicalize toJSON() separately at the application protocol layer.
Parameters
- options: SchemaCRDTCanonicalPresentationOptions = {}
Returns Promise<string>
Inherited from CRThing.getCanonicalPresentation
- Defined in src/CRThing/class.ts:612

keys

keys<K extends string | number | symbol>(): K[]
Returns the struct field keys.
Type Parameters
- K extends string | number | symbol
Returns K[]
The field keys in the current replica.
Inherited from CRThing.keys
- Defined in src/CRThing/class.ts:781

merge

merge(
    crStructDelta:
        | Partial<CRStructSnapshot<Shape>>
        | Partial<Record<keyof Shape, unknown>>,
): void
Applies a remote or local delta to the replica state.
Parameters
- crStructDelta: Partial<CRStructSnapshot<Shape>> | Partial<Record<keyof Shape, unknown>>
  The partial serializable field delta to merge.
Returns void
Inherited from CRThing.merge
- Defined in src/CRThing/class.ts:677

removeEventListener

removeEventListener<K extends keyof SchemaCRDTEventMap<Shape>>(
    type: K,
    listener: SchemaCRDTEventListenerFor<Shape, K> | null,
    options?: boolean | EventListenerOptions,
): void
Removes an event listener.
Type Parameters
- K extends keyof SchemaCRDTEventMap<Shape>
Parameters
- type: K
  The event type to stop listening for.
- listener: SchemaCRDTEventListenerFor<Shape, K> | null
  The listener to remove.
- Optionaloptions: boolean | EventListenerOptions
  Listener removal options.
Returns void
Inherited from CRThing.removeEventListener
- Defined in src/CRThing/class.ts:882

snapshot

snapshot(): void
Emits the current serializable snapshot of the replica state.

Returns void
Inherited from CRThing.snapshot
- Defined in src/CRThing/class.ts:768

toJSON

toJSON(): CRStructSnapshot<Shape>
Returns the current serializable snapshot projection of this replica.

Called automatically by JSON.stringify.

Returns CRStructSnapshot<Shape>
Inherited from CRThing.toJSON
- Defined in src/CRThing/class.ts:826

toJSONLD

toJSONLD(options?: SchemaCRDTJSONLDOptions): SchemaCRDTJSONLDDocument
Exports the current live projection as Schema.org JSON-LD.

This does not return CRDT state. toJSON() remains the CRStruct snapshot projection used for replication and persistence.
Parameters
- options: SchemaCRDTJSONLDOptions = {}
Returns SchemaCRDTJSONLDDocument
Inherited from CRThing.toJSONLD
- Defined in src/CRThing/class.ts:581

toString

toString(): string
Attempts to return the current snapshot as a serialized JSON string.

Returns string
Inherited from CRThing.toString
- Defined in src/CRThing/class.ts:832

`Protected`validateFormat

validateFormat(key: Extract<keyof Shape, string>, value: unknown): void
Parameters
- key: Extract<keyof Shape, string>
- value: unknown
Returns void
Inherited from CRThing.validateFormat
- Defined in src/CRThing/class.ts:978

values

values<K extends string | number | symbol>(): Shape[K][]
Returns cloned copies of the current field values.
Type Parameters
- K extends string | number | symbol
Returns Shape[K][]
The current field values.
Inherited from CRThing.values
- Defined in src/CRThing/class.ts:808

`Static`fromJSONLD

fromJSONLD<
    Instance extends
        CRThing<
            "Thing",
            CRThingDefaultShape<"Thing">,
            Partial<CRStructSnapshot<CRThingDefaultShape<"Thing">>>,
        > = CRThing<
        "Thing",
        CRThingDefaultShape<"Thing">,
        Partial<CRStructSnapshot<CRThingDefaultShape<"Thing">>>,
    >,
>(
    document: SchemaCRDTJSONLDInput,
): Promise<Instance>
Constructs a fresh replica from a JSON-LD live presentation.

This is intentionally a constructor-style import, not a CRDT merge path. Use merge() for CRDT snapshots and deltas.
Type Parameters
- Instance extends CRThing<
      "Thing",
      CRThingDefaultShape<"Thing">,
      Partial<CRStructSnapshot<CRThingDefaultShape<"Thing">>>,
  > = CRThing<
      "Thing",
      CRThingDefaultShape<"Thing">,
      Partial<CRStructSnapshot<CRThingDefaultShape<"Thing">>>,
  >
Parameters
- document: SchemaCRDTJSONLDInput
  Compacted or expanded Schema.org JSON-LD document to import.
Returns Promise<Instance>
Inherited from CRThing.fromJSONLD
- Defined in src/CRThing/class.ts:417

Class CRAction<Type, Shape, Snapshot>

Type Parameters

Hierarchy (View Summary)

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Type Parameters

Parameters

Returns CRAction<Type, Shape, Snapshot>

Properties

Readonly@id

Readonly@type

actionProcess

actionStatus

ReadonlyadditionalType

agent

ReadonlyalternateName

Readonlydescription

ReadonlydisambiguatingDescription

endTime

error

Protected ReadonlyformatValidators

Readonlyidentifier

image

instrument

location

mainEntityOfPage

Readonlyname

object

owner

participant

potentialAction

provider

result

ReadonlysameAs

startTime

ReadonlysubjectOf

target

url

Methods

[iterator]

Returns IterableIterator<[keyof Shape, Shape[keyof Shape]]>

acknowledge

Returns void

addEventListener

Type Parameters

Parameters

Returns void

clear

Returns void

clone

Returns Shape

entries

Type Parameters

Returns [K, Shape[K]][]

garbageCollect

Parameters

Returns void

getCanonicalPresentation

Parameters

Returns Promise<string>

keys

Type Parameters

Returns K[]

merge

Parameters

Returns void

removeEventListener

Type Parameters

Parameters

Returns void

snapshot

Returns void

toJSON

Returns CRStructSnapshot<Shape>

toJSONLD

`Readonly`@id

`Readonly`@type

`Readonly`additionalType

`Readonly`alternateName

`Readonly`description

`Readonly`disambiguatingDescription

`Protected` `Readonly`formatValidators

`Readonly`identifier

`Readonly`name

`Readonly`sameAs

`Readonly`subjectOf

`Protected`validateFormat

`Static`fromJSONLD