@wildo-ai/saas-models 1.0.1 → 1.1.0

package/dist/esm/compliance/audit-trails/audit-logs.shared.resources-config.schemas.js

@@ -2,9 +2,10 @@ import { z } from 'zod';
 import { AuditEventCategory, AuditEventSeverity, AuditableEvent_BaseSchema } from './auditable-events.shared.schema.js';
 import { createResourceConfiguration_Initialization } from '../../resources/resources-config.shared.factory.js';
 import { CoreResourceOperation, CoreResourceType, coreResourceShared_FieldIdentifier } from '../../resources/resources.shared.core.definitions.js';
-import { ResourceOperationRiskLevel, ResourceOperationVariantType, ResourceOperation_CustomServiceImplementationMode, DefaultActionResponseSchema, } from '../../resources/resources.shared.schemas.js';
+import { ResourceOperationRiskLevel, ResourceOperationVariantType, ResourceOperation_CustomServiceImplementationMode, } from '../../resources/resources.shared.schemas.js';
 import { CORE_APP_ROLES, CORE_ORG_ROLES } from '../../security/authorizations/roles.shared.schemas.js';
 import { Resouces_Filter_DateRangeSchema } from '../../resources/resources-config.shared.schemas.js';
+import { ResourceSystemAccessMode } from '../../resources/resources-config.shared.schemas.js';
 // ── Custom Operations ────────────────────────────────────────────────
 export var AuditLogs_Operations;
 (function (AuditLogs_Operations) {
@@ -12,15 +13,47 @@ export var AuditLogs_Operations;
 })(AuditLogs_Operations || (AuditLogs_Operations = {}));
 // ── Export Request DTO ────────────────────────────────────────────────
 export const AuditLogs_ExportRequestDto = z.object({
-    format: z.enum(['json', 'csv']).default('json'),
     eventType: z.string().optional(),
     eventCategory: z.enum(AuditEventCategory).optional(),
     severity: z.enum(AuditEventSeverity).optional(),
     userId: z.string().optional(),
-    organizationId: z.string().optional(),
     createdAt: Resouces_Filter_DateRangeSchema.optional(),
-    maxRecords: z.number().min(1).max(10_000).default(1000),
-});
+    // This is a bounded, synchronous API response, not an archive job. Keep its
+    // ceiling aligned with the resource LIST operation so callers cannot request
+    // a window that the repository will silently truncate.
+    // Input stays optional and the backend applies 100 when omitted. Record the
+    // default as metadata rather than a Zod output default, which would falsely
+    // make the request field required in JSON Schema.
+    maxRecords: z.number().int().min(1).max(100).optional().meta({ default: 100 }),
+}).strict();
+/**
+ * The named runtime source for the audit-log export-format vocabulary.
+ *
+ * Single-member on purpose, and deliberately NOT `ResourceCollectionExportFormat` (which also
+ * carries `JSON`): that enum governs listing/collection exports with their CSV option and
+ * content-type/extension tables, while this one names what the SYNCHRONOUS audit-log export
+ * operation can return — a JSON window in the HTTP 200 response, nothing else. Merging them
+ * because the wire value overlaps would silently grant this operation every format the
+ * collection-export vocabulary ever gains. A future archival/export delivery mechanism must
+ * introduce its own request and response contract (and its own members here) rather than
+ * extending this one implicitly.
+ */
+export var AuditLogs_ExportFormat;
+(function (AuditLogs_ExportFormat) {
+    AuditLogs_ExportFormat["JSON"] = "json";
+})(AuditLogs_ExportFormat || (AuditLogs_ExportFormat = {}));
+/**
+ * The complete synchronous audit-log export payload.
+ *
+ * There is deliberately no CSV option, download URL, or asynchronous job
+ * handle here — see {@link AuditLogs_ExportFormat} for why the format
+ * vocabulary is closed at JSON.
+ */
+export const AuditLogs_ExportResponseDto = z.object({
+    records: z.array(AuditableEvent_BaseSchema),
+    format: z.literal(AuditLogs_ExportFormat.JSON),
+    totalCount: z.number().int().nonnegative(),
+}).strict();
 // ── Filter/Sort Schemas for SEARCH operation ────────────────────────────
 const auditLogsFilterEventCategorySchema = z.enum(AuditEventCategory);
 const auditLogsFilterSeveritySchema = z.enum(AuditEventSeverity);
