@snowluma/sdk 0.1.0

package/dist/errors.js

@@ -0,0 +1,71 @@
+/** Base error for every exception intentionally thrown by the SnowLuma SDK. */
+export class SnowLumaError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'SnowLumaError';
+    }
+}
+/** Transport-layer failures before a valid OneBot API response is available. */
+export class SnowLumaTransportError extends SnowLumaError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'SnowLumaTransportError';
+    }
+}
+/** The request was cancelled by the caller's AbortSignal. */
+export class SnowLumaAbortError extends SnowLumaTransportError {
+    constructor(message = 'SnowLuma request aborted', options) {
+        super(message, options);
+        this.name = 'SnowLumaAbortError';
+    }
+}
+/** The request exceeded the configured timeout. */
+export class SnowLumaTimeoutError extends SnowLumaTransportError {
+    timeoutMs;
+    constructor(message, timeoutMs, options) {
+        super(message, options);
+        this.name = 'SnowLumaTimeoutError';
+        this.timeoutMs = timeoutMs;
+    }
+}
+/** The SDK could not establish or keep a connection to SnowLuma. */
+export class SnowLumaConnectionError extends SnowLumaTransportError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'SnowLumaConnectionError';
+    }
+}
+/** SnowLuma returned a payload that could not be parsed as the expected protocol shape. */
+export class SnowLumaParseError extends SnowLumaTransportError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'SnowLumaParseError';
+    }
+}
+/** A OneBot API response with status failed or a non-zero retcode. */
+export class SnowLumaApiError extends SnowLumaError {
+    response;
+    retcode;
+    wording;
+    constructor(response) {
+        super(response.wording || `SnowLuma API failed with retcode ${response.retcode}`);
+        this.name = 'SnowLumaApiError';
+        this.response = response;
+        this.retcode = response.retcode;
+        this.wording = response.wording;
+    }
+}
+/** Authentication or authorization failure returned by SnowLuma. */
+export class SnowLumaAuthError extends SnowLumaApiError {
+    constructor(response) {
+        super(response);
+        this.name = 'SnowLumaAuthError';
+    }
+}
+export function createSnowLumaApiError(response) {
+    return isAuthFailure(response) ? new SnowLumaAuthError(response) : new SnowLumaApiError(response);
+}
+function isAuthFailure(response) {
+    return response.retcode === 1401 || response.retcode === 401 || response.retcode === 403;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IACvD,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,6DAA6D;AAC7D,MAAM,OAAO,kBAAmB,SAAQ,sBAAsB;IAC5D,YAAY,OAAO,GAAG,0BAA0B,EAAE,OAAsB;QACtE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,OAAO,oBAAqB,SAAQ,sBAAsB;IACrD,SAAS,CAAS;IAE3B,YAAY,OAAe,EAAE,SAAiB,EAAE,OAAsB;QACpE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,OAAO,uBAAwB,SAAQ,sBAAsB;IACjE,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,2FAA2F;AAC3F,MAAM,OAAO,kBAAmB,SAAQ,sBAAsB;IAC5D,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,sEAAsE;AACtE,MAAM,OAAO,gBAAkC,SAAQ,aAAa;IACzD,QAAQ,CAAqB;IAC7B,OAAO,CAAS;IAChB,OAAO,CAAU;IAE1B,YAAY,QAA4B;QACtC,KAAK,CAAC,QAAQ,CAAC,OAAO,IAAI,oCAAoC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IAClC,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,OAAO,iBAAmC,SAAQ,gBAAuB;IAC7E,YAAY,QAA4B;QACtC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAQ,QAA4B;IACxE,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACpG,CAAC;AAED,SAAS,aAAa,CAAC,QAA8B;IACnD,OAAO,QAAQ,CAAC,OAAO,KAAK,IAAI,IAAI,QAAQ,CAAC,OAAO,KAAK,GAAG,IAAI,QAAQ,CAAC,OAAO,KAAK,GAAG,CAAC;AAC3F,CAAC"}

package/dist/events/command.d.ts

@@ -0,0 +1,4 @@
+import type { OneBotMessageEvent } from '../types/index';
+import type { CommandMatch, CommandOptions } from './types';
+export declare function matchCommand(event: OneBotMessageEvent, command: string | RegExp, options?: CommandOptions): CommandMatch | null;
+//# sourceMappingURL=command.d.ts.map

package/dist/events/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/events/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE5D,wBAAgB,YAAY,CAC1B,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,GAAE,cAAmB,GAC3B,YAAY,GAAG,IAAI,CA2CrB"}

package/dist/events/command.js

@@ -0,0 +1,46 @@
+export function matchCommand(event, command, options = {}) {
+    const trim = options.trim ?? true;
+    const raw = trim ? event.raw_message.trim() : event.raw_message;
+    const prefixes = normalizePrefixes(options.prefixes ?? '/');
+    for (const prefix of prefixes) {
+        if (prefix && !raw.startsWith(prefix))
+            continue;
+        const text = prefix ? raw.slice(prefix.length).trimStart() : raw;
+        if (!text)
+            continue;
+        if (command instanceof RegExp) {
+            const match = text.match(command);
+            if (!match || match.index !== 0)
+                continue;
+            const matchedText = match[0] ?? '';
+            const rest = text.slice(matchedText.length).trim();
+            return {
+                command: matchedText,
+                text,
+                args: rest ? rest.split(/\s+/) : [],
+                rest,
+                prefix,
+                match,
+            };
+        }
+        const [head = '', ...args] = text.split(/\s+/);
+        const matches = options.caseSensitive
+            ? head === command
+            : head.toLowerCase() === command.toLowerCase();
+        if (!matches)
+            continue;
+        return {
+            command: head,
+            text,
+            args,
+            rest: text.slice(head.length).trim(),
+            prefix,
+            match: null,
+        };
+    }
+    return null;
+}
+function normalizePrefixes(prefixes) {
+    return Array.isArray(prefixes) ? prefixes : [prefixes];
+}
+//# sourceMappingURL=command.js.map

package/dist/events/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/events/command.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAC1B,KAAyB,EACzB,OAAwB,EACxB,UAA0B,EAAE;IAE5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;IAChE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;IAE5D,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS;QAEhD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACjE,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,IAAI,OAAO,YAAY,MAAM,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC;gBAAE,SAAS;YAC1C,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YACnD,OAAO;gBACL,OAAO,EAAE,WAAW;gBACpB,IAAI;gBACJ,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;gBACnC,IAAI;gBACJ,MAAM;gBACN,KAAK;aACN,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,IAAI,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa;YACnC,CAAC,CAAC,IAAI,KAAK,OAAO;YAClB,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC;QACjD,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI;YACJ,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;YACpC,MAAM;YACN,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CAAC,QAA2B;IACpD,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AACzD,CAAC"}

package/dist/events/context.d.ts

@@ -0,0 +1,6 @@
+import type { SnowLumaApiClient } from '../client/api-client';
+import type { SnowLumaEvent } from '../types/index';
+import type { SnowLumaEventContext } from './types';
+/** Creates the helper context object used by WebSocket event handlers. */
+export declare function createEventContext<TEvent extends SnowLumaEvent>(event: TEvent, client: SnowLumaApiClient): SnowLumaEventContext<TEvent>;
+//# sourceMappingURL=context.d.ts.map

package/dist/events/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/events/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,aAAa,EAC7D,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,iBAAiB,GACxB,oBAAoB,CAAC,MAAM,CAAC,CA+D9B"}

package/dist/events/context.js

@@ -0,0 +1,65 @@
+import { isGroupMessageEvent, isPrivateMessageEvent, isRequestEvent } from './guards';
+/** Creates the helper context object used by WebSocket event handlers. */
+export function createEventContext(event, client) {
+    let stopped = false;
+    const context = {
+        event,
+        client,
+        get stopped() {
+            return stopped;
+        },
+        stopPropagation() {
+            stopped = true;
+        },
+        async reply(message, options) {
+            if (isGroupMessageEvent(event)) {
+                return client.sendGroupMessage(event.group_id, message, options);
+            }
+            if (isPrivateMessageEvent(event)) {
+                return client.sendPrivateMessage(event.user_id, message, options);
+            }
+            throw new Error('reply() is only available for message events');
+        },
+        async approve(options) {
+            if (!isRequestEvent(event)) {
+                throw new Error('approve() is only available for request events');
+            }
+            if (event.request_type === 'friend') {
+                return client.setFriendAddRequest(event.flag, true, options);
+            }
+            if (event.request_type === 'group') {
+                return client.setGroupAddRequest(event.flag, {
+                    ...options,
+                    subType: options?.subType ?? event.sub_type,
+                    approve: true,
+                });
+            }
+            throw new Error(`approve() does not support request_type=${event.request_type}`);
+        },
+        async reject(reason, options) {
+            if (!isRequestEvent(event)) {
+                throw new Error('reject() is only available for request events');
+            }
+            if (event.request_type === 'friend') {
+                return client.setFriendAddRequest(event.flag, false, options);
+            }
+            if (event.request_type === 'group') {
+                return client.setGroupAddRequest(event.flag, {
+                    ...options,
+                    subType: options?.subType ?? event.sub_type,
+                    approve: false,
+                    reason: reason ?? options?.reason,
+                });
+            }
+            throw new Error(`reject() does not support request_type=${event.request_type}`);
+        },
+        async quickOperation(operation, options) {
+            return client.raw('.handle_quick_operation', {
+                context: event,
+                operation,
+            }, options);
+        },
+    };
+    return context;
+}
+//# sourceMappingURL=context.js.map

package/dist/events/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/events/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAGtF,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,MAAyB;IAEzB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,OAAO,GAAiC;QAC5C,KAAK;QACL,MAAM;QACN,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,eAAe;YACb,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO;YAC1B,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjC,OAAO,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACpE,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,OAAO;YACnB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YACD,IAAI,KAAK,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;gBACpC,OAAO,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAC/D,CAAC;YACD,IAAI,KAAK,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;gBACnC,OAAO,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE;oBAC3C,GAAG,OAAO;oBACV,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC,QAAQ;oBAC3C,OAAO,EAAE,IAAI;iBACd,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO;YAC1B,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,KAAK,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;gBACpC,OAAO,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAChE,CAAC;YACD,IAAI,KAAK,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;gBACnC,OAAO,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE;oBAC3C,GAAG,OAAO;oBACV,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC,QAAQ;oBAC3C,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM;iBAClC,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,0CAA0C,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO;YACrC,OAAO,MAAM,CAAC,GAAG,CAAC,yBAAyB,EAAE;gBAC3C,OAAO,EAAE,KAAK;gBACd,SAAS;aACV,EAAE,OAAO,CAAC,CAAC;QACd,CAAC;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/events/guards.d.ts

@@ -0,0 +1,11 @@
+import type { OneBotGroupMessageEvent, OneBotMessageEvent, OneBotMetaEvent, OneBotNoticeEvent, OneBotPrivateMessageEvent, OneBotRequestEvent, SnowLumaEvent } from '../types/index';
+import type { EventPredicate } from './types';
+export declare function isMessageEvent(event: SnowLumaEvent): event is OneBotMessageEvent;
+export declare function isPrivateMessageEvent(event: SnowLumaEvent): event is OneBotPrivateMessageEvent;
+export declare function isGroupMessageEvent(event: SnowLumaEvent): event is OneBotGroupMessageEvent;
+export declare function isNoticeEvent(event: SnowLumaEvent): event is OneBotNoticeEvent;
+export declare function isRequestEvent(event: SnowLumaEvent): event is OneBotRequestEvent;
+export declare function isMetaEvent(event: SnowLumaEvent): event is OneBotMetaEvent;
+export declare function noticeType(type: string): EventPredicate<OneBotNoticeEvent>;
+export declare function requestType(type: string): EventPredicate<OneBotRequestEvent>;
+//# sourceMappingURL=guards.d.ts.map

package/dist/events/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/events/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,kBAAkB,CAGhF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,yBAAyB,CAE9F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,uBAAuB,CAE1F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAE1E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAE5E"}

package/dist/events/guards.js

@@ -0,0 +1,26 @@
+export function isMessageEvent(event) {
+    return (event.post_type === 'message' || event.post_type === 'message_sent')
+        && (event.message_type === 'private' || event.message_type === 'group');
+}
+export function isPrivateMessageEvent(event) {
+    return isMessageEvent(event) && event.message_type === 'private';
+}
+export function isGroupMessageEvent(event) {
+    return isMessageEvent(event) && event.message_type === 'group';
+}
+export function isNoticeEvent(event) {
+    return event.post_type === 'notice' && typeof event.notice_type === 'string';
+}
+export function isRequestEvent(event) {
+    return event.post_type === 'request' && typeof event.request_type === 'string' && typeof event.flag === 'string';
+}
+export function isMetaEvent(event) {
+    return event.post_type === 'meta_event' && typeof event.meta_event_type === 'string';
+}
+export function noticeType(type) {
+    return (event) => isNoticeEvent(event) && event.notice_type === type;
+}
+export function requestType(type) {
+    return (event) => isRequestEvent(event) && event.request_type === type;
+}
+//# sourceMappingURL=guards.js.map

package/dist/events/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/events/guards.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,cAAc,CAAC;WACvE,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAoB;IACxD,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAoB;IACtD,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,YAAY,KAAK,OAAO,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAoB;IAChD,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AACnH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAoB;IAC9C,OAAO,KAAK,CAAC,SAAS,KAAK,YAAY,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,CAAC,KAAK,EAA8B,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,CAAC,KAAK,EAA+B,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;AACtG,CAAC"}

package/dist/events/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types';
+export * from './guards';
+export * from './context';
+export * from './command';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,5 @@
+export * from './types';
+export * from './guards';
+export * from './context';
+export * from './command';
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/events/types.d.ts

@@ -0,0 +1,52 @@
+import type { SnowLumaApiClient } from '../client/api-client';
+import type { JsonObject, OneBotMessageEvent, OutgoingMessage, RequestOptions, SnowLumaEvent } from '../types/index';
+export type MaybePromise<T = void> = T | Promise<T>;
+export type EventNext = () => Promise<void>;
+/** Type guard or predicate used by client.when(). */
+export type EventPredicate<TEvent extends SnowLumaEvent = SnowLumaEvent> = (event: SnowLumaEvent) => event is TEvent;
+/** Handler for one narrowed SnowLuma event. */
+export type EventHandler<TEvent extends SnowLumaEvent = SnowLumaEvent> = (event: TEvent, context: SnowLumaEventContext<TEvent>) => MaybePromise;
+/** Middleware in the WebSocket event dispatch pipeline. */
+export type EventMiddleware = (event: SnowLumaEvent, context: SnowLumaEventContext, next: EventNext) => MaybePromise;
+/** Options for accepting or rejecting OneBot request events. */
+export interface RequestDecisionOptions extends RequestOptions {
+    reason?: string;
+    subType?: string;
+}
+/** Convenience context passed to event middleware and handlers. */
+export interface SnowLumaEventContext<TEvent extends SnowLumaEvent = SnowLumaEvent> {
+    readonly event: TEvent;
+    readonly client: SnowLumaApiClient;
+    readonly stopped: boolean;
+    /** Prevents subsequent middleware and final onEvent listeners from running. */
+    stopPropagation(): void;
+    /** Replies to private or group message events with the correct API. */
+    reply(message: OutgoingMessage, options?: RequestOptions & {
+        autoEscape?: boolean;
+    }): Promise<unknown>;
+    /** Approves a friend or group request event. */
+    approve(options?: RequestDecisionOptions): Promise<unknown>;
+    /** Rejects a friend or group request event. */
+    reject(reason?: string, options?: RequestDecisionOptions): Promise<unknown>;
+    /** Sends OneBot .handle_quick_operation with the current event as context. */
+    quickOperation(operation: JsonObject, options?: RequestOptions): Promise<unknown>;
+}
+/** Command matching options for WebSocketClient.command(). */
+export interface CommandOptions {
+    prefixes?: string | string[];
+    trim?: boolean;
+    caseSensitive?: boolean;
+}
+/** Parsed command information passed to command handlers. */
+export interface CommandMatch {
+    command: string;
+    text: string;
+    args: string[];
+    rest: string;
+    prefix: string;
+    match: RegExpMatchArray | null;
+}
+export type CommandHandler<TEvent extends OneBotMessageEvent = OneBotMessageEvent> = (event: TEvent, context: SnowLumaEventContext<TEvent> & {
+    command: CommandMatch;
+}, match: CommandMatch) => MaybePromise;
+//# sourceMappingURL=types.d.ts.map

package/dist/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,aAAa,EACd,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AACpD,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5C,qDAAqD;AACrD,MAAM,MAAM,cAAc,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa,IAAI,CAAC,KAAK,EAAE,aAAa,KAAK,KAAK,IAAI,MAAM,CAAC;AAErH,+CAA+C;AAC/C,MAAM,MAAM,YAAY,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa,IAAI,CACvE,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAClC,YAAY,CAAC;AAElB,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,CAC5B,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,SAAS,KACZ,YAAY,CAAC;AAElB,gEAAgE;AAChE,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,oBAAoB,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,eAAe,IAAI,IAAI,CAAC;IACxB,uEAAuE;IACvE,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvG,gDAAgD;IAChD,OAAO,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,+CAA+C;IAC/C,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,8EAA8E;IAC9E,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnF;AAED,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,cAAc,CAAC,MAAM,SAAS,kBAAkB,GAAG,kBAAkB,IAAI,CACnF,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,GAAG;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,EACjE,KAAK,EAAE,YAAY,KAChB,YAAY,CAAC"}

package/dist/events/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { SNOWLUMA_ACTIONS, isSnowLumaAction } from './actions';
+export { SnowLumaApiClient } from './client/api-client';
+export { SnowLumaHttpClient, createHttpClient } from './client/http-client';
+export { SnowLumaWebSocketClient, createWebSocketClient } from './client/websocket-client';
+export { SnowLumaAbortError, SnowLumaApiError, SnowLumaAuthError, SnowLumaConnectionError, SnowLumaError, SnowLumaParseError, SnowLumaTimeoutError, SnowLumaTransportError, createSnowLumaApiError, } from './errors';
+export { MessageChain, at, atAll, br, chain, contact, escapeCqParam, escapeCqText, face, forward, image, json, location, message, music, node, normalizeMessage, parseSegments, poke, raw, record, reply, share, text, toCQString, video, xml, fromCQString, } from './messages/index';
+export { createEventContext, isGroupMessageEvent, isMessageEvent, isMetaEvent, isNoticeEvent, isPrivateMessageEvent, isRequestEvent, matchCommand, noticeType, requestType, } from './events/index';
+export type { SnowLumaKnownAction, } from './actions';
+export type { SnowLumaHttpClientOptions, } from './client/http-client';
+export type { ReconnectOptions, SnowLumaWebSocketClientOptions, SnowLumaWebSocketEvents, WebSocketCloseInfo, WebSocketConstructor, } from './client/websocket-client';
+export type { CommandHandler, CommandMatch, CommandOptions, EventHandler, EventMiddleware, EventNext, EventPredicate, MaybePromise, RequestDecisionOptions, SnowLumaEventContext, } from './events/index';
+export type * from './types/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC3F,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,YAAY,EACZ,EAAE,EACF,KAAK,EACL,EAAE,EACF,KAAK,EACL,OAAO,EACP,aAAa,EACb,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,KAAK,EACL,IAAI,EACJ,gBAAgB,EAChB,aAAa,EACb,IAAI,EACJ,GAAG,EACH,MAAM,EACN,KAAK,EACL,KAAK,EACL,IAAI,EACJ,UAAU,EACV,KAAK,EACL,GAAG,EACH,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,gBAAgB,EAChB,8BAA8B,EAC9B,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,SAAS,EACT,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,mBAAmB,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { SNOWLUMA_ACTIONS, isSnowLumaAction } from './actions';
+export { SnowLumaApiClient } from './client/api-client';
+export { SnowLumaHttpClient, createHttpClient } from './client/http-client';
+export { SnowLumaWebSocketClient, createWebSocketClient } from './client/websocket-client';
+export { SnowLumaAbortError, SnowLumaApiError, SnowLumaAuthError, SnowLumaConnectionError, SnowLumaError, SnowLumaParseError, SnowLumaTimeoutError, SnowLumaTransportError, createSnowLumaApiError, } from './errors';
+export { MessageChain, at, atAll, br, chain, contact, escapeCqParam, escapeCqText, face, forward, image, json, location, message, music, node, normalizeMessage, parseSegments, poke, raw, record, reply, share, text, toCQString, video, xml, fromCQString, } from './messages/index';
+export { createEventContext, isGroupMessageEvent, isMessageEvent, isMetaEvent, isNoticeEvent, isPrivateMessageEvent, isRequestEvent, matchCommand, noticeType, requestType, } from './events/index';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC3F,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,YAAY,EACZ,EAAE,EACF,KAAK,EACL,EAAE,EACF,KAAK,EACL,OAAO,EACP,aAAa,EACb,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,KAAK,EACL,IAAI,EACJ,gBAAgB,EAChB,aAAa,EACb,IAAI,EACJ,GAAG,EACH,MAAM,EACN,KAAK,EACL,KAAK,EACL,IAAI,EACJ,UAAU,EACV,KAAK,EACL,GAAG,EACH,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,gBAAgB,CAAC"}

package/dist/internal/abort.d.ts

@@ -0,0 +1,11 @@
+export interface RequestAbortState {
+    signal: AbortSignal;
+    cleanup(): void;
+    isTimedOut(): boolean;
+    isExternallyAborted(): boolean;
+}
+export declare function createRequestAbortState(timeoutMs: number, externalSignal?: AbortSignal): RequestAbortState;
+export declare function throwIfAborted(signal?: AbortSignal, message?: string): void;
+export declare function isAbortError(error: unknown): boolean;
+export declare function raceWithAbort<T>(promise: Promise<T>, signal?: AbortSignal, message?: string): Promise<T>;
+//# sourceMappingURL=abort.d.ts.map

package/dist/internal/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../src/internal/abort.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,IAAI,IAAI,CAAC;IAChB,UAAU,IAAI,OAAO,CAAC;IACtB,mBAAmB,IAAI,OAAO,CAAC;CAChC;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,WAAW,GAC3B,iBAAiB,CAoCnB;AAED,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,OAAO,SAA6B,GAAG,IAAI,CAI/F;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKpD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,SAA6B,GACnC,OAAO,CAAC,CAAC,CAAC,CAcZ"}

package/dist/internal/abort.js

@@ -0,0 +1,62 @@
+import { SnowLumaAbortError } from '../errors';
+export function createRequestAbortState(timeoutMs, externalSignal) {
+    const controller = new AbortController();
+    let timedOut = false;
+    let externallyAborted = false;
+    const onExternalAbort = () => {
+        externallyAborted = true;
+        controller.abort(externalSignal?.reason);
+    };
+    if (externalSignal?.aborted) {
+        onExternalAbort();
+    }
+    else {
+        externalSignal?.addEventListener('abort', onExternalAbort, { once: true });
+    }
+    const timer = timeoutMs > 0
+        ? setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+        }, timeoutMs)
+        : null;
+    return {
+        signal: controller.signal,
+        cleanup() {
+            if (timer)
+                clearTimeout(timer);
+            externalSignal?.removeEventListener('abort', onExternalAbort);
+        },
+        isTimedOut() {
+            return timedOut;
+        },
+        isExternallyAborted() {
+            return externallyAborted || externalSignal?.aborted === true;
+        },
+    };
+}
+export function throwIfAborted(signal, message = 'SnowLuma request aborted') {
+    if (signal?.aborted) {
+        throw new SnowLumaAbortError(message, { cause: signal.reason });
+    }
+}
+export function isAbortError(error) {
+    return typeof error === 'object'
+        && error !== null
+        && 'name' in error
+        && error.name === 'AbortError';
+}
+export function raceWithAbort(promise, signal, message = 'SnowLuma request aborted') {
+    if (!signal)
+        return promise;
+    throwIfAborted(signal, message);
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            reject(new SnowLumaAbortError(message, { cause: signal.reason }));
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        promise.then(resolve, reject).finally(() => {
+            signal.removeEventListener('abort', onAbort);
+        });
+    });
+}
+//# sourceMappingURL=abort.js.map

