@evercam/api 1.0.0-5ccefe067 → 1.0.0-5d2895b13

package/dist/shared/types/components.d.ts

@@ -1,6 +1,184 @@
-import { type _360Scene, type Media, type DroneModel, type MobileCaptureSnapshot, type TimelineDateInterval, type TimelinePrecision, type Comment, TaskStatus, Tag } from "@evercam/api/types";
+import { type _360Scene, type Media, type DroneModel, type MobileCaptureSnapshot, type TimelineDateInterval, type TimelinePrecision, type Comment, type ProcoreUserProject, type ProcoreProjectAlbum, type ProcoreObservationType, type AconexUserProject, type AutodeskUserHub, type AutodeskProject, type AutodeskFolder, type ProcoreType, type HammertechProject, type HammertechIssueType, type HammertechPriority, type HammertechClassification, type HammertechFileFieldValue, Tag, TuplePoint2D, CameraStatus } from "@evercam/shared/types";
+import type { _360AssetType, AdminCamera, Camera, IngestUploadInitResponse } from "@evercam/api/types";
 import type { TimelineChartType, TimelineEvent, TimelineEventsGroup } from "@evercam/ui";
 import { TimelineDataProvider } from "@evercam/shared/components/timelinePlayer/providers";
+import { SeriesOptionsType } from "highcharts";
+export type ReorderableCamera = Camera & {
+    thumbnailSrc?: string;
+    batteryLevel?: {
+        voltage: number;
+        level: string;
+        icon: string;
+        color: string;
+    } | null;
+};
+export type SelectItem = {
+    text: string;
+    value: string | number;
+};
+export type RoiProjectGroup = {
+    exid: string;
+    name: string;
+    cameras: AdminCamera[];
+};
+export declare enum IframeMessageType {
+    LiveView = "liveView",
+    EditSnapshot = "editSnapshot",
+    Weather = "weather",
+    CameraInfo = "cameraInfo",
+    AnalyticsEvent = "analyticsEvent",
+    Ready = "ready",
+    Info = "info",
+    GateReport = "gateReport",
+    CreateCompare = "createCompare",
+    UploadDrone = "uploadDrone",
+    UploadBIM = "uploadBIM",
+    History = "history",
+    PerformanceScore = "performanceScore",
+    ShareLink = "shareLink",
+    LoadForgeModel = "loadForgeModel",
+    LoadPlannerList = "loadPlannerList",
+    SaveProjectBounds = "saveProjectBounds",
+    ArchiveComment = "archiveComment",
+    UnarchiveComment = "unarchiveComment",
+    DeleteComment = "deleteComment",
+    CreateComment = "createComment",
+    RefreshComments = "refreshComments",
+    CommentSyncFailed = "commentSyncFailed",
+    Load360Gallery = "load360Gallery",
+    Upload360 = "upload360",
+    FetchForgeToken = "FetchForgeToken",
+    ForgeTokenResponse = "ForgeTokenResponse",
+    ShowBimUploadChoice = "showBimUploadChoice",
+    ViewerLaunchFlags = "viewerLaunchFlags",
+    Fetch360DrawingIds = "fetch360DrawingIds",
+    DrawingIdsResponse = "drawingIdsResponse",
+    CloseCameraMarkerPreview = "CloseCameraMarkerPreview",
+    ChatInit = "chatInit",
+    ChatToken = "chatToken",
+    ChatContext = "chatContext",
+    ChatTheme = "chatTheme",
+    ChatNavigate = "chatNavigate",
+    ChatConversations = "chatConversations",
+    ChatOpenConversation = "chatOpenConversation",
+    ChatNewConversation = "chatNewConversation",
+    ChatRenameConversation = "chatRenameConversation",
+    ChatDeleteConversation = "chatDeleteConversation",
+    ChatOpenWalkMarker = "chatOpenWalkMarker",
+    ProjectMembers = "projectMembers",
+    FocusComment = "focusComment"
+}
+export declare enum ChatTheme {
+    Dark = "dark",
+    Light = "light"
+}
+export type ChatUser = {
+    email: string;
+    name: string;
+};
+/**
+ * The dashboard's answer to the frame's `Ready`.
+ *
+ * The token travels here and nowhere else — never in the iframe URL, which
+ * would land it in history, referrers and logs.
+ */
+export type ChatInitPayload = {
+    token: string;
+    user: ChatUser;
+    theme: ChatTheme;
+    timezone: string;
+};
+/** Pushed on rotation. A frame holding a mount-time token 401s the moment it changes. */
+export type ChatTokenPayload = {
+    token: string;
+};
+/** Pushed on every dashboard route change. */
+export type ChatContextPayload = {
+    pageId: string;
+    projectExid: string | null;
+    projectName: string | null;
+    cameraExid: string | null;
+    timezone: string;
+    /**
+     * A conversation to open, from `?chat=` on the dashboard's URL.
+     *
+     * Deep-linking lives in the *context* rather than in a message of its own
+     * because it is exactly that — a fact about where the host currently is, sent
+     * on every route change alongside the project and page. `null` means "no
+     * opinion", which is what every other page sends.
+     */
+    chatId: string | null;
+};
+export type ChatThemePayload = {
+    theme: ChatTheme;
+};
+/**
+ * A page id plus params, never a route string — the dashboard owns the
+ * id → route mapping.
+ */
+export type ChatNavigatePayload = {
+    pageId: string;
+    params: Record<string, string>;
+};
+/**
+ * Open a 360-walk marker in the 360 viewer, facing one view.
+ *
+ * Sent by Chat when a `WalkView` in an answer is clicked. The dashboard opens the
+ * 360 app in its own dialog (`Walk360Preview`), outside the chat frame, so the
+ * viewer gets the whole screen. `walkName` and `walkDate` are how the 360 app
+ * knows a walk (its `floor` and `date` URL params); `camera` is the viewer's own
+ * azimuth/polar angles for that view, or null to open at the marker's default.
+ */
+export type ChatOpenWalkMarkerPayload = {
+    projectExid: string;
+    walkId: string;
+    walkName: string;
+    walkDate: string;
+    markerId: string;
+    view: string;
+    camera: {
+        azimuthAngle: number;
+        polarAngle: number;
+    } | null;
+};
+/**
+ * One conversation, as the dashboard's sidebar needs it.
+ *
+ * A deliberate projection of the engine's `ChatSession` — a label and a
+ * timestamp, nothing else. The transcript stays in the frame: mirroring `turns`
+ * would put every message of every conversation on the bridge each time the list
+ * changed, to render a row that shows neither.
+ */
+export type ChatSessionSummary = {
+    id: string;
+    title: string | null;
+    updatedAt: string;
+};
+/**
+ * The frame's conversation list, mirrored up for the left sidebar to draw.
+ *
+ * The frame stays the single owner of this data — it holds the engine client and
+ * the bearer. The host renders and sends intent back; it never fetches.
+ */
+export type ChatConversationsPayload = {
+    sessions: ChatSessionSummary[];
+    openId: string | null;
+    isLoading: boolean;
+};
+export type ChatOpenConversationPayload = {
+    id: string;
+};
+export type ChatRenameConversationPayload = {
+    id: string;
+    title: string;
+};
+export type ChatDeleteConversationPayload = {
+    id: string;
+};
+export declare enum NavigationArrow {
+    Previous = "previous",
+    Next = "next"
+}
 export declare enum WatermarkedImageDownloadOrigin {
     Drone = "drone",
     Bim = "BIM",
@@ -12,24 +190,6 @@ export declare enum PlayerMode {
     Video = "video",
     Jpegs = "jpegs"
 }
-export type TasksStatusMap = {
-    [key: string]: TaskStatus;
-};
-export type TaskProgressItem = {
-    status: TaskStatus;
-    description: string;
-    percentDone?: number;
-    duration?: number;
-};
-export type GlobalSearchMatch = {
-    path: Array<string>;
-    value: string | number | boolean;
-};
-export type GlobalSearchResult = {
-    index: number;
-    matches: Array<GlobalSearchMatch>;
-};
-export type GlobalSearchResultInput = Array<Record<any, any> | Array<any>>;
 export type TimelineProviderRequestParams = TimelineDateInterval & {
     precision?: TimelinePrecision;
     labels?: string[];
@@ -43,13 +203,6 @@ export type TimelinePlayerGroupConfig = {
 export type TimelinePlayerConfig = {
     [groupName: string]: TimelinePlayerGroupConfig;
 };
-export type TimelinePlayerTooltipItem = {
-    label?: string;
-    title?: string;
-    thumbnailUrl: string;
-    placeholderThumbnailUrl?: string;
-    fallbackThumbnailUrl?: string;
-};
 export declare enum TimelineGroupId {
     ThreeSixty = "w360",
     Drone = "drone",
@@ -119,8 +272,8 @@ export type LeaderLineOptions = {
     startPlugSize?: number;
     endPlugSize?: number;
     path?: LeaderLinesPathType;
-    startSocketGravity?: [number, number];
-    endSocketGravity?: [number, number];
+    startSocketGravity?: TuplePoint2D;
+    endSocketGravity?: TuplePoint2D;
     dash?: {
         animation: boolean | {
             duration: number;
@@ -137,10 +290,6 @@ export type LineConfig = {
     end: CssSelector | CssSelector[];
     options?: LeaderLineOptions;
 };
-export type Point = {
-    x: number;
-    y: number;
-};
 export declare enum ZohoDeskTicketStatus {
     Closed = "Closed",
     OnHold = "On Hold",
@@ -151,13 +300,18 @@ export type TagSelectorItem = Tag & {
 };
 export declare enum FormSchemaComponents {
     SelectField = "SelectField",
+    HierarchicalSelect = "HierarchicalSelectField",
     MultiOption = "MultiOption",
     TextField = "TextField",
-    CheckBox = "SwitchField",
-    DateTime = "DatePickerInput",
+    SwitchField = "SwitchField",
+    CheckBox = "CheckBoxField",
+    Date = "DatePickerInput",
+    DateTime = "DateTimeField",
+    Time = "TimeField",
     TextArea = "Textarea",
     Search = "Autocomplete",
-    ReadOnly = "ReadOnly"
+    ReadOnly = "ReadOnly",
+    Ratio = "RatioField"
 }
 export declare enum FormSchemaDataType {
     String = "string",
@@ -168,6 +322,7 @@ export declare enum FormSchemaDataType {
 export type FormSchemaOptions = {
     title: string;
     value: string;
+    parentId?: string | null;
 };
 export type FormSchemaField = {
     id: string;
@@ -182,11 +337,176 @@ export type FormSchemaField = {
     columns?: number;
 };
 export type FormSchema = Record<string, FormSchemaField>;
+export type DrawingStats = {
+    overlay: boolean;
+    geolocated: boolean;
+    isCalibrated: boolean;
+    walks: number;
+    markers: number;
+    minimodel: number;
+    bim: number;
+    comments: number;
+    lastCapturedDate: string | null;
+};
 export interface ScrollListener {
     element: Element | Window;
+    event: "scroll" | "resize";
     handler: () => void;
 }
 export interface LeaderLineInstance {
     remove(): void;
     position(): void;
 }
+export type SnapshotCardItem = {
+    label?: string;
+    title?: string;
+    thumbnailUrl: string;
+    placeholderThumbnailUrl?: string;
+    fallbackThumbnailUrl?: string;
+};
+export type HighchartsSeriesWithData<T extends number = number> = SeriesOptionsType & {
+    data: T[];
+};
+export type NotificationTitleSegment = {
+    text: string;
+    isBold?: boolean;
+};
+export type FormattedNotificationData = {
+    title: string;
+    titleSegments?: NotificationTitleSegment[];
+    link: string;
+    thumbnail?: string;
+    icon: string;
+    excerpt?: string;
+    commentTarget?: {
+        commentId: number;
+        dateId: string | number;
+        floorId: string;
+    };
+};
+export type FormattedNotification = FormattedNotificationData & {
+    date: string;
+    read: boolean;
+    id: number;
+    thumbnailError?: boolean;
+};
+export type ProcoreProjectStepData = {
+    project: ProcoreUserProject | null;
+    album: ProcoreProjectAlbum | null;
+    observationType: ProcoreObservationType | null;
+};
+export type ProcoreUploadFormData = {
+    procoreType: ProcoreType;
+    project: ProcoreUserProject | null;
+    album: ProcoreProjectAlbum | null;
+    observationType: ProcoreObservationType | null;
+    observationForm: Record<string, string | number | boolean | null>;
+};
+export type AconexUploadFormData = {
+    project: AconexUserProject | null;
+    form: Record<string, string | number | boolean | null>;
+};
+export type AutodeskUploadFormData = {
+    hub: AutodeskUserHub | null;
+    project: AutodeskProject | null;
+    folder: AutodeskFolder | null;
+};
+export type HammertechUploadFormData = {
+    project: HammertechProject | null;
+    issueType: HammertechIssueType | null;
+    description: string;
+    priority: HammertechPriority | null;
+    dueDate: string | null;
+    classification: HammertechClassification | null;
+    locationId: string | null;
+    isPositiveObservation: boolean;
+    isPhotoForFixRequired: boolean;
+    customFieldFormId: string | null;
+    customFieldValues: Record<string, unknown>;
+    fileCustomFieldValues: Record<string, HammertechFileFieldValue>;
+};
+export interface MediaHubFilters {
+    title: string;
+    requesterEmail: string | undefined;
+    camera: string | undefined;
+    type: string;
+    fromDate: string;
+    toDate: string;
+    sortBy: string;
+}
+export interface MediaHubSortParameter {
+    label: string;
+    value: string;
+}
+export type TableHeaderParams<TItem = unknown> = {
+    value: string;
+    text: string;
+    align?: string;
+    sortable?: boolean;
+    visible?: boolean;
+    width?: number | string;
+    copyable?: boolean;
+    toStringFn?: (item: TItem, key: string) => any;
+    sort?: (a: unknown, b: unknown) => number;
+};
+export type BimUploadObject = IngestUploadInitResponse & {
+    projectName: string;
+};
+export type BimUploadFileResult = {
+    url: string;
+    title: string;
+    fileExtension: string;
+};
+export type CameraCardItem = {
+    thumbnail: string;
+    title: string;
+    exid: string;
+    status: CameraStatus;
+    disabled: boolean;
+    to: string;
+    isOffline: boolean;
+    isWaiting: boolean;
+    isUnderNda: boolean;
+    isAdmin: boolean;
+    batteryVoltage: number | null;
+};
+export type ThreeSixtyGalleryView = "drawings" | "walks";
+export interface ThreeSixtyWalk {
+    id: string;
+    name: string;
+    date: string;
+    monthKey: string;
+    color: string;
+    dateId: string;
+    floorId: string;
+    commentCount: number;
+    hasBim: boolean;
+    hasMinimodel: boolean;
+}
+export interface ThreeSixtyWalkGroup {
+    date: string;
+    walks: ThreeSixtyWalk[];
+}
+export type ThreeSixtyMediaDownloadOption = {
+    type: _360AssetType;
+    title: string;
+    icon: string;
+};
+export type DrawingSelection = {
+    pageNumber: number;
+    size: number;
+    thumbnail: string | null;
+    pageCount: number;
+};
+export type CommentCardComment = {
+    id?: number | string;
+    content?: string;
+    createdAt?: string;
+    archivedAt?: string;
+    creatorName?: string;
+    label?: string;
+    timestamp?: string;
+    cameraExid?: string;
+    position3d?: number[];
+    canDelete?: boolean;
+};

package/dist/shared/types/customDataTableFilters.d.ts

@@ -0,0 +1,10 @@
+export declare enum CustomDataTableFilterType {
+    Select = "SelectSearchFilter",
+    Text = "TextFieldSearchFilter"
+}
+export interface CustomDataTableFilterField<T = unknown> {
+    component: CustomDataTableFilterType;
+    attributes?: Record<string, unknown>;
+    customFilter?: (item: T, fieldName: string, search: unknown) => boolean;
+}
+export type CustomDataTableFilterFields<T = unknown> = Record<string, CustomDataTableFilterField<T>>;

package/dist/shared/types/imagePlayer.d.ts

@@ -1,4 +1,4 @@
-import type { Timestamp } from "@evercam/api/types";
+import type { Timestamp } from "@evercam/shared/types";
 export interface Frame {
     label: string;
     src: string;
@@ -13,7 +13,7 @@ export type EventMarker<T extends {}> = T & {
     label: string;
     thumbnailUrl: string;
     isActive: boolean;
-    cssClass?: Object | string;
+    markerType?: RecordingsMarker;
 };
 export type SnapshotEvent<T extends {}> = T & {
     eventTime: Timestamp;
@@ -22,8 +22,15 @@ export type MatchedSnapshotEvent<T extends {}> = SnapshotEvent<T> & {
     frameIndex: number;
     snapshotTimestamp: Timestamp;
 };
+export declare enum RecordingsMarker {
+    Comment = "comment",
+    GateReport = "gate-report",
+    Anpr = "anpr",
+    Detection = "detection",
+    SmartSearch = "smart-search"
+}
 export declare enum ImageQuality {
-    ThureeSixty = "360",
+    ThreeSixty = "360",
     FourEighty = "480",
     SevenTwenty = "720",
     OneZeroEightZero = "1080",

package/dist/shared/types/index.d.ts

@@ -1,4 +1,7 @@
 export * from "@evercam/api/types";
 export * from "./components";
+export * from "./customDataTableFilters";
 export * from "./imagePlayer";
 export * from "./timeline";
+export * from "./rbac";
+export * from "./observations";

package/dist/shared/types/observations.d.ts

@@ -0,0 +1,25 @@
+export type ObservationsTableHeader = {
+    isThumbnail?: boolean;
+    visible: boolean;
+    divider: boolean;
+    sortable: boolean;
+    text: string;
+    value: string;
+    class: string;
+    align: string;
+};
+export type ObservationsCountDay = {
+    day: string;
+};
+export type ObservationsTableOptionsUpdate = {
+    page: number;
+    sortBy: string[];
+    sortDesc: boolean[];
+};
+export type ObservationsEventsTableState = {
+    height: number | string;
+};
+export type ObservationTypeOption = {
+    value: string;
+    label: string;
+};

package/dist/shared/types/rbac.d.ts

@@ -0,0 +1,67 @@
+import type { ProjectMember, ProjectInvite, ProjectResourceRole } from "@evercam/api/types";
+export type HasRoleChangedFn<T = ProjectMember | ProjectInvite> = (entity: T, baseRole: ProjectResourceRole) => boolean;
+export type ProjectRoleData = {
+    id?: number;
+    name: string;
+    description?: string | null;
+    permissions: string[];
+    subRoles?: Array<{
+        resourceId: string;
+        roleId: number | null;
+    }>;
+};
+export type ProjectResourcePermission = {
+    id: string;
+    name: string;
+    description?: string;
+    requires?: string;
+};
+export type ProjectResource = {
+    id: string;
+    name: string;
+    permissions: ProjectResourcePermission[];
+};
+export type ProjectPermissionWarning = {
+    resourceId: string;
+    message: string;
+    type?: string;
+    cameraExids?: string[];
+    accessLevel?: string;
+    grantAllPermissions?: boolean;
+};
+export type ProjectDisabledPermission = {
+    id: string;
+    reason: string;
+};
+export type CameraAccessFilters = {
+    memberName: string;
+    memberEmail: string;
+    cameraName: string;
+};
+export type CameraAccessLevelConfig = {
+    id: string;
+    name: string;
+    description: string;
+    permissions: string[];
+};
+export declare enum CameraStatusGroup {
+    Active = "active",
+    Pending = "pending",
+    Archived = "archived"
+}
+export type CameraStatusGroupConfig = {
+    text: string;
+    icon: string;
+    color: string;
+};
+export type CameraFeatureIconConfig = {
+    icon: string;
+    tooltip: string;
+};
+export type RecipientRule = {
+    blocked: string[];
+};
+export type RecipientRules = {
+    notExistingRecipients?: RecipientRule;
+    notPendingInviteRecipients?: RecipientRule;
+};

package/dist/shared/types/timeline.d.ts

@@ -1,4 +1,4 @@
-import { TimelineGroupId, type TimelinePlayerGroupConfig } from "@evercam/shared/types/components";
+import { TimelineGroupId, type TimelinePlayerGroupConfig } from "./components";
 export interface TimelineGroup {
     id: TimelineGroupId;
     timelineConfig: TimelinePlayerGroupConfig | Record<string, TimelinePlayerGroupConfig>;
@@ -6,4 +6,5 @@ export interface TimelineGroup {
     isDisabled: boolean;
     isRestricted?: boolean;
     hasMultipleGroups?: boolean;
+    isPersistent?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evercam/api",
-  "version": "1.0.0-5ccefe067",
+  "version": "1.0.0-5d2895b13",
   "description": "Evercam API client",
   "repository": {
     "type": "git",
@@ -24,10 +24,12 @@
     "dist"
   ],
   "engines": {
-    "node": "20.x"
+    "node": ">=22"
   },
   "readme": "README.md",
   "scripts": {
+    "preinstall": "node ../shared/ci-scripts/check-bootstrap.js",
+    "bootstrap": "node ../shared/ci-scripts/bootstrap.js",
     "clean": "rimraf dist",
     "typecheck": "tsc --noEmit",
     "build:types": "tsc --declaration --emitDeclarationOnly",
@@ -36,7 +38,7 @@
     "publish-api": "cd ../.. && yarn publish-api"
   },
   "devDependencies": {
-    "@types/node": "^24.3.1",
+    "@types/node": "^25.9.1",
     "vite": "latest",
     "vite-plugin-commonjs": "^0.10.3",
     "vite-plugin-dts": "^4.5.4"
@@ -47,4 +49,4 @@
     "idb-keyval": "^6.2.2",
     "moment-timezone": "^0.5.46"
   }
-}
+}