@@ -28,7 +61,7 @@ const auditLogsFilterSeveritySchema = z.enum(AuditEventSeverity);
  * Audit Logs Resource Configuration
  * - REPOSITORY_ONLY CREATE for internal writes
  * - API_CALL READ/LIST for org members and app admins (enables frontend routes)
- * - EXPORT_AUDIT_LOGS custom operation for streaming export
+ * - EXPORT_AUDIT_LOGS custom operation for bounded synchronous JSON retrieval
  */
 export const auditLogsResourceConfiguration_InitializationFactory = (resourcesRelationships) => createResourceConfiguration_Initialization({
     mainSchema: AuditableEvent_BaseSchema,
@@ -37,6 +70,8 @@ export const auditLogsResourceConfiguration_InitializationFactory = (resourcesRe
     resourceRelationships: resourcesRelationships,
     isSystemResource: true,
     customOperation: AuditLogs_Operations,
+    /** Subject-export disclosure. Security/operational record rather than the subject's own data — disclosing the monitoring trail to its subject is self-defeating, and it is already out of Art. 20 scope. A curated sign-in summary, if ever wanted, is a different surface. */
+    systemAccessPolicy: { exportSubject: ResourceSystemAccessMode.FORBIDDEN },
     coreOperations: [
         CoreResourceOperation.READ,
         CoreResourceOperation.LIST,
@@ -74,9 +109,32 @@ export const auditLogsResourceConfiguration_InitializationFactory = (resourcesRe
                         severity: auditLogsFilterSeveritySchema,
                         userId: z.string(),
                         organizationId: z.string(),
+                        applicationId: z.string(),
+                        correlationId: z.string(),
+                        // Filterable so an investigator can pull every action from one browser/device install —
+                        // the cross-session/cross-login question. Only ever populated for applications that
+                        // opted into `compliance.clientInstanceIdScope`; for every other app the filter matches nothing.
+                        clientInstanceId: z.string(),
                         createdAt: z.date(),
                     },
-                    sortFields: ['createdAt', 'severity', 'eventType'],
+                    // DECLARED rather than inherited, and equal to the SEARCH sibling below.
+                    //
+                    // The value matches the framework default, so it changes nothing today — it is written
+                    // down because the audit export uses the same maximum. Keeping the
+                    // request DTO and this resource operation at 100 makes the contract
+                    // explicit instead of allowing the repository to silently truncate a
+                    // larger client request.
+                    maxPaginatedResultPerPageLimit: 100,
+                    // `eventId` is LAST on purpose. Sort priority follows key order and the repository
+                    // falls back to the FIRST configured field, so `createdAt` must stay in front to keep
+                    // the existing newest-first default intact. `eventId` exists here as the KEYSET
+                    // TIE-BREAKER the immudb audit-reconcile batch pages on: `createdAt` is not unique
+                    // (boot/seed bursts write hundreds of rows in one millisecond), and without a unique
+                    // secondary sort that batch cannot address a position inside a burst — it previously
+                    // stepped over the remainder and skipped those records permanently. Removing `eventId`
+                    // silently reintroduces that data-loss path, because a non-empty whitelist makes the
+                    // repository DROP any unlisted sort key rather than fail.
+                    sortFields: ['createdAt', 'severity', 'eventType', 'eventId'],
                 },
                 {
                     variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
@@ -100,6 +158,12 @@ export const auditLogsResourceConfiguration_InitializationFactory = (resourcesRe
                         severity: auditLogsFilterSeveritySchema,
                         userId: z.string(),
                         organizationId: z.string(),
+                        applicationId: z.string(),
+                        correlationId: z.string(),
+                        // Filterable so an investigator can pull every action from one browser/device install —
+                        // the cross-session/cross-login question. Only ever populated for applications that
+                        // opted into `compliance.clientInstanceIdScope`; for every other app the filter matches nothing.
+                        clientInstanceId: z.string(),
                         createdAt: z.date(),
                     },
                     sortFields: ['createdAt', 'severity', 'eventType'],
@@ -122,12 +186,15 @@ export const auditLogsResourceConfiguration_InitializationFactory = (resourcesRe
                     isDefault: true,
                     roles: [CORE_ORG_ROLES.ORG_ADMIN, CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
                     riskLevel: ResourceOperationRiskLevel.MEDIUM,
-                    resourceOperationLike: CoreResourceOperation.UPDATE,
+                    // Export filters a tenant-scoped collection. CREATE supplies the
+                    // collection POST route shape without pretending that one audit row is
+                    // being updated or requiring a meaningless `auditLogId` path value.
+                    resourceOperationLike: CoreResourceOperation.CREATE,
                     requestDto: AuditLogs_ExportRequestDto,
-                    customResponseDto: DefaultActionResponseSchema,
+                    customResponseDto: AuditLogs_ExportResponseDto,
                     customServiceImplementationModes: [ResourceOperation_CustomServiceImplementationMode.REPLACE_CORE_OPERARTIONS],
                 }],
         },
     },
 });