package/dist/internal/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../src/internal/abort.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAS/C,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,cAA4B;IAE5B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAE9B,MAAM,eAAe,GAAG,GAAS,EAAE;QACjC,iBAAiB,GAAG,IAAI,CAAC;QACzB,UAAU,CAAC,KAAK,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC,CAAC;IAEF,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;QAC5B,eAAe,EAAE,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,cAAc,EAAE,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,GAAG,CAAC;QACzB,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;YAChB,QAAQ,GAAG,IAAI,CAAC;YAChB,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,EAAE,SAAS,CAAC;QACb,CAAC,CAAC,IAAI,CAAC;IAET,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,OAAO;YACL,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC/B,cAAc,EAAE,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAChE,CAAC;QACD,UAAU;YACR,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,mBAAmB;YACjB,OAAO,iBAAiB,IAAI,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC;QAC/D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAoB,EAAE,OAAO,GAAG,0BAA0B;IACvF,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ;WAC3B,KAAK,KAAK,IAAI;WACd,MAAM,IAAI,KAAK;WACd,KAA4B,CAAC,IAAI,KAAK,YAAY,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,OAAmB,EACnB,MAAoB,EACpB,OAAO,GAAG,0BAA0B;IAEpC,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAC5B,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,MAAM,CAAC,IAAI,kBAAkB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACzC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/internal/json.d.ts

