@tamtamchik/app-store-receipt-parser 2.3.0 → 2.3.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 2.3.1 - 2026-06-12
+
+### Fixed
+
+- Decoded ASN.1 `INTEGER` field values to decimal strings instead of raw hex.
+- Preserved `Environment` literal type hints and exported the `Environment` type from the package entrypoint.
+- Shipped generated type declarations instead of hand-written ones.
+- Allowed parsing receipts without in-app purchases.
+
+### Changed
+
+- Documented last-wins semantics of top-level `IN_APP_*` fields.
+- Added a warning that receipt signatures are not verified.
+- Updated the README example to decoded integer values.
+
+### Maintenance
+
+- Replaced `tsup` with `tsdown` for the build.
+- Simplified the Dependabot configuration.
+- Updated development dependencies.
+
 ## 2.3.0 - 2026-05-27
 
 ### Added

package/README.md

@@ -14,6 +14,12 @@ A lightweight TypeScript library for extracting selected fields from Apple's ASN
 > It extracts supported fields from Apple's ASN.1 encoded Unified Receipts, including in-app purchase receipts.
 > It does not work with the old-style transaction receipts.
 
+> [!CAUTION]
+> This library does **not** verify the receipt's PKCS#7 signature — it only checks that the ASN.1
+> structure has the expected shape. The extracted data is not cryptographically trustworthy on its own.
+> Do not grant entitlements based on it without verifying the receipt signature (or using Apple's
+> [App Store Server API](https://developer.apple.com/documentation/appstoreserverapi)) separately.
+
 > [!NOTE]
 > Documentation for the version 1.x of the library can be found [here](https://github.com/tamtamchik/app-store-receipt-parser/tree/1.x/README.md).
 
@@ -55,8 +61,8 @@ console.log(data);
 //   ORIGINAL_PURCHASE_DATE: '2013-08-01T07:00:00Z',
 //   IN_APP_EXPIRES_DATE: '2015-08-10T07:19:32Z',
 //   IN_APP_CANCELLATION_DATE: '',
-//   IN_APP_QUANTITY: '020101',
-//   IN_APP_WEB_ORDER_LINE_ITEM_ID: '0207038d7ea69472c9',
+//   IN_APP_QUANTITY: '1',
+//   IN_APP_WEB_ORDER_LINE_ITEM_ID: '1000000030274249',
 //   IN_APP_PRODUCT_ID: 'monthly',
 //   IN_APP_TRANSACTION_ID: '1000000166967782',
 //   IN_APP_TRANSACTION_IDS: [
@@ -73,8 +79,8 @@ console.log(data);
 //     {
 //       IN_APP_EXPIRES_DATE: '2015-08-10T07:19:32Z',
 //       IN_APP_CANCELLATION_DATE: '',
-//       IN_APP_QUANTITY: '020101',
-//       IN_APP_WEB_ORDER_LINE_ITEM_ID: '0207038d7ea69472c9',
+//       IN_APP_QUANTITY: '1',
+//       IN_APP_WEB_ORDER_LINE_ITEM_ID: '1000000030274249',
 //       IN_APP_PRODUCT_ID: 'monthly',
 //       IN_APP_TRANSACTION_ID: '1000000166967782',
 //       IN_APP_ORIGINAL_TRANSACTION_ID: '1000000166965150',
@@ -92,6 +98,12 @@ console.log(data);
 // }
 ```
 
+> [!WARNING]
+> Top-level scalar `IN_APP_*` fields (e.g. `IN_APP_PRODUCT_ID`, `IN_APP_TRANSACTION_ID`) hold the value
+> from the **last** in-app purchase block encountered in the receipt, and Apple does not guarantee the
+> order of those blocks. They are kept for backward compatibility — for reliable per-purchase data use
+> `IN_APP_RECEIPTS`.
+
 ## Special Thanks
 
 - [@Jurajzovinec](https://github.com/Jurajzovinec) for his superb contribution to the project.

package/dist/index.d.mts

@@ -0,0 +1,15 @@
+//#region src/constants.d.ts
+type ReceiptFieldsKeyNames = 'ENVIRONMENT' | 'BUNDLE_ID' | 'APP_VERSION' | 'OPAQUE_VALUE' | 'SHA1_HASH' | 'RECEIPT_CREATION_DATE' | 'ORIGINAL_PURCHASE_DATE' | 'ORIGINAL_APP_VERSION' | 'IN_APP_QUANTITY' | 'IN_APP_PRODUCT_ID' | 'IN_APP_TRANSACTION_ID' | 'IN_APP_PURCHASE_DATE' | 'IN_APP_ORIGINAL_TRANSACTION_ID' | 'IN_APP_ORIGINAL_PURCHASE_DATE' | 'IN_APP_EXPIRES_DATE' | 'IN_APP_WEB_ORDER_LINE_ITEM_ID' | 'IN_APP_CANCELLATION_DATE';
+//#endregion
+//#region src/ReceiptParser.d.ts
+type Environment = 'Production' | 'ProductionSandbox' | (string & {});
+type InAppReceipt = Partial<Record<ReceiptFieldsKeyNames, string>>;
+type ParsedReceipt = Partial<Record<ReceiptFieldsKeyNames, string>> & {
+  ENVIRONMENT: Environment;
+  IN_APP_RECEIPTS: InAppReceipt[];
+  IN_APP_ORIGINAL_TRANSACTION_IDS: string[];
+  IN_APP_TRANSACTION_IDS: string[];
+};
+declare function parseReceipt(receipt: string): ParsedReceipt;
+//#endregion
+export { type Environment, type InAppReceipt, type ParsedReceipt, parseReceipt };

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+//#region src/constants.d.ts
+type ReceiptFieldsKeyNames = 'ENVIRONMENT' | 'BUNDLE_ID' | 'APP_VERSION' | 'OPAQUE_VALUE' | 'SHA1_HASH' | 'RECEIPT_CREATION_DATE' | 'ORIGINAL_PURCHASE_DATE' | 'ORIGINAL_APP_VERSION' | 'IN_APP_QUANTITY' | 'IN_APP_PRODUCT_ID' | 'IN_APP_TRANSACTION_ID' | 'IN_APP_PURCHASE_DATE' | 'IN_APP_ORIGINAL_TRANSACTION_ID' | 'IN_APP_ORIGINAL_PURCHASE_DATE' | 'IN_APP_EXPIRES_DATE' | 'IN_APP_WEB_ORDER_LINE_ITEM_ID' | 'IN_APP_CANCELLATION_DATE';
+//#endregion
+//#region src/ReceiptParser.d.ts
+type Environment = 'Production' | 'ProductionSandbox' | (string & {});
+type InAppReceipt = Partial<Record<ReceiptFieldsKeyNames, string>>;
+type ParsedReceipt = Partial<Record<ReceiptFieldsKeyNames, string>> & {
+  ENVIRONMENT: Environment;
+  IN_APP_RECEIPTS: InAppReceipt[];
+  IN_APP_ORIGINAL_TRANSACTION_IDS: string[];
+  IN_APP_TRANSACTION_IDS: string[];
+};
+declare function parseReceipt(receipt: string): ParsedReceipt;
+//#endregion
+export { type Environment, type InAppReceipt, type ParsedReceipt, parseReceipt };

package/dist/index.js

@@ -1,237 +1,188 @@
-"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
 var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  parseReceipt: () => parseReceipt
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/ReceiptParser.ts
-var ASN1 = __toESM(require("asn1js"));
-
-// src/constants.ts
-var IN_APP = 17;
-var CONTENT_ID = "pkcs7_content";
-var FIELD_TYPE_ID = "FieldType";
-var FIELD_VALUE_ID = "FieldTypeOctetString";
-var RECEIPT_FIELDS_MAP = /* @__PURE__ */ new Map([
-  [0, "ENVIRONMENT"],
-  [2, "BUNDLE_ID"],
-  [3, "APP_VERSION"],
-  [4, "OPAQUE_VALUE"],
-  [5, "SHA1_HASH"],
-  [12, "RECEIPT_CREATION_DATE"],
-  [18, "ORIGINAL_PURCHASE_DATE"],
-  [19, "ORIGINAL_APP_VERSION"],
-  [1701, "IN_APP_QUANTITY"],
-  [1702, "IN_APP_PRODUCT_ID"],
-  [1703, "IN_APP_TRANSACTION_ID"],
-  [1704, "IN_APP_PURCHASE_DATE"],
-  [1705, "IN_APP_ORIGINAL_TRANSACTION_ID"],
-  [1706, "IN_APP_ORIGINAL_PURCHASE_DATE"],
-  [1708, "IN_APP_EXPIRES_DATE"],
-  [1711, "IN_APP_WEB_ORDER_LINE_ITEM_ID"],
-  [1712, "IN_APP_CANCELLATION_DATE"]
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let asn1js = require("asn1js");
+asn1js = __toESM(asn1js);
+//#region src/constants.ts
+/** Identifies pkcs7 content information encoded as Octet string  */
+const CONTENT_ID = "pkcs7_content";
+/** Identifies field type id information */
+const FIELD_TYPE_ID = "FieldType";
+/** Identifies field value information encoded as Octet string */
+const FIELD_VALUE_ID = "FieldTypeOctetString";
+/**
+* Receipt fields
+* @see https://developer.apple.com/library/archive/releasenotes/General/ValidateAppStoreReceipt/Chapters/ReceiptFields.html
+*/
+const RECEIPT_FIELDS_MAP = new Map([
+	[0, "ENVIRONMENT"],
+	[2, "BUNDLE_ID"],
+	[3, "APP_VERSION"],
+	[4, "OPAQUE_VALUE"],
+	[5, "SHA1_HASH"],
+	[12, "RECEIPT_CREATION_DATE"],
+	[18, "ORIGINAL_PURCHASE_DATE"],
+	[19, "ORIGINAL_APP_VERSION"],
+	[1701, "IN_APP_QUANTITY"],
+	[1702, "IN_APP_PRODUCT_ID"],
+	[1703, "IN_APP_TRANSACTION_ID"],
+	[1704, "IN_APP_PURCHASE_DATE"],
+	[1705, "IN_APP_ORIGINAL_TRANSACTION_ID"],
+	[1706, "IN_APP_ORIGINAL_PURCHASE_DATE"],
+	[1708, "IN_APP_EXPIRES_DATE"],
+	[1711, "IN_APP_WEB_ORDER_LINE_ITEM_ID"],
+	[1712, "IN_APP_CANCELLATION_DATE"]
 ]);
-
-// src/ReceiptVerifier.ts
-var import_asn1js = require("asn1js");
+//#endregion
+//#region src/ReceiptVerifier.ts
 var ReceiptVerifier = class {
-  receiptSchema;
-  fieldSchema;
-  constructor() {
-    this.receiptSchema = new import_asn1js.Sequence({
-      value: [
-        new import_asn1js.ObjectIdentifier(),
-        new import_asn1js.Constructed({
-          idBlock: { tagClass: 3, tagNumber: 0 },
-          value: [
-            new import_asn1js.Sequence({
-              value: [
-                new import_asn1js.Integer(),
-                new import_asn1js.Set({
-                  value: [
-                    new import_asn1js.Sequence({
-                      value: [new import_asn1js.ObjectIdentifier(), new import_asn1js.Any()]
-                    })
-                  ]
-                }),
-                new import_asn1js.Sequence({
-                  value: [
-                    new import_asn1js.ObjectIdentifier(),
-                    new import_asn1js.Constructed({
-                      idBlock: { tagClass: 3, tagNumber: 0 },
-                      value: [new import_asn1js.OctetString({ name: CONTENT_ID })]
-                    })
-                  ]
-                })
-              ]
-            })
-          ]
-        })
-      ]
-    });
-    this.fieldSchema = new import_asn1js.Sequence({
-      value: [
-        new import_asn1js.Integer({ name: FIELD_TYPE_ID }),
-        new import_asn1js.Integer(),
-        new import_asn1js.OctetString({ name: FIELD_VALUE_ID })
-      ]
-    });
-  }
-  verifyReceiptSchema(receipt) {
-    const receiptVerification = (0, import_asn1js.verifySchema)(Buffer.from(receipt, "base64"), this.receiptSchema);
-    if (!receiptVerification.verified) {
-      throw new Error("Receipt verification failed.");
-    }
-    return receiptVerification;
-  }
-  verifyFieldSchema(sequence) {
-    const fieldVerification = (0, import_asn1js.verifySchema)(sequence.toBER(), this.fieldSchema);
-    if (!fieldVerification.verified) {
-      return null;
-    }
-    return fieldVerification;
-  }
+	receiptSchema;
+	fieldSchema;
+	constructor() {
+		this.receiptSchema = new asn1js.Sequence({ value: [new asn1js.ObjectIdentifier(), new asn1js.Constructed({
+			idBlock: {
+				tagClass: 3,
+				tagNumber: 0
+			},
+			value: [new asn1js.Sequence({ value: [
+				new asn1js.Integer(),
+				new asn1js.Set({ value: [new asn1js.Sequence({ value: [new asn1js.ObjectIdentifier(), new asn1js.Any()] })] }),
+				new asn1js.Sequence({ value: [new asn1js.ObjectIdentifier(), new asn1js.Constructed({
+					idBlock: {
+						tagClass: 3,
+						tagNumber: 0
+					},
+					value: [new asn1js.OctetString({ name: CONTENT_ID })]
+				})] })
+			] })]
+		})] });
+		this.fieldSchema = new asn1js.Sequence({ value: [
+			new asn1js.Integer({ name: FIELD_TYPE_ID }),
+			new asn1js.Integer(),
+			new asn1js.OctetString({ name: FIELD_VALUE_ID })
+		] });
+	}
+	verifyReceiptSchema(receipt) {
+		const receiptVerification = (0, asn1js.verifySchema)(Buffer.from(receipt, "base64"), this.receiptSchema);
+		if (!receiptVerification.verified) throw new Error("Receipt verification failed.");
+		return receiptVerification;
+	}
+	verifyFieldSchema(sequence) {
+		const fieldVerification = (0, asn1js.verifySchema)(sequence.toBER(), this.fieldSchema);
+		if (!fieldVerification.verified) return null;
+		return fieldVerification;
+	}
 };
-
-// src/ReceiptParser.ts
+//#endregion
+//#region src/ReceiptParser.ts
 var ReceiptParser = class {
-  parsed;
-  receiptVerifier;
-  constructor() {
-    this.receiptVerifier = new ReceiptVerifier();
-    this.parsed = this.createInitialParsedReceipt();
-  }
-  parseReceipt(receipt) {
-    if (receipt.trim() === "") {
-      throw new Error("Receipt must be a non-empty string.");
-    }
-    const rootSchemaVerification = this.receiptVerifier.verifyReceiptSchema(receipt);
-    const content = rootSchemaVerification.result[CONTENT_ID];
-    this.parseReceiptContent(content);
-    this.validateParsedFields();
-    this.deduplicateArrayFields();
-    return this.parsed;
-  }
-  createInitialParsedReceipt() {
-    return {
-      ENVIRONMENT: "Production",
-      IN_APP_RECEIPTS: [],
-      IN_APP_ORIGINAL_TRANSACTION_IDS: [],
-      IN_APP_TRANSACTION_IDS: []
-    };
-  }
-  parseReceiptContent(content, inAppReceipt) {
-    const sequences = this.extractSequencesFromContent(content);
-    sequences.forEach((sequence) => this.processSequence(sequence, inAppReceipt));
-  }
-  extractSequencesFromContent(content) {
-    const [contentSet] = content.valueBlock.value;
-    return contentSet.valueBlock.value.filter((v) => v instanceof ASN1.Sequence);
-  }
-  processSequence(sequence, inAppReceipt) {
-    const verifiedSequence = this.receiptVerifier.verifyFieldSchema(sequence);
-    if (verifiedSequence) {
-      this.handleVerifiedSequence(verifiedSequence, inAppReceipt);
-    }
-  }
-  handleVerifiedSequence(verifiedSequence, inAppReceipt) {
-    const fieldKey = verifiedSequence.result[FIELD_TYPE_ID].valueBlock.valueDec;
-    const fieldValue = verifiedSequence.result[FIELD_VALUE_ID];
-    const handler = this.getFieldHandler(fieldKey, inAppReceipt);
-    handler(fieldValue);
-  }
-  getFieldHandler(fieldKey, inAppReceipt) {
-    if (fieldKey === IN_APP) {
-      return (fieldValue) => {
-        const parsedInAppReceipt = {};
-        this.parseReceiptContent(fieldValue, parsedInAppReceipt);
-        this.parsed.IN_APP_RECEIPTS.push(parsedInAppReceipt);
-      };
-    }
-    if (this.isValidReceiptFieldKey(fieldKey)) {
-      const name = RECEIPT_FIELDS_MAP.get(fieldKey);
-      return (fieldValue) => {
-        this.addFieldToReceipt(name, this.extractStringValue(fieldValue), inAppReceipt);
-      };
-    }
-    return () => {
-    };
-  }
-  isValidReceiptFieldKey(value) {
-    return typeof value === "number" && RECEIPT_FIELDS_MAP.has(value);
-  }
-  extractStringValue(field) {
-    const [fieldValue] = field.valueBlock.value;
-    if (fieldValue instanceof ASN1.IA5String || fieldValue instanceof ASN1.Utf8String) {
-      return fieldValue.valueBlock.value;
-    }
-    return field.toJSON().valueBlock.valueHex;
-  }
-  addFieldToReceipt(name, value, inAppReceipt) {
-    this.addToArrayFieldIfApplicable(name, value);
-    this.parsed[name] = value;
-    if (inAppReceipt) {
-      inAppReceipt[name] = value;
-    }
-  }
-  addToArrayFieldIfApplicable(name, value) {
-    const arrayFields = {
-      "IN_APP_ORIGINAL_TRANSACTION_ID": "IN_APP_ORIGINAL_TRANSACTION_IDS",
-      "IN_APP_TRANSACTION_ID": "IN_APP_TRANSACTION_IDS"
-    };
-    const arrayFieldName = arrayFields[name];
-    if (arrayFieldName) {
-      this.parsed[arrayFieldName].push(value);
-    }
-  }
-  validateParsedFields() {
-    const missingFields = Array.from(RECEIPT_FIELDS_MAP.values()).filter((fieldKey) => !(fieldKey in this.parsed));
-    if (missingFields.length > 0) {
-      throw new Error(`Missing required fields: ${missingFields.join(", ")}`);
-    }
-  }
-  deduplicateArrayFields() {
-    this.parsed.IN_APP_ORIGINAL_TRANSACTION_IDS = this.removeDuplicates(this.parsed.IN_APP_ORIGINAL_TRANSACTION_IDS);
-    this.parsed.IN_APP_TRANSACTION_IDS = this.removeDuplicates(this.parsed.IN_APP_TRANSACTION_IDS);
-  }
-  removeDuplicates(array) {
-    return [...new Set(array)];
-  }
+	parsed;
+	receiptVerifier;
+	constructor() {
+		this.receiptVerifier = new ReceiptVerifier();
+		this.parsed = this.createInitialParsedReceipt();
+	}
+	parseReceipt(receipt) {
+		if (receipt.trim() === "") throw new Error("Receipt must be a non-empty string.");
+		const content = this.receiptVerifier.verifyReceiptSchema(receipt).result[CONTENT_ID];
+		this.parseReceiptContent(content);
+		this.validateParsedFields();
+		this.deduplicateArrayFields();
+		return this.parsed;
+	}
+	createInitialParsedReceipt() {
+		return {
+			ENVIRONMENT: "Production",
+			IN_APP_RECEIPTS: [],
+			IN_APP_ORIGINAL_TRANSACTION_IDS: [],
+			IN_APP_TRANSACTION_IDS: []
+		};
+	}
+	parseReceiptContent(content, inAppReceipt) {
+		this.extractSequencesFromContent(content).forEach((sequence) => this.processSequence(sequence, inAppReceipt));
+	}
+	extractSequencesFromContent(content) {
+		const [contentSet] = content.valueBlock.value;
+		return contentSet.valueBlock.value.filter((v) => v instanceof asn1js.Sequence);
+	}
+	processSequence(sequence, inAppReceipt) {
+		const verifiedSequence = this.receiptVerifier.verifyFieldSchema(sequence);
+		if (verifiedSequence) this.handleVerifiedSequence(verifiedSequence, inAppReceipt);
+	}
+	handleVerifiedSequence(verifiedSequence, inAppReceipt) {
+		const fieldKey = verifiedSequence.result[FIELD_TYPE_ID].valueBlock.valueDec;
+		const fieldValue = verifiedSequence.result[FIELD_VALUE_ID];
+		this.getFieldHandler(fieldKey, inAppReceipt)(fieldValue);
+	}
+	getFieldHandler(fieldKey, inAppReceipt) {
+		if (fieldKey === 17) return (fieldValue) => {
+			const parsedInAppReceipt = {};
+			this.parseReceiptContent(fieldValue, parsedInAppReceipt);
+			this.parsed.IN_APP_RECEIPTS.push(parsedInAppReceipt);
+		};
+		if (this.isValidReceiptFieldKey(fieldKey)) {
+			const name = RECEIPT_FIELDS_MAP.get(fieldKey);
+			return (fieldValue) => {
+				this.addFieldToReceipt(name, this.extractStringValue(fieldValue), inAppReceipt);
+			};
+		}
+		return () => {};
+	}
+	isValidReceiptFieldKey(value) {
+		return typeof value === "number" && RECEIPT_FIELDS_MAP.has(value);
+	}
+	extractStringValue(field) {
+		const [fieldValue] = field.valueBlock.value;
+		if (fieldValue instanceof asn1js.IA5String || fieldValue instanceof asn1js.Utf8String) return fieldValue.valueBlock.value;
+		if (fieldValue instanceof asn1js.Integer) return fieldValue.toBigInt().toString();
+		return field.toJSON().valueBlock.valueHex;
+	}
+	addFieldToReceipt(name, value, inAppReceipt) {
+		this.addToArrayFieldIfApplicable(name, value);
+		this.parsed[name] = value;
+		if (inAppReceipt) inAppReceipt[name] = value;
+	}
+	addToArrayFieldIfApplicable(name, value) {
+		const arrayFieldName = {
+			"IN_APP_ORIGINAL_TRANSACTION_ID": "IN_APP_ORIGINAL_TRANSACTION_IDS",
+			"IN_APP_TRANSACTION_ID": "IN_APP_TRANSACTION_IDS"
+		}[name];
+		if (arrayFieldName) this.parsed[arrayFieldName].push(value);
+	}
+	validateParsedFields() {
+		const missingFields = Array.from(RECEIPT_FIELDS_MAP.values()).filter((fieldKey) => !fieldKey.startsWith("IN_APP_")).filter((fieldKey) => !(fieldKey in this.parsed));
+		if (missingFields.length > 0) throw new Error(`Missing required fields: ${missingFields.join(", ")}`);
+	}
+	deduplicateArrayFields() {
+		this.parsed.IN_APP_ORIGINAL_TRANSACTION_IDS = this.removeDuplicates(this.parsed.IN_APP_ORIGINAL_TRANSACTION_IDS);
+		this.parsed.IN_APP_TRANSACTION_IDS = this.removeDuplicates(this.parsed.IN_APP_TRANSACTION_IDS);
+	}
+	removeDuplicates(array) {
+		return [...new Set(array)];
+	}
 };
 function parseReceipt(receipt) {
-  return new ReceiptParser().parseReceipt(receipt);
+	return new ReceiptParser().parseReceipt(receipt);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  parseReceipt
-});
+//#endregion
+exports.parseReceipt = parseReceipt;

package/dist/index.mjs

@@ -1,200 +1,165 @@
-// src/ReceiptParser.ts
 import * as ASN1 from "asn1js";
-
-// src/constants.ts
-var IN_APP = 17;
-var CONTENT_ID = "pkcs7_content";
-var FIELD_TYPE_ID = "FieldType";
-var FIELD_VALUE_ID = "FieldTypeOctetString";
-var RECEIPT_FIELDS_MAP = /* @__PURE__ */ new Map([
-  [0, "ENVIRONMENT"],
-  [2, "BUNDLE_ID"],
-  [3, "APP_VERSION"],
-  [4, "OPAQUE_VALUE"],
-  [5, "SHA1_HASH"],
-  [12, "RECEIPT_CREATION_DATE"],
-  [18, "ORIGINAL_PURCHASE_DATE"],
-  [19, "ORIGINAL_APP_VERSION"],
-  [1701, "IN_APP_QUANTITY"],
-  [1702, "IN_APP_PRODUCT_ID"],
-  [1703, "IN_APP_TRANSACTION_ID"],
-  [1704, "IN_APP_PURCHASE_DATE"],
-  [1705, "IN_APP_ORIGINAL_TRANSACTION_ID"],
-  [1706, "IN_APP_ORIGINAL_PURCHASE_DATE"],
-  [1708, "IN_APP_EXPIRES_DATE"],
-  [1711, "IN_APP_WEB_ORDER_LINE_ITEM_ID"],
-  [1712, "IN_APP_CANCELLATION_DATE"]
+import { Any, Constructed, Integer, ObjectIdentifier, OctetString, Sequence, Set as Set$1, verifySchema } from "asn1js";
+//#region src/constants.ts
+/** Identifies pkcs7 content information encoded as Octet string  */
+const CONTENT_ID = "pkcs7_content";
+/** Identifies field type id information */
+const FIELD_TYPE_ID = "FieldType";
+/** Identifies field value information encoded as Octet string */
+const FIELD_VALUE_ID = "FieldTypeOctetString";
+/**
+* Receipt fields
+* @see https://developer.apple.com/library/archive/releasenotes/General/ValidateAppStoreReceipt/Chapters/ReceiptFields.html
+*/
+const RECEIPT_FIELDS_MAP = new Map([
+	[0, "ENVIRONMENT"],
+	[2, "BUNDLE_ID"],
+	[3, "APP_VERSION"],
+	[4, "OPAQUE_VALUE"],
+	[5, "SHA1_HASH"],
+	[12, "RECEIPT_CREATION_DATE"],
+	[18, "ORIGINAL_PURCHASE_DATE"],
+	[19, "ORIGINAL_APP_VERSION"],
+	[1701, "IN_APP_QUANTITY"],
+	[1702, "IN_APP_PRODUCT_ID"],
+	[1703, "IN_APP_TRANSACTION_ID"],
+	[1704, "IN_APP_PURCHASE_DATE"],
+	[1705, "IN_APP_ORIGINAL_TRANSACTION_ID"],
+	[1706, "IN_APP_ORIGINAL_PURCHASE_DATE"],
+	[1708, "IN_APP_EXPIRES_DATE"],
+	[1711, "IN_APP_WEB_ORDER_LINE_ITEM_ID"],
+	[1712, "IN_APP_CANCELLATION_DATE"]
 ]);
-
-// src/ReceiptVerifier.ts
-import { Any, Constructed, Integer, ObjectIdentifier, OctetString, Sequence, Set as Set2, verifySchema } from "asn1js";
+//#endregion
+//#region src/ReceiptVerifier.ts
 var ReceiptVerifier = class {
-  receiptSchema;
-  fieldSchema;
-  constructor() {
-    this.receiptSchema = new Sequence({
-      value: [
-        new ObjectIdentifier(),
-        new Constructed({
-          idBlock: { tagClass: 3, tagNumber: 0 },
-          value: [
-            new Sequence({
-              value: [
-                new Integer(),
-                new Set2({
-                  value: [
-                    new Sequence({
-                      value: [new ObjectIdentifier(), new Any()]
-                    })
-                  ]
-                }),
-                new Sequence({
-                  value: [
-                    new ObjectIdentifier(),
-                    new Constructed({
-                      idBlock: { tagClass: 3, tagNumber: 0 },
-                      value: [new OctetString({ name: CONTENT_ID })]
-                    })
-                  ]
-                })
-              ]
-            })
-          ]
-        })
-      ]
-    });
-    this.fieldSchema = new Sequence({
-      value: [
-        new Integer({ name: FIELD_TYPE_ID }),
-        new Integer(),
-        new OctetString({ name: FIELD_VALUE_ID })
-      ]
-    });
-  }
-  verifyReceiptSchema(receipt) {
-    const receiptVerification = verifySchema(Buffer.from(receipt, "base64"), this.receiptSchema);
-    if (!receiptVerification.verified) {
-      throw new Error("Receipt verification failed.");
-    }
-    return receiptVerification;
-  }
-  verifyFieldSchema(sequence) {
-    const fieldVerification = verifySchema(sequence.toBER(), this.fieldSchema);
-    if (!fieldVerification.verified) {
-      return null;
-    }
-    return fieldVerification;
-  }
+	receiptSchema;
+	fieldSchema;
+	constructor() {
+		this.receiptSchema = new Sequence({ value: [new ObjectIdentifier(), new Constructed({
+			idBlock: {
+				tagClass: 3,
+				tagNumber: 0
+			},
+			value: [new Sequence({ value: [
+				new Integer(),
+				new Set$1({ value: [new Sequence({ value: [new ObjectIdentifier(), new Any()] })] }),
+				new Sequence({ value: [new ObjectIdentifier(), new Constructed({
+					idBlock: {
+						tagClass: 3,
+						tagNumber: 0
+					},
+					value: [new OctetString({ name: CONTENT_ID })]
+				})] })
+			] })]
+		})] });
+		this.fieldSchema = new Sequence({ value: [
+			new Integer({ name: FIELD_TYPE_ID }),
+			new Integer(),
+			new OctetString({ name: FIELD_VALUE_ID })
+		] });
+	}
+	verifyReceiptSchema(receipt) {
+		const receiptVerification = verifySchema(Buffer.from(receipt, "base64"), this.receiptSchema);
+		if (!receiptVerification.verified) throw new Error("Receipt verification failed.");
+		return receiptVerification;
+	}
+	verifyFieldSchema(sequence) {
+		const fieldVerification = verifySchema(sequence.toBER(), this.fieldSchema);
+		if (!fieldVerification.verified) return null;
+		return fieldVerification;
+	}
 };
-
-// src/ReceiptParser.ts
+//#endregion
+//#region src/ReceiptParser.ts
 var ReceiptParser = class {
-  parsed;
-  receiptVerifier;
-  constructor() {
-    this.receiptVerifier = new ReceiptVerifier();
-    this.parsed = this.createInitialParsedReceipt();
-  }
-  parseReceipt(receipt) {
-    if (receipt.trim() === "") {
-      throw new Error("Receipt must be a non-empty string.");
-    }
-    const rootSchemaVerification = this.receiptVerifier.verifyReceiptSchema(receipt);
-    const content = rootSchemaVerification.result[CONTENT_ID];
-    this.parseReceiptContent(content);
-    this.validateParsedFields();
-    this.deduplicateArrayFields();
-    return this.parsed;
-  }
-  createInitialParsedReceipt() {
-    return {
-      ENVIRONMENT: "Production",
-      IN_APP_RECEIPTS: [],
-      IN_APP_ORIGINAL_TRANSACTION_IDS: [],
-      IN_APP_TRANSACTION_IDS: []
-    };
-  }
-  parseReceiptContent(content, inAppReceipt) {
-    const sequences = this.extractSequencesFromContent(content);
-    sequences.forEach((sequence) => this.processSequence(sequence, inAppReceipt));
-  }
-  extractSequencesFromContent(content) {
-    const [contentSet] = content.valueBlock.value;
-    return contentSet.valueBlock.value.filter((v) => v instanceof ASN1.Sequence);
-  }
-  processSequence(sequence, inAppReceipt) {
-    const verifiedSequence = this.receiptVerifier.verifyFieldSchema(sequence);
-    if (verifiedSequence) {
-      this.handleVerifiedSequence(verifiedSequence, inAppReceipt);
-    }
-  }
-  handleVerifiedSequence(verifiedSequence, inAppReceipt) {
-    const fieldKey = verifiedSequence.result[FIELD_TYPE_ID].valueBlock.valueDec;
-    const fieldValue = verifiedSequence.result[FIELD_VALUE_ID];
-    const handler = this.getFieldHandler(fieldKey, inAppReceipt);
-    handler(fieldValue);
-  }
-  getFieldHandler(fieldKey, inAppReceipt) {
-    if (fieldKey === IN_APP) {
-      return (fieldValue) => {
-        const parsedInAppReceipt = {};
-        this.parseReceiptContent(fieldValue, parsedInAppReceipt);
-        this.parsed.IN_APP_RECEIPTS.push(parsedInAppReceipt);
-      };
-    }
-    if (this.isValidReceiptFieldKey(fieldKey)) {
-      const name = RECEIPT_FIELDS_MAP.get(fieldKey);
-      return (fieldValue) => {
-        this.addFieldToReceipt(name, this.extractStringValue(fieldValue), inAppReceipt);
-      };
-    }
-    return () => {
-    };
-  }
-  isValidReceiptFieldKey(value) {
-    return typeof value === "number" && RECEIPT_FIELDS_MAP.has(value);
-  }
-  extractStringValue(field) {
-    const [fieldValue] = field.valueBlock.value;
-    if (fieldValue instanceof ASN1.IA5String || fieldValue instanceof ASN1.Utf8String) {
-      return fieldValue.valueBlock.value;
-    }
-    return field.toJSON().valueBlock.valueHex;
-  }
-  addFieldToReceipt(name, value, inAppReceipt) {
-    this.addToArrayFieldIfApplicable(name, value);
-    this.parsed[name] = value;
-    if (inAppReceipt) {
-      inAppReceipt[name] = value;
-    }
-  }
-  addToArrayFieldIfApplicable(name, value) {
-    const arrayFields = {
-      "IN_APP_ORIGINAL_TRANSACTION_ID": "IN_APP_ORIGINAL_TRANSACTION_IDS",
-      "IN_APP_TRANSACTION_ID": "IN_APP_TRANSACTION_IDS"
-    };
-    const arrayFieldName = arrayFields[name];
-    if (arrayFieldName) {
-      this.parsed[arrayFieldName].push(value);
-    }
-  }
-  validateParsedFields() {
-    const missingFields = Array.from(RECEIPT_FIELDS_MAP.values()).filter((fieldKey) => !(fieldKey in this.parsed));
-    if (missingFields.length > 0) {
-      throw new Error(`Missing required fields: ${missingFields.join(", ")}`);
-    }
-  }
-  deduplicateArrayFields() {
-    this.parsed.IN_APP_ORIGINAL_TRANSACTION_IDS = this.removeDuplicates(this.parsed.IN_APP_ORIGINAL_TRANSACTION_IDS);
-    this.parsed.IN_APP_TRANSACTION_IDS = this.removeDuplicates(this.parsed.IN_APP_TRANSACTION_IDS);
-  }
-  removeDuplicates(array) {
-    return [...new Set(array)];
-  }
+	parsed;
+	receiptVerifier;
+	constructor() {
+		this.receiptVerifier = new ReceiptVerifier();
+		this.parsed = this.createInitialParsedReceipt();
+	}
+	parseReceipt(receipt) {
+		if (receipt.trim() === "") throw new Error("Receipt must be a non-empty string.");
+		const content = this.receiptVerifier.verifyReceiptSchema(receipt).result[CONTENT_ID];
+		this.parseReceiptContent(content);
+		this.validateParsedFields();
+		this.deduplicateArrayFields();
+		return this.parsed;
+	}
+	createInitialParsedReceipt() {
+		return {
+			ENVIRONMENT: "Production",
+			IN_APP_RECEIPTS: [],
+			IN_APP_ORIGINAL_TRANSACTION_IDS: [],
+			IN_APP_TRANSACTION_IDS: []
+		};
+	}
+	parseReceiptContent(content, inAppReceipt) {
+		this.extractSequencesFromContent(content).forEach((sequence) => this.processSequence(sequence, inAppReceipt));
+	}
+	extractSequencesFromContent(content) {
+		const [contentSet] = content.valueBlock.value;
+		return contentSet.valueBlock.value.filter((v) => v instanceof ASN1.Sequence);
+	}
+	processSequence(sequence, inAppReceipt) {
+		const verifiedSequence = this.receiptVerifier.verifyFieldSchema(sequence);
+		if (verifiedSequence) this.handleVerifiedSequence(verifiedSequence, inAppReceipt);
+	}
+	handleVerifiedSequence(verifiedSequence, inAppReceipt) {
+		const fieldKey = verifiedSequence.result[FIELD_TYPE_ID].valueBlock.valueDec;
+		const fieldValue = verifiedSequence.result[FIELD_VALUE_ID];
+		this.getFieldHandler(fieldKey, inAppReceipt)(fieldValue);
+	}
+	getFieldHandler(fieldKey, inAppReceipt) {
+		if (fieldKey === 17) return (fieldValue) => {
+			const parsedInAppReceipt = {};
+			this.parseReceiptContent(fieldValue, parsedInAppReceipt);
+			this.parsed.IN_APP_RECEIPTS.push(parsedInAppReceipt);
+		};
+		if (this.isValidReceiptFieldKey(fieldKey)) {
+			const name = RECEIPT_FIELDS_MAP.get(fieldKey);
+			return (fieldValue) => {
+				this.addFieldToReceipt(name, this.extractStringValue(fieldValue), inAppReceipt);
+			};
+		}
+		return () => {};
+	}
+	isValidReceiptFieldKey(value) {
+		return typeof value === "number" && RECEIPT_FIELDS_MAP.has(value);
+	}
+	extractStringValue(field) {
+		const [fieldValue] = field.valueBlock.value;
+		if (fieldValue instanceof ASN1.IA5String || fieldValue instanceof ASN1.Utf8String) return fieldValue.valueBlock.value;
+		if (fieldValue instanceof ASN1.Integer) return fieldValue.toBigInt().toString();
+		return field.toJSON().valueBlock.valueHex;
+	}
+	addFieldToReceipt(name, value, inAppReceipt) {
+		this.addToArrayFieldIfApplicable(name, value);
+		this.parsed[name] = value;
+		if (inAppReceipt) inAppReceipt[name] = value;
+	}
+	addToArrayFieldIfApplicable(name, value) {
+		const arrayFieldName = {
+			"IN_APP_ORIGINAL_TRANSACTION_ID": "IN_APP_ORIGINAL_TRANSACTION_IDS",
+			"IN_APP_TRANSACTION_ID": "IN_APP_TRANSACTION_IDS"
+		}[name];
+		if (arrayFieldName) this.parsed[arrayFieldName].push(value);
+	}
+	validateParsedFields() {
+		const missingFields = Array.from(RECEIPT_FIELDS_MAP.values()).filter((fieldKey) => !fieldKey.startsWith("IN_APP_")).filter((fieldKey) => !(fieldKey in this.parsed));
+		if (missingFields.length > 0) throw new Error(`Missing required fields: ${missingFields.join(", ")}`);
+	}
+	deduplicateArrayFields() {
+		this.parsed.IN_APP_ORIGINAL_TRANSACTION_IDS = this.removeDuplicates(this.parsed.IN_APP_ORIGINAL_TRANSACTION_IDS);
+		this.parsed.IN_APP_TRANSACTION_IDS = this.removeDuplicates(this.parsed.IN_APP_TRANSACTION_IDS);
+	}
+	removeDuplicates(array) {
+		return [...new Set(array)];
+	}
 };
 function parseReceipt(receipt) {
-  return new ReceiptParser().parseReceipt(receipt);
+	return new ReceiptParser().parseReceipt(receipt);
 }
-export {
-  parseReceipt
-};
+//#endregion
+export { parseReceipt };

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@tamtamchik/app-store-receipt-parser",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "A lightweight TypeScript library for extracting selected fields from Apple's ASN.1 encoded receipts.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
-  "types": "./src/index.ts",
+  "types": "./dist/index.d.ts",
   "author": "Yuri Tkachenko <yuri.tam.tkachenko@gmail.com>",
   "license": "MIT",
   "homepage": "https://github.com/tamtamchik/app-store-receipt-parser#readme",
@@ -26,7 +26,7 @@
   ],
   "exports": {
     ".": {
-      "types": "./src/index.ts",
+      "types": "./dist/index.d.ts",
       "require": "./dist/index.js",
       "import": "./dist/index.mjs"
     }
@@ -41,13 +41,13 @@
     "c8": "^11.0.0",
     "eslint": "^10.2.0",
     "globals": "^17.5.0",
-    "tsup": "^8.0.2",
+    "tsdown": "^0.22.2",
     "tsx": "^4.21.0",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.58.2"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --clean",
+    "build": "tsdown",
     "dev": "npm run build -- --watch src",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",

package/src/ReceiptParser.ts

@@ -11,7 +11,7 @@ import {
 
 import { ReceiptVerifier } from './ReceiptVerifier'
 
-export type Environment = 'Production' | 'ProductionSandbox' | string
+export type Environment = 'Production' | 'ProductionSandbox' | (string & {})
 
 export type InAppReceipt = Partial<Record<ReceiptFieldsKeyNames, string>>
 
@@ -115,6 +115,10 @@ class ReceiptParser {
       return fieldValue.valueBlock.value
     }
 
+    if (fieldValue instanceof ASN1.Integer) {
+      return fieldValue.toBigInt().toString()
+    }
+
     return field.toJSON().valueBlock.valueHex
   }
 
@@ -139,7 +143,9 @@ class ReceiptParser {
   }
 
   private validateParsedFields(): void {
+    // In-app fields are optional: a valid receipt may contain no in-app purchases.
     const missingFields = Array.from(RECEIPT_FIELDS_MAP.values())
+      .filter(fieldKey => !fieldKey.startsWith('IN_APP_'))
       .filter(fieldKey => !(fieldKey in this.parsed))
 
     if (missingFields.length > 0) {

package/src/index.ts

@@ -1,2 +1,2 @@
-export type { InAppReceipt, ParsedReceipt } from './ReceiptParser'
+export type { Environment, InAppReceipt, ParsedReceipt } from './ReceiptParser'
 export { parseReceipt } from './ReceiptParser'

package/tsdown.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['cjs', 'esm'],
+  dts: true,
+  clean: true,
+  // Keep the file names the package has always shipped (index.js / index.mjs / index.d.ts)
+  outExtensions: ({ format }) => ({
+    js: format === 'cjs' ? '.js' : '.mjs',
+    dts: format === 'cjs' ? '.d.ts' : '.d.mts',
+  }),
+})