@objectstack/objectql 3.2.9 → 3.3.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @objectstack/objectql@3.2.9 build /home/runner/work/spec/spec/packages/objectql
+> @objectstack/objectql@3.3.1 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     96.39 KB
-ESM dist/index.mjs.map 196.70 KB
-ESM ⚡️ Build success in 178ms
-CJS dist/index.js     98.13 KB
-CJS dist/index.js.map 198.00 KB
-CJS ⚡️ Build success in 189ms
+ESM dist/index.mjs     98.69 KB
+ESM dist/index.mjs.map 201.00 KB
+ESM ⚡️ Build success in 247ms
+CJS dist/index.js     100.43 KB
+CJS dist/index.js.map 202.30 KB
+CJS ⚡️ Build success in 256ms
 DTS Build start
-DTS ⚡️ Build success in 24730ms
-DTS dist/index.d.mts 78.30 KB
-DTS dist/index.d.ts  78.30 KB
+DTS ⚡️ Build success in 25891ms
+DTS dist/index.d.mts 78.82 KB
+DTS dist/index.d.ts  78.82 KB

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @objectstack/objectql
 
+## 3.3.1
+
+### Patch Changes
+
+- @objectstack/spec@3.3.1
+- @objectstack/core@3.3.1
+- @objectstack/types@3.3.1
+
+## 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

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;
     /**
@@ -1891,9 +1897,13 @@ declare class ObjectQLPlugin implements Plugin {
     /**
      * 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
+     * Groups objects by their responsible driver, then:
+     * - If the driver advertises `supports.batchSchemaSync` and implements
+     *   `syncSchemasBatch()`, submits all schemas in a single call (reducing
+     *   network round-trips for remote drivers like Turso).
+     * - Otherwise falls back to sequential `syncSchema()` per object.
+     *
+     * This is idempotent — drivers must tolerate repeated calls without
      * duplicating tables or erroring out.
      *
      * Drivers that do not implement `syncSchema` are silently skipped.

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;
     /**
@@ -1891,9 +1897,13 @@ declare class ObjectQLPlugin implements Plugin {
     /**
      * 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
+     * Groups objects by their responsible driver, then:
+     * - If the driver advertises `supports.batchSchemaSync` and implements
+     *   `syncSchemasBatch()`, submits all schemas in a single call (reducing
+     *   network round-trips for remote drivers like Turso).
+     * - Otherwise falls back to sequential `syncSchema()` per object.
+     *
+     * This is idempotent — drivers must tolerate repeated calls without
      * duplicating tables or erroring out.
      *
      * Drivers that do not implement `syncSchema` are silently skipped.

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;
   }
@@ -2758,9 +2770,13 @@ var ObjectQLPlugin = class {
   /**
    * 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
+   * Groups objects by their responsible driver, then:
+   * - If the driver advertises `supports.batchSchemaSync` and implements
+   *   `syncSchemasBatch()`, submits all schemas in a single call (reducing
+   *   network round-trips for remote drivers like Turso).
+   * - Otherwise falls back to sequential `syncSchema()` per object.
+   *
+   * This is idempotent — drivers must tolerate repeated calls without
    * duplicating tables or erroring out.
    *
    * Drivers that do not implement `syncSchema` are silently skipped.
@@ -2771,6 +2787,7 @@ var ObjectQLPlugin = class {
     if (allObjects.length === 0) return;
     let synced = 0;
     let skipped = 0;
+    const driverGroups = /* @__PURE__ */ new Map();
     for (const obj of allObjects) {
       const driver = this.ql.getDriverForObject(obj.name);
       if (!driver) {
@@ -2788,15 +2805,60 @@ var ObjectQLPlugin = class {
         skipped++;
         continue;
       }
-      try {
-        await driver.syncSchema(obj.name, obj);
-        synced++;
-      } catch (e) {
-        ctx.logger.warn("Failed to sync schema for object", {
-          object: obj.name,
-          driver: driver.name,
-          error: e instanceof Error ? e.message : String(e)
-        });
+      const tableName = obj.tableName || obj.name;
+      let group = driverGroups.get(driver);
+      if (!group) {
+        group = [];
+        driverGroups.set(driver, group);
+      }
+      group.push({ obj, tableName });
+    }
+    for (const [driver, entries] of driverGroups) {
+      if (driver.supports?.batchSchemaSync && typeof driver.syncSchemasBatch === "function") {
+        const batchPayload = entries.map((e) => ({
+          object: e.tableName,
+          schema: e.obj
+        }));
+        try {
+          await driver.syncSchemasBatch(batchPayload);
+          synced += entries.length;
+          ctx.logger.debug("Batch schema sync succeeded", {
+            driver: driver.name,
+            count: entries.length
+          });
+        } catch (e) {
+          ctx.logger.warn("Batch schema sync failed, falling back to sequential", {
+            driver: driver.name,
+            error: e instanceof Error ? e.message : String(e)
+          });
+          for (const { obj, tableName } of entries) {
+            try {
+              await driver.syncSchema(tableName, obj);
+              synced++;
+            } catch (seqErr) {
+              ctx.logger.warn("Failed to sync schema for object", {
+                object: obj.name,
+                tableName,
+                driver: driver.name,
+                error: seqErr instanceof Error ? seqErr.message : String(seqErr)
+              });
+            }
+          }
+        }
+      } else {
+        for (const { obj, tableName } of entries) {
+          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) {