@asiyst/sdk 0.1.21 → 0.1.22

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/dist/index.d.cts CHANGED
@@ -1,3 +1,5 @@
1
+ import * as THREE from 'three';
2
+
1
3
  interface AsiystEventMap {
2
4
  "asiyst:initialized": {
3
5
  projectId: string;
@@ -19,6 +21,26 @@ interface AsiystEventMap {
19
21
  x: number;
20
22
  y: number;
21
23
  };
24
+ "asiyst:avatar:loading": {
25
+ avatarId?: string;
26
+ assetUrl?: string;
27
+ };
28
+ "asiyst:avatar:loaded": {
29
+ avatarId?: string;
30
+ assetUrl?: string;
31
+ format?: string;
32
+ };
33
+ "asiyst:avatar:rendered": {
34
+ avatarId?: string;
35
+ format?: string;
36
+ durationMs?: number;
37
+ };
38
+ "asiyst:avatar:error": {
39
+ avatarId?: string;
40
+ error: string;
41
+ code?: string;
42
+ stage?: string;
43
+ };
22
44
  "asiyst:target:found": {
23
45
  target: TargetRef;
24
46
  elementId: string;
@@ -127,11 +149,29 @@ interface AvatarDataSource {
127
149
  headers?: Record<string, string>;
128
150
  credentials?: string;
129
151
  }
152
+ interface AvatarAnimation {
153
+ id?: string;
154
+ name: string;
155
+ intent?: string;
156
+ clipName?: string;
157
+ loopMode?: string;
158
+ durationMs?: number;
159
+ assetUrl?: string | null;
160
+ }
161
+ interface AvatarBranding {
162
+ siteLogoUrl?: string | null;
163
+ }
130
164
  interface ProjectConfig {
131
165
  schemaVersion: number;
132
166
  version: number;
133
167
  avatarName: string;
134
168
  avatar: string;
169
+ avatarId?: string;
170
+ assetUrl?: string;
171
+ thumbnailUrl?: string | null;
172
+ publishedVersion?: string;
173
+ animations?: AvatarAnimation[];
174
+ branding?: AvatarBranding;
135
175
  size: number;
136
176
  position: AnchorPosition;
137
177
  voice?: string;
@@ -348,4 +388,166 @@ declare function evaluateActionPermission(action: ActionKind, config: ProjectCon
348
388
  };
349
389
  declare function isActionAllowed(action: ActionKind, config: ProjectConfig, source: "developer" | "cloud" | "local", currentUrl?: string, target?: string): boolean;
350
390
 
351
- export { type ActionKind, ActionNotAllowedError, Asiyst, AsiystError, type AsiystEventMap, type AsiystEventName, type AssistantMode, AuthenticationError, ConfigurationError, type HighlightStyle, type InitOptions, InitializationError, type MappedElement, NetworkError, type ProjectConfig, SDK_VERSION, type TargetInput, TargetNotFoundError, type TargetRef, type TaskDefinition, TaskExecutionError, TaskStatus, type TaskStep, type WebsiteMapSnapshot, type WorkflowDefinition, anchorToViewport, canNavigateTo, canTransition, computeAvatarDestination, evaluateActionPermission, fallbackConfig, isActionAllowed, isSafeSelector, normalizeProjectConfig, sanitizeText, validateInitOptions, validateWebsiteDomain };
391
+ interface ParsedGlbMesh {
392
+ name?: string;
393
+ positions: Float32Array;
394
+ normals?: Float32Array;
395
+ indices?: Uint16Array | Uint32Array;
396
+ }
397
+ interface LoadedGlbAsset {
398
+ format: "glb";
399
+ url: string;
400
+ json: Record<string, unknown>;
401
+ bin: Uint8Array;
402
+ meshes: ParsedGlbMesh[];
403
+ embeddedImageUrls: string[];
404
+ durationMs: number;
405
+ }
406
+ interface LoadedImageAsset {
407
+ format: "image";
408
+ url: string;
409
+ image?: HTMLImageElement;
410
+ width?: number;
411
+ height?: number;
412
+ durationMs: number;
413
+ }
414
+ interface LoadedManifestAsset {
415
+ format: "manifest";
416
+ url: string;
417
+ manifest: Record<string, unknown>;
418
+ durationMs: number;
419
+ }
420
+ interface LoadedFbxAsset {
421
+ format: "fbx";
422
+ url: string;
423
+ buffer: ArrayBuffer;
424
+ version?: number;
425
+ isBinary: boolean;
426
+ resourcePath: string;
427
+ durationMs: number;
428
+ }
429
+ type LoadedAvatarAsset = LoadedFbxAsset | LoadedGlbAsset | LoadedImageAsset | LoadedManifestAsset;
430
+ declare class AssetLoader {
431
+ private inFlightController;
432
+ private readonly createdObjectUrls;
433
+ load(assetUrl: string, options?: {
434
+ signal?: AbortSignal;
435
+ timeoutMs?: number;
436
+ }): Promise<LoadedAvatarAsset>;
437
+ isFbxBuffer(buffer: ArrayBuffer): boolean;
438
+ parseFbxHeader(buffer: ArrayBuffer): {
439
+ isBinary: boolean;
440
+ version?: number;
441
+ };
442
+ isGlbBuffer(buffer: ArrayBuffer): boolean;
443
+ private loadImage;
444
+ parseGlb(buffer: ArrayBuffer): {
445
+ json: Record<string, unknown>;
446
+ bin: Uint8Array;
447
+ meshes: ParsedGlbMesh[];
448
+ embeddedImageUrls: string[];
449
+ };
450
+ destroy(): void;
451
+ }
452
+
453
+ type AvatarPose = "idle" | "point" | "think" | "celebrate" | "speak" | "walk";
454
+ interface AvatarRenderer {
455
+ mount(container: HTMLElement, config: ProjectConfig): void;
456
+ unmount(): void;
457
+ applyConfig(config: ProjectConfig): void;
458
+ setPosition(x: number, y: number, animate: boolean): void;
459
+ setFacing(direction: "left" | "right"): void;
460
+ setPose(pose: AvatarPose): void;
461
+ setSpeech(text: string | null): void;
462
+ getSize(): {
463
+ width: number;
464
+ height: number;
465
+ };
466
+ }
467
+
468
+ interface FbxRenderMetrics {
469
+ meshCount: number;
470
+ vertexCount: number;
471
+ animationCount: number;
472
+ }
473
+ declare class FbxRenderer {
474
+ private canvas;
475
+ private renderer;
476
+ private scene;
477
+ private camera;
478
+ private modelRoot;
479
+ private mixer;
480
+ private animFrameId;
481
+ private lastTime;
482
+ private facing;
483
+ private currentPose;
484
+ private initialRenderCompleted;
485
+ mount(container: HTMLElement, asset: LoadedFbxAsset | LoadedGlbAsset, options?: {
486
+ accentColor?: string;
487
+ config?: ProjectConfig;
488
+ }): Promise<FbxRenderMetrics>;
489
+ setFacing(direction: "left" | "right"): void;
490
+ setPose(pose: AvatarPose): void;
491
+ isRendered(): boolean;
492
+ validateGeometry(rawObject: THREE.Object3D): {
493
+ meshCount: number;
494
+ vertexCount: number;
495
+ };
496
+ getCanvas(): HTMLCanvasElement | null;
497
+ private startLoop;
498
+ destroy(): void;
499
+ }
500
+
501
+ type AvatarRenderState = "idle" | "loading" | "ready" | "error";
502
+ declare class CssAvatarRenderer implements AvatarRenderer {
503
+ private root;
504
+ private figure;
505
+ private viewport;
506
+ private bubble;
507
+ private nameEl;
508
+ private size;
509
+ private hidden;
510
+ private facing;
511
+ private pose;
512
+ private accentColor;
513
+ private avatarName;
514
+ private readonly assetLoader;
515
+ private fbxRenderer;
516
+ private renderState;
517
+ private isAssetLoadedFlag;
518
+ private isFallbackFlag;
519
+ private loadedFormat;
520
+ private activeAssetUrl;
521
+ private lastErrorMessage;
522
+ private renderMetrics;
523
+ mount(container: HTMLElement, config: ProjectConfig): void;
524
+ unmount(): void;
525
+ applyConfig(config: ProjectConfig): void;
526
+ loadAsset(config: ProjectConfig): Promise<boolean>;
527
+ private renderLoader;
528
+ private renderLoadedAsset;
529
+ private renderFallback;
530
+ setPosition(x: number, y: number, animate: boolean): void;
531
+ setFacing(direction: "left" | "right"): void;
532
+ setPose(pose: AvatarPose): void;
533
+ private syncTransform;
534
+ setSpeech(text: string | null): void;
535
+ getSize(): {
536
+ width: number;
537
+ height: number;
538
+ };
539
+ setHidden(hidden: boolean): void;
540
+ isHidden(): boolean;
541
+ getFigure(): HTMLElement | undefined;
542
+ getViewport(): HTMLElement | undefined;
543
+ isAssetLoaded(): boolean;
544
+ isRendered(): boolean;
545
+ isFallbackActive(): boolean;
546
+ getRenderState(): AvatarRenderState;
547
+ getLoadedFormat(): string | undefined;
548
+ getAssetUrl(): string | undefined;
549
+ getLastError(): string | undefined;
550
+ getMetrics(): FbxRenderMetrics | undefined;
551
+ }
552
+
553
+ export { type ActionKind, ActionNotAllowedError, Asiyst, AsiystError, type AsiystEventMap, type AsiystEventName, AssetLoader, type AssistantMode, AuthenticationError, type AvatarAnimation, type AvatarBranding, ConfigurationError, CssAvatarRenderer, FbxRenderer, type HighlightStyle, type InitOptions, InitializationError, type MappedElement, NetworkError, type ProjectConfig, SDK_VERSION, type TargetInput, TargetNotFoundError, type TargetRef, type TaskDefinition, TaskExecutionError, TaskStatus, type TaskStep, type WebsiteMapSnapshot, type WorkflowDefinition, anchorToViewport, canNavigateTo, canTransition, computeAvatarDestination, evaluateActionPermission, fallbackConfig, isActionAllowed, isSafeSelector, normalizeProjectConfig, sanitizeText, validateInitOptions, validateWebsiteDomain };
package/dist/index.d.ts CHANGED
@@ -1,3 +1,5 @@
1
+ import * as THREE from 'three';
2
+
1
3
  interface AsiystEventMap {
2
4
  "asiyst:initialized": {
3
5
  projectId: string;
@@ -19,6 +21,26 @@ interface AsiystEventMap {
19
21
  x: number;
20
22
  y: number;
21
23
  };
24
+ "asiyst:avatar:loading": {
25
+ avatarId?: string;
26
+ assetUrl?: string;
27
+ };
28
+ "asiyst:avatar:loaded": {
29
+ avatarId?: string;
30
+ assetUrl?: string;
31
+ format?: string;
32
+ };
33
+ "asiyst:avatar:rendered": {
34
+ avatarId?: string;
35
+ format?: string;
36
+ durationMs?: number;
37
+ };
38
+ "asiyst:avatar:error": {
39
+ avatarId?: string;
40
+ error: string;
41
+ code?: string;
42
+ stage?: string;
43
+ };
22
44
  "asiyst:target:found": {
23
45
  target: TargetRef;
24
46
  elementId: string;
@@ -127,11 +149,29 @@ interface AvatarDataSource {
127
149
  headers?: Record<string, string>;
128
150
  credentials?: string;
129
151
  }
152
+ interface AvatarAnimation {
153
+ id?: string;
154
+ name: string;
155
+ intent?: string;
156
+ clipName?: string;
157
+ loopMode?: string;
158
+ durationMs?: number;
159
+ assetUrl?: string | null;
160
+ }
161
+ interface AvatarBranding {
162
+ siteLogoUrl?: string | null;
163
+ }
130
164
  interface ProjectConfig {
131
165
  schemaVersion: number;
132
166
  version: number;
133
167
  avatarName: string;
134
168
  avatar: string;
169
+ avatarId?: string;
170
+ assetUrl?: string;
171
+ thumbnailUrl?: string | null;
172
+ publishedVersion?: string;
173
+ animations?: AvatarAnimation[];
174
+ branding?: AvatarBranding;
135
175
  size: number;
136
176
  position: AnchorPosition;
137
177
  voice?: string;
@@ -348,4 +388,166 @@ declare function evaluateActionPermission(action: ActionKind, config: ProjectCon
348
388
  };
349
389
  declare function isActionAllowed(action: ActionKind, config: ProjectConfig, source: "developer" | "cloud" | "local", currentUrl?: string, target?: string): boolean;
350
390
 
351
- export { type ActionKind, ActionNotAllowedError, Asiyst, AsiystError, type AsiystEventMap, type AsiystEventName, type AssistantMode, AuthenticationError, ConfigurationError, type HighlightStyle, type InitOptions, InitializationError, type MappedElement, NetworkError, type ProjectConfig, SDK_VERSION, type TargetInput, TargetNotFoundError, type TargetRef, type TaskDefinition, TaskExecutionError, TaskStatus, type TaskStep, type WebsiteMapSnapshot, type WorkflowDefinition, anchorToViewport, canNavigateTo, canTransition, computeAvatarDestination, evaluateActionPermission, fallbackConfig, isActionAllowed, isSafeSelector, normalizeProjectConfig, sanitizeText, validateInitOptions, validateWebsiteDomain };
391
+ interface ParsedGlbMesh {
392
+ name?: string;
393
+ positions: Float32Array;
394
+ normals?: Float32Array;
395
+ indices?: Uint16Array | Uint32Array;
396
+ }
397
+ interface LoadedGlbAsset {
398
+ format: "glb";
399
+ url: string;
400
+ json: Record<string, unknown>;
401
+ bin: Uint8Array;
402
+ meshes: ParsedGlbMesh[];
403
+ embeddedImageUrls: string[];
404
+ durationMs: number;
405
+ }
406
+ interface LoadedImageAsset {
407
+ format: "image";
408
+ url: string;
409
+ image?: HTMLImageElement;
410
+ width?: number;
411
+ height?: number;
412
+ durationMs: number;
413
+ }
414
+ interface LoadedManifestAsset {
415
+ format: "manifest";
416
+ url: string;
417
+ manifest: Record<string, unknown>;
418
+ durationMs: number;
419
+ }
420
+ interface LoadedFbxAsset {
421
+ format: "fbx";
422
+ url: string;
423
+ buffer: ArrayBuffer;
424
+ version?: number;
425
+ isBinary: boolean;
426
+ resourcePath: string;
427
+ durationMs: number;
428
+ }
429
+ type LoadedAvatarAsset = LoadedFbxAsset | LoadedGlbAsset | LoadedImageAsset | LoadedManifestAsset;
430
+ declare class AssetLoader {
431
+ private inFlightController;
432
+ private readonly createdObjectUrls;
433
+ load(assetUrl: string, options?: {
434
+ signal?: AbortSignal;
435
+ timeoutMs?: number;
436
+ }): Promise<LoadedAvatarAsset>;
437
+ isFbxBuffer(buffer: ArrayBuffer): boolean;
438
+ parseFbxHeader(buffer: ArrayBuffer): {
439
+ isBinary: boolean;
440
+ version?: number;
441
+ };
442
+ isGlbBuffer(buffer: ArrayBuffer): boolean;
443
+ private loadImage;
444
+ parseGlb(buffer: ArrayBuffer): {
445
+ json: Record<string, unknown>;
446
+ bin: Uint8Array;
447
+ meshes: ParsedGlbMesh[];
448
+ embeddedImageUrls: string[];
449
+ };
450
+ destroy(): void;
451
+ }
452
+
453
+ type AvatarPose = "idle" | "point" | "think" | "celebrate" | "speak" | "walk";
454
+ interface AvatarRenderer {
455
+ mount(container: HTMLElement, config: ProjectConfig): void;
456
+ unmount(): void;
457
+ applyConfig(config: ProjectConfig): void;
458
+ setPosition(x: number, y: number, animate: boolean): void;
459
+ setFacing(direction: "left" | "right"): void;
460
+ setPose(pose: AvatarPose): void;
461
+ setSpeech(text: string | null): void;
462
+ getSize(): {
463
+ width: number;
464
+ height: number;
465
+ };
466
+ }
467
+
468
+ interface FbxRenderMetrics {
469
+ meshCount: number;
470
+ vertexCount: number;
471
+ animationCount: number;
472
+ }
473
+ declare class FbxRenderer {
474
+ private canvas;
475
+ private renderer;
476
+ private scene;
477
+ private camera;
478
+ private modelRoot;
479
+ private mixer;
480
+ private animFrameId;
481
+ private lastTime;
482
+ private facing;
483
+ private currentPose;
484
+ private initialRenderCompleted;
485
+ mount(container: HTMLElement, asset: LoadedFbxAsset | LoadedGlbAsset, options?: {
486
+ accentColor?: string;
487
+ config?: ProjectConfig;
488
+ }): Promise<FbxRenderMetrics>;
489
+ setFacing(direction: "left" | "right"): void;
490
+ setPose(pose: AvatarPose): void;
491
+ isRendered(): boolean;
492
+ validateGeometry(rawObject: THREE.Object3D): {
493
+ meshCount: number;
494
+ vertexCount: number;
495
+ };
496
+ getCanvas(): HTMLCanvasElement | null;
497
+ private startLoop;
498
+ destroy(): void;
499
+ }
500
+
501
+ type AvatarRenderState = "idle" | "loading" | "ready" | "error";
502
+ declare class CssAvatarRenderer implements AvatarRenderer {
503
+ private root;
504
+ private figure;
505
+ private viewport;
506
+ private bubble;
507
+ private nameEl;
508
+ private size;
509
+ private hidden;
510
+ private facing;
511
+ private pose;
512
+ private accentColor;
513
+ private avatarName;
514
+ private readonly assetLoader;
515
+ private fbxRenderer;
516
+ private renderState;
517
+ private isAssetLoadedFlag;
518
+ private isFallbackFlag;
519
+ private loadedFormat;
520
+ private activeAssetUrl;
521
+ private lastErrorMessage;
522
+ private renderMetrics;
523
+ mount(container: HTMLElement, config: ProjectConfig): void;
524
+ unmount(): void;
525
+ applyConfig(config: ProjectConfig): void;
526
+ loadAsset(config: ProjectConfig): Promise<boolean>;
527
+ private renderLoader;
528
+ private renderLoadedAsset;
529
+ private renderFallback;
530
+ setPosition(x: number, y: number, animate: boolean): void;
531
+ setFacing(direction: "left" | "right"): void;
532
+ setPose(pose: AvatarPose): void;
533
+ private syncTransform;
534
+ setSpeech(text: string | null): void;
535
+ getSize(): {
536
+ width: number;
537
+ height: number;
538
+ };
539
+ setHidden(hidden: boolean): void;
540
+ isHidden(): boolean;
541
+ getFigure(): HTMLElement | undefined;
542
+ getViewport(): HTMLElement | undefined;
543
+ isAssetLoaded(): boolean;
544
+ isRendered(): boolean;
545
+ isFallbackActive(): boolean;
546
+ getRenderState(): AvatarRenderState;
547
+ getLoadedFormat(): string | undefined;
548
+ getAssetUrl(): string | undefined;
549
+ getLastError(): string | undefined;
550
+ getMetrics(): FbxRenderMetrics | undefined;
551
+ }
552
+
553
+ export { type ActionKind, ActionNotAllowedError, Asiyst, AsiystError, type AsiystEventMap, type AsiystEventName, AssetLoader, type AssistantMode, AuthenticationError, type AvatarAnimation, type AvatarBranding, ConfigurationError, CssAvatarRenderer, FbxRenderer, type HighlightStyle, type InitOptions, InitializationError, type MappedElement, NetworkError, type ProjectConfig, SDK_VERSION, type TargetInput, TargetNotFoundError, type TargetRef, type TaskDefinition, TaskExecutionError, TaskStatus, type TaskStep, type WebsiteMapSnapshot, type WorkflowDefinition, anchorToViewport, canNavigateTo, canTransition, computeAvatarDestination, evaluateActionPermission, fallbackConfig, isActionAllowed, isSafeSelector, normalizeProjectConfig, sanitizeText, validateInitOptions, validateWebsiteDomain };