opticedge-types 1.0.61 → 1.0.63

package/dist/types/instant.d.ts

@@ -2,9 +2,19 @@ export type SubmissionStatus = 'REJECTED' | 'ACCEPTED';
 export interface RejectedResponse {
     submission_status: 'REJECTED';
     rejection_message: string;
+    validation?: never;
+    overall_grade?: never;
+    front_subgrades?: never;
+    back_subgrades?: never;
+    environment_score?: never;
+    accuracy_score?: never;
+    grading_rationale?: never;
+    defect_map?: never;
 }
 export interface AcceptedResponse {
     submission_status: 'ACCEPTED';
+    rejection_message?: never;
+    validation: ValidationResult;
     overall_grade: number;
     front_subgrades: SubGrades;
     back_subgrades: SubGrades;
@@ -13,6 +23,14 @@ export interface AcceptedResponse {
     grading_rationale: string;
     defect_map: DefectMap;
 }
+type SameCardConfidence = 'high' | 'medium' | 'low';
+type ImageQuality = 'good' | 'borderline' | 'poor';
+interface ValidationResult {
+    front_back_valid: boolean;
+    same_card_confidence: SameCardConfidence;
+    image_quality: ImageQuality;
+    damage_override_triggered: boolean;
+}
 export interface SubGrades {
     centering: number;
     surface: number;
@@ -41,3 +59,4 @@ export interface DefectMap {
 }
 export type LocationZone = 'front_top_left_corner' | 'front_top_right_corner' | 'front_bottom_left_corner' | 'front_bottom_right_corner' | 'back_top_left_corner' | 'back_top_right_corner' | 'back_bottom_left_corner' | 'back_bottom_right_corner' | 'front_top_edge_left' | 'front_top_edge_center' | 'front_top_edge_right' | 'front_bottom_edge_left' | 'front_bottom_edge_center' | 'front_bottom_edge_right' | 'front_left_edge_upper' | 'front_left_edge_center' | 'front_left_edge_lower' | 'front_right_edge_upper' | 'front_right_edge_center' | 'front_right_edge_lower' | 'back_top_edge_left' | 'back_top_edge_center' | 'back_top_edge_right' | 'back_bottom_edge_left' | 'back_bottom_edge_center' | 'back_bottom_edge_right' | 'back_left_edge_upper' | 'back_left_edge_center' | 'back_left_edge_lower' | 'back_right_edge_upper' | 'back_right_edge_center' | 'back_right_edge_lower' | 'front_inner_top_left' | 'front_inner_top_center' | 'front_inner_top_right' | 'front_inner_middle_left' | 'front_inner_middle_center' | 'front_inner_middle_right' | 'front_inner_bottom_left' | 'front_inner_bottom_center' | 'front_inner_bottom_right' | 'back_inner_top_left' | 'back_inner_top_center' | 'back_inner_top_right' | 'back_inner_middle_left' | 'back_inner_middle_center' | 'back_inner_middle_right' | 'back_inner_bottom_left' | 'back_inner_bottom_center' | 'back_inner_bottom_right';
 export type PromptGradingResponse = RejectedResponse | AcceptedResponse;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opticedge-types",
-  "version": "1.0.61",
+  "version": "1.0.63",
   "description": "Common type for opticedge",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/types/instant.ts

@@ -10,7 +10,17 @@ export type SubmissionStatus = 'REJECTED' | 'ACCEPTED'
 
 export interface RejectedResponse {
   submission_status: 'REJECTED'
-  rejection_message: string // single sentence, <200 chars
+  rejection_message: string
+
+  // explicitly forbid accepted fields
+  validation?: never
+  overall_grade?: never
+  front_subgrades?: never
+  back_subgrades?: never
+  environment_score?: never
+  accuracy_score?: never
+  grading_rationale?: never
+  defect_map?: never
 }
 
 /* --------------------------------------------- */
@@ -20,6 +30,11 @@ export interface RejectedResponse {
 export interface AcceptedResponse {
   submission_status: 'ACCEPTED'
 
+  // explicitly forbid reject field
+  rejection_message?: never
+
+  validation: ValidationResult
+
   overall_grade: number // 1.0–10.0
 
   front_subgrades: SubGrades
@@ -33,6 +48,20 @@ export interface AcceptedResponse {
   defect_map: DefectMap
 }
 
+/* --------------------------------------------- */
+/* Validation */
+/* --------------------------------------------- */
+
+type SameCardConfidence = 'high' | 'medium' | 'low'
+type ImageQuality = 'good' | 'borderline' | 'poor'
+
+interface ValidationResult {
+  front_back_valid: boolean
+  same_card_confidence: SameCardConfidence
+  image_quality: ImageQuality
+  damage_override_triggered: boolean
+}
+
 /* --------------------------------------------- */
 /* SUBGRADES */
 /* --------------------------------------------- */
@@ -89,59 +118,38 @@ export interface DefectMap {
 /* --------------------------------------------- */
 
 export type LocationZone =
-  // FRONT — Corners
   | 'front_top_left_corner'
   | 'front_top_right_corner'
   | 'front_bottom_left_corner'
   | 'front_bottom_right_corner'
-
-  // BACK — Corners
   | 'back_top_left_corner'
   | 'back_top_right_corner'
   | 'back_bottom_left_corner'
   | 'back_bottom_right_corner'
-
-  // FRONT — Top Edge
   | 'front_top_edge_left'
   | 'front_top_edge_center'
   | 'front_top_edge_right'
-
-  // FRONT — Bottom Edge
   | 'front_bottom_edge_left'
   | 'front_bottom_edge_center'
   | 'front_bottom_edge_right'
-
-  // FRONT — Left Edge
   | 'front_left_edge_upper'
   | 'front_left_edge_center'
   | 'front_left_edge_lower'
-
-  // FRONT — Right Edge
   | 'front_right_edge_upper'
   | 'front_right_edge_center'
   | 'front_right_edge_lower'
-
-  // BACK — Top Edge
   | 'back_top_edge_left'
   | 'back_top_edge_center'
   | 'back_top_edge_right'
-
-  // BACK — Bottom Edge
   | 'back_bottom_edge_left'
   | 'back_bottom_edge_center'
   | 'back_bottom_edge_right'
-
-  // BACK — Left Edge
   | 'back_left_edge_upper'
   | 'back_left_edge_center'
   | 'back_left_edge_lower'
-
-  // BACK — Right Edge
   | 'back_right_edge_upper'
   | 'back_right_edge_center'
   | 'back_right_edge_lower'
-
-  // FRONT — Interior
   | 'front_inner_top_left'
   | 'front_inner_top_center'
   | 'front_inner_top_right'
@@ -151,8 +159,6 @@ export type LocationZone =
   | 'front_inner_bottom_left'
   | 'front_inner_bottom_center'
   | 'front_inner_bottom_right'
-
-  // BACK — Interior
   | 'back_inner_top_left'
   | 'back_inner_top_center'
   | 'back_inner_top_right'