@naniteninja/profile-comparison-lib 1.0.3 → 1.0.4

package/index.d.ts

@@ -1,11 +1,39 @@
 import * as i0 from '@angular/core';
 import { InjectionToken, OnInit, AfterViewInit, OnChanges, EventEmitter, ElementRef, Renderer2, ChangeDetectorRef, SimpleChanges } from '@angular/core';
 import { Observable, BehaviorSubject } from 'rxjs';
+import * as i2 from '@angular/common';
 import * as i3 from '@angular/common/http';
 import { HttpClient } from '@angular/common/http';
-import * as i2 from '@angular/common';
 import * as i4 from '@angular/forms';
 
+/** Backend mode for the profile comparison component. */
+declare enum BackendMode {
+    /** Use the real deployed backend (default). */
+    Real = 0,
+    /** Use a local mock server at localhost:3000. */
+    Mock = 1
+}
+declare const BACKEND_MODE_URLS: Record<BackendMode, string>;
+/** Either a static base URL or a getter that returns the current base URL (for runtime toggle). */
+type ProfileComparisonApiBaseUrl = string | (() => string | null);
+/**
+ * Legacy injection token for the backend base URL.
+ * Prefer using the [backendMode] or [backendUrl] @Input on the component instead.
+ * Kept for backward compatibility — lowest priority when resolving the URL.
+ */
+declare const PROFILE_COMPARISON_API_BASE_URL: InjectionToken<ProfileComparisonApiBaseUrl | null>;
+/** Optional getter: when true, lib and backend service log steps to console for diagnosis. */
+declare const PROFILE_COMPARISON_VERBOSE_LOGGING: InjectionToken<() => boolean>;
+/**
+ * Resolves the active backend URL from inputs, with fallback to injection token.
+ *
+ * Priority:
+ * 1. Explicit backendUrl (custom URL string)
+ * 2. BackendMode enum (Real or Mock)
+ * 3. Legacy PROFILE_COMPARISON_API_BASE_URL token
+ */
+declare function resolveBackendUrl(backendUrl: string | null | undefined, backendMode: BackendMode, legacyTokenUrl: string | null | undefined): string | null;
+
 interface IProfileConfig {
     person1Interests: string[];
     person2Interests: string[];
@@ -204,53 +232,6 @@ declare class CachePersistenceService {
     static ɵprov: i0.ɵɵInjectableDeclaration<CachePersistenceService>;
 }
 
-declare class EmbeddingService {
-    private model$;
-    getEmbedding(text: string): Observable<Float32Array>;
-    /**
-     * Group-align two lists based on semantic similarity, allowing one-to-many relationships.
-     *
-     * Design goals:
-     * - Semantic relevance takes priority over original order or spacing.
-     * - Each term in listB is assigned to the single most similar anchor in listA (if above threshold).
-     * - For an anchor in listA with multiple highly related listB terms, they are emitted as consecutive rows:
-     *   [A, B1], ['-', B2], ['-', B3], ... so they render adjacently and remain visually connected.
-     * - Low-similarity/unassigned terms from either side are appended at the end and never break groups.
-     */
-    groupAlignLists(listA: string[], listB: string[], threshold?: number, preserveLeftOrder?: boolean, exclusivityMargin?: number, leftCohesion?: number): Observable<IAlignmentRow[]>;
-    cosineSimilarity(a: Float32Array, b: Float32Array): number;
-    /**
-     * Align words in listA with their most semantically similar words in listB
-     *
-     * Algorithm:
-     * 1. Generate embeddings for all words in both lists using Universal Sentence Encoder
-     * 2. For each word in listA, compare its embedding with all words in listB
-     * 3. Find the word in listB with highest cosine similarity score
-     * 4. Return alignment results with similarity scores
-     *
-     * @param listA - Source list of words to align
-     * @param listB - Target list of words to find matches in
-     * @returns Observable of alignment results with word, alignedWith, score, and index
-     */
-    alignLists(listA: string[], listB: string[]): Observable<IWordAlignment[]>;
-    /**
-     * Find best matching pairs between two lists above a similarity threshold
-     *
-     * @param listA - Source list of words
-     * @param listB - Target list of words to match against
-     * @param threshold - Minimum similarity score (0-1, default: 0.15)
-     * @returns Observable of word pairs with similarity scores
-     */
-    findBestMatchingPairs(listA: string[], listB: string[], threshold?: number): Observable<IWordPair[]>;
-    calculateSimilarity(primaryText: string, comparisonText: string): Observable<number>;
-    testWordSimilarity(word1: string, word2: string): Observable<void>;
-    private domainCompatibilityCap;
-    private computeLexicalBoost;
-    private loadModel;
-    static ɵfac: i0.ɵɵFactoryDeclaration<EmbeddingService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<EmbeddingService>;
-}
-
 declare class FileConversionService {
     private static readonly MIME_TYPE_JPEG;
     private static readonly MIME_TYPE_PNG;
@@ -281,18 +262,6 @@ declare class ImageCompressionService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ImageCompressionService>;
 }
 
-/** Either a static base URL or a getter that returns the current base URL (for runtime toggle). */
-type ProfileComparisonApiBaseUrl = string | (() => string | null);
-/**
- * When provided, ProfileService and OpenAIEmbeddingService call this backend base URL
- * (e.g. 'http://localhost:3000/api') for all profile/embedding endpoints instead of
- * calling external APIs directly with keys. Can be a string or a getter function for runtime toggle.
- * When not provided or getter returns null, the lib uses the direct path with keys.
- */
-declare const PROFILE_COMPARISON_API_BASE_URL: InjectionToken<ProfileComparisonApiBaseUrl | null>;
-/** Optional getter: when true, lib and backend service log steps to console for diagnosis. */
-declare const PROFILE_COMPARISON_VERBOSE_LOGGING: InjectionToken<() => boolean>;
-
 /**
  * OpenAI Alignment Service
  * Uses OpenAI Chat Completions API to align two lists of text in a single request.
@@ -417,12 +386,16 @@ declare class ProfileService {
 declare class ProfileComparisonBackendService {
     private http;
     private apiBaseUrl;
-    private getVerboseLogging?;
-    constructor(http: HttpClient, apiBaseUrl: ProfileComparisonApiBaseUrl | null, getVerboseLogging?: (() => boolean) | undefined);
+    private getVerboseLogging;
+    constructor();
+    static extractErrorMessage(err: unknown): string;
     private log;
+    /** Returns the legacy token URL (for backward compat fallback). */
+    getLegacyTokenUrl(): string | null;
+    /** @deprecated Use getLegacyTokenUrl(). Kept for backward compat. */
     getBaseUrl(): string | null;
-    getComparison(config: IProfileConfig): Observable<IComparisonPayload>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ProfileComparisonBackendService, [null, { optional: true; }, { optional: true; }]>;
+    getComparison(config: IProfileConfig, baseUrl?: string | null): Observable<IComparisonPayload>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ProfileComparisonBackendService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ProfileComparisonBackendService>;
 }
 
