@veloxts/web 0.6.57 → 0.6.59

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @veloxts/web
 
+## 0.6.59
+
+### Patch Changes
+
+- refactor(ecosystem): Laravel-style API refinements & added missing unit tests
+- Updated dependencies
+  - @veloxts/auth@0.6.59
+  - @veloxts/client@0.6.59
+  - @veloxts/core@0.6.59
+  - @veloxts/router@0.6.59
+
+## 0.6.58
+
+### Patch Changes
+
+- feat(router): add OpenAPI 3.0.3 specification generator
+- Updated dependencies
+  - @veloxts/auth@0.6.58
+  - @veloxts/client@0.6.58
+  - @veloxts/core@0.6.58
+  - @veloxts/router@0.6.58
+
 ## 0.6.57
 
 ### Patch Changes

package/dist/app/create-app.d.ts

@@ -163,15 +163,15 @@ export interface DefineVeloxAppOptions {
  *
  * @example Minimal (all defaults)
  * ```typescript
- * import { defineVeloxApp } from '@veloxts/web';
- * export default defineVeloxApp();
+ * import { createVeloxApp } from '@veloxts/web';
+ * export default createVeloxApp();
  * ```
  *
  * @example Flat config (preferred, Laravel-style)
  * ```typescript
- * import { defineVeloxApp } from '@veloxts/web';
+ * import { createVeloxApp } from '@veloxts/web';
  *
- * export default defineVeloxApp({
+ * export default createVeloxApp({
  *   port: 3030,
  *   apiPrefix: '/api',
  *   pagesDir: 'app/pages',
@@ -180,15 +180,33 @@ export interface DefineVeloxAppOptions {
  *
  * @example Nested config (backward compatible)
  * ```typescript
- * import { defineVeloxApp } from '@veloxts/web';
+ * import { createVeloxApp } from '@veloxts/web';
  *
- * export default defineVeloxApp({
+ * export default createVeloxApp({
  *   server: { port: 3030 },
  *   api: { prefix: '/api' },
  * });
  * ```
  */
-export declare function defineVeloxApp(options?: DefineVeloxAppOptions): VinxiApp;
+export declare function createVeloxApp(options?: DefineVeloxAppOptions): VinxiApp;
+/**
+ * @deprecated Use `createVeloxApp()` instead. Will be removed in v2.0.
+ *
+ * The naming `define*` is reserved for type/schema definitions in VeloxTS.
+ * Factory functions that create instances use `create*` naming.
+ *
+ * @example
+ * ```typescript
+ * // Old (deprecated):
+ * import { defineVeloxApp } from '@veloxts/web';
+ * export default defineVeloxApp({ port: 3030 });
+ *
+ * // New:
+ * import { createVeloxApp } from '@veloxts/web';
+ * export default createVeloxApp({ port: 3030 });
+ * ```
+ */
+export declare const defineVeloxApp: typeof createVeloxApp;
 /**
  * Re-export for convenience
  */

package/dist/app/create-app.js

@@ -18,15 +18,15 @@ import { getEnvConfig, resolveConfig, validateConfig } from './config.js';
  *
  * @example Minimal (all defaults)
  * ```typescript
- * import { defineVeloxApp } from '@veloxts/web';
- * export default defineVeloxApp();
+ * import { createVeloxApp } from '@veloxts/web';
+ * export default createVeloxApp();
  * ```
  *
  * @example Flat config (preferred, Laravel-style)
  * ```typescript
- * import { defineVeloxApp } from '@veloxts/web';
+ * import { createVeloxApp } from '@veloxts/web';
  *
- * export default defineVeloxApp({
+ * export default createVeloxApp({
  *   port: 3030,
  *   apiPrefix: '/api',
  *   pagesDir: 'app/pages',
@@ -35,15 +35,15 @@ import { getEnvConfig, resolveConfig, validateConfig } from './config.js';
  *
  * @example Nested config (backward compatible)
  * ```typescript
- * import { defineVeloxApp } from '@veloxts/web';
+ * import { createVeloxApp } from '@veloxts/web';
  *
- * export default defineVeloxApp({
+ * export default createVeloxApp({
  *   server: { port: 3030 },
  *   api: { prefix: '/api' },
  * });
  * ```
  */
-export function defineVeloxApp(options = {}) {
+export function createVeloxApp(options = {}) {
     // Merge environment config with provided options
     const envConfig = getEnvConfig();
     // Support both flat and nested config (flat takes precedence)
@@ -84,6 +84,24 @@ export function defineVeloxApp(options = {}) {
         routers,
     });
 }
+/**
+ * @deprecated Use `createVeloxApp()` instead. Will be removed in v2.0.
+ *
+ * The naming `define*` is reserved for type/schema definitions in VeloxTS.
+ * Factory functions that create instances use `create*` naming.
+ *
+ * @example
+ * ```typescript
+ * // Old (deprecated):
+ * import { defineVeloxApp } from '@veloxts/web';
+ * export default defineVeloxApp({ port: 3030 });
+ *
+ * // New:
+ * import { createVeloxApp } from '@veloxts/web';
+ * export default createVeloxApp({ port: 3030 });
+ * ```
+ */
+export const defineVeloxApp = createVeloxApp;
 /**
  * Creates the four routers for the Vinxi application
  *

package/dist/index.d.ts

@@ -14,7 +14,7 @@
  *
  * ```typescript
  * // Build-time configuration (app.config.ts) - runs in Node.js
- * import { defineVeloxApp } from '@veloxts/web';
+ * import { createVeloxApp } from '@veloxts/web';
  *
  * // Server action files ('use server') - runs in RSC context
  * import { authAction, validated } from '@veloxts/web/server';
@@ -28,7 +28,7 @@
  *
  * ## Why No server-only Guard Here?
  *
- * This module includes build-time configuration (`defineVeloxApp`) which runs
+ * This module includes build-time configuration (`createVeloxApp`) which runs
  * in Node.js context during Vinxi's config loading, NOT in React Server Component
  * context. The `server-only` package is designed to prevent client bundle inclusion,
  * but it incorrectly throws during legitimate Node.js build-time usage.
@@ -40,7 +40,9 @@
  * @packageDocumentation
  */
 export { getEnvConfig, resolveConfig, validateConfig, } from './app/config.js';
-export { type ApiConfig, type BuildConfig, type DefineVeloxAppOptions, defineVeloxApp, type RoutingConfig, type ServerConfig, } from './app/create-app.js';
+export { type ApiConfig, type BuildConfig, createVeloxApp, type DefineVeloxAppOptions, 
+/** @deprecated Use createVeloxApp(). Will be removed in v2.0. */
+defineVeloxApp, type RoutingConfig, type ServerConfig, } from './app/create-app.js';
 export { Document } from './rendering/document.js';
 export { type ClientManifest, createEmptyModuleMap, createModuleMap, type FlightModuleMap, getClientComponentChunks, isClientComponent, loadClientManifest, resolveClientManifest, } from './rendering/flight.js';
 export { clearComponentCache, type RenderToStreamOptions, renderToStream, } from './rendering/server-renderer.js';

package/dist/index.js

@@ -14,7 +14,7 @@
  *
  * ```typescript
  * // Build-time configuration (app.config.ts) - runs in Node.js
- * import { defineVeloxApp } from '@veloxts/web';
+ * import { createVeloxApp } from '@veloxts/web';
  *
  * // Server action files ('use server') - runs in RSC context
  * import { authAction, validated } from '@veloxts/web/server';
@@ -28,7 +28,7 @@
  *
  * ## Why No server-only Guard Here?
  *
- * This module includes build-time configuration (`defineVeloxApp`) which runs
+ * This module includes build-time configuration (`createVeloxApp`) which runs
  * in Node.js context during Vinxi's config loading, NOT in React Server Component
  * context. The `server-only` package is designed to prevent client bundle inclusion,
  * but it incorrectly throws during legitimate Node.js build-time usage.
@@ -43,7 +43,9 @@ export { getEnvConfig, resolveConfig, validateConfig, } from './app/config.js';
 // ============================================================================
 // App Configuration (always server-side)
 // ============================================================================
-export { defineVeloxApp, } from './app/create-app.js';
+export { createVeloxApp, 
+/** @deprecated Use createVeloxApp(). Will be removed in v2.0. */
+defineVeloxApp, } from './app/create-app.js';
 // ============================================================================
 // Rendering (Server-Side)
 // ============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/web",
-  "version": "0.6.57",
+  "version": "0.6.59",
   "description": "React Server Components integration for VeloxTS framework using Vinxi",
   "type": "module",
   "main": "dist/index.js",
@@ -72,10 +72,10 @@
   "peerDependencies": {
     "react": ">=19.2.0",
     "react-dom": ">=19.2.0",
-    "@veloxts/auth": "0.6.57",
-    "@veloxts/client": "0.6.57",
-    "@veloxts/core": "0.6.57",
-    "@veloxts/router": "0.6.57"
+    "@veloxts/auth": "0.6.59",
+    "@veloxts/router": "0.6.59",
+    "@veloxts/client": "0.6.59",
+    "@veloxts/core": "0.6.59"
   },
   "peerDependenciesMeta": {
     "@veloxts/auth": {
@@ -98,10 +98,10 @@
     "react-server-dom-webpack": "19.2.3",
     "typescript": "5.9.3",
     "vitest": "4.0.16",
-    "@veloxts/core": "0.6.57",
-    "@veloxts/client": "0.6.57",
-    "@veloxts/auth": "0.6.57",
-    "@veloxts/router": "0.6.57"
+    "@veloxts/core": "0.6.59",
+    "@veloxts/client": "0.6.59",
+    "@veloxts/router": "0.6.59",
+    "@veloxts/auth": "0.6.59"
   },
   "keywords": [
     "velox",