@sunafterrainwm/telegram-entities-builder 0.1.4 → 0.2.0

package/dist/index.cjs

@@ -0,0 +1,365 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+
+//#region src/index.ts
+var src_exports = /* @__PURE__ */ __exportAll({
+	EntityBuilder: () => EntityBuilder,
+	EntityBuilderProxy: () => EntityBuilderProxy,
+	LazyEntityBuilder: () => LazyEntityBuilder,
+	MessageComposer: () => MessageComposer,
+	default: () => MessageComposer,
+	escapeTag: () => escapeTag
+});
+/**
+* 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;
+	}
+};
+/**
+* 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 {
+	_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);
+}
+/**
+* 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("");
+}
+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 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
+//#region src/cjs.cts
+module.exports = Object.assign(MessageComposer, src_exports);
+
+//#endregion
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["#text","#entities","#parent","#segments","#tags","#upperTags","Default","Named"],"sources":["../src/index.ts","../src/cjs.cts"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,247 @@
+import * as TT from "@grammyjs/types";
+
+//#region \0rolldown/runtime.js
+declare namespace index_d_exports {
+  export { AnyDraftEntity, EntityBuilder, EntityBuilderProxy, IEntityBuilder, IEntityBuilderBase, LazyEntityBuilder, MessageComposer, PartialEntity, TextSegment, MessageComposer as default, escapeTag };
+}
+type Telegram = TT.ApiMethods<never>;
+type ApiParameters<T extends keyof Telegram> = Parameters<Telegram[T]>[0];
+/**
+ * Represents a Telegram MessageEntity without the offset and length properties.
+ */
+type PartialEntity<E extends TT.MessageEntity = TT.MessageEntity> = Omit<E, 'offset' | 'length'>;
+/**
+ * Represents any draft entity that can be used before calculating the final offset and length.
+ */
+type AnyDraftEntity = PartialEntity<TT.MessageEntity.CommonMessageEntity> | PartialEntity<TT.MessageEntity.CustomEmojiMessageEntity> | PartialEntity<TT.MessageEntity.PreMessageEntity> | PartialEntity<TT.MessageEntity.TextLinkMessageEntity> | PartialEntity<TT.MessageEntity.TextMentionMessageEntity>;
+/**
+ * Represents a segment of text which may contain one or multiple entities.
+ */
+type TextSegment = TextSegment.SingleTextSegment | TextSegment.MultiTextSegment;
+/**
+ * Namespace for TextSegment types.
+ */
+declare namespace TextSegment {
+  interface SingleTextSegment {
+    text: string;
+    entity?: AnyDraftEntity;
+    entities?: never;
+  }
+  interface MultiTextSegment {
+    text: string;
+    entity?: never;
+    entities: AnyDraftEntity[];
+  }
+}
+type PartialRequired<T, REQUIRED extends keyof T, OPTIONAL extends keyof T> = Required<Pick<T, REQUIRED>> & Pick<T, OPTIONAL>;
+/**
+ * Base interface for entity builders, providing fundamental operations for appending text and managing builder state.
+ */
+interface IEntityBuilderBase {
+  /**
+   * Appends plain text.
+   */
+  addText(text: string): this;
+  /**
+   * Appends text with a single entity.
+   */
+  addTextEntity(text: string, entity: AnyDraftEntity): this;
+  /**
+   * Appends text with multiple entities.
+   */
+  addTextEntities(text: string, entities: AnyDraftEntity[]): this;
+  /**
+   * Appends a list of text segments.
+   */
+  addTextSegmentList(segments: TextSegment[]): this;
+  /**
+   * Creates a deep clone of this builder.
+   */
+  clone(): IEntityBuilderBase;
+  /**
+   * Creates a child builder that forks from this instance.
+   */
+  fork(): IEntityBuilderBase;
+  /**
+   * Merges a forked builder back into its parent.
+   */
+  merge(wrapperEntities?: AnyDraftEntity[]): void;
+}
+/**
+ * Advanced entity builder interface supporting string manipulation, entity sorting, and payload generation.
+ */
+interface IEntityBuilder extends IEntityBuilderBase {
+  /**
+   * Trims or slices the string in-place, and automatically recalculates, filters, or truncates the affected entities.
+   */
+  sliceInplace(start?: number, end?: number): this;
+  /**
+   * Returns a new sliced instance.
+   */
+  slice(start?: number, end?: number): IEntityBuilder;
+  /**
+   * Removes leading whitespace in-place.
+   */
+  trimStart(): this;
+  /**
+   * Removes trailing whitespace in-place.
+   */
+  trimEnd(): this;
+  /**
+   * Removes leading and trailing whitespace in-place.
+   */
+  trim(): this;
+  /**
+   * Sorts the entities based on their offset and length.
+   */
+  sortEntities(): this;
+  /**
+   * Builds the payload for sending a text message.
+   */
+  buildTextPayload(): PartialRequired<ApiParameters<'sendMessage'>, 'text', 'entities' | 'link_preview_options'>;
+  /**
+   * Builds the payload for sending a document with a caption.
+   */
+  buildCaptionPayload(): PartialRequired<ApiParameters<'sendDocument'>, 'caption', 'caption_entities'>;
+  /**
+   * Builds the payload for inline query results.
+   */
+  buildInlinePayload(): PartialRequired<TT.InputTextMessageContent, 'message_text', 'entities' | 'link_preview_options'>;
+  clone(): IEntityBuilder;
+  fork(): IEntityBuilder;
+}
+/**
+ * Main implementation of IEntityBuilder that eagerly evaluates and stores entities.
+ */
+declare class EntityBuilder implements IEntityBuilder {
+  #private;
+  addText(text: string): this;
+  addTextEntity(text: string, entity: AnyDraftEntity): this;
+  addTextEntities(text: string, entities: AnyDraftEntity[]): this;
+  addTextSegmentList(segments: TextSegment[]): this;
+  buildTextPayload(): {
+    text: string;
+    entities: TT.MessageEntity[];
+  };
+  buildCaptionPayload(): {
+    caption: string;
+    caption_entities: TT.MessageEntity[];
+  };
+  buildInlinePayload(): {
+    message_text: string;
+    entities: TT.MessageEntity[];
+  };
+  sortEntities(): this;
+  sliceInplace(start?: number, end?: number): this;
+  slice(start?: number, end?: number): EntityBuilder;
+  trimStart(): this;
+  trimEnd(): this;
+  trim(): this;
+  clone(): EntityBuilder;
+  fork(): EntityBuilder;
+  /**
+   * Merges a payload text and its entities into this builder, optionally wrapping them with additional entities.
+   */
+  mergePayload(text: string, entities: TT.MessageEntity[], wrappers?: AnyDraftEntity[]): void;
+  merge(wrapperEntities?: AnyDraftEntity[]): void;
+}
+/**
+ * A lazy implementation of IEntityBuilderBase that stores segments and flattens them into an EntityBuilder only when needed.
+ */
+declare class LazyEntityBuilder implements IEntityBuilderBase {
+  #private;
+  /**
+   * Flattens the lazy segments into a new EntityBuilder instance.
+   */
+  flatten(): EntityBuilder;
+  addText(text: string): this;
+  addTextEntity(text: string, entity: AnyDraftEntity): this;
+  addTextEntities(text: string, entities: AnyDraftEntity[]): this;
+  addTextSegmentList(segments: TextSegment[]): this;
+  clone(): LazyEntityBuilder;
+  fork(): LazyEntityBuilder;
+  merge(wrapperEntities?: AnyDraftEntity[]): void;
+}
+/**
+ * Abstract proxy class that delegates all IEntityBuilder operations to an underlying builder instance.
+ */
+declare abstract class EntityBuilderProxy<THIS extends IEntityBuilder = IEntityBuilder> implements IEntityBuilder {
+  protected _entities: IEntityBuilder;
+  protected constructor(_entities: IEntityBuilder);
+  get entities(): IEntityBuilder;
+  addText(...args: Parameters<IEntityBuilder['addText']>): this;
+  addTextEntity(...args: Parameters<IEntityBuilder['addTextEntity']>): this;
+  addTextEntities(...args: Parameters<IEntityBuilder['addTextEntities']>): this;
+  addTextSegmentList(...args: Parameters<IEntityBuilder['addTextSegmentList']>): this;
+  sliceInplace(...args: Parameters<IEntityBuilder['sliceInplace']>): this;
+  slice(...args: Parameters<IEntityBuilder['slice']>): THIS;
+  trim(): this;
+  trimStart(): this;
+  trimEnd(): this;
+  sortEntities(): this;
+  clone(): THIS;
+  fork(): IEntityBuilder;
+  merge(...args: Parameters<IEntityBuilder['merge']>): void;
+  buildTextPayload(): PartialRequired<{
+    business_connection_id?: string;
+    chat_id: number | string;
+    message_thread_id?: number;
+    text: string;
+    parse_mode?: TT.ParseMode;
+    entities?: TT.MessageEntity[];
+    link_preview_options?: TT.LinkPreviewOptions;
+    disable_notification?: boolean;
+    protect_content?: boolean;
+    allow_paid_broadcast?: boolean;
+    message_effect_id?: string;
+    reply_parameters?: TT.ReplyParameters;
+    reply_markup?: TT.InlineKeyboardMarkup | TT.ReplyKeyboardMarkup | TT.ReplyKeyboardRemove | TT.ForceReply;
+    reply_to_message_id?: number;
+  }, "text", "entities" | "link_preview_options">;
+  buildCaptionPayload(): {
+    caption: string;
+    caption_entities: TT.MessageEntity[] | undefined;
+  };
+  buildInlinePayload(): {
+    message_text: string;
+    entities: TT.MessageEntity[] | undefined;
+    link_preview_options: TT.LinkPreviewOptions | undefined;
+  };
+}
+/**
+ * Escapes a string to be used as a valid tag by removing or replacing invalid characters.
+ */
+declare function escapeTag(input: string): string;
+declare const SymbolMessageComposer: unique symbol;
+/**
+ * A high-level composer that wraps an IEntityBuilder and provides additional features like tags and link preview options.
+ */
+declare class MessageComposer extends EntityBuilderProxy<MessageComposer> {
+  #private;
+  protected [SymbolMessageComposer]: true;
+  /**
+   * Options for link preview generation.
+   */
+  linkPreviewOptions?: TT.LinkPreviewOptions;
+  constructor(entities?: IEntityBuilder & {
+    [SymbolMessageComposer]?: never;
+  });
+  /**
+   * Gets the current list of tags.
+   */
+  get tags(): string[];
+  /**
+   * Adds one or more tags, escaping them and avoiding duplicates.
+   */
+  addTags(...tags: string[]): this;
+  buildTextPayload(): {
+    link_preview_options: TT.LinkPreviewOptions | undefined;
+    text: string;
+    entities?: TT.MessageEntity[] | undefined;
+  };
+}
+//#endregion
+//#region src/cjs.d.cts
+declare const _default: typeof MessageComposer & typeof index_d_exports;
+export = _default;
+//# sourceMappingURL=index.d.cts.map