@objectstack/core 4.0.3 → 4.0.5

package/src/contracts/data-engine.ts

@@ -1,57 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { 
-  EngineQueryOptions,
-  DataEngineInsertOptions, 
-  EngineUpdateOptions, 
-  EngineDeleteOptions,
-  EngineAggregateOptions, 
-  EngineCountOptions,
-  DataEngineRequest,
-} from '@objectstack/spec/data';
-
-/**
- * IDataEngine - Standard Data Engine Interface
- * 
- * Abstract interface for data persistence capabilities.
- * Following the Dependency Inversion Principle - plugins depend on this interface,
- * not on concrete database implementations.
- * 
- * All query methods use standard QueryAST parameter names
- * (where/fields/orderBy/limit/offset/expand) to eliminate mechanical translation
- * between the Engine and Driver layers.
- * 
- * Aligned with 'src/data/data-engine.zod.ts' in @objectstack/spec.
- */
-
-export interface IDataEngine {
-  find(objectName: string, query?: EngineQueryOptions): Promise<any[]>;
-  findOne(objectName: string, query?: EngineQueryOptions): Promise<any>;
-  insert(objectName: string, data: any | any[], options?: DataEngineInsertOptions): Promise<any>;
-  update(objectName: string, data: any, options?: EngineUpdateOptions): Promise<any>;
-  delete(objectName: string, options?: EngineDeleteOptions): Promise<any>;
-  count(objectName: string, query?: EngineCountOptions): Promise<number>;
-  aggregate(objectName: string, query: EngineAggregateOptions): Promise<any[]>;
-  
-  /**
-   * Vector Search (AI/RAG)
-   */
-  vectorFind?(objectName: string, vector: number[], options?: { where?: any, limit?: number, fields?: string[], threshold?: number }): Promise<any[]>;
-
-  /**
-   * Batch Operations (Transactional)
-   */
-  batch?(requests: DataEngineRequest[], options?: { transaction?: boolean }): Promise<any[]>;
-
-  /**
-   * Execute raw command (Escape hatch)
-   */
-  execute?(command: any, options?: Record<string, any>): Promise<any>;
-}
-
-/**
- * @deprecated Use `IDataDriver` from `@objectstack/spec/contracts` instead.
- * This type is re-exported from `@objectstack/spec/contracts` for backward compatibility only.
- */
-export type { DriverInterface } from '@objectstack/spec/contracts';
-

package/src/contracts/http-server.ts

