Audit Trail Y.A.N.I.

1
import { z } from 'zod';
2
3
export const auditEntrySchema = z
4
  .object({
5
    id: z.string().min(1),
6
    timestamp: z.string().refine(isIso8601, { message: 'timestamp must be ISO-8601' }),
7
    actor: z.string().min(1),
8
    actionType: z.enum(AUDIT_ACTION_TYPES),
9
    tool: z.string().min(1),
10
    reason: z.string().min(1),
11
    impact: z.string().min(1),
12
    status: z.enum(AUDIT_STATUSES),
13
  })
14
  .strict();
15
16
export type AuditEntry = z.infer<typeof auditEntrySchema>;
17
18
// Champs fournis par l'appelant — id et timestamp sont derives / injectes
19
export type AuditEntryInput = Omit<AuditEntry, 'id' | 'timestamp'>;

1
import { createAuditEntry } from '@/lib/yani/audit-trail';
2
3
// Cas nominal : Y.A.N.I. lit le solde de l'utilisateur
4
const entry = createAuditEntry({
5
  actor: 'user:42',
6
  actionType: 'BALANCE_READ',
7
  tool: 'banking.getBalance',
8
  reason: "L'utilisateur a demande son solde courant",
9
  impact: 'Lecture seule du solde du wallet principal',
10
  status: 'SUCCESS',
11
});
12
13
// entry.id        — genere automatiquement (ex: aud_l8x2k_1)
14
// entry.timestamp — ISO-8601 de l'instant courant
15
// L'objet retourne est gele (Object.freeze) : immuable.

1
import { createAuditEntry } from '@/lib/yani/audit-trail';
2
3
const entry = createAuditEntry(
4
  {
5
    actor: 'user:42',
6
    actionType: 'MEMORY_WRITE',
7
    tool: 'memory.store',
8
    reason: "Persistance d'une preference utilisateur",
9
    impact: "Ajout d'une cle en memoire de session",
10
    status: 'SUCCESS',
11
  },
12
  {
13
    now: new Date('2026-06-22T10:30:00.000Z'), // horloge injectee
14
    id: 'aud_test_001',                          // identifiant fixe
15
  },
16
);
17
18
// entry.id        === 'aud_test_001'
19
// entry.timestamp === '2026-06-22T10:30:00.000Z'

1
import { createRevocationEntry } from '@/lib/yani/audit-trail';
2
3
const revocation = createRevocationEntry({
4
  ruleId: 'rule_auto_transfer_77',
5
  actor: 'user:42',
6
  reason: "L'utilisateur retire l'autorisation de virement automatique",
7
  // impact optionnel — defaut : 'rule disabled with immediate effect'
8
});
9
10
// revocation.actionType === 'RULE_REVOKED'
11
// revocation.status     === 'REVOKED_BY_USER'
12
// revocation.tool       === 'rule_auto_transfer_77'  (l'id de la regle revoquee)
13
// revocation.impact     === 'rule disabled with immediate effect'

1
import {
2
  createAuditEntry,
3
  serializeAuditTrail,
4
  type AuditEntry,
5
} from '@/lib/yani/audit-trail';
6
7
const entries: AuditEntry[] = [
8
  createAuditEntry({
9
    actor: 'user:42',
10
    actionType: 'DATA_EXPORTED',
11
    tool: 'gdpr.export',
12
    reason: "L'utilisateur exerce son droit d'acces (RGPD art. 15)",
13
    impact: 'Export complet du journal au format JSON',
14
    status: 'SUCCESS',
15
  }),
16
  // ... autres entrees
17
];
18
19
// Serialisation deterministe, triee par timestamp croissant
20
const json = serializeAuditTrail(entries);
21
// -> string JSON indentee (2 espaces), prete a etre telechargee