@tthr/vue 0.0.16 → 0.0.18

package/dist/server.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @tthr/vue/server - Server-side Tether client for Nuxt
+ *
+ * Use this in Nuxt server/api routes for webhooks, third-party integrations,
+ * and any server-side logic that needs to call Tether queries/mutations.
+ */
+import { TetherServerClient, type TetherServerClientOptions } from '@tthr/client';
+export { TetherServerClient, type TetherServerClientOptions } from '@tthr/client';
+/**
+ * Configure the server-side Tether client.
+ * Call this once in your Nuxt server plugin or at the top of your API routes.
+ *
+ * @example
+ * ```typescript
+ * // server/plugins/tether.ts
+ * import { configureTetherServer } from '@tthr/vue/server';
+ *
+ * export default defineNitroPlugin(() => {
+ *   configureTetherServer({
+ *     url: process.env.TETHER_URL!,
+ *     projectId: process.env.TETHER_PROJECT_ID!,
+ *     apiKey: process.env.TETHER_API_KEY,
+ *   });
+ * });
+ * ```
+ */
+export declare function configureTetherServer(options: TetherServerClientOptions): void;
+/**
+ * Get the configured server-side Tether client.
+ *
+ * @example
+ * ```typescript
+ * // server/api/users.get.ts
+ * import { useTetherServer } from '@tthr/vue/server';
+ *
+ * export default defineEventHandler(async () => {
+ *   const tether = useTetherServer();
+ *   return await tether.query('users.list');
+ * });
+ * ```
+ */
+export declare function useTetherServer(): TetherServerClient;
+/**
+ * Create a new server-side Tether client instance.
+ * Use this when you need a separate client with different configuration.
+ *
+ * @example
+ * ```typescript
+ * // server/api/webhook.ts
+ * import { createTetherServer } from '@tthr/vue/server';
+ *
+ * const tether = createTetherServer({
+ *   url: process.env.TETHER_URL!,
+ *   projectId: process.env.TETHER_PROJECT_ID!,
+ *   apiKey: process.env.TETHER_API_KEY,
+ * });
+ *
+ * export default defineEventHandler(async (event) => {
+ *   const users = await tether.query('users.list');
+ *   return { users };
+ * });
+ * ```
+ */
+export declare function createTetherServer(options: TetherServerClientOptions): TetherServerClient;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAGlF,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAKlF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAE9E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,IAAI,kBAAkB,CAQpD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAEzF"}

package/dist/server.js

