@tthr/vue 0.0.80 → 0.0.82

package/nuxt/module.ts

@@ -110,6 +110,14 @@ export default defineNuxtModule<TetherModuleOptions>({
         name: 'useTetherSubscription',
         from: resolver.resolve('./runtime/composables'),
       },
+      {
+        name: '$query',
+        from: resolver.resolve('./runtime/composables'),
+      },
+      {
+        name: '$mutation',
+        from: resolver.resolve('./runtime/composables'),
+      },
     ]);
 
     // Auto-import components

package/nuxt/runtime/composables.d.ts

@@ -16,6 +16,12 @@ export interface QueryState<T> {
     isConnected: Ref<boolean>;
     refetch: () => Promise<void>;
 }
+/**
+ * Thenable query state — can be awaited or destructured directly.
+ * When awaited, resolves after the initial fetch completes (data is populated).
+ * When destructured without await, data starts as undefined and populates reactively.
+ */
+export type AsyncQueryState<T> = QueryState<T> & PromiseLike<QueryState<T>>;
 /**
  * Query function reference
  */
@@ -31,15 +37,33 @@ export interface QueryFunction<TArgs = void, TResult = unknown> {
  * Data is fetched on the server and hydrated on the client.
  * Automatically subscribes to WebSocket updates for realtime sync.
  *
+ * Can be used with or without await:
+ *
  * @example
  * ```vue
  * <script setup>
- * // That's it! Data automatically updates when it changes anywhere
+ * // Reactive — data fills in asynchronously, updates in realtime
  * const { data: posts, isLoading, isConnected } = useQuery(api.posts.list);
+ *
+ * // Awaited — data is populated when the promise resolves, still updates in realtime
+ * const { data: posts } = await useQuery(api.posts.list);
  * </script>
  * ```
  */
-export declare function useQuery<TArgs, TResult>(query: QueryFunction<TArgs, TResult> | string, args?: TArgs): QueryState<TResult>;
+export declare function useQuery<TArgs, TResult>(query: QueryFunction<TArgs, TResult> | string, args?: TArgs): AsyncQueryState<TResult>;
+/**
+ * Execute a query and return raw data directly.
+ *
+ * Unlike useQuery, this does NOT set up reactive state or WebSocket subscriptions.
+ * Use this in event handlers, utilities, or anywhere you need a one-shot data fetch.
+ * Proxies through the Nuxt server route to keep API keys secure.
+ *
+ * @example
+ * ```ts
+ * const messages = await $query(api.messages.listByChannel, { channelId });
+ * ```
+ */
+export declare function $query<TArgs, TResult>(query: QueryFunction<TArgs, TResult> | string, args?: TArgs): Promise<TResult>;
 /**
  * Mutation state returned by useMutation
  */
@@ -74,6 +98,19 @@ export interface MutationFunction<TArgs = void, TResult = unknown> {
  * ```
  */
 export declare function useMutation<TArgs, TResult>(mutation: MutationFunction<TArgs, TResult> | string): MutationState<TArgs, TResult>;
+/**
+ * Execute a mutation and return the result directly.
+ *
+ * Unlike useMutation, this does NOT set up reactive state.
+ * Use this in event handlers, utilities, or anywhere you need a one-shot mutation.
+ * Proxies through the Nuxt server route to keep API keys secure.
+ *
+ * @example
+ * ```ts
+ * const post = await $mutation(api.posts.create, { title: 'Hello' });
+ * ```
+ */
+export declare function $mutation<TArgs, TResult>(mutation: MutationFunction<TArgs, TResult> | string, args?: TArgs): Promise<TResult>;
 /**
  * Subscription handler options
  */
@@ -103,4 +140,3 @@ export interface SubscriptionHandlers {
 export declare function useTetherSubscription(queryName: string, args: Record<string, unknown> | undefined, handlers: SubscriptionHandlers | ((data?: unknown) => void)): {
     isConnected: Ref<boolean>;
 };
-//# sourceMappingURL=composables.d.ts.map

package/nuxt/runtime/server/mutation.post.js

@@ -218,10 +218,12 @@ function createDatabaseProxy(apiKey, url, projectId) {
           const whereObj = options.where;
           // Support both _id (standard) and id (legacy) in where clause
           const id = whereObj?._id ?? whereObj?.id;
-          if (!id) {
-            throw new Error('Delete requires an _id in the where clause');
+          if (id) {
+            const result = await makeMutation('delete', { id });
+            return result?.rowsAffected ?? 0;
           }
-          const result = await makeMutation('delete', { id });
+          // Compound where clause — use deleteMany
+          const result = await makeMutation('deleteMany', { where: whereObj });
           return result?.rowsAffected ?? 0;
         },
         deleteById: async (id) => {

package/nuxt/runtime/server/query.post.js

@@ -218,10 +218,12 @@ function createDatabaseProxy(apiKey, url, projectId) {
           const whereObj = options.where;
           // Support both _id (standard) and id (legacy) in where clause
           const id = whereObj?._id ?? whereObj?.id;
-          if (!id) {
-            throw new Error('Delete requires an _id in the where clause');
+          if (id) {
+            const result = await makeMutation('delete', { id });
+            return result?.rowsAffected ?? 0;
           }
-          const result = await makeMutation('delete', { id });
+          // Compound where clause — use deleteMany
+          const result = await makeMutation('deleteMany', { where: whereObj });
           return result?.rowsAffected ?? 0;
         },
         deleteById: async (id) => {

package/package.json

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