@fitzzero/quickdraw-core 3.6.0 → 3.7.0

package/dist/shared/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shared/types.ts"],"names":[],"mappings":";AAkTO,IAAM,aAAA,GAAwB;AAAA,EACnC,IAAA,EAAM,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,IAAI,CAAA,OAAA,EAAU,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACpE,IAAA,EAAM,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,KAAK,CAAA,OAAA,EAAU,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACrE,KAAA,EAAO,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,MAAM,CAAA,QAAA,EAAW,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACxE,KAAA,EAAO,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,MAAM,CAAA,QAAA,EAAW,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACxE,OAAO,MAAM;AACf","file":"index.js","sourcesContent":["import type { z } from \"zod\";\n\n// ============================================================================\n// Access Control Types\n// ============================================================================\n\nexport type AccessLevel = \"Public\" | \"Read\" | \"Moderate\" | \"Admin\";\n\nexport type ACE = {\n  userId: string;\n  level: AccessLevel;\n};\n\nexport type ACL = ACE[];\n\n// ============================================================================\n// Entity and User Interfaces for ACL\n// ============================================================================\n\n/**\n * Interface for entities that support entry-level ACL stored as JSON.\n *\n * Use this pattern when:\n * - You want simple ACL without a separate membership table\n * - Access patterns are straightforward (read/write permissions)\n * - You don't need to query \"all entities user X can access\" efficiently\n *\n * The default `checkEntryACL` in BaseService expects entities to have this shape.\n *\n * @example\n * ```prisma\n * model Document {\n *   id    String @id @default(cuid())\n *   title String\n *   acl   Json?  // Stores ACL array\n * }\n * ```\n *\n * @example\n * ```typescript\n * class DocumentService extends BaseService<Document & ACLEntity, ...> {\n *   constructor(prisma: PrismaClient) {\n *     super({ serviceName: 'documentService', hasEntryACL: true });\n *     this.setDelegate(prisma.document);\n *     // Default checkEntryACL will work automatically\n *   }\n * }\n * ```\n */\nexport interface ACLEntity {\n  id: string;\n  acl?: ACL | null;\n}\n\n/**\n * Interface for users with service-level access control.\n *\n * The `serviceAccess` field maps service names to access levels, granting\n * blanket permissions across all entries in that service.\n *\n * @example\n * ```prisma\n * model User {\n *   id            String @id @default(cuid())\n *   serviceAccess Json?  // { \"chatService\": \"Admin\", \"documentService\": \"Read\" }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // User with Admin access to chatService can perform any operation\n * // on any chat, regardless of entry-level ACL\n * const user: QuickdrawUser = {\n *   id: \"user-123\",\n *   serviceAccess: { chatService: \"Admin\" }\n * };\n * ```\n */\nexport interface QuickdrawUser {\n  id: string;\n  serviceAccess?: Record<string, AccessLevel> | null;\n}\n\n// ============================================================================\n// Service Response Types\n// ============================================================================\n\nexport type ServiceResponse<T = unknown> =\n  | { success: true; data: T }\n  | { success: false; error: string; code?: number };\n\n// ============================================================================\n// Service Method Definition Types\n// ============================================================================\n\n/**\n * Defines the shape of a service method including its payload and response types.\n * Used to create a type-safe contract between server and client.\n */\nexport interface ServiceMethodDefinition<\n  TPayload = unknown,\n  TResponse = unknown,\n> {\n  name: string;\n  access: AccessLevel;\n  handler: (\n    payload: TPayload,\n    context: ServiceMethodContext\n  ) => Promise<TResponse>;\n  schema?: z.ZodType<TPayload>;\n  resolveEntryId?: (payload: TPayload) => string | null;\n}\n\n/**\n * Context provided to service method handlers\n */\nexport interface ServiceMethodContext {\n  userId: string | undefined;\n  socketId: string;\n  serviceAccess: Record<string, AccessLevel>;\n}\n\n/**\n * Type helper for defining service method maps.\n * Each service should define its methods using this structure.\n *\n * @example\n * ```typescript\n * type ChatServiceMethods = ServiceMethodMap<{\n *   createChat: {\n *     payload: { title: string };\n *     response: { id: string };\n *   };\n *   updateTitle: {\n *     payload: { id: string; title: string };\n *     response: { id: string; title: string };\n *   };\n * }>;\n * ```\n */\nexport type ServiceMethodMap<\n  T extends Record<string, { payload: unknown; response: unknown }>,\n> = T;\n\n// ============================================================================\n// Admin Method Types (Generic shapes for all services)\n// ============================================================================\n\nexport type AdminListPayload = {\n  page?: number;\n  pageSize?: number;\n  sort?: {\n    field?: string;\n    direction?: \"asc\" | \"desc\";\n  };\n  filter?: {\n    id?: string;\n    ids?: string[];\n    createdAfter?: string;\n    createdBefore?: string;\n    updatedAfter?: string;\n    updatedBefore?: string;\n  } & Record<string, unknown>;\n};\n\nexport type AdminListResponse<T> = {\n  rows: T[];\n  page: number;\n  pageSize: number;\n  total: number;\n};\n\nexport type AdminGetPayload = { id: string };\n\nexport type AdminCreatePayload<TInsert> = { data: Partial<TInsert> };\n\nexport type AdminUpdatePayload<TInsert> = {\n  id: string;\n  data: Partial<TInsert>;\n};\n\nexport type AdminDeletePayload = { id: string };\nexport type AdminDeleteResponse = { id: string; deleted: true };\n\nexport type AdminSetEntryACLPayload = {\n  id: string;\n  acl: ACL;\n};\n\nexport type AdminGetSubscribersPayload = { id: string };\nexport type AdminGetSubscribersResponse = {\n  id: string;\n  subscribers: Array<{ socketId: string; userId?: string }>;\n};\n\nexport type AdminReemitPayload = { id: string };\nexport type AdminReemitResponse = { emitted: boolean };\n\nexport type AdminUnsubscribeAllPayload = { id: string };\nexport type AdminUnsubscribeAllResponse = { id: string; unsubscribed: number };\n\n// ============================================================================\n// Admin Field Configuration Types\n// ============================================================================\n\n/**\n * Supported field types for admin UI generation.\n */\nexport type AdminFieldType =\n  | \"string\"\n  | \"number\"\n  | \"boolean\"\n  | \"date\"\n  | \"enum\"\n  | \"json\"\n  | \"relation\";\n\n/**\n * Configuration for a single field in the admin UI.\n * Derived from Zod schemas with optional overrides.\n */\nexport interface AdminFieldConfig {\n  /** Field name (property key on the entity) */\n  name: string;\n  /** Field type for rendering appropriate input */\n  type: AdminFieldType;\n  /** Human-readable label */\n  label: string;\n  /** Whether the field is required for creation */\n  required: boolean;\n  /** Whether the field can be edited (false for id, createdAt, etc.) */\n  editable: boolean;\n  /** Whether to show this field as a table column */\n  showInTable: boolean;\n  /** Whether the table can be sorted by this field */\n  sortable: boolean;\n  /** For enum fields, the allowed values */\n  enumValues?: string[];\n  /** For relation fields, the related service name */\n  relationService?: string;\n}\n\n/**\n * Service metadata for admin UI generation.\n * Returned by the adminMeta method.\n */\nexport interface AdminServiceMeta {\n  /** Internal service name (e.g., \"chatService\") */\n  serviceName: string;\n  /** Human-readable display name (e.g., \"Chats\") */\n  displayName: string;\n  /** Field configurations derived from schema */\n  fields: AdminFieldConfig[];\n}\n\n/**\n * Payload for adminMeta method (no parameters needed)\n */\nexport type AdminMetaPayload = Record<string, never>;\n\n/**\n * Response type for adminMeta method\n */\nexport type AdminMetaResponse = AdminServiceMeta;\n\n// ============================================================================\n// Subscription Types\n// ============================================================================\n\nexport type SubscribePayload = {\n  entryId: string;\n  requiredLevel?: AccessLevel;\n};\n\nexport type UnsubscribePayload = {\n  entryId: string;\n};\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\n/**\n * Extracts payload type from a service method definition\n */\nexport type ExtractPayload<T> = T extends { payload: infer P } ? P : never;\n\n/**\n * Extracts response type from a service method definition\n */\nexport type ExtractResponse<T> = T extends { response: infer R } ? R : never;\n\n/**\n * Logger interface compatible with Winston and other loggers\n */\nexport interface Logger {\n  info(message: string, meta?: Record<string, unknown>): void;\n  warn(message: string, meta?: Record<string, unknown>): void;\n  error(message: string, meta?: Record<string, unknown>): void;\n  debug(message: string, meta?: Record<string, unknown>): void;\n  child(options: Record<string, unknown>): Logger;\n}\n\n/**\n * Default console logger implementation\n */\nexport const consoleLogger: Logger = {\n  info: (message, meta) => console.log(`[INFO] ${message}`, meta ?? \"\"),\n  warn: (message, meta) => console.warn(`[WARN] ${message}`, meta ?? \"\"),\n  error: (message, meta) => console.error(`[ERROR] ${message}`, meta ?? \"\"),\n  debug: (message, meta) => console.debug(`[DEBUG] ${message}`, meta ?? \"\"),\n  child: () => consoleLogger,\n};\n"]}
+{"version":3,"sources":["../../src/shared/types.ts"],"names":[],"mappings":";AA0SO,IAAM,aAAA,GAAwB;AAAA,EACnC,IAAA,EAAM,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,IAAI,CAAA,OAAA,EAAU,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACpE,IAAA,EAAM,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,KAAK,CAAA,OAAA,EAAU,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACrE,KAAA,EAAO,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,MAAM,CAAA,QAAA,EAAW,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACxE,KAAA,EAAO,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,MAAM,CAAA,QAAA,EAAW,OAAO,CAAA,CAAA,EAAI,IAAA,IAAQ,EAAE,CAAA;AAAA,EACxE,OAAO,MAAM;AACf","file":"index.js","sourcesContent":["import type { z } from \"zod\";\n\n// ============================================================================\n// Access Control Types\n// ============================================================================\n\nexport type AccessLevel = \"Public\" | \"Read\" | \"Moderate\" | \"Admin\";\n\nexport type ACE = {\n  userId: string;\n  level: AccessLevel;\n};\n\nexport type ACL = ACE[];\n\n// ============================================================================\n// Entity and User Interfaces for ACL\n// ============================================================================\n\n/**\n * Interface for entities that support entry-level ACL stored as JSON.\n *\n * Use this pattern when:\n * - You want simple ACL without a separate membership table\n * - Access patterns are straightforward (read/write permissions)\n * - You don't need to query \"all entities user X can access\" efficiently\n *\n * The default `checkEntryACL` in BaseService expects entities to have this shape.\n *\n * @example\n * ```prisma\n * model Document {\n *   id    String @id @default(cuid())\n *   title String\n *   acl   Json?  // Stores ACL array\n * }\n * ```\n *\n * @example\n * ```typescript\n * class DocumentService extends BaseService<Document & ACLEntity, ...> {\n *   constructor(prisma: PrismaClient) {\n *     super({ serviceName: 'documentService', hasEntryACL: true });\n *     this.setDelegate(prisma.document);\n *     // Default checkEntryACL will work automatically\n *   }\n * }\n * ```\n */\nexport interface ACLEntity {\n  id: string;\n  acl?: ACL | null;\n}\n\n/**\n * Interface for users with service-level access control.\n *\n * The `serviceAccess` field maps service names to access levels, granting\n * blanket permissions across all entries in that service.\n *\n * @example\n * ```prisma\n * model User {\n *   id            String @id @default(cuid())\n *   serviceAccess Json?  // { \"chatService\": \"Admin\", \"documentService\": \"Read\" }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // User with Admin access to chatService can perform any operation\n * // on any chat, regardless of entry-level ACL\n * const user: QuickdrawUser = {\n *   id: \"user-123\",\n *   serviceAccess: { chatService: \"Admin\" }\n * };\n * ```\n */\nexport interface QuickdrawUser {\n  id: string;\n  serviceAccess?: Record<string, AccessLevel> | null;\n}\n\n// ============================================================================\n// Service Response Types\n// ============================================================================\n\nexport type ServiceResponse<T = unknown> =\n  | { success: true; data: T }\n  | { success: false; error: string; code?: number };\n\n// ============================================================================\n// Service Method Definition Types\n// ============================================================================\n\n/**\n * Defines the shape of a service method including its payload and response types.\n * Used to create a type-safe contract between server and client.\n */\nexport interface ServiceMethodDefinition<TPayload = unknown, TResponse = unknown> {\n  name: string;\n  access: AccessLevel;\n  handler: (payload: TPayload, context: ServiceMethodContext) => Promise<TResponse>;\n  schema?: z.ZodType<TPayload>;\n  resolveEntryId?: (payload: TPayload) => string | null;\n}\n\n/**\n * Context provided to service method handlers\n */\nexport interface ServiceMethodContext {\n  userId: string | undefined;\n  socketId: string;\n  serviceAccess: Record<string, AccessLevel>;\n}\n\n/**\n * Type helper for defining service method maps.\n * Each service should define its methods using this structure.\n *\n * @example\n * ```typescript\n * type ChatServiceMethods = ServiceMethodMap<{\n *   createChat: {\n *     payload: { title: string };\n *     response: { id: string };\n *   };\n *   updateTitle: {\n *     payload: { id: string; title: string };\n *     response: { id: string; title: string };\n *   };\n * }>;\n * ```\n */\nexport type ServiceMethodMap<T extends Record<string, { payload: unknown; response: unknown }>> = T;\n\n// ============================================================================\n// Admin Method Types (Generic shapes for all services)\n// ============================================================================\n\nexport type AdminListPayload = {\n  page?: number;\n  pageSize?: number;\n  sort?: {\n    field?: string;\n    direction?: \"asc\" | \"desc\";\n  };\n  filter?: {\n    id?: string;\n    ids?: string[];\n    createdAfter?: string;\n    createdBefore?: string;\n    updatedAfter?: string;\n    updatedBefore?: string;\n  } & Record<string, unknown>;\n};\n\nexport type AdminListResponse<T> = {\n  rows: T[];\n  page: number;\n  pageSize: number;\n  total: number;\n};\n\nexport type AdminGetPayload = { id: string };\n\nexport type AdminCreatePayload<TInsert> = { data: Partial<TInsert> };\n\nexport type AdminUpdatePayload<TInsert> = {\n  id: string;\n  data: Partial<TInsert>;\n};\n\nexport type AdminDeletePayload = { id: string };\nexport type AdminDeleteResponse = { id: string; deleted: true };\n\nexport type AdminSetEntryACLPayload = {\n  id: string;\n  acl: ACL;\n};\n\nexport type AdminGetSubscribersPayload = { id: string };\nexport type AdminGetSubscribersResponse = {\n  id: string;\n  subscribers: Array<{ socketId: string; userId?: string }>;\n};\n\nexport type AdminReemitPayload = { id: string };\nexport type AdminReemitResponse = { emitted: boolean };\n\nexport type AdminUnsubscribeAllPayload = { id: string };\nexport type AdminUnsubscribeAllResponse = { id: string; unsubscribed: number };\n\n// ============================================================================\n// Admin Field Configuration Types\n// ============================================================================\n\n/**\n * Supported field types for admin UI generation.\n */\nexport type AdminFieldType =\n  | \"string\"\n  | \"number\"\n  | \"boolean\"\n  | \"date\"\n  | \"enum\"\n  | \"json\"\n  | \"relation\";\n\n/**\n * Configuration for a single field in the admin UI.\n * Derived from Zod schemas with optional overrides.\n */\nexport interface AdminFieldConfig {\n  /** Field name (property key on the entity) */\n  name: string;\n  /** Field type for rendering appropriate input */\n  type: AdminFieldType;\n  /** Human-readable label */\n  label: string;\n  /** Whether the field is required for creation */\n  required: boolean;\n  /** Whether the field can be edited (false for id, createdAt, etc.) */\n  editable: boolean;\n  /** Whether to show this field as a table column */\n  showInTable: boolean;\n  /** Whether the table can be sorted by this field */\n  sortable: boolean;\n  /** For enum fields, the allowed values */\n  enumValues?: string[];\n  /** For relation fields, the related service name */\n  relationService?: string;\n}\n\n/**\n * Service metadata for admin UI generation.\n * Returned by the adminMeta method.\n */\nexport interface AdminServiceMeta {\n  /** Internal service name (e.g., \"chatService\") */\n  serviceName: string;\n  /** Human-readable display name (e.g., \"Chats\") */\n  displayName: string;\n  /** Field configurations derived from schema */\n  fields: AdminFieldConfig[];\n}\n\n/**\n * Payload for adminMeta method (no parameters needed)\n */\nexport type AdminMetaPayload = Record<string, never>;\n\n/**\n * Response type for adminMeta method\n */\nexport type AdminMetaResponse = AdminServiceMeta;\n\n// ============================================================================\n// Subscription Types\n// ============================================================================\n\nexport type SubscribePayload = {\n  entryId: string;\n  requiredLevel?: AccessLevel;\n};\n\nexport type UnsubscribePayload = {\n  entryId: string;\n};\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\n/**\n * Extracts payload type from a service method definition\n */\nexport type ExtractPayload<T> = T extends { payload: infer P } ? P : never;\n\n/**\n * Extracts response type from a service method definition\n */\nexport type ExtractResponse<T> = T extends { response: infer R } ? R : never;\n\n/**\n * Logger interface compatible with Winston and other loggers\n */\nexport interface Logger {\n  info(message: string, meta?: Record<string, unknown>): void;\n  warn(message: string, meta?: Record<string, unknown>): void;\n  error(message: string, meta?: Record<string, unknown>): void;\n  debug(message: string, meta?: Record<string, unknown>): void;\n  child(options: Record<string, unknown>): Logger;\n}\n\n/**\n * Default console logger implementation\n */\nexport const consoleLogger: Logger = {\n  info: (message, meta) => console.log(`[INFO] ${message}`, meta ?? \"\"),\n  warn: (message, meta) => console.warn(`[WARN] ${message}`, meta ?? \"\"),\n  error: (message, meta) => console.error(`[ERROR] ${message}`, meta ?? \"\"),\n  debug: (message, meta) => console.debug(`[DEBUG] ${message}`, meta ?? \"\"),\n  child: () => consoleLogger,\n};\n"]}

