@hypersoniclabs/helix-sdk 0.1.2 → 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.
Files changed (115) hide show
  1. package/README.md +859 -8
  2. package/dist/action-surface.d.ts +182 -0
  3. package/dist/action-surface.js +1032 -0
  4. package/dist/action-surface.js.map +1 -0
  5. package/dist/camera.d.ts +65 -1
  6. package/dist/camera.js +568 -0
  7. package/dist/camera.js.map +1 -1
  8. package/dist/dev-shell/criteria.d.ts +46 -0
  9. package/dist/dev-shell/criteria.js +98 -0
  10. package/dist/dev-shell/criteria.js.map +1 -0
  11. package/dist/dev-shell/index.d.ts +189 -0
  12. package/dist/dev-shell/index.js +287 -0
  13. package/dist/dev-shell/index.js.map +1 -0
  14. package/dist/dev-shell/keys.d.ts +14 -0
  15. package/dist/dev-shell/keys.js +78 -0
  16. package/dist/dev-shell/keys.js.map +1 -0
  17. package/dist/dev-shell/simulator.d.ts +436 -0
  18. package/dist/dev-shell/simulator.js +1634 -0
  19. package/dist/dev-shell/simulator.js.map +1 -0
  20. package/dist/dev-shell/state.d.ts +148 -0
  21. package/dist/dev-shell/state.js +196 -0
  22. package/dist/dev-shell/state.js.map +1 -0
  23. package/dist/device-definition-resolver.d.ts +34 -0
  24. package/dist/device-definition-resolver.js +172 -0
  25. package/dist/device-definition-resolver.js.map +1 -0
  26. package/dist/device-trial.d.ts +3 -0
  27. package/dist/device-trial.js +132 -0
  28. package/dist/device-trial.js.map +1 -0
  29. package/dist/devices.d.ts +228 -0
  30. package/dist/devices.js +198 -0
  31. package/dist/devices.js.map +1 -0
  32. package/dist/dreamerAudio.d.ts +126 -0
  33. package/dist/dreamerAudio.js +135 -0
  34. package/dist/dreamerAudio.js.map +1 -0
  35. package/dist/generated/runtime-contract.d.ts +15529 -0
  36. package/dist/generated/runtime-contract.js +20470 -0
  37. package/dist/generated/runtime-contract.js.map +1 -0
  38. package/dist/index.d.ts +272 -15
  39. package/dist/index.js +1401 -91
  40. package/dist/index.js.map +1 -1
  41. package/dist/interaction-mode.d.ts +172 -0
  42. package/dist/interaction-mode.js +553 -0
  43. package/dist/interaction-mode.js.map +1 -0
  44. package/dist/internal/avatar-pose.d.ts +25 -0
  45. package/dist/internal/avatar-pose.js +46 -0
  46. package/dist/internal/avatar-pose.js.map +1 -0
  47. package/dist/internal/keyed-collection.d.ts +2 -0
  48. package/dist/internal/keyed-collection.js +12 -0
  49. package/dist/internal/keyed-collection.js.map +1 -0
  50. package/dist/internal/vehicle-detach-action.d.ts +2 -0
  51. package/dist/internal/vehicle-detach-action.js +6 -0
  52. package/dist/internal/vehicle-detach-action.js.map +1 -0
  53. package/dist/matchmaking.d.ts +433 -0
  54. package/dist/matchmaking.js +1487 -0
  55. package/dist/matchmaking.js.map +1 -0
  56. package/dist/materials.d.ts +122 -0
  57. package/dist/materials.js +217 -0
  58. package/dist/materials.js.map +1 -0
  59. package/dist/multiplayer-accessors.d.ts +100 -0
  60. package/dist/multiplayer-accessors.js +200 -0
  61. package/dist/multiplayer-accessors.js.map +1 -0
  62. package/dist/multiplayer-contract/avatar-pose.d.ts +112 -0
  63. package/dist/multiplayer-contract/avatar-pose.js +250 -0
  64. package/dist/multiplayer-contract/avatar-pose.js.map +1 -0
  65. package/dist/multiplayer-contract/credential.d.ts +38 -0
  66. package/dist/multiplayer-contract/final-rest.d.ts +66 -0
  67. package/dist/multiplayer-contract/final-rest.js +38 -0
  68. package/dist/multiplayer-contract/final-rest.js.map +1 -0
  69. package/dist/multiplayer-contract/index.d.ts +11 -5
  70. package/dist/multiplayer-contract/index.js +16 -5
  71. package/dist/multiplayer-contract/index.js.map +1 -1
  72. package/dist/multiplayer-contract/messages.d.ts +461 -14
  73. package/dist/multiplayer-contract/messages.js +141 -15
  74. package/dist/multiplayer-contract/messages.js.map +1 -1
  75. package/dist/multiplayer-contract/room.d.ts +55 -4
  76. package/dist/multiplayer-contract/state.d.ts +181 -1
  77. package/dist/multiplayer-contract/state.js.map +1 -1
  78. package/dist/multiplayer-final-rest.d.ts +32 -0
  79. package/dist/multiplayer-final-rest.js +217 -0
  80. package/dist/multiplayer-final-rest.js.map +1 -0
  81. package/dist/multiplayer.d.ts +507 -16
  82. package/dist/multiplayer.js +2242 -73
  83. package/dist/multiplayer.js.map +1 -1
  84. package/dist/package.json +3 -0
  85. package/dist/protocol.d.ts +668 -5
  86. package/dist/protocol.js +101 -1
  87. package/dist/protocol.js.map +1 -1
  88. package/dist/runtime-contract/index.d.ts +15 -0
  89. package/dist/runtime-contract/index.js +12 -0
  90. package/dist/runtime-contract/index.js.map +1 -0
  91. package/dist/server-clock.d.ts +25 -0
  92. package/dist/server-clock.js +88 -0
  93. package/dist/server-clock.js.map +1 -0
  94. package/dist/tsconfig.build.tsbuildinfo +1 -1
  95. package/dist/universal-vehicles.d.ts +111 -0
  96. package/dist/universal-vehicles.js +2 -0
  97. package/dist/universal-vehicles.js.map +1 -0
  98. package/dist/vault.d.ts +562 -0
  99. package/dist/vault.js +365 -0
  100. package/dist/vault.js.map +1 -0
  101. package/dist/vehicle-specialty-placement.d.ts +28 -0
  102. package/dist/vehicle-specialty-placement.js +154 -0
  103. package/dist/vehicle-specialty-placement.js.map +1 -0
  104. package/dist/vehicle-specialty-transport.d.ts +78 -0
  105. package/dist/vehicle-specialty-transport.js +183 -0
  106. package/dist/vehicle-specialty-transport.js.map +1 -0
  107. package/dist/voice.d.ts +229 -0
  108. package/dist/voice.js +1348 -0
  109. package/dist/voice.js.map +1 -0
  110. package/generated/runtime-contract/helix-runtime-contract.json +13332 -0
  111. package/generated/runtime-contract/known-answer.json +20471 -0
  112. package/generated/runtime-contract/known-answer.schema.json +630 -0
  113. package/generated/runtime-contract/runtime-contract.schema.json +607 -0
  114. package/generated/runtime-contract/unreal/HelixRuntimeContract.generated.h +908 -0
  115. package/package.json +32 -6
