@spikard/node 0.15.6-rc.2 → 0.15.6-rc.21

package/index.d.ts

@@ -1,5 +1,87 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
+/** Spikard application builder. */
+export declare class App {
+  /** Create a new application with the default server configuration. */
+  static new(): App
+  static default(): App
+  /**
+   * Register a handler via the `get` variant shortcut.
+   *
+   * Register a GET route at the given path.
+   */
+  get(path: string, handler: ((err: Error | null, arg: any) => any)): void
+  /**
+   * Register a handler via the `post` variant shortcut.
+   *
+   * Register a POST route at the given path.
+   */
+  post(path: string, handler: ((err: Error | null, arg: any) => any)): void
+  /**
+   * Register a handler via the `put` variant shortcut.
+   *
+   * Register a PUT route at the given path.
+   */
+  put(path: string, handler: ((err: Error | null, arg: any) => any)): void
+  /**
+   * Register a handler via the `patch` variant shortcut.
+   *
+   * Register a PATCH route at the given path.
+   */
+  patch(path: string, handler: ((err: Error | null, arg: any) => any)): void
+  /**
+   * Register a handler via the `delete` variant shortcut.
+   *
+   * Register a DELETE route at the given path.
+   */
+  delete(path: string, handler: ((err: Error | null, arg: any) => any)): void
+  /**
+   * Register a handler via the `head` variant shortcut.
+   *
+   * Register a HEAD route at the given path.
+   */
+  head(path: string, handler: ((err: Error | null, arg: any) => any)): void
+  /**
+   * Register a handler via the `options` variant shortcut.
+   *
+   * Register an OPTIONS route at the given path.
+   */
+  options(path: string, handler: ((err: Error | null, arg: any) => any)): void
+  /**
+   * Register a handler via the `connect` variant shortcut.
+   *
+   * Register a CONNECT route at the given path.
+   */
+  connect(path: string, handler: ((err: Error | null, arg: any) => any)): void
+  /**
+   * Register a handler via the `trace` variant shortcut.
+   *
+   * Register a TRACE route at the given path.
+   */
+  trace(path: string, handler: ((err: Error | null, arg: any) => any)): void
+  /**
+   * Call the `run` entrypoint on the inner service.
+   *
+   * Run the HTTP server using the configured routes.
+   *
+   * # Errors
+   *
+   * Returns an error if server construction or execution fails.
+   */
+  nativeRun(): Promise<void>
+  /**
+   * Call the `into_router` entrypoint on the inner service.
+   *
+   * Build the underlying Axum router.
+   *
+   * # Errors
+   *
+   * Returns an error if server or router construction fails.
+   */
+  nativeIntoRouter(): void
+}
+export type JsApp = App
+
 /**
  * Configuration for GraphQL routes
  *
@@ -49,6 +131,15 @@ export declare class GraphQLRouteConfig {
   isPlaygroundEnabled(): boolean
   /** Get the description if set */
   getDescription(): string | null
+  /**
+   * Create a new GraphQL route configuration with defaults
+   *
+   * Default values:
+   * - path: "/graphql"
+   * - method: "POST"
+   * - `enable_playground`: false
+   */
+  static new(): GraphQLRouteConfig
   static default(): GraphQLRouteConfig
 }
 export type JsGraphQLRouteConfig = GraphQLRouteConfig
@@ -66,6 +157,32 @@ export declare class JsGraphQlErrorInfo {
 }
 export type JsGraphQLErrorInfo = JsGraphQlErrorInfo
 
