arc-1 1.6.0 → 1.7.0

package/dist/adt/stored-text/decoder.js

@@ -0,0 +1,319 @@
+/**
+ * STXL container marker research and portions of the traversal design are adapted from:
+ * https://github.com/aamelin1/sap-long-texts
+ * Revision: 19c8c272b23f0ab481f7d63b6b36c45db15fd095
+ *
+ * MIT License
+ *
+ * Copyright (c) 2026 Andrey
+ *
+ * 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.
+ */
+/**
+ * Bounded STXL/TLINE decoder; no SAP installation, RFC, Python, or third-party runtime.
+ * Container marker research: aamelin1/sap-long-texts, commit 19c8c272 (MIT; attribution above).
+ * Verified profile: FF06, Unicode little-endian (4103), flat TLINE, CS_LZH or plain.
+ * This accepts the qualified stored profile; it is not a universal IMPORT/READ_TEXT implementation.
+ */
+import { promisify } from 'node:util';
+import { inflateRaw } from 'node:zlib';
+import { TextReadError } from './errors.js';
+const inflate = promisify(inflateRaw);
+const CONTAINER_HEADER_BYTES = 16;
+const COMPRESSION_HEADER_BYTES = 8;
+const TLINE_FORMAT_UNITS = 2;
+const TLINE_TEXT_UNITS = 132;
+const UTF16_BYTES_PER_UNIT = 2;
+const TLINE_ROW_BYTES = (TLINE_FORMAT_UNITS + TLINE_TEXT_UNITS) * UTF16_BYTES_PER_UNIT;
+// Empirical ceiling for the verified SAP-produced compressed profile; not a trailer grammar.
+const MAX_COMPRESSED_TRAILING_BYTES = 6;
+const MARKER = {
+    segment: 3,
+    containerEnd: 4,
+    characterField: 0xaa,
+    structureStart: 0xad,
+    structureEnd: 0xae,
+    fixedRow: 0xbb,
+    sizedRow: 0xbc,
+    rowEnd: 0xbd,
+    table: 0xbe,
+    tableEnd: 0xbf,
+};
+export const DEFAULT_LIMITS = Object.freeze({
+    maxInputBytes: 2 * 1024 * 1024,
+    maxOutputBytes: 4 * 1024 * 1024,
+    maxLines: 10_000,
+});
+function fail(message, code = 'CORRUPT_CLUSTER') {
+    throw new TextReadError(code, message);
+}
+function checkLimits(limits) {
+    for (const name of Object.keys(DEFAULT_LIMITS)) {
+        const value = limits?.[name];
+        if (!Number.isSafeInteger(value) || value < 1 || value > DEFAULT_LIMITS[name]) {
+            fail(`invalid ${name}; limits may only narrow the hard ceiling`, 'LIMIT_EXCEEDED');
+        }
+    }
+}
+function range(data, offset, size) {
+    if (!Number.isSafeInteger(offset) ||
+        !Number.isSafeInteger(size) ||
+        offset < 0 ||
+        size < 0 ||
+        offset + size > data.length) {
+        fail(`truncated container at byte ${offset}`);
+    }
+    return data.subarray(offset, offset + size);
+}
+function uint(data, offset, size) {
+    return range(data, offset, size).readUIntBE(0, size);
+}
+function textBytes(bytes, codePage) {
+    if (codePage !== '4103')
+        fail(`unverified code page ${codePage}`, 'UNSUPPORTED_PROFILE');
+    // ABAP CHAR truncation can leave a lone surrogate. Preserve its code unit, as IMPORT does.
+    // JSON.stringify escapes such units; callers must not silently replace them during encoding.
+    return bytes.toString('utf16le');
+}
+/** Remove SAP's bit prefix while preserving the bounded input size for native zlib. */
+function reframeLzh(source) {
+    const shift = 2 + (source[0] & 3);
+    const reframed = Buffer.alloc(source.length);
+    for (let i = 0; i < source.length; i++) {
+        reframed[i] = (source[i] >>> shift) | ((source[i + 1] ?? 0) << (8 - shift));
+    }
+    return reframed;
+}
+/** Validate the tested container profile and return its bounded decompressed payload. */
+export async function unpackCluster(data, limits = DEFAULT_LIMITS) {
+    checkLimits(limits);
+    if (data.length > limits.maxInputBytes)
+        fail('compressed input limit exceeded', 'LIMIT_EXCEEDED');
+    range(data, 0, CONTAINER_HEADER_BYTES);
+    if (data[0] !== 0xff || data[1] !== 6 || data[2] !== 2)
+        fail('unverified container signature/version/byte order', 'UNSUPPORTED_PROFILE');
+    const version = data[1];
+    const codePage = data.subarray(8, 12).toString('latin1');
+    textBytes(Buffer.alloc(0), codePage); // Reject unknown code pages even for an empty table.
+    const compression = data[4];
+    let payload;
+    let compressedTrailingBytes = 0;
+    if (compression === 1) {
+        payload = data.subarray(CONTAINER_HEADER_BYTES);
+        if (payload.length > limits.maxOutputBytes)
+            fail('uncompressed output limit exceeded', 'LIMIT_EXCEEDED');
+    }
+    else if (compression === 2) {
+        range(data, CONTAINER_HEADER_BYTES, COMPRESSION_HEADER_BYTES + 1);
+        if (data[20] !== 0x12 || data[21] !== 0x1f || data[22] !== 0x9d)
+            fail('unsupported compression header', 'UNSUPPORTED_PROFILE');
+        const expected = data.readUInt32LE(CONTAINER_HEADER_BYTES);
+        if (expected < 1 || expected > limits.maxOutputBytes)
+            fail('declared output limit exceeded', 'LIMIT_EXCEEDED');
+        const reframed = reframeLzh(data.subarray(CONTAINER_HEADER_BYTES + COMPRESSION_HEADER_BYTES));
+        const firstBlockType = (reframed[0] >>> 1) & 3;
+        if (firstBlockType !== 1 && firstBlockType !== 2)
+            fail('unsupported initial LZH block type', 'UNSUPPORTED_PROFILE');
+        let consumed;
+        try {
+            // Node's callback typings omit the info:true result shape.
+            const inflated = (await inflate(reframed, {
+                maxOutputLength: expected,
+                windowBits: 14,
+                info: true,
+            }));
+            payload = inflated.buffer;
+            consumed = inflated.engine.bytesWritten;
+        }
+        catch {
+            return fail('invalid, truncated, oversized, or unsupported LZH stream');
+        }
+        if (payload.length !== expected)
+            fail('decompressed length mismatch');
+        compressedTrailingBytes = reframed.length - consumed;
+        // Live SAP buffers have 1–6 residual bytes, sometimes nonzero. Their grammar is unverified.
+        // Bound the opaque tail to reject appended stale chunks; this is not an integrity check.
+        if (!Number.isSafeInteger(consumed) ||
+            consumed < 1 ||
+            compressedTrailingBytes < 0 ||
+            compressedTrailingBytes > MAX_COMPRESSED_TRAILING_BYTES)
+            fail('excess compressed trailer bytes');
+    }
+    else {
+        return fail(`unsupported compression flag ${compression}`, 'UNSUPPORTED_PROFILE');
+    }
+    return { version, codePage, compressed: compression === 2, compressedTrailingBytes, payload };
+}
+/** Parse one complete named TLINE table; every transition checks its required predecessor. */
+function parseTlinePayload(payload, codePage, limits) {
+    // unpackCluster has already rejected all profiles except UTF-16LE / 4103.
+    const charBytes = UTF16_BYTES_PER_UNIT;
+    const lines = [];
+    let p = 0;
+    let descriptor = false;
+    let ended = false;
+    let rowBytes = 0;
+    const fields = [];
+    let declaredRows;
+    let structureStarted = false;
+    let structureEnded = false;
+    let rowPending = false;
+    let tableClosed = false;
+    let segmentLength = 0;
+    const emit = (offset, length) => {
+        if (ended ||
+            tableClosed ||
+            rowPending ||
+            !descriptor ||
+            declaredRows === undefined ||
+            length !== TLINE_ROW_BYTES ||
+            rowBytes !== length ||
+            fields.length !== 2 ||
+            fields[0] !== TLINE_FORMAT_UNITS * charBytes ||
+            fields[1] !== TLINE_TEXT_UNITS * charBytes)
+            fail('unexpected TLINE row shape');
+        if (lines.length >= limits.maxLines)
+            fail('line limit exceeded', 'LIMIT_EXCEEDED');
+        const row = range(payload, offset, length);
+        lines.push({
+            format: textBytes(row.subarray(0, TLINE_FORMAT_UNITS * charBytes), codePage).replace(/ +$/u, ''),
+            text: textBytes(row.subarray(TLINE_FORMAT_UNITS * charBytes), codePage).replace(/ +$/u, ''),
+        });
+        rowPending = true;
+    };
+    while (p < payload.length) {
+        const marker = payload[p];
+        // Verified plain and inflated TLINE payloads end exactly at marker 04. CLUSTR has
+        // already removed storage padding; accepting zeros here could hide stale chunks.
+        if (ended)
+            fail('non-padding bytes after container end (trailing padding is unsupported)');
+        switch (marker) {
+            case MARKER.segment: {
+                if (descriptor)
+                    fail('multiple tables in TLINE container');
+                const nameOffset = 32;
+                if (uint(payload, p + 1, 1) !== 14 ||
+                    uint(payload, p + 2, 1) !== 0 ||
+                    uint(payload, p + 3, 4) !== TLINE_ROW_BYTES)
+                    fail('unexpected TLINE segment descriptor');
+                if (range(payload, p + 12, 20).some((byte) => byte !== 0))
+                    fail('unsupported segment header fields');
+                segmentLength = uint(payload, p + 7, 4);
+                const nameLength = uint(payload, p + 11, 1);
+                const bytes = charBytes;
+                const name = textBytes(range(payload, p + nameOffset, nameLength * bytes), codePage);
+                if (name !== 'TLINE')
+                    fail('container does not hold TLINE');
+                range(payload, p, nameOffset + nameLength * bytes);
+                p += nameOffset + nameLength * bytes;
+                descriptor = true;
+                break;
+            }
+            case MARKER.structureStart:
+                if (!descriptor || structureStarted || fields.length || declaredRows !== undefined)
+                    fail('misplaced structure start');
+                if (uint(payload, p + 3, 4) !== TLINE_ROW_BYTES)
+                    fail('unexpected structure length');
+                structureStarted = true;
+                p += 7;
+                break;
+            case MARKER.structureEnd:
+                if (!structureStarted || structureEnded || fields.length !== 2 || declaredRows !== undefined)
+                    fail('misplaced structure end');
+                if (uint(payload, p + 3, 4) !== TLINE_ROW_BYTES)
+                    fail('unexpected structure length');
+                structureEnded = true;
+                p += 7;
+                break;
+            case MARKER.characterField: {
+                if (!structureStarted || structureEnded || fields.length >= 2)
+                    fail('unexpected character descriptor');
+                const length = uint(payload, p + 3, 4);
+                if (length !== (fields.length === 0 ? TLINE_FORMAT_UNITS : TLINE_TEXT_UNITS) * charBytes)
+                    fail('unexpected TLINE field length');
+                fields.push(length);
+                rowBytes += length;
+                p += 7;
+                break;
+            }
+            case MARKER.table:
+                if (!structureEnded || declaredRows !== undefined || lines.length)
+                    fail('misplaced table descriptor');
+                if (uint(payload, p + 1, 4) !== rowBytes)
+                    fail('table row length mismatch');
+                declaredRows = uint(payload, p + 5, 4);
+                if (declaredRows > limits.maxLines)
+                    fail('declared line limit exceeded', 'LIMIT_EXCEEDED');
+                p += 9;
+                break;
+            case MARKER.sizedRow: {
+                const length = uint(payload, p + 1, 4);
+                emit(p + 5, length);
+                p += 5 + length;
+                break;
+            }
+            case MARKER.fixedRow:
+                emit(p + 1, rowBytes);
+                p += 1 + rowBytes;
+                break;
+            case MARKER.rowEnd:
+                if (!rowPending || tableClosed)
+                    fail('misplaced row end');
+                rowPending = false;
+                p++;
+                break;
+            case MARKER.tableEnd:
+                if (declaredRows === undefined || tableClosed || rowPending || declaredRows !== lines.length)
+                    fail('misplaced table end');
+                tableClosed = true;
+                p++;
+                break;
+            case MARKER.containerEnd:
+                if (!tableClosed)
+                    fail('container ended before table');
+                if (segmentLength !== 0 && segmentLength !== p)
+                    fail('segment length mismatch');
+                ended = true;
+                p++;
+                break;
+            default:
+                return fail(`unsupported container marker ${marker} at ${p}`);
+        }
+    }
+    if (!descriptor || !ended)
+        fail('missing TLINE descriptor or end marker');
+    if (declaredRows !== undefined && declaredRows !== lines.length)
+        fail('declared line count mismatch');
+    return lines;
+}
+/** Decode the verified stored-TLINE profile; returned lines retain ITF formatting codes. */
+export async function decodeStxl(data, limits = DEFAULT_LIMITS) {
+    const { version, codePage, compressed, compressedTrailingBytes, payload } = await unpackCluster(data, limits);
+    const lines = parseTlinePayload(payload, codePage, limits);
+    return {
+        version,
+        codePage,
+        compressed,
+        compressedTrailingBytes,
+        wellFormedUnicode: lines.every((line) => !/\p{Surrogate}/u.test(line.format) && !/\p{Surrogate}/u.test(line.text)),
+        lines,
+        outputBytes: payload.length,
+    };
+}
+//# sourceMappingURL=decoder.js.map

