@extk/expressive 0.10.0 → 0.10.1

package/README.md

@@ -224,6 +224,17 @@ addRoute({
 }, handler);
 ```
 
+Pass `enabled: false` to skip swagger registration conditionally without breaking the chain:
+
+```ts
+.withSwagger(
+    b => b.withInfo({ title: 'My API', version: '1.0' }),
+    { path: '/api-docs', enabled: isDev() },
+)
+```
+
+When `enabled` is `false`, `withSwagger` is a no-op and the chain continues normally. Omitting `enabled` (or passing `true`) keeps existing behavior.
+
 Configure security schemes via the `configure` callback in `withSwagger`:
 
 ```ts

package/dist/index.d.mts

@@ -229,6 +229,7 @@ type SwaggerRef = {
 };
 type ExpressiveSwaggerOptions = {
     path: ExpressRoute;
+    enabled?: boolean;
     uiOpts?: SwaggerUiOptions;
     options?: SwaggerOptions;
     customCss?: string;

package/dist/index.d.ts

@@ -229,6 +229,7 @@ type SwaggerRef = {
 };
 type ExpressiveSwaggerOptions = {
     path: ExpressRoute;
+    enabled?: boolean;
     uiOpts?: SwaggerUiOptions;
     options?: SwaggerOptions;
     customCss?: string;

package/dist/index.js

@@ -241,6 +241,7 @@ var ServerBuilder = class {
     return this;
   }
   withSwagger(configure, opts, ...handlers) {
+    if (opts.enabled === false) return this;
     const config = this.swaggerRef.doc;
     if (!config) throw new Error("withSwagger must be called before build()");
     configure(new SwaggerBuilder(config));

package/dist/index.mjs

@@ -180,6 +180,7 @@ var ServerBuilder = class {
     return this;
   }
   withSwagger(configure, opts, ...handlers) {
+    if (opts.enabled === false) return this;
     const config = this.swaggerRef.doc;
     if (!config) throw new Error("withSwagger must be called before build()");
     configure(new SwaggerBuilder(config));

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@extk/expressive",
-    "version": "0.10.0",
+    "version": "0.10.1",
     "type": "commonjs",
     "publishConfig": {
         "access": "public"