@sunafterrainwm/telegram-entities-builder 0.1.2 → 0.2.0

package/dist/index.mjs

@@ -1,356 +1,336 @@
-// src/index.ts
-var EntityBuilder = class _EntityBuilder {
-  #text = "";
-  #entities = [];
-  #parent;
-  addText(text) {
-    this.#text += text;
-    return this;
-  }
-  addTextEntity(text, entity) {
-    text = String(text);
-    if (text.length > 0) {
-      this.#entities.push({
-        ...entity,
-        offset: this.#text.length,
-        length: text.length
-      });
-      this.#text += text;
-    }
-    return this;
-  }
-  addTextEntities(text, entities) {
-    for (const entity of entities) {
-      this.#entities.push({
-        ...entity,
-        offset: this.#text.length,
-        length: text.length
-      });
-    }
-    this.#text += text;
-    return this;
-  }
-  addTextSegmentList(segments) {
-    for (const segment of segments) {
-      if (segment.entity) {
-        this.addTextEntity(segment.text, segment.entity);
-      } else if (segment.entities) {
-        this.addTextEntities(segment.text, segment.entities);
-      } else {
-        this.#text += segment.text;
-      }
-    }
-    return this;
-  }
-  buildTextPayload() {
-    return {
-      text: this.#text,
-      entities: this.#entities
-    };
-  }
-  buildCaptionPayload() {
-    return {
-      caption: this.#text,
-      caption_entities: this.#entities
-    };
-  }
-  buildInlinePayload() {
-    return {
-      message_text: this.#text,
-      entities: this.#entities
-    };
-  }
-  sortEntities() {
-    this.#entities.sort((a, b) => a.offset - b.offset || a.length - b.length);
-    return this;
-  }
-  sliceInplace(start, end) {
-    if (!start && !end) {
-      return this;
-    }
-    const len = this.#text.length;
-    const s = start === void 0 ? 0 : start < 0 ? Math.max(len + start, 0) : Math.min(start, len);
-    const e = end === void 0 ? len : end < 0 ? Math.max(len + end, 0) : Math.min(end, len);
-    if (s >= e) {
-      this.#text = "";
-      this.#entities = [];
-      return this;
-    }
-    this.#text = this.#text.slice(s, e);
-    this.#entities = this.#entities.flatMap((entity) => {
-      const overlapStart = Math.max(s, entity.offset);
-      const overlapEnd = Math.min(e, entity.offset + entity.length);
-      if (overlapStart < overlapEnd) {
-        return [
-          {
-            ...entity,
-            offset: overlapStart - s,
-            length: overlapEnd - overlapStart
-          }
-        ];
-      }
-      return [];
-    });
-    return this;
-  }
-  slice(start, end) {
-    return this.clone().sliceInplace(start, end);
-  }
-  trimStart() {
-    const trimmedLength = this.#text.trimStart().length;
-    const diff = this.#text.length - trimmedLength;
-    if (diff > 0) {
-      this.sliceInplace(diff);
-    }
-    return this;
-  }
-  trimEnd() {
-    const trimmedLength = this.#text.trimEnd().length;
-    if (trimmedLength < this.#text.length) {
-      this.sliceInplace(0, trimmedLength);
-    }
-    return this;
-  }
-  trim() {
-    const originalLength = this.#text.length;
-    const startOffset = originalLength - this.#text.trimStart().length;
-    const endOffset = this.#text.trimEnd().length;
-    if (startOffset > 0 || endOffset < originalLength) {
-      this.sliceInplace(startOffset, endOffset);
-    }
-    return this;
-  }
-  clone() {
-    const instance = new _EntityBuilder();
-    instance.#text = this.#text;
-    instance.#entities = structuredClone(this.#entities);
-    return instance;
-  }
-  fork() {
-    const instance = new _EntityBuilder();
-    instance.#parent = this;
-    return instance;
-  }
-  /**
-   * Merges a payload text and its entities into this builder, optionally wrapping them with additional entities.
-   */
-  mergePayload(text, entities, wrappers = []) {
-    const startOffset = this.#text.length;
-    this.#text += text;
-    this.#entities.push(
-      ...wrappers.map(
-        (w) => ({
-          ...w,
-          offset: startOffset,
-          length: text.length
-        })
-      ),
-      ...entities.map((e) => ({
-        ...e,
-        offset: e.offset + startOffset
-      }))
-    );
-  }
-  merge(wrapperEntities = []) {
-    if (!this.#parent) {
-      throw new Error("Cannot merge: This builder is not a fork or has already been merged.");
-    }
-    this.#parent.mergePayload(this.#text, this.#entities, wrapperEntities);
-    this.#parent = void 0;
-  }
+//#region src/index.ts
+/**
+* Main implementation of IEntityBuilder that eagerly evaluates and stores entities.
+*/
+var EntityBuilder = class EntityBuilder {
+	#text = "";
+	#entities = [];
+	#parent;
+	addText(text) {
+		this.#text += text;
+		return this;
+	}
+	addTextEntity(text, entity) {
+		text = String(text);
+		if (text.length > 0) {
+			this.#entities.push({
+				...entity,
+				offset: this.#text.length,
+				length: text.length
+			});
+			this.#text += text;
+		}
+		return this;
+	}
+	addTextEntities(text, entities) {
+		for (const entity of entities) this.#entities.push({
+			...entity,
+			offset: this.#text.length,
+			length: text.length
+		});
+		this.#text += text;
+		return this;
+	}
+	addTextSegmentList(segments) {
+		for (const segment of segments) if (segment.entity) this.addTextEntity(segment.text, segment.entity);
+		else if (segment.entities) this.addTextEntities(segment.text, segment.entities);
+		else this.#text += segment.text;
+		return this;
+	}
+	buildTextPayload() {
+		return {
+			text: this.#text,
+			entities: this.#entities
+		};
+	}
+	buildCaptionPayload() {
+		return {
+			caption: this.#text,
+			caption_entities: this.#entities
+		};
+	}
+	buildInlinePayload() {
+		return {
+			message_text: this.#text,
+			entities: this.#entities
+		};
+	}
+	sortEntities() {
+		this.#entities.sort((a, b) => a.offset - b.offset || a.length - b.length);
+		return this;
+	}
+	sliceInplace(start, end) {
+		if (!start && !end) return this;
+		const len = this.#text.length;
+		const s = start === void 0 ? 0 : start < 0 ? Math.max(len + start, 0) : Math.min(start, len);
+		const e = end === void 0 ? len : end < 0 ? Math.max(len + end, 0) : Math.min(end, len);
+		if (s >= e) {
+			this.#text = "";
+			this.#entities = [];
+			return this;
+		}
+		this.#text = this.#text.slice(s, e);
+		this.#entities = this.#entities.flatMap((entity) => {
+			const overlapStart = Math.max(s, entity.offset);
+			const overlapEnd = Math.min(e, entity.offset + entity.length);
+			if (overlapStart < overlapEnd) return [{
+				...entity,
+				offset: overlapStart - s,
+				length: overlapEnd - overlapStart
+			}];
+			return [];
+		});
+		return this;
+	}
+	slice(start, end) {
+		return this.clone().sliceInplace(start, end);
+	}
+	trimStart() {
+		const trimmedLength = this.#text.trimStart().length;
+		const diff = this.#text.length - trimmedLength;
+		if (diff > 0) this.sliceInplace(diff);
+		return this;
+	}
+	trimEnd() {
+		const trimmedLength = this.#text.trimEnd().length;
+		if (trimmedLength < this.#text.length) this.sliceInplace(0, trimmedLength);
+		return this;
+	}
+	trim() {
+		const originalLength = this.#text.length;
+		const startOffset = originalLength - this.#text.trimStart().length;
+		const endOffset = this.#text.trimEnd().length;
+		if (startOffset > 0 || endOffset < originalLength) this.sliceInplace(startOffset, endOffset);
+		return this;
+	}
+	clone() {
+		const instance = new EntityBuilder();
+		instance.#text = this.#text;
+		instance.#entities = structuredClone(this.#entities);
+		return instance;
+	}
+	fork() {
+		const instance = new EntityBuilder();
+		instance.#parent = this;
+		return instance;
+	}
+	/**
+	* Merges a payload text and its entities into this builder, optionally wrapping them with additional entities.
+	*/
+	mergePayload(text, entities, wrappers = []) {
+		const startOffset = this.#text.length;
+		this.#text += text;
+		this.#entities.push(...wrappers.map((w) => ({
+			...w,
+			offset: startOffset,
+			length: text.length
+		})), ...entities.map((e) => ({
+			...e,
+			offset: e.offset + startOffset
+		})));
+	}
+	merge(wrapperEntities = []) {
+		if (!this.#parent) throw new Error("Cannot merge: This builder is not a fork or has already been merged.");
+		this.#parent.mergePayload(this.#text, this.#entities, wrapperEntities);
+		this.#parent = void 0;
+	}
 };
