@maykonpaulo/maestro-core 0.3.0-next.0 → 0.3.0-next.1

package/dist/index.d.ts

@@ -66,6 +66,40 @@ declare class ConsoleLogger implements Logger {
     private serializeError;
 }
 
+type OperationLogStatus = 'success' | 'failure' | 'partial';
+
+interface StructuredLogEntry {
+    correlationId?: string;
+    operation?: string;
+    entity?: string;
+    entityId?: string;
+    actor?: string;
+    durationMs?: number;
+    status?: OperationLogStatus;
+    severity?: string;
+    message?: string;
+    metadata?: Metadata;
+    error?: unknown;
+}
+
+interface StructuredLogger {
+    debug(entry: StructuredLogEntry): void;
+    info(entry: StructuredLogEntry): void;
+    warn(entry: StructuredLogEntry): void;
+    error(entry: StructuredLogEntry): void;
+}
+
+declare class ConsoleStructuredLogger implements StructuredLogger {
+    private readonly minLevel;
+    constructor(minLevel?: LogLevel);
+    debug(entry: StructuredLogEntry): void;
+    info(entry: StructuredLogEntry): void;
+    warn(entry: StructuredLogEntry): void;
+    error(entry: StructuredLogEntry): void;
+    private log;
+    private serializeError;
+}
+
 type AuditLevel = 'debug' | 'info' | 'warn' | 'error' | 'critical';
 
 interface AuditEvent {
@@ -74,6 +108,8 @@ interface AuditEvent {
     action: string;
     actor: Actor;
     resource?: ResourceRef;
+    entity?: string;
+    entityId?: string;
     level: AuditLevel;
     before?: Metadata;
     after?: Metadata;
@@ -87,6 +123,8 @@ interface AuditEvent {
 interface AuditFilter {
     actorId?: string;
     action?: string;
+    entity?: string;
+    entityId?: string;
     resourceType?: string;
     resourceId?: string;
     level?: AuditLevel;
@@ -99,11 +137,17 @@ interface AuditRepository {
     list(filter?: AuditFilter): Promise<AuditEvent[]>;
 }
 
+interface AuditTimeline {
+    query(filter?: AuditFilter): Promise<AuditEvent[]>;
+}
+
 interface RecordAuditInput {
     action: string;
     actor: Actor;
     level?: AuditLevel;
     resource?: ResourceRef;
+    entity?: string;
+    entityId?: string;
     before?: Metadata;
     after?: Metadata;
     metadata?: Metadata;
@@ -118,10 +162,11 @@ declare class AuditRecorder {
     record(input: RecordAuditInput): Promise<AuditEvent>;
 }
 
-declare class InMemoryAuditRepository implements AuditRepository {
+declare class InMemoryAuditRepository implements AuditRepository, AuditTimeline {
     private readonly store;
     record(event: AuditEvent): Promise<void>;
     list(filter?: AuditFilter): Promise<AuditEvent[]>;
+    query(filter?: AuditFilter): Promise<AuditEvent[]>;
 }
 
 type Permission = string;
@@ -967,4 +1012,238 @@ declare class IntrospectionRuntime {
     compareWithSnapshot(snapshotId: string, provider?: IntrospectionProvider): Promise<IntrospectionDiff | null>;
 }
 
-export { type Actor, type ActorType, type AuditEvent, type AuditFilter, type AuditLevel, AuditRecorder, type AuditRepository, type ConfigProvider, ConsoleLogger, type ContextAction, type ContextActionCondition, type ContextActionStyle, type CreateMaestroFromIntrospectionOptions, CsvExportProvider, type CursorPagination, DEFAULT_CAPABILITIES, type DatasourceDeleteContext, type DatasourceFindContext, type DatasourceProvider, type DatasourceQueryContext, DatasourceRegistry, type DatasourceUpdateContext, type DatasourceWriteContext, type DiffChange, type DiffChangeKind, DiffEngine, type DiffEngineOptions, type DiffSummary, type DomainEvent, type EntityCapabilities, type EntityDiffChange, type EntityDiffChangeKind, type EntityExportConfig, type EntityIntrospectionSchema, type EntityLabelConfig, type EntityMetadata, type EntitySchema, type EntitySourceConfig, type EnumOption, ErrorCode, type EventBus, type EventHandler, type ExportConfig, type ExportFormat, type ExportOptions, type ExportProvider, type ExportResult, type FeatureFlag, type FeatureFlagProvider, type FieldDetailConfig, type FieldDiffChange, type FieldDiffChangeKind, type FieldFormConfig, type FieldIntrospectionSchema, type FieldListConfig, type FieldMetadata, type FieldSchema, type FieldSchemaDetailConfig, type FieldSchemaEnumOption, type FieldSchemaFormConfig, type FieldSchemaListConfig, type FieldType, type FileSystemReader, type FilterDescriptor, type FilterOperator, type GeneratedConfig, type ImpactLevel, InMemoryAuditRepository, InMemoryConfigProvider, InMemoryDatasourceProvider, InMemoryEventBus, InMemoryFeatureFlagProvider, InMemorySnapshotRepository, type IndexIntrospectionSchema, type IntrospectionDiff, type IntrospectionProvider, type IntrospectionReport, type IntrospectionReportChange, type IntrospectionReportStats, type IntrospectionResult, IntrospectionRuntime, type IntrospectionRuntimeResult, type IntrospectionRuntimeRunOptions, type IntrospectionSnapshot, type ListResult, type LoadedConfig, type LogEntry, type LogLevel, type Logger, type MaestroActorResolver, type MaestroConfig, MaestroEngine, MaestroError, type MaestroFileLoaderOptions, type MaestroHttpHandler, type MaestroHttpHandlers, type MaestroHttpOptions, type MaestroHttpRequest, type MaestroHttpResponse, type MaestroMetadata, type MaestroRequestContext, type MergeIntrospectionOptions, type MergeStrategy, type Metadata, MetadataEngine, type MetadataValue, type OffsetPagination, type OperationContext, type OperationDef, type OperationMetadata, OperationRegistry, type OperationResult, type OperationScope, type PagePagination, type PaginationInput, type Permission, type QueryInput, RbacEngine, type RbacPolicy, type RecordAuditInput, type RelationDiffChange, type RelationDiffChangeKind, type RelationDisplayConfig, type RelationEndpoint, type RelationIntrospectionSchema, type RelationMetadata, type RelationSchema, type RelationType, ReportGenerator, type ResourceRef, type Role, type SchemaValidationError, type SchemaValidationResult, type SearchConfig, type SearchInput, type SnapshotRepository, type SoftDeleteConfig, type SortDescriptor, type SortDirection, type YamlParser, createMaestro, createMaestroFromIntrospection, createMaestroHttpHandlers, detectDisplayField, generateAllConfigs, generateEntityConfig, generateRelationConfig, humanizeFieldName, inferFieldType, isSearchCandidate, isSoftDeleteCandidate, isTimestampField, loadMaestroConfig, mergeIntrospectionWithOverrides, parseQueryInput, tableNameToEntityId, tableNameToLabel, validateMaestroConfig };
+type CorrelationId = string;
+declare function generateCorrelationId(): CorrelationId;
+
+interface CorrelationContext {
+    correlationId: CorrelationId;
+}
+
+type OperationalRisk = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+
+interface RiskClassificationInput {
+    operation: string;
+    resource?: ResourceRef;
+    metadata?: Metadata;
+}
+interface RiskClassifier {
+    classify(input: RiskClassificationInput): OperationalRisk;
+}
+
+declare class MetadataRiskClassifier implements RiskClassifier {
+    private readonly operationRiskMap;
+    private readonly defaultRisk;
+    constructor(operationRiskMap?: Record<string, OperationalRisk>, defaultRisk?: OperationalRisk);
+    classify(input: RiskClassificationInput): OperationalRisk;
+}
+
+type AuthorizationDecision = 'ALLOW' | 'DENY' | 'REQUIRES_CONFIRMATION';
+
+interface AuthorizationContext {
+    actor: Actor;
+    operation: string;
+    resource?: ResourceRef;
+    metadata?: Metadata;
+    riskLevel?: OperationalRisk;
+    correlationId?: string;
+}
+
+interface AuthorizationResult {
+    decision: AuthorizationDecision;
+    reason?: string;
+    metadata?: Metadata;
+}
+
+interface AuthorizationProvider {
+    evaluate(context: AuthorizationContext): Promise<AuthorizationResult>;
+}
+
+declare class ContextualAuthorizationEngine implements AuthorizationProvider {
+    private readonly criticalOperations;
+    private readonly rbac;
+    constructor(policy: RbacPolicy, criticalOperations?: ReadonlySet<string>);
+    evaluate(context: AuthorizationContext): Promise<AuthorizationResult>;
+}
+
+type PolicyDecision = 'ALLOW' | 'DENY' | 'REQUIRES_CONFIRMATION';
+
+interface PolicyContext {
+    actor: Actor;
+    operation: string;
+    resource?: ResourceRef;
+    metadata?: Metadata;
+    riskLevel?: OperationalRisk;
+    correlationId?: string;
+}
+
+interface PolicyRuleResult {
+    decision: PolicyDecision;
+    reason?: string;
+}
+interface PolicyRule {
+    id: string;
+    description?: string;
+    evaluate(context: PolicyContext): PolicyRuleResult | null;
+}
+
+interface PolicyViolation {
+    ruleId: string;
+    reason?: string;
+    context: PolicyContext;
+    occurredAt: Date;
+}
+
+interface PolicyEvaluationResult {
+    decision: PolicyDecision;
+    violations: PolicyViolation[];
+    reason?: string;
+}
+
+interface PolicyProvider {
+    rules(): PolicyRule[];
+}
+
+declare class PolicyEngine {
+    private readonly provider;
+    constructor(provider: PolicyProvider);
+    evaluate(context: PolicyContext): PolicyEvaluationResult;
+}
+
+declare class InMemoryPolicyProvider implements PolicyProvider {
+    private readonly _rules;
+    constructor(rules?: PolicyRule[]);
+    rules(): PolicyRule[];
+}
+
+type ConfirmationStatus = 'REQUESTED' | 'AWAITING_CONFIRMATION' | 'APPROVED' | 'REJECTED' | 'EXECUTED' | 'EXPIRED';
+
+interface ConfirmationApproval {
+    approver: Actor;
+    approvedAt: Date;
+    comment?: string;
+}
+
+interface ConfirmationRequest {
+    id: string;
+    operation: string;
+    actor: Actor;
+    resource?: ResourceRef;
+    status: ConfirmationStatus;
+    requiredApprovals: number;
+    approvals: ConfirmationApproval[];
+    rejections: ConfirmationApproval[];
+    requestedAt: Date;
+    executedAt?: Date;
+    expiresAt?: Date;
+    metadata?: Metadata;
+    correlationId?: string;
+}
+
+interface ConfirmationRepository {
+    save(request: ConfirmationRequest): Promise<void>;
+    findById(id: string): Promise<ConfirmationRequest | undefined>;
+    listPending(): Promise<ConfirmationRequest[]>;
+}
+
+interface RequestConfirmationInput {
+    operation: string;
+    actor: Actor;
+    resource?: ResourceRef;
+    requiredApprovals?: number;
+    metadata?: Metadata;
+    correlationId?: string;
+    expiresAt?: Date;
+}
+declare class ConfirmationEngine {
+    private readonly repository;
+    constructor(repository: ConfirmationRepository);
+    request(input: RequestConfirmationInput): Promise<ConfirmationRequest>;
+    approve(requestId: string, approver: Actor, comment?: string): Promise<ConfirmationRequest>;
+    reject(requestId: string, approver: Actor, comment?: string): Promise<ConfirmationRequest>;
+    execute(requestId: string): Promise<ConfirmationRequest>;
+    getPending(): Promise<ConfirmationRequest[]>;
+    private findOrThrow;
+    private assertActive;
+}
+
+declare class InMemoryConfirmationRepository implements ConfirmationRepository {
+    private readonly store;
+    save(request: ConfirmationRequest): Promise<void>;
+    findById(id: string): Promise<ConfirmationRequest | undefined>;
+    listPending(): Promise<ConfirmationRequest[]>;
+}
+
+declare const GOVERNANCE_EVENT_TYPES: {
+    readonly OPERATION_EXECUTED: "governance.operation.executed";
+    readonly AUTHORIZATION_DENIED: "governance.authorization.denied";
+    readonly POLICY_TRIGGERED: "governance.policy.triggered";
+    readonly CONFIRMATION_REQUESTED: "governance.confirmation.requested";
+    readonly CONFIRMATION_APPROVED: "governance.confirmation.approved";
+    readonly CONFIRMATION_REJECTED: "governance.confirmation.rejected";
+    readonly AUDIT_RECORDED: "governance.audit.recorded";
+};
+type GovernanceEventType = (typeof GOVERNANCE_EVENT_TYPES)[keyof typeof GOVERNANCE_EVENT_TYPES];
+
+interface OperationExecutedPayload {
+    operation: string;
+    actor: Actor;
+    resource?: ResourceRef;
+    correlationId?: string;
+    durationMs?: number;
+}
+interface AuthorizationDeniedPayload {
+    context: AuthorizationContext;
+    reason?: string;
+}
+interface PolicyTriggeredPayload {
+    violations: PolicyViolation[];
+    correlationId?: string;
+}
+interface ConfirmationRequestedPayload {
+    request: ConfirmationRequest;
+}
+interface ConfirmationApprovedPayload {
+    request: ConfirmationRequest;
+    approver: Actor;
+}
+interface ConfirmationRejectedPayload {
+    request: ConfirmationRequest;
+    approver: Actor;
+}
+interface AuditRecordedPayload {
+    event: AuditEvent;
+}
+
+interface GovernanceEventBus extends EventBus {
+    publishGovernance<TPayload>(type: GovernanceEventType, payload: TPayload, correlationId?: string): Promise<DomainEvent<TPayload>>;
+}
+
+declare class InMemoryGovernanceEventBus extends InMemoryEventBus implements GovernanceEventBus {
+    publishGovernance<TPayload>(type: GovernanceEventType, payload: TPayload, correlationId?: string): Promise<DomainEvent<TPayload>>;
+}
+
+interface PolicyViolationFilter {
+    ruleId?: string;
+    correlationId?: string;
+    from?: Date;
+    to?: Date;
+}
+interface GovernanceApi {
+    getAuditTimeline(filter?: AuditFilter): Promise<AuditEvent[]>;
+    getCorrelationTrace(correlationId: string): Promise<AuditEvent[]>;
+    getPendingConfirmations(): Promise<ConfirmationRequest[]>;
+    getPolicyViolations(filter?: PolicyViolationFilter): Promise<PolicyViolation[]>;
+}
+
+declare class DefaultGovernanceApi implements GovernanceApi {
+    private readonly auditRepository;
+    private readonly confirmationRepository;
+    private readonly violationLog;
+    constructor(auditRepository: AuditRepository, confirmationRepository: ConfirmationRepository, violationLog?: PolicyViolation[]);
+    getAuditTimeline(filter?: AuditFilter): Promise<AuditEvent[]>;
+    getCorrelationTrace(correlationId: string): Promise<AuditEvent[]>;
+    getPendingConfirmations(): Promise<ConfirmationRequest[]>;
+    getPolicyViolations(filter?: PolicyViolationFilter): Promise<PolicyViolation[]>;
+}
+
+export { type Actor, type ActorType, type AuditEvent, type AuditFilter, type AuditLevel, type AuditRecordedPayload, AuditRecorder, type AuditRepository, type AuditTimeline, type AuthorizationContext, type AuthorizationDecision, type AuthorizationDeniedPayload, type AuthorizationProvider, type AuthorizationResult, type ConfigProvider, type ConfirmationApproval, type ConfirmationApprovedPayload, ConfirmationEngine, type ConfirmationRejectedPayload, type ConfirmationRepository, type ConfirmationRequest, type ConfirmationRequestedPayload, type ConfirmationStatus, ConsoleLogger, ConsoleStructuredLogger, type ContextAction, type ContextActionCondition, type ContextActionStyle, ContextualAuthorizationEngine, type CorrelationContext, type CorrelationId, type CreateMaestroFromIntrospectionOptions, CsvExportProvider, type CursorPagination, DEFAULT_CAPABILITIES, type DatasourceDeleteContext, type DatasourceFindContext, type DatasourceProvider, type DatasourceQueryContext, DatasourceRegistry, type DatasourceUpdateContext, type DatasourceWriteContext, DefaultGovernanceApi, type DiffChange, type DiffChangeKind, DiffEngine, type DiffEngineOptions, type DiffSummary, type DomainEvent, type EntityCapabilities, type EntityDiffChange, type EntityDiffChangeKind, type EntityExportConfig, type EntityIntrospectionSchema, type EntityLabelConfig, type EntityMetadata, type EntitySchema, type EntitySourceConfig, type EnumOption, ErrorCode, type EventBus, type EventHandler, type ExportConfig, type ExportFormat, type ExportOptions, type ExportProvider, type ExportResult, type FeatureFlag, type FeatureFlagProvider, type FieldDetailConfig, type FieldDiffChange, type FieldDiffChangeKind, type FieldFormConfig, type FieldIntrospectionSchema, type FieldListConfig, type FieldMetadata, type FieldSchema, type FieldSchemaDetailConfig, type FieldSchemaEnumOption, type FieldSchemaFormConfig, type FieldSchemaListConfig, type FieldType, type FileSystemReader, type FilterDescriptor, type FilterOperator, GOVERNANCE_EVENT_TYPES, type GeneratedConfig, type GovernanceApi, type GovernanceEventBus, type GovernanceEventType, type ImpactLevel, InMemoryAuditRepository, InMemoryConfigProvider, InMemoryConfirmationRepository, InMemoryDatasourceProvider, InMemoryEventBus, InMemoryFeatureFlagProvider, InMemoryGovernanceEventBus, InMemoryPolicyProvider, InMemorySnapshotRepository, type IndexIntrospectionSchema, type IntrospectionDiff, type IntrospectionProvider, type IntrospectionReport, type IntrospectionReportChange, type IntrospectionReportStats, type IntrospectionResult, IntrospectionRuntime, type IntrospectionRuntimeResult, type IntrospectionRuntimeRunOptions, type IntrospectionSnapshot, type ListResult, type LoadedConfig, type LogEntry, type LogLevel, type Logger, type MaestroActorResolver, type MaestroConfig, MaestroEngine, MaestroError, type MaestroFileLoaderOptions, type MaestroHttpHandler, type MaestroHttpHandlers, type MaestroHttpOptions, type MaestroHttpRequest, type MaestroHttpResponse, type MaestroMetadata, type MaestroRequestContext, type MergeIntrospectionOptions, type MergeStrategy, type Metadata, MetadataEngine, MetadataRiskClassifier, type MetadataValue, type OffsetPagination, type OperationContext, type OperationDef, type OperationExecutedPayload, type OperationLogStatus, type OperationMetadata, OperationRegistry, type OperationResult, type OperationScope, type OperationalRisk, type PagePagination, type PaginationInput, type Permission, type PolicyContext, type PolicyDecision, PolicyEngine, type PolicyEvaluationResult, type PolicyProvider, type PolicyRule, type PolicyRuleResult, type PolicyTriggeredPayload, type PolicyViolation, type PolicyViolationFilter, type QueryInput, RbacEngine, type RbacPolicy, type RecordAuditInput, type RelationDiffChange, type RelationDiffChangeKind, type RelationDisplayConfig, type RelationEndpoint, type RelationIntrospectionSchema, type RelationMetadata, type RelationSchema, type RelationType, ReportGenerator, type RequestConfirmationInput, type ResourceRef, type RiskClassificationInput, type RiskClassifier, type Role, type SchemaValidationError, type SchemaValidationResult, type SearchConfig, type SearchInput, type SnapshotRepository, type SoftDeleteConfig, type SortDescriptor, type SortDirection, type StructuredLogEntry, type StructuredLogger, type YamlParser, createMaestro, createMaestroFromIntrospection, createMaestroHttpHandlers, detectDisplayField, generateAllConfigs, generateCorrelationId, generateEntityConfig, generateRelationConfig, humanizeFieldName, inferFieldType, isSearchCandidate, isSoftDeleteCandidate, isTimestampField, loadMaestroConfig, mergeIntrospectionWithOverrides, parseQueryInput, tableNameToEntityId, tableNameToLabel, validateMaestroConfig };