@objectstack/objectql 3.2.8 → 3.3.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @objectstack/objectql@3.2.8 build /home/runner/work/spec/spec/packages/objectql
+> @objectstack/objectql@3.3.0 build /home/runner/work/spec/spec/packages/objectql
 > tsup --config ../../tsup.config.ts
 
 CLI Building entry: src/index.ts
@@ -10,13 +10,13 @@
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.mjs     94.28 KB
-ESM dist/index.mjs.map 193.23 KB
-ESM ⚡️ Build success in 210ms
-CJS dist/index.js     96.02 KB
-CJS dist/index.js.map 194.53 KB
-CJS ⚡️ Build success in 213ms
+CJS dist/index.js     98.69 KB
+CJS dist/index.js.map 199.38 KB
+CJS ⚡️ Build success in 147ms
+ESM dist/index.mjs     96.95 KB
+ESM dist/index.mjs.map 198.08 KB
+ESM ⚡️ Build success in 148ms
 DTS Build start
-DTS ⚡️ Build success in 24357ms
-DTS dist/index.d.mts 77.36 KB
-DTS dist/index.d.ts  77.36 KB
+DTS ⚡️ Build success in 25675ms
+DTS dist/index.d.mts 78.59 KB
+DTS dist/index.d.ts  78.59 KB

package/CHANGELOG.md

@@ -1,9 +1,29 @@
 # @objectstack/objectql
 
+## 3.3.0
+
+### Patch Changes
+
+- @objectstack/spec@3.3.0
+- @objectstack/core@3.3.0
+- @objectstack/types@3.3.0
+
+## 3.2.9
+
+### Patch Changes
+
+- c3065dd: fix turso 2
+  - @objectstack/spec@3.2.9
+  - @objectstack/core@3.2.9
+  - @objectstack/types@3.2.9
+
 ## 3.2.8
 
 ### Patch Changes
 
+- Auto-sync all registered object schemas to database on startup: `ObjectQLPlugin.start()` now iterates every object in `SchemaRegistry` and calls `driver.syncSchema()` after driver connections are established. This ensures tables for plugin-registered objects (e.g. `sys_user` from plugin-auth) are created or updated automatically.
+- Added `getDriverForObject(objectName)` public method to `ObjectQL` engine for resolving the responsible driver for a given object.
+- Added optional `syncSchema` method to `DriverInterface` contract, aligning it with the full `IDataDriver` protocol.
 - @objectstack/spec@3.2.8
 - @objectstack/core@3.2.8
 - @objectstack/types@3.2.8

package/dist/index.d.mts