@@ -0,0 +1,78 @@
+/**
+ * @tthr/vue/server - Server-side Tether client for Nuxt
+ *
+ * Use this in Nuxt server/api routes for webhooks, third-party integrations,
+ * and any server-side logic that needs to call Tether queries/mutations.
+ */
+import { TetherServerClient } from '@tthr/client';
+// Re-export the server client and types for convenience
+export { TetherServerClient } from '@tthr/client';
+// Singleton client instance
+let serverClient = null;
+/**
+ * Configure the server-side Tether client.
+ * Call this once in your Nuxt server plugin or at the top of your API routes.
+ *
+ * @example
+ * ```typescript
+ * // server/plugins/tether.ts
+ * import { configureTetherServer } from '@tthr/vue/server';
+ *
+ * export default defineNitroPlugin(() => {
+ *   configureTetherServer({
+ *     url: process.env.TETHER_URL!,
+ *     projectId: process.env.TETHER_PROJECT_ID!,
+ *     apiKey: process.env.TETHER_API_KEY,
+ *   });
+ * });
+ * ```
+ */
+export function configureTetherServer(options) {
+    serverClient = new TetherServerClient(options);
+}
+/**
+ * Get the configured server-side Tether client.
+ *
+ * @example
+ * ```typescript
+ * // server/api/users.get.ts
+ * import { useTetherServer } from '@tthr/vue/server';
+ *
+ * export default defineEventHandler(async () => {
+ *   const tether = useTetherServer();
+ *   return await tether.query('users.list');
+ * });
+ * ```
+ */
+export function useTetherServer() {
+    if (!serverClient) {
+        throw new Error('Tether server client not configured. Call configureTetherServer() first, ' +
+            'typically in a Nitro plugin (server/plugins/tether.ts).');
+    }
+    return serverClient;
+}
+/**
+ * Create a new server-side Tether client instance.
+ * Use this when you need a separate client with different configuration.
+ *
+ * @example
+ * ```typescript
+ * // server/api/webhook.ts
+ * import { createTetherServer } from '@tthr/vue/server';
+ *
+ * const tether = createTetherServer({
+ *   url: process.env.TETHER_URL!,
+ *   projectId: process.env.TETHER_PROJECT_ID!,
+ *   apiKey: process.env.TETHER_API_KEY,
+ * });
+ *
+ * export default defineEventHandler(async (event) => {
+ *   const users = await tether.query('users.list');
+ *   return { users };
+ * });
+ * ```
+ */
+export function createTetherServer(options) {
+    return new TetherServerClient(options);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAkC,MAAM,cAAc,CAAC;AAElF,wDAAwD;AACxD,OAAO,EAAE,kBAAkB,EAAkC,MAAM,cAAc,CAAC;AAElF,4BAA4B;AAC5B,IAAI,YAAY,GAA8B,IAAI,CAAC;AAEnD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAkC;IACtE,YAAY,GAAG,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,2EAA2E;YAC3E,yDAAyD,CAC1D,CAAC;IACJ,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAkC;IACnE,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/nuxt/module.ts

@@ -65,13 +65,13 @@ export default defineNuxtModule<TetherModuleOptions>({
     addServerHandler({
       route: '/api/_tether/query',
       method: 'post',
-      handler: resolver.resolve('./runtime/server/query.post.ts'),
+      handler: resolver.resolve('./runtime/server/query.post.js'),
     });
 
     addServerHandler({
       route: '/api/_tether/mutation',
       method: 'post',
-      handler: resolver.resolve('./runtime/server/mutation.post.ts'),
+      handler: resolver.resolve('./runtime/server/mutation.post.js'),
     });
 
     // Add the client plugin for WebSocket subscriptions only

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

@@ -21,94 +21,13 @@
 import { createError } from 'h3';
 import { useRuntimeConfig } from '#imports';
 
-export interface TetherServerClient {
-  /**
-   * Execute a query on the Tether server
-   */
-  query: <TResult = unknown>(
-    name: string,
-    args?: Record<string, unknown>
-  ) => Promise<TResult>;
-
-  /**
-   * Execute a mutation on the Tether server
-   */
-  mutation: <TResult = unknown>(
-    name: string,
-    args?: Record<string, unknown>
-  ) => Promise<TResult>;
-
-  /**
-   * File storage operations
-   */
-  storage: {
-    /**
-     * Generate a presigned upload URL
-     */
-    generateUploadUrl: (options: {
-      filename: string;
-      contentType: string;
-      metadata?: Record<string, unknown>;
-    }) => Promise<{ assetId: string; uploadUrl: string; expiresAt: string }>;
-
-    /**
-     * Confirm an upload has completed
-     */
-    confirmUpload: (assetId: string, sha256?: string) => Promise<AssetMetadata>;
-
-    /**
-     * Get a presigned download URL for an asset
-     */
-    getUrl: (assetId: string) => Promise<string>;
-
-    /**
-     * Get metadata for an asset
-     */
-    getMetadata: (assetId: string) => Promise<AssetMetadata>;
-
-    /**
-     * Delete an asset
-     */
-    delete: (assetId: string) => Promise<void>;
-
-    /**
-     * List assets with optional pagination and filtering
-     */
-    list: (options?: {
-      limit?: number;
-      offset?: number;
-      contentType?: string;
-    }) => Promise<{ assets: AssetMetadata[]; totalCount: number }>;
-  };
-
-  /**
-   * The project ID
-   */
-  projectId: string;
-
-  /**
-   * The API URL
-   */
-  url: string;
-}
-
-export interface AssetMetadata {
-  id: string;
-  filename: string;
-  contentType: string;
-  size: number;
-  sha256?: string;
-  createdAt: string;
-  metadata?: Record<string, unknown>;
-}
-
 /**
  * Get a Tether client for use in server-side code
  *
- * @param event - The H3 event (optional, used for request context)
+ * @param {unknown} _event - The H3 event (optional, used for request context)
  * @returns A Tether client with query, mutation, and storage methods
  */
-export function useTetherServer(_event?: unknown): TetherServerClient {
+export function useTetherServer(_event) {
   const config = useRuntimeConfig();
 
   const apiKey = config.tether?.apiKey || process.env.TETHER_API_KEY;
@@ -134,10 +53,7 @@ export function useTetherServer(_event?: unknown): TetherServerClient {
     'Authorization': `Bearer ${apiKey}`,
   };
 
-  async function query<TResult = unknown>(
-    name: string,
-    args?: Record<string, unknown>
-  ): Promise<TResult> {
+  async function query(name, args) {
     const response = await fetch(`${url}/api/v1/projects/${projectId}/query`, {
       method: 'POST',
       headers,
@@ -153,13 +69,10 @@ export function useTetherServer(_event?: unknown): TetherServerClient {
     }
 
     const result = await response.json();
-    return result.data as TResult;
+    return result.data;
   }
 
-  async function mutation<TResult = unknown>(
-    name: string,
-    args?: Record<string, unknown>
-  ): Promise<TResult> {
+  async function mutation(name, args) {
     const response = await fetch(`${url}/api/v1/projects/${projectId}/mutation`, {
       method: 'POST',
       headers,
@@ -175,15 +88,11 @@ export function useTetherServer(_event?: unknown): TetherServerClient {
     }
 
     const result = await response.json();
-    return result.data as TResult;
+    return result.data;
   }
 
   const storage = {
-    async generateUploadUrl(options: {
-      filename: string;
-      contentType: string;
-      metadata?: Record<string, unknown>;
-    }) {
+    async generateUploadUrl(options) {
       const response = await fetch(`${url}/api/v1/projects/${projectId}/assets/upload-url`, {
         method: 'POST',
         headers,
@@ -210,7 +119,7 @@ export function useTetherServer(_event?: unknown): TetherServerClient {
       };
     },
 
-    async confirmUpload(assetId: string, sha256?: string): Promise<AssetMetadata> {
+    async confirmUpload(assetId, sha256) {
       const response = await fetch(`${url}/api/v1/projects/${projectId}/assets/${assetId}/complete`, {
         method: 'POST',
         headers,
@@ -229,7 +138,7 @@ export function useTetherServer(_event?: unknown): TetherServerClient {
       return mapAssetMetadata(result.asset);
     },
 
-    async getUrl(assetId: string): Promise<string> {
+    async getUrl(assetId) {
       const response = await fetch(`${url}/api/v1/projects/${projectId}/assets/${assetId}/url`, {
         method: 'GET',
         headers,
@@ -247,7 +156,7 @@ export function useTetherServer(_event?: unknown): TetherServerClient {
       return result.url;
     },
 
-    async getMetadata(assetId: string): Promise<AssetMetadata> {
+    async getMetadata(assetId) {
       const response = await fetch(`${url}/api/v1/projects/${projectId}/assets/${assetId}`, {
         method: 'GET',
         headers,
@@ -265,7 +174,7 @@ export function useTetherServer(_event?: unknown): TetherServerClient {
       return mapAssetMetadata(result.asset);
     },
 
-    async delete(assetId: string): Promise<void> {
+    async delete(assetId) {
       const response = await fetch(`${url}/api/v1/projects/${projectId}/assets/${assetId}`, {
         method: 'DELETE',
         headers,
@@ -280,11 +189,7 @@ export function useTetherServer(_event?: unknown): TetherServerClient {
       }
     },
 
-    async list(options?: {
-      limit?: number;
-      offset?: number;
-      contentType?: string;
-    }): Promise<{ assets: AssetMetadata[]; totalCount: number }> {
+    async list(options) {
       const params = new URLSearchParams();
       if (options?.limit) params.set('limit', String(options.limit));
       if (options?.offset) params.set('offset', String(options.offset));
@@ -326,14 +231,14 @@ export function useTetherServer(_event?: unknown): TetherServerClient {
 /**
  * Map snake_case API response to camelCase
  */
-function mapAssetMetadata(asset: Record<string, unknown>): AssetMetadata {
+function mapAssetMetadata(asset) {
   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 | undefined,
-    createdAt: asset.created_at as string,
-    metadata: asset.metadata as Record<string, unknown> | undefined,
+    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.16",
+  "version": "0.0.18",
   "description": "Tether Vue/Nuxt SDK",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,6 +10,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
     "./nuxt": {
       "import": "./nuxt/module.ts"
     }