@multisystemsuite/timezone-engine-audit

Audit-safe timestamp creation and normalization for compliance, logging, and forensic trails.

What it is used for

• Store immutable audit records with UTC + source timezone metadata
• Normalize log entries from distributed services
• Healthcare, fintech, and ERP audit requirements
• Preserve original timezone context while storing UTC

Install

npm install @multisystemsuite/timezone-engine-audit

Usage

import {
  createAuditTimestamp,
  normalizeAuditLogEntry,
} from "@multisystemsuite/timezone-engine-audit";

const audit = createAuditTimestamp(new Date(), "Asia/Kolkata");
// { utc, timezone, iso, unixMs }

const entry = normalizeAuditLogEntry({
  timestamp: new Date(),
  timezone: "America/New_York",
  action: "USER_LOGIN",
  actor: "[email protected]",
});

Express API example

import { createAuditTimestamp } from "@multisystemsuite/timezone-engine-audit";

app.post("/api/action", (req, res) => {
  const audit = createAuditTimestamp(new Date(), req.timezone ?? "UTC");
  await auditLog.write({ ...audit, action: req.body.action });
  res.json({ ok: true, audit });
});

Key exports

| Export | Purpose | | -------------------------- | ------------------------- | | createAuditTimestamp() | UTC + metadata snapshot | | normalizeAuditLogEntry() | Standardize log row shape |

Related packages

• @multisystemsuite/timezone-engine-core — ensureUTCStorage()
• @multisystemsuite/timezone-engine-node — middleware timezone on req

Keywords

timezone, audit, timestamps, compliance, logging, utc

License

MIT