tsdmarc 0.0.0-stage → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# tsdmarc
+
+## 1.0.0
+
+### Major Changes
+
+- a1c5fad: First release: a 1:1 TypeScript port of parsedmarc 11.2.1 and of the parts of mailsuite 2.3.4 it uses, for Node.js 24+, Bun and Deno.
+
+### Patch Changes
+
+- Updated dependencies [a1c5fad]
+  - @tsdmarc/ipinfo-lite@1.0.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,61 @@
+tsdmarc
+Copyright 2026 tsdmarc contributors
+
+This product is a TypeScript port of parsedmarc
+(https://github.com/domainaware/parsedmarc), Copyright Sean Whalen and
+parsedmarc contributors, licensed under the Apache License, Version 2.0.
+Ported from parsedmarc 11.2.1, commit 7bbc405c01a1c4c37811b2a3746e8881c00cda39.
+
+The mailbox connection and SMTP code is a port of mailsuite
+(https://github.com/seanthegeek/mailsuite), Copyright Sean Whalen,
+licensed under the Apache License, Version 2.0.
+Ported from mailsuite 2.3.4, commit 3bd62831d137c9aa7884be33b83323ca3a1bd1de.
+
+All source files were translated from Python to TypeScript; this is a
+modification of the original works within the meaning of section 4(b) of
+the Apache License.
+
+Third-party data files in resources/:
+- ipinfo_lite.mmdb: IPinfo Lite, (c) IPinfo (https://ipinfo.io/lite),
+  licensed under CC BY-SA 4.0.
+- base_reverse_dns_map.csv: from parsedmarc, derived in part from IPinfo
+  Lite data, licensed under CC BY-SA 4.0.
+
+Ported third-party code in packages/tsdmarc/src (behavior reimplemented in
+TypeScript to reproduce parsedmarc's output exactly):
+- xml/expat.ts, xml/expat-names.ts: port of parts of Expat 2.9.0
+  (https://libexpat.github.io/), Copyright (c) 1997-2000 Thai Open Source
+  Software Center Ltd and Copyright (c) 2000-2026 Expat development team,
+  licensed under the MIT License.
+- xml/xmltodict.ts: port of xmltodict (https://github.com/martinblech/xmltodict),
+  Copyright (c) 2012 Martin Blech, licensed under the MIT License.
+- xml/recover.ts: emulates the observable recovery behavior of libxml2
+  (https://gitlab.gnome.org/GNOME/libxml2), MIT License.
+- utils/py-email/, utils/py-codecs*.ts, utils/py-binascii.ts, utils/py-str.ts,
+  csv.ts, utils/csv-reader.ts, utils/url-split.ts: ports of parts of the
+  CPython standard library (https://github.com/python/cpython), Copyright (c)
+  2001 Python Software Foundation, licensed under the PSF License Agreement.
+- utils/mailparser/: port of mail-parser 4.8.0
+  (https://github.com/SpamScope/mail-parser), Copyright Fedele Mantuano,
+  licensed under the Apache License, Version 2.0.
+- utils/dns*.ts: port of parts of dnspython (https://www.dnspython.org/),
+  Copyright (c) Dnspython Contributors, licensed under the ISC License.
+- utils/timestamps.ts: date parsing compatible with python-dateutil
+  (https://github.com/dateutil/dateutil), Apache License 2.0 / BSD 3-Clause.
+- internal/zipfile.ts and the decompressor wrappers in internal/bz2.ts,
+  internal/lzma.ts, internal/zstd.ts and internal/zlib.ts: ports of parts of
+  the CPython standard library (zipfile, bz2, lzma, compression.zstd, zlib
+  modules), Copyright (c) 2001 Python Software Foundation, licensed under the
+  PSF License Agreement.
+- internal/zlib.ts: port of the inflate code of zlib 1.3 (https://zlib.net/),
+  Copyright (C) 1995-2023 Jean-loup Gailly and Mark Adler, licensed under the
+  zlib License.
+- internal/bz2.ts: port of the libbzip2 1.0.8 decompressor
+  (https://sourceware.org/bzip2/), Copyright (C) 1996-2019 Julian R Seward,
+  licensed under the bzip2 license (BSD-style).
+- internal/lzma.ts: port of the LZMA1 decoder of liblzma 5.8
+  (https://tukaani.org/xz/), by Igor Pavlov and Lasse Collin, licensed under
+  the BSD Zero Clause License (0BSD).
+- internal/zstd.ts: port of the libzstd 1.5.7 decoder
+  (https://github.com/facebook/zstd), Copyright (c) Meta Platforms, Inc. and
+  affiliates, licensed under the BSD 3-Clause License.

package/README.md

@@ -1,3 +1,138 @@
-# Temporary Holding Version
+# tsdmarc
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DMARC report parser for Node.js, Bun and Deno: parses DMARC aggregate (RUA) reports, DMARC failure (RUF, formerly "forensic") reports and SMTP TLS (TLS-RPT) reports, enriches them with GeoIP, reverse DNS and base-domain data, and writes parsedmarc-compatible JSON and CSV.
+
+This is the core package of [tsdmarc](https://github.com/helixnebulatech/tsdmarc#readme), a 1:1 TypeScript port of [parsedmarc](https://github.com/domainaware/parsedmarc) 11.2.1. Its output is checked against reference fixtures generated by parsedmarc itself.
+
+## Install
+
+```bash
+npm install tsdmarc
+# optional: the IPinfo Lite database (~25 MB), for GeoIP without downloads
+npm install @tsdmarc/ipinfo-lite
+```
+
+Node.js ≥ 24, Bun or Deno 2. ESM only.
+
+## Parse a report file
+
+`parseReportFile()` accepts a path, bytes or a stream, and detects the format: aggregate XML (plain, zip or gzip), SMTP TLS JSON, or a report email (`.eml`, including failure reports).
+
+```ts
+import {
+  parsedAggregateReportsToCsv,
+  parseReportFile,
+  pyJsonDumps,
+  toSnakeCaseKeys,
+} from 'tsdmarc';
+
+const parsed = await parseReportFile('report.xml.gz', { offline: true });
+
+if (parsed.reportType === 'aggregate') {
+  const { reportMetadata, policyPublished, records } = parsed.report;
+  console.log(reportMetadata.orgName, policyPublished.domain, records.length);
+  console.log(parsedAggregateReportsToCsv(parsed.report));
+}
+
+// parsedmarc's JSON: snake_case keys, big integers written exactly
+console.log(pyJsonDumps(toSnakeCaseKeys(parsed), { indent: 2 }));
+```
+
+`parsed.reportType` is `'aggregate'`, `'failure'` or `'smtp_tls'`, and `parsed.report` is typed accordingly (`AggregateReport`, `FailureReport`, `SMTPTLSReport`).
+
+## Process a mailbox
+
+`getDmarcReportsFromMailbox()` reads every message in a folder, parses the reports, and moves the messages to `Archive/Aggregate`, `Archive/Failure`, `Archive/SMTP-TLS` or `Archive/Invalid`. `MaildirConnection` is in this package; IMAP, Gmail and Microsoft Graph are in `@tsdmarc/imap`, `@tsdmarc/gmail` and `@tsdmarc/msgraph`.
+
+```ts
+import {
+  getDmarcReportsFromMailbox,
+  MaildirConnection,
+  saveOutput,
+} from 'tsdmarc';
+
+const connection = new MaildirConnection('/var/mail/dmarc');
+try {
+  const results = await getDmarcReportsFromMailbox(connection, {
+    archiveFolder: 'Archive',
+    batchSize: 10,
+  });
+  // aggregate.json, aggregate.csv, failure.json, failure.csv,
+  // smtp_tls.json, smtp_tls.csv
+  await saveOutput(results, { outputDirectory: 'output' });
+} finally {
+  await connection.close();
+}
+```
+
+`watchInbox(connection, callback, options)` keeps watching the folder (IMAP IDLE or polling) and calls `callback(results)` for each batch; pass `signal` (an `AbortSignal`) to stop it.
+
+## Parser options
+
+Every parsing function (`parseReportFile`, `parseReportEmail`, `parseAggregateReportXml`, `getDmarcReportsFromMailbox`, `watchInbox`, ...) accepts these options, or a `config` built once with `createParserConfig()`:
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `offline` | `false` | No DNS queries and no downloads. GeoIP still works with a local database. |
+| `ipDbPath` | `null` | Path to an MMDB file (IPinfo, MaxMind or DB-IP). |
+| `alwaysUseLocalFiles` | `false` | Use the bundled reverse DNS map and PSL overrides instead of downloading them. |
+| `reverseDnsMapPath` / `reverseDnsMapUrl` | `null` | A custom reverse DNS map (file or URL). |
+| `nameservers` | `null` | DNS servers (plain IPs, `https://` for DoH, `tls://` for DoT). `null`: Cloudflare. |
+| `dnsTimeout` | `2.0` | DNS query timeout, in seconds. |
+| `dnsRetries` | `0` | Retries after a DNS timeout or transient error. |
+| `stripAttachmentPayloads` | `false` | Remove attachment payloads from failure report samples. |
+| `normalizeTimespanThresholdHours` | `24` | Aggregate records spanning more hours are split into daily buckets. |
+| `maxEmailSize` | 50 MiB | Largest email accepted (`0`: no limit). Not in parsedmarc. |
+| `maxMimeParts` | `10000` | Most MIME boundary lines accepted (`0`: no limit). Not in parsedmarc. |
+| `maxHeaderLines` | `100000` | Most header lines in an email, over all its parts (`0`: no limit). Not in parsedmarc. |
+| `maxExpandedEmailSize` | 512 MiB | Most text, in characters (twice for text beyond Latin-1), re-serializing one email's parts may produce (`0`: no limit). Not in parsedmarc. |
+| `maxNormalizedRecords` | `250000` | Most records of an aggregate report once split into daily buckets (`0`: no limit). Not in parsedmarc. |
+| `maxXmlDepth` / `maxXmlNodes` | `100000` / `5000000` | Deepest nesting, and most elements and attributes, in an aggregate report's XML (`0`: no limit). Not in parsedmarc. |
+| `maxSmtpTlsReportSize` | 10 MiB | Largest SMTP TLS report JSON (`0`: no limit). Not in parsedmarc. |
+| `maxLookupsPerReport` / `maxFailedLookupsPerReport` / `maxLookupTimePerReport` | `100000` / `256` / `600` | Network lookups, failed reverse DNS lookups, and seconds of lookups, per aggregate report; past any of them, the remaining IPs only get the IP database (`0`: no limit). Not in parsedmarc. |
+| `jobTimeout` | `3600` | Seconds one email or file may take to parse (`0`: no limit). Not in parsedmarc. |
+| `maxWorkerHeapMb` | `2048` | Heap limit of each parsing worker, in MiB (`0`: the runtime's). Not in parsedmarc. |
+
+## GeoIP
+
+IP lookups use, in this order: `ipDbPath`; the database chosen by `loadIpDb()`; the `@tsdmarc/ipinfo-lite` package when installed. `loadIpDb()` (what the `tsdmarc` CLI calls at startup) downloads the latest IPinfo Lite database into a per-user cache directory and falls back to the cached or bundled copy when offline. `await configureIpinfoApi(token)` makes the IPinfo Lite REST API the primary source, falling back to the database on errors.
+
+## API overview
+
+All exports are named exports of `tsdmarc`. Types are exported too (`AggregateReport`, `FailureReport`, `SMTPTLSReport`, `ParsingResults`, `ParserConfig`, ...).
+
+- **Parsing:** `parseReportFile`, `parseReportEmail`, `parseAggregateReportXml`, `parseAggregateReportFile`, `parseAggregateReportFromFilePath`, `parseFailureReport`, `parseSmtpTlsReportJson`, `extractReport`, `getDmarcReportsFromMbox`
+- **CSV:** `parsedAggregateReportsToCsv`, `parsedFailureReportsToCsv`, `parsedSmtpTlsReportsToCsv` (and `...ToCsvRows`), `rowsToCsv`, `CsvDictWriter`
+- **Files:** `saveOutput`, `appendJson`, `appendCsv`, `getReportZip`
+- **Mailboxes:** `MailboxConnection` (base class), `MaildirConnection`, `getDmarcReportsFromMailbox`, `watchInbox`
+- **Outputs without an SDK:** `HECClient` (Splunk), `LokiClient` (Grafana Loki push API; throws `LokiError` when a push fails, redirects are not followed), `SyslogClient`, `GelfClient`, `WebhookClient` (pass `throwOnError: true` to throw on network errors, timeouts and non-2xx responses instead of logging them, as the CLI does)
+- **Enrichment:** `getIpAddressInfo`, `loadIpDb`, `configureIpinfoApi`, `loadReverseDnsMap`, `getReverseDns`, `queryDns`, `reverseNameFromAddress`, `getBaseDomain`
+- **Log safety:** `sanitizeForLog`, `redactUrlCredentials` (masks URL passwords as `user:***@`), `maskNameserverSecrets`
+- **Parallel parsing:** `parallelMap`, `parseReportFileTask`, `parseReportEmailTask` (worker threads)
+- **Serialization:** `toSnakeCaseKeys`, `toCamelCaseKeys`, `pyJsonDumps`
+- **Logging:** `logger`, `configureLogging`, `captureLogs`, Python-style levels (`DEBUG`, `INFO`, ...)
+- **Errors:** `ParserError`, `InvalidDMARCReport`, `InvalidAggregateReport`, `InvalidFailureReport`, `InvalidSMTPTLSReport`, `EmailTooLargeError`, `EnrichmentError` (`InvalidIPinfoAPIKey`, `IPDatabaseError`), `PrivilegeDropError`, `SyslogError`, `GelfError`, `JobTimeoutError`, `WorkerCrashedError`
+
+Backward-compatible aliases kept from parsedmarc (`parseForensicReport`, `InvalidForensicReport`, `parsedForensicReportsToCsv`) are exported as well.
+
+## camelCase in, snake_case out
+
+Report objects use camelCase keys (`report.reportMetadata.orgName`). Every output (JSON and CSV files, Splunk, Loki, syslog, GELF, webhook, and the `@tsdmarc/*` outputs) uses parsedmarc's snake_case names, so existing dashboards and queries keep working. Convert a report yourself with `toSnakeCaseKeys()`.
+
+## Other packages
+
+| Package | For |
+| --- | --- |
+| [`@tsdmarc/cli`](https://www.npmjs.com/package/@tsdmarc/cli) | The `tsdmarc` command (parsedmarc-compatible INI config) |
+| [`@tsdmarc/imap`](https://www.npmjs.com/package/@tsdmarc/imap), [`@tsdmarc/gmail`](https://www.npmjs.com/package/@tsdmarc/gmail), [`@tsdmarc/msgraph`](https://www.npmjs.com/package/@tsdmarc/msgraph) | Mailbox connections |
+| [`@tsdmarc/smtp`](https://www.npmjs.com/package/@tsdmarc/smtp) | Email the results |
+| [`@tsdmarc/elasticsearch`](https://www.npmjs.com/package/@tsdmarc/elasticsearch), [`@tsdmarc/opensearch`](https://www.npmjs.com/package/@tsdmarc/opensearch), [`@tsdmarc/postgres`](https://www.npmjs.com/package/@tsdmarc/postgres), [`@tsdmarc/kafka`](https://www.npmjs.com/package/@tsdmarc/kafka), [`@tsdmarc/s3`](https://www.npmjs.com/package/@tsdmarc/s3), [`@tsdmarc/loganalytics`](https://www.npmjs.com/package/@tsdmarc/loganalytics) | Outputs |
+| [`@tsdmarc/ipinfo-lite`](https://www.npmjs.com/package/@tsdmarc/ipinfo-lite) | Offline GeoIP database |
+
+Differences from parsedmarc (security hardening, size limits, camelCase API, ...) are listed in [architecture/README.md](https://github.com/helixnebulatech/tsdmarc/blob/main/architecture/README.md#differences-from-parsedmarc).
+
+---
+
+Part of [tsdmarc](https://github.com/helixnebulatech/tsdmarc#readme), a TypeScript port of [parsedmarc](https://github.com/domainaware/parsedmarc). Licensed under Apache-2.0.
+
+Created by [HelixNebula](https://helixnebula.tech).