package/dist/adt/stored-text/decoder.js.map

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

package/dist/adt/stored-text/errors.d.ts

@@ -0,0 +1,10 @@
+/** Stable failure categories for the stored-text reader and codec. */
+export type TextReadErrorCode = 'INVALID_KEY' | 'NOT_FOUND' | 'UNSUPPORTED_PROFILE' | 'UNSUPPORTED_PERSISTENCE' | 'NON_ITF_TEXT' | 'REFERENCE_ERROR' | 'REFERENCE_CYCLE' | 'REFERENCE_LIMIT' | 'INCONSISTENT_READ' | 'CORRUPT_CLUSTER' | 'LIMIT_EXCEEDED';
+/** Messages must describe the failure without including text keys, contents, or raw SAP errors. */
+export declare class TextReadError extends Error {
+    readonly code: TextReadErrorCode;
+    constructor(code: TextReadErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/adt/stored-text/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/adt/stored-text/errors.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,WAAW,GACX,qBAAqB,GACrB,yBAAyB,GACzB,cAAc,GACd,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,mGAAmG;AACnG,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAEjC,YAAY,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAIlF;CACF"}

package/dist/adt/stored-text/errors.js

@@ -0,0 +1,10 @@
+/** Messages must describe the failure without including text keys, contents, or raw SAP errors. */
+export class TextReadError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(`STXL: ${message}`, options);
+        this.name = 'TextReadError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/adt/stored-text/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/adt/stored-text/errors.ts"],"names":[],"mappings":"AAcA,mGAAmG;AACnG,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAoB;IAEjC,YAAY,IAAuB,EAAE,OAAe,EAAE,OAA6B;QACjF,KAAK,CAAC,SAAS,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/adt/stored-text/index.d.ts

@@ -0,0 +1,7 @@
+/** Qualified classic persisted ITF reads through the caller's guarded ADT session. */
+export { TextReadError, type TextReadErrorCode } from './errors.js';
+export { normalizeTextKey } from './key.js';
+export { type ClassicTextBatchItem, type ClassicTextResult, findTextMatches, readClassicText, readClassicTextBatch, } from './reader.js';
+export { withStoredTextSession } from './source.js';
+export type { StoredTextHeader, StoredTextSource, TextDiscovery, TextKey } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adt/stored-text/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adt/stored-text/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/adt/stored-text/index.js

@@ -0,0 +1,6 @@
+/** Qualified classic persisted ITF reads through the caller's guarded ADT session. */
+export { TextReadError } from './errors.js';
+export { normalizeTextKey } from './key.js';
+export { findTextMatches, readClassicText, readClassicTextBatch, } from './reader.js';
+export { withStoredTextSession } from './source.js';
+//# sourceMappingURL=index.js.map

package/dist/adt/stored-text/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adt/stored-text/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,OAAO,EAAE,aAAa,EAA0B,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAGL,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/adt/stored-text/key.d.ts

@@ -0,0 +1,3 @@
+import type { TextKey } from './types.js';
+export declare function normalizeTextKey(value: unknown): TextKey;
+//# sourceMappingURL=key.d.ts.map

package/dist/adt/stored-text/key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.d.ts","sourceRoot":"","sources":["../../../src/adt/stored-text/key.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAmBxD"}

package/dist/adt/stored-text/key.js

@@ -0,0 +1,23 @@
+/** Exact SAP text identity. Only fixed-width trailing ASCII padding is normalized. */
+import { TextReadError } from './errors.js';
+const KEY_LENGTHS = { TDOBJECT: 10, TDNAME: 70, TDID: 4, TDSPRAS: 1 };
+export function normalizeTextKey(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new TextReadError('INVALID_KEY', 'provide an exact object, name, ID and SAP language key');
+    const input = value;
+    const result = {};
+    for (const [field, length] of Object.entries(KEY_LENGTHS)) {
+        const item = input[field];
+        if (typeof item !== 'string' ||
+            item.length > length ||
+            /\p{Surrogate}/u.test(item) ||
+            Array.from(item).some((char) => char.charCodeAt(0) < 32 || char.charCodeAt(0) === 127))
+            throw new TextReadError('INVALID_KEY', `invalid ${field}`);
+        const normalized = item.replace(/ +$/u, '');
+        if (!normalized)
+            throw new TextReadError('INVALID_KEY', `empty ${field}`);
+        result[field] = normalized;
+    }
+    return result;
+}
+//# sourceMappingURL=key.js.map

package/dist/adt/stored-text/key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../../../src/adt/stored-text/key.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,WAAW,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAW,CAAC;AAE/E,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7D,MAAM,IAAI,aAAa,CAAC,aAAa,EAAE,wDAAwD,CAAC,CAAC;IACnG,MAAM,KAAK,GAAG,KAAgC,CAAC;IAC/C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IACE,OAAO,IAAI,KAAK,QAAQ;YACxB,IAAI,CAAC,MAAM,GAAG,MAAM;YACpB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;YAEtF,MAAM,IAAI,aAAa,CAAC,aAAa,EAAE,WAAW,KAAK,EAAE,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,aAAa,CAAC,aAAa,EAAE,SAAS,KAAK,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,MAA4B,CAAC;AACtC,CAAC"}

package/dist/adt/stored-text/reader.d.ts

@@ -0,0 +1,52 @@
+import { type DecodedText, type TextLine } from './decoder.js';
+import { type TextReadErrorCode } from './errors.js';
+import type { StoredTextHeader, StoredTextSource, TextKey } from './types.js';
+export { normalizeTextKey } from './key.js';
+export interface ClassicTextResult {
+    requestedKey: TextKey;
+    resolvedKey: TextKey;
+    header: StoredTextHeader;
+    referenceChain: TextKey[];
+    lines: TextLine[];
+    lineCount: number;
+    storage: {
+        kind: 'classic-stxh-stxl';
+        clusterPresent: boolean;
+        consistency: 'reread-matched';
+        /** A matching reread is change detection, not a transactional snapshot. */
+        snapshotGuaranteed: false;
+        codec?: Omit<DecodedText, 'lines'>;
+    };
+    warnings: Array<'STORED_LINE_COUNT_DIFFERS' | 'LONE_SURROGATE' | 'ITF_COMMANDS_PRESENT'>;
+}
+/** Resolve exact, same-language stored references, then verify headers and bytes by rereading. */
+export declare function readClassicText(source: StoredTextSource, input: unknown): Promise<ClassicTextResult>;
+export type ClassicTextBatchItem = {
+    index: number;
+    status: 'ok';
+    text: ClassicTextResult;
+} | {
+    index: number;
+    status: 'error';
+    key?: TextKey;
+    error: {
+        code: TextReadErrorCode;
+        message: string;
+    };
+};
+/** Preserve input order/duplicates; isolate semantic failures, but abort on infrastructure or budget errors. */
+export declare function readClassicTextBatch(source: StoredTextSource, inputs: unknown[]): Promise<ClassicTextBatchItem[]>;
+/** Literal search of an already bounded batch; includes ITF command lines, no rendering or global scan. */
+export declare function findTextMatches(items: ClassicTextBatchItem[], phrase: string): {
+    matches: {
+        index: number;
+        key: TextKey;
+        lineNumber: number;
+        format: string;
+        text: string;
+    }[];
+    truncated: boolean;
+    caseSensitive: boolean;
+    scope: 'supplied-batch-only';
+};
+//# sourceMappingURL=reader.d.ts.map

package/dist/adt/stored-text/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../../src/adt/stored-text/reader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAAc,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAW5C,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,IAAI,EAAE,mBAAmB,CAAC;QAC1B,cAAc,EAAE,OAAO,CAAC;QACxB,WAAW,EAAE,gBAAgB,CAAC;QAC9B,2EAA2E;QAC3E,kBAAkB,EAAE,KAAK,CAAC;QAC1B,KAAK,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC,2BAA2B,GAAG,gBAAgB,GAAG,sBAAsB,CAAC,CAAC;CAC1F;AAED,kGAAkG;AAClG,wBAAsB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmE1G;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACxD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,iBAAiB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE3G,gHAAgH;AAChH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,OAAO,EAAE,GAChB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA0BjC;AAED,2GAA2G;AAC3G,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,EAAE,EAAE,MAAM,EAAE,MAAM;;eAK7C,MAAM;aAAO,OAAO;oBAAc,MAAM;gBAAU,MAAM;cAAQ,MAAM;;;;WAgB3C,qBAAqB;EAC/E"}

package/dist/adt/stored-text/reader.js

@@ -0,0 +1,142 @@
+/** Classic persisted ITF semantics. No SQL, credentials, RFC, text-memory or rendering. */
+import { createHash } from 'node:crypto';
+import { decodeStxl } from './decoder.js';
+import { TextReadError } from './errors.js';
+import { normalizeTextKey } from './key.js';
+export { normalizeTextKey } from './key.js';
+const MAX_REFERENCE_HOPS = 8;
+const MAX_BATCH_KEYS = 25;
+const MAX_BATCH_LINES = 10_000;
+const MAX_BATCH_JSON_BYTES = 2 * 1024 * 1024;
+const keyId = (key) => JSON.stringify([key.TDOBJECT, key.TDNAME, key.TDID, key.TDSPRAS]);
+const fingerprint = (bytes) => bytes === undefined ? 'absent' : createHash('sha256').update(bytes).digest('hex');
+/** Resolve exact, same-language stored references, then verify headers and bytes by rereading. */
+export async function readClassicText(source, input) {
+    const requestedKey = normalizeTextKey(input);
+    let key = requestedKey;
+    const headers = [];
+    const visited = new Set();
+    for (;;) {
+        if (visited.has(keyId(key)))
+            throw new TextReadError('REFERENCE_CYCLE', 'stored reference cycle');
+        visited.add(keyId(key));
+        try {
+            await source.assertSupportedKey(key);
+        }
+        catch (error) {
+            if (headers.length && error instanceof TextReadError && error.code === 'INVALID_KEY')
+                throw new TextReadError('REFERENCE_ERROR', 'reference target has an invalid configured key');
+            throw error;
+        }
+        const header = await source.readHeader(key);
+        if (!header)
+            throw new TextReadError(headers.length ? 'REFERENCE_ERROR' : 'NOT_FOUND', headers.length ? 'reference target has no classic stored header' : 'no header in classic storage');
+        if (header.textType.replace(/ +$/u, ''))
+            throw new TextReadError('NON_ITF_TEXT', 'non-ITF text requires a different storage reader');
+        if (header.legacyReference)
+            throw new TextReadError('UNSUPPORTED_PROFILE', 'legacy or incomplete reference metadata requires ITCRF support');
+        headers.push(header);
+        if (!header.reference)
+            break;
+        if (headers.length > MAX_REFERENCE_HOPS)
+            throw new TextReadError('REFERENCE_LIMIT', 'stored reference hop limit exceeded');
+        key = normalizeTextKey(header.reference);
+        if (key.TDSPRAS !== requestedKey.TDSPRAS)
+            throw new TextReadError('REFERENCE_ERROR', 'stored references must retain the requested language');
+    }
+    const bytes = await source.readCluster(key);
+    const decoded = bytes === undefined ? undefined : await decodeStxl(bytes);
+    // A count alone is insufficient: references and valid header-only texts can have stale counts.
+    for (const original of headers) {
+        const current = await source.readHeader(original.key);
+        if (!current || current.revision !== original.revision)
+            throw new TextReadError('INCONSISTENT_READ', 'stored header changed during the read; retry the exact key');
+    }
+    if (fingerprint(await source.readCluster(key)) !== fingerprint(bytes))
+        throw new TextReadError('INCONSISTENT_READ', 'stored chunks changed during the read; retry the exact key');
+    const lines = decoded?.lines ?? [];
+    const warnings = [];
+    if (headers[headers.length - 1].storedLineCount !== lines.length)
+        warnings.push('STORED_LINE_COUNT_DIFFERS');
+    if (decoded && !decoded.wellFormedUnicode)
+        warnings.push('LONE_SURROGATE');
+    if (lines.some((line) => line.format === '/:'))
+        warnings.push('ITF_COMMANDS_PRESENT');
+    const codec = decoded ? (({ lines: _lines, ...details }) => details)(decoded) : undefined;
+    return {
+        requestedKey,
+        resolvedKey: key,
+        header: headers[0],
+        referenceChain: headers.map((header) => header.key),
+        lines,
+        lineCount: lines.length,
+        storage: {
+            kind: 'classic-stxh-stxl',
+            clusterPresent: bytes !== undefined,
+            consistency: 'reread-matched',
+            snapshotGuaranteed: false,
+            codec,
+        },
+        warnings,
+    };
+}
+/** Preserve input order/duplicates; isolate semantic failures, but abort on infrastructure or budget errors. */
+export async function readClassicTextBatch(source, inputs) {
+    if (!Array.isArray(inputs) || inputs.length < 1 || inputs.length > MAX_BATCH_KEYS)
+        throw new TextReadError('LIMIT_EXCEEDED', `batch must contain 1–${MAX_BATCH_KEYS} exact keys`);
+    const completed = new Map();
+    const results = [];
+    let totalLines = 0;
+    let totalBytes = 2; // JSON array brackets.
+    for (const [index, input] of inputs.entries()) {
+        let key;
+        let item;
+        try {
+            key = normalizeTextKey(input);
+            const previous = completed.get(keyId(key));
+            item = previous ? { ...previous, index } : { index, status: 'ok', text: await readClassicText(source, key) };
+        }
+        catch (error) {
+            if (!(error instanceof TextReadError) || error.code === 'LIMIT_EXCEEDED')
+                throw error;
+            item = { index, status: 'error', key, error: { code: error.code, message: error.message } };
+        }
+        if (key)
+            completed.set(keyId(key), item);
+        totalLines += item.status === 'ok' ? item.text.lineCount : 0;
+        totalBytes += Buffer.byteLength(JSON.stringify(item)) + (index > 0 ? 1 : 0);
+        if (totalLines > MAX_BATCH_LINES || totalBytes > MAX_BATCH_JSON_BYTES)
+            throw new TextReadError('LIMIT_EXCEEDED', 'batch decoded result budget exceeded; request fewer texts');
+        results.push(item);
+    }
+    return results;
+}
+/** Literal search of an already bounded batch; includes ITF command lines, no rendering or global scan. */
+export function findTextMatches(items, phrase) {
+    if (!Array.isArray(items) || items.length > MAX_BATCH_KEYS)
+        throw new TextReadError('LIMIT_EXCEEDED', 'search must use a bounded text batch');
+    if (typeof phrase !== 'string' || !phrase.length || phrase.length > 200)
+        throw new TextReadError('INVALID_KEY', 'search phrase must contain 1–200 characters');
+    const matches = [];
+    let truncated = false;
+    let scanned = 0;
+    for (const item of items) {
+        if (item.status !== 'ok')
+            continue;
+        for (const [lineIndex, line] of item.text.lines.entries()) {
+            if (++scanned > MAX_BATCH_LINES)
+                throw new TextReadError('LIMIT_EXCEEDED', 'search line budget exceeded');
+            if (!line.text.includes(phrase))
+                continue;
+            if (matches.length === 50) {
+                truncated = true;
+                break;
+            }
+            matches.push({ index: item.index, key: item.text.requestedKey, lineNumber: lineIndex + 1, ...line });
+        }
+        if (truncated)
+            break;
+    }
+    return { matches, truncated, caseSensitive: true, scope: 'supplied-batch-only' };
+}
+//# sourceMappingURL=reader.js.map