@owlmeans/bot 0.0.0-stage → 0.1.18-rc.1

package/build/consts.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../src/consts.local.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAA0B,CAAA;AAExD,0GAA0G;AAC1G,eAAO,MAAM,iBAAiB,QAAU,CAAA;AAExC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAA6E,CAAA"}

package/build/consts.local.js

@@ -0,0 +1,13 @@
+/**
+ * One token of `word` matching: letters, combining marks, digits and `_`. Marks are part of the word
+ * (Devanagari vowel signs, a decomposed accent left after folding), so a word never splits on one.
+ */
+export const BOT_TOKEN_PATTERN = /[\p{L}\p{M}\p{N}_]+/gu;
+/** Any whitespace run — collapsed to one space before a `contains` comparison and in a stored keyword. */
+export const BOT_SPACE_PATTERN = /\s+/gu;
+/**
+ * A `/command`, optionally addressed `@ToBot`, ending at whitespace or at the end of the text, then
+ * its arguments.
+ */
+export const BOT_COMMAND_PATTERN = /^\/([\p{L}\p{N}_-]{1,64})(?:@([\p{L}\p{N}_.]{1,64}))?(?:\s+([\s\S]*))?$/u;
+//# sourceMappingURL=consts.local.js.map

package/build/consts.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../src/consts.local.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAA;AAExD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAA;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,0EAA0E,CAAA"}

package/build/errors.d.ts

