Class User

Summary

Create an instance of User class with optional session credentials.

Usage

await new User(topia, {
  profileId: 1,
  credentials: { apiKey: "exampleKey", interactiveNonce: "exampleNonce", urlSlug: "exampleWorld", visitorId: 1 }
});

Hierarchy

SDKController
- User
  - Visitor

Implements

UserInterface

Constructors

constructor

new User(topia: Topia, options?: UserOptionalInterface): User
Parameters
- topia: Topia
- options: UserOptionalInterface = ...
Returns User
Overrides SDKController.constructor
- Defined in controllers/User.ts:38

Properties

credentials

credentials: undefined | InteractiveCredentials

`Optional` dataObject

dataObject?: null | object

`Optional` jwt

jwt?: string

`Optional` profile

profile?: Record<string, any>

`Optional` profileId

profileId?: null | string

requestOptions

requestOptions: object

topia

topia: Topia

Accessors

adminWorlds

get adminWorlds(): {
[key: string]: World;
}
Returns {
[key: string]: World;
}
- [key: string]: World
- Defined in controllers/User.ts:56

assets

get assets(): {
[key: string]: Asset;
}
Returns {
[key: string]: Asset;
}
- [key: string]: Asset
- Defined in controllers/User.ts:60

scenes

get scenes(): {
[key: string]: Scene;
}
Returns {
[key: string]: Scene;
}
- [key: string]: Scene
- Defined in controllers/User.ts:64

worlds

get worlds(): {
[key: string]: World;
}
Returns {
[key: string]: World;
}
- [key: string]: World
- Defined in controllers/User.ts:68

Methods

checkInteractiveCredentials

checkInteractiveCredentials(): Promise<void | ResponseType>
Summary
Verify user has valid interactive credentials

Usage
```
await user.checkInteractiveCredentials();
```
Returns Promise<void | ResponseType>
- Defined in controllers/User.ts:81

errorHandler

errorHandler(__namedParameters: {
    error?: unknown;
    message?: string;
    params?: object;
    sdkMethod?: string;
}): {
    data: {};
    message: string;
    method: string;
    params: object;
    sdkMethod: undefined | string;
    stack: string;
    stackTrace: Error;
    status: number;
    success: boolean;
    url: string;
}
Parameters
- __namedParameters: {
      error?: unknown;
      message?: string;
      params?: object;
      sdkMethod?: string;
  }
  - Optional error?: unknown
  - Optional message?: string
  - Optional params?: object
  - Optional sdkMethod?: string
Returns {
    data: {};
    message: string;
    method: string;
    params: object;
    sdkMethod: undefined | string;
    stack: string;
    stackTrace: Error;
    status: number;
    success: boolean;
    url: string;
}
- data: {}
- message: string
- method: string
- params: object
- sdkMethod: undefined | string
- stack: string
- stackTrace: Error
- status: number
- success: boolean
- url: string
Inherited from SDKController.errorHandler
- Defined in controllers/SDKController.ts:82

fetchAdminWorldsByKey

fetchAdminWorldsByKey(): Promise<void | ResponseType>
Summary
Retrieves all worlds a user with matching API Key is an admin in, creates a new World object for each, and creates new map of Worlds accessible via user.adminWorlds.

Usage
```
await user.fetchAdminWorldsByKey();
const adminWorlds = user.adminWorlds;
```
Returns Promise<void | ResponseType>
- Defined in controllers/User.ts:211

fetchAssets

fetchAssets(): Promise<void | ResponseType>
Summary
Returns all assets owned by User when an email address is provided.

Usage
```
await user.fetchAssets();
const userAssets = user.assets;
```
Returns Promise<void | ResponseType>
Implementation of UserInterface.fetchAssets
- Defined in controllers/User.ts:103

fetchDataObject

fetchDataObject(): Promise<void | ResponseType>
Summary
Retrieves the data object for a user.

