@botpress/runtime 1.13.8 → 1.13.10

package/dist/utilities/events.d.ts

@@ -1,5 +1,14 @@
 import { Event, Message } from '@botpress/client';
 import { WorkflowCallbackEventType } from '../runtime/events';
+import type { EventName, EventPayload } from '../_types/events';
+/**
+ * Type for a typed event with a specific event name and corresponding payload.
+ * This is used as the return type for isEventOfType type guard.
+ */
+export type TypedEvent<T extends EventName> = Event & {
+    type: T;
+    payload: EventPayload<T>;
+};
 export declare function isEvent(event: unknown): event is Event;
 export declare function isEventMessage(event: Event): event is Event & {
     type: 'message_created';
@@ -9,4 +18,23 @@ export declare function isEventMessage(event: Event): event is Event & {
 };
 export declare function isWorkflowCallback(event: unknown): event is WorkflowCallbackEventType;
 export declare function isMessage(message: unknown): message is Message;
+/**
+ * Type guard to check if an event matches a specific event type.
+ * Works with both custom events and integration events.
+ *
+ * @example
+ * // Custom event
+ * if (isEventOfType(event, 'orderPlaced')) {
+ *   // event.payload is typed as the orderPlaced schema
+ *   console.log(event.payload.orderId)
+ * }
+ *
+ * @example
+ * // Integration event
+ * if (isEventOfType(event, 'slack:reactionAdded')) {
+ *   // event.payload is typed as the slack reactionAdded event payload
+ *   console.log(event.payload.reaction)
+ * }
+ */
+export declare function isEventOfType<T extends EventName>(event: unknown, eventName: T): event is TypedEvent<T>;
 //# sourceMappingURL=events.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/utilities/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAI7D,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,GACX,KAAK,IAAI,KAAK,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,CAQ7E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAUrF;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,OAAO,CAE9D"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/utilities/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAI/D;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS,IAAI,KAAK,GAAG;IACpD,IAAI,EAAE,CAAC,CAAA;IACP,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;CACzB,CAAA;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,GACX,KAAK,IAAI,KAAK,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,CAQ7E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAUrF;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,OAAO,CAE9D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,CAEvG"}

package/dist/utilities/validate-event-name.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Validates an event name according to ADK rules:
+ * - Only alphanumeric characters (A-Z, a-z, 0-9) and underscores
+ * - Maximum 100 characters
+ * - Must start with a letter
+ * - No special characters
+ */
+export declare function validateEventName(name: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validates all event names in an events definition object
+ * Throws an error if any event name is invalid
+ */
+export declare function validateEventDefinitions(events: Record<string, {
+    schema?: unknown;
+    description?: string | undefined;
+}>, context: string): void;
+//# sourceMappingURL=validate-event-name.d.ts.map

package/dist/utilities/validate-event-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-event-name.d.ts","sourceRoot":"","sources":["../../src/utilities/validate-event-name.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAqBlF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,EAC9E,OAAO,EAAE,MAAM,GACd,IAAI,CAON"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botpress/runtime",
-  "version": "1.13.8",
+  "version": "1.13.10",
   "description": "Lightweight runtime library for ADK-based Botpress agents",
   "type": "module",
   "files": [
@@ -81,7 +81,7 @@
     "fast-safe-stringify": "^2.1.1",
     "fast-xml-parser": "^5.3.3",
     "glob": "^11.1.0",
-    "llmz": "^0.0.35",
+    "llmz": "^0.0.37",
     "lodash": "^4.17.21",
     "ms": "^2.1.3",
     "object-sizeof": "^2.6.5",

package/dist/utilities/trigger-tags.d.ts

@@ -1,31 +0,0 @@
-/**
- * Gets the tag name for a trigger
- * @param triggerName - The name of the trigger
- * @returns The tag name in format "trigger[5-char-hash]"
- */
-export declare const getTriggerTagName: (triggerName: string) => string;
-/**
- * Gets the tag value for a specific trigger match
- * @param key - The specific key from the trigger match result, or undefined for wildcard
- * @returns The tag value - either the specific key or "*" for wildcard
- */
-export declare const getTriggerTagValue: (key?: string) => string;
-/**
- * Helper to subscribe a conversation to a trigger
- * @param triggerName - The name of the trigger to subscribe to
- * @param key - Optional specific key to subscribe to (omit for wildcard subscription)
- * @returns Object with tagName and tagValue to use for subscription
- */
-export declare const getTriggerSubscriptionTags: (triggerName: string, key?: string) => {
-    name: string;
-    value: string;
-};
-/**
- * Checks if a conversation should handle a trigger event based on its tags
- * @param conversationTags - The tags on the conversation
- * @param triggerName - The name of the trigger that fired
- * @param triggerKey - The key from the trigger match result
- * @returns true if the conversation is subscribed to this trigger event
- */
-export declare const isConversationSubscribedToTrigger: (conversationTags: Record<string, string>, triggerName: string, triggerKey?: string) => boolean;
-//# sourceMappingURL=trigger-tags.d.ts.map

package/dist/utilities/trigger-tags.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trigger-tags.d.ts","sourceRoot":"","sources":["../../src/utilities/trigger-tags.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,aAAa,MAAM,KAAG,MAEvD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MAEjD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAI,aAAa,MAAM,EAAE,MAAM,MAAM;;;CAK3E,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,GAC5C,kBAAkB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,aAAa,MAAM,EACnB,aAAa,MAAM,KAClB,OAUF,CAAA"}