-var LazyEntityBuilder = class _LazyEntityBuilder {
-  #segments = [];
-  #parent;
-  /**
-   * Flattens the lazy segments into a new EntityBuilder instance.
-   */
-  flatten() {
-    const builder = new EntityBuilder();
-    builder.addTextSegmentList(this.#segments);
-    return builder;
-  }
-  addText(text) {
-    this.#segments.push({ text });
-    return this;
-  }
-  addTextEntity(text, entity) {
-    this.#segments.push({ text, entity });
-    return this;
-  }
-  addTextEntities(text, entities) {
-    this.#segments.push({ text, entities });
-    return this;
-  }
-  addTextSegmentList(segments) {
-    this.#segments.push(...segments);
-    return this;
-  }
-  clone() {
-    const instance = new _LazyEntityBuilder();
-    instance.#segments = structuredClone(this.#segments);
-    return instance;
-  }
-  fork() {
-    const instance = new _LazyEntityBuilder();
-    instance.#parent = this;
-    return instance;
-  }
-  merge(wrapperEntities = []) {
-    if (!this.#parent) {
-      throw new Error("Cannot merge: This builder is not a fork or has already been merged.");
-    }
-    const wrappedSegments = this.#segments.map((seg) => {
-      if (seg.text.length === 0) {
-        return seg;
-      }
-      const existing = seg.entities ? [...seg.entities] : seg.entity ? [seg.entity] : [];
-      return {
-        text: seg.text,
-        entities: [...existing, ...wrapperEntities]
-      };
-    });
-    this.#parent.addTextSegmentList(wrappedSegments);
-    this.#parent = void 0;
-  }
+/**
+* A lazy implementation of IEntityBuilderBase that stores segments and flattens them into an EntityBuilder only when needed.
+*/
+var LazyEntityBuilder = class LazyEntityBuilder {
+	#segments = [];
+	#parent;
+	/**
+	* Flattens the lazy segments into a new EntityBuilder instance.
+	*/
+	flatten() {
+		const builder = new EntityBuilder();
+		builder.addTextSegmentList(this.#segments);
+		return builder;
+	}
+	addText(text) {
+		this.#segments.push({ text });
+		return this;
+	}
+	addTextEntity(text, entity) {
+		this.#segments.push({
+			text,
+			entity
+		});
+		return this;
+	}
+	addTextEntities(text, entities) {
+		this.#segments.push({
+			text,
+			entities
+		});
+		return this;
+	}
+	addTextSegmentList(segments) {
+		this.#segments.push(...segments);
+		return this;
+	}
+	clone() {
+		const instance = new LazyEntityBuilder();
+		instance.#segments = structuredClone(this.#segments);
+		return instance;
+	}
+	fork() {
+		const instance = new LazyEntityBuilder();
+		instance.#parent = this;
+		return instance;
+	}
+	merge(wrapperEntities = []) {
+		if (!this.#parent) throw new Error("Cannot merge: This builder is not a fork or has already been merged.");
+		const wrappedSegments = this.#segments.map((seg) => {
+			if (seg.text.length === 0) return seg;
+			const existing = seg.entities ? [...seg.entities] : seg.entity ? [seg.entity] : [];
+			return {
+				text: seg.text,
+				entities: [...existing, ...wrapperEntities]
+			};
+		});
+		this.#parent.addTextSegmentList(wrappedSegments);
+		this.#parent = void 0;
+	}
 };
