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

package/build/protocols.js

@@ -0,0 +1,70 @@
+import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint';
+import { backend, route, RouteMethod } from '@owlmeans/route';
+import { BotActivityQuerySchema, BotChallengeQuerySchema, BotConnectionInputSchema, BotHookParamsSchema, BotIdParamsSchema, BotRuleInputSchema, BotRuleListQuerySchema, BotSimulateInputSchema, } from './schemas.js';
+import { botAliasUtils } from './utils/aliases.js';
+const mountOf = (base) => ({
+    ...(base.parent != null ? { parent: base.parent } : {}),
+    ...(base.service != null ? { service: base.service } : {}),
+});
+/**
+ * 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 const makeBotProtocols = (opts) => {
+    const aliases = botAliasUtils.botAliases(opts.base.alias);
+    const base = openProtocol(route(aliases.base, opts.base.path, backend(mountOf(opts.base))), {
+        ...(opts.guards != null ? { guards: opts.guards } : {}),
+        ...(opts.gates != null ? { gate: opts.gates } : {}),
+    });
+    const leaf = (alias, path, method) => route(alias, path, backend({ parent: base }, method));
+    return Object.freeze({
+        base,
+        connection: Object.freeze({
+            list: protocol(leaf(aliases.connection.list, '/connections', RouteMethod.GET), contract(typed())),
+            save: protocol(leaf(aliases.connection.save, '/connections', RouteMethod.POST), contract.request({ body: typed(BotConnectionInputSchema) }, typed())),
+            verify: protocol(leaf(aliases.connection.verify, '/connections/:id/verify', RouteMethod.POST), contract.request({ params: typed(BotIdParamsSchema) }, typed())),
+            remove: protocol(leaf(aliases.connection.remove, '/connections/:id', RouteMethod.DELETE), contract.request({ params: typed(BotIdParamsSchema) }, typed())),
+            simulate: protocol(leaf(aliases.connection.simulate, '/connections/:id/simulate', RouteMethod.POST), contract.request({
+                params: typed(BotIdParamsSchema),
+                body: typed(BotSimulateInputSchema),
+            }, typed())),
+        }),
+        rule: Object.freeze({
+            list: protocol(leaf(aliases.rule.list, '/rules', RouteMethod.GET), contract.request({ query: typed(BotRuleListQuerySchema) }, typed())),
+            save: protocol(leaf(aliases.rule.save, '/rules', RouteMethod.POST), contract.request({ body: typed(BotRuleInputSchema) }, typed())),
+            remove: protocol(leaf(aliases.rule.remove, '/rules/:id', RouteMethod.DELETE), contract.request({ params: typed(BotIdParamsSchema) }, typed())),
+        }),
+        activity: Object.freeze({
+            list: protocol(leaf(aliases.activity.list, '/activity', RouteMethod.GET), contract.request({ query: typed(BotActivityQuerySchema) }, typed())),
+        }),
+    });
+};
+/**
+ * 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 const makeBotHookProtocols = (opts) => {
+    const aliases = botAliasUtils.botHookAliases(opts.base.alias);
+    const base = openProtocol(route(aliases.base, opts.base.path, backend(mountOf(opts.base))));
+    return Object.freeze({
+        base,
+        receive: protocol(route(aliases.receive, '/:platform/:connection', backend({ parent: base }, RouteMethod.POST)), contract.request({
+            params: typed(BotHookParamsSchema),
+            body: typed(),
+        }, typed())),
+        challenge: protocol(route(aliases.challenge, '/:platform/:connection', backend({ parent: base }, RouteMethod.GET)), contract.request({
+            params: typed(BotHookParamsSchema),
+            query: typed(BotChallengeQuerySchema),
+        }, typed())),
+    });
+};
+//# sourceMappingURL=protocols.js.map

package/build/protocols.js.map

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

package/build/schemas.d.ts

@@ -0,0 +1,17 @@
+import type { JSONSchemaType } from 'ajv';
+import type { BotActivityQuery, BotChallengeQuery, BotHookParams, BotIdParams, BotRuleListQuery } from './protocols/types.js';
+import type { BotConnectionInput, BotRuleInput, BotSimulateInput } from './types.js';
+export declare const BotIdParamsSchema: JSONSchemaType<BotIdParams>;
+export declare const BotConnectionInputSchema: JSONSchemaType<BotConnectionInput>;
+export declare const BotRuleInputSchema: JSONSchemaType<BotRuleInput>;
+export declare const BotSimulateInputSchema: JSONSchemaType<BotSimulateInput>;
+export declare const BotRuleListQuerySchema: JSONSchemaType<BotRuleListQuery>;
+/** A query string arrives as text: the server coerces `limit` before this checks it. */
+export declare const BotActivityQuerySchema: JSONSchemaType<BotActivityQuery>;
+export declare const BotHookParamsSchema: JSONSchemaType<BotHookParams>;
+/**
+ * The handshake query. Open (`additionalProperties: true`): a platform adds keys at will, and a
+ * stripping validator must never drop the one the server reads.
+ */
+export declare const BotChallengeQuerySchema: JSONSchemaType<BotChallengeQuery>;
+//# sourceMappingURL=schemas.d.ts.map

