Class: FunctionsManager
Manages serverless functions (settings, runtime, and CRUD) for a project.
Constructors
new FunctionsManager()
Internal
Parameters
| Parameter | Type |
|---|---|
ctx | ClientContext |
projectId | string |
Returns
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:46
Methods
activate()
Activate Functions for this project (async)
Parameters
| Parameter | Type | Description |
|---|---|---|
body | object | Activation payload |
body.locationCity | string | Description Deployment location city Example frankfurt |
body.locationCityDisplay? | string | Description Deployment location city display name Example Frankfurt, Germany |
body.locationContinent | string | Description Deployment location continent Example europe |
body.locationCountry | string | Description Deployment location country Example de |
body.locationIsProtected | boolean | Description Whether location is DDoS protected Default false |
body.resourcePackage | string | Description Resource package slug Default fleet-s1 Example fleet-s1 |
Returns
Promise<object>
Activation confirmation
| Name | Type | Description | Defined in |
|---|---|---|---|
message | string | Description Status message Example Activation started | 4Players/cortex-typescript-sdk/src/types.ts:4698 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:124
create()
Create a new serverless function
Parameters
| Parameter | Type | Description |
|---|---|---|
body | object | Function creation payload |
body.authMode | "api_key" | "public" | "signed" | Description Authentication mode Default api_key @enum {string} |
body.code | string | Description Initial source code Example exports.handler = async (event, ctx) => { return { statusCode: 200, body: "Hello" }; }; |
body.description? | string | Description Function description |
body.entrypoint | string | Description Entrypoint function name Default handler |
body.envVars? | object[] | Description Initial environment variables |
body.memory | number | Description Memory limit in MB (128-1024) Default 256 |
body.name | string | Description Function name Example process-webhook |
body.runtime | "nodejs20" | "nodejs22" | Description Runtime environment Default nodejs20 @enum {string} |
body.slug? | string | Description URL-friendly slug (auto-generated if not provided) Example process-webhook |
body.timeout | number | Description Execution timeout in ms (1000-300000) Default 30000 |
Returns
Promise<CortexFunctionInstance>
Live CortexFunctionInstance object
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:277
get()
Get a function by ID
Parameters
| Parameter | Type | Description |
|---|---|---|
functionId | string | Function ID |
Returns
Promise<CortexFunctionInstance>
Live CortexFunctionInstance object
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:291
getDeploymentLocations()
Get available deployment locations
Returns
Promise<object[]>
Array of locations
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:110
getNpmPackageInfo()
Lookup npm package versions
Parameters
| Parameter | Type | Description |
|---|---|---|
packageName | string | NPM package name |
Returns
Promise<object>
Package info with available versions
| Name | Type | Description | Defined in |
|---|---|---|---|
distTags | Record<string, never> | Description Dist tags (latest, next, beta, etc.) Example { * "latest": "6.0.6", * "next": "7.0.0-beta.1" * } | 4Players/cortex-typescript-sdk/src/types.ts:4773 |
name | string | Description Package name Example node-mailjet | 4Players/cortex-typescript-sdk/src/types.ts:4756 |
versions | string[] | Description All available versions (sorted newest first) Example [ "6.0.6", "6.0.5", "6.0.4" ] | 4Players/cortex-typescript-sdk/src/types.ts:4765 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:166
getResourcePackages()
Get available resource packages for function deployment
Returns
Promise<object[]>
Array of resource packages
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:97
getRuntimeStatus()
Get function runtime status
Returns
Promise<object>
Runtime status
| Name | Type | Description | Defined in |
|---|---|---|---|
fleetDeploymentId? | number | Description Fleet deployment ID | 4Players/cortex-typescript-sdk/src/types.ts:4784 |
latestVersion? | string | Description The latest available runtime version Example v1 | 4Players/cortex-typescript-sdk/src/types.ts:4796 |
message | string | Description Status message | 4Players/cortex-typescript-sdk/src/types.ts:4786 |
runtimeVersion? | null | string | Description Runtime version this deployment is pinned to (null = legacy/unpinned) Example v1 | 4Players/cortex-typescript-sdk/src/types.ts:4791 |
serverCount? | number | Description Number of running servers | 4Players/cortex-typescript-sdk/src/types.ts:4782 |
status | | "running" | "stopped" | "starting" | "stopping" | "unknown" | Description Runtime status | 4Players/cortex-typescript-sdk/src/types.ts:4780 |
upgradeAvailable? | boolean | Description Whether a newer runtime version is available to upgrade to | 4Players/cortex-typescript-sdk/src/types.ts:4798 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:181
getRuntimeVersions()
List the available function-runtime versions and the project's current pin.
Returns
Promise<object>
Runtime version catalog (current, latest, upgradeAvailable, versions)
| Name | Type | Description | Defined in |
|---|---|---|---|
current | null | string | Description Version the project is currently pinned to (null = legacy/unpinned) Example v1 | 4Players/cortex-typescript-sdk/src/types.ts:4850 |
latest | string | Description The latest available runtime version Example v1 | 4Players/cortex-typescript-sdk/src/types.ts:4855 |
upgradeAvailable | boolean | Description Whether a newer runtime version is available | 4Players/cortex-typescript-sdk/src/types.ts:4857 |
versions | object[] | Description All published runtime versions (oldest first) | 4Players/cortex-typescript-sdk/src/types.ts:4859 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:233
getSettings()
Get function settings
Returns
Promise<object>
Function settings
| Name | Type | Description | Defined in |
|---|---|---|---|
activationError? | string | Description Error message if activation failed | 4Players/cortex-typescript-sdk/src/types.ts:4556 |
activationStep? | | "pending" | "registry" | "image" | "config" | "deployment" | "server" | "complete" | "error" | Description Current activation step (for async progress tracking) | 4Players/cortex-typescript-sdk/src/types.ts:4554 |
dependencies? | object[] | Description NPM dependencies shared by all functions | 4Players/cortex-typescript-sdk/src/types.ts:4593 |
envVars? | object[] | Description Environment variables shared by all functions (secrets masked) | 4Players/cortex-typescript-sdk/src/types.ts:4595 |
fleetAppId? | number | Description Fleet app ID | 4Players/cortex-typescript-sdk/src/types.ts:4558 |
fleetDeploymentId? | number | Description Fleet deployment ID (app location setting) | 4Players/cortex-typescript-sdk/src/types.ts:4566 |
fleetImageId? | string | Description Fleet binary/image ID | 4Players/cortex-typescript-sdk/src/types.ts:4562 |
fleetRegion? | string | Description Fleet region (deprecated, use locationCity) Example eu-west | 4Players/cortex-typescript-sdk/src/types.ts:4581 |
fleetRegistryId? | number | Description Fleet Docker registry ID | 4Players/cortex-typescript-sdk/src/types.ts:4560 |
fleetServerConfigId? | string | Description Fleet server config ID | 4Players/cortex-typescript-sdk/src/types.ts:4564 |
isActivated | boolean | Description Whether Functions feature is activated | 4Players/cortex-typescript-sdk/src/types.ts:4549 |
locationCity? | string | Description Deployment location city Example frankfurt | 4Players/cortex-typescript-sdk/src/types.ts:4576 |
maxFunctions | number | Description Maximum functions allowed Example 10 | 4Players/cortex-typescript-sdk/src/types.ts:4586 |
maxMemoryPerFunction | number | Description Maximum memory per function (MB) Example 512 | 4Players/cortex-typescript-sdk/src/types.ts:4591 |
resourcePackageSlug? | string | Description Resource package slug Example fleet-s1 | 4Players/cortex-typescript-sdk/src/types.ts:4571 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:57
list()
List functions for this project
Returns
Promise<object[]>
Array of functions
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:263
restartRuntime()
Restart the function runtime
Returns
Promise<object>
Restart confirmation
| Name | Type | Description | Defined in |
|---|---|---|---|
message | string | Description Status message Example Runtime started successfully | 4Players/cortex-typescript-sdk/src/types.ts:4805 |
status | | "running" | "stopped" | "starting" | "stopping" | "unknown" | Description New runtime status | 4Players/cortex-typescript-sdk/src/types.ts:4810 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:220
startRuntime()
Start the function runtime
Returns
Promise<object>
Start confirmation
| Name | Type | Description | Defined in |
|---|---|---|---|
message | string | Description Status message Example Runtime started successfully | 4Players/cortex-typescript-sdk/src/types.ts:4805 |
status | | "running" | "stopped" | "starting" | "stopping" | "unknown" | Description New runtime status | 4Players/cortex-typescript-sdk/src/types.ts:4810 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:194
stopRuntime()
Stop the function runtime
Returns
Promise<object>
Stop confirmation
| Name | Type | Description | Defined in |
|---|---|---|---|
message | string | Description Status message Example Runtime stopped successfully | 4Players/cortex-typescript-sdk/src/types.ts:4817 |
status | | "running" | "stopped" | "starting" | "stopping" | "unknown" | Description New runtime status | 4Players/cortex-typescript-sdk/src/types.ts:4822 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:207
updateDependencies()
Update project-wide function dependencies
Parameters
| Parameter | Type | Description |
|---|---|---|
body | object | Dependencies payload |
body.dependencies | object[] | Description NPM dependencies for the project |
Returns
Promise<object>
Updated settings with message
| Name | Type | Description | Defined in |
|---|---|---|---|
message | string | Description Status message Example Dependencies updated. Runtime restarting... | 4Players/cortex-typescript-sdk/src/types.ts:4719 |
settings | object | Description Updated settings | 4Players/cortex-typescript-sdk/src/types.ts:4714 |
settings.activationError? | string | Description Error message if activation failed | 4Players/cortex-typescript-sdk/src/types.ts:4556 |
settings.activationStep? | | "pending" | "registry" | "image" | "config" | "deployment" | "server" | "complete" | "error" | Description Current activation step (for async progress tracking) | 4Players/cortex-typescript-sdk/src/types.ts:4554 |
settings.dependencies? | object[] | Description NPM dependencies shared by all functions | 4Players/cortex-typescript-sdk/src/types.ts:4593 |
settings.envVars? | object[] | Description Environment variables shared by all functions (secrets masked) | 4Players/cortex-typescript-sdk/src/types.ts:4595 |
settings.fleetAppId? | number | Description Fleet app ID | 4Players/cortex-typescript-sdk/src/types.ts:4558 |
settings.fleetDeploymentId? | number | Description Fleet deployment ID (app location setting) | 4Players/cortex-typescript-sdk/src/types.ts:4566 |
settings.fleetImageId? | string | Description Fleet binary/image ID | 4Players/cortex-typescript-sdk/src/types.ts:4562 |
settings.fleetRegion? | string | Description Fleet region (deprecated, use locationCity) Example eu-west | 4Players/cortex-typescript-sdk/src/types.ts:4581 |
settings.fleetRegistryId? | number | Description Fleet Docker registry ID | 4Players/cortex-typescript-sdk/src/types.ts:4560 |
settings.fleetServerConfigId? | string | Description Fleet server config ID | 4Players/cortex-typescript-sdk/src/types.ts:4564 |
settings.isActivated | boolean | Description Whether Functions feature is activated | 4Players/cortex-typescript-sdk/src/types.ts:4549 |
settings.locationCity? | string | Description Deployment location city Example frankfurt | 4Players/cortex-typescript-sdk/src/types.ts:4576 |
settings.maxFunctions | number | Description Maximum functions allowed Example 10 | 4Players/cortex-typescript-sdk/src/types.ts:4586 |
settings.maxMemoryPerFunction | number | Description Maximum memory per function (MB) Example 512 | 4Players/cortex-typescript-sdk/src/types.ts:4591 |
settings.resourcePackageSlug? | string | Description Resource package slug Example fleet-s1 | 4Players/cortex-typescript-sdk/src/types.ts:4571 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:138
updateEnvVars()
Update project-wide environment variables
Parameters
| Parameter | Type | Description |
|---|---|---|
body | object | Environment variables payload |
body.envVars | object[] | Description Environment variables for the project |
Returns
Promise<object>
Updated settings with message
| Name | Type | Description | Defined in |
|---|---|---|---|
message | string | Description Status message Example Environment variables updated. Runtime restarting... | 4Players/cortex-typescript-sdk/src/types.ts:4749 |
settings | object | Description Updated settings | 4Players/cortex-typescript-sdk/src/types.ts:4744 |
settings.activationError? | string | Description Error message if activation failed | 4Players/cortex-typescript-sdk/src/types.ts:4556 |
settings.activationStep? | | "pending" | "registry" | "image" | "config" | "deployment" | "server" | "complete" | "error" | Description Current activation step (for async progress tracking) | 4Players/cortex-typescript-sdk/src/types.ts:4554 |
settings.dependencies? | object[] | Description NPM dependencies shared by all functions | 4Players/cortex-typescript-sdk/src/types.ts:4593 |
settings.envVars? | object[] | Description Environment variables shared by all functions (secrets masked) | 4Players/cortex-typescript-sdk/src/types.ts:4595 |
settings.fleetAppId? | number | Description Fleet app ID | 4Players/cortex-typescript-sdk/src/types.ts:4558 |
settings.fleetDeploymentId? | number | Description Fleet deployment ID (app location setting) | 4Players/cortex-typescript-sdk/src/types.ts:4566 |
settings.fleetImageId? | string | Description Fleet binary/image ID | 4Players/cortex-typescript-sdk/src/types.ts:4562 |
settings.fleetRegion? | string | Description Fleet region (deprecated, use locationCity) Example eu-west | 4Players/cortex-typescript-sdk/src/types.ts:4581 |
settings.fleetRegistryId? | number | Description Fleet Docker registry ID | 4Players/cortex-typescript-sdk/src/types.ts:4560 |
settings.fleetServerConfigId? | string | Description Fleet server config ID | 4Players/cortex-typescript-sdk/src/types.ts:4564 |
settings.isActivated | boolean | Description Whether Functions feature is activated | 4Players/cortex-typescript-sdk/src/types.ts:4549 |
settings.locationCity? | string | Description Deployment location city Example frankfurt | 4Players/cortex-typescript-sdk/src/types.ts:4576 |
settings.maxFunctions | number | Description Maximum functions allowed Example 10 | 4Players/cortex-typescript-sdk/src/types.ts:4586 |
settings.maxMemoryPerFunction | number | Description Maximum memory per function (MB) Example 512 | 4Players/cortex-typescript-sdk/src/types.ts:4591 |
settings.resourcePackageSlug? | string | Description Resource package slug Example fleet-s1 | 4Players/cortex-typescript-sdk/src/types.ts:4571 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:152
updateSettings()
Update function settings
Parameters
| Parameter | Type | Description |
|---|---|---|
body | object | Updated settings |
body.fleetRegion? | string | Description Fleet region |
body.maxFunctions? | number | Description Maximum functions allowed (requires upgrade) |
body.maxMemoryPerFunction? | number | Description Maximum memory per function (MB) |
Returns
Promise<object>
Updated function settings
| Name | Type | Description | Defined in |
|---|---|---|---|
activationError? | string | Description Error message if activation failed | 4Players/cortex-typescript-sdk/src/types.ts:4556 |
activationStep? | | "pending" | "registry" | "image" | "config" | "deployment" | "server" | "complete" | "error" | Description Current activation step (for async progress tracking) | 4Players/cortex-typescript-sdk/src/types.ts:4554 |
dependencies? | object[] | Description NPM dependencies shared by all functions | 4Players/cortex-typescript-sdk/src/types.ts:4593 |
envVars? | object[] | Description Environment variables shared by all functions (secrets masked) | 4Players/cortex-typescript-sdk/src/types.ts:4595 |
fleetAppId? | number | Description Fleet app ID | 4Players/cortex-typescript-sdk/src/types.ts:4558 |
fleetDeploymentId? | number | Description Fleet deployment ID (app location setting) | 4Players/cortex-typescript-sdk/src/types.ts:4566 |
fleetImageId? | string | Description Fleet binary/image ID | 4Players/cortex-typescript-sdk/src/types.ts:4562 |
fleetRegion? | string | Description Fleet region (deprecated, use locationCity) Example eu-west | 4Players/cortex-typescript-sdk/src/types.ts:4581 |
fleetRegistryId? | number | Description Fleet Docker registry ID | 4Players/cortex-typescript-sdk/src/types.ts:4560 |
fleetServerConfigId? | string | Description Fleet server config ID | 4Players/cortex-typescript-sdk/src/types.ts:4564 |
isActivated | boolean | Description Whether Functions feature is activated | 4Players/cortex-typescript-sdk/src/types.ts:4549 |
locationCity? | string | Description Deployment location city Example frankfurt | 4Players/cortex-typescript-sdk/src/types.ts:4576 |
maxFunctions | number | Description Maximum functions allowed Example 10 | 4Players/cortex-typescript-sdk/src/types.ts:4586 |
maxMemoryPerFunction | number | Description Maximum memory per function (MB) Example 512 | 4Players/cortex-typescript-sdk/src/types.ts:4591 |
resourcePackageSlug? | string | Description Resource package slug Example fleet-s1 | 4Players/cortex-typescript-sdk/src/types.ts:4571 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:71
upgradeRuntime()
Upgrade (or change) the pinned runtime version. Swaps the Fleet binary image and restarts the runtime so the new image is pulled.
Parameters
| Parameter | Type | Description |
|---|---|---|
version | string | The runtime version to deploy (e.g. "v1") |
Returns
Promise<object>
Runtime status after triggering the upgrade
| Name | Type | Description | Defined in |
|---|---|---|---|
fleetDeploymentId? | number | Description Fleet deployment ID | 4Players/cortex-typescript-sdk/src/types.ts:4784 |
latestVersion? | string | Description The latest available runtime version Example v1 | 4Players/cortex-typescript-sdk/src/types.ts:4796 |
message | string | Description Status message | 4Players/cortex-typescript-sdk/src/types.ts:4786 |
runtimeVersion? | null | string | Description Runtime version this deployment is pinned to (null = legacy/unpinned) Example v1 | 4Players/cortex-typescript-sdk/src/types.ts:4791 |
serverCount? | number | Description Number of running servers | 4Players/cortex-typescript-sdk/src/types.ts:4782 |
status | | "running" | "stopped" | "starting" | "stopping" | "unknown" | Description Runtime status | 4Players/cortex-typescript-sdk/src/types.ts:4780 |
upgradeAvailable? | boolean | Description Whether a newer runtime version is available to upgrade to | 4Players/cortex-typescript-sdk/src/types.ts:4798 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:248
verifyFleetCredentials()
Verify Fleet credentials for function activation
Returns
Promise<object>
Verification result
| Name | Type | Description | Defined in |
|---|---|---|---|
email | string | Description User email | 4Players/cortex-typescript-sdk/src/types.ts:4601 |
valid | boolean | Description Whether credentials are valid | 4Players/cortex-typescript-sdk/src/types.ts:4599 |
Defined in
4Players/cortex-typescript-sdk/src/resources/functions.ts:84