@@ -0,0 +1,43 @@
+import { ResilientError } from '@owlmeans/error';
+/**
+ * The bot refusal family.
+ *
+ * Every message starts with `bot:` and the class's own marker (`connection-not-found:` …) — the
+ * marker survives a hop where the class is not registered, so it is part of the contract. The family
+ * base declares no status: a fault of the platform or the store answers 500.
+ */
+export declare class BotError extends ResilientError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** The connection does not exist — or is another scope's, which is deliberately the same answer. */
+export declare class BotConnectionNotFound extends BotError {
+    static typeName: string;
+    static httpStatus: number;
+    constructor(message?: string);
+}
+/** The platform refused the credentials (or a required one is missing) at verification. */
+export declare class BotCredentialsRejected extends BotError {
+    static typeName: string;
+    static httpStatus: number;
+    constructor(message?: string);
+}
+/** An inbound hook whose signature (or verify token) does not prove it came from the platform. */
+export declare class BotSignatureRejected extends BotError {
+    static typeName: string;
+    static httpStatus: number;
+    constructor(message?: string);
+}
+/** The request needs the other transport — `simulate` on a live connection. */
+export declare class BotTransportMismatch extends BotError {
+    static typeName: string;
+    static httpStatus: number;
+    constructor(message?: string);
+}
+/** The platform (or the connection's credentials) cannot perform the requested action. */
+export declare class BotUnsupportedAction extends BotError {
+    static typeName: string;
+    static httpStatus: number;
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/build/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,cAAc;IAC1C,OAAuB,QAAQ,EAAE,MAAM,CAAa;IAEpD,YAAY,OAAO,GAAE,MAAgB,EAEpC;CACF;AAED,oGAAoG;AACpG,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,OAAuB,QAAQ,EAAE,MAAM,CAA2C;IAClF,OAAc,UAAU,SAAM;IAE9B,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,2FAA2F;AAC3F,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD,OAAuB,QAAQ,EAAE,MAAM,CAA4C;IACnF,OAAc,UAAU,SAAM;IAE9B,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,kGAAkG;AAClG,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,OAAuB,QAAQ,EAAE,MAAM,CAA0C;IACjF,OAAc,UAAU,SAAM;IAE9B,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,+EAA+E;AAC/E,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,OAAuB,QAAQ,EAAE,MAAM,CAA0C;IACjF,OAAc,UAAU,SAAM;IAE9B,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,0FAA0F;AAC1F,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,OAAuB,QAAQ,EAAE,MAAM,CAA0C;IACjF,OAAc,UAAU,SAAM;IAE9B,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF"}

package/build/errors.js

@@ -0,0 +1,66 @@
+import { ResilientError } from '@owlmeans/error';
+/**
+ * The bot refusal family.
+ *
+ * Every message starts with `bot:` and the class's own marker (`connection-not-found:` …) — the
+ * marker survives a hop where the class is not registered, so it is part of the contract. The family
+ * base declares no status: a fault of the platform or the store answers 500.
+ */
+export class BotError extends ResilientError {
+    static typeName = 'BotError';
+    constructor(message = 'error') {
+        super(BotError.typeName, `bot:${message}`);
+    }
+}
+/** The connection does not exist — or is another scope's, which is deliberately the same answer. */
+export class BotConnectionNotFound extends BotError {
+    static typeName = `${BotError.typeName}ConnectionNotFound`;
+    static httpStatus = 404;
+    constructor(message = 'error') {
+        super(`connection-not-found:${message}`);
+        this.type = BotConnectionNotFound.typeName;
+    }
+}
+/** The platform refused the credentials (or a required one is missing) at verification. */
+export class BotCredentialsRejected extends BotError {
+    static typeName = `${BotError.typeName}CredentialsRejected`;
+    static httpStatus = 422;
+    constructor(message = 'error') {
+        super(`credentials-rejected:${message}`);
+        this.type = BotCredentialsRejected.typeName;
+    }
+}
+/** An inbound hook whose signature (or verify token) does not prove it came from the platform. */
+export class BotSignatureRejected extends BotError {
+    static typeName = `${BotError.typeName}SignatureRejected`;
+    static httpStatus = 401;
+    constructor(message = 'error') {
+        super(`signature-rejected:${message}`);
+        this.type = BotSignatureRejected.typeName;
+    }
+}
+/** The request needs the other transport — `simulate` on a live connection. */
+export class BotTransportMismatch extends BotError {
+    static typeName = `${BotError.typeName}TransportMismatch`;
+    static httpStatus = 409;
+    constructor(message = 'error') {
+        super(`transport-mismatch:${message}`);
+        this.type = BotTransportMismatch.typeName;
+    }
+}
+/** The platform (or the connection's credentials) cannot perform the requested action. */
+export class BotUnsupportedAction extends BotError {
+    static typeName = `${BotError.typeName}UnsupportedAction`;
+    static httpStatus = 422;
+    constructor(message = 'error') {
+        super(`unsupported-action:${message}`);
+        this.type = BotUnsupportedAction.typeName;
+    }
+}
+ResilientError.registerErrorClass(BotError);
+ResilientError.registerErrorClass(BotConnectionNotFound);
+ResilientError.registerErrorClass(BotCredentialsRejected);
+ResilientError.registerErrorClass(BotSignatureRejected);
+ResilientError.registerErrorClass(BotTransportMismatch);
+ResilientError.registerErrorClass(BotUnsupportedAction);
+//# sourceMappingURL=errors.js.map

package/build/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,OAAO,QAAS,SAAQ,cAAc;IACnC,MAAM,CAAU,QAAQ,GAAW,UAAU,CAAA;IAEpD,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,OAAO,EAAE,CAAC,CAAA;IAC5C,CAAC;CACF;AAED,oGAAoG;AACpG,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IAC1C,MAAM,CAAU,QAAQ,GAAW,GAAG,QAAQ,CAAC,QAAQ,oBAAoB,CAAA;IAC3E,MAAM,CAAC,UAAU,GAAG,GAAG,CAAA;IAE9B,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,QAAQ,CAAA;IAC5C,CAAC;CACF;AAED,2FAA2F;AAC3F,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;IAC3C,MAAM,CAAU,QAAQ,GAAW,GAAG,QAAQ,CAAC,QAAQ,qBAAqB,CAAA;IAC5E,MAAM,CAAC,UAAU,GAAG,GAAG,CAAA;IAE9B,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,QAAQ,CAAA;IAC7C,CAAC;CACF;AAED,kGAAkG;AAClG,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IACzC,MAAM,CAAU,QAAQ,GAAW,GAAG,QAAQ,CAAC,QAAQ,mBAAmB,CAAA;IAC1E,MAAM,CAAC,UAAU,GAAG,GAAG,CAAA;IAE9B,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAA;QACtC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAA;IAC3C,CAAC;CACF;AAED,+EAA+E;AAC/E,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IACzC,MAAM,CAAU,QAAQ,GAAW,GAAG,QAAQ,CAAC,QAAQ,mBAAmB,CAAA;IAC1E,MAAM,CAAC,UAAU,GAAG,GAAG,CAAA;IAE9B,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAA;QACtC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAA;IAC3C,CAAC;CACF;AAED,0FAA0F;AAC1F,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IACzC,MAAM,CAAU,QAAQ,GAAW,GAAG,QAAQ,CAAC,QAAQ,mBAAmB,CAAA;IAC1E,MAAM,CAAC,UAAU,GAAG,GAAG,CAAA;IAE9B,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAA;QACtC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAA;IAC3C,CAAC;CACF;AAED,cAAc,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAA;AAC3C,cAAc,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAA;AACxD,cAAc,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAA;AACzD,cAAc,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAA;AACvD,cAAc,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAA;AACvD,cAAc,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAA"}

package/build/helpers/command/types.d.ts

@@ -0,0 +1,14 @@
+import type { BotCommand } from '../../types.js';
+export interface BotCommandHelper {
+    /**
+     * Read a `/command` off the start of a message: `/report@MyBot some args` →
+     * `{ name: 'report', args: 'some args' }`.
+     *
+     * The name is lower-cased and must end at whitespace or at the end of the text (`/usr/bin` is not a
+     * command); `args` is the trimmed rest, `''` when none. A command addressed to ANOTHER bot
+     * (`@OtherBot`, compared case-insensitively, a leading `@` of `botUsername` ignored) answers `null`
+     * — when `botUsername` is not given, any address is accepted. Not a command answers `null`.
+     */
+    parse: (text: string, botUsername?: string) => BotCommand | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/helpers/command/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/helpers/command/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;OAQG;IACH,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,CAAA;CACjE"}

package/build/helpers/command/types.js

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

package/build/helpers/command/types.js.map

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

package/build/helpers/command.d.ts

@@ -0,0 +1,4 @@
+import type { BotCommandHelper } from './command/types.js';
+export declare const createBotCommandHelper: () => BotCommandHelper;
+export declare const botCommandHelper: BotCommandHelper;
+//# sourceMappingURL=command.d.ts.map

package/build/helpers/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/helpers/command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,eAAO,MAAM,sBAAsB,QAAO,gBAmBzC,CAAA;AAED,eAAO,MAAM,gBAAgB,kBAA2B,CAAA"}

package/build/helpers/command.js

@@ -0,0 +1,21 @@
+import { BOT_COMMAND_PATTERN } from '../consts.local.js';
+export const createBotCommandHelper = () => {
+    const parse = (text, botUsername) => {
+        if (typeof text !== 'string') {
+            return null;
+        }
+        const found = BOT_COMMAND_PATTERN.exec(text.trimStart());
+        if (found == null) {
+            return null;
+        }
+        const [, name, addressee, args] = found;
+        const own = botUsername?.replace(/^@/, '').trim().toLowerCase();
+        if (addressee != null && own != null && own !== '' && addressee.toLowerCase() !== own) {
+            return null;
+        }
+        return { name: name.toLowerCase(), args: (args ?? '').trim() };
+    };
+    return { parse };
+};
+export const botCommandHelper = createBotCommandHelper();
+//# sourceMappingURL=command.js.map

package/build/helpers/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/helpers/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAIxD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAqB,EAAE;IAC3D,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,WAAoB,EAAqB,EAAE;QACtE,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;QACxD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,KAAK,CAAA;QACvC,MAAM,GAAG,GAAG,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC/D,IAAI,SAAS,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;YACtF,OAAO,IAAI,CAAA;QACb,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAA;IAChE,CAAC,CAAA;IAED,OAAO,EAAE,KAAK,EAAE,CAAA;AAClB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,EAAE,CAAA"}

package/build/helpers/index.d.ts

@@ -0,0 +1,7 @@
+export type * from './rule/types.js';
+export type * from './command/types.js';
+export type * from './platform/types.js';
+export * from './rule.js';
+export * from './command.js';
+export * from './platform.js';
+//# sourceMappingURL=index.d.ts.map

package/build/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,qBAAqB,CAAA;AACxC,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA"}

package/build/helpers/index.js

@@ -0,0 +1,4 @@
+export * from './rule.js';
+export * from './command.js';
+export * from './platform.js';
+//# sourceMappingURL=index.js.map

package/build/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAGA,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA"}

package/build/helpers/platform/types.d.ts

@@ -0,0 +1,12 @@
+import type { BotActionKind, BotPlatform } from '../../consts.js';
+/** What a connection on a platform can do, given which of its credentials hold a value. */
+export interface BotPlatformHelper {
+    /**
+     * The descriptor's actions, plus those an optional credential `enables` when its key is in
+     * `credentialsSet` (Slack's `userToken` → `delete`), plus `note`, which every connection supports.
+     */
+    actionsOf: (platform: BotPlatform, credentialsSet?: readonly string[]) => BotActionKind[];
+    /** Whether {@link BotPlatformHelper.actionsOf} includes `kind`. */
+    supports: (platform: BotPlatform, kind: BotActionKind, credentialsSet?: readonly string[]) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/helpers/platform/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/helpers/platform/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAEjE,2FAA2F;AAC3F,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,KAAK,aAAa,EAAE,CAAA;IACzF,mEAAmE;IACnE,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAA;CACtG"}

package/build/helpers/platform/types.js

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

package/build/helpers/platform/types.js.map

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

package/build/helpers/platform.d.ts

@@ -0,0 +1,4 @@
+import type { BotPlatformHelper } from './platform/types.js';
+export declare const createBotPlatformHelper: () => BotPlatformHelper;
+export declare const botPlatformHelper: BotPlatformHelper;
+//# sourceMappingURL=platform.d.ts.map

package/build/helpers/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/helpers/platform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,eAAO,MAAM,uBAAuB,QAAO,iBAiB1C,CAAA;AAED,eAAO,MAAM,iBAAiB,mBAA4B,CAAA"}

package/build/helpers/platform.js

@@ -0,0 +1,17 @@
+import { BOT_PLATFORMS, BotActionKind } from '../consts.js';
+export const createBotPlatformHelper = () => {
+    const actionsOf = (platform, credentialsSet = []) => {
+        const descriptor = BOT_PLATFORMS[platform];
+        if (descriptor == null) {
+            return [BotActionKind.Note];
+        }
+        const enabled = descriptor.credentials
+            .filter(field => field.enables != null && credentialsSet.includes(field.key))
+            .flatMap(field => field.enables ?? []);
+        return [...new Set([...descriptor.actions, ...enabled, BotActionKind.Note])];
+    };
+    const supports = (platform, kind, credentialsSet) => actionsOf(platform, credentialsSet).includes(kind);
+    return { actionsOf, supports };
+};
+export const botPlatformHelper = createBotPlatformHelper();
+//# sourceMappingURL=platform.js.map

package/build/helpers/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/helpers/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAoB,MAAM,cAAc,CAAA;AAG7E,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAsB,EAAE;IAC7D,MAAM,SAAS,GAAG,CAAC,QAAqB,EAAE,cAAc,GAAsB,EAAE,EAAmB,EAAE;QACnG,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC1C,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;QAC7B,CAAC;QACD,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW;aACnC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;aAC5E,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QAExC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC9E,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,CAAC,QAAqB,EAAE,IAAmB,EAAE,cAAkC,EAAW,EAAE,CAC3G,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAEpD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;AAChC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,EAAE,CAAA"}

package/build/helpers/rule/types.d.ts

@@ -0,0 +1,26 @@
+import type { BotMatch, BotRule } from '../../types.js';
+/**
+ * How a message is matched against keyword groups — the ONE implementation the server's dispatch,
+ * the panels and the tests share, so a rule means the same thing everywhere.
+ */
+export interface BotRuleHelper {
+    /**
+     * The enabled rules whose keywords the text matches, ordered by `order` (ties keep the given
+     * order), each with the keywords (as stored) that matched.
+     *
+     * Both sides are folded the same way: NFKC, then case-folded (`ß` ≡ `ss`, `Ё` ≡ `ё`), accents
+     * kept. `word` compares whole tokens — runs of letters, combining marks, digits and `_` — and a
+     * multi-word keyword is a PHRASE that must appear as consecutive tokens; `contains` is a substring
+     * of the folded text with whitespace runs collapsed. Disabled rules never match.
+     */
+    match: (text: string, rules: readonly BotRule[]) => BotMatch[];
+    /**
+     * A keyword list as it is stored: each trimmed with inner whitespace collapsed, cut to
+     * `BOT_KEYWORD_MAX` code points, empties dropped, duplicates (by their folded form) dropped keeping
+     * the first spelling, at most `BOT_KEYWORDS_MAX` kept.
+     */
+    normalizeKeywords: (list: readonly string[]) => string[];
+    /** Whether a rule applies to a connection: its own, or a scope-wide one (`connection` null/absent). */
+    appliesTo: (rule: Pick<BotRule, 'connection'>, connection: string) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/helpers/rule/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/helpers/rule/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAEvD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;OAQG;IACH,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAA;IAC9D;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,EAAE,CAAA;IACxD,uGAAuG;IACvG,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAA;CAC9E"}

package/build/helpers/rule/types.js

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

package/build/helpers/rule/types.js.map

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

package/build/helpers/rule.d.ts

@@ -0,0 +1,4 @@
+import type { BotRuleHelper } from './rule/types.js';
+export declare const createBotRuleHelper: () => BotRuleHelper;
+export declare const botRuleHelper: BotRuleHelper;
+//# sourceMappingURL=rule.d.ts.map

package/build/helpers/rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../src/helpers/rule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,eAAO,MAAM,mBAAmB,QAAO,aAiFtC,CAAA;AAED,eAAO,MAAM,aAAa,eAAwB,CAAA"}

package/build/helpers/rule.js

@@ -0,0 +1,71 @@
+import { BOT_KEYWORD_MAX, BOT_KEYWORDS_MAX, BotMatchMode } from '../consts.js';
+import { BOT_SPACE_PATTERN, BOT_TOKEN_PATTERN } from '../consts.local.js';
+export const createBotRuleHelper = () => {
+    /**
+     * NFKC, then a case fold: upper-casing first maps what lower-casing alone keeps apart (`ß` → `SS`
+     * → `ss`, final `ς` → `Σ` → `σ`), and NFKC again recomposes what the case mapping decomposed.
+     */
+    const fold = (text) => text.normalize('NFKC').toUpperCase().toLowerCase().normalize('NFKC');
+    const tokensOf = (text) => fold(text).match(BOT_TOKEN_PATTERN) ?? [];
+    const spacedOf = (text) => fold(text).replace(BOT_SPACE_PATTERN, ' ').trim();
+    const hasPhrase = (tokens, phrase) => {
+        for (let at = 0; at + phrase.length <= tokens.length; at++) {
+            if (phrase.every((token, offset) => tokens[at + offset] === token)) {
+                return true;
+            }
+        }
+        return false;
+    };
+    const match = (text, rules) => {
+        if (typeof text !== 'string' || text.trim() === '') {
+            return [];
+        }
+        // Folded once per message, never per rule.
+        let tokens;
+        let spaced;
+        const matchesKeyword = (mode, keyword) => {
+            if (mode === BotMatchMode.Contains) {
+                const needle = spacedOf(keyword);
+                spaced ??= spacedOf(text);
+                return needle !== '' && spaced.includes(needle);
+            }
+            const phrase = tokensOf(keyword);
+            tokens ??= tokensOf(text);
+            return phrase.length > 0 && hasPhrase(tokens, phrase);
+        };
+        return rules
+            .filter(rule => rule.enabled)
+            .map((rule) => ({
+            rule,
+            keywords: [...new Set(rule.keywords.filter(keyword => typeof keyword === 'string' && matchesKeyword(rule.mode ?? BotMatchMode.Word, keyword)))],
+        }))
+            .filter(found => found.keywords.length > 0)
+            // Array#sort is stable: rules of equal order keep the order they were given in.
+            .sort((left, right) => (left.rule.order ?? 0) - (right.rule.order ?? 0));
+    };
+    const normalizeKeywords = (list) => {
+        const seen = new Set();
+        const result = [];
+        for (const raw of list ?? []) {
+            if (typeof raw !== 'string') {
+                continue;
+            }
+            const keyword = Array.from(raw.replace(BOT_SPACE_PATTERN, ' ').trim())
+                .slice(0, BOT_KEYWORD_MAX).join('').trim();
+            const key = spacedOf(keyword);
+            if (keyword === '' || seen.has(key)) {
+                continue;
+            }
+            seen.add(key);
+            result.push(keyword);
+            if (result.length >= BOT_KEYWORDS_MAX) {
+                break;
+            }
+        }
+        return result;
+    };
+    const appliesTo = (rule, connection) => rule.connection == null || rule.connection === connection;
+    return { match, normalizeKeywords, appliesTo };
+};
+export const botRuleHelper = createBotRuleHelper();
+//# sourceMappingURL=rule.js.map

package/build/helpers/rule.js.map

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

package/build/index.d.ts

@@ -0,0 +1,8 @@
+export type * from './types.js';
+export type * from './protocols/types.js';
+export * from './consts.js';
+export * from './schemas.js';
+export * from './errors.js';
+export * from './protocols.js';
+export * from './helpers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,sBAAsB,CAAA;AACzC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA"}

package/build/index.js

@@ -0,0 +1,6 @@
+export * from './consts.js';
+export * from './schemas.js';
+export * from './errors.js';
+export * from './protocols.js';
+export * from './helpers/index.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA"}

package/build/protocols/types.d.ts

@@ -0,0 +1,115 @@
+import type { EntrypointProtocol, OpenRequest, OpenValue } from '@owlmeans/entrypoint';
+import type { RouteParent } from '@owlmeans/route';
+import type { BotPlatform } from '../consts.js';
+import type { BotActivity, BotConnection, BotConnectionInput, BotRule, BotRuleInput, BotSimulateInput, BotSimulateResult } from '../types.js';
+/** Where a bot tree mounts. Every leaf alias derives from `alias` (`<alias>:connection:list` …). */
+export interface BotBaseOptions {
+    alias: string;
+    /** The base path — `/bot/operator`, `/bot/member`, `/bot/hook`. */
+    path: string;
+    parent?: RouteParent;
+    service?: string;
+}
+/** The access gate the managing base carries — `EntrypointOptions['gate']`. */
+export interface BotGateOptions {
+    alias: string;
+    params?: string | readonly string[];
+}
+export interface BotProtocolOptions {
+    base: BotBaseOptions;
+    /** The guard(s) the base carries; every leaf inherits them. */
+    guards?: string | readonly string[];
+    /** The ONE gate the base carries (a protocol has one gate); every leaf inherits it. */
+    gates?: BotGateOptions;
+}
+export interface BotHookProtocolOptions {
+    base: BotBaseOptions;
+}
+/** `:id` of a connection or a rule. */
+export interface BotIdParams {
+    id: string;
+}
+export interface BotRemoveResult {
+    id: string;
+}
+export interface BotRuleListQuery {
+    /** Rules of this connection plus the scope-wide ones; every rule of the scope when absent. */
+    connection?: string;
+}
+export interface BotActivityQuery {
+    connection?: string;
+    /** 1 … `BOT_ACTIVITY_LIMIT_MAX`; `BOT_ACTIVITY_LIMIT_DEFAULT` when absent. */
+    limit?: number;
+}
+/** The hook address: `/:platform/:connection`. */
+export interface BotHookParams {
+    platform: BotPlatform;
+    connection: string;
+}
+/** The platform's NATIVE payload — authenticated and normalized by the server, never by a schema. */
+export interface BotHookPayload {
+    [key: string]: unknown;
+}
+/** What the receive hook answers: 200 at once, or a handshake's challenge (Slack `url_verification`). */
+export interface BotHookReply {
+    ok?: boolean;
+    challenge?: string;
+}
+/** The subscription handshake WhatsApp sends as a GET (`hub.*`); answered with `hub.challenge`. */
+export interface BotChallengeQuery {
+    'hub.mode'?: string;
+    'hub.verify_token'?: string;
+    'hub.challenge'?: string;
+}
+/** The managing surface of one mount (operator or member). */
+export interface BotProtocols {
+    /** Carries the guards and the gate; every leaf hangs under it. */
+    base: EntrypointProtocol<OpenRequest, OpenValue>;
+    connection: {
+        list: EntrypointProtocol<{}, BotConnection[]>;
+        save: EntrypointProtocol<{
+            body: BotConnectionInput;
+        }, BotConnection>;
+        verify: EntrypointProtocol<{
+            params: BotIdParams;
+        }, BotConnection>;
+        remove: EntrypointProtocol<{
+            params: BotIdParams;
+        }, BotRemoveResult>;
+        /** Mock transport only — a live connection answers `BotTransportMismatch` (409). */
+        simulate: EntrypointProtocol<{
+            params: BotIdParams;
+            body: BotSimulateInput;
+        }, BotSimulateResult>;
+    };
+    rule: {
+        list: EntrypointProtocol<{
+            query: BotRuleListQuery;
+        }, BotRule[]>;
+        save: EntrypointProtocol<{
+            body: BotRuleInput;
+        }, BotRule>;
+        remove: EntrypointProtocol<{
+            params: BotIdParams;
+        }, BotRemoveResult>;
+    };
+    activity: {
+        /** Newest first. */
+        list: EntrypointProtocol<{
+            query: BotActivityQuery;
+        }, BotActivity[]>;
+    };
+}
+/** The platforms' inbound surface — no guard: the platform signs. */
+export interface BotHookProtocols {
+    base: EntrypointProtocol<OpenRequest, OpenValue>;
+    receive: EntrypointProtocol<{
+        params: BotHookParams;
+        body: BotHookPayload;
+    }, BotHookReply>;
+    challenge: EntrypointProtocol<{
+        params: BotHookParams;
+        query: BotChallengeQuery;
+    }, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/protocols/types.d.ts.map

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

package/build/protocols/types.js

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

package/build/protocols/types.js.map

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

package/build/protocols.d.ts

@@ -0,0 +1,21 @@
+import type { BotHookProtocolOptions, BotHookProtocols, BotProtocolOptions, BotProtocols } from './protocols/types.js';
+/**
+ * Declare one managing surface of the bot — connections, rules, activity — as an immutable tree a
+ * server binds and a client calls.
+ *
+ * Every leaf hangs under ONE base that carries the guards and the gate, so they cannot drift apart;
+ * aliases derive from `opts.base.alias` (`<alias>:connection:list` …). A target declares one tree per
+ * area that runs bots (`api:bot:operator`, `api:bot:member`) — the same leaves, another gate.
+ */
+export declare const makeBotProtocols: (opts: BotProtocolOptions) => BotProtocols;
+/**
+ * Declare the platforms' inbound surface: `receive` (POST) and `challenge` (GET) at
+ * `/:platform/:connection` under the base.
+ *
+ * NO guard and no gate, by design: the caller is the platform, and it proves itself by signing the
+ * request (Telegram's secret token, WhatsApp's app-secret HMAC, Slack's signing secret), which the
+ * server verifies against the connection's credentials. The body carries no schema — the signature
+ * covers the raw bytes, and the payload is the platform's own.
+ */
+export declare const makeBotHookProtocols: (opts: BotHookProtocolOptions) => BotHookProtocols;
+//# sourceMappingURL=protocols.d.ts.map

package/build/protocols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocols.d.ts","sourceRoot":"","sources":["../src/protocols.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAC0E,sBAAsB,EAC1G,gBAAgB,EAA6B,kBAAkB,EAAE,YAAY,EAC9E,MAAM,sBAAsB,CAAA;AAU7B;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,SAAU,kBAAkB,KAAG,YA4D3D,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,SAAU,sBAAsB,KAAG,gBAqBnE,CAAA"}