@tthr/vue 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @tthr/vue - Tether Vue/Nuxt SDK
+ *
+ * Reactive data fetching and mutations for Vue and Nuxt applications.
+ */
+import { type Ref, type App } from 'vue';
+import { TetherClient, type TetherClientOptions } from '@tthr/client';
+/**
+ * Tether plugin for Vue/Nuxt
+ */
+export declare const TetherPlugin: {
+    install(app: App, options: TetherClientOptions): void;
+    configure(options: TetherClientOptions): void;
+};
+/**
+ * Get the Tether client instance
+ */
+export declare function useTether(): TetherClient;
+/**
+ * Query state returned by useQuery
+ */
+export interface QueryState<T> {
+    data: Ref<T | undefined>;
+    error: Ref<Error | null>;
+    isLoading: Ref<boolean>;
+    refetch: () => Promise<void>;
+}
+/**
+ * Query function reference
+ */
+export interface QueryFunction<TArgs = void, TResult = unknown> {
+    _name: string;
+    _args?: TArgs;
+    _result?: TResult;
+}
+/**
+ * Reactive query composable
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useQuery } from '@tthr/vue';
+ * import { api } from '../_generated/api';
+ *
+ * const posts = useQuery(api.posts.list);
+ * </script>
+ * ```
+ */
+export declare function useQuery<TArgs, TResult>(query: QueryFunction<TArgs, TResult>, args?: TArgs): QueryState<TResult>;
+/**
+ * Mutation state returned by useMutation
+ */
+export interface MutationState<TArgs, TResult> {
+    data: Ref<TResult | undefined>;
+    error: Ref<Error | null>;
+    isPending: Ref<boolean>;
+    mutate: (args: TArgs) => Promise<TResult>;
+    reset: () => void;
+}
+/**
+ * Mutation function reference
+ */
+export interface MutationFunction<TArgs = void, TResult = unknown> {
+    _name: string;
+    _args?: TArgs;
+    _result?: TResult;
+}
+/**
+ * Mutation composable
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useMutation } from '@tthr/vue';
+ * import { api } from '../_generated/api';
+ *
+ * const createPost = useMutation(api.posts.create);
+ * await createPost.mutate({ title: 'Hello', content: '...' });
+ * </script>
+ * ```
+ */
+export declare function useMutation<TArgs, TResult>(mutation: MutationFunction<TArgs, TResult>): MutationState<TArgs, TResult>;
+export type { TetherClientOptions } from '@tthr/client';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA+B,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAKtE;;GAEG;AACH,eAAO,MAAM,YAAY;iBACV,GAAG,WAAW,mBAAmB;uBAK3B,mBAAmB;CAGvC,CAAC;AAEF;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAKxC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACzB,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACzB,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACxB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,GAAG,OAAO;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EACrC,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,EACpC,IAAI,CAAC,EAAE,KAAK,GACX,UAAU,CAAC,OAAO,CAAC,CA4CrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,EAAE,OAAO;IAC3C,IAAI,EAAE,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/B,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACzB,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,GAAG,OAAO;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EACxC,QAAQ,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,GACzC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAmC/B;AAGD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,132 @@
+/**
+ * @tthr/vue - Tether Vue/Nuxt SDK
+ *
+ * Reactive data fetching and mutations for Vue and Nuxt applications.
+ */
+import { ref, onMounted, onUnmounted } from 'vue';
+import { TetherClient } from '@tthr/client';
+// Global client instance
+let globalClient = null;
+/**
+ * Tether plugin for Vue/Nuxt
+ */
+export const TetherPlugin = {
+    install(app, options) {
+        globalClient = new TetherClient(options);
+        app.provide('tether', globalClient);
+    },
+    configure(options) {
+        globalClient = new TetherClient(options);
+    },
+};
+/**
+ * Get the Tether client instance
+ */
+export function useTether() {
+    if (!globalClient) {
+        throw new Error('Tether client not initialised. Call TetherPlugin.configure() first.');
+    }
+    return globalClient;
+}
+/**
+ * Reactive query composable
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useQuery } from '@tthr/vue';
+ * import { api } from '../_generated/api';
+ *
+ * const posts = useQuery(api.posts.list);
+ * </script>
+ * ```
+ */
+export function useQuery(query, args) {
+    const data = ref();
+    const error = ref(null);
+    const isLoading = ref(true);
+    let unsubscribe = null;
+    const fetchData = async () => {
+        try {
+            isLoading.value = true;
+            error.value = null;
+            const client = useTether();
+            const result = await client.query(query._name, args);
+            data.value = result;
+        }
+        catch (e) {
+            error.value = e instanceof Error ? e : new Error(String(e));
+        }
+        finally {
+            isLoading.value = false;
+        }
+    };
+    onMounted(async () => {
+        await fetchData();
+        // Subscribe to updates
+        const client = useTether();
+        unsubscribe = client.subscribe(query._name, args, (newData) => {
+            data.value = newData;
+        });
+    });
+    onUnmounted(() => {
+        if (unsubscribe) {
+            unsubscribe();
+        }
+    });
+    return {
+        data: data,
+        error,
+        isLoading,
+        refetch: fetchData,
+    };
+}
+/**
+ * Mutation composable
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useMutation } from '@tthr/vue';
+ * import { api } from '../_generated/api';
+ *
+ * const createPost = useMutation(api.posts.create);
+ * await createPost.mutate({ title: 'Hello', content: '...' });
+ * </script>
+ * ```
+ */
+export function useMutation(mutation) {
+    const data = ref();
+    const error = ref(null);
+    const isPending = ref(false);
+    const mutate = async (args) => {
+        try {
+            isPending.value = true;
+            error.value = null;
+            const client = useTether();
+            const result = await client.mutation(mutation._name, args);
+            data.value = result;
+            return result;
+        }
+        catch (e) {
+            error.value = e instanceof Error ? e : new Error(String(e));
+            throw e;
+        }
+        finally {
+            isPending.value = false;
+        }
+    };
+    const reset = () => {
+        data.value = undefined;
+        error.value = null;
+        isPending.value = false;
+    };
+    return {
+        data: data,
+        error,
+        isPending,
+        mutate,
+        reset,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@tthr/vue",
+  "version": "0.0.1",
+  "description": "Tether Vue/Nuxt SDK",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@tthr/client": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  },
+  "peerDependencies": {
+    "vue": "^3.5.0"
+  }
+}