@@ -1,151 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-/**
- * IHttpServer - Standard HTTP Server Interface
- * 
- * Abstract interface for HTTP server capabilities.
- * This allows plugins to interact with HTTP servers without knowing
- * the underlying implementation (Express, Fastify, Hono, etc.).
- * 
- * Follows Dependency Inversion Principle - plugins depend on this interface,
- * not on concrete HTTP framework implementations.
- */
-
-// We use Zod for validation but export interfaces for internal implementation
-
-/**
- * Generic HTTP Request type
- * Abstraction over framework-specific request objects
- */
-export interface IHttpRequest {
-    /** Request path parameters */
-    params: Record<string, string>;
-    /** Request query parameters */
-    query: Record<string, string | string[]>;
-    /** Request body */
-    body?: any;
-    /** Request headers */
-    headers: Record<string, string | string[]>;
-    /** HTTP method */
-    method: string;
-    /** Request path */
-    path: string;
-}
-
-/**
- * Generic HTTP Response type
- * Abstraction over framework-specific response objects
- */
-export interface IHttpResponse {
-    /**
-     * Send a JSON response
-     * @param data - Data to send
-     */
-    json(data: any): void | Promise<void>;
-    
-    /**
-     * Send a text/html response
-     * @param data - Data to send
-     */
-    send(data: string): void | Promise<void>;
-    
-    /**
-     * Set HTTP status code
-     * @param code - HTTP status code
-     */
-    status(code: number): IHttpResponse;
-    
-    /**
-     * Set response header
-     * @param name - Header name
-     * @param value - Header value (string or array of strings for multi-value headers)
-     */
-    header(name: string, value: string | string[]): IHttpResponse;
-}
-
-/**
- * Route handler function
- */
-export type RouteHandler = (
-    req: IHttpRequest,
-    res: IHttpResponse
-) => void | Promise<void>;
-
-/**
- * Middleware function
- */
-export type Middleware = (
-    req: IHttpRequest,
-    res: IHttpResponse,
-    next: () => void | Promise<void>
-) => void | Promise<void>;
-
-/**
- * IHttpServer - HTTP Server capability interface
- * 
- * Defines the contract for HTTP server implementations.
- * Concrete implementations (Express, Fastify, Hono) should implement this interface.
- */
-export interface IHttpServer {
-    /**
-     * Register a GET route handler
-     * @param path - Route path (e.g., '/api/users/:id')
-     * @param handler - Route handler function
-     */
-    get(path: string, handler: RouteHandler): void;
-    
-    /**
-     * Register a POST route handler
-     * @param path - Route path
-     * @param handler - Route handler function
-     */
-    post(path: string, handler: RouteHandler): void;
-    
-    /**
-     * Register a PUT route handler
-     * @param path - Route path
-     * @param handler - Route handler function
-     */
-    put(path: string, handler: RouteHandler): void;
-    
-    /**
-     * Register a DELETE route handler
-     * @param path - Route path
-     * @param handler - Route handler function
-     */
-    delete(path: string, handler: RouteHandler): void;
-    
-    /**
-     * Register a PATCH route handler
-     * @param path - Route path
-     * @param handler - Route handler function
-     */
-    patch(path: string, handler: RouteHandler): void;
-    
-    /**
-     * Register middleware
-     * @param path - Optional path to apply middleware to (if omitted, applies globally)
-     * @param handler - Middleware function
-     */
-    use(path: string | Middleware, handler?: Middleware): void;
-    
-    /**
-     * Start the HTTP server
-     * @param port - Port number to listen on
-     * @returns Promise that resolves when server is ready
-     */
-    listen(port: number): Promise<void>;
-
-    /**
-     * Get the port the server is listening on.
-     * Returns the actual bound port after `listen()` resolves, or the
-     * configured port before that.
-     */
-    getPort?(): number;
-    
-    /**
-     * Stop the HTTP server
-     * @returns Promise that resolves when server is stopped
-     */
-    close?(): Promise<void>;
-}

package/src/contracts/logger.ts

@@ -1,72 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-/**
- * Logger Contract
- * 
- * Defines the interface for logging in ObjectStack.
- * Compatible with both browser console and structured logging systems.
- */
-export interface Logger {
-    /**
-     * Log a debug message
-     * @param message - The message to log
-     * @param meta - Optional metadata to include
-     */
-    debug(message: string, meta?: Record<string, any>): void;
-
-    /**
-     * Log an informational message
-     * @param message - The message to log
-     * @param meta - Optional metadata to include
-     */
-    info(message: string, meta?: Record<string, any>): void;
-
-    /**
-     * Log a warning message
-     * @param message - The message to log
-     * @param meta - Optional metadata to include
-     */
-    warn(message: string, meta?: Record<string, any>): void;
-
-    /**
-     * Log an error message
-     * @param message - The message to log
-     * @param error - Optional error object
-     * @param meta - Optional metadata to include
-     */
-    error(message: string, error?: Error, meta?: Record<string, any>): void;
-
-    /**
-     * Log a fatal error message
-     * @param message - The message to log
-     * @param error - Optional error object
-     * @param meta - Optional metadata to include
-     */
-    fatal?(message: string, error?: Error, meta?: Record<string, any>): void;
-
-    /**
-     * Create a child logger with additional context
-     * @param context - Context to add to all logs from this child
-     */
-    child?(context: Record<string, any>): Logger;
-
-    /**
-     * Set trace context for distributed tracing
-     * @param traceId - Trace identifier
-     * @param spanId - Span identifier
-     */
-    withTrace?(traceId: string, spanId?: string): Logger;
-
-    /**
-     * Compatibility method for console.log usage
-     * @param message - The message to log
-     * @param args - Additional arguments
-     */
-    log?(message: string, ...args: any[]): void;
-
-    /**
-     * Cleanup resources (close file streams, etc.)
-     * Should be called when the logger is no longer needed
-     */
-    destroy?(): Promise<void>;
-}