-//# sourceMappingURL=audit-logs.shared.resources-config.schemas.js.map
+//# sourceMappingURL=audit-logs.shared.resources-config.schemas.js.map

package/dist/esm/compliance/audit-trails/audit-logs.shared.resources-config.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit-logs.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../src/compliance/audit-trails/audit-logs.shared.resources-config.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"audit-logs.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/audit-logs.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { AuditEventCategory, AuditEventSeverity, AuditableEvent_BaseSchema } from './auditable-events.shared.schema';\nimport { createResourceConfiguration_Initialization } from '../../resources/resources-config.shared.factory';\nimport { CoreResourceOperation, CoreResourceType, coreResourceShared_FieldIdentifier } from '../../resources/resources.shared.core.definitions';\nimport {\n  ResourceOperationRiskLevel,\n  ResourceOperationVariantType,\n  ResourceRelationship,\n  ResourceOperation_CustomServiceImplementationMode,\n} from '../../resources/resources.shared.schemas';\nimport { CORE_APP_ROLES, CORE_ORG_ROLES } from '../../security/authorizations/roles.shared.schemas';\nimport { Resouces_Filter_DateRangeSchema } from '../../resources/resources-config.shared.schemas';\nimport { ResourceSystemAccessMode } from '../../resources/resources-config.shared.schemas';\n\n// ── Custom Operations ────────────────────────────────────────────────\n\nexport enum AuditLogs_Operations {\n  EXPORT_AUDIT_LOGS = 'exportAuditLogs',\n}\n\n// ── Export Request DTO ────────────────────────────────────────────────\n\nexport const AuditLogs_ExportRequestDto = z.object({\n  eventType: z.string().optional(),\n  eventCategory: z.enum(AuditEventCategory).optional(),\n  severity: z.enum(AuditEventSeverity).optional(),\n  userId: z.string().optional(),\n  createdAt: Resouces_Filter_DateRangeSchema.optional(),\n  // This is a bounded, synchronous API response, not an archive job. Keep its\n  // ceiling aligned with the resource LIST operation so callers cannot request\n  // a window that the repository will silently truncate.\n  // Input stays optional and the backend applies 100 when omitted. Record the\n  // default as metadata rather than a Zod output default, which would falsely\n  // make the request field required in JSON Schema.\n  maxRecords: z.number().int().min(1).max(100).optional().meta({ default: 100 }),\n}).strict();\n\nexport type AuditLogs_ExportRequestDtoType = z.infer<typeof AuditLogs_ExportRequestDto>;\n\n/**\n * The named runtime source for the audit-log export-format vocabulary.\n *\n * Single-member on purpose, and deliberately NOT `ResourceCollectionExportFormat` (which also\n * carries `JSON`): that enum governs listing/collection exports with their CSV option and\n * content-type/extension tables, while this one names what the SYNCHRONOUS audit-log export\n * operation can return — a JSON window in the HTTP 200 response, nothing else. Merging them\n * because the wire value overlaps would silently grant this operation every format the\n * collection-export vocabulary ever gains. A future archival/export delivery mechanism must\n * introduce its own request and response contract (and its own members here) rather than\n * extending this one implicitly.\n */\nexport enum AuditLogs_ExportFormat {\n  JSON = 'json',\n}\n\n/**\n * The complete synchronous audit-log export payload.\n *\n * There is deliberately no CSV option, download URL, or asynchronous job\n * handle here — see {@link AuditLogs_ExportFormat} for why the format\n * vocabulary is closed at JSON.\n */\nexport const AuditLogs_ExportResponseDto = z.object({\n  records: z.array(AuditableEvent_BaseSchema),\n  format: z.literal(AuditLogs_ExportFormat.JSON),\n  totalCount: z.number().int().nonnegative(),\n}).strict();\n\nexport type AuditLogs_ExportResponseDtoType = z.infer<typeof AuditLogs_ExportResponseDto>;\n\n// ── Filter/Sort Schemas for SEARCH operation ────────────────────────────\n\nconst auditLogsFilterEventCategorySchema = z.enum(AuditEventCategory);\nconst auditLogsFilterSeveritySchema = z.enum(AuditEventSeverity);\n\n/**\n * Audit Logs Resource Configuration\n * - REPOSITORY_ONLY CREATE for internal writes\n * - API_CALL READ/LIST for org members and app admins (enables frontend routes)\n * - EXPORT_AUDIT_LOGS custom operation for bounded synchronous JSON retrieval\n */\nexport const auditLogsResourceConfiguration_InitializationFactory = (\n  resourcesRelationships: ResourceRelationship[]\n) => createResourceConfiguration_Initialization<\n  typeof AuditLogs_Operations,\n  CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.SEARCH | CoreResourceOperation.CREATE,\n  typeof AuditableEvent_BaseSchema\n>({\n  mainSchema: AuditableEvent_BaseSchema,\n  resourceIdentifier: CoreResourceType.AUDIT_LOGS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.AUDIT_LOGS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  customOperation: AuditLogs_Operations,\n  /** Subject-export disclosure. Security/operational record rather than the subject's own data — disclosing the monitoring trail to its subject is self-defeating, and it is already out of Art. 20 scope. A curated sign-in summary, if ever wanted, is a different surface. */\n  systemAccessPolicy: { exportSubject: ResourceSystemAccessMode.FORBIDDEN },\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.SEARCH,\n    CoreResourceOperation.CREATE,\n    // Note: No UPDATE or DELETE - audit logs are immutable\n  ],\n  operationsConfiguration: {\n    [CoreResourceOperation.READ]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER, CORE_ORG_ROLES.ORG_ADMIN, CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        },\n        {\n          variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n          isDefault: false,\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        },\n      ],\n    },\n    [CoreResourceOperation.LIST]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER, CORE_ORG_ROLES.ORG_ADMIN, CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n          filterFields: {\n            eventType: z.string(),\n            eventCategory: auditLogsFilterEventCategorySchema,\n            severity: auditLogsFilterSeveritySchema,\n            userId: z.string(),\n            organizationId: z.string(),\n            applicationId: z.string(),\n            correlationId: z.string(),\n            // Filterable so an investigator can pull every action from one browser/device install —\n            // the cross-session/cross-login question. Only ever populated for applications that\n            // opted into `compliance.clientInstanceIdScope`; for every other app the filter matches nothing.\n            clientInstanceId: z.string(),\n            createdAt: z.date(),\n          },\n          // DECLARED rather than inherited, and equal to the SEARCH sibling below.\n          //\n          // The value matches the framework default, so it changes nothing today — it is written\n          // down because the audit export uses the same maximum. Keeping the\n          // request DTO and this resource operation at 100 makes the contract\n          // explicit instead of allowing the repository to silently truncate a\n          // larger client request.\n          maxPaginatedResultPerPageLimit: 100,\n          // `eventId` is LAST on purpose. Sort priority follows key order and the repository\n          // falls back to the FIRST configured field, so `createdAt` must stay in front to keep\n          // the existing newest-first default intact. `eventId` exists here as the KEYSET\n          // TIE-BREAKER the immudb audit-reconcile batch pages on: `createdAt` is not unique\n          // (boot/seed bursts write hundreds of rows in one millisecond), and without a unique\n          // secondary sort that batch cannot address a position inside a burst — it previously\n          // stepped over the remainder and skipped those records permanently. Removing `eventId`\n          // silently reintroduces that data-loss path, because a non-empty whitelist makes the\n          // repository DROP any unlisted sort key rather than fail.\n          sortFields: ['createdAt', 'severity', 'eventType', 'eventId'] as const,\n        },\n        {\n          variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n          isDefault: false,\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        },\n      ],\n    },\n\n    [CoreResourceOperation.SEARCH]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_MEMBER, CORE_ORG_ROLES.ORG_ADMIN, CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n        isSearchable: false,\n        searchableFields: [],\n        filterFields: {\n          eventType: z.string(),\n          eventCategory: auditLogsFilterEventCategorySchema,\n          severity: auditLogsFilterSeveritySchema,\n          userId: z.string(),\n          organizationId: z.string(),\n          applicationId: z.string(),\n          correlationId: z.string(),\n          // Filterable so an investigator can pull every action from one browser/device install —\n          // the cross-session/cross-login question. Only ever populated for applications that\n          // opted into `compliance.clientInstanceIdScope`; for every other app the filter matches nothing.\n          clientInstanceId: z.string(),\n          createdAt: z.date(),\n        },\n        sortFields: ['createdAt', 'severity', 'eventType'] as const,\n        maxPaginatedResultPerPageLimit: 100,\n      }],\n    },\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        },\n      ],\n    },\n    [AuditLogs_Operations.EXPORT_AUDIT_LOGS]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_ADMIN, CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        // Export filters a tenant-scoped collection. CREATE supplies the\n        // collection POST route shape without pretending that one audit row is\n        // being updated or requiring a meaningless `auditLogId` path value.\n        resourceOperationLike: CoreResourceOperation.CREATE,\n        requestDto: AuditLogs_ExportRequestDto,\n        customResponseDto: AuditLogs_ExportResponseDto,\n        customServiceImplementationModes: [ResourceOperation_CustomServiceImplementationMode.REPLACE_CORE_OPERARTIONS],\n      }],\n    },\n  },\n});\n"]}

