codecane 1.0.293 → 1.0.296

package/dist/common/util/saxy.js

@@ -0,0 +1,503 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Saxy = exports.parseAttrs = void 0;
+/**
+ * This is a modified version of the Saxy library that emits text nodes immediately
+ */
+const string_decoder_1 = require("string_decoder");
+const readable_stream_1 = require("readable-stream");
+const string_1 = require("./string");
+/**
+ * Nodes that can be found inside an XML stream.
+ */
+const Node = {
+    text: 'text',
+    cdata: 'cdata',
+    comment: 'comment',
+    processingInstruction: 'processinginstruction',
+    tagOpen: 'tagopen',
+    tagClose: 'tagclose',
+    // markupDeclaration: 'markupDeclaration',
+};
+/**
+ * Expand a piece of XML text by replacing all XML entities by
+ * their canonical value. Ignore invalid and unknown entities.
+ *
+ * @param input A string of XML text
+ * @return The input string, expanded
+ */
+const parseEntities = (input) => {
+    let position = 0, next = 0;
+    const parts = [];
+    while ((next = input.indexOf('&', position)) !== -1) {
+        // remember anything there was before the entity
+        if (next > position) {
+            parts.push(input.slice(position, next));
+        }
+        const end = input.indexOf(';', next);
+        // ignore unterminated entities
+        if (end === -1) {
+            parts.push(input.slice(next));
+            break;
+        }
+        const entity = input.slice(next + 1, end);
+        if (entity === 'quot') {
+            parts.push('"');
+        }
+        else if (entity === 'amp') {
+            parts.push('&');
+        }
+        else if (entity === 'apos') {
+            parts.push("'");
+        }
+        else if (entity === 'lt') {
+            parts.push('<');
+        }
+        else if (entity === 'gt') {
+            parts.push('>');
+        }
+        else {
+            // ignore unrecognized character entities
+            if (entity[0] !== '#') {
+                parts.push('&' + entity + ';');
+            }
+            else {
+                // hexadecimal numeric entities
+                if (entity[1] === 'x') {
+                    const value = parseInt(entity.slice(2), 16);
+                    // ignore non-numeric numeric entities
+                    if (isNaN(value)) {
+                        parts.push('&' + entity + ';');
+                    }
+                    else {
+                        parts.push(String.fromCharCode(value));
+                    }
+                }
+                else {
+                    // decimal numeric entities
+                    const value = parseInt(entity.slice(1), 10);
+                    // ignore non-numeric numeric entities
+                    if (isNaN(value)) {
+                        parts.push('&' + entity + ';');
+                    }
+                    else {
+                        parts.push(String.fromCharCode(value));
+                    }
+                }
+            }
+        }
+        position = end + 1;
+    }
+    if (position < input.length) {
+        parts.push(input.slice(position));
+    }
+    return parts.join('');
+};
+/**
+ * Parse a string of XML attributes to a map of attribute names to their values.
+ *
+ * @param input A string of XML attributes
+ * @throws If the string is malformed
+ * @return A map of attribute names to their values
+ */
+const parseAttrs = (input) => {
+    const attrs = {};
+    const end = input.length;
+    let position = 0;
+    while (position < end) {
+        // Skip all whitespace
+        if ((0, string_1.isWhitespace)(input[position])) {
+            position += 1;
+            continue;
+        }
+        // Check that the attribute name contains valid chars
+        const startName = position;
+        while (input[position] !== '=' && position < end) {
+            if ((0, string_1.isWhitespace)(input[position])) {
+                throw new Error('Attribute names may not contain whitespace');
+            }
+            position += 1;
+        }
+        // This is XML, so we need a value for the attribute
+        if (position === end) {
+            throw new Error('Expected a value for the attribute');
+        }
+        const attrName = input.slice(startName, position);
+        position += 1;
+        const startQuote = input[position];
+        position += 1;
+        if (startQuote !== '"' && startQuote !== "'") {
+            throw new Error('Attribute values should be quoted');
+        }
+        const endQuote = input.indexOf(startQuote, position);
+        if (endQuote === -1) {
+            throw new Error('Unclosed attribute value');
+        }
+        const attrValue = input.slice(position, endQuote);
+        attrs[attrName] = attrValue;
+        position = endQuote + 1;
+    }
+    return attrs;
+};
+exports.parseAttrs = parseAttrs;
+/**
+ * Find the first character in a string that matches a predicate
+ * while being outside the given delimiters.
+ *
+ * @param haystack String to search in
+ * @param predicate Checks whether a character is permissible
+ * @param [delim=''] Delimiter inside which no match should be
+ * returned. If empty, all characters are considered.
+ * @param [fromIndex=0] Start the search from this index
+ * @return Index of the first match, or -1 if no match
+ */
+const findIndexOutside = (haystack, predicate, delim = '', fromIndex = 0) => {
+    const length = haystack.length;
+    let index = fromIndex;
+    let inDelim = false;
+    while (index < length && (inDelim || !predicate(haystack[index]))) {
+        if (haystack[index] === delim) {
+            inDelim = !inDelim;
+        }
+        ++index;
+    }
+    return index === length ? -1 : index;
+};
+/**
+ * Parse an XML stream and emit events corresponding
+ * to the different tokens encountered.
+ */
+class Saxy extends readable_stream_1.Transform {
+    _decoder;
+    _tagStack;
+    _waiting;
+    _schema;
+    _pendingEntity;
+    /**
+     * Parse a string of XML attributes to a map of attribute names
+     * to their values
+     *
+     * @param input A string of XML attributes
+     * @throws If the string is malformed
+     * @return A map of attribute names to their values
+     */
+    static parseAttrs = exports.parseAttrs;
+    /**
+     * Expand a piece of XML text by replacing all XML entities
+     * by their canonical value. Ignore invalid and unknown
+     * entities
+     *
+     * @param input A string of XML text
+     * @return The input string, expanded
+     */
+    static parseEntities = parseEntities;
+    /**
+     * Create a new parser instance.
+     * @param schema Optional schema defining allowed top-level tags and their children
+     */
+    constructor(schema) {
+        super({ decodeStrings: false });
+        // String decoder instance
+        const state = this._writableState;
+        this._decoder = new string_decoder_1.StringDecoder(state.defaultEncoding);
+        // Stack of tags that were opened up until the current cursor position
+        this._tagStack = [];
+        // Not waiting initially
+        this._waiting = null;
+        // Store schema if provided
+        this._schema = schema || null;
+        // Pending entity for incomplete entities
+        this._pendingEntity = null;
+    }
+    /**
+     * Handle a chunk of data written into the stream.
+     *
+     * @param chunk Chunk of data.
+     * @param encoding Encoding of the string, or 'buffer'.
+     * @param callback Called when the chunk has been parsed, with
+     * an optional error argument.
+     */
+    _write(chunk, encoding, callback) {
+        const data = encoding === 'buffer'
+            ? this._decoder.write(chunk)
+            : chunk;
+        this._parseChunk(data, callback);
+    }
+    /**
+     * Handle the end of incoming data.
+     *
+     * @param callback
+     */
+    _final(callback) {
+        // Make sure all data has been extracted from the decoder
+        this._parseChunk(this._decoder.end(), (err) => {
+            if (err) {
+                callback(err);
+                return;
+            }
+            // Handle any remaining pending entity
+            if (this._pendingEntity) {
+                this.emit(Node.text, { contents: this._pendingEntity });
+            }
+            // Handle unclosed nodes
+            if (this._waiting !== null) {
+                switch (this._waiting.token) {
+                    case Node.text:
+                        // Text nodes are implicitly closed
+                        this.emit('text', { contents: this._waiting.data });
+                        break;
+                    case Node.cdata:
+                        callback(new Error('Unclosed CDATA section'));
+                        return;
+                    case Node.comment:
+                        callback(new Error('Unclosed comment'));
+                        return;
+                    case Node.processingInstruction:
+                        callback(new Error('Unclosed processing instruction'));
+                        return;
+                    case Node.tagOpen:
+                    case Node.tagClose:
+                        // We do not distinguish between unclosed opening
+                        // or unclosed closing tags
+                        // callback(new Error('Unclosed tag'))
+                        return;
+                    default:
+                    // Pass
+                }
+            }
+            if (this._tagStack.length !== 0) {
+                // callback(new Error(`Unclosed tags: ${this._tagStack.join(',')}`))
+                return;
+            }
+            callback();
+        });
+    }
+    /**
+     * Immediately parse a complete chunk of XML and close the stream.
+     *
+     * @param input Input chunk.
+     */
+    parse(input) {
+        this.end(input);
+        return this;
+    }
+    /**
+     * Put the stream into waiting mode, which means we need more data
+     * to finish parsing the current token.
+     *
+     * @param token Type of token that is being parsed.
+     * @param data Pending data.
+     */
+    _wait(token, data) {
+        this._waiting = { token, data };
+    }
+    /**
+     * Put the stream out of waiting mode.
+     *
+     * @return Any data that was pending.
+     */
+    _unwait() {
+        if (this._waiting === null) {
+            return '';
+        }
+        const data = this._waiting.data;
+        this._waiting = null;
+        return data;
+    }
+    /**
+     * Handle the opening of a tag in the text stream.
+     *
+     * Push the tag into the opened tag stack and emit the
+     * corresponding event on the event emitter.
+     *
+     * @param node Information about the opened tag.
+     * @param rawTag The raw tag text including angle brackets
+     */
+    _handleTagOpening(node, rawTag) {
+        const { name } = node;
+        // If we have a schema, validate against it
+        if (this._schema) {
+            // For top-level tags
+            if (this._tagStack.length === 0) {
+                // Convert to text if not in schema
+                if (!this._schema[name]) {
+                    this.emit(Node.text, { contents: rawTag });
+                    return;
+                }
+            }
+            // For nested tags
+            else {
+                const parentTag = this._tagStack[this._tagStack.length - 1];
+                // Convert to text if parent not in schema or this tag not allowed as child
+                if (!this._schema[parentTag] ||
+                    !this._schema[parentTag].includes(name)) {
+                    this.emit(Node.text, { contents: rawTag });
+                    return;
+                }
+            }
+        }
+        if (!node.isSelfClosing) {
+            this._tagStack.push(node.name);
+        }
+        this.emit(Node.tagOpen, node);
+    }
+    /**
+     * Parse a XML chunk.
+     *
+     * @private
+     * @param input A string with the chunk data.
+     * @param callback Called when the chunk has been parsed, with
+     * an optional error argument.
+     */
+    _parseChunk(input, callback) {
+        // Handle pending entity if exists
+        if (this._pendingEntity) {
+            input = this._pendingEntity + input;
+            this._pendingEntity = null;
+        }
+        // Use pending data if applicable and get out of waiting mode
+        const waitingData = this._unwait();
+        input = waitingData + input;
+        let chunkPos = 0;
+        const end = input.length;
+        while (chunkPos < end) {
+            if (input[chunkPos] !== '<' ||
+                (chunkPos + 1 < end && !this._isXMLTagStart(input, chunkPos + 1))) {
+                // Find next potential tag, but verify it's actually a tag
+                let nextTag = input.indexOf('<', chunkPos);
+                while (nextTag !== -1 &&
+                    nextTag + 1 < end &&
+                    !this._isXMLTagStart(input, nextTag + 1)) {
+                    nextTag = input.indexOf('<', nextTag + 1);
+                }
+                // We read a TEXT node but there might be some
+                // more text data left, so we wait
+                if (nextTag === -1) {
+                    let chunk = input.slice(chunkPos);
+                    if (this._tagStack.length === 1 && chunk === '\n') {
+                        chunk = '';
+                    }
+                    // Check for incomplete entity at end
+                    const lastAmp = chunk.lastIndexOf('&');
+                    if (lastAmp !== -1 && chunk.indexOf(';', lastAmp) === -1) {
+                        // Store incomplete entity for next chunk
+                        this._pendingEntity = chunk.slice(lastAmp);
+                        chunk = chunk.slice(0, lastAmp);
+                    }
+                    if (chunk.length > 0) {
+                        chunk = parseEntities(chunk);
+                        this.emit(Node.text, { contents: chunk });
+                    }
+                    chunkPos = end;
+                    break;
+                }
+                // A tag follows, so we can be confident that
+                // we have all the data needed for the TEXT node
+                let chunk = input.slice(chunkPos, nextTag);
+                if (this._tagStack.length === 1 && chunk === '\n') {
+                    chunk = '';
+                }
+                // Check for incomplete entity at end
+                const lastAmp = chunk.lastIndexOf('&');
+                if (lastAmp !== -1 && chunk.indexOf(';', lastAmp) === -1) {
+                    // Store incomplete entity for next chunk
+                    this._pendingEntity = chunk.slice(lastAmp);
+                    chunk = chunk.slice(0, lastAmp);
+                }
+                // Only emit non-whitespace text or text within a single tag (not between tags)
+                if (chunk.length > 0) {
+                    chunk = parseEntities(chunk);
+                    this.emit(Node.text, { contents: chunk });
+                }
+                chunkPos = nextTag;
+            }
+            // Invariant: the cursor now points on the name of a tag,
+            // after an opening angled bracket
+            chunkPos += 1;
+            // Recognize regular tags (< ... >)
+            const tagClose = findIndexOutside(input, (char) => char === '>', '"', chunkPos);
+            if (tagClose === -1) {
+                this._wait(Node.tagOpen, input.slice(chunkPos - 1));
+                break;
+            }
+            // Check if the tag is a closing tag
+            if (input[chunkPos] === '/') {
+                const tagName = input.slice(chunkPos + 1, tagClose);
+                const stackedTagName = this._tagStack[this._tagStack.length - 1];
+                // Convert closing tag to text if it doesn't match schema validation
+                if (this._schema) {
+                    // For top-level tags
+                    if (this._tagStack.length === 1) {
+                        if (!this._schema[tagName]) {
+                            const rawTag = input.slice(chunkPos - 1, tagClose + 1);
+                            this.emit(Node.text, { contents: rawTag });
+                            chunkPos = tagClose + 1;
+                            continue;
+                        }
+                    }
+                    // For nested tags
+                    else {
+                        const parentTag = this._tagStack[this._tagStack.length - 2];
+                        if (!this._schema[parentTag] ||
+                            !this._schema[parentTag].includes(tagName)) {
+                            const rawTag = input.slice(chunkPos - 1, tagClose + 1);
+                            this.emit(Node.text, { contents: rawTag });
+                            chunkPos = tagClose + 1;
+                            continue;
+                        }
+                    }
+                }
+                this._tagStack.pop();
+                // Only emit if the tag matches what we expect
+                if (stackedTagName === tagName) {
+                    this.emit(Node.tagClose, { name: tagName });
+                }
+                chunkPos = tagClose + 1;
+                continue;
+            }
+            // Check if the tag is self-closing
+            const isSelfClosing = input[tagClose - 1] === '/';
+            let realTagClose = isSelfClosing ? tagClose - 1 : tagClose;
+            // Extract the tag name and attributes
+            const whitespace = input.slice(chunkPos).search(/\s/);
+            // Get the raw tag text for potential text node conversion
+            const rawTag = input.slice(chunkPos - 1, tagClose + 1);
+            if (whitespace === -1 || whitespace >= tagClose - chunkPos) {
+                // Tag without any attribute
+                this._handleTagOpening({
+                    name: input.slice(chunkPos, realTagClose),
+                    attrs: '',
+                    isSelfClosing,
+                }, rawTag);
+            }
+            else if (whitespace === 0) {
+                // Invalid tag starting with whitespace - emit as text
+                this.emit(Node.text, { contents: rawTag });
+            }
+            else {
+                // Tag with attributes
+                this._handleTagOpening({
+                    name: input.slice(chunkPos, chunkPos + whitespace),
+                    attrs: input.slice(chunkPos + whitespace, realTagClose),
+                    isSelfClosing,
+                }, rawTag);
+            }
+            chunkPos = tagClose + 1;
+        }
+        callback();
+    }
+    /**
+     * Check if a potential XML tag start is actually a valid tag
+     * @param input The input string
+     * @param pos Position after the < character
+     * @returns true if this is a valid XML tag start
+     */
+    _isXMLTagStart(input, pos) {
+        // Valid XML tags must start with a letter, underscore or colon
+        // https://www.w3.org/TR/xml/#NT-NameStartChar
+        const firstChar = input[pos];
+        return /[A-Za-z_:]/.test(firstChar) || firstChar === '/';
+    }
+}
+exports.Saxy = Saxy;
+//# sourceMappingURL=saxy.js.map

