vector-framework 1.2.2 → 1.2.3

package/src/checkpoint/types.ts

@@ -0,0 +1,63 @@
+export const CHECKPOINT_FORMAT_VERSION = 1;
+
+export type CheckpointCompressionCodec = 'none' | 'gzip';
+
+export interface CheckpointManifest {
+  formatVersion: number;
+  version: string;
+  createdAt: string;
+  entrypoint: string;
+  routes: CheckpointRouteRecord[];
+  assets: CheckpointAssetRecord[];
+  bundleHash: string;
+  bundleSize: number;
+  checkpointArchivePath?: string;
+  checkpointArchiveHash?: string;
+  checkpointArchiveSize?: number;
+  checkpointArchiveCodec?: CheckpointCompressionCodec;
+}
+
+export interface CheckpointRouteRecord {
+  method: string;
+  path: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface CheckpointAssetRecord {
+  type: 'embedded' | 'sidecar';
+  logicalPath: string;
+  // Legacy field kept for compatibility with existing tests/fixtures.
+  storedPath: string;
+  // Legacy field kept for compatibility with existing tests/fixtures.
+  hash: string;
+  // Legacy field kept for compatibility with existing tests/fixtures.
+  size: number;
+  contentHash?: string;
+  contentSize?: number;
+  blobHash?: string;
+  blobSize?: number;
+  blobPath?: string;
+  codec?: CheckpointCompressionCodec;
+  materializedPath?: string;
+}
+
+export interface CheckpointConfig {
+  enabled?: boolean;
+  storageDir?: string;
+  maxCheckpoints?: number;
+  versionHeader?: string;
+  idleTimeoutMs?: number;
+  cacheKeyOverride?: boolean;
+}
+
+export interface CheckpointPublishOptions {
+  version: string;
+  routesDir: string;
+  embeddedAssetPaths?: string[];
+  sidecarAssetPaths?: string[];
+}
+
+export interface ActivePointer {
+  version: string;
+  activatedAt: string;
+}

package/src/cli/index.ts

@@ -10,6 +10,14 @@ import type { StartedVectorApp } from '../types';
 // Compatibility layer for both Node and Bun
 const args = typeof Bun !== 'undefined' ? Bun.argv.slice(2) : process.argv.slice(2);
 
+// Handle checkpoint subcommand early — it has its own arg format
+// and would conflict with the main parseArgs strict mode.
+if (args[0] === 'checkpoint') {
+  const { runCheckpointCli } = await import('../checkpoint/cli');
+  await runCheckpointCli(args.slice(1));
+  process.exit(0);
+}
+
 const { values, positionals } = parseArgs({
   args,
   options: {
@@ -224,8 +232,9 @@ switch (command) {
 Usage: vector [command] [options]
 
 Commands:
-  dev     Start development server (default)
-  start   Start production server
+  dev       Start development server (default)
+  start     Start production server
+  checkpoint  Manage versioned checkpoints (publish, list, rollback, remove)
 
 Options:
   -p, --port <port>      Port to listen on (default: 3000)

package/src/cli/option-resolution.ts

@@ -20,7 +20,11 @@ function parseAndValidatePort(value: unknown): number {
   return parsed;
 }
 
-export function resolvePort(configPort: number | null | undefined, hasPortOption: boolean, cliPort: string): number {
+export function resolvePort(
+  configPort: string | number | null | undefined,
+  hasPortOption: boolean,
+  cliPort: string
+): number {
   if (hasPortOption) {
     return parseAndValidatePort(cliPort);
   }

package/src/core/config-loader.ts

@@ -29,8 +29,9 @@ export class ConfigLoader<TTypes extends VectorTypes = DefaultVectorTypes> {
     if (existsSync(this.configPath)) {
       try {
         // Use explicit file:// URL to ensure correct resolution
+        // Append cache-busting query to force re-import on dev reload
         const userConfigPath = toFileUrl(this.configPath);
-        const userConfig = await import(userConfigPath);
+        const userConfig = await import(`${userConfigPath}?t=${Date.now()}`);
         this.config = userConfig.default || userConfig;
         this.configSource = 'user';
       } catch (error: any) {
@@ -57,7 +58,7 @@ export class ConfigLoader<TTypes extends VectorTypes = DefaultVectorTypes> {
 
     // Direct mapping - schemas are now the same (flat)
     if (this.config) {
-      config.port = this.config.port;
+      config.port = this.normalizePort(this.config.port);
       config.hostname = this.config.hostname;
       config.reusePort = this.config.reusePort;
       config.development = this.config.development;
@@ -68,6 +69,7 @@ export class ConfigLoader<TTypes extends VectorTypes = DefaultVectorTypes> {
       config.openapi = this.config.openapi;
       config.startup = this.config.startup;
       config.shutdown = this.config.shutdown;
+      config.checkpoint = this.config.checkpoint;
     }
 
     // Always auto-discover routes
@@ -103,6 +105,13 @@ export class ConfigLoader<TTypes extends VectorTypes = DefaultVectorTypes> {
     return config;
   }
 
+  private normalizePort(port: number | string | undefined): number | undefined {
+    if (port === undefined) {
+      return undefined;
+    }
+    return Number(port);
+  }
+
   async loadAuthHandler(): Promise<ProtectedHandler<TTypes> | null> {
     return this.config?.auth || null;
   }