@@ -465,6 +438,8 @@ declare class ProfileComparisonLibComponent implements OnInit, AfterViewInit, On
     private static readonly TRANSFORM_RESET;
     private static readonly TRANSITION_RESET_DELAY_MS;
     config: IProfileConfig;
+    backendMode: BackendMode;
+    backendUrl: string | null;
     fadeAllEdges: boolean;
     matrixDataChange: EventEmitter<IMatrixData>;
     rawLLMOutputChange: EventEmitter<string>;
@@ -522,6 +497,8 @@ declare class ProfileComparisonLibComponent implements OnInit, AfterViewInit, On
     matrixData: IMatrixData | null;
     /** When false, backend URL is not provided — show "Configure backend". */
     backendConfigured: boolean;
+    /** The resolved backend URL computed from inputs and legacy token. */
+    private resolvedBackendUrl;
     compressionConfig: IImageCompressionConfig;
     private computeSub?;
     /** Incremented on each fetchComparison(); used to ignore stale success/error from an older request. */
@@ -582,7 +559,7 @@ declare class ProfileComparisonLibComponent implements OnInit, AfterViewInit, On
     applyDefaultAlignment(): void;
     isValidFaceData(face: IBoundingBox): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<ProfileComparisonLibComponent, [null, null, null, null, null, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ProfileComparisonLibComponent, "lib-profile-comparison", never, { "config": { "alias": "config"; "required": false; }; "fadeAllEdges": { "alias": "fadeAllEdges"; "required": false; }; }, { "matrixDataChange": "matrixDataChange"; "rawLLMOutputChange": "rawLLMOutputChange"; "viewProfileClick": "viewProfileClick"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ProfileComparisonLibComponent, "lib-profile-comparison", never, { "config": { "alias": "config"; "required": false; }; "backendMode": { "alias": "backendMode"; "required": false; }; "backendUrl": { "alias": "backendUrl"; "required": false; }; "fadeAllEdges": { "alias": "fadeAllEdges"; "required": false; }; }, { "matrixDataChange": "matrixDataChange"; "rawLLMOutputChange": "rawLLMOutputChange"; "viewProfileClick": "viewProfileClick"; }, never, never, false, never>;
 }
 
 declare class ProfileComparisonLibModule {
@@ -591,5 +568,5 @@ declare class ProfileComparisonLibModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<ProfileComparisonLibModule>;
 }
 
-export { CachePersistenceService, EmbeddingService, FileConversionService, ImageCompressionService, OpenAIEmbeddingService, PROFILE_COMPARISON_API_BASE_URL, PROFILE_COMPARISON_VERBOSE_LOGGING, ProfileComparisonBackendService, ProfileComparisonLibComponent, ProfileComparisonLibModule, ProfileComparisonLibService, ProfileService };
+export { BACKEND_MODE_URLS, BackendMode, CachePersistenceService, FileConversionService, ImageCompressionService, OpenAIEmbeddingService, PROFILE_COMPARISON_API_BASE_URL, PROFILE_COMPARISON_VERBOSE_LOGGING, ProfileComparisonBackendService, ProfileComparisonLibComponent, ProfileComparisonLibModule, ProfileComparisonLibService, ProfileService, resolveBackendUrl };
 export type { CacheStoreName, FaceDetectionData, FaceDetectionResponse, FileInputEvent, IAlignmentRow, IBoundingBox, IComparisonPayload, IComparisonResult, IEnvironment, IFaceBoxWithLandmarks, IFaceDetectionResult, IFaceLandmarks, IFacePlusPlusFace, IFacePlusPlusResponse, IFaceRectangle, IImageCompressionConfig, IMatrixData, IMatrixLegendItem, IMatrixRow, IOpenAIEmbeddingItem, IOpenAIResponse, IPoint, IProfileConfig, ISimilarityResponse, ISimilarityThreshold, IWordAlignment, IWordPair };

package/package.json

@@ -1,14 +1,12 @@
 {
   "name": "@naniteninja/profile-comparison-lib",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0"
   },
   "dependencies": {
-    "tslib": "^2.3.0",
-    "@tensorflow-models/universal-sentence-encoder": "^1.3.3",
-    "@tensorflow/tfjs": "^4.22.0"
+    "tslib": "^2.3.0"
   },
   "module": "fesm2022/naniteninja-profile-comparison-lib.mjs",
   "typings": "index.d.ts",