@tthr/vue 0.0.83 → 0.0.85

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();
+}

package/nuxt/runtime/server/utils/{tether.js → tether.ts}

@@ -20,13 +20,77 @@
 
 import { createError } from 'h3';
 
+// ============================================================================
+// Types
+// ============================================================================
+
+interface AssetMetadata {
+  id: string;
+  filename: string;
+  contentType: string;
+  size: number;
+  sha256: string;
+  createdAt: string;
+  metadata: Record<string, unknown>;
+}
+
+interface UploadUrlOptions {
+  filename: string;
+  contentType: string;
+  metadata?: Record<string, unknown>;
+}
+
+interface ListAssetsOptions {
+  limit?: number;
+  offset?: number;
+  contentType?: string;
+}
+
+interface TetherServerClient {
+  query: (name: string, args?: unknown) => Promise<unknown>;
+  mutation: (name: string, args?: unknown) => Promise<unknown>;
+  storage: {
+    generateUploadUrl: (options: UploadUrlOptions) => Promise<{ assetId: string; uploadUrl: string; expiresAt: string }>;
+    confirmUpload: (assetId: string, sha256?: string) => Promise<AssetMetadata>;
+    getUrl: (assetId: string) => Promise<string>;
+    getMetadata: (assetId: string) => Promise<AssetMetadata>;
+    delete: (assetId: string) => Promise<void>;
+    list: (options?: ListAssetsOptions) => Promise<{ assets: AssetMetadata[]; totalCount: number }>;
+  };
+  projectId: string;
+  url: string;
+}
+
+// ============================================================================
+// Helpers
+// ============================================================================
+
+/**
+ * Map snake_case API response to camelCase
+ */
+function mapAssetMetadata(asset: Record<string, unknown>): AssetMetadata {
+  return {
+    id: asset.id as string,
+    filename: asset.filename as string,
+    contentType: asset.content_type as string,
+    size: asset.size as number,
+    sha256: asset.sha256 as string,
+    createdAt: asset.created_at as string,
+    metadata: (asset.metadata as Record<string, unknown>) ?? {},
+  };
+}
+
+// ============================================================================
+// Main Export
+// ============================================================================
+
 /**
  * Get a Tether client for use in server-side code
  *
- * @param {unknown} _event - The H3 event (optional, used for request context)
+ * @param _event - The H3 event (optional, used for request context)
  * @returns A Tether client with query, mutation, and storage methods
  */