package/eslint-config/index.mjs

@@ -71,8 +71,7 @@ export const base = [
       "no-restricted-syntax": [
         "error",
         {
-          selector:
-            'TSAsExpression[typeAnnotation.typeName.name="unknown"] > TSAsExpression',
+          selector: 'TSAsExpression[typeAnnotation.typeName.name="unknown"] > TSAsExpression',
           message:
             "Avoid double `as unknown as` casts. Use proper generics, type guards, or extend the type system.",
         },

package/eslint-plugin-quickdraw/index.mjs

@@ -1,9 +1,13 @@
-import noCrossServiceMutations from "./rules/no-cross-service-mutations.mjs"
-import requireZodSchema from "./rules/require-zod-schema.mjs"
-import noServiceMethodRecord from "./rules/no-service-method-record.mjs"
-import noUnsafePayloadCast from "./rules/no-unsafe-payload-cast.mjs"
-import noRawSocketOn from "./rules/no-raw-socket-on.mjs"
-import noRawSocketEmit from "./rules/no-raw-socket-emit.mjs"
+import noCrossServiceMutations from "./rules/no-cross-service-mutations.mjs";
+import requireZodSchema from "./rules/require-zod-schema.mjs";
+import noServiceMethodRecord from "./rules/no-service-method-record.mjs";
+import noUnsafePayloadCast from "./rules/no-unsafe-payload-cast.mjs";
+import noRawSocketOn from "./rules/no-raw-socket-on.mjs";
+import noRawSocketEmit from "./rules/no-raw-socket-emit.mjs";
+import noRawServiceRoomString from "./rules/no-raw-service-room-string.mjs";
+import noRawButtonStrings from "./rules/no-raw-button-strings.mjs";
+import noRawTooltipStrings from "./rules/no-raw-tooltip-strings.mjs";
+import noRawTypographyStrings from "./rules/no-raw-typography-strings.mjs";
 
 /** @type {import('eslint').ESLint.Plugin} */
 export default {
@@ -14,5 +18,9 @@ export default {
     "no-unsafe-payload-cast": noUnsafePayloadCast,
     "no-raw-socket-on": noRawSocketOn,
     "no-raw-socket-emit": noRawSocketEmit,
+    "no-raw-service-room-string": noRawServiceRoomString,
+    "no-raw-button-strings": noRawButtonStrings,
+    "no-raw-tooltip-strings": noRawTooltipStrings,
+    "no-raw-typography-strings": noRawTypographyStrings,
   },
-}
+};

package/eslint-plugin-quickdraw/rules/no-cross-service-mutations.mjs

@@ -1,4 +1,4 @@
-const MUTATION_METHODS = new Set(["create", "update", "delete"])
+const MUTATION_METHODS = new Set(["create", "update", "delete"]);
 
 /**
  * Extract the service directory name from a file path.
@@ -6,8 +6,8 @@ const MUTATION_METHODS = new Set(["create", "update", "delete"])
  *      "/app/services/task/helpers.ts" → "task"
  */
 function getServiceDirName(filename) {
-  const match = filename.match(/services\/([^/]+)\//)
-  return match ? match[1] : null
+  const match = filename.match(/services\/([^/]+)\//);
+  return match ? match[1] : null;
 }
 
 /**
@@ -16,7 +16,7 @@ function getServiceDirName(filename) {
  * e.g. "cloud-build" → "cloudBuild", "task" → "task"
  */
 function dirNameToModelName(dirName) {
-  return dirName.replace(/[-_](\w)/g, (_, c) => c.toUpperCase())
+  return dirName.replace(/[-_](\w)/g, (_, c) => c.toUpperCase());
 }
 
 /** @type {import('eslint').Rule.RuleModule} */
@@ -56,38 +56,37 @@ export default {
     ],
   },
   create(context) {
-    const filename = context.filename || context.getFilename()
-    const serviceDirName = getServiceDirName(filename)
+    const filename = context.filename || context.getFilename();
+    const serviceDirName = getServiceDirName(filename);
 
-    if (!serviceDirName) return {}
+    if (!serviceDirName) return {};
 
-    const ownedModel = dirNameToModelName(serviceDirName)
-    const isIndexFile = filename.endsWith("/index.ts") || filename.endsWith("/index.js")
-    const options = context.options[0] || {}
-    const allowedModels = options.allowedModels || {}
-    const allowedForThisService = new Set(allowedModels[serviceDirName] || [])
+    const ownedModel = dirNameToModelName(serviceDirName);
+    const isIndexFile = filename.endsWith("/index.ts") || filename.endsWith("/index.js");
+    const options = context.options[0] || {};
+    const allowedModels = options.allowedModels || {};
+    const allowedForThisService = new Set(allowedModels[serviceDirName] || []);
 
     return {
       CallExpression(node) {
-        const callee = node.callee
-        if (callee.type !== "MemberExpression") return
-        if (callee.property.type !== "Identifier") return
+        const callee = node.callee;
+        if (callee.type !== "MemberExpression") return;
+        if (callee.property.type !== "Identifier") return;
 
-        const methodName = callee.property.name
-        if (!MUTATION_METHODS.has(methodName)) return
+        const methodName = callee.property.name;
+        if (!MUTATION_METHODS.has(methodName)) return;
 
-        const obj = callee.object
-        if (obj.type !== "MemberExpression") return
+        const obj = callee.object;
+        if (obj.type !== "MemberExpression") return;
 
-        const parentObj = obj.object
-        if (parentObj.type !== "MemberExpression") return
-        if (parentObj.property.type !== "Identifier") return
-        if (parentObj.property.name !== "prisma") return
+        const parentObj = obj.object;
+        if (parentObj.type !== "MemberExpression") return;
+        if (parentObj.property.type !== "Identifier") return;
+        if (parentObj.property.name !== "prisma") return;
 
-        if (parentObj.object.type !== "ThisExpression") return
+        if (parentObj.object.type !== "ThisExpression") return;
 
-        const modelName =
-          obj.property.type === "Identifier" ? obj.property.name : "model"
+        const modelName = obj.property.type === "Identifier" ? obj.property.name : "model";
 
         if (modelName === ownedModel) {
           if (!isIndexFile) {
@@ -95,19 +94,19 @@ export default {
               node,
               messageId: "useBaseService",
               data: { method: methodName, model: modelName },
-            })
+            });
           }
-          return
+          return;
         }
 
-        if (allowedForThisService.has(modelName)) return
+        if (allowedForThisService.has(modelName)) return;
 
         context.report({
           node,
           messageId: "crossServiceMutation",
           data: { method: methodName, model: modelName },
-        })
+        });
       },
