@fitzzero/quickdraw-core 0.1.0 → 1.1.0

package/dist/{types-CUExGF7F.d.ts → types-BADirRXn.d.ts}

@@ -2,14 +2,6 @@ import { Socket } from 'socket.io-client';
 import { QueryClient } from '@tanstack/react-query';
 import { AccessLevel } from './shared/index.js';
 
-interface QuickdrawSocketContextValue {
-    socket: Socket | null;
-    isConnected: boolean;
-    userId: string | null;
-    serviceAccess: Record<string, AccessLevel>;
-    connect: (token?: string) => void;
-    disconnect: () => void;
-}
 interface QuickdrawProviderProps {
     children: React.ReactNode;
     /**
@@ -37,6 +29,10 @@ interface QuickdrawProviderProps {
 interface UseServiceOptions<TResponse> {
     onSuccess?: (data: TResponse) => void;
     onError?: (error: string) => void;
+    /**
+     * Request timeout in milliseconds (default: 10000)
+     */
+    timeout?: number;
     /**
      * TanStack Query mutation options
      */
@@ -105,5 +101,51 @@ type ClientServiceMethodMap<T extends Record<string, {
  * Maps service names to their entity types.
  */
 type SubscriptionDataMap<T extends Record<string, unknown>> = T;
+/**
+ * Tracks an active subscription with reference counting for deduplication.
+ */
+interface SubscriptionEntry {
+    refCount: number;
+    cleanup?: () => void;
+}
+/**
+ * Registry for tracking active subscriptions per socket instance.
+ * This prevents memory leaks and race conditions with HMR/reconnects.
+ */
+interface SubscriptionRegistry {
+    /**
+     * Get or create a subscription entry, incrementing ref count.
+     * Returns true if this is a new subscription, false if joining existing.
+     */
+    acquire: (key: string) => {
+        isNew: boolean;
+        entry: SubscriptionEntry;
+    };
+    /**
+     * Release a subscription, decrementing ref count.
+     * Returns true if subscription was fully released (ref count reached 0).
+     */
+    release: (key: string) => boolean;
+    /**
+     * Set the cleanup function for a subscription.
+     */
+    setCleanup: (key: string, cleanup: () => void) => void;
+    /**
+     * Clear all subscriptions (called on disconnect/socket change).
+     */
+    clear: () => void;
+}
+/**
+ * Extended socket context value with subscription registry.
+ */
+interface QuickdrawSocketContextValue {
+    socket: Socket | null;
+    isConnected: boolean;
+    userId: string | null;
+    serviceAccess: Record<string, AccessLevel>;
+    connect: (token?: string) => void;
+    disconnect: () => void;
+    subscriptionRegistry: SubscriptionRegistry;
+}
 
 export type { ClientServiceMethodMap as C, QuickdrawSocketContextValue as Q, SubscriptionDataMap as S, UseServiceOptions as U, QuickdrawProviderProps as a, UseServiceResult as b, UseSubscriptionOptions as c, UseSubscriptionResult as d };

package/dist/{types-OhRxDBID.d.ts → types-D7oHWh4O.d.ts}

@@ -1,6 +1,7 @@
 import { Socket, Server } from 'socket.io';
 import { Server as Server$1 } from 'http';
-import { AccessLevel, ServiceMethodDefinition, Logger } from './shared/index.js';
+import { z } from 'zod';
+import { AccessLevel, ServiceMethodDefinition, Logger, AdminFieldConfig } from './shared/index.js';
 
 /**
  * Extended Socket type with authentication properties
@@ -25,6 +26,19 @@ interface QuickdrawServerOptions {
         authenticate?: (socket: QuickdrawSocket, auth: Record<string, unknown>) => Promise<string | undefined>;
     };
     logger?: Logger;
+    /**
+     * Automatic method logging configuration.
+     * Logs all service method calls, success/failure, timing, and errors.
+     * @default { enabled: true, logPayloads: false }
+     */
+    methodLogging?: {
+        /** Enable automatic method logging. Default: true */
+        enabled?: boolean;
+        /** Log request payloads (may contain sensitive data). Default: false */
+        logPayloads?: boolean;
+        /** Log response data (may contain sensitive data). Default: false */
+        logResponses?: boolean;
+    };
 }
 interface QuickdrawServerResult {
     io: Server;
@@ -41,6 +55,8 @@ interface BaseServiceInstance {
     unsubscribeSocket: (socket: QuickdrawSocket) => void;
     ensureAccessForMethod: (requiredLevel: AccessLevel, socket: QuickdrawSocket, entryId?: string) => Promise<void>;
     getPublicMethods: () => ServiceMethodDefinition<unknown, unknown>[];
+    /** Set Socket.io server instance for room-based broadcasts */
+    setIo?: (io: Server) => void;
 }
 /**
  * Interface for ServiceRegistry instances
@@ -70,6 +86,8 @@ interface InstallAdminMethodsOptions {
         getSubscribers?: boolean;
         reemit?: boolean;
         unsubscribeAll?: boolean;
+        /** Enable adminMeta method for UI generation. Default: true if any other admin method is exposed */
+        meta?: boolean;
     };
     access: {
         list: AccessLevel;
@@ -81,7 +99,47 @@ interface InstallAdminMethodsOptions {
         getSubscribers: AccessLevel;
         reemit: AccessLevel;
         unsubscribeAll: AccessLevel;
+        /** Access level for adminMeta. Default: same as list */
+        meta?: AccessLevel;
     };
+    /** Zod schema for deriving field metadata (typically the create schema) */
+    schema?: z.ZodTypeAny;
+    /** Human-readable display name for the service (e.g., "Chats") */
+    displayName?: string;
+    /** Override which fields appear in table (by default all non-json fields) */
+    tableColumns?: string[];
+    /** Fields to hide from admin UI entirely */
+    hiddenFields?: string[];
+    /** Override specific field configurations */
+    fieldOverrides?: Partial<Record<string, Partial<AdminFieldConfig>>>;
+}
+interface AdminListPayload {
+    page?: number;
+    pageSize?: number;
+    where?: Record<string, unknown>;
+    orderBy?: Record<string, "asc" | "desc">;
+}
+interface AdminListResponse<TEntity> {
+    items: TEntity[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+}
+interface AdminSetACLPayload {
+    entryId: string;
+    acl: Array<{
+        userId: string;
+        level: AccessLevel;
+    }>;
+}
+interface AdminSubscribersResponse {
+    entryId: string;
+    subscribers: Array<{
+        socketId: string;
+        userId: string | null;
+    }>;
+    count: number;
 }
 /**
  * Generic Prisma delegate type for CRUD operations.
@@ -115,4 +173,4 @@ interface PrismaDelegate<TEntity, TCreateInput, TUpdateInput, TWhereUniqueInput
     }) => Promise<number>;
 }
 
-export type { BaseServiceInstance as B, InstallAdminMethodsOptions as I, PrismaDelegate as P, QuickdrawServerResult as Q, ServiceRegistryInstance as S, QuickdrawSocket as a, BaseServiceOptions as b, QuickdrawServerOptions as c };
+export type { AdminListPayload as A, BaseServiceInstance as B, InstallAdminMethodsOptions as I, PrismaDelegate as P, QuickdrawServerResult as Q, ServiceRegistryInstance as S, QuickdrawSocket as a, BaseServiceOptions as b, AdminListResponse as c, AdminSetACLPayload as d, AdminSubscribersResponse as e, QuickdrawServerOptions as f };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fitzzero/quickdraw-core",
-  "version": "0.1.0",
+  "version": "1.1.0",
   "description": "Fast fullstack patterns for real-time applications with Socket.io and TanStack Query",
   "type": "module",
   "main": "./dist/shared/index.js",
@@ -31,17 +31,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src --ext .ts,.tsx",
-    "lint:fix": "eslint src --ext .ts,.tsx --fix",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "prepublishOnly": "pnpm build"
-  },
   "keywords": [
     "socket.io",
     "tanstack-query",
@@ -107,5 +96,15 @@
   },
   "engines": {
     "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   }
-}
+}