vector-framework 1.2.0 → 1.2.1

package/src/types/index.ts

@@ -1,4 +1,5 @@
 import type { StandardJSONSchemaV1, StandardSchemaV1, StandardTypedV1 } from './standard-schema';
+import type { Server } from 'bun';
 
 // Default AuthUser type - users can override this with their own type
 export interface DefaultAuthUser {
@@ -150,6 +151,31 @@ export interface VectorConfig<TTypes extends VectorTypes = DefaultVectorTypes> {
   idleTimeout?: number;
   defaults?: VectorDefaults;
   openapi?: OpenAPIOptions | boolean;
+  startup?: StartupHandler;
+  shutdown?: ShutdownHandler;
+}
+
+export interface StartVectorContext {
+  configSource: 'user' | 'default';
+}
+
+export interface StartVectorOptions<TTypes extends VectorTypes = DefaultVectorTypes> {
+  configPath?: string;
+  config?: Partial<VectorConfig<TTypes>>;
+  autoDiscover?: boolean;
+  protectedHandler?: ProtectedHandler<TTypes> | null;
+  cacheHandler?: CacheHandler | null;
+  mutateConfig?: (
+    config: VectorConfig<TTypes>,
+    context: StartVectorContext
+  ) => VectorConfig<TTypes> | Promise<VectorConfig<TTypes>>;
+}
+
+export interface StartedVectorApp<TTypes extends VectorTypes = DefaultVectorTypes> {
+  server: Server;
+  config: VectorConfig<TTypes>;
+  stop: () => void;
+  shutdown: () => Promise<void>;
 }
 
 // New config-driven schema - flat structure
@@ -178,6 +204,10 @@ export interface VectorConfigSchema<TTypes extends VectorTypes = DefaultVectorTy
   // OpenAPI/docs configuration
   openapi?: OpenAPIOptions | boolean;
 
+  // Startup lifecycle
+  startup?: StartupHandler;
+  shutdown?: ShutdownHandler;
+
   // Custom types for TypeScript
   types?: VectorTypes;
 }
@@ -194,6 +224,7 @@ export interface CorsOptions {
 export interface OpenAPIDocsOptions {
   enabled?: boolean;
   path?: string;
+  exposePaths?: string[];
 }
 
 export interface OpenAPIInfoOptions {
@@ -220,6 +251,9 @@ export type AfterMiddlewareHandler<TTypes extends VectorTypes = DefaultVectorTyp
 ) => Promise<Response> | Response;
 export type MiddlewareHandler = BeforeMiddlewareHandler | AfterMiddlewareHandler;
 
+export type StartupHandler = () => Promise<void> | void;
+export type ShutdownHandler = () => Promise<void> | void;
+
 export type RouteHandler<TTypes extends VectorTypes = DefaultVectorTypes, TValidatedInput = undefined> = (
   request: VectorRequest<TTypes, TValidatedInput>
 ) => Promise<any> | any;

package/src/utils/logger.ts

@@ -17,7 +17,7 @@ export class Logger {
   constructor(config: Partial<LoggerConfig> = {}) {
     this.config = {
       level: config.level ?? LogLevel.INFO,
-      prefix: config.prefix ?? '[Vector]',
+      prefix: config.prefix ?? '[vector]',
       timestamp: config.timestamp ?? true,
     };
   }

package/src/utils/validation.ts

@@ -13,6 +13,8 @@ export function validateConfig(config: VectorConfig): VectorConfig {
     cors: config.cors ? validateCorsOptions(config.cors) : undefined,
     before: config.before || [],
     finally: config.finally || [],
+    startup: config.startup,
+    shutdown: config.shutdown,
   };
 
   return validatedConfig;