nuxt-feathers-zod 0.2.0 → 0.2.1

package/README.md

@@ -364,8 +364,59 @@ Template basé sur le pattern existant `playground/server/feathers/dummy.ts` :
 * `--servicesDir <dir>`
 * `--target nitro|feathers`
 
+
+## Changements du 25 janvier 2026
+
+### 1) `add service` : nouvelles options ROI
+
+La commande supporte désormais :
+
+```bash
+bunx nuxt-feathers-zod add service <serviceName> \
+  [--idField id|_id] \
+  [--path <customPath>] \
+  [--docs] \
+  [--adapter mongodb|memory] \
+  [--auth] \
+  [--servicesDir <dir>] \
+  [--dry] \
+  [--force]
+```
+
+#### `--idField id|_id`
+
+* Détermine le champ d’identifiant dans le schéma Zod généré.
+* Compatible avec `mongodb` (ObjectId en string 24 hex) et `memory` (number int).
+* Défauts :
+
+  * `mongodb` → `_id`
+  * `memory` → `id`
+
+#### `--path <customPath>`
+
+* Découple le **dossier service** du **path Feathers exposé**.
+* Normalise automatiquement les `/` de tête/fin (ex: `/accounts/` → `accounts`).
+* Impacte : `*.shared.ts` (path const), et donc tous les usages de `service(path)`.
+
+#### `--docs`
+
+* Injecte un bloc `docs:` (Swagger legacy) dans le `app.use(...)`.
+* Ajoute `securities: ['jwt']` si `--auth` est activé.
+
+### 2) Tests smoke mis à jour
+
+* Ajout d’un test couvrant `--path`, `--idField`, `--docs`.
+
 ---
 
+## Exemple rapide (valide)
+
+```bash
+bunx nuxt-feathers-zod add service users --adapter mongodb --auth --idField id --path accounts --docs
+```
+
+Génère `services/users/*` mais expose le service sur `accounts` avec schéma `id: objectIdSchema()` + bloc `docs:`.
+
 
 
 ## License

package/dist/module.json

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

package/dist/module.mjs

@@ -1,6 +1,7 @@
 import { defineNuxtModule, createResolver, addImportsDir, addTemplate, addServerPlugin, addImports, addPlugin, hasNuxtModule, installModule } from '@nuxt/kit';
 import { consola } from 'consola';
 import defu from 'defu';
+import { createRequire } from 'node:module';
 import { resolveOptions, resolveRuntimeConfig, resolvePublicRuntimeConfig } from '../dist/runtime/options/index.js';
 import { serverDefaults } from '../dist/runtime/options/server.js';
 import { getServicesImports, addServicesImports } from '../dist/runtime/services.js';
@@ -64,11 +65,22 @@ const module$1 = defineNuxtModule({
       extendDefaults: true
     },
     loadFeathersConfig: false,
-    auth: true
+    auth: true,
+    swagger: false
   },
   async setup(options, nuxt) {
     const resolver = createResolver(import.meta.url);
     const resolvedOptions = await resolveOptions(options, nuxt);
+    if (resolvedOptions.swagger) {
+      const require = createRequire(import.meta.url);
+      try {
+        require.resolve("feathers-swagger", { paths: [nuxt.options.rootDir] });
+      } 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"
+        );
+      }
+    }
     nuxt.options.runtimeConfig._feathers = resolveRuntimeConfig(resolvedOptions);
     nuxt.options.runtimeConfig.public._feathers = resolvePublicRuntimeConfig(resolvedOptions);
     const servicesImports = await getServicesImports(resolvedOptions.servicesDirs);

package/dist/runtime/options/index.d.ts

@@ -7,6 +7,7 @@ import type { ResolvedServerOptions, ServerOptions } from './server.js';
 import type { ServicesDir, ServicesDirs } from './services.js';
 import type { ResolvedTransportsOptions, TransportsOptions } from './transports/index.js';
 import type { ResolvedValidatorOptions, ValidatorOptions } from './validator.js';