-    }
+    };
   },
-}
+};

package/eslint-plugin-quickdraw/rules/no-direct-prisma-mutations.mjs

@@ -14,36 +14,35 @@ export default {
     schema: [],
   },
   create(context) {
-    const MUTATION_METHODS = new Set(["create", "update", "delete"])
+    const MUTATION_METHODS = new Set(["create", "update", "delete"]);
 
     return {
       CallExpression(node) {
-        const callee = node.callee
-        if (callee.type !== "MemberExpression") return
-        if (callee.property.type !== "Identifier") return
+        const callee = node.callee;
+        if (callee.type !== "MemberExpression") return;
+        if (callee.property.type !== "Identifier") return;
 
-        const methodName = callee.property.name
-        if (!MUTATION_METHODS.has(methodName)) return
+        const methodName = callee.property.name;
+        if (!MUTATION_METHODS.has(methodName)) return;
 
-        const obj = callee.object
-        if (obj.type !== "MemberExpression") return
+        const obj = callee.object;
+        if (obj.type !== "MemberExpression") return;
 
-        const parentObj = obj.object
-        if (parentObj.type !== "MemberExpression") return
-        if (parentObj.property.type !== "Identifier") return
-        if (parentObj.property.name !== "prisma") return
+        const parentObj = obj.object;
+        if (parentObj.type !== "MemberExpression") return;
+        if (parentObj.property.type !== "Identifier") return;
+        if (parentObj.property.name !== "prisma") return;
 
-        if (parentObj.object.type !== "ThisExpression") return
+        if (parentObj.object.type !== "ThisExpression") return;
 
-        const modelName =
-          obj.property.type === "Identifier" ? obj.property.name : "model"
+        const modelName = obj.property.type === "Identifier" ? obj.property.name : "model";
 
         context.report({
           node,
           messageId: "noDirectMutation",
           data: { method: methodName, model: modelName },
-        })
+        });
       },
