@willyim/drizzle-audit 0.1.3 → 0.3.0

package/dist/src/compute-diff.d.ts

@@ -0,0 +1,15 @@
+export type DiffEntry = {
+    field: string;
+    old: unknown;
+    new: unknown;
+};
+export type DiffResult = {
+    operation: string;
+    changes: DiffEntry[];
+};
+export type ComputeDiffOptions = {
+    /** Fields to exclude from the diff (default: ["updated_at", "created_at"]) */
+    ignoreFields?: string[];
+};
+export declare function computeDiff(operation: string, oldData: Record<string, unknown> | null, newData: Record<string, unknown> | null, options?: ComputeDiffOptions): DiffResult;
+//# sourceMappingURL=compute-diff.d.ts.map

package/dist/src/compute-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-diff.d.ts","sourceRoot":"","sources":["../../src/compute-diff.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAQF,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,CAyBZ"}

package/dist/src/compute-diff.js

@@ -0,0 +1,22 @@
+const DEFAULT_IGNORE = ["updated_at", "created_at"];
+function deepEqual(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+export function computeDiff(operation, oldData, newData, options) {
+    const ignore = options?.ignoreFields ?? DEFAULT_IGNORE;
+    if (oldData === null && newData === null) {
+        return { operation, changes: [] };
+    }
+    const allKeys = Array.from(new Set([...Object.keys(oldData ?? {}), ...Object.keys(newData ?? {})]))
+        .filter((k) => !ignore.includes(k))
+        .sort();
+    const changes = [];
+    for (const field of allKeys) {
+        const oldVal = oldData?.[field] ?? null;
+        const newVal = newData?.[field] ?? null;
+        if (!deepEqual(oldVal, newVal)) {
+            changes.push({ field, old: oldVal, new: newVal });
+        }
+    }
+    return { operation, changes };
+}

package/dist/src/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./postgres/index.js";
 export * from "./d1/index.js";
 export * from "./d1-runtime/index.js";
+export * from "./compute-diff.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA"}

package/dist/src/index.js

@@ -1,3 +1,4 @@
 export * from "./postgres/index.js";
 export * from "./d1/index.js";
 export * from "./d1-runtime/index.js";
+export * from "./compute-diff.js";

package/dist/test/compute-diff.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compute-diff.test.d.ts.map

package/dist/test/compute-diff.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-diff.test.d.ts","sourceRoot":"","sources":["../../test/compute-diff.test.ts"],"names":[],"mappings":""}

package/dist/test/compute-diff.test.js

@@ -0,0 +1,60 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { computeDiff } from "../src/compute-diff.js";
+test("UPDATE — only changed fields are emitted", () => {
+    const result = computeDiff("UPDATE", { name: "Juan", phone: "809", status: "current" }, { name: "Juan Carlos", phone: "809", status: "current" });
+    assert.deepEqual(result, {
+        operation: "UPDATE",
+        changes: [{ field: "name", old: "Juan", new: "Juan Carlos" }],
+    });
+});
+test("UPDATE — ignores updated_at by default", () => {
+    const result = computeDiff("UPDATE", { name: "A", updated_at: "2026-01-01" }, { name: "B", updated_at: "2026-04-15" });
+    assert.deepEqual(result, {
+        operation: "UPDATE",
+        changes: [{ field: "name", old: "A", new: "B" }],
+    });
+});
+test("UPDATE — ignores created_at by default", () => {
+    const result = computeDiff("UPDATE", { name: "A", created_at: "2026-01-01" }, { name: "A", created_at: "2026-04-15" });
+    assert.deepEqual(result, { operation: "UPDATE", changes: [] });
+});
+test("INSERT — all fields with old: null", () => {
+    const result = computeDiff("INSERT", null, { name: "María", phone: "809" });
+    assert.deepEqual(result, {
+        operation: "INSERT",
+        changes: [
+            { field: "name", old: null, new: "María" },
+            { field: "phone", old: null, new: "809" },
+        ],
+    });
+});
+test("DELETE — all fields with new: null", () => {
+    const result = computeDiff("DELETE", { name: "Pedro", phone: "809" }, null);
+    assert.deepEqual(result, {
+        operation: "DELETE",
+        changes: [
+            { field: "name", old: "Pedro", new: null },
+            { field: "phone", old: "809", new: null },
+        ],
+    });
+});
+test("custom ignoreFields", () => {
+    const result = computeDiff("UPDATE", { a: 1, b: 2 }, { a: 1, b: 3 }, { ignoreFields: ["b"] });
+    assert.deepEqual(result, { operation: "UPDATE", changes: [] });
+});
+test("deep equality for nested objects", () => {
+    const result = computeDiff("UPDATE", { payload: { x: 1 } }, { payload: { x: 2 } });
+    assert.deepEqual(result, {
+        operation: "UPDATE",
+        changes: [{ field: "payload", old: { x: 1 }, new: { x: 2 } }],
+    });
+});
+test("both null — returns empty changes", () => {
+    const result = computeDiff("UPDATE", null, null);
+    assert.deepEqual(result, { operation: "UPDATE", changes: [] });
+});
+test("changes are sorted alphabetically by field", () => {
+    const result = computeDiff("UPDATE", { zebra: 1, apple: 2, mango: 3 }, { zebra: 2, apple: 3, mango: 4 });
+    assert.deepEqual(result.changes.map((c) => c.field), ["apple", "mango", "zebra"]);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@willyim/drizzle-audit",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Lightweight audit logging for Drizzle ORM using database triggers (Postgres + D1/SQLite)",
   "type": "module",
   "main": "./dist/src/index.js",