@zaflun/lumio-sdk 0.2.0 → 0.3.0

package/dist/server.d.ts

@@ -1,3 +1,5 @@
+import { LumioEventType } from '@zaflun/lumio-protocol';
+
 interface Validator {
     type: string;
     isOptional: boolean;
@@ -135,4 +137,87 @@ declare function filter(field: string, op: string, value: unknown): {
     value: unknown;
 };
 
-export { type ActionDefinition, type DeleteRowDefinition, type DeleteRowOptions, type FetchActionDefinition, type FetchActionOptions, type HandlerConfig, type HandlerContext, type InsertRowDefinition, type InsertRowOptions, type MutationDefinition, type PatchRowDefinition, type PatchRowOptions, type QueryDefinition, type QueryRowsDefinition, type SchemaDefinition, type TableDefinition, type Validator, action, arg, defineSchema, defineTable, deleteRow, fetchAction, filter, identity, insertRow, mutation, patchRow, query, queryRows, secret, v };
+interface BotModuleContext {
+    auth: {
+        userId: string | null;
+        accountId: string | null;
+        role: string;
+    };
+    user: {
+        id: string;
+        name: string;
+        displayName: string;
+        platform: string;
+        role: string;
+        isMod: boolean;
+        isVip: boolean;
+        isSub: boolean;
+    } | null;
+    config: Record<string, unknown>;
+    db: {
+        get: (table: string, id: string) => Promise<Record<string, unknown> | null>;
+        list: (table: string) => Promise<Record<string, unknown>[]>;
+        insert: (table: string, row: Record<string, unknown>) => Promise<string>;
+        patch: (table: string, id: string, row: Record<string, unknown>) => Promise<void>;
+        delete: (table: string, id: string) => Promise<void>;
+    };
+    cache: {
+        get: (key: string) => Promise<unknown | null>;
+        set: (key: string, value: unknown, ttl?: number) => Promise<void>;
+        delete: (key: string) => Promise<void>;
+        increment: (key: string, by?: number) => Promise<number>;
+    };
+    secrets: {
+        get: (key: string) => Promise<string | null>;
+    };
+    fetch: (url: string, options?: RequestInit) => Promise<Response>;
+    defer: (fn: () => Promise<void>) => void;
+}
+interface HandlerResponse {
+    reply?: string;
+    actions?: Array<{
+        action: string;
+        params: Record<string, unknown>;
+    }>;
+}
+interface ModerationResponse {
+    block: boolean;
+    action?: "delete" | "timeout" | "ban";
+    duration?: number;
+    reason?: string;
+}
+interface ChatMessage {
+    text: string;
+    platformMessageId: string;
+}
+type CommandHandler = (ctx: BotModuleContext, args: string[]) => Promise<HandlerResponse | null>;
+type KeywordHandler = (ctx: BotModuleContext, message: ChatMessage) => Promise<HandlerResponse | null>;
+type PatternHandler = (ctx: BotModuleContext, message: ChatMessage, matched: string) => Promise<HandlerResponse | null>;
+type EventHandler = (ctx: BotModuleContext, event: Record<string, unknown>) => Promise<HandlerResponse | null>;
+type TimerHandler = (ctx: BotModuleContext) => Promise<HandlerResponse | null>;
+type ModerateHandler = (ctx: BotModuleContext, message: ChatMessage) => Promise<ModerationResponse>;
+declare function command(name: string, handler: CommandHandler): CommandHandler & {
+    __type: string;
+    __trigger: string;
+};
+declare function keyword(trigger: string, handler: KeywordHandler): KeywordHandler & {
+    __type: string;
+    __trigger: string;
+};
+declare function pattern(regex: string, handler: PatternHandler): PatternHandler & {
+    __type: string;
+    __trigger: string;
+};
+declare function event(eventType: LumioEventType | string, handler: EventHandler): EventHandler & {
+    __type: string;
+    __trigger: string;
+};
+declare function timer(name: string, handler: TimerHandler): TimerHandler & {
+    __type: string;
+    __trigger: string;
+};
+declare function moderate(handler: ModerateHandler): ModerateHandler & {
+    __type: string;
+};
+
+export { type ActionDefinition, type BotModuleContext, type ChatMessage, type DeleteRowDefinition, type DeleteRowOptions, type FetchActionDefinition, type FetchActionOptions, type HandlerConfig, type HandlerContext, type HandlerResponse, type InsertRowDefinition, type InsertRowOptions, type ModerationResponse, type MutationDefinition, type PatchRowDefinition, type PatchRowOptions, type QueryDefinition, type QueryRowsDefinition, type SchemaDefinition, type TableDefinition, type Validator, action, arg, command, defineSchema, defineTable, deleteRow, event, fetchAction, filter, identity, insertRow, keyword, moderate, mutation, patchRow, pattern, query, queryRows, secret, timer, v };

package/dist/server.js

@@ -112,20 +112,63 @@ function secret(name) {
 function filter(field, op, value) {
   return { __expr: "filter", field, op, value };
 }
+
+// src/server/bot-module.ts
+function command(name, handler) {
+  const fn = handler;
+  fn.__type = "command";
+  fn.__trigger = name;
+  return fn;
+}
+function keyword(trigger, handler) {
+  const fn = handler;
+  fn.__type = "keyword";
+  fn.__trigger = trigger;
+  return fn;
+}
+function pattern(regex, handler) {
+  const fn = handler;
+  fn.__type = "pattern";
+  fn.__trigger = regex;
+  return fn;
+}
+function event(eventType, handler) {
+  const fn = handler;
+  fn.__type = "event";
+  fn.__trigger = eventType;
+  return fn;
+}
+function timer(name, handler) {
+  const fn = handler;
+  fn.__type = "timer";
+  fn.__trigger = name;
+  return fn;
+}
+function moderate(handler) {
+  const fn = handler;
+  fn.__type = "moderate";
+  return fn;
+}
 export {
   action,
   arg,
+  command,
   defineSchema,
   defineTable,
   deleteRow,
+  event,
   fetchAction,
   filter,
   identity,
   insertRow,
+  keyword,
+  moderate,
   mutation,
   patchRow,
+  pattern,
   query,
   queryRows,
   secret,
+  timer,
   v
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaflun/lumio-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Lumio Extension SDK — React components, hooks, and server utilities for building Lumio extensions",
   "type": "module",
   "main": "dist/index.js",
@@ -23,7 +23,7 @@
   ],
   "dependencies": {
     "react-reconciler": "^0.32.0",
-    "@zaflun/lumio-extension-types": "0.1.0",
+    "@zaflun/lumio-extension-types": "0.3.0",
     "@zaflun/lumio-protocol": "0.1.1"
   },
   "peerDependencies": {