-    }
+    };
   },
-}
+};

package/eslint-plugin-quickdraw/rules/no-raw-button-strings.mjs

@@ -0,0 +1,52 @@
+/** @type {import('eslint').Rule.RuleModule} */
+export default {
+  meta: {
+    type: "problem",
+    docs: {
+      description:
+        "Disallow raw string literals in Button components. Use useTranslations() or the <T> component for localization.",
+    },
+    messages: {
+      noRawButtonStrings:
+        "Raw string '{{content}}' in Button component should be localized. Use t('key') or <T>key</T> instead.",
+    },
+    schema: [],
+  },
+  create(context) {
+    return {
+      JSXElement(node) {
+        // Check if this is a Button element
+        if (
+          node.openingElement.name.type !== "JSXIdentifier" ||
+          node.openingElement.name.name !== "Button"
+        ) {
+          return;
+        }
+
+        // Check all children for raw strings
+        for (const child of node.children) {
+          if (child.type === "JSXText") {
+            // Flag JSXText that contains non-whitespace characters
+            const trimmedText = child.value.trim();
+            if (trimmedText.length > 0) {
+              context.report({
+                node: child,
+                messageId: "noRawButtonStrings",
+                data: { content: trimmedText },
+              });
+            }
+          } else if (child.type === "JSXExpressionContainer") {
+            // Flag JSXExpressionContainer where the expression is a string literal
+            if (child.expression.type === "Literal" && typeof child.expression.value === "string") {
+              context.report({
+                node: child,
+                messageId: "noRawButtonStrings",
+                data: { content: child.expression.value },
+              });
+            }
+          }
+        }
+      },
+    };
+  },
+};

