dzql 0.5.33 → 0.6.0

package/src/database/migrations/010_atomic_updates.sql

@@ -1,157 +0,0 @@
--- Migration 010: Atomic Updates for Subscribables
--- Adds extract_scope_tables function and updates register_subscribable to auto-populate scope_tables
-
--- ============================================================================
--- Helper function to extract scope tables from relations
--- ============================================================================
-
-CREATE OR REPLACE FUNCTION dzql.extract_scope_tables(
-  p_root_entity TEXT,
-  p_relations JSONB
-) RETURNS TEXT[] AS $$
-DECLARE
-  v_tables TEXT[];
-  v_key TEXT;
-  v_value JSONB;
-  v_entity TEXT;
-  v_nested JSONB;
-BEGIN
-  -- Start with root entity (may be NULL for dashboard mode)
-  IF p_root_entity IS NOT NULL AND p_root_entity != '' THEN
-    v_tables := ARRAY[p_root_entity];
-  ELSE
-    v_tables := ARRAY[]::TEXT[];
-  END IF;
-
-  -- Return early if no relations
-  IF p_relations IS NULL OR p_relations = '{}'::jsonb THEN
-    RETURN v_tables;
-  END IF;
-
-  -- Iterate through relations
-  FOR v_key, v_value IN SELECT * FROM jsonb_each(p_relations)
-  LOOP
-    -- Handle string relation (simple FK expansion): "org": "organisations"
-    IF jsonb_typeof(v_value) = 'string' THEN
-      v_entity := v_value #>> '{}';
-      IF v_entity IS NOT NULL AND v_entity != '' THEN
-        v_tables := array_append(v_tables, v_entity);
-      END IF;
-    -- Handle object relation: {"entity": "sites", "filter": "..."}
-    ELSIF jsonb_typeof(v_value) = 'object' THEN
-      v_entity := v_value ->> 'entity';
-      IF v_entity IS NOT NULL AND v_entity != '' THEN
-        v_tables := array_append(v_tables, v_entity);
-      END IF;
-
-      -- Recursively handle nested relations (include or relations)
-      v_nested := v_value -> 'include';
-      IF v_nested IS NOT NULL AND jsonb_typeof(v_nested) = 'object' THEN
-        v_tables := v_tables || dzql.extract_scope_tables(NULL, v_nested);
-      END IF;
-
-      v_nested := v_value -> 'relations';
-      IF v_nested IS NOT NULL AND jsonb_typeof(v_nested) = 'object' THEN
-        v_tables := v_tables || dzql.extract_scope_tables(NULL, v_nested);
-      END IF;
-    END IF;
-  END LOOP;
-
-  -- Remove duplicates and nulls
-  SELECT array_agg(DISTINCT t) INTO v_tables
-  FROM unnest(v_tables) t
-  WHERE t IS NOT NULL;
-
-  RETURN COALESCE(v_tables, ARRAY[]::TEXT[]);
-END;
-$$ LANGUAGE plpgsql IMMUTABLE;
-
-COMMENT ON FUNCTION dzql.extract_scope_tables IS
-  'Extract all table names from a subscribable definition (root entity + all relations recursively)';
-
--- ============================================================================
--- Update register_subscribable to auto-populate scope_tables
--- ============================================================================
-
-CREATE OR REPLACE FUNCTION dzql.register_subscribable(
-  p_name TEXT,
-  p_permission_paths JSONB,
-  p_param_schema JSONB,
-  p_root_entity TEXT,
-  p_relations JSONB
-) RETURNS TEXT AS $$
-DECLARE
-  v_result TEXT;
-  v_scope_tables TEXT[];
-BEGIN
-  -- Validate inputs
-  IF p_name IS NULL OR p_name = '' THEN
-    RAISE EXCEPTION 'Subscribable name cannot be empty';
-  END IF;
-
-  -- NULL root_entity is allowed for dashboard mode (pure collections)
-  -- But if relations is also empty, that's an error
-  IF (p_root_entity IS NULL OR p_root_entity = '') AND
-     (p_relations IS NULL OR p_relations = '{}'::jsonb) THEN
-    RAISE EXCEPTION 'Subscribable must have either a root entity or relations';
-  END IF;
-
-  -- Extract scope tables from root entity and relations
-  v_scope_tables := dzql.extract_scope_tables(p_root_entity, p_relations);
-
-  -- Insert or update subscribable
-  INSERT INTO dzql.subscribables (
-    name,
-    permission_paths,
-    param_schema,
-    root_entity,
-    relations,
-    scope_tables,
-    created_at,
-    updated_at
-  ) VALUES (
-    p_name,
-    COALESCE(p_permission_paths, '{}'::jsonb),
-    COALESCE(p_param_schema, '{}'::jsonb),
-    NULLIF(p_root_entity, ''),  -- Store empty string as NULL
-    COALESCE(p_relations, '{}'::jsonb),
-    v_scope_tables,
-    NOW(),
-    NOW()
-  )
-  ON CONFLICT (name) DO UPDATE SET
-    permission_paths = EXCLUDED.permission_paths,
-    param_schema = EXCLUDED.param_schema,
-    root_entity = EXCLUDED.root_entity,
-    relations = EXCLUDED.relations,
-    scope_tables = EXCLUDED.scope_tables,
-    updated_at = NOW();
-
-  v_result := format('Subscribable "%s" registered successfully with scope tables: %s',
-                     p_name, array_to_string(v_scope_tables, ', '));
-
-  RAISE NOTICE '%', v_result;
-
-  RETURN v_result;
-END;
-$$ LANGUAGE plpgsql;
-
--- ============================================================================
--- Backfill existing subscribables with scope_tables
--- ============================================================================
-
-UPDATE dzql.subscribables s
-SET scope_tables = dzql.extract_scope_tables(s.root_entity, s.relations)
-WHERE scope_tables = '{}' OR scope_tables IS NULL;
-
--- ============================================================================
--- Verification
--- ============================================================================
-
-DO $$
-BEGIN
-  RAISE NOTICE 'Migration 010: Atomic Updates - Complete';
-  RAISE NOTICE 'Created dzql.extract_scope_tables() function';
-  RAISE NOTICE 'Updated dzql.register_subscribable() to auto-populate scope_tables';
-  RAISE NOTICE 'Backfilled existing subscribables';
-END $$;