+/** Builder for defining a route. */
+export declare class RouteBuilder {
+  /** Assign an explicit handler name. */
+  handlerName(name: string): RouteBuilder
+  /** Provide a raw JSON schema for the request body. */
+  requestSchemaJson(schema: any): RouteBuilder
+  /** Provide a raw JSON schema for the response body. */
+  responseSchemaJson(schema: any): RouteBuilder
+  /** Provide a raw JSON schema for request parameters. */
+  paramsSchemaJson(schema: any): RouteBuilder
+  /** Provide multipart file parameter configuration. */
+  fileParamsJson(schema: any): RouteBuilder
+  /** Attach a CORS configuration for this route. */
+  cors(cors: CorsConfig): RouteBuilder
+  /** Attach a compression configuration for this route. */
+  compression(compression: CompressionConfig): RouteBuilder
+  /** Mark the route as synchronous. */
+  sync(): RouteBuilder
+  /** Declare the dependency keys that must be resolved before this handler runs. */
+  handlerDependencies(dependencies: Array<string>): RouteBuilder
+  /** Create a new builder for the provided HTTP method and path. */
+  static new(method: JsMethod, path: string): RouteBuilder
+  constructor(method: JsMethod, path: string)
+}
+export type JsRouteBuilder = RouteBuilder
+
 /**
  * Core test client for making HTTP requests to a Spikard application.
  *
@@ -103,6 +220,22 @@ export interface ApiKeyConfig {
   headerName: string
 }
 
+/**
+ * Drive `spikard::App::into_router` from JavaScript.
+ *
+ * Each entry in `registrations` is a `[method_name, metadata, callback]` triple
+ * produced by the TypeScript service class.
+ */
+export declare function appIntoRouter(registrations: Array<[string, Array<any>, ((err: Error | null, arg: any) => any)]>): Promise<void>
+
+/**
+ * Drive `spikard::App::run` from JavaScript.
+ *
+ * Each entry in `registrations` is a `[method_name, metadata, callback]` triple
+ * produced by the TypeScript service class.
+ */
+export declare function appRun(registrations: Array<[string, Array<any>, ((err: Error | null, arg: any) => any)]>): Promise<void>
+
 /** AsyncAPI HTTP endpoint configuration */
 export interface AsyncApiConfig {
   /** Enable AsyncAPI endpoints (default: false) */
@@ -350,6 +483,7 @@ export declare const enum Method {
   Delete = 'Delete',
   Head = 'Head',
   Options = 'Options',
+  Connect = 'Connect',
   Trace = 'Trace'
 }
 
@@ -644,7 +778,7 @@ export interface ServerConfig {
   /** Graceful shutdown timeout (seconds) */
   shutdownTimeout?: number
   /** AsyncAPI HTTP endpoint configuration */
-  asyncapi?: AsyncApiConfig
+  asyncapi?: JsAsyncApiConfig
   /** OpenAPI documentation configuration */
   openapi?: OpenApiConfig
   /** JSON-RPC configuration */

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-android-arm64')
         const bindingPackageVersion = require('@spikard/node-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-android-arm-eabi')
         const bindingPackageVersion = require('@spikard/node-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-win32-x64-gnu')
         const bindingPackageVersion = require('@spikard/node-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-win32-x64-msvc')
         const bindingPackageVersion = require('@spikard/node-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-win32-ia32-msvc')
         const bindingPackageVersion = require('@spikard/node-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-win32-arm64-msvc')
         const bindingPackageVersion = require('@spikard/node-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@spikard/node-darwin-universal')
       const bindingPackageVersion = require('@spikard/node-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-darwin-x64')
         const bindingPackageVersion = require('@spikard/node-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-darwin-arm64')
         const bindingPackageVersion = require('@spikard/node-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-freebsd-x64')
         const bindingPackageVersion = require('@spikard/node-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-freebsd-arm64')
         const bindingPackageVersion = require('@spikard/node-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@spikard/node-linux-x64-musl')
           const bindingPackageVersion = require('@spikard/node-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@spikard/node-linux-x64-gnu')
           const bindingPackageVersion = require('@spikard/node-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@spikard/node-linux-arm64-musl')
           const bindingPackageVersion = require('@spikard/node-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@spikard/node-linux-arm64-gnu')
           const bindingPackageVersion = require('@spikard/node-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@spikard/node-linux-arm-musleabihf')
           const bindingPackageVersion = require('@spikard/node-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@spikard/node-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@spikard/node-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@spikard/node-linux-loong64-musl')
           const bindingPackageVersion = require('@spikard/node-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@spikard/node-linux-loong64-gnu')
           const bindingPackageVersion = require('@spikard/node-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@spikard/node-linux-riscv64-musl')
           const bindingPackageVersion = require('@spikard/node-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@spikard/node-linux-riscv64-gnu')
           const bindingPackageVersion = require('@spikard/node-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-linux-ppc64-gnu')
         const bindingPackageVersion = require('@spikard/node-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-linux-s390x-gnu')
         const bindingPackageVersion = require('@spikard/node-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-openharmony-arm64')
         const bindingPackageVersion = require('@spikard/node-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-openharmony-x64')
         const bindingPackageVersion = require('@spikard/node-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@spikard/node-openharmony-arm')
         const bindingPackageVersion = require('@spikard/node-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.15.6-rc.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.15.6-rc.21' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.15.6-rc.21 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -576,12 +576,18 @@ if (!nativeBinding) {
 }
 
 module.exports = nativeBinding
+module.exports.App = nativeBinding.App
+module.exports.JsApp = nativeBinding.JsApp
 module.exports.GraphQLRouteConfig = nativeBinding.GraphQLRouteConfig
 module.exports.JsGraphQLRouteConfig = nativeBinding.JsGraphQLRouteConfig
 module.exports.JsGraphQlErrorInfo = nativeBinding.JsGraphQlErrorInfo
 module.exports.JsGraphQLErrorInfo = nativeBinding.JsGraphQLErrorInfo
+module.exports.RouteBuilder = nativeBinding.RouteBuilder
+module.exports.JsRouteBuilder = nativeBinding.JsRouteBuilder
 module.exports.TestClient = nativeBinding.TestClient
 module.exports.JsTestClient = nativeBinding.JsTestClient
+module.exports.appIntoRouter = nativeBinding.appIntoRouter
+module.exports.appRun = nativeBinding.appRun
 module.exports.backgroundJobMetadataDefault = nativeBinding.backgroundJobMetadataDefault
 module.exports.backgroundTaskConfigDefault = nativeBinding.backgroundTaskConfigDefault
 module.exports.compressionConfigDefault = nativeBinding.compressionConfigDefault

package/package.json

@@ -1,39 +1,52 @@
 {
   "name": "@spikard/node",
-  "version": "0.15.6-rc.2",
+  "version": "0.15.6-rc.21",
   "description": "Rust-centric multi-language HTTP framework with polyglot bindings",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Goldziher/spikard.git"
   },
-  "files": [
-    "index.js",
-    "index.d.ts",
-    "*.node"
-  ],
   "main": "index.js",
   "types": "index.d.ts",
-  "scripts": {
-    "build": "napi build --platform --release",
-    "artifacts": "napi artifacts",
-    "prepublishOnly": "napi prepublish -t npm --skip-optional-publish"
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "default": "./index.js"
+    }
   },
-  "devDependencies": {
-    "@napi-rs/cli": "^3.6.2"
+  "files": ["index.js", "index.d.ts", "service.cjs", "*.node"],
+  "optionalDependencies": {
+    "@spikard/node-linux-x64-gnu": "0.15.6-rc.21",
+    "@spikard/node-linux-arm64-gnu": "0.15.6-rc.21",
+    "@spikard/node-linux-x64-musl": "0.15.6-rc.21",
+    "@spikard/node-linux-arm64-musl": "0.15.6-rc.21",
+    "@spikard/node-darwin-x64": "0.15.6-rc.21",
+    "@spikard/node-darwin-arm64": "0.15.6-rc.21",
+    "@spikard/node-win32-x64-msvc": "0.15.6-rc.21",
+    "@spikard/node-win32-arm64-msvc": "0.15.6-rc.21"
   },
   "napi": {
+    "packageName": "@spikard/node",
     "binaryName": "spikard-node",
     "targets": [
       "x86_64-unknown-linux-gnu",
       "aarch64-unknown-linux-gnu",
+      "x86_64-unknown-linux-musl",
+      "aarch64-unknown-linux-musl",
       "x86_64-apple-darwin",
       "aarch64-apple-darwin",
       "x86_64-pc-windows-msvc",
       "aarch64-pc-windows-msvc"
     ]
   },
-  "engines": {
-    "node": ">= 18"
-  }
+  "scripts": {
+    "build": "npx --yes -p @napi-rs/cli@^3.6.2 napi build --platform --release",
+    "artifacts": "npx --yes -p @napi-rs/cli@^3.6.2 napi artifacts",
+    "prepublishOnly": "npx --yes -p @napi-rs/cli@^3.6.2 napi prepublish -t npm --skip-optional-publish"
+  },
+  "engines": { "node": ">= 18" },
+  "publishConfig": { "access": "public" },
+  "devDependencies": { "@napi-rs/cli": "^3.6.2" }
 }

package/service.cjs

@@ -0,0 +1,197 @@
+// Auto-generated service API class
+
+const { ServerConfig } = require("./index");
+const { Method, RouteBuilder } = require("./index");
+const { appIntoRouter, appRun } = require("./index");
+/**
+ * Spikard application builder.
+ */
+class App {
+  _registrations = [];
+  /**
+   * Create a new App instance.
+   */
+  static new() {
+    return new App();
+  }
+  /**
+   * Create a new application with the default server configuration.
+   */
+  constructor() {
+    // Constructor initialization (parameters stored for future use)
+  }
+  /**
+   * Set the server configuration.
+   */
+  config(_config) {
+    return this;
+  }
+  /**
+   * Register a route using the provided builder and handler function.
+   *
+   * # Errors
+   *
+   * Returns an error if route construction fails or if the handler registration fails.
+   */
+  route(builder) {
+    return (fn) => {
+      this._registrations.push(["route", [builder], fn]);
+      return fn;
+    };
+  }
+  /**
+   * Register a route callback directly.
+   */
+  registerRoute(builder, handler) {
+    this._registrations.push(["route", [builder], handler]);
+    return this;
+  }
+  /**
+   * Register a GET route at the given path.
+   */
+  get(path, handler) {
+    const builder = RouteBuilder.new(Method.Get, path);
+    if (handler !== undefined) {
+      this._registrations.push(["route", [builder], handler]);
+      return this;
+    }
+    return (fn) => {
+      this._registrations.push(["route", [builder], fn]);
+      return fn;
+    };
+  }
+  /**
+   * Register a POST route at the given path.
+   */
+  post(path, handler) {
+    const builder = RouteBuilder.new(Method.Post, path);
+    if (handler !== undefined) {
+      this._registrations.push(["route", [builder], handler]);
+      return this;
+    }
+    return (fn) => {
+      this._registrations.push(["route", [builder], fn]);
+      return fn;
+    };
+  }
+  /**
+   * Register a PUT route at the given path.
+   */
+  put(path, handler) {
+    const builder = RouteBuilder.new(Method.Put, path);
+    if (handler !== undefined) {
+      this._registrations.push(["route", [builder], handler]);
+      return this;
+    }
+    return (fn) => {
+      this._registrations.push(["route", [builder], fn]);
+      return fn;
+    };
+  }
+  /**
+   * Register a PATCH route at the given path.
+   */
+  patch(path, handler) {
+    const builder = RouteBuilder.new(Method.Patch, path);
+    if (handler !== undefined) {
+      this._registrations.push(["route", [builder], handler]);
+      return this;
+    }
+    return (fn) => {
+      this._registrations.push(["route", [builder], fn]);
+      return fn;
+    };
+  }
+  /**
+   * Register a DELETE route at the given path.
+   */
+  delete(path, handler) {
+    const builder = RouteBuilder.new(Method.Delete, path);
+    if (handler !== undefined) {
+      this._registrations.push(["route", [builder], handler]);
+      return this;
+    }
+    return (fn) => {
+      this._registrations.push(["route", [builder], fn]);
+      return fn;
+    };
+  }
+  /**
+   * Register a HEAD route at the given path.
+   */
+  head(path, handler) {
+    const builder = RouteBuilder.new(Method.Head, path);
+    if (handler !== undefined) {
+      this._registrations.push(["route", [builder], handler]);
+      return this;
+    }
+    return (fn) => {
+      this._registrations.push(["route", [builder], fn]);
+      return fn;
+    };
+  }
+  /**
+   * Register an OPTIONS route at the given path.
+   */
+  options(path, handler) {
+    const builder = RouteBuilder.new(Method.Options, path);
+    if (handler !== undefined) {
+      this._registrations.push(["route", [builder], handler]);
+      return this;
+    }
+    return (fn) => {
+      this._registrations.push(["route", [builder], fn]);
+      return fn;
+    };
+  }
+  /**
+   * Register a CONNECT route at the given path.
+   */
+  connect(path, handler) {
+    const builder = RouteBuilder.new(Method.Connect, path);
+    if (handler !== undefined) {
+      this._registrations.push(["route", [builder], handler]);
+      return this;
+    }
+    return (fn) => {
+      this._registrations.push(["route", [builder], fn]);
+      return fn;
+    };
+  }
+  /**
+   * Register a TRACE route at the given path.
+   */
+  trace(path, handler) {
+    const builder = RouteBuilder.new(Method.Trace, path);
+    if (handler !== undefined) {
+      this._registrations.push(["route", [builder], handler]);
+      return this;
+    }
+    return (fn) => {
+      this._registrations.push(["route", [builder], fn]);
+      return fn;
+    };
+  }
+  /**
+   * Run the HTTP server using the configured routes.
+   *
+   * # Errors
+   *
+   * Returns an error if server construction or execution fails.
+   */
+  async run() {
+    return await appRun(this._registrations);
+  }
+  /**
+   * Build the underlying Axum router.
+   *
+   * # Errors
+   *
+   * Returns an error if server or router construction fails.
+   */
+  into_router() {
+    return appIntoRouter(this._registrations);
+  }
+}
+
+module.exports = { App };