@smarterplan/ngx-smarterplan-core 1.4.11 → 1.4.12

package/lib/services/matterport-navigation.service.d.ts

@@ -57,6 +57,31 @@ export declare class MatterportNavigationService {
      * Disable forbidden sweeps. Resolves each sweep ID to sid before calling SDK.
      */
     removeForbiddenSweeps(sdk: any, forbiddenSweeps: string[]): Promise<void>;
+    /**
+     * Move to a position
+     * @param sdk
+     * @param position
+     * @param rotation
+     * @param options
+     */
+    move_to_position(sdk: any, position: {
+        x: number;
+        y: number;
+        z: number;
+    }, rotation: {
+        yaw: number;
+        pitch?: number;
+        roll?: number;
+    } | null, options?: {
+        transition?: 'FLY' | 'INSTANT' | 'IMMEDIATE';
+        durationMs?: number;
+        anglesInDegrees?: boolean;
+        offset?: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    }): Promise<void>;
     /**
      * Returns the current sweep as a **uuid** (for database matching).
      * The SDK's poseCamera.sweep is a sid; we translate it.

package/lib/services/matterport-tag-copy.service.d.ts

@@ -0,0 +1,129 @@
+import { BehaviorSubject } from 'rxjs';
+import { TranslateService } from '@ngx-translate/core';
+import { NavigationService } from './models/navigation.service';
+import { PoiService } from './models/poi.service';
+import { TicketsService } from './models/ticket.service';
+import { EquipmentService } from './models/equipment.service';
+import { Object3DService } from './models/object3D.service';
+import { FeatureService } from './models/feature.service';
+import { MeasurementService } from './models/measurement.service';
+import { CommentService } from './models/comment.service';
+import { BaseUserService } from './user.service';
+import { Vec3 } from './utils/matterport-transform.util';
+import * as i0 from "@angular/core";
+/** Progress snapshot emitted during copyTagsFromVisit(), so the UI can show a live status. */
+export interface CopyProgress {
+    phase: 'collecting' | 'tickets' | 'equipments' | 'pois' | 'objects3d' | 'features' | 'measurements' | 'done';
+    processedInPhase: number;
+    totalInPhase: number;
+    processedOverall: number;
+    totalOverall: number;
+    percent: number;
+    errorCount: number;
+}
+/** A single line in the copy log — either a step status (updated in place) or an error (appended once). */
+export interface CopyLogEntry {
+    id: string;
+    type: 'step' | 'error';
+    text: string;
+}
+export declare class MatterportTagCopyService {
+    private navigationService;
+    private userService;
+    private poiService;
+    private ticketService;
+    private equipmentService;
+    private object3DService;
+    private featureService;
+    private measurementService;
+    private commentService;
+    private translate;
+    copyProgress$: BehaviorSubject<CopyProgress | null>;
+    copyLog$: BehaviorSubject<CopyLogEntry[]>;
+    private spModule;
+    private log;
+    private errorSeq;
+    constructor(navigationService: NavigationService, userService: BaseUserService, poiService: PoiService, ticketService: TicketsService, equipmentService: EquipmentService, object3DService: Object3DService, featureService: FeatureService, measurementService: MeasurementService, commentService: CommentService, translate: TranslateService);
+    copyTagsFromVisit(sourceSpaceId: string, targetSpaceId: string, landmarkSourceA: Vec3, landmarkTargetA: Vec3, landmarkSourceB: Vec3, landmarkTargetB: Vec3): Promise<boolean>;
+    /** Adds or updates a step line (identified by stepId) with new text, then republishes the log. */
+    private setStepLog;
+    /** Appends a new, permanent log line (never overwritten), then republishes the log. */
+    private appendErrorLog;
+    /** Resets the log for a new run. */
+    private resetLog;
+    /** Builds and sets a step's log line as "<translated label>: <percent>%", no step numbering. */
+    private setStepProgress;
+    /** Logs a translated, parameterized error line for a single failed item. */
+    private logItemError;
+    /** Logs an item-level error, using a specific "missing file / orphaned reference"
+     *  translation key when the cause is a MissingS3FileError, and the generic per-type
+     *  key otherwise. Keeps the copy log readable: a missing file is not a bug to
+     *  investigate the same way a network/permission error is. */
+    private logCopyItemError;
+    /**
+     * Heuristic duplicate-detection: compares title AND description together instead of
+     * title alone, to reduce false positives when several source items happen to share
+     * the same title. Not a perfect guarantee, but meaningfully more robust.
+     */
+    private matchesExisting;
+    /**
+     * Fetches the position of every sweep in a space and returns it as a Map for O(1) lookup.
+     * Uses allSettled so a single failing sweep lookup doesn't abort the whole map —
+     * that sweep is simply absent from the resulting map (and skipped later).
+     */
+    private buildNavigationPositionMap;
+    /** Applies the rigid transform to a POI coordinate (position + orientation). */
+    private getAdjustedCoordinates;
+    /**
+     * Applies the rigid transform's translation+rotation to a plain {x,y,z} position,
+     * WITHOUT adding xRotation/yRotation keys. Used for measurements, whose stored
+     * coordinate is a bare position (no orientation), unlike other POI types.
+     */
+    private getAdjustedPositionOnly;
+    /**
+     * Finds the closest target sweep, comparing positions in the SAME coordinate frame.
+     * Pure in-memory lookup — no network call, thanks to the pre-built position maps.
+     */
+    private findClosestTargetSweepId;
+    /** Generates a short random id, used to give each copied S3 file a fresh, collision-safe key. */
+    private generateShortId;
+    /**
+     * Builds a new S3 key for a copied attachment and sanitizes the filename
+     * to prevent AWS Amplify SignatureDoesNotMatch errors.
+     */
+    private buildCopiedAttachmentKey;
+    /**
+     * Duplicates an S3 object if a key is present.
+     * - If the source file is genuinely missing from S3 (NoSuchKey / orphaned DB reference),
+     *   throws a MissingS3FileError so the caller can log a clear, specific message and
+     *   skip the whole item entirely, rather than creating a record with a broken file link.
+     * - Any other kind of failure (permissions, network, etc.) still throws a generic Error.
+     */
+    private copyS3KeyIfPresent;
+    /**
+     * Duplicates the file referenced by a POI's tagIcon (a JSON string shaped like
+     * { src, opacity }, per form-feature.component.ts). If the JSON can't be parsed or
+     * has no `src`, the value is returned unchanged rather than risk corrupting it.
+     */
+    private duplicateTagIcon;
+    /**
+     * Duplicates tagImageID if it looks like a reference to a file (contains a path
+     * separator, whether raw key or pre-signed URL). UNCONFIRMED ASSUMPTION: this
+     * field's exact semantics weren't verified — if it's actually an opaque reference
+     * to another DB record rather than a file, this heuristic may incorrectly attempt
+     * a copy. Confirm the real structure to tighten this if it causes issues.
+     */
+    private duplicateTagImageID;
+    /**
+     * Extracts and normalizes the raw S3 key from a stored value (which may be a full URL
+     * or already a raw key).
+     * IMPORTANT: this must return the RAW (decoded, non URL-encoded) key. Amplify's
+     * Storage.copy() already builds and encodes the 'x-amz-copy-source' header internally
+     * from the key we give it. Pre-encoding it here caused a double-encoding bug (e.g. a
+     * space became "%2520" instead of "%20"), so Storage.copy() looked for a key that never
+     * existed on S3, resulting in a NoSuchKey error.
+     */
+    private extractS3KeyFromValue;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatterportTagCopyService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatterportTagCopyService>;
+}

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

@@ -190,6 +190,31 @@ export declare class MatterportService {
     goToLastTag(): Promise<void>;
     /** Navigates the camera to a specific Mattertag by its ID. */
     goToTag(mattertagID: string): Promise<void>;
+    /**
+     * Move the viewer camera to a specific 3D position and apply a rotation.
+     * Delegates the heavy lifting to MatterportNavigationService.move_to_position.
+     * - position: { x, y, z }
+     * - rotation: { yaw, pitch?, roll? } in degrees by default
+     * - options: optional transition and conversion settings (see navigation service)
+     */
+    goToPosition(position: {
+        x: number;
+        y: number;
+        z: number;
+    }, rotation?: {
+        yaw: number;
+        pitch?: number;
+        roll?: number;
+    } | null, options?: {
+        transition?: 'FLY' | 'INSTANT' | 'IMMEDIATE';
+        durationMs?: number;
+        anglesInDegrees?: boolean;
+        offset?: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    }): Promise<void>;
     /**
       * Computes the context-aware opacity for a single tag at the moment it is rendered.
       * - Cursor tag: always use provided defaultOpacity.

package/lib/services/models/equipment.service.d.ts

@@ -63,6 +63,14 @@ export declare class EquipmentService extends BaseObjectService {
         nextToken: string | null;
     }>;
     uploadImageForAllEquipments(equipments: Equipment[], imageFile: File): Promise<Equipment[]>;
+    /**
+     * Creates a Note attached to an equipment from an S3 key that ALREADY exists
+     * (as opposed to uploadDoc/uploadImage, which upload a fresh browser File).
+     * Used when duplicating equipment attachments during a cross-visit copy: the
+     * S3 object itself has already been physically copied by the caller beforehand,
+     * so this only needs to record the Note pointing at that new key.
+     */
+    createNoteWithExistingAttachment(equipmentID: string, attachmentKey: string, type: TypeNote, ownerMissionID: string | null): Promise<Note>;
     uploadImage(equipment: Equipment, imageFile: File): Promise<Note>;
     updateEquipment(equip: any, file?: File, noteType?: TypeNote): Promise<Equipment>;
     getPrefixDoc(type: TypeNote): any;

package/lib/services/models/poi.service.d.ts

@@ -19,6 +19,20 @@ export declare class PoiService {
     updatePoi(poi: {}): Promise<POI>;
     deletePoi(poiID: string): Promise<POI>;
     getPoisByMatterportSweepByType(sweep: string, type: PoiType): Promise<POI[]>;
+    /**
+    * Optimized version: fetches POIs for MANY sweeps in as few GraphQL calls as possible,
+    * using an `or: [{ matterportSweepID: { eq } }, ...]` filter instead of looping one
+    * request per sweep. This is a DynamoDB Scan with a server-side filter (not a GSI
+    * hash-key query), so `or` composition works and collapses N sweep-by-sweep calls
+    * into a handful of paginated calls total.
+    *
+    * NOTE: `in` is NOT supported on this schema's ModelStringInput (older Amplify codegen),
+    * hence the `or` composition instead — functionally equivalent for this use case.
+    *
+    * Chunked because DynamoDB/AppSync filter expressions have a practical size ceiling —
+    * splitting keeps each request well within safe limits regardless of space size.
+    */
+    getPoisByMatterportSweeps(sweeps: string[]): Promise<POI[]>;
     unsubscribe(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoiService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<PoiService>;

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

@@ -12,3 +12,11 @@ export declare const getSignedFile: (path: any) => Promise<string | null>;
 export declare const downloadFileAsObject: (path: any) => Promise<Object | void>;
 export declare const getBufferForFileFromS3: (path: any) => Promise<ArrayBuffer>;
 export declare const uploadJsonToS3: (path: string, json: string, filename: string) => Promise<string>;
+/**
+ * Physically duplicates an S3 object to a new key. Used when copying attachments
+ * between features/tickets/etc. so the copy is fully independent: deleting the
+ * original file later must not affect the copy.
+ * IMPORTANT: does NOT swallow errors — callers need the real error (e.g. NoSuchKey)
+ * to distinguish an orphaned DB reference from a genuine copy failure.
+ */
+export declare const copyFileInS3: (sourceKey: string, destKey: string) => Promise<string>;

package/lib/services/utils/matterport-transform.util.d.ts

@@ -0,0 +1,21 @@
+export interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface RigidTransform {
+    rotationYRad: number;
+    refSource: Vec3;
+    refTarget: Vec3;
+}
+/**
+ * Computes the rigid transform (Y-axis rotation + translation) between two
+ * coordinate frames, from 2 pairs of points representing the same physical spot.
+ */
+export declare function computeRigidTransform(sourceA: Vec3, targetA: Vec3, sourceB: Vec3, targetB: Vec3): RigidTransform;
+/** Applies the rigid transform to a 3D position (x, y, z). */
+export declare function applyRigidTransformToPoint(p: Vec3, t: RigidTransform): Vec3;
+/** Applies the Y rotation (in degrees) to an orientation angle (a pose's yRotation). */
+export declare function applyRigidTransformToYRotationDeg(yRotationDeg: number, t: RigidTransform): number;
+/** Euclidean distance between two points, useful to validate landmark quality. */
+export declare function distance(a: Vec3, b: Vec3): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smarterplan/ngx-smarterplan-core",
-  "version": "1.4.11",
+  "version": "1.4.12",
   "dependencies": {
     "tslib": "^2.5.0"
   },

package/public-api.d.ts

@@ -18,7 +18,9 @@ export * from './lib/services/filter.service';
 export * from './lib/services/search.service';
 export * from './lib/services/zone-drawer.service';
 export * from './lib/services/matterport-import.service';
+export * from './lib/services/matterport-tag-copy.service';
 export * from './lib/mattertagData';
+export * from './lib/services/utils/matterport-transform.util';
 export * from './lib/services/models/profile.service';
 export * from './lib/services/models/zone.service';
 export * from './lib/services/models/mission.service';