DatalayerClient

Datalayer Core

---

Datalayer Core / DatalayerClient

Class: DatalayerClient

Defined in: src/client/index.ts:92

Main Datalayer Client providing unified access to all platform services. Uses TypeScript mixins to provide a flat, discoverable API.

Example

const client = new DatalayerClient({
  token: 'your-token'
});

const user = await client.whoami();
const runtime = await client.createRuntime({
  environment_name: 'ai-agents-env',
  credits_limit: 100
});

Extends

• DatalayerClientWithMixins

Constructors

Constructor

new DatalayerClient(config): DatalayerClient

Defined in: src/client/index.ts:98

Create a DatalayerClient instance.

Parameters

config

DatalayerClientConfig

Client configuration options

Returns

DatalayerClient

Overrides

DatalayerClientWithMixins.constructor

Properties

auth

readonly auth: AuthenticationManager

Defined in: src/client/base.ts:57

Authentication manager

Inherited from

DatalayerClientWithMixins.auth

---

environments

readonly environments: Environment[] = []

Defined in: src/client/base.ts:53

Environments

Inherited from

DatalayerClientWithMixins.environments

---

handlers?

readonly optional handlers?: ClientHandlers

Defined in: src/client/base.ts:55

Method lifecycle handlers

Inherited from

DatalayerClientWithMixins.handlers

---

iamRunUrl

readonly iamRunUrl: string

Defined in: src/client/base.ts:45

URL for IAM service

Inherited from

DatalayerClientWithMixins.iamRunUrl

---

runtimesRunUrl

readonly runtimesRunUrl: string

Defined in: src/client/base.ts:47

URL for Runtimes service

Inherited from

DatalayerClientWithMixins.runtimesRunUrl

---

spacerRunUrl

readonly spacerRunUrl: string

Defined in: src/client/base.ts:49

URL for Spacer service

Inherited from

DatalayerClientWithMixins.spacerRunUrl

---

token?

optional token?: string

Defined in: src/client/base.ts:51

Authentication token

Inherited from

DatalayerClientWithMixins.token

Methods

calculateCreditsFromMinutes()

calculateCreditsFromMinutes(minutes, burningRate): number

Defined in: src/client/index.ts:473

Parameters

minutes

number

burningRate

number

Returns

number

Inherited from

DatalayerClientWithMixins.calculateCreditsFromMinutes

---

calculateCreditsRequired()

calculateCreditsRequired(minutes, burningRate): number

Defined in: src/client/index.ts:348

Parameters

minutes

number

burningRate

number

Returns

number

---

calculateMaxRuntimeMinutes()

calculateMaxRuntimeMinutes(availableCredits, burningRate): number

Defined in: src/client/index.ts:344

Parameters

availableCredits

number

burningRate

number

Returns

number

---

checkIAMHealth()

checkIAMHealth(): Promise<HealthCheck>

Defined in: src/client/index.ts:349

Returns

Promise<HealthCheck>

---

checkRuntimesHealth()

checkRuntimesHealth(): Promise<HealthCheck>

Defined in: src/client/index.ts:401

Returns

Promise<HealthCheck>

---

checkSpacerHealth()

checkSpacerHealth(): Promise<HealthCheck>

Defined in: src/client/index.ts:443

Returns

Promise<HealthCheck>

---

cloneLexical()

cloneLexical(id): Promise<LexicalDTO>

Defined in: src/client/index.ts:458

Parameters

id

string

Returns

Promise<LexicalDTO>

---

cloneNotebook()

cloneNotebook(id): Promise<Notebook>

Defined in: src/client/index.ts:457

Parameters

id

string

Returns

Promise<Notebook>

---

createDatasource()

createDatasource(data): Promise<Datasource>

Defined in: src/client/index.ts:362

Parameters

data

CreateDatasourceRequest

Returns

Promise<Datasource>

---

createLexical()

createLexical(spaceId, name, description, file?): Promise<LexicalDTO>

Defined in: src/client/index.ts:426

Parameters

spaceId

string

name

string

description

string

file?

Blob | File

Returns

Promise<LexicalDTO>

---

createNotebook()

createNotebook(spaceId, name, description, file?): Promise<Notebook>

Defined in: src/client/index.ts:414

Parameters

spaceId

string

name

string

description

string

file?

Blob | File

Returns

Promise<Notebook>

---

createProject()

createProject(name, description?): Promise<Project>

Defined in: src/client/index.ts:463

Parameters

name

string

description?

string

Returns

Promise<Project>

---

createRuntime()

createRuntime(environmentName, type, givenName, minutesLimit, fromSnapshotId?): Promise<Runtime>

Defined in: src/client/index.ts:381

Parameters

environmentName

string

type

"notebook" | "terminal" | "job"

givenName

string

minutesLimit

number

fromSnapshotId?

string

Returns

Promise<Runtime>

---

createSecret()

createSecret(data): Promise<Secret>

Defined in: src/client/index.ts:352

Parameters

data

CreateSecretRequest

Returns

Promise<Secret>