package/src/database/migrations/010_fix_m2m_events.sql

@@ -1,94 +0,0 @@
--- ============================================================================
--- Migration 010: Fix M2M in Event "before" Field
--- ============================================================================
---
--- Issue: UPDATE events don't include M2M data in the "before" field
--- Root cause: l_existing_record in generic_save doesn't expand M2M relationships
--- Fix: Create a helper function to expand M2M, then update generic_save to use it
---
--- This ensures UPDATE events have complete before/after state including M2M data
--- ============================================================================
-
-DO $$ BEGIN
-  RAISE NOTICE 'Migration 010: Fixing M2M in event before field...';
-END $$;
-
--- Create helper function to expand M2M relationships for a record
-CREATE OR REPLACE FUNCTION dzql.expand_m2m_for_record(
-  p_entity text,
-  p_record jsonb,
-  p_entity_config record,
-  p_pk_cols text[]
-) RETURNS jsonb
-LANGUAGE plpgsql
-AS $$
-DECLARE
-  l_result jsonb := p_record;
-  l_m2m_key text;
-  l_m2m_config jsonb;
-  l_id_field text;
-  l_junction_table text;
-  l_local_key text;
-  l_foreign_key text;
-  l_target_entity text;
-  l_expand boolean;
-  l_record_id text;
-  l_id_array jsonb;
-  l_expanded_objects jsonb;
-BEGIN
-  -- Only expand if entity has M2M configuration
-  IF p_entity_config.many_to_many IS NULL OR p_entity_config.many_to_many = '{}'::jsonb THEN
-    RETURN l_result;
-  END IF;
-
-  -- Get the primary key value from the record
-  l_record_id := l_result->>p_pk_cols[1];  -- Assume single PK for now
-
-  IF l_record_id IS NULL THEN
-    RETURN l_result;
-  END IF;
-
-  -- Loop through all M2M relationships
-  FOR l_m2m_key IN SELECT jsonb_object_keys(p_entity_config.many_to_many)
-  LOOP
-    l_m2m_config := p_entity_config.many_to_many->l_m2m_key;
-    l_id_field := l_m2m_config->>'id_field';
-    l_junction_table := l_m2m_config->>'junction_table';
-    l_local_key := l_m2m_config->>'local_key';
-    l_foreign_key := l_m2m_config->>'foreign_key';
-    l_target_entity := l_m2m_config->>'target_entity';
-    l_expand := COALESCE((l_m2m_config->>'expand')::boolean, false);
-
-    -- Always include array of IDs
-    EXECUTE format('
-      SELECT COALESCE(jsonb_agg(%I ORDER BY %I), ''[]''::jsonb)
-      FROM %I
-      WHERE %I = $1::int
-    ', l_foreign_key, l_foreign_key, l_junction_table, l_local_key)
-    INTO l_id_array
-    USING l_record_id;
-
-    l_result := l_result || jsonb_build_object(l_id_field, l_id_array);
-
-    -- Conditionally include expanded objects if expand: true
-    IF l_expand THEN
-      EXECUTE format('
-        SELECT COALESCE(jsonb_agg(to_jsonb(t.*) ORDER BY t.id), ''[]''::jsonb)
-        FROM %I jt
-        JOIN %I t ON t.id = jt.%I
-        WHERE jt.%I = $1::int
-      ', l_junction_table, l_target_entity, l_foreign_key, l_local_key)
-      INTO l_expanded_objects
-      USING l_record_id;
-
-      l_result := l_result || jsonb_build_object(l_m2m_key, l_expanded_objects);
-    END IF;
-  END LOOP;
-
-  RETURN l_result;
-END $$;
-
-DO $$ BEGIN
-  RAISE NOTICE 'Migration 010: M2M expansion helper function created';
-  RAISE NOTICE 'Note: generic_save still needs updating to use this helper - will be done in next migration';
-END $$;

package/src/index.js

@@ -1,40 +0,0 @@
-#!/usr/bin/env bun
-/**
- * DZQL Demo Server
- *
- * Minimal example server that serves demo.html and provides WebSocket functionality.
- * Run with: bun packages/dzql/src/index.js
- */
-
-import { createServer } from './server/index.js';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Path to demo.html
-const demoPath = join(__dirname, 'client/demo.html');
-
-// Create DZQL server with demo route
-const app = createServer({
-  port: 3000,
-  routes: {
-    '/': async () => {
-      const file = Bun.file(demoPath);
-      return new Response(file, {
-        headers: { 'Content-Type': 'text/html' }
-      });
-    },
-    '/demo': async () => {
-      const file = Bun.file(demoPath);
-      return new Response(file, {
-        headers: { 'Content-Type': 'text/html' }
-      });
-    }
-  }
-});
-
-console.log('🚀 DZQL Demo Server running');
-console.log('📝 Visit http://localhost:3000 to see the demo');
-console.log('🔌 WebSocket available at ws://localhost:3000/ws');

package/src/server/api.js

@@ -1,9 +0,0 @@
-export async function goodbye(userId, params = {}) {
-  const { name = "World" } = params;
-
-  return {
-    message: `Goodbye, ${name}!`,
-    from: "Bun",
-    user_id: userId,
-  };
-}