Usage
```
const dataObject = await user.fetchDataObject();
```
Returns Promise<void | ResponseType>
Implementation of UserInterface.fetchDataObject
- Defined in controllers/User.ts:258

fetchInteractiveWorldsByKey

fetchInteractiveWorldsByKey(interactivePublicKey: string): Promise<object | ResponseType>
Summary
Retrieves ids of all dropped assets in all worlds with a matching interactivePublicKey.

Usage
```
await user.fetchInteractiveWorldsByKey("interactivePublicKeyExample");
const interactiveWorlds = user.interactiveWorlds;
```
Parameters
- interactivePublicKey: string
Returns Promise<object | ResponseType>
- Defined in controllers/User.ts:237

fetchPlatformAssets

fetchPlatformAssets(): Promise<object | ResponseType>
Summary
Returns all platform assets.

Usage
```
const assets = await user.fetchPlatformAssets();
```
Returns Promise<object | ResponseType>
Implementation of UserInterface.fetchPlatformAssets
- Defined in controllers/User.ts:129

fetchScenes

fetchScenes(): Promise<void | ResponseType>
Summary
Returns all scenes owned by User.

Usage
```
await user.fetchScenes();
const userScenes = user.scenes;
```
Returns Promise<void | ResponseType>
Implementation of UserInterface.fetchScenes
- Defined in controllers/User.ts:148

fetchWorldsByKey

fetchWorldsByKey(): Promise<void | ResponseType>
Summary
Retrieves all worlds owned by user with matching API Key, creates a new World object for each, and creates new map of Worlds accessible via user.worlds.

Usage
```
await user.fetchWorldsByKey();
const userWorlds = user.worlds;
```
Result
```
{ urlSlug: new World({ apiKey, worldArgs, urlSlug }) }
```
Returns Promise<void | ResponseType>
Implementation of UserInterface.fetchWorldsByKey
- Defined in controllers/User.ts:182

incrementDataObjectValue

incrementDataObjectValue(path: string, amount: number, options?: {
    analytics?: string[];
    lock?: {
        lockId: string;
        releaseLock?: boolean;
    };
}): Promise<void | ResponseType>
Summary
Increments a specific value in the data object for a user by the amount specified. Must have valid interactive credentials from a visitor in the world.

Optionally, a lock can be provided with this request to ensure only one update happens at a time between all updates that share the same lock id

Usage
```
await user.incrementDataObjectValue(
  "path": "key",
  "amount": 1,
);
```
Parameters
- path: string
- amount: number
- options: {
      analytics?: string[];
      lock?: {
          lockId: string;
          releaseLock?: boolean;
      };
  } = {}
  - Optional analytics?: string[]
  - Optional lock?: {
    lockId: string;
    releaseLock?: boolean;
    }
    - lockId: string
    - Optional releaseLock?: boolean
Returns Promise<void | ResponseType>
Implementation of UserInterface.incrementDataObjectValue
- Defined in controllers/User.ts:348

setDataObject

setDataObject(dataObject: undefined | null | object, options?: {
    analytics?: string[];
    lock?: {
        lockId: string;
        releaseLock?: boolean;
    };
}): Promise<void | ResponseType>
Summary
Sets the data object for a user.

Optionally, a lock can be provided with this request to ensure only one update happens at a time between all updates that share the same lock id

Usage
```
await user.setDataObject({
  "exampleKey": "exampleValue",
});
```
Parameters
- dataObject: undefined | null | object
- options: {
      analytics?: string[];
      lock?: {
          lockId: string;
          releaseLock?: boolean;
      };
  } = {}
  - Optional analytics?: string[]
  - Optional lock?: {
    lockId: string;
    releaseLock?: boolean;
    }
    - lockId: string
    - Optional releaseLock?: boolean
Returns Promise<void | ResponseType>
Implementation of UserInterface.setDataObject
- Defined in controllers/User.ts:285

topiaPublicApi

topiaPublicApi(): AxiosInstance
Returns AxiosInstance
Inherited from SDKController.topiaPublicApi
- Defined in controllers/SDKController.ts:78

