dzql 0.5.33 → 0.6.0

package/.env.sample

@@ -0,0 +1,28 @@
+# TZQL Environment Variables
+# Copy this file to .env and modify as needed
+
+# ===================
+# Server (Runtime)
+# ===================
+
+# PostgreSQL connection string
+DATABASE_URL=postgres://user:password@localhost:5432/database
+
+# Server port
+PORT=3000
+
+# Path to compiled manifest (relative to working directory)
+MANIFEST_PATH=./dist/runtime/manifest.json
+
+# JWT secret for authentication (CHANGE IN PRODUCTION!)
+JWT_SECRET=your-secure-secret-key-here
+
+# ===================
+# Client (Browser)
+# ===================
+# These are injected at build time by your bundler (Vite, Webpack, etc.)
+
+# Token name for localStorage (Vite: prefix with VITE_)
+# VITE_TZQL_TOKEN_NAME=myapp_token
+# Or for other bundlers:
+# TZQL_TOKEN_NAME=myapp_token

package/compose.yml

@@ -0,0 +1,28 @@
+services:
+  postgres:
+    image: postgres:16-alpine
+    container_name: tzql-test-db
+    environment:
+      POSTGRES_USER: dzql_test
+      POSTGRES_PASSWORD: dzql_test
+      POSTGRES_DB: dzql_test
+    ports:
+      - "5433:5432" # Map container's 5432 to host's 5433
+    volumes:
+      - tzql-test-data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U dzql_test -d dzql_test"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+    command:
+      - "postgres"
+      - "-c"
+      - "log_statement=all"
+      - "-c"
+      - "log_destination=stderr"
+      - "-c"
+      - "logging_collector=off"
+
+volumes:
+  tzql-test-data:

package/dist/client/index.ts

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

package/dist/client/stores/useMyProfileStore.ts

@@ -0,0 +1,114 @@
+// 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

@@ -0,0 +1,131 @@
+// 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

@@ -0,0 +1,117 @@
+// 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 };
+});