feat: add Deltains claim submission flow

Adds a full "Deltains Claim" button next to Delta MA Claim, mirroring
the DDMA claim flow across frontend, backend queue/routes, and a new
Selenium worker. Reuses the existing Deltains eligibility login/OTP
code and was iteratively wired against the live portal (patient roster
search, per-service-line fields, tooth number/surface selects, review
and submit). Also fixes chatbot/insurance-alias carrier recognition so
"deltains" resolves correctly instead of falling back to MassHealth.

apps/Backend/src/routes/claims.ts

@@ -588,6 +588,7 @@ function batchColumnDeriveSiteKey(provider: string): string {
   if (!p || p.includes("masshealth") || p === "mh" || p === "mass health") return "MH";
   if (p.includes("commonwealth care alliance") || p === "cca") return "CCA";
   if (p.includes("ddma") || p.includes("delta dental ma")) return "DDMA";
+  if (p.includes("delta ins") || p === "deltains") return "DELTAINS";
   if (p.includes("tufts") || p.includes("dentaquest") || p === "tuftssco") return "TUFTS_SCO";
   if ((p.includes("united") && p.includes("sco")) || p.includes("dentalhub") || p === "united_sco") return "UNITED_SCO";
   if (p.includes("ucard") || p.includes("onehealthcareid") || p.includes("one healthcare id")) return "UNITED_UCARD";
@@ -599,6 +600,7 @@ function batchColumnCanonicalName(siteKey: string): string {
   switch (siteKey) {
     case "CCA": return "CCA";
     case "DDMA": return "Delta Dental MA";
+    case "DELTAINS": return "Delta Dental Ins";
     case "TUFTS_SCO": return "Tufts SCO";
     case "UNITED_SCO": return "United/DentalHub";
     case "UNITED_UCARD": return "United Ucard";
@@ -947,6 +949,24 @@ router.post(
               enrichedPayload,
               claimId,
             });
+          } else if (siteKey === "DELTAINS") {
+            const enrichedPayload = {
+              claim: {
+                ...baseClaimPayload,
+                insuranceProvider: "Delta Dental Ins",
+                insuranceSiteKey: "DELTAINS",
+                deltainsUsername: credentials.username,
+                deltainsPassword: credentials.password,
+                providerName: resolvedNpiProvider?.providerName ?? "",
+                claimFiles: diskClaimFiles,
+              },
+            };
+            jobId = enqueueSeleniumJob({
+              jobType: "deltains-claim-submit",
+              userId: req.user.id,
+              enrichedPayload,
+              claimId,
+            });
           } else if (siteKey === "TUFTS_SCO") {
             const enrichedPayload = {
               claim: {

apps/Backend/src/routes/index.ts

@@ -20,6 +20,7 @@ import insuranceStatusCCARoutes from "./insuranceStatusCCA";
 import insuranceStatusCCAClaimRoutes from "./insuranceStatusCCAClaim";
 import insuranceStatusCCAPreAuthRoutes from "./insuranceStatusCCAPreAuth";
 import insuranceStatusDDMAClaimRoutes from "./insuranceStatusDDMAClaim";
+import insuranceStatusDeltainsClaimRoutes from "./insuranceStatusDeltainsClaim";
 import insuranceStatusUnitedDHClaimRoutes from "./insuranceStatusUnitedDHClaim";
 import insuranceStatusUnitedDHPreAuthRoutes from "./insuranceStatusUnitedDHPreAuth";
 import insuranceStatusTuftsSCOClaimRoutes from "./insuranceStatusTuftsSCOClaim";
@@ -75,6 +76,7 @@ router.use("/insurance-status-bcbs-ma", insuranceStatusBcbsMaRoutes);
 router.use("/claims", insuranceStatusCCAClaimRoutes);
 router.use("/claims", insuranceStatusCCAPreAuthRoutes);
 router.use("/claims", insuranceStatusDDMAClaimRoutes);
+router.use("/claims", insuranceStatusDeltainsClaimRoutes);
 router.use("/claims", insuranceStatusUnitedDHClaimRoutes);
 router.use("/claims", insuranceStatusUnitedDHPreAuthRoutes);
 router.use("/claims", insuranceStatusTuftsSCOClaimRoutes);

apps/Backend/src/routes/insuranceStatusDeltainsClaim.ts

@@ -0,0 +1,103 @@
+import { Router, Request, Response } from "express";
+import { storage } from "../storage";
+import { enqueueSeleniumJob } from "../queue/jobRunner";
+import { forwardOtpToSeleniumDeltainsClaimAgent } from "../services/seleniumDeltainsClaimClient";
+import { io } from "../socket";
+
+const router = Router();
+
+/**
+ * POST /deltains-claim
+ *
+ * Enqueues a Delta Dental Ins claim submission job.
+ *
+ * Body fields (JSON):
+ *   data     — claim payload (memberId, dateOfBirth, serviceDate, serviceLines, patientName, etc.)
+ *   socketId — socket.io client id
+ *   claimId  — existing claim DB id (optional)
+ *
+ * Response: { status: "queued", jobId: "…" }
+ */
+router.post("/deltains-claim", async (req: Request, res: Response): Promise<any> => {
+  if (!req.user?.id) {
+    return res.status(401).json({ error: "Unauthorized: user info missing" });
+  }
+
+  try {
+    const claimData =
+      typeof req.body.data === "string"
+        ? JSON.parse(req.body.data)
+        : req.body.data ?? req.body ?? {};
+
+    // Fetch Deltains credentials
+    const credentials = await storage.getInsuranceCredentialByUserAndSiteKey(
+      req.user.id,
+      "DELTAINS"
+    );
+    if (!credentials) {
+      return res.status(404).json({
+        error: "No Delta Dental Ins credentials found. Please add them on the Settings page.",
+      });
+    }
+
+    // Use provider from the claim form if set; fall back to Provider #1 (default)
+    const npiProviders = await storage.getNpiProvidersByUser(req.user.id);
+    const primaryProvider = npiProviders[0];
+    const providerName =
+      (claimData.npiProvider?.providerName as string | undefined)?.trim() ||
+      primaryProvider?.providerName ||
+      "";
+
+    const enrichedPayload = {
+      claim: {
+        ...claimData,
+        deltainsUsername: credentials.username,
+        deltainsPassword: credentials.password,
+        providerName,
+      },
+    };
+
+    const socketId: string | undefined = req.body.socketId;
+    const claimId: number | undefined = claimData.claimId
+      ? Number(claimData.claimId)
+      : undefined;
+
+    const jobId = enqueueSeleniumJob({
+      jobType: "deltains-claim-submit",
+      userId: req.user.id,
+      socketId,
+      enrichedPayload,
+      claimId,
+    });
+
+    return res.json({ status: "queued", jobId });
+  } catch (err: any) {
+    console.error("[deltains-claim route] error:", err);
+    return res.status(500).json({
+      error: err.message || "Failed to enqueue Deltains claim job",
+    });
+  }
+});
+
+/**
+ * POST /claims/deltains-claim/selenium/submit-otp
+ * Body: { session_id, otp, socketId? }
+ */
+router.post("/deltains-claim/selenium/submit-otp", async (req: Request, res: Response): Promise<any> => {
+  const { session_id: sessionId, otp, socketId } = req.body;
+  if (!sessionId || !otp) {
+    return res.status(400).json({ error: "session_id and otp are required" });
+  }
+  try {
+    const r = await forwardOtpToSeleniumDeltainsClaimAgent(sessionId, otp);
+    if (socketId && io) {
+      io.to(socketId).emit("selenium:otp_submitted", { session_id: sessionId });
+    }
+    return res.json(r);
+  } catch (err: any) {
+    console.error("[deltains-claim] submit-otp failed:", err?.message);
+    return res.status(500).json({ error: err?.message || "Failed to forward OTP" });
+  }
+});
+
+export default router;