@zentring/zinvoice 0.1.0

package/dist/index.js

@@ -0,0 +1,3274 @@
+import { createHash } from 'crypto';
+
+// src/Provider.ts
+var Provider = /* @__PURE__ */ ((Provider2) => {
+  Provider2["AMEGO"] = "amego";
+  return Provider2;
+})(Provider || {});
+var Capability = /* @__PURE__ */ ((Capability3) => {
+  Capability3["B2C"] = "b2c";
+  Capability3["B2B"] = "b2b";
+  Capability3["CARRIER"] = "carrier";
+  Capability3["DONATION"] = "donation";
+  Capability3["ALLOWANCE"] = "allowance";
+  Capability3["VOID"] = "void";
+  Capability3["EXCHANGE"] = "exchange";
+  Capability3["PRINT"] = "print";
+  Capability3["QUERY"] = "query";
+  Capability3["LIST"] = "list";
+  return Capability3;
+})(Capability || {});
+var PROVIDER_CAPABILITIES = {
+  ["amego" /* AMEGO */]: /* @__PURE__ */ new Set([
+    "b2c" /* B2C */,
+    "b2b" /* B2B */,
+    "carrier" /* CARRIER */,
+    "donation" /* DONATION */,
+    "allowance" /* ALLOWANCE */,
+    "void" /* VOID */,
+    "exchange" /* EXCHANGE */,
+    "print" /* PRINT */,
+    "query" /* QUERY */,
+    "list" /* LIST */
+  ])
+};
+var PROVIDER_NAMES = {
+  ["amego" /* AMEGO */]: "\u5149\u8CBF\u8CC7\u8A0A"
+};
+
+// src/errors/index.ts
+var ZinvoiceError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ZinvoiceError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var InvalidTaxIdError = class extends ZinvoiceError {
+  constructor(value) {
+    super(`Invalid tax ID (\u7D71\u4E00\u7DE8\u865F): ${value}`);
+    this.value = value;
+    this.name = "InvalidTaxIdError";
+  }
+};
+var InvalidCarrierCodeError = class extends ZinvoiceError {
+  constructor(value, carrierType) {
+    super(`Invalid carrier code for type ${carrierType}: ${value}`);
+    this.value = value;
+    this.carrierType = carrierType;
+    this.name = "InvalidCarrierCodeError";
+  }
+};
+var InvalidInvoiceNumberError = class extends ZinvoiceError {
+  constructor(value) {
+    super(`Invalid invoice number (\u767C\u7968\u865F\u78BC): ${value}`);
+    this.value = value;
+    this.name = "InvalidInvoiceNumberError";
+  }
+};
+var InvalidMoneyError = class extends ZinvoiceError {
+  constructor(value, reason) {
+    super(`Invalid money amount: ${value} - ${reason}`);
+    this.value = value;
+    this.name = "InvalidMoneyError";
+  }
+};
+var ProviderApiError = class extends ZinvoiceError {
+  constructor(provider, code, message) {
+    super(`[${provider}] API Error (${code}): ${message}`);
+    this.provider = provider;
+    this.code = code;
+    this.name = "ProviderApiError";
+  }
+};
+var NetworkError = class extends ZinvoiceError {
+  constructor(message, cause) {
+    super(`Network error: ${message}`);
+    this.cause = cause;
+    this.name = "NetworkError";
+  }
+};
+var ValidationError = class extends ZinvoiceError {
+  constructor(field, message) {
+    super(`Validation error on ${field}: ${message}`);
+    this.field = field;
+    this.name = "ValidationError";
+  }
+};
+var UnsupportedCapabilityError = class extends ZinvoiceError {
+  constructor(capability, provider) {
+    super(`Provider "${provider}" does not support capability: ${capability}`);
+    this.capability = capability;
+    this.provider = provider;
+    this.name = "UnsupportedCapabilityError";
+  }
+};
+var ProviderNotImplementedError = class extends ZinvoiceError {
+  constructor(provider) {
+    super(`Provider "${provider}" is not yet implemented`);
+    this.provider = provider;
+    this.name = "ProviderNotImplementedError";
+  }
+};
+
+// src/infrastructure/amego/AmegoConfig.ts
+var AMEGO_ENDPOINTS = {
+  // Invoice endpoints (發票)
+  INVOICE_ISSUE: "/json/f0401",
+  // 開立發票 (自動配號)
+  INVOICE_ISSUE_CUSTOM: "/json/f0401_custom",
+  // 開立發票 (API 配號)
+  INVOICE_VOID: "/json/f0501",
+  // 作廢發票
+  INVOICE_QUERY: "/json/invoice_query",
+  // 查詢單張發票
+  INVOICE_LIST: "/json/invoice_list",
+  // 查詢發票列表
+  INVOICE_STATUS: "/json/invoice_status",
+  // 查詢發票狀態
+  INVOICE_FILE: "/json/invoice_file",
+  // 下載發票檔案 (PDF)
+  INVOICE_PRINT: "/json/invoice_print",
+  // 產出列印格式字串
+  // Allowance endpoints (折讓)
+  ALLOWANCE_ISSUE: "/json/g0401",
+  // 開立折讓
+  ALLOWANCE_VOID: "/json/g0501",
+  // 作廢折讓
+  ALLOWANCE_QUERY: "/json/allowance_query",
+  // 查詢單張折讓
+  ALLOWANCE_LIST: "/json/allowance_list",
+  // 查詢折讓列表
+  ALLOWANCE_STATUS: "/json/allowance_status",
+  // 查詢折讓狀態
+  ALLOWANCE_FILE: "/json/allowance_file",
+  // 下載折讓檔案 (PDF)
+  ALLOWANCE_PRINT: "/json/allowance_print",
+  // 產出折讓列印格式字串
+  // Utility endpoints (其他)
+  BARCODE_CHECK: "/json/barcode",
+  // 手機條碼查詢
+  BAN_QUERY: "/json/ban_query",
+  // 公司名稱查詢
+  TRACK_ALL: "/json/track_all",
+  // 所有字軌資料
+  TRACK_GET: "/json/track_get",
+  // 字軌取號 (API 配號專用)
+  TRACK_STATUS: "/json/track_status",
+  // 字軌狀態 (API 配號專用)
+  LOTTERY_TYPE: "/json/lottery_type",
+  // 獎項定義
+  LOTTERY_STATUS: "/json/lottery_status"
+  // 中獎發票
+};
+var AMEGO_DEFAULTS = {
+  TIMEOUT: 3e4,
+  BASE_URL: "https://invoice-api.amego.tw"
+};
+var AmegoSigner = class {
+  constructor(apiKey) {
+    this.apiKey = apiKey;
+  }
+  /**
+   * Generate signature for API request
+   *
+   * @param data - Request data as JSON string
+   * @param timestamp - Unix timestamp in seconds
+   * @returns MD5 signature in lowercase hex
+   */
+  sign(data, timestamp) {
+    const payload = `${data}${timestamp}${this.apiKey}`;
+    return createHash("md5").update(payload, "utf8").digest("hex").toLowerCase();
+  }
+  /**
+   * Generate current timestamp (Unix seconds)
+   */
+  static getTimestamp() {
+    return Math.floor(Date.now() / 1e3);
+  }
+};
+
+// src/infrastructure/amego/AmegoClient.ts
+var AmegoClient = class {
+  baseUrl;
+  timeout;
+  signer;
+  sellerTaxId;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.timeout = config.timeout ?? AMEGO_DEFAULTS.TIMEOUT;
+    this.signer = new AmegoSigner(config.apiKey);
+    this.sellerTaxId = config.sellerTaxId;
+  }
+  /**
+   * Send POST request to Amego API
+   *
+   * 請求格式：application/x-www-form-urlencoded
+   * 參數：
+   * - invoice: 統一編號
+   * - data: URL encoded JSON string
+   * - time: Unix timestamp
+   * - sign: MD5(data + time + apiKey)
+   */
+  async post(endpoint, data) {
+    const timestamp = AmegoSigner.getTimestamp();
+    const jsonData = JSON.stringify(data);
+    const signature = this.signer.sign(jsonData, timestamp);
+    const url = `${this.baseUrl}${endpoint}`;
+    const formData = new URLSearchParams();
+    formData.append("invoice", this.sellerTaxId);
+    formData.append("data", jsonData);
+    formData.append("time", timestamp.toString());
+    formData.append("sign", signature);
+    try {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/x-www-form-urlencoded"
+        },
+        body: formData.toString(),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        throw new ProviderApiError(
+          "amego",
+          `HTTP ${response.status}`,
+          `HTTP error: ${response.status} ${response.statusText}`
+        );
+      }
+      const result = await response.json();
+      if (result.code !== 0) {
+        throw new ProviderApiError(
+          "amego",
+          String(result.code),
+          result.msg || "Unknown error"
+        );
+      }
+      return result;
+    } catch (error) {
+      if (error instanceof ProviderApiError) {
+        throw error;
+      }
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new NetworkError(`Request timeout after ${this.timeout}ms`);
+        }
+        throw new NetworkError(error.message);
+      }
+      throw new NetworkError("Unknown network error");
+    }
+  }
+  /**
+   * Send POST request and return raw response (for debugging)
+   */
+  async postRaw(endpoint, data) {
+    const timestamp = AmegoSigner.getTimestamp();
+    const jsonData = JSON.stringify(data);
+    const signature = this.signer.sign(jsonData, timestamp);
+    const url = `${this.baseUrl}${endpoint}`;
+    const formData = new URLSearchParams();
+    formData.append("invoice", this.sellerTaxId);
+    formData.append("data", jsonData);
+    formData.append("time", timestamp.toString());
+    formData.append("sign", signature);
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/x-www-form-urlencoded"
+      },
+      body: formData.toString(),
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+    const headers = {};
+    response.headers.forEach((value, key) => {
+      headers[key] = value;
+    });
+    const body = await response.text();
+    let parsed;
+    try {
+      parsed = JSON.parse(body);
+    } catch {
+    }
+    return {
+      status: response.status,
+      statusText: response.statusText,
+      headers,
+      body,
+      parsed
+    };
+  }
+};
+
+// src/domain/shared/Money.ts
+var Money = class _Money {
+  constructor(amount) {
+    this.amount = amount;
+  }
+  /**
+   * Create Money from a number
+   * @throws InvalidMoneyError if the amount is invalid
+   */
+  static create(amount) {
+    if (!Number.isFinite(amount)) {
+      throw new InvalidMoneyError(amount, "Amount must be a finite number");
+    }
+    return new _Money(amount);
+  }
+  /**
+   * Create Money representing zero
+   */
+  static zero() {
+    return new _Money(0);
+  }
+  /**
+   * Create Money from cents (integer)
+   */
+  static fromCents(cents) {
+    if (!Number.isInteger(cents)) {
+      throw new InvalidMoneyError(cents, "Cents must be an integer");
+    }
+    return new _Money(cents / 100);
+  }
+  /**
+   * Get the numeric value
+   */
+  toNumber() {
+    return this.amount;
+  }
+  /**
+   * Get value rounded to integer
+   */
+  toInteger() {
+    return Math.round(this.amount);
+  }
+  /**
+   * Get value in cents (integer)
+   */
+  toCents() {
+    return Math.round(this.amount * 100);
+  }
+  /**
+   * Add another Money value
+   */
+  add(other) {
+    return new _Money(this.amount + other.amount);
+  }
+  /**
+   * Subtract another Money value
+   */
+  subtract(other) {
+    return new _Money(this.amount - other.amount);
+  }
+  /**
+   * Multiply by a factor
+   */
+  multiply(factor) {
+    return new _Money(this.amount * factor);
+  }
+  /**
+   * Divide by a divisor
+   */
+  divide(divisor) {
+    if (divisor === 0) {
+      throw new InvalidMoneyError(this.amount, "Cannot divide by zero");
+    }
+    return new _Money(this.amount / divisor);
+  }
+  /**
+   * Check if this amount is zero
+   */
+  isZero() {
+    return this.amount === 0;
+  }
+  /**
+   * Check if this amount is positive
+   */
+  isPositive() {
+    return this.amount > 0;
+  }
+  /**
+   * Check if this amount is negative
+   */
+  isNegative() {
+    return this.amount < 0;
+  }
+  /**
+   * Get absolute value
+   */
+  abs() {
+    return new _Money(Math.abs(this.amount));
+  }
+  /**
+   * Round to specified decimal places
+   */
+  round(decimals = 0) {
+    const factor = Math.pow(10, decimals);
+    return new _Money(Math.round(this.amount * factor) / factor);
+  }
+  /**
+   * Format as string with specified decimal places
+   */
+  format(decimals = 2) {
+    return this.amount.toFixed(decimals);
+  }
+  /**
+   * Check equality with another Money
+   */
+  equals(other) {
+    return this.amount === other.amount;
+  }
+  /**
+   * Compare with another Money
+   * Returns: -1 if less, 0 if equal, 1 if greater
+   */
+  compareTo(other) {
+    if (this.amount < other.amount) return -1;
+    if (this.amount > other.amount) return 1;
+    return 0;
+  }
+  toString() {
+    return this.amount.toString();
+  }
+};
+
+// src/domain/shared/Carrier.ts
+var Carrier = class _Carrier {
+  constructor(_type, _id) {
+    this._type = _type;
+    this._id = _id;
+  }
+  /**
+   * Create a "no carrier" instance
+   */
+  static none() {
+    return new _Carrier("" /* NONE */, "");
+  }
+  /**
+   * Create a mobile barcode carrier (手機條碼)
+   *
+   * @param barcode The mobile barcode (format: /XXXXXXX)
+   */
+  static mobile(barcode) {
+    const trimmed = barcode?.trim();
+    if (!trimmed) {
+      throw new ValidationError("carrier", "Mobile barcode is required");
+    }
+    const pattern = /^\/[0-9A-Z.+-]{7}$/;
+    if (!pattern.test(trimmed.toUpperCase())) {
+      throw new ValidationError(
+        "carrier",
+        "Invalid mobile barcode format. Expected: /XXXXXXX"
+      );
+    }
+    return new _Carrier("3J0002" /* MOBILE */, trimmed.toUpperCase());
+  }
+  /**
+   * Create a certificate carrier (自然人憑證)
+   *
+   * @param certId The certificate ID (16 characters)
+   */
+  static certificate(certId) {
+    const trimmed = certId?.trim();
+    if (!trimmed) {
+      throw new ValidationError("carrier", "Certificate ID is required");
+    }
+    if (!/^[A-Z0-9]{16}$/i.test(trimmed)) {
+      throw new ValidationError(
+        "carrier",
+        "Invalid certificate ID format. Expected: 16 alphanumeric characters"
+      );
+    }
+    return new _Carrier("CQ0001" /* CERTIFICATE */, trimmed.toUpperCase());
+  }
+  /**
+   * Create a custom carrier
+   */
+  static custom(type, id) {
+    if (type === "" /* NONE */) {
+      return _Carrier.none();
+    }
+    return new _Carrier(type, id?.trim() ?? "");
+  }
+  /**
+   * Get the carrier type
+   */
+  get type() {
+    return this._type;
+  }
+  /**
+   * Get the carrier type code (for API)
+   */
+  get typeCode() {
+    return this._type;
+  }
+  /**
+   * Get the carrier ID
+   */
+  get id() {
+    return this._id;
+  }
+  /**
+   * Check if this is an empty carrier
+   */
+  get isEmpty() {
+    return this._type === "" /* NONE */;
+  }
+  /**
+   * Check if this is a mobile barcode
+   */
+  get isMobile() {
+    return this._type === "3J0002" /* MOBILE */;
+  }
+  /**
+   * Check if this is a certificate
+   */
+  get isCertificate() {
+    return this._type === "CQ0001" /* CERTIFICATE */;
+  }
+};
+
+// src/domain/shared/Donation.ts
+var Donation = class _Donation {
+  constructor(_code) {
+    this._code = _code;
+  }
+  /**
+   * Create a "no donation" instance
+   */
+  static none() {
+    return new _Donation("");
+  }
+  /**
+   * Create a donation with code (愛心碼)
+   *
+   * @param code The donation code (3-7 digits)
+   */
+  static code(code) {
+    const trimmed = code?.trim();
+    if (!trimmed) {
+      throw new ValidationError("donation", "Donation code is required");
+    }
+    if (!/^\d{3,7}$/.test(trimmed)) {
+      throw new ValidationError(
+        "donation",
+        "Invalid donation code format. Expected: 3-7 digits"
+      );
+    }
+    return new _Donation(trimmed);
+  }
+  /**
+   * Try to create a Donation, returns none() if invalid
+   */
+  static tryCreate(code) {
+    try {
+      return _Donation.code(code);
+    } catch {
+      return _Donation.none();
+    }
+  }
+  /**
+   * Get the donation code
+   */
+  get code() {
+    return this._code;
+  }
+  /**
+   * Check if this is an empty donation (not donating)
+   */
+  get isEmpty() {
+    return this._code.length === 0;
+  }
+  /**
+   * Check if this invoice is being donated
+   */
+  get isDonating() {
+    return this._code.length > 0;
+  }
+  /**
+   * Get the string value
+   */
+  toString() {
+    return this._code;
+  }
+};
+
+// src/domain/shared/TaxType.ts
+var TaxType = /* @__PURE__ */ ((TaxType2) => {
+  TaxType2[TaxType2["TAXABLE"] = 1] = "TAXABLE";
+  TaxType2[TaxType2["ZERO_RATED"] = 2] = "ZERO_RATED";
+  TaxType2[TaxType2["TAX_EXEMPT"] = 3] = "TAX_EXEMPT";
+  TaxType2[TaxType2["SPECIAL_TAX"] = 4] = "SPECIAL_TAX";
+  TaxType2[TaxType2["MIXED"] = 9] = "MIXED";
+  return TaxType2;
+})(TaxType || {});
+var ZeroTaxRateReason = /* @__PURE__ */ ((ZeroTaxRateReason3) => {
+  ZeroTaxRateReason3[ZeroTaxRateReason3["EXPORT_GOODS"] = 71] = "EXPORT_GOODS";
+  ZeroTaxRateReason3[ZeroTaxRateReason3["EXPORT_SERVICES"] = 72] = "EXPORT_SERVICES";
+  ZeroTaxRateReason3[ZeroTaxRateReason3["DUTY_FREE_SHOP"] = 73] = "DUTY_FREE_SHOP";
+  ZeroTaxRateReason3[ZeroTaxRateReason3["BONDED_AREA"] = 74] = "BONDED_AREA";
+  ZeroTaxRateReason3[ZeroTaxRateReason3["INTERNATIONAL_TRANSPORT"] = 75] = "INTERNATIONAL_TRANSPORT";
+  ZeroTaxRateReason3[ZeroTaxRateReason3["INTERNATIONAL_VESSELS"] = 76] = "INTERNATIONAL_VESSELS";
+  ZeroTaxRateReason3[ZeroTaxRateReason3["VESSEL_SUPPLIES"] = 77] = "VESSEL_SUPPLIES";
+  ZeroTaxRateReason3[ZeroTaxRateReason3["BONDED_DIRECT_EXPORT"] = 78] = "BONDED_DIRECT_EXPORT";
+  ZeroTaxRateReason3[ZeroTaxRateReason3["BONDED_WAREHOUSE"] = 79] = "BONDED_WAREHOUSE";
+  return ZeroTaxRateReason3;
+})(ZeroTaxRateReason || {});
+var CustomsClearanceMark = /* @__PURE__ */ ((CustomsClearanceMark3) => {
+  CustomsClearanceMark3[CustomsClearanceMark3["NON_CUSTOMS"] = 1] = "NON_CUSTOMS";
+  CustomsClearanceMark3[CustomsClearanceMark3["CUSTOMS"] = 2] = "CUSTOMS";
+  return CustomsClearanceMark3;
+})(CustomsClearanceMark || {});
+var TAX_RATE = 0.05;
+
+// src/domain/invoice/Invoice.ts
+var InvoiceStatus = /* @__PURE__ */ ((InvoiceStatus2) => {
+  InvoiceStatus2[InvoiceStatus2["PENDING"] = 1] = "PENDING";
+  InvoiceStatus2[InvoiceStatus2["UPLOADING"] = 2] = "UPLOADING";
+  InvoiceStatus2[InvoiceStatus2["UPLOADED"] = 3] = "UPLOADED";
+  InvoiceStatus2[InvoiceStatus2["PROCESSING"] = 31] = "PROCESSING";
+  InvoiceStatus2[InvoiceStatus2["AWAITING_CONFIRMATION"] = 32] = "AWAITING_CONFIRMATION";
+  InvoiceStatus2[InvoiceStatus2["ERROR"] = 91] = "ERROR";
+  InvoiceStatus2[InvoiceStatus2["COMPLETED"] = 99] = "COMPLETED";
+  return InvoiceStatus2;
+})(InvoiceStatus || {});
+var InvoiceType = /* @__PURE__ */ ((InvoiceType2) => {
+  InvoiceType2["B2C_ISSUE"] = "C0401";
+  InvoiceType2["B2C_VOID"] = "C0501";
+  InvoiceType2["B2C_CANCEL"] = "C0701";
+  InvoiceType2["B2B_ISSUE"] = "A0401";
+  InvoiceType2["B2B_VOID"] = "A0501";
+  return InvoiceType2;
+})(InvoiceType || {});
+var Invoice = class _Invoice {
+  constructor(_orderId, _buyer, _items, _carrier, _donation, _remark, _trackApiCode, _taxType, _customsClearanceMark, _zeroTaxRateReason, _brandName, _pricesIncludeTax = true, _status = 1 /* PENDING */, _type = "C0401" /* B2C_ISSUE */) {
+    this._orderId = _orderId;
+    this._buyer = _buyer;
+    this._items = _items;
+    this._carrier = _carrier;
+    this._donation = _donation;
+    this._remark = _remark;
+    this._trackApiCode = _trackApiCode;
+    this._taxType = _taxType;
+    this._customsClearanceMark = _customsClearanceMark;
+    this._zeroTaxRateReason = _zeroTaxRateReason;
+    this._brandName = _brandName;
+    this._pricesIncludeTax = _pricesIncludeTax;
+    this._status = _status;
+    this._type = _type;
+  }
+  _invoiceNumber;
+  _invoiceTime;
+  _randomNumber;
+  /**
+   * Create a new Invoice
+   */
+  static create(props) {
+    if (!props.items || props.items.length === 0) {
+      throw new ValidationError("items", "At least one item is required");
+    }
+    if (props.items.length > 9999) {
+      throw new ValidationError("items", "Maximum 9999 items allowed");
+    }
+    if (props.remark && props.remark.length > 200) {
+      throw new ValidationError(
+        "remark",
+        "Remark must not exceed 200 characters"
+      );
+    }
+    const taxType = _Invoice.determineTaxType(props.items);
+    if (taxType === 2 /* ZERO_RATED */) {
+      if (!props.customsClearanceMark) {
+        throw new ValidationError(
+          "customsClearanceMark",
+          "Customs clearance mark is required for zero-rated invoices"
+        );
+      }
+      if (!props.zeroTaxRateReason) {
+        throw new ValidationError(
+          "zeroTaxRateReason",
+          "Zero tax rate reason is required for zero-rated invoices"
+        );
+      }
+    }
+    const hasCarrier = props.carrier && !props.carrier.isEmpty;
+    const hasDonation = props.donation && props.donation.isDonating;
+    if (hasCarrier && hasDonation) {
+      throw new ValidationError(
+        "carrier",
+        "Cannot have both carrier and donation on the same invoice"
+      );
+    }
+    const isB2B = props.buyer.isCompany;
+    return new _Invoice(
+      props.orderId,
+      props.buyer,
+      props.items,
+      props.carrier ?? Carrier.none(),
+      props.donation ?? Donation.none(),
+      props.remark?.trim() ?? "",
+      props.trackApiCode?.trim() ?? "",
+      taxType,
+      props.customsClearanceMark,
+      props.zeroTaxRateReason,
+      props.brandName?.trim(),
+      props.pricesIncludeTax ?? true,
+      1 /* PENDING */,
+      isB2B ? "A0401" /* B2B_ISSUE */ : "C0401" /* B2C_ISSUE */
+    );
+  }
+  /**
+   * Determine overall tax type from items
+   */
+  static determineTaxType(items) {
+    const taxTypes = new Set(items.map((item) => item.taxType));
+    if (taxTypes.size === 1) {
+      return items[0].taxType;
+    }
+    return 9 /* MIXED */;
+  }
+  // --- Calculated amounts ---
+  /**
+   * Calculate sales amount (應稅銷售額)
+   */
+  calculateSalesAmount() {
+    return this._items.filter((item) => item.taxType === 1 /* TAXABLE */).reduce((sum, item) => sum.add(item.amount), Money.zero()).round();
+  }
+  /**
+   * Calculate free tax sales amount (免稅銷售額)
+   */
+  calculateFreeTaxSalesAmount() {
+    return this._items.filter((item) => item.taxType === 3 /* TAX_EXEMPT */).reduce((sum, item) => sum.add(item.amount), Money.zero()).round();
+  }
+  /**
+   * Calculate zero tax sales amount (零稅率銷售額)
+   */
+  calculateZeroTaxSalesAmount() {
+    return this._items.filter((item) => item.taxType === 2 /* ZERO_RATED */).reduce((sum, item) => sum.add(item.amount), Money.zero()).round();
+  }
+  /**
+   * Calculate tax amount (營業稅額)
+   */
+  calculateTaxAmount() {
+    if (this._buyer.isAnonymous) {
+      return Money.zero();
+    }
+    const salesAmount = this.calculateSalesAmount();
+    if (this._pricesIncludeTax) {
+      const beforeTax = salesAmount.divide(1.05).round();
+      return salesAmount.subtract(beforeTax);
+    } else {
+      return salesAmount.multiply(0.05).round();
+    }
+  }
+  /**
+   * Calculate total amount (總計)
+   */
+  calculateTotalAmount() {
+    const salesAmount = this.calculateSalesAmount();
+    const freeTaxAmount = this.calculateFreeTaxSalesAmount();
+    const zeroTaxAmount = this.calculateZeroTaxSalesAmount();
+    const taxAmount = this.calculateTaxAmount();
+    if (this._pricesIncludeTax) {
+      return salesAmount.add(freeTaxAmount).add(zeroTaxAmount);
+    } else {
+      return salesAmount.add(freeTaxAmount).add(zeroTaxAmount).add(taxAmount);
+    }
+  }
+  // --- State mutations ---
+  /**
+   * Set invoice number after issuing
+   */
+  setInvoiceNumber(number, time, randomNumber) {
+    this._invoiceNumber = number;
+    this._invoiceTime = time;
+    this._randomNumber = randomNumber;
+  }
+  /**
+   * Update status
+   */
+  updateStatus(status) {
+    this._status = status;
+  }
+  /**
+   * Mark as voided
+   */
+  markAsVoided() {
+    this._type = this.isB2B ? "A0501" /* B2B_VOID */ : "C0501" /* B2C_VOID */;
+  }
+  // --- Getters ---
+  get orderId() {
+    return this._orderId;
+  }
+  get invoiceNumber() {
+    return this._invoiceNumber;
+  }
+  get invoiceTime() {
+    return this._invoiceTime;
+  }
+  get randomNumber() {
+    return this._randomNumber;
+  }
+  get buyer() {
+    return this._buyer;
+  }
+  get carrier() {
+    return this._carrier;
+  }
+  get donation() {
+    return this._donation;
+  }
+  get remark() {
+    return this._remark;
+  }
+  get trackApiCode() {
+    return this._trackApiCode;
+  }
+  get items() {
+    return this._items;
+  }
+  get taxType() {
+    return this._taxType;
+  }
+  get customsClearanceMark() {
+    return this._customsClearanceMark;
+  }
+  get zeroTaxRateReason() {
+    return this._zeroTaxRateReason;
+  }
+  get brandName() {
+    return this._brandName;
+  }
+  get pricesIncludeTax() {
+    return this._pricesIncludeTax;
+  }
+  get status() {
+    return this._status;
+  }
+  get type() {
+    return this._type;
+  }
+  /**
+   * Check if this is a B2B invoice (has buyer tax ID)
+   */
+  get isB2B() {
+    return this._buyer.isCompany;
+  }
+  /**
+   * Check if invoice has been issued
+   */
+  get isIssued() {
+    return this._invoiceNumber !== void 0;
+  }
+  /**
+   * Check if invoice has carrier
+   */
+  get hasCarrier() {
+    return !this._carrier.isEmpty;
+  }
+  /**
+   * Check if invoice is donated
+   */
+  get isDonated() {
+    return this._donation.isDonating;
+  }
+  // --- Backward compatibility getters (deprecated) ---
+  /** @deprecated Use buyer.taxId instead */
+  get buyerTaxId() {
+    return this._buyer.taxId;
+  }
+  /** @deprecated Use buyer.name instead */
+  get buyerName() {
+    return this._buyer.name;
+  }
+  /** @deprecated Use buyer.address instead */
+  get buyerAddress() {
+    return this._buyer.address;
+  }
+  /** @deprecated Use buyer.phone instead */
+  get buyerPhone() {
+    return this._buyer.phone;
+  }
+  /** @deprecated Use buyer.email instead */
+  get buyerEmail() {
+    return this._buyer.email;
+  }
+  /** @deprecated Use donation.code instead */
+  get donationCode() {
+    return this._donation.code;
+  }
+};
+
+// src/domain/allowance/Allowance.ts
+var AllowanceStatus = /* @__PURE__ */ ((AllowanceStatus2) => {
+  AllowanceStatus2[AllowanceStatus2["PENDING"] = 1] = "PENDING";
+  AllowanceStatus2[AllowanceStatus2["UPLOADING"] = 2] = "UPLOADING";
+  AllowanceStatus2[AllowanceStatus2["UPLOADED"] = 3] = "UPLOADED";
+  AllowanceStatus2[AllowanceStatus2["PROCESSING"] = 31] = "PROCESSING";
+  AllowanceStatus2[AllowanceStatus2["AWAITING_CONFIRMATION"] = 32] = "AWAITING_CONFIRMATION";
+  AllowanceStatus2[AllowanceStatus2["ERROR"] = 91] = "ERROR";
+  AllowanceStatus2[AllowanceStatus2["COMPLETED"] = 99] = "COMPLETED";
+  return AllowanceStatus2;
+})(AllowanceStatus || {});
+var AllowanceType = /* @__PURE__ */ ((AllowanceType2) => {
+  AllowanceType2["B2C_ISSUE"] = "C0701";
+  AllowanceType2["B2C_VOID"] = "C0801";
+  AllowanceType2["B2B_ISSUE"] = "A0701";
+  AllowanceType2["B2B_VOID"] = "A0801";
+  return AllowanceType2;
+})(AllowanceType || {});
+var Allowance = class _Allowance {
+  constructor(_originalInvoiceNumber, _originalInvoiceDate, _buyerTaxId, _sellerTaxId, _buyerName, _sellerName, _items, _taxType, _pricesIncludeTax = true, _status = 1 /* PENDING */, _type = "C0701" /* B2C_ISSUE */) {
+    this._originalInvoiceNumber = _originalInvoiceNumber;
+    this._originalInvoiceDate = _originalInvoiceDate;
+    this._buyerTaxId = _buyerTaxId;
+    this._sellerTaxId = _sellerTaxId;
+    this._buyerName = _buyerName;
+    this._sellerName = _sellerName;
+    this._items = _items;
+    this._taxType = _taxType;
+    this._pricesIncludeTax = _pricesIncludeTax;
+    this._status = _status;
+    this._type = _type;
+  }
+  _allowanceNumber;
+  _allowanceDate;
+  /**
+   * Create a new Allowance
+   */
+  static create(props) {
+    if (!props.items || props.items.length === 0) {
+      throw new ValidationError("items", "At least one item is required");
+    }
+    if (props.items.length > 9999) {
+      throw new ValidationError("items", "Maximum 9999 items allowed");
+    }
+    const taxType = _Allowance.determineTaxType(props.items);
+    const isB2B = !props.buyerTaxId.isNone();
+    return new _Allowance(
+      props.originalInvoiceNumber,
+      props.originalInvoiceDate,
+      props.buyerTaxId,
+      props.sellerTaxId,
+      props.buyerName?.trim() ?? "",
+      props.sellerName?.trim() ?? "",
+      props.items,
+      taxType,
+      props.pricesIncludeTax ?? true,
+      1 /* PENDING */,
+      isB2B ? "A0701" /* B2B_ISSUE */ : "C0701" /* B2C_ISSUE */
+    );
+  }
+  /**
+   * Determine overall tax type from items
+   */
+  static determineTaxType(items) {
+    const taxTypes = new Set(items.map((item) => item.taxType));
+    if (taxTypes.size === 1) {
+      return items[0].taxType;
+    }
+    return 9 /* MIXED */;
+  }
+  // --- Calculated amounts ---
+  /**
+   * Calculate taxable sales amount (應稅銷售額)
+   */
+  calculateTaxableAmount() {
+    return this._items.filter((item) => item.taxType === 1 /* TAXABLE */).reduce((sum, item) => sum.add(item.amount), Money.zero()).round();
+  }
+  /**
+   * Calculate free tax sales amount (免稅銷售額)
+   */
+  calculateFreeTaxAmount() {
+    return this._items.filter((item) => item.taxType === 3 /* TAX_EXEMPT */).reduce((sum, item) => sum.add(item.amount), Money.zero()).round();
+  }
+  /**
+   * Calculate zero tax sales amount (零稅率銷售額)
+   */
+  calculateZeroTaxAmount() {
+    return this._items.filter((item) => item.taxType === 2 /* ZERO_RATED */).reduce((sum, item) => sum.add(item.amount), Money.zero()).round();
+  }
+  /**
+   * Calculate tax amount (營業稅額)
+   */
+  calculateTaxAmount() {
+    const taxableAmount = this.calculateTaxableAmount();
+    if (this._pricesIncludeTax) {
+      const beforeTax = taxableAmount.divide(1 + TAX_RATE).round();
+      return taxableAmount.subtract(beforeTax);
+    } else {
+      return taxableAmount.multiply(TAX_RATE).round();
+    }
+  }
+  /**
+   * Calculate total amount (總計)
+   */
+  calculateTotalAmount() {
+    const taxableAmount = this.calculateTaxableAmount();
+    const freeTaxAmount = this.calculateFreeTaxAmount();
+    const zeroTaxAmount = this.calculateZeroTaxAmount();
+    const taxAmount = this.calculateTaxAmount();
+    if (this._pricesIncludeTax) {
+      return taxableAmount.add(freeTaxAmount).add(zeroTaxAmount);
+    } else {
+      return taxableAmount.add(freeTaxAmount).add(zeroTaxAmount).add(taxAmount);
+    }
+  }
+  // --- State mutations ---
+  /**
+   * Set allowance number after issuing
+   */
+  setAllowanceNumber(number, date) {
+    this._allowanceNumber = number;
+    this._allowanceDate = date;
+  }
+  /**
+   * Update status
+   */
+  updateStatus(status) {
+    this._status = status;
+  }
+  /**
+   * Mark as voided
+   */
+  markAsVoided() {
+    this._type = this.isB2B ? "A0801" /* B2B_VOID */ : "C0801" /* B2C_VOID */;
+  }
+  // --- Getters ---
+  get originalInvoiceNumber() {
+    return this._originalInvoiceNumber;
+  }
+  get originalInvoiceDate() {
+    return this._originalInvoiceDate;
+  }
+  get allowanceNumber() {
+    return this._allowanceNumber;
+  }
+  get allowanceDate() {
+    return this._allowanceDate;
+  }
+  get buyerTaxId() {
+    return this._buyerTaxId;
+  }
+  get sellerTaxId() {
+    return this._sellerTaxId;
+  }
+  get buyerName() {
+    return this._buyerName;
+  }
+  get sellerName() {
+    return this._sellerName;
+  }
+  get items() {
+    return this._items;
+  }
+  get taxType() {
+    return this._taxType;
+  }
+  get pricesIncludeTax() {
+    return this._pricesIncludeTax;
+  }
+  get status() {
+    return this._status;
+  }
+  get type() {
+    return this._type;
+  }
+  /**
+   * Check if this is a B2B allowance (has buyer tax ID)
+   */
+  get isB2B() {
+    return !this._buyerTaxId.isNone();
+  }
+  /**
+   * Check if allowance has been issued
+   */
+  get isIssued() {
+    return this._allowanceNumber !== void 0;
+  }
+};
+
+// src/infrastructure/amego/AmegoMapper.ts
+var AmegoMapper = class _AmegoMapper {
+  /**
+   * Convert Invoice domain object to API payload
+   */
+  static toInvoicePayload(invoice) {
+    const salesAmount = invoice.calculateSalesAmount().toNumber();
+    const freeTaxSalesAmount = invoice.calculateFreeTaxSalesAmount().toNumber();
+    const zeroTaxSalesAmount = invoice.calculateZeroTaxSalesAmount().toNumber();
+    const taxAmount = invoice.calculateTaxAmount().toNumber();
+    const totalAmount = invoice.calculateTotalAmount().toNumber();
+    const payload = {
+      OrderId: invoice.orderId.toString(),
+      BuyerIdentifier: invoice.buyer.taxId.isNone() ? "0000000000" : invoice.buyer.taxId.toString(),
+      BuyerName: invoice.buyer.name,
+      ProductItem: invoice.items.map(_AmegoMapper.toInvoiceItemPayload),
+      SalesAmount: salesAmount,
+      FreeTaxSalesAmount: freeTaxSalesAmount,
+      ZeroTaxSalesAmount: zeroTaxSalesAmount,
+      TaxType: _AmegoMapper.toApiTaxType(invoice.taxType),
+      TaxRate: "0.05",
+      TaxAmount: taxAmount,
+      TotalAmount: totalAmount,
+      DetailVat: invoice.pricesIncludeTax ? 1 : 0
+    };
+    if (invoice.trackApiCode) {
+      payload.TrackApiCode = invoice.trackApiCode;
+    }
+    if (invoice.buyer.address) {
+      payload.BuyerAddress = invoice.buyer.address;
+    }
+    if (invoice.buyer.phone) {
+      payload.BuyerTelephoneNumber = invoice.buyer.phone;
+    }
+    if (invoice.buyer.email) {
+      payload.BuyerEmailAddress = invoice.buyer.email;
+    }
+    if (invoice.remark) {
+      payload.MainRemark = invoice.remark;
+    }
+    if (invoice.hasCarrier) {
+      payload.CarrierType = invoice.carrier.typeCode;
+      payload.CarrierId1 = invoice.carrier.id;
+      payload.CarrierId2 = invoice.carrier.id;
+    }
+    if (invoice.isDonated) {
+      payload.NPOBAN = invoice.donation.code;
+    }
+    if (invoice.customsClearanceMark !== void 0) {
+      payload.CustomsClearanceMark = invoice.customsClearanceMark;
+    }
+    if (invoice.zeroTaxRateReason !== void 0) {
+      payload.ZeroTaxRateReason = invoice.zeroTaxRateReason;
+    }
+    if (invoice.brandName) {
+      payload.BrandName = invoice.brandName;
+    }
+    return payload;
+  }
+  /**
+   * Convert InvoiceItem to API payload (ProductItem)
+   */
+  static toInvoiceItemPayload(item) {
+    const payload = {
+      Description: item.description,
+      Quantity: item.quantity,
+      UnitPrice: item.unitPrice.toNumber(),
+      Amount: item.amount.toNumber(),
+      TaxType: _AmegoMapper.toApiTaxType(item.taxType)
+    };
+    if (item.unit) {
+      payload.Unit = item.unit;
+    }
+    if (item.remark) {
+      payload.Remark = item.remark;
+    }
+    return payload;
+  }
+  /**
+   * Convert Allowance domain object to API payload
+   */
+  static toAllowancePayload(allowance, allowanceNumber) {
+    let totalAmount = 0;
+    let taxAmount = 0;
+    const items = allowance.items.map((item) => {
+      const amount = item.amount.toNumber();
+      const tax = Math.round(amount * 0.05);
+      totalAmount += amount;
+      taxAmount += tax;
+      return {
+        OriginalInvoiceNumber: allowance.originalInvoiceNumber.toString(),
+        OriginalInvoiceDate: _AmegoMapper.formatDateNumber(
+          allowance.originalInvoiceDate
+        ),
+        OriginalDescription: item.originalDescription,
+        Quantity: item.quantity,
+        UnitPrice: item.unitPrice.toNumber(),
+        Amount: amount,
+        Tax: tax,
+        TaxType: _AmegoMapper.toApiTaxType(item.taxType),
+        Unit: item.unit
+      };
+    });
+    const payload = {
+      AllowanceNumber: allowanceNumber,
+      AllowanceDate: _AmegoMapper.formatDate(/* @__PURE__ */ new Date()),
+      AllowanceType: 2,
+      // 賣方折讓證明通知單
+      BuyerIdentifier: allowance.buyerTaxId.isNone() ? "0000000000" : allowance.buyerTaxId.toString(),
+      BuyerName: allowance.buyerName ?? "",
+      ProductItem: items,
+      TaxAmount: taxAmount,
+      TotalAmount: totalAmount
+    };
+    return payload;
+  }
+  /**
+   * Convert AllowanceItem to API payload
+   */
+  static toAllowanceItemPayload(item, originalInvoiceNumber, originalInvoiceDate) {
+    const amount = item.amount.toNumber();
+    const tax = Math.round(amount * 0.05);
+    return {
+      OriginalInvoiceNumber: originalInvoiceNumber,
+      OriginalInvoiceDate: _AmegoMapper.formatDateNumber(originalInvoiceDate),
+      OriginalDescription: item.originalDescription,
+      Quantity: item.quantity,
+      UnitPrice: item.unitPrice.toNumber(),
+      Amount: amount,
+      Tax: tax,
+      TaxType: _AmegoMapper.toApiTaxType(item.taxType),
+      Unit: item.unit
+    };
+  }
+  /**
+   * Convert domain TaxType to API tax type number
+   */
+  static toApiTaxType(taxType) {
+    switch (taxType) {
+      case 1 /* TAXABLE */:
+        return 1;
+      case 2 /* ZERO_RATED */:
+        return 2;
+      case 3 /* TAX_EXEMPT */:
+        return 3;
+      case 9 /* MIXED */:
+        return 9;
+      default:
+        return 1;
+    }
+  }
+  /**
+   * Convert API tax type number to domain TaxType
+   */
+  static fromApiTaxType(apiTaxType) {
+    switch (apiTaxType) {
+      case 1:
+        return 1 /* TAXABLE */;
+      case 2:
+        return 2 /* ZERO_RATED */;
+      case 3:
+        return 3 /* TAX_EXEMPT */;
+      case 4:
+        return 1 /* TAXABLE */;
+      // 特種稅率 -> 應稅
+      case 9:
+        return 9 /* MIXED */;
+      default:
+        return 1 /* TAXABLE */;
+    }
+  }
+  /**
+   * Convert API status code to InvoiceStatus
+   */
+  static toInvoiceStatus(status) {
+    switch (status) {
+      case 1:
+        return 1 /* PENDING */;
+      case 2:
+        return 2 /* UPLOADING */;
+      case 3:
+        return 3 /* UPLOADED */;
+      case 31:
+        return 31 /* PROCESSING */;
+      case 32:
+        return 32 /* AWAITING_CONFIRMATION */;
+      case 91:
+        return 91 /* ERROR */;
+      case 99:
+        return 99 /* COMPLETED */;
+      default:
+        return 1 /* PENDING */;
+    }
+  }
+  /**
+   * Convert API status code to AllowanceStatus
+   */
+  static toAllowanceStatus(status) {
+    switch (status) {
+      case 1:
+        return 1 /* PENDING */;
+      case 2:
+        return 2 /* UPLOADING */;
+      case 3:
+        return 3 /* UPLOADED */;
+      case 31:
+        return 31 /* PROCESSING */;
+      case 32:
+        return 32 /* AWAITING_CONFIRMATION */;
+      case 91:
+        return 91 /* ERROR */;
+      case 99:
+        return 99 /* COMPLETED */;
+      default:
+        return 1 /* PENDING */;
+    }
+  }
+  /**
+   * Format date to YYYYMMDD string
+   */
+  static formatDate(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    return `${year}${month}${day}`;
+  }
+  /**
+   * Format date to YYYYMMDD number
+   */
+  static formatDateNumber(date) {
+    return parseInt(_AmegoMapper.formatDate(date), 10);
+  }
+  /**
+   * Parse YYYYMMDD (string or number) to Date
+   */
+  static parseDate(dateValue) {
+    const dateStr = String(dateValue);
+    const year = parseInt(dateStr.substring(0, 4), 10);
+    const month = parseInt(dateStr.substring(4, 6), 10) - 1;
+    const day = parseInt(dateStr.substring(6, 8), 10);
+    return new Date(year, month, day);
+  }
+  /**
+   * Parse Unix timestamp to Date
+   */
+  static parseUnixTimestamp(timestamp) {
+    return new Date(timestamp * 1e3);
+  }
+  /**
+   * Parse ISO date string to Date
+   */
+  static parseIsoDate(isoStr) {
+    return new Date(isoStr);
+  }
+};
+
+// src/domain/invoice/InvoiceNumber.ts
+var InvoiceNumber = class _InvoiceNumber {
+  constructor(value) {
+    this.value = value;
+  }
+  static PATTERN = /^[A-Z]{2}\d{8}$/;
+  /**
+   * Create an InvoiceNumber from string
+   * @throws InvalidInvoiceNumberError if format is invalid
+   */
+  static create(value) {
+    const normalized = value.trim().toUpperCase();
+    if (!_InvoiceNumber.isValid(normalized)) {
+      throw new InvalidInvoiceNumberError(value);
+    }
+    return new _InvoiceNumber(normalized);
+  }
+  /**
+   * Try to create an InvoiceNumber, return null if invalid
+   */
+  static tryCreate(value) {
+    try {
+      return _InvoiceNumber.create(value);
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Validate invoice number format
+   */
+  static isValid(value) {
+    return _InvoiceNumber.PATTERN.test(value);
+  }
+  /**
+   * Get the track (字軌) - first 2 letters
+   */
+  getTrack() {
+    return this.value.substring(0, 2);
+  }
+  /**
+   * Get the number part - last 8 digits
+   */
+  getNumber() {
+    return this.value.substring(2);
+  }
+  /**
+   * Get the full invoice number
+   */
+  toString() {
+    return this.value;
+  }
+  /**
+   * Check equality
+   */
+  equals(other) {
+    return this.value === other.value;
+  }
+};
+
+// src/domain/invoice/InvoiceItem.ts
+var InvoiceItem = class _InvoiceItem {
+  constructor(_description, _quantity, _unitPrice, _amount, _unit, _remark, _taxType) {
+    this._description = _description;
+    this._quantity = _quantity;
+    this._unitPrice = _unitPrice;
+    this._amount = _amount;
+    this._unit = _unit;
+    this._remark = _remark;
+    this._taxType = _taxType;
+  }
+  /**
+   * Create an InvoiceItem
+   */
+  static create(props) {
+    if (!props.description || props.description.trim().length === 0) {
+      throw new ValidationError("description", "Description is required");
+    }
+    if (props.description.length > 256) {
+      throw new ValidationError(
+        "description",
+        "Description must not exceed 256 characters"
+      );
+    }
+    if (props.quantity === 0) {
+      throw new ValidationError("quantity", "Quantity cannot be zero");
+    }
+    if (props.unit && props.unit.length > 6) {
+      throw new ValidationError("unit", "Unit must not exceed 6 characters");
+    }
+    if (props.remark && props.remark.length > 40) {
+      throw new ValidationError("remark", "Remark must not exceed 40 characters");
+    }
+    return new _InvoiceItem(
+      props.description.trim(),
+      props.quantity,
+      props.unitPrice,
+      props.amount,
+      props.unit?.trim() ?? "",
+      props.remark?.trim() ?? "",
+      props.taxType ?? 1 /* TAXABLE */
+    );
+  }
+  /**
+   * Create an InvoiceItem with auto-calculated amount
+   */
+  static createWithAutoAmount(props) {
+    const amount = props.unitPrice.multiply(props.quantity);
+    return _InvoiceItem.create({ ...props, amount });
+  }
+  // Getters
+  get description() {
+    return this._description;
+  }
+  get quantity() {
+    return this._quantity;
+  }
+  get unitPrice() {
+    return this._unitPrice;
+  }
+  get amount() {
+    return this._amount;
+  }
+  get unit() {
+    return this._unit;
+  }
+  get remark() {
+    return this._remark;
+  }
+  get taxType() {
+    return this._taxType;
+  }
+  /**
+   * Check if this is a discount item (negative amount)
+   */
+  isDiscount() {
+    return this._amount.isNegative();
+  }
+};
+
+// src/domain/shared/TaxId.ts
+var TaxId = class _TaxId {
+  constructor(value) {
+    this.value = value;
+  }
+  static WEIGHTS = [1, 2, 1, 2, 1, 2, 4, 1];
+  static NO_TAX_ID = "0000000000";
+  /**
+   * Create a TaxId from string
+   * @throws InvalidTaxIdError if the tax ID is invalid
+   */
+  static create(value) {
+    const normalized = value.trim();
+    if (!_TaxId.isValid(normalized)) {
+      throw new InvalidTaxIdError(value);
+    }
+    return new _TaxId(normalized);
+  }
+  /**
+   * Create a "no tax ID" placeholder (0000000000)
+   * Used for B2C invoices without buyer's tax ID
+   */
+  static none() {
+    return new _TaxId(_TaxId.NO_TAX_ID);
+  }
+  /**
+   * Try to create a TaxId, return null if invalid
+   */
+  static tryCreate(value) {
+    try {
+      return _TaxId.create(value);
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Validate a tax ID string
+   */
+  static isValid(value) {
+    if (value === _TaxId.NO_TAX_ID) {
+      return true;
+    }
+    if (!/^\d{8}$/.test(value)) {
+      return false;
+    }
+    return _TaxId.validateChecksum(value);
+  }
+  /**
+   * Validate checksum using the official algorithm
+   *
+   * Algorithm:
+   * 1. Multiply each digit by its weight [1,2,1,2,1,2,4,1]
+   * 2. For each product, sum its digits (e.g., 18 -> 1+8=9)
+   * 3. Sum all results
+   * 4. If 7th digit is 7, check both (sum % 10 === 0) or ((sum + 1) % 10 === 0)
+   * 5. Otherwise, check (sum % 10 === 0)
+   */
+  static validateChecksum(value) {
+    const digits = value.split("").map(Number);
+    let sum = 0;
+    for (let i = 0; i < 8; i++) {
+      const product = digits[i] * _TaxId.WEIGHTS[i];
+      sum += Math.floor(product / 10) + product % 10;
+    }
+    if (digits[6] === 7) {
+      return sum % 10 === 0 || (sum + 1) % 10 === 0;
+    }
+    return sum % 10 === 0;
+  }
+  /**
+   * Check if this is a "no tax ID" placeholder
+   */
+  isNone() {
+    return this.value === _TaxId.NO_TAX_ID;
+  }
+  /**
+   * Get the string value
+   */
+  toString() {
+    return this.value;
+  }
+  /**
+   * Check equality with another TaxId
+   */
+  equals(other) {
+    return this.value === other.value;
+  }
+};
+
+// src/domain/shared/OrderId.ts
+var OrderId = class _OrderId {
+  constructor(value) {
+    this.value = value;
+  }
+  static MAX_LENGTH = 40;
+  /**
+   * Create an OrderId
+   * @throws ValidationError if invalid
+   */
+  static create(value) {
+    const trimmed = value?.trim();
+    if (!trimmed || trimmed.length === 0) {
+      throw new ValidationError("orderId", "Order ID is required");
+    }
+    if (trimmed.length > _OrderId.MAX_LENGTH) {
+      throw new ValidationError(
+        "orderId",
+        `Order ID must not exceed ${_OrderId.MAX_LENGTH} characters`
+      );
+    }
+    return new _OrderId(trimmed);
+  }
+  /**
+   * Try to create an OrderId, returns null if invalid
+   */
+  static tryCreate(value) {
+    try {
+      return _OrderId.create(value);
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Get the string value
+   */
+  toString() {
+    return this.value;
+  }
+  /**
+   * Check equality
+   */
+  equals(other) {
+    return this.value === other.value;
+  }
+};
+
+// src/domain/shared/Buyer.ts
+var Buyer = class _Buyer {
+  constructor(_type, _taxId, _name, _address, _phone, _email) {
+    this._type = _type;
+    this._taxId = _taxId;
+    this._name = _name;
+    this._address = _address;
+    this._phone = _phone;
+    this._email = _email;
+  }
+  /**
+   * Create an anonymous buyer (B2C)
+   * @param name Buyer name (default: '消費者')
+   */
+  static anonymous(name) {
+    const trimmedName = name === void 0 ? "\u6D88\u8CBB\u8005" : name.trim();
+    _Buyer.validateName(trimmedName);
+    return new _Buyer(
+      "anonymous" /* ANONYMOUS */,
+      TaxId.none(),
+      trimmedName,
+      "",
+      "",
+      ""
+    );
+  }
+  /**
+   * Create a company buyer (B2B)
+   */
+  static company(props) {
+    const name = props.name?.trim();
+    _Buyer.validateName(name);
+    if (props.taxId.isNone()) {
+      throw new ValidationError("taxId", "Company buyer must have a tax ID");
+    }
+    return new _Buyer(
+      "company" /* COMPANY */,
+      props.taxId,
+      name,
+      props.address?.trim() ?? "",
+      props.phone?.trim() ?? "",
+      props.email?.trim() ?? ""
+    );
+  }
+  /**
+   * Validate buyer name
+   */
+  static validateName(name) {
+    if (!name || name.length === 0) {
+      throw new ValidationError("buyerName", "Buyer name is required");
+    }
+    const invalidNames = ["0", "00", "000", "0000"];
+    if (invalidNames.includes(name)) {
+      throw new ValidationError(
+        "buyerName",
+        "Buyer name cannot be 0, 00, 000, or 0000"
+      );
+    }
+  }
+  /**
+   * Get the buyer type
+   */
+  get type() {
+    return this._type;
+  }
+  /**
+   * Get the tax ID
+   */
+  get taxId() {
+    return this._taxId;
+  }
+  /**
+   * Get the name
+   */
+  get name() {
+    return this._name;
+  }
+  /**
+   * Get the address
+   */
+  get address() {
+    return this._address;
+  }
+  /**
+   * Get the phone
+   */
+  get phone() {
+    return this._phone;
+  }
+  /**
+   * Get the email
+   */
+  get email() {
+    return this._email;
+  }
+  /**
+   * Check if this is a B2B buyer (company)
+   */
+  get isCompany() {
+    return this._type === "company" /* COMPANY */;
+  }
+  /**
+   * Check if this is a B2C buyer (anonymous)
+   */
+  get isAnonymous() {
+    return this._type === "anonymous" /* ANONYMOUS */;
+  }
+};
+
+// src/infrastructure/amego/AmegoInvoiceRepository.ts
+var AmegoInvoiceRepository = class {
+  client;
+  constructor(config) {
+    this.client = new AmegoClient(config);
+  }
+  /**
+   * Issue a new invoice (開立發票)
+   *
+   * 使用 /json/f0401 endpoint
+   */
+  async issue(invoice) {
+    const payload = AmegoMapper.toInvoicePayload(invoice);
+    const response = await this.client.post(
+      AMEGO_ENDPOINTS.INVOICE_ISSUE,
+      payload
+    );
+    const invoiceNumber = InvoiceNumber.create(response.invoice_number);
+    const invoiceTime = AmegoMapper.parseUnixTimestamp(response.invoice_time);
+    invoice.setInvoiceNumber(
+      invoiceNumber,
+      invoiceTime,
+      response.random_number
+    );
+    invoice.updateStatus(3 /* UPLOADED */);
+    return {
+      invoiceNumber,
+      invoiceTime,
+      randomNumber: response.random_number,
+      barcode: response.barcode ?? "",
+      qrcodeLeft: response.qrcode_left ?? "",
+      qrcodeRight: response.qrcode_right ?? "",
+      printData: response.base64_data
+    };
+  }
+  /**
+   * Void an invoice (作廢發票)
+   *
+   * 使用 /json/f0501 endpoint
+   */
+  async void(invoiceNumber) {
+    const payload = {
+      CancelInvoiceNumber: invoiceNumber.toString()
+    };
+    await this.client.post(AMEGO_ENDPOINTS.INVOICE_VOID, payload);
+  }
+  /**
+   * Query invoice by invoice number (查詢發票 - 依發票號碼)
+   *
+   * 使用 /json/invoice_query endpoint
+   */
+  async findByInvoiceNumber(invoiceNumber) {
+    try {
+      const payload = {
+        type: "invoice",
+        invoice_number: invoiceNumber.toString()
+      };
+      const response = await this.client.post(
+        AMEGO_ENDPOINTS.INVOICE_QUERY,
+        payload
+      );
+      if (!response.data) {
+        return null;
+      }
+      return this.mapQueryResponse(response.data);
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Query invoice by order ID (查詢發票 - 依訂單編號)
+   *
+   * 使用 /json/invoice_query endpoint
+   */
+  async findByOrderId(orderId) {
+    try {
+      const payload = {
+        type: "order",
+        order_id: orderId
+      };
+      const response = await this.client.post(
+        AMEGO_ENDPOINTS.INVOICE_QUERY,
+        payload
+      );
+      if (!response.data) {
+        return null;
+      }
+      return this.mapQueryResponse(response.data);
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Check invoice status (查詢發票狀態)
+   *
+   * 使用 /json/invoice_status endpoint
+   */
+  async getStatus(invoiceNumbers) {
+    const results = [];
+    for (const invoiceNumber of invoiceNumbers) {
+      try {
+        const payload = {
+          InvoiceNumber: invoiceNumber.toString()
+        };
+        const response = await this.client.post(
+          AMEGO_ENDPOINTS.INVOICE_STATUS,
+          payload
+        );
+        if (response.data && response.data.length > 0) {
+          for (const item of response.data) {
+            results.push({
+              invoiceNumber: item.invoice_number,
+              type: item.type,
+              status: AmegoMapper.toInvoiceStatus(item.status),
+              totalAmount: item.total_amount
+            });
+          }
+        }
+      } catch {
+      }
+    }
+    return results;
+  }
+  /**
+   * List invoices (發票列表)
+   *
+   * 使用 /json/invoice_list endpoint
+   */
+  async list(options) {
+    const dateStart = parseInt(options.startDate, 10);
+    const dateEnd = parseInt(options.endDate, 10);
+    const payload = {
+      date_select: options.dateType,
+      date_start: dateStart,
+      date_end: dateEnd,
+      limit: options.limit ?? 20,
+      page: options.page ?? 1
+    };
+    const response = await this.client.post(
+      AMEGO_ENDPOINTS.INVOICE_LIST,
+      payload
+    );
+    const invoices = (response.data ?? []).map(
+      (item) => this.mapListItemResponse(item)
+    );
+    return {
+      invoices,
+      totalPages: response.page_total ?? 1,
+      currentPage: response.page_now ?? 1,
+      totalCount: response.data_total ?? 0
+    };
+  }
+  /**
+   * Map API query response to domain query result
+   */
+  mapQueryResponse(response) {
+    const items = (response.product_item ?? []).map(
+      (item) => InvoiceItem.create({
+        description: item.description,
+        quantity: item.quantity,
+        unitPrice: Money.create(item.unit_price),
+        amount: Money.create(item.amount),
+        unit: item.unit || void 0,
+        remark: item.remark || void 0,
+        taxType: AmegoMapper.fromApiTaxType(item.tax_type)
+      })
+    );
+    const buyerTaxId = TaxId.tryCreate(response.buyer_identifier) ?? TaxId.none();
+    const buyer = buyerTaxId.isNone() ? Buyer.anonymous(response.buyer_name || "\u6D88\u8CBB\u8005") : Buyer.company({
+      taxId: buyerTaxId,
+      name: response.buyer_name || "",
+      address: response.buyer_address || void 0,
+      phone: response.buyer_telephone_number || void 0,
+      email: response.buyer_email_address || void 0
+    });
+    const carrier = this.buildCarrier(
+      response.carrier_type,
+      response.carrier_id1
+    );
+    const donation = response.npoban ? Donation.tryCreate(response.npoban) : Donation.none();
+    const invoice = Invoice.create({
+      orderId: OrderId.create(response.order_id || response.invoice_number),
+      buyer,
+      items,
+      carrier,
+      donation,
+      remark: response.main_remark || void 0
+    });
+    const invoiceNumber = InvoiceNumber.create(response.invoice_number);
+    const invoiceTime = AmegoMapper.parseIsoDate(response.invoice_time);
+    invoice.setInvoiceNumber(invoiceNumber, invoiceTime, response.random_number);
+    invoice.updateStatus(AmegoMapper.toInvoiceStatus(response.invoice_status));
+    return {
+      invoice,
+      status: AmegoMapper.toInvoiceStatus(response.invoice_status)
+    };
+  }
+  /**
+   * Map API list item response to domain query result
+   */
+  mapListItemResponse(item) {
+    const placeholderItem = InvoiceItem.create({
+      description: "\uFF08\u8A73\u7D30\u8ACB\u67E5\u8A62\u55AE\u5F35\u767C\u7968\uFF09",
+      quantity: 1,
+      unitPrice: Money.create(item.total_amount),
+      amount: Money.create(item.total_amount),
+      taxType: AmegoMapper.fromApiTaxType(item.tax_type)
+    });
+    const buyerTaxId = TaxId.tryCreate(item.buyer_identifier) ?? TaxId.none();
+    const buyer = buyerTaxId.isNone() ? Buyer.anonymous(item.buyer_name || "\u6D88\u8CBB\u8005") : Buyer.company({
+      taxId: buyerTaxId,
+      name: item.buyer_name || "",
+      address: item.buyer_address || void 0,
+      phone: item.buyer_telephone_number || void 0,
+      email: item.buyer_email_address || void 0
+    });
+    const carrier = this.buildCarrier(item.carrier_type, item.carrier_id1);
+    const donation = item.npoban ? Donation.tryCreate(item.npoban) : Donation.none();
+    const invoice = Invoice.create({
+      orderId: OrderId.create(item.order_id || item.invoice_number),
+      buyer,
+      items: [placeholderItem],
+      carrier,
+      donation,
+      remark: item.main_remark || void 0
+    });
+    const invoiceNumber = InvoiceNumber.create(item.invoice_number);
+    const invoiceTime = AmegoMapper.parseIsoDate(item.invoice_time);
+    invoice.setInvoiceNumber(invoiceNumber, invoiceTime, item.random_number);
+    invoice.updateStatus(AmegoMapper.toInvoiceStatus(item.invoice_status));
+    return {
+      invoice,
+      status: AmegoMapper.toInvoiceStatus(item.invoice_status)
+    };
+  }
+  /**
+   * Build Carrier from API response fields
+   */
+  buildCarrier(carrierType, carrierId) {
+    if (!carrierType || carrierType === "") {
+      return Carrier.none();
+    }
+    switch (carrierType) {
+      case "3J0002" /* MOBILE */:
+        return Carrier.mobile(carrierId);
+      case "CQ0001" /* CERTIFICATE */:
+        return Carrier.certificate(carrierId);
+      default:
+        return Carrier.custom(carrierType, carrierId);
+    }
+  }
+};
+
+// src/domain/shared/Pagination.ts
+var Pagination = class _Pagination {
+  constructor(_page, _limit) {
+    this._page = _page;
+    this._limit = _limit;
+  }
+  static DEFAULT_LIMIT = 20;
+  static MIN_LIMIT = 20;
+  static MAX_LIMIT = 500;
+  /**
+   * Create pagination with specified page and limit
+   */
+  static create(options = {}) {
+    const page = options.page ?? 1;
+    const limit = options.limit ?? _Pagination.DEFAULT_LIMIT;
+    if (page < 1) {
+      throw new ValidationError("page", "Page must be at least 1");
+    }
+    if (limit < _Pagination.MIN_LIMIT || limit > _Pagination.MAX_LIMIT) {
+      throw new ValidationError(
+        "limit",
+        `Limit must be between ${_Pagination.MIN_LIMIT} and ${_Pagination.MAX_LIMIT}`
+      );
+    }
+    return new _Pagination(page, limit);
+  }
+  /**
+   * Create first page with default limit
+   */
+  static first(limit) {
+    return _Pagination.create({ page: 1, limit });
+  }
+  /**
+   * Get the page number (1-based)
+   */
+  get page() {
+    return this._page;
+  }
+  /**
+   * Get the limit (items per page)
+   */
+  get limit() {
+    return this._limit;
+  }
+  /**
+   * Get the offset (0-based, for SQL queries)
+   */
+  get offset() {
+    return (this._page - 1) * this._limit;
+  }
+  /**
+   * Create next page pagination
+   */
+  next() {
+    return new _Pagination(this._page + 1, this._limit);
+  }
+  /**
+   * Create previous page pagination (min page 1)
+   */
+  previous() {
+    return new _Pagination(Math.max(1, this._page - 1), this._limit);
+  }
+};
+function createPaginatedResult(items, totalCount, pagination) {
+  const totalPages = Math.ceil(totalCount / pagination.limit);
+  return {
+    items,
+    totalCount,
+    totalPages,
+    currentPage: pagination.page,
+    pageSize: pagination.limit,
+    hasNextPage: pagination.page < totalPages,
+    hasPreviousPage: pagination.page > 1
+  };
+}
+
+// src/domain/shared/LocalDate.ts
+var LocalDate = class _LocalDate {
+  constructor(_year, _month, _day) {
+    this._year = _year;
+    this._month = _month;
+    this._day = _day;
+  }
+  /**
+   * Create a LocalDate from year, month, day
+   */
+  static of(year, month, day) {
+    if (month < 1 || month > 12) {
+      throw new ValidationError("month", "Month must be between 1 and 12");
+    }
+    if (day < 1 || day > 31) {
+      throw new ValidationError("day", "Day must be between 1 and 31");
+    }
+    return new _LocalDate(year, month, day);
+  }
+  /**
+   * Create a LocalDate from a JavaScript Date
+   */
+  static fromDate(date) {
+    return new _LocalDate(
+      date.getFullYear(),
+      date.getMonth() + 1,
+      date.getDate()
+    );
+  }
+  /**
+   * Create a LocalDate from YYYYMMDD string or number
+   */
+  static parse(value) {
+    const str = String(value);
+    if (str.length !== 8) {
+      throw new ValidationError("date", "Date must be in YYYYMMDD format");
+    }
+    const year = parseInt(str.substring(0, 4), 10);
+    const month = parseInt(str.substring(4, 6), 10);
+    const day = parseInt(str.substring(6, 8), 10);
+    return _LocalDate.of(year, month, day);
+  }
+  /**
+   * Get today's date
+   */
+  static today() {
+    return _LocalDate.fromDate(/* @__PURE__ */ new Date());
+  }
+  /**
+   * Get the year
+   */
+  get year() {
+    return this._year;
+  }
+  /**
+   * Get the month (1-12)
+   */
+  get month() {
+    return this._month;
+  }
+  /**
+   * Get the day of month
+   */
+  get day() {
+    return this._day;
+  }
+  /**
+   * Convert to YYYYMMDD number (for API calls)
+   */
+  toNumber() {
+    return this._year * 1e4 + this._month * 100 + this._day;
+  }
+  /**
+   * Convert to YYYYMMDD string
+   */
+  toString() {
+    const month = String(this._month).padStart(2, "0");
+    const day = String(this._day).padStart(2, "0");
+    return `${this._year}${month}${day}`;
+  }
+  /**
+   * Convert to JavaScript Date (at midnight)
+   */
+  toDate() {
+    return new Date(this._year, this._month - 1, this._day);
+  }
+  /**
+   * Convert to ISO date string (YYYY-MM-DD)
+   */
+  toISOString() {
+    const month = String(this._month).padStart(2, "0");
+    const day = String(this._day).padStart(2, "0");
+    return `${this._year}-${month}-${day}`;
+  }
+  /**
+   * Check if this date is before another
+   */
+  isBefore(other) {
+    return this.toNumber() < other.toNumber();
+  }
+  /**
+   * Check if this date is after another
+   */
+  isAfter(other) {
+    return this.toNumber() > other.toNumber();
+  }
+  /**
+   * Check equality
+   */
+  equals(other) {
+    return this.toNumber() === other.toNumber();
+  }
+};
+var DateRange = class _DateRange {
+  constructor(_start, _end) {
+    this._start = _start;
+    this._end = _end;
+  }
+  /**
+   * Create a date range between two dates
+   */
+  static between(start, end) {
+    if (start.isAfter(end)) {
+      throw new ValidationError(
+        "dateRange",
+        "Start date must be before or equal to end date"
+      );
+    }
+    return new _DateRange(start, end);
+  }
+  /**
+   * Create a date range for a single day
+   */
+  static on(date) {
+    return new _DateRange(date, date);
+  }
+  /**
+   * Get the start date
+   */
+  get start() {
+    return this._start;
+  }
+  /**
+   * Get the end date
+   */
+  get end() {
+    return this._end;
+  }
+  /**
+   * Check if a date is within this range (inclusive)
+   */
+  contains(date) {
+    return !date.isBefore(this._start) && !date.isAfter(this._end);
+  }
+};
+var DateType = /* @__PURE__ */ ((DateType2) => {
+  DateType2[DateType2["INVOICE_DATE"] = 1] = "INVOICE_DATE";
+  DateType2[DateType2["CREATE_DATE"] = 2] = "CREATE_DATE";
+  return DateType2;
+})(DateType || {});
+
+// src/infrastructure/amego/AmegoInvoiceService.ts
+var AmegoInvoiceService = class {
+  repository;
+  constructor(config) {
+    this.repository = new AmegoInvoiceRepository(config);
+  }
+  /**
+   * Issue a new invoice (開立發票)
+   */
+  async issue(invoice) {
+    const result = await this.repository.issue(invoice);
+    return {
+      invoiceNumber: result.invoiceNumber,
+      invoiceTime: result.invoiceTime,
+      randomNumber: result.randomNumber,
+      barcode: result.barcode,
+      qrcodeLeft: result.qrcodeLeft,
+      qrcodeRight: result.qrcodeRight,
+      printData: result.printData
+    };
+  }
+  /**
+   * Void an invoice (作廢發票)
+   */
+  async void(invoiceNumber) {
+    await this.repository.void(invoiceNumber);
+  }
+  /**
+   * Find invoice by invoice number
+   */
+  async findByNumber(invoiceNumber) {
+    const result = await this.repository.findByInvoiceNumber(invoiceNumber);
+    return result?.invoice ?? null;
+  }
+  /**
+   * Find invoice by order ID
+   */
+  async findByOrderId(orderId) {
+    const result = await this.repository.findByOrderId(orderId);
+    return result?.invoice ?? null;
+  }
+  /**
+   * List invoices with query
+   */
+  async list(query) {
+    const result = await this.repository.list({
+      dateType: query.dateType === 2 /* CREATE_DATE */ ? 2 : 1,
+      startDate: query.dateRange.start.toNumber().toString(),
+      endDate: query.dateRange.end.toNumber().toString(),
+      limit: query.pagination.limit,
+      page: query.pagination.page
+    });
+    const invoices = result.invoices.map((r) => r.invoice);
+    return createPaginatedResult(invoices, result.totalCount, query.pagination);
+  }
+  /**
+   * Get invoice status
+   */
+  async getStatus(invoiceNumbers) {
+    const results = await this.repository.getStatus(invoiceNumbers);
+    return results.map((r) => ({
+      invoiceNumber: r.invoiceNumber,
+      type: r.type,
+      status: r.status,
+      totalAmount: r.totalAmount
+    }));
+  }
+};
+
+// src/domain/allowance/AllowanceItem.ts
+var AllowanceItem = class _AllowanceItem {
+  constructor(_originalDescription, _quantity, _unitPrice, _amount, _unit, _taxType) {
+    this._originalDescription = _originalDescription;
+    this._quantity = _quantity;
+    this._unitPrice = _unitPrice;
+    this._amount = _amount;
+    this._unit = _unit;
+    this._taxType = _taxType;
+  }
+  /**
+   * Create an AllowanceItem
+   */
+  static create(props) {
+    if (!props.originalDescription || props.originalDescription.trim().length === 0) {
+      throw new ValidationError(
+        "originalDescription",
+        "Original description is required"
+      );
+    }
+    if (props.originalDescription.length > 256) {
+      throw new ValidationError(
+        "originalDescription",
+        "Original description must not exceed 256 characters"
+      );
+    }
+    if (props.quantity === 0) {
+      throw new ValidationError("quantity", "Quantity cannot be zero");
+    }
+    if (props.unit && props.unit.length > 6) {
+      throw new ValidationError("unit", "Unit must not exceed 6 characters");
+    }
+    return new _AllowanceItem(
+      props.originalDescription.trim(),
+      props.quantity,
+      props.unitPrice,
+      props.amount,
+      props.unit?.trim() ?? "",
+      props.taxType ?? 1 /* TAXABLE */
+    );
+  }
+  /**
+   * Create an AllowanceItem with auto-calculated amount
+   */
+  static createWithAutoAmount(props) {
+    const amount = props.unitPrice.multiply(props.quantity);
+    return _AllowanceItem.create({ ...props, amount });
+  }
+  // Getters
+  get originalDescription() {
+    return this._originalDescription;
+  }
+  get quantity() {
+    return this._quantity;
+  }
+  get unitPrice() {
+    return this._unitPrice;
+  }
+  get amount() {
+    return this._amount;
+  }
+  get unit() {
+    return this._unit;
+  }
+  get taxType() {
+    return this._taxType;
+  }
+};
+
+// src/infrastructure/amego/AmegoAllowanceRepository.ts
+var allowanceCounter = 0;
+function generateAllowanceNumber() {
+  const now = /* @__PURE__ */ new Date();
+  const datePart = AmegoMapper.formatDate(now);
+  const seq = String(++allowanceCounter % 1e6).padStart(6, "0");
+  return `AL${datePart}${seq}`;
+}
+var AmegoAllowanceRepository = class {
+  client;
+  constructor(config) {
+    this.client = new AmegoClient(config);
+  }
+  /**
+   * Issue a new allowance (開立折讓)
+   *
+   * 使用 /json/g0401 endpoint
+   */
+  async issue(allowance) {
+    const allowanceNumber = generateAllowanceNumber();
+    const payload = AmegoMapper.toAllowancePayload(allowance, allowanceNumber);
+    await this.client.post(
+      AMEGO_ENDPOINTS.ALLOWANCE_ISSUE,
+      payload
+    );
+    const allowanceDate = AmegoMapper.parseDate(payload.AllowanceDate);
+    allowance.setAllowanceNumber(allowanceNumber, allowanceDate);
+    allowance.updateStatus(3 /* UPLOADED */);
+    return {
+      allowanceNumber,
+      allowanceDate
+    };
+  }
+  /**
+   * Void an allowance (作廢折讓)
+   *
+   * 使用 /json/g0501 endpoint
+   */
+  async void(allowanceNumber) {
+    const payload = {
+      CancelAllowanceNumber: allowanceNumber
+    };
+    await this.client.post(AMEGO_ENDPOINTS.ALLOWANCE_VOID, payload);
+  }
+  /**
+   * Query allowance by allowance number (查詢折讓 - 依折讓單編號)
+   *
+   * 使用 /json/allowance_query endpoint
+   */
+  async findByAllowanceNumber(allowanceNumber) {
+    try {
+      const payload = {
+        type: "allowance",
+        allowance_number: allowanceNumber
+      };
+      const response = await this.client.post(
+        AMEGO_ENDPOINTS.ALLOWANCE_QUERY,
+        payload
+      );
+      if (!response.data) {
+        return null;
+      }
+      return this.mapQueryResponse(response.data);
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Query allowances by original invoice number (查詢折讓 - 依原發票號碼)
+   *
+   * 使用 /json/allowance_query endpoint
+   */
+  async findByInvoiceNumber(invoiceNumber) {
+    try {
+      const payload = {
+        type: "invoice",
+        invoice_number: invoiceNumber.toString()
+      };
+      const response = await this.client.post(
+        AMEGO_ENDPOINTS.ALLOWANCE_QUERY,
+        payload
+      );
+      if (!response.data) {
+        return [];
+      }
+      return [this.mapQueryResponse(response.data)];
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Check allowance status (查詢折讓狀態)
+   *
+   * 使用 /json/allowance_status endpoint
+   */
+  async getStatus(allowanceNumbers) {
+    const results = [];
+    for (const allowanceNumber of allowanceNumbers) {
+      try {
+        const payload = {
+          AllowanceNumber: allowanceNumber
+        };
+        const response = await this.client.post(
+          AMEGO_ENDPOINTS.ALLOWANCE_STATUS,
+          payload
+        );
+        if (response.data && response.data.length > 0) {
+          for (const item of response.data) {
+            results.push({
+              allowanceNumber: item.allowance_number,
+              status: AmegoMapper.toAllowanceStatus(item.status),
+              totalAmount: item.total_amount
+            });
+          }
+        }
+      } catch {
+      }
+    }
+    return results;
+  }
+  /**
+   * List allowances (折讓列表)
+   *
+   * 使用 /json/allowance_list endpoint
+   */
+  async list(options) {
+    const dateStart = parseInt(options.startDate, 10);
+    const dateEnd = parseInt(options.endDate, 10);
+    const payload = {
+      date_select: options.dateType,
+      date_start: dateStart,
+      date_end: dateEnd,
+      limit: options.limit ?? 20,
+      page: options.page ?? 1
+    };
+    const response = await this.client.post(
+      AMEGO_ENDPOINTS.ALLOWANCE_LIST,
+      payload
+    );
+    const allowances = (response.data ?? []).map(
+      (item) => this.mapListItemResponse(item)
+    );
+    return {
+      allowances,
+      totalPages: response.page_total ?? 1,
+      currentPage: response.page_now ?? 1,
+      totalCount: response.data_total ?? 0
+    };
+  }
+  /**
+   * Map API query response to domain query result
+   */
+  mapQueryResponse(data) {
+    const items = (data.product_item ?? []).map(
+      (item) => AllowanceItem.create({
+        originalDescription: item.description,
+        quantity: item.quantity,
+        unitPrice: Money.create(item.unit_price),
+        amount: Money.create(item.amount),
+        unit: item.unit || void 0,
+        taxType: AmegoMapper.fromApiTaxType(item.tax_type)
+      })
+    );
+    const firstItem = data.product_item?.[0];
+    const originalInvoiceNumber = firstItem?.original_invoice_number ?? "";
+    const originalInvoiceDate = firstItem?.original_invoice_date ? AmegoMapper.parseDate(firstItem.original_invoice_date) : /* @__PURE__ */ new Date();
+    const allowance = Allowance.create({
+      originalInvoiceNumber: InvoiceNumber.create(originalInvoiceNumber),
+      originalInvoiceDate,
+      buyerTaxId: TaxId.tryCreate(data.buyer_identifier) ?? TaxId.none(),
+      sellerTaxId: TaxId.none(),
+      // API 回應沒有賣方資訊，使用空值
+      buyerName: data.buyer_name || "",
+      items
+    });
+    const allowanceDate = AmegoMapper.parseDate(data.allowance_date);
+    allowance.setAllowanceNumber(data.allowance_number, allowanceDate);
+    allowance.updateStatus(AmegoMapper.toAllowanceStatus(data.invoice_status));
+    return {
+      allowance,
+      status: AmegoMapper.toAllowanceStatus(data.invoice_status)
+    };
+  }
+  /**
+   * Map API list item response to domain query result
+   */
+  mapListItemResponse(item) {
+    const firstProductItem = item.product_item?.[0];
+    const originalInvoiceNumber = firstProductItem?.original_invoice_number ?? "";
+    const originalInvoiceDate = firstProductItem?.original_invoice_date ? AmegoMapper.parseDate(firstProductItem.original_invoice_date) : /* @__PURE__ */ new Date();
+    const items = (item.product_item ?? []).map(
+      (productItem) => AllowanceItem.create({
+        originalDescription: productItem.description,
+        quantity: productItem.quantity,
+        unitPrice: Money.create(productItem.unit_price),
+        amount: Money.create(productItem.amount),
+        unit: productItem.unit || void 0,
+        taxType: AmegoMapper.fromApiTaxType(productItem.tax_type)
+      })
+    );
+    const allowanceItems = items.length > 0 ? items : [
+      AllowanceItem.create({
+        originalDescription: "\uFF08\u8A73\u7D30\u8ACB\u67E5\u8A62\u55AE\u5F35\u6298\u8B93\uFF09",
+        quantity: 1,
+        unitPrice: Money.create(item.total_amount),
+        amount: Money.create(item.total_amount),
+        taxType: AmegoMapper.fromApiTaxType(1)
+        // Default to taxable
+      })
+    ];
+    const allowance = Allowance.create({
+      originalInvoiceNumber: InvoiceNumber.create(originalInvoiceNumber),
+      originalInvoiceDate,
+      buyerTaxId: TaxId.tryCreate(item.buyer_identifier) ?? TaxId.none(),
+      sellerTaxId: TaxId.none(),
+      buyerName: item.buyer_name || "",
+      items: allowanceItems
+    });
+    const allowanceDate = AmegoMapper.parseDate(item.allowance_date);
+    allowance.setAllowanceNumber(item.allowance_number, allowanceDate);
+    allowance.updateStatus(AmegoMapper.toAllowanceStatus(item.invoice_status));
+    return {
+      allowance,
+      status: AmegoMapper.toAllowanceStatus(item.invoice_status)
+    };
+  }
+};
+
+// src/infrastructure/amego/AmegoAllowanceService.ts
+var AmegoAllowanceService = class {
+  repository;
+  constructor(config) {
+    this.repository = new AmegoAllowanceRepository(config);
+  }
+  /**
+   * Issue a new allowance (開立折讓)
+   */
+  async issue(allowance) {
+    const result = await this.repository.issue(allowance);
+    return {
+      allowanceNumber: result.allowanceNumber,
+      allowanceDate: result.allowanceDate
+    };
+  }
+  /**
+   * Void an allowance (作廢折讓)
+   */
+  async void(allowanceNumber) {
+    await this.repository.void(allowanceNumber);
+  }
+  /**
+   * Find allowance by allowance number
+   */
+  async findByNumber(allowanceNumber) {
+    const result = await this.repository.findByAllowanceNumber(allowanceNumber);
+    return result?.allowance ?? null;
+  }
+  /**
+   * Find allowances by original invoice number
+   */
+  async findByInvoiceNumber(invoiceNumber) {
+    const results = await this.repository.findByInvoiceNumber(invoiceNumber);
+    return results.map((r) => r.allowance);
+  }
+  /**
+   * List allowances with query
+   */
+  async list(query) {
+    const result = await this.repository.list({
+      dateType: query.dateType === 2 /* CREATE_DATE */ ? 2 : 1,
+      startDate: query.dateRange.start.toNumber().toString(),
+      endDate: query.dateRange.end.toNumber().toString(),
+      limit: query.pagination.limit,
+      page: query.pagination.page
+    });
+    const allowances = result.allowances.map((r) => r.allowance);
+    return createPaginatedResult(allowances, result.totalCount, query.pagination);
+  }
+  /**
+   * Get allowance status
+   */
+  async getStatus(allowanceNumbers) {
+    const results = await this.repository.getStatus(allowanceNumbers);
+    return results.map((r) => ({
+      allowanceNumber: r.allowanceNumber,
+      status: r.status,
+      totalAmount: r.totalAmount
+    }));
+  }
+};
+
+// src/Zinvoice.ts
+var Zinvoice = class _Zinvoice {
+  _provider;
+  _invoiceService;
+  _allowanceService;
+  _capabilities;
+  constructor(provider, invoiceService, allowanceService) {
+    this._provider = provider;
+    this._invoiceService = invoiceService;
+    this._allowanceService = allowanceService;
+    this._capabilities = PROVIDER_CAPABILITIES[provider];
+  }
+  /**
+   * Create a Zinvoice client
+   */
+  static create(config) {
+    switch (config.provider) {
+      case "amego" /* AMEGO */:
+        return _Zinvoice.createAmego(config);
+      default:
+        throw new ProviderNotImplementedError(config.provider);
+    }
+  }
+  /**
+   * Create a Zinvoice client for Amego provider
+   */
+  static createAmego(config) {
+    const amegoConfig = {
+      baseUrl: config.baseUrl ?? "https://invoice-api.amego.tw",
+      sellerTaxId: config.sellerTaxId,
+      apiKey: config.apiKey,
+      timeout: config.timeout
+    };
+    const invoiceService = new AmegoInvoiceService(amegoConfig);
+    const allowanceService = new AmegoAllowanceService(amegoConfig);
+    return new _Zinvoice("amego" /* AMEGO */, invoiceService, allowanceService);
+  }
+  /**
+   * Get the invoice service
+   */
+  get invoices() {
+    return this._invoiceService;
+  }
+  /**
+   * Get the allowance service
+   */
+  get allowances() {
+    return this._allowanceService;
+  }
+  /**
+   * Get the current provider
+   */
+  get provider() {
+    return this._provider;
+  }
+  /**
+   * Get the provider display name
+   */
+  get providerName() {
+    return PROVIDER_NAMES[this._provider];
+  }
+  /**
+   * Check if a capability is supported
+   */
+  supports(capability) {
+    return this._capabilities.has(capability);
+  }
+  /**
+   * Get all supported capabilities
+   */
+  getCapabilities() {
+    return Array.from(this._capabilities);
+  }
+  /**
+   * Assert that a capability is supported, throw if not
+   */
+  requireCapability(capability) {
+    if (!this.supports(capability)) {
+      throw new UnsupportedCapabilityError(capability, this._provider);
+    }
+  }
+};
+
+// src/domain/shared/CarrierCode.ts
+var CarrierType2 = /* @__PURE__ */ ((CarrierType3) => {
+  CarrierType3["MOBILE"] = "3J0002";
+  CarrierType3["CERTIFICATE"] = "CQ0001";
+  CarrierType3["AMEGO"] = "amego";
+  CarrierType3["NONE"] = "";
+  return CarrierType3;
+})(CarrierType2 || {});
+var CarrierCode = class _CarrierCode {
+  constructor(_type, _code1, _code2) {
+    this._type = _type;
+    this._code1 = _code1;
+    this._code2 = _code2;
+  }
+  /**
+   * Create a CarrierCode for mobile barcode
+   * Format: /[A-Z0-9.+-]{7}
+   */
+  static mobile(code) {
+    const normalized = code.trim().toUpperCase();
+    if (!_CarrierCode.isValidMobileBarcode(normalized)) {
+      throw new InvalidCarrierCodeError(code, "3J0002" /* MOBILE */);
+    }
+    return new _CarrierCode("3J0002" /* MOBILE */, normalized, normalized);
+  }
+  /**
+   * Create a CarrierCode for natural person certificate
+   * Format: 2 letters + 14 digits
+   */
+  static certificate(code) {
+    const normalized = code.trim().toUpperCase();
+    if (!_CarrierCode.isValidCertificate(normalized)) {
+      throw new InvalidCarrierCodeError(code, "CQ0001" /* CERTIFICATE */);
+    }
+    return new _CarrierCode("CQ0001" /* CERTIFICATE */, normalized, normalized);
+  }
+  /**
+   * Create a CarrierCode for Amego member
+   * Format: a+phone number (a0911222333) or email
+   */
+  static amego(code) {
+    const normalized = code.trim().toLowerCase();
+    if (!_CarrierCode.isValidAmego(normalized)) {
+      throw new InvalidCarrierCodeError(code, "amego" /* AMEGO */);
+    }
+    return new _CarrierCode("amego" /* AMEGO */, normalized, normalized);
+  }
+  /**
+   * Create a CarrierCode for custom carrier type
+   */
+  static custom(type, code1, code2) {
+    return new _CarrierCode(type, code1.trim(), code2.trim());
+  }
+  /**
+   * Create an empty carrier (no carrier)
+   */
+  static none() {
+    return new _CarrierCode("" /* NONE */, "", "");
+  }
+  /**
+   * Validate mobile barcode format
+   * Format: starts with "/" followed by 7 characters (A-Z, 0-9, +, -, .)
+   */
+  static isValidMobileBarcode(code) {
+    return /^\/[A-Z0-9.+-]{7}$/.test(code);
+  }
+  /**
+   * Validate natural person certificate format
+   * Format: 2 uppercase letters + 14 digits
+   */
+  static isValidCertificate(code) {
+    return /^[A-Z]{2}\d{14}$/.test(code);
+  }
+  /**
+   * Validate Amego member carrier format
+   * Format: "a" + phone number or email
+   */
+  static isValidAmego(code) {
+    if (/^a09\d{8}$/.test(code)) {
+      return true;
+    }
+    if (/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(code)) {
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Get carrier type (alias for type property)
+   */
+  getType() {
+    return this._type;
+  }
+  /**
+   * Get carrier code 1 (顯碼)
+   */
+  getCode1() {
+    return this._code1;
+  }
+  /**
+   * Get carrier code 2 (隱碼)
+   */
+  getCode2() {
+    return this._code2;
+  }
+  /**
+   * Carrier type for API usage
+   */
+  get type() {
+    return this._type;
+  }
+  /**
+   * Carrier value (code1) for API usage
+   */
+  get value() {
+    return this._code1;
+  }
+  /**
+   * Check if this is an empty carrier
+   */
+  isEmpty() {
+    return this._type === "" /* NONE */;
+  }
+  /**
+   * Check if this is a mobile barcode carrier
+   */
+  isMobile() {
+    return this._type === "3J0002" /* MOBILE */;
+  }
+  /**
+   * Check equality
+   */
+  equals(other) {
+    return this._type === other._type && this._code1 === other._code1 && this._code2 === other._code2;
+  }
+};
+
+// src/domain/invoice/InvoiceQuery.ts
+var InvoiceQuery = class _InvoiceQuery {
+  constructor(_dateRange, _dateType, _pagination) {
+    this._dateRange = _dateRange;
+    this._dateType = _dateType;
+    this._pagination = _pagination;
+  }
+  /**
+   * Create a query with all parameters
+   */
+  static create(options) {
+    return new _InvoiceQuery(
+      options.dateRange,
+      options.dateType ?? 1 /* INVOICE_DATE */,
+      options.pagination ?? Pagination.first()
+    );
+  }
+  /**
+   * Create a query by invoice date
+   */
+  static byInvoiceDate(dateRange, pagination) {
+    return _InvoiceQuery.create({
+      dateRange,
+      dateType: 1 /* INVOICE_DATE */,
+      pagination
+    });
+  }
+  /**
+   * Create a query by create date
+   */
+  static byCreateDate(dateRange, pagination) {
+    return _InvoiceQuery.create({
+      dateRange,
+      dateType: 2 /* CREATE_DATE */,
+      pagination
+    });
+  }
+  /**
+   * Create a query for a specific month
+   */
+  static forMonth(year, month, pagination) {
+    const start = LocalDate.of(year, month, 1);
+    const nextMonth = month === 12 ? 1 : month + 1;
+    const nextYear = month === 12 ? year + 1 : year;
+    const lastDay = new Date(nextYear, nextMonth - 1, 0).getDate();
+    const end = LocalDate.of(year, month, lastDay);
+    return _InvoiceQuery.create({
+      dateRange: DateRange.between(start, end),
+      dateType: 1 /* INVOICE_DATE */,
+      pagination
+    });
+  }
+  /**
+   * Create a query for a specific year
+   */
+  static forYear(year, pagination) {
+    return _InvoiceQuery.create({
+      dateRange: DateRange.between(
+        LocalDate.of(year, 1, 1),
+        LocalDate.of(year, 12, 31)
+      ),
+      dateType: 1 /* INVOICE_DATE */,
+      pagination
+    });
+  }
+  /**
+   * Get the date range
+   */
+  get dateRange() {
+    return this._dateRange;
+  }
+  /**
+   * Get the date type
+   */
+  get dateType() {
+    return this._dateType;
+  }
+  /**
+   * Get the pagination
+   */
+  get pagination() {
+    return this._pagination;
+  }
+  /**
+   * Create a new query with different pagination
+   */
+  withPagination(pagination) {
+    return new _InvoiceQuery(this._dateRange, this._dateType, pagination);
+  }
+  /**
+   * Create a query for the next page
+   */
+  nextPage() {
+    return this.withPagination(this._pagination.next());
+  }
+};
+
+// src/domain/services/TaxCalculator.ts
+var TaxCalculator = class _TaxCalculator {
+  /**
+   * Calculate tax for invoice items
+   */
+  static calculateForInvoice(items, pricesIncludeTax, hasB2BTaxId) {
+    const taxableSales = _TaxCalculator.sumByTaxType(items, 1 /* TAXABLE */);
+    const taxExemptSales = _TaxCalculator.sumByTaxType(items, 3 /* TAX_EXEMPT */);
+    const zeroRatedSales = _TaxCalculator.sumByTaxType(items, 2 /* ZERO_RATED */);
+    const taxAmount = hasB2BTaxId ? _TaxCalculator.calculateTaxAmount(taxableSales, pricesIncludeTax) : Money.zero();
+    const totalAmount = _TaxCalculator.calculateTotal(
+      taxableSales,
+      taxExemptSales,
+      zeroRatedSales,
+      taxAmount,
+      pricesIncludeTax
+    );
+    return {
+      taxableSales,
+      taxExemptSales,
+      zeroRatedSales,
+      taxAmount,
+      totalAmount
+    };
+  }
+  /**
+   * Calculate tax for allowance items
+   */
+  static calculateForAllowance(items, pricesIncludeTax) {
+    const taxableSales = _TaxCalculator.sumAllowanceByTaxType(
+      items,
+      1 /* TAXABLE */
+    );
+    const taxExemptSales = _TaxCalculator.sumAllowanceByTaxType(
+      items,
+      3 /* TAX_EXEMPT */
+    );
+    const zeroRatedSales = _TaxCalculator.sumAllowanceByTaxType(
+      items,
+      2 /* ZERO_RATED */
+    );
+    const taxAmount = _TaxCalculator.calculateTaxAmount(
+      taxableSales,
+      pricesIncludeTax
+    );
+    const totalAmount = _TaxCalculator.calculateTotal(
+      taxableSales,
+      taxExemptSales,
+      zeroRatedSales,
+      taxAmount,
+      pricesIncludeTax
+    );
+    return {
+      taxableSales,
+      taxExemptSales,
+      zeroRatedSales,
+      taxAmount,
+      totalAmount
+    };
+  }
+  /**
+   * Calculate tax amount from taxable sales
+   */
+  static calculateTaxAmount(taxableSales, pricesIncludeTax) {
+    if (pricesIncludeTax) {
+      const beforeTax = taxableSales.divide(1 + TAX_RATE).round();
+      return taxableSales.subtract(beforeTax);
+    } else {
+      return taxableSales.multiply(TAX_RATE).round();
+    }
+  }
+  /**
+   * Calculate net amount (before tax) from tax-included amount
+   */
+  static extractNetAmount(taxIncludedAmount) {
+    return taxIncludedAmount.divide(1 + TAX_RATE).round();
+  }
+  /**
+   * Calculate gross amount (after tax) from tax-excluded amount
+   */
+  static addTax(taxExcludedAmount) {
+    const tax = taxExcludedAmount.multiply(TAX_RATE).round();
+    return taxExcludedAmount.add(tax);
+  }
+  /**
+   * Sum invoice items by tax type
+   */
+  static sumByTaxType(items, taxType) {
+    return items.filter((item) => item.taxType === taxType).reduce((sum, item) => sum.add(item.amount), Money.zero()).round();
+  }
+  /**
+   * Sum allowance items by tax type
+   */
+  static sumAllowanceByTaxType(items, taxType) {
+    return items.filter((item) => item.taxType === taxType).reduce((sum, item) => sum.add(item.amount), Money.zero()).round();
+  }
+  /**
+   * Calculate total amount
+   */
+  static calculateTotal(taxableSales, taxExemptSales, zeroRatedSales, taxAmount, pricesIncludeTax) {
+    if (pricesIncludeTax) {
+      return taxableSales.add(taxExemptSales).add(zeroRatedSales);
+    } else {
+      return taxableSales.add(taxExemptSales).add(zeroRatedSales).add(taxAmount);
+    }
+  }
+};
+
+// src/application/InvoiceService.ts
+var InvoiceService = class {
+  constructor(repository) {
+    this.repository = repository;
+  }
+  /**
+   * Issue a new invoice
+   */
+  async issue(input) {
+    const items = input.items.map((item) => {
+      const unitPrice = Money.create(item.unitPrice);
+      if (item.amount !== void 0) {
+        return InvoiceItem.create({
+          description: item.description,
+          quantity: item.quantity,
+          unitPrice,
+          amount: Money.create(item.amount),
+          unit: item.unit,
+          remark: item.remark,
+          taxType: item.taxType
+        });
+      }
+      return InvoiceItem.createWithAutoAmount({
+        description: item.description,
+        quantity: item.quantity,
+        unitPrice,
+        unit: item.unit,
+        remark: item.remark,
+        taxType: item.taxType
+      });
+    });
+    const buyerTaxId = input.buyerTaxId ? TaxId.tryCreate(input.buyerTaxId) ?? TaxId.none() : TaxId.none();
+    const buyer = buyerTaxId.isNone() ? Buyer.anonymous(input.buyerName) : Buyer.company({
+      taxId: buyerTaxId,
+      name: input.buyerName,
+      address: input.buyerAddress,
+      phone: input.buyerPhone,
+      email: input.buyerEmail
+    });
+    let carrier;
+    if (input.carrier) {
+      switch (input.carrier.type) {
+        case "mobile":
+          carrier = Carrier.mobile(input.carrier.value);
+          break;
+        case "certificate":
+          carrier = Carrier.certificate(input.carrier.value);
+          break;
+        case "amego":
+          carrier = Carrier.custom("amego", input.carrier.value);
+          break;
+      }
+    }
+    const donation = input.donationCode ? Donation.tryCreate(input.donationCode) : void 0;
+    const invoice = Invoice.create({
+      orderId: OrderId.create(input.orderId),
+      buyer,
+      items,
+      carrier,
+      donation,
+      remark: input.remark,
+      trackApiCode: input.trackApiCode,
+      customsClearanceMark: input.customsClearanceMark,
+      zeroTaxRateReason: input.zeroTaxRateReason,
+      brandName: input.brandName,
+      pricesIncludeTax: input.pricesIncludeTax
+    });
+    return this.repository.issue(invoice);
+  }
+  /**
+   * Void an invoice
+   */
+  async void(invoiceNumber) {
+    const number = InvoiceNumber.create(invoiceNumber);
+    return this.repository.void(number);
+  }
+  /**
+   * Query invoice by invoice number
+   */
+  async findByInvoiceNumber(invoiceNumber) {
+    const number = InvoiceNumber.create(invoiceNumber);
+    return this.repository.findByInvoiceNumber(number);
+  }
+  /**
+   * Query invoice by order ID
+   */
+  async findByOrderId(orderId) {
+    return this.repository.findByOrderId(orderId);
+  }
+  /**
+   * Check invoice status
+   */
+  async getStatus(invoiceNumbers) {
+    const numbers = invoiceNumbers.map((n) => InvoiceNumber.create(n));
+    return this.repository.getStatus(numbers);
+  }
+  /**
+   * List invoices
+   */
+  async list(options) {
+    return this.repository.list(options);
+  }
+};
+
+// src/application/AllowanceService.ts
+var AllowanceService = class {
+  constructor(repository) {
+    this.repository = repository;
+  }
+  /**
+   * Issue a new allowance
+   */
+  async issue(input) {
+    const items = input.items.map((item) => {
+      const unitPrice = Money.create(item.unitPrice);
+      if (item.amount !== void 0) {
+        return AllowanceItem.create({
+          originalDescription: item.originalDescription,
+          quantity: item.quantity,
+          unitPrice,
+          amount: Money.create(item.amount),
+          unit: item.unit,
+          taxType: item.taxType
+        });
+      }
+      return AllowanceItem.createWithAutoAmount({
+        originalDescription: item.originalDescription,
+        quantity: item.quantity,
+        unitPrice,
+        unit: item.unit,
+        taxType: item.taxType
+      });
+    });
+    let invoiceDate;
+    if (typeof input.originalInvoiceDate === "string") {
+      const dateStr = input.originalInvoiceDate;
+      if (dateStr.length === 8) {
+        const year = parseInt(dateStr.substring(0, 4), 10);
+        const month = parseInt(dateStr.substring(4, 6), 10) - 1;
+        const day = parseInt(dateStr.substring(6, 8), 10);
+        invoiceDate = new Date(year, month, day);
+      } else {
+        invoiceDate = new Date(dateStr);
+      }
+    } else {
+      invoiceDate = input.originalInvoiceDate;
+    }
+    const props = {
+      originalInvoiceNumber: InvoiceNumber.create(input.originalInvoiceNumber),
+      originalInvoiceDate: invoiceDate,
+      buyerTaxId: input.buyerTaxId ? TaxId.tryCreate(input.buyerTaxId) ?? TaxId.none() : TaxId.none(),
+      sellerTaxId: TaxId.create(input.sellerTaxId),
+      items,
+      buyerName: input.buyerName,
+      sellerName: input.sellerName,
+      pricesIncludeTax: input.pricesIncludeTax
+    };
+    const allowance = Allowance.create(props);
+    return this.repository.issue(allowance);
+  }
+  /**
+   * Void an allowance
+   */
+  async void(allowanceNumber) {
+    return this.repository.void(allowanceNumber);
+  }
+  /**
+   * Query allowance by allowance number
+   */
+  async findByAllowanceNumber(allowanceNumber) {
+    return this.repository.findByAllowanceNumber(allowanceNumber);
+  }
+  /**
+   * Query allowances by original invoice number
+   */
+  async findByInvoiceNumber(invoiceNumber) {
+    const number = InvoiceNumber.create(invoiceNumber);
+    return this.repository.findByInvoiceNumber(number);
+  }
+  /**
+   * Check allowance status
+   */
+  async getStatus(allowanceNumbers) {
+    return this.repository.getStatus(allowanceNumbers);
+  }
+  /**
+   * List allowances
+   */
+  async list(options) {
+    return this.repository.list(options);
+  }
+};
+
+export { AMEGO_DEFAULTS, AMEGO_ENDPOINTS, Allowance, AllowanceItem, AllowanceStatus, AllowanceType, AmegoAllowanceRepository, AmegoAllowanceService, AmegoClient, AmegoInvoiceRepository, AmegoInvoiceService, AmegoMapper, AmegoSigner, Buyer, Capability, Carrier, CarrierCode, CarrierType2 as CarrierType, CustomsClearanceMark, DateRange, DateType, Donation, InvalidCarrierCodeError, InvalidInvoiceNumberError, InvalidMoneyError, InvalidTaxIdError, Invoice, InvoiceItem, InvoiceNumber, InvoiceQuery, InvoiceStatus, InvoiceType, AllowanceService as LegacyAllowanceService, InvoiceService as LegacyInvoiceService, LocalDate, Money, NetworkError, OrderId, PROVIDER_CAPABILITIES, PROVIDER_NAMES, Pagination, Provider, ProviderApiError, ProviderNotImplementedError, TAX_RATE, TaxCalculator, TaxId, TaxType, UnsupportedCapabilityError, ValidationError, ZeroTaxRateReason, Zinvoice, ZinvoiceError, createPaginatedResult };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map