package/dist/esm/compliance/audit-trails/audit-trail-config.shared.schemas.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+/**
+ * `AuditTrailConfig` — application-level operator-tunable configuration for the
+ * compliance audit-trail subsystem.
+ *
+ * Phase 5 / F1 (audit-logging plan). Mirrors {@link DataSeedingConfigSchema} /
+ * {@link LifecycleConfigSchema} in shape and intent: a small, OPTIONAL block on
+ * the shared application configuration ({@link AppConfiguration_Shared_Schema})
+ * that tunes an engine-owned background batch — here the
+ * `compliance:audit-logs-archive` cron batch — without forking the factory's
+ * built-in defaults.
+ *
+ * --------------------------------------------------------------------------
+ * Archival, NOT deletion — audit logs are immutable
+ * --------------------------------------------------------------------------
+ * The `AUDIT_LOGS` resource is IMMUTABLE by invariant (G5): its
+ * `coreOperations` are `READ | LIST | SEARCH | CREATE` — there is NO `UPDATE`
+ * and NO `DELETE`. The retention mechanism therefore NEVER removes audit
+ * records from the primary store. Instead, records older than
+ * {@link archiveAfterDays} are EXPORTED (copied) to durable off-DB archival
+ * artifacts in file storage by the archival batch, while the original rows
+ * remain in the always-on `AUDIT_LOGS` store (and, when configured, in the
+ * append-only immudb tamper-proof ledger). This is why the field is named
+ * `archiveAfterDays` and not `retentionDays`: nothing is retained-then-deleted;
+ * the value is purely the ARCHIVAL HORIZON. (The distinction mirrors the
+ * `archiveAfterDays` vs `retentionDays` split in the general
+ * `DataRetentionPolicySchema`.)
+ *
+ * --------------------------------------------------------------------------
+ * Why the config lives in `saas-models` (not next to the batch)
+ * --------------------------------------------------------------------------
+ * The runtime wiring (`StartApplicationBackendService.initialize`) and the
+ * batch body read operator-tunable configuration EXCLUSIVELY from
+ * `appConfigService.config?.*` — i.e. the {@link AppConfiguration_Shared_Schema}
+ * aggregate. Placing the schema here (rather than in `saas-backend-lib` next to
+ * the batch) keeps every operator-tunable engine batch symmetric with
+ * `dataSeeding` / `lifecycle` and gives one source of truth the batch factory
+ * and the startup validator can both import (`saas-models` cannot depend on
+ * `saas-backend-lib` — the dependency arrow points the other way).
+ *
+ * --------------------------------------------------------------------------
+ * Bounds + production floor
+ * --------------------------------------------------------------------------
+ * {@link archiveAfterDays} bounds mirror the SSO `auditConfig.retentionDays`
+ * precedent (min 1 day, max 2555 ≈ 7 years). A stricter PRODUCTION FLOOR (365
+ * days) is enforced at boot by
+ * `ApplicationStartupConfigValidatorService.validate()` — NOT by a schema-level
+ * `.min()` and NOT by a Zod `.superRefine()`, because the environment
+ * (development vs staging/production) is a RUNTIME signal
+ * (`process.env.APPLICATION_ENV`) that a pure, environment-agnostic shared
+ * schema must not read. The schema `.min(1)` is the absolute floor; the runtime
+ * validator raises it to 365 outside development.
+ */
+export declare const AuditTrailConfigSchema: z.ZodObject<{
+    archiveAfterDays: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type AuditTrailConfig = z.infer<typeof AuditTrailConfigSchema>;
+//# sourceMappingURL=audit-trail-config.shared.schemas.d.ts.map

package/dist/esm/compliance/audit-trails/audit-trail-config.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-trail-config.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/audit-trail-config.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,eAAO,MAAM,sBAAsB;;iBAmBjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/esm/compliance/audit-trails/audit-trail-config.shared.schemas.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+/**
+ * `AuditTrailConfig` — application-level operator-tunable configuration for the
+ * compliance audit-trail subsystem.
+ *
+ * Phase 5 / F1 (audit-logging plan). Mirrors {@link DataSeedingConfigSchema} /
+ * {@link LifecycleConfigSchema} in shape and intent: a small, OPTIONAL block on
+ * the shared application configuration ({@link AppConfiguration_Shared_Schema})
+ * that tunes an engine-owned background batch — here the
+ * `compliance:audit-logs-archive` cron batch — without forking the factory's
+ * built-in defaults.
+ *
+ * --------------------------------------------------------------------------
+ * Archival, NOT deletion — audit logs are immutable
+ * --------------------------------------------------------------------------
+ * The `AUDIT_LOGS` resource is IMMUTABLE by invariant (G5): its
+ * `coreOperations` are `READ | LIST | SEARCH | CREATE` — there is NO `UPDATE`
+ * and NO `DELETE`. The retention mechanism therefore NEVER removes audit
+ * records from the primary store. Instead, records older than
+ * {@link archiveAfterDays} are EXPORTED (copied) to durable off-DB archival
+ * artifacts in file storage by the archival batch, while the original rows
+ * remain in the always-on `AUDIT_LOGS` store (and, when configured, in the
+ * append-only immudb tamper-proof ledger). This is why the field is named
+ * `archiveAfterDays` and not `retentionDays`: nothing is retained-then-deleted;
+ * the value is purely the ARCHIVAL HORIZON. (The distinction mirrors the
+ * `archiveAfterDays` vs `retentionDays` split in the general
+ * `DataRetentionPolicySchema`.)
+ *
+ * --------------------------------------------------------------------------
+ * Why the config lives in `saas-models` (not next to the batch)
+ * --------------------------------------------------------------------------
+ * The runtime wiring (`StartApplicationBackendService.initialize`) and the
+ * batch body read operator-tunable configuration EXCLUSIVELY from
+ * `appConfigService.config?.*` — i.e. the {@link AppConfiguration_Shared_Schema}
+ * aggregate. Placing the schema here (rather than in `saas-backend-lib` next to
+ * the batch) keeps every operator-tunable engine batch symmetric with
+ * `dataSeeding` / `lifecycle` and gives one source of truth the batch factory
+ * and the startup validator can both import (`saas-models` cannot depend on
+ * `saas-backend-lib` — the dependency arrow points the other way).
+ *
+ * --------------------------------------------------------------------------
+ * Bounds + production floor
+ * --------------------------------------------------------------------------
+ * {@link archiveAfterDays} bounds mirror the SSO `auditConfig.retentionDays`
+ * precedent (min 1 day, max 2555 ≈ 7 years). A stricter PRODUCTION FLOOR (365
+ * days) is enforced at boot by
+ * `ApplicationStartupConfigValidatorService.validate()` — NOT by a schema-level
+ * `.min()` and NOT by a Zod `.superRefine()`, because the environment
+ * (development vs staging/production) is a RUNTIME signal
+ * (`process.env.APPLICATION_ENV`) that a pure, environment-agnostic shared
+ * schema must not read. The schema `.min(1)` is the absolute floor; the runtime
+ * validator raises it to 365 outside development.
+ */
+export const AuditTrailConfigSchema = z.object({
+    /**
+     * Age (in days) beyond which audit records are EXPORTED to durable archival
+     * file-storage artifacts by the `compliance:audit-logs-archive` cron batch.
+     *
+     * Records are NEVER deleted from the primary `AUDIT_LOGS` store — this is the
+     * archival horizon only (see the block-level JSDoc on why the field is
+     * `archiveAfterDays`, not `retentionDays`).
+     *
+     * OPTIONAL — when omitted (`undefined`), NO archival runs and audit records
+     * are retained in the primary store indefinitely. This is the compliance-safe
+     * default: an operator must explicitly opt in before any archival happens.
+     *
+     * Bounds: min 1 / max 2555 (≈ 7 years), mirroring the SSO
+     * `auditConfig.retentionDays` precedent. A production floor of 365 days is
+     * enforced at boot (see block-level JSDoc) — setting a value below 365 in a
+     * staging/production environment fails startup with a CONFIGURATION error.
+     */
+    archiveAfterDays: z.number().int().min(1).max(2555).optional(),
+});
+//# sourceMappingURL=audit-trail-config.shared.schemas.js.map

package/dist/esm/compliance/audit-trails/audit-trail-config.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-trail-config.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/audit-trail-config.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C;;;;;;;;;;;;;;;;OAgBG;IACH,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\n\n/**\n * `AuditTrailConfig` — application-level operator-tunable configuration for the\n * compliance audit-trail subsystem.\n *\n * Phase 5 / F1 (audit-logging plan). Mirrors {@link DataSeedingConfigSchema} /\n * {@link LifecycleConfigSchema} in shape and intent: a small, OPTIONAL block on\n * the shared application configuration ({@link AppConfiguration_Shared_Schema})\n * that tunes an engine-owned background batch — here the\n * `compliance:audit-logs-archive` cron batch — without forking the factory's\n * built-in defaults.\n *\n * --------------------------------------------------------------------------\n * Archival, NOT deletion — audit logs are immutable\n * --------------------------------------------------------------------------\n * The `AUDIT_LOGS` resource is IMMUTABLE by invariant (G5): its\n * `coreOperations` are `READ | LIST | SEARCH | CREATE` — there is NO `UPDATE`\n * and NO `DELETE`. The retention mechanism therefore NEVER removes audit\n * records from the primary store. Instead, records older than\n * {@link archiveAfterDays} are EXPORTED (copied) to durable off-DB archival\n * artifacts in file storage by the archival batch, while the original rows\n * remain in the always-on `AUDIT_LOGS` store (and, when configured, in the\n * append-only immudb tamper-proof ledger). This is why the field is named\n * `archiveAfterDays` and not `retentionDays`: nothing is retained-then-deleted;\n * the value is purely the ARCHIVAL HORIZON. (The distinction mirrors the\n * `archiveAfterDays` vs `retentionDays` split in the general\n * `DataRetentionPolicySchema`.)\n *\n * --------------------------------------------------------------------------\n * Why the config lives in `saas-models` (not next to the batch)\n * --------------------------------------------------------------------------\n * The runtime wiring (`StartApplicationBackendService.initialize`) and the\n * batch body read operator-tunable configuration EXCLUSIVELY from\n * `appConfigService.config?.*` — i.e. the {@link AppConfiguration_Shared_Schema}\n * aggregate. Placing the schema here (rather than in `saas-backend-lib` next to\n * the batch) keeps every operator-tunable engine batch symmetric with\n * `dataSeeding` / `lifecycle` and gives one source of truth the batch factory\n * and the startup validator can both import (`saas-models` cannot depend on\n * `saas-backend-lib` — the dependency arrow points the other way).\n *\n * --------------------------------------------------------------------------\n * Bounds + production floor\n * --------------------------------------------------------------------------\n * {@link archiveAfterDays} bounds mirror the SSO `auditConfig.retentionDays`\n * precedent (min 1 day, max 2555 ≈ 7 years). A stricter PRODUCTION FLOOR (365\n * days) is enforced at boot by\n * `ApplicationStartupConfigValidatorService.validate()` — NOT by a schema-level\n * `.min()` and NOT by a Zod `.superRefine()`, because the environment\n * (development vs staging/production) is a RUNTIME signal\n * (`process.env.APPLICATION_ENV`) that a pure, environment-agnostic shared\n * schema must not read. The schema `.min(1)` is the absolute floor; the runtime\n * validator raises it to 365 outside development.\n */\nexport const AuditTrailConfigSchema = z.object({\n  /**\n   * Age (in days) beyond which audit records are EXPORTED to durable archival\n   * file-storage artifacts by the `compliance:audit-logs-archive` cron batch.\n   *\n   * Records are NEVER deleted from the primary `AUDIT_LOGS` store — this is the\n   * archival horizon only (see the block-level JSDoc on why the field is\n   * `archiveAfterDays`, not `retentionDays`).\n   *\n   * OPTIONAL — when omitted (`undefined`), NO archival runs and audit records\n   * are retained in the primary store indefinitely. This is the compliance-safe\n   * default: an operator must explicitly opt in before any archival happens.\n   *\n   * Bounds: min 1 / max 2555 (≈ 7 years), mirroring the SSO\n   * `auditConfig.retentionDays` precedent. A production floor of 365 days is\n   * enforced at boot (see block-level JSDoc) — setting a value below 365 in a\n   * staging/production environment fails startup with a CONFIGURATION error.\n   */\n  archiveAfterDays: z.number().int().min(1).max(2555).optional(),\n});\n\nexport type AuditTrailConfig = z.infer<typeof AuditTrailConfigSchema>;\n"]}