package/dist/vault.js ADDED
@@ -0,0 +1,365 @@
1
+ /**
2
+ * Engine-agnostic access to durable HELIX Vault assets.
3
+ *
4
+ * Persist `VaultAssetHandle` (assetId + immutable integer version), never an
5
+ * artifact URL. URLs are resolution results and may change when the serving
6
+ * host changes.
7
+ */
8
+ export const VAULT_ASSET_KINDS = [
9
+ 'prop',
10
+ 'character',
11
+ 'animation',
12
+ 'audio',
13
+ 'texture',
14
+ 'material',
15
+ 'environment',
16
+ 'terrain',
17
+ 'vfx',
18
+ 'decal',
19
+ 'sky',
20
+ 'gaussian_splat',
21
+ 'scene',
22
+ 'unreal_package',
23
+ ];
24
+ export class VaultApiError extends Error {
25
+ status;
26
+ url;
27
+ responseBody;
28
+ constructor(status, url, responseBody) {
29
+ super(`HELIX Vault request failed (${status})${responseBody ? `: ${responseBody}` : ''}`);
30
+ this.status = status;
31
+ this.url = url;
32
+ this.responseBody = responseBody;
33
+ this.name = 'VaultApiError';
34
+ }
35
+ }
36
+ export class VaultArtifactUnavailableError extends Error {
37
+ handle;
38
+ constructor(handle) {
39
+ super(`HELIX Vault asset ${handle.assetId} version ${handle.version} has no servable artifact.`);
40
+ this.handle = handle;
41
+ this.name = 'VaultArtifactUnavailableError';
42
+ }
43
+ }
44
+ export class VaultChecksumMismatchError extends Error {
45
+ expected;
46
+ actual;
47
+ constructor(expected, actual) {
48
+ super(`HELIX Vault artifact checksum mismatch: expected ${expected}, got ${actual}.`);
49
+ this.expected = expected;
50
+ this.actual = actual;
51
+ this.name = 'VaultChecksumMismatchError';
52
+ }
53
+ }
54
+ export class VaultUnsupportedRuntimeError extends Error {
55
+ kind;
56
+ mimeType;
57
+ constructor(kind, mimeType, reason) {
58
+ super(`HELIX Vault asset cannot be loaded by the web SDK (${kind}, ${mimeType}): ${reason}`);
59
+ this.kind = kind;
60
+ this.mimeType = mimeType;
61
+ this.name = 'VaultUnsupportedRuntimeError';
62
+ }
63
+ }
64
+ export class VaultCapabilityUnavailableError extends Error {
65
+ capability;
66
+ constructor(capability) {
67
+ super(`HELIX Vault requires ${capability === 'fetch' ? 'Fetch API support' : 'Web Crypto SHA-256 support or an injected sha256 function'} in this runtime.`);
68
+ this.capability = capability;
69
+ this.name = 'VaultCapabilityUnavailableError';
70
+ }
71
+ }
72
+ function trimBase(url) {
73
+ return url.replace(/\/+$/, '');
74
+ }
75
+ function normalizeVaultBase(url) {
76
+ const base = trimBase(url);
77
+ return base.endsWith('/api/v1/vault') ? base : `${base}/api/v1/vault`;
78
+ }
79
+ function queryString(query) {
80
+ const params = new URLSearchParams();
81
+ for (const [key, value] of Object.entries(query)) {
82
+ if (value === undefined)
83
+ continue;
84
+ if (key === 'kind') {
85
+ const kinds = Array.isArray(value) ? value : [value];
86
+ params.set('kind', kinds.join(','));
87
+ }
88
+ else {
89
+ params.set(key, String(value));
90
+ }
91
+ }
92
+ const rendered = params.toString();
93
+ return rendered ? `?${rendered}` : '';
94
+ }
95
+ function asHandle(asset, requested) {
96
+ return {
97
+ assetId: asset.assetId,
98
+ version: typeof requested === 'object' ? requested.version : asset.currentVersion,
99
+ };
100
+ }
101
+ function primaryReference(artifact) {
102
+ return {
103
+ role: 'primary',
104
+ url: artifact.url,
105
+ mimeType: artifact.mimeType,
106
+ sizeBytes: artifact.sizeBytes,
107
+ checksumSha256: artifact.checksumSha256,
108
+ };
109
+ }
110
+ function relatedReferences(artifacts) {
111
+ return artifacts.map((artifact) => ({ ...artifact }));
112
+ }
113
+ function splatScope(asset) {
114
+ const metadata = asset.metadata;
115
+ return metadata.gaussianSplat?.scope ?? 'environment';
116
+ }
117
+ /**
118
+ * Convert a resolved Vault artifact into a renderer-neutral loader handoff.
119
+ * The SDK never imports or guesses a rendering engine.
120
+ */
121
+ export function createVaultLoadPlan(resolved) {
122
+ const { asset, artifact, handle } = resolved;
123
+ const mime = artifact.mimeType.toLowerCase();
124
+ const primary = primaryReference(artifact);
125
+ const related = relatedReferences(artifact.relatedArtifacts);
126
+ if (asset.kind === 'unreal_package') {
127
+ throw new VaultUnsupportedRuntimeError(asset.kind, mime, 'Unreal packages require an Unreal runtime.');
128
+ }
129
+ if (mime === 'model/gltf-binary' || mime === 'model/gltf+json') {
130
+ const purpose = asset.kind === 'character' ||
131
+ asset.kind === 'animation' ||
132
+ asset.kind === 'environment' ||
133
+ asset.kind === 'terrain'
134
+ ? asset.kind
135
+ : 'prop';
136
+ return { loader: 'gltf', purpose, handle, primary, related };
137
+ }
138
+ if (mime === 'image/png' ||
139
+ mime === 'image/jpeg' ||
140
+ mime === 'image/webp' ||
141
+ mime === 'image/ktx2') {
142
+ if (asset.kind !== 'texture' && asset.kind !== 'decal') {
143
+ throw new VaultUnsupportedRuntimeError(asset.kind, mime, 'Image artifacts are only valid as texture or decal resources.');
144
+ }
145
+ return {
146
+ loader: 'image',
147
+ purpose: asset.kind,
148
+ handle,
149
+ primary,
150
+ related,
151
+ };
152
+ }
153
+ if (mime.startsWith('audio/')) {
154
+ return { loader: 'audio', purpose: 'audio', handle, primary, related };
155
+ }
156
+ if (mime === 'image/vnd.radiance' || mime === 'image/x-exr') {
157
+ return {
158
+ loader: 'hdr-environment',
159
+ purpose: 'sky',
160
+ format: mime === 'image/vnd.radiance' ? 'hdr' : 'exr',
161
+ handle,
162
+ primary,
163
+ related,
164
+ };
165
+ }
166
+ if (mime === 'model/vnd.gaussian-splat.spz') {
167
+ return {
168
+ loader: 'gaussian-splat',
169
+ purpose: asset.kind === 'environment' ? 'environment' : 'gaussian_splat',
170
+ format: 'spz',
171
+ scope: splatScope(asset),
172
+ handle,
173
+ primary,
174
+ related,
175
+ };
176
+ }
177
+ const descriptors = {
178
+ 'application/vnd.helix.material+json': {
179
+ purpose: 'material',
180
+ schema: 'helix-material@1',
181
+ },
182
+ 'application/vnd.helix.scene+json': {
183
+ purpose: 'scene',
184
+ schema: 'helix-scene@1',
185
+ },
186
+ 'application/vnd.helix.terrain+json': {
187
+ purpose: 'terrain',
188
+ schema: 'helix-terrain@1',
189
+ },
190
+ 'application/vnd.helix.vfx+json': {
191
+ purpose: 'vfx',
192
+ schema: 'helix-vfx@1',
193
+ },
194
+ 'application/vnd.helix.sky+json': {
195
+ purpose: 'sky',
196
+ schema: 'helix-sky@1',
197
+ },
198
+ };
199
+ const descriptor = descriptors[mime];
200
+ if (descriptor) {
201
+ return {
202
+ loader: 'helix-descriptor',
203
+ ...descriptor,
204
+ handle,
205
+ primary,
206
+ related,
207
+ };
208
+ }
209
+ throw new VaultUnsupportedRuntimeError(asset.kind, mime, 'No format adapter is registered for this artifact.');
210
+ }
211
+ async function defaultSha256(bytes) {
212
+ const subtle = globalThis.crypto?.subtle;
213
+ if (!subtle) {
214
+ throw new VaultCapabilityUnavailableError('sha256');
215
+ }
216
+ const digest = await subtle.digest('SHA-256', bytes);
217
+ return Array.from(new Uint8Array(digest))
218
+ .map((byte) => byte.toString(16).padStart(2, '0'))
219
+ .join('');
220
+ }
221
+ export function createVaultClient(options) {
222
+ const vaultBase = normalizeVaultBase(options.apiBaseUrl);
223
+ const requestFetch = options.fetch ?? globalThis.fetch;
224
+ if (!requestFetch) {
225
+ throw new VaultCapabilityUnavailableError('fetch');
226
+ }
227
+ const hasher = options.sha256 ?? defaultSha256;
228
+ async function token() {
229
+ const source = options.accessToken;
230
+ return typeof source === 'function' ? await source() : (source ?? null);
231
+ }
232
+ async function request(path, init = {}) {
233
+ const accessToken = await token();
234
+ const headers = new Headers(init.headers);
235
+ if (accessToken)
236
+ headers.set('Authorization', `Bearer ${accessToken}`);
237
+ const url = `${vaultBase}${path}`;
238
+ const response = await requestFetch(url, { ...init, headers });
239
+ if (!response.ok) {
240
+ let body = '';
241
+ try {
242
+ body = await response.text();
243
+ }
244
+ catch {
245
+ // The status and URL remain actionable if a runtime cannot read a body.
246
+ }
247
+ throw new VaultApiError(response.status, url, body);
248
+ }
249
+ return response;
250
+ }
251
+ async function json(path) {
252
+ const response = await request(path);
253
+ return (await response.json());
254
+ }
255
+ async function resolve(handleOrAssetId) {
256
+ const assetId = typeof handleOrAssetId === 'string'
257
+ ? handleOrAssetId
258
+ : handleOrAssetId.assetId;
259
+ const asset = await json(`/assets/${encodeURIComponent(assetId)}`);
260
+ const handle = asHandle(asset, handleOrAssetId);
261
+ if (handle.version === asset.artifact.version) {
262
+ return {
263
+ handle,
264
+ asset,
265
+ artifact: asset.artifact,
266
+ relatedArtifactsComplete: true,
267
+ };
268
+ }
269
+ const versionRows = await versions(assetId);
270
+ const row = versionRows.find((candidate) => candidate.handle.version === handle.version);
271
+ if (!row) {
272
+ throw new VaultApiError(404, `${vaultBase}/assets/${encodeURIComponent(assetId)}/versions`, `Version ${handle.version} does not exist for this asset.`);
273
+ }
274
+ return {
275
+ handle,
276
+ asset,
277
+ artifact: {
278
+ assetId,
279
+ version: handle.version,
280
+ url: row.url,
281
+ urlKind: row.url ? 'cdn' : 'unavailable',
282
+ mimeType: row.mimeType,
283
+ sizeBytes: row.sizeBytes,
284
+ checksumSha256: row.checksumSha256,
285
+ relatedArtifacts: [],
286
+ },
287
+ relatedArtifactsComplete: false,
288
+ };
289
+ }
290
+ async function versions(assetId) {
291
+ const response = await json(`/assets/${encodeURIComponent(assetId)}/versions`);
292
+ return response.items.map(({ version, ...row }) => ({
293
+ ...row,
294
+ handle: { assetId, version },
295
+ }));
296
+ }
297
+ async function downloadReference(reference, fetchUrl, verifyChecksum = reference.checksumSha256 !== null, useAuth = false) {
298
+ if (!reference.url && !useAuth) {
299
+ throw new Error('HELIX Vault related artifact has no servable URL.');
300
+ }
301
+ const response = useAuth
302
+ ? await request(fetchUrl)
303
+ : await requestFetch(fetchUrl, { redirect: 'follow' });
304
+ if (!response.ok) {
305
+ let body = '';
306
+ try {
307
+ body = await response.text();
308
+ }
309
+ catch {
310
+ // Preserve the primary failure below.
311
+ }
312
+ throw new VaultApiError(response.status, fetchUrl, body);
313
+ }
314
+ const bytes = await response.arrayBuffer();
315
+ let checksumVerified = false;
316
+ if (verifyChecksum && reference.checksumSha256) {
317
+ const actual = (await hasher(bytes)).toLowerCase();
318
+ const expected = reference.checksumSha256.toLowerCase();
319
+ if (actual !== expected) {
320
+ throw new VaultChecksumMismatchError(expected, actual);
321
+ }
322
+ checksumVerified = true;
323
+ }
324
+ return { reference, bytes, checksumVerified };
325
+ }
326
+ async function download(handleOrAssetId, installOptions = {}) {
327
+ const resolved = await resolve(handleOrAssetId);
328
+ if (!resolved.artifact.url) {
329
+ throw new VaultArtifactUnavailableError(resolved.handle);
330
+ }
331
+ const reference = primaryReference(resolved.artifact);
332
+ const path = `/assets/${encodeURIComponent(resolved.handle.assetId)}/download?version=${resolved.handle.version}`;
333
+ return downloadReference(reference, path, installOptions.verifyChecksum, true);
334
+ }
335
+ function downloadArtifact(reference, installOptions = {}) {
336
+ if (!reference.url) {
337
+ return Promise.reject(new Error('HELIX Vault related artifact has no servable URL.'));
338
+ }
339
+ return downloadReference(reference, reference.url, installOptions.verifyChecksum);
340
+ }
341
+ return {
342
+ search(query = {}) {
343
+ return json(`/assets${queryString(query)}`);
344
+ },
345
+ get(assetId) {
346
+ return json(`/assets/${encodeURIComponent(assetId)}`);
347
+ },
348
+ versions,
349
+ resolve,
350
+ createLoadPlan: createVaultLoadPlan,
351
+ download,
352
+ downloadArtifact,
353
+ async install(handleOrAssetId, installOptions = {}) {
354
+ const resolved = await resolve(handleOrAssetId);
355
+ const plan = createVaultLoadPlan(resolved);
356
+ const primary = await download(resolved.handle, installOptions);
357
+ const roles = new Set(installOptions.relatedRoles ?? []);
358
+ const related = await Promise.all(plan.related
359
+ .filter((reference) => roles.has(reference.role))
360
+ .map((reference) => downloadArtifact(reference, installOptions)));
361
+ return { asset: resolved, plan, primary, related };
362
+ },
363
+ };
364
+ }
365
+ //# sourceMappingURL=vault.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vault.js","sourceRoot":"","sources":["../src/vault.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ import type { VehicleSpecialtyRoomBinding } from './vehicle-specialty-transport.js';
2
+ import type { VehicleDetachActions } from './universal-vehicles.js';
3
+ export interface VehicleSpecialtyPlacementIdentity {
4
+ placementId: string;
5
+ itemInstanceId: string;
6
+ bundleId: string;
7
+ bundleChecksumSha256: string;
8
+ revision: number;
9
+ stateVars: readonly string[];
10
+ /** Exact signed descriptor from the backend runtime mount. */
11
+ detachActions?: VehicleDetachActions | null;
12
+ }
13
+ export interface VehicleSpecialtyPlacementBinding extends VehicleSpecialtyRoomBinding {
14
+ placementId: string;
15
+ entityId: string;
16
+ }
17
+ /** Mirrors the trusted World compiler's placement-scoped module identity. */
18
+ export declare function vehicleSpecialtyRuntimeModuleId(bundleId: string, placementId: string): string;
19
+ /** Mirrors the trusted World compiler's authoritative moving entity identity. */
20
+ export declare function vehicleSpecialtyEntityId(placementId: string): string;
21
+ /**
22
+ * Converts a public World placement plus its checksum-pinned package into the
23
+ * exact binding used by the signed room config. No caller-supplied module or
24
+ * entity id is accepted.
25
+ */
26
+ export declare function vehicleSpecialtyPlacementBinding(identity: VehicleSpecialtyPlacementIdentity): VehicleSpecialtyPlacementBinding & {
27
+ detachActions: VehicleDetachActions | null;
28
+ };
@@ -0,0 +1,154 @@
1
+ import { isVehicleDetachActionId } from './internal/vehicle-detach-action.js';
2
+ const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
3
+ const BUNDLE = /^[a-z0-9][a-z0-9-]{1,62}$/;
4
+ const SHA256 = /^[a-f0-9]{64}$/;
5
+ const VEHICLE_ROLES = new Set(['owner', 'driver', 'occupant', 'nearby']);
6
+ const POSITION_ABS_MAX_M = 16;
7
+ const COLLIDER_HALF_EXTENT_MAX_M = 8;
8
+ const MASS_MIN_KG = 0.1;
9
+ const MASS_MAX_KG = 500;
10
+ const SETTLE_MAX_MS = 60_000;
11
+ const DESPAWN_MIN_MS = 1_000;
12
+ const DESPAWN_MAX_MS = 600_000;
13
+ function record(value) {
14
+ return value !== null && typeof value === 'object' && !Array.isArray(value)
15
+ ? value
16
+ : null;
17
+ }
18
+ function exactFields(value, allowed, label) {
19
+ const unknown = Object.keys(value).find((key) => !allowed.includes(key));
20
+ if (unknown)
21
+ throw new Error(`vehicle specialty ${label} has unknown field ${unknown}`);
22
+ }
23
+ function finiteTuple(value, length, label) {
24
+ if (!Array.isArray(value) || value.length !== length ||
25
+ !value.every((entry) => typeof entry === 'number' && Number.isFinite(entry)))
26
+ throw new Error(`vehicle specialty ${label} must contain ${length} finite numbers`);
27
+ return [...value];
28
+ }
29
+ function detachDescriptor(value, actionId) {
30
+ const raw = record(value);
31
+ if (!raw) {
32
+ throw new Error(`vehicle specialty detach action ${actionId} is invalid`);
33
+ }
34
+ exactFields(raw, [
35
+ 'partId', 'stateBit', 'localTransform', 'collider', 'massKg', 'allowedRoles', 'settleAfterMs', 'despawnAfterMs',
36
+ ], `detach action ${actionId}`);
37
+ const descriptor = raw;
38
+ if (descriptor.partId !== 'hood')
39
+ throw new Error(`vehicle specialty detach action ${actionId} partId is invalid`);
40
+ const transform = record(descriptor.localTransform);
41
+ const collider = record(descriptor.collider);
42
+ if (!transform) {
43
+ throw new Error(`vehicle specialty detach action ${actionId} localTransform is invalid`);
44
+ }
45
+ exactFields(transform, ['position', 'rotation'], `detach action ${actionId} localTransform`);
46
+ if (!collider || collider.shape !== 'box') {
47
+ throw new Error(`vehicle specialty detach action ${actionId} collider is invalid`);
48
+ }
49
+ exactFields(collider, ['shape', 'halfExtents'], `detach action ${actionId} collider`);
50
+ const position = finiteTuple(transform.position, 3, `${actionId} position`);
51
+ const rotation = finiteTuple(transform.rotation, 4, `${actionId} rotation`);
52
+ const halfExtents = finiteTuple(collider.halfExtents, 3, `${actionId} halfExtents`);
53
+ const rotationNorm = Math.sqrt(rotation.reduce((sum, entry) => sum + entry * entry, 0));
54
+ if (position.some((entry) => Math.abs(entry) > POSITION_ABS_MAX_M) ||
55
+ !Number.isInteger(descriptor.stateBit) || Number(descriptor.stateBit) < 0 ||
56
+ Number(descriptor.stateBit) > 15 ||
57
+ rotation.some((entry) => Math.abs(entry) > 1) || Math.abs(rotationNorm - 1) > 0.001 ||
58
+ halfExtents.some((entry) => entry <= 0 || entry > COLLIDER_HALF_EXTENT_MAX_M) ||
59
+ typeof descriptor.massKg !== 'number' || !Number.isFinite(descriptor.massKg) ||
60
+ descriptor.massKg < MASS_MIN_KG || descriptor.massKg > MASS_MAX_KG ||
61
+ !Array.isArray(descriptor.allowedRoles) || descriptor.allowedRoles.length === 0 ||
62
+ descriptor.allowedRoles.some((role) => !VEHICLE_ROLES.has(role)) ||
63
+ new Set(descriptor.allowedRoles).size !== descriptor.allowedRoles.length ||
64
+ !Number.isSafeInteger(descriptor.settleAfterMs) || Number(descriptor.settleAfterMs) < 0 ||
65
+ Number(descriptor.settleAfterMs) > SETTLE_MAX_MS ||
66
+ !Number.isSafeInteger(descriptor.despawnAfterMs) || Number(descriptor.despawnAfterMs) < DESPAWN_MIN_MS ||
67
+ Number(descriptor.despawnAfterMs) > DESPAWN_MAX_MS ||
68
+ Number(descriptor.despawnAfterMs) < Number(descriptor.settleAfterMs))
69
+ throw new Error(`vehicle specialty detach action ${actionId} descriptor is invalid`);
70
+ return {
71
+ partId: 'hood',
72
+ stateBit: Number(descriptor.stateBit),
73
+ localTransform: {
74
+ position: position,
75
+ rotation: rotation,
76
+ },
77
+ collider: { shape: 'box', halfExtents: halfExtents },
78
+ massKg: descriptor.massKg,
79
+ allowedRoles: [...descriptor.allowedRoles],
80
+ settleAfterMs: Number(descriptor.settleAfterMs),
81
+ despawnAfterMs: Number(descriptor.despawnAfterMs),
82
+ };
83
+ }
84
+ function detachActions(value) {
85
+ if (value == null)
86
+ return null;
87
+ const root = record(value);
88
+ if (!root)
89
+ throw new Error('vehicle specialty detachActions is invalid');
90
+ exactFields(root, ['version', 'actions'], 'detachActions');
91
+ const actions = record(root.actions);
92
+ if (root.version !== 1 || !actions) {
93
+ throw new Error('vehicle specialty detachActions is invalid');
94
+ }
95
+ const entries = Object.entries(actions);
96
+ if (entries.length !== 1 || entries.some(([actionId]) => !isVehicleDetachActionId(actionId))) {
97
+ throw new Error('vehicle specialty detachActions contains an invalid action id');
98
+ }
99
+ const seenStateBits = new Set();
100
+ const normalizedEntries = entries.map(([actionId, descriptor]) => {
101
+ const normalized = detachDescriptor(descriptor, actionId);
102
+ if (seenStateBits.has(normalized.stateBit)) {
103
+ throw new Error(`vehicle specialty detach action ${actionId} stateBit is duplicated`);
104
+ }
105
+ seenStateBits.add(normalized.stateBit);
106
+ return [actionId, normalized];
107
+ });
108
+ return {
109
+ version: 1,
110
+ actions: Object.fromEntries(normalizedEntries),
111
+ };
112
+ }
113
+ /** Mirrors the trusted World compiler's placement-scoped module identity. */
114
+ export function vehicleSpecialtyRuntimeModuleId(bundleId, placementId) {
115
+ if (!BUNDLE.test(bundleId))
116
+ throw new Error('vehicle specialty bundleId is invalid');
117
+ if (!UUID.test(placementId))
118
+ throw new Error('vehicle specialty placementId is invalid');
119
+ const safeSlug = bundleId.replace(/[^a-z0-9-]/g, '').slice(0, 13) || 'item';
120
+ return `itx.${safeSlug}.${placementId.replace(/-/g, '').slice(0, 12).toLowerCase()}`;
121
+ }
122
+ /** Mirrors the trusted World compiler's authoritative moving entity identity. */
123
+ export function vehicleSpecialtyEntityId(placementId) {
124
+ if (!UUID.test(placementId))
125
+ throw new Error('vehicle specialty placementId is invalid');
126
+ return `uv.${placementId.replace(/-/g, '').slice(0, 24).toLowerCase()}`;
127
+ }
128
+ /**
129
+ * Converts a public World placement plus its checksum-pinned package into the
130
+ * exact binding used by the signed room config. No caller-supplied module or
131
+ * entity id is accepted.
132
+ */
133
+ export function vehicleSpecialtyPlacementBinding(identity) {
134
+ if (!identity.itemInstanceId.trim())
135
+ throw new Error('vehicle specialty itemInstanceId is required');
136
+ if (!SHA256.test(identity.bundleChecksumSha256))
137
+ throw new Error('vehicle specialty bundle checksum is invalid');
138
+ if (!Number.isSafeInteger(identity.revision) || identity.revision < 1)
139
+ throw new Error('vehicle specialty revision is invalid');
140
+ if (identity.stateVars.some((name) => !/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(name))) {
141
+ throw new Error('vehicle specialty stateVars contains an invalid name');
142
+ }
143
+ return {
144
+ placementId: identity.placementId,
145
+ itemInstanceId: identity.itemInstanceId,
146
+ moduleId: vehicleSpecialtyRuntimeModuleId(identity.bundleId, identity.placementId),
147
+ entityId: vehicleSpecialtyEntityId(identity.placementId),
148
+ bundleChecksumSha256: identity.bundleChecksumSha256,
149
+ revision: identity.revision,
150
+ stateVars: [...identity.stateVars],
151
+ detachActions: detachActions(identity.detachActions),
152
+ };
153
+ }
154
+ //# sourceMappingURL=vehicle-specialty-placement.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vehicle-specialty-placement.js","sourceRoot":"","sources":["../src/vehicle-specialty-placement.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,78 @@
1
+ import type { HelixRoom } from './multiplayer.js';
2
+ import type { VehicleDetachActions } from './universal-vehicles.js';
3
+ export interface VehicleSpecialtyRoomBinding {
4
+ /** Required for legacy/static bindings; dynamic room modules have no public inventory UUID. */
5
+ itemInstanceId?: string;
6
+ moduleId: string;
7
+ /** Present on trusted placement bindings; legacy specialty-only bindings omit it. */
8
+ entityId?: string;
9
+ bundleChecksumSha256: string;
10
+ revision: number;
11
+ stateVars: readonly string[];
12
+ /** Full signed descriptor from the trusted runtime mount; null means this vehicle has no detachable part. */
13
+ detachActions?: VehicleDetachActions | null;
14
+ }
15
+ export interface VehicleSpecialtyInvocation {
16
+ functionName: string;
17
+ args: Readonly<Record<string, unknown>>;
18
+ /** Caller assertions are diagnostic only; the trusted constructor binding is always used. */
19
+ itemInstanceId?: string;
20
+ moduleId?: string;
21
+ bundleChecksumSha256?: string;
22
+ }
23
+ export interface VehicleSpecialtyDetachInvocation {
24
+ actionId: string;
25
+ }
26
+ export interface VehicleSpecialtyComponentInvocation {
27
+ action: string;
28
+ targetBits?: number;
29
+ }
30
+ export interface VehicleSpecialtyStateSnapshot {
31
+ itemInstanceId?: string;
32
+ moduleId: string;
33
+ bundleChecksumSha256: string;
34
+ revision: number;
35
+ serverTick: number;
36
+ vars: Readonly<Record<string, unknown>>;
37
+ }
38
+ export interface VehicleSpecialtyPresentationEffect {
39
+ moduleId: string;
40
+ commandId: string;
41
+ index: number;
42
+ serverTick: number;
43
+ event: string;
44
+ payload: Readonly<Record<string, unknown>>;
45
+ }
46
+ type StateSubscriber = (snapshot: VehicleSpecialtyStateSnapshot, options: {
47
+ initial: boolean;
48
+ }) => void;
49
+ type EffectSubscriber = (effect: VehicleSpecialtyPresentationEffect) => void;
50
+ type VehicleSpecialtyRoom = Pick<HelixRoom, 'state' | 'module' | 'onStateChange' | 'onMessage' | 'sendModuleAction'> & Partial<Pick<HelixRoom, 'sendVehicleComponentAction' | 'sendVehicleDetachAction'>>;
51
+ /**
52
+ * Binds a checksum-pinned Universal Vehicle specialty module to the normal
53
+ * HELIX room. State is hydrated immediately for late joiners, then assigned a
54
+ * client-local monotonic revision on every distinct authoritative patch.
55
+ */
56
+ export declare class VehicleSpecialtyRoomTransport {
57
+ #private;
58
+ constructor(room: VehicleSpecialtyRoom, binding: VehicleSpecialtyRoomBinding);
59
+ invoke(invocation: VehicleSpecialtyInvocation): void;
60
+ /** The exact detachable-part action ids admitted by this signed placement. */
61
+ detachActionIds(): readonly string[];
62
+ /**
63
+ * Submit one admitted rigid-part detach intent with constructor-bound package
64
+ * identity. Unknown action ids fail closed without consuming a replay number.
65
+ */
66
+ invokeDetach(invocation: VehicleSpecialtyDetachInvocation): boolean;
67
+ /**
68
+ * Submit one server-authoritative component mutation using only the trusted
69
+ * constructor identity and entity. The room and server resolve live vehicle
70
+ * authority and admit the action against the signed component protocol.
71
+ */
72
+ invokeComponent(invocation: VehicleSpecialtyComponentInvocation): boolean;
73
+ subscribeState(subscriber: StateSubscriber): () => void;
74
+ subscribeEffect(subscriber: EffectSubscriber): () => void;
75
+ snapshot(): VehicleSpecialtyStateSnapshot | null;
76
+ dispose(): void;
77
+ }
78
+ export {};