@snowluma/sdk 0.1.0

package/dist/messages/chain.d.ts

@@ -0,0 +1,100 @@
+import type { AnyMessageSegment, ContactSegment, ImageSegment, JsonObject, LocationSegment, MessageChainLike, MusicSegment, OutgoingMessage, RecordSegment, RequestOptions, ShareSegment, VideoSegment, XmlSegment } from '../types/index';
+export interface MessageChainSender {
+    sendGroupMessage(groupId: number, message: OutgoingMessage, options?: RequestOptions & {
+        autoEscape?: boolean;
+    }): Promise<unknown>;
+    sendPrivateMessage(userId: number, message: OutgoingMessage, options?: RequestOptions & {
+        autoEscape?: boolean;
+    }): Promise<unknown>;
+}
+/**
+ * Immutable fluent builder for OneBot message segments.
+ *
+ * The generic state tracks single-use segments such as reply(), so TypeScript
+ * can reject duplicate reply segments in normal chained calls.
+ */
+export declare class MessageChain<THasReply extends boolean = false> implements MessageChainLike {
+    private readonly items;
+    private readonly used;
+    private readonly replyStateBrand?;
+    private constructor();
+    static empty(): MessageChain<false>;
+    /** Number of segments currently in the chain. */
+    get length(): number;
+    /** True when no segment has been appended. */
+    get isEmpty(): boolean;
+    /** Appends a text segment. */
+    text(text?: string): MessageChain<THasReply>;
+    /** Appends a newline text segment. */
+    br(): MessageChain<THasReply>;
+    face(id: number | string): MessageChain<THasReply>;
+    /** Mentions a user or everyone in a group. */
+    at(qq: number | 'all', options?: {
+        name?: string;
+        uid?: string;
+    }): MessageChain<THasReply>;
+    atAll(): MessageChain<THasReply>;
+    /** Adds a reply segment. A chain can contain at most one reply segment. */
+    reply(this: MessageChain<false>, id: number | string): MessageChain<true>;
+    /** Appends an image segment from a URL, local path, file id, or base64 URI. */
+    image(file: string, options?: Omit<ImageSegment['data'], 'file'>): MessageChain<THasReply>;
+    record(file: string, options?: Omit<RecordSegment['data'], 'file'>): MessageChain<THasReply>;
+    video(file: string, options?: Omit<VideoSegment['data'], 'file'>): MessageChain<THasReply>;
+    json(data: string | JsonObject): MessageChain<THasReply>;
+    xml(data: string, options?: Omit<XmlSegment['data'], 'data'>): MessageChain<THasReply>;
+    poke(type: number | string, id?: number | string): MessageChain<THasReply>;
+    forward(id: string): MessageChain<THasReply>;
+    node(userId: number, nickname: string, content: OutgoingMessage): MessageChain<THasReply>;
+    share(options: ShareSegment['data']): MessageChain<THasReply>;
+    music(options: MusicSegment['data']): MessageChain<THasReply>;
+    location(options: LocationSegment['data']): MessageChain<THasReply>;
+    contact(type: ContactSegment['data']['type'], id: number | string): MessageChain<THasReply>;
+    raw<TType extends string, TData extends JsonObject>(type: TType, data: TData): MessageChain<THasReply>;
+    /** Appends another outgoing message while preserving single-use segment checks. */
+    append(messageInput: OutgoingMessage): MessageChain<THasReply>;
+    /** Returns a fresh segment array suitable for OneBot array message format. */
+    build(): AnyMessageSegment[];
+    toArray(): AnyMessageSegment[];
+    toSegments(): AnyMessageSegment[];
+    toJSON(): AnyMessageSegment[];
+    toString(): string;
+    /** Sends this chain to a group through a compatible SnowLuma client. */
+    sendToGroup(client: MessageChainSender, groupId: number, options?: RequestOptions & {
+        autoEscape?: boolean;
+    }): Promise<unknown>;
+    /** Sends this chain to a private chat through a compatible SnowLuma client. */
+    sendToPrivate(client: MessageChainSender, userId: number, options?: RequestOptions & {
+        autoEscape?: boolean;
+    }): Promise<unknown>;
+    [Symbol.iterator](): IterableIterator<AnyMessageSegment>;
+    private addFromSegment;
+    private addSegment;
+}
+export declare function chain(): MessageChain<false>;
+/** Starts a message chain with a text segment. */
+export declare function text(value?: string): MessageChain<false>;
+export declare function br(): MessageChain<false>;
+export declare function face(id: number | string): MessageChain<false>;
+export declare function at(qq: number | 'all', options?: {
+    name?: string;
+    uid?: string;
+}): MessageChain<false>;
+export declare function atAll(): MessageChain<false>;
+export declare function reply(id: number | string): MessageChain<true>;
+/** Starts a message chain with an image segment. */
+export declare function image(file: string, options?: Omit<ImageSegment['data'], 'file'>): MessageChain<false>;
+export declare function record(file: string, options?: Omit<RecordSegment['data'], 'file'>): MessageChain<false>;
+export declare function video(file: string, options?: Omit<VideoSegment['data'], 'file'>): MessageChain<false>;
+export declare function json(data: string | JsonObject): MessageChain<false>;
+export declare function xml(data: string, options?: Omit<XmlSegment['data'], 'data'>): MessageChain<false>;
+export declare function poke(type: number | string, id?: number | string): MessageChain<false>;
+export declare function forward(id: string): MessageChain<false>;
+export declare function node(userId: number, nickname: string, content: OutgoingMessage): MessageChain<false>;
+export declare function share(options: ShareSegment['data']): MessageChain<false>;
+export declare function music(options: MusicSegment['data']): MessageChain<false>;
+export declare function location(options: LocationSegment['data']): MessageChain<false>;
+export declare function contact(type: ContactSegment['data']['type'], id: number | string): MessageChain<false>;
+export declare function raw<TType extends string, TData extends JsonObject>(type: TType, data: TData): MessageChain<false>;
+/** Normalizes a string, segment, segment array, or MessageChain into OneBot output. */
+export declare function normalizeMessage(input: OutgoingMessage): string | AnyMessageSegment[];
+//# sourceMappingURL=chain.d.ts.map

