@hypersoniclabs/helix-sdk 0.1.1 → 0.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +954 -2
- package/dist/action-surface.d.ts +182 -0
- package/dist/action-surface.js +1032 -0
- package/dist/action-surface.js.map +1 -0
- package/dist/camera.d.ts +78 -0
- package/dist/camera.js +640 -0
- package/dist/camera.js.map +1 -0
- package/dist/dev-shell/criteria.d.ts +46 -0
- package/dist/dev-shell/criteria.js +98 -0
- package/dist/dev-shell/criteria.js.map +1 -0
- package/dist/dev-shell/index.d.ts +189 -0
- package/dist/dev-shell/index.js +287 -0
- package/dist/dev-shell/index.js.map +1 -0
- package/dist/dev-shell/keys.d.ts +14 -0
- package/dist/dev-shell/keys.js +78 -0
- package/dist/dev-shell/keys.js.map +1 -0
- package/dist/dev-shell/simulator.d.ts +436 -0
- package/dist/dev-shell/simulator.js +1634 -0
- package/dist/dev-shell/simulator.js.map +1 -0
- package/dist/dev-shell/state.d.ts +148 -0
- package/dist/dev-shell/state.js +196 -0
- package/dist/dev-shell/state.js.map +1 -0
- package/dist/device-definition-resolver.d.ts +34 -0
- package/dist/device-definition-resolver.js +172 -0
- package/dist/device-definition-resolver.js.map +1 -0
- package/dist/device-trial.d.ts +3 -0
- package/dist/device-trial.js +132 -0
- package/dist/device-trial.js.map +1 -0
- package/dist/devices.d.ts +228 -0
- package/dist/devices.js +198 -0
- package/dist/devices.js.map +1 -0
- package/dist/dreamerAudio.d.ts +126 -0
- package/dist/dreamerAudio.js +135 -0
- package/dist/dreamerAudio.js.map +1 -0
- package/dist/generated/runtime-contract.d.ts +15529 -0
- package/dist/generated/runtime-contract.js +20470 -0
- package/dist/generated/runtime-contract.js.map +1 -0
- package/dist/index.d.ts +364 -3
- package/dist/index.js +1954 -13
- package/dist/index.js.map +1 -1
- package/dist/interaction-mode.d.ts +172 -0
- package/dist/interaction-mode.js +553 -0
- package/dist/interaction-mode.js.map +1 -0
- package/dist/internal/avatar-pose.d.ts +25 -0
- package/dist/internal/avatar-pose.js +46 -0
- package/dist/internal/avatar-pose.js.map +1 -0
- package/dist/internal/keyed-collection.d.ts +2 -0
- package/dist/internal/keyed-collection.js +12 -0
- package/dist/internal/keyed-collection.js.map +1 -0
- package/dist/internal/vehicle-detach-action.d.ts +2 -0
- package/dist/internal/vehicle-detach-action.js +6 -0
- package/dist/internal/vehicle-detach-action.js.map +1 -0
- package/dist/matchmaking.d.ts +433 -0
- package/dist/matchmaking.js +1487 -0
- package/dist/matchmaking.js.map +1 -0
- package/dist/materials.d.ts +122 -0
- package/dist/materials.js +217 -0
- package/dist/materials.js.map +1 -0
- package/dist/multiplayer-accessors.d.ts +100 -0
- package/dist/multiplayer-accessors.js +200 -0
- package/dist/multiplayer-accessors.js.map +1 -0
- package/dist/multiplayer-contract/avatar-pose.d.ts +112 -0
- package/dist/multiplayer-contract/avatar-pose.js +250 -0
- package/dist/multiplayer-contract/avatar-pose.js.map +1 -0
- package/dist/multiplayer-contract/credential.d.ts +80 -0
- package/dist/multiplayer-contract/credential.js +5 -0
- package/dist/multiplayer-contract/credential.js.map +1 -0
- package/dist/multiplayer-contract/final-rest.d.ts +66 -0
- package/dist/multiplayer-contract/final-rest.js +38 -0
- package/dist/multiplayer-contract/final-rest.js.map +1 -0
- package/dist/multiplayer-contract/index.d.ts +20 -0
- package/dist/multiplayer-contract/index.js +41 -0
- package/dist/multiplayer-contract/index.js.map +1 -0
- package/dist/multiplayer-contract/messages.d.ts +731 -0
- package/dist/multiplayer-contract/messages.js +237 -0
- package/dist/multiplayer-contract/messages.js.map +1 -0
- package/dist/multiplayer-contract/room.d.ts +177 -0
- package/dist/multiplayer-contract/room.js +17 -0
- package/dist/multiplayer-contract/room.js.map +1 -0
- package/dist/multiplayer-contract/state.d.ts +241 -0
- package/dist/multiplayer-contract/state.js +15 -0
- package/dist/multiplayer-contract/state.js.map +1 -0
- package/dist/multiplayer-final-rest.d.ts +32 -0
- package/dist/multiplayer-final-rest.js +217 -0
- package/dist/multiplayer-final-rest.js.map +1 -0
- package/dist/multiplayer.d.ts +624 -0
- package/dist/multiplayer.js +2503 -0
- package/dist/multiplayer.js.map +1 -0
- package/dist/package.json +3 -0
- package/dist/protocol.d.ts +859 -1
- package/dist/protocol.js +117 -5
- package/dist/protocol.js.map +1 -1
- package/dist/runtime-contract/index.d.ts +15 -0
- package/dist/runtime-contract/index.js +12 -0
- package/dist/runtime-contract/index.js.map +1 -0
- package/dist/server-clock.d.ts +25 -0
- package/dist/server-clock.js +88 -0
- package/dist/server-clock.js.map +1 -0
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/universal-vehicles.d.ts +111 -0
- package/dist/universal-vehicles.js +2 -0
- package/dist/universal-vehicles.js.map +1 -0
- package/dist/vault.d.ts +562 -0
- package/dist/vault.js +365 -0
- package/dist/vault.js.map +1 -0
- package/dist/vehicle-specialty-placement.d.ts +28 -0
- package/dist/vehicle-specialty-placement.js +154 -0
- package/dist/vehicle-specialty-placement.js.map +1 -0
- package/dist/vehicle-specialty-transport.d.ts +78 -0
- package/dist/vehicle-specialty-transport.js +183 -0
- package/dist/vehicle-specialty-transport.js.map +1 -0
- package/dist/voice.d.ts +229 -0
- package/dist/voice.js +1348 -0
- package/dist/voice.js.map +1 -0
- package/generated/runtime-contract/helix-runtime-contract.json +13332 -0
- package/generated/runtime-contract/known-answer.json +20471 -0
- package/generated/runtime-contract/known-answer.schema.json +630 -0
- package/generated/runtime-contract/runtime-contract.schema.json +607 -0
- package/generated/runtime-contract/unreal/HelixRuntimeContract.generated.h +908 -0
- package/package.json +44 -5
package/dist/devices.js
ADDED
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* World-scoped persistence backed by the existing HELIX dataStore contract.
|
|
3
|
+
* It deliberately never addresses a Universal Item instance: the same owned
|
|
4
|
+
* item keeps its per-instance state, while a Build-authored Device uses this
|
|
5
|
+
* World namespace and lifecycle.
|
|
6
|
+
*/
|
|
7
|
+
export class WorldDeviceDataStorePersistence {
|
|
8
|
+
dataStore;
|
|
9
|
+
constructor(dataStore) {
|
|
10
|
+
this.dataStore = dataStore;
|
|
11
|
+
}
|
|
12
|
+
key(placementId) {
|
|
13
|
+
return `world:device:${placementId}`;
|
|
14
|
+
}
|
|
15
|
+
async load(placementId) {
|
|
16
|
+
const entry = await this.dataStore.getEntry(this.key(placementId));
|
|
17
|
+
return entry && entry.value && typeof entry.value === 'object'
|
|
18
|
+
? { value: entry.value, version: entry.version }
|
|
19
|
+
: null;
|
|
20
|
+
}
|
|
21
|
+
async save(placementId, value, expectedVersion) {
|
|
22
|
+
await this.dataStore.set(this.key(placementId), value, { expectedVersion });
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Powers the host itself grants, independent of any renderer adapter.
|
|
27
|
+
*
|
|
28
|
+
* A definition declaring a capability outside this set must have it granted by
|
|
29
|
+
* `adapter.capabilities` or `mount()` refuses the definition. Adding an entry
|
|
30
|
+
* here is how a first-party power reaches the host without every adapter
|
|
31
|
+
* having to claim it.
|
|
32
|
+
*/
|
|
33
|
+
const PLATFORM_DEVICE_CAPABILITIES = new Set([
|
|
34
|
+
'clock.serverTime',
|
|
35
|
+
'room.authority',
|
|
36
|
+
'signals.local',
|
|
37
|
+
'state.durable',
|
|
38
|
+
'state.typed',
|
|
39
|
+
'app.image.remote',
|
|
40
|
+
'character.posture',
|
|
41
|
+
'character.animate',
|
|
42
|
+
'character.hand',
|
|
43
|
+
]);
|
|
44
|
+
/** Stable placement-scoped module id shared with the platform compositor. */
|
|
45
|
+
export function deviceRuntimeModuleId(definitionId, placementId) {
|
|
46
|
+
const slug = definitionId.replace(/[^a-z0-9-]/g, '').slice(0, 13) || 'device';
|
|
47
|
+
const identity = placementId.replace(/-/g, '').slice(0, 12).toLowerCase();
|
|
48
|
+
return `dev.${slug}.${identity}`;
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Renderer-neutral World Device host. The world supplies its engine adapter;
|
|
52
|
+
* HELIX supplies immutable placement identity, authoritative room state/actions,
|
|
53
|
+
* server time, compatibility checks, and lifecycle.
|
|
54
|
+
*/
|
|
55
|
+
export class WorldDeviceHost {
|
|
56
|
+
room;
|
|
57
|
+
adapter;
|
|
58
|
+
resolveDefinition;
|
|
59
|
+
#presentations = new Map();
|
|
60
|
+
#unsubscribers = [];
|
|
61
|
+
#disposed = false;
|
|
62
|
+
#serverOffsetMs = 0;
|
|
63
|
+
#clockAnchored = false;
|
|
64
|
+
constructor(room, adapter, resolveDefinition) {
|
|
65
|
+
this.room = room;
|
|
66
|
+
this.adapter = adapter;
|
|
67
|
+
this.resolveDefinition = resolveDefinition;
|
|
68
|
+
this.#sampleClock();
|
|
69
|
+
}
|
|
70
|
+
now = () => Date.now() + this.#serverOffsetMs;
|
|
71
|
+
async mount(spawn) {
|
|
72
|
+
if (this.#disposed)
|
|
73
|
+
throw new Error('World Device host is disposed');
|
|
74
|
+
const reference = spawn.deviceDefinition;
|
|
75
|
+
if (!reference)
|
|
76
|
+
return false;
|
|
77
|
+
const definition = await this.resolveDefinition(reference);
|
|
78
|
+
if (definition.format !== 'helix.device' ||
|
|
79
|
+
definition.formatVersion !== 1 ||
|
|
80
|
+
definition.id !== reference.id ||
|
|
81
|
+
definition.version !== reference.version) {
|
|
82
|
+
throw new Error(`Device definition identity mismatch for ${reference.id}@${reference.version}`);
|
|
83
|
+
}
|
|
84
|
+
if (definition.compatibility &&
|
|
85
|
+
!definition.compatibility.hosts.includes('world')) {
|
|
86
|
+
throw new Error(`Device ${definition.id} does not support World hosts`);
|
|
87
|
+
}
|
|
88
|
+
const requestedCapabilities = new Set([
|
|
89
|
+
...(definition.compatibility?.requiredCapabilities ?? []),
|
|
90
|
+
...(definition.capabilities ?? []),
|
|
91
|
+
]);
|
|
92
|
+
for (const capability of requestedCapabilities) {
|
|
93
|
+
if (!PLATFORM_DEVICE_CAPABILITIES.has(capability) &&
|
|
94
|
+
!this.adapter.capabilities.has(capability)) {
|
|
95
|
+
throw new Error(`World Device host is missing capability ${capability}`);
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
for (const interaction of definition.interactions) {
|
|
99
|
+
const target = interaction.presentation;
|
|
100
|
+
if (target === undefined)
|
|
101
|
+
continue;
|
|
102
|
+
if (!target || target.kind !== 'webPanel' || typeof target.app !== 'string' || !target.app || target.app.length > 64 ||
|
|
103
|
+
Object.keys(target).some(key => key !== 'kind' && key !== 'app')) {
|
|
104
|
+
throw new Error('Device interaction presentation must name a declared webPanel app');
|
|
105
|
+
}
|
|
106
|
+
if (!requestedCapabilities.has('app.web.panel'))
|
|
107
|
+
throw new Error('Device webPanel requires app.web.panel capability');
|
|
108
|
+
const raw = interaction;
|
|
109
|
+
if (raw.action !== undefined || interaction.control !== undefined || raw.surface === 'internal') {
|
|
110
|
+
throw new Error('Device webPanel cannot declare action, control or internal surface');
|
|
111
|
+
}
|
|
112
|
+
const app = definition.apps?.[target.app];
|
|
113
|
+
if (!app || !['localWeb', 'remoteWeb'].includes(app.type) || !app.entry) {
|
|
114
|
+
throw new Error('Device webPanel requires a declared localWeb or remoteWeb entry');
|
|
115
|
+
}
|
|
116
|
+
if (!requestedCapabilities.has(app.type === 'remoteWeb' ? 'app.web.remote' : 'app.web.local')) {
|
|
117
|
+
throw new Error('Device webPanel app capability is missing');
|
|
118
|
+
}
|
|
119
|
+
if (app.type === 'remoteWeb') {
|
|
120
|
+
const url = new URL(app.entry);
|
|
121
|
+
if (url.protocol !== 'https:' || url.username || url.password || !app.allowedOrigins?.includes(url.origin) ||
|
|
122
|
+
app.allowedOrigins.some(origin => { try {
|
|
123
|
+
const allowed = new URL(origin);
|
|
124
|
+
return allowed.protocol !== 'https:' || allowed.origin !== origin;
|
|
125
|
+
}
|
|
126
|
+
catch {
|
|
127
|
+
return true;
|
|
128
|
+
} })) {
|
|
129
|
+
throw new Error('Device webPanel requires a declared HTTPS origin without credentials');
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
else {
|
|
133
|
+
const path = new URL(app.entry, 'https://device-host.invalid');
|
|
134
|
+
if (!app.entry.startsWith('/device-apps/') || app.entry.includes('\\') || app.entry.split(/[/?#]/).includes('..') ||
|
|
135
|
+
!/^\/device-apps\/[A-Za-z0-9][A-Za-z0-9/_.-]*$/.test(path.pathname) || path.origin !== 'https://device-host.invalid' ||
|
|
136
|
+
decodeURIComponent(path.pathname) !== path.pathname || app.allowedOrigins !== undefined) {
|
|
137
|
+
throw new Error('Device webPanel local entry must remain within /device-apps/');
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
const graph = definition.graph;
|
|
141
|
+
if (graph?.triggers?.some(trigger => trigger.on === 'interact' && trigger.interaction === interaction.id)) {
|
|
142
|
+
throw new Error('Device webPanel cannot trigger a state graph');
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
const moduleId = deviceRuntimeModuleId(definition.id, spawn.placementId);
|
|
146
|
+
const presentation = await this.adapter.mount({
|
|
147
|
+
spawn,
|
|
148
|
+
definition,
|
|
149
|
+
now: this.now,
|
|
150
|
+
interact: (interactionId, args = {}) => {
|
|
151
|
+
if (definition.interactions.find(interaction => interaction.id === interactionId)?.presentation) {
|
|
152
|
+
throw new Error('Device webPanel is viewer-local and cannot be sent as a room action');
|
|
153
|
+
}
|
|
154
|
+
this.room.sendAction(interactionId, args, moduleId);
|
|
155
|
+
},
|
|
156
|
+
});
|
|
157
|
+
if (this.#disposed) {
|
|
158
|
+
await presentation.dispose();
|
|
159
|
+
return false;
|
|
160
|
+
}
|
|
161
|
+
this.#presentations.set(spawn.placementId, presentation);
|
|
162
|
+
const sync = () => {
|
|
163
|
+
this.#sampleClock();
|
|
164
|
+
const vars = this.room.module(moduleId).vars;
|
|
165
|
+
presentation.applyState(Object.fromEntries(Object.keys(definition.state).map((name) => [name, vars.raw(name)])));
|
|
166
|
+
};
|
|
167
|
+
sync();
|
|
168
|
+
const unsubscribe = this.room.onStateChange(sync);
|
|
169
|
+
if (typeof unsubscribe === 'function')
|
|
170
|
+
this.#unsubscribers.push(unsubscribe);
|
|
171
|
+
return true;
|
|
172
|
+
}
|
|
173
|
+
async dispose() {
|
|
174
|
+
if (this.#disposed)
|
|
175
|
+
return;
|
|
176
|
+
this.#disposed = true;
|
|
177
|
+
for (const unsubscribe of this.#unsubscribers.splice(0))
|
|
178
|
+
unsubscribe();
|
|
179
|
+
for (const presentation of this.#presentations.values()) {
|
|
180
|
+
await presentation.dispose();
|
|
181
|
+
}
|
|
182
|
+
this.#presentations.clear();
|
|
183
|
+
}
|
|
184
|
+
#sampleClock() {
|
|
185
|
+
const serverTimeMs = Number(this.room.state.serverTimeMs);
|
|
186
|
+
if (Number.isFinite(serverTimeMs) && serverTimeMs > 0) {
|
|
187
|
+
const sample = serverTimeMs - Date.now();
|
|
188
|
+
if (!this.#clockAnchored) {
|
|
189
|
+
this.#serverOffsetMs = sample;
|
|
190
|
+
this.#clockAnchored = true;
|
|
191
|
+
return;
|
|
192
|
+
}
|
|
193
|
+
const correction = Math.max(-250, Math.min(250, sample - this.#serverOffsetMs));
|
|
194
|
+
this.#serverOffsetMs += correction * 0.2;
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
//# sourceMappingURL=devices.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"devices.js","sourceRoot":"","sources":["../src/devices.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
import { type VaultLoadPlan, type VaultResolvedAsset } from './vault.js';
|
|
2
|
+
export declare const DREAMER_AUDIO_TIMEOUT_MS: number;
|
|
3
|
+
export type DreamerAudioGenerationMode = 'sound_effect' | 'music' | 'text_to_speech';
|
|
4
|
+
export type DreamerAudioVoiceSettings = {
|
|
5
|
+
stability?: number;
|
|
6
|
+
similarityBoost?: number;
|
|
7
|
+
style?: number;
|
|
8
|
+
speed?: number;
|
|
9
|
+
speakerBoost?: boolean;
|
|
10
|
+
};
|
|
11
|
+
type DreamerAudioRequestBase = {
|
|
12
|
+
additionalPrompt?: string;
|
|
13
|
+
projectId?: string;
|
|
14
|
+
sessionId?: string;
|
|
15
|
+
title?: string;
|
|
16
|
+
model?: string;
|
|
17
|
+
outputFormat?: string;
|
|
18
|
+
};
|
|
19
|
+
export type DreamerSoundEffectRequest = DreamerAudioRequestBase & {
|
|
20
|
+
audioMode: 'sound_effect';
|
|
21
|
+
prompt: string;
|
|
22
|
+
durationSeconds?: number;
|
|
23
|
+
loop?: boolean;
|
|
24
|
+
promptInfluence?: number;
|
|
25
|
+
};
|
|
26
|
+
export type DreamerMusicRequest = DreamerAudioRequestBase & {
|
|
27
|
+
audioMode: 'music';
|
|
28
|
+
prompt: string;
|
|
29
|
+
durationSeconds?: number;
|
|
30
|
+
forceInstrumental?: boolean;
|
|
31
|
+
};
|
|
32
|
+
export type DreamerTextToSpeechRequest = DreamerAudioRequestBase & {
|
|
33
|
+
audioMode: 'text_to_speech';
|
|
34
|
+
text: string;
|
|
35
|
+
voiceId: string;
|
|
36
|
+
languageCode?: string;
|
|
37
|
+
seed?: number;
|
|
38
|
+
voiceSettings?: DreamerAudioVoiceSettings;
|
|
39
|
+
pronunciationDictionaryIds?: string[];
|
|
40
|
+
};
|
|
41
|
+
export type DreamerAudioGenerateRequest = DreamerSoundEffectRequest | DreamerMusicRequest | DreamerTextToSpeechRequest;
|
|
42
|
+
export type DreamerAudioArtifact = {
|
|
43
|
+
url: string;
|
|
44
|
+
contentType: string;
|
|
45
|
+
sizeBytes: number;
|
|
46
|
+
kind: 'audio';
|
|
47
|
+
};
|
|
48
|
+
type DreamerAudioJobBase = {
|
|
49
|
+
jobId: string;
|
|
50
|
+
units?: number;
|
|
51
|
+
providerCostUsd?: number;
|
|
52
|
+
billingEvidence?: 'measured_provider_credits' | 'estimated_accepted_duration';
|
|
53
|
+
vaultAssetId?: string | null;
|
|
54
|
+
vaultAutoPublish?: 'published' | 'disabled';
|
|
55
|
+
};
|
|
56
|
+
export type DreamerAudioPendingJob = DreamerAudioJobBase & {
|
|
57
|
+
status: 'queued' | 'running';
|
|
58
|
+
};
|
|
59
|
+
export type DreamerAudioFailedJob = DreamerAudioJobBase & {
|
|
60
|
+
status: 'failed';
|
|
61
|
+
error?: string;
|
|
62
|
+
};
|
|
63
|
+
export type DreamerAudioSucceededJob = DreamerAudioJobBase & {
|
|
64
|
+
status: 'succeeded';
|
|
65
|
+
asset: DreamerAudioArtifact;
|
|
66
|
+
};
|
|
67
|
+
export type DreamerAudioJob = DreamerAudioPendingJob | DreamerAudioFailedJob | DreamerAudioSucceededJob;
|
|
68
|
+
export type DreamerAudioClientOptions = {
|
|
69
|
+
/**
|
|
70
|
+
* HELIX API origin, or a full base ending in `/api/v1/dreamer`.
|
|
71
|
+
*/
|
|
72
|
+
apiBaseUrl: string;
|
|
73
|
+
fetch?: typeof fetch;
|
|
74
|
+
accessToken?: string | null | (() => string | null | Promise<string | null>);
|
|
75
|
+
pollIntervalMs?: number;
|
|
76
|
+
timeoutMs?: number;
|
|
77
|
+
};
|
|
78
|
+
export type DreamerAudioPollOptions = {
|
|
79
|
+
pollIntervalMs?: number;
|
|
80
|
+
timeoutMs?: number;
|
|
81
|
+
onProgress?: (job: DreamerAudioJob) => void;
|
|
82
|
+
};
|
|
83
|
+
export type DreamerGeneratedVaultAudio = {
|
|
84
|
+
job: DreamerAudioSucceededJob;
|
|
85
|
+
resolved: VaultResolvedAsset<'audio'>;
|
|
86
|
+
loadPlan: Extract<VaultLoadPlan, {
|
|
87
|
+
loader: 'audio';
|
|
88
|
+
}>;
|
|
89
|
+
};
|
|
90
|
+
export type DreamerAudioClient = {
|
|
91
|
+
start(input: DreamerAudioGenerateRequest): Promise<{
|
|
92
|
+
jobId: string;
|
|
93
|
+
status: 'queued';
|
|
94
|
+
}>;
|
|
95
|
+
get(jobId: string): Promise<DreamerAudioJob>;
|
|
96
|
+
generate(input: DreamerAudioGenerateRequest, options?: DreamerAudioPollOptions): Promise<DreamerAudioSucceededJob>;
|
|
97
|
+
/**
|
|
98
|
+
* Generate, require default-on Vault publication, then resolve the same
|
|
99
|
+
* durable asset through the SDK's normal Vault consumption surface.
|
|
100
|
+
*/
|
|
101
|
+
generateAndResolve(input: DreamerAudioGenerateRequest, options?: DreamerAudioPollOptions): Promise<DreamerGeneratedVaultAudio>;
|
|
102
|
+
};
|
|
103
|
+
export declare class DreamerAudioApiError extends Error {
|
|
104
|
+
readonly status: number;
|
|
105
|
+
readonly url: string;
|
|
106
|
+
readonly responseBody: string;
|
|
107
|
+
constructor(status: number, url: string, responseBody: string);
|
|
108
|
+
}
|
|
109
|
+
export declare class DreamerAudioJobFailedError extends Error {
|
|
110
|
+
readonly job: DreamerAudioFailedJob;
|
|
111
|
+
constructor(job: DreamerAudioFailedJob);
|
|
112
|
+
}
|
|
113
|
+
export declare class DreamerAudioJobTimeoutError extends Error {
|
|
114
|
+
readonly jobId: string;
|
|
115
|
+
readonly timeoutMs: number;
|
|
116
|
+
constructor(jobId: string, timeoutMs: number);
|
|
117
|
+
}
|
|
118
|
+
export declare class DreamerAudioVaultUnavailableError extends Error {
|
|
119
|
+
readonly job: DreamerAudioSucceededJob;
|
|
120
|
+
constructor(job: DreamerAudioSucceededJob);
|
|
121
|
+
}
|
|
122
|
+
export declare class DreamerAudioCapabilityUnavailableError extends Error {
|
|
123
|
+
constructor();
|
|
124
|
+
}
|
|
125
|
+
export declare function createDreamerAudioClient(options: DreamerAudioClientOptions): DreamerAudioClient;
|
|
126
|
+
export {};
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import { createVaultClient, } from './vault.js';
|
|
2
|
+
export const DREAMER_AUDIO_TIMEOUT_MS = 30 * 60_000;
|
|
3
|
+
export class DreamerAudioApiError extends Error {
|
|
4
|
+
status;
|
|
5
|
+
url;
|
|
6
|
+
responseBody;
|
|
7
|
+
constructor(status, url, responseBody) {
|
|
8
|
+
super(`HELIX Dreamer audio request failed (${status})${responseBody ? `: ${responseBody}` : ''}`);
|
|
9
|
+
this.status = status;
|
|
10
|
+
this.url = url;
|
|
11
|
+
this.responseBody = responseBody;
|
|
12
|
+
this.name = 'DreamerAudioApiError';
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
export class DreamerAudioJobFailedError extends Error {
|
|
16
|
+
job;
|
|
17
|
+
constructor(job) {
|
|
18
|
+
super(`HELIX Dreamer audio job ${job.jobId} failed: ${job.error ?? 'no details'}`);
|
|
19
|
+
this.job = job;
|
|
20
|
+
this.name = 'DreamerAudioJobFailedError';
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
export class DreamerAudioJobTimeoutError extends Error {
|
|
24
|
+
jobId;
|
|
25
|
+
timeoutMs;
|
|
26
|
+
constructor(jobId, timeoutMs) {
|
|
27
|
+
super(`HELIX Dreamer audio job ${jobId} timed out after ${timeoutMs}ms.`);
|
|
28
|
+
this.jobId = jobId;
|
|
29
|
+
this.timeoutMs = timeoutMs;
|
|
30
|
+
this.name = 'DreamerAudioJobTimeoutError';
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
export class DreamerAudioVaultUnavailableError extends Error {
|
|
34
|
+
job;
|
|
35
|
+
constructor(job) {
|
|
36
|
+
super(`HELIX Dreamer audio job ${job.jobId} succeeded without a published Vault asset.`);
|
|
37
|
+
this.job = job;
|
|
38
|
+
this.name = 'DreamerAudioVaultUnavailableError';
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
export class DreamerAudioCapabilityUnavailableError extends Error {
|
|
42
|
+
constructor() {
|
|
43
|
+
super('HELIX Dreamer audio requires Fetch API support in this runtime.');
|
|
44
|
+
this.name = 'DreamerAudioCapabilityUnavailableError';
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
function trimBase(url) {
|
|
48
|
+
return url.replace(/\/+$/, '');
|
|
49
|
+
}
|
|
50
|
+
function normalizeApiOrigin(url) {
|
|
51
|
+
const base = trimBase(url);
|
|
52
|
+
return base.endsWith('/api/v1/dreamer')
|
|
53
|
+
? base.slice(0, -'/api/v1/dreamer'.length)
|
|
54
|
+
: base;
|
|
55
|
+
}
|
|
56
|
+
function sleep(ms) {
|
|
57
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
58
|
+
}
|
|
59
|
+
export function createDreamerAudioClient(options) {
|
|
60
|
+
const apiOrigin = normalizeApiOrigin(options.apiBaseUrl);
|
|
61
|
+
const dreamerBase = `${apiOrigin}/api/v1/dreamer`;
|
|
62
|
+
const requestFetch = options.fetch ?? globalThis.fetch;
|
|
63
|
+
if (!requestFetch) {
|
|
64
|
+
throw new DreamerAudioCapabilityUnavailableError();
|
|
65
|
+
}
|
|
66
|
+
async function token() {
|
|
67
|
+
const source = options.accessToken;
|
|
68
|
+
return typeof source === 'function' ? await source() : (source ?? null);
|
|
69
|
+
}
|
|
70
|
+
async function request(path, init = {}) {
|
|
71
|
+
const accessToken = await token();
|
|
72
|
+
const headers = new Headers(init.headers);
|
|
73
|
+
if (accessToken)
|
|
74
|
+
headers.set('Authorization', `Bearer ${accessToken}`);
|
|
75
|
+
const url = `${dreamerBase}${path}`;
|
|
76
|
+
const response = await requestFetch(url, { ...init, headers });
|
|
77
|
+
if (!response.ok) {
|
|
78
|
+
let body = '';
|
|
79
|
+
try {
|
|
80
|
+
body = await response.text();
|
|
81
|
+
}
|
|
82
|
+
catch {
|
|
83
|
+
// Status and URL remain actionable when a runtime cannot read the body.
|
|
84
|
+
}
|
|
85
|
+
throw new DreamerAudioApiError(response.status, url, body);
|
|
86
|
+
}
|
|
87
|
+
return (await response.json());
|
|
88
|
+
}
|
|
89
|
+
async function start(input) {
|
|
90
|
+
return request('/assets/generate', {
|
|
91
|
+
method: 'POST',
|
|
92
|
+
headers: { 'Content-Type': 'application/json' },
|
|
93
|
+
body: JSON.stringify({ kind: 'audio', ...input }),
|
|
94
|
+
});
|
|
95
|
+
}
|
|
96
|
+
function get(jobId) {
|
|
97
|
+
return request(`/assets/jobs/${encodeURIComponent(jobId)}`);
|
|
98
|
+
}
|
|
99
|
+
async function generate(input, pollOptions = {}) {
|
|
100
|
+
const accepted = await start(input);
|
|
101
|
+
const pollIntervalMs = pollOptions.pollIntervalMs ?? options.pollIntervalMs ?? 2_000;
|
|
102
|
+
const timeoutMs = pollOptions.timeoutMs ?? options.timeoutMs ?? DREAMER_AUDIO_TIMEOUT_MS;
|
|
103
|
+
const deadline = Date.now() + timeoutMs;
|
|
104
|
+
while (Date.now() < deadline) {
|
|
105
|
+
const job = await get(accepted.jobId);
|
|
106
|
+
pollOptions.onProgress?.(job);
|
|
107
|
+
if (job.status === 'succeeded')
|
|
108
|
+
return job;
|
|
109
|
+
if (job.status === 'failed') {
|
|
110
|
+
throw new DreamerAudioJobFailedError(job);
|
|
111
|
+
}
|
|
112
|
+
await sleep(pollIntervalMs);
|
|
113
|
+
}
|
|
114
|
+
throw new DreamerAudioJobTimeoutError(accepted.jobId, timeoutMs);
|
|
115
|
+
}
|
|
116
|
+
async function generateAndResolve(input, pollOptions = {}) {
|
|
117
|
+
const job = await generate(input, pollOptions);
|
|
118
|
+
if (!job.vaultAssetId) {
|
|
119
|
+
throw new DreamerAudioVaultUnavailableError(job);
|
|
120
|
+
}
|
|
121
|
+
const vault = createVaultClient({
|
|
122
|
+
apiBaseUrl: apiOrigin,
|
|
123
|
+
fetch: requestFetch,
|
|
124
|
+
accessToken: options.accessToken,
|
|
125
|
+
});
|
|
126
|
+
const resolved = await vault.resolve(job.vaultAssetId);
|
|
127
|
+
const loadPlan = vault.createLoadPlan(resolved);
|
|
128
|
+
if (loadPlan.loader !== 'audio') {
|
|
129
|
+
throw new Error(`HELIX Vault asset ${job.vaultAssetId} is not a loadable audio artifact.`);
|
|
130
|
+
}
|
|
131
|
+
return { job, resolved, loadPlan };
|
|
132
|
+
}
|
|
133
|
+
return { start, get, generate, generateAndResolve };
|
|
134
|
+
}
|
|
135
|
+
//# sourceMappingURL=dreamerAudio.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dreamerAudio.js","sourceRoot":"","sources":["../src/dreamerAudio.ts"],"names":[],"mappings":"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"}
|