+/**
+* Abstract proxy class that delegates all IEntityBuilder operations to an underlying builder instance.
+*/
 var EntityBuilderProxy = class {
-  constructor(_entities) {
-    this._entities = _entities;
-  }
-  _entities;
-  get entities() {
-    return this._entities;
-  }
-  addText(...args) {
-    this._entities.addText(...args);
-    return this;
-  }
-  addTextEntity(...args) {
-    this._entities.addTextEntity(...args);
-    return this;
-  }
-  addTextEntities(...args) {
-    this._entities.addTextEntities(...args);
-    return this;
-  }
-  addTextSegmentList(...args) {
-    this._entities.addTextSegmentList(...args);
-    return this;
-  }
-  sliceInplace(...args) {
-    this._entities.sliceInplace(...args);
-    return this;
-  }
-  slice(...args) {
-    return this.fork().sliceInplace(...args);
-  }
-  trim() {
-    this._entities.trim();
-    return this;
-  }
-  trimStart() {
-    this._entities.trimStart();
-    return this;
-  }
-  trimEnd() {
-    this._entities.trimEnd();
-    return this;
-  }
-  sortEntities() {
-    this._entities.sortEntities();
-    return this;
-  }
-  clone() {
-    const newInstance = Object.create(this.constructor.prototype);
-    newInstance._entities.clone();
-    return newInstance;
-  }
-  fork() {
-    return this._entities.fork();
-  }
-  merge(...args) {
-    this._entities.merge(...args);
-  }
-  buildTextPayload() {
-    return this._entities.buildTextPayload();
-  }
-  buildCaptionPayload() {
-    const { text, entities } = this.buildTextPayload();
-    return {
-      caption: text,
-      caption_entities: entities
-    };
-  }
-  buildInlinePayload() {
-    const { text, entities, link_preview_options } = this.buildTextPayload();
-    return {
-      message_text: text,
-      entities,
-      link_preview_options
-    };
-  }
+	_entities;
+	constructor(_entities) {
+		this._entities = _entities;
+	}
+	get entities() {
+		return this._entities;
+	}
+	addText(...args) {
+		this._entities.addText(...args);
+		return this;
+	}
+	addTextEntity(...args) {
+		this._entities.addTextEntity(...args);
+		return this;
+	}
+	addTextEntities(...args) {
+		this._entities.addTextEntities(...args);
+		return this;
+	}
+	addTextSegmentList(...args) {
+		this._entities.addTextSegmentList(...args);
+		return this;
+	}
+	sliceInplace(...args) {
+		this._entities.sliceInplace(...args);
+		return this;
+	}
+	slice(...args) {
+		return this.fork().sliceInplace(...args);
+	}
+	trim() {
+		this._entities.trim();
+		return this;
+	}
+	trimStart() {
+		this._entities.trimStart();
+		return this;
+	}
+	trimEnd() {
+		this._entities.trimEnd();
+		return this;
+	}
+	sortEntities() {
+		this._entities.sortEntities();
+		return this;
+	}
+	clone() {
+		const newInstance = Object.create(this.constructor.prototype);
+		newInstance._entities.clone();
+		return newInstance;
+	}
+	fork() {
+		return this._entities.fork();
+	}
+	merge(...args) {
+		this._entities.merge(...args);
+	}
+	buildTextPayload() {
+		return this._entities.buildTextPayload();
+	}
+	buildCaptionPayload() {
+		const { text, entities } = this.buildTextPayload();
+		return {
+			caption: text,
+			caption_entities: entities
+		};
+	}
+	buildInlinePayload() {
+		const { text, entities, link_preview_options } = this.buildTextPayload();
+		return {
+			message_text: text,
+			entities,
+			link_preview_options
+		};
+	}
 };
 function upperFirst(input) {
-  return input.slice(0, 1).toUpperCase() + input.slice(1);
+	return input.slice(0, 1).toUpperCase() + input.slice(1);
 }
