nuxt-feathers-zod 6.3.0 → 6.3.2

package/README.md

@@ -1,312 +1,193 @@
-# nuxt-feathers-zod 
-[guide](https://vevedh.github.io/nuxt-feathers-zod/)
+# nuxt-feathers-zod
 
-### Guide officiel d’initialisation – Nuxt 4 (Bun, Feathers v5, Zod)
+[Documentation](https://vevedh.github.io/nuxt-feathers-zod/)
 
-Ce guide décrit **la seule procédure valide et supportée** pour initialiser correctement **nuxt-feathers-zod** dans un projet **Nuxt 4**, en se basant **strictement sur le comportement réel du module**.
+`nuxt-feathers-zod` is a Nuxt 4 module that integrates **FeathersJS v5 (Dove)** with a **CLI-first** workflow and a Zod-oriented service generation approach.
 
-Il évite volontairement toute “magie implicite” ou création manuelle non supportée.
+It supports two main usage patterns:
 
----
+- **embedded mode**: a Feathers server runs inside Nuxt/Nitro
+- **remote mode**: a Nuxt app uses a Feathers client against an external API
 
-## 1. Objectif du module
+## What is already in the open source core
 
-`nuxt-feathers-zod` permet d’embarquer un **backend FeathersJS v5 (Dove)** directement dans **Nitro**, avec :
+- Nuxt 4 + Nitro integration
+- embedded and remote modes
+- REST and Socket.IO transports
+- embedded server with **Express** or **Koa**
+- CLI bootstrap for `init embedded`, `init remote`, `init templates`
+- CLI service generation with `add service`
+- adapter-less service generation with `add service --custom`
+- remote-service registration with `add remote-service`
+- local/JWT auth flows
+- Keycloak SSO bridge
+- optional legacy Swagger support
+- template overrides
+- embedded server modules
+- client-side helpers with Pinia / feathers-pinia support
 
-* API REST (`/feathers/*`)
-* WebSocket (Socket.IO)
-* Validation **Zod-first**
-* Authentification **Local + JWT**
-* Adapters (MongoDB, Memory, etc.)
-* Swagger legacy (optionnel)
-* Composables client (`useService`, `useAuth`, stores Pinia)
-
-👉 Il **n’y a pas de backend séparé** : Feathers est monté **dans Nuxt**.
-
----
-
-## 2. Pré-requis
-
-* **Bun** (recommandé et supporté)
-* **Node.js ≥ 18**
-* **Nuxt 4**
-* MongoDB (optionnel mais recommandé)
-
----
-
-## 3. Création du projet Nuxt 4
+## Installation
 
 ```bash
-bunx nuxi@latest init my-site
-cd my-site
-bun install
-bun run dev
+bun add nuxt-feathers-zod feathers-pinia
+bun add -D @pinia/nuxt
 ```
 
-➡️ Vérifie que Nuxt démarre **avant toute intégration Feathers**.
+Optional Swagger dependencies:
 
----
-
-## 4. Installation des dépendances
+```bash
+bun add feathers-swagger swagger-ui-dist
+```
 
-### 4.1 Module principal
+## Recommended quick start — new Nuxt 4 app in embedded mode
 
 ```bash
+bunx nuxi@latest init my-nfz-app
+cd my-nfz-app
+bun install
 bun add nuxt-feathers-zod feathers-pinia
+bun add -D @pinia/nuxt
+bunx nuxt-feathers-zod init embedded --force
+bunx nuxt-feathers-zod add service users
+bun dev
 ```
 
-### 4.2 (Optionnel) Swagger legacy
+## Embedded mode with local auth
 
 ```bash
-bun add feathers-swagger swagger-ui-dist
-```
-
-> ⚠️ `swagger-ui-dist` est requis si `feathers.swagger = true`
-
----
-
-## 5. Configuration **obligatoire** (`nuxt.config.ts`)
-
-> ⚠️ **Cette configuration est critique**.
-> Une mauvaise initialisation provoque des erreurs bloquantes au démarrage.
-
-```ts
-export default defineNuxtConfig({
-  modules: ['nuxt-feathers-zod'],
-
-  feathers: {
-    /**
-     * RÈGLE D’OR :
-     * Le module scanne UNIQUEMENT ces dossiers
-     */
-    servicesDirs: ['services'],
-
-    /**
-     * Transports
-     */
-    transports: {
-      rest: {
-        path: '/feathers',
-        framework: 'koa',
-      },
-      websocket: true,
-    },
-
-    /**
-     * Base de données (MongoDB recommandé)
-     */
-    database: {
-      mongo: {
-        url: 'mongodb://127.0.0.1:27017/my-site',
-      },
-    },
-
-    /**
-     * Authentification
-     */
-    auth: true,
-
-    /**
-     * Swagger legacy (optionnel)
-     */
-    swagger: false,
-  },
-})
+bunx nuxi@latest init my-nfz-auth
+cd my-nfz-auth
+bun install
+bun add nuxt-feathers-zod feathers-pinia feathers-swagger swagger-ui-dist
+bun add -D @pinia/nuxt
+bunx nuxt-feathers-zod init embedded --force --auth --swagger
+bunx nuxt-feathers-zod add service users --auth --adapter mongodb --collection users --idField _id --docs
+bun dev
 ```
 
----
-
-## 6. RÈGLE FONDAMENTALE – À NE JAMAIS VIOLER
-
-> ❌ **Ne jamais créer un service manuellement**
-> ✅ **Toujours utiliser la CLI officielle**
-
-Cette règle est **imposée par le code interne du module**.
-
----
-
-## 7. Création du premier service : `users` (OBLIGATOIRE)
+## Remote mode quick start
 
 ```bash
-bunx nuxt-feathers-zod add service users \
-  --adapter mongodb \
-  --auth \
-  --idField _id \
-  --docs
+bunx nuxi@latest init my-nfz-remote
+cd my-nfz-remote
+bun install
+bun add nuxt-feathers-zod feathers-pinia
+bun add -D @pinia/nuxt
+bunx nuxt-feathers-zod init remote --url https://api.example.com --transport socketio --force
+bunx nuxt-feathers-zod add remote-service users --path users --methods find,get,create,patch,remove
+bun dev
 ```
 
-### Structure générée (attendue)
+## Canonical CLI commands
 
-```
-services/users/
-  users.ts
-  users.class.ts
-  users.schema.ts
-  users.shared.ts
+```bash
+bunx nuxt-feathers-zod init embedded --force
+bunx nuxt-feathers-zod init remote --url https://api.example.com --transport rest --force
+bunx nuxt-feathers-zod add service users --adapter mongodb --collection users --idField _id
+bunx nuxt-feathers-zod add service actions --custom --methods find --customMethods run,preview
+bunx nuxt-feathers-zod add remote-service users --path users --methods find,get
+bunx nuxt-feathers-zod doctor
 ```
 
-### Pourquoi `users` est obligatoire ?
+## Open source core boundary
 
-* Le module **résout l’authentification** via une `entityClass` nommée **`User`**
-* Cette classe est **recherchée dynamiquement** dans les exports scannés
-* Sans ce service :
+The project is being stabilized around a predictable **standard open source core**.
 
-  * `Services typeExports []`
-  * `Entity class User not found in services imports`
-  * **Boot impossible**
+That core currently includes:
 
-👉 Le service `users` est la **clé de voûte** de tout projet `nuxt-feathers-zod`.
+- runtime + transports
+- auth basics
+- CLI generation
+- template overrides
+- server modules
+- docs and playground validation
 
----
+Potential future **license-key / Pro** candidates are intentionally kept outside that frozen core, such as advanced visual consoles, premium diagnostics, builders, enterprise presets, and packaged RBAC/policy layers.
 
-## 8. Création d’un service métier (exemple : `articles`)
+## Development commands
 
 ```bash
-bunx nuxt-feathers-zod add service articles \
-  --adapter mongodb \
-  --auth \
-  --idField _id \
-  --docs
+bun install
+bun run build
+bun run typecheck
+bun run docs:dev
+bun run docs:build
 ```
 
-Structure :
 
-```
-services/articles/
-  articles.ts
-  articles.class.ts
-  articles.schema.ts
-  articles.shared.ts
-```
+## Quality gates
 
----
+The repository includes a standard open-source CI workflow on GitHub Actions.
+It validates the main surfaces of the module:
 
-## 9. Démarrage et tests REST
+- install dependencies with Bun
+- lint the repository
+- run the template sanity check
+- build the Nuxt module
+- build the playground application
+- build the VitePress documentation
 
-```bash
-bun run dev
-```
+The workflow file is located at `.github/workflows/ci.yml`.
 
-### 9.1 Création d’un utilisateur
+## Release process
 
-```bash
-curl -X POST http://localhost:3000/feathers/users \
-  -H "Content-Type: application/json" \
-  -d '{"userId":"demo","password":"demo123"}'
-```
+The repository now includes two GitHub Actions workflows:
 
-### 9.2 Authentification
-
-```bash
-curl -X POST http://localhost:3000/feathers/authentication \
-  -H "Content-Type: application/json" \
-  -d '{"strategy":"local","userId":"demo","password":"demo123"}'
-```
+- `.github/workflows/ci.yml` for the standard open-source validation gates
+- `.github/workflows/publish.yml` for validated npm publication on tag or manual trigger
 
-### 9.3 Accès à un service protégé
+Manual release checklist:
 
 ```bash
-curl http://localhost:3000/feathers/articles \
-  -H "Authorization: Bearer <ACCESS_TOKEN>"
+bun install
+bun run lint
+bun run sanity:templates
+bun run prepare
+bun run build
+bun run docs:build
+npm pack --dry-run
 ```
 
----
-
-## 10. Swagger legacy (optionnel)
-
-### 10.1 Activer Swagger
+Then publish with either:
 
-```ts
-feathers: {
-  swagger: true,
-}
+```bash
+npm version patch
+npm publish --access public
 ```
 
-### 10.2 Accès
-
-* UI :
-  `http://localhost:3000/feathers/docs/`
-* Spec :
-  `http://localhost:3000/feathers/swagger.json`
-
-### ⚠️ Important
-
-Dans l’UI Swagger, la spec doit être définie manuellement à :
+or:
 
+```bash
+npm version prerelease --preid beta
+npm publish --tag beta --access public
 ```
-../swagger.json
-```
-
-(C’est un comportement connu et assumé du module.)
-
----
 
-## 11. Plugins serveur Feathers (seed, hooks globaux)
+Public documentation builds intentionally exclude internal guide pages such as `open-core` and `playground` in production builds.
 
-### Exemple : `server/feathers/dummy.ts`
+## Publishing to npm
 
-```ts
-import { defineFeathersServerPlugin } from 'nuxt-feathers-zod/server'
-
-export default defineFeathersServerPlugin((app) => {
-  app.hooks({
-    setup: [
-      async (context, next) => {
-        await context.app.service('users').create({
-          userId: 'admin',
-          password: 'admin123',
-        })
-        await next()
-      },
-    ],
-  })
-})
+```bash
+npm login
+bun install
+bun run build
+npm pack --dry-run
+npm version patch
+npm publish --access public
 ```
 
-➡️ Ces fichiers sont des **plugins Feathers**, pas des services.
-
----
-
-## 12. Erreurs courantes et causes réelles
-
-### ❌ `Services typeExports []`
-
-Causes :
-
-* `servicesDirs` incorrect
-* services créés manuellement
-* fichiers mal nommés (`users.ts` manquant)
-
-### ❌ `Entity class User not found in services imports`
-
-Cause exacte :
-
-* le service `users` n’existe pas ou n’a pas été généré via la CLI
-
-✅ Solution universelle :
+For a beta release:
 
 ```bash
-bunx nuxt-feathers-zod add service users
+npm version prerelease --preid beta
+npm publish --tag beta --access public
 ```
 
----
-
-## 13. Bonnes pratiques figées
-
-* ✅ **Toujours** générer les services avec la CLI
-* ✅ `services/<name>/<name>.ts` obligatoire
-* ✅ Zod-first (`*.schema.ts`)
-* ❌ Pas de création manuelle
-* ❌ Pas de renommage arbitraire de `User`
-* ❌ Pas de déplacement hors `servicesDirs`
+## Notes
 
----
+- The recommended convention is `servicesDirs: ['services']`.
+- The recommended path is **CLI-first**.
+- Historical aliases may remain supported for backward compatibility, but the public docs only foreground the canonical forms.
 
-## 14. Résumé express (checklist)
+## License
 
-1. `bunx nuxi init`
-2. `bun add nuxt-feathers-zod feathers-pinia`
-3. `servicesDirs: ['services']`
-4. `bunx nuxt-feathers-zod add service users`
-5. `bunx nuxt-feathers-zod add service <business>`
-6. `bun run dev`
+MIT

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": "^4.0.0"
   },
-  "version": "6.3.0",
+  "version": "6.3.2",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -1,11 +1,13 @@
 import { createRequire } from 'node:module';
-import { defineNuxtModule, createResolver, addImportsDir, addTemplate, addServerPlugin, addImports, addPlugin, hasNuxtModule, installModule } from '@nuxt/kit';
+import { defineNuxtModule, createResolver, addImportsDir, addTemplate, addServerPlugin, addImports, addPlugin, hasNuxtModule } from '@nuxt/kit';
 import { consola } from 'consola';
 import defu from 'defu';
 import { resolveOptions, resolveRuntimeConfig, resolvePublicRuntimeConfig } from '../dist/runtime/options/index.js';
+import { detectResolvedMode, isResolvedServerEnabled, isResolvedRemoteAuthEnabled } from '../dist/runtime/options/mode.js';
 import { serverDefaults } from '../dist/runtime/options/server.js';
 import { getServicesImports, addServicesImports } from '../dist/runtime/services.js';
 import { getClientTemplates } from '../dist/runtime/templates/client/index.js';
+import { resolveTemplateOverrideForFilename } from '../dist/runtime/templates/overrides.js';
 import { getServerTemplates } from '../dist/runtime/templates/server/index.js';
 
 function setAliases(options, nuxt) {
@@ -15,7 +17,9 @@ function setAliases(options, nuxt) {
     "nuxt-feathers-zod/validators": resolver.resolve("runtime/zod/validators"),
     "nuxt-feathers-zod/query": resolver.resolve("runtime/zod/query"),
     "nuxt-feathers-zod/zod": resolver.resolve("runtime/zod/index"),
-    "nuxt-feathers-zod/options": resolver.resolve("runtime/options")
+    "nuxt-feathers-zod/options": resolver.resolve("runtime/options"),
+    "nuxt-feathers-zod/auth-utils": resolver.resolve("runtime/utils/auth"),
+    "nuxt-feathers-zod/config-utils": resolver.resolve("runtime/utils/config")
   };
   nuxt.options.alias = defu(nuxt.options.alias, aliases);
   if (options.client)
@@ -26,44 +30,56 @@ function setAliases(options, nuxt) {
 }
 function setTsIncludes(options, nuxt) {
   const resolver = createResolver(import.meta.url);
-  const servicesDirs = options.servicesDirs.map((dir) => resolver.resolve(dir, "**/*.ts"));
+  const servicesDirs = (options.servicesDirs || []).map((dir) => resolver.resolve(dir, "**/*.ts"));
+  const serverModuleDirs = Array.isArray(options.server?.moduleDirs) ? options.server.moduleDirs : options.server?.moduleDirs ? [String(options.server.moduleDirs)] : [];
+  const serverModulesGlobs = serverModuleDirs.map((dir) => resolver.resolve(dir, "*.ts"));
+  const includeGlobs = [...servicesDirs, ...serverModulesGlobs];
   nuxt.hook("prepare:types", async ({ tsConfig }) => {
-    tsConfig.include?.push(...servicesDirs);
+    tsConfig.include?.push(...includeGlobs);
   });
   nuxt.hook("nitro:config", (nitroConfig) => {
-    nitroConfig.typescript?.tsConfig?.include?.push(...servicesDirs);
+    nitroConfig.typescript = nitroConfig.typescript || {};
+    nitroConfig.typescript.tsConfig = nitroConfig.typescript.tsConfig || {};
+    nitroConfig.typescript.tsConfig.include = nitroConfig.typescript.tsConfig.include || [];
+    nitroConfig.typescript.tsConfig.include.push(...includeGlobs);
   });
 }
-async function loadPinia(client) {
+async function ensurePinia(client, nuxt) {
+  const piniaEnabled = client.pinia !== false && Boolean(client.pinia);
+  if (!piniaEnabled)
+    return;
+  const active = hasNuxtModule("@pinia/nuxt");
+  if (active)
+    return;
+  const require = createRequire(import.meta.url);
   const storesDirs = client.pinia?.storesDirs;
-  if (storesDirs?.length) {
-    if (hasNuxtModule("@pinia/nuxt"))
-      return consola.warn("Pinia is already loaded, skipping your configuration");
-    await installModule("@pinia/nuxt", { storesDirs });
+  const storesHint = storesDirs?.length ? ` (storesDirs: ${JSON.stringify(storesDirs)})` : "";
+  try {
+    require.resolve("@pinia/nuxt", { paths: [nuxt.options.rootDir] });
+    nuxt.options.modules = nuxt.options.modules || [];
+    if (!nuxt.options.modules.includes("@pinia/nuxt")) {
+      nuxt.options.modules.push("@pinia/nuxt");
+      consola.info("[nuxt-feathers-zod] Added @pinia/nuxt to Nuxt modules because feathers.client.pinia is enabled.");
+    }
+  } catch {
+    consola.warn(
+      `[nuxt-feathers-zod] feathers.client.pinia is enabled but @pinia/nuxt is not installed.${storesHint} Install it manually: bun add -D @pinia/nuxt and add '@pinia/nuxt' to your app modules.`
+    );
   }
-  if (!hasNuxtModule("@pinia/nuxt"))
-    await installModule("@pinia/nuxt");
 }
 const module$1 = defineNuxtModule({
+  moduleDependencies: {},
   meta: {
     name: "nuxt-feathers-zod",
     configKey: "feathers",
-    compatibility: {
-      nuxt: "^4.0.0"
-    }
+    compatibility: { nuxt: "^4.0.0" }
   },
-  // Default configuration options of the Nuxt module
   defaults: {
-    transports: {
-      websocket: true
-    },
+    transports: { websocket: true },
     server: serverDefaults,
     client: true,
     servicesDirs: ["services"],
-    validator: {
-      formats: [],
-      extendDefaults: true
-    },
+    validator: { formats: [], extendDefaults: true },
     loadFeathersConfig: false,
     auth: true,
     swagger: false
@@ -71,11 +87,13 @@ const module$1 = defineNuxtModule({
   async setup(options, nuxt) {
     const resolver = createResolver(import.meta.url);
     const resolvedOptions = await resolveOptions(options, nuxt);
+    const mode = detectResolvedMode(resolvedOptions);
+    const serverEnabled = isResolvedServerEnabled(resolvedOptions);
     if (resolvedOptions.swagger) {
       const require = createRequire(import.meta.url);
       try {
         require.resolve("feathers-swagger", { paths: [nuxt.options.rootDir] });
-      } catch (e) {
+      } catch {
         consola.warn(
           "feathers.swagger is enabled but 'feathers-swagger' could not be resolved from this Nuxt project. Install it in your app (root) dependencies: bun add feathers-swagger swagger-ui-dist"
         );
@@ -83,8 +101,6 @@ const module$1 = defineNuxtModule({
     }
     nuxt.options.runtimeConfig._feathers = resolveRuntimeConfig(resolvedOptions);
     nuxt.options.runtimeConfig.public._feathers = resolvePublicRuntimeConfig(resolvedOptions);
-    const servicesImports = await getServicesImports(resolvedOptions.servicesDirs);
-    await addServicesImports(servicesImports);
     setAliases(resolvedOptions, nuxt);
     setTsIncludes(resolvedOptions, nuxt);
     if (resolvedOptions.transports.websocket) {
@@ -93,34 +109,48 @@ const module$1 = defineNuxtModule({
       });
     }
     addImportsDir(resolver.resolve("./runtime/composables"));
-    let serverPluginDst;
-    for (const serverTemplate of getServerTemplates(resolvedOptions)) {
-      const tpl = addTemplate({ ...serverTemplate, options: resolvedOptions });
-      if (serverTemplate.filename?.endsWith("server/plugin.ts") || serverTemplate.filename?.endsWith("server/plugin"))
-        serverPluginDst = tpl.dst;
+    if (resolvedOptions.client) {
+      await ensurePinia(resolvedOptions.client, nuxt);
+    }
+    if (mode === "embedded" && serverEnabled) {
+      const servicesImports = await getServicesImports(resolvedOptions.servicesDirs);
+      await addServicesImports(servicesImports);
+    }
+    if (serverEnabled) {
+      let serverPluginDst;
+      for (const serverTemplate of getServerTemplates(resolvedOptions)) {
+        const ov = resolveTemplateOverrideForFilename(serverTemplate.filename, resolvedOptions);
+        const tpl = addTemplate(ov ? { filename: serverTemplate.filename, src: ov.absPath, write: true, options: resolvedOptions } : { ...serverTemplate, options: resolvedOptions });
+        if (serverTemplate.filename?.endsWith("server/plugin.ts") || serverTemplate.filename?.endsWith("server/plugin"))
+          serverPluginDst = tpl.dst;
+      }
+      addServerPlugin(serverPluginDst ?? resolver.resolve(resolvedOptions.templateDir, "server/plugin.ts"));
     }
-    addServerPlugin(serverPluginDst ?? resolver.resolve(resolvedOptions.templateDir, "server/plugin.ts"));
     if (resolvedOptions.client) {
       const clientOptions = resolvedOptions.client;
-      if (clientOptions.pinia) {
-        await loadPinia(clientOptions);
+      const piniaEnabled = clientOptions.pinia !== false && Boolean(clientOptions.pinia);
+      if (piniaEnabled) {
         nuxt.hook("vite:extendConfig", (config) => {
-          config.optimizeDeps?.include?.push("feathers-pinia");
+          config.optimizeDeps = config.optimizeDeps || {};
+          config.optimizeDeps.include = config.optimizeDeps.include || [];
+          if (!config.optimizeDeps.include.includes("feathers-pinia"))
+            config.optimizeDeps.include.push("feathers-pinia");
         });
-        if (resolvedOptions.auth) {
+        const enableAuthBootstrap = Boolean(
+          resolvedOptions.auth && serverEnabled || isResolvedRemoteAuthEnabled(resolvedOptions)
+        );
+        if (enableAuthBootstrap) {
           addImports({ from: resolver.resolve("./runtime/stores/auth"), name: "useAuthStore" });
           addPlugin({ order: 1, src: resolver.resolve("./runtime/plugins/feathers-auth") });
         }
         if (resolvedOptions.keycloak) {
           addPlugin({ order: 1, src: resolver.resolve("./runtime/plugins/keycloak-sso"), mode: "client" });
-        } else if (resolvedOptions.auth) {
-          addImports({ from: resolver.resolve("./runtime/stores/auth"), name: "useAuthStore" });
-          addPlugin({ order: 1, src: resolver.resolve("./runtime/plugins/feathers-auth") });
         }
       }
       let clientPluginDst;
       for (const clientTemplate of getClientTemplates(resolvedOptions, resolver)) {
-        const tpl = addTemplate({ ...clientTemplate, options: resolvedOptions });
+        const ov = resolveTemplateOverrideForFilename(clientTemplate.filename, resolvedOptions);
+        const tpl = addTemplate(ov ? { filename: clientTemplate.filename, src: ov.absPath, write: true, options: resolvedOptions } : { ...clientTemplate, options: resolvedOptions });
         if (clientTemplate.filename?.endsWith("client/plugin.ts") || clientTemplate.filename?.endsWith("client/plugin"))
           clientPluginDst = tpl.dst;
       }
@@ -131,7 +161,7 @@ const module$1 = defineNuxtModule({
         return {
           content: [{
             type: "text",
-            text: JSON.stringify(resolvedOptions, null, 2)
+            text: JSON.stringify({ mode, serverEnabled, ...resolvedOptions }, null, 2)
           }]
         };
       });

package/dist/runtime/composables/feathers.d.ts

@@ -1,5 +1,6 @@
-import type { ServiceTypes } from 'nuxt-feathers-zod/client';
+import type { ClientApplication, ServiceTypes } from 'nuxt-feathers-zod/client';
 export declare function useFeathers(): {
-    api: import("feathers-pinia").FeathersPiniaClient<import("nuxt-feathers-zod/client").ClientApplication>;
+    api: unknown;
+    client: ClientApplication;
 };
-export declare function useService<L extends keyof ServiceTypes>(path: L): import("@feathersjs/feathers").FeathersService<import("feathers-pinia").FeathersPiniaClient<import("nuxt-feathers-zod/client").ClientApplication>, import("feathers-pinia").CreatePiniaServiceTypes<import("nuxt-feathers-zod/client").ClientApplication>[L]>;
+export declare function useService<L extends keyof ServiceTypes>(path: L): import("@feathersjs/feathers").FeathersService<ClientApplication, ServiceTypes[ServiceTypes[L]]>;

package/dist/runtime/composables/feathers.js

@@ -1,9 +1,11 @@
 import { useNuxtApp } from "#imports";
 export function useFeathers() {
-  const { $api: api } = useNuxtApp();
-  return { api };
+  const nuxtApp = useNuxtApp();
+  const api = nuxtApp.$api;
+  const client = nuxtApp.$client ?? nuxtApp.$api;
+  return { api, client };
 }
 export function useService(path) {
-  const { api } = useFeathers();
-  return api.service(path);
+  const { client } = useFeathers();
+  return client.service(String(path));
 }