package/build/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAOzC,OAAO,KAAK,EACV,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAClF,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAcpF,eAAO,MAAM,iBAAiB,6BAK5B,CAAA;AAEF,eAAO,MAAM,wBAAwB,oCAoBnC,CAAA;AAEF,eAAO,MAAM,kBAAkB,8BAqB7B,CAAA;AAEF,eAAO,MAAM,sBAAsB,kCAuCjC,CAAA;AAEF,eAAO,MAAM,sBAAsB,kCAKjC,CAAA;AAEF,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,kCAQjC,CAAA;AAEF,eAAO,MAAM,mBAAmB,+BAQ9B,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,mCASlC,CAAA"}

package/build/schemas.js

@@ -0,0 +1,140 @@
+import { BOT_ACTIVITY_LIMIT_MAX, BOT_CREDENTIAL_KEY_PATTERN, BOT_CREDENTIAL_MAX, BOT_CREDENTIALS_MAX, BOT_ID_MAX, BOT_ID_PATTERN, BOT_INSTRUCTION_MAX, BOT_KEYWORD_MAX, BOT_KEYWORDS_MAX, BOT_LABEL_MAX, BOT_NAME_MAX, BOT_REPLY_MAX, BOT_RULE_NAME_MAX, BOT_TEXT_MAX, BotChatKind, BotMatchMode, BotPlatform, BotRuleAction, BotTransport, } from './consts.js';
+/**
+ * Hand-written request schemas, cast: an optional key is OPTIONAL, never `null` — the wire matches the
+ * TypeScript type exactly. The only nullable is a rule's `connection`, whose `null` means "every
+ * connection of the scope". `additionalProperties: false` everywhere a client writes.
+ */
+const cast = (schema) => schema;
+const Id = { type: 'string', minLength: 1, maxLength: BOT_ID_MAX, pattern: BOT_ID_PATTERN };
+const Name = { type: 'string', maxLength: BOT_NAME_MAX };
+/** A platform's own id (a chat, a user, a message) — no pattern: Telegram chat ids are negative numbers. */
+const PlatformId = { type: 'string', minLength: 1, maxLength: BOT_ID_MAX };
+export const BotIdParamsSchema = cast({
+    type: 'object',
+    properties: { id: Id },
+    required: ['id'],
+    additionalProperties: false,
+});
+export const BotConnectionInputSchema = cast({
+    type: 'object',
+    properties: {
+        id: Id,
+        platform: { type: 'string', enum: Object.values(BotPlatform) },
+        label: { type: 'string', minLength: 1, maxLength: BOT_LABEL_MAX },
+        transport: { type: 'string', enum: Object.values(BotTransport) },
+        enabled: { type: 'boolean' },
+        // Write-only. An omitted key keeps its stored value; an empty string is spellable so an optional
+        // credential can be cleared.
+        credentials: {
+            type: 'object',
+            propertyNames: { pattern: BOT_CREDENTIAL_KEY_PATTERN },
+            additionalProperties: { type: 'string', maxLength: BOT_CREDENTIAL_MAX },
+            maxProperties: BOT_CREDENTIALS_MAX,
+            required: [],
+        },
+    },
+    required: ['platform', 'label'],
+    additionalProperties: false,
+});
+export const BotRuleInputSchema = cast({
+    type: 'object',
+    properties: {
+        id: Id,
+        connection: { ...Id, nullable: true },
+        name: { type: 'string', minLength: 1, maxLength: BOT_RULE_NAME_MAX },
+        keywords: {
+            type: 'array',
+            items: { type: 'string', minLength: 1, maxLength: BOT_KEYWORD_MAX },
+            minItems: 1,
+            maxItems: BOT_KEYWORDS_MAX,
+        },
+        mode: { type: 'string', enum: Object.values(BotMatchMode) },
+        action: { type: 'string', enum: Object.values(BotRuleAction) },
+        reply: { type: 'string', maxLength: BOT_REPLY_MAX },
+        instruction: { type: 'string', maxLength: BOT_INSTRUCTION_MAX },
+        enabled: { type: 'boolean' },
+        order: { type: 'number' },
+    },
+    required: ['name', 'keywords', 'action'],
+    additionalProperties: false,
+});
+export const BotSimulateInputSchema = cast({
+    type: 'object',
+    properties: {
+        text: { type: 'string', minLength: 1, maxLength: BOT_TEXT_MAX },
+        chat: {
+            type: 'object',
+            properties: {
+                id: PlatformId,
+                kind: { type: 'string', enum: Object.values(BotChatKind) },
+                title: Name,
+                thread: PlatformId,
+                space: PlatformId,
+            },
+            required: [],
+            additionalProperties: false,
+        },
+        sender: {
+            type: 'object',
+            properties: {
+                id: PlatformId,
+                name: Name,
+                username: Name,
+                bot: { type: 'boolean' },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+        replyTo: {
+            type: 'object',
+            properties: {
+                id: PlatformId,
+                text: { type: 'string', maxLength: BOT_TEXT_MAX },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+    },
+    required: ['text'],
+    additionalProperties: false,
+});
+export const BotRuleListQuerySchema = cast({
+    type: 'object',
+    properties: { connection: Id },
+    required: [],
+    additionalProperties: false,
+});
+/** A query string arrives as text: the server coerces `limit` before this checks it. */
+export const BotActivityQuerySchema = cast({
+    type: 'object',
+    properties: {
+        connection: Id,
+        limit: { type: 'integer', minimum: 1, maximum: BOT_ACTIVITY_LIMIT_MAX },
+    },
+    required: [],
+    additionalProperties: false,
+});
+export const BotHookParamsSchema = cast({
+    type: 'object',
+    properties: {
+        platform: { type: 'string', enum: Object.values(BotPlatform) },
+        connection: Id,
+    },
+    required: ['platform', 'connection'],
+    additionalProperties: false,
+});
+/**
+ * The handshake query. Open (`additionalProperties: true`): a platform adds keys at will, and a
+ * stripping validator must never drop the one the server reads.
+ */
+export const BotChallengeQuerySchema = cast({
+    type: 'object',
+    properties: {
+        'hub.mode': { type: 'string', maxLength: BOT_NAME_MAX },
+        'hub.verify_token': { type: 'string', maxLength: BOT_CREDENTIAL_MAX },
+        'hub.challenge': { type: 'string', maxLength: BOT_CREDENTIAL_MAX },
+    },
+    required: [],
+    additionalProperties: true,
+});
+//# sourceMappingURL=schemas.js.map

package/build/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,UAAU,EACvG,cAAc,EAAE,mBAAmB,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EACnG,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EACrG,YAAY,GACb,MAAM,aAAa,CAAA;AAMpB;;;;GAIG;AACH,MAAM,IAAI,GAAG,CAAI,MAAc,EAAqB,EAAE,CAAC,MAAsC,CAAA;AAE7F,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,CAAA;AAC3F,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA;AACxD,4GAA4G;AAC5G,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;AAE1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAc;IACjD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;IACtB,QAAQ,EAAE,CAAC,IAAI,CAAC;IAChB,oBAAoB,EAAE,KAAK;CAC5B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAqB;IAC/D,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,EAAE,EAAE,EAAE;QACN,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;QAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE;QACjE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;QAChE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC5B,iGAAiG;QACjG,6BAA6B;QAC7B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,aAAa,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE;YACtD,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,EAAE;YACvE,aAAa,EAAE,mBAAmB;YAClC,QAAQ,EAAE,EAAE;SACb;KACF;IACD,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,oBAAoB,EAAE,KAAK;CAC5B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAe;IACnD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,EAAE,EAAE,EAAE;QACN,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;QACrC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE;QACpE,QAAQ,EAAE;YACR,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE;YACnE,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,gBAAgB;SAC3B;QACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;QAC3D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;QAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE;QACnD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,mBAAmB,EAAE;QAC/D,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC5B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC1B;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC;IACxC,oBAAoB,EAAE,KAAK;CAC5B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAmB;IAC3D,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE;QAC/D,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,UAAU;gBACd,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;gBAC1D,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,UAAU;gBAClB,KAAK,EAAE,UAAU;aAClB;YACD,QAAQ,EAAE,EAAE;YACZ,oBAAoB,EAAE,KAAK;SAC5B;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,UAAU;gBACd,IAAI,EAAE,IAAI;gBACV,QAAQ,EAAE,IAAI;gBACd,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aACzB;YACD,QAAQ,EAAE,EAAE;YACZ,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,UAAU;gBACd,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE;aAClD;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;YAChB,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,oBAAoB,EAAE,KAAK;CAC5B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAmB;IAC3D,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IAC9B,QAAQ,EAAE,EAAE;IACZ,oBAAoB,EAAE,KAAK;CAC5B,CAAC,CAAA;AAEF,wFAAwF;AACxF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAmB;IAC3D,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,UAAU,EAAE,EAAE;QACd,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE;KACxE;IACD,QAAQ,EAAE,EAAE;IACZ,oBAAoB,EAAE,KAAK;CAC5B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAgB;IACrD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;QAC9D,UAAU,EAAE,EAAE;KACf;IACD,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;IACpC,oBAAoB,EAAE,KAAK;CAC5B,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAoB;IAC7D,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE;QACvD,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,EAAE;QACrE,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,EAAE;KACnE;IACD,QAAQ,EAAE,EAAE;IACZ,oBAAoB,EAAE,IAAI;CAC3B,CAAC,CAAA"}

package/build/types.d.ts

@@ -0,0 +1,215 @@
+import type { BotActionKind, BotChatKind, BotConnectionStatus, BotMatchMode, BotPlatform, BotReceiveMode, BotRuleAction, BotTransport, BotUpdateKind } from './consts.js';
+/** One credential a platform needs — what the panel draws an input for. */
+export interface BotCredentialField {
+    key: string;
+    /** Never shown back once saved; the connection only says the key holds a value. */
+    secret: boolean;
+    /** The connection cannot be verified without it. */
+    required: boolean;
+    /**
+     * The server creates it on save and nobody types it (WhatsApp's verify token); the connection's
+     * `setup` steps carry it for pasting into the platform console.
+     */
+    generated?: boolean;
+    /** Optional credential only: the platform calls it adds when set (Slack's admin `userToken`: `delete`). */
+    enables?: BotActionKind[];
+}
+/** What a platform needs and can do. One per platform, in `BOT_PLATFORMS`. */
+export interface BotPlatformDescriptor {
+    platform: BotPlatform;
+    title: string;
+    credentials: BotCredentialField[];
+    /** The receive modes the platform offers, preferred first. */
+    receive: BotReceiveMode[];
+    /** The platform calls the required credentials allow; `note` is never listed. */
+    actions: BotActionKind[];
+    /** `auto`: the server registers the hook itself; `manual`: a person pastes `setup` into the console. */
+    setup: 'auto' | 'manual';
+    /** Where a person learns to create the bot and its credentials. */
+    docs: string;
+}
+/** A connection as any client sees it — never a credential. */
+export interface BotConnection {
+    id: string;
+    /** The organization (or application) key the connection belongs to — the server's, never the wire's. */
+    scope: string;
+    platform: BotPlatform;
+    label: string;
+    transport: BotTransport;
+    status: BotConnectionStatus;
+    enabled: boolean;
+    /** The receive mode in effect. */
+    receive: BotReceiveMode;
+    /** Who the bot is on the platform, as verification answered. */
+    identity?: {
+        id: string;
+        username?: string;
+        name?: string;
+    };
+    /** The address the platform posts to, for webhook platforms. */
+    hookUrl?: string;
+    /** Manual steps: the URL / verify token to paste in the platform console. */
+    setup?: string[];
+    /** Which credential keys hold a value. */
+    credentialsSet: string[];
+    lastError?: string;
+    lastEventAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * A connection as a client writes it. `credentials` is write-only: an omitted key keeps its stored
+ * value.
+ */
+export interface BotConnectionInput {
+    id?: string;
+    platform: BotPlatform;
+    label: string;
+    transport?: BotTransport;
+    enabled?: boolean;
+    credentials?: Record<string, string>;
+}
+/** A chat; `space` is the Discord guild or the Slack team. */
+export interface BotChatRef {
+    id: string;
+    kind: BotChatKind;
+    title?: string;
+    thread?: string;
+    space?: string;
+}
+export interface BotSenderRef {
+    id: string;
+    name?: string;
+    username?: string;
+    bot?: boolean;
+}
+/**
+ * Enough to act on one message. `space` (the Discord guild / Slack team) is carried so a reference
+ * alone suffices where the platform addresses a member through it (a Discord timeout needs the guild).
+ */
+export interface BotMessageRef {
+    chat: string;
+    id: string;
+    thread?: string;
+    space?: string;
+}
+/** The message an update carries. */
+export interface BotReplyTarget extends BotMessageRef {
+    text?: string;
+    sender?: BotSenderRef;
+}
+export interface BotMessage {
+    ref: BotMessageRef;
+    text: string;
+    date: string;
+    replyTo?: BotReplyTarget;
+}
+/** A `/command`, its bot address stripped and its name lower-cased. */
+export interface BotCommand {
+    name: string;
+    args: string;
+}
+/** A keyword group: the keywords and what the bot does with a message that matches them. */
+export interface BotRule {
+    id: string;
+    scope: string;
+    /** One connection only; `null` or absent applies to every connection of the scope. */
+    connection?: string | null;
+    name: string;
+    keywords: string[];
+    mode: BotMatchMode;
+    action: BotRuleAction;
+    /** The fixed text of `reply` / `warn` (and the confirmation of `record`). */
+    reply?: string;
+    /** What the product's agent is told for this group. */
+    instruction?: string;
+    enabled: boolean;
+    order: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface BotRuleInput {
+    id?: string;
+    connection?: string | null;
+    name: string;
+    keywords: string[];
+    mode?: BotMatchMode;
+    action: BotRuleAction;
+    reply?: string;
+    instruction?: string;
+    enabled?: boolean;
+    order?: number;
+}
+/** A rule a message matched, with the rule's keywords (as stored) that matched it. */
+export interface BotMatch {
+    rule: BotRule;
+    keywords: string[];
+}
+/** A normalized inbound update, as a handler receives it. */
+export interface BotUpdate {
+    id: string;
+    connection: string;
+    scope: string;
+    platform: BotPlatform;
+    kind: BotUpdateKind;
+    chat: BotChatRef;
+    sender?: BotSenderRef;
+    message?: BotMessage;
+    command?: BotCommand;
+    /** A direct message, a mention of the bot, or a reply to it. */
+    addressed: boolean;
+    /** Enabled rules of the scope (and connection) the text matches, by order. */
+    matches: BotMatch[];
+    receivedAt: string;
+    raw?: unknown;
+}
+/** Whom an activity acted on. */
+export interface BotActivityTarget {
+    chat: string;
+    message?: string;
+    user?: string;
+}
+/** One thing the bot did — or tried to do — recorded whether it succeeded or not. */
+export interface BotActivity {
+    id: string;
+    scope: string;
+    connection: string;
+    platform: BotPlatform;
+    /** The update it answered. */
+    update?: string;
+    action: BotActionKind;
+    target?: BotActivityTarget;
+    text?: string;
+    /** The rule it followed. */
+    rule?: string;
+    ok: boolean;
+    /** Why it failed, as a short sentence a person reads. */
+    error?: string;
+    /**
+     * The machine marker of the failure (`bot:<marker>:<detail>`) — what code compares and what a
+     * translating view keys its copy on; never shown as is.
+     */
+    code?: string;
+    transport: BotTransport;
+    at: string;
+}
+/** A message fed to a MOCK connection through the platform's own path. */
+export interface BotSimulateInput {
+    text: string;
+    chat?: Partial<BotChatRef>;
+    sender?: Partial<BotSenderRef>;
+    replyTo?: {
+        id: string;
+        text?: string;
+    };
+}
+export interface BotSimulateResult {
+    /** The id of the update the simulated message became. */
+    update: string;
+    /**
+     * `true` when the simulated payload's dedupe key was already in the inbox: `update` is that
+     * existing row and nothing new is dispatched. `false` (or absent) for a new row.
+     */
+    duplicate?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

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

package/build/types.js

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

package/build/types.js.map

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

package/build/utils/aliases/types.d.ts

@@ -0,0 +1,30 @@
+/** The aliases one managing tree answers under — every one derived from the mount's base alias. */
+export interface BotAliases {
+    readonly base: string;
+    readonly connection: {
+        readonly list: string;
+        readonly save: string;
+        readonly verify: string;
+        readonly remove: string;
+        readonly simulate: string;
+    };
+    readonly rule: {
+        readonly list: string;
+        readonly save: string;
+        readonly remove: string;
+    };
+    readonly activity: {
+        readonly list: string;
+    };
+}
+export interface BotHookAliases {
+    readonly base: string;
+    readonly receive: string;
+    readonly challenge: string;
+}
+export interface BotAliasUtils {
+    /** Two mounts in one deployment are two base aliases, never two copies of a table. */
+    botAliases: (base: string) => BotAliases;
+    botHookAliases: (base: string) => BotHookAliases;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/utils/aliases/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/aliases/types.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAC1B,CAAA;IACD,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACxF,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAA;IACxC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,cAAc,CAAA;CACjD"}

package/build/utils/aliases/types.js

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

package/build/utils/aliases/types.js.map

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

package/build/utils/aliases.d.ts

@@ -0,0 +1,4 @@
+import type { BotAliasUtils } from './aliases/types.js';
+export declare const createBotAliasUtils: () => BotAliasUtils;
+export declare const botAliasUtils: BotAliasUtils;
+//# sourceMappingURL=aliases.d.ts.map

package/build/utils/aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../../src/utils/aliases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,aAAa,EAAkB,MAAM,oBAAoB,CAAA;AAEnF,eAAO,MAAM,mBAAmB,QAAO,aAyBtC,CAAA;AAED,eAAO,MAAM,aAAa,eAAwB,CAAA"}

package/build/utils/aliases.js

@@ -0,0 +1,26 @@
+export const createBotAliasUtils = () => {
+    const botAliases = (base) => Object.freeze({
+        base,
+        connection: Object.freeze({
+            list: `${base}:connection:list`,
+            save: `${base}:connection:save`,
+            verify: `${base}:connection:verify`,
+            remove: `${base}:connection:remove`,
+            simulate: `${base}:connection:simulate`,
+        }),
+        rule: Object.freeze({
+            list: `${base}:rule:list`,
+            save: `${base}:rule:save`,
+            remove: `${base}:rule:remove`,
+        }),
+        activity: Object.freeze({ list: `${base}:activity:list` }),
+    });
+    const botHookAliases = (base) => Object.freeze({
+        base,
+        receive: `${base}:receive`,
+        challenge: `${base}:challenge`,
+    });
+    return { botAliases, botHookAliases };
+};
+export const botAliasUtils = createBotAliasUtils();
+//# sourceMappingURL=aliases.js.map

package/build/utils/aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.js","sourceRoot":"","sources":["../../src/utils/aliases.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAkB,EAAE;IACrD,MAAM,UAAU,GAAG,CAAC,IAAY,EAAc,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QAC7D,IAAI;QACJ,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;YACxB,IAAI,EAAE,GAAG,IAAI,kBAAkB;YAC/B,IAAI,EAAE,GAAG,IAAI,kBAAkB;YAC/B,MAAM,EAAE,GAAG,IAAI,oBAAoB;YACnC,MAAM,EAAE,GAAG,IAAI,oBAAoB;YACnC,QAAQ,EAAE,GAAG,IAAI,sBAAsB;SACxC,CAAC;QACF,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,IAAI,EAAE,GAAG,IAAI,YAAY;YACzB,IAAI,EAAE,GAAG,IAAI,YAAY;YACzB,MAAM,EAAE,GAAG,IAAI,cAAc;SAC9B,CAAC;QACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,gBAAgB,EAAE,CAAC;KAC3D,CAAC,CAAA;IAEF,MAAM,cAAc,GAAG,CAAC,IAAY,EAAkB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QACrE,IAAI;QACJ,OAAO,EAAE,GAAG,IAAI,UAAU;QAC1B,SAAS,EAAE,GAAG,IAAI,YAAY;KAC/B,CAAC,CAAA;IAEF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,CAAA;AACvC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@owlmeans/bot",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.18-rc.2",
+  "license": "MIT",
+  "description": "Runtime-free, browser-safe contract of OwlMeans chat bots — platforms (Telegram, WhatsApp, Discord, Slack) and their descriptors, connections, keyword rules, normalized updates and activity, the Unicode-aware rule matcher and command parser, the operator/member and hook protocol trees with their AJV schemas, and the bot error family.",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 2 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty",
+    "test": "bun test ./tests"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@owlmeans/context": "^0.1.18-rc.35",
+    "@owlmeans/entrypoint": "^0.1.18-rc.42",
+    "@owlmeans/error": "^0.1.18-rc.39",
+    "@owlmeans/route": "^0.1.18-rc.36"
+  },
+  "peerDependencies": {
+    "ajv": "*"
+  },
+  "devDependencies": {
+    "@owlmeans/dep-config": "workspace:*",
+    "@types/bun": "^1.4.2",
+    "ajv": "^8.20.0",
+    "nodemon": "^3.1.14",
+    "typescript": "^7.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/consts.local.ts

@@ -0,0 +1,14 @@
+/**
+ * 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