vector-framework 1.2.2 → 1.2.3

package/dist/checkpoint/cli.js

@@ -0,0 +1,157 @@
+import { parseArgs } from 'node:util';
+import { CheckpointManager } from './manager';
+export async function runCheckpointCli(argv) {
+    const subcommand = argv[0];
+    switch (subcommand) {
+        case 'publish':
+            return await cliPublish(argv.slice(1));
+        case 'list':
+            return await cliList(argv.slice(1));
+        case 'rollback':
+            return await cliRollback(argv.slice(1));
+        case 'remove':
+            return await cliRemove(argv.slice(1));
+        default:
+            printCheckpointHelp();
+            if (subcommand) {
+                console.error(`\nUnknown checkpoint command: ${subcommand}`);
+            }
+            process.exit(1);
+    }
+}
+async function cliPublish(args) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            version: { type: 'string', short: 'v' },
+            routes: { type: 'string', short: 'r', default: './routes' },
+            storage: { type: 'string', short: 's' },
+        },
+        strict: true,
+    });
+    if (!values.version) {
+        console.error('Error: --version is required for publish');
+        console.error('Usage: vector checkpoint publish --version <ver> [--routes <dir>]');
+        process.exit(1);
+    }
+    const manager = new CheckpointManager(values.storage ? { storageDir: values.storage } : undefined);
+    try {
+        console.log(`Publishing checkpoint ${values.version}...`);
+        const manifest = await manager.publish({
+            version: values.version,
+            routesDir: values.routes,
+        });
+        console.log(`Checkpoint ${manifest.version} published successfully.`);
+        console.log(`  Bundle hash: ${manifest.bundleHash.slice(0, 12)}...`);
+        console.log(`  Bundle size: ${formatBytes(manifest.bundleSize)}`);
+        console.log(`  Routes: ${manifest.routes.length}`);
+        console.log(`  Assets: ${manifest.assets.length}`);
+    }
+    catch (err) {
+        console.error(`Failed to publish checkpoint: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function cliList(args) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            storage: { type: 'string', short: 's' },
+        },
+        strict: true,
+    });
+    const manager = new CheckpointManager(values.storage ? { storageDir: values.storage } : undefined);
+    const manifests = await manager.listVersions();
+    const active = await manager.getActive();
+    if (manifests.length === 0) {
+        console.log('No checkpoints found.');
+        return;
+    }
+    console.log('');
+    console.log('  Version      Created                    Bundle Hash     Size       Status');
+    console.log('  ─────────────────────────────────────────────────────────────────────────');
+    for (const m of manifests) {
+        const isActive = active?.version === m.version;
+        const status = isActive ? '● active' : '  ';
+        const hash = m.bundleHash.slice(0, 12);
+        const size = formatBytes(m.bundleSize).padEnd(10);
+        const created = new Date(m.createdAt).toISOString().replace('T', ' ').slice(0, 19);
+        console.log(`  ${m.version.padEnd(12)} ${created}   ${hash}...   ${size} ${status}`);
+    }
+    console.log('');
+}
+async function cliRollback(args) {
+    const { positionals, values } = parseArgs({
+        args,
+        options: {
+            storage: { type: 'string', short: 's' },
+        },
+        strict: true,
+        allowPositionals: true,
+    });
+    const version = positionals[0];
+    if (!version) {
+        console.error('Error: version argument is required');
+        console.error('Usage: vector checkpoint rollback <version>');
+        process.exit(1);
+    }
+    const manager = new CheckpointManager(values.storage ? { storageDir: values.storage } : undefined);
+    try {
+        await manager.setActive(version);
+        console.log(`Active checkpoint set to ${version}.`);
+        console.log('Note: Restart the server for the change to take effect.');
+    }
+    catch (err) {
+        console.error(`Failed to rollback: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function cliRemove(args) {
+    const { positionals, values } = parseArgs({
+        args,
+        options: {
+            storage: { type: 'string', short: 's' },
+        },
+        strict: true,
+        allowPositionals: true,
+    });
+    const version = positionals[0];
+    if (!version) {
+        console.error('Error: version argument is required');
+        console.error('Usage: vector checkpoint remove <version>');
+        process.exit(1);
+    }
+    const manager = new CheckpointManager(values.storage ? { storageDir: values.storage } : undefined);
+    try {
+        await manager.remove(version);
+        console.log(`Checkpoint ${version} removed.`);
+    }
+    catch (err) {
+        console.error(`Failed to remove checkpoint: ${err.message}`);
+        process.exit(1);
+    }
+}
+function printCheckpointHelp() {
+    console.log(`
+Usage: vector checkpoint <command>
+
+Commands:
+  publish   --version <ver> [--routes <dir>]   Build and store a checkpoint
+  list                                          List all stored checkpoints
+  rollback  <version>                           Activate a specific checkpoint
+  remove    <version>                           Delete a checkpoint
+
+Options:
+  -v, --version   Semver version string (e.g. 1.2.0)
+  -r, --routes    Routes directory (default: ./routes)
+  -s, --storage   Checkpoint storage dir (default: .vector/checkpoints)
+`);
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=cli.js.map

package/dist/checkpoint/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/checkpoint/cli.ts"],"names":[],"mappings":"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"}

package/dist/checkpoint/entrypoint-generator.d.ts

@@ -0,0 +1,17 @@
+import type { CheckpointRouteRecord } from './types';
+export interface EntrypointGeneratorOptions {
+    version: string;
+    outputDir: string;
+    routesDir: string;
+    socketPath: string;
+}
+export declare class CheckpointEntrypointGenerator {
+    private discoveredRoutes;
+    generate(options: EntrypointGeneratorOptions): Promise<string>;
+    getDiscoveredRoutes(): CheckpointRouteRecord[];
+    private scanRouteFiles;
+    private walkDir;
+    private buildSource;
+    private toImportSpecifier;
+}
+//# sourceMappingURL=entrypoint-generator.d.ts.map

package/dist/checkpoint/entrypoint-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrypoint-generator.d.ts","sourceRoot":"","sources":["../../src/checkpoint/entrypoint-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,6BAA6B;IACxC,OAAO,CAAC,gBAAgB,CAA+B;IAEjD,QAAQ,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC;IASpE,mBAAmB,IAAI,qBAAqB,EAAE;YAIhC,cAAc;YAUd,OAAO;IAsBrB,OAAO,CAAC,WAAW;IAgNnB,OAAO,CAAC,iBAAiB;CAO1B"}

package/dist/checkpoint/entrypoint-generator.js

@@ -0,0 +1,251 @@
+import { existsSync, promises as fs } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+export class CheckpointEntrypointGenerator {
+    discoveredRoutes = [];
+    async generate(options) {
+        const routeFiles = await this.scanRouteFiles(options.routesDir);
+        const source = this.buildSource(routeFiles, options);
+        const outputPath = join(options.outputDir, 'entrypoint.ts');
+        await fs.writeFile(outputPath, source, 'utf-8');
+        return outputPath;
+    }
+    getDiscoveredRoutes() {
+        return this.discoveredRoutes;
+    }
+    async scanRouteFiles(routesDir) {
+        if (!existsSync(routesDir)) {
+            return [];
+        }
+        const files = [];
+        await this.walkDir(routesDir, files);
+        return files;
+    }
+    async walkDir(dir, files) {
+        const entries = await fs.readdir(dir);
+        for (const entry of entries) {
+            const fullPath = join(dir, entry);
+            const stats = await fs.stat(fullPath);
+            if (stats.isDirectory()) {
+                await this.walkDir(fullPath, files);
+            }
+            else if ((entry.endsWith('.ts') || entry.endsWith('.js')) &&
+                !entry.endsWith('.test.ts') &&
+                !entry.endsWith('.test.js') &&
+                !entry.endsWith('.spec.ts') &&
+                !entry.endsWith('.spec.js') &&
+                !entry.endsWith('.d.ts')) {
+                files.push(fullPath);
+            }
+        }
+    }
+    buildSource(routeFiles, options) {
+        this.discoveredRoutes = [];
+        const imports = [];
+        const registrations = [];
+        for (const [i, file] of routeFiles.entries()) {
+            const varName = `routeModule_${i}`;
+            const importSpecifier = this.toImportSpecifier(file, options.outputDir);
+            imports.push(`import * as ${varName} from ${JSON.stringify(importSpecifier)};`);
+            registrations.push(`  registerModule(${varName});`);
+            // Record discovered route for manifest
+            const routePath = relative(options.routesDir, file)
+                .replace(/\.(ts|js)$/, '')
+                .split(sep)
+                .join('/');
+            this.discoveredRoutes.push({
+                method: '*',
+                path: `/${routePath}`,
+            });
+        }
+        return `// Checkpoint entrypoint — auto-generated for version ${options.version}
+// DO NOT EDIT: This file is generated by Vector checkpoint publish.
+
+${imports.join('\n')}
+
+const socketPath = process.env.VECTOR_CHECKPOINT_SOCKET ?? '${options.socketPath}';
+const checkpointContextHeader = 'x-vector-checkpoint-context';
+
+// Route registration helper
+type RouteDefinition = {
+  entry: { method: string; path: string };
+  options: { method: string; path: string; [key: string]: any };
+  handler: (ctx: any) => any;
+};
+
+function isRouteDefinition(value: unknown): value is RouteDefinition {
+  return (
+    value !== null &&
+    typeof value === 'object' &&
+    'entry' in value &&
+    'options' in value &&
+    'handler' in value &&
+    typeof (value as any).handler === 'function'
+  );
+}
+
+const routeTable: Record<string, Record<string, (req: Request) => Response | Promise<Response>>> = {};
+
+function parseCheckpointContext(req: Request): Record<string, unknown> {
+  const encoded = req.headers.get(checkpointContextHeader);
+  if (!encoded) {
+    return {};
+  }
+
+  try {
+    const json = Buffer.from(encoded, 'base64url').toString('utf-8');
+    const parsed = JSON.parse(json);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+      return {};
+    }
+    return parsed as Record<string, unknown>;
+  } catch {
+    return {};
+  }
+}
+
+function parseQuery(url: URL): Record<string, string | string[]> {
+  const query: Record<string, string | string[]> = {};
+  for (const [key, value] of url.searchParams) {
+    if (key in query) {
+      const existing = query[key];
+      if (Array.isArray(existing)) {
+        existing.push(value);
+      } else {
+        query[key] = [existing as string, value];
+      }
+    } else {
+      query[key] = value;
+    }
+  }
+  return query;
+}
+
+function parseCookies(cookieHeader: string | null): Record<string, string> {
+  const cookies: Record<string, string> = {};
+  if (!cookieHeader) {
+    return cookies;
+  }
+  for (const pair of cookieHeader.split(';')) {
+    const idx = pair.indexOf('=');
+    if (idx > 0) {
+      cookies[pair.slice(0, idx).trim()] = pair.slice(idx + 1).trim();
+    }
+  }
+  return cookies;
+}
+
+function extractRouteParams(req: Request): Record<string, string> {
+  const nativeParams = (req as Request & { params?: Record<string, string> }).params;
+  if (nativeParams && typeof nativeParams === 'object' && !Array.isArray(nativeParams)) {
+    return nativeParams;
+  }
+  return {};
+}
+
+function createContext(req: Request): Record<string, unknown> {
+  const ctx: Record<string, unknown> = Object.create(null);
+  setContextField(ctx, 'request', req);
+
+  // Initialize always-present VectorContext fields with defaults derived from the request
+  setContextField(ctx, 'params', extractRouteParams(req));
+
+  try {
+    setContextField(ctx, 'query', parseQuery(new URL(req.url)));
+  } catch {
+    setContextField(ctx, 'query', {});
+  }
+
+  setContextField(ctx, 'cookies', parseCookies(req.headers.get('cookie')));
+  setContextField(ctx, 'metadata', {});
+
+  const checkpointContext = parseCheckpointContext(req);
+  const allowedCheckpointKeys = ['metadata', 'content', 'validatedInput', 'authUser'] as const;
+  for (const key of allowedCheckpointKeys) {
+    if (!Object.prototype.hasOwnProperty.call(checkpointContext, key)) {
+      continue;
+    }
+    const value = checkpointContext[key];
+    setContextField(ctx, key, value);
+  }
+
+  return ctx;
+}
+
+function setContextField(target: Record<string, unknown>, key: string, value: unknown) {
+  const ownDescriptor = Object.getOwnPropertyDescriptor(target as object, key);
+  if (ownDescriptor && ownDescriptor.writable === false && typeof ownDescriptor.set !== 'function') {
+    return;
+  }
+
+  try {
+    target[key] = value;
+    return;
+  } catch {
+    // Fall back to own-property define when inherited Request field is readonly.
+  }
+
+  try {
+    Object.defineProperty(target, key, {
+      value,
+      writable: true,
+      configurable: true,
+      enumerable: true,
+    });
+  } catch {
+    // Ignore non-extensible context edge cases.
+  }
+}
+
+function addToRouteTable(method: string, path: string, handler: (ctx: any) => any) {
+  if (!routeTable[path]) {
+    routeTable[path] = Object.create(null);
+  }
+  routeTable[path][method.toUpperCase()] = async (req: Request) => {
+    const ctx = createContext(req);
+    const result = await handler(ctx);
+    if (result instanceof Response) return result;
+    return Response.json(result);
+  };
+}
+
+function registerModule(mod: Record<string, unknown>) {
+  for (const [name, value] of Object.entries(mod)) {
+    if (isRouteDefinition(value)) {
+      addToRouteTable(value.options.method, value.options.path, value.handler);
+    } else if (name === 'default' && typeof value === 'function') {
+      // Default export functions need path context — skip for now
+    }
+  }
+}
+
+${registrations.join('\n')}
+
+// Health check endpoint for parent process
+routeTable['/_vector/health'] = {
+  GET: () => Response.json({ status: 'ok', version: '${options.version}' }),
+};
+
+const server = Bun.serve({
+  unix: socketPath,
+  routes: routeTable,
+  fetch(req: Request) {
+    return Response.json(
+      { error: true, message: 'Not Found', statusCode: 404 },
+      { status: 404 }
+    );
+  },
+});
+
+// Signal readiness to parent process
+process.stdout.write('READY\\n');
+`;
+    }
+    toImportSpecifier(filePath, outputDir) {
+        const normalized = relative(outputDir, filePath).split(sep).join('/');
+        if (normalized.startsWith('.') || normalized.startsWith('/')) {
+            return normalized;
+        }
+        return `./${normalized}`;
+    }
+}
+//# sourceMappingURL=entrypoint-generator.js.map

package/dist/checkpoint/entrypoint-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrypoint-generator.js","sourceRoot":"","sources":["../../src/checkpoint/entrypoint-generator.ts"],"names":[],"mappings":"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"}

package/dist/checkpoint/forwarder.d.ts

@@ -0,0 +1,6 @@
+export declare const CHECKPOINT_CONTEXT_HEADER = "x-vector-checkpoint-context";
+export type CheckpointContextPayload = Record<string, unknown>;
+export declare class CheckpointForwarder {
+    forward(request: Request, socketPath: string, contextPayload?: CheckpointContextPayload): Promise<Response>;
+}
+//# sourceMappingURL=forwarder.d.ts.map

package/dist/checkpoint/forwarder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forwarder.d.ts","sourceRoot":"","sources":["../../src/checkpoint/forwarder.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AAEvE,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/D,qBAAa,mBAAmB;IACxB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,QAAQ,CAAC;CA6BlH"}

package/dist/checkpoint/forwarder.js

@@ -0,0 +1,74 @@
+export const CHECKPOINT_CONTEXT_HEADER = 'x-vector-checkpoint-context';
+export class CheckpointForwarder {
+    async forward(request, socketPath, contextPayload) {
+        try {
+            const encodedContext = encodeCheckpointContext(contextPayload);
+            const headers = buildForwardHeaders(request.headers, encodedContext);
+            const response = await fetch(request.url, {
+                method: request.method,
+                headers,
+                body: request.body,
+                unix: socketPath,
+                // @ts-ignore - duplex required for streaming body
+                duplex: request.body ? 'half' : undefined,
+            });
+            // Clone the response so headers are mutable (fetch returns immutable headers).
+            // This is required because the parent server applies CORS headers after forwarding.
+            return new Response(response.body, {
+                status: response.status,
+                statusText: response.statusText,
+                headers: new Headers(response.headers),
+            });
+        }
+        catch (error) {
+            console.error('[CheckpointForwarder] Forward failed:', error);
+            return new Response(JSON.stringify({ error: true, message: 'Checkpoint unavailable', statusCode: 503 }), {
+                status: 503,
+                headers: { 'content-type': 'application/json' },
+            });
+        }
+    }
+}
+function buildForwardHeaders(source, encodedContext) {
+    const headers = new Headers(source);
+    stripHopByHopHeaders(headers);
+    if (encodedContext) {
+        headers.set(CHECKPOINT_CONTEXT_HEADER, encodedContext);
+    }
+    return headers;
+}
+function stripHopByHopHeaders(headers) {
+    const connectionValue = headers.get('connection');
+    if (connectionValue) {
+        for (const token of connectionValue.split(',')) {
+            const normalized = token.trim().toLowerCase();
+            if (normalized) {
+                headers.delete(normalized);
+            }
+        }
+    }
+    headers.delete('connection');
+    headers.delete('keep-alive');
+    headers.delete('proxy-authenticate');
+    headers.delete('proxy-authorization');
+    headers.delete('te');
+    headers.delete('trailer');
+    headers.delete('transfer-encoding');
+    headers.delete('upgrade');
+}
+function encodeCheckpointContext(contextPayload) {
+    if (!contextPayload) {
+        return null;
+    }
+    const keys = Object.keys(contextPayload);
+    if (keys.length === 0) {
+        return null;
+    }
+    try {
+        return Buffer.from(JSON.stringify(contextPayload), 'utf-8').toString('base64url');
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=forwarder.js.map

package/dist/checkpoint/forwarder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forwarder.js","sourceRoot":"","sources":["../../src/checkpoint/forwarder.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG,6BAA6B,CAAC;AAIvE,MAAM,OAAO,mBAAmB;IAC9B,KAAK,CAAC,OAAO,CAAC,OAAgB,EAAE,UAAkB,EAAE,cAAyC;QAC3F,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAC;YAC/D,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAErE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;gBACxC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO;gBACP,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,UAAU;gBAChB,kDAAkD;gBAClD,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;aACnC,CAAC,CAAC;YAEV,+EAA+E;YAC/E,oFAAoF;YACpF,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;gBACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,OAAO,EAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;aACvC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;YAC9D,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,wBAAwB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE;gBACvG,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;aAChD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAED,SAAS,mBAAmB,CAAC,MAAe,EAAE,cAA6B;IACzE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAE9B,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,cAAc,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAgB;IAC5C,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,MAAM,KAAK,IAAI,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC9C,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACrC,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACtC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1B,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACpC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,uBAAuB,CAAC,cAAyC;IACxE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/checkpoint/gateway.d.ts

@@ -0,0 +1,11 @@
+import type { CheckpointResolver } from './resolver';
+import type { CheckpointContextPayload, CheckpointForwarder } from './forwarder';
+export declare class CheckpointGateway {
+    private resolver;
+    private forwarder;
+    constructor(resolver: CheckpointResolver, forwarder: CheckpointForwarder);
+    getRequestedVersion(request: Request): string | null;
+    getCacheKeyOverrideValue(request: Request): string | null;
+    handle(request: Request, contextPayload?: CheckpointContextPayload): Promise<Response | null>;
+}
+//# sourceMappingURL=gateway.d.ts.map

package/dist/checkpoint/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/checkpoint/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEjF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAAsB;gBAE3B,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,mBAAmB;IAKxE,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAIpD,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAInD,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;CAmBpG"}

package/dist/checkpoint/gateway.js

@@ -0,0 +1,30 @@
+export class CheckpointGateway {
+    resolver;
+    forwarder;
+    constructor(resolver, forwarder) {
+        this.resolver = resolver;
+        this.forwarder = forwarder;
+    }
+    getRequestedVersion(request) {
+        return this.resolver.getRequestedVersion(request);
+    }
+    getCacheKeyOverrideValue(request) {
+        return this.resolver.getCacheKeyOverrideValue(request);
+    }
+    async handle(request, contextPayload) {
+        const requestedVersion = this.getRequestedVersion(request);
+        const socketPath = await this.resolver.resolve(request);
+        if (!socketPath) {
+            if (requestedVersion) {
+                return new Response(JSON.stringify({
+                    error: true,
+                    message: `Requested checkpoint version "${requestedVersion}" is unavailable`,
+                    statusCode: 503,
+                }), { status: 503, headers: { 'content-type': 'application/json' } });
+            }
+            return null;
+        }
+        return await this.forwarder.forward(request, socketPath, contextPayload);
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/checkpoint/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/checkpoint/gateway.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,iBAAiB;IACpB,QAAQ,CAAqB;IAC7B,SAAS,CAAsB;IAEvC,YAAY,QAA4B,EAAE,SAA8B;QACtE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,mBAAmB,CAAC,OAAgB;QAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,wBAAwB,CAAC,OAAgB;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAgB,EAAE,cAAyC;QACtE,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,gBAAgB,EAAE,CAAC;gBACrB,OAAO,IAAI,QAAQ,CACjB,IAAI,CAAC,SAAS,CAAC;oBACb,KAAK,EAAE,IAAI;oBACX,OAAO,EAAE,iCAAiC,gBAAgB,kBAAkB;oBAC5E,UAAU,EAAE,GAAG;iBAChB,CAAC,EACF,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CACjE,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/checkpoint/ipc.d.ts

@@ -0,0 +1,12 @@
+export type CheckpointIpcMessage = {
+    type: 'ready';
+} | {
+    type: 'error';
+    message: string;
+} | {
+    type: 'health';
+    status: 'ok' | 'degraded';
+};
+export declare function parseIpcLine(line: string): CheckpointIpcMessage | null;
+export declare function waitForReady(stdout: ReadableStream<Uint8Array>, timeoutMs?: number): Promise<void>;
+//# sourceMappingURL=ipc.d.ts.map

package/dist/checkpoint/ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.d.ts","sourceRoot":"","sources":["../../src/checkpoint/ipc.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,IAAI,GAAG,UAAU,CAAA;CAAE,CAAC;AAIlD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAUtE;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,SAAS,GAAE,MAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAuFhH"}