runtime/binding

Type Aliases

AiChatInput

type AiChatInput = object;

Defined in: platform-utils/src/runtime/binding.ts:64

Properties

Property	Modifier	Type	Defined in
messages	readonly	readonly object[]	platform-utils/src/runtime/binding.ts:65
model?	readonly	string	platform-utils/src/runtime/binding.ts:69
temperature?	readonly	number	platform-utils/src/runtime/binding.ts:70

---

AiInferInput

type AiInferInput = object;

Defined in: platform-utils/src/runtime/binding.ts:52

Properties

Property	Modifier	Type	Defined in
model?	readonly	string	platform-utils/src/runtime/binding.ts:54
prompt	readonly	string	platform-utils/src/runtime/binding.ts:53
schema?	readonly	unknown	platform-utils/src/runtime/binding.ts:56
temperature?	readonly	number	platform-utils/src/runtime/binding.ts:55

---

AiInferResult

type AiInferResult = object;

Defined in: platform-utils/src/runtime/binding.ts:59

Properties

Property	Modifier	Type	Defined in
text	readonly	string	platform-utils/src/runtime/binding.ts:60
usage?	readonly	unknown	platform-utils/src/runtime/binding.ts:61

---

DbQueryConfig

type DbQueryConfig = object;

Defined in: platform-utils/src/runtime/binding.ts:10

Serializable query payload for the host db binding (no driver callbacks).

Properties

Property	Modifier	Type	Defined in
rowMode?	readonly	"array"	platform-utils/src/runtime/binding.ts:12
text	readonly	string	platform-utils/src/runtime/binding.ts:11
values?	readonly	readonly unknown[]	platform-utils/src/runtime/binding.ts:13

---

DbQueryInput

type DbQueryInput = 
  | string
  | DbQueryConfig;

Defined in: platform-utils/src/runtime/binding.ts:16

---

DbQueryResult

type DbQueryResult = object;

Defined in: platform-utils/src/runtime/binding.ts:4

Properties

Property	Modifier	Type	Defined in
rowCount	readonly	number	platform-utils/src/runtime/binding.ts:6
rows	readonly	readonly unknown[]	platform-utils/src/runtime/binding.ts:5

---

GeolocationSuggestion

type GeolocationSuggestion = object;

Defined in: platform-utils/src/runtime/binding.ts:132

Properties

Property	Modifier	Type	Defined in
formattedAddress	readonly	string	platform-utils/src/runtime/binding.ts:133
latitude	readonly	number | null	platform-utils/src/runtime/binding.ts:134
longitude	readonly	number | null	platform-utils/src/runtime/binding.ts:135

---

HostAiBinding

type HostAiBinding = object;

Defined in: platform-utils/src/runtime/binding.ts:73

Methods

chat()

chat(input): Promise<AiInferResult>;

Defined in: platform-utils/src/runtime/binding.ts:75

Parameters

Parameter	Type
input	AiChatInput

Returns

Promise<AiInferResult>

infer()

infer(input): Promise<AiInferResult>;

Defined in: platform-utils/src/runtime/binding.ts:74

Parameters

Parameter	Type
input	AiInferInput

Returns

Promise<AiInferResult>

---

HostDbBinding

type HostDbBinding = object;

Defined in: platform-utils/src/runtime/binding.ts:18

Methods

begin()

begin(): Promise<string>;

Defined in: platform-utils/src/runtime/binding.ts:20

Returns

Promise<string>

commit()

commit(txId): Promise<void>;

Defined in: platform-utils/src/runtime/binding.ts:22

Parameters

Parameter	Type
txId	string

Returns

Promise<void>

query()

query(sql, params?): Promise<DbQueryResult>;

Defined in: platform-utils/src/runtime/binding.ts:19

Parameters

Parameter	Type
sql	DbQueryInput
params?	readonly unknown[]

Returns

Promise<DbQueryResult>

rollback()

rollback(txId): Promise<void>;

Defined in: platform-utils/src/runtime/binding.ts:23

Parameters

Parameter	Type
txId	string

Returns

Promise<void>

txQuery()

