@tthr/vue 0.0.29 → 0.0.31

package/nuxt/runtime/server/mutation.post.js

@@ -3,7 +3,7 @@
  * Executes local custom functions or proxies generic CRUD to Tether API
  */
 
-import { defineEventHandler, readBody, createError, getHeader } from 'h3';
+import { defineEventHandler, readBody, createError, getHeader, setResponseStatus } from 'h3';
 import { useRuntimeConfig } from '#imports';
 
 // Dynamic function registry - populated on first request
@@ -316,11 +316,13 @@ export default defineEventHandler(async (event) => {
       return { data: result };
     } catch (error) {
       console.error(`[Tether] Mutation ${body.function} failed:`, error);
-      throw createError({
-        statusCode: 500,
+      // Return JSON error response instead of throwing (avoids proxy HTML error pages)
+      setResponseStatus(event, 400);
+      return {
+        error: true,
         message: error.message || 'Mutation execution failed',
-        data: { function: body.function, error: String(error) },
-      });
+        function: body.function,
+      };
     }
   }
 

package/nuxt/runtime/server/plugins/cron.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Nuxt server plugin for Tether cron execution
+ *
+ * This plugin automatically connects to Tether via WebSocket as a server connection
+ * to receive cron triggers. When a cron is due, Tether sends a trigger message,
+ * this plugin executes the function, and reports the result back.
+ *
+ * The connection is secured with the API key and only server connections
+ * (identified by ?type=server) receive cron triggers.
+ */
+/**
+ * Register a cron handler for a specific function
+ *
+ * @example
+ * ```ts
+ * // In your Nuxt server setup
+ * import { registerCronHandler } from '#imports';
+ *
+ * registerCronHandler('reports.generate', async (args) => {
+ *   // Your function logic here
+ *   return { generated: true };
+ * });
+ * ```
+ */
+export declare function registerCronHandler(functionName: string, handler: (args: unknown) => Promise<unknown>): void;
+/**
+ * Unregister a cron handler
+ */
+export declare function unregisterCronHandler(functionName: string): void;
+/**
+ * Get all registered cron handlers
+ */
+export declare function getCronHandlers(): string[];
+declare const _default: any;
+export default _default;
+//# sourceMappingURL=cron.d.ts.map

package/nuxt/runtime/server/plugins/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["cron.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsBH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAC3C,IAAI,CAGN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;;AAqPD,wBA+BG"}

package/nuxt/runtime/server/plugins/cron.js

