@happyvertical/accounting 0.101.1 → 0.101.3

package/dist/chunks/invoice-request-C_z10JiX.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"invoice-request-C_z10JiX.js","names":[],"sources":["../../src/providers/quickbooks/invoice-request.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport type { InvoiceInput, QuickBooksInvoiceRequest } from '../../types.js';\n\n/** Prepare once, persist before sending, and reuse unchanged. Performs no I/O. */\nexport function prepareQuickBooksInvoiceRequest(\n  invoice: InvoiceInput,\n  identity: Omit<QuickBooksInvoiceRequest, 'payloadHash'>,\n): QuickBooksInvoiceRequest {\n  if (invoice.externalId)\n    throw new Error('QuickBooks request identity is only for invoice creation');\n  const payload = JSON.stringify(mapInvoiceToQBO(invoice));\n  const request = { ...identity, payloadHash: hash(payload) };\n  validateQuickBooksInvoiceRequest(\n    request,\n    identity.realmId,\n    identity.environment,\n    payload,\n  );\n  return Object.freeze(request);\n}\n\nfunction hash(payload: string): string {\n  return createHash('sha256').update(payload).digest('hex');\n}\n\nexport function validateQuickBooksInvoiceRequest(\n  request: QuickBooksInvoiceRequest,\n  realmId: string,\n  environment: 'sandbox' | 'production',\n  payload: string | undefined,\n): void {\n  // A deliberately conservative URL-safe subset of Intuit's 50-character limit.\n  if (\n    !request ||\n    typeof request.requestId !== 'string' ||\n    !/^[A-Za-z0-9._-]{1,50}$/.test(request.requestId)\n  ) {\n    throw new Error(\n      'QuickBooks requestId must contain 1–50 URL-safe letters, digits, dots, underscores or hyphens',\n    );\n  }\n  if (\n    !request.realmId ||\n    request.realmId !== realmId ||\n    !['sandbox', 'production'].includes(request.environment) ||\n    request.environment !== environment\n  ) {\n    throw new Error('QuickBooks invoice request realm/environment mismatch');\n  }\n  if (!payload || request.payloadHash !== hash(payload)) {\n    throw new Error(\n      'QuickBooks invoice request payload mismatch; reconcile the original request',\n    );\n  }\n  const parsed = JSON.parse(payload);\n  if (parsed.Id !== undefined || parsed.SyncToken !== undefined) {\n    throw new Error('QuickBooks request identity is only for invoice creation');\n  }\n}\n\nfunction formatLocalDate(date: Date): string {\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, '0');\n  const day = String(date.getDate()).padStart(2, '0');\n  return `${year}-${month}-${day}`;\n}\n\nexport function mapInvoiceToQBO(invoice: InvoiceInput) {\n  if (invoice.collectionMethod === 'charge_automatically') {\n    // QuickBooks cannot charge a stored payment method for an invoice.\n    throw new Error(\n      'QuickBooks does not support charge_automatically invoice collection',\n    );\n  }\n  if (invoice.automaticTax)\n    throw new Error(\n      'QuickBooks does not support automaticTax invoice calculation',\n    );\n  if (\n    invoice.quickbooksMapping &&\n    !['TaxExcluded', 'NotApplicable'].includes(\n      invoice.quickbooksMapping.globalTaxCalculation,\n    )\n  )\n    throw new Error(\n      'QuickBooks globalTaxCalculation must be TaxExcluded or NotApplicable',\n    );\n  const finite = (value: number, label: string) => {\n    if (!Number.isFinite(value) || value < 0)\n      throw new Error(\n        `QuickBooks ${label} must be a finite non-negative amount`,\n      );\n    return value;\n  };\n  const reference = (value: string | undefined, label: string) => {\n    if (!value || value.trim() !== value || value.length > 255)\n      throw new Error(\n        `QuickBooks ${label} must be a non-empty realm reference`,\n      );\n    return { value };\n  };\n  finite(invoice.subtotal, 'subtotal');\n  finite(invoice.taxAmount, 'tax amount');\n  finite(invoice.totalAmount, 'total amount');\n  if (invoice.lineItems.length === 0)\n    throw new Error('QuickBooks invoices require at least one sales line');\n  const close = (a: number, b: number) =>\n    Number.isFinite(a) &&\n    Number.isFinite(b) &&\n    Math.abs(a - b) <=\n      Number.EPSILON * Math.max(1, Math.abs(a), Math.abs(b)) * 8;\n  const lines = invoice.lineItems.map((item, idx) => {\n    if (item.discount !== undefined && item.discount !== 0)\n      throw new Error(\n        'QuickBooks line discounts are not supported; record an explicit supported sales line instead',\n      );\n    if (item.taxRate !== undefined && item.taxRate !== 0)\n      throw new Error(\n        'QuickBooks numeric taxRate is not supported; use a realm taxCodeRef',\n      );\n    if (item.taxCode !== undefined)\n      throw new Error(\n        'QuickBooks generic taxCode is not a realm tax reference; use quickbooksMapping.taxCodeRef',\n      );\n    finite(item.quantity, `line ${idx + 1} quantity`);\n    finite(item.unitPrice, `line ${idx + 1} unit price`);\n    const amount = finite(\n      item.amount ?? item.quantity * item.unitPrice,\n      `line ${idx + 1} amount`,\n    );\n    if (!close(amount, item.quantity * item.unitPrice))\n      throw new Error(\n        `QuickBooks line ${idx + 1} amount must equal quantity times unit price`,\n      );\n    return {\n      LineNum: idx + 1,\n      Description: item.description,\n      Amount: amount,\n      DetailType: 'SalesItemLineDetail' as const,\n      SalesItemLineDetail: {\n        Qty: item.quantity,\n        UnitPrice: item.unitPrice,\n        ItemRef: item.quickbooksMapping\n          ? reference(item.quickbooksMapping.itemRef, `line ${idx + 1} itemRef`)\n          : undefined,\n        TaxCodeRef: item.quickbooksMapping\n          ? reference(\n              item.quickbooksMapping.taxCodeRef,\n              `line ${idx + 1} taxCodeRef`,\n            )\n          : undefined,\n      },\n    };\n  });\n  // Compensated summation limits accumulated binary floating-point error\n  // without assuming a currency-specific number of decimal places.\n  let mappedSubtotal = 0;\n  let compensation = 0;\n  for (const line of lines) {\n    const adjusted = line.Amount - compensation;\n    const next = mappedSubtotal + adjusted;\n    compensation = next - mappedSubtotal - adjusted;\n    mappedSubtotal = next;\n  }\n  if (!close(mappedSubtotal, invoice.subtotal))\n    throw new Error('QuickBooks line amounts must equal the invoice subtotal');\n  if (!close(invoice.subtotal + invoice.taxAmount, invoice.totalAmount))\n    throw new Error(\n      'QuickBooks subtotal plus tax must equal the invoice total',\n    );\n  const hasLineMapping = invoice.lineItems.some(\n    (item) => item.quickbooksMapping,\n  );\n  if ((invoice.taxAmount > 0 || hasLineMapping) && !invoice.quickbooksMapping)\n    throw new Error(\n      'QuickBooks mapped or nonzero-tax invoices require explicit globalTaxCalculation',\n    );\n  if (\n    invoice.quickbooksMapping &&\n    invoice.lineItems.some((item) => !item.quickbooksMapping)\n  )\n    throw new Error(\n      'QuickBooks mapped invoices require itemRef and taxCodeRef on every line',\n    );\n  if (\n    invoice.taxAmount > 0 &&\n    invoice.quickbooksMapping?.globalTaxCalculation === 'NotApplicable'\n  )\n    throw new Error(\n      'QuickBooks nonzero tax cannot use NotApplicable global tax calculation',\n    );\n  return {\n    CustomerRef: { value: invoice.customerExternalId || invoice.customerId },\n    DocNumber: invoice.invoiceNumber,\n    TxnDate: formatLocalDate(invoice.issueDate),\n    DueDate: formatLocalDate(invoice.dueDate),\n    Line: lines,\n    GlobalTaxCalculation: invoice.quickbooksMapping?.globalTaxCalculation,\n    TxnTaxDetail: invoice.quickbooksMapping\n      ? { TotalTax: invoice.taxAmount }\n      : undefined,\n    CurrencyRef: invoice.currency ? { value: invoice.currency } : undefined,\n    CustomerMemo: invoice.memo ? { value: invoice.memo } : undefined,\n  };\n}\n"],"mappings":"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"}

package/dist/chunks/rolldown-runtime-D1cXj70v.js

@@ -1,46 +0,0 @@
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __esmMin = (fn, res, err) => () => {
-	if (err) throw err[0];
-	try {
-		return fn && (res = fn(fn = 0)), res;
-	} catch (e) {
-		throw err = [e], e;
-	}
-};
-var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
-	if (typeof require !== "undefined") return require.apply(this, arguments);
-	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
-});
-//#endregion
-export { __toCommonJS as a, __require as i, __esmMin as n, __toESM as o, __exportAll as r, __commonJSMin as t };