dzql 0.6.1 → 0.6.2

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.2",
   "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_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
 });