+/**
+* Escapes a string to be used as a valid tag by removing or replacing invalid characters.
+*/
 function escapeTag(input) {
-  return input.replaceAll(/["'′]/g, "").split(/[^\p{L}\p{N}_]/gu).map((s) => upperFirst(s)).join("");
+	return input.replaceAll(/["'′]/g, "").split(/[^\p{L}\p{N}_]/gu).map((s) => upperFirst(s)).join("");
 }
-var SymbolMessageComposer = /* @__PURE__ */ Symbol("MessageComposer");
+const SymbolMessageComposer = Symbol("MessageComposer");
+/**
+* A high-level composer that wraps an IEntityBuilder and provides additional features like tags and link preview options.
+*/
 var MessageComposer = class extends EntityBuilderProxy {
-  [SymbolMessageComposer] = true;
-  #upperTags = /* @__PURE__ */ new Set();
-  #tags = [];
-  /**
-   * Options for link preview generation.
-   */
-  linkPreviewOptions;
-  constructor(entities) {
-    if (entities && SymbolMessageComposer in entities) {
-      throw new Error("Cannot nest MessageComposer inside MessageComposer");
-    }
-    super(entities ?? new EntityBuilder());
-  }
-  /**
-   * Gets the current list of tags.
-   */
-  get tags() {
-    return [...this.#tags];
-  }
-  /**
-   * Adds one or more tags, escaping them and avoiding duplicates.
-   */
-  addTags(...tags) {
-    for (let tag of tags) {
-      tag = escapeTag(tag);
-      const upperTag = tag.toUpperCase();
-      if (this.#upperTags.has(upperTag)) {
-        continue;
-      }
-      this.#upperTags.add(upperTag);
-      this.#tags.push(tag);
-    }
-    return this;
-  }
-  buildTextPayload() {
-    const entities = this.entities.clone();
-    entities.trimEnd().addText("\n\n");
-    for (const tag of this.tags) {
-      entities.addTextEntity(`#${tag}`, { type: "hashtag" }).addText(" ");
-    }
-    entities.trimEnd();
-    return {
-      ...entities.buildTextPayload(),
-      link_preview_options: this.linkPreviewOptions
-    };
-  }
-};
-export {
-  EntityBuilder,
-  EntityBuilderProxy,
-  LazyEntityBuilder,
-  MessageComposer,
-  escapeTag
+	[SymbolMessageComposer] = true;
+	#upperTags = /* @__PURE__ */ new Set();
+	#tags = [];
+	/**
+	* Options for link preview generation.
+	*/
+	linkPreviewOptions;
+	constructor(entities) {
+		if (entities && SymbolMessageComposer in entities) throw new TypeError("Cannot nest MessageComposer inside MessageComposer");
+		super(entities ?? new EntityBuilder());
+	}
+	/**
+	* Gets the current list of tags.
+	*/
+	get tags() {
+		return [...this.#tags];
+	}
+	/**
+	* Adds one or more tags, escaping them and avoiding duplicates.
+	*/
+	addTags(...tags) {
+		for (let tag of tags) {
+			tag = escapeTag(tag);
+			const upperTag = tag.toUpperCase();
+			if (this.#upperTags.has(upperTag)) continue;
+			this.#upperTags.add(upperTag);
+			this.#tags.push(tag);
+		}
+		return this;
+	}
+	buildTextPayload() {
+		const entities = this.entities.clone();
+		entities.trimEnd().addText("\n\n");
+		for (const tag of this.tags) entities.addTextEntity(`#${tag}`, { type: "hashtag" }).addText(" ");
+		entities.trimEnd();
+		return {
+			...entities.buildTextPayload(),
+			link_preview_options: this.linkPreviewOptions
+		};
+	}
 };
+
+//#endregion
+export { EntityBuilder, EntityBuilderProxy, LazyEntityBuilder, MessageComposer, MessageComposer as default, escapeTag };
 //# sourceMappingURL=index.mjs.map