tas-uell-sdk 0.1.2 → 0.2.0

package/lib/components/tas-btn/tas-btn.component.d.ts

@@ -15,6 +15,7 @@ export declare class TasButtonComponent implements OnInit, OnDestroy {
     currentUser: TasCurrentUser;
     variant: 'default' | 'teal';
     buttonLabel: string;
+    skipStatusCheck: boolean;
     isLoading: boolean;
     isCheckingStatus: boolean;
     isStatusError: boolean;
@@ -47,9 +48,10 @@ export declare class TasButtonComponent implements OnInit, OnDestroy {
      * Check status endpoint to determine if button should be enabled
      */
     private checkStatus;
+    private handleStatusError;
     onClick(): void;
     private openWaitingRoomModal;
     private openVideoCallModal;
     static ɵfac: i0.ɵɵFactoryDeclaration<TasButtonComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TasButtonComponent, "tas-btn", never, { "roomType": "roomType"; "entityId": "entityId"; "tenant": "tenant"; "businessRole": "businessRole"; "currentUser": "currentUser"; "variant": "variant"; "buttonLabel": "buttonLabel"; }, {}, never, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TasButtonComponent, "tas-btn", never, { "roomType": "roomType"; "entityId": "entityId"; "tenant": "tenant"; "businessRole": "businessRole"; "currentUser": "currentUser"; "variant": "variant"; "buttonLabel": "buttonLabel"; "skipStatusCheck": "skipStatusCheck"; }, {}, never, never>;
 }

package/lib/components/tas-incoming-appointment/tas-incoming-appointment.component.d.ts

@@ -9,8 +9,10 @@ export declare class TasIncomingAppointmentComponent implements OnInit, OnDestro
     tenant: string;
     businessRole: TasBusinessRole;
     currentUser: TasCurrentUser;
+    fromDate: string;
+    toDate: string;
     enterCall: EventEmitter<TasAppointment>;
-    appointment: TasAppointment | null;
+    appointments: TasAppointment[];
     isLoading: boolean;
     hasError: boolean;
     private subscriptions;
@@ -18,16 +20,23 @@ export declare class TasIncomingAppointmentComponent implements OnInit, OnDestro
     ngOnInit(): void;
     ngOnDestroy(): void;
     private loadAppointments;
-    onEnterCall(): void;
+    onEnterCall(appointment: TasAppointment): void;
+    /**
+     * Check if tas-btn should be shown for an appointment (CONFIRMED or ACTIVE status)
+     */
+    shouldShowTasBtn(appointment: TasAppointment): boolean;
     /**
      * Format date to Spanish format: "Lunes 8 de diciembre"
      */
-    get formattedDate(): string;
+    formatAppointmentDate(appointment: TasAppointment): string;
     /**
      * Format time range: "9:00 - 9:30"
      */
-    get formattedTimeRange(): string;
-    private formatDate;
+    formatTimeRange(appointment: TasAppointment): string;
+    /**
+     * Get the other participant in the call (not the current user)
+     */
+    getOtherParticipant(appointment: TasAppointment): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<TasIncomingAppointmentComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TasIncomingAppointmentComponent, "tas-incoming-appointment", never, { "roomType": "roomType"; "entityId": "entityId"; "tenant": "tenant"; "businessRole": "businessRole"; "currentUser": "currentUser"; }, { "enterCall": "enterCall"; }, never, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TasIncomingAppointmentComponent, "tas-incoming-appointment", never, { "roomType": "roomType"; "entityId": "entityId"; "tenant": "tenant"; "businessRole": "businessRole"; "currentUser": "currentUser"; "fromDate": "fromDate"; "toDate": "toDate"; }, { "enterCall": "enterCall"; }, never, never>;
 }

package/lib/components/tas-videocall/tas-videocall.component.d.ts

@@ -1,13 +1,23 @@
 import { OnInit, OnDestroy, ElementRef, AfterViewInit } from '@angular/core';
+import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
 import { NgbActiveModal } from '@ng-bootstrap/ng-bootstrap';
 import { TasService } from '../../services/tas.service';
 import { GeolocationService } from '../../services/geolocation.service';
