@docmana/sdk 0.36.0-hitl.2 → 0.37.0

package/dist/errors.d.ts

@@ -1,16 +1,28 @@
 import type { DocmanaExecutionResult } from "./models/docmana-execution-result.model.js";
 import type { FraudDetectionError, FraudDetectionResult } from "./types.js";
+/** Whitelisted metadata returned by Consumer Edge for a review HTTP 409. */
+export interface ReviewConflictDetails {
+    currentVersion?: number | null;
+    decidedBy?: {
+        id?: string;
+        name?: string;
+        source?: "integrator" | "token";
+    } | null;
+    decidedAt?: string | null;
+    /** @deprecated Use currentVersion. Retained for existing SDK consumers. */
+    version: number | null;
+    /** @deprecated Use decidedBy. Retained for existing SDK consumers. */
+    submittedBy: string | null;
+    /** @deprecated Use decidedAt. Retained for existing SDK consumers. */
+    submittedAt: string | null;
+}
 export declare class DocmanaError extends Error {
     readonly status?: number;
     readonly requestId?: string;
     readonly code: string;
     /** Public API business code; `code` retains the SDK's existing error category. */
     readonly apiCode?: string;
-    readonly reviewConflict?: {
-        version: number | null;
-        submittedBy: string | null;
-        submittedAt: string | null;
-    };
+    readonly reviewConflict?: ReviewConflictDetails;
     constructor(message: string, opts?: {
         status?: number;
         requestId?: string;

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { Docmana } from "./client.js";
 export { REVIEW_EVENT_TYPES, parseReviewEventCallback, verifyReviewEventCallback, ReviewEventVerificationError, } from "./review-events.js";
 export type { ReviewEventCallback, ReviewEventType } from "./review-events.js";
 export { FormulaAuthoring } from "./authoring.js";
+export type { ReviewConflictDetails } from "./errors.js";
 export type { AuthoringDocumentTrialNode, AuthoringDocumentTrialSpec, AuthoringDocumentTrialReport, AuthoringSource, AuthoringGitPublication, AuthoringGitProjection, AuthoringPublication, AuthoringConversation, AuthoringConversationInput, AuthoringConversationContext, AuthoringConversationTurn, AuthoringData, AuthoringNode, AuthoringEdge, AuthoringRevisions, AuthoringFlowSummary, AuthoringSnapshot, AuthoringChanges, AuthoringDraft, AuthoringCreate, AuthoringReceipt, AuthoringOptions, AuthoringEditorCatalog, AuthoringPageOptions, } from "./authoring.js";
 export { DocmanaError, DocmanaAuthError, DocmanaRequestError, DocmanaPayloadTooLargeError, DocmanaPermissionError, DocmanaNotFoundError, DocmanaExecutionError, DocmanaFraudDetectionError, DocmanaTimeoutError, DocmanaAbortError, DocmanaServiceUnavailableError, } from "./errors.js";
 export type { AccessibleOrganization, DownloadedOrganizationDocument, DocmanaConfig, FlowDefinition, FlowDefinitionField, FlowDefinitionNode, FlowDefinitionNodeMetadata, FlowDocumentRequirement, FlowListItem, FlowMetadata, FraudDetectionAccepted, FraudDetectionAsyncOptions, FraudDetectionBaseParams, FraudDetectionError, FraudDetectionFileParams, FraudDetectionOptions, FraudDetectionParams, FraudDetectionProcessor, FraudDetectionResult, FraudDetectionStatus, FraudDetectionStatusResult, FraudDetectionSummary, FraudDetectionUrlParams, FraudDetectionVerdict, FraudFinding, FraudFindingLocation, FraudFindingSeverity, FraudSeverityCounts, OrganizationDocument, OrganizationDocumentsPayload, PartialExecutionFlowVersion, PartialExecutionMetadata, PartialExecutionScope, RunFlowAsyncParams, RunFlowAsyncOptions, RunFlowOptions, RunFlowParams, RunPartialFlowAsyncParams, RunPartialFlowOptions, RunPartialFlowParams, FileInput, NamedFileInput, PathFileInput, DocmanaExecutionResult, DocmanaExecutionVerdict, ExecutionStatus, DocmanaDocumentMapping, DocmanaSourceDocument, DocmanaDocumentResult, DocmanaNodeResult, DocmanaScoreNodeResult, DocmanaCrossValidationResult, DocmanaConclusionResult, DocmanaClassificationResult, DocmanaMetadataExtractionResult, DocmanaExtractionResult, DocmanaValidationResult, DocmanaPreprocessingResult, } from "./types.js";
@@ -9,4 +10,4 @@ export type { ExecutionProgress, VirtualDocument, PhysicalDocument, DocumentCont
 export { Reviews } from "./reviews.js";
 export { ExecutionEvents, EXECUTION_NODE_EVENT_TYPES, parseExecutionEventCallback, verifyExecutionEventCallback, } from "./execution-events.js";
 export type { ExecutionNodeEvent, ExecutionEventCallback, ExecutionEventsPage, } from "./execution-events.js";
-export type { ReviewCalculation, ReviewFlowOutline, ReviewItem, DocumentPreviewManifest, ReviewDocument, ReviewAssessment, ReviewFinding, ReviewTask, ReviewSummary, ReviewDecision, ReviewReadOptions, ReviewDocumentOptions, } from "./reviews.js";
+export type { ReviewCalculation, ReviewFlowOutline, ReviewItem, DocumentPreviewManifest, ReviewDocument, ReviewAssessment, ReviewFinding, ReviewTask, ReviewStep, ReviewSummary, ReviewDecision, ReviewReadOptions, ReviewDocumentOptions, } from "./reviews.js";

package/dist/index.js

@@ -250,6 +250,11 @@ var Reviews = class {
     return this.http.requestJson("GET", `/executions/${segment(executionId)}/review`, {
       signal: options.signal,
       query: { organization: options.organization }
+    }).then((task) => {
+      if (typeof task?.status === "string" && task.status !== "pending" && task.documents === void 0) {
+        return { ...task, documents: [] };
+      }
+      return task;
     });
   }
   decide(executionId, decision, options) {
@@ -625,13 +630,9 @@ var HttpClient = class {
       const data = await res.clone().json().catch(() => null);
       if (typeof data?.code === "string" && /^[A-Za-z][A-Za-z0-9_]{0,99}$/.test(data.code))
         Object.defineProperty(error, "apiCode", { value: data.code, enumerable: true });
-      if (res.status === 409 && data?.details)
+      if (res.status === 409 && isRecord(data?.details))
         Object.defineProperty(error, "reviewConflict", {
-          value: {
-            version: Number.isInteger(data.details.version) ? data.details.version : null,
-            submittedBy: typeof data.details.submittedBy === "string" ? data.details.submittedBy.slice(0, 200) : null,
-            submittedAt: typeof data.details.submittedAt === "string" ? data.details.submittedAt.slice(0, 40) : null
-          },
+          value: reviewConflictDetails(data.details),
           enumerable: true
         });
       throw error;
@@ -677,6 +678,32 @@ var HttpClient = class {
     }
   }
 };
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function reviewConflictDetails(raw) {
+  const text = (value, limit) => typeof value === "string" ? value.slice(0, limit) : null;
+  const version = (value) => Number.isSafeInteger(value) && Number(value) >= 1 ? value : null;
+  const actor = isRecord(raw.decidedBy) ? raw.decidedBy : {};
+  const id = text(actor.id, 200);
+  const name = text(actor.name, 200);
+  const source = actor.source === "integrator" || actor.source === "token" ? actor.source : null;
+  const decidedBy = id !== null || name !== null || source !== null ? {
+    ...id !== null ? { id } : {},
+    ...name !== null ? { name } : {},
+    ...source ? { source } : {}
+  } : null;
+  const currentVersion = version(raw.currentVersion) ?? version(raw.version);
+  const decidedAt = text(raw.decidedAt, 40) ?? text(raw.submittedAt, 40);
+  return {
+    currentVersion,
+    decidedBy,
+    decidedAt,
+    version: currentVersion,
+    submittedBy: id ?? name ?? text(raw.submittedBy, 200),
+    submittedAt: decidedAt
+  };
+}
 function parseRetryAfterMs(value) {
   if (!value) return void 0;
   const seconds = Number(value);