txQuery(
   txId, 
   sql, 
params?): Promise<DbQueryResult>;

Defined in: platform-utils/src/runtime/binding.ts:21

Parameters

Parameter	Type
txId	string
sql	DbQueryInput
params?	readonly unknown[]

Returns

Promise<DbQueryResult>

---

HostFileStorageBinding

type HostFileStorageBinding = object;

Defined in: platform-utils/src/runtime/binding.ts:44

File bytes cross the isolate boundary as raw Uint8Array. The V8 isolate marshals binding args/returns with v8.serialize (structured clone), which supports typed arrays natively, so base64 would only add overhead.

Methods

delete()

delete(key): Promise<void>;

Defined in: platform-utils/src/runtime/binding.ts:47

Parameters

Parameter	Type
key	string

Returns

Promise<void>

get()

get(key): Promise<Uint8Array<ArrayBufferLike> | null>;

Defined in: platform-utils/src/runtime/binding.ts:46

Parameters

Parameter	Type
key	string

Returns

Promise<Uint8Array<ArrayBufferLike> | null>

presignGet()

presignGet(key, ttlSeconds): Promise<PresignResult>;

Defined in: platform-utils/src/runtime/binding.ts:49

Parameters

Parameter	Type
key	string
ttlSeconds	number

Returns

Promise<PresignResult>

presignPut()

presignPut(key, ttlSeconds): Promise<PresignResult>;

Defined in: platform-utils/src/runtime/binding.ts:48

Parameters

Parameter	Type
key	string
ttlSeconds	number

Returns

Promise<PresignResult>

put()

put(
   key, 
   body, 
contentType?): Promise<void>;

Defined in: platform-utils/src/runtime/binding.ts:45

Parameters

Parameter	Type
key	string
body	Uint8Array
contentType?	string

Returns

Promise<void>

---

HostMapsBinding

type HostMapsBinding = object;

Defined in: platform-utils/src/runtime/binding.ts:142

Maps operations execute in the trusted host. Tenant runtimes receive only derived place data or rendered image bytes, never provider credentials.

Methods

autocompleteGeolocation()

autocompleteGeolocation(query): Promise<readonly GeolocationSuggestion[]>;

Defined in: platform-utils/src/runtime/binding.ts:144

Parameters

Parameter	Type
query	string

Returns

Promise<readonly GeolocationSuggestion[]>

renderStaticMap()

renderStaticMap(input): Promise<StaticMapRenderResult>;

Defined in: platform-utils/src/runtime/binding.ts:143

Parameters

Parameter	Type
input	{ markers: object[]; }
input.markers	object[]

Returns

Promise<StaticMapRenderResult>

---

HostNotificationsBinding

type HostNotificationsBinding = object;

Defined in: platform-utils/src/runtime/binding.ts:93

Methods

send()

send(input): Promise<NotificationDeliveryResult>;

Defined in: platform-utils/src/runtime/binding.ts:94

Parameters

Parameter	Type
input	NotificationDeliveryInput

Returns

Promise<NotificationDeliveryResult>

---

NotificationChannel

type NotificationChannel = "email" | "telegram" | "whatsapp" | "web";

Defined in: platform-utils/src/runtime/binding.ts:78

---

NotificationDeliveryInput

type NotificationDeliveryInput = object;

Defined in: platform-utils/src/runtime/binding.ts:80

Properties

Property	Modifier	Type	Defined in
channels	readonly	readonly NotificationChannel[]	platform-utils/src/runtime/binding.ts:85
cta?	readonly	| { label: string; url: string; } | null	platform-utils/src/runtime/binding.ts:86
message	readonly	string	platform-utils/src/runtime/binding.ts:84
organizationId	readonly	string	platform-utils/src/runtime/binding.ts:81
recipientUserId	readonly	string	platform-utils/src/runtime/binding.ts:82
subject	readonly	string	platform-utils/src/runtime/binding.ts:83

---

NotificationDeliveryResult

type NotificationDeliveryResult = object;

Defined in: platform-utils/src/runtime/binding.ts:89

Index Signature

[channel: string]: object