-import { CallState, TasBusinessRole, WaitingRoomUser } from '../../interfaces/tas.interfaces';
+import { CallState, TasBusinessRole, WaitingRoomUser, UserGeoInfo } from '../../interfaces/tas.interfaces';
 import * as i0 from "@angular/core";
+/** User geolocation panel view states */
+export declare enum UserGeoViewState {
+    HIDDEN = "HIDDEN",
+    INITIAL = "INITIAL",
+    VERIFYING = "VERIFYING",
+    VERIFIED = "VERIFIED",
+    DENIED = "DENIED"
+}
 export declare class TasVideocallComponent implements OnInit, OnDestroy, AfterViewInit {
     activeModal: NgbActiveModal;
     private tasService;
     private geolocationService;
+    private sanitizer;
     sessionId: string;
     token: string;
     appointmentId?: number;
@@ -31,8 +41,14 @@ export declare class TasVideocallComponent implements OnInit, OnDestroy, AfterVi
     geoLocationStatus: 'unknown' | 'active' | 'denied';
     geoRequestActive: boolean;
     allGeoGranted: boolean;
+    userGeoInfo: UserGeoInfo[];
+    userGeoViewState: UserGeoViewState;
+    UserGeoViewState: typeof UserGeoViewState;
+    homeIcon: SafeHtml;
+    devModeEnabled: boolean;
+    private geoPanelDismissed;
     private subscriptions;
-    constructor(activeModal: NgbActiveModal, tasService: TasService, geolocationService: GeolocationService);
+    constructor(activeModal: NgbActiveModal, tasService: TasService, geolocationService: GeolocationService, sanitizer: DomSanitizer);
     ngOnInit(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
@@ -45,6 +61,20 @@ export declare class TasVideocallComponent implements OnInit, OnDestroy, AfterVi
      * Check if current user can admit others (OWNER, BACKOFFICE, or MODERATOR)
      */
     get canAdmitUsers(): boolean;
+    /** Users with pending geo status */
+    get pendingUsers(): UserGeoInfo[];
+    /** Users who granted geo */
+    get grantedUsers(): UserGeoInfo[];
+    /** Users who denied geo */
+    get deniedUsers(): UserGeoInfo[];
+    /** Show location panel only if owner and there are users who haven't granted */
+    get shouldShowLocationPanel(): boolean;
+    /** Check if any user has denied geo */
+    get hasAnyDenied(): boolean;
+    /** Show user geo panel for owners when not hidden */
+    get shouldShowUserGeoPanel(): boolean;
+    /** Set user geo view state (for dev controls or close button) */
+    setUserGeoViewState(state: UserGeoViewState): void;
     /**
      * Admit a user from the waiting room
      */
@@ -58,19 +88,26 @@ export declare class TasVideocallComponent implements OnInit, OnDestroy, AfterVi
      */
     closeLocationPanel(): void;
     /**
-     * Request the user to share their location
+     * Request the user to share their location (called by owner)
      */
     requestUserLocation(): void;
     private setupSubscriptions;
     /**
      * Handle activateGeo request from backend (for non-owner users).
-     * If geo is already active, report it. If not, prompt user.
+     * Directly prompts browser for geolocation - no panel for users.
      */
     private handleActivateGeo;
+    /** Start geolocation verification (called from template button) */
+    startGeoVerification(): Promise<void>;
     /**
-     * Report geolocation status to backend.
+     * Report granted geolocation to backend.
+     * IMPORTANT: Only call with valid coordinates.
      */
     private reportGeoStatus;
+    /**
+     * Report denied geolocation to backend.
+     */
+    private denyGeoLocation;
     private initializeCall;
     private resetVideoPositions;
     private initInteract;

package/lib/components/tas-waiting-room/tas-waiting-room.component.d.ts

@@ -34,39 +34,61 @@ export declare class TasWaitingRoomComponent implements OnInit, OnDestroy {
     private subscriptions;
     private videoCallModalRef;
     private geoPosition;
+    private geoWasDenied;
+    private geoResultSent;
+    private mediaPermissionsGranted;
+    private geoPermissionsResolved;
+    private retryCount;
+    private readonly MAX_RETRIES;
     /** Whether current user is an owner */
     get isOwner(): boolean;
+    /** Whether we're still requesting permissions (for template) */
+    get isRequestingPermissions(): boolean;
+    /** Whether we're waiting for admission after permissions granted (for template) */
+    get isWaitingForAdmission(): boolean;
     constructor(activeModal: NgbActiveModal, tasService: TasService, geolocationService: GeolocationService, modalService: NgbModal, cdr: ChangeDetectorRef);
     ngOnInit(): void;
     /**
      * Request camera and microphone permissions.
+     * Triggers auto-join when permissions are resolved.
      */
     private requestMediaPermissions;
     /**
-     * Request geolocation immediately on init.
+     * Request geolocation permission and cache result.
      * Only for regular users (not owners/backoffice).
-     * If user allows, store position and send to backend.
+     * Actual send to backend happens after we have videoCallId.
+     * Triggers auto-join when geolocation is resolved.
      */
     private requestGeolocation;
     /**
-     * Send geolocation to backend via modify user endpoint.
-     * NOTE: Endpoint call is prepared but may not be active yet.
+     * Send geo result to backend (granted or denied).
+     * Only sends if videoCallId is available and not already sent.
+     */
+    private sendGeoResultToBackend;
+    /**
+     * Send granted geolocation to backend via modify user endpoint.
      */
     private sendGeolocationToBackend;
+    /**
+     * Send geolocation denial to backend via modify user endpoint.
+     */
+    private sendGeoDenialToBackend;
     ngOnDestroy(): void;
     /**
      * Check status to get session info
      */
     private checkStatus;
     /**
-     * Handle changes to joinable status
+     * Handle changes to joinable status.
+     * Triggers auto-join when joinable becomes true.
      */
     private handleJoinableChange;
     /**
-     * Called when user clicks the join button.
-     * Calls /start to get token then auto-joins.
+     * Attempt to auto-join the session when all conditions are met.
+     * - For owners: just need joinable + sessionId
+     * - For users: need media permissions + geo resolved + joinable + sessionId
      */
-    joinSession(): void;
+    private tryAutoJoin;
     /**
      * Check if user has owner/backoffice role
      */
@@ -76,11 +98,8 @@ export declare class TasWaitingRoomComponent implements OnInit, OnDestroy {
      */
     private startSessionAndJoin;
     /**
-     * Closes the waiting room
-     */
-    cancel(): void;
-    /**
-     * Retry after an error
+     * Retry after an error.
+     * Resets retry count and restarts the flow.
      */
     retry(): void;
     private openVideoCallModal;

package/lib/icons/tas-icons.d.ts

@@ -0,0 +1,8 @@
+/**
+ * SVG icons used internally by TAS SDK components.
+ * Icons are stored as strings to avoid asset bundling complexity.
+ */
+export declare const TAS_ICONS: {
+    readonly home: "<svg width=\"120\" height=\"100\" viewBox=\"0 0 120 100\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\">\n<rect x=\"10\" width=\"100\" height=\"100\" rx=\"50\" fill=\"#44D8E8\" fill-opacity=\"0.2\"/>\n<path d=\"M45 70C43.625 70 42.4479 69.5104 41.4688 68.5313C40.4896 67.5521 40 66.375 40 65V46.5625L37.5 48.5C36.9583 48.9167 36.3438 49.0833 35.6562 49C34.9688 48.9167 34.4167 48.5833 34 48C33.5833 47.4583 33.4271 46.8542 33.5312 46.1875C33.6354 45.5208 33.9583 44.9792 34.5 44.5625L56.9375 27.3125C57.3958 26.9792 57.8854 26.7292 58.4062 26.5625C58.9271 26.3958 59.4583 26.3125 60 26.3125C60.5417 26.3125 61.0729 26.3958 61.5938 26.5625C62.1146 26.7292 62.6042 26.9792 63.0625 27.3125L85.5 44.5C86.0417 44.9167 86.3646 45.4583 86.4688 46.125C86.5729 46.7917 86.4167 47.4167 86 48C85.5833 48.5833 85.0417 48.9063 84.375 48.9688C83.7083 49.0313 83.0833 48.8542 82.5 48.4375L60 31.25L45 42.75V65H50.0625C50.7708 65 51.3542 65.2396 51.8125 65.7188C52.2708 66.1979 52.5 66.7917 52.5 67.5C52.5 68.2083 52.2604 68.8021 51.7812 69.2813C51.3021 69.7604 50.7083 70 50 70H45ZM67.3125 73.9375C66.9792 73.9375 66.6667 73.875 66.375 73.75C66.0833 73.625 65.8125 73.4375 65.5625 73.1875L58.5 66.125C58 65.625 57.75 65.0417 57.75 64.375C57.75 63.7083 58 63.125 58.5 62.625C59 62.125 59.5833 61.875 60.25 61.875C60.9167 61.875 61.5 62.125 62 62.625L67.3125 67.875L79.6875 55.5C80.1875 55 80.7812 54.7604 81.4688 54.7813C82.1562 54.8021 82.75 55.0625 83.25 55.5625C83.75 56.0625 84 56.6458 84 57.3125C84 57.9792 83.75 58.5625 83.25 59.0625L69.0625 73.1875C68.8125 73.4375 68.5417 73.625 68.25 73.75C67.9583 73.875 67.6458 73.9375 67.3125 73.9375Z\" fill=\"white\"/>\n<path d=\"M110 5L106.575 3.425L105 0L103.425 3.425L100 5L103.425 6.575L105 10L106.575 6.575L110 5Z\" fill=\"#44D8E8\"/>\n<path d=\"M10 51L6.575 49.425L5 46L3.425 49.425L0 51L3.425 52.575L5 56L6.575 52.575L10 51Z\" fill=\"#44D8E8\"/>\n<path d=\"M95 43.5L93.2875 42.7125L92.5 41L91.7125 42.7125L90 43.5L91.7125 44.2875L92.5 46L93.2875 44.2875L95 43.5Z\" fill=\"#44D8E8\"/>\n<path d=\"M42 4.5L40.2875 3.7125L39.5 2L38.7125 3.7125L37 4.5L38.7125 5.2875L39.5 7L40.2875 5.2875L42 4.5Z\" fill=\"#44D8E8\"/>\n<path d=\"M88 83.5L86.2875 82.7125L85.5 81L84.7125 82.7125L83 83.5L84.7125 84.2875L85.5 86L86.2875 84.2875L88 83.5Z\" fill=\"#44D8E8\"/>\n<path d=\"M120 97.5L118.287 96.7125L117.5 95L116.713 96.7125L115 97.5L116.713 98.2875L117.5 100L118.287 98.2875L120 97.5Z\" fill=\"#44D8E8\"/>\n</svg>";
+};
+export declare type TasIconName = keyof typeof TAS_ICONS;

package/lib/interfaces/tas.interfaces.d.ts

@@ -36,7 +36,13 @@ export declare enum UserCallAction {
     BAN = "BAN",
     CHANGE_STATUS = "CHANGE_STATUS",
     REQUEST_GEOLOCALIZATION = "REQUEST_GEOLOCALIZATION",
-    ACTIVATE_GEOLOCATION = "ACTIVATE_GEOLOCATION"
+    ACTIVATE_GEOLOCATION = "ACTIVATE_GEOLOCATION",
+    DENY_GEOLOCATION = "DENY_GEOLOCATION"
+}
+export declare enum GeoStatus {
+    PENDING = "PENDING",
+    GRANTED = "GRANTED",
+    DENIED = "DENIED"
 }
 export declare enum RoomUserStatus {
     ASSIGNED = "ASSIGNED",
@@ -99,6 +105,9 @@ export interface ProxyVideoStatusUser {
     userId: number;
     rol: TasUserRole;
     status: UserStatus;
+    geoStatus: GeoStatus;
+    latitude: number | null;
+    longitude: number | null;
 }
 export interface ProxyVideoStatusResponse {
     content: {
@@ -109,8 +118,8 @@ export interface ProxyVideoStatusResponse {
         waitingRoomAvailable: boolean;
         appointmentId: number;
         activateGeo: boolean;
-        geoRequestActive?: boolean;
-        allGeoGranted?: boolean;
+        geoRequestActive: boolean | null;
+        allGeoGranted: boolean;
         users: ProxyVideoStatusUser[];
     };
 }
@@ -137,10 +146,22 @@ export interface WaitingRoomUser {
     name: string;
     status: RoomUserStatus;
 }
+/** User geolocation info for owner panel */
+export interface UserGeoInfo {
+    userId: number;
+    geoStatus: GeoStatus;
+    latitude: number | null;
+    longitude: number | null;
+}
 export declare enum AppointmentStatus {
     CONFIRMED = "CONFIRMED",
     CANCELLED = "CANCELLED",
-    RESCHEDULED = "RESCHEDULED"
+    RESCHEDULED = "RESCHEDULED",
+    ACTIVE = "ACTIVE"
+}
+export interface TasParticipant {
+    userId: number;
+    name: string;
 }
 export interface TasAppointment {
     id: number;
@@ -154,6 +175,7 @@ export interface TasAppointment {
     notes: string;
     entityId: number;
     roomType: TasRoomType;
+    participants: TasParticipant[];
 }
 export interface GetAppointmentsRequest {
     fromDate: string;

package/lib/services/tas.service.d.ts

@@ -1,10 +1,10 @@
 import { TasUtilityService } from './tas-utility.service';
 import { Observable } from 'rxjs';
 import * as OT from '@opentok/client';
-import { GenerateTokenResponse, StartSessionRequest, FinishSessionResponse, ProxyVideoStatusRequest, ProxyVideoStatusResponse, ProxyVideoFinishRequest, ProxyVideoUserModifyRequest, UserCallAction, RoomUserStatus, TasBusinessRole, CallState, ViewMode, WaitingRoomUser, TasAppointment, GetAppointmentsRequest } from '../interfaces/tas.interfaces';
+import { GenerateTokenResponse, StartSessionRequest, FinishSessionResponse, ProxyVideoStatusRequest, ProxyVideoStatusResponse, ProxyVideoFinishRequest, ProxyVideoUserModifyRequest, UserCallAction, RoomUserStatus, GeoStatus, TasBusinessRole, CallState, ViewMode, WaitingRoomUser, UserGeoInfo, TasAppointment, GetAppointmentsRequest } from '../interfaces/tas.interfaces';
 import { TasConfig, TasHttpClient } from '../config/tas.config';
 import * as i0 from "@angular/core";
-export { CallState, ViewMode, TasBusinessRole, UserCallAction, RoomUserStatus };
+export { CallState, ViewMode, TasBusinessRole, UserCallAction, RoomUserStatus, GeoStatus };
 export declare class TasService {
     private httpClient;
     private config;
@@ -40,12 +40,16 @@ export declare class TasService {
     geoRequestActive$: Observable<boolean>;
     private allGeoGrantedSubject;
     allGeoGranted$: Observable<boolean>;
+    private userGeoInfoSubject;
+    userGeoInfo$: Observable<UserGeoInfo[]>;
     private statusPollingInterval;
     private readonly DEFAULT_POLL_INTERVAL_MS;
     private wasOwnerPresent;
     private currentAppointmentId;
     private currentVideoCallId;
     private currentTenant;
+    private readonly STATUS_CACHE_TTL_MS;
+    private statusCache;
     constructor(httpClient: TasHttpClient, config: TasConfig, tasUtilityService: TasUtilityService);
     /**
      * Start automatic status polling for the current session.
@@ -86,8 +90,15 @@ export declare class TasService {
      * PROXY circuit token: /v2/proxy/video/start
      */
     startProxyVideoSession(payload: StartSessionRequest): Observable<GenerateTokenResponse>;
+    /**
+     * Generate cache key from request payload
+     */
+    private getStatusCacheKey;
+    private inflightStatusRequests;
     /**
      * PROXY circuit status: /v2/proxy/video/status
+     * Uses a 1-second cache to avoid redundant API calls from multiple components
+     * Implements request deduplication for simultaneous calls
      */
     getProxyVideoStatus(payload: ProxyVideoStatusRequest): Observable<ProxyVideoStatusResponse>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tas-uell-sdk",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "TAS (Telemedicine Assistance Service) SDK for Angular applications - Video call functionality using TokBox/Vonage",
   "peerDependencies": {
     "@angular/common": "^13.0.0 || ^14.0.0 || ^15.0.0 || ^16.0.0",