dzql 0.5.25 → 0.5.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dzql",
-  "version": "0.5.25",
+  "version": "0.5.27",
   "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,6 +247,38 @@ $$ LANGUAGE plpgsql STABLE SECURITY DEFINER;`;
       scopeTables: scopeTables
     });
 
+    // Dashboard mode: empty paramSchema means aggregate root as array
+    if (params.length === 0) {
+      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 root as array (dashboard mode)
+  SELECT jsonb_build_object(
+    '${this.rootEntity}', COALESCE((
+      SELECT jsonb_agg(row_to_json(root.*))
+      FROM ${this.rootEntity} root
+    ), '[]'::jsonb)${relationSelects}
+  )
+  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;`;
+    }
+
     return `CREATE OR REPLACE FUNCTION get_${this.name}(
   p_params JSONB,
   p_user_id INT
@@ -462,6 +494,11 @@ $$ LANGUAGE plpgsql SECURITY DEFINER;`;
       return `rel.${fk} = root.id`;
     }
 
+    // Dashboard collection: filter="TRUE" means fetch ALL rows (no FK filter)
+    if (filter === 'TRUE') {
+      return 'TRUE';
+    }
+
     // Parse filter expression like "venue_id=$venue_id"
     // Replace $param with v_param variable
     return filter.replace(/\$(\w+)/g, 'v_$1');
@@ -473,13 +510,19 @@ $$ LANGUAGE plpgsql SECURITY DEFINER;`;
    */
   _generateAffectedDocumentsFunction() {
     const cases = [];
+    const seenEntities = new Set();
 
     // Case 1: Root entity changed
     cases.push(this._generateRootAffectedCase());
+    seenEntities.add(this.rootEntity);
 
-    // Case 2: Related entities changed
+    // Case 2: Related entities changed (skip duplicates)
     for (const [relName, relConfig] of Object.entries(this.relations)) {
-      cases.push(this._generateRelationAffectedCase(relName, relConfig));
+      const relEntity = typeof relConfig === 'string' ? relConfig : relConfig.entity;
+      if (!seenEntities.has(relEntity)) {
+        cases.push(this._generateRelationAffectedCase(relName, relConfig));
+        seenEntities.add(relEntity);
+      }
     }
 
     const casesSQL = cases.join('\n\n    ');
@@ -510,7 +553,15 @@ $$ LANGUAGE plpgsql IMMUTABLE;`;
    */
   _generateRootAffectedCase() {
     const params = Object.keys(this.paramSchema);
-    const firstParam = params[0] || 'id';
+
+    // Dashboard mode: empty paramSchema means notify ALL subscribers
+    if (params.length === 0) {
+      return `-- Root entity (${this.rootEntity}) changed - dashboard mode, notify all
+    WHEN '${this.rootEntity}' THEN
+      v_affected := ARRAY['{}'::jsonb];`;
+    }
+
+    const firstParam = params[0];
 
     return `-- Root entity (${this.rootEntity}) changed
     WHEN '${this.rootEntity}' THEN
@@ -529,10 +580,19 @@ $$ LANGUAGE plpgsql IMMUTABLE;`;
       ? relConfig.foreignKey
       : `${this.rootEntity}_id`;
     const relVia = typeof relConfig === 'object' ? relConfig.via : null;
+    const relFilter = typeof relConfig === 'object' ? relConfig.filter : null;
 
     const params = Object.keys(this.paramSchema);
     const firstParam = params[0] || 'id';
 
+    // Dashboard collection: filter="TRUE" means notify ALL subscribers
+    // This relation is independent from the root entity
+    if (relFilter === 'TRUE') {
+      return `-- Dashboard collection (${relEntity}) - notify all subscribers
+    WHEN '${relEntity}' THEN
+      v_affected := ARRAY['{}'::jsonb];`;
+    }
+
     // Check if this is a nested relation (has parent FK)
     const nestedIncludes = typeof relConfig === 'object' ? relConfig.include : null;