---

createSnapshot()

createSnapshot(podName, name, description, stop?): Promise<Snapshot>

Defined in: src/client/index.ts:392

Parameters

podName

string

name

string

description

string

stop?

boolean

Returns

Promise<Snapshot>

---

createSpace()

createSpace(name, description, variant, spaceHandle, organizationId, seedSpaceId, isPublic): Promise<Space>

Defined in: src/client/index.ts:405

Parameters

name

string

description

string

variant

string

spaceHandle

string

organizationId

string

seedSpaceId

string

isPublic

boolean

Returns

Promise<Space>

---

deleteDatasource()

deleteDatasource(datasourceId): Promise<void>

Defined in: src/client/index.ts:369

Parameters

datasourceId

string

Returns

Promise<void>

---

deleteRuntime()

deleteRuntime(podName): Promise<void>

Defined in: src/client/index.ts:390

Parameters

podName

string

Returns

Promise<void>

---

deleteSecret()

deleteSecret(secretId): Promise<void>

Defined in: src/client/index.ts:359

Parameters

secretId

string

Returns

Promise<void>

---

deleteSnapshot()

deleteSnapshot(id): Promise<void>

Defined in: src/client/index.ts:400

Parameters

id

string

Returns

Promise<void>

---

deleteSpace()

deleteSpace(uid): Promise<void>

Defined in: src/client/index.ts:453

Parameters

uid

string

Returns

Promise<void>

---

deleteSpaceItem()

deleteSpaceItem(itemId): Promise<void>

Defined in: src/client/index.ts:440

Parameters

itemId

string

Returns

Promise<void>

---

ensureRuntime()

ensureRuntime(environmentName?, creditsLimit?, waitForReady?, maxWaitTime?, reuseExisting?, snapshotId?): Promise<Runtime>

Defined in: src/client/index.ts:373

Parameters

environmentName?

string

creditsLimit?

number

waitForReady?

boolean

maxWaitTime?

number

reuseExisting?

boolean

snapshotId?

string

Returns

Promise<Runtime>

---

exportSpace()

exportSpace(uid): Promise<any>

Defined in: src/client/index.ts:456

Parameters

uid

string

Returns

Promise<any>

---

getCollaborationSessionId()

getCollaborationSessionId(documentId): Promise<string>

Defined in: src/client/index.ts:441

Parameters

documentId

string

Returns

Promise<string>

---

getConfig()

getConfig(): DatalayerClientConfig

Defined in: src/client/base.ts:84

Get the current configuration including service URLs and token.

Returns

DatalayerClientConfig

Current configuration

Inherited from

DatalayerClientWithMixins.getConfig

---

getContent()

getContent(itemId): Promise<any>

Defined in: src/client/index.ts:442

Parameters

itemId

string

Returns

Promise<any>

---

getCredits()

getCredits(): Promise<Credits>

Defined in: src/client/index.ts:343

Returns

Promise<Credits>

---

getDatasource()

getDatasource(datasourceId): Promise<Datasource>

Defined in: src/client/index.ts:364

Parameters

datasourceId

string

Returns

Promise<Datasource>

---

getIamRunUrl()

getIamRunUrl(): string

Defined in: src/client/base.ts:94

Get the IAM service URL.

Returns

string

Inherited from

DatalayerClientWithMixins.getIamRunUrl

---

getLexical()

getLexical(id): Promise<LexicalDTO>

Defined in: src/client/index.ts:432

Parameters

id

string

Returns

Promise<LexicalDTO>

---

getMySpaces()

getMySpaces(): Promise<Space[]>

Defined in: src/client/index.ts:404

Returns

Promise<Space[]>

---

getNotebook()

getNotebook(id): Promise<Notebook>

Defined in: src/client/index.ts:420

Parameters

id

string

Returns

Promise<Notebook>

---

getProject()

getProject(uid): Promise<Project>

Defined in: src/client/index.ts:462

Parameters

uid

string

Returns

Promise<Project>

---

getProjectDefaultItems()

getProjectDefaultItems(uid): Promise<ProjectDefaultItems>

Defined in: src/client/index.ts:470

Parameters

uid

string

Returns

Promise<ProjectDefaultItems>

---

getProjects()

getProjects(): Promise<Project[]>

Defined in: src/client/index.ts:461

Returns

Promise<Project[]>

---

getRuntime()

getRuntime(podName): Promise<Runtime>

Defined in: src/client/index.ts:389

Parameters

podName

string

Returns

Promise<Runtime>

---

getRuntimesRunUrl()

getRuntimesRunUrl(): string

Defined in: src/client/base.ts:99

Get the Runtimes service URL.

Returns

string

Inherited from

DatalayerClientWithMixins.getRuntimesRunUrl

---

getSecret()

getSecret(secretId): Promise<Secret>

Defined in: src/client/index.ts:354

Parameters

secretId

string

Returns

Promise<Secret>

---

getSnapshot()

getSnapshot(id): Promise<Snapshot>

Defined in: src/client/index.ts:399