package/dist/common/util/saxy.js.map

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

package/dist/common/util/string.d.ts

@@ -0,0 +1,61 @@
+export declare const truncateString: (str: string, maxLength: number) => string;
+export declare const truncateStringWithMessage: ({ str, maxLength, message, remove, }: {
+    str: string;
+    maxLength: number;
+    message?: string;
+    remove?: "END" | "START" | "MIDDLE";
+}) => string;
+/**
+ * Check if a character is a whitespace character according
+ * to the XML spec (space, carriage return, line feed or tab)
+ *
+ * @param character Character to check
+ * @return Whether the character is whitespace or not
+ */
+export declare const isWhitespace: (character: string) => boolean;
+export declare const replaceNonStandardPlaceholderComments: (content: string, replacement: string) => string;
+export declare const randBoolFromStr: (str: string) => boolean;
+export declare const pluralize: (count: number, word: string) => string;
+/**
+ * Safely replaces all occurrences of a search string with a replacement string,
+ * escaping special replacement patterns (like $) in the replacement string.
+ */
+export declare const capitalize: (str: string) => string;
+/**
+ * Converts a snake_case string to Title Case
+ * Example: "add_subgoal" -> "Add Subgoal"
+ */
+export declare const snakeToTitleCase: (str: string) => string;
+/**
+ * Ensures a URL has the appropriate protocol (http:// or https://)
+ * Uses http:// for localhost and local IPs, https:// for all other domains
+ */
+export declare const ensureUrlProtocol: (url: string) => string;
+export declare const safeReplace: (content: string, searchStr: string, replaceStr: string) => string;
+export declare const hasLazyEdit: (content: string) => boolean;
+/**
+ * Extracts a JSON field from a string, transforms it, and puts it back.
+ * Handles both array and object JSON values.
+ * @param content The string containing JSON-like content
+ * @param field The field name to find and transform
+ * @param transform Function to transform the parsed JSON value
+ * @param fallback String to use if parsing fails
+ * @returns The content string with the transformed JSON field
+ */
+export declare const transformJsonInString: <T = unknown>(content: string, field: string, transform: (json: T) => unknown, fallback: string) => string;
+/**
+ * Generates a compact unique identifier by combining timestamp bits with random bits.
+ * Takes last 24 bits of timestamp (enough for months) and 8 random bits.
+ * Encodes in base36 for very compact strings (~5-6 chars).
+ * @param prefix Optional prefix to add to the ID
+ * @returns A unique string ID
+ * @example
+ * generateCompactId()      // => "1a2b3c"
+ * generateCompactId('msg-') // => "msg-1a2b3c"
+ */
+export declare const generateCompactId: (prefix?: string) => string;
+/**
+ * Removes null characters from a string
+ */
+export declare const stripNullChars: (str: string) => string;
+export declare function stripColors(str: string): string;