package/dist/messages/chain.d.ts.map

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

package/dist/messages/chain.js

@@ -0,0 +1,220 @@
+import { segments } from './segments';
+import { segmentsToCQString } from './cq-format';
+const SINGLE_USE_TYPES = new Set(['reply']);
+/**
+ * Immutable fluent builder for OneBot message segments.
+ *
+ * The generic state tracks single-use segments such as reply(), so TypeScript
+ * can reject duplicate reply segments in normal chained calls.
+ */
+export class MessageChain {
+    items;
+    used;
+    replyStateBrand;
+    constructor(items = [], used = new Set()) {
+        this.items = items;
+        this.used = used;
+    }
+    static empty() {
+        return new MessageChain();
+    }
+    /** Number of segments currently in the chain. */
+    get length() {
+        return this.items.length;
+    }
+    /** True when no segment has been appended. */
+    get isEmpty() {
+        return this.items.length === 0;
+    }
+    /** Appends a text segment. */
+    text(text = '') {
+        return this.addSegment(segments.text(text));
+    }
+    /** Appends a newline text segment. */
+    br() {
+        return this.text('\n');
+    }
+    face(id) {
+        return this.addSegment(segments.face(id));
+    }
+    /** Mentions a user or everyone in a group. */
+    at(qq, options = {}) {
+        return this.addSegment(segments.at(qq, options));
+    }
+    atAll() {
+        return this.at('all');
+    }
+    /** Adds a reply segment. A chain can contain at most one reply segment. */
+    reply(id) {
+        return this.addSegment(segments.reply(id), 'reply');
+    }
+    /** Appends an image segment from a URL, local path, file id, or base64 URI. */
+    image(file, options = {}) {
+        return this.addSegment(segments.image(file, options));
+    }
+    record(file, options = {}) {
+        return this.addSegment(segments.record(file, options));
+    }
+    video(file, options = {}) {
+        return this.addSegment(segments.video(file, options));
+    }
+    json(data) {
+        return this.addSegment(segments.json(data));
+    }
+    xml(data, options = {}) {
+        return this.addSegment(segments.xml(data, options));
+    }
+    poke(type, id) {
+        return this.addSegment(segments.poke(type, id));
+    }
+    forward(id) {
+        return this.addSegment(segments.forward(id));
+    }
+    node(userId, nickname, content) {
+        return this.addSegment(segments.node(userId, nickname, content));
+    }
+    share(options) {
+        return this.addSegment(segments.share(options));
+    }
+    music(options) {
+        return this.addSegment(segments.music(options));
+    }
+    location(options) {
+        return this.addSegment(segments.location(options));
+    }
+    contact(type, id) {
+        return this.addSegment(segments.contact(type, id));
+    }
+    raw(type, data) {
+        return this.addSegment(segments.raw(type, data), type);
+    }
+    /** Appends another outgoing message while preserving single-use segment checks. */
+    append(messageInput) {
+        let next = this;
+        const normalized = normalizeMessage(messageInput);
+        if (typeof normalized === 'string') {
+            return next.text(normalized);
+        }
+        for (const segment of normalized) {
+            next = next.addFromSegment(segment);
+        }
+        return next;
+    }
+    /** Returns a fresh segment array suitable for OneBot array message format. */
+    build() {
+        return this.toSegments();
+    }
+    toArray() {
+        return this.toSegments();
+    }
+    toSegments() {
+        return [...this.items];
+    }
+    toJSON() {
+        return this.toSegments();
+    }
+    toString() {
+        return segmentsToCQString(this.items);
+    }
+    /** Sends this chain to a group through a compatible SnowLuma client. */
+    sendToGroup(client, groupId, options) {
+        return client.sendGroupMessage(groupId, this, options);
+    }
+    /** Sends this chain to a private chat through a compatible SnowLuma client. */
+    sendToPrivate(client, userId, options) {
+        return client.sendPrivateMessage(userId, this, options);
+    }
+    [Symbol.iterator]() {
+        return this.items[Symbol.iterator]();
+    }
+    addFromSegment(segment) {
+        return this.addSegment(segment, segment.type);
+    }
+    addSegment(segment, singleUseType) {
+        if (singleUseType && SINGLE_USE_TYPES.has(singleUseType) && this.used.has(singleUseType)) {
+            throw new Error(`Message segment "${singleUseType}" can only appear once in a chain`);
+        }
+        const nextUsed = new Set(this.used);
+        if (singleUseType && SINGLE_USE_TYPES.has(singleUseType)) {
+            nextUsed.add(singleUseType);
+        }
+        return new MessageChain([...this.items, segment], nextUsed);
+    }
+}
+export function chain() {
+    return MessageChain.empty();
+}
+/** Starts a message chain with a text segment. */
+export function text(value = '') {
+    return chain().text(value);
+}
+export function br() {
+    return chain().br();
+}
+export function face(id) {
+    return chain().face(id);
+}
+export function at(qq, options = {}) {
+    return chain().at(qq, options);
+}
+export function atAll() {
+    return chain().atAll();
+}
+export function reply(id) {
+    return chain().reply(id);
+}
+/** Starts a message chain with an image segment. */
+export function image(file, options = {}) {
+    return chain().image(file, options);
+}
+export function record(file, options = {}) {
+    return chain().record(file, options);
+}
+export function video(file, options = {}) {
+    return chain().video(file, options);
+}
+export function json(data) {
+    return chain().json(data);
+}
+export function xml(data, options = {}) {
+    return chain().xml(data, options);
+}
+export function poke(type, id) {
+    return chain().poke(type, id);
+}
+export function forward(id) {
+    return chain().forward(id);
+}
+export function node(userId, nickname, content) {
+    return chain().node(userId, nickname, content);
+}
+export function share(options) {
+    return chain().share(options);
+}
+export function music(options) {
+    return chain().music(options);
+}
+export function location(options) {
+    return chain().location(options);
+}
+export function contact(type, id) {
+    return chain().contact(type, id);
+}
+export function raw(type, data) {
+    return chain().raw(type, data);
+}
+/** Normalizes a string, segment, segment array, or MessageChain into OneBot output. */
+export function normalizeMessage(input) {
+    if (typeof input === 'string')
+        return input;
+    if (isMessageChainLike(input))
+        return input.toSegments();
+    return Array.isArray(input) ? input : [input];
+}
+function isMessageChainLike(value) {
+    return typeof value === 'object'
+        && value !== null
+        && 'toSegments' in value
+        && typeof value.toSegments === 'function';
+}
+//# sourceMappingURL=chain.js.map