Parameters

id

string

Returns

Promise<Snapshot>

---

getSpace()

getSpace(uid): Promise<Space>

Defined in: src/client/index.ts:446

Parameters

uid

string

Returns

Promise<Space>

---

getSpaceItem()

getSpaceItem(itemId): Promise<LexicalDTO | Notebook>

Defined in: src/client/index.ts:439

Parameters

itemId

string

Returns

Promise<LexicalDTO | Notebook>

---

getSpaceItems()

getSpaceItems(spaceId): Promise<(LexicalDTO | Notebook)[]>

Defined in: src/client/index.ts:438

Parameters

spaceId

string

Returns

Promise<(LexicalDTO | Notebook)[]>

---

getSpacerRunUrl()

getSpacerRunUrl(): string

Defined in: src/client/base.ts:104

Get the Spacer service URL.

Returns

string

Inherited from

DatalayerClientWithMixins.getSpacerRunUrl

---

getToken()

getToken(): string | undefined

Defined in: src/client/index.ts:336

Returns

string | undefined

Inherited from

DatalayerClientWithMixins.getToken

---

listDatasources()

listDatasources(): Promise<Datasource[]>

Defined in: src/client/index.ts:363

Returns

Promise<Datasource[]>

---

listEnvironments()

listEnvironments(): Promise<Environment[]>

Defined in: src/client/index.ts:372

Returns

Promise<Environment[]>

---

listRuntimes()

listRuntimes(): Promise<Runtime[]>

Defined in: src/client/index.ts:388

Returns

Promise<Runtime[]>

---

listSecrets()

listSecrets(): Promise<Secret[]>

Defined in: src/client/index.ts:353

Returns

Promise<Secret[]>

---

listSnapshots()

listSnapshots(): Promise<Snapshot[]>

Defined in: src/client/index.ts:398

Returns

Promise<Snapshot[]>

---

login()

login(token): Promise<User>

Defined in: src/client/index.ts:341

Parameters

token

string

Returns

Promise<User>

---

logout()

logout(): Promise<void>

Defined in: src/client/index.ts:342

Returns

Promise<void>

---

makeSpacePrivate()

makeSpacePrivate(uid): Promise<Space>

Defined in: src/client/index.ts:455

Parameters

uid

string

Returns

Promise<Space>

---

makeSpacePublic()

makeSpacePublic(uid): Promise<Space>

Defined in: src/client/index.ts:454

Parameters

uid

string

Returns

Promise<Space>

---

renameProject()

renameProject(uid, newName, description?): Promise<Project>

Defined in: src/client/index.ts:465

Parameters

uid

string

newName

string

description?

string

Returns

Promise<Project>

---

setToken()

setToken(token): Promise<void>

Defined in: src/client/index.ts:337

Parameters

token

string

Returns

Promise<void>

Inherited from

DatalayerClientWithMixins.setToken

---

terminateAllRuntimes()

terminateAllRuntimes(): Promise<PromiseSettledResult<void>[]>

Defined in: src/client/index.ts:391

Returns

Promise<PromiseSettledResult<void>[]>

---

updateDatasource()

updateDatasource(datasourceId, updates): Promise<Datasource>

Defined in: src/client/index.ts:365

Parameters

datasourceId

string

updates

UpdateDatasourceRequest

Returns

Promise<Datasource>

---

updateLexical()

updateLexical(id, name?, description?): Promise<LexicalDTO>

Defined in: src/client/index.ts:433

Parameters

id

string

name?

string

description?

string

Returns

Promise<LexicalDTO>

---

updateNotebook()

updateNotebook(id, name?, description?): Promise<Notebook>

Defined in: src/client/index.ts:421

Parameters

id

string

name?

string

description?

string

Returns

Promise<Notebook>

---

updateProject()

updateProject(uid, data): Promise<Project>

Defined in: src/client/index.ts:464

Parameters

uid

string

data

UpdateSpaceRequest

Returns

Promise<Project>

---

updateSecret()

updateSecret(secretId, updates): Promise<Secret>

Defined in: src/client/index.ts:355

Parameters

secretId

string

updates

UpdateSecretRequest

Returns

Promise<Secret>

---

updateSpace()

updateSpace(uid, data): Promise<Space>

Defined in: src/client/index.ts:447

Parameters

uid

string

data

UpdateSpaceRequest

Returns

Promise<Space>

---

updateUserSpace()

updateUserSpace(uid, userId, data): Promise<Space>

Defined in: src/client/index.ts:448

Parameters

uid

string

userId

string

data

UpdateSpaceRequest

Returns

Promise<Space>

---

whoami()

whoami(): Promise<User>

Defined in: src/client/index.ts:340

Returns

Promise<User>

---

wrapAllMethods()

protected wrapAllMethods(): void

Defined in: src/client/base.ts:127

Internal

Wrap all Client methods with handlers for cross-cutting concerns. Called automatically by the DatalayerClient constructor.

Returns

void

Inherited from

DatalayerClientWithMixins.wrapAllMethods