@objectql/driver-excel 4.0.1 → 4.0.3

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @objectql/driver-excel@4.0.3 build /home/runner/work/objectql/objectql/packages/drivers/excel
+> tsc
+

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @objectql/driver-excel
 
+## 4.0.3
+
+### Patch Changes
+
+- **Patch Release v4.0.3**
+
+  This patch release includes infrastructure improvements and development experience enhancements:
+  - Refactored dev server setup for improved configuration handling
+  - Enhanced example scripts and development workflow
+  - Updated build and test infrastructure
+  - Improved documentation and developer tools
+  - Bug fixes and stability improvements
+
+- Updated dependencies
+  - @objectql/driver-memory@4.0.3
+  - @objectql/types@4.0.3
+
+## 4.0.2
+
+### Patch Changes
+
+- **Patch Release v4.0.2**
+
+  This patch release includes:
+  - Infrastructure improvements and maintenance updates
+  - Enhanced stability and reliability
+  - Bug fixes and performance optimizations
+
+- Updated dependencies
+  - @objectql/types@4.0.2
+
 ## 4.0.1
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,60 +1,5 @@
-import { Data } from '@objectstack/spec';
-type QueryAST = Data.QueryAST;
-/**
- * ObjectQL
- * Copyright (c) 2026-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-/**
- * Excel Driver for ObjectQL (Production-Ready)
- *
- * A driver for ObjectQL that reads and writes data from Excel (.xlsx) files.
- * Each worksheet in the Excel file represents an object type, with the first row
- * containing column headers (field names) and subsequent rows containing data.
- *
- * ✅ Features:
- * - Read data from Excel files
- * - Write data back to Excel files
- * - Multiple sheets support (one sheet per object type)
- * - Full CRUD operations
- * - Query support (filters, sorting, pagination)
- * - Automatic data type handling
- * - Secure: Uses ExcelJS (no known vulnerabilities)
- *
- * Use Cases:
- * - Import/export data from Excel spreadsheets
- * - Use Excel as a simple database for prototyping
- * - Data migration from Excel to other databases
- * - Generate reports in Excel format
- */
-import { Driver } from '@objectql/types';
-/**
- * Command interface for executeCommand method
- */
-export interface Command {
-    type: 'create' | 'update' | 'delete' | 'bulkCreate' | 'bulkUpdate' | 'bulkDelete';
-    object: string;
-    data?: any;
-    id?: string | number;
-    ids?: Array<string | number>;
-    records?: any[];
-    updates?: Array<{
-        id: string | number;
-        data: any;
-    }>;
-    options?: any;
-}
-/**
- * Command result interface
- */
-export interface CommandResult {
-    success: boolean;
-    data?: any;
-    affected: number;
-    error?: string;
-}
+import { MemoryDriver, MemoryDriverConfig, Command, CommandResult } from '@objectql/driver-memory';
+export type { Command, CommandResult };
 /**
  * File storage mode for the Excel driver.
  */
@@ -62,7 +7,7 @@ export type FileStorageMode = 'single-file' | 'file-per-object';
 /**
  * Configuration options for the Excel driver.
  */