updateDataObject

updateDataObject(dataObject: object, options?: {
    analytics?: string[];
    lock?: {
        lockId: string;
        releaseLock?: boolean;
    };
}): Promise<void | ResponseType>
Summary
Updates the data object for a user.

Optionally, a lock can be provided with this request to ensure only one update happens at a time between all updates that share the same lock id

Usage
```
await user.updateDataObject({
  "exampleKey": "exampleValue",
});
```
Parameters
- dataObject: object
- options: {
      analytics?: string[];
      lock?: {
          lockId: string;
          releaseLock?: boolean;
      };
  } = {}
  - Optional analytics?: string[]
  - Optional lock?: {
    lockId: string;
    releaseLock?: boolean;
    }
    - lockId: string
    - Optional releaseLock?: boolean
Returns Promise<void | ResponseType>
- Defined in controllers/User.ts:316

Class User

Summary

Usage

Hierarchy

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

topia: Topia

options: UserOptionalInterface = ...

Returns User

Properties

credentials

Optional dataObject

Optional jwt

Optional profile

Optional profileId

requestOptions

topia

Accessors

adminWorlds

Returns { [key: string]: World; }

[key: string]: World

assets

Returns { [key: string]: Asset; }

[key: string]: Asset

scenes

Returns { [key: string]: Scene; }

[key: string]: Scene

worlds

Returns { [key: string]: World; }

[key: string]: World

Methods

checkInteractiveCredentials

Summary

Usage

Returns Promise<void | ResponseType>

errorHandler

Parameters

__namedParameters: { error?: unknown; message?: string; params?: object; sdkMethod?: string; }

Optional error?: unknown

Optional message?: string

Optional params?: object

Optional sdkMethod?: string

Returns { data: {}; message: string; method: string; params: object; sdkMethod: undefined | string; stack: string; stackTrace: Error; status: number; success: boolean; url: string; }

data: {}

message: string

method: string

params: object

sdkMethod: undefined | string

stack: string

stackTrace: Error

status: number

success: boolean

url: string

fetchAdminWorldsByKey

Summary

Usage

Returns Promise<void | ResponseType>

fetchAssets

Summary

Usage

Returns Promise<void | ResponseType>

fetchDataObject

Summary

Usage

Returns Promise<void | ResponseType>

fetchInteractiveWorldsByKey

Summary

Usage

Parameters

interactivePublicKey: string

Returns Promise<object | ResponseType>

fetchPlatformAssets

Summary

`Optional` dataObject

`Optional` jwt

`Optional` profile

`Optional` profileId

Returns {
[key: string]: World;
}

Returns {
[key: string]: Asset;
}

Returns {
[key: string]: Scene;
}

Returns {
[key: string]: World;
}

__namedParameters: {
error?: unknown;
message?: string;
params?: object;
sdkMethod?: string;
}

`Optional` error?: unknown

`Optional` message?: string

`Optional` params?: object

`Optional` sdkMethod?: string

Returns {
data: {};
message: string;
method: string;
params: object;
sdkMethod: undefined | string;
stack: string;
stackTrace: Error;
status: number;
success: boolean;
url: string;
}

options: {
analytics?: string[];
lock?: {
lockId: string;
releaseLock?: boolean;
};
} = {}

`Optional` analytics?: string[]

`Optional` lock?: {
lockId: string;
releaseLock?: boolean;
}

`Optional` releaseLock?: boolean

options: {
analytics?: string[];
lock?: {
lockId: string;
releaseLock?: boolean;
};
} = {}

`Optional` analytics?: string[]

`Optional` lock?: {
lockId: string;
releaseLock?: boolean;
}

`Optional` releaseLock?: boolean

options: {
analytics?: string[];
lock?: {
lockId: string;
releaseLock?: boolean;
};
} = {}

`Optional` analytics?: string[]

`Optional` lock?: {
lockId: string;
releaseLock?: boolean;
}

`Optional` releaseLock?: boolean