dzql 0.3.6 → 0.4.0

package/bin/cli.js

@@ -186,8 +186,7 @@ CREATE TABLE IF NOT EXISTS dzql.events (
   table_name text NOT NULL,
   op text NOT NULL,
   pk jsonb NOT NULL,
-  before jsonb,
-  after jsonb,
+  data jsonb,
   user_id int,
   notify_users int[],
   at timestamptz DEFAULT now()
@@ -206,9 +205,7 @@ BEGIN
     'table', NEW.table_name,
     'op', NEW.op,
     'pk', NEW.pk,
-    'data', COALESCE(NEW.after, NEW.before),
-    'before', NEW.before,
-    'after', NEW.after,
+    'data', NEW.data,
     'user_id', NEW.user_id,
     'at', NEW.at,
     'notify_users', NEW.notify_users

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dzql",
-  "version": "0.3.6",
+  "version": "0.4.0",
   "description": "PostgreSQL-powered framework with zero boilerplate CRUD operations and real-time WebSocket synchronization",
   "type": "module",
   "main": "src/server/index.js",
@@ -11,7 +11,8 @@
     "./client/templates": "./src/client/templates/App.vue",
     "./server": "./src/server/index.js",
     "./db": "./src/server/db.js",
-    "./compiler": "./src/compiler/index.js"
+    "./compiler": "./src/compiler/index.js",
+    "./namespace": "./src/server/namespace.js"
   },
   "files": [
     "bin/**/*.js",

package/src/server/namespace.js

@@ -0,0 +1,228 @@
+import { sql, db } from "./db.js";
+
+// Default user for CLI operations
+const DEFAULT_USER_ID = 1;
+
+/**
+ * Discover available entities from dzql.entities table
+ */
+async function discoverEntities() {
+  const result = await sql`
+    SELECT table_name, label_field, searchable_fields
+    FROM dzql.entities
+    ORDER BY table_name
+  `;
+
+  const entities = {};
+  for (const row of result) {
+    const searchFields = row.searchable_fields?.join(", ") || "none";
+    entities[row.table_name] = {
+      label: row.label_field,
+      searchable: row.searchable_fields || [],
+      description: `Entity: ${row.table_name} (label: ${row.label_field}, searchable: ${searchFields})`,
+    };
+  }
+
+  return entities;
+}
+
+/**
+ * DZQL operations namespace - provides CLI-style access to DZQL operations
+ *
+ * Usage in tasks.js:
+ * ```js
+ * import { DzqlNamespace } from 'dzql/namespace';
+ *
+ * export class Tasks {
+ *   constructor() {
+ *     this.dzql = new DzqlNamespace();
+ *   }
+ * }
+ * ```
+ */
+export class DzqlNamespace {
+  constructor(userId = DEFAULT_USER_ID) {
+    this.userId = userId;
+  }
+
+  /** List all available entities */
+  async entities(c) {
+    try {
+      const entities = await discoverEntities();
+      console.log(JSON.stringify({ success: true, entities }, null, 2));
+      await sql.end();
+    } catch (error) {
+      console.error(
+        JSON.stringify({ success: false, error: error.message }, null, 2),
+      );
+      await sql.end();
+      process.exit(1);
+    }
+  }
+
+  /** Search an entity */
+  async search(c, entity, argsJson = "{}") {
+    if (!entity) {
+      console.error("Error: entity name required");
+      console.error("Usage: invokej dzql.search <entity> '<json_args>'");
+      console.error(
+        'Example: invokej dzql.search organisations \'{"query": "test"}\'',
+      );
+      await sql.end();
+      process.exit(1);
+    }
+
+    let args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      console.error("Error: arguments must be valid JSON");
+      await sql.end();
+      process.exit(1);
+    }
+
+    try {
+      const result = await db.api.search[entity](args, this.userId);
+      console.log(JSON.stringify({ success: true, result }, null, 2));
+      await sql.end();
+    } catch (error) {
+      console.error(
+        JSON.stringify({ success: false, error: error.message }, null, 2),
+      );
+      await sql.end();
+      process.exit(1);
+    }
+  }
+
+  /** Get entity by ID */
+  async get(c, entity, argsJson = "{}") {
+    if (!entity) {
+      console.error("Error: entity name required");
+      console.error("Usage: invokej dzql.get <entity> '<json_args>'");
+      console.error("Example: invokej dzql.get venues '{\"id\": 1}'");
+      await sql.end();
+      process.exit(1);
+    }
+
+    let args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      console.error("Error: arguments must be valid JSON");
+      await sql.end();
+      process.exit(1);
+    }
+
+    try {
+      const result = await db.api.get[entity](args, this.userId);
+      console.log(JSON.stringify({ success: true, result }, null, 2));
+      await sql.end();
+    } catch (error) {
+      console.error(
+        JSON.stringify({ success: false, error: error.message }, null, 2),
+      );
+      await sql.end();
+      process.exit(1);
+    }
+  }
+
+  /** Save (create or update) entity */
+  async save(c, entity, argsJson = "{}") {
+    if (!entity) {
+      console.error("Error: entity name required");
+      console.error("Usage: invokej dzql.save <entity> '<json_args>'");
+      console.error(
+        'Example: invokej dzql.save venues \'{"name": "Test Venue", "org_id": 1}\'',
+      );
+      await sql.end();
+      process.exit(1);
+    }
+
+    let args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      console.error("Error: arguments must be valid JSON");
+      await sql.end();
+      process.exit(1);
+    }
+
+    try {
+      const result = await db.api.save[entity](args, this.userId);
+      console.log(JSON.stringify({ success: true, result }, null, 2));
+      await sql.end();
+    } catch (error) {
+      console.error(
+        JSON.stringify({ success: false, error: error.message }, null, 2),
+      );
+      await sql.end();
+      process.exit(1);
+    }
+  }
+
+  /** Delete entity by ID */
+  async delete(c, entity, argsJson = "{}") {
+    if (!entity) {
+      console.error("Error: entity name required");
+      console.error("Usage: invokej dzql.delete <entity> '<json_args>'");
+      console.error("Example: invokej dzql.delete venues '{\"id\": 1}'");
+      await sql.end();
+      process.exit(1);
+    }
+
+    let args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      console.error("Error: arguments must be valid JSON");
+      await sql.end();
+      process.exit(1);
+    }
+
+    try {
+      const result = await db.api.delete[entity](args, this.userId);
+      console.log(JSON.stringify({ success: true, result }, null, 2));
+      await sql.end();
+    } catch (error) {
+      console.error(
+        JSON.stringify({ success: false, error: error.message }, null, 2),
+      );
+      await sql.end();
+      process.exit(1);
+    }
+  }
+
+  /** Lookup entity (for dropdowns/autocomplete) */
+  async lookup(c, entity, argsJson = "{}") {
+    if (!entity) {
+      console.error("Error: entity name required");
+      console.error("Usage: invokej dzql.lookup <entity> '<json_args>'");
+      console.error(
+        'Example: invokej dzql.lookup organisations \'{"query": "acme"}\'',
+      );
+      await sql.end();
+      process.exit(1);
+    }
+
+    let args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      console.error("Error: arguments must be valid JSON");
+      await sql.end();
+      process.exit(1);
+    }
+
+    try {
+      const result = await db.api.lookup[entity](args, this.userId);
+      console.log(JSON.stringify({ success: true, result }, null, 2));
+      await sql.end();
+    } catch (error) {
+      console.error(
+        JSON.stringify({ success: false, error: error.message }, null, 2),
+      );
+      await sql.end();
+      process.exit(1);
+    }
+  }
+}