@explita/prisma-audit-log 0.2.0 → 0.2.2

package/README.md

@@ -102,7 +102,7 @@ const prisma = new PrismaClient().$extends(
     },
 
     // Timestamp-only updates are skipped automatically, so no extra config needed
-  })
+  }),
 );
 ```
 
@@ -164,10 +164,11 @@ route.put("/test/:id", async (request, reply) => {
 | `maskValue`       | `any`                                                                                      | Value to use for masked fields (default: `[REDACTED]`)                                                           |
 | `maxStringLength` | `number`                                                                                   | Truncate long strings                                                                                            |
 | `maxArrayLength`  | `number`                                                                                   | Truncate large arrays                                                                                            |
+| `enabled`         | `boolean`                                                                                  | Enable or disable audit logging (defaults to `true`)                                                              |
 | `maxPayloadBytes` | `number`                                                                                   | Maximum JSON payload size (before truncation)                                                                    |
 | `fieldFilters`    | `{ [model: string]: { include?: string[]; exclude?: string[] } }`                          | Configure field inclusion/exclusion per model. Use `include` to whitelist fields or `exclude` to blacklist them. |
 | `skip`            | `(params: { model: string; operation: string; args: any }) => boolean \| Promise<boolean>` | Skip logging for specific operations                                                                             |
-| `logger`          | `(log: AuditLog \| AuditLog[]) => void`                                                    | Custom logger function for audit logs                                                                            |
+| `logger`          | `(log: AuditLog[]) => void \| Promise<void>`                                               | Custom logger function for audit logs                                                                            |
 
 ## License
 

package/dist/core/create.d.ts

@@ -1,2 +1,2 @@
-import type { HandlerArgs } from "../types.js";
-export declare function handleCreate(opts: HandlerArgs): Promise<any>;
+import type { AuditLog, HandlerArgs } from "../types.js";
+export declare function handleCreate(opts: HandlerArgs, action?: AuditLog["action"]): Promise<any>;

package/dist/core/create.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleCreate = handleCreate;
 const process_js_1 = require("./process.js");
-async function handleCreate(opts) {
+async function handleCreate(opts, action = "CREATE") {
     const { args, prisma, query, options, modelName } = opts;
     const result = await query(args);
     const auditLog = {
-        action: "CREATE",
+        action,
         model: modelName,
         recordId: result.id,
         newData: result,

package/dist/core/update-many.js

@@ -16,7 +16,7 @@ async function handleUpdateMany(opts) {
     const ids = currentRecords.map((row) => row.id);
     const result = await query(args);
     //updated records
-    const updatedRecords = operation == "createManyAndReturn"
+    const updatedRecords = operation == "updateManyAndReturn"
         ? result
         : await prisma[modelName].findMany({
             where: { id: { in: ids } },
@@ -28,6 +28,8 @@ async function handleUpdateMany(opts) {
         if (!updated)
             continue;
         const changedFields = (0, utils_js_1.getChangedFields)(current, updated);
+        if (changedFields.length === 0)
+            continue;
         if (changedFields.length === 1 &&
             (changedFields[0] === "updatedAt" || changedFields[0] === "updated_at")) {
             continue;

package/dist/core/update.d.ts

@@ -1,2 +1,2 @@
-import type { HandlerArgs } from "../types.js";
-export declare function handleUpdate(opts: HandlerArgs): Promise<any>;
+import type { AuditLog, HandlerArgs } from "../types.js";
+export declare function handleUpdate(opts: HandlerArgs, action?: AuditLog["action"]): Promise<any>;

package/dist/core/update.js

@@ -3,29 +3,34 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleUpdate = handleUpdate;
 const utils_js_1 = require("../lib/utils.js");
 const process_js_1 = require("./process.js");
-async function handleUpdate(opts) {
-    const { args, prisma, query, options, modelName } = opts;
-    // Get the current state before update
-    const current = await prisma[modelName].findUnique({
-        where: args["where"],
-    });
+async function handleUpdate(opts, action = "UPDATE") {
+    const { args, prisma, query, options, modelName, existingRecord } = opts;
+    // Use provided existingRecord or fetch it if not provided
+    const current = existingRecord ||
+        (await prisma[modelName].findUnique({
+            where: args["where"],
+        }));
+    if (!current) {
+        return query(args);
+    }
     const result = await query(args);
-    if (current) {
-        const changedFields = (0, utils_js_1.getChangedFields)(current, result);
-        if (changedFields.length === 1 &&
-            (changedFields[0] === "updatedAt" || changedFields[0] === "updated_at")) {
-            return result;
-        }
-        const { oldData, newData } = (0, utils_js_1.buildSnapshot)(changedFields, current, result);
-        const auditLog = {
-            action: "UPDATE",
-            model: modelName,
-            recordId: result.id,
-            oldData,
-            newData,
-            changedFields,
-        };
-        await (0, process_js_1.saveAuditLogs)(prisma, [auditLog], options);
+    const changedFields = (0, utils_js_1.getChangedFields)(current, result);
+    if (changedFields.length === 0)
+        return result;
+    // Skip if only timestamps were updated
+    if (changedFields.length === 1 &&
+        (changedFields[0] === "updatedAt" || changedFields[0] === "updated_at")) {
+        return result;
     }
+    const { oldData, newData } = (0, utils_js_1.buildSnapshot)(changedFields, current, result);
+    const auditLog = {
+        action,
+        model: modelName,
+        recordId: result.id,
+        oldData,
+        newData,
+        changedFields,
+    };
+    await (0, process_js_1.saveAuditLogs)(prisma, [auditLog], options);
     return result;
 }

package/dist/core/upsert.d.ts

@@ -0,0 +1,2 @@
+import type { HandlerArgs } from "../types.js";
+export declare function handleUpsert(opts: HandlerArgs): Promise<any>;

package/dist/core/upsert.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleUpsert = handleUpsert;
+const create_js_1 = require("./create.js");
+const update_js_1 = require("./update.js");
+async function handleUpsert(opts) {
+    const { args, prisma, modelName } = opts;
+    // Check if the record exists before performing the upsert
+    const existingRecord = await prisma[modelName].findUnique({
+        where: args["where"],
+    });
+    if (existingRecord) {
+        // Handle update case with the existing record to avoid extra query
+        // Pass a custom action to handleUpdate to indicate this is from an upsert
+        return await (0, update_js_1.handleUpdate)({
+            ...opts,
+            existingRecord,
+        }, "UPDATE_upsert");
+    }
+    else {
+        // Handle create case with custom action
+        return await (0, create_js_1.handleCreate)({
+            ...opts,
+        }, "CREATE_upsert");
+    }
+}

package/dist/lib/prisma-extension.js

@@ -9,10 +9,11 @@ const update_many_js_1 = require("../core/update-many.js");
 const delete_js_1 = require("../core/delete.js");
 const delete_many_js_1 = require("../core/delete-many.js");
 const update_js_1 = require("../core/update.js");
+const upsert_js_1 = require("../core/upsert.js");
 /**
  * Creates a Prisma extension that adds audit logging
  */
-function auditLogExtension(options = {}) {
+function auditLogExtension(options = { enabled: true }) {
     return extension_1.Prisma.defineExtension((prisma) => {
         return prisma.$extends({
             name: "auditLogExtension",
@@ -24,8 +25,8 @@ function auditLogExtension(options = {}) {
                         if (["auditLog", "AuditLog"].includes(modelName !== null && modelName !== void 0 ? modelName : "")) {
                             return query(args);
                         }
-                        // Skip if model is excluded or not included
-                        if ((0, utils_js_1.shouldSkipModel)(modelName, options)) {
+                        // Skip if model is excluded or not included or disabled
+                        if (!options.enabled || (0, utils_js_1.shouldSkipModel)(modelName, options)) {
                             return query(args);
                         }
                         // Check if the operation should be skipped via the skip callback
@@ -63,6 +64,8 @@ function auditLogExtension(options = {}) {
                             case "updateMany":
                             case "updateManyAndReturn":
                                 return (0, update_many_js_1.handleUpdateMany)(queryArgs);
+                            case "upsert":
+                                return (0, upsert_js_1.handleUpsert)(queryArgs);
                             default:
                                 return query(args);
                         }

package/dist/types.d.ts

@@ -1,5 +1,10 @@
 import type { JsArgs } from "@prisma/client/runtime/client";
 export interface AuditLogOptions {
+    /**
+     * Enable or disable audit logging
+     * @default true
+     */
+    enabled?: boolean;
     /**
      * Function to determine if audit logging should be skipped for the current operation
      * @returns true to skip logging, false or undefined to continue with logging
@@ -37,7 +42,7 @@ export interface AuditLogOptions {
      * Custom logger function
      * If not provided, logs will be written to console
      */
-    logger?: (log: AuditLog | AuditLog[]) => void | Promise<void>;
+    logger?: (log: AuditLog[]) => void | Promise<void>;
     /**
      * Keys to mask in oldData/newData/metadata. Exact match on property name.
      */
@@ -57,7 +62,7 @@ export interface AuditLogOptions {
 }
 export interface AuditLog {
     id: string;
-    action: "CREATE" | "UPDATE" | "DELETE";
+    action: "CREATE" | "UPDATE" | "DELETE" | "CREATE_upsert" | "UPDATE_upsert";
     model: string;
     recordId: string;
     oldData?: Record<string, any>;
@@ -83,7 +88,8 @@ export type HandlerArgs = {
     args: JsArgs;
     query: (args: JsArgs) => Promise<any>;
     options: AuditLogOptions;
-    operation?: string;
+    operation: string;
+    existingRecord?: any;
 };
 export type FieldFilterConfig = {
     include?: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explita/prisma-audit-log",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "A Prisma extension for automatic audit logging",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,11 +12,20 @@
   ],
   "license": "MIT",
   "author": "Explita",
+  "sideEffects": false,
   "scripts": {
     "clean": "rimraf dist",
     "build": "npm run clean && tsc",
     "prepublishOnly": "npm run build"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/explita/prisma-audit-log.git"
+  },
+  "bugs": {
+    "url": "https://github.com/explita/prisma-audit-log/issues"
+  },
+  "homepage": "https://github.com/explita/prisma-audit-log#readme",
   "peerDependencies": {
     "@prisma/client": "^7"
   },