arc-1 1.5.2 → 1.7.0

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

@@ -0,0 +1,55 @@
+/** Assemble bounded STXL storage rows; decoding and SAP access live in separate modules. */
+import { DEFAULT_LIMITS } from './decoder.js';
+import { TextReadError } from './errors.js';
+const keyLengths = { TDOBJECT: 10, TDNAME: 70, TDID: 4, TDSPRAS: 1 };
+export function keyFilters(key) {
+    return Object.entries(keyLengths).map(([name, length]) => {
+        const value = key[name];
+        if (typeof value !== 'string' ||
+            !value.length ||
+            value.length > length ||
+            Array.from(value).some((char) => char.charCodeAt(0) < 32)) {
+            throw new TextReadError('INVALID_KEY', `invalid ${name}`);
+        }
+        return { field: name, op: '=', value };
+    });
+}
+export function assembleChunks(rows, key, client) {
+    keyFilters(key);
+    if (!/^\d{3}$/.test(client))
+        throw new TextReadError('INVALID_KEY', 'invalid client');
+    if (!rows.length || rows.length > 256)
+        throw new TextReadError('CORRUPT_CLUSTER', 'missing or excessive chunks');
+    const chunks = rows
+        .map((row) => {
+        if (row.MANDT !== client ||
+            row.RELID !== 'TX' ||
+            Object.keys(keyLengths).some((name) => row[name] !== key[name]))
+            throw new TextReadError('CORRUPT_CLUSTER', 'chunk identity mismatch');
+        if (!/^\d+ *$/.test(row.SRTF2) || !/^\d+ *$/.test(row.CLUSTR))
+            throw new TextReadError('CORRUPT_CLUSTER', 'invalid chunk integer');
+        const index = Number(row.SRTF2);
+        const length = Number(row.CLUSTR);
+        if (!Number.isSafeInteger(index) ||
+            index < 0 ||
+            index > 255 ||
+            length < 1 ||
+            length > 7902 ||
+            !/^[\da-f]{15804}$/iu.test(row.CLUSTD))
+            throw new TextReadError('CORRUPT_CLUSTER', 'invalid or truncated binary chunk');
+        return { index, data: Buffer.from(row.CLUSTD.slice(0, length * 2), 'hex') };
+    })
+        .sort((a, b) => a.index - b.index);
+    let total = 0;
+    for (const [index, chunk] of chunks.entries()) {
+        if (chunk.index !== index)
+            throw new TextReadError('CORRUPT_CLUSTER', 'missing or duplicate chunk sequence');
+        if (index < chunks.length - 1 && chunk.data.length !== 7902)
+            throw new TextReadError('CORRUPT_CLUSTER', 'short intermediate chunk');
+        total += chunk.data.length;
+        if (total > DEFAULT_LIMITS.maxInputBytes)
+            throw new TextReadError('LIMIT_EXCEEDED', 'compressed input limit exceeded');
+    }
+    return Buffer.concat(chunks.map((chunk) => chunk.data), total);
+}
+//# sourceMappingURL=chunks.js.map

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

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

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

@@ -0,0 +1,31 @@
+export interface TextLine {
+    format: string;
+    text: string;
+}
+export interface DecodeLimits {
+    maxInputBytes: number;
+    maxOutputBytes: number;
+    maxLines: number;
+}
+export interface UnpackedCluster {
+    version: number;
+    codePage: string;
+    compressed: boolean;
+    compressedTrailingBytes: number;
+    payload: Buffer;
+}
+export interface DecodedText {
+    version: number;
+    codePage: string;
+    compressed: boolean;
+    compressedTrailingBytes: number;
+    wellFormedUnicode: boolean;
+    lines: TextLine[];
+    outputBytes: number;
+}
+export declare const DEFAULT_LIMITS: Readonly<DecodeLimits>;
+/** Validate the tested container profile and return its bounded decompressed payload. */
+export declare function unpackCluster(data: Buffer, limits?: DecodeLimits): Promise<UnpackedCluster>;
+/** Decode the verified stored-TLINE profile; returned lines retain ITF formatting codes. */
+export declare function decodeStxl(data: Buffer, limits?: DecodeLimits): Promise<DecodedText>;
+//# sourceMappingURL=decoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../../src/adt/stored-text/decoder.ts"],"names":[],"mappings":"AA2DA,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,uBAAuB,EAAE,MAAM,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AACD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,YAAY,CAIhD,CAAC;AA6CH,yFAAyF;AACzF,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,YAA6B,GAAG,OAAO,CAAC,eAAe,CAAC,CAoDjH;AAqID,4FAA4F;AAC5F,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,YAA6B,GAAG,OAAO,CAAC,WAAW,CAAC,CAY1G"}

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"}