dzql 0.6.1 → 0.6.2

package/src/runtime/namespace.ts

@@ -1,16 +1,16 @@
 /**
- * TZQL Namespace for invokej integration
+ * DZQL Namespace for invokej integration
  *
- * Provides CLI-style access to TZQL operations via the compiled manifest.
+ * Provides CLI-style access to DZQL operations via the compiled manifest.
  * Each method outputs JSON to console and closes the connection before returning.
  *
  * Setup - add to your tasks.js:
  * ```js
- * import { TzqlNamespace } from 'tzql/namespace';
+ * import { DzqlNamespace } from 'dzql/namespace';
  *
  * export class Tasks {
  *   constructor() {
- *     this.tzql = new TzqlNamespace();
+ *     this.dzql = new DzqlNamespace();
  *   }
  * }
  * ```
@@ -18,32 +18,32 @@
  * Available Commands:
  *
  * Discovery:
- *   invj tzql:entities                              # List all entities
- *   invj tzql:subscribables                         # List all subscribables
- *   invj tzql:functions                             # List all manifest functions
+ *   invj dzql:entities                              # List all entities
+ *   invj dzql:subscribables                         # List all subscribables
+ *   invj dzql:functions                             # List all manifest functions
  *
  * Entity CRUD:
- *   invj tzql:search venues '{"query": "test"}'     # Search with filters
- *   invj tzql:get venues '{"id": 1}'                # Get by primary key
- *   invj tzql:save venues '{"name": "New", "org_id": 1}'  # Create (no id)
- *   invj tzql:save venues '{"id": 1, "name": "Updated"}'  # Update (with id)
- *   invj tzql:delete venues '{"id": 1}'             # Delete by primary key
- *   invj tzql:lookup venues '{"query": "test"}'     # Lookup for dropdowns
+ *   invj dzql:search venues '{"query": "test"}'     # Search with filters
+ *   invj dzql:get venues '{"id": 1}'                # Get by primary key
+ *   invj dzql:save venues '{"name": "New", "org_id": 1}'  # Create (no id)
+ *   invj dzql:save venues '{"id": 1, "name": "Updated"}'  # Update (with id)
+ *   invj dzql:delete venues '{"id": 1}'             # Delete by primary key
+ *   invj dzql:lookup venues '{"query": "test"}'     # Lookup for dropdowns
  *
  * Subscribables:
- *   invj tzql:subscribe venue_detail '{"venue_id": 1}'  # Get snapshot
+ *   invj dzql:subscribe venue_detail '{"venue_id": 1}'  # Get snapshot
  *
  * Ad-hoc Function Calls:
- *   invj tzql:call login_user '{"email": "x", "password": "y"}'
- *   invj tzql:call register_user '{"email": "x", "password": "y"}'
- *   invj tzql:call get_venue_detail '{"venue_id": 1}'
- *   invj tzql:call save_venues '{"name": "Test", "org_id": 1}'
+ *   invj dzql:call login_user '{"email": "x", "password": "y"}'
+ *   invj dzql:call register_user '{"email": "x", "password": "y"}'
+ *   invj dzql:call get_venue_detail '{"venue_id": 1}'
+ *   invj dzql:call save_venues '{"name": "Test", "org_id": 1}'
  *
  * Environment:
  *   DATABASE_URL - PostgreSQL connection string (default: postgres://localhost:5432/dzql)
  *
  * Requirements:
- *   - Run 'tzql compile' first to generate dist/runtime/manifest.json
+ *   - Run 'dzql compile' first to generate dist/runtime/manifest.json
  */
 
 import postgres from "postgres";
