@tthr/vue 0.0.84 → 0.0.86

package/nuxt/runtime/server/utils/handler.js

@@ -0,0 +1,318 @@
+/**
+ * Shared handler utilities for Tether server routes
+ *
+ * Provides function registry loading, database proxy creation,
+ * auth context building, and logging — used by both query and mutation handlers.
+ */
+import { createError, getHeader, getCookie } from 'h3';
+import { useRuntimeConfig } from '#imports';
+// ============================================================================
+// Logging
+// ============================================================================
+let verboseLogging = false;
+const PREFIX = '[Tether]';
+export const log = {
+    debug: (...args) => { if (verboseLogging)
+        console.log(PREFIX, ...args); },
+    info: (...args) => console.log(PREFIX, ...args),
+    warn: (...args) => console.warn(PREFIX, ...args),
+    error: (...args) => console.error(PREFIX, ...args),
+};
+/**
+ * Read and validate Tether config from runtime config + env vars.
+ * Throws H3 errors if required values are missing.
+ */
+export function getConfig() {
+    const config = useRuntimeConfig();
+    verboseLogging = config.tether?.verbose || process.env.TETHER_VERBOSE === 'true';
+    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;
+    if (!apiKey) {
+        throw createError({
+            statusCode: 500,
+            message: 'Tether API key not configured. Set TETHER_API_KEY environment variable.',
+        });
+    }
+    if (!projectId) {
+        throw createError({
+            statusCode: 500,
+            message: 'Tether project ID not configured.',
+        });
+    }
+    return { apiKey, url, projectId };
+}
+let functionRegistry = null;
+let registryError = null;
+/**
+ * Load the user's custom functions from ~/tether/functions (once).
+ */
+async function loadFunctionRegistry() {
+    if (functionRegistry !== null || registryError !== null)
+        return;
+    try {
+        log.debug('Loading custom functions from ~~/tether/functions/index.ts');
+        const functions = await import('~~/tether/functions/index.ts').catch((err) => {
+            log.debug('Failed to import functions:', err.message);
+            return null;
+        });
+        if (functions) {
+            log.debug('Loaded function modules:', Object.keys(functions));
+            functionRegistry = functions;
+        }
+        else {
+            log.debug('No custom functions found, will proxy all requests');
+            functionRegistry = {};
+        }
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        log.debug('Could not load custom functions:', err.message);
+        registryError = err;
+        functionRegistry = {};
+    }
+}
+/**
+ * Look up a function by name (e.g. "channel.getMyChannels").
+ * Returns null if no custom function is registered.
+ */
+export async function lookupFunction(name) {
+    await loadFunctionRegistry();
+    if (!functionRegistry || !name)
+        return null;
+    const parts = name.split('.');
+    if (parts.length !== 2)
+        return null;
+    const [moduleName, fnName] = parts;
+    const mod = functionRegistry[moduleName];
+    if (!mod)
+        return null;
+    const fn = mod[fnName];
+    if (fn && typeof fn === 'object' && typeof fn.handler === 'function') {
+        return fn;
+    }
+    return null;
+}
+// ============================================================================
+// Database Proxy
+// ============================================================================
+/**
+ * Create a database proxy that routes calls to Tether's CRUD endpoints.
+ */
+export function createDatabaseProxy(apiKey, url, projectId) {
+    return new Proxy({}, {
+        get(_target, tableName) {
+            const makeRequest = async (operation, args) => {
+                const response = await fetch(`${url}/api/v1/projects/${projectId}/query`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Authorization': `Bearer ${apiKey}`,
+                    },
+                    body: JSON.stringify({
+                        function: `${tableName}.${operation}`,
+                        args,
+                    }),
+                });
+                if (!response.ok) {
+                    const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+                    throw new Error(error.error || `Database operation failed: ${tableName}.${operation}`);
+                }
+                const result = await response.json();
+                return result.data;
+            };
+            const makeMutation = async (operation, args) => {
+                const response = await fetch(`${url}/api/v1/projects/${projectId}/mutation`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Authorization': `Bearer ${apiKey}`,
+                    },
+                    body: JSON.stringify({
+                        function: `${tableName}.${operation}`,
+                        args,
+                    }),
+                });
+                if (!response.ok) {
+                    const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+                    throw new Error(error.error || `Database operation failed: ${tableName}.${operation}`);
+                }
+                const result = await response.json();
+                return result.data;
+            };
+            return {
+                findMany: async (options) => {
+                    const args = {};
+                    if (options?.where)
+                        args.where = options.where;
+                    if (options?.limit)
+                        args.limit = options.limit;
+                    if (options?.offset)
+                        args.offset = options.offset;
+                    if (options?.orderBy) {
+                        if (typeof options.orderBy === 'string') {
+                            args.orderBy = options.orderBy;
+                        }
+                        else if (typeof options.orderBy === 'object') {
+                            const [column, dir] = Object.entries(options.orderBy)[0] || [];
+                            if (column) {
+                                args.orderBy = column;
+                                args.orderDir = dir?.toUpperCase?.() || 'ASC';
+                            }
+                        }
+                    }
+                    if (options?.orderDir)
+                        args.orderDir = options.orderDir;
+                    return makeRequest('list', args);
+                },
+                findFirst: async (options) => {
+                    const args = { limit: 1 };
+                    if (options?.where)
+                        args.where = options.where;
+                    const results = await makeRequest('list', args);
+                    return results?.[0] ?? null;
+                },
+                findUnique: async (options) => {
+                    const args = { limit: 1 };
+                    if (options?.where)
+                        args.where = options.where;
+                    const results = await makeRequest('list', args);
+                    return results?.[0] ?? null;
+                },
+                findById: async (id) => {
+                    return makeRequest('get', { id });
+                },
+                count: async (options) => {
+                    const args = {};
+                    if (options?.where)
+                        args.where = options.where;
+                    const result = await makeRequest('count', args);
+                    return result?.count ?? 0;
+                },
+                insert: async (data) => {
+                    return makeMutation('create', { data });
+                },
+                insertMany: async (items) => {
+                    const results = [];
+                    for (const data of items) {
+                        const result = await makeMutation('create', { data });
+                        results.push(result);
+                    }
+                    return results;
+                },
+                create: async (options) => {
+                    return makeMutation('create', { data: options.data });
+                },
+                update: async (options) => {
+                    const id = options.where?._id ?? options.where?.id;
+                    if (!id) {
+                        throw new Error('Update requires an _id in the where clause');
+                    }
+                    const result = await makeMutation('update', { id, data: options.data });
+                    return result?.rowsAffected ?? 0;
+                },
+                upsert: async (options) => {
+                    const results = await makeRequest('list', { where: options.where, limit: 1 }).catch(() => []);
+                    const existing = results?.[0] ?? null;
+                    if (existing) {
+                        const id = existing._id ?? existing.id;
+                        if (!id) {
+                            throw new Error('Found record has no _id or id field for update');
+                        }
+                        await makeMutation('update', { id, data: options.update });
+                        return { ...existing, ...options.update };
+                    }
+                    else {
+                        return makeMutation('create', { data: options.create });
+                    }
+                },
+                delete: async (options) => {
+                    const id = options.where?._id ?? options.where?.id;
+                    if (id) {
+                        const result = await makeMutation('delete', { id });
+                        return result?.rowsAffected ?? 0;
+                    }
+                    const result = await makeMutation('deleteMany', { where: options.where });
+                    return result?.rowsAffected ?? 0;
+                },
+                deleteById: async (id) => {
+                    const result = await makeMutation('delete', { id });
+                    return (result?.rowsAffected ?? 0) > 0;
+                },
+            };
+        },
+    });
+}
+/**
+ * Build auth context by extracting and validating tokens from the request.
+ */
+export async function buildAuthContext(event, url, projectId) {
+    let userIdentity = null;
+    const authHeader = getHeader(event, 'authorization');
+    const strandsToken = getHeader(event, 'x-strands-token');
+    const cookieToken = getCookie(event, 'strands_oauth_token');
+    if (strandsToken || cookieToken || authHeader?.startsWith('Bearer ')) {
+        const token = strandsToken || cookieToken || authHeader?.replace('Bearer ', '');
+        if (token) {
+            try {
+                const authResponse = await fetch(`${url}/api/v1/projects/${projectId}/auth/validate`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ accessToken: token }),
+                });
+                if (authResponse.ok) {
+                    const authData = await authResponse.json();
+                    if (authData.valid) {
+                        userIdentity = {
+                            subject: authData.userId,
+                            email: authData.email,
+                            name: authData.name,
+                        };
+                    }
+                }
+            }
+            catch (authError) {
+                const err = authError instanceof Error ? authError : new Error(String(authError));
+                log.warn('Auth validation failed:', err.message);
+            }
+        }
+    }
+    const auth = {
+        getUserIdentity: async () => userIdentity,
+    };
+    const ctx = {
+        auth: {
+            userId: userIdentity?.subject ?? null,
+            claims: userIdentity ?? {},
+        },
+        userId: userIdentity?.subject ?? null,
+    };
+    return { auth, ctx };
+}
+// ============================================================================
+// Proxy to Tether API
+// ============================================================================
+/**
+ * Proxy a request directly to the Tether API (for generic CRUD when no custom function exists).
+ */
+export async function proxyToTetherApi(config, endpoint, functionName, args) {
+    const response = await fetch(`${config.url}/api/v1/projects/${config.projectId}/${endpoint}`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${config.apiKey}`,
+        },
+        body: JSON.stringify({
+            function: functionName,
+            args,
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+        throw createError({
+            statusCode: response.status,
+            message: error.error || `${endpoint === 'query' ? 'Query' : 'Mutation'} failed`,
+        });
+    }
+    return response.json();
+}

package/nuxt/runtime/server/utils/handler.ts

@@ -0,0 +1,375 @@
+/**
+ * Shared handler utilities for Tether server routes
+ *
+ * Provides function registry loading, database proxy creation,
+ * auth context building, and logging — used by both query and mutation handlers.
+ */
+
+import { createError, getHeader, getCookie, type H3Event } from 'h3';
+import { useRuntimeConfig } from '#imports';
+
+// ============================================================================
+// Logging
+// ============================================================================
+
+let verboseLogging = false;
+const PREFIX = '[Tether]';
+
+export const log = {
+  debug: (...args: unknown[]) => { if (verboseLogging) console.log(PREFIX, ...args); },
+  info: (...args: unknown[]) => console.log(PREFIX, ...args),
+  warn: (...args: unknown[]) => console.warn(PREFIX, ...args),
+  error: (...args: unknown[]) => console.error(PREFIX, ...args),
+};
+
+// ============================================================================
+// Config
+// ============================================================================
+
+export interface TetherServerConfig {
+  apiKey: string;
+  url: string;
+  projectId: string;
+}
+
+/**
+ * Read and validate Tether config from runtime config + env vars.
+ * Throws H3 errors if required values are missing.
+ */
+export function getConfig(): TetherServerConfig {
+  const config = useRuntimeConfig();
+  verboseLogging = config.tether?.verbose || process.env.TETHER_VERBOSE === 'true';
+
+  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;
+
+  if (!apiKey) {
+    throw createError({
+      statusCode: 500,
+      message: 'Tether API key not configured. Set TETHER_API_KEY environment variable.',
+    });
+  }
+
+  if (!projectId) {
+    throw createError({
+      statusCode: 500,
+      message: 'Tether project ID not configured.',
+    });
+  }
+
+  return { apiKey, url, projectId };
+}
+
+// ============================================================================
+// Function Registry
+// ============================================================================
+
+interface TetherFunction {
+  handler: (ctx: unknown) => Promise<unknown>;
+  [key: string]: unknown;
+}
+
+type FunctionRegistry = Record<string, Record<string, TetherFunction>>;
+
+let functionRegistry: FunctionRegistry | null = null;
+let registryError: Error | null = null;
+
+/**
+ * Load the user's custom functions from ~/tether/functions (once).
+ */
+async function loadFunctionRegistry(): Promise<void> {
+  if (functionRegistry !== null || registryError !== null) return;
+
+  try {
+    log.debug('Loading custom functions from ~~/tether/functions/index.ts');
+    const functions = await import('~~/tether/functions/index.ts').catch((err: Error) => {
+      log.debug('Failed to import functions:', err.message);
+      return null;
+    });
+
+    if (functions) {
+      log.debug('Loaded function modules:', Object.keys(functions));
+      functionRegistry = functions as FunctionRegistry;
+    } else {
+      log.debug('No custom functions found, will proxy all requests');
+      functionRegistry = {};
+    }
+  } catch (error: unknown) {
+    const err = error instanceof Error ? error : new Error(String(error));
+    log.debug('Could not load custom functions:', err.message);
+    registryError = err;
+    functionRegistry = {};
+  }
+}
+
+/**
+ * Look up a function by name (e.g. "channel.getMyChannels").
+ * Returns null if no custom function is registered.
+ */
+export async function lookupFunction(name: string): Promise<TetherFunction | null> {
+  await loadFunctionRegistry();
+
+  if (!functionRegistry || !name) return null;
+
+  const parts = name.split('.');
+  if (parts.length !== 2) return null;
+
+  const [moduleName, fnName] = parts;
+  const mod = functionRegistry[moduleName];
+  if (!mod) return null;
+
+  const fn = mod[fnName];
+  if (fn && typeof fn === 'object' && typeof fn.handler === 'function') {
+    return fn;
+  }
+
+  return null;
+}
+
+// ============================================================================
+// Database Proxy
+// ============================================================================
+
+/**
+ * Create a database proxy that routes calls to Tether's CRUD endpoints.
+ */
+export function createDatabaseProxy(apiKey: string, url: string, projectId: string) {
+  return new Proxy({} as Record<string, unknown>, {
+    get(_target, tableName: string) {
+      const makeRequest = async (operation: string, args: Record<string, unknown>) => {
+        const response = await fetch(`${url}/api/v1/projects/${projectId}/query`, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${apiKey}`,
+          },
+          body: JSON.stringify({
+            function: `${tableName}.${operation}`,
+            args,
+          }),
+        });
+
+        if (!response.ok) {
+          const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+          throw new Error(error.error || `Database operation failed: ${tableName}.${operation}`);
+        }
+
+        const result = await response.json();
+        return result.data;
+      };
+
+      const makeMutation = async (operation: string, args: Record<string, unknown>) => {
+        const response = await fetch(`${url}/api/v1/projects/${projectId}/mutation`, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${apiKey}`,
+          },
+          body: JSON.stringify({
+            function: `${tableName}.${operation}`,
+            args,
+          }),
+        });
+
+        if (!response.ok) {
+          const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+          throw new Error(error.error || `Database operation failed: ${tableName}.${operation}`);
+        }
+
+        const result = await response.json();
+        return result.data;
+      };
+
+      return {
+        findMany: async (options?: { where?: Record<string, unknown>; limit?: number; offset?: number; orderBy?: string | Record<string, string>; orderDir?: string }) => {
+          const args: Record<string, unknown> = {};
+          if (options?.where) args.where = options.where;
+          if (options?.limit) args.limit = options.limit;
+          if (options?.offset) args.offset = options.offset;
+          if (options?.orderBy) {
+            if (typeof options.orderBy === 'string') {
+              args.orderBy = options.orderBy;
+            } else if (typeof options.orderBy === 'object') {
+              const [column, dir] = Object.entries(options.orderBy)[0] || [];
+              if (column) {
+                args.orderBy = column;
+                args.orderDir = dir?.toUpperCase?.() || 'ASC';
+              }
+            }
+          }
+          if (options?.orderDir) args.orderDir = options.orderDir;
+          return makeRequest('list', args);
+        },
+        findFirst: async (options?: { where?: Record<string, unknown> }) => {
+          const args: Record<string, unknown> = { limit: 1 };
+          if (options?.where) args.where = options.where;
+          const results = await makeRequest('list', args);
+          return results?.[0] ?? null;
+        },
+        findUnique: async (options?: { where?: Record<string, unknown> }) => {
+          const args: Record<string, unknown> = { limit: 1 };
+          if (options?.where) args.where = options.where;
+          const results = await makeRequest('list', args);
+          return results?.[0] ?? null;
+        },
+        findById: async (id: unknown) => {
+          return makeRequest('get', { id });
+        },
+        count: async (options?: { where?: Record<string, unknown> }) => {
+          const args: Record<string, unknown> = {};
+          if (options?.where) args.where = options.where;
+          const result = await makeRequest('count', args);
+          return result?.count ?? 0;
+        },
+        insert: async (data: unknown) => {
+          return makeMutation('create', { data });
+        },
+        insertMany: async (items: unknown[]) => {
+          const results: unknown[] = [];
+          for (const data of items) {
+            const result = await makeMutation('create', { data });
+            results.push(result);
+          }
+          return results;
+        },
+        create: async (options: { data: unknown }) => {
+          return makeMutation('create', { data: options.data });
+        },
+        update: async (options: { where: Record<string, unknown>; data: unknown }) => {
+          const id = options.where?._id ?? options.where?.id;
+          if (!id) {
+            throw new Error('Update requires an _id in the where clause');
+          }
+          const result = await makeMutation('update', { id, data: options.data });
+          return result?.rowsAffected ?? 0;
+        },
+        upsert: async (options: { where: Record<string, unknown>; create: unknown; update: unknown }) => {
+          const results = await makeRequest('list', { where: options.where, limit: 1 }).catch(() => []);
+          const existing = results?.[0] ?? null;
+
+          if (existing) {
+            const id = existing._id ?? existing.id;
+            if (!id) {
+              throw new Error('Found record has no _id or id field for update');
+            }
+            await makeMutation('update', { id, data: options.update });
+            return { ...existing, ...options.update };
+          } else {
+            return makeMutation('create', { data: options.create });
+          }
+        },
+        delete: async (options: { where: Record<string, unknown> }) => {
+          const id = options.where?._id ?? options.where?.id;
+          if (id) {
+            const result = await makeMutation('delete', { id });
+            return result?.rowsAffected ?? 0;
+          }
+          const result = await makeMutation('deleteMany', { where: options.where });
+          return result?.rowsAffected ?? 0;
+        },
+        deleteById: async (id: unknown) => {
+          const result = await makeMutation('delete', { id });
+          return (result?.rowsAffected ?? 0) > 0;
+        },
+      };
+    },
+  });
+}
+
+// ============================================================================
+// Auth Context
+// ============================================================================
+
+interface UserIdentity {
+  subject: string;
+  email?: string;
+  name?: string;
+}
+
+/**
+ * Build auth context by extracting and validating tokens from the request.
+ */
+export async function buildAuthContext(event: H3Event, url: string, projectId: string) {
+  let userIdentity: UserIdentity | null = null;
+
+  const authHeader = getHeader(event, 'authorization');
+  const strandsToken = getHeader(event, 'x-strands-token');
+  const cookieToken = getCookie(event, 'strands_oauth_token');
+
+  if (strandsToken || cookieToken || authHeader?.startsWith('Bearer ')) {
+    const token = strandsToken || cookieToken || authHeader?.replace('Bearer ', '');
+    if (token) {
+      try {
+        const authResponse = await fetch(`${url}/api/v1/projects/${projectId}/auth/validate`, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ accessToken: token }),
+        });
+        if (authResponse.ok) {
+          const authData = await authResponse.json();
+          if (authData.valid) {
+            userIdentity = {
+              subject: authData.userId,
+              email: authData.email,
+              name: authData.name,
+            };
+          }
+        }
+      } catch (authError: unknown) {
+        const err = authError instanceof Error ? authError : new Error(String(authError));
+        log.warn('Auth validation failed:', err.message);
+      }
+    }
+  }
+
+  const auth = {
+    getUserIdentity: async () => userIdentity,
+  };
+
+  const ctx = {
+    auth: {
+      userId: userIdentity?.subject ?? null,
+      claims: userIdentity ?? {},
+    },
+    userId: userIdentity?.subject ?? null,
+  };
+
+  return { auth, ctx };
+}
+
+// ============================================================================
+// Proxy to Tether API
+// ============================================================================
+
+/**
+ * Proxy a request directly to the Tether API (for generic CRUD when no custom function exists).
+ */
+export async function proxyToTetherApi(
+  config: TetherServerConfig,
+  endpoint: 'query' | 'mutation',
+  functionName: string,
+  args: unknown
+) {
+  const response = await fetch(`${config.url}/api/v1/projects/${config.projectId}/${endpoint}`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${config.apiKey}`,
+    },
+    body: JSON.stringify({
+      function: functionName,
+      args,
+    }),
+  });
+
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+    throw createError({
+      statusCode: response.status,
+      message: error.error || `${endpoint === 'query' ? 'Query' : 'Mutation'} failed`,
+    });
+  }
+
+  return response.json();
+}