@@ -167,8 +167,14 @@ declare class SchemaRegistry {
      */
     static resolveObject(fqn: string): ServiceObject | undefined;
     /**
-     * Get object by name (FQN or short name with fallback scan).
-     * For compatibility, tries exact match first, then scans for suffix match.
+     * Get object by name (FQN, short name, or physical table name).
+     *
+     * Resolution order:
+     * 1. Exact FQN match (e.g., 'crm__account')
+     * 2. Short name fallback (e.g., 'account' → 'crm__account')
+     * 3. Physical table name match (e.g., 'sys_user' → 'sys__user')
+     *    ObjectSchema.create() auto-derives tableName as {namespace}_{name},
+     *    which uses a single underscore — different from the FQN double underscore.
      */
     static getObject(name: string): ServiceObject | undefined;
     /**
@@ -1683,6 +1689,17 @@ declare class ObjectQL implements IDataEngine {
      * this method directly looks up a driver by its registered name.
      */
     getDriverByName(name: string): DriverInterface | undefined;
+    /**
+     * Get the driver responsible for the given object.
+     *
+     * Resolves datasource binding from the object's schema definition,
+     * falling back to the default driver. This is a public version of
+     * the internal getDriver() used by CRUD operations.
+     *
+     * @param objectName - FQN or short name of the registered object.
+     * @returns The resolved DriverInterface, or undefined if no driver is available.
+     */
+    getDriverForObject(objectName: string): DriverInterface | undefined;
     /**
      * Get a registered driver by datasource name.
      * Alias matching @objectql/core datasource() API.
@@ -1877,6 +1894,17 @@ declare class ObjectQLPlugin implements Plugin {
      * for multi-tenant operations.
      */
     private registerTenantMiddleware;
+    /**
+     * Synchronize all registered object schemas to the database.
+     *
+     * Iterates every object in the SchemaRegistry and calls the
+     * responsible driver's `syncSchema()` for each one.  This is
+     * idempotent — drivers must tolerate repeated calls without
+     * duplicating tables or erroring out.
+     *
+     * Drivers that do not implement `syncSchema` are silently skipped.
+     */
+    private syncRegisteredSchemas;
     /**
      * Load metadata from external metadata service into ObjectQL registry
      * This enables ObjectQL to use file-based or remote metadata

package/dist/index.d.ts

@@ -167,8 +167,14 @@ declare class SchemaRegistry {
      */
     static resolveObject(fqn: string): ServiceObject | undefined;
     /**
-     * Get object by name (FQN or short name with fallback scan).
-     * For compatibility, tries exact match first, then scans for suffix match.
+     * Get object by name (FQN, short name, or physical table name).
+     *
+     * Resolution order:
+     * 1. Exact FQN match (e.g., 'crm__account')
+     * 2. Short name fallback (e.g., 'account' → 'crm__account')
+     * 3. Physical table name match (e.g., 'sys_user' → 'sys__user')
+     *    ObjectSchema.create() auto-derives tableName as {namespace}_{name},
+     *    which uses a single underscore — different from the FQN double underscore.
      */
     static getObject(name: string): ServiceObject | undefined;
     /**
@@ -1683,6 +1689,17 @@ declare class ObjectQL implements IDataEngine {
      * this method directly looks up a driver by its registered name.
      */
     getDriverByName(name: string): DriverInterface | undefined;
+    /**
+     * Get the driver responsible for the given object.
+     *
+     * Resolves datasource binding from the object's schema definition,
+     * falling back to the default driver. This is a public version of
+     * the internal getDriver() used by CRUD operations.
+     *
+     * @param objectName - FQN or short name of the registered object.
+     * @returns The resolved DriverInterface, or undefined if no driver is available.
+     */
+    getDriverForObject(objectName: string): DriverInterface | undefined;
     /**
      * Get a registered driver by datasource name.
      * Alias matching @objectql/core datasource() API.
@@ -1877,6 +1894,17 @@ declare class ObjectQLPlugin implements Plugin {
      * for multi-tenant operations.
      */
     private registerTenantMiddleware;
+    /**
+     * Synchronize all registered object schemas to the database.
+     *
+     * Iterates every object in the SchemaRegistry and calls the
+     * responsible driver's `syncSchema()` for each one.  This is
+     * idempotent — drivers must tolerate repeated calls without
+     * duplicating tables or erroring out.
+     *
+     * Drivers that do not implement `syncSchema` are silently skipped.
+     */
+    private syncRegisteredSchemas;
     /**
      * Load metadata from external metadata service into ObjectQL registry
      * This enables ObjectQL to use file-based or remote metadata

package/dist/index.js

@@ -207,8 +207,14 @@ var SchemaRegistry = class {
     return merged;
   }
   /**
-   * Get object by name (FQN or short name with fallback scan).
-   * For compatibility, tries exact match first, then scans for suffix match.
+   * Get object by name (FQN, short name, or physical table name).
+   *
+   * Resolution order:
+   * 1. Exact FQN match (e.g., 'crm__account')
+   * 2. Short name fallback (e.g., 'account' → 'crm__account')
+   * 3. Physical table name match (e.g., 'sys_user' → 'sys__user')
+   *    ObjectSchema.create() auto-derives tableName as {namespace}_{name},
+   *    which uses a single underscore — different from the FQN double underscore.
    */
   static getObject(name) {
     const direct = this.resolveObject(name);
@@ -219,6 +225,12 @@ var SchemaRegistry = class {
         return this.resolveObject(fqn);
       }
     }
+    for (const fqn of this.objectContributors.keys()) {
+      const resolved = this.resolveObject(fqn);
+      if (resolved?.tableName === name) {
+        return resolved;
+      }
+    }
     return void 0;
   }
   /**
@@ -1760,7 +1772,7 @@ var _ObjectQL = class _ObjectQL {
   resolveObjectName(name) {
     const schema = SchemaRegistry.getObject(name);
     if (schema) {
-      return schema.name;
+      return schema.tableName || schema.name;
     }
     return name;
   }
@@ -2246,6 +2258,23 @@ var _ObjectQL = class _ObjectQL {
   getDriverByName(name) {
     return this.drivers.get(name);
   }
+  /**
+   * Get the driver responsible for the given object.
+   *
+   * Resolves datasource binding from the object's schema definition,
+   * falling back to the default driver. This is a public version of
+   * the internal getDriver() used by CRUD operations.
+   *
+   * @param objectName - FQN or short name of the registered object.
+   * @returns The resolved DriverInterface, or undefined if no driver is available.
+   */
+  getDriverForObject(objectName) {
+    try {
+      return this.getDriver(objectName);
+    } catch {
+      return void 0;
+    }
+  }
   /**
    * Get a registered driver by datasource name.
    * Alias matching @objectql/core datasource() API.
@@ -2643,6 +2672,7 @@ var ObjectQLPlugin = class {
         }
       }
       await this.ql?.init();
+      await this.syncRegisteredSchemas(ctx);
       this.registerAuditHooks(ctx);
       this.registerTenantMiddleware(ctx);
       ctx.logger.info("ObjectQL engine started", {
@@ -2737,6 +2767,56 @@ var ObjectQLPlugin = class {
     });
     ctx.logger.debug("Tenant isolation middleware registered");
   }
+  /**
+   * Synchronize all registered object schemas to the database.
+   *
+   * Iterates every object in the SchemaRegistry and calls the
+   * responsible driver's `syncSchema()` for each one.  This is
+   * idempotent — drivers must tolerate repeated calls without
+   * duplicating tables or erroring out.
+   *
+   * Drivers that do not implement `syncSchema` are silently skipped.
+   */
+  async syncRegisteredSchemas(ctx) {
+    if (!this.ql) return;
+    const allObjects = this.ql.registry?.getAllObjects?.() ?? [];
+    if (allObjects.length === 0) return;
+    let synced = 0;
+    let skipped = 0;
+    for (const obj of allObjects) {
+      const driver = this.ql.getDriverForObject(obj.name);
+      if (!driver) {
+        ctx.logger.debug("No driver available for object, skipping schema sync", {
+          object: obj.name
+        });
+        skipped++;
+        continue;
+      }
+      if (typeof driver.syncSchema !== "function") {
+        ctx.logger.debug("Driver does not support syncSchema, skipping", {
+          object: obj.name,
+          driver: driver.name
+        });
+        skipped++;
+        continue;
+      }
+      const tableName = obj.tableName || obj.name;
+      try {
+        await driver.syncSchema(tableName, obj);
+        synced++;
+      } catch (e) {
+        ctx.logger.warn("Failed to sync schema for object", {
+          object: obj.name,
+          tableName,
+          driver: driver.name,
+          error: e instanceof Error ? e.message : String(e)
+        });
+      }
+    }
+    if (synced > 0 || skipped > 0) {
+      ctx.logger.info("Schema sync complete", { synced, skipped, total: allObjects.length });
+    }
+  }
   /**
    * Load metadata from external metadata service into ObjectQL registry
    * This enables ObjectQL to use file-based or remote metadata