package/eslint-plugin-quickdraw/rules/no-raw-service-room-string.mjs

@@ -0,0 +1,140 @@
+/**
+ * Bans raw template literals used as room name strings in emit/to/join calls.
+ * Use serviceRoom(), userRoom(), etc. helpers from your shared package instead.
+ *
+ * Options: { additionalPatterns: string[] } — app-specific room patterns
+ * (regex sources) checked in addition to the defaults.
+ */
+
+const DEFAULT_ROOM_PATTERNS = [/Service:\$\{/, /^user:\$\{/];
+
+/**
+ * Check if a template literal node looks like a room string.
+ */
+function isRoomTemplateLiteral(node, patterns) {
+  if (node.type !== "TemplateLiteral" || node.expressions.length === 0) {
+    return false;
+  }
+
+  // Reconstruct the raw template pattern by replacing expressions with ${...}
+  let raw = "";
+  for (let i = 0; i < node.quasis.length; i++) {
+    raw += node.quasis[i].value.raw;
+    if (i < node.expressions.length) {
+      raw += "${...}";
+    }
+  }
+
+  return patterns.some((pattern) => pattern.test(raw));
+}
+
+/**
+ * Check if a node is a call to emitToRoom, .to(), .join(), or
+ * emitConnectedUsers and return the argument index that represents the room name.
+ */
+function getRoomArgIndex(node) {
+  if (node.type !== "CallExpression") return -1;
+
+  const callee = node.callee;
+
+  // this.emitToRoom(ROOM, ...) or service.emitToRoom(ROOM, ...)
+  if (
+    callee.type === "MemberExpression" &&
+    callee.property.type === "Identifier" &&
+    callee.property.name === "emitToRoom"
+  ) {
+    return 0;
+  }
+
+  // .to(ROOM) — Socket.IO chaining
+  if (
+    callee.type === "MemberExpression" &&
+    callee.property.type === "Identifier" &&
+    callee.property.name === "to"
+  ) {
+    return 0;
+  }
+
+  // .join(ROOM) — Socket.IO room joining
+  if (
+    callee.type === "MemberExpression" &&
+    callee.property.type === "Identifier" &&
+    callee.property.name === "join"
+  ) {
+    return 0;
+  }
+
+  // this.emitConnectedUsers(entityId, ROOM)
+  if (
+    callee.type === "MemberExpression" &&
+    callee.property.type === "Identifier" &&
+    callee.property.name === "emitConnectedUsers"
+  ) {
+    return 1;
+  }
+
+  return -1;
+}
+
+/** @type {import('eslint').Rule.RuleModule} */
+export default {
+  meta: {
+    type: "problem",
+    docs: {
+      description:
+        "Disallow raw template literal room strings in emit/to/join calls. Use serviceRoom() or other room helpers from your shared package.",
+    },
+    messages: {
+      noRawRoomString:
+        "Use serviceRoom() or other room helpers from your shared package instead of raw template literals for room names.",
+    },
+    schema: [
+      {
+        type: "object",
+        properties: {
+          additionalPatterns: {
+            type: "array",
+            items: { type: "string" },
+          },
+        },
+        additionalProperties: false,
+      },
+    ],
+  },
+  create(context) {
+    const options = context.options[0] ?? {};
+    const patterns = [
+      ...DEFAULT_ROOM_PATTERNS,
+      ...(options.additionalPatterns ?? []).map((source) => new RegExp(source)),
+    ];
+
+    return {
+      CallExpression(node) {
+        const argIndex = getRoomArgIndex(node);
+        if (argIndex < 0 || !node.arguments[argIndex]) return;
+
+        const arg = node.arguments[argIndex];
+        if (isRoomTemplateLiteral(arg, patterns)) {
+          context.report({
+            node: arg,
+            messageId: "noRawRoomString",
+          });
+        }
+      },
+      // Also catch: const room = `chatService:${id}`;
+      VariableDeclarator(node) {
+        if (
+          node.id.type === "Identifier" &&
+          /room/i.test(node.id.name) &&
+          node.init &&
+          isRoomTemplateLiteral(node.init, patterns)
+        ) {
+          context.report({
+            node: node.init,
+            messageId: "noRawRoomString",
+          });
+        }
+      },
+    };
+  },
+};

package/eslint-plugin-quickdraw/rules/no-raw-socket-emit.mjs

@@ -2,12 +2,12 @@
  * Allowed event name prefixes that are exempt from this rule.
  * These are documented exceptions for protocols that don't map to BaseService.
  */
-const DEFAULT_ALLOWED_PREFIXES = ["agentRunner:", "projectRunner:"]
+const DEFAULT_ALLOWED_PREFIXES = ["agentRunner:", "projectRunner:"];
 
 /**
  * Allowed exact event names that are exempt from this rule.
  */
-const DEFAULT_ALLOWED_EVENTS = new Set(["subscribe", "unsubscribe"])
+const DEFAULT_ALLOWED_EVENTS = new Set(["subscribe", "unsubscribe"]);
 
 /** @type {import('eslint').Rule.RuleModule} */
 export default {
@@ -51,45 +51,43 @@ export default {
     ],
   },
   create(context) {
-    const options = context.options[0] || {}
-    const allowedPrefixes = options.allowedPrefixes || DEFAULT_ALLOWED_PREFIXES
-    const allowedEvents = new Set(
-      options.allowedEvents || DEFAULT_ALLOWED_EVENTS
-    )
+    const options = context.options[0] || {};
+    const allowedPrefixes = options.allowedPrefixes || DEFAULT_ALLOWED_PREFIXES;
+    const allowedEvents = new Set(options.allowedEvents || DEFAULT_ALLOWED_EVENTS);
 
     return {
       CallExpression(node) {
-        const callee = node.callee
-        if (callee.type !== "MemberExpression") return
-        if (callee.property.type !== "Identifier") return
-        if (callee.property.name !== "emit") return
+        const callee = node.callee;
+        if (callee.type !== "MemberExpression") return;
+        if (callee.property.type !== "Identifier") return;
+        if (callee.property.name !== "emit") return;
 
-        const obj = callee.object
-        if (obj.type !== "Identifier" || obj.name !== "socket") return
+        const obj = callee.object;
+        if (obj.type !== "Identifier" || obj.name !== "socket") return;
 
-        const eventArg = node.arguments[0]
-        if (!eventArg) return
+        const eventArg = node.arguments[0];
+        if (!eventArg) return;
 
         if (eventArg.type === "Literal" && typeof eventArg.value === "string") {
-          const eventName = eventArg.value
+          const eventName = eventArg.value;
 
-          if (allowedEvents.has(eventName)) return
+          if (allowedEvents.has(eventName)) return;
           if (allowedPrefixes.some((prefix) => eventName.startsWith(prefix))) {
-            return
+            return;
           }
 
           context.report({
             node,
             messageId: "noRawSocketEmit",
             data: { eventName },
-          })
+          });
         } else {
           context.report({
             node,
             messageId: "noRawSocketEmitDynamic",
-          })
+          });
         }
       },