---

PresignResult

type PresignResult = object;

Defined in: platform-utils/src/runtime/binding.ts:26

Properties

Property	Modifier	Type	Defined in
expiresAt	readonly	string	platform-utils/src/runtime/binding.ts:28
url	readonly	string	platform-utils/src/runtime/binding.ts:27

---

RuntimeFacilityBindings

type RuntimeFacilityBindings = object;

Defined in: platform-utils/src/runtime/binding.ts:152

Capabilities supplied by whichever platform hosts a tenant runtime. The runtime owns this contract; hosts own the implementations and credentials. Optional capabilities fail at their point of use, allowing the same build to run on platforms with different facility sets.

Properties

Property	Modifier	Type	Defined in
ai?	readonly	HostAiBinding	platform-utils/src/runtime/binding.ts:155
db	readonly	HostDbBinding	platform-utils/src/runtime/binding.ts:153
fileStorage?	readonly	HostFileStorageBinding	platform-utils/src/runtime/binding.ts:154
maps?	readonly	HostMapsBinding	platform-utils/src/runtime/binding.ts:157
notifications?	readonly	HostNotificationsBinding	platform-utils/src/runtime/binding.ts:156

---

RuntimeFacilityRequirement

type RuntimeFacilityRequirement = "db" | "fileStorage" | "integrationDelivery" | "queue" | "ai" | "maps";

Defined in: platform-utils/src/runtime/binding.ts:160

---

StaticMapInput

type StaticMapInput = z.infer<typeof StaticMapInputSchema>;

Defined in: platform-utils/src/runtime/binding.ts:121

---

StaticMapMarker

type StaticMapMarker = object;

Defined in: platform-utils/src/runtime/binding.ts:97

Properties

Property	Modifier	Type	Defined in
label?	readonly	string	platform-utils/src/runtime/binding.ts:100
latitude	readonly	number	platform-utils/src/runtime/binding.ts:98
longitude	readonly	number	platform-utils/src/runtime/binding.ts:99
tone?	readonly	"default" | "alert"	platform-utils/src/runtime/binding.ts:101

---

StaticMapRenderResult

type StaticMapRenderResult = object;

Defined in: platform-utils/src/runtime/binding.ts:123

Properties

Property	Modifier	Type	Defined in
data	readonly	Uint8Array	platform-utils/src/runtime/binding.ts:125
markerPositions	readonly	readonly object[]	platform-utils/src/runtime/binding.ts:126
mimeType	readonly	"image/png" | "image/jpeg"	platform-utils/src/runtime/binding.ts:124

---

WorkspaceBillingSummary

type WorkspaceBillingSummary = object;

Defined in: platform-utils/src/runtime/binding.ts:33

Properties

Property	Modifier	Type	Defined in
currentPeriodEnd	readonly	string | null	platform-utils/src/runtime/binding.ts:35
hasPaymentMethod	readonly	boolean	platform-utils/src/runtime/binding.ts:36
status	readonly	string	platform-utils/src/runtime/binding.ts:34

Variables

NORBITAL_BILLING_HEADER

const NORBITAL_BILLING_HEADER: "x-norbital-billing-json" = 'x-norbital-billing-json';

Defined in: platform-utils/src/runtime/binding.ts:31

---

StaticMapInputSchema

const StaticMapInputSchema: ZodObject<{
  markers: ZodArray<ZodObject<{
     label: ZodOptional<ZodString>;
     latitude: ZodNumber;
     longitude: ZodNumber;
     tone: ZodOptional<ZodEnum<{
        alert: "alert";
        default: "default";
     }>>;
  }, $strip>>;
}, $strip>;

Defined in: platform-utils/src/runtime/binding.ts:104

Functions

requiredRuntimeFacilities()

function requiredRuntimeFacilities(manifest): readonly RuntimeFacilityRequirement[];

Defined in: platform-utils/src/runtime/binding.ts:164

Facilities implied by the portable workspace manifest, independent of a particular host.

Parameters

Parameter	Type
manifest	NorbitalManifest

Returns

readonly RuntimeFacilityRequirement[]