@normativepdf/recover 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 shuji-bonji
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,100 @@
+# @normativepdf/recover
+
+相互参照表が ISO 32000-2 §7.5 のとおりでない PDF を、読める範囲まで読む。
+
+`startxref` から `/Prev` を順に辿る。辿れなければ 1 つ前の `startxref` を試す。
+それでも節が 1 つも読めなければ、ファイルの中の `N G obj` を数え上げて表を組み直す。
+そして **どこまで読んだかを返り値に入れて返す。**
+
+> 🔴 **このパッケージは適合を判定しない。** `DocumentScope` と `ReadingScope` が
+> 答えるのは「どこまで読んだか」だけで、「条文に適合しているか」ではない。
+> 適合の判定は利用する側が行う。
+
+## なぜコアと別のパッケージなのか
+
+[normativepdf](https://github.com/shuji-bonji/normativepdf) は §7.5 を条文どおりに
+読み、条文に反する文書は受け取らずに例外を投げる。それは正しい。
+ただし監査に持ち込まれる文書は壊れていることが多く、受け取らないだけで終わると、
+その文書に何が書いてあるかを誰も見ないまま終わる。
+
+このパッケージはコアの外側にある。コアが「条文に反するので受け取らない」と言い、
+こちらが「受け取らなかった文書をどう読むか」を持つ。読み直す手順には推測が入る
+（1 つ前の `startxref` を試す・巡回を検出する・表を組み直す）ので、
+条文どおりに読むことを 2,907 件の検体で検査しているコアには入れない。
+決めた経緯は [ADR-0010](https://github.com/shuji-bonji/normativepdf/blob/main/docs/adr/0010-recover-package.md)。
+
+## インストール
+
+```sh
+npm install @normativepdf/recover
+```
+
+依存しているのは `normativepdf` 1 つだけである。
+
+## 使い方
+
+```ts
+import { openDocument, toReadingScope } from '@normativepdf/recover';
+
+const { doc, scope } = await openDocument(bytes);
+
+if (scope.reconstructed) {
+  // このとき相互参照表は、ファイルが持っているものではなく、
+  // このパッケージが組み直したものである。報告の読み手に伏せてよい事実ではない。
+}
+
+// 出力に載せる形（COS 辞書を落としたもの）
+const declared = toReadingScope(scope);
+```
+
+`openDocument` は 2 段になっている。
+
+1. まず `parsePdf` に渡す。読めたらその結果をそのまま使う（**手を加えない**）
+2. 断られたら、下の手順で読み直して文書を組み立てる
+
+pdf-verify-mcp の検体 2,947 件では、2,930 件が 1 で読める。2 に入るのは残り 17 件
+だけで、その 17 件だけが「ライブラリが読んだ結果」ではなくなる。
+どちらだったかは `scope.recovered` が持っている。
+
+## 読み直す手順は 4 つ
+
+1. 最後の `startxref` が読めなければ、1 つ前の `startxref` を順に試す
+   （試したことは `newestSectionUnreadable` に入れる）
+2. `/Prev` が正の整数でなければ、そこで辿るのをやめる。
+   このとき「最後まで辿れた」とは言わない
+3. 巡回している場合と、200 リビジョンを超えた場合は止める
+4. 線形化（Annex F）の 2 つの節は、1 リビジョンとして数える
+
+辿るのをやめた理由は `scope.chainStop.kind` に入る。値は normativepdf と同じ 5 つ
+（`complete` / `prev-zero` / `unreadable` / `cyclic` / `malformed`）。
+**「最後まで辿れた」と「これ以上辿れなかった」は別の値になる。**
+
+## デバッグ出力
+
+既定では何も出力しない。要るなら出力する関数を渡す。
+
+```ts
+await openDocument(bytes, {
+  onDebug: (context, message) => process.stderr.write(`[${context}] ${message}\n`),
+});
+```
+
+> 🔴 **stdout に書く関数を渡さないこと。** このパッケージを最初に使うのは
+> MCP サーバで、そこでは stdout に書いたバイトが JSON-RPC のメッセージとして
+> 読まれ、パースに失敗する。
+
+## 入っているもの
+
+| ファイル | 中身 |
+|---|---|
+| `cos.ts` | COS を読むための関数（`asDict` / `asRef` / `tryResolve` / `enumerateObjects` / `decodedBytes` など）。**ここに判定は書かない** |
+| `xref-walk.ts` | `walkXrefChain` と `reconstructXref`、および上の 4 つの手順。`findOrigin` / `readToken` などのバイト操作も |
+| `document.ts` | `openDocument` / `DocumentScope` / `toReadingScope` |
+
+pdf-verify-mcp 0.21.1 の `src/services/` から、1,189 行をそのまま移したものである。
+移したときに出力が変わっていないことは、検体 2,950 件 × ツール 7 本 =
+20,650 回の呼び出しで差が 0 件であることを確かめてある。
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,105 @@
+# @normativepdf/recover
+
+Reads a PDF as far as it can when the cross-reference table does not follow
+ISO 32000-2 §7.5.
+
+It walks `startxref` → `/Prev`. When a link cannot be followed it falls back to
+an earlier `startxref`. When no section can be read at all it scans the file for
+`N G obj` and rebuilds the table. **Whatever it does, it returns how far it got.**
+
+> 🔴 **This package does not judge conformance.** `DocumentScope` and
+> `ReadingScope` answer "how much was read", not "does this conform". Conformance
+> is the caller's decision.
+
+## Why this is not part of the core
+
+[normativepdf](https://github.com/shuji-bonji/normativepdf) reads §7.5 as
+written and throws on a document that violates it. That is the right behaviour
+for a library. But documents that arrive for auditing are usually the damaged
+ones, and refusing them means nobody ever sees what is inside.
+
+This package sits outside the core. The core says "this violates the clause, so
+I will not accept it"; this package decides what to do with the documents it
+refused. Re-reading involves guesswork — trying an earlier `startxref`,
+detecting cycles, rebuilding the table — so it does not belong in a core whose
+2,907-specimen gate asserts that it reads exactly what the clause says.
+The reasoning is in
+[ADR-0010](https://github.com/shuji-bonji/normativepdf/blob/main/docs/adr/0010-recover-package.md).
+
+## Install
+
+```sh
+npm install @normativepdf/recover
+```
+
+`normativepdf` is the only dependency.
+
+## Usage
+
+```ts
+import { openDocument, toReadingScope } from '@normativepdf/recover';
+
+const { doc, scope } = await openDocument(bytes);
+
+if (scope.reconstructed) {
+  // The cross-reference table here was rebuilt by this package. It is not the
+  // one the file carries, and a reader of the report needs to be told so.
+}
+
+// The shape meant for output (COS dictionaries dropped)
+const declared = toReadingScope(scope);
+```
+
+`openDocument` works in two steps.
+
+1. Hand the bytes to `parsePdf`. If that succeeds, use the result **unchanged**.
+2. If it refuses, re-read using the recovery steps below and assemble a document.
+
+Across pdf-verify-mcp's 2,947 specimens, 2,930 succeed at step 1. Only the
+remaining 17 reach step 2, and only those 17 stop being "what the library read".
+`scope.recovered` records which path a document took.
+
+## The four recovery steps
+
+1. If the last `startxref` is unreadable, try earlier ones in turn
+   (recorded in `newestSectionUnreadable`).
+2. If `/Prev` is not a positive integer, stop following it — and do not claim
+   the chain was walked to the end.
+3. Stop on a cycle, and at 200 revisions.
+4. Fold the two sections of a linearised file (Annex F) into one revision.
+
+Why the walk stopped is in `scope.chainStop.kind`, using the same five values as
+normativepdf (`complete` / `prev-zero` / `unreadable` / `cyclic` / `malformed`).
+**"Reached the end" and "could not go further" are different values.**
+
+## Debug output
+
+Nothing is written anywhere by default. Pass a function if you want output.
+
+```ts
+await openDocument(bytes, {
+  onDebug: (context, message) => process.stderr.write(`[${context}] ${message}\n`),
+});
+```
+
+> 🔴 **Do not pass a function that writes to stdout.** The first consumer of this
+> package is an MCP server, where bytes on stdout are read as JSON-RPC messages
+> and fail to parse.
+
+## What is in it
+
+| File | Contents |
+|---|---|
+| `cos.ts` | Functions for reading COS (`asDict`, `asRef`, `tryResolve`, `enumerateObjects`, `decodedBytes`, …). **No judgement is written here** |
+| `xref-walk.ts` | `walkXrefChain` and `reconstructXref`, plus the four steps above. Also byte-level helpers such as `findOrigin` and `readToken` |
+| `document.ts` | `openDocument` / `DocumentScope` / `toReadingScope` |
+
+These 1,189 lines were moved unchanged out of pdf-verify-mcp 0.21.1's
+`src/services/`. That the move changed no output was checked over 2,950
+specimens × 7 tools = 20,650 calls, with zero differences.
+
+日本語版は [README.ja.md](./README.ja.md)。
+
+## License
+
+MIT

package/dist/cos.d.ts

@@ -0,0 +1,97 @@
+/**
+ * COS の読み口。**ここに判定は書かない。**
+ *
+ * pdf-lib の `instanceof PDFDict` / `context.lookup` に当たるものを 1 か所に集める。
+ * 6 ファイルに散らすと同じ変換が 6 通りになり、そのうち 1 つだけ条文の読み方が違う、
+ * という形で壊れる（B1 = pdf-constraints の撤去で実測。`src/facts/cos.ts` と同じ位置づけ）。
+ *
+ * 🔴 **「読めなかった」と「そこに無い」を分ける。** 未定義の間接参照は null と等価で
+ * （R-7.3.10-13）、それは**観測できた事実**である。条文に反していて復号できないストリームは
+ * 観測できていない。2 つを同じ `null` に畳むと、「フォントが埋め込まれていない」と
+ * 「フォントを読めなかった」が同じ顔になる（B1 で一度そうして、唯一 fail していた検体を消した）。
+ */
+import { type CosArray, type CosDict, type CosObject, type CosRef, type CosStream, type PdfDocument } from 'normativepdf';
+export declare function asDict(value: CosObject | undefined | null): CosDict | null;
+export declare function asStream(value: CosObject | undefined | null): CosStream | null;
+export declare function asArray(value: CosObject | undefined | null): CosArray | null;
+export declare function asRef(value: CosObject | undefined | null): CosRef | null;
+/**
+ * ストリームの辞書。**ストリームは辞書ではない。**
+ * pdf-lib の `enumerateIndirectObjects` を `instanceof PDFDict` で絞ると
+ * `PDFRawStream` は落ちる —— その範囲を変えると、いままで見ていなかった辞書が
+ * 規則の対象に入って判定が動く。範囲を変えるなら別の変更として測ること。
+ */
+export declare function dictOfStream(value: CosObject | undefined | null): CosDict | null;
+/** 名前オブジェクトの値（`#xx` の解決と UTF-8 復号は lexer が済ませている・R-7.3.5-13）。 */
+export declare function nameOf(value: CosObject | undefined | null): string | null;
+/** 数値（整数と実数のどちらでも受ける）。 */
+export declare function numberOf(value: CosObject | undefined | null): number | null;
+/** 整数だけを受ける（R-7.3.3-6「実数が来てはならない」を区別できるようにしておく）。 */
+export declare function integerOf(value: CosObject | undefined | null): number | null;
+export declare function boolOf(value: CosObject | undefined | null): boolean | null;
+/** 文字列のバイト列そのまま（復号は §7.9.2 の話で、ここではしない）。 */
+export declare function bytesOf(value: CosObject | undefined | null): Uint8Array | null;
+/**
+ * テキスト文字列（§7.9.2）。PDFDocEncoding / UTF-16BE / UTF-8（PDF 2.0）を
+ * 見分けて復号し、言語エスケープ列を落とす。
+ * pdf-lib 1.x は `R-7.9.2.2.1-4`（UTF-8 のバイト順マーク）を実装しておらず、
+ * 適合している文書に「文法に合わない」と誤報していた。
+ */
+export declare function textOf(value: CosObject | undefined | null): string | null;
+/** 直接値を引く（`null` の値は「無い」と等価に畳む・R-7.3.7-7）。参照は解決しない。 */
+export declare function get(dict: CosDict | null, key: string): CosObject | undefined;
+/** 鍵があるか。**値が `null` でも「ある」と数える**（`get` とはここが違う）。 */
+export declare function has(dict: CosDict | null, key: string): boolean;
+/**
+ * 引いて解決する。**読めたかどうかを分けて返す。**
+ *
+ * - `{ value: X, unreadable: false }` —— 読めた（`null` は「未定義の間接参照」= 観測できた事実）
+ * - `{ value: null, unreadable: true }` —— **観測できなかった**。オブジェクトストリームが
+ *   条文に反して復号できない、などがここに来る。判定に食わせてはいけない
+ */
+export interface Lookup {
+    value: CosObject | null;
+    unreadable: boolean;
+}
+export declare function tryResolve(doc: PdfDocument, value: CosObject | undefined): Promise<Lookup>;
+/** 辞書の鍵を引いて解決する。 */
+export declare function tryGet(doc: PdfDocument, dict: CosDict | null, key: string): Promise<Lookup>;
+/** 読めなかったことを捨ててよい場所だけで使う短縮形（`unreadable` は `null` に畳まれる）。 */
+export declare function resolved(doc: PdfDocument, value: CosObject | undefined): Promise<CosObject | null>;
+export interface IndirectEntry {
+    objectNumber: number;
+    generation: number;
+    object: CosObject;
+}
+/**
+ * 相互参照表に載っている間接オブジェクトを、番号順に読む。
+ * 読めなかったものは**飛ばさずに数える**（`unreadable` として返る）。
+ */
+export declare function enumerateObjects(doc: PdfDocument): Promise<{
+    objects: IndirectEntry[];
+    unreadable: number;
+}>;
+/**
+ * 間接オブジェクトのうち**辞書だけ**（ストリームの辞書は含めない）。
+ * pdf-lib の `enumerateIndirectObjects()` + `instanceof PDFDict` と同じ範囲である。
+ * 🔴 ここにストリームを足すと、いままで見ていなかった辞書が規則の対象に入る。
+ */
+export declare function enumerateDicts(doc: PdfDocument): Promise<{
+    dicts: CosDict[];
+    unreadable: number;
+}>;
+/**
+ * ストリームを復号する。**読めなかったら `unreadable`** —— 空のバイト列にしない。
+ * 空を返すと「中身が無い」と「読めなかった」が同じ顔になる。
+ *
+ * 🔴 `/Length` `/Filter` `/DecodeParms` は間接参照でよい（相互参照ストリームだけは
+ * 直接であることを §7.5.8.2 が要求している）。`decodeStream` は同期の解決関数しか
+ * 受け取れないので、辞書の第 1 階層の参照を**先に解いてから**渡す。
+ * これを渡さないと、`/Length 12 0 R` の DSS 証明書ストリームなどが「読めない」に落ち、
+ * 失効情報がまるごと消える —— 実検体で `revocation: revoked` が `unknown` に化けた。
+ */
+export declare function decodedBytes(doc: PdfDocument, stream: CosStream | null): Promise<{
+    bytes: Uint8Array | null;
+    unreadable: boolean;
+}>;
+//# sourceMappingURL=cos.d.ts.map

package/dist/cos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cos.d.ts","sourceRoot":"","sources":["../src/cos.ts"],"names":[],"mappings":"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"}

package/dist/cos.js

@@ -0,0 +1,177 @@
+/**
+ * COS の読み口。**ここに判定は書かない。**
+ *
+ * pdf-lib の `instanceof PDFDict` / `context.lookup` に当たるものを 1 か所に集める。
+ * 6 ファイルに散らすと同じ変換が 6 通りになり、そのうち 1 つだけ条文の読み方が違う、
+ * という形で壊れる（B1 = pdf-constraints の撤去で実測。`src/facts/cos.ts` と同じ位置づけ）。
+ *
+ * 🔴 **「読めなかった」と「そこに無い」を分ける。** 未定義の間接参照は null と等価で
+ * （R-7.3.10-13）、それは**観測できた事実**である。条文に反していて復号できないストリームは
+ * 観測できていない。2 つを同じ `null` に畳むと、「フォントが埋め込まれていない」と
+ * 「フォントを読めなかった」が同じ顔になる（B1 で一度そうして、唯一 fail していた検体を消した）。
+ */
+import { COS_NULL, decodeStream, decodeTextString, dictGet, } from 'normativepdf';
+/* ------------------------------------------------------------------ *
+ * 形を見る（pdf-lib の instanceof に当たる）
+ * ------------------------------------------------------------------ */
+export function asDict(value) {
+    return value?.kind === 'dict' ? value : null;
+}
+export function asStream(value) {
+    return value?.kind === 'stream' ? value : null;
+}
+export function asArray(value) {
+    return value?.kind === 'array' ? value : null;
+}
+export function asRef(value) {
+    return value?.kind === 'ref' ? value : null;
+}
+/**
+ * ストリームの辞書。**ストリームは辞書ではない。**
+ * pdf-lib の `enumerateIndirectObjects` を `instanceof PDFDict` で絞ると
+ * `PDFRawStream` は落ちる —— その範囲を変えると、いままで見ていなかった辞書が
+ * 規則の対象に入って判定が動く。範囲を変えるなら別の変更として測ること。
+ */
+export function dictOfStream(value) {
+    return value?.kind === 'stream' ? value.dict : null;
+}
+/** 名前オブジェクトの値（`#xx` の解決と UTF-8 復号は lexer が済ませている・R-7.3.5-13）。 */
+export function nameOf(value) {
+    return value?.kind === 'name' ? value.value : null;
+}
+/** 数値（整数と実数のどちらでも受ける）。 */
+export function numberOf(value) {
+    return value?.kind === 'integer' || value?.kind === 'real' ? value.value : null;
+}
+/** 整数だけを受ける（R-7.3.3-6「実数が来てはならない」を区別できるようにしておく）。 */
+export function integerOf(value) {
+    return value?.kind === 'integer' ? value.value : null;
+}
+export function boolOf(value) {
+    return value?.kind === 'boolean' ? value.value : null;
+}
+/** 文字列のバイト列そのまま（復号は §7.9.2 の話で、ここではしない）。 */
+export function bytesOf(value) {
+    return value?.kind === 'string' ? value.bytes : null;
+}
+/**
+ * テキスト文字列（§7.9.2）。PDFDocEncoding / UTF-16BE / UTF-8（PDF 2.0）を
+ * 見分けて復号し、言語エスケープ列を落とす。
+ * pdf-lib 1.x は `R-7.9.2.2.1-4`（UTF-8 のバイト順マーク）を実装しておらず、
+ * 適合している文書に「文法に合わない」と誤報していた。
+ */
+export function textOf(value) {
+    const bytes = bytesOf(value);
+    return bytes === null ? null : decodeTextString(bytes);
+}
+/* ------------------------------------------------------------------ *
+ * 辞書を引く
+ * ------------------------------------------------------------------ */
+/** 直接値を引く（`null` の値は「無い」と等価に畳む・R-7.3.7-7）。参照は解決しない。 */
+export function get(dict, key) {
+    return dict ? dictGet(dict, key) : undefined;
+}
+/** 鍵があるか。**値が `null` でも「ある」と数える**（`get` とはここが違う）。 */
+export function has(dict, key) {
+    return dict ? dict.entries.has(key) : false;
+}
+export async function tryResolve(doc, value) {
+    if (value === undefined)
+        return { value: null, unreadable: false };
+    try {
+        const resolved = await doc.resolve(value);
+        return { value: resolved.kind === 'null' ? null : resolved, unreadable: false };
+    }
+    catch {
+        return { value: null, unreadable: true };
+    }
+}
+/** 辞書の鍵を引いて解決する。 */
+export async function tryGet(doc, dict, key) {
+    return tryResolve(doc, get(dict, key));
+}
+/** 読めなかったことを捨ててよい場所だけで使う短縮形（`unreadable` は `null` に畳まれる）。 */
+export async function resolved(doc, value) {
+    return (await tryResolve(doc, value)).value;
+}
+/**
+ * 相互参照表に載っている間接オブジェクトを、番号順に読む。
+ * 読めなかったものは**飛ばさずに数える**（`unreadable` として返る）。
+ */
+export async function enumerateObjects(doc) {
+    const objects = [];
+    let unreadable = 0;
+    const numbers = [...doc.xref.keys()].sort((a, b) => a - b);
+    for (const objectNumber of numbers) {
+        if (objectNumber === 0)
+            continue;
+        const entry = doc.xref.get(objectNumber);
+        if (!entry || entry.type === 'free' || entry.type === 'unknown')
+            continue;
+        const generation = entry.type === 'in-use' ? entry.generation : 0;
+        try {
+            const object = await doc.getObject(objectNumber, generation);
+            if (object.kind === 'null')
+                continue;
+            objects.push({ objectNumber, generation, object });
+        }
+        catch {
+            unreadable += 1;
+        }
+    }
+    return { objects, unreadable };
+}
+/**
+ * 間接オブジェクトのうち**辞書だけ**（ストリームの辞書は含めない）。
+ * pdf-lib の `enumerateIndirectObjects()` + `instanceof PDFDict` と同じ範囲である。
+ * 🔴 ここにストリームを足すと、いままで見ていなかった辞書が規則の対象に入る。
+ */
+export async function enumerateDicts(doc) {
+    const { objects, unreadable } = await enumerateObjects(doc);
+    const dicts = [];
+    for (const { object } of objects)
+        if (object.kind === 'dict')
+            dicts.push(object);
+    return { dicts, unreadable };
+}
+/* ------------------------------------------------------------------ *
+ * ストリームの中身
+ * ------------------------------------------------------------------ */
+/**
+ * ストリームを復号する。**読めなかったら `unreadable`** —— 空のバイト列にしない。
+ * 空を返すと「中身が無い」と「読めなかった」が同じ顔になる。
+ *
+ * 🔴 `/Length` `/Filter` `/DecodeParms` は間接参照でよい（相互参照ストリームだけは
+ * 直接であることを §7.5.8.2 が要求している）。`decodeStream` は同期の解決関数しか
+ * 受け取れないので、辞書の第 1 階層の参照を**先に解いてから**渡す。
+ * これを渡さないと、`/Length 12 0 R` の DSS 証明書ストリームなどが「読めない」に落ち、
+ * 失効情報がまるごと消える —— 実検体で `revocation: revoked` が `unknown` に化けた。
+ */
+export async function decodedBytes(doc, stream) {
+    if (!stream)
+        return { bytes: null, unreadable: false };
+    const cache = new Map();
+    for (const [, value] of stream.dict.entries) {
+        if (value.kind !== 'ref')
+            continue;
+        const key = `${value.objectNumber} ${value.generationNumber}`;
+        if (cache.has(key))
+            continue;
+        try {
+            cache.set(key, await doc.resolve(value));
+        }
+        catch {
+            cache.set(key, COS_NULL);
+        }
+    }
+    const resolve = (value) => value.kind === 'ref'
+        ? (cache.get(`${value.objectNumber} ${value.generationNumber}`) ?? COS_NULL)
+        : value;
+    try {
+        return { bytes: await decodeStream(stream, { resolve }), unreadable: false };
+    }
+    catch {
+        return { bytes: null, unreadable: true };
+    }
+}
+//# sourceMappingURL=cos.js.map

package/dist/cos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cos.js","sourceRoot":"","sources":["../src/cos.ts"],"names":[],"mappings":"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"}

package/dist/document.d.ts

@@ -0,0 +1,106 @@
+/**
+ * 文書を開く 1 つの入口と、**その読みの射程**。
+ *
+ * normativepdf は §7.5 を条文どおりに読み、条文に反する文書を受け取らない。
+ * それは正しいが、消費者は「受け取らない」で終われない —— 監査の対象として持ち込まれる
+ * 文書こそ壊れているからである。そこで:
+ *
+ *   1. まず `parsePdf` に渡す。読めたらそれをそのまま使う（**方針を挟まない**）
+ *   2. 断られたら `xref-walk.ts` の回復方針で歩き、読めた節から文書を組み立てる
+ *
+ * この順番が肝で、2,947 検体のうち 2,930 件は 1 で読める。回復方針が当たるのは
+ * 残り 17 件だけであり、そこだけが「ライブラリの答え」ではなく「このパッケージの方針」になる。
+ * どちらだったかは `scope.recovered` が申告する。
+ *
+ * 🔴 **射程は判定ではない。** `scope` は「どこまで読んだか」であって、
+ * 「この文書が条文に適合しているか」ではない。適合の判定は validator が下す。
+ */
+import { type CosDict, PdfDocument, type XrefChainStop } from 'normativepdf';
+import type { DebugSink, ReadingScope } from './types.js';
+/** どこまで読めたか。**判定ではない。** */
+export interface DocumentScope {
+    /**
+     * true = normativepdf が受け取らず、このパッケージの回復方針で組み立てた文書である。
+     * このとき「条文に反する箇所がある」ことは既に分かっている（`refusal` が条文を名指しする）。
+     */
+    recovered: boolean;
+    /** 回復に入った理由。ライブラリが投げた、条文を名指しするエラーの文面 */
+    refusal: string | null;
+    /** チェーンの歩きがどこで止まったか（§7.5.6） */
+    chainStop: XrefChainStop;
+    /** 最後の `startxref` が読めず、古い入口から入った = 末尾のバイトは代表されていない */
+    newestSectionUnreadable: boolean;
+    /**
+     * 読めた相互参照節の数（§7.5.4/§7.5.6）。
+     *
+     * 🔴 **経路によらず同じ意味を持たせること。** 0.19.0 では、ライブラリが
+     * そのまま読んだ経路でこの値を数えておらず、**健全な文書がすべて `0`** を
+     * 返していた（2,947 検体のうち 2,931 件）。読み手はそれを「節が 0 個」と読む。
+     * 観測していないことと、観測して 0 だったことが同じ顔をしていた ——
+     * `observation` で直したのと同じ間違いを、この項目自身が持っていた。
+     *
+     * 数えられなかったときは `null`。`0` は「節が 1 つも読めなかった」という
+     * 観測結果のときだけ使う（表を組み直した経路）。
+     */
+    sections: number | null;
+    /**
+     * チェーンが止まったあと、`startxref` の値を頼りに読み続けて文書を組み立てた。
+     * **`/Prev` が繋いだものではない**ので、リビジョンの一覧とは別の読み方である。
+     * 目録に届かない文書でだけ起きる（§7.5.6 の `/Prev 0` など）。
+     */
+    continuedPastStop: boolean;
+    /**
+     * チェーンが辿れない文書で、**表に載っていないオブジェクトを数え上げて埋めた**。
+     * 表そのものは信じたうえで、穴だけを埋める（表にある定義は上書きしない）。
+     * ここで埋めた分は「ファイルの中にこう書いてある」であって、
+     * 「相互参照表がそう言っている」ではない。
+     */
+    filledFromScan: number;
+    /**
+     * 🔴 **相互参照表を組み直した。** ファイルの中の `N G obj` を数え上げて作った表であり、
+     * ファイルが持っているものではない。リビジョンの境目は言えない
+     * （pdf-verify-mcp の `verify_integrity` は `revisionChain` に `unwalkable` を返す）。
+     */
+    reconstructed: boolean;
+    /** 相互参照表に載っているオブジェクトの数 */
+    objects: number;
+    /** trailer に `/Encrypt` がある（§7.6） */
+    encrypted: boolean;
+    /**
+     * 暗号化文書の鍵が導けた。false のとき **オブジェクトは 1 つも読めない** ——
+     * normativepdf は暗号文を平文の顔で返さない（ADR-0008）。
+     * 「読めなかった」ことを申告したうえで、読めた範囲だけで答えるのは呼び出し側の仕事。
+     */
+    authenticated: boolean;
+    /**
+     * `/Encrypt` 辞書。**鍵が導けなくても読める** —— §7.6.2 が暗号化の対象から
+     * 除いているので、生バイトから直接読んでよい。ISO 14289-1 7.16（支援技術への
+     * 許可ビット）はこれだけで判定できる。
+     */
+    encryptDict: CosDict | null;
+}
+export interface OpenedDocument {
+    doc: PdfDocument;
+    scope: DocumentScope;
+}
+export interface OpenOptions {
+    /** 暗号化文書のパスワード（既定は空 —— §7.6.4.4 の NOTE が言う「まず空を試す」） */
+    password?: string;
+    /**
+     * 回復に入った理由などの申告先。既定は「どこにも出さない」。
+     * 🔴 stdout に書く実装を渡さないこと（`DebugSink`）。
+     */
+    onDebug?: DebugSink;
+}
+/**
+ * 文書を開く。ライブラリが読めればそれを、断ったら回復方針で組み立てたものを返す。
+ * どちらも無理なら、**ライブラリが名指しした条文をそのまま**投げる。
+ */
+export declare function openDocument(bytes: Uint8Array, options?: OpenOptions): Promise<OpenedDocument>;
+/**
+ * 内部の申告を、出力に載せる形にする。落とすのは `encryptDict` だけ
+ * —— COS 辞書なので JSON にすると内部表現が出る。`/V` `/R` `/Filter` の値が
+ * 要るなら、呼び出し側がそこから取り出す。
+ */
+export declare function toReadingScope(scope: DocumentScope): ReadingScope;
+//# sourceMappingURL=document.d.ts.map

package/dist/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAGL,KAAK,OAAO,EAIZ,WAAW,EAIX,KAAK,aAAa,EAEnB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAW1D,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+BAA+B;IAC/B,SAAS,EAAE,aAAa,CAAC;IACzB,uDAAuD;IACvD,uBAAuB,EAAE,OAAO,CAAC;IACjC;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,WAAW,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AA6LD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,cAAc,CAAC,CAyJzB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAgBjE"}