-    }
+    };
   },
-}
+};

package/eslint-plugin-quickdraw/rules/no-raw-socket-on.mjs

@@ -2,7 +2,7 @@
  * Allowed event name prefixes that are exempt from this rule.
  * These are documented exceptions for protocols that don't map to BaseService.
  */
-const DEFAULT_ALLOWED_PREFIXES = ["agentRunner:", "projectRunner:"]
+const DEFAULT_ALLOWED_PREFIXES = ["agentRunner:", "projectRunner:"];
 
 /** @type {import('eslint').Rule.RuleModule} */
 export default {
@@ -39,41 +39,41 @@ export default {
     ],
   },
   create(context) {
-    const options = context.options[0] || {}
-    const allowedPrefixes = options.allowedPrefixes || DEFAULT_ALLOWED_PREFIXES
+    const options = context.options[0] || {};
+    const allowedPrefixes = options.allowedPrefixes || DEFAULT_ALLOWED_PREFIXES;
 
     return {
       CallExpression(node) {
-        const callee = node.callee
-        if (callee.type !== "MemberExpression") return
-        if (callee.property.type !== "Identifier") return
-        if (callee.property.name !== "on") return
+        const callee = node.callee;
+        if (callee.type !== "MemberExpression") return;
+        if (callee.property.type !== "Identifier") return;
+        if (callee.property.name !== "on") return;
 
-        const obj = callee.object
-        if (obj.type !== "Identifier" || obj.name !== "socket") return
+        const obj = callee.object;
+        if (obj.type !== "Identifier" || obj.name !== "socket") return;
 
-        const eventArg = node.arguments[0]
-        if (!eventArg) return
+        const eventArg = node.arguments[0];
+        if (!eventArg) return;
 
         if (eventArg.type === "Literal" && typeof eventArg.value === "string") {
-          const eventName = eventArg.value
+          const eventName = eventArg.value;
 
           if (allowedPrefixes.some((prefix) => eventName.startsWith(prefix))) {
-            return
+            return;
           }
 
           context.report({
             node,
             messageId: "noRawSocketOn",
             data: { eventName },
-          })
+          });
         } else {
           context.report({
             node,
             messageId: "noRawSocketOnDynamic",
-          })
+          });
         }
       },