+import type { ResolvedSwaggerOptionsOrDisabled, SwaggerOptionsOrDisabled } from './swagger.js';
 export interface ModuleOptions {
     transports: TransportsOptions;
     database: DataBaseOptions;
@@ -16,6 +17,7 @@ export interface ModuleOptions {
     client: ClientOptions | boolean;
     validator: ValidatorOptions;
     loadFeathersConfig: boolean;
+    swagger?: SwaggerOptionsOrDisabled;
 }
 export interface ResolvedOptions {
     templateDir: string;
@@ -27,6 +29,7 @@ export interface ResolvedOptions {
     client: ResolvedClientOptionsOrDisabled;
     validator: ResolvedValidatorOptions;
     loadFeathersConfig: boolean;
+    swagger?: ResolvedSwaggerOptionsOrDisabled;
 }
 export interface FeathersRuntimeConfig {
     auth?: ResolvedAuthOptions;

package/dist/runtime/options/index.js

@@ -7,6 +7,7 @@ import { resolveServerOptions } from "./server.js";
 import { resolveServicesDirs } from "./services.js";
 import { resolveTransportsOptions } from "./transports/index.js";
 import { resolveValidatorOptions } from "./validator.js";
+import { resolveSwaggerOptions } from "./swagger.js";
 export async function resolveOptions(options, nuxt) {
   const { rootDir, srcDir, serverDir, appDir, buildDir, ssr } = nuxt.options;
   const resolver = createResolver(import.meta.url);
@@ -17,6 +18,7 @@ export async function resolveOptions(options, nuxt) {
   const server = await resolveServerOptions(options.server, rootDir, serverDir);
   const client = await resolveClientOptions(options.client, !!database.mongo, rootDir, srcDir);
   const validator = resolveValidatorOptions(options.validator);
+  const swagger = resolveSwaggerOptions(options.swagger, transports);
   const servicesImports = await getServicesImports(servicesDirs);
   const auth = resolveAuthOptions(options.auth, !!client, servicesImports, appDir);
   const loadFeathersConfig = options.loadFeathersConfig;
@@ -29,7 +31,8 @@ export async function resolveOptions(options, nuxt) {
     client,
     validator,
     auth,
-    loadFeathersConfig
+    loadFeathersConfig,
+    swagger
   };
   console.dir(resolvedOptions, { depth: null });
   return resolvedOptions;

package/dist/runtime/options/swagger.d.ts

@@ -0,0 +1,34 @@
+import type { ResolvedTransportsOptions } from './transports/index.js';
+export interface SwaggerOptions {
+    /**
+     * Enable Swagger/OpenAPI documentation generation via feathers-swagger (legacy).
+     * When `true`, defaults are applied.
+     */
+    enabled?: boolean;
+    /** Swagger UI base path (e.g. /docs) */
+    docsPath?: string;
+    /** OpenAPI JSON path (e.g. /docs.json) */
+    docsJsonPath?: string;
+    /** OpenAPI version (2 or 3). Default: 3 */
+    openApiVersion?: 2 | 3;
+    /** OpenAPI info */
+    info?: {
+        title: string;
+        description?: string;
+        version: string;
+    };
+}
+export type SwaggerOptionsOrDisabled = SwaggerOptions | boolean;
+export interface ResolvedSwaggerOptions {
+    enabled: true;
+    docsPath: string;
+    docsJsonPath: string;
+    openApiVersion: 2 | 3;
+    info: {
+        title: string;
+        description?: string;
+        version: string;
+    };
+}
+export type ResolvedSwaggerOptionsOrDisabled = ResolvedSwaggerOptions | false;
+export declare function resolveSwaggerOptions(options: SwaggerOptionsOrDisabled | undefined, transports: ResolvedTransportsOptions): ResolvedSwaggerOptionsOrDisabled;

package/dist/runtime/options/swagger.js

@@ -0,0 +1,16 @@
+export function resolveSwaggerOptions(options, transports) {
+  if (options == null || options === false)
+    return false;
+  if (options === true)
+    options = {};
+  const enabled = options.enabled ?? true;
+  if (!enabled)
+    return false;
+  return {
+    enabled: true,
+    docsPath: options.docsPath || "/docs",
+    docsJsonPath: options.docsJsonPath || "/docs.json",
+    openApiVersion: options.openApiVersion || 3,
+    info: options.info || { title: "API Docs", version: "1.0.0" }
+  };
+}

package/dist/runtime/templates/server/plugin.js

@@ -26,6 +26,46 @@ export function getServerPluginContents(options) {
     const authService = options?.auth?.service;
     const restPath = transports?.rest?.path;
     const websocketPath = transports?.websocket?.path;
+    const swaggerEnabled = !!options.swagger;
+    const swagger = options.swagger;
+    const normalizePath = (p) => {
+      if (!p)
+        return "";
+      return p.startsWith("/") ? p : `/${p}`;
+    };
+    const trimTrailingSlash = (p) => {
+      if (!p)
+        return "";
+      return p.length > 1 && p.endsWith("/") ? p.slice(0, -1) : p;
+    };
+    const docsPath = trimTrailingSlash(normalizePath(swagger?.docsPath ?? "/docs"));
+    const docsPathSlash = `${docsPath}/`;
+    const docsJsonPath = trimTrailingSlash(normalizePath(swagger?.docsJsonPath ?? "/docs.json"));
+    const swaggerInitBlock = swaggerEnabled ? `  // Init Swagger (feathers-swagger legacy)
+  
+
+  app.configure(swagger.customMethodsHandler)
+  app.configure(swagger({
+    docsPath: '${docsPath}',
+    docsJsonPath: '/swagger.json',
+    specs: {
+      info: ${JSON.stringify(swagger?.info ?? { title: "API Docs", description: "Feathers API", version: "1.0.0" })},
+      components: {
+        securitySchemes: {
+          BearerAuth: {
+            type: 'http',
+            scheme: 'bearer',
+            bearerFormat: 'JWT',
+          },
+        },
+      },
+      security: [
+        { BearerAuth: [] },
+      ],
+    },
+    ui: swagger.swaggerUI({ docsPath: '${docsPath}' }),
+  }))
+` : "";
     return `// ! Generated by nuxt-feathers-zod - do not change manually
 import type { NitroApp } from 'nitropack'
 import type { Application } from './server.js'
@@ -36,6 +76,7 @@ ${puts([
       [exp, `import feathersExpress, { json, rest, urlencoded } from '@feathersjs/express'`],
       [sio, `import socketio from '@feathersjs/socketio'`]
     ])}
+${put(swaggerEnabled, `import swagger from 'feathers-swagger'`)}
 ${put(rest, `import { ${framework}ErrorHandler } from '@gabortorma/feathers-nitro-adapter/handlers'`)}
 ${put(auth, `import authentication from './authentication.js'`)}
 import { ${routers.join(", ")} } from '@gabortorma/feathers-nitro-adapter/routers'
@@ -52,6 +93,7 @@ export default defineNitroPlugin((nitroApp: NitroApp) => {
 ${put(options.loadFeathersConfig, `
   app.configure(configuration())
 `)}
+${put(swaggerEnabled, swaggerInitBlock)}
   // Add nitroApp to feathers app
   app.nitroApp = nitroApp;
 ${put(rest, `${put(koa, `
@@ -70,6 +112,7 @@ ${put(exp, `  // Set up Express middleware
     },
   }`)}))  
 `)}`)}
+
   // Init socket.io server for real-time functionality
   app.set('websocket', ${!!sio})${put(sio, `
   app.configure(socketio({ 
@@ -83,11 +126,13 @@ ${put(exp, `  // Set up Express middleware
   ${put(mongo, `// Init mongodb
   app.configure(mongodb)
 `)}
+
   // Init services
   ${services.map((service) => `app.configure(${service.meta.importId})`).join("\n  ")}
 
   // Init plugins
   ${plugins.map((plugin) => `app.configure(${plugin.meta.importId})`).join("\n  ")}
+
 ${put(exp, `
   // Set up Express middleware for 404s and the error handler
   app.configure(expressErrorHandler)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-feathers-zod",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "packageManager": "bun@1.3.6",
   "description": "Feathers API integration for Nuxt",
   "author": "Herve de CHAVIGNY",

package/src/cli/index.ts

@@ -7,6 +7,8 @@ import consola from 'consola'
 
 type Adapter = 'mongodb' | 'memory'
 type MiddlewareTarget = 'nitro' | 'feathers'
+type IdField = 'id' | '_id'
+type CollectionName = string
 
 export type RunCliOptions = {
   cwd: string
@@ -48,6 +50,10 @@ export async function runCli(argv: string[], opts: RunCliOptions) {
   if (subcmd === 'service') {
     const adapter = (flags.adapter as Adapter | undefined) ?? 'mongodb'
     const auth = Boolean(flags.auth)
+    const idField = (flags.idField as IdField | undefined) ?? (adapter === 'mongodb' ? '_id' : 'id')
+    const servicePath = typeof flags.path === 'string' ? String(flags.path) : undefined
+    const collectionName = typeof flags.collection === 'string' ? String(flags.collection) : undefined
+    const docs = Boolean(flags.docs)
     const dry = Boolean(flags.dry)
     const force = Boolean(flags.force)
 
@@ -60,6 +66,10 @@ export async function runCli(argv: string[], opts: RunCliOptions) {
       name,
       adapter,
       auth,
+      idField,
+      servicePath,
+      collectionName,
+      docs,
       dry,
       force,
     })
@@ -86,7 +96,7 @@ export async function runCli(argv: string[], opts: RunCliOptions) {
 function printHelp() {
   // Keep output short; this is a CLI entrypoint.
   // eslint-disable-next-line no-console
-  console.log(`\nnuxt-feathers-zod CLI\n\nUsage:\n  nuxt-feathers-zod add service <serviceName> [--adapter mongodb|memory] [--auth] [--servicesDir <dir>] [--dry] [--force]\n  nuxt-feathers-zod add middleware <name> [--target nitro|feathers] [--dry] [--force]\n\nExamples:\n  bunx nuxt-feathers-zod add service posts --adapter mongodb --auth\n  bunx nuxt-feathers-zod add middleware session\n  bunx nuxt-feathers-zod add middleware dummy --target feathers\n`)
+  console.log(`\nnuxt-feathers-zod CLI\n\nUsage:\n  nuxt-feathers-zod add service <serviceName> [--adapter mongodb|memory] [--auth] [--idField id|_id] [--path <customPath>] [--collection <mongoCollection>] [--docs] [--servicesDir <dir>] [--dry] [--force]\n  nuxt-feathers-zod add middleware <name> [--target nitro|feathers] [--dry] [--force]\n\nExamples:\n  bunx nuxt-feathers-zod add service posts --adapter mongodb --auth\n  bunx nuxt-feathers-zod add service users --adapter mongodb --idField _id --path accounts --docs\n  bunx nuxt-feathers-zod add service haproxy-domains --path haproxy/domains --collection haproxy-domains --auth --docs\n  bunx nuxt-feathers-zod add middleware session\n  bunx nuxt-feathers-zod add middleware dummy --target feathers\n`)
 }
 
 function parseFlags(argv: string[]) {
@@ -132,6 +142,28 @@ function normalizeServiceName(raw: string) {
   return kebabCase(raw)
 }
 
+function normalizeServicePath(raw: string) {
+  // Feathers service paths are usually kebab-case and can include slashes.
+  // We keep user intent, but normalize leading/trailing slashes.
+  const cleaned = String(raw).trim().replace(/^\/+/, '').replace(/\/+$/, '')
+  if (!cleaned) throw new Error('Invalid --path: path cannot be empty')
+  return cleaned
+}
+
+function normalizeCollectionName(raw: string) {
+  // MongoDB collection names are strings, but in practice should not include path separators.
+  // We keep it permissive while preventing common foot-guns.
+  const cleaned = String(raw).trim()
+  if (!cleaned) throw new Error('Invalid --collection: collection name cannot be empty')
+  if (cleaned.includes('/') || cleaned.includes('\\')) {
+    throw new Error('Invalid --collection: collection name must not include \/ or \\')
+  }
+  if (cleaned.includes('\u0000')) {
+    throw new Error('Invalid --collection: collection name must not include null characters')
+  }
+  return cleaned
+}
+
 function createServiceIds(serviceNameKebab: string) {
   const baseKebab = singularize(serviceNameKebab)
   const basePascal = pascalCase(baseKebab)
@@ -151,6 +183,10 @@ type GenerateServiceOptions = {
   name: string
   adapter: Adapter
   auth: boolean
+  idField: IdField
+  servicePath?: string
+  collectionName?: CollectionName
+  docs: boolean
   dry: boolean
   force: boolean
 }
@@ -159,6 +195,12 @@ export async function generateService(opts: GenerateServiceOptions) {
   const serviceNameKebab = normalizeServiceName(opts.name)
   const ids = createServiceIds(serviceNameKebab)
 
+  const servicePath = normalizeServicePath(opts.servicePath ?? serviceNameKebab)
+  const collectionName = normalizeCollectionName(
+    opts.collectionName
+      ?? (servicePath.includes('/') ? serviceNameKebab : servicePath),
+  )
+
   const dir = join(opts.servicesDir, serviceNameKebab)
   const schemaFile = join(dir, `${serviceNameKebab}.schema.ts`)
   const classFile = join(dir, `${serviceNameKebab}.class.ts`)
@@ -166,10 +208,10 @@ export async function generateService(opts: GenerateServiceOptions) {
   const serviceFile = join(dir, `${serviceNameKebab}.ts`)
 
   const files: Array<{ path: string; content: string }> = [
-    { path: schemaFile, content: renderSchema(ids, opts.adapter) },
-    { path: classFile, content: renderClass(ids, opts.adapter) },
-    { path: sharedFile, content: renderShared(ids) },
-    { path: serviceFile, content: renderService(ids, opts.auth) },
+    { path: schemaFile, content: renderSchema(ids, opts.adapter, opts.idField) },
+    { path: classFile, content: renderClass(ids, opts.adapter, collectionName) },
+    { path: sharedFile, content: renderShared(ids, servicePath) },
+    { path: serviceFile, content: renderService(ids, opts.auth, opts.docs) },
   ]
 
   await ensureDir(dir, opts.dry)
@@ -178,11 +220,41 @@ export async function generateService(opts: GenerateServiceOptions) {
     await writeFileSafe(f.path, f.content, { dry: opts.dry, force: opts.force })
   }
 
+  if (opts.docs) {
+    await ensureFeathersSwaggerSupport(opts.projectRoot, { dry: opts.dry, force: opts.force })
+  }
+
   if (!opts.dry) {
     consola.success(`Generated service '${serviceNameKebab}' in ${relativeToCwd(dir)}`)
   }
 }
 
+async function ensureFeathersSwaggerSupport(projectRoot: string, io: { dry: boolean; force: boolean }) {
+  // 1) Ensure TS sees `ServiceOptions.docs` (required for feathers-swagger in TS projects)
+  const typesDir = join(projectRoot, 'types')
+  const typesFile = join(typesDir, 'feathers-swagger.d.ts')
+  const typesContent = `// Auto-generated by nuxt-feathers-zod CLI (required when using feathers-swagger in TypeScript)\n\nimport type { ServiceSwaggerOptions } from 'feathers-swagger'\n\ndeclare module '@feathersjs/feathers' {\n  interface ServiceOptions {\n    docs?: ServiceSwaggerOptions\n  }\n}\n`
+
+  await ensureDir(typesDir, io.dry)
+  await writeFileSafe(typesFile, typesContent, { dry: io.dry, force: io.force })
+
+  // 2) Best-effort dependency hint (we do not auto-install dependencies)
+  try {
+    const pkgPath = join(projectRoot, 'package.json')
+    if (!existsSync(pkgPath)) return
+    const pkg = JSON.parse(await readFile(pkgPath, 'utf8')) as any
+    const deps = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) }
+    if (!deps['feathers-swagger']) {
+      consola.warn(
+        `--docs was used but 'feathers-swagger' is not listed in package.json. Install it (and swagger UI deps if needed): bun add feathers-swagger swagger-ui-dist`,
+      )
+    }
+  }
+  catch {
+    // ignore
+  }
+}
+
 type GenerateMiddlewareOptions = {
   projectRoot: string
   name: string
@@ -238,12 +310,12 @@ function relativeToCwd(p: string) {
   }
 }
 
-function renderSchema(ids: ReturnType<typeof createServiceIds>, adapter: Adapter) {
+function renderSchema(ids: ReturnType<typeof createServiceIds>, adapter: Adapter, idField: IdField) {
   const base = ids.baseCamel
   const Base = ids.basePascal
   const serviceClass = `${Base}Service`
 
-  const idField = adapter === 'mongodb' ? '_id' : 'id'
+  const idSchemaField = idField
   const idSchema = adapter === 'mongodb'
     ? `
 const objectIdRegex = /^[0-9a-f]{24}$/i
@@ -253,11 +325,11 @@ export const objectIdSchema = () => z.string().regex(objectIdRegex, 'Invalid Obj
 
   const mainSchema = adapter === 'mongodb'
     ? `export const ${base}Schema = z.object({
-  ${idField}: objectIdSchema(),
+  ${idSchemaField}: objectIdSchema(),
   text: z.string(),
 })`
     : `export const ${base}Schema = z.object({
-  ${idField}: z.number().int(),
+  ${idSchemaField}: z.number().int(),
   text: z.string(),
 })`
 
@@ -303,8 +375,7 @@ export const ${base}QueryResolver = resolve<${Base}Query, HookContext<${serviceC
 `
 }
 
-function renderClass(ids: ReturnType<typeof createServiceIds>, adapter: Adapter) {
-  const base = ids.baseCamel
+function renderClass(ids: ReturnType<typeof createServiceIds>, adapter: Adapter, collectionName: string) {
   const Base = ids.basePascal
   const serviceName = ids.serviceNameKebab
   const serviceClass = `${Base}Service`
@@ -364,13 +435,13 @@ export function getOptions(app: Application): MongoDBAdapterOptions {
       max: 100,
     },
     multi: true,
-    Model: mongoClient.then(db => db.collection('${serviceName}')),
+    Model: mongoClient.then(db => db.collection('${collectionName}')),
   }
 }
 `
 }
 
-function renderShared(ids: ReturnType<typeof createServiceIds>) {
+function renderShared(ids: ReturnType<typeof createServiceIds>, servicePath: string) {
   const base = ids.baseCamel
   const Base = ids.basePascal
   const serviceName = ids.serviceNameKebab
@@ -390,7 +461,7 @@ export type { ${Base}, ${Base}Data, ${Base}Patch, ${Base}Query }
 
 export type ${clientServiceType} = Pick<${serviceClass}<Params<${Base}Query>>, (typeof ${methodsConst})[number]>
 
-export const ${pathConst} = '${serviceName}'
+export const ${pathConst} = '${servicePath}'
 
 export const ${methodsConst}: Array<keyof ${serviceClass}> = ['find', 'get', 'create', 'patch', 'remove']
 
@@ -410,13 +481,39 @@ declare module 'nuxt-feathers-zod/client' {
 `
 }
 
-function renderService(ids: ReturnType<typeof createServiceIds>, auth: boolean) {
+function renderService(ids: ReturnType<typeof createServiceIds>, auth: boolean, docs: boolean) {
   const base = ids.baseCamel
   const Base = ids.basePascal
   const serviceName = ids.serviceNameKebab
   const serviceClass = `${Base}Service`
   const authImports = auth ? "import { authenticate } from '@feathersjs/authentication'\n" : ''
 
+  const swaggerImports = ''
+
+  const swaggerSchemaImports = ''
+  const docsBlock = docs
+    ? `
+    docs: {
+      description: '${Base} service',
+      idType: 'string',
+${auth ? `      securities: ${base}Methods,
+` : ''}      definitions: {
+        ${base}: { type: 'object', properties: {} },
+        ${base}Data: { type: 'object', properties: {} },
+        ${base}Patch: { type: 'object', properties: {} },
+        ${base}Query: {
+          type: 'object',
+          properties: {
+            $limit: { type: 'number' },
+            $skip: { type: 'number' },
+            $sort: { type: 'object', additionalProperties: { type: 'number' } },
+          },
+        },
+      },
+    },
+`
+    : ''
+
   const authAround = auth
     ? `
       find: [authenticate('jwt')],
@@ -436,10 +533,10 @@ function renderService(ids: ReturnType<typeof createServiceIds>, auth: boolean)
   return `// For more information about this file see https://dove.feathersjs.com/guides/cli/service.html
 
 import type { Application } from 'nuxt-feathers-zod/server'
-${authImports}import { hooks as schemaHooks } from '@feathersjs/schema'
+${authImports}${swaggerImports}import { hooks as schemaHooks } from '@feathersjs/schema'
 import { getOptions, ${serviceClass} } from './${serviceName}.class'
 import {
-  ${base}DataResolver,
+${swaggerSchemaImports}  ${base}DataResolver,
   ${base}DataValidator,
   ${base}ExternalResolver,
   ${base}PatchResolver,
@@ -456,7 +553,7 @@ export * from './${serviceName}.schema'
 export function ${base}(app: Application) {
   app.use(${base}Path, new ${serviceClass}(getOptions(app)), {
     methods: ${base}Methods,
-    events: [],
+    events: [],${docsBlock}
   })
 
   app.service(${base}Path).hooks({