# `@peculiar/asn1-pfx`

[![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/PeculiarVentures/asn1-schema/blob/master/packages/pfx/LICENSE)
[![npm version](https://badge.fury.io/js/%40peculiar%2Fasn1-pfx.svg)](https://badge.fury.io/js/%40peculiar%2Fasn1-pfx)

[![NPM](https://nodei.co/npm/@peculiar/asn1-pfx.png)](https://nodei.co/npm/@peculiar/asn1-pfx/)

ASN.1 schema for PKCS #12 personal information exchange structures defined in RFC 7292.

Use the exported classes with `@peculiar/asn1-schema` helpers such as `AsnConvert`, `AsnParser`, and `AsnSerializer` to parse or serialize DER-encoded data defined by the referenced specification.

## Installation

```bash
npm install @peculiar/asn1-pfx
```

## Breaking Changes In v3

v3 is ESM-only and requires Node.js `^20.19.0 || >=22.12.0` (was `>=14`). CommonJS code can still `require("@peculiar/asn1-pfx")` on these versions; Node.js 22.0–22.11 can't. The public API is unchanged. See the [full notes](https://github.com/PeculiarVentures/asn1-schema#breaking-changes-in-v3).

- **TypeScript compiling to CommonJS:** use `"module": "node20"` or `"nodenext"` (`node16` fails with TS1479). ESM and bundler setups need no changes.
- **Jest in CommonJS mode:** switch to ESM mode or Vitest, or configure an ESM-to-CommonJS transformer and make sure `transformIgnorePatterns` doesn't exclude the `@peculiar/*` packages and `asn1js`.
- **Deep imports** (`@peculiar/asn1-pfx/build/...`) are blocked by `exports`; import from `@peculiar/asn1-pfx`.
- **Peer dependencies:** `@peculiar/asn1-schema` (`^3.0.0`) is a peer instead of a dependency, so your app shares one copy with the other `@peculiar/asn1-*` packages. npm installs peers automatically.

## Specifications

- [RFC 7292: PKCS #12: Personal Information Exchange Syntax](https://datatracker.ietf.org/doc/html/rfc7292)