@extk/expressive 0.5.4 → 0.6.1

package/README.md

@@ -22,7 +22,7 @@
 
 - **Auto-generated OpenAPI 3.1 docs** from your route definitions
 - **Structured error handling** with typed error classes and consistent JSON responses
-- **Winston logging** with daily file rotation and dev/prod modes
+- **Bring-your-own logger** — any object with `info/warn/error/debug` works
 - **Security defaults** via Helmet, safe query parsing, and morgan request logging
 - **Standardized responses** (`ApiResponse` / `ApiErrorResponse`) across your entire API
 
@@ -58,13 +58,9 @@ const {
 const swaggerDoc = swaggerBuilder()
   .withInfo({ title: 'My API', version: '1.0.0' })
   .withServers([{ url: 'http://localhost:3000' }])
-  .get();
+  .build();
 
-// 3. Build the Express app with sensible defaults (helmet, morgan, swagger UI)
-const app = expressiveServer()
-  .withDefaults({ path: '/api-docs', doc: swaggerDoc });
-
-// 4. Define routes — they auto-register in the OpenAPI spec
+// 3. Define routes — they auto-register in the OpenAPI spec
 const { router, addRoute } = expressiveRouter({
   oapi: { tags: ['Users'] },
 });
@@ -85,10 +81,24 @@ addRoute(
   },
 );
 
-// 5. Mount the router and error handling
-app.use(router);
-app.use(getErrorHandlerMiddleware());
-app.use(notFoundMiddleware);
+```
+
+> [!IMPORTANT]
+> Method call order on `ServerBuilder` matters — middleware is registered in the order you chain it.
+
+```ts
+// 4. Build the Express app
+const app = expressiveServer()
+  .withHelmet()
+  .withQs()
+  .withMorgan()
+  .withRoutes(router)
+  .withSwagger({ path: '/api-docs', config: swaggerDoc })
+  .with((app) => {
+    app.use(getErrorHandlerMiddleware());
+    app.use(notFoundMiddleware);
+  })
+  .build();
 
 app.listen(3000);
 ```
@@ -203,15 +213,19 @@ export const loginSchema = z.object({
 import z from 'zod';
 
 const app = expressiveServer()
-  .withDefaults({
-    doc: swaggerBuilder()
+  .withHelmet()
+  .withQs()
+  .withMorgan()
+  .withSwagger({
+    config: swaggerBuilder()
       .withInfo({ title: 'My API' })
       .withServers([{ url: 'http://localhost:3000/api' }])
       .withSchemas(z.toJSONSchema(z.globalRegistry).schemas) // all Zod schemas -> OpenAPI
       .withSecuritySchemes({ auth: SWG.securitySchemes.BearerAuth() })
       .withDefaultSecurity([SWG.security('auth')])
       .get(),
-  });
+  })
+  .build();
 ```
 
 **3. Reference them in routes with `SWG.jsonSchemaRef`:**

package/dist/index.d.mts

@@ -163,19 +163,23 @@ type SwaggerConfig = {
 
 type SwaggerOptions = {
     path?: ExpressRoute;
-    doc: SwaggerConfig;
+    config: SwaggerConfig;
 };
 declare class ServerBuilder {
     private app;
     private container;
     constructor(app: express__default.Express, container: Container);
-    get(): express__default.Express;
+    build(): express__default.Express;
     withHelmet(options?: Readonly<HelmetOptions>): this;
     withQs(): this;
     withMorgan(format?: string, // TODO: FormatFn
     options?: Parameters<typeof morgan>[1]): this;
+    withRoutes(routes: ExpressRoute): this;
+    /**
+     * Helper function for fluent design
+     */
+    with(fn: (app: express__default.Express, container: Container) => void): this;
     withSwagger(swagger: SwaggerOptions, ...handlers: ExpressHandler[]): this;
-    withDefaults(swagger: SwaggerOptions): express__default.Express;
 }
 
 declare class ApiError extends Error {

package/dist/index.d.ts

@@ -163,19 +163,23 @@ type SwaggerConfig = {
 
 type SwaggerOptions = {
     path?: ExpressRoute;
-    doc: SwaggerConfig;
+    config: SwaggerConfig;
 };
 declare class ServerBuilder {
     private app;
     private container;
     constructor(app: express__default.Express, container: Container);
-    get(): express__default.Express;
+    build(): express__default.Express;
     withHelmet(options?: Readonly<HelmetOptions>): this;
     withQs(): this;
     withMorgan(format?: string, // TODO: FormatFn
     options?: Parameters<typeof morgan>[1]): this;
+    withRoutes(routes: ExpressRoute): this;
+    /**
+     * Helper function for fluent design
+     */
+    with(fn: (app: express__default.Express, container: Container) => void): this;
     withSwagger(swagger: SwaggerOptions, ...handlers: ExpressHandler[]): this;
-    withDefaults(swagger: SwaggerOptions): express__default.Express;
 }
 
 declare class ApiError extends Error {

package/dist/index.js

@@ -198,7 +198,7 @@ var ServerBuilder = class {
     this.app = app;
     this.container = container;
   }
-  get() {
+  build() {
     return this.app;
   }
   withHelmet(options) {
@@ -222,15 +222,23 @@ var ServerBuilder = class {
     ));
     return this;
   }
+  withRoutes(routes) {
+    this.app.use(routes);
+    return this;
+  }
+  /**
+   * Helper function for fluent design
+   */
+  with(fn) {
+    fn(this.app, this.container);
+    return this;
+  }
   withSwagger(swagger, ...handlers) {
-    this.app.use(swagger.path ?? "/api-docs", ...handlers, import_swagger_ui_express.default.serve, import_swagger_ui_express.default.setup(swagger.doc, {
-      customSiteTitle: swagger.doc.info?.title
+    this.app.use(swagger.path ?? "/api-docs", ...handlers, import_swagger_ui_express.default.serve, import_swagger_ui_express.default.setup(swagger.config, {
+      customSiteTitle: swagger.config.info?.title
     }));
     return this;
   }
-  withDefaults(swagger) {
-    return this.withHelmet().withQs().withMorgan().withSwagger(swagger).get();
-  }
 };
 function buildExpressive(container, swaggerDoc) {
   return {

package/dist/index.mjs

@@ -137,7 +137,7 @@ var ServerBuilder = class {
     this.app = app;
     this.container = container;
   }
-  get() {
+  build() {
     return this.app;
   }
   withHelmet(options) {
@@ -161,15 +161,23 @@ var ServerBuilder = class {
     ));
     return this;
   }
+  withRoutes(routes) {
+    this.app.use(routes);
+    return this;
+  }
+  /**
+   * Helper function for fluent design
+   */
+  with(fn) {
+    fn(this.app, this.container);
+    return this;
+  }
   withSwagger(swagger, ...handlers) {
-    this.app.use(swagger.path ?? "/api-docs", ...handlers, swaggerUi.serve, swaggerUi.setup(swagger.doc, {
-      customSiteTitle: swagger.doc.info?.title
+    this.app.use(swagger.path ?? "/api-docs", ...handlers, swaggerUi.serve, swaggerUi.setup(swagger.config, {
+      customSiteTitle: swagger.config.info?.title
     }));
     return this;
   }
-  withDefaults(swagger) {
-    return this.withHelmet().withQs().withMorgan().withSwagger(swagger).get();
-  }
 };
 function buildExpressive(container, swaggerDoc) {
   return {

package/package.json

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