Skip to main content

Space

Datalayer Core


Datalayer Core / Space

Class: Space

Defined in: src/models/SpaceDTO.ts:70

Space domain model that wraps API responses with convenient methods. Provides workspace management with data refresh and content creation operations.

Example

const space = spaces[0];
const items = await space.getItems();
const notebook = await space.createNotebook({ name: 'Analysis' });

Constructors

Constructor

new Space(data, sdk): SpaceDTO

Defined in: src/models/SpaceDTO.ts:82

Create a Space instance.

Parameters

data

SpaceData

Space data from API

sdk

DatalayerClient

SDK instance

Returns

SpaceDTO

Properties

_data

protected _data: SpaceData

Defined in: src/models/SpaceDTO.ts:71

Accessors

description

Get Signature

get description(): string

Defined in: src/models/SpaceDTO.ts:148

The description of the space.

Returns

string


handle

Get Signature

get handle(): string

Defined in: src/models/SpaceDTO.ts:127

URL-friendly handle for the space.

Returns

string


name

Get Signature

get name(): string

Defined in: src/models/SpaceDTO.ts:141

The name of the space.

Returns

string


uid

Get Signature

get uid(): string

Defined in: src/models/SpaceDTO.ts:121

Unique identifier for the space.

Returns

string


variant

Get Signature

get variant(): string

Defined in: src/models/SpaceDTO.ts:133

Space variant type.

Returns

string

Methods

createLexical()

createLexical(data): Promise<LexicalDTO>

Defined in: src/models/SpaceDTO.ts:265

Create a new lexical document in this space.

Parameters

data

Lexical creation configuration

description

string

file?

Blob | File

name

string

Returns

Promise<LexicalDTO>

Created Lexical instance


createNotebook()

createNotebook(data): Promise<Notebook>

Defined in: src/models/SpaceDTO.ts:246

Create a new notebook in this space.

Parameters

data

Notebook creation configuration

description

string

file?

Blob | File

name

string

Returns

Promise<Notebook>

Created Notebook instance


getItems()

getItems(): Promise<(Notebook | LexicalDTO)[]>

Defined in: src/models/SpaceDTO.ts:224

Get all items in this space as model instances.

Returns

Promise<(Notebook | LexicalDTO)[]>

Array of Notebook and Lexical model instances


rawData()

rawData(): SpaceData

Defined in: src/models/SpaceDTO.ts:319

Get the raw space data exactly as received from the API. This preserves the original snake_case naming from the API response.

Returns

SpaceData

Raw space data from API


refresh()

refresh(): Promise<void>

Defined in: src/models/SpaceDTO.ts:106

Refresh space data from the API by fetching user's spaces.

Returns

Promise<void>


toJSON()

toJSON(): SpaceJSON

Defined in: src/models/SpaceDTO.ts:295

Get space data in camelCase format. Returns only the core fields that consumers need. This provides a stable interface regardless of API changes.

Returns

SpaceJSON

Core space data with camelCase properties


toString()

toString(): string

Defined in: src/models/SpaceDTO.ts:325

String representation of the space.

Returns

string