@botpress/runtime 1.13.9 → 1.13.11

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.9",
+  "version": "1.13.11",
   "description": "Lightweight runtime library for ADK-based Botpress agents",
   "type": "module",
   "files": [