@seedprotocol/archive 0.0.0-stage → 0.7.11-next.1384.g8b47246

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+All notable changes to this package are documented in this file.
+
+## 0.7.10 (2026-10-24)
+
+- New package. `createBag` and `validateBag` write and check BagIt 1.0 bags with SHA-256 and SHA-512 payload and tag manifests; `writeBagDirectory` and `readBagDirectory` (from `@seedprotocol/archive/node`) move them to and from disk. `parseArchiveDocument` reads an h-entry archive document, `rewriteHtmlUrls` splices new `src`/`href`/`poster` values into Html, and `dublinCoreXml` and `premisXml` write Dublin Core and PREMIS 3.0 metadata.

package/README.md

@@ -1,3 +1,70 @@
-# Temporary Holding Version
+# @seedprotocol/archive
 
-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.
+[![npm](https://img.shields.io/npm/v/@seedprotocol/archive.svg)](https://www.npmjs.com/package/@seedprotocol/archive)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Archive packaging for [Seed Protocol](https://seedprotocol.io): [BagIt](https://www.rfc-editor.org/rfc/rfc8493)
+1.0 bags with SHA-256 and SHA-512 manifests, [PREMIS 3.0](https://www.loc.gov/standards/premis/v3/)
+and Dublin Core metadata, and a reader for [h-entry](https://microformats.org/wiki/h-entry) archive
+documents. It works on bytes and plain objects and depends on no other Seed package, so archive
+tools and servers can use it without the SDK.
+
+To export a Seed item, use `exportArchive` from [`@seedprotocol/sdk`](https://www.npmjs.com/package/@seedprotocol/sdk),
+which builds its bag with this package. The bag's layout is described in
+[docs/ARCHIVE.md](https://github.com/JournoLabs/seed-protocol-sdk/blob/main/docs/ARCHIVE.md).
+
+## Installation
+
+```bash
+npm install @seedprotocol/archive
+```
+
+## Bags
+
+```ts
+import { createBag, validateBag } from '@seedprotocol/archive'
+import { writeBagDirectory, readBagDirectory } from '@seedprotocol/archive/node'
+
+const bag = createBag({
+  payload: [{ path: 'index.html', bytes: html }],          // paths relative to data/
+  tagFiles: [{ path: 'metadata/dc.xml', bytes: dcXml }],    // listed in the tag manifests
+  info: [['Source-Organization', 'The Daily Example']],
+})
+await writeBagDirectory(bag, './bag')                       // the directory must be empty or absent
+
+const { valid, errors } = validateBag(await readBagDirectory('./bag'))
+```
+
+`createBag` adds Bagging-Date, Payload-Oxum and Bag-Software-Agent unless you pass them. It throws
+`ArchiveError` for a path that won't survive another file system: absolute, `..` or empty
+segments, backslashes, control characters, `%`, text not in Unicode NFC, or two paths that differ
+only in letter case.
+
+`validateBag` checks bagit.txt, every payload and tag manifest entry, unlisted payload files and
+Payload-Oxum. It checks SHA-256 and SHA-512 manifests and reports a manifest for any other
+algorithm as an error. For an independent check, run the Library of Congress validator:
+`pipx run --spec bagit==1.9.0 bagit.py --validate ./bag`.
+
+## Archive documents
+
+```ts
+import { parseArchiveDocument, rewriteHtmlUrls } from '@seedprotocol/archive'
+
+const { method, content, name, summary, authors, published, featured } = parseArchiveDocument(html)
+```
+
+The body is read from `.h-entry .e-content`, then `[itemprop=articleBody]`, then a lone
+`<article>` without its `<header>` and `<footer>`, then the whole input; `method` says which.
+`content` is sliced from the source string, so it comes back byte for byte. Only the h-entry
+properties archives use are read (p-name, p-summary, p-author, dt-published, u-featured, u-url,
+e-content); implied properties and value-class patterns are not applied.
+
+`rewriteHtmlUrls(html, map)` replaces whole `src`, `href` and `poster` values that `map` returns a
+new URL for, by splicing them into the original string. `srcset` is not rewritten.
+
+## Metadata
+
+`dublinCoreXml(record)` writes an `oai_dc:dc` record; `premisXml({ objects, events, agents })`
+writes PREMIS 3.0 with event and agent types from the Library of Congress preservation
+vocabularies (`valueURI="http://id.loc.gov/vocabulary/preservation/eventType/cre"` and so on).
+Both validate against the official schemas.

package/dist/bag-BkZhe-zN.js

@@ -0,0 +1,72 @@
+import { sha256 as e, sha512 as t } from "@noble/hashes/sha2";
+import { bytesToHex as n } from "@noble/hashes/utils";
+//#region src/bytes.ts
+var r = ["sha256", "sha512"], i = (r, i) => n(r === "sha256" ? e(i) : t(i)), a = new TextEncoder(), o = new TextDecoder("utf-8", { fatal: !0 }), s = (e) => a.encode(e), c = (e) => {
+	try {
+		return o.decode(e);
+	} catch {
+		return;
+	}
+}, l = class extends Error {
+	code;
+	constructor(e, t) {
+		super(t), this.name = "ArchiveError", this.code = e;
+	}
+}, u = "1.0", d = "@seedprotocol/archive (https://github.com/JournoLabs/seed-protocol-sdk)", f = /^(bagit\.txt|bag-info\.txt|fetch\.txt|(tag)?manifest-[a-z0-9]+\.txt)$/, p = /[\u0000-\u001f\u007f]/, m = /^[^\s:][^:\r\n]*$/;
+function h(e) {
+	let t = e === "" ? "is empty" : e.startsWith("/") ? "is absolute" : e.includes("\\") ? "contains a backslash" : p.test(e) ? "contains a control character" : e.includes("%") ? "contains \"%\"" : e.split("/").some((e) => e === "" || e === "." || e === "..") ? "has an empty, \".\" or \"..\" segment" : e.normalize("NFC") === e ? void 0 : "is not in Unicode NFC";
+	if (t) throw new l("invalid_path", `Bag path ${JSON.stringify(e)} ${t}`);
+}
+var g = (e) => e.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A"), _ = (e) => e.replace(/%0D/gi, "\r").replace(/%0A/gi, "\n").replace(/%25/g, "%"), v = (e, t) => t.map((t) => `${i(e, t.bytes)}  ${g(t.path)}\n`).join(""), y = (e) => e.map(([e, t]) => {
+	if (!m.test(e)) throw new l("invalid_bag_info", `bag-info.txt label ${JSON.stringify(e)} is not valid`);
+	return `${e}: ${t.replace(/\r\n?/g, "\n").split("\n").join("\n  ")}\n`;
+}).join(""), b = (e) => e.toISOString().slice(0, 10), x = (e, t) => e.path < t.path ? -1 : +(e.path > t.path);
+function S(e) {
+	let t = e.payload.map((e) => (h(e.path), {
+		path: `data/${e.path}`,
+		bytes: e.bytes
+	})), n = (e.tagFiles ?? []).map((e) => {
+		if (h(e.path), e.path.startsWith("data/") || f.test(e.path)) throw new l("invalid_path", `${e.path} can't be supplied as a tag file`);
+		return e;
+	}), i = /* @__PURE__ */ new Map();
+	for (let { path: e } of [...t, ...n]) {
+		let t = e.toLowerCase(), n = i.get(t);
+		if (n !== void 0) throw new l("duplicate_path", n === e ? `${e} appears twice` : `${n} and ${e} differ only in letter case`);
+		i.set(t, e);
+	}
+	t.sort(x), n.sort(x);
+	let a = [...e.info ?? []], o = (e) => a.some(([t]) => t.toLowerCase() === e.toLowerCase());
+	if (o("Bagging-Date") || a.push(["Bagging-Date", b(e.baggingDate ?? /* @__PURE__ */ new Date())]), !o("Payload-Oxum")) {
+		let e = t.reduce((e, t) => e + t.bytes.byteLength, 0);
+		a.push(["Payload-Oxum", `${e}.${t.length}`]);
+	}
+	o("Bag-Software-Agent") || a.push(["Bag-Software-Agent", e.softwareAgent ?? "@seedprotocol/archive (https://github.com/JournoLabs/seed-protocol-sdk)"]);
+	let c = [
+		{
+			path: "bagit.txt",
+			bytes: s("BagIt-Version: 1.0\nTag-File-Character-Encoding: UTF-8\n")
+		},
+		{
+			path: "bag-info.txt",
+			bytes: s(y(a))
+		},
+		...r.map((e) => ({
+			path: `manifest-${e}.txt`,
+			bytes: s(v(e, t))
+		})),
+		...n
+	], u = r.map((e) => ({
+		path: `tagmanifest-${e}.txt`,
+		bytes: s(v(e, c))
+	}));
+	return { files: [
+		...c,
+		...u,
+		...t
+	] };
+}
+var C = (e, t) => e.files.find((e) => e.path === t);
+//#endregion
+export { _ as a, l as c, c as d, S as i, r as l, d as n, g as o, h as r, C as s, u as t, i as u };
+
+//# sourceMappingURL=bag-BkZhe-zN.js.map

package/dist/bag-BkZhe-zN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bag-BkZhe-zN.js","names":["BAG_ALGORITHMS","digestHex","bytesToHex","algorithm","sha256","bytes","sha512","encoder","decoder","utf8","text","fromUtf8","ArchiveError","message","code","BAGIT_VERSION","DEFAULT_SOFTWARE_AGENT","RESERVED_TAG_PATH","CONTROL_CHARACTER","BAG_INFO_LABEL","assertBagPath","problem","path","segment","encodeManifestPath","decodeManifestPath","field","manifestText","files","file","bagInfoText","entries","label","value","isoDate","date","byPath","a","b","createBag","payload","options","extraTags","seen","key","previous","info","has","l","octets","sum","tagFiles","tagManifests","getBagFile","bag","f"],"sources":["../src/bytes.ts","../src/errors.ts","../src/bag.ts"],"sourcesContent":["import { sha256, sha512 } from '@noble/hashes/sha2'\nimport { bytesToHex } from '@noble/hashes/utils'\n\n/** Checksum algorithms every bag carries a manifest for, in the order the manifests are written. */\nexport const BAG_ALGORITHMS = ['sha256', 'sha512'] as const\nexport type BagAlgorithm = (typeof BAG_ALGORITHMS)[number]\n\n/** Lowercase hex digest of `bytes`. @noble/hashes rather than WebCrypto, so it also runs outside secure contexts. */\nexport const digestHex = (algorithm: BagAlgorithm, bytes: Uint8Array): string =>\n  bytesToHex(algorithm === 'sha256' ? sha256(bytes) : sha512(bytes))\n\nconst encoder = new TextEncoder()\nconst decoder = new TextDecoder('utf-8', { fatal: true })\n\nexport const utf8 = (text: string): Uint8Array => encoder.encode(text)\n\n/** `bytes` as UTF-8 text, or undefined when they are not valid UTF-8. */\nexport const fromUtf8 = (bytes: Uint8Array): string | undefined => {\n  try {\n    return decoder.decode(bytes)\n  } catch {\n    return undefined\n  }\n}\n","export type ArchiveErrorCode = 'invalid_path' | 'duplicate_path' | 'invalid_bag_info'\n\n/** A bag that can't be built as asked. `code` says why; the message names the file or field. */\nexport class ArchiveError extends Error {\n  readonly code: ArchiveErrorCode\n\n  constructor(code: ArchiveErrorCode, message: string) {\n    super(message)\n    this.name = 'ArchiveError'\n    this.code = code\n  }\n}\n","import { BAG_ALGORITHMS, digestHex, utf8 } from './bytes'\nimport { ArchiveError } from './errors'\n\n/**\n * BagIt bags (RFC 8493, BagIt 1.0). A bag here is a list of files with bag-relative paths, so\n * the same value can be written to a directory (`@seedprotocol/archive/node`), zipped, or\n * uploaded file by file. Every bag carries SHA-256 and SHA-512 payload and tag manifests.\n */\n\n/** One file of a bag. `path` is relative to the bag's base directory and uses `/`. */\nexport type BagFile = { path: string; bytes: Uint8Array }\n\n/** A bag-info.txt line. Labels may repeat, and their order is kept. */\nexport type BagInfoEntry = [label: string, value: string]\n\nexport type Bag = { files: BagFile[] }\n\nexport type CreateBagOptions = {\n  /** Payload files, with paths relative to `data/` (e.g. `index.html`, `assets/<sha256>.png`). */\n  payload: BagFile[]\n  /**\n   * Tag files other than the ones the bag writes itself, with paths relative to the bag's base\n   * (e.g. `metadata/dc.xml`). They are listed in the tag manifests.\n   */\n  tagFiles?: BagFile[]\n  /** bag-info.txt entries. Bagging-Date, Payload-Oxum and Bag-Software-Agent are added when missing. */\n  info?: BagInfoEntry[]\n  /** Bagging-Date. Defaults to today (UTC). */\n  baggingDate?: Date\n  /** Bag-Software-Agent value. */\n  softwareAgent?: string\n}\n\nexport const BAGIT_VERSION = '1.0'\nexport const DEFAULT_SOFTWARE_AGENT = '@seedprotocol/archive (https://github.com/JournoLabs/seed-protocol-sdk)'\n\n/** Tag files the bag writes itself; callers can't supply files at these paths. */\nconst RESERVED_TAG_PATH = /^(bagit\\.txt|bag-info\\.txt|fetch\\.txt|(tag)?manifest-[a-z0-9]+\\.txt)$/\nconst CONTROL_CHARACTER = /[\\u0000-\\u001f\\u007f]/\nconst BAG_INFO_LABEL = /^[^\\s:][^:\\r\\n]*$/\n\n/**\n * Throws unless `path` is a portable bag-relative path: `/`-separated, no empty, `.` or `..`\n * segments, no backslash, control characters or `%`, and in Unicode NFC (two spellings of one\n * name would be different files on some file systems and the same file on others).\n *\n * `%` is refused because validators disagree on it: RFC 8493 writes it as `%25` in manifests,\n * and bagit-python 1.9.0 (the Library of Congress reference validator) doesn't decode `%25`, so\n * it reports the file as missing.\n */\nexport function assertBagPath(path: string): void {\n  const problem =\n    path === ''\n      ? 'is empty'\n      : path.startsWith('/')\n        ? 'is absolute'\n        : path.includes('\\\\')\n          ? 'contains a backslash'\n          : CONTROL_CHARACTER.test(path)\n            ? 'contains a control character'\n            : path.includes('%')\n              ? 'contains \"%\"'\n            : path.split('/').some((segment) => segment === '' || segment === '.' || segment === '..')\n              ? 'has an empty, \".\" or \"..\" segment'\n              : path.normalize('NFC') !== path\n                ? 'is not in Unicode NFC'\n                : undefined\n  if (problem) throw new ArchiveError('invalid_path', `Bag path ${JSON.stringify(path)} ${problem}`)\n}\n\n/** A manifest's filepath field: RFC 8493 §2.1.3 requires `%`, CR and LF percent-encoded. */\nexport const encodeManifestPath = (path: string): string =>\n  path.replace(/%/g, '%25').replace(/\\r/g, '%0D').replace(/\\n/g, '%0A')\n\nexport const decodeManifestPath = (field: string): string =>\n  field.replace(/%0D/gi, '\\r').replace(/%0A/gi, '\\n').replace(/%25/g, '%')\n\nconst manifestText = (algorithm: (typeof BAG_ALGORITHMS)[number], files: BagFile[]): string =>\n  files.map((file) => `${digestHex(algorithm, file.bytes)}  ${encodeManifestPath(file.path)}\\n`).join('')\n\n/** bag-info.txt: one `Label: value` line per entry, with line breaks in a value folded onto indented lines. */\nconst bagInfoText = (entries: BagInfoEntry[]): string =>\n  entries\n    .map(([label, value]) => {\n      if (!BAG_INFO_LABEL.test(label)) {\n        throw new ArchiveError('invalid_bag_info', `bag-info.txt label ${JSON.stringify(label)} is not valid`)\n      }\n      const folded = value.replace(/\\r\\n?/g, '\\n').split('\\n').join('\\n  ')\n      return `${label}: ${folded}\\n`\n    })\n    .join('')\n\nconst isoDate = (date: Date): string => date.toISOString().slice(0, 10)\n\nconst byPath = (a: BagFile, b: BagFile): number => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0)\n\n/**\n * Builds a BagIt 1.0 bag: bagit.txt, bag-info.txt, SHA-256 and SHA-512 payload manifests, the\n * caller's tag files, and SHA-256 and SHA-512 tag manifests covering every tag file.\n *\n * Throws {@link ArchiveError} for a path that isn't portable ({@link assertBagPath}), a reserved\n * tag file name, a tag file under `data/`, or two files whose paths differ only in letter case\n * (they would collide on case-insensitive file systems).\n */\nexport function createBag(options: CreateBagOptions): Bag {\n  const payload = options.payload.map((file) => {\n    assertBagPath(file.path)\n    return { path: `data/${file.path}`, bytes: file.bytes }\n  })\n  const extraTags = (options.tagFiles ?? []).map((file) => {\n    assertBagPath(file.path)\n    if (file.path.startsWith('data/') || RESERVED_TAG_PATH.test(file.path)) {\n      throw new ArchiveError('invalid_path', `${file.path} can't be supplied as a tag file`)\n    }\n    return file\n  })\n\n  const seen = new Map<string, string>()\n  for (const { path } of [...payload, ...extraTags]) {\n    const key = path.toLowerCase()\n    const previous = seen.get(key)\n    if (previous !== undefined) {\n      throw new ArchiveError(\n        'duplicate_path',\n        previous === path ? `${path} appears twice` : `${previous} and ${path} differ only in letter case`,\n      )\n    }\n    seen.set(key, path)\n  }\n  payload.sort(byPath)\n  extraTags.sort(byPath)\n\n  const info = [...(options.info ?? [])]\n  const has = (label: string) => info.some(([l]) => l.toLowerCase() === label.toLowerCase())\n  if (!has('Bagging-Date')) info.push(['Bagging-Date', isoDate(options.baggingDate ?? new Date())])\n  if (!has('Payload-Oxum')) {\n    const octets = payload.reduce((sum, file) => sum + file.bytes.byteLength, 0)\n    info.push(['Payload-Oxum', `${octets}.${payload.length}`])\n  }\n  if (!has('Bag-Software-Agent')) info.push(['Bag-Software-Agent', options.softwareAgent ?? DEFAULT_SOFTWARE_AGENT])\n\n  const tagFiles: BagFile[] = [\n    { path: 'bagit.txt', bytes: utf8(`BagIt-Version: ${BAGIT_VERSION}\\nTag-File-Character-Encoding: UTF-8\\n`) },\n    { path: 'bag-info.txt', bytes: utf8(bagInfoText(info)) },\n    ...BAG_ALGORITHMS.map((algorithm) => ({\n      path: `manifest-${algorithm}.txt`,\n      bytes: utf8(manifestText(algorithm, payload)),\n    })),\n    ...extraTags,\n  ]\n  const tagManifests = BAG_ALGORITHMS.map((algorithm) => ({\n    path: `tagmanifest-${algorithm}.txt`,\n    bytes: utf8(manifestText(algorithm, tagFiles)),\n  }))\n\n  return { files: [...tagFiles, ...tagManifests, ...payload] }\n}\n\n/** The bag's file at `path`, if any. */\nexport const getBagFile = (bag: Bag, path: string): BagFile | undefined => bag.files.find((f) => f.path === path)\n"],"mappings":"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"}

package/dist/bag.d.ts

@@ -0,0 +1,57 @@
+/**
+ * BagIt bags (RFC 8493, BagIt 1.0). A bag here is a list of files with bag-relative paths, so
+ * the same value can be written to a directory (`@seedprotocol/archive/node`), zipped, or
+ * uploaded file by file. Every bag carries SHA-256 and SHA-512 payload and tag manifests.
+ */
+/** One file of a bag. `path` is relative to the bag's base directory and uses `/`. */
+export type BagFile = {
+    path: string;
+    bytes: Uint8Array;
+};
+/** A bag-info.txt line. Labels may repeat, and their order is kept. */
+export type BagInfoEntry = [label: string, value: string];
+export type Bag = {
+    files: BagFile[];
+};
+export type CreateBagOptions = {
+    /** Payload files, with paths relative to `data/` (e.g. `index.html`, `assets/<sha256>.png`). */
+    payload: BagFile[];
+    /**
+     * Tag files other than the ones the bag writes itself, with paths relative to the bag's base
+     * (e.g. `metadata/dc.xml`). They are listed in the tag manifests.
+     */
+    tagFiles?: BagFile[];
+    /** bag-info.txt entries. Bagging-Date, Payload-Oxum and Bag-Software-Agent are added when missing. */
+    info?: BagInfoEntry[];
+    /** Bagging-Date. Defaults to today (UTC). */
+    baggingDate?: Date;
+    /** Bag-Software-Agent value. */
+    softwareAgent?: string;
+};
+export declare const BAGIT_VERSION = "1.0";
+export declare const DEFAULT_SOFTWARE_AGENT = "@seedprotocol/archive (https://github.com/JournoLabs/seed-protocol-sdk)";
+/**
+ * Throws unless `path` is a portable bag-relative path: `/`-separated, no empty, `.` or `..`
+ * segments, no backslash, control characters or `%`, and in Unicode NFC (two spellings of one
+ * name would be different files on some file systems and the same file on others).
+ *
+ * `%` is refused because validators disagree on it: RFC 8493 writes it as `%25` in manifests,
+ * and bagit-python 1.9.0 (the Library of Congress reference validator) doesn't decode `%25`, so
+ * it reports the file as missing.
+ */
+export declare function assertBagPath(path: string): void;
+/** A manifest's filepath field: RFC 8493 §2.1.3 requires `%`, CR and LF percent-encoded. */
+export declare const encodeManifestPath: (path: string) => string;
+export declare const decodeManifestPath: (field: string) => string;
+/**
+ * Builds a BagIt 1.0 bag: bagit.txt, bag-info.txt, SHA-256 and SHA-512 payload manifests, the
+ * caller's tag files, and SHA-256 and SHA-512 tag manifests covering every tag file.
+ *
+ * Throws {@link ArchiveError} for a path that isn't portable ({@link assertBagPath}), a reserved
+ * tag file name, a tag file under `data/`, or two files whose paths differ only in letter case
+ * (they would collide on case-insensitive file systems).
+ */
+export declare function createBag(options: CreateBagOptions): Bag;
+/** The bag's file at `path`, if any. */
+export declare const getBagFile: (bag: Bag, path: string) => BagFile | undefined;
+//# sourceMappingURL=bag.d.ts.map

package/dist/bag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bag.d.ts","sourceRoot":"","sources":["../src/bag.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,sFAAsF;AACtF,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAA;AAEzD,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;AAEzD,MAAM,MAAM,GAAG,GAAG;IAAE,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,CAAA;AAEtC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gGAAgG;IAChG,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IACpB,sGAAsG;IACtG,IAAI,CAAC,EAAE,YAAY,EAAE,CAAA;IACrB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,aAAa,QAAQ,CAAA;AAClC,eAAO,MAAM,sBAAsB,4EAA4E,CAAA;AAO/G;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkBhD;AAED,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MACqB,CAAA;AAEvE,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,MACuB,CAAA;AAqB1E;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,GAAG,CAoDxD;AAED,wCAAwC;AACxC,eAAO,MAAM,UAAU,GAAI,KAAK,GAAG,EAAE,MAAM,MAAM,KAAG,OAAO,GAAG,SAAmD,CAAA"}

package/dist/bytes.d.ts

@@ -0,0 +1,9 @@
+/** Checksum algorithms every bag carries a manifest for, in the order the manifests are written. */
+export declare const BAG_ALGORITHMS: readonly ["sha256", "sha512"];
+export type BagAlgorithm = (typeof BAG_ALGORITHMS)[number];
+/** Lowercase hex digest of `bytes`. @noble/hashes rather than WebCrypto, so it also runs outside secure contexts. */
+export declare const digestHex: (algorithm: BagAlgorithm, bytes: Uint8Array) => string;
+export declare const utf8: (text: string) => Uint8Array;
+/** `bytes` as UTF-8 text, or undefined when they are not valid UTF-8. */
+export declare const fromUtf8: (bytes: Uint8Array) => string | undefined;
+//# sourceMappingURL=bytes.d.ts.map

package/dist/bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../src/bytes.ts"],"names":[],"mappings":"AAGA,oGAAoG;AACpG,eAAO,MAAM,cAAc,+BAAgC,CAAA;AAC3D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D,qHAAqH;AACrH,eAAO,MAAM,SAAS,GAAI,WAAW,YAAY,EAAE,OAAO,UAAU,KAAG,MACH,CAAA;AAKpE,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,UAAkC,CAAA;AAEtE,yEAAyE;AACzE,eAAO,MAAM,QAAQ,GAAI,OAAO,UAAU,KAAG,MAAM,GAAG,SAMrD,CAAA"}

package/dist/dublinCore.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Simple Dublin Core (the 15 DCMI elements), written as an `oai_dc:dc` record, the format every
+ * OAI-PMH repository must support. Each element may repeat; leave a field out rather than
+ * guessing a value.
+ */
+export type DublinCore = Partial<Record<'title' | 'creator' | 'subject' | 'description' | 'publisher' | 'contributor' | 'date' | 'type' | 'format' | 'identifier' | 'source' | 'language' | 'relation' | 'coverage' | 'rights', string | string[]>>;
+/** `record` as an `oai_dc:dc` XML document. Empty strings are left out. */
+export declare function dublinCoreXml(record: DublinCore): string;
+//# sourceMappingURL=dublinCore.d.ts.map

package/dist/dublinCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dublinCore.d.ts","sourceRoot":"","sources":["../src/dublinCore.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAC9B,MAAM,CACF,OAAO,GACP,SAAS,GACT,SAAS,GACT,aAAa,GACb,WAAW,GACX,aAAa,GACb,MAAM,GACN,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,UAAU,GACV,UAAU,GACV,QAAQ,EACV,MAAM,GAAG,MAAM,EAAE,CAClB,CACF,CAAA;AAoBD,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAgBxD"}

package/dist/errors.d.ts

@@ -0,0 +1,7 @@
+export type ArchiveErrorCode = 'invalid_path' | 'duplicate_path' | 'invalid_bag_info';
+/** A bag that can't be built as asked. `code` says why; the message names the file or field. */
+export declare class ArchiveError extends Error {
+    readonly code: ArchiveErrorCode;
+    constructor(code: ArchiveErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,gBAAgB,GAAG,kBAAkB,CAAA;AAErF,gGAAgG;AAChG,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;gBAEnB,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM;CAKpD"}

package/dist/hEntry.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Reads an archive document: Html that marks up an article as a microformats2 h-entry
+ * (https://microformats.org/wiki/h-entry), the way PermaPress seals a Post. Documents without
+ * an h-entry are read by fallbacks, so archives from other clients still yield a body.
+ *
+ * Only the properties archives use are read: p-name, p-summary, p-author, dt-published,
+ * u-featured, u-url and e-content. This is not a full microformats2 parser: implied
+ * properties and value-class patterns are not applied.
+ */
+/** How the body was found, most to least reliable. `fragment` means the whole input is the body. */
+export type ArchiveDocumentMethod = 'h-entry' | 'articleBody' | 'article' | 'fragment';
+export type ArchiveDocument = {
+    method: ArchiveDocumentMethod;
+    /** The body's exact source, sliced from the input (not re-serialized). */
+    content: string;
+    name?: string;
+    summary?: string;
+    /** dt-published as written: a `datetime`/`value` attribute, else the element's text. */
+    published?: string;
+    /** Each p-author: a nested h-card's p-name, else the element's text. */
+    authors: string[];
+    featured?: {
+        url: string;
+        alt?: string;
+    };
+    url?: string;
+};
+/**
+ * The body and descriptive fields of `html`. The body is taken, in order, from:
+ *
+ * 1. `.h-entry .e-content` (with the entry's other properties)
+ * 2. the first `[itemprop=articleBody]`
+ * 3. the only top-level `<article>`, without its direct `<header>` and `<footer>` children
+ * 4. the whole input
+ *
+ * An h-entry without e-content falls through to the later steps for its body, keeping its
+ * other properties.
+ */
+export declare function parseArchiveDocument(html: string): ArchiveDocument;
+//# sourceMappingURL=hEntry.d.ts.map

package/dist/hEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hEntry.d.ts","sourceRoot":"","sources":["../src/hEntry.ts"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AAEH,oGAAoG;AACpG,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAA;AAEtF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,qBAAqB,CAAA;IAC7B,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wEAAwE;IACxE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACxC,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AA8DD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAiDlE"}

package/dist/html.d.ts

@@ -0,0 +1,39 @@
+import { type DefaultTreeAdapterTypes } from 'parse5';
+export type HtmlElement = DefaultTreeAdapterTypes.Element;
+export type HtmlNode = DefaultTreeAdapterTypes.ChildNode;
+/** `html` parsed as a fragment with source offsets, so callers can slice or splice the original string. */
+export declare const parseHtmlWithLocations: (html: string) => DefaultTreeAdapterTypes.DocumentFragment;
+export declare const isElement: (node: HtmlNode) => node is HtmlElement;
+export declare const childElements: (node: {
+    childNodes?: HtmlNode[];
+}) => HtmlElement[];
+/** Calls `visit` for each element under `nodes`, depth first; returning false skips that element's children. */
+export declare function walkElements(nodes: HtmlNode[], visit: (element: HtmlElement) => boolean | void): void;
+export declare const attribute: (element: HtmlElement, name: string) => string | undefined;
+export declare const classTokens: (element: HtmlElement) => string[];
+/** Concatenated text of `node`, leaving out script, style and template content. */
+export declare function textContent(node: HtmlNode): string;
+/** The exact source of an element's children: from the end of its start tag to the start of its end tag. */
+export declare function innerSource(html: string, element: HtmlElement): string;
+/** The exact source of one node. */
+export declare const nodeSource: (html: string, node: HtmlNode) => string;
+/**
+ * Rewrites attribute values by splicing each new value into the original string, so every byte
+ * outside the rewritten attributes stays as written. Re-serializing the parsed tree would not
+ * round-trip (parse5 drops the newline after `<pre>`, a fragment parse drops doctype, html, head
+ * and body, and quoting, case and line endings are normalized), and sealed Html must not change.
+ *
+ * `rewrite` gets each attribute's entity-decoded value and returns the new value, or undefined to
+ * leave it. A rewritten attribute is written as `name="value"`.
+ */
+export declare function rewriteHtmlAttributes(html: string, rewrite: (element: HtmlElement, attrName: string, value: string) => string | undefined): string;
+/** Attributes whose whole value is one URL. `srcset` lists several and is not rewritten. */
+export declare const URL_ATTRIBUTES: Set<string>;
+/**
+ * Replaces whole `src`, `href` and `poster` values that `replace` maps to a new URL (e.g. a
+ * gateway URL to a bag-relative path). Values are compared trimmed. Other bytes are kept.
+ */
+export declare const rewriteHtmlUrls: (html: string, replace: (url: string) => string | undefined) => string;
+/** Every whole `src`, `href` and `poster` value in `html`, trimmed, each once, in document order. */
+export declare function findHtmlUrls(html: string): string[];
+//# sourceMappingURL=html.d.ts.map

package/dist/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,uBAAuB,EAAE,MAAM,QAAQ,CAAA;AAEpE,MAAM,MAAM,WAAW,GAAG,uBAAuB,CAAC,OAAO,CAAA;AACzD,MAAM,MAAM,QAAQ,GAAG,uBAAuB,CAAC,SAAS,CAAA;AAExD,2GAA2G;AAC3G,eAAO,MAAM,sBAAsB,GAAI,MAAM,MAAM,KAAG,uBAAuB,CAAC,gBACvB,CAAA;AAEvD,eAAO,MAAM,SAAS,GAAI,MAAM,QAAQ,KAAG,IAAI,IAAI,WAC6C,CAAA;AAEhG,eAAO,MAAM,aAAa,GAAI,MAAM;IAAE,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,KAAG,WAAW,EAClC,CAAA;AAQ3C,gHAAgH;AAChH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,GAAG,IAAI,GAAG,IAAI,CAMrG;AAED,eAAO,MAAM,SAAS,GAAI,SAAS,WAAW,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SACR,CAAA;AAEhE,eAAO,MAAM,WAAW,GAAI,SAAS,WAAW,KAAG,MAAM,EACS,CAAA;AAIlE,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAIlD;AAED,4GAA4G;AAC5G,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAKtE;AAED,oCAAoC;AACpC,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,MAAM,QAAQ,KAAG,MAGzD,CAAA;AAID;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GACrF,MAAM,CAkBR;AAED,4FAA4F;AAC5F,eAAO,MAAM,cAAc,aAAqC,CAAA;AAEhE;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,KAAG,MAG1F,CAAA;AAEH,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQnD"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { BAGIT_VERSION, DEFAULT_SOFTWARE_AGENT, assertBagPath, createBag, decodeManifestPath, encodeManifestPath, getBagFile, type Bag, type BagFile, type BagInfoEntry, type CreateBagOptions, } from './bag';
+export { validateBag, type BagValidation } from './validateBag';
+export { BAG_ALGORITHMS, digestHex, type BagAlgorithm } from './bytes';
+export { ArchiveError, type ArchiveErrorCode } from './errors';
+export { findHtmlUrls, rewriteHtmlAttributes, rewriteHtmlUrls } from './html';
+export { parseArchiveDocument, type ArchiveDocument, type ArchiveDocumentMethod } from './hEntry';
+export { dublinCoreXml, type DublinCore } from './dublinCore';
+export { PREMIS_AGENT_TYPES, PREMIS_EVENT_TYPES, premisXml, type Premis, type PremisAgent, type PremisAgentType, type PremisEvent, type PremisEventType, type PremisFile, type PremisIdentifier, type PremisIntellectualEntity, type PremisObject, } from './premis';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,KAAK,GAAG,EACR,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AAC7E,OAAO,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAA;AACjG,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,GAClB,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,277 @@
+import { a as e, c as t, d as n, i as r, l as i, n as a, o, r as s, s as c, t as l, u } from "./bag-BkZhe-zN.js";
+import { parseFragment as d } from "parse5";
+//#region src/validateBag.ts
+var f = /^(tag)?manifest-([a-z0-9]+)\.txt$/, p = (e) => {
+	let t = [];
+	for (let n of e.replace(/\r\n?/g, "\n").split("\n")) {
+		if (n === "") continue;
+		let e = t[t.length - 1];
+		if (/^\s/.test(n) && e) {
+			e[1] += `\n${n.trim()}`;
+			continue;
+		}
+		let r = n.indexOf(":");
+		r > 0 && t.push([n.slice(0, r).trim(), n.slice(r + 1).trim()]);
+	}
+	return t;
+};
+function m(t) {
+	let r = [], a = new Map(t.files.map((e) => [e.path, e])), o = (e) => {
+		let t = a.get(e);
+		if (!t) return;
+		let i = n(t.bytes);
+		return i === void 0 && r.push(`${e} is not valid UTF-8`), i;
+	}, s = o("bagit.txt");
+	if (s === void 0) r.push("bagit.txt is missing");
+	else {
+		let e = new Map(p(s)), t = e.get("BagIt-Version");
+		t !== "1.0" && t !== "0.97" && r.push(`bagit.txt declares BagIt-Version ${t ?? "(none)"}`), e.get("Tag-File-Character-Encoding")?.toUpperCase() !== "UTF-8" && r.push("bagit.txt does not declare Tag-File-Character-Encoding: UTF-8");
+	}
+	let c = t.files.filter((e) => e.path.startsWith("data/")).map((e) => e.path), l = t.files.map((e) => ({
+		file: e,
+		match: f.exec(e.path)
+	})).filter((e) => e.match !== null);
+	l.some(({ match: e }) => !e[1]) || r.push("no payload manifest (manifest-<algorithm>.txt)");
+	for (let { file: t, match: n } of l) {
+		let s = !!n[1], l = n[2];
+		if (!i.includes(l)) {
+			r.push(`${t.path}: algorithm ${l} is not supported by this validator`);
+			continue;
+		}
+		let d = o(t.path);
+		if (d === void 0) continue;
+		let f = /* @__PURE__ */ new Set();
+		for (let n of d.split("\n")) {
+			if (n.trim() === "") continue;
+			let i = /^([0-9a-fA-F]+)\s+(.+)$/.exec(n.replace(/\r$/, ""));
+			if (!i) {
+				r.push(`${t.path}: malformed line ${JSON.stringify(n)}`);
+				continue;
+			}
+			let o = e(i[2]);
+			f.add(o), !s && !o.startsWith("data/") && r.push(`${t.path}: ${o} is outside data/`);
+			let c = a.get(o);
+			c ? u(l, c.bytes) !== i[1].toLowerCase() && r.push(`${t.path}: ${o} does not match its ${l} checksum`) : r.push(`${t.path}: ${o} is listed but missing`);
+		}
+		if (!s) for (let e of c) f.has(e) || r.push(`${t.path}: payload file ${e} is not listed`);
+	}
+	let d = o("bag-info.txt"), m = d === void 0 ? void 0 : p(d).find(([e]) => e === "Payload-Oxum")?.[1];
+	if (m !== void 0) {
+		let e = t.files.filter((e) => e.path.startsWith("data/")).reduce((e, t) => e + t.bytes.byteLength, 0);
+		m !== `${e}.${c.length}` && r.push(`bag-info.txt: Payload-Oxum ${m} does not match the payload (${e}.${c.length})`);
+	}
+	return {
+		valid: r.length === 0,
+		errors: r
+	};
+}
+//#endregion
+//#region src/html.ts
+var h = (e) => d(e, { sourceCodeLocationInfo: !0 }), g = (e) => e.nodeName !== "#text" && e.nodeName !== "#comment" && e.nodeName !== "#documentType", _ = (e) => (e.childNodes ?? []).filter(g), v = (e) => e.tagName === "template" ? e.content?.childNodes ?? [] : e.childNodes ?? [];
+function y(e, t) {
+	for (let n of e) g(n) && t(n) !== !1 && y(v(n), t);
+}
+var b = (e, t) => e.attrs.find((e) => e.name === t && !e.prefix)?.value, x = (e) => (b(e, "class") ?? "").split(/\s+/).filter(Boolean), S = /* @__PURE__ */ new Set([
+	"script",
+	"style",
+	"template"
+]);
+function C(e) {
+	return e.nodeName === "#text" ? e.value : !g(e) || S.has(e.tagName) ? "" : (e.childNodes ?? []).map(C).join("");
+}
+function w(e, t) {
+	let n = t.sourceCodeLocation;
+	if (!n?.startTag) return "";
+	let r = n.endTag?.startOffset ?? n.endOffset;
+	return e.slice(n.startTag.endOffset, r);
+}
+var T = (e, t) => {
+	let n = t.sourceCodeLocation;
+	return n ? e.slice(n.startOffset, n.endOffset) : "";
+}, E = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;");
+function D(e, t) {
+	let n = h(e), r = [];
+	y(n.childNodes, (e) => {
+		for (let n of e.attrs) {
+			if (n.prefix) continue;
+			let i = t(e, n.name, n.value), a = e.sourceCodeLocation?.attrs?.[n.name];
+			i !== void 0 && a && r.push({
+				start: a.startOffset,
+				end: a.endOffset,
+				text: `${n.name}="${E(i)}"`
+			});
+		}
+	});
+	let i = e;
+	for (let e of r.sort((e, t) => t.start - e.start)) i = i.slice(0, e.start) + e.text + i.slice(e.end);
+	return i;
+}
+var O = /* @__PURE__ */ new Set([
+	"src",
+	"href",
+	"poster"
+]), k = (e, t) => D(e, (e, n, r) => O.has(n) ? t(r.trim()) : void 0);
+function A(e) {
+	let t = /* @__PURE__ */ new Set();
+	return y(h(e).childNodes, (e) => {
+		for (let n of e.attrs) !n.prefix && O.has(n.name) && n.value.trim() && t.add(n.value.trim());
+	}), [...t];
+}
+//#endregion
+//#region src/hEntry.ts
+var j = (e) => x(e).some((e) => e.startsWith("h-")), M = (e) => C(e).replace(/\s+/g, " ").trim(), N = (e, t) => {
+	let n;
+	return y(e, (e) => {
+		if (n) return !1;
+		if (x(e).includes(t)) return n = e, !1;
+	}), n;
+}, P = /* @__PURE__ */ new Set([
+	"time",
+	"ins",
+	"del"
+]);
+function F(e, t) {
+	let n = {
+		method: "h-entry",
+		content: "",
+		authors: []
+	}, r = !1;
+	return y(_(t), (t) => {
+		let i = x(t), a = j(t);
+		if (i.includes("p-author")) {
+			let e = M((a ? N(_(t), "p-name") : void 0) || t);
+			e && n.authors.push(e);
+		}
+		if (a) return !1;
+		if (i.includes("p-name") && n.name === void 0 && (n.name = M(t)), i.includes("p-summary") && n.summary === void 0 && (n.summary = M(t)), i.includes("dt-published") && n.published === void 0 && (n.published = (P.has(t.tagName) ? b(t, "datetime") : void 0) ?? b(t, "value") ?? M(t)), i.includes("u-featured") && n.featured === void 0) {
+			let e = b(t, "src") ?? b(t, "href") ?? M(t);
+			e && (n.featured = {
+				url: e.trim(),
+				alt: b(t, "alt")
+			});
+		}
+		if (i.includes("u-url") && n.url === void 0) {
+			let e = b(t, "href") ?? b(t, "src") ?? M(t);
+			e && (n.url = e.trim());
+		}
+		if (i.includes("e-content") && !r) return r = !0, n.content = w(e, t), !1;
+	}), n;
+}
+function I(e) {
+	let t = h(e).childNodes, n, r;
+	if (y(t, (e) => {
+		if (r) return !1;
+		if (x(e).includes("h-entry")) return r = e, !1;
+	}), r && (n = F(e, r), n.content || N(_(r), "e-content"))) return n;
+	let i = n ? {
+		name: n.name,
+		summary: n.summary,
+		published: n.published,
+		authors: n.authors,
+		featured: n.featured,
+		url: n.url
+	} : { authors: [] }, a;
+	if (y(t, (e) => {
+		if (a) return !1;
+		if (b(e, "itemprop")?.split(/\s+/).includes("articleBody")) return a = e, !1;
+	}), a) return {
+		...i,
+		method: "articleBody",
+		content: w(e, a)
+	};
+	let o = [];
+	if (y(t, (e) => {
+		if (e.tagName === "article") return o.push(e), !1;
+	}), o.length === 1) {
+		let t = (o[0].childNodes ?? []).filter((e) => !("tagName" in e) || e.tagName !== "header" && e.tagName !== "footer").map((t) => T(e, t)).join("");
+		return {
+			...i,
+			method: "article",
+			content: t
+		};
+	}
+	return {
+		...i,
+		method: "fragment",
+		content: e
+	};
+}
+//#endregion
+//#region src/xml.ts
+var L = /[\u0000-\u0008\u000b\u000c\u000e-\u001f￾￿]/g, R = (e) => e.replace(L, "�").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;"), z = (e) => Object.entries(e ?? {}).filter((e) => e[1] !== void 0).map(([e, t]) => ` ${e}="${R(t)}"`).join(""), B = (e, t, n, r) => n === void 0 ? "" : `${e}<${t}${z(r)}>${R(n)}</${t}>\n`, V = (e, t, n, r) => n === "" ? "" : `${e}<${t}${z(r)}>\n${n}${e}</${t}>\n`, H = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n", U = [
+	"title",
+	"creator",
+	"subject",
+	"description",
+	"publisher",
+	"contributor",
+	"date",
+	"type",
+	"format",
+	"identifier",
+	"source",
+	"language",
+	"relation",
+	"coverage",
+	"rights"
+];
+function W(e) {
+	let t = "";
+	for (let n of U) {
+		let r = e[n], i = r === void 0 ? [] : Array.isArray(r) ? r : [r];
+		for (let e of i) e !== "" && (t += B("  ", `dc:${n}`, e));
+	}
+	return H + "<oai_dc:dc xmlns:oai_dc=\"http://www.openarchives.org/OAI/2.0/oai_dc/\" xmlns:dc=\"http://purl.org/dc/elements/1.1/\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:schemaLocation=\"http://www.openarchives.org/OAI/2.0/oai_dc/ http://www.openarchives.org/OAI/2.0/oai_dc.xsd\">\n" + t + "</oai_dc:dc>\n";
+}
+//#endregion
+//#region src/premis.ts
+var G = {
+	creation: "cre",
+	modification: "mod",
+	"metadata modification": "mem",
+	"message digest calculation": "mes",
+	"information package creation": "ipc",
+	"fixity check": "fix",
+	validation: "val",
+	"digital signature generation": "dsg",
+	capture: "cap",
+	replication: "rep"
+}, K = {
+	person: "per",
+	organization: "org",
+	software: "sof",
+	hardware: "har"
+}, q = "http://id.loc.gov/vocabulary/preservation", J = (e, t, n) => V(e, t, B(`${e}  `, `premis:${t.replace("premis:", "")}Type`, n.type) + B(`${e}  `, `premis:${t.replace("premis:", "")}Value`, n.value)), Y = (e, t, n) => {
+	let r = t === "linkingAgentIdentifier" ? "linkingAgentRole" : "linkingObjectRole";
+	return V(e, `premis:${t}`, B(`${e}  `, `premis:${t}Type`, n.type) + B(`${e}  `, `premis:${t}Value`, n.value) + B(`${e}  `, `premis:${r}`, n.role));
+};
+function X(e) {
+	let t = "    ", n = e.identifiers.map((e) => J(t, "premis:objectIdentifier", e)).join("");
+	if (e.kind === "intellectualEntity") return V("  ", "premis:object", n, { "xsi:type": "premis:intellectualEntity" });
+	let r = Object.entries(e.fixity).map(([e, n]) => V(`${t}  `, "premis:fixity", B(`${t}    `, "premis:messageDigestAlgorithm", e) + B(`${t}    `, "premis:messageDigest", n))).join("");
+	return V("  ", "premis:object", n + V(t, "premis:objectCharacteristics", B(`${t}  `, "premis:compositionLevel", "0") + r + B(`${t}  `, "premis:size", String(e.size)) + V(`${t}  `, "premis:format", V(`${t}    `, "premis:formatDesignation", B(`${t}      `, "premis:formatName", e.formatName)))) + B(t, "premis:originalName", e.originalName), { "xsi:type": "premis:file" });
+}
+function Z(e) {
+	let t = "    ", n = G[e.type];
+	return V("  ", "premis:event", J(t, "premis:eventIdentifier", e.identifier) + B(t, "premis:eventType", e.type, {
+		authority: "eventType",
+		authorityURI: `${q}/eventType`,
+		valueURI: `${q}/eventType/${n}`
+	}) + B(t, "premis:eventDateTime", e.dateTime) + V(t, "premis:eventDetailInformation", B(`${t}  `, "premis:eventDetail", e.detail)) + V(t, "premis:eventOutcomeInformation", B(`${t}  `, "premis:eventOutcome", e.outcome) + V(`${t}  `, "premis:eventOutcomeDetail", B(`${t}    `, "premis:eventOutcomeDetailNote", e.outcomeNote))) + (e.agents ?? []).map((e) => Y(t, "linkingAgentIdentifier", e)).join("") + (e.objects ?? []).map((e) => Y(t, "linkingObjectIdentifier", e)).join(""));
+}
+function Q(e) {
+	let t = "    ";
+	return V("  ", "premis:agent", e.identifiers.map((e) => J(t, "premis:agentIdentifier", e)).join("") + B(t, "premis:agentName", e.name) + (e.type ? B(t, "premis:agentType", e.type, {
+		authority: "agentType",
+		authorityURI: `${q}/agentType`,
+		valueURI: `${q}/agentType/${K[e.type]}`
+	}) : "") + B(t, "premis:agentVersion", e.version) + B(t, "premis:agentNote", e.note));
+}
+function $(e) {
+	if (e.objects.length === 0) throw Error("PREMIS needs at least one object");
+	return H + "<premis:premis xmlns:premis=\"http://www.loc.gov/premis/v3\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:schemaLocation=\"http://www.loc.gov/premis/v3 https://www.loc.gov/standards/premis/premis.xsd\" version=\"3.0\">\n" + e.objects.map(X).join("") + (e.events ?? []).map(Z).join("") + (e.agents ?? []).map(Q).join("") + "</premis:premis>\n";
+}
+//#endregion
+export { t as ArchiveError, l as BAGIT_VERSION, i as BAG_ALGORITHMS, a as DEFAULT_SOFTWARE_AGENT, K as PREMIS_AGENT_TYPES, G as PREMIS_EVENT_TYPES, s as assertBagPath, r as createBag, e as decodeManifestPath, u as digestHex, W as dublinCoreXml, o as encodeManifestPath, A as findHtmlUrls, c as getBagFile, I as parseArchiveDocument, $ as premisXml, D as rewriteHtmlAttributes, k as rewriteHtmlUrls, m as validateBag };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["decodeManifestPath","ArchiveError","fromUtf8","createBag","BAG_ALGORITHMS","DEFAULT_SOFTWARE_AGENT","assertBagPath","getBagFile","BAGIT_VERSION","MANIFEST","parseTagLines","entries","line","text","last","colon","validateBag","errors","byPath","bag","file","path","decoded","declaration","fields","version","payloadPaths","f","manifests","m","match","isTag","algorithm","body","listed","parsed","target","digestHex","info","oxum","label","octets","sum","parseHtmlWithLocations","parseFragment","html","isElement","node","childElements","childrenOf","walkElements","nodes","visit","attribute","element","a","name","classTokens","NON_TEXT_ELEMENTS","textContent","innerSource","location","end","nodeSource","escapeAttributeValue","value","rewriteHtmlAttributes","fragment","edits","attr","next","rewrite","out","edit","b","URL_ATTRIBUTES","rewriteHtmlUrls","attrName","replace","findHtmlUrls","urls","isMicroformatRoot","c","cleanText","firstWithClass","found","roots","token","DATETIME_ELEMENTS","readHEntry","doc","contentFound","root","classes","nested","author","url","parseArchiveDocument","top","entry","entryRoot","base","articleBody","articles","content","INVALID_XML_CHARACTER","escapeXml","attributes","attrs","textElement","indent","parentElement","children","XML_DECLARATION","ELEMENT_ORDER","dublinCoreXml","record","values","v","PREMIS_EVENT_TYPES","PREMIS_AGENT_TYPES","VOCABULARY","identifier","id","linking","role","objectXml","i","ids","object","fixity","digest","eventXml","code","event","agent","agentXml","premisXml","premis","encodeManifestPath"],"sources":["../src/validateBag.ts","../src/html.ts","../src/hEntry.ts","../src/xml.ts","../src/dublinCore.ts","../src/premis.ts"],"sourcesContent":["import { decodeManifestPath, type Bag, type BagFile } from './bag'\nimport { BAG_ALGORITHMS, digestHex, fromUtf8, type BagAlgorithm } from './bytes'\n\nexport type BagValidation = {\n  valid: boolean\n  /** One line per problem, naming the file. Empty when `valid`. */\n  errors: string[]\n}\n\nconst MANIFEST = /^(tag)?manifest-([a-z0-9]+)\\.txt$/\n\n/** `label: value` pairs of a tag file, with indented continuation lines folded back in. */\nconst parseTagLines = (text: string): [string, string][] => {\n  const entries: [string, string][] = []\n  for (const line of text.replace(/\\r\\n?/g, '\\n').split('\\n')) {\n    if (line === '') continue\n    const last = entries[entries.length - 1]\n    if (/^\\s/.test(line) && last) {\n      last[1] += `\\n${line.trim()}`\n      continue\n    }\n    const colon = line.indexOf(':')\n    if (colon > 0) entries.push([line.slice(0, colon).trim(), line.slice(colon + 1).trim()])\n  }\n  return entries\n}\n\n/**\n * Checks a bag the way a BagIt validator does: bagit.txt declares BagIt 1.0 (or 0.97) in UTF-8,\n * there is at least one payload manifest, every payload file is listed in every payload manifest\n * and matches it, every listed file exists, every tag manifest entry matches, and Payload-Oxum\n * (when present) agrees with the payload. Only SHA-256 and SHA-512 manifests are checked; a\n * manifest for another algorithm is reported as an error rather than skipped.\n */\nexport function validateBag(bag: Bag): BagValidation {\n  const errors: string[] = []\n  const byPath = new Map<string, BagFile>(bag.files.map((file) => [file.path, file]))\n  const text = (path: string): string | undefined => {\n    const file = byPath.get(path)\n    if (!file) return undefined\n    const decoded = fromUtf8(file.bytes)\n    if (decoded === undefined) errors.push(`${path} is not valid UTF-8`)\n    return decoded\n  }\n\n  const declaration = text('bagit.txt')\n  if (declaration === undefined) {\n    errors.push('bagit.txt is missing')\n  } else {\n    const fields = new Map(parseTagLines(declaration))\n    const version = fields.get('BagIt-Version')\n    if (version !== '1.0' && version !== '0.97') errors.push(`bagit.txt declares BagIt-Version ${version ?? '(none)'}`)\n    if (fields.get('Tag-File-Character-Encoding')?.toUpperCase() !== 'UTF-8') {\n      errors.push('bagit.txt does not declare Tag-File-Character-Encoding: UTF-8')\n    }\n  }\n\n  const payloadPaths = bag.files.filter((f) => f.path.startsWith('data/')).map((f) => f.path)\n  const manifests = bag.files\n    .map((file) => ({ file, match: MANIFEST.exec(file.path) }))\n    .filter((m): m is { file: BagFile; match: RegExpExecArray } => m.match !== null)\n\n  if (!manifests.some(({ match }) => !match[1])) errors.push('no payload manifest (manifest-<algorithm>.txt)')\n\n  for (const { file, match } of manifests) {\n    const isTag = !!match[1]\n    const algorithm = match[2] as string\n    if (!(BAG_ALGORITHMS as readonly string[]).includes(algorithm)) {\n      errors.push(`${file.path}: algorithm ${algorithm} is not supported by this validator`)\n      continue\n    }\n    const body = text(file.path)\n    if (body === undefined) continue\n    const listed = new Set<string>()\n    for (const line of body.split('\\n')) {\n      if (line.trim() === '') continue\n      const parsed = /^([0-9a-fA-F]+)\\s+(.+)$/.exec(line.replace(/\\r$/, ''))\n      if (!parsed) {\n        errors.push(`${file.path}: malformed line ${JSON.stringify(line)}`)\n        continue\n      }\n      const path = decodeManifestPath(parsed[2] as string)\n      listed.add(path)\n      if (!isTag && !path.startsWith('data/')) errors.push(`${file.path}: ${path} is outside data/`)\n      const target = byPath.get(path)\n      if (!target) {\n        errors.push(`${file.path}: ${path} is listed but missing`)\n      } else if (digestHex(algorithm as BagAlgorithm, target.bytes) !== (parsed[1] as string).toLowerCase()) {\n        errors.push(`${file.path}: ${path} does not match its ${algorithm} checksum`)\n      }\n    }\n    if (!isTag) {\n      for (const path of payloadPaths) {\n        if (!listed.has(path)) errors.push(`${file.path}: payload file ${path} is not listed`)\n      }\n    }\n  }\n\n  const info = text('bag-info.txt')\n  const oxum = info !== undefined ? parseTagLines(info).find(([label]) => label === 'Payload-Oxum')?.[1] : undefined\n  if (oxum !== undefined) {\n    const octets = bag.files.filter((f) => f.path.startsWith('data/')).reduce((sum, f) => sum + f.bytes.byteLength, 0)\n    if (oxum !== `${octets}.${payloadPaths.length}`) {\n      errors.push(`bag-info.txt: Payload-Oxum ${oxum} does not match the payload (${octets}.${payloadPaths.length})`)\n    }\n  }\n\n  return { valid: errors.length === 0, errors }\n}\n","import { parseFragment, type DefaultTreeAdapterTypes } from 'parse5'\n\nexport type HtmlElement = DefaultTreeAdapterTypes.Element\nexport type HtmlNode = DefaultTreeAdapterTypes.ChildNode\n\n/** `html` parsed as a fragment with source offsets, so callers can slice or splice the original string. */\nexport const parseHtmlWithLocations = (html: string): DefaultTreeAdapterTypes.DocumentFragment =>\n  parseFragment(html, { sourceCodeLocationInfo: true })\n\nexport const isElement = (node: HtmlNode): node is HtmlElement =>\n  node.nodeName !== '#text' && node.nodeName !== '#comment' && node.nodeName !== '#documentType'\n\nexport const childElements = (node: { childNodes?: HtmlNode[] }): HtmlElement[] =>\n  (node.childNodes ?? []).filter(isElement)\n\n/** An element's children, including a `<template>`'s content. */\nconst childrenOf = (node: HtmlElement): HtmlNode[] =>\n  node.tagName === 'template'\n    ? ((node as DefaultTreeAdapterTypes.Template).content?.childNodes ?? [])\n    : (node.childNodes ?? [])\n\n/** Calls `visit` for each element under `nodes`, depth first; returning false skips that element's children. */\nexport function walkElements(nodes: HtmlNode[], visit: (element: HtmlElement) => boolean | void): void {\n  for (const node of nodes) {\n    if (!isElement(node)) continue\n    if (visit(node) === false) continue\n    walkElements(childrenOf(node), visit)\n  }\n}\n\nexport const attribute = (element: HtmlElement, name: string): string | undefined =>\n  element.attrs.find((a) => a.name === name && !a.prefix)?.value\n\nexport const classTokens = (element: HtmlElement): string[] =>\n  (attribute(element, 'class') ?? '').split(/\\s+/).filter(Boolean)\n\nconst NON_TEXT_ELEMENTS = new Set(['script', 'style', 'template'])\n\n/** Concatenated text of `node`, leaving out script, style and template content. */\nexport function textContent(node: HtmlNode): string {\n  if (node.nodeName === '#text') return (node as DefaultTreeAdapterTypes.TextNode).value\n  if (!isElement(node) || NON_TEXT_ELEMENTS.has(node.tagName)) return ''\n  return (node.childNodes ?? []).map(textContent).join('')\n}\n\n/** The exact source of an element's children: from the end of its start tag to the start of its end tag. */\nexport function innerSource(html: string, element: HtmlElement): string {\n  const location = element.sourceCodeLocation\n  if (!location?.startTag) return ''\n  const end = location.endTag?.startOffset ?? location.endOffset\n  return html.slice(location.startTag.endOffset, end)\n}\n\n/** The exact source of one node. */\nexport const nodeSource = (html: string, node: HtmlNode): string => {\n  const location = node.sourceCodeLocation\n  return location ? html.slice(location.startOffset, location.endOffset) : ''\n}\n\nconst escapeAttributeValue = (value: string): string => value.replace(/&/g, '&amp;').replace(/\"/g, '&quot;')\n\n/**\n * Rewrites attribute values by splicing each new value into the original string, so every byte\n * outside the rewritten attributes stays as written. Re-serializing the parsed tree would not\n * round-trip (parse5 drops the newline after `<pre>`, a fragment parse drops doctype, html, head\n * and body, and quoting, case and line endings are normalized), and sealed Html must not change.\n *\n * `rewrite` gets each attribute's entity-decoded value and returns the new value, or undefined to\n * leave it. A rewritten attribute is written as `name=\"value\"`.\n */\nexport function rewriteHtmlAttributes(\n  html: string,\n  rewrite: (element: HtmlElement, attrName: string, value: string) => string | undefined,\n): string {\n  const fragment = parseHtmlWithLocations(html)\n  const edits: { start: number; end: number; text: string }[] = []\n  walkElements(fragment.childNodes, (element) => {\n    for (const attr of element.attrs) {\n      if (attr.prefix) continue\n      const next = rewrite(element, attr.name, attr.value)\n      const location = element.sourceCodeLocation?.attrs?.[attr.name]\n      if (next === undefined || !location) continue\n      edits.push({ start: location.startOffset, end: location.endOffset, text: `${attr.name}=\"${escapeAttributeValue(next)}\"` })\n    }\n  })\n\n  let out = html\n  for (const edit of edits.sort((a, b) => b.start - a.start)) {\n    out = out.slice(0, edit.start) + edit.text + out.slice(edit.end)\n  }\n  return out\n}\n\n/** Attributes whose whole value is one URL. `srcset` lists several and is not rewritten. */\nexport const URL_ATTRIBUTES = new Set(['src', 'href', 'poster'])\n\n/**\n * Replaces whole `src`, `href` and `poster` values that `replace` maps to a new URL (e.g. a\n * gateway URL to a bag-relative path). Values are compared trimmed. Other bytes are kept.\n */\nexport const rewriteHtmlUrls = (html: string, replace: (url: string) => string | undefined): string =>\n  rewriteHtmlAttributes(html, (_element, attrName, value) =>\n    URL_ATTRIBUTES.has(attrName) ? replace(value.trim()) : undefined,\n  )\n\n/** Every whole `src`, `href` and `poster` value in `html`, trimmed, each once, in document order. */\nexport function findHtmlUrls(html: string): string[] {\n  const urls = new Set<string>()\n  walkElements(parseHtmlWithLocations(html).childNodes, (element) => {\n    for (const attr of element.attrs) {\n      if (!attr.prefix && URL_ATTRIBUTES.has(attr.name) && attr.value.trim()) urls.add(attr.value.trim())\n    }\n  })\n  return [...urls]\n}\n","import {\n  attribute,\n  childElements,\n  classTokens,\n  innerSource,\n  nodeSource,\n  parseHtmlWithLocations,\n  textContent,\n  walkElements,\n  type HtmlElement,\n} from './html'\n\n/**\n * Reads an archive document: Html that marks up an article as a microformats2 h-entry\n * (https://microformats.org/wiki/h-entry), the way PermaPress seals a Post. Documents without\n * an h-entry are read by fallbacks, so archives from other clients still yield a body.\n *\n * Only the properties archives use are read: p-name, p-summary, p-author, dt-published,\n * u-featured, u-url and e-content. This is not a full microformats2 parser: implied\n * properties and value-class patterns are not applied.\n */\n\n/** How the body was found, most to least reliable. `fragment` means the whole input is the body. */\nexport type ArchiveDocumentMethod = 'h-entry' | 'articleBody' | 'article' | 'fragment'\n\nexport type ArchiveDocument = {\n  method: ArchiveDocumentMethod\n  /** The body's exact source, sliced from the input (not re-serialized). */\n  content: string\n  name?: string\n  summary?: string\n  /** dt-published as written: a `datetime`/`value` attribute, else the element's text. */\n  published?: string\n  /** Each p-author: a nested h-card's p-name, else the element's text. */\n  authors: string[]\n  featured?: { url: string; alt?: string }\n  url?: string\n}\n\nconst isMicroformatRoot = (element: HtmlElement): boolean => classTokens(element).some((c) => c.startsWith('h-'))\n\nconst cleanText = (element: HtmlElement): string => textContent(element).replace(/\\s+/g, ' ').trim()\n\nconst firstWithClass = (roots: HtmlElement[], token: string): HtmlElement | undefined => {\n  let found: HtmlElement | undefined\n  walkElements(roots, (element) => {\n    if (found) return false\n    if (classTokens(element).includes(token)) {\n      found = element\n      return false\n    }\n  })\n  return found\n}\n\nconst DATETIME_ELEMENTS = new Set(['time', 'ins', 'del'])\n\nfunction readHEntry(html: string, root: HtmlElement): ArchiveDocument {\n  const doc: ArchiveDocument = { method: 'h-entry', content: '', authors: [] }\n  let contentFound = false\n\n  walkElements(childElements(root), (element) => {\n    const classes = classTokens(element)\n    const nested = isMicroformatRoot(element)\n\n    if (classes.includes('p-author')) {\n      const name = nested ? firstWithClass(childElements(element), 'p-name') : undefined\n      const author = name ? cleanText(name) : cleanText(element)\n      if (author) doc.authors.push(author)\n    }\n    // A nested microformat's own properties belong to it, not to this entry.\n    if (nested) return false\n\n    if (classes.includes('p-name') && doc.name === undefined) doc.name = cleanText(element)\n    if (classes.includes('p-summary') && doc.summary === undefined) doc.summary = cleanText(element)\n    if (classes.includes('dt-published') && doc.published === undefined) {\n      doc.published =\n        (DATETIME_ELEMENTS.has(element.tagName) ? attribute(element, 'datetime') : undefined) ??\n        attribute(element, 'value') ??\n        cleanText(element)\n    }\n    if (classes.includes('u-featured') && doc.featured === undefined) {\n      const url = attribute(element, 'src') ?? attribute(element, 'href') ?? cleanText(element)\n      if (url) doc.featured = { url: url.trim(), alt: attribute(element, 'alt') }\n    }\n    if (classes.includes('u-url') && doc.url === undefined) {\n      const url = attribute(element, 'href') ?? attribute(element, 'src') ?? cleanText(element)\n      if (url) doc.url = url.trim()\n    }\n    if (classes.includes('e-content') && !contentFound) {\n      contentFound = true\n      doc.content = innerSource(html, element)\n      // The body's own markup can't add properties to the entry.\n      return false\n    }\n  })\n  return doc\n}\n\n/**\n * The body and descriptive fields of `html`. The body is taken, in order, from:\n *\n * 1. `.h-entry .e-content` (with the entry's other properties)\n * 2. the first `[itemprop=articleBody]`\n * 3. the only top-level `<article>`, without its direct `<header>` and `<footer>` children\n * 4. the whole input\n *\n * An h-entry without e-content falls through to the later steps for its body, keeping its\n * other properties.\n */\nexport function parseArchiveDocument(html: string): ArchiveDocument {\n  const fragment = parseHtmlWithLocations(html)\n  const top = fragment.childNodes\n\n  let entry: ArchiveDocument | undefined\n  let entryRoot: HtmlElement | undefined\n  walkElements(top, (element) => {\n    if (entryRoot) return false\n    if (classTokens(element).includes('h-entry')) {\n      entryRoot = element\n      return false\n    }\n  })\n  if (entryRoot) {\n    entry = readHEntry(html, entryRoot)\n    if (entry.content || firstWithClass(childElements(entryRoot), 'e-content')) return entry\n  }\n  const base: Omit<ArchiveDocument, 'method' | 'content'> = entry\n    ? { name: entry.name, summary: entry.summary, published: entry.published, authors: entry.authors, featured: entry.featured, url: entry.url }\n    : { authors: [] }\n\n  let articleBody: HtmlElement | undefined\n  walkElements(top, (element) => {\n    if (articleBody) return false\n    if (attribute(element, 'itemprop')?.split(/\\s+/).includes('articleBody')) {\n      articleBody = element\n      return false\n    }\n  })\n  if (articleBody) return { ...base, method: 'articleBody', content: innerSource(html, articleBody) }\n\n  // Top-level here means outside any other article; html/head/body wrappers of a full document don't count.\n  const articles: HtmlElement[] = []\n  walkElements(top, (element) => {\n    if (element.tagName === 'article') {\n      articles.push(element)\n      return false\n    }\n  })\n  if (articles.length === 1) {\n    const article = articles[0] as HtmlElement\n    const content = (article.childNodes ?? [])\n      .filter((node) => !('tagName' in node) || (node.tagName !== 'header' && node.tagName !== 'footer'))\n      .map((node) => nodeSource(html, node))\n      .join('')\n    return { ...base, method: 'article', content }\n  }\n\n  return { ...base, method: 'fragment', content: html }\n}\n","// XML 1.0 forbids these code points even as character references.\nconst INVALID_XML_CHARACTER = /[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f￾￿]/g\n\n/** `text` escaped for XML element content and double-quoted attribute values. */\nexport const escapeXml = (text: string): string =>\n  text\n    .replace(INVALID_XML_CHARACTER, '�')\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n\nexport type XmlAttributes = Record<string, string | undefined>\n\nconst attributes = (attrs: XmlAttributes | undefined): string =>\n  Object.entries(attrs ?? {})\n    .filter((entry): entry is [string, string] => entry[1] !== undefined)\n    .map(([name, value]) => ` ${name}=\"${escapeXml(value)}\"`)\n    .join('')\n\n/** An element with text content, or nothing when `text` is undefined. */\nexport const textElement = (indent: string, name: string, text: string | undefined, attrs?: XmlAttributes): string =>\n  text === undefined ? '' : `${indent}<${name}${attributes(attrs)}>${escapeXml(text)}</${name}>\\n`\n\n/** An element wrapping already-rendered children, or nothing when they are empty. */\nexport const parentElement = (indent: string, name: string, children: string, attrs?: XmlAttributes): string =>\n  children === '' ? '' : `${indent}<${name}${attributes(attrs)}>\\n${children}${indent}</${name}>\\n`\n\nexport const XML_DECLARATION = '<?xml version=\"1.0\" encoding=\"UTF-8\"?>\\n'\n","import { textElement, XML_DECLARATION } from './xml'\n\n/**\n * Simple Dublin Core (the 15 DCMI elements), written as an `oai_dc:dc` record, the format every\n * OAI-PMH repository must support. Each element may repeat; leave a field out rather than\n * guessing a value.\n */\nexport type DublinCore = Partial<\n  Record<\n    | 'title'\n    | 'creator'\n    | 'subject'\n    | 'description'\n    | 'publisher'\n    | 'contributor'\n    | 'date'\n    | 'type'\n    | 'format'\n    | 'identifier'\n    | 'source'\n    | 'language'\n    | 'relation'\n    | 'coverage'\n    | 'rights',\n    string | string[]\n  >\n>\n\nconst ELEMENT_ORDER: (keyof DublinCore)[] = [\n  'title',\n  'creator',\n  'subject',\n  'description',\n  'publisher',\n  'contributor',\n  'date',\n  'type',\n  'format',\n  'identifier',\n  'source',\n  'language',\n  'relation',\n  'coverage',\n  'rights',\n]\n\n/** `record` as an `oai_dc:dc` XML document. Empty strings are left out. */\nexport function dublinCoreXml(record: DublinCore): string {\n  let body = ''\n  for (const element of ELEMENT_ORDER) {\n    const value = record[element]\n    const values = value === undefined ? [] : Array.isArray(value) ? value : [value]\n    for (const v of values) if (v !== '') body += textElement('  ', `dc:${element}`, v)\n  }\n  return (\n    XML_DECLARATION +\n    '<oai_dc:dc xmlns:oai_dc=\"http://www.openarchives.org/OAI/2.0/oai_dc/\"' +\n    ' xmlns:dc=\"http://purl.org/dc/elements/1.1/\"' +\n    ' xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"' +\n    ' xsi:schemaLocation=\"http://www.openarchives.org/OAI/2.0/oai_dc/ http://www.openarchives.org/OAI/2.0/oai_dc.xsd\">\\n' +\n    body +\n    '</oai_dc:dc>\\n'\n  )\n}\n","import { parentElement, textElement, XML_DECLARATION } from './xml'\n\n/**\n * PREMIS 3.0 preservation metadata (https://www.loc.gov/standards/premis/v3/): the objects in a\n * bag, the events in their history and the agents behind those events. Event and agent types use\n * the Library of Congress preservation vocabularies, written with their id.loc.gov value URIs.\n */\n\nexport type PremisIdentifier = { type: string; value: string }\n\n/** The thing a bag preserves, such as a Seed: identifiers only. */\nexport type PremisIntellectualEntity = {\n  kind: 'intellectualEntity'\n  identifiers: PremisIdentifier[]\n}\n\n/** One payload file, with its fixity and format. */\nexport type PremisFile = {\n  kind: 'file'\n  identifiers: PremisIdentifier[]\n  /** Hex digests by algorithm name, e.g. `{ 'SHA-256': '…' }`. */\n  fixity: Record<string, string>\n  size: number\n  /** A MIME type, or another format name. */\n  formatName: string\n  /** The file's name where it came from, e.g. its Arweave transaction id. */\n  originalName?: string\n}\n\nexport type PremisObject = PremisIntellectualEntity | PremisFile\n\n/** Event types from https://id.loc.gov/vocabulary/preservation/eventType, by label. */\nexport const PREMIS_EVENT_TYPES = {\n  creation: 'cre',\n  modification: 'mod',\n  'metadata modification': 'mem',\n  'message digest calculation': 'mes',\n  'information package creation': 'ipc',\n  'fixity check': 'fix',\n  validation: 'val',\n  'digital signature generation': 'dsg',\n  capture: 'cap',\n  replication: 'rep',\n} as const\nexport type PremisEventType = keyof typeof PREMIS_EVENT_TYPES\n\nexport type PremisEvent = {\n  identifier: PremisIdentifier\n  type: PremisEventType\n  /** ISO 8601. */\n  dateTime: string\n  detail?: string\n  outcome?: 'success' | 'failure'\n  outcomeNote?: string\n  agents?: (PremisIdentifier & { role?: string })[]\n  objects?: (PremisIdentifier & { role?: string })[]\n}\n\n/** Agent types from https://id.loc.gov/vocabulary/preservation/agentType. */\nexport const PREMIS_AGENT_TYPES = { person: 'per', organization: 'org', software: 'sof', hardware: 'har' } as const\nexport type PremisAgentType = keyof typeof PREMIS_AGENT_TYPES\n\nexport type PremisAgent = {\n  identifiers: PremisIdentifier[]\n  name?: string\n  /** Left out when unknown, e.g. an EVM address that may be a person or an organization. */\n  type?: PremisAgentType\n  version?: string\n  note?: string\n}\n\nexport type Premis = { objects: PremisObject[]; events?: PremisEvent[]; agents?: PremisAgent[] }\n\nconst VOCABULARY = 'http://id.loc.gov/vocabulary/preservation'\n\nconst identifier = (indent: string, element: string, id: PremisIdentifier): string =>\n  parentElement(\n    indent,\n    element,\n    textElement(`${indent}  `, `premis:${element.replace('premis:', '')}Type`, id.type) +\n      textElement(`${indent}  `, `premis:${element.replace('premis:', '')}Value`, id.value),\n  )\n\nconst linking = (indent: string, element: 'linkingAgentIdentifier' | 'linkingObjectIdentifier', id: PremisIdentifier & { role?: string }) => {\n  const role = element === 'linkingAgentIdentifier' ? 'linkingAgentRole' : 'linkingObjectRole'\n  return parentElement(\n    indent,\n    `premis:${element}`,\n    textElement(`${indent}  `, `premis:${element}Type`, id.type) +\n      textElement(`${indent}  `, `premis:${element}Value`, id.value) +\n      textElement(`${indent}  `, `premis:${role}`, id.role),\n  )\n}\n\nfunction objectXml(object: PremisObject): string {\n  const i = '    '\n  const ids = object.identifiers.map((id) => identifier(i, 'premis:objectIdentifier', id)).join('')\n  if (object.kind === 'intellectualEntity') {\n    return parentElement('  ', 'premis:object', ids, { 'xsi:type': 'premis:intellectualEntity' })\n  }\n  const fixity = Object.entries(object.fixity)\n    .map(([algorithm, digest]) =>\n      parentElement(\n        `${i}  `,\n        'premis:fixity',\n        textElement(`${i}    `, 'premis:messageDigestAlgorithm', algorithm) +\n          textElement(`${i}    `, 'premis:messageDigest', digest),\n      ),\n    )\n    .join('')\n  const characteristics = parentElement(\n    i,\n    'premis:objectCharacteristics',\n    textElement(`${i}  `, 'premis:compositionLevel', '0') +\n      fixity +\n      textElement(`${i}  `, 'premis:size', String(object.size)) +\n      parentElement(\n        `${i}  `,\n        'premis:format',\n        parentElement(`${i}    `, 'premis:formatDesignation', textElement(`${i}      `, 'premis:formatName', object.formatName)),\n      ),\n  )\n  return parentElement(\n    '  ',\n    'premis:object',\n    ids + characteristics + textElement(i, 'premis:originalName', object.originalName),\n    { 'xsi:type': 'premis:file' },\n  )\n}\n\nfunction eventXml(event: PremisEvent): string {\n  const i = '    '\n  const code = PREMIS_EVENT_TYPES[event.type]\n  return parentElement(\n    '  ',\n    'premis:event',\n    identifier(i, 'premis:eventIdentifier', event.identifier) +\n      textElement(i, 'premis:eventType', event.type, {\n        authority: 'eventType',\n        authorityURI: `${VOCABULARY}/eventType`,\n        valueURI: `${VOCABULARY}/eventType/${code}`,\n      }) +\n      textElement(i, 'premis:eventDateTime', event.dateTime) +\n      parentElement(i, 'premis:eventDetailInformation', textElement(`${i}  `, 'premis:eventDetail', event.detail)) +\n      parentElement(\n        i,\n        'premis:eventOutcomeInformation',\n        textElement(`${i}  `, 'premis:eventOutcome', event.outcome) +\n          parentElement(\n            `${i}  `,\n            'premis:eventOutcomeDetail',\n            textElement(`${i}    `, 'premis:eventOutcomeDetailNote', event.outcomeNote),\n          ),\n      ) +\n      (event.agents ?? []).map((agent) => linking(i, 'linkingAgentIdentifier', agent)).join('') +\n      (event.objects ?? []).map((object) => linking(i, 'linkingObjectIdentifier', object)).join(''),\n  )\n}\n\nfunction agentXml(agent: PremisAgent): string {\n  const i = '    '\n  return parentElement(\n    '  ',\n    'premis:agent',\n    agent.identifiers.map((id) => identifier(i, 'premis:agentIdentifier', id)).join('') +\n      textElement(i, 'premis:agentName', agent.name) +\n      (agent.type\n        ? textElement(i, 'premis:agentType', agent.type, {\n            authority: 'agentType',\n            authorityURI: `${VOCABULARY}/agentType`,\n            valueURI: `${VOCABULARY}/agentType/${PREMIS_AGENT_TYPES[agent.type]}`,\n          })\n        : '') +\n      textElement(i, 'premis:agentVersion', agent.version) +\n      textElement(i, 'premis:agentNote', agent.note),\n  )\n}\n\n/** `premis` as a PREMIS 3.0 XML document. PREMIS requires at least one object. */\nexport function premisXml(premis: Premis): string {\n  if (premis.objects.length === 0) throw new Error('PREMIS needs at least one object')\n  return (\n    XML_DECLARATION +\n    '<premis:premis xmlns:premis=\"http://www.loc.gov/premis/v3\"' +\n    ' xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"' +\n    ' xsi:schemaLocation=\"http://www.loc.gov/premis/v3 https://www.loc.gov/standards/premis/premis.xsd\"' +\n    ' version=\"3.0\">\\n' +\n    premis.objects.map(objectXml).join('') +\n    (premis.events ?? []).map(eventXml).join('') +\n    (premis.agents ?? []).map(agentXml).join('') +\n    '</premis:premis>\\n'\n  )\n}\n"],"mappings":"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"}

package/dist/node/index.d.ts

@@ -0,0 +1,9 @@
+import { type Bag } from '../bag';
+/**
+ * Writes `bag` under `directory`, which must not exist or be empty, so a bag never mixes with
+ * leftover files that its manifests don't list.
+ */
+export declare function writeBagDirectory(bag: Bag, directory: string): Promise<void>;
+/** Every file under `directory` as a bag, with `/`-separated paths. */
+export declare function readBagDirectory(directory: string): Promise<Bag>;
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,GAAG,EAAE,MAAM,QAAQ,CAAA;AAEhD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYlF;AAED,uEAAuE;AACvE,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CActE"}

package/dist/node.js

@@ -0,0 +1,32 @@
+import { r as e } from "./bag-BkZhe-zN.js";
+import { mkdir as t, readFile as n, readdir as r, writeFile as i } from "node:fs/promises";
+import a from "node:path";
+//#region src/node/index.ts
+async function o(n, o) {
+	if ((await r(o).catch((e) => {
+		if (e.code === "ENOENT") return [];
+		throw e;
+	})).length > 0) throw Error(`${o} is not empty`);
+	for (let r of n.files) {
+		e(r.path);
+		let n = a.join(o, ...r.path.split("/"));
+		await t(a.dirname(n), { recursive: !0 }), await i(n, r.bytes);
+	}
+}
+async function s(e) {
+	let t = await r(e, {
+		recursive: !0,
+		withFileTypes: !0
+	});
+	return { files: await Promise.all(t.filter((e) => e.isFile()).map(async (t) => {
+		let r = a.join(t.parentPath, t.name);
+		return {
+			path: a.relative(e, r).split(a.sep).join("/"),
+			bytes: new Uint8Array(await n(r))
+		};
+	})) };
+}
+//#endregion
+export { s as readBagDirectory, o as writeBagDirectory };
+
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","names":["assertBagPath","path","writeBagDirectory","readdir","directory","error","file","bag","target","mkdir","writeFile","readBagDirectory","entries","entry","full","readFile"],"sources":["../src/node/index.ts"],"sourcesContent":["import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises'\nimport path from 'node:path'\nimport { assertBagPath, type Bag } from '../bag'\n\n/**\n * Writes `bag` under `directory`, which must not exist or be empty, so a bag never mixes with\n * leftover files that its manifests don't list.\n */\nexport async function writeBagDirectory(bag: Bag, directory: string): Promise<void> {\n  const existing = await readdir(directory).catch((error: NodeJS.ErrnoException) => {\n    if (error.code === 'ENOENT') return []\n    throw error\n  })\n  if (existing.length > 0) throw new Error(`${directory} is not empty`)\n  for (const file of bag.files) {\n    assertBagPath(file.path)\n    const target = path.join(directory, ...file.path.split('/'))\n    await mkdir(path.dirname(target), { recursive: true })\n    await writeFile(target, file.bytes)\n  }\n}\n\n/** Every file under `directory` as a bag, with `/`-separated paths. */\nexport async function readBagDirectory(directory: string): Promise<Bag> {\n  const entries = await readdir(directory, { recursive: true, withFileTypes: true })\n  const files = await Promise.all(\n    entries\n      .filter((entry) => entry.isFile())\n      .map(async (entry) => {\n        const full = path.join(entry.parentPath, entry.name)\n        return {\n          path: path.relative(directory, full).split(path.sep).join('/'),\n          bytes: new Uint8Array(await readFile(full)),\n        }\n      }),\n  )\n  return { files }\n}\n"],"mappings":";;;;AAQA,eAAsBE,EAAkB,GAAU,GAAkC;CAKlF,KAAI,MAJmBC,EAAQC,CAAS,CAAC,CAAC,OAAO,MAAiC;EAChF,IAAIC,EAAM,SAAS,UAAU,OAAO,CAAC;EACrC,MAAMA;CACR,CAAC,EAAA,CACY,SAAS,GAAG,MAAU,MAAM,GAAGD,EAAU,cAAc;CACpE,KAAK,IAAME,KAAQC,EAAI,OAAO;EAC5B,EAAcD,EAAK,IAAI;EACvB,IAAME,IAASP,EAAK,KAAKG,GAAW,GAAGE,EAAK,KAAK,MAAM,GAAG,CAAC;EAE3D,AADA,MAAMG,EAAMR,EAAK,QAAQO,CAAM,GAAG,EAAE,WAAW,GAAK,CAAC,GACrD,MAAME,EAAUF,GAAQF,EAAK,KAAK;CACpC;AACF;AAGA,eAAsBK,EAAiB,GAAiC;CACtE,IAAMC,IAAU,MAAMT,EAAQC,GAAW;EAAE,WAAW;EAAM,eAAe;CAAK,CAAC;CAYjF,OAAO,EAAE,OAAA,MAXW,QAAQ,IAC1BQ,EACG,QAAQ,MAAUC,EAAM,OAAO,CAAC,CAAC,CACjC,IAAI,OAAO,MAAU;EACpB,IAAMC,IAAOb,EAAK,KAAKY,EAAM,YAAYA,EAAM,IAAI;EACnD,OAAO;GACL,MAAMZ,EAAK,SAASG,GAAWU,CAAI,CAAC,CAAC,MAAMb,EAAK,GAAG,CAAC,CAAC,KAAK,GAAG;GAC7D,OAAO,IAAI,WAAW,MAAMc,EAASD,CAAI,CAAC;EAC5C;CACF,CAAC,CACL,EACe;AACjB"}

package/dist/premis.d.ts

@@ -0,0 +1,80 @@
+/**
+ * PREMIS 3.0 preservation metadata (https://www.loc.gov/standards/premis/v3/): the objects in a
+ * bag, the events in their history and the agents behind those events. Event and agent types use
+ * the Library of Congress preservation vocabularies, written with their id.loc.gov value URIs.
+ */
+export type PremisIdentifier = {
+    type: string;
+    value: string;
+};
+/** The thing a bag preserves, such as a Seed: identifiers only. */
+export type PremisIntellectualEntity = {
+    kind: 'intellectualEntity';
+    identifiers: PremisIdentifier[];
+};
+/** One payload file, with its fixity and format. */
+export type PremisFile = {
+    kind: 'file';
+    identifiers: PremisIdentifier[];
+    /** Hex digests by algorithm name, e.g. `{ 'SHA-256': '…' }`. */
+    fixity: Record<string, string>;
+    size: number;
+    /** A MIME type, or another format name. */
+    formatName: string;
+    /** The file's name where it came from, e.g. its Arweave transaction id. */
+    originalName?: string;
+};
+export type PremisObject = PremisIntellectualEntity | PremisFile;
+/** Event types from https://id.loc.gov/vocabulary/preservation/eventType, by label. */
+export declare const PREMIS_EVENT_TYPES: {
+    readonly creation: "cre";
+    readonly modification: "mod";
+    readonly 'metadata modification': "mem";
+    readonly 'message digest calculation': "mes";
+    readonly 'information package creation': "ipc";
+    readonly 'fixity check': "fix";
+    readonly validation: "val";
+    readonly 'digital signature generation': "dsg";
+    readonly capture: "cap";
+    readonly replication: "rep";
+};
+export type PremisEventType = keyof typeof PREMIS_EVENT_TYPES;
+export type PremisEvent = {
+    identifier: PremisIdentifier;
+    type: PremisEventType;
+    /** ISO 8601. */
+    dateTime: string;
+    detail?: string;
+    outcome?: 'success' | 'failure';
+    outcomeNote?: string;
+    agents?: (PremisIdentifier & {
+        role?: string;
+    })[];
+    objects?: (PremisIdentifier & {
+        role?: string;
+    })[];
+};
+/** Agent types from https://id.loc.gov/vocabulary/preservation/agentType. */
+export declare const PREMIS_AGENT_TYPES: {
+    readonly person: "per";
+    readonly organization: "org";
+    readonly software: "sof";
+    readonly hardware: "har";
+};
+export type PremisAgentType = keyof typeof PREMIS_AGENT_TYPES;
+export type PremisAgent = {
+    identifiers: PremisIdentifier[];
+    name?: string;
+    /** Left out when unknown, e.g. an EVM address that may be a person or an organization. */
+    type?: PremisAgentType;
+    version?: string;
+    note?: string;
+};
+export type Premis = {
+    objects: PremisObject[];
+    events?: PremisEvent[];
+    agents?: PremisAgent[];
+};
+/** `premis` as a PREMIS 3.0 XML document. PREMIS requires at least one object. */
+export declare function premisXml(premis: Premis): string;
+//# sourceMappingURL=premis.d.ts.map

package/dist/premis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"premis.d.ts","sourceRoot":"","sources":["../src/premis.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9D,mEAAmE;AACnE,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,oBAAoB,CAAA;IAC1B,WAAW,EAAE,gBAAgB,EAAE,CAAA;CAChC,CAAA;AAED,oDAAoD;AACpD,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,wBAAwB,GAAG,UAAU,CAAA;AAEhE,uFAAuF;AACvF,eAAO,MAAM,kBAAkB;;;;;;;;;;;CAWrB,CAAA;AACV,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,kBAAkB,CAAA;AAE7D,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,gBAAgB,CAAA;IAC5B,IAAI,EAAE,eAAe,CAAA;IACrB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,CAAC,gBAAgB,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;IACjD,OAAO,CAAC,EAAE,CAAC,gBAAgB,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;CACnD,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB;;;;;CAAoF,CAAA;AACnH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,kBAAkB,CAAA;AAE7D,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0FAA0F;IAC1F,IAAI,CAAC,EAAE,eAAe,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,MAAM,GAAG;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,CAAA;AA2GhG,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAahD"}

package/dist/validateBag.d.ts

@@ -0,0 +1,15 @@
+import { type Bag } from './bag';
+export type BagValidation = {
+    valid: boolean;
+    /** One line per problem, naming the file. Empty when `valid`. */
+    errors: string[];
+};
+/**
+ * Checks a bag the way a BagIt validator does: bagit.txt declares BagIt 1.0 (or 0.97) in UTF-8,
+ * there is at least one payload manifest, every payload file is listed in every payload manifest
+ * and matches it, every listed file exists, every tag manifest entry matches, and Payload-Oxum
+ * (when present) agrees with the payload. Only SHA-256 and SHA-512 manifests are checked; a
+ * manifest for another algorithm is reported as an error rather than skipped.
+ */
+export declare function validateBag(bag: Bag): BagValidation;
+//# sourceMappingURL=validateBag.d.ts.map

package/dist/validateBag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateBag.d.ts","sourceRoot":"","sources":["../src/validateBag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,GAAG,EAAgB,MAAM,OAAO,CAAA;AAGlE,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,iEAAiE;IACjE,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAoBD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CA0EnD"}

package/dist/xml.d.ts

@@ -0,0 +1,9 @@
+/** `text` escaped for XML element content and double-quoted attribute values. */
+export declare const escapeXml: (text: string) => string;
+export type XmlAttributes = Record<string, string | undefined>;
+/** An element with text content, or nothing when `text` is undefined. */
+export declare const textElement: (indent: string, name: string, text: string | undefined, attrs?: XmlAttributes) => string;
+/** An element wrapping already-rendered children, or nothing when they are empty. */
+export declare const parentElement: (indent: string, name: string, children: string, attrs?: XmlAttributes) => string;
+export declare const XML_DECLARATION = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n";
+//# sourceMappingURL=xml.d.ts.map

package/dist/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../src/xml.ts"],"names":[],"mappings":"AAGA,iFAAiF;AACjF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAMb,CAAA;AAE5B,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;AAQ9D,yEAAyE;AACzE,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,EAAE,MAAM,MAAM,GAAG,SAAS,EAAE,QAAQ,aAAa,KAAG,MACV,CAAA;AAElG,qFAAqF;AACrF,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,EAAE,UAAU,MAAM,EAAE,QAAQ,aAAa,KAAG,MACH,CAAA;AAEnG,eAAO,MAAM,eAAe,iDAA6C,CAAA"}

package/package.json

@@ -1,6 +1,75 @@
 {
   "name": "@seedprotocol/archive",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.7.11-next.1384.g8b47246",
+  "description": "Standards-based archive packaging for Seed Protocol items: BagIt (RFC 8493) bags with SHA-256/SHA-512 manifests, Dublin Core and PREMIS metadata, and an h-entry archive document reader",
+  "keywords": [
+    "seed-protocol",
+    "archive",
+    "bagit",
+    "rfc8493",
+    "premis",
+    "dublin-core",
+    "h-entry",
+    "digital-preservation"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./node": {
+      "import": {
+        "types": "./dist/node/index.d.ts",
+        "default": "./dist/node.js"
+      },
+      "require": {
+        "types": "./dist/node/index.d.ts",
+        "default": "./dist/node.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "rimraf dist && tsc -p tsconfig.build.json && vite build",
+    "test": "vitest run --reporter=default",
+    "prepublishOnly": "bun run build && node ../../scripts/sync-versions.js"
+  },
+  "dependencies": {
+    "@noble/hashes": "^1.8.0",
+    "parse5": "8.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "rimraf": "^6.0.1",
+    "typescript": "~5.9.3",
+    "vite": "^8.0.0",
+    "vitest": "^4.1.11"
+  },
+  "author": "Keith Axline <keith@journodao.xyz>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JournoLabs/seed-protocol-sdk.git",
+    "directory": "packages/archive"
+  },
+  "homepage": "https://github.com/JournoLabs/seed-protocol-sdk/tree/main/packages/archive#readme",
+  "bugs": {
+    "url": "https://github.com/JournoLabs/seed-protocol-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}