DatalayerClient

Datalayer Core

---

Datalayer Core / DatalayerClient

Class: DatalayerClient

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

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

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

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

Parameters

minutes

number

burningRate

number

Returns

number

Inherited from

DatalayerClientWithMixins.calculateCreditsFromMinutes

---

calculateCreditsRequired()

calculateCreditsRequired(minutes, burningRate): number

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

Parameters

minutes

number

burningRate

number

Returns

number

---

calculateMaxRuntimeMinutes()

calculateMaxRuntimeMinutes(availableCredits, burningRate): number

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

Parameters

availableCredits

number

burningRate

number

Returns

number

---

checkIAMHealth()

checkIAMHealth(): Promise<HealthCheck>

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

Returns

Promise<HealthCheck>

---

checkRuntimesHealth()

checkRuntimesHealth(): Promise<HealthCheck>

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

Returns

Promise<HealthCheck>

---

checkSpacerHealth()

checkSpacerHealth(): Promise<HealthCheck>

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

Returns

Promise<HealthCheck>

---

createDatasource()

createDatasource(data): Promise<Datasource>

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

Parameters

data

CreateDatasourceRequest

Returns

Promise<Datasource>

---

createLexical()

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

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

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

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

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

Parameters

data

CreateSecretRequest

Returns

Promise<Secret>

---

createSnapshot()

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

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

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

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

Parameters

datasourceId

string

Returns

Promise<void>

---

deleteRuntime()

deleteRuntime(podName): Promise<void>

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

Parameters

podName

string

Returns

Promise<void>

---

deleteSecret()

deleteSecret(secretId): Promise<void>

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

Parameters

secretId

string

Returns

Promise<void>

---

deleteSnapshot()

deleteSnapshot(id): Promise<void>

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

Parameters

id

string

Returns

Promise<void>

---

deleteSpaceItem()

deleteSpaceItem(itemId): Promise<void>

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

Parameters

itemId

string

Returns

Promise<void>

---

ensureRuntime()

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

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

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

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

Parameters

itemId

string

Returns

Promise<any>

---

getCredits()

getCredits(): Promise<Credits>

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

Returns

Promise<Credits>

---

getDatasource()

getDatasource(datasourceId): Promise<Datasource>

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

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

Parameters

id

string

Returns

Promise<LexicalDTO>

---

getMySpaces()

getMySpaces(): Promise<Space[]>

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

Returns

Promise<Space[]>

---

getNotebook()

getNotebook(id): Promise<Notebook>

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

Parameters

id

string

Returns

Promise<Notebook>

---

getRuntime()

getRuntime(podName): Promise<Runtime>

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

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

Parameters

secretId

string

Returns

Promise<Secret>

---

getSnapshot()

getSnapshot(id): Promise<Snapshot>

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

Parameters

id

string

Returns

Promise<Snapshot>

---

getSpaceItem()

getSpaceItem(itemId): Promise<LexicalDTO | Notebook>

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

Parameters

itemId

string

Returns

Promise<LexicalDTO | Notebook>

---

getSpaceItems()

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

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

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

Returns

string | undefined

Inherited from

DatalayerClientWithMixins.getToken

---

listDatasources()

listDatasources(): Promise<Datasource[]>

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

Returns

Promise<Datasource[]>

---

listEnvironments()

listEnvironments(): Promise<Environment[]>

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

Returns

Promise<Environment[]>

---

listRuntimes()

listRuntimes(): Promise<Runtime[]>

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

Returns

Promise<Runtime[]>

---

listSecrets()

listSecrets(): Promise<Secret[]>

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

Returns

Promise<Secret[]>

---

listSnapshots()

listSnapshots(): Promise<Snapshot[]>

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

Returns

Promise<Snapshot[]>

---

login()

login(token): Promise<User>

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

Parameters

token

string

Returns

Promise<User>

---

logout()

logout(): Promise<void>

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

Returns

Promise<void>

---

setToken()

setToken(token): Promise<void>

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

Parameters

token

string

Returns

Promise<void>

Inherited from

DatalayerClientWithMixins.setToken

---

terminateAllRuntimes()

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

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

Returns

Promise<PromiseSettledResult<void>[]>

---

updateDatasource()

updateDatasource(datasourceId, updates): Promise<Datasource>

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

Parameters

datasourceId

string

updates

UpdateDatasourceRequest

Returns

Promise<Datasource>

---

updateLexical()

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

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

Parameters

id

string

name?

string

description?

string

Returns

Promise<LexicalDTO>

---

updateNotebook()

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

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

Parameters

id

string

name?

string

description?

string

Returns

Promise<Notebook>

---

updateSecret()

updateSecret(secretId, updates): Promise<Secret>

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

Parameters

secretId

string

updates

UpdateSecretRequest

Returns

Promise<Secret>

---

whoami()

whoami(): Promise<User>

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

Returns

Promise<User>

---

wrapAllMethods()

protected wrapAllMethods(): void

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

Internal

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

Returns

void

Inherited from

DatalayerClientWithMixins.wrapAllMethods