Trait

Defined in: packages/@livestore/common/dist/schema/state/sqlite/client-document-def.d.ts:137

Type Parameters

TName

TName extends string

TType

TType

TEncoded

TEncoded

TOptions

TOptions extends ClientDocumentTableOptions<TType>

Properties

[ClientDocumentTableDefSymbol]

readonly [ClientDocumentTableDefSymbol]: object

Defined in: packages/@livestore/common/dist/schema/state/sqlite/client-document-def.d.ts:208

derived

readonly derived: object

derived.setEventDef

readonly setEventDef: SetEventDef<TName, TType, TOptions>

derived.setMaterializer

readonly setMaterializer: Materializer<SetEventDef<TName, TType, TOptions>>

options

readonly options: TOptions

---

default

readonly default: TOptions["default"]

Defined in: packages/@livestore/common/dist/schema/state/sqlite/client-document-def.d.ts:207

---

get

readonly get: MakeGetQueryBuilder<TName, TType, TOptions>

Defined in: packages/@livestore/common/dist/schema/state/sqlite/client-document-def.d.ts:166

Get the current value of the client document table.

Example

const someDocumentTable = State.SQLite.clientDocument({
  name: 'SomeDocumentTable',
  schema: Schema.Struct({
    someField: Schema.String,
  }),
  default: { value: { someField: 'some-value' } },
})

const value$ = queryDb(someDocumentTable.get('some-id'))

// When you've set a default id, you can omit the id argument

const uiState = State.SQLite.clientDocument({
  name: 'UiState',
  schema: Schema.Struct({
    someField: Schema.String,
  }),
  default: { id: SessionIdSymbol, value: { someField: 'some-value' } },
})

const value$ = queryDb(uiState.get())

---

set

readonly set: SetEventDefLike<TName, TType, TOptions>

Defined in: packages/@livestore/common/dist/schema/state/sqlite/client-document-def.d.ts:204

Derived event definition for setting the value of the client document table. If the document doesn’t exist yet, the first .set event will create it.

Examples

const someDocumentTable = State.SQLite.clientDocument({
  name: 'SomeDocumentTable',
  schema: Schema.Struct({
    someField: Schema.String,
    someOtherField: Schema.String,
  }),
  default: { value: { someField: 'some-default-value', someOtherField: 'some-other-default-value' } },
})

const setEventDef = store.commit(someDocumentTable.set({ someField: 'explicit-value' }, 'some-id'))
// Will commit an event with the following payload:
// { id: 'some-id', value: { someField: 'explicit-value', someOtherField: 'some-other-default-value' } }

Similar to .get, you can omit the id argument if you’ve set a default id.

const uiState = State.SQLite.clientDocument({
  name: 'UiState',
  schema: Schema.Struct({ someField: Schema.String }),
  default: { id: SessionIdSymbol, value: { someField: 'some-default-value' } },
})

const setEventDef = store.commit(uiState.set({ someField: 'explicit-value' }))
// Will commit an event with the following payload:
// { id: '...', value: { someField: 'explicit-value' } }
//        ^^^
//        Automatically replaced with the client session id

---

Value

readonly Value: TType

Defined in: packages/@livestore/common/dist/schema/state/sqlite/client-document-def.d.ts:205

---

valueSchema

readonly valueSchema: Schema<TType, TEncoded>

Defined in: packages/@livestore/common/dist/schema/state/sqlite/client-document-def.d.ts:206