package/src/dependency-resolver.test.ts

@@ -1,287 +0,0 @@
-import { describe, it, expect, beforeEach } from 'vitest';
-import { SemanticVersionManager, DependencyResolver } from './dependency-resolver.js';
-import { createLogger } from './logger.js';
-
-describe('SemanticVersionManager', () => {
-  describe('parse', () => {
-    it('should parse standard semver', () => {
-      const version = SemanticVersionManager.parse('1.2.3');
-      expect(version).toEqual({
-        major: 1,
-        minor: 2,
-        patch: 3,
-        preRelease: undefined,
-        build: undefined,
-      });
-    });
-
-    it('should parse semver with pre-release', () => {
-      const version = SemanticVersionManager.parse('1.2.3-alpha.1');
-      expect(version).toEqual({
-        major: 1,
-        minor: 2,
-        patch: 3,
-        preRelease: 'alpha.1',
-        build: undefined,
-      });
-    });
-
-    it('should parse semver with build metadata', () => {
-      const version = SemanticVersionManager.parse('1.2.3+build.123');
-      expect(version).toEqual({
-        major: 1,
-        minor: 2,
-        patch: 3,
-        preRelease: undefined,
-        build: 'build.123',
-      });
-    });
-
-    it('should parse semver with both pre-release and build', () => {
-      const version = SemanticVersionManager.parse('1.2.3-beta.2+build.456');
-      expect(version).toEqual({
-        major: 1,
-        minor: 2,
-        patch: 3,
-        preRelease: 'beta.2',
-        build: 'build.456',
-      });
-    });
-
-    it('should handle v prefix', () => {
-      const version = SemanticVersionManager.parse('v1.2.3');
-      expect(version.major).toBe(1);
-      expect(version.minor).toBe(2);
-      expect(version.patch).toBe(3);
-    });
-  });
-
-  describe('compare', () => {
-    it('should compare major versions', () => {
-      const v1 = SemanticVersionManager.parse('2.0.0');
-      const v2 = SemanticVersionManager.parse('1.0.0');
-      expect(SemanticVersionManager.compare(v1, v2)).toBeGreaterThan(0);
-      expect(SemanticVersionManager.compare(v2, v1)).toBeLessThan(0);
-    });
-
-    it('should compare minor versions', () => {
-      const v1 = SemanticVersionManager.parse('1.2.0');
-      const v2 = SemanticVersionManager.parse('1.1.0');
-      expect(SemanticVersionManager.compare(v1, v2)).toBeGreaterThan(0);
-    });
-
-    it('should compare patch versions', () => {
-      const v1 = SemanticVersionManager.parse('1.0.2');
-      const v2 = SemanticVersionManager.parse('1.0.1');
-      expect(SemanticVersionManager.compare(v1, v2)).toBeGreaterThan(0);
-    });
-
-    it('should handle equal versions', () => {
-      const v1 = SemanticVersionManager.parse('1.2.3');
-      const v2 = SemanticVersionManager.parse('1.2.3');
-      expect(SemanticVersionManager.compare(v1, v2)).toBe(0);
-    });
-
-    it('should treat pre-release as lower than release', () => {
-      const v1 = SemanticVersionManager.parse('1.0.0-alpha');
-      const v2 = SemanticVersionManager.parse('1.0.0');
-      expect(SemanticVersionManager.compare(v1, v2)).toBeLessThan(0);
-    });
-  });
-
-  describe('satisfies', () => {
-    it('should match exact version', () => {
-      const version = SemanticVersionManager.parse('1.2.3');
-      expect(SemanticVersionManager.satisfies(version, '1.2.3')).toBe(true);
-      expect(SemanticVersionManager.satisfies(version, '1.2.4')).toBe(false);
-    });
-
-    it('should match caret range', () => {
-      const version = SemanticVersionManager.parse('1.2.5');
-      expect(SemanticVersionManager.satisfies(version, '^1.2.3')).toBe(true);
-      expect(SemanticVersionManager.satisfies(version, '^1.3.0')).toBe(false);
-      expect(SemanticVersionManager.satisfies(version, '^2.0.0')).toBe(false);
-    });
-
-    it('should match tilde range', () => {
-      const version = SemanticVersionManager.parse('1.2.5');
-      expect(SemanticVersionManager.satisfies(version, '~1.2.3')).toBe(true);
-      expect(SemanticVersionManager.satisfies(version, '~1.3.0')).toBe(false);
-    });
-
-    it('should match greater than or equal', () => {
-      const version = SemanticVersionManager.parse('1.2.5');
-      expect(SemanticVersionManager.satisfies(version, '>=1.2.3')).toBe(true);
-      expect(SemanticVersionManager.satisfies(version, '>=1.2.5')).toBe(true);
-      expect(SemanticVersionManager.satisfies(version, '>=1.3.0')).toBe(false);
-    });
-
-    it('should match less than', () => {
-      const version = SemanticVersionManager.parse('1.2.5');
-      expect(SemanticVersionManager.satisfies(version, '<1.3.0')).toBe(true);
-      expect(SemanticVersionManager.satisfies(version, '<1.2.5')).toBe(false);
-    });
-
-    it('should match range', () => {
-      const version = SemanticVersionManager.parse('1.2.5');
-      expect(SemanticVersionManager.satisfies(version, '1.2.0 - 1.3.0')).toBe(true);
-      expect(SemanticVersionManager.satisfies(version, '1.3.0 - 1.4.0')).toBe(false);
-    });
-
-    it('should match wildcard', () => {
-      const version = SemanticVersionManager.parse('1.2.5');
-      expect(SemanticVersionManager.satisfies(version, '*')).toBe(true);
-      expect(SemanticVersionManager.satisfies(version, 'latest')).toBe(true);
-    });
-  });
-
-  describe('getCompatibilityLevel', () => {
-    it('should detect fully compatible versions', () => {
-      const from = SemanticVersionManager.parse('1.2.3');
-      const to = SemanticVersionManager.parse('1.2.3');
-      expect(SemanticVersionManager.getCompatibilityLevel(from, to)).toBe('fully-compatible');
-    });
-
-    it('should detect backward compatible versions', () => {
-      const from = SemanticVersionManager.parse('1.2.3');
-      const to = SemanticVersionManager.parse('1.3.0');
-      expect(SemanticVersionManager.getCompatibilityLevel(from, to)).toBe('backward-compatible');
-    });
-
-    it('should detect breaking changes', () => {
-      const from = SemanticVersionManager.parse('1.2.3');
-      const to = SemanticVersionManager.parse('2.0.0');
-      expect(SemanticVersionManager.getCompatibilityLevel(from, to)).toBe('breaking-changes');
-    });
-
-    it('should detect incompatible (downgrade)', () => {
-      const from = SemanticVersionManager.parse('1.3.0');
-      const to = SemanticVersionManager.parse('1.2.0');
-      expect(SemanticVersionManager.getCompatibilityLevel(from, to)).toBe('incompatible');
-    });
-  });
-});
-
-describe('DependencyResolver', () => {
-  let resolver: DependencyResolver;
-  let logger: ReturnType<typeof createLogger>;
-
-  beforeEach(() => {
-    logger = createLogger({ level: 'silent' });
-    resolver = new DependencyResolver(logger);
-  });
-
-  describe('resolve', () => {
-    it('should resolve dependencies in topological order', () => {
-      const plugins = new Map([
-        ['a', { dependencies: [] }],
-        ['b', { dependencies: ['a'] }],
-        ['c', { dependencies: ['a', 'b'] }],
-      ]);
-
-      const order = resolver.resolve(plugins);
-      
-      expect(order.indexOf('a')).toBeLessThan(order.indexOf('b'));
-      expect(order.indexOf('b')).toBeLessThan(order.indexOf('c'));
-    });
-
-    it('should handle plugins with no dependencies', () => {
-      const plugins = new Map([
-        ['a', { dependencies: [] }],
-        ['b', { dependencies: [] }],
-      ]);
-
-      const order = resolver.resolve(plugins);
-      expect(order).toHaveLength(2);
-      expect(order).toContain('a');
-      expect(order).toContain('b');
-    });
-
-    it('should detect circular dependencies', () => {
-      const plugins = new Map([
-        ['a', { dependencies: ['b'] }],
-        ['b', { dependencies: ['a'] }],
-      ]);
-
-      expect(() => resolver.resolve(plugins)).toThrow('Circular dependency');
-    });
-
-    it('should detect missing dependencies', () => {
-      const plugins = new Map([
-        ['a', { dependencies: ['missing'] }],
-      ]);
-
-      expect(() => resolver.resolve(plugins)).toThrow('Missing dependency');
-    });
-  });
-
-  describe('detectConflicts', () => {
-    it('should detect version mismatches', () => {
-      const plugins = new Map<string, any>([
-        ['core', { version: '1.0.0', dependencies: {} }],
-        ['plugin-a', { version: '1.0.0', dependencies: { core: '^2.0.0' } }],
-      ]);
-
-      const conflicts = resolver.detectConflicts(plugins);
-      expect(conflicts.length).toBeGreaterThan(0);
-      expect(conflicts[0].type).toBe('version-mismatch');
-    });
-
-    it('should return no conflicts for compatible versions', () => {
-      const plugins = new Map<string, any>([
-        ['core', { version: '1.2.0', dependencies: {} }],
-        ['plugin-a', { version: '1.0.0', dependencies: { core: '^1.0.0' } }],
-      ]);
-
-      const conflicts = resolver.detectConflicts(plugins);
-      expect(conflicts.length).toBe(0);
-    });
-  });
-
-  describe('findBestVersion', () => {
-    it('should find highest matching version', () => {
-      const available = ['1.0.0', '1.1.0', '1.2.0', '2.0.0'];
-      const constraints = ['^1.0.0'];
-      
-      const best = resolver.findBestVersion(available, constraints);
-      expect(best).toBe('1.2.0');
-    });
-
-    it('should satisfy all constraints', () => {
-      const available = ['1.0.0', '1.1.0', '1.2.0', '2.0.0'];
-      const constraints = ['^1.0.0', '>=1.1.0', '<2.0.0'];
-      
-      const best = resolver.findBestVersion(available, constraints);
-      expect(best).toBe('1.2.0');
-    });
-
-    it('should return undefined if no version satisfies', () => {
-      const available = ['1.0.0', '1.1.0'];
-      const constraints = ['^2.0.0'];
-      
-      const best = resolver.findBestVersion(available, constraints);
-      expect(best).toBeUndefined();
-    });
-  });
-
-  describe('isAcyclic', () => {
-    it('should detect acyclic graph', () => {
-      const deps = new Map([
-        ['a', []],
-        ['b', ['a']],
-        ['c', ['a', 'b']],
-      ]);
-
-      expect(resolver.isAcyclic(deps)).toBe(true);
-    });
-
-    it('should detect cyclic graph', () => {
-      const deps = new Map([
-        ['a', ['b']],
-        ['b', ['a']],
-      ]);
-
-      expect(resolver.isAcyclic(deps)).toBe(false);
-    });
-  });
-});