-    }
+    };
   },
-}
+};

package/eslint-plugin-quickdraw/rules/no-raw-tooltip-strings.mjs

@@ -0,0 +1,59 @@
+/** @type {import('eslint').Rule.RuleModule} */
+export default {
+  meta: {
+    type: "problem",
+    docs: {
+      description:
+        "Disallow raw string literals in Tooltip title props. Use useTranslations() for localization.",
+    },
+    messages: {
+      noRawTooltipStrings:
+        "Raw string '{{content}}' in Tooltip title should be localized. Use t('key') instead.",
+    },
+    schema: [],
+  },
+  create(context) {
+    return {
+      JSXOpeningElement(node) {
+        if (node.name.type !== "JSXIdentifier" || node.name.name !== "Tooltip") {
+          return;
+        }
+
+        const titleAttr = node.attributes.find(
+          (a) => a.type === "JSXAttribute" && a.name.name === "title",
+        );
+        if (!titleAttr) return;
+
+        // Check for title="raw string"
+        if (
+          titleAttr.value &&
+          (titleAttr.value.type === "StringLiteral" || titleAttr.value.type === "Literal") &&
+          typeof titleAttr.value.value === "string" &&
+          titleAttr.value.value.trim().length > 0
+        ) {
+          context.report({
+            node: titleAttr,
+            messageId: "noRawTooltipStrings",
+            data: { content: titleAttr.value.value },
+          });
+        }
+
+        // Check for title={"raw string"}
+        if (
+          titleAttr.value &&
+          titleAttr.value.type === "JSXExpressionContainer" &&
+          titleAttr.value.expression &&
+          titleAttr.value.expression.type === "Literal" &&
+          typeof titleAttr.value.expression.value === "string" &&
+          titleAttr.value.expression.value.trim().length > 0
+        ) {
+          context.report({
+            node: titleAttr,
+            messageId: "noRawTooltipStrings",
+            data: { content: titleAttr.value.expression.value },
+          });
+        }
+      },
+    };
+  },
+};