@@ -0,0 +1,8 @@
+import type { ApiResponse, JsonObject, JsonValue } from '../types/index';
+export declare function isJsonObject(value: unknown): value is JsonObject;
+export declare function asJsonValue(value: unknown): JsonValue;
+export declare function assertApiResponse(value: unknown): ApiResponse;
+export declare function createEcho(): string;
+export declare function echoKey(value: JsonValue | undefined): string;
+export declare function appendAccessToken(urlValue: string, accessToken?: string): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/internal/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/internal/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAerD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAqB7D;AAED,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAG5D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAOhF"}

package/dist/internal/json.js

@@ -0,0 +1,60 @@
+export function isJsonObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function asJsonValue(value) {
+    if (value === null)
+        return null;
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return value;
+    }
+    if (Array.isArray(value))
+        return value.map(asJsonValue);
+    if (isJsonObject(value)) {
+        const out = {};
+        for (const [key, item] of Object.entries(value)) {
+            if (item === undefined)
+                continue;
+            out[key] = asJsonValue(item);
+        }
+        return out;
+    }
+    return String(value);
+}
+export function assertApiResponse(value) {
+    if (!isJsonObject(value)) {
+        throw new Error('response is not a JSON object');
+    }
+    const status = value.status === 'ok' ? 'ok' : value.status === 'failed' ? 'failed' : null;
+    if (!status) {
+        throw new Error('response status is missing or invalid');
+    }
+    const retcode = typeof value.retcode === 'number' && Number.isFinite(value.retcode)
+        ? value.retcode
+        : status === 'ok' ? 0 : -1;
+    return {
+        status,
+        retcode,
+        data: asJsonValue(value.data ?? null),
+        echo: value.echo === undefined ? undefined : asJsonValue(value.echo),
+        wording: typeof value.wording === 'string' ? value.wording : undefined,
+    };
+}
+export function createEcho() {
+    const random = Math.random().toString(36).slice(2);
+    return `snowluma-sdk:${Date.now().toString(36)}:${random}`;
+}
+export function echoKey(value) {
+    if (value === undefined)
+        return '';
+    return JSON.stringify(value);
+}
+export function appendAccessToken(urlValue, accessToken) {
+    if (!accessToken)
+        return urlValue;
+    const url = new URL(urlValue);
+    if (!url.searchParams.has('access_token')) {
+        url.searchParams.set('access_token', accessToken);
+    }
+    return url.toString();
+}
+//# sourceMappingURL=json.js.map

package/dist/internal/json.js.map

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