feat: add invoice JSON export, deadline extension flow, webhook docs, and creator verification requests (#247-#250) (#277)

- #250: Add "Export JSON" button to AuditLogTable for structured invoice archival with schema versioning
- #249: Add deadline extension request/approval flow with single-pending constraint
- #248: Add webhook payload schema documentation viewer at /dev/webhook-docs
- #247: Add creator verification request form with URL validation and duplicate-submission blocking

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: SYMBAxx

src/__tests__/deadlineExtensionRequests.test.ts

@@ -0,0 +1,102 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import {
+  submitExtensionRequest,
+  getPendingRequest,
+  getExtensionRequests,
+  approveExtensionRequest,
+  denyExtensionRequest,
+} from "@/lib/deadlineExtensionRequests";
+
+const store: Record<string, string> = {};
+vi.stubGlobal("localStorage", {
+  getItem: (key: string) => store[key] ?? null,
+  setItem: (key: string, val: string) => { store[key] = val; },
+  removeItem: (key: string) => { delete store[key]; },
+});
+
+const INVOICE_ID = "inv-001";
+const REQUESTER = "GCEZWKZPVOPNFHIMZQ3OQNFHM2FQNBXCQ3PNHIMZQ3OQNFHM2FQNBX";
+const CREATOR = "GBXYZ1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890ABC";
+const FUTURE_DEADLINE = Math.floor(Date.now() / 1000) + 86400 * 7; // 7 days from now
+
+beforeEach(() => {
+  Object.keys(store).forEach((k) => delete store[k]);
+});
+
+describe("submitExtensionRequest", () => {
+  it("creates a request with status pending", () => {
+    const req = submitExtensionRequest(INVOICE_ID, REQUESTER, FUTURE_DEADLINE, "Need more time");
+    expect(req.status).toBe("pending");
+    expect(req.invoiceId).toBe(INVOICE_ID);
+    expect(req.requester).toBe(REQUESTER);
+    expect(req.requestedDeadline).toBe(FUTURE_DEADLINE);
+    expect(req.reason).toBe("Need more time");
+    expect(req.id).toBeDefined();
+    expect(req.createdAt).toBeGreaterThan(0);
+  });
+});
+
+describe("getPendingRequest", () => {
+  it("returns the pending request", () => {
+    submitExtensionRequest(INVOICE_ID, REQUESTER, FUTURE_DEADLINE, "Need more time");
+    const pending = getPendingRequest(INVOICE_ID);
+    expect(pending).not.toBeNull();
+    expect(pending!.status).toBe("pending");
+    expect(pending!.invoiceId).toBe(INVOICE_ID);
+  });
+
+  it("returns null when no pending request exists", () => {
+    expect(getPendingRequest(INVOICE_ID)).toBeNull();
+  });
+});
+
+describe("single-pending-request constraint", () => {
+  it("throws when submitting a second request while one is pending", () => {
+    submitExtensionRequest(INVOICE_ID, REQUESTER, FUTURE_DEADLINE, "First request");
+    expect(() =>
+      submitExtensionRequest(INVOICE_ID, REQUESTER, FUTURE_DEADLINE + 3600, "Second request"),
+    ).toThrow("An extension request is already pending for this invoice.");
+  });
+});
+
+describe("approveExtensionRequest", () => {
+  it("changes status to approved and sets resolvedAt/resolvedBy", () => {
+    const req = submitExtensionRequest(INVOICE_ID, REQUESTER, FUTURE_DEADLINE, "Please extend");
+    const approved = approveExtensionRequest(req.id, CREATOR);
+    expect(approved.status).toBe("approved");
+    expect(approved.resolvedAt).toBeGreaterThan(0);
+    expect(approved.resolvedBy).toBe(CREATOR);
+  });
+});
+
+describe("denyExtensionRequest", () => {
+  it("changes status to denied and sets resolvedAt/resolvedBy", () => {
+    const req = submitExtensionRequest(INVOICE_ID, REQUESTER, FUTURE_DEADLINE, "Please extend");
+    const denied = denyExtensionRequest(req.id, CREATOR);
+    expect(denied.status).toBe("denied");
+    expect(denied.resolvedAt).toBeGreaterThan(0);
+    expect(denied.resolvedBy).toBe(CREATOR);
+  });
+});
+
+describe("after resolving, a new request can be submitted", () => {
+  it("allows a new request after approval", () => {
+    const req = submitExtensionRequest(INVOICE_ID, REQUESTER, FUTURE_DEADLINE, "First");
+    approveExtensionRequest(req.id, CREATOR);
+    expect(getPendingRequest(INVOICE_ID)).toBeNull();
+
+    const req2 = submitExtensionRequest(INVOICE_ID, REQUESTER, FUTURE_DEADLINE + 7200, "Second");
+    expect(req2.status).toBe("pending");
+    expect(getExtensionRequests(INVOICE_ID)).toHaveLength(2);
+  });
+
+  it("allows a new request after denial", () => {
+    const req = submitExtensionRequest(INVOICE_ID, REQUESTER, FUTURE_DEADLINE, "First");
+    denyExtensionRequest(req.id, CREATOR);
+    expect(getPendingRequest(INVOICE_ID)).toBeNull();
+
+    const req2 = submitExtensionRequest(INVOICE_ID, REQUESTER, FUTURE_DEADLINE + 7200, "Second");
+    expect(req2.status).toBe("pending");
+    expect(getExtensionRequests(INVOICE_ID)).toHaveLength(2);
+  });
+});

src/__tests__/invoiceArchiveExport.test.ts

@@ -0,0 +1,151 @@
+/**
+ * Unit tests for invoiceArchiveExport.
+ *
+ * Covers:
+ *   1. buildInvoiceArchive includes correct schemaVersion
+ *   2. generateArchiveFilename produces correct format
+ *   3. buildInvoiceArchive works with empty audit log and empty payments
+ *   4. BigInt amounts are properly serialized as formatted strings
+ */
+
+import { describe, it, expect, vi } from "vitest";
+
+vi.mock("@stellar-split/sdk", () => ({
+  formatAmount: (n: bigint) => (Number(n) / 10_000_000).toFixed(2),
+}));
+
+import {
+  buildInvoiceArchive,
+  generateArchiveFilename,
+  ARCHIVE_SCHEMA_VERSION,
+} from "@/lib/invoiceArchiveExport";
+
+// ── Test Fixtures ───────────────────────────────────────────────────────────
+
+function makeInvoice(overrides: Record<string, unknown> = {}) {
+  return {
+    id: "inv-42",
+    creator: "GCREATOR",
+    status: "Pending",
+    deadline: 1_700_000_000,
+    funded: 50_000_000n,
+    recipients: [
+      { address: "GRECIPIENT1", amount: 70_000_000n },
+      { address: "GRECIPIENT2", amount: 30_000_000n },
+    ],
+    ...overrides,
+  };
+}
+
+const sampleAuditLog = [
+  { action: "created", actor: "GCREATOR", timestamp: 1_700_000_000 },
+  { action: "paid", actor: "GPAYER1", timestamp: 1_700_001_000 },
+];
+
+const samplePayments = [
+  { payer: "GPAYER1", amount: 30_000_000n },
+  { payer: "GPAYER2", amount: 20_000_000n },
+];
+
+// ── schemaVersion ───────────────────────────────────────────────────────────
+
+describe("buildInvoiceArchive", () => {
+  it("includes schemaVersion equal to ARCHIVE_SCHEMA_VERSION", () => {
+    const archive = buildInvoiceArchive(
+      makeInvoice(),
+      sampleAuditLog,
+      samplePayments,
+    );
+    expect(archive.schemaVersion).toBe(ARCHIVE_SCHEMA_VERSION);
+  });
+
+  it("includes an ISO 8601 exportedAt timestamp", () => {
+    const archive = buildInvoiceArchive(
+      makeInvoice(),
+      sampleAuditLog,
+      samplePayments,
+    );
+    // Should be a valid ISO date string
+    expect(() => new Date(archive.exportedAt).toISOString()).not.toThrow();
+    expect(archive.exportedAt).toMatch(
+      /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/,
+    );
+  });
+
+  it("works with empty audit log and empty payments", () => {
+    const archive = buildInvoiceArchive(makeInvoice(), [], []);
+    expect(archive.auditLog).toEqual([]);
+    expect(archive.payments).toEqual([]);
+    expect(archive.schemaVersion).toBe(ARCHIVE_SCHEMA_VERSION);
+    // Invoice data should still be present
+    expect(archive.invoice.id).toBe("inv-42");
+  });
+
+  it("serializes BigInt amounts as formatted strings", () => {
+    const archive = buildInvoiceArchive(
+      makeInvoice(),
+      sampleAuditLog,
+      samplePayments,
+    );
+    // funded: 50_000_000n → "5.00"
+    expect(archive.invoice.funded).toBe("5.00");
+    // totalAmount: 70_000_000n + 30_000_000n = 100_000_000n → "10.00"
+    expect(archive.invoice.totalAmount).toBe("10.00");
+    // recipient amounts
+    expect(archive.invoice.recipients[0].amount).toBe("7.00");
+    expect(archive.invoice.recipients[1].amount).toBe("3.00");
+    // payment amounts
+    expect(archive.payments[0].amount).toBe("3.00");
+    expect(archive.payments[1].amount).toBe("2.00");
+  });
+
+  it("maps audit log entries correctly", () => {
+    const archive = buildInvoiceArchive(
+      makeInvoice(),
+      sampleAuditLog,
+      samplePayments,
+    );
+    expect(archive.auditLog).toHaveLength(2);
+    expect(archive.auditLog[0]).toEqual({
+      action: "created",
+      actor: "GCREATOR",
+      timestamp: 1_700_000_000,
+    });
+  });
+
+  it("maps payments correctly", () => {
+    const archive = buildInvoiceArchive(
+      makeInvoice(),
+      sampleAuditLog,
+      samplePayments,
+    );
+    expect(archive.payments).toHaveLength(2);
+    expect(archive.payments[0].payer).toBe("GPAYER1");
+  });
+});
+
+// ── generateArchiveFilename ─────────────────────────────────────────────────
+
+describe("generateArchiveFilename", () => {
+  it("starts with 'invoice-' and contains the invoice id", () => {
+    const filename = generateArchiveFilename("inv-42");
+    expect(filename.startsWith("invoice-inv-42")).toBe(true);
+  });
+
+  it("contains 'archive' in the filename", () => {
+    const filename = generateArchiveFilename("inv-42");
+    expect(filename).toContain("archive");
+  });
+
+  it("ends with .json", () => {
+    const filename = generateArchiveFilename("inv-42");
+    expect(filename.endsWith(".json")).toBe(true);
+  });
+
+  it("does not contain colons or dots (except .json extension)", () => {
+    const filename = generateArchiveFilename("inv-42");
+    const withoutExtension = filename.replace(/\.json$/, "");
+    expect(withoutExtension).not.toContain(":");
+    expect(withoutExtension).not.toContain(".");
+  });
+});