package/dist/messages/chain.js.map

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

package/dist/messages/cq-format.d.ts

@@ -0,0 +1,5 @@
+import type { KnownMessageSegment, MessageSegment } from '../types/index';
+export declare function escapeCqText(text: string): string;
+export declare function escapeCqParam(text: string): string;
+export declare function segmentsToCQString(segments: Array<KnownMessageSegment | MessageSegment>): string;
+//# sourceMappingURL=cq-format.d.ts.map

package/dist/messages/cq-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cq-format.d.ts","sourceRoot":"","sources":["../../src/messages/cq-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE1E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,mBAAmB,GAAG,cAAc,CAAC,GAAG,MAAM,CAEhG"}

package/dist/messages/cq-format.js

@@ -0,0 +1,23 @@
+export function escapeCqText(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/\[/g, '[')
+        .replace(/\]/g, ']');
+}
+export function escapeCqParam(text) {
+    return escapeCqText(text).replace(/,/g, ',');
+}
+export function segmentsToCQString(segments) {
+    return segments.map(segmentToCq).join('');
+}
+function segmentToCq(segment) {
+    if (segment.type === 'text') {
+        return escapeCqText(String(segment.data.text ?? ''));
+    }
+    const params = Object.entries(segment.data)
+        .filter(([, value]) => value !== undefined && value !== null)
+        .map(([key, value]) => `${key}=${escapeCqParam(String(value))}`)
+        .join(',');
+    return params ? `[CQ:${segment.type},${params}]` : `[CQ:${segment.type}]`;
+}
+//# sourceMappingURL=cq-format.js.map

