@tthr/vue 0.0.88 → 0.0.90

package/nuxt/module.js

@@ -60,6 +60,7 @@ export default defineNuxtModule({
         nuxt.options.runtimeConfig.public.tether = {
             projectId,
             wsUrl,
+            auth: options.auth || null,
         };
         // Add server API routes for proxying Tether requests
         // Use .js — Nitro's rollup can't parse .ts from node_modules

package/nuxt/module.ts

@@ -21,6 +21,13 @@
 
 import { defineNuxtModule, addPlugin, createResolver, addImports, addComponent, addServerHandler, addServerImports } from '@nuxt/kit';
 
+export interface TetherAuthOptions {
+  /** Where to read the auth token from */
+  mode: 'localstorage' | 'cookie';
+  /** The localStorage key or cookie name to read the token from */
+  key: string;
+}
+
 export interface TetherModuleOptions {
   /** Project ID from Tether dashboard */
   projectId?: string;
@@ -28,6 +35,8 @@ export interface TetherModuleOptions {
   url?: string;
   /** Enable verbose logging for debugging WebSocket connections */
   verbose?: boolean;
+  /** Auth token configuration — attaches the token to all tether requests */
+  auth?: TetherAuthOptions;
 }
 
 export default defineNuxtModule<TetherModuleOptions>({
@@ -75,6 +84,7 @@ export default defineNuxtModule<TetherModuleOptions>({
     (nuxt.options.runtimeConfig.public as any).tether = {
       projectId,
       wsUrl,
+      auth: options.auth || null,
     };
 
     // Add server API routes for proxying Tether requests

package/nuxt/runtime/composables.ts

@@ -25,6 +25,50 @@ function toPlainArgs<T>(value: T): T {
   return out as T;
 }
 
+/**
+ * Read auth token from the configured source and return as headers.
+ * Returns empty object if no auth is configured or no token is found.
+ *
+ * For localStorage mode, the key supports dot-notation to read nested
+ * values from JSON objects, e.g. 'strands_oauth_session.accessToken'
+ * reads localStorage key 'strands_oauth_session', parses it as JSON,
+ * then accesses the 'accessToken' property.
+ */
+function getAuthHeaders(): Record<string, string> {
+  if (typeof window === 'undefined') return {};
+  const config = (window as any).__TETHER_CONFIG__;
+  if (!config?.auth) return {};
+
+  const { mode, key } = config.auth;
+  let token: string | null = null;
+
+  if (mode === 'localstorage') {
+    const parts = key.split('.');
+    const storageKey = parts[0];
+    const raw = localStorage.getItem(storageKey);
+    if (raw && parts.length > 1) {
+      try {
+        let value: unknown = JSON.parse(raw);
+        for (let i = 1; i < parts.length; i++) {
+          value = (value as Record<string, unknown>)?.[parts[i]];
+        }
+        token = typeof value === 'string' ? value : null;
+      } catch {
+        token = null;
+      }
+    } else {
+      token = raw;
+    }
+  } else if (mode === 'cookie') {
+    const cookieKey = key.split('.')[0];
+    const match = document.cookie.match(new RegExp(`(?:^|;\\s*)${cookieKey}=([^;]*)`));
+    token = match ? decodeURIComponent(match[1]) : null;
+  }
+
+  if (!token) return {};
+  return { Authorization: `Bearer ${token}` };
+}
+
 // ============================================================================
 // Shared WebSocket Connection Manager
 // ============================================================================
@@ -309,6 +353,7 @@ export function useQuery<TArgs, TResult>(
     async () => {
       const response = await $fetch<{ data: TResult }>('/api/_tether/query', {
         method: 'POST',
+        headers: getAuthHeaders(),
         body: {
           function: queryName,
           args: plainArgs,
@@ -429,6 +474,7 @@ export async function $query<TArgs, TResult>(
 
   const response = await $fetch<{ data: TResult }>('/api/_tether/query', {
     method: 'POST',
+    headers: getAuthHeaders(),
     body: {
       function: queryName,
       args: plainArgs,
@@ -492,6 +538,7 @@ export function useMutation<TArgs, TResult>(
 
       const response = await $fetch<{ data: TResult }>('/api/_tether/mutation', {
         method: 'POST',
+        headers: getAuthHeaders(),
         body: {
           function: mutationName,
           args: toPlainArgs(args),
@@ -555,6 +602,7 @@ export async function $mutation<TArgs, TResult>(
 
   const response = await $fetch<{ data: TResult }>('/api/_tether/mutation', {
     method: 'POST',
+    headers: getAuthHeaders(),
     body: {
       function: mutationName,
       args: plainArgs,

package/nuxt/runtime/plugin.client.ts

@@ -12,6 +12,10 @@ declare global {
     __TETHER_CONFIG__?: {
       projectId: string;
       wsUrl: string;
+      auth?: {
+        mode: 'localstorage' | 'cookie';
+        key: string;
+      } | null;
     };
   }
 }
@@ -19,11 +23,12 @@ declare global {
 export default defineNuxtPlugin(() => {
   const config = useRuntimeConfig();
 
-  // Make config available for WebSocket connections
-  // This is safe - no secrets are exposed
+  // Make config available for WebSocket connections and auth
+  // This is safe - no secrets are exposed (just mode + key name)
   const tetherConfig = {
     projectId: config.public.tether?.projectId || '',
     wsUrl: config.public.tether?.wsUrl || '',
+    auth: config.public.tether?.auth || null,
   };
 
   window.__TETHER_CONFIG__ = tetherConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tthr/vue",
-  "version": "0.0.88",
+  "version": "0.0.90",
   "description": "Tether Vue/Nuxt SDK",
   "type": "module",
   "main": "./dist/index.js",