-export interface ExcelDriverConfig {
+export interface ExcelDriverConfig extends MemoryDriverConfig {
     /**
      * Path to the Excel file or directory.
      * - In 'single-file' mode: Path to a single .xlsx file
@@ -79,14 +24,17 @@ export interface ExcelDriverConfig {
     autoSave?: boolean;
     /** Optional: Create file if it doesn't exist (default: true) */
     createIfMissing?: boolean;
-    /** Optional: Enable strict mode (throw on missing objects) */
-    strictMode?: boolean;
 }
 /**
  * Excel Driver Implementation
  *
- * Stores ObjectQL documents in Excel worksheets. Each object type is stored
- * in a separate worksheet, with the first row containing column headers.
+ * Extends MemoryDriver with Excel file persistence.
+ * All query and aggregation logic is inherited from MemoryDriver.
+ * Only the persistence layer (load/save) is overridden.
+ *
+ * Stores ObjectQL documents in Excel worksheets with format:
+ * - Single-file mode: All objects as worksheets in one .xlsx file
+ * - File-per-object mode: Each object in a separate .xlsx file
  *
  * Uses ExcelJS library for secure Excel file operations.
  *
@@ -94,29 +42,14 @@ export interface ExcelDriverConfig {
  * the standard DriverInterface from @objectstack/spec for compatibility
  * with the new kernel-based plugin system.
  */
-export declare class ExcelDriver implements Driver {
-    readonly name = "ExcelDriver";
-    readonly version = "4.0.0";
-    readonly supports: {
-        transactions: boolean;
-        joins: boolean;
-        fullTextSearch: boolean;
-        jsonFields: boolean;
-        arrayFields: boolean;
-        queryFilters: boolean;
-        queryAggregations: boolean;
-        querySorting: boolean;
-        queryPagination: boolean;
-        queryWindowFunctions: boolean;
-        querySubqueries: boolean;
-    };
-    private config;
-    private workbook;
-    private workbooks;
-    private data;
-    private idCounters;
+export declare class ExcelDriver extends MemoryDriver {
     private filePath;
     private fileStorageMode;
+    private autoSave;
+    private createIfMissing;
+    private workbook;
+    private workbooks;
+    private fileLocks;
     constructor(config: ExcelDriverConfig);
     /**
      * Initialize the driver by loading the workbook from file.
@@ -125,56 +58,42 @@ export declare class ExcelDriver implements Driver {
     init(): Promise<void>;
     /**
      * Connect to the database (for DriverInterface compatibility)
-     * This calls init() to load the workbook.
      */
     connect(): Promise<void>;
-    /**
-     * Check database connection health
-     */
-    checkHealth(): Promise<boolean>;
     /**
      * Factory method to create and initialize the driver.
      */
     static create(config: ExcelDriverConfig): Promise<ExcelDriver>;
+    /**
+     * Check database connection health
+     */
+    checkHealth(): Promise<boolean>;
     /**
      * Load workbook from file or create a new one.
-     * Handles both single-file and file-per-object modes.
      */
     private loadWorkbook;
     /**
-     * Load workbook in single-file mode (all objects in one Excel file).
+     * Load workbook in single-file mode.
      */
     private loadSingleFileWorkbook;
     /**
-     * Load workbooks in file-per-object mode (each object in separate Excel file).
+     * Load workbooks in file-per-object mode.
      */
     private loadFilePerObjectWorkbooks;
     /**
-     * Load data from workbook into memory.
-     *
-     * Expected Excel format:
-     * - First row contains column headers (field names)
-     * - Subsequent rows contain data records
-     * - Each worksheet represents one object type
+     * Load all data from single-file workbook into memory.
      */
     private loadDataFromWorkbook;
     /**
-     * Load data from a single worksheet into memory.
-     */
-    private loadDataFromSingleWorksheet;
-    /**
-     * Update ID counter based on existing records.
-     *
-     * Attempts to extract counter from auto-generated IDs (format: objectName-timestamp-counter).
-     * If IDs don't follow this format, counter starts from existing record count.
+     * Load data from workbook for a specific object.
      */
-    private updateIdCounter;
+    private loadDataFromWorkbookForObject;
     /**
-     * Save workbook to file.
+     * Parse worksheet into array of records.
      */
+    private parseWorksheet;
     /**
      * Save workbook to file.
-     * Handles both single-file and file-per-object modes.
      */
     private saveWorkbook;
     /**
@@ -186,9 +105,7 @@ export declare class ExcelDriver implements Driver {
      */
     private saveFilePerObjectWorkbook;
     /**
-     * Sync in-memory data to workbook.
-     *
-     * Creates or updates a worksheet for the given object type.
+     * Sync in-memory data to workbook and save.
      */
     private syncToWorkbook;
     /**
@@ -200,128 +117,35 @@ export declare class ExcelDriver implements Driver {
      */
     private syncToFilePerObjectWorkbook;
     /**
-     * Find multiple records matching the query criteria.
-     */
-    find(objectName: string, query?: any, options?: any): Promise<any[]>;
-    /**
-     * Find a single record by ID or query.
-     */
-    findOne(objectName: string, id: string | number, query?: any, options?: any): Promise<any>;
-    /**
-     * Create a new record.
+     * Get all records for an object from memory store.
      */
-    create(objectName: string, data: any, options?: any): Promise<any>;
+    private getObjectRecords;
     /**
-     * Update an existing record.
+     * Populate worksheet with records.
      */
-    update(objectName: string, id: string | number, data: any, options?: any): Promise<any>;
-    /**
-     * Delete a record.
-     */
-    delete(objectName: string, id: string | number, options?: any): Promise<any>;
+    private populateWorksheet;
     /**
-     * Count records matching filters.
+     * Simple file locking mechanism.
      */
-    count(objectName: string, filters: any, options?: any): Promise<number>;
+    private acquireLock;
     /**
-     * Get distinct values for a field.
+     * Release file lock.
      */
-    distinct(objectName: string, field: string, filters?: any, options?: any): Promise<any[]>;
+    private releaseLock;
     /**
-     * Create multiple records at once.
+     * Override create to persist to Excel.
      */
-    createMany(objectName: string, data: any[], options?: any): Promise<any>;
-    /**
-     * Update multiple records matching filters.
-     */
-    updateMany(objectName: string, filters: any, data: any, options?: any): Promise<any>;
+    create(objectName: string, data: any, options?: any): Promise<any>;
     /**
-     * Delete multiple records matching filters.
+     * Override update to persist to Excel.
      */
-    deleteMany(objectName: string, filters: any, options?: any): Promise<any>;
+    update(objectName: string, id: string | number, data: any, options?: any): Promise<any>;
     /**
-     * Manually save the workbook to file.
+     * Override delete to persist to Excel.
      */
+    delete(objectName: string, id: string | number, options?: any): Promise<any>;
     /**
-     * Manually save the workbook to file.
+     * Manually save all data to Excel file(s).
      */
     save(): Promise<void>;
-    /**
-     * Disconnect (flush any pending writes).
-     */
-    disconnect(): Promise<void>;
-    /**
-     * Execute a query using QueryAST (DriverInterface v4.0 method)
-     *
-     * This method handles all query operations using the standard QueryAST format
-     * from @objectstack/spec. It converts the AST to the legacy query format
-     * and delegates to the existing find() method.
-     *
-     * @param ast - The query AST to execute
-     * @param options - Optional execution options
-     * @returns Query results with value array and count
-     */
-    executeQuery(ast: QueryAST, options?: any): Promise<{
-        value: any[];
-        count?: number;
-    }>;
-    /**
-     * Execute a command (DriverInterface v4.0 method)
-     *
-     * This method handles all mutation operations (create, update, delete)
-     * using a unified command interface.
-     *
-     * @param command - The command to execute
-     * @param options - Optional execution options
-     * @returns Command execution result
-     */
-    executeCommand(command: Command, options?: any): Promise<CommandResult>;
-    /**
-     * Execute raw command (for compatibility)
-     *
-     * @param command - Command string or object
-     * @param parameters - Command parameters
-     * @param options - Execution options
-     */
-    execute(command: any, parameters?: any[], options?: any): Promise<any>;
-    /**
-     * Convert FilterNode from QueryAST to legacy filter format.
-     *
-     * @param node - The FilterNode to convert
-     * @returns Legacy filter array format
-     */
-    private convertFilterNodeToLegacy;
-    /**
-     * Normalizes query format to support both legacy UnifiedQuery and QueryAST formats.
-     * This ensures backward compatibility while supporting the new @objectstack/spec interface.
-     *
-     * QueryAST format uses 'top' for limit, while UnifiedQuery uses 'limit'.
-     * QueryAST sort is array of {field, order}, while UnifiedQuery is array of [field, order].
-     */
-    private normalizeQuery;
-    /**
-     * Apply filters to an array of records (in-memory filtering).
-     */
-    private applyFilters;
-    /**
-     * Check if a single record matches the filter conditions.
-     */
-    private matchesFilters;
-    /**
-     * Evaluate a single filter condition.
-     */
-    private evaluateCondition;
-    /**
-     * Apply sorting to an array of records.
-     */
-    private applySort;
-    /**
-     * Project specific fields from a document.
-     */
-    private projectFields;
-    /**
-     * Generate a unique ID for a record.
-     */
-    private generateId;
 }
-export {};