@deepcitation/deepcitation-js 1.0.6 → 1.0.7

package/lib/client/DeepCitation.d.ts

@@ -28,13 +28,6 @@ import type { CitationInput, ConvertFileInput, ConvertFileResponse, DeepCitation
 export declare class DeepCitation {
     private readonly apiKey;
     private readonly apiUrl;
-    /**
-     * Stores mapping of user-provided fileId to internal attachmentId
-     * This allows users to reference files by their own IDs
-     */
-    private fileIdMap;
-    /** Store file mapping and return public response */
-    private storeAndReturnResponse;
     /**
      * Create a new DeepCitation client instance.
      *
@@ -190,17 +183,4 @@ export declare class DeepCitation {
     verifyCitationsFromLlmOutput(input: VerifyCitationsFromLlmOutput, citations?: {
         [key: string]: Citation;
     }): Promise<VerifyCitationsResponse>;
-    /**
-     * Register a file that was uploaded separately (e.g., via direct API call).
-     * This allows you to use verifyCitations with files not uploaded via uploadFile().
-     *
-     * @param fileId - Your file ID
-     * @param attachmentId - The internal attachment ID
-     */
-    registerFile(fileId: string, attachmentId: string): void;
-    /**
-     * Clear the internal file ID mapping.
-     * Useful for cleanup or when working with many files.
-     */
-    clearFileMap(): void;
 }

package/lib/client/DeepCitation.js

@@ -18,7 +18,8 @@ function toBlob(file, filename) {
 /** Extract error message from API response */
 async function extractErrorMessage(response, fallbackAction) {
     const error = await response.json().catch(() => ({}));
-    return error?.error?.message || `${fallbackAction} failed with status ${response.status}`;
+    return (error?.error?.message ||
+        `${fallbackAction} failed with status ${response.status}`);
 }
 /**
  * DeepCitation client for file upload and citation verification.
@@ -48,17 +49,6 @@ async function extractErrorMessage(response, fallbackAction) {
 export class DeepCitation {
     apiKey;
     apiUrl;
-    /**
-     * Stores mapping of user-provided fileId to internal attachmentId
-     * This allows users to reference files by their own IDs
-     */
-    fileIdMap = new Map();
-    /** Store file mapping and return public response */
-    storeAndReturnResponse(apiResponse) {
-        this.fileIdMap.set(apiResponse.fileId, { attachmentId: apiResponse.attachmentId });
-        const { attachmentId: _, ...publicResponse } = apiResponse;
-        return publicResponse;
-    }
     /**
      * Create a new DeepCitation client instance.
      *
@@ -111,7 +101,7 @@ export class DeepCitation {
         if (!response.ok) {
             throw new Error(await extractErrorMessage(response, "Upload"));
         }
-        return this.storeAndReturnResponse(await response.json());
+        return (await response.json());
     }
     /**
      * Convert a URL or Office file to PDF for citation verification.
@@ -179,10 +169,7 @@ export class DeepCitation {
         if (!response.ok) {
             throw new Error(await extractErrorMessage(response, "Conversion"));
         }
-        const apiResponse = (await response.json());
-        this.fileIdMap.set(apiResponse.fileId, { attachmentId: apiResponse.attachmentId });
-        const { attachmentId: _, ...publicResponse } = apiResponse;
-        return publicResponse;
+        return (await response.json());
     }
     /**
      * Prepare a previously converted file for citation verification.
@@ -205,10 +192,6 @@ export class DeepCitation {
      * ```
      */
     async prepareConvertedFile(options) {
-        const fileInfo = this.fileIdMap.get(options.fileId);
-        if (!fileInfo) {
-            throw new Error(`File ID "${options.fileId}" not found. Make sure to call convertToPdf() first.`);
-        }
         const response = await fetch(`${this.apiUrl}/prepareFile`, {
             method: "POST",
             headers: {
@@ -216,14 +199,13 @@ export class DeepCitation {
                 "Content-Type": "application/json",
             },
             body: JSON.stringify({
-                attachmentId: fileInfo.attachmentId,
                 fileId: options.fileId,
             }),
         });
         if (!response.ok) {
             throw new Error(await extractErrorMessage(response, "Prepare"));
         }
-        return this.storeAndReturnResponse(await response.json());
+        return (await response.json());
     }
     /**
      * Upload multiple files for citation verification and get structured content.
@@ -286,11 +268,6 @@ export class DeepCitation {
      * ```
      */
     async verifyCitations(fileId, citations, options) {
-        // Look up the internal IDs from our map
-        const fileInfo = this.fileIdMap.get(fileId);
-        if (!fileInfo) {
-            throw new Error(`File ID "${fileId}" not found. Make sure to upload the file first with uploadFile().`);
-        }
         // Normalize citations to a map with citation keys
         const citationMap = {};
         if (Array.isArray(citations)) {
@@ -315,24 +292,27 @@ export class DeepCitation {
         else {
             throw new Error("Invalid citations format");
         }
-        const response = await fetch(`${this.apiUrl}/verifyCitation`, {
+        const requestUrl = `${this.apiUrl}/verifyCitations`;
+        const requestBody = {
+            data: {
+                fileId,
+                citations: citationMap,
+                outputImageFormat: options?.outputImageFormat || "avif",
+            },
+        };
+        const response = await fetch(requestUrl, {
             method: "POST",
             headers: {
                 Authorization: `Bearer ${this.apiKey}`,
                 "Content-Type": "application/json",
             },
-            body: JSON.stringify({
-                data: {
-                    attachmentId: fileInfo.attachmentId,
-                    citations: citationMap,
-                    outputImageFormat: options?.outputImageFormat || "avif",
-                },
-            }),
+            body: JSON.stringify(requestBody),
         });
         if (!response.ok) {
             throw new Error(await extractErrorMessage(response, "Verification"));
         }
-        return (await response.json());
+        const result = (await response.json());
+        return result;
     }
     /**
      * Verify citations from LLM output with automatic parsing.
@@ -362,9 +342,6 @@ export class DeepCitation {
         if (Object.keys(citations).length === 0) {
             return { foundHighlights: {} };
         }
-        // Note: fileDataParts is now only used to identify which files to verify
-        // The mapping from fileId to attachmentId must be registered via uploadFile() or prepareFiles()
-        // in the same session. For Zero Data Retention scenarios, use verifyCitations() directly.
         // Group citations by fileId
         const citationsByFile = new Map();
         for (const [key, citation] of Object.entries(citations)) {
@@ -374,10 +351,10 @@ export class DeepCitation {
             }
             citationsByFile.get(fileId)[key] = citation;
         }
-        // Filter to only registered files and verify in parallel
+        // Verify all files in parallel
         const verificationPromises = [];
         for (const [fileId, fileCitations] of citationsByFile) {
-            if (this.fileIdMap.has(fileId)) {
+            if (fileId) {
                 verificationPromises.push(this.verifyCitations(fileId, fileCitations, { outputImageFormat }));
             }
         }
@@ -388,21 +365,4 @@ export class DeepCitation {
         }
         return { foundHighlights: allHighlights };
     }
-    /**
-     * Register a file that was uploaded separately (e.g., via direct API call).
-     * This allows you to use verifyCitations with files not uploaded via uploadFile().
-     *
-     * @param fileId - Your file ID
-     * @param attachmentId - The internal attachment ID
-     */
-    registerFile(fileId, attachmentId) {
-        this.fileIdMap.set(fileId, { attachmentId });
-    }
-    /**
-     * Clear the internal file ID mapping.
-     * Useful for cleanup or when working with many files.
-     */
-    clearFileMap() {
-        this.fileIdMap.clear();
-    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@deepcitation/deepcitation-js",
-    "version": "1.0.6",
+    "version": "1.0.7",
     "description": "DeepCitation JavaScript SDK for deterministic AI citation verification",
     "type": "module",
     "private": false,