-export function useTetherServer(_event) {
+export function useTetherServer(_event?: unknown): TetherServerClient {
   // Use process.env directly to avoid #imports dependency
   // The Nuxt module sets NUXT_TETHER_* vars from runtime config
   const apiKey = process.env.NUXT_TETHER_API_KEY || process.env.TETHER_API_KEY;
@@ -52,7 +116,7 @@ export function useTetherServer(_event) {
     'Authorization': `Bearer ${apiKey}`,
   };
 
-  async function query(name, args) {
+  async function query(name: string, args?: unknown): Promise<unknown> {
     const response = await fetch(`${url}/api/v1/projects/${projectId}/query`, {
       method: 'POST',
       headers,
@@ -71,7 +135,7 @@ export function useTetherServer(_event) {
     return result.data;
   }
 
-  async function mutation(name, args) {
+  async function mutation(name: string, args?: unknown): Promise<unknown> {
     const response = await fetch(`${url}/api/v1/projects/${projectId}/mutation`, {
       method: 'POST',
       headers,
@@ -91,7 +155,7 @@ export function useTetherServer(_event) {
   }
 
   const storage = {
-    async generateUploadUrl(options) {
+    async generateUploadUrl(options: UploadUrlOptions) {
       const response = await fetch(`${url}/api/v1/projects/${projectId}/assets/upload-url`, {
         method: 'POST',
         headers,
@@ -112,13 +176,13 @@ export function useTetherServer(_event) {
 
       const result = await response.json();
       return {
-        assetId: result.asset_id,
-        uploadUrl: result.upload_url,
-        expiresAt: result.expires_at,
+        assetId: result.asset_id as string,
+        uploadUrl: result.upload_url as string,
+        expiresAt: result.expires_at as string,
       };
     },
 
-    async confirmUpload(assetId, sha256) {
+    async confirmUpload(assetId: string, sha256?: string) {
       const response = await fetch(`${url}/api/v1/projects/${projectId}/assets/${assetId}/complete`, {
         method: 'POST',
         headers,
@@ -137,7 +201,7 @@ export function useTetherServer(_event) {
       return mapAssetMetadata(result.asset);
     },
 
-    async getUrl(assetId) {
+    async getUrl(assetId: string): Promise<string> {
       const response = await fetch(`${url}/api/v1/projects/${projectId}/assets/${assetId}/url`, {
         method: 'GET',
         headers,
@@ -155,7 +219,7 @@ export function useTetherServer(_event) {
       return result.url;
     },
 
-    async getMetadata(assetId) {
+    async getMetadata(assetId: string): Promise<AssetMetadata> {
       const response = await fetch(`${url}/api/v1/projects/${projectId}/assets/${assetId}`, {
         method: 'GET',
         headers,
@@ -173,7 +237,7 @@ export function useTetherServer(_event) {
       return mapAssetMetadata(result.asset);
     },
 
-    async delete(assetId) {
+    async delete(assetId: string): Promise<void> {
       const response = await fetch(`${url}/api/v1/projects/${projectId}/assets/${assetId}`, {
         method: 'DELETE',
         headers,
@@ -188,7 +252,7 @@ export function useTetherServer(_event) {
       }
     },
 
-    async list(options) {
+    async list(options?: ListAssetsOptions) {
       const params = new URLSearchParams();
       if (options?.limit) params.set('limit', String(options.limit));
       if (options?.offset) params.set('offset', String(options.offset));
@@ -213,7 +277,7 @@ export function useTetherServer(_event) {
       const result = await response.json();
       return {
         assets: result.assets.map(mapAssetMetadata),
-        totalCount: result.total_count,
+        totalCount: result.total_count as number,
       };
     },
   };
@@ -226,18 +290,3 @@ export function useTetherServer(_event) {
     url,
   };
 }
-
-/**
- * Map snake_case API response to camelCase
- */
-function mapAssetMetadata(asset) {
-  return {
-    id: asset.id,
-    filename: asset.filename,
-    contentType: asset.content_type,
-    size: asset.size,
-    sha256: asset.sha256,
-    createdAt: asset.created_at,
-    metadata: asset.metadata,
-  };
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tthr/vue",
-  "version": "0.0.83",
+  "version": "0.0.85",
   "description": "Tether Vue/Nuxt SDK",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,11 +17,11 @@
     "./nuxt": {
       "import": "./nuxt/module.ts"
     },
-    "./nuxt/runtime/server/plugins/cron.js": {
-      "import": "./nuxt/runtime/server/plugins/cron.js"
+    "./nuxt/runtime/server/plugins/cron": {
+      "import": "./nuxt/runtime/server/plugins/cron.ts"
     },
-    "./nuxt/runtime/server/utils/tether.js": {
-      "import": "./nuxt/runtime/server/utils/tether.js"
+    "./nuxt/runtime/server/utils/tether": {
+      "import": "./nuxt/runtime/server/utils/tether.ts"
     }
   },
   "files": [
@@ -29,10 +29,7 @@
     "nuxt/module.ts",
     "nuxt/module.js",
     "nuxt/module.js.map",
-    "nuxt/runtime/**/*.js",
-    "nuxt/runtime/**/*.js.map",
-    "nuxt/runtime/**/*.d.ts",
-    "nuxt/runtime/**/*.d.ts.map",
+    "nuxt/runtime/**/*.ts",
     "nuxt/runtime/**/*.vue"
   ],
   "dependencies": {

package/dist/nuxt.d.ts

@@ -1,14 +0,0 @@
-/**
- * @tthr/vue/nuxt - Tether Nuxt Module
- *
- * Automatically configures Tether for Nuxt applications.
- */
-export interface TetherModuleOptions {
-    /** Project ID from Tether dashboard */
-    projectId?: string;
-    /** API endpoint (defaults to Tether Cloud) */
-    url?: string;
-}
-declare const _default: import("@nuxt/schema").NuxtModule<TetherModuleOptions, TetherModuleOptions, false>;
-export default _default;
-//# sourceMappingURL=nuxt.d.ts.map

package/dist/nuxt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"nuxt.d.ts","sourceRoot":"","sources":["../src/nuxt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;;AAED,wBA2CG"}

package/dist/nuxt.js

@@ -1,48 +0,0 @@
-/**
- * @tthr/vue/nuxt - Tether Nuxt Module
- *
- * Automatically configures Tether for Nuxt applications.
- */
-import { defineNuxtModule, addPlugin, createResolver, addImports } from '@nuxt/kit';
-export default defineNuxtModule({
-    meta: {
-        name: '@tthr/vue',
-        configKey: 'tether',
-        compatibility: {
-            nuxt: '>=3.0.0',
-        },
-    },
-    defaults: {
-        projectId: undefined,
-        url: undefined,
-    },
-    setup(options, nuxt) {
-        const resolver = createResolver(import.meta.url);
-        // Add runtime config
-        nuxt.options.runtimeConfig.public.tether = {
-            projectId: options.projectId || '',
-            url: options.url || 'https://api.tether.strands.gg',
-        };
-        // Add the plugin that initialises Tether
-        addPlugin({
-            src: resolver.resolve('./runtime/plugin'),
-            mode: 'client',
-        });
-        // Auto-import composables
-        addImports([
-            {
-                name: 'useQuery',
-                from: resolver.resolve('./runtime/composables'),
-            },
-            {
-                name: 'useMutation',
-                from: resolver.resolve('./runtime/composables'),
-            },
-            {
-                name: 'useTether',
-                from: resolver.resolve('./runtime/composables'),
-            },
-        ]);
-    },
-});
-//# sourceMappingURL=nuxt.js.map

package/dist/nuxt.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"nuxt.js","sourceRoot":"","sources":["../src/nuxt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AASpF,eAAe,gBAAgB,CAAsB;IACnD,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,QAAQ;QACnB,aAAa,EAAE;YACb,IAAI,EAAE,SAAS;SAChB;KACF;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,SAAS;QACpB,GAAG,EAAE,SAAS;KACf;IACD,KAAK,CAAC,OAAO,EAAE,IAAI;QACjB,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEjD,qBAAqB;QACrB,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,GAAG;YACzC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;YAClC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,+BAA+B;SACpD,CAAC;QAEF,yCAAyC;QACzC,SAAS,CAAC;YACR,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC;YACzC,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QAEH,0BAA0B;QAC1B,UAAU,CAAC;YACT;gBACE,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,uBAAuB,CAAC;aAChD;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,uBAAuB,CAAC;aAChD;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,uBAAuB,CAAC;aAChD;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}