package/dist/messages/cq-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cq-format.js","sourceRoot":"","sources":["../../src/messages/cq-format.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI;SACR,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAqD;IACtF,OAAO,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,WAAW,CAAC,OAA6C;IAChE,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;SACxC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;SAC5D,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;SAC/D,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO,MAAM,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,GAAG,CAAC;AAC5E,CAAC"}

package/dist/messages/cq.d.ts

@@ -0,0 +1,5 @@
+import type { AnyMessageSegment, OutgoingMessage } from '../types/index';
+export declare function toCQString(input: OutgoingMessage): string;
+export declare function fromCQString(input: string): import("./chain").MessageChain<false>;
+export declare function parseSegments(input: string): AnyMessageSegment[];
+//# sourceMappingURL=cq.d.ts.map

package/dist/messages/cq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cq.d.ts","sourceRoot":"","sources":["../../src/messages/cq.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAIzE,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAMzD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,yCAsBzC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAEhE"}

package/dist/messages/cq.js

@@ -0,0 +1,98 @@
+import { normalizeMessage, chain } from './chain';
+import { escapeCqText, segmentsToCQString } from './cq-format';
+import { segments } from './segments';
+const CQ_REGEX = /\[CQ:([a-zA-Z0-9_.-]+)(?:,([^\]]*))?\]/g;
+export function toCQString(input) {
+    if (typeof input === 'string')
+        return escapeCqText(input);
+    const normalized = normalizeMessage(input);
+    return typeof normalized === 'string'
+        ? escapeCqText(normalized)
+        : segmentsToCQString(normalized);
+}
+export function fromCQString(input) {
+    let current = chain();
+    let lastIndex = 0;
+    for (const match of input.matchAll(CQ_REGEX)) {
+        const index = match.index ?? 0;
+        if (index > lastIndex) {
+            const textValue = cqUnescape(input.slice(lastIndex, index));
+            if (textValue)
+                current = current.text(textValue);
+        }
+        const segment = segmentFromCq(match[1] ?? '', parseCQParams(match[2] ?? ''));
+        if (segment)
+            current = current.append(segment);
+        lastIndex = index + match[0].length;
+    }
+    if (lastIndex < input.length) {
+        const textValue = cqUnescape(input.slice(lastIndex));
+        if (textValue)
+            current = current.text(textValue);
+    }
+    return current;
+}
+export function parseSegments(input) {
+    return fromCQString(input).toSegments();
+}
+function parseCQParams(raw) {
+    const params = {};
+    if (!raw)
+        return params;
+    for (const pair of raw.split(',')) {
+        const eq = pair.indexOf('=');
+        if (eq <= 0)
+            continue;
+        params[pair.slice(0, eq)] = cqUnescapeParam(pair.slice(eq + 1));
+    }
+    return params;
+}
+function cqUnescape(text) {
+    return text
+        .replace(/&#91;/g, '[')
+        .replace(/&#93;/g, ']')
+        .replace(/&amp;/g, '&');
+}
+function cqUnescapeParam(text) {
+    return cqUnescape(text).replace(/&#44;/g, ',');
+}
+function segmentFromCq(type, data) {
+    switch (type) {
+        case 'text':
+            return segments.text(data.text ?? '');
+        case 'face':
+            return segments.face(data.id ?? '0');
+        case 'at':
+            if (data.qq === 'all')
+                return segments.at('all');
+            {
+                const qq = Number(data.qq);
+                return Number.isFinite(qq) && qq > 0
+                    ? segments.at(qq, { name: data.name, uid: data.uid })
+                    : segments.raw(type, data);
+            }
+        case 'reply':
+            return segments.reply(data.id ?? '0');
+        case 'image':
+            return segments.image(data.file ?? data.url ?? '', {
+                url: data.url,
+                type: data.type === 'flash' ? 'flash' : undefined,
+                summary: data.summary,
+            });
+        case 'record':
+            return segments.record(data.file ?? data.url ?? '', { url: data.url });
+        case 'video':
+            return segments.video(data.file ?? data.url ?? '', { url: data.url, thumb: data.thumb });
+        case 'json':
+            return segments.json(data.data ?? '');
+        case 'xml':
+            return segments.xml(data.data ?? '', { id: data.id });
+        case 'poke':
+            return segments.poke(data.type ?? data.id ?? '0', data.id);
+        case 'forward':
+            return segments.forward(data.id ?? data.res_id ?? data.forward_id ?? '');
+        default:
+            return segments.raw(type, data);
+    }
+}
+//# sourceMappingURL=cq.js.map

package/dist/messages/cq.js.map

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

package/dist/messages/index.d.ts

@@ -0,0 +1,29 @@
+import { segments } from './segments';
+export { MessageChain } from './chain';
+export { at, atAll, br, chain, contact, face, forward, image, json, location, music, node, normalizeMessage, poke, raw, record, reply, share, text, video, xml, } from './chain';
+export { escapeCqParam, escapeCqText } from './cq-format';
+export { fromCQString, parseSegments, toCQString } from './cq';
+export { segments };
+export declare const message: {
+    text(text: string): import("..").TextSegment;
+    face(id: number | string): import("..").FaceSegment;
+    at(qq: number | "all", options?: {
+        name?: string;
+        uid?: string;
+    }): import("..").AtSegment;
+    reply(id: number | string): import("..").ReplySegment;
+    image(file: string, options?: Omit<import("..").ImageSegment["data"], "file">): import("..").ImageSegment;
+    record(file: string, options?: Omit<import("..").RecordSegment["data"], "file">): import("..").RecordSegment;
+    video(file: string, options?: Omit<import("..").VideoSegment["data"], "file">): import("..").VideoSegment;
+    json(data: string | import("..").JsonObject): import("..").JsonSegment;
+    xml(data: string, options?: Omit<import("..").XmlSegment["data"], "data">): import("..").XmlSegment;
+    poke(type: number | string, id?: number | string): import("..").PokeSegment;
+    forward(id: string): import("..").ForwardSegment;
+    node(userId: number, nickname: string, content: import("..").OutgoingMessage): import("..").NodeSegment;
+    share(options: import("..").ShareSegment["data"]): import("..").ShareSegment;
+    music(options: import("..").MusicSegment["data"]): import("..").MusicSegment;
+    location(options: import("..").LocationSegment["data"]): import("..").LocationSegment;
+    contact(type: import("..").ContactSegment["data"]["type"], id: number | string): import("..").ContactSegment;
+    raw<TType extends string, TData extends import("..").JsonObject>(type: TType, data: TData): import("..").MessageSegment<TType, TData>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/messages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EACL,EAAE,EACF,KAAK,EACL,EAAE,EACF,KAAK,EACL,OAAO,EACP,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,gBAAgB,EAChB,IAAI,EACJ,GAAG,EACH,MAAM,EACN,KAAK,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,GAAG,GACJ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,eAAO,MAAM,OAAO;;;;YAGwO,CAAC;WAAa,CAAC;;;;;;;;;;;;;;kBAAkvD,mCAAuB;;CADnhE,CAAC"}

package/dist/messages/index.js

@@ -0,0 +1,10 @@
+import { segments } from './segments';
+export { MessageChain } from './chain';
+export { at, atAll, br, chain, contact, face, forward, image, json, location, music, node, normalizeMessage, poke, raw, record, reply, share, text, video, xml, } from './chain';
+export { escapeCqParam, escapeCqText } from './cq-format';
+export { fromCQString, parseSegments, toCQString } from './cq';
+export { segments };
+export const message = {
+    ...segments,
+};
+//# sourceMappingURL=index.js.map

package/dist/messages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EACL,EAAE,EACF,KAAK,EACL,EAAE,EACF,KAAK,EACL,OAAO,EACP,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,gBAAgB,EAChB,IAAI,EACJ,GAAG,EACH,MAAM,EACN,KAAK,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,GAAG,GACJ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,GAAG,QAAQ;CACZ,CAAC"}

package/dist/messages/segments.d.ts

@@ -0,0 +1,24 @@
+import type { AtSegment, ContactSegment, FaceSegment, ForwardSegment, ImageSegment, JsonObject, JsonSegment, LocationSegment, MessageSegment, MusicSegment, NodeSegment, OutgoingMessage, PokeSegment, RecordSegment, ReplySegment, ShareSegment, TextSegment, VideoSegment, XmlSegment } from '../types/index';
+export declare const segments: {
+    text(text: string): TextSegment;
+    face(id: number | string): FaceSegment;
+    at(qq: number | "all", options?: {
+        name?: string;
+        uid?: string;
+    }): AtSegment;
+    reply(id: number | string): ReplySegment;
+    image(file: string, options?: Omit<ImageSegment["data"], "file">): ImageSegment;
+    record(file: string, options?: Omit<RecordSegment["data"], "file">): RecordSegment;
+    video(file: string, options?: Omit<VideoSegment["data"], "file">): VideoSegment;
+    json(data: string | JsonObject): JsonSegment;
+    xml(data: string, options?: Omit<XmlSegment["data"], "data">): XmlSegment;
+    poke(type: number | string, id?: number | string): PokeSegment;
+    forward(id: string): ForwardSegment;
+    node(userId: number, nickname: string, content: OutgoingMessage): NodeSegment;
+    share(options: ShareSegment["data"]): ShareSegment;
+    music(options: MusicSegment["data"]): MusicSegment;
+    location(options: LocationSegment["data"]): LocationSegment;
+    contact(type: ContactSegment["data"]["type"], id: number | string): ContactSegment;
+    raw<TType extends string, TData extends JsonObject>(type: TType, data: TData): MessageSegment<TType, TData>;
+};
+//# sourceMappingURL=segments.d.ts.map

package/dist/messages/segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/messages/segments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,WAAW,EACX,cAAc,EACd,YAAY,EACZ,UAAU,EACV,WAAW,EACX,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACX,MAAM,gBAAgB,CAAC;AAMxB,eAAO,MAAM,QAAQ;eACR,MAAM,GAAG,WAAW;aAItB,MAAM,GAAG,MAAM,GAAG,WAAW;WAI/B,MAAM,GAAG,KAAK,YAAW;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAQ,SAAS;cAOtE,MAAM,GAAG,MAAM,GAAG,YAAY;gBAI5B,MAAM,YAAW,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAQ,YAAY;iBAItE,MAAM,YAAW,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAQ,aAAa;gBAI1E,MAAM,YAAW,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAQ,YAAY;eAIxE,MAAM,GAAG,UAAU,GAAG,WAAW;cAIlC,MAAM,YAAW,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAQ,UAAU;eAIlE,MAAM,GAAG,MAAM,OAAO,MAAM,GAAG,MAAM,GAAG,WAAW;gBAMlD,MAAM,GAAG,cAAc;iBAItB,MAAM,YAAY,MAAM,WAAW,eAAe,GAAG,WAAW;mBAI9D,YAAY,CAAC,MAAM,CAAC,GAAG,YAAY;mBAInC,YAAY,CAAC,MAAM,CAAC,GAAG,YAAY;sBAIhC,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe;kBAI7C,cAAc,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,GAAG,cAAc;QAI9E,KAAK,SAAS,MAAM,EAAE,KAAK,SAAS,UAAU,QAAQ,KAAK,QAAQ,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC;CAG5G,CAAC"}

package/dist/messages/segments.js

@@ -0,0 +1,65 @@
+function seg(type, data) {
+    return { type, data };
+}
+export const segments = {
+    text(text) {
+        return seg('text', { text });
+    },
+    face(id) {
+        return seg('face', { id: String(id) });
+    },
+    at(qq, options = {}) {
+        const data = { qq: String(qq) };
+        if (options.name)
+            data.name = options.name;
+        if (options.uid)
+            data.uid = options.uid;
+        return seg('at', data);
+    },
+    reply(id) {
+        return seg('reply', { id: String(id) });
+    },
+    image(file, options = {}) {
+        return seg('image', { file, ...options });
+    },
+    record(file, options = {}) {
+        return seg('record', { file, ...options });
+    },
+    video(file, options = {}) {
+        return seg('video', { file, ...options });
+    },
+    json(data) {
+        return seg('json', { data: typeof data === 'string' ? data : JSON.stringify(data) });
+    },
+    xml(data, options = {}) {
+        return seg('xml', { data, ...options });
+    },
+    poke(type, id) {
+        const data = { type };
+        if (id !== undefined)
+            data.id = id;
+        return seg('poke', data);
+    },
+    forward(id) {
+        return seg('forward', { id, res_id: id, forward_id: id });
+    },
+    node(userId, nickname, content) {
+        return seg('node', { user_id: userId, nickname, content });
+    },
+    share(options) {
+        return seg('share', options);
+    },
+    music(options) {
+        return seg('music', options);
+    },
+    location(options) {
+        return seg('location', options);
+    },
+    contact(type, id) {
+        return seg('contact', { type, id });
+    },
+    raw(type, data) {
+        return seg(type, data);
+    },
+};
+//# sourceMappingURL=segments.js.map