feat(OUT-3874): use invoice address to designate tax jurisdiction

Send the customer's address to QBO as BillAddr + ShipAddr so its
Automated Sales Tax engine computes tax by jurisdiction, and record the
amount/tax QBO actually returned rather than the locally-computed values.

- Add getUsStateCode() (us-state-converter) to map a full state name to
  the two-letter CountrySubDivisionCode QBO needs.
- Only attach the address when both state and postalCode resolve, the two
  fields QBO requires to pin a jurisdiction.
- Gate TxnTaxDetail: send our own tax total when we have one or there is
  no usable address; otherwise omit it so QBO computes from the address.
- Log amount/taxAmount from the QBO response (TotalAmt / TxnTaxDetail),
  falling back to computed values.
- Make address sub-fields optional so partial addresses on the REST fetch
  paths (_getInvoice/_getInvoices .parse) can't abort bulk resync.
- Consolidate InvoiceDeleted/InvoiceVoided response schemas into
  InvoiceDestructiveResponseSchema.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: SandipBajracharya

src/app/api/quickbooks/invoice/invoice.service.ts

@@ -831,7 +831,9 @@ export class InvoiceService extends BaseService {
     }
 
     // update/ create the record in sync log table
-    const totalWithTax = actualTotalAmount + totalTax
+    const totalWithTax =
+      invoiceRes.Invoice.TotalAmt ?? actualTotalAmount + totalTax
+    const taxForLog = invoiceRes.Invoice.TxnTaxDetail?.TotalTax ?? totalTax
     await this.logSync(
       invoiceResource.id,
       {
@@ -841,7 +843,7 @@ export class InvoiceService extends BaseService {
       EventType.CREATED,
       {
         amount: (totalWithTax * 100).toFixed(2),
-        taxAmount: (totalTax * 100).toFixed(2), // convert to cents for logs
+        taxAmount: (taxForLog * 100).toFixed(2), // convert to cents for logs
         customerName: recipientInfo.displayName,
         customerEmail: recipientInfo.email,
       },
@@ -885,7 +887,7 @@ export class InvoiceService extends BaseService {
         {
           invoiceNumber: invoiceResource.number,
           invoiceId: invoiceResource.id,
-          taxAmount: (totalTax * 100).toFixed(2),
+          taxAmount: (taxForLog * 100).toFixed(2),
         },
         {
           displayName: recipientInfo.displayName,

src/type/dto/intuitAPI.dto.ts

@@ -347,6 +347,11 @@ export const QBInvoiceRowSchema = z.object({
   DueDate: z.string().optional(),
   PrivateNote: z.string().optional(),
   CustomerRef: QBNameValueSchema.optional(),
+  TxnTaxDetail: z
+    .object({
+      TotalTax: z.number(),
+    })
+    .optional(),
 })
 export type QBInvoiceRowType = z.infer<typeof QBInvoiceRowSchema>