fix(cache): improve unique constraint error detection

Create a database-agnostic utility function to detect unique constraint
violations across PostgreSQL, MySQL, SQLite, and SQL Server. This
improves the reliability of the cache upsert logic by properly handling
database-specific error codes and numbers.

Author: trijpstra-fourlights

server/src/services/cache.ts

@@ -6,6 +6,7 @@ import isEqual from "lodash/isEqual"
 
 import type { PopulateParams } from "./populate"
 
+import { isUniqueConstraintError } from "../utils/isUniqueConstraintError"
 import log from "../utils/log"
 import { majorMinorVersion } from "../utils/version"
 import { getConfig } from "./deep-populate/utils"
@@ -45,8 +46,8 @@ export default ({ strapi }: { strapi: Core.Strapi }) => ({
 
     try {
       return await documentService.create({ data: { hash, params, populate, dependencies: dependencies.join(",") } })
-    } catch (error) {
-      if (error?.code?.includes("UNIQUE")) {
+    } catch (error: unknown) {
+      if (isUniqueConstraintError(error)) {
         const entry = await documentService.findFirst({ filters: { hash: { $eq: hash } } })
 
         if (entry) {

server/src/utils/isUniqueConstraintError.ts

@@ -0,0 +1,29 @@
+const UniqueConstraintErrorCodes = {
+  // PostgreSQL
+  POSTGRES_UNIQUE_VIOLATION: "23505",
+
+  // MySQL
+  MYSQL_DUPLICATE_ENTRY: 1062,
+
+  // SQLite
+  SQLITE_CONSTRAINT: 19,
+  SQLITE_CONSTRAINT_UNIQUE: 2067,
+
+  // SQL Server
+  SQLSERVER_DUPLICATE_KEY: 2601,
+  SQLSERVER_UNIQUE_KEY_VIOLATION: 2627,
+} as const
+
+export const isUniqueConstraintError = (error: unknown): boolean => {
+  const err = error as { code?: string; errno?: number; number?: number }
+
+  return (
+    Object.keys(UniqueConstraintErrorCodes).includes(err.code) ||
+    err.code === UniqueConstraintErrorCodes.POSTGRES_UNIQUE_VIOLATION ||
+    err.errno === UniqueConstraintErrorCodes.MYSQL_DUPLICATE_ENTRY ||
+    err.errno === UniqueConstraintErrorCodes.SQLITE_CONSTRAINT ||
+    err.errno === UniqueConstraintErrorCodes.SQLITE_CONSTRAINT_UNIQUE ||
+    err.number === UniqueConstraintErrorCodes.SQLSERVER_DUPLICATE_KEY ||
+    err.number === UniqueConstraintErrorCodes.SQLSERVER_UNIQUE_KEY_VIOLATION
+  )
+}