@@ -0,0 +1,268 @@
+/**
+ * Nuxt server plugin for Tether cron execution
+ *
+ * This plugin automatically connects to Tether via WebSocket as a server connection
+ * to receive cron triggers. When a cron is due, Tether sends a trigger message,
+ * this plugin executes the function, and reports the result back.
+ *
+ * The connection is secured with the API key and only server connections
+ * (identified by ?type=server) receive cron triggers.
+ */
+import { defineNitroPlugin } from 'nitropack/runtime';
+import { useRuntimeConfig } from '#imports';
+// Store for registered cron handlers
+const cronHandlers = new Map();
+// WebSocket connection state
+let ws = null;
+let connectionId = null;
+let reconnectAttempts = 0;
+let heartbeatTimer = null;
+let heartbeatTimeoutTimer = null;
+let awaitingPong = false;
+let shouldReconnect = true;
+const MAX_RECONNECT_ATTEMPTS = 10;
+const HEARTBEAT_INTERVAL = 30000;
+const HEARTBEAT_TIMEOUT = 10000;
+const RECONNECT_DELAY = 1000;
+/**
+ * Register a cron handler for a specific function
+ *
+ * @example
+ * ```ts
+ * // In your Nuxt server setup
+ * import { registerCronHandler } from '#imports';
+ *
+ * registerCronHandler('reports.generate', async (args) => {
+ *   // Your function logic here
+ *   return { generated: true };
+ * });
+ * ```
+ */
+export function registerCronHandler(functionName, handler) {
+    cronHandlers.set(functionName, handler);
+    console.log(`[Tether Cron] Registered handler for: ${functionName}`);
+}
+/**
+ * Unregister a cron handler
+ */
+export function unregisterCronHandler(functionName) {
+    cronHandlers.delete(functionName);
+}
+/**
+ * Get all registered cron handlers
+ */
+export function getCronHandlers() {
+    return Array.from(cronHandlers.keys());
+}
+function getWsUrl(config) {
+    const base = config.url
+        .replace('https://', 'wss://')
+        .replace('http://', 'ws://')
+        .replace(/\/$/, '');
+    const env = config.environment;
+    let wsPath;
+    if (env && env !== 'production') {
+        wsPath = `${base}/ws/${config.projectId}/${env}`;
+    }
+    else {
+        wsPath = `${base}/ws/${config.projectId}`;
+    }
+    // Add type=server to identify as server connection and token for auth
+    return `${wsPath}?type=server&token=${encodeURIComponent(config.apiKey)}`;
+}
+async function reportExecution(config, trigger, result, durationMs) {
+    const base = config.url.replace(/\/$/, '');
+    const env = config.environment;
+    let apiPath;
+    if (env && env !== 'production') {
+        apiPath = `${base}/api/v1/projects/${config.projectId}/env/${env}`;
+    }
+    else {
+        apiPath = `${base}/api/v1/projects/${config.projectId}`;
+    }
+    const url = `${apiPath}/crons/${trigger.cronId}/executions`;
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.apiKey}`,
+            },
+            body: JSON.stringify({
+                executionId: trigger.executionId,
+                success: result.success,
+                errorMessage: result.error,
+                result: result.result,
+                durationMs,
+            }),
+        });
+        if (!response.ok) {
+            console.error(`[Tether Cron] Failed to report execution: ${response.status} ${response.statusText}`);
+        }
+        else {
+            console.log(`[Tether Cron] Reported execution ${trigger.executionId}: ${result.success ? 'success' : 'failed'}`);
+        }
+    }
+    catch (error) {
+        console.error('[Tether Cron] Failed to report execution:', error);
+    }
+}
+async function handleCronTrigger(config, trigger) {
+    console.log(`[Tether Cron] Received trigger for ${trigger.functionName} (execution: ${trigger.executionId})`);
+    const startTime = Date.now();
+    const handler = cronHandlers.get(trigger.functionName);
+    if (!handler) {
+        console.warn(`[Tether Cron] No handler registered for: ${trigger.functionName}`);
+        const durationMs = Date.now() - startTime;
+        await reportExecution(config, trigger, {
+            success: false,
+            error: `No handler registered for function: ${trigger.functionName}`,
+        }, durationMs);
+        return;
+    }
+    try {
+        const result = await handler(trigger.args);
+        const durationMs = Date.now() - startTime;
+        await reportExecution(config, trigger, {
+            success: true,
+            result,
+        }, durationMs);
+    }
+    catch (error) {
+        const durationMs = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`[Tether Cron] Handler error for ${trigger.functionName}:`, errorMessage);
+        await reportExecution(config, trigger, {
+            success: false,
+            error: errorMessage,
+        }, durationMs);
+    }
+}
+function startHeartbeat() {
+    stopHeartbeat();
+    heartbeatTimer = setInterval(() => {
+        if (ws?.readyState === WebSocket.OPEN) {
+            awaitingPong = true;
+            ws.send(JSON.stringify({ type: 'ping' }));
+            heartbeatTimeoutTimer = setTimeout(() => {
+                if (awaitingPong) {
+                    console.warn('[Tether Cron] Heartbeat timeout - forcing reconnect');
+                    ws?.close();
+                }
+            }, HEARTBEAT_TIMEOUT);
+        }
+    }, HEARTBEAT_INTERVAL);
+}
+function stopHeartbeat() {
+    if (heartbeatTimer) {
+        clearInterval(heartbeatTimer);
+        heartbeatTimer = null;
+    }
+    if (heartbeatTimeoutTimer) {
+        clearTimeout(heartbeatTimeoutTimer);
+        heartbeatTimeoutTimer = null;
+    }
+    awaitingPong = false;
+}
+function connect(config) {
+    if (ws?.readyState === WebSocket.OPEN || ws?.readyState === WebSocket.CONNECTING) {
+        return;
+    }
+    try {
+        const url = getWsUrl(config);
+        // Use ws package for Node.js
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const WebSocketImpl = typeof WebSocket !== 'undefined' ? WebSocket : require('ws');
+        ws = new WebSocketImpl(url);
+        ws.onopen = () => {
+            reconnectAttempts = 0;
+            console.log('[Tether Cron] WebSocket connected');
+        };
+        ws.onmessage = async (event) => {
+            const data = typeof event.data === 'string' ? event.data : event.data.toString();
+            try {
+                const message = JSON.parse(data);
+                switch (message.type) {
+                    case 'connected':
+                        connectionId = message.connection_id ?? null;
+                        startHeartbeat();
+                        console.log(`[Tether Cron] Connected with ID: ${connectionId}`);
+                        break;
+                    case 'cron_trigger':
+                        await handleCronTrigger(config, message);
+                        break;
+                    case 'pong':
+                        awaitingPong = false;
+                        if (heartbeatTimeoutTimer) {
+                            clearTimeout(heartbeatTimeoutTimer);
+                            heartbeatTimeoutTimer = null;
+                        }
+                        break;
+                    case 'error':
+                        console.error('[Tether Cron] Server error:', message.error);
+                        break;
+                }
+            }
+            catch (e) {
+                console.error('[Tether Cron] Failed to parse message:', e);
+            }
+        };
+        ws.onerror = (error) => {
+            const err = error instanceof Error ? error : new Error('WebSocket error');
+            console.error('[Tether Cron] WebSocket error:', err.message);
+        };
+        ws.onclose = () => {
+            connectionId = null;
+            stopHeartbeat();
+            console.log('[Tether Cron] WebSocket disconnected');
+            handleReconnect(config);
+        };
+    }
+    catch (error) {
+        console.error('[Tether Cron] Failed to connect:', error);
+        handleReconnect(config);
+    }
+}
+function handleReconnect(config) {
+    if (!shouldReconnect) {
+        return;
+    }
+    if (reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
+        console.error('[Tether Cron] Max reconnection attempts reached');
+        return;
+    }
+    reconnectAttempts++;
+    const delay = Math.min(RECONNECT_DELAY * Math.pow(2, reconnectAttempts - 1), 30000);
+    console.log(`[Tether Cron] Reconnecting in ${delay}ms (attempt ${reconnectAttempts}/${MAX_RECONNECT_ATTEMPTS})`);
+    setTimeout(() => {
+        connect(config);
+    }, delay);
+}
+export default defineNitroPlugin((nitro) => {
+    // Get config from runtime config
+    const config = useRuntimeConfig();
+    const apiKey = config.tether?.apiKey || process.env.TETHER_API_KEY;
+    const url = config.tether?.url || process.env.TETHER_URL || 'https://tether-api.strands.gg';
+    const projectId = config.tether?.projectId || process.env.TETHER_PROJECT_ID;
+    // Only connect if we have all required config
+    if (!apiKey || !projectId) {
+        console.log('[Tether Cron] Missing config (apiKey or projectId) - cron connection disabled');
+        return;
+    }
+    console.log('[Tether Cron] Initialising cron connection...');
+    // Connect on next tick to allow handlers to be registered first
+    process.nextTick(() => {
+        connect({ url, projectId, apiKey });
+    });
+    // Clean up on shutdown
+    nitro.hooks.hook('close', () => {
+        shouldReconnect = false;
+        stopHeartbeat();
+        if (ws) {
+            ws.close();
+            ws = null;
+        }
+        console.log('[Tether Cron] Connection closed');
+    });
+});
+//# sourceMappingURL=cron.js.map

package/nuxt/runtime/server/plugins/cron.js.map

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

package/nuxt/runtime/server/plugins/cron.ts

@@ -0,0 +1,342 @@
+/**
+ * Nuxt server plugin for Tether cron execution
+ *
+ * This plugin automatically connects to Tether via WebSocket as a server connection
+ * to receive cron triggers. When a cron is due, Tether sends a trigger message,
+ * this plugin executes the function, and reports the result back.
+ *
+ * The connection is secured with the API key and only server connections
+ * (identified by ?type=server) receive cron triggers.
+ */
+
+import { defineNitroPlugin } from 'nitropack/runtime';
+import { useRuntimeConfig } from '#imports';
+
+// Store for registered cron handlers
+const cronHandlers: Map<string, (args: unknown) => Promise<unknown>> = new Map();
+
+// WebSocket connection state
+let ws: WebSocket | null = null;
+let connectionId: string | null = null;
+let reconnectAttempts = 0;
+let heartbeatTimer: ReturnType<typeof setInterval> | null = null;
+let heartbeatTimeoutTimer: ReturnType<typeof setTimeout> | null = null;
+let awaitingPong = false;
+let shouldReconnect = true;
+
+const MAX_RECONNECT_ATTEMPTS = 10;
+const HEARTBEAT_INTERVAL = 30000;
+const HEARTBEAT_TIMEOUT = 10000;
+const RECONNECT_DELAY = 1000;
+
+/**
+ * Register a cron handler for a specific function
+ *
+ * @example
+ * ```ts
+ * // In your Nuxt server setup
+ * import { registerCronHandler } from '#imports';
+ *
+ * registerCronHandler('reports.generate', async (args) => {
+ *   // Your function logic here
+ *   return { generated: true };
+ * });
+ * ```
+ */
+export function registerCronHandler(
+  functionName: string,
+  handler: (args: unknown) => Promise<unknown>
+): void {
+  cronHandlers.set(functionName, handler);
+  console.log(`[Tether Cron] Registered handler for: ${functionName}`);
+}
+
+/**
+ * Unregister a cron handler
+ */
+export function unregisterCronHandler(functionName: string): void {
+  cronHandlers.delete(functionName);
+}
+
+/**
+ * Get all registered cron handlers
+ */
+export function getCronHandlers(): string[] {
+  return Array.from(cronHandlers.keys());
+}
+
+interface CronTriggerMessage {
+  type: 'cron_trigger';
+  executionId: string;
+  cronId: string;
+  functionName: string;
+  functionType: string;
+  args?: unknown;
+}
+
+interface ServerMessage {
+  type: 'connected' | 'cron_trigger' | 'pong' | 'error';
+  connection_id?: string;
+  server_time?: string;
+  executionId?: string;
+  cronId?: string;
+  functionName?: string;
+  functionType?: string;
+  args?: unknown;
+  error?: { code: string; message: string };
+}
+
+function getWsUrl(config: { url: string; projectId: string; apiKey: string; environment?: string }): string {
+  const base = config.url
+    .replace('https://', 'wss://')
+    .replace('http://', 'ws://')
+    .replace(/\/$/, '');
+
+  const env = config.environment;
+  let wsPath: string;
+
+  if (env && env !== 'production') {
+    wsPath = `${base}/ws/${config.projectId}/${env}`;
+  } else {
+    wsPath = `${base}/ws/${config.projectId}`;
+  }
+
+  // Add type=server to identify as server connection and token for auth
+  return `${wsPath}?type=server&token=${encodeURIComponent(config.apiKey)}`;
+}
+
+async function reportExecution(
+  config: { url: string; projectId: string; apiKey: string; environment?: string },
+  trigger: CronTriggerMessage,
+  result: { success: boolean; result?: unknown; error?: string },
+  durationMs: number
+): Promise<void> {
+  const base = config.url.replace(/\/$/, '');
+  const env = config.environment;
+
+  let apiPath: string;
+  if (env && env !== 'production') {
+    apiPath = `${base}/api/v1/projects/${config.projectId}/env/${env}`;
+  } else {
+    apiPath = `${base}/api/v1/projects/${config.projectId}`;
+  }
+
+  const url = `${apiPath}/crons/${trigger.cronId}/executions`;
+
+  try {
+    const response = await fetch(url, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${config.apiKey}`,
+      },
+      body: JSON.stringify({
+        executionId: trigger.executionId,
+        success: result.success,
+        errorMessage: result.error,
+        result: result.result,
+        durationMs,
+      }),
+    });
+
+    if (!response.ok) {
+      console.error(`[Tether Cron] Failed to report execution: ${response.status} ${response.statusText}`);
+    } else {
+      console.log(`[Tether Cron] Reported execution ${trigger.executionId}: ${result.success ? 'success' : 'failed'}`);
+    }
+  } catch (error) {
+    console.error('[Tether Cron] Failed to report execution:', error);
+  }
+}
+
+async function handleCronTrigger(
+  config: { url: string; projectId: string; apiKey: string; environment?: string },
+  trigger: CronTriggerMessage
+): Promise<void> {
+  console.log(`[Tether Cron] Received trigger for ${trigger.functionName} (execution: ${trigger.executionId})`);
+
+  const startTime = Date.now();
+  const handler = cronHandlers.get(trigger.functionName);
+
+  if (!handler) {
+    console.warn(`[Tether Cron] No handler registered for: ${trigger.functionName}`);
+    const durationMs = Date.now() - startTime;
+    await reportExecution(config, trigger, {
+      success: false,
+      error: `No handler registered for function: ${trigger.functionName}`,
+    }, durationMs);
+    return;
+  }
+
+  try {
+    const result = await handler(trigger.args);
+    const durationMs = Date.now() - startTime;
+
+    await reportExecution(config, trigger, {
+      success: true,
+      result,
+    }, durationMs);
+  } catch (error) {
+    const durationMs = Date.now() - startTime;
+    const errorMessage = error instanceof Error ? error.message : String(error);
+
+    console.error(`[Tether Cron] Handler error for ${trigger.functionName}:`, errorMessage);
+
+    await reportExecution(config, trigger, {
+      success: false,
+      error: errorMessage,
+    }, durationMs);
+  }
+}
+
+function startHeartbeat(): void {
+  stopHeartbeat();
+
+  heartbeatTimer = setInterval(() => {
+    if (ws?.readyState === WebSocket.OPEN) {
+      awaitingPong = true;
+      ws.send(JSON.stringify({ type: 'ping' }));
+
+      heartbeatTimeoutTimer = setTimeout(() => {
+        if (awaitingPong) {
+          console.warn('[Tether Cron] Heartbeat timeout - forcing reconnect');
+          ws?.close();
+        }
+      }, HEARTBEAT_TIMEOUT);
+    }
+  }, HEARTBEAT_INTERVAL);
+}
+
+function stopHeartbeat(): void {
+  if (heartbeatTimer) {
+    clearInterval(heartbeatTimer);
+    heartbeatTimer = null;
+  }
+  if (heartbeatTimeoutTimer) {
+    clearTimeout(heartbeatTimeoutTimer);
+    heartbeatTimeoutTimer = null;
+  }
+  awaitingPong = false;
+}
+
+function connect(config: { url: string; projectId: string; apiKey: string; environment?: string }): void {
+  if (ws?.readyState === WebSocket.OPEN || ws?.readyState === WebSocket.CONNECTING) {
+    return;
+  }
+
+  try {
+    const url = getWsUrl(config);
+
+    // Use ws package for Node.js
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const WebSocketImpl = typeof WebSocket !== 'undefined' ? WebSocket : require('ws');
+    ws = new WebSocketImpl(url);
+
+    ws!.onopen = () => {
+      reconnectAttempts = 0;
+      console.log('[Tether Cron] WebSocket connected');
+    };
+
+    ws!.onmessage = async (event: { data: string | Buffer }) => {
+      const data = typeof event.data === 'string' ? event.data : event.data.toString();
+
+      try {
+        const message = JSON.parse(data) as ServerMessage;
+
+        switch (message.type) {
+          case 'connected':
+            connectionId = message.connection_id ?? null;
+            startHeartbeat();
+            console.log(`[Tether Cron] Connected with ID: ${connectionId}`);
+            break;
+
+          case 'cron_trigger':
+            await handleCronTrigger(config, message as CronTriggerMessage);
+            break;
+
+          case 'pong':
+            awaitingPong = false;
+            if (heartbeatTimeoutTimer) {
+              clearTimeout(heartbeatTimeoutTimer);
+              heartbeatTimeoutTimer = null;
+            }
+            break;
+
+          case 'error':
+            console.error('[Tether Cron] Server error:', message.error);
+            break;
+        }
+      } catch (e) {
+        console.error('[Tether Cron] Failed to parse message:', e);
+      }
+    };
+
+    ws!.onerror = (error: Event | Error) => {
+      const err = error instanceof Error ? error : new Error('WebSocket error');
+      console.error('[Tether Cron] WebSocket error:', err.message);
+    };
+
+    ws!.onclose = () => {
+      connectionId = null;
+      stopHeartbeat();
+      console.log('[Tether Cron] WebSocket disconnected');
+      handleReconnect(config);
+    };
+  } catch (error) {
+    console.error('[Tether Cron] Failed to connect:', error);
+    handleReconnect(config);
+  }
+}
+
+function handleReconnect(config: { url: string; projectId: string; apiKey: string; environment?: string }): void {
+  if (!shouldReconnect) {
+    return;
+  }
+
+  if (reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
+    console.error('[Tether Cron] Max reconnection attempts reached');
+    return;
+  }
+
+  reconnectAttempts++;
+  const delay = Math.min(RECONNECT_DELAY * Math.pow(2, reconnectAttempts - 1), 30000);
+
+  console.log(`[Tether Cron] Reconnecting in ${delay}ms (attempt ${reconnectAttempts}/${MAX_RECONNECT_ATTEMPTS})`);
+
+  setTimeout(() => {
+    connect(config);
+  }, delay);
+}
+
+export default defineNitroPlugin((nitro) => {
+  // Get config from runtime config
+  const config = useRuntimeConfig();
+
+  const apiKey = config.tether?.apiKey || process.env.TETHER_API_KEY;
+  const url = config.tether?.url || process.env.TETHER_URL || 'https://tether-api.strands.gg';
+  const projectId = config.tether?.projectId || process.env.TETHER_PROJECT_ID;
+
+  // Only connect if we have all required config
+  if (!apiKey || !projectId) {
+    console.log('[Tether Cron] Missing config (apiKey or projectId) - cron connection disabled');
+    return;
+  }
+
+  console.log('[Tether Cron] Initialising cron connection...');
+
+  // Connect on next tick to allow handlers to be registered first
+  process.nextTick(() => {
+    connect({ url, projectId, apiKey });
+  });
+
+  // Clean up on shutdown
+  nitro.hooks.hook('close', () => {
+    shouldReconnect = false;
+    stopHeartbeat();
+    if (ws) {
+      ws.close();
+      ws = null;
+    }
+    console.log('[Tether Cron] Connection closed');
+  });
+});