DatalayerClient

Datalayer Core

---

Datalayer Core / DatalayerClient

Class: DatalayerClient

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

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: 'python-cpu-env',
  credits_limit: 100
});

Extends

• DatalayerClientWithMixins

Constructors

Constructor

new DatalayerClient(config): DatalayerClient

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

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:54

Authentication manager

Inherited from

DatalayerClientWithMixins.auth

---

environments

readonly environments: Environment[] = []

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

Environments

Inherited from

DatalayerClientWithMixins.environments

---

handlers?

readonly optional handlers: SDKHandlers

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

Method lifecycle handlers

Inherited from

DatalayerClientWithMixins.handlers

---

iamRunUrl

readonly iamRunUrl: string

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

URL for IAM service

Inherited from

DatalayerClientWithMixins.iamRunUrl

---

runtimesRunUrl

readonly runtimesRunUrl: string

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

URL for Runtimes service

Inherited from

DatalayerClientWithMixins.runtimesRunUrl

---

spacerRunUrl

readonly spacerRunUrl: string

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

URL for Spacer service

Inherited from

DatalayerClientWithMixins.spacerRunUrl

---

token?

optional token: string

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

Authentication token

Inherited from

DatalayerClientWithMixins.token

Methods

calculateCreditsFromMinutes()

calculateCreditsFromMinutes(minutes, burningRate): number

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

Parameters

minutes

number

burningRate

number

Returns

number

Inherited from

DatalayerClientWithMixins.calculateCreditsFromMinutes

---

calculateCreditsRequired()

calculateCreditsRequired(minutes, burningRate): number

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

Parameters

minutes

number

burningRate

number

Returns

number

---

calculateMaxRuntimeMinutes()

calculateMaxRuntimeMinutes(availableCredits, burningRate): number

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

Parameters

availableCredits

number

burningRate

number

Returns

number

---

checkIAMHealth()

checkIAMHealth(): Promise<HealthCheck>

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

Returns

Promise<HealthCheck>

---

checkRuntimesHealth()

checkRuntimesHealth(): Promise<HealthCheck>

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

Returns

Promise<HealthCheck>

---

checkSpacerHealth()

checkSpacerHealth(): Promise<HealthCheck>

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

Returns

Promise<HealthCheck>

---

createLexical()

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

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

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:180

Parameters

spaceId

string

name

string

description

string

file?

Blob | File

Returns

Promise<Notebook>

---

createRuntime()

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

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

Parameters

environmentName

string

type

"notebook" | "terminal" | "job"

givenName

string

minutesLimit

number

fromSnapshotId?

string

Returns

Promise<Runtime>

---

createSnapshot()

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

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

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:171

Parameters

name

string

description

string

variant

string

spaceHandle

string

organizationId

string

seedSpaceId

string

isPublic

boolean

Returns

Promise<Space>

---

deleteRuntime()

deleteRuntime(podName): Promise<void>

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

Parameters

podName

string

Returns

Promise<void>

---

deleteSnapshot()

deleteSnapshot(id): Promise<void>

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

Parameters

id

string

Returns

Promise<void>

---

deleteSpaceItem()

deleteSpaceItem(itemId): Promise<void>

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

Parameters

itemId

string

Returns

Promise<void>

---

ensureRuntime()

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

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

Parameters

environmentName?

string

creditsLimit?

number

waitForReady?

boolean

maxWaitTime?

number

reuseExisting?

boolean

snapshotId?

string

Returns

Promise<Runtime>

---

getCollaborationSessionId()

getCollaborationSessionId(documentId): Promise<string>

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

Parameters

documentId

string

Returns

Promise<string>

---

getConfig()

getConfig(): DatalayerClientConfig

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

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:208

Parameters

itemId

string

Returns

Promise<any>

---

getCredits()

getCredits(): Promise<Credits>

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

Returns

Promise<Credits>

---

getIamRunUrl()

getIamRunUrl(): string

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

Get the IAM service URL.

Returns

string

Inherited from

DatalayerClientWithMixins.getIamRunUrl

---

getLexical()

getLexical(id): Promise<LexicalDTO>

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

Parameters

id

string

Returns

Promise<LexicalDTO>

---

getMySpaces()

getMySpaces(): Promise<Space[]>

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

Returns

Promise<Space[]>

---

getNotebook()

getNotebook(id): Promise<Notebook>

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

Parameters

id

string

Returns

Promise<Notebook>

---

getRuntime()

getRuntime(podName): Promise<Runtime>

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

Parameters

podName

string

Returns

Promise<Runtime>

---

getRuntimesRunUrl()

getRuntimesRunUrl(): string

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

Get the Runtimes service URL.

Returns

string

Inherited from

DatalayerClientWithMixins.getRuntimesRunUrl

---

getSnapshot()

getSnapshot(id): Promise<Snapshot>

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

Parameters

id

string

Returns

Promise<Snapshot>

---

getSpaceItem()

getSpaceItem(itemId): Promise<Notebook | LexicalDTO>

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

Parameters

itemId

string

Returns

Promise<Notebook | LexicalDTO>

---

getSpaceItems()

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

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

Parameters

spaceId

string

Returns

Promise<(Notebook | LexicalDTO)[]>

---

getSpacerRunUrl()

getSpacerRunUrl(): string

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

Get the Spacer service URL.

Returns

string

Inherited from

DatalayerClientWithMixins.getSpacerRunUrl

---

getToken()

getToken(): string | undefined

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

Returns

string | undefined

Inherited from

DatalayerClientWithMixins.getToken

---

listEnvironments()

listEnvironments(): Promise<Environment[]>

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

Returns

Promise<Environment[]>

---

listRuntimes()

listRuntimes(): Promise<Runtime[]>

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

Returns

Promise<Runtime[]>

---

listSnapshots()

listSnapshots(): Promise<Snapshot[]>

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

Returns

Promise<Snapshot[]>

---

login()

login(token): Promise<User>

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

Parameters

token

string

Returns

Promise<User>

---

logout()

logout(): Promise<void>

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

Returns

Promise<void>

---

setToken()

setToken(token): Promise<void>

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

Parameters

token

string

Returns

Promise<void>

Inherited from

DatalayerClientWithMixins.setToken

---

terminateAllRuntimes()

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

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

Returns

Promise<PromiseSettledResult<void>[]>

---

updateLexical()

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

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

Parameters

id

string

name?

string

description?

string

Returns

Promise<LexicalDTO>

---

updateNotebook()

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

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

Parameters

id

string

name?

string

description?

string

Returns

Promise<Notebook>

---

whoami()

whoami(): Promise<User>

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

Returns

Promise<User>

---

wrapAllMethods()

protected wrapAllMethods(): void

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

Internal

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

Returns

void

Inherited from

DatalayerClientWithMixins.wrapAllMethods