dzql 0.6.1 → 0.6.3

package/dist/client/stores/useMyProfileStore.ts

@@ -1,4 +1,4 @@
-// Generated by TZQL Compiler v2.0.0
+// Generated by DZQL Compiler v2.0.0
 // Do not edit this file directly.
 
 import { defineStore } from 'pinia';

package/dist/client/stores/useOrgDashboardStore.ts

@@ -1,4 +1,4 @@
-// Generated by TZQL Compiler v2.0.0
+// Generated by DZQL Compiler v2.0.0
 // Do not edit this file directly.
 
 import { defineStore } from 'pinia';

package/dist/client/stores/useVenueDetailStore.ts

@@ -1,4 +1,4 @@
-// Generated by TZQL Compiler v2.0.0
+// Generated by DZQL Compiler v2.0.0
 // Do not edit this file directly.
 
 import { defineStore } from 'pinia';

package/dist/client/ws.ts

@@ -1,7 +1,7 @@
-// Generated by TZQL Compiler v2.0.0
+// Generated by DZQL Compiler v2.0.0
 // Do not edit this file directly.
 
-import { WebSocketManager } from '/Users/peterb/Workshop/blueshed/dzql/packages/tzql/src/client/index.ts';
+import { WebSocketManager } from 'dzql/client';
 
 // Filter operators for search queries
 export interface FilterOperators<T> {
@@ -556,7 +556,7 @@ export interface MyProfileParams {
 
 
 /** API interface with typed methods */
-export interface TzqlAPI {
+export interface DzqlAPI {
   login_user: (params: Record<string, unknown>) => Promise<unknown>;
   register_user: (params: Record<string, unknown>) => Promise<unknown>;
   get_users: (params: UsersPK) => Promise<Users | null>;
@@ -632,7 +632,7 @@ export interface TzqlAPI {
 
 /** Extended WebSocket manager with typed API */
 export class GeneratedWebSocketManager extends WebSocketManager {
-  api: TzqlAPI;
+  api: DzqlAPI;
 
   constructor(options: { url?: string; reconnect?: boolean } = {}) {
     super(options);
@@ -708,7 +708,7 @@ export class GeneratedWebSocketManager extends WebSocketManager {
       subscribe_venue_detail: (params: Record<string, unknown>, callback: (data: unknown) => void) => this.subscribe('subscribe_venue_detail', params, callback),
       subscribe_org_dashboard: (params: Record<string, unknown>, callback: (data: unknown) => void) => this.subscribe('subscribe_org_dashboard', params, callback),
       subscribe_my_profile: (params: Record<string, unknown>, callback: (data: unknown) => void) => this.subscribe('subscribe_my_profile', params, callback),
-    } as TzqlAPI;
+    } as DzqlAPI;
   }
 }
 

package/dist/db/migrations/{20251229T212912022Z_subscribables.sql → 20260101T235039268Z_subscribables.sql}

@@ -2,7 +2,7 @@
 -- Subscribable: venue_detail
 -- Root Entity: venues
 -- Scope Tables: venues, organisations, sites, allocations
--- Generated: 2025-12-29T21:29:12.021Z
+-- Generated: 2026-01-01T23:50:39.267Z
 -- ============================================================================
 
 CREATE OR REPLACE FUNCTION dzql_v2.venue_detail_can_subscribe(
@@ -125,7 +125,7 @@ $$;
 -- Subscribable: org_dashboard
 -- Root Entity: organisations
 -- Scope Tables: organisations, venues, sites, products, packages, brands, artwork
--- Generated: 2025-12-29T21:29:12.022Z
+-- Generated: 2026-01-01T23:50:39.267Z
 -- ============================================================================
 
 CREATE OR REPLACE FUNCTION dzql_v2.org_dashboard_can_subscribe(
@@ -276,7 +276,7 @@ $$;
 -- Subscribable: my_profile
 -- Root Entity: users
 -- Scope Tables: users, acts_for, organisations
--- Generated: 2025-12-29T21:29:12.022Z
+-- Generated: 2026-01-01T23:50:39.267Z
 -- ============================================================================
 
 CREATE OR REPLACE FUNCTION dzql_v2.my_profile_can_subscribe(

package/docs/README.md

@@ -147,7 +147,7 @@ await ws.logout();  // Clears token and user state
 
 ## Generated Pinia Subscribable Stores
 
-TZQL generates Pinia stores for each subscribable that handle:
+DZQL generates Pinia stores for each subscribable that handle:
 - Initial data fetch via WebSocket subscription
 - Automatic realtime patching when related data changes
 - Deduplication of subscriptions by parameter key

package/docs/feature-requests/applyPatch-bug-report.md

@@ -1,4 +1,4 @@
-# tzql Bug Report
+# DZQL Bug Report
 
 ## Generated Store applyPatch Doesn't Match Data Structure
 
@@ -79,7 +79,7 @@ to_jsonb(rel.*) || jsonb_build_object(...)
 
 ## Environment
 
-- tzql version: local development (linked)
+- dzql version: local development (linked)
 - Database: PostgreSQL 17 (Docker)
 - Client: Vue 3 + Pinia + TypeScript
 - Runtime: Bun

package/docs/feature-requests/connection-ready-profile.md

@@ -4,7 +4,7 @@
 
 ## Summary
 
-When a client connects to the tzql WebSocket server, the server should immediately send a connection:ready message containing the authenticated user profile (or null if not authenticated).
+When a client connects to the DZQL WebSocket server, the server should immediately send a connection:ready message containing the authenticated user profile (or null if not authenticated).
 
 ## Current Behavior
 

package/docs/feature-requests/hidden-bug-report.md

@@ -1,6 +1,6 @@
-# tzql Bug Report
+# DZQL Bug Report
 
-Bugs discovered while building the Venues application with tzql.
+Bugs discovered while building the Venues application with DZQL.
 
 ---
 
@@ -97,7 +97,7 @@ Updated `compileSubscribePermission` in `subscribable_sql.ts` to map param names
 
 ## Environment
 
-- tzql version: (linked local development version)
+- dzql version: (linked local development version)
 - Database: PostgreSQL 17 (via Docker)
 - Client: Vue 3 + Pinia + TypeScript
 - Runtime: Bun
@@ -106,6 +106,6 @@ Updated `compileSubscribePermission` in `subscribable_sql.ts` to map param names
 
 ## Related Files
 
-Detailed bug documents created in tzql docs:
+Detailed bug documents created in dzql docs:
 - `/packages/tzql/docs/feature-requests/hidden-fields-in-subscribables.md`
 - `/packages/tzql/docs/feature-requests/subscribable-param-key-bug.md`

package/docs/feature-requests/todo.md

@@ -1,4 +1,4 @@
-# TZQL v2 Gap Analysis TODO
+# DZQL v2 Gap Analysis TODO
 
 Gap analysis comparing v1 tests to v2 functionality. Updated 2024-12-17.
 

package/docs/for_ai.md

@@ -288,7 +288,7 @@ Use `type: 'reactor'` for anything that requires Node.js (Email, Stripe, AI proc
 
 ## Custom Functions
 
-TZQL supports two types of custom functions that can be called via RPC:
+DZQL supports two types of custom functions that can be called via RPC:
 
 ### 1. SQL Custom Functions
 
@@ -367,7 +367,7 @@ JavaScript custom functions run in the Bun/Node runtime. They are ideal for:
 
 ```typescript
 // server.ts or wherever you start your runtime
-import { registerJsFunction } from 'tzql/runtime';
+import { registerJsFunction } from 'dzql/runtime';
 
 // Simple function
 registerJsFunction('hello_world', async (ctx) => {
@@ -471,7 +471,7 @@ interface JsFunctionContext {
 
 ## Unmanaged Entities (Junction Tables)
 
-For junction tables used in many-to-many relationships, you typically don't want TZQL to generate CRUD functions. These tables are managed via the M2M relationship on the parent entity.
+For junction tables used in many-to-many relationships, you typically don't want DZQL to generate CRUD functions. These tables are managed via the M2M relationship on the parent entity.
 
 Use `managed: false` to skip CRUD generation:
 
@@ -580,7 +580,7 @@ await ws.logout();  // Clears token, user state, and reconnects
 
 ## CLI Integration with Namespace
 
-TZQL provides a namespace export for CLI tools like `invokej` to interact with the database directly without going through the WebSocket runtime.
+DZQL provides a namespace export for CLI tools like `invokej` to interact with the database directly without going through the WebSocket runtime.
 
 ### Setup
 
@@ -599,19 +599,19 @@ const dzql = new DzqlNamespace(sql, manifest);
 
 ```typescript
 // Get a record
-const venue = await tzql.get('venues', { id: 1 }, userId);
+const venue = await dzql.get('venues', { id: 1 }, userId);
 
 // Save (create or update)
-const newVenue = await tzql.save('venues', { name: 'New Venue', org_id: 1 }, userId);
+const newVenue = await dzql.save('venues', { name: 'New Venue', org_id: 1 }, userId);
 
 // Delete
-const deleted = await tzql.delete('venues', { id: 1 }, userId);
+const deleted = await dzql.delete('venues', { id: 1 }, userId);
 
 // Search with filters
-const venues = await tzql.search('venues', { org_id: 1, limit: 10 }, userId);
+const venues = await dzql.search('venues', { org_id: 1, limit: 10 }, userId);
 
 // Lookup for autocomplete
-const options = await tzql.lookup('venues', { q: 'test' }, userId);
+const options = await dzql.lookup('venues', { q: 'test' }, userId);
 ```
 
 ### Ad-hoc Function Calls
@@ -620,17 +620,17 @@ Call any function in the manifest directly:
 
 ```typescript
 // Call a custom function
-const result = await tzql.call('calculate_org_stats', { org_id: 1 }, userId);
+const result = await dzql.call('calculate_org_stats', { org_id: 1 }, userId);
 
 // Call a subscribable getter
-const detail = await tzql.call('get_venue_detail', { venue_id: 1 }, userId);
+const detail = await dzql.call('get_venue_detail', { venue_id: 1 }, userId);
 ```
 
 ### List Available Functions
 
 ```typescript
 // Get all functions from manifest
-const functions = tzql.functions();
+const functions = dzql.functions();
 // Returns: ['login_user', 'register_user', 'get_venues', 'save_venues', ...]
 ```
 
@@ -639,11 +639,11 @@ const functions = tzql.functions();
 The namespace is designed for use with `invokej`, a CLI tool for invoking functions:
 
 ```bash
-# In your invokej configuration, register the TZQL namespace
-invokej tzql:get venues '{"id": 1}'
-invokej tzql:save venues '{"name": "Updated Venue", "id": 1}'
-invokej tzql:call calculate_org_stats '{"org_id": 1}'
-invokej tzql:functions
+# In your invokej configuration, register the DZQL namespace
+invokej dzql:get venues '{"id": 1}'
+invokej dzql:save venues '{"name": "Updated Venue", "id": 1}'
+invokej dzql:call calculate_org_stats '{"org_id": 1}'
+invokej dzql:functions
 ```
 
 **Key Points:**

package/docs/project-setup.md

@@ -26,7 +26,7 @@ If you prefer to set up manually:
 my-app/
 ├── package.json          # Workspaces root
 ├── bun.lock              # Single lockfile
-├── domain.js             # TZQL domain definition
+├── domain.js             # DZQL domain definition
 ├── .env                  # Environment variables
 ├── compose.yml           # PostgreSQL for development
 ├── generated/            # DO NOT EDIT - compiled output
@@ -43,7 +43,7 @@ my-app/
 │       ├── composables/
 │       ├── components/
 │       └── views/
-└── server/               # TZQL server workspace
+└── server/               # DZQL server workspace
     ├── package.json
     └── index.ts
 ```
@@ -164,7 +164,7 @@ MANIFEST_PATH=./generated/runtime/manifest.json
 JWT_SECRET=dev-secret-change-in-production
 
 # Client (Vite)
-VITE_TZQL_TOKEN_NAME=myapp_token
+VITE_DZQL_TOKEN_NAME=myapp_token
 ```
 
 ## 4. Vite Configuration
@@ -189,7 +189,7 @@ export default defineConfig({
     host: '0.0.0.0',
     allowedHosts: ['host.docker.internal'],
     
-    // Proxy WebSocket to TZQL server
+    // Proxy WebSocket to DZQL server
     proxy: {
       '/ws': {
         target: 'ws://localhost:3000',
@@ -204,7 +204,7 @@ export default defineConfig({
 
 - `host: '0.0.0.0'` - Binds to all interfaces, required for Docker access
 - `allowedHosts: ['host.docker.internal']` - Allows Playwright MCP (running in Docker) to connect
-- `proxy: { '/ws': ... }` - Client connects to `/ws` on Vite's port, proxied to TZQL server on port 3000
+- `proxy: { '/ws': ... }` - Client connects to `/ws` on Vite's port, proxied to DZQL server on port 3000
 
 **For Playwright MCP testing:** Navigate to `http://host.docker.internal:5173`
 
@@ -227,7 +227,7 @@ export default defineConfig({
 
 ## 6. Authentication Composable
 
-`src/src/composables/useTzql.ts`:
+`src/src/composables/useDzql.ts`:
 
 ```typescript
 import { ref } from 'vue'
@@ -237,7 +237,7 @@ const ready = ref(false)
 const user = ref<any>(null)
 const connectionError = ref<string | null>(null)
 
-export function useTzql() {
+export function useDzql() {
   async function connect(url?: string) {
     try {
       connectionError.value = null
@@ -293,15 +293,15 @@ import { createApp } from 'vue'
 import { createPinia } from 'pinia'
 import App from './App.vue'
 import router from './router'
-import { useTzql } from './composables/useTzql'
+import { useDzql } from './composables/useDzql'
 
 const app = createApp(App)
 app.use(createPinia())
 app.use(router)
 app.mount('#app')
 
-// Connect to TZQL server
-const { connect } = useTzql()
+// Connect to DZQL server
+const { connect } = useDzql()
 connect()
 ```
 
@@ -311,10 +311,10 @@ connect()
 
 ```vue
 <script setup lang="ts">
-import { useTzql } from '@/composables/useTzql'
+import { useDzql } from '@/composables/useDzql'
 import LoginModal from '@/components/LoginModal.vue'
 
-const { ready, user, logout } = useTzql()
+const { ready, user, logout } = useDzql()
 </script>
 
 <template>
@@ -347,11 +347,11 @@ const { ready, user, logout } = useTzql()
 <script setup lang="ts">
 import { computed, watchEffect } from 'vue'
 import { useRoute } from 'vue-router'
-import { useTzql } from '@/composables/useTzql'
+import { useDzql } from '@/composables/useDzql'
 import { useVenueDetailStore } from '@generated/client/stores/useVenueDetailStore.js'
 
 const route = useRoute()
-const { ws } = useTzql()
+const { ws } = useDzql()
 const store = useVenueDetailStore()
 
 const venueId = computed(() => Number(route.params.id))
@@ -391,11 +391,11 @@ async function deleteSite(id: number) {
 Create `tasks.js` in the project root to enable CLI database operations:
 
 ```javascript
-import { TzqlNamespace } from "tzql/namespace";
+import { DzqlNamespace } from "dzql/namespace";
 
 export class Tasks {
   constructor() {
-    this.tzql = new TzqlNamespace();
+    this.dzql = new DzqlNamespace();
   }
 }
 ```
@@ -406,25 +406,25 @@ This integrates with `invj` to provide direct database access:
 # List available commands
 invj -l
 
-# Available tzql commands:
-#   tzql:entities              - List all entities
-#   tzql:subscribables         - List all subscribables
-#   tzql:functions             - List all functions
-#   tzql:search <entity> [json] - Search records
-#   tzql:get <entity> [json]    - Get single record
-#   tzql:save <entity> [json]   - Create/update record
-#   tzql:delete <entity> [json] - Delete record
-#   tzql:lookup <entity> [json] - Autocomplete lookup
-#   tzql:call <func> [json]     - Call custom function
-#   tzql:subscribe <name> [json] - Get subscribable data
+# Available dzql commands:
+#   dzql:entities              - List all entities
+#   dzql:subscribables         - List all subscribables
+#   dzql:functions             - List all functions
+#   dzql:search <entity> [json] - Search records
+#   dzql:get <entity> [json]    - Get single record
+#   dzql:save <entity> [json]   - Create/update record
+#   dzql:delete <entity> [json] - Delete record
+#   dzql:lookup <entity> [json] - Autocomplete lookup
+#   dzql:call <func> [json]     - Call custom function
+#   dzql:subscribe <name> [json] - Get subscribable data
 
 # Examples
-invj tzql:entities
-invj tzql:search venues
-invj tzql:search venues '{"org_id": 1}'
-invj tzql:get venues '{"id": 1}'
-invj tzql:save venues '{"org_id": 1, "name": "New Venue", "address": "123 Main St"}'
-invj tzql:delete venues '{"id": 1}'
+invj dzql:entities
+invj dzql:search venues
+invj dzql:search venues '{"org_id": 1}'
+invj dzql:get venues '{"id": 1}'
+invj dzql:save venues '{"org_id": 1, "name": "New Venue", "address": "123 Main St"}'
+invj dzql:delete venues '{"id": 1}'
 ```
 
 ## Development Workflow
@@ -442,15 +442,15 @@ bun run dev
 
 After `bun run db`, the database initializes with migrations automatically. After domain changes, run `bun run compile` then restart the server.
 
-## Linking TZQL for Local Development
+## Linking DZQL for Local Development
 
-If developing TZQL locally:
+If developing DZQL locally:
 
 ```bash
-cd /path/to/tzql
+cd /path/to/dzql
 bun link
 
 cd /path/to/my-app
-# tzql is already in package.json as "link:tzql"
+# dzql is already in package.json as "link:dzql"
 bun install
 ```

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "dzql",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Database-first real-time framework with TypeScript support",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blueshed/dzql"
+  },
   "type": "module",
   "bin": {
     "dzql": "./src/cli/index.ts"

package/src/cli/codegen/client.ts

@@ -64,21 +64,21 @@ export function generateClientSDK(manifest: Manifest): string {
     return `  ${funcName}: (params: ${paramType}) => Promise<${returnType}>;`;
   }).join('\n');
 
-  return `// Generated by TZQL Compiler v${manifest.version}
+  return `// Generated by DZQL Compiler v${manifest.version}
 // Do not edit this file directly.
 
-import { WebSocketManager } from 'tzql/client';
+import { WebSocketManager } from 'dzql/client';
 
 ${typeDefs}
 
 /** API interface with typed methods */
-export interface TzqlAPI {
+export interface DzqlAPI {
 ${apiMethods}
 }
 
 /** Extended WebSocket manager with typed API */
 export class GeneratedWebSocketManager extends WebSocketManager {
-  api: TzqlAPI;
+  api: DzqlAPI;
 
   constructor(options: { url?: string; reconnect?: boolean } = {}) {
     super(options);
@@ -89,7 +89,7 @@ ${regularFunctions.map(([funcName]) =>
 ${subscriptionFunctions.map(([funcName]) =>
       `      ${funcName}: (params: Record<string, unknown>, callback: (data: unknown) => void) => this.subscribe('${funcName}', params, callback),`
 ).join('\n')}
-    } as TzqlAPI;
+    } as DzqlAPI;
   }
 }
 

package/src/cli/codegen/pinia.ts

@@ -48,7 +48,7 @@ export function generatePiniaStore(manifest: Manifest, entityName: string): stri
     ? 'number'
     : 'string';
 
-  return `// Generated by TZQL Compiler v${manifest.version}
+  return `// Generated by DZQL Compiler v${manifest.version}
 // Do not edit this file directly.
 
 import { defineStore } from 'pinia';

package/src/cli/codegen/subscribable_sql.ts

@@ -223,7 +223,7 @@ function generateGetFunction(name: string, sub: SubscribableIR, entities: Record
   // Handle special @user_id root key
   const rootKey = sub.root.key;
   const isUserIdRoot = rootKey === '@user_id';
-  const rootWhereValue = isUserIdRoot ? 'p_user_id' : `v_${rootKey}`;
+  const isList = !rootKey; // No key means it's a list subscribable
 
   // Build root select expression excluding hidden fields
   const rootSelectExpr = buildVisibleRowJson('root', sub.root.entity, entities);
@@ -239,7 +239,67 @@ function generateGetFunction(name: string, sub: SubscribableIR, entities: Record
     scopeTables: sub.scopeTables
   }).replace(/'/g, "''"); // Escape single quotes for SQL
 
-  return `CREATE OR REPLACE FUNCTION dzql_v2.get_${name}(
+  // Build WHERE clause based on root filter and key
+  const whereConditions: string[] = [];
+  if (rootKey) {
+    const rootWhereValue = isUserIdRoot ? 'p_user_id' : `v_${rootKey}`;
+    whereConditions.push(`root.id = ${rootWhereValue}`);
+  }
+  if (sub.root.filter) {
+    for (const [field, value] of Object.entries(sub.root.filter)) {
+      if (typeof value === 'boolean') {
+        whereConditions.push(`root.${field} = ${value}`);
+      } else if (typeof value === 'string') {
+        whereConditions.push(`root.${field} = '${value}'`);
+      } else {
+        whereConditions.push(`root.${field} = ${value}`);
+      }
+    }
+  }
+  const whereClause = whereConditions.length > 0
+    ? `WHERE ${whereConditions.join(' AND ')}`
+    : '';
+
+  if (isList) {
+    // List subscribable - return array of records with nested includes
+    return `CREATE OR REPLACE FUNCTION dzql_v2.get_${name}(
+  p_params JSONB,
+  p_user_id INT
+) RETURNS JSONB
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path = dzql_v2, public
+AS $$
+DECLARE
+${paramDecls}
+  v_data JSONB;
+BEGIN
+  -- Extract parameters
+${paramExtracts}
+
+  -- Check access control
+  IF NOT dzql_v2.${name}_can_subscribe(p_user_id, p_params) THEN
+    RAISE EXCEPTION 'permission_denied';
+  END IF;
+
+  -- Build list of documents with nested relations
+  SELECT COALESCE(jsonb_agg(
+    to_jsonb(root.*) || jsonb_build_object(${relationSelects ? relationSelects.slice(1) : ''})
+  ), '[]'::jsonb)
+  INTO v_data
+  FROM ${sub.root.entity} root
+  ${whereClause};
+
+  -- Return data with embedded schema for atomic updates
+  RETURN jsonb_build_object(
+    '${sub.root.entity}', v_data,
+    'schema', '${schemaJson}'::jsonb
+  );
+END;
+$$;`;
+  } else {
+    // Single record subscribable
+    return `CREATE OR REPLACE FUNCTION dzql_v2.get_${name}(
   p_params JSONB,
   p_user_id INT
 ) RETURNS JSONB
@@ -265,7 +325,7 @@ ${paramExtracts}
   )
   INTO v_data
   FROM ${sub.root.entity} root
-  WHERE root.id = ${rootWhereValue};
+  ${whereClause};
 
   -- Return data with embedded schema for atomic updates
   RETURN jsonb_build_object(
@@ -274,6 +334,7 @@ ${paramExtracts}
   );
 END;
 $$;`;
+  }
 }
 
 function singularize(name: string): string {

package/src/cli/codegen/subscribable_store.ts

@@ -81,7 +81,7 @@ export function generateSubscribableStore(manifest: Manifest, subName: string):
 
   const patchCases = generatePatchCases();
 
-  return `// Generated by TZQL Compiler v${manifest.version}
+  return `// Generated by DZQL Compiler v${manifest.version}
 // Do not edit this file directly.
 
 import { defineStore } from 'pinia';

package/src/client/ws.ts

@@ -1,4 +1,4 @@
-// Core WebSocket Manager for TZQL Client
+// Core WebSocket Manager for DZQL Client
 // Handles connection, auth, reconnects, and message dispatching.
 // This is a pure transport layer - it does not manage or cache data.
 
@@ -10,17 +10,17 @@ export interface WebSocketOptions {
 
 // Get default token name from environment (build-time injection)
 function getDefaultTokenName(): string {
-  // Vite: import.meta.env.VITE_TZQL_TOKEN_NAME
+  // Vite: import.meta.env.VITE_DZQL_TOKEN_NAME
   // @ts-ignore
-  if (typeof import.meta !== 'undefined' && import.meta.env?.VITE_TZQL_TOKEN_NAME) {
+  if (typeof import.meta !== 'undefined' && import.meta.env?.VITE_DZQL_TOKEN_NAME) {
     // @ts-ignore
-    return import.meta.env.VITE_TZQL_TOKEN_NAME;
+    return import.meta.env.VITE_DZQL_TOKEN_NAME;
   }
-  // Node/bundlers: process.env.TZQL_TOKEN_NAME
-  if (typeof process !== 'undefined' && process.env?.TZQL_TOKEN_NAME) {
-    return process.env.TZQL_TOKEN_NAME;
+  // Node/bundlers: process.env.DZQL_TOKEN_NAME
+  if (typeof process !== 'undefined' && process.env?.DZQL_TOKEN_NAME) {
+    return process.env.DZQL_TOKEN_NAME;
   }
-  return 'tzql_token';
+  return 'dzql_token';
 }
 
 export class WebSocketManager {
@@ -32,7 +32,7 @@ export class WebSocketManager {
   protected readyCallbacks = new Set<(user: any) => void>();
   protected reconnectAttempts = 0;
   protected maxReconnectAttempts = 5;
-  protected tokenName = 'tzql_token';
+  protected tokenName = 'dzql_token';
   protected isShuttingDown = false;
 
   // Connection state
@@ -123,7 +123,7 @@ export class WebSocketManager {
 
       this.ws.onopen = () => {
         clearTimeout(connectionTimeout);
-        console.log('[TZQL] Connected to ' + wsUrl);
+        console.log('[DZQL] Connected to ' + wsUrl);
         this.reconnectAttempts = 0;
         resolve();
       };
@@ -133,12 +133,12 @@ export class WebSocketManager {
           const message = JSON.parse(event.data);
           this.handleMessage(message);
         } catch (error) {
-          console.error("[TZQL] Failed to parse message:", error);
+          console.error("[DZQL] Failed to parse message:", error);
         }
       };
 
       this.ws.onclose = () => {
-        console.log("[TZQL] Disconnected");
+        console.log("[DZQL] Disconnected");
         if (!this.isShuttingDown) {
           this.attemptReconnect();
         }
@@ -146,7 +146,7 @@ export class WebSocketManager {
 
       this.ws.onerror = (error) => {
         clearTimeout(connectionTimeout);
-        console.error("[TZQL] Connection error:", error);
+        console.error("[DZQL] Connection error:", error);
         reject(error);
       };
     });
@@ -157,7 +157,7 @@ export class WebSocketManager {
       this.reconnectAttempts++;
       const delay = 1000 * this.reconnectAttempts;
       setTimeout(() => {
-        console.log('[TZQL] Reconnecting (' + this.reconnectAttempts + ')...');
+        console.log('[DZQL] Reconnecting (' + this.reconnectAttempts + ')...');
         this.connect();
       }, delay);
     }

package/src/runtime/index.ts

@@ -90,7 +90,7 @@ const server = serve({
     if (server.upgrade(req, { data: { token } })) {
         return;
     }
-    return new Response("TZQL Runtime Active", { status: 200 });
+    return new Response("DZQL Runtime Active", { status: 200 });
   },
   websocket: wsServer.handlers
 });

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/src/runtime/ws.ts

@@ -148,6 +148,8 @@ export class WebSocketServer {
              // Auto-generate token for auth methods
              if (req.method === 'login_user' || req.method === 'register_user') {
                  const token = await signToken({ user_id: result.user_id, role: 'user' });
+                 // Update connection's userId for subsequent calls
+                 ws.data.userId = result.user_id;
                  // Return profile + token
                  ws.send(JSON.stringify({ id: req.id, result: { ...result, token } }));
              } else {

package/tests/client.test.ts

@@ -18,16 +18,16 @@ describe("Client SDK Generation", () => {
     const tsCode = generateClientSDK(mockManifest);
 
     // Check imports
-    expect(tsCode).toContain("import { WebSocketManager } from 'tzql/client'");
+    expect(tsCode).toContain("import { WebSocketManager } from 'dzql/client'");
 
     // Check interface definition
-    expect(tsCode).toContain("export interface TzqlAPI {");
+    expect(tsCode).toContain("export interface DzqlAPI {");
     expect(tsCode).toContain("save_posts: (params: SavePostsParams) => Promise<Posts>");
     expect(tsCode).toContain("get_posts: (params: PostsPK) => Promise<Posts | null>");
 
     // Check class definition
     expect(tsCode).toContain("export class GeneratedWebSocketManager extends WebSocketManager");
-    expect(tsCode).toContain("api: TzqlAPI");
+    expect(tsCode).toContain("api: DzqlAPI");
 
     // Check API implementation
     expect(tsCode).toContain("this.call('save_posts', params)");

package/tests/namespace.test.ts

@@ -1,5 +1,5 @@
 /**
- * Tests for TzqlNamespace - invokej integration
+ * Tests for DzqlNamespace - invokej integration
  *
  * These tests verify the namespace works correctly with the manifest
  * and can execute CRUD operations against a real database.
@@ -16,7 +16,7 @@ import { join } from "path";
 
 const blogDomain = { entities, subscribables: {} };
 
-describe("TzqlNamespace", () => {
+describe("DzqlNamespace", () => {
   let db: V2TestDatabase;
   let sql: any;
   let testManifestPath: string;
@@ -140,8 +140,8 @@ describe("TzqlNamespace", () => {
   }
 
   test("entities() lists available entities", async () => {
-    const { TzqlNamespace } = await import("../src/runtime/namespace.js");
-    const ns = new TzqlNamespace();
+    const { DzqlNamespace } = await import("../src/runtime/namespace.js");
+    const ns = new DzqlNamespace();
 
     const restore = setupMocks();
 
@@ -162,8 +162,8 @@ describe("TzqlNamespace", () => {
   });
 
   test("functions() lists available functions", async () => {
-    const { TzqlNamespace } = await import("../src/runtime/namespace.js");
-    const ns = new TzqlNamespace();
+    const { DzqlNamespace } = await import("../src/runtime/namespace.js");
+    const ns = new DzqlNamespace();
 
     const restore = setupMocks();
 
@@ -188,8 +188,8 @@ describe("TzqlNamespace", () => {
   });
 
   test("save() creates a new entity", async () => {
-    const { TzqlNamespace } = await import("../src/runtime/namespace.js");
-    const ns = new TzqlNamespace(1); // userId = 1
+    const { DzqlNamespace } = await import("../src/runtime/namespace.js");
+    const ns = new DzqlNamespace(1); // userId = 1
 
     const restore = setupMocks();
 
@@ -222,8 +222,8 @@ describe("TzqlNamespace", () => {
     `;
     const postId = created[0].id;
 
-    const { TzqlNamespace } = await import("../src/runtime/namespace.js");
-    const ns = new TzqlNamespace(1);
+    const { DzqlNamespace } = await import("../src/runtime/namespace.js");
+    const ns = new DzqlNamespace(1);
 
     const restore = setupMocks();
 
@@ -250,8 +250,8 @@ describe("TzqlNamespace", () => {
       VALUES ('Search Post 1', 'Content', 1), ('Search Post 2', 'More', 1)
     `;
 
-    const { TzqlNamespace } = await import("../src/runtime/namespace.js");
-    const ns = new TzqlNamespace(1);
+    const { DzqlNamespace } = await import("../src/runtime/namespace.js");
+    const ns = new DzqlNamespace(1);
 
     const restore = setupMocks();
 
@@ -279,8 +279,8 @@ describe("TzqlNamespace", () => {
     `;
     const postId = created[0].id;
 
-    const { TzqlNamespace } = await import("../src/runtime/namespace.js");
-    const ns = new TzqlNamespace(1); // userId must match author_id
+    const { DzqlNamespace } = await import("../src/runtime/namespace.js");
+    const ns = new DzqlNamespace(1); // userId must match author_id
 
     const restore = setupMocks();
 
@@ -308,8 +308,8 @@ describe("TzqlNamespace", () => {
   });
 
   test("call() executes arbitrary manifest function", async () => {
-    const { TzqlNamespace } = await import("../src/runtime/namespace.js");
-    const ns = new TzqlNamespace(1);
+    const { DzqlNamespace } = await import("../src/runtime/namespace.js");
+    const ns = new DzqlNamespace(1);
 
     const restore = setupMocks();
 
@@ -338,8 +338,8 @@ describe("TzqlNamespace", () => {
   });
 
   test("call() with unknown function returns error", async () => {
-    const { TzqlNamespace } = await import("../src/runtime/namespace.js");
-    const ns = new TzqlNamespace(1);
+    const { DzqlNamespace } = await import("../src/runtime/namespace.js");
+    const ns = new DzqlNamespace(1);
 
     const restore = setupMocks();
 
@@ -360,8 +360,8 @@ describe("TzqlNamespace", () => {
   });
 
   test("search() without entity shows usage", async () => {
-    const { TzqlNamespace } = await import("../src/runtime/namespace.js");
-    const ns = new TzqlNamespace(1);
+    const { DzqlNamespace } = await import("../src/runtime/namespace.js");
+    const ns = new DzqlNamespace(1);
 
     const restore = setupMocks();
 
@@ -377,8 +377,8 @@ describe("TzqlNamespace", () => {
   });
 
   test("save() with invalid JSON shows error", async () => {
-    const { TzqlNamespace } = await import("../src/runtime/namespace.js");
-    const ns = new TzqlNamespace(1);
+    const { DzqlNamespace } = await import("../src/runtime/namespace.js");
+    const ns = new DzqlNamespace(1);
 
     const restore = setupMocks();