@@ -74,7 +74,7 @@ function loadManifestFromDisk(): Manifest {
   // Fall back to default paths
   const paths = [
     join(process.cwd(), "dist/runtime/manifest.json"),
-    join(process.cwd(), "packages/tzql/dist/runtime/manifest.json"),
+    join(process.cwd(), "generated/runtime/manifest.json"),
   ];
 
   for (const path of paths) {
@@ -85,7 +85,7 @@ function loadManifestFromDisk(): Manifest {
   }
 
   throw new Error(
-    "Manifest not found. Set MANIFEST_PATH env var or run 'tzql compile' to generate dist/runtime/manifest.json"
+    "Manifest not found. Set MANIFEST_PATH env var or run 'dzql compile' to generate dist/runtime/manifest.json"
   );
 }
 
@@ -122,9 +122,9 @@ function discoverSubscribables(manifest: Manifest): Record<string, { params: Rec
 }
 
 /**
- * TZQL operations namespace for invokej
+ * DZQL operations namespace for invokej
  */
-export class TzqlNamespace {
+export class DzqlNamespace {
   private userId: number;
   private sql: postgres.Sql | null = null;
   private manifest: Manifest | null = null;
@@ -225,13 +225,13 @@ export class TzqlNamespace {
 
   /**
    * Search an entity
-   * @example invj tzql:search venues '{"query": "test"}'
+   * @example invj dzql:search venues '{"query": "test"}'
    */
   async search(_context: any, entity?: string, argsJson: string = "{}"): Promise<void> {
     if (!entity) {
       console.error("Error: entity name required");
-      console.error("Usage: invj tzql:search <entity> '<json_args>'");
-      console.error('Example: invj tzql:search venues \'{"query": "test"}\'');
+      console.error("Usage: invj dzql:search <entity> '<json_args>'");
+      console.error('Example: invj dzql:search venues \'{"query": "test"}\'');
       await this.cleanup();
       process.exit(1);
     }
@@ -258,13 +258,13 @@ export class TzqlNamespace {
 
   /**
    * Get entity by ID
-   * @example invj tzql:get venues '{"id": 1}'
+   * @example invj dzql:get venues '{"id": 1}'
    */
   async get(_context: any, entity?: string, argsJson: string = "{}"): Promise<void> {
     if (!entity) {
       console.error("Error: entity name required");
-      console.error("Usage: invj tzql:get <entity> '<json_args>'");
-      console.error('Example: invj tzql:get venues \'{"id": 1}\'');
+      console.error("Usage: invj dzql:get <entity> '<json_args>'");
+      console.error('Example: invj dzql:get venues \'{"id": 1}\'');
       await this.cleanup();
       process.exit(1);
     }
@@ -291,13 +291,13 @@ export class TzqlNamespace {
 
   /**
    * Save (create or update) entity
-   * @example invj tzql:save venues '{"name": "New Venue", "org_id": 1}'
+   * @example invj dzql:save venues '{"name": "New Venue", "org_id": 1}'
    */
   async save(_context: any, entity?: string, argsJson: string = "{}"): Promise<void> {
     if (!entity) {
       console.error("Error: entity name required");
-      console.error("Usage: invj tzql:save <entity> '<json_args>'");
-      console.error('Example: invj tzql:save venues \'{"name": "Test Venue", "org_id": 1}\'');
+      console.error("Usage: invj dzql:save <entity> '<json_args>'");
+      console.error('Example: invj dzql:save venues \'{"name": "Test Venue", "org_id": 1}\'');
       await this.cleanup();
       process.exit(1);
     }
@@ -324,13 +324,13 @@ export class TzqlNamespace {
 
   /**
    * Delete entity by ID
-   * @example invj tzql:delete venues '{"id": 1}'
+   * @example invj dzql:delete venues '{"id": 1}'
    */
   async delete(_context: any, entity?: string, argsJson: string = "{}"): Promise<void> {
     if (!entity) {
       console.error("Error: entity name required");
-      console.error("Usage: invj tzql:delete <entity> '<json_args>'");
-      console.error('Example: invj tzql:delete venues \'{"id": 1}\'');
+      console.error("Usage: invj dzql:delete <entity> '<json_args>'");
+      console.error('Example: invj dzql:delete venues \'{"id": 1}\'');
       await this.cleanup();
       process.exit(1);
     }
@@ -357,13 +357,13 @@ export class TzqlNamespace {
 
   /**
    * Lookup entity (for dropdowns/autocomplete)
-   * @example invj tzql:lookup organisations '{"query": "acme"}'
+   * @example invj dzql:lookup organisations '{"query": "acme"}'
    */
   async lookup(_context: any, entity?: string, argsJson: string = "{}"): Promise<void> {
     if (!entity) {
       console.error("Error: entity name required");
-      console.error("Usage: invj tzql:lookup <entity> '<json_args>'");
-      console.error('Example: invj tzql:lookup organisations \'{"query": "acme"}\'');
+      console.error("Usage: invj dzql:lookup <entity> '<json_args>'");
+      console.error('Example: invj dzql:lookup organisations \'{"query": "acme"}\'');
       await this.cleanup();
       process.exit(1);
     }
@@ -390,13 +390,13 @@ export class TzqlNamespace {
 
   /**
    * Get subscribable snapshot
-   * @example invj tzql:subscribe venue_detail '{"venue_id": 1}'
+   * @example invj dzql:subscribe venue_detail '{"venue_id": 1}'
    */
   async subscribe(_context: any, name?: string, argsJson: string = "{}"): Promise<void> {
     if (!name) {
       console.error("Error: subscribable name required");
-      console.error("Usage: invj tzql:subscribe <name> '<json_args>'");
-      console.error('Example: invj tzql:subscribe venue_detail \'{"venue_id": 1}\'');
+      console.error("Usage: invj dzql:subscribe <name> '<json_args>'");
+      console.error('Example: invj dzql:subscribe venue_detail \'{"venue_id": 1}\'');
       await this.cleanup();
       process.exit(1);
     }
@@ -423,15 +423,15 @@ export class TzqlNamespace {
 
   /**
    * Call any function in the manifest by name
-   * @example invj tzql:call login_user '{"email": "test@example.com", "password": "secret"}'
-   * @example invj tzql:call get_venue_detail '{"venue_id": 1}'
+   * @example invj dzql:call login_user '{"email": "test@example.com", "password": "secret"}'
+   * @example invj dzql:call get_venue_detail '{"venue_id": 1}'
    */
   async call(_context: any, funcName?: string, argsJson: string = "{}"): Promise<void> {
     if (!funcName) {
       console.error("Error: function name required");
-      console.error("Usage: invj tzql:call <function_name> '<json_args>'");
-      console.error('Example: invj tzql:call login_user \'{"email": "test@example.com", "password": "secret"}\'');
-      console.error('Example: invj tzql:call get_venue_detail \'{"venue_id": 1}\'');
+      console.error("Usage: invj dzql:call <function_name> '<json_args>'");
+      console.error('Example: invj dzql:call login_user \'{"email": "test@example.com", "password": "secret"}\'');
+      console.error('Example: invj dzql:call get_venue_detail \'{"venue_id": 1}\'');
       await this.cleanup();
       process.exit(1);
     }
@@ -458,7 +458,7 @@ export class TzqlNamespace {
 
   /**
    * List all available functions in the manifest
-   * @example invj tzql:functions
+   * @example invj dzql:functions
    */
   async functions(_context?: any): Promise<void> {
     try {

package/dist/client/index.ts

@@ -1 +0,0 @@
-export * from './ws.js';

package/dist/client/stores/useMyProfileStore.ts

@@ -1,114 +0,0 @@
-// Generated by TZQL Compiler v2.0.0
-// Do not edit this file directly.
-
-import { defineStore } from 'pinia';
-import { ref, type Ref } from 'vue';
-import { ws } from '../index.js';
-
-/** Parameters for my_profile subscription */
-export interface MyProfileParams {
-  [key: string]: unknown;
-}
-
-/** Event from server for patching */
-export interface PatchEvent {
-  table: string;
-  op: 'insert' | 'update' | 'delete';
-  pk: { id: number };
-  data: Record<string, unknown> | null;
-}
-
-/** Document wrapper with loading state */
-export interface DocumentWrapper<T> {
-  data: T;
-  loading: boolean;
-  ready: Promise<void>;
-}
-
-export const useMyProfileStore = defineStore('sub-my_profile', () => {
-  const documents: Ref<Record<string, DocumentWrapper<Record<string, unknown>>>> = ref({});
-  const unsubscribers = new Map<string, () => void>();
-
-  async function bind(params: MyProfileParams): Promise<DocumentWrapper<Record<string, unknown>>> {
-    const key = JSON.stringify(params);
-
-    if (documents.value[key]) {
-      const existing = documents.value[key];
-      if (existing.loading) {
-        await existing.ready;
-      }
-      return existing;
-    }
-
-    let resolveReady!: () => void;
-    const ready = new Promise<void>((resolve) => { resolveReady = resolve; });
-
-    documents.value[key] = { data: {}, loading: true, ready };
-    let isFirst = true;
-
-    const unsubscribe = await ws.api.subscribe_my_profile(params, (eventData: unknown) => {
-      if (isFirst) {
-        // Initial data - merge into existing object to preserve reactivity
-        Object.assign(documents.value[key].data, eventData as Record<string, unknown>);
-        documents.value[key].loading = false;
-        isFirst = false;
-        resolveReady();
-      } else {
-        // Patch event
-        applyPatch(documents.value[key].data, eventData as PatchEvent);
-      }
-    });
-
-    unsubscribers.set(key, unsubscribe as () => void);
-    await ready;
-    return documents.value[key];
-  }
-
-  function unbind(params: MyProfileParams): void {
-    const key = JSON.stringify(params);
-    const unsubscribe = unsubscribers.get(key);
-    if (unsubscribe) {
-      unsubscribe();
-      unsubscribers.delete(key);
-      delete documents.value[key];
-    }
-  }
-
-  function applyPatch(doc: Record<string, unknown>, event: PatchEvent): void {
-    if (!doc) return;
-    switch (event.table) {
-      case 'users':
-        if (event.op === 'update' && doc.users) {
-          Object.assign(doc.users, event.data);
-        }
-        break;
-      case 'acts_for':
-        handleArrayPatch(doc.memberships, event);
-        break;
-      case 'organisations':
-        if (event.data && event.data.membership_id) {
-          const parent = doc.memberships?.find((p: { id: number }) => p.id === event.data.membership_id);
-          if (parent && parent.org) {
-            handleArrayPatch(parent.org, event);
-          }
-        }
-        break;
-    }
-  }
-
-  function handleArrayPatch(arr: unknown[] | undefined, event: PatchEvent): void {
-    if (!arr || !Array.isArray(arr)) return;
-    const pkValue = event.pk?.id;
-    const idx = arr.findIndex((i: unknown) => (i as { id: number }).id === pkValue);
-
-    if (event.op === 'insert') {
-      if (idx === -1 && event.data) arr.push(event.data);
-    } else if (event.op === 'update') {
-      if (idx !== -1 && event.data) Object.assign(arr[idx] as object, event.data);
-    } else if (event.op === 'delete') {
-      if (idx !== -1) arr.splice(idx, 1);
-    }
-  }
-
-  return { bind, unbind, documents };
-});

package/dist/client/stores/useOrgDashboardStore.ts

@@ -1,131 +0,0 @@
-// Generated by TZQL Compiler v2.0.0
-// Do not edit this file directly.
-
-import { defineStore } from 'pinia';
-import { ref, type Ref } from 'vue';
-import { ws } from '../index.js';
-
-/** Parameters for org_dashboard subscription */
-export interface OrgDashboardParams {
-  org_id: number;
-}
-
-/** Event from server for patching */
-export interface PatchEvent {
-  table: string;
-  op: 'insert' | 'update' | 'delete';
-  pk: { id: number };
-  data: Record<string, unknown> | null;
-}
-
-/** Document wrapper with loading state */
-export interface DocumentWrapper<T> {
-  data: T;
-  loading: boolean;
-  ready: Promise<void>;
-}
-
-export const useOrgDashboardStore = defineStore('sub-org_dashboard', () => {
-  const documents: Ref<Record<string, DocumentWrapper<Record<string, unknown>>>> = ref({});
-  const unsubscribers = new Map<string, () => void>();
-
-  async function bind(params: OrgDashboardParams): Promise<DocumentWrapper<Record<string, unknown>>> {
-    const key = JSON.stringify(params);
-
-    if (documents.value[key]) {
-      const existing = documents.value[key];
-      if (existing.loading) {
-        await existing.ready;
-      }
-      return existing;
-    }
-
-    let resolveReady!: () => void;
-    const ready = new Promise<void>((resolve) => { resolveReady = resolve; });
-
-    documents.value[key] = { data: {}, loading: true, ready };
-    let isFirst = true;
-
-    const unsubscribe = await ws.api.subscribe_org_dashboard(params, (eventData: unknown) => {
-      if (isFirst) {
-        // Initial data - merge into existing object to preserve reactivity
-        Object.assign(documents.value[key].data, eventData as Record<string, unknown>);
-        documents.value[key].loading = false;
-        isFirst = false;
-        resolveReady();
-      } else {
-        // Patch event
-        applyPatch(documents.value[key].data, eventData as PatchEvent);
-      }
-    });
-
-    unsubscribers.set(key, unsubscribe as () => void);
-    await ready;
-    return documents.value[key];
-  }
-
-  function unbind(params: OrgDashboardParams): void {
-    const key = JSON.stringify(params);
-    const unsubscribe = unsubscribers.get(key);
-    if (unsubscribe) {
-      unsubscribe();
-      unsubscribers.delete(key);
-      delete documents.value[key];
-    }
-  }
-
-  function applyPatch(doc: Record<string, unknown>, event: PatchEvent): void {
-    if (!doc) return;
-    switch (event.table) {
-      case 'organisations':
-        if (event.op === 'update' && doc.organisations) {
-          Object.assign(doc.organisations, event.data);
-        }
-        break;
-      case 'venues':
-        handleArrayPatch(doc.venues, event);
-        break;
-      case 'sites':
-        if (event.data && event.data.venue_id) {
-          const parent = doc.venues?.find((p: { id: number }) => p.id === event.data.venue_id);
-          if (parent && parent.sites) {
-            handleArrayPatch(parent.sites, event);
-          }
-        }
-        break;
-      case 'products':
-        handleArrayPatch(doc.products, event);
-        break;
-      case 'packages':
-        handleArrayPatch(doc.packages, event);
-        break;
-      case 'brands':
-        handleArrayPatch(doc.brands, event);
-        break;
-      case 'artwork':
-        if (event.data && event.data.brand_id) {
-          const parent = doc.brands?.find((p: { id: number }) => p.id === event.data.brand_id);
-          if (parent && parent.artwork) {
-            handleArrayPatch(parent.artwork, event);
-          }
-        }
-        break;
-    }
-  }
-
-  function handleArrayPatch(arr: unknown[] | undefined, event: PatchEvent): void {
-    if (!arr || !Array.isArray(arr)) return;
-    const pkValue = event.pk?.id;
-    const idx = arr.findIndex((i: unknown) => (i as { id: number }).id === pkValue);
-
-    if (event.op === 'insert') {
-      if (idx === -1 && event.data) arr.push(event.data);
-    } else if (event.op === 'update') {
-      if (idx !== -1 && event.data) Object.assign(arr[idx] as object, event.data);
-    } else if (event.op === 'delete') {
-      if (idx !== -1) arr.splice(idx, 1);
-    }
-  }
-
-  return { bind, unbind, documents };
-});

package/dist/client/stores/useVenueDetailStore.ts

@@ -1,117 +0,0 @@
-// Generated by TZQL Compiler v2.0.0
-// Do not edit this file directly.
-
-import { defineStore } from 'pinia';
-import { ref, type Ref } from 'vue';
-import { ws } from '../index.js';
-
-/** Parameters for venue_detail subscription */
-export interface VenueDetailParams {
-  venue_id: number;
-}
-
-/** Event from server for patching */
-export interface PatchEvent {
-  table: string;
-  op: 'insert' | 'update' | 'delete';
-  pk: { id: number };
-  data: Record<string, unknown> | null;
-}
-
-/** Document wrapper with loading state */
-export interface DocumentWrapper<T> {
-  data: T;
-  loading: boolean;
-  ready: Promise<void>;
-}
-
-export const useVenueDetailStore = defineStore('sub-venue_detail', () => {
-  const documents: Ref<Record<string, DocumentWrapper<Record<string, unknown>>>> = ref({});
-  const unsubscribers = new Map<string, () => void>();
-
-  async function bind(params: VenueDetailParams): Promise<DocumentWrapper<Record<string, unknown>>> {
-    const key = JSON.stringify(params);
-
-    if (documents.value[key]) {
-      const existing = documents.value[key];
-      if (existing.loading) {
-        await existing.ready;
-      }
-      return existing;
-    }
-
-    let resolveReady!: () => void;
-    const ready = new Promise<void>((resolve) => { resolveReady = resolve; });
-
-    documents.value[key] = { data: {}, loading: true, ready };
-    let isFirst = true;
-
-    const unsubscribe = await ws.api.subscribe_venue_detail(params, (eventData: unknown) => {
-      if (isFirst) {
-        // Initial data - merge into existing object to preserve reactivity
-        Object.assign(documents.value[key].data, eventData as Record<string, unknown>);
-        documents.value[key].loading = false;
-        isFirst = false;
-        resolveReady();
-      } else {
-        // Patch event
-        applyPatch(documents.value[key].data, eventData as PatchEvent);
-      }
-    });
-
-    unsubscribers.set(key, unsubscribe as () => void);
-    await ready;
-    return documents.value[key];
-  }
-
-  function unbind(params: VenueDetailParams): void {
-    const key = JSON.stringify(params);
-    const unsubscribe = unsubscribers.get(key);
-    if (unsubscribe) {
-      unsubscribe();
-      unsubscribers.delete(key);
-      delete documents.value[key];
-    }
-  }
-
-  function applyPatch(doc: Record<string, unknown>, event: PatchEvent): void {
-    if (!doc) return;
-    switch (event.table) {
-      case 'venues':
-        if (event.op === 'update' && doc.venues) {
-          Object.assign(doc.venues, event.data);
-        }
-        break;
-      case 'organisations':
-        handleArrayPatch(doc.org, event);
-        break;
-      case 'sites':
-        handleArrayPatch(doc.sites, event);
-        break;
-      case 'allocations':
-        if (event.data && event.data.site_id) {
-          const parent = doc.sites?.find((p: { id: number }) => p.id === event.data.site_id);
-          if (parent && parent.allocations) {
-            handleArrayPatch(parent.allocations, event);
-          }
-        }
-        break;
-    }
-  }
-
-  function handleArrayPatch(arr: unknown[] | undefined, event: PatchEvent): void {
-    if (!arr || !Array.isArray(arr)) return;
-    const pkValue = event.pk?.id;
-    const idx = arr.findIndex((i: unknown) => (i as { id: number }).id === pkValue);
-
-    if (event.op === 'insert') {
-      if (idx === -1 && event.data) arr.push(event.data);
-    } else if (event.op === 'update') {
-      if (idx !== -1 && event.data) Object.assign(arr[idx] as object, event.data);
-    } else if (event.op === 'delete') {
-      if (idx !== -1) arr.splice(idx, 1);
-    }
-  }
-
-  return { bind, unbind, documents };
-});