@fitzzero/quickdraw-core 3.1.0 → 3.3.0

package/dist/client/testing.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { ServiceResponse } from '../shared/index.js';
-import { Q as QuickdrawSocketContextValue } from '../types-e6WPGE70.js';
+import { Q as QuickdrawSocketContextValue } from '../types-Cr8YC7Kg.js';
 import 'zod';
 import 'socket.io-client';
 

package/dist/client/testing.js

@@ -64,6 +64,8 @@ function createMockSocketContext(overrides = {}) {
     disconnect: () => {
     },
     subscriptionRegistry: createMockSubscriptionRegistry(),
+    subscriptionBatcher: { enqueue: () => {
+    } },
     ...overrides
   };
 }

package/dist/client/testing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/testing.tsx"],"names":[],"mappings":"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","file":"testing.js","sourcesContent":["import * as React from \"react\";\nimport type { QueryClient } from \"@tanstack/react-query\";\nimport type { Socket } from \"socket.io-client\";\nimport type { ServiceResponse } from \"../shared/types\";\nimport type { QuickdrawSocketContextValue } from \"./types\";\n\n// Generic mock function type that works with both Jest and Vitest\ntype MockFn = (...args: unknown[]) => unknown;\n\n/**\n * Mock socket for testing client components.\n */\nexport interface MockSocket {\n  id: string;\n  connected: boolean;\n  emit: MockFn;\n  on: MockFn;\n  off: MockFn;\n  disconnect: MockFn;\n}\n\n/**\n * Create a mock socket for testing.\n */\nexport function createMockSocket(): MockSocket {\n  // Simple mock function that can be enhanced by the test framework\n  const createMock = (): MockFn => {\n    const fn: MockFn = () => undefined;\n    return fn;\n  };\n\n  return {\n    id: \"mock-socket-id\",\n    connected: true,\n    emit: createMock(),\n    on: createMock(),\n    off: createMock(),\n    disconnect: createMock(),\n  };\n}\n\n/**\n * Create a mock subscription registry for testing.\n */\nfunction createMockSubscriptionRegistry() {\n  const subscriptions = new Map<string, { refCount: number; cleanup?: () => void }>();\n  \n  return {\n    acquire: (key: string) => {\n      const existing = subscriptions.get(key);\n      if (existing) {\n        existing.refCount++;\n        return { isNew: false, entry: existing };\n      }\n      const entry = { refCount: 1 };\n      subscriptions.set(key, entry);\n      return { isNew: true, entry };\n    },\n    release: (key: string) => {\n      const entry = subscriptions.get(key);\n      if (!entry) return false;\n      entry.refCount--;\n      if (entry.refCount <= 0) {\n        entry.cleanup?.();\n        subscriptions.delete(key);\n        return true;\n      }\n      return false;\n    },\n    setCleanup: (key: string, cleanup: () => void) => {\n      const entry = subscriptions.get(key);\n      if (entry) entry.cleanup = cleanup;\n    },\n    clear: () => subscriptions.clear(),\n  };\n}\n\n/**\n * Create a mock QuickdrawSocketContextValue for testing.\n */\nexport function createMockSocketContext(\n  overrides: Partial<QuickdrawSocketContextValue> = {}\n): QuickdrawSocketContextValue {\n  const mockSocket = createMockSocket();\n\n  return {\n    socket: mockSocket as unknown as Socket,\n    isConnected: true,\n    userId: \"test-user-id\",\n    serviceAccess: {},\n    connect: () => {},\n    disconnect: () => {},\n    subscriptionRegistry: createMockSubscriptionRegistry(),\n    ...overrides,\n  };\n}\n\n/**\n * Mock socket emit that resolves with a successful response.\n */\nexport function mockSuccessEmit<T>(data: T): (\n  _event: string,\n  _payload: unknown,\n  callback?: (response: ServiceResponse<T>) => void\n) => void {\n  return (_event, _payload, callback) => {\n    callback?.({ success: true, data });\n  };\n}\n\n/**\n * Mock socket emit that resolves with an error response.\n */\nexport function mockErrorEmit(\n  error: string,\n  code?: number\n): (\n  _event: string,\n  _payload: unknown,\n  callback?: (response: ServiceResponse<unknown>) => void\n) => void {\n  return (_event, _payload, callback) => {\n    const response: ServiceResponse<unknown> = { success: false, error };\n    if (code !== undefined) {\n      (response as { success: false; error: string; code: number }).code = code;\n    }\n    callback?.(response);\n  };\n}\n\n/**\n * Create a mock QueryClient for testing.\n */\nexport function createMockQueryClient(): QueryClient {\n  // Dynamic import to avoid bundling issues\n  // eslint-disable-next-line @typescript-eslint/no-var-requires\n  const { QueryClient } = require(\"@tanstack/react-query\") as {\n    QueryClient: new (options?: unknown) => QueryClient;\n  };\n\n  return new QueryClient({\n    defaultOptions: {\n      queries: {\n        retry: false,\n        gcTime: 0,\n      },\n      mutations: {\n        retry: false,\n      },\n    },\n  });\n}\n\n/**\n * Test wrapper component that provides the necessary context.\n */\nexport interface TestWrapperProps {\n  children: React.ReactNode;\n  socketContext?: Partial<QuickdrawSocketContextValue>;\n  queryClient?: QueryClient;\n}\n\n/**\n * Create a test wrapper for rendering components with quickdraw context.\n *\n * @example\n * ```tsx\n * import { render } from '@testing-library/react';\n * import { createTestWrapper, createMockSocketContext, mockSuccessEmit } from '@quickdraw/core/client/testing';\n *\n * test('creates chat', async () => {\n *   const mockSocket = createMockSocket();\n *   mockSocket.emit.mockImplementation(mockSuccessEmit({ id: 'chat-123' }));\n *\n *   const wrapper = createTestWrapper({\n *     socketContext: { socket: mockSocket },\n *   });\n *\n *   const { getByText } = render(<CreateChatButton />, { wrapper });\n *   // ...\n * });\n * ```\n */\nexport function createTestWrapper(\n  options: Omit<TestWrapperProps, \"children\"> = {}\n): ({ children }: { children: React.ReactNode }) => React.ReactElement {\n  const socketContext = createMockSocketContext(options.socketContext);\n  const queryClient = options.queryClient ?? createMockQueryClient();\n\n  // Create context for testing\n  const QuickdrawSocketContext = React.createContext<QuickdrawSocketContextValue | null>(null);\n\n  return function TestWrapper({ children }: { children: React.ReactNode }): React.ReactElement {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const { QueryClientProvider } = require(\"@tanstack/react-query\") as {\n      QueryClientProvider: React.ComponentType<{ client: QueryClient; children: React.ReactNode }>;\n    };\n\n    return (\n      <QueryClientProvider client={queryClient}>\n        <QuickdrawSocketContext.Provider value={socketContext}>\n          {children}\n        </QuickdrawSocketContext.Provider>\n      </QueryClientProvider>\n    );\n  };\n}\n"]}
+{"version":3,"sources":["../../src/client/testing.tsx"],"names":[],"mappings":"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","file":"testing.js","sourcesContent":["import * as React from \"react\";\nimport type { QueryClient } from \"@tanstack/react-query\";\nimport type { Socket } from \"socket.io-client\";\nimport type { ServiceResponse } from \"../shared/types\";\nimport type { QuickdrawSocketContextValue } from \"./types\";\n\n// Generic mock function type that works with both Jest and Vitest\ntype MockFn = (...args: unknown[]) => unknown;\n\n/**\n * Mock socket for testing client components.\n */\nexport interface MockSocket {\n  id: string;\n  connected: boolean;\n  emit: MockFn;\n  on: MockFn;\n  off: MockFn;\n  disconnect: MockFn;\n}\n\n/**\n * Create a mock socket for testing.\n */\nexport function createMockSocket(): MockSocket {\n  // Simple mock function that can be enhanced by the test framework\n  const createMock = (): MockFn => {\n    const fn: MockFn = () => undefined;\n    return fn;\n  };\n\n  return {\n    id: \"mock-socket-id\",\n    connected: true,\n    emit: createMock(),\n    on: createMock(),\n    off: createMock(),\n    disconnect: createMock(),\n  };\n}\n\n/**\n * Create a mock subscription registry for testing.\n */\nfunction createMockSubscriptionRegistry() {\n  const subscriptions = new Map<string, { refCount: number; cleanup?: () => void }>();\n  \n  return {\n    acquire: (key: string) => {\n      const existing = subscriptions.get(key);\n      if (existing) {\n        existing.refCount++;\n        return { isNew: false, entry: existing };\n      }\n      const entry = { refCount: 1 };\n      subscriptions.set(key, entry);\n      return { isNew: true, entry };\n    },\n    release: (key: string) => {\n      const entry = subscriptions.get(key);\n      if (!entry) return false;\n      entry.refCount--;\n      if (entry.refCount <= 0) {\n        entry.cleanup?.();\n        subscriptions.delete(key);\n        return true;\n      }\n      return false;\n    },\n    setCleanup: (key: string, cleanup: () => void) => {\n      const entry = subscriptions.get(key);\n      if (entry) entry.cleanup = cleanup;\n    },\n    clear: () => subscriptions.clear(),\n  };\n}\n\n/**\n * Create a mock QuickdrawSocketContextValue for testing.\n */\nexport function createMockSocketContext(\n  overrides: Partial<QuickdrawSocketContextValue> = {}\n): QuickdrawSocketContextValue {\n  const mockSocket = createMockSocket();\n\n  return {\n    socket: mockSocket as unknown as Socket,\n    isConnected: true,\n    userId: \"test-user-id\",\n    serviceAccess: {},\n    connect: () => {},\n    disconnect: () => {},\n    subscriptionRegistry: createMockSubscriptionRegistry(),\n    subscriptionBatcher: { enqueue: () => {} },\n    ...overrides,\n  };\n}\n\n/**\n * Mock socket emit that resolves with a successful response.\n */\nexport function mockSuccessEmit<T>(data: T): (\n  _event: string,\n  _payload: unknown,\n  callback?: (response: ServiceResponse<T>) => void\n) => void {\n  return (_event, _payload, callback) => {\n    callback?.({ success: true, data });\n  };\n}\n\n/**\n * Mock socket emit that resolves with an error response.\n */\nexport function mockErrorEmit(\n  error: string,\n  code?: number\n): (\n  _event: string,\n  _payload: unknown,\n  callback?: (response: ServiceResponse<unknown>) => void\n) => void {\n  return (_event, _payload, callback) => {\n    const response: ServiceResponse<unknown> = { success: false, error };\n    if (code !== undefined) {\n      (response as { success: false; error: string; code: number }).code = code;\n    }\n    callback?.(response);\n  };\n}\n\n/**\n * Create a mock QueryClient for testing.\n */\nexport function createMockQueryClient(): QueryClient {\n  // Dynamic import to avoid bundling issues\n  // eslint-disable-next-line @typescript-eslint/no-var-requires\n  const { QueryClient } = require(\"@tanstack/react-query\") as {\n    QueryClient: new (options?: unknown) => QueryClient;\n  };\n\n  return new QueryClient({\n    defaultOptions: {\n      queries: {\n        retry: false,\n        gcTime: 0,\n      },\n      mutations: {\n        retry: false,\n      },\n    },\n  });\n}\n\n/**\n * Test wrapper component that provides the necessary context.\n */\nexport interface TestWrapperProps {\n  children: React.ReactNode;\n  socketContext?: Partial<QuickdrawSocketContextValue>;\n  queryClient?: QueryClient;\n}\n\n/**\n * Create a test wrapper for rendering components with quickdraw context.\n *\n * @example\n * ```tsx\n * import { render } from '@testing-library/react';\n * import { createTestWrapper, createMockSocketContext, mockSuccessEmit } from '@quickdraw/core/client/testing';\n *\n * test('creates chat', async () => {\n *   const mockSocket = createMockSocket();\n *   mockSocket.emit.mockImplementation(mockSuccessEmit({ id: 'chat-123' }));\n *\n *   const wrapper = createTestWrapper({\n *     socketContext: { socket: mockSocket },\n *   });\n *\n *   const { getByText } = render(<CreateChatButton />, { wrapper });\n *   // ...\n * });\n * ```\n */\nexport function createTestWrapper(\n  options: Omit<TestWrapperProps, \"children\"> = {}\n): ({ children }: { children: React.ReactNode }) => React.ReactElement {\n  const socketContext = createMockSocketContext(options.socketContext);\n  const queryClient = options.queryClient ?? createMockQueryClient();\n\n  // Create context for testing\n  const QuickdrawSocketContext = React.createContext<QuickdrawSocketContextValue | null>(null);\n\n  return function TestWrapper({ children }: { children: React.ReactNode }): React.ReactElement {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const { QueryClientProvider } = require(\"@tanstack/react-query\") as {\n      QueryClientProvider: React.ComponentType<{ client: QueryClient; children: React.ReactNode }>;\n    };\n\n    return (\n      <QueryClientProvider client={queryClient}>\n        <QuickdrawSocketContext.Provider value={socketContext}>\n          {children}\n        </QuickdrawSocketContext.Provider>\n      </QueryClientProvider>\n    );\n  };\n}\n"]}

package/dist/server/index.d.ts

@@ -1,4 +1,4 @@
-import { a as QuickdrawSocket, P as PrismaDelegate, b as BaseServiceOptions, I as InstallAdminMethodsOptions, A as AdminListPayload, c as AdminListResponse, d as AdminSetACLPayload, e as AdminSubscribersResponse, S as ServiceRegistryInstance, B as BaseServiceInstance, f as QuickdrawServerOptions, Q as QuickdrawServerResult } from '../types-D7oHWh4O.js';
+import { a as QuickdrawSocket, P as PrismaDelegate, b as BaseServiceOptions, I as InstallAdminMethodsOptions, A as AdminListPayload, c as AdminListResponse, d as AdminSetACLPayload, e as AdminSubscribersResponse, S as ServiceRegistryInstance, B as BaseServiceInstance, f as QuickdrawServerOptions, Q as QuickdrawServerResult } from '../types-DniMxkQs.js';
 import { Server, Socket } from 'socket.io';
 import { z } from 'zod';
 import { ACL, Logger, AccessLevel, ServiceMethodContext, ServiceMethodDefinition, AdminServiceMeta, AdminFieldConfig } from '../shared/index.js';
@@ -84,6 +84,31 @@ declare abstract class BaseService<TEntity extends {
      * Also joins the socket to the entity's Socket.io room for cross-service events.
      */
     subscribe(entryId: string, socket: QuickdrawSocket, requiredLevel?: AccessLevel): Promise<TEntity | null>;
+    /**
+     * Subscribe a socket to multiple entities at once.
+     * Batches ACL checks and entity fetches for efficiency.
+     * Override `checkBatchSubscriptionAccess` and `findByIds` in derived classes
+     * for optimized batch queries (e.g., single findMany instead of N findUnique).
+     *
+     * Default implementation runs individual checks/fetches in parallel via Promise.all.
+     */
+    batchSubscribe(entryIds: string[], socket: QuickdrawSocket, requiredLevel?: AccessLevel): Promise<Record<string, TEntity | null>>;
+    /**
+     * Batch ACL check for multiple entities.
+     * Override in derived classes for efficient batch queries
+     * (e.g., one findMany + one membership check per project instead of per entity).
+     *
+     * Default: checks each entity individually in parallel.
+     */
+    protected checkBatchSubscriptionAccess(userId: string, entryIds: string[], requiredLevel: AccessLevel, socket: QuickdrawSocket): Promise<Map<string, boolean>>;
+    /**
+     * Batch entity fetch by IDs.
+     * Override in derived classes for efficient batch queries
+     * (e.g., one findMany with includes instead of N findUnique).
+     *
+     * Default: fetches each entity individually in parallel.
+     */
+    protected findByIds(ids: string[]): Promise<TEntity[]>;
     /**
      * Unsubscribe a socket from an entity's updates.
      */
@@ -228,9 +253,12 @@ declare abstract class BaseService<TEntity extends {
     /**
      * Define a public method that will be exposed via Socket.io.
      *
+     * Can be called from external helper functions to split method definitions
+     * across multiple files while keeping full type safety.
+     *
      * @typeParam K - Method name from the service methods map
      */
-    protected defineMethod<K extends keyof TServiceMethods & string>(name: K, access: AccessLevel, handler: (payload: TServiceMethods[K]["payload"], context: ServiceMethodContext) => Promise<TServiceMethods[K]["response"]>, options?: {
+    defineMethod<K extends keyof TServiceMethods & string>(name: K, access: AccessLevel, handler: (payload: TServiceMethods[K]["payload"], context: ServiceMethodContext) => Promise<TServiceMethods[K]["response"]>, options?: {
         schema?: z.ZodType<TServiceMethods[K]["payload"]>;
         resolveEntryId?: (payload: TServiceMethods[K]["payload"]) => string | null;
     }): ServiceMethodDefinition<TServiceMethods[K]["payload"], TServiceMethods[K]["response"]>;
@@ -406,6 +434,11 @@ declare class ServiceRegistry implements ServiceRegistryInstance {
      * Register subscription listener for a service.
      */
     private registerSubscriptionListener;
+    /**
+     * Register batch subscription listener for a service.
+     * Handles subscribing to multiple entities in a single event.
+     */
+    private registerBatchSubscriptionListener;
     /**
      * Register unsubscription listener for a service.
      */

package/dist/server/index.js

@@ -265,6 +265,89 @@ var BaseService = class {
     if (!entity) return null;
     return this.filterEntityForSubscriber(entity, socket, entryId);
   }
+  /**
+   * Subscribe a socket to multiple entities at once.
+   * Batches ACL checks and entity fetches for efficiency.
+   * Override `checkBatchSubscriptionAccess` and `findByIds` in derived classes
+   * for optimized batch queries (e.g., single findMany instead of N findUnique).
+   *
+   * Default implementation runs individual checks/fetches in parallel via Promise.all.
+   */
+  async batchSubscribe(entryIds, socket, requiredLevel = "Read") {
+    if (!socket.userId || entryIds.length === 0) {
+      return {};
+    }
+    const accessMap = await this.checkBatchSubscriptionAccess(
+      socket.userId,
+      entryIds,
+      requiredLevel,
+      socket
+    );
+    const allowedIds = entryIds.filter((id) => accessMap.get(id) === true);
+    const entities = allowedIds.length > 0 ? await this.findByIds(allowedIds) : [];
+    const entityMap = /* @__PURE__ */ new Map();
+    for (const entity of entities) {
+      entityMap.set(entity.id, entity);
+    }
+    const results = {};
+    for (const entryId of entryIds) {
+      const entity = entityMap.get(entryId);
+      if (!entity || !accessMap.get(entryId)) {
+        results[entryId] = null;
+        continue;
+      }
+      if (!this.subscribers.has(entryId)) {
+        this.subscribers.set(entryId, /* @__PURE__ */ new Set());
+      }
+      this.subscribers.get(entryId).add(socket);
+      const roomName = this.getRoomName(entryId);
+      void socket.join(roomName);
+      results[entryId] = this.filterEntityForSubscriber(
+        entity,
+        socket,
+        entryId
+      );
+    }
+    this.logger.debug(
+      `User ${socket.userId} batch-subscribed to ${allowedIds.length}/${entryIds.length} entities`
+    );
+    return results;
+  }
+  /**
+   * Batch ACL check for multiple entities.
+   * Override in derived classes for efficient batch queries
+   * (e.g., one findMany + one membership check per project instead of per entity).
+   *
+   * Default: checks each entity individually in parallel.
+   */
+  async checkBatchSubscriptionAccess(userId, entryIds, requiredLevel, socket) {
+    const results = /* @__PURE__ */ new Map();
+    await Promise.all(
+      entryIds.map(async (id) => {
+        const allowed = await this.checkSubscriptionAccess(
+          userId,
+          id,
+          requiredLevel,
+          socket
+        );
+        results.set(id, allowed);
+      })
+    );
+    return results;
+  }
+  /**
+   * Batch entity fetch by IDs.
+   * Override in derived classes for efficient batch queries
+   * (e.g., one findMany with includes instead of N findUnique).
+   *
+   * Default: fetches each entity individually in parallel.
+   */
+  async findByIds(ids) {
+    const results = await Promise.all(
+      ids.map((id) => this.findById(id))
+    );
+    return results.filter((e) => e !== null);
+  }
   /**
    * Unsubscribe a socket from an entity's updates.
    */
@@ -584,6 +667,9 @@ var BaseService = class {
   /**
    * Define a public method that will be exposed via Socket.io.
    *
+   * Can be called from external helper functions to split method definitions
+   * across multiple files while keeping full type safety.
+   *
    * @typeParam K - Method name from the service methods map
    */
   defineMethod(name, access, handler, options) {
@@ -1001,6 +1087,11 @@ var ServiceRegistry = class {
         `${serviceName}:subscribe`,
         service
       );
+      this.registerBatchSubscriptionListener(
+        socket,
+        `${serviceName}:batchSubscribe`,
+        service
+      );
       this.registerUnsubscriptionListener(
         socket,
         `${serviceName}:unsubscribe`,
@@ -1194,6 +1285,49 @@ var ServiceRegistry = class {
       }
     );
   }
+  /**
+   * Register batch subscription listener for a service.
+   * Handles subscribing to multiple entities in a single event.
+   */
+  registerBatchSubscriptionListener(socket, eventName, service) {
+    socket.on(
+      eventName,
+      async (payload, callback) => {
+        try {
+          if (!socket.userId) {
+            callback?.({
+              success: false,
+              error: "Authentication required",
+              code: 401
+            });
+            return;
+          }
+          if (!Array.isArray(payload.entryIds) || payload.entryIds.length === 0) {
+            callback?.({
+              success: false,
+              error: "entryIds must be a non-empty array",
+              code: 400
+            });
+            return;
+          }
+          const data = await service.batchSubscribe(
+            payload.entryIds,
+            socket,
+            payload.requiredLevel ?? "Read"
+          );
+          callback?.({ success: true, data });
+        } catch (error) {
+          this.logger.error(`Error in batch subscription ${eventName}:`, {
+            error: error instanceof Error ? error.message : "Unknown error"
+          });
+          callback?.({
+            success: false,
+            error: error instanceof Error ? error.message : "Batch subscription failed"
+          });
+        }
+      }
+    );
+  }
   /**
    * Register unsubscription listener for a service.
    */