dzql 0.5.27 → 0.5.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dzql",
-  "version": "0.5.27",
+  "version": "0.5.28",
   "description": "PostgreSQL-powered framework with zero boilerplate CRUD operations and real-time WebSocket synchronization",
   "type": "module",
   "main": "src/server/index.js",

package/src/compiler/codegen/subscribable-codegen.js

@@ -247,7 +247,39 @@ $$ LANGUAGE plpgsql STABLE SECURITY DEFINER;`;
       scopeTables: scopeTables
     });
 
-    // Dashboard mode: empty paramSchema means aggregate root as array
+    // Pure collection mode: no rootEntity, only relations
+    if (!this.rootEntity) {
+      // Build relation-only selects (strip leading comma)
+      const collectionSelects = this._generateCollectionOnlySelects();
+
+      return `CREATE OR REPLACE FUNCTION get_${this.name}(
+  p_params JSONB,
+  p_user_id INT
+) RETURNS JSONB AS $$
+DECLARE
+  v_data JSONB;
+BEGIN
+  -- Check access control
+  IF NOT ${this.name}_can_subscribe(p_user_id, p_params) THEN
+    RAISE EXCEPTION 'Permission denied';
+  END IF;
+
+  -- Build document with collections only (no root entity)
+  SELECT jsonb_build_object(
+    ${collectionSelects}
+  )
+  INTO v_data;
+
+  -- Return data with embedded schema for atomic updates
+  RETURN jsonb_build_object(
+    'data', v_data,
+    'schema', '${schemaJson}'::jsonb
+  );
+END;
+$$ LANGUAGE plpgsql SECURITY DEFINER;`;
+    }
+
+    // Dashboard mode: empty paramSchema with rootEntity means aggregate root as array
     if (params.length === 0) {
       return `CREATE OR REPLACE FUNCTION get_${this.name}(
   p_params JSONB,
@@ -388,6 +420,33 @@ $$ LANGUAGE plpgsql SECURITY DEFINER;`;
     return selects;
   }
 
+  /**
+   * Generate collection-only selects (no root entity)
+   * Used when rootEntity is null/empty - pure collection mode
+   * @private
+   */
+  _generateCollectionOnlySelects() {
+    if (Object.keys(this.relations).length === 0) {
+      return "'_empty', '{}'::jsonb";
+    }
+
+    const selects = Object.entries(this.relations).map(([relName, relConfig]) => {
+      const relEntity = typeof relConfig === 'string' ? relConfig : relConfig.entity;
+      const relFilter = typeof relConfig === 'object' ? relConfig.filter : null;
+
+      // For collection mode, filter should be TRUE or we fetch all
+      const filterSQL = relFilter === 'TRUE' ? 'TRUE' : 'TRUE';
+
+      return `'${relName}', COALESCE((
+      SELECT jsonb_agg(row_to_json(rel.*))
+      FROM ${relEntity} rel
+      WHERE ${filterSQL}
+    ), '[]'::jsonb)`;
+    });
+
+    return selects.join(',\n    ');
+  }
+
   /**
    * Generate JOIN clause for via relations
    * Handles multi-hop via chains by looking up each intermediate table
@@ -512,9 +571,11 @@ $$ LANGUAGE plpgsql SECURITY DEFINER;`;
     const cases = [];
     const seenEntities = new Set();
 
-    // Case 1: Root entity changed
-    cases.push(this._generateRootAffectedCase());
-    seenEntities.add(this.rootEntity);
+    // Case 1: Root entity changed (only if rootEntity exists)
+    if (this.rootEntity) {
+      cases.push(this._generateRootAffectedCase());
+      seenEntities.add(this.rootEntity);
+    }
 
     // Case 2: Related entities changed (skip duplicates)
     for (const [relName, relConfig] of Object.entries(this.relations)) {
@@ -664,7 +725,10 @@ $$ LANGUAGE plpgsql IMMUTABLE;`;
    * @returns {string[]} Array of table names
    */
   extractScopeTables() {
-    const tables = new Set([this.rootEntity]);
+    const tables = new Set();
+    if (this.rootEntity) {
+      tables.add(this.rootEntity);
+    }
 
     const extractFromRelations = (relations) => {
       for (const [relName, relConfig] of Object.entries(relations || {})) {
@@ -701,8 +765,10 @@ $$ LANGUAGE plpgsql IMMUTABLE;`;
   buildPathMapping() {
     const paths = {};
 
-    // Root entity maps to top level
-    paths[this.rootEntity] = '.';
+    // Root entity maps to top level (only if it exists)
+    if (this.rootEntity) {
+      paths[this.rootEntity] = '.';
+    }
 
     const buildPaths = (relations, parentPath = '') => {
       for (const [relName, relConfig] of Object.entries(relations || {})) {