sinfactura-types 1.10.608 → 1.10.609

package/dist/audit.d.ts

@@ -9,6 +9,8 @@ declare global {
      */
     interface OrderAuditEntry {
         entity: 'ORDER';
+        /** Absent on older API responses; legacy rows carry status: legacy. */
+        audit?: PublicAuditMetadata;
         /** The `orderId`. */
         entityId: string;
         storeId: string;

package/dist/auditEnvelope.d.ts

@@ -0,0 +1,73 @@
+declare global {
+    type EntityAuditEntity = 'PLAN' | 'STORE' | 'PAYMENT' | 'ORDER' | 'MERCADOPAGO' | 'INVOICE' | 'SUBSCRIPTION' | 'USER' | 'CUSTOMER' | 'INTEGRATION' | 'PLATFORM';
+    /** Existing business fields with independently projected public metadata. */
+    interface EntityAuditHttpEntry {
+        entity: EntityAuditEntity;
+        entityId: string;
+        storeId?: string;
+        timestamp: number;
+        actor: OrderAuditActor;
+        action: string;
+        before: Record<string, unknown>;
+        after: Record<string, unknown>;
+        reason: string;
+        createdAt: number;
+        origin?: OrderAuditOrigin;
+        audit: PublicAuditMetadata;
+    }
+    /** Internal, forward-only metadata; independent of each event's schema_version. */
+    interface AuditEnvelopeV1 {
+        envelopeVersion: 1;
+        eventId: string;
+        surface: AuditSurface;
+        dataClass: AuditDataClass;
+        scope: {
+            kind: 'tenant';
+            tenantId: string;
+        } | {
+            kind: 'platform';
+        } | {
+            kind: 'unknown';
+        };
+        occurredAt: string;
+        recordedAt: string;
+        actor: {
+            principal: {
+                kind: 'user' | 'customer' | 'platform-user';
+                id: string;
+            } | {
+                kind: 'system' | 'anonymous' | 'unknown';
+            };
+            resolution: 'named' | 'name-unresolved' | 'system' | 'anonymous' | 'unknown';
+            /** Trusted support context only; never a public projection. */
+            support?: {
+                operatorId: string;
+                sessionId: string;
+            };
+        };
+        subject?: {
+            type: string;
+            id: string;
+        };
+        targets?: {
+            type: string;
+            id: string;
+        }[];
+        action: string;
+        correlationId?: string;
+        causationId?: string;
+    }
+    type AuditSurface = 'storefrontEvents' | 'userActivity' | 'entityAudit' | 'storeLogPartition' | 'errorPartition' | 'fiscalAudit' | 'loginHistory' | 'outboundMessageLog' | 'impersonationAudit' | 'notifyDelivery' | 'orderOutbox';
+    type AuditDataClass = 'customer-analytics' | 'operator-audit' | 'entity-diff-history' | 'legacy-mixed-log' | 'operational-error' | 'fiscal-interaction-log' | 'security-audit' | 'outbound-message-forensics' | 'privileged-access-audit' | 'notification-delivery-outcome' | 'delivery-intent';
+    /** Public metadata contains no internal attribution, references or bookkeeping. */
+    type PublicAuditMetadata = {
+        status: 'legacy';
+    } | {
+        status: 'v1';
+        envelopeVersion: 1;
+        eventId: string;
+        occurredAt: string;
+        recordedAt: string;
+    };
+}
+export {};

package/dist/auditEnvelope.js

@@ -0,0 +1 @@
+export {};

package/dist/cjs/auditEnvelope.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/index.js

@@ -28,6 +28,7 @@ __exportStar(require("./ai.js"), exports);
 __exportStar(require("./api.js"), exports);
 __exportStar(require("./appointment.js"), exports);
 __exportStar(require("./audit.js"), exports);
+__exportStar(require("./auditEnvelope.js"), exports);
 __exportStar(require("./attendance.js"), exports);
 __exportStar(require("./auth.js"), exports);
 __exportStar(require("./basket.js"), exports);

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './ai.ts';
 export * from './api.ts';
 export * from './appointment.ts';
 export * from './audit.ts';
+export * from './auditEnvelope.ts';
 export * from './attendance.ts';
 export * from './auth.ts';
 export * from './basket.ts';

package/dist/index.js

@@ -12,6 +12,7 @@ export * from "./ai.js";
 export * from "./api.js";
 export * from "./appointment.js";
 export * from "./audit.js";
+export * from "./auditEnvelope.js";
 export * from "./attendance.js";
 export * from "./auth.js";
 export * from "./basket.js";

package/dist/subscription.d.ts

@@ -247,6 +247,7 @@ declare global {
      * `before`/`after` carry only the fields that changed (diff slice).
      */
     interface PlanAuditEntry {
+        audit?: PublicAuditMetadata;
         entity: 'PLAN';
         entityId: string;
         timestamp: number;
@@ -495,6 +496,7 @@ declare global {
      * each side structurally rather than trusting every field to be present.
      */
     interface SubscriptionAuditEntry {
+        audit?: PublicAuditMetadata;
         storeId: string;
         timestamp: number;
         actor: {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "sinfactura-types",
-	"version": "1.10.608",
+	"version": "1.10.609",
 	"description": "Shared wire and entity contracts for the SINFACTURA platform.",
 	"type": "module",
 	"main": "dist/index.js",