@maykonpaulo/maestro-core 0.2.0

package/README.md

@@ -0,0 +1,87 @@
+# @maykonpaulo/maestro-core
+
+Pacote central da plataforma Maestro. Fornece capacidades administrativas genéricas e reutilizáveis para sistemas internos.
+
+## Módulos disponíveis
+
+| Módulo          | Classes / Interfaces principais                                      |
+|-----------------|----------------------------------------------------------------------|
+| `audit`         | `AuditRecorder`, `InMemoryAuditRepository`, `AuditRepository`       |
+| `rbac`          | `RbacEngine`, `RbacPolicy`, `Role`                                   |
+| `logging`       | `ConsoleLogger`, `Logger`                                            |
+| `feature-flags` | `InMemoryFeatureFlagProvider`, `FeatureFlagProvider`                 |
+| `config`        | `InMemoryConfigProvider`, `ConfigProvider`                           |
+| `events`        | `InMemoryEventBus`, `EventBus`, `DomainEvent`                        |
+| `errors`        | `MaestroError`, `ErrorCode`                                          |
+| `types`         | `Actor`, `ResourceRef`, `Metadata`                                   |
+
+## Instalação
+
+```bash
+pnpm add @maykonpaulo/maestro-core
+```
+
+## Uso básico
+
+```typescript
+import {
+  AuditRecorder,
+  InMemoryAuditRepository,
+  RbacEngine,
+  ConsoleLogger,
+  InMemoryFeatureFlagProvider,
+  InMemoryConfigProvider,
+  InMemoryEventBus,
+} from '@maykonpaulo/maestro-core';
+import type { Actor, RbacPolicy } from '@maykonpaulo/maestro-core';
+
+// Actor
+const actor: Actor = { id: 'user-1', type: 'user', roles: ['editor'] };
+
+// Auditoria
+const audit = new AuditRecorder(new InMemoryAuditRepository());
+await audit.record({ action: 'contract.updated', actor });
+
+// RBAC
+const policy: RbacPolicy = {
+  roles: {
+    editor: { id: 'editor', name: 'editor', permissions: ['contracts.*'] },
+  },
+};
+const rbac = new RbacEngine(policy);
+rbac.can(actor, 'contracts.update'); // true
+
+// Logging
+const logger = new ConsoleLogger('info');
+logger.info({ message: 'Operação concluída', correlationId: 'req-123' });
+
+// Feature flags
+const flags = new InMemoryFeatureFlagProvider([{ key: 'new-ui', enabled: true }]);
+await flags.isEnabled('new-ui', actor); // true
+
+// Config
+const config = new InMemoryConfigProvider({ 'app.name': 'meu-sistema' });
+config.get('app.name'); // 'meu-sistema'
+
+// Eventos
+const bus = new InMemoryEventBus();
+bus.subscribe('contract.updated', (event) => console.log(event));
+await bus.publish({ id: 'evt-1', type: 'contract.updated', payload: {}, occurredAt: new Date() });
+```
+
+## API pública
+
+Todas as exportações estão documentadas em `src/index.ts`. Importe apenas pelo nome do pacote:
+
+```typescript
+import { ... } from '@maykonpaulo/maestro-core';
+```
+
+## Limitações da Fase 1
+
+- **Sem persistência real** — todas as implementações são in-memory. Dados são perdidos ao reiniciar o processo.
+- **Sem provider remoto de feature flags** — `InMemoryFeatureFlagProvider` não suporta avaliação por actor com regras complexas.
+- **Sem adapter de logging externo** — `ConsoleLogger` escreve em `console.*`. Para produção, implementar um adapter que envie para seu stack de observabilidade.
+- **Sem autenticação** — o `RbacEngine` avalia autorização com base no `Actor` recebido. Autenticação é responsabilidade do consumer.
+
+As interfaces (`AuditRepository`, `FeatureFlagProvider`, `ConfigProvider`, `EventBus`, `Logger`) foram projetadas para serem substituídas por implementações concretas em produção.

package/dist/index.d.ts

@@ -0,0 +1,209 @@
+type MetadataValue = string | number | boolean | null | MetadataValue[] | {
+    [key: string]: MetadataValue;
+};
+type Metadata = Record<string, MetadataValue>;
+
+type ActorType = 'user' | 'system' | 'job' | 'integration' | 'ai-agent';
+interface Actor {
+    id: string;
+    type: ActorType;
+    name?: string;
+    email?: string;
+    roles?: string[];
+    permissions?: string[];
+    metadata?: Metadata;
+}
+
+interface ResourceRef {
+    type: string;
+    id: string;
+    label?: string;
+    metadata?: Metadata;
+}
+
+declare enum ErrorCode {
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    NOT_FOUND = "NOT_FOUND",
+    CONFLICT = "CONFLICT",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    CONFIGURATION_ERROR = "CONFIGURATION_ERROR"
+}
+
+declare class MaestroError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: Metadata;
+    readonly cause?: unknown;
+    constructor(code: ErrorCode, message: string, options?: {
+        details?: Metadata;
+        cause?: unknown;
+    });
+}
+
+interface LogEntry {
+    message: string;
+    metadata?: Metadata;
+    error?: unknown;
+    correlationId?: string;
+}
+interface Logger {
+    debug(entry: LogEntry): void;
+    info(entry: LogEntry): void;
+    warn(entry: LogEntry): void;
+    error(entry: LogEntry): void;
+}
+
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+
+declare class ConsoleLogger implements Logger {
+    private readonly minLevel;
+    constructor(minLevel?: LogLevel);
+    debug(entry: LogEntry): void;
+    info(entry: LogEntry): void;
+    warn(entry: LogEntry): void;
+    error(entry: LogEntry): void;
+    private log;
+    private serializeError;
+}
+
+type AuditLevel = 'debug' | 'info' | 'warn' | 'error' | 'critical';
+
+interface AuditEvent {
+    id: string;
+    timestamp: Date;
+    action: string;
+    actor: Actor;
+    resource?: ResourceRef;
+    level: AuditLevel;
+    before?: Metadata;
+    after?: Metadata;
+    metadata?: Metadata;
+    correlationId?: string;
+    requestId?: string;
+    ip?: string;
+    userAgent?: string;
+}
+
+interface AuditFilter {
+    actorId?: string;
+    action?: string;
+    resourceType?: string;
+    resourceId?: string;
+    level?: AuditLevel;
+    from?: Date;
+    to?: Date;
+    correlationId?: string;
+}
+interface AuditRepository {
+    record(event: AuditEvent): Promise<void>;
+    list(filter?: AuditFilter): Promise<AuditEvent[]>;
+}
+
+interface RecordAuditInput {
+    action: string;
+    actor: Actor;
+    level?: AuditLevel;
+    resource?: ResourceRef;
+    before?: Metadata;
+    after?: Metadata;
+    metadata?: Metadata;
+    correlationId?: string;
+    requestId?: string;
+    ip?: string;
+    userAgent?: string;
+}
+declare class AuditRecorder {
+    private readonly repository;
+    constructor(repository: AuditRepository);
+    record(input: RecordAuditInput): Promise<AuditEvent>;
+}
+
+declare class InMemoryAuditRepository implements AuditRepository {
+    private readonly store;
+    record(event: AuditEvent): Promise<void>;
+    list(filter?: AuditFilter): Promise<AuditEvent[]>;
+}
+
+type Permission = string;
+
+interface Role {
+    id: string;
+    name: string;
+    permissions: Permission[];
+}
+
+interface RbacPolicy {
+    roles: Record<string, Role>;
+}
+
+declare class RbacEngine {
+    private readonly policy;
+    constructor(policy: RbacPolicy);
+    can(actor: Actor, permission: string): boolean;
+    private resolvePermissions;
+    private matchesPattern;
+}
+
+interface FeatureFlag {
+    key: string;
+    enabled: boolean;
+    description?: string;
+    metadata?: Metadata;
+}
+
+interface FeatureFlagProvider {
+    isEnabled(key: string, actor?: Actor): Promise<boolean>;
+    get(key: string): FeatureFlag | undefined;
+    set(flag: FeatureFlag): void;
+    list(): FeatureFlag[];
+}
+
+declare class InMemoryFeatureFlagProvider implements FeatureFlagProvider {
+    private readonly flags;
+    constructor(flags?: FeatureFlag[]);
+    isEnabled(key: string, _actor?: Actor): Promise<boolean>;
+    get(key: string): FeatureFlag | undefined;
+    set(flag: FeatureFlag): void;
+    list(): FeatureFlag[];
+}
+
+interface ConfigProvider {
+    get<T extends MetadataValue>(key: string): T | undefined;
+    set<T extends MetadataValue>(key: string, value: T): void;
+    has(key: string): boolean;
+    getOrDefault<T extends MetadataValue>(key: string, defaultValue: T): T;
+}
+
+declare class InMemoryConfigProvider implements ConfigProvider {
+    private readonly store;
+    constructor(initial?: Record<string, MetadataValue>);
+    get<T extends MetadataValue>(key: string): T | undefined;
+    set<T extends MetadataValue>(key: string, value: T): void;
+    has(key: string): boolean;
+    getOrDefault<T extends MetadataValue>(key: string, defaultValue: T): T;
+}
+
+interface DomainEvent<TPayload = Metadata> {
+    id: string;
+    type: string;
+    occurredAt: Date;
+    payload?: TPayload;
+    metadata?: Metadata;
+    correlationId?: string;
+}
+
+type EventHandler<TPayload = unknown> = (event: DomainEvent<TPayload>) => void | Promise<void>;
+interface EventBus {
+    publish<TPayload>(event: DomainEvent<TPayload>): Promise<void>;
+    subscribe<TPayload>(eventType: string, handler: EventHandler<TPayload>): void;
+    unsubscribe<TPayload>(eventType: string, handler: EventHandler<TPayload>): void;
+}
+
+declare class InMemoryEventBus implements EventBus {
+    private readonly handlers;
+    publish<TPayload>(event: DomainEvent<TPayload>): Promise<void>;
+    subscribe<TPayload>(eventType: string, handler: EventHandler<TPayload>): void;
+    unsubscribe<TPayload>(eventType: string, handler: EventHandler<TPayload>): void;
+}
+
+export { type Actor, type ActorType, type AuditEvent, type AuditFilter, type AuditLevel, AuditRecorder, type AuditRepository, type ConfigProvider, ConsoleLogger, type DomainEvent, ErrorCode, type EventBus, type EventHandler, type FeatureFlag, type FeatureFlagProvider, InMemoryAuditRepository, InMemoryConfigProvider, InMemoryEventBus, InMemoryFeatureFlagProvider, type LogEntry, type LogLevel, type Logger, MaestroError, type Metadata, type MetadataValue, type Permission, RbacEngine, type RbacPolicy, type RecordAuditInput, type ResourceRef, type Role };

package/dist/index.js

@@ -0,0 +1,245 @@
+// src/errors/ErrorCode.ts
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+  ErrorCode2["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+  ErrorCode2["NOT_FOUND"] = "NOT_FOUND";
+  ErrorCode2["CONFLICT"] = "CONFLICT";
+  ErrorCode2["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+  ErrorCode2["CONFIGURATION_ERROR"] = "CONFIGURATION_ERROR";
+  return ErrorCode2;
+})(ErrorCode || {});
+
+// src/errors/MaestroError.ts
+var MaestroError = class extends Error {
+  code;
+  details;
+  cause;
+  constructor(code, message, options) {
+    super(message, { cause: options?.cause });
+    this.code = code;
+    this.details = options?.details;
+    this.cause = options?.cause;
+    this.name = "MaestroError";
+  }
+};
+
+// src/logging/LogLevel.ts
+var LOG_LEVEL_PRIORITY = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
+};
+
+// src/logging/ConsoleLogger.ts
+var ConsoleLogger = class {
+  constructor(minLevel = "info") {
+    this.minLevel = minLevel;
+  }
+  minLevel;
+  debug(entry) {
+    this.log("debug", entry);
+  }
+  info(entry) {
+    this.log("info", entry);
+  }
+  warn(entry) {
+    this.log("warn", entry);
+  }
+  error(entry) {
+    this.log("error", entry);
+  }
+  log(level, entry) {
+    if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.minLevel]) return;
+    const output = {
+      level,
+      message: entry.message,
+      ...entry.correlationId && { correlationId: entry.correlationId },
+      ...entry.metadata && { metadata: entry.metadata },
+      ...entry.error !== void 0 && { error: this.serializeError(entry.error) }
+    };
+    const consoleFn = level === "error" ? console.error : level === "warn" ? console.warn : level === "debug" ? console.debug : console.info;
+    consoleFn(JSON.stringify(output));
+  }
+  serializeError(error) {
+    if (error instanceof Error) {
+      return { name: error.name, message: error.message };
+    }
+    return error;
+  }
+};
+
+// src/audit/InMemoryAuditRepository.ts
+var InMemoryAuditRepository = class {
+  store = /* @__PURE__ */ new Map();
+  async record(event) {
+    this.store.set(event.id, event);
+  }
+  async list(filter) {
+    let events = Array.from(this.store.values());
+    if (!filter) return events;
+    if (filter.actorId !== void 0) {
+      events = events.filter((e) => e.actor.id === filter.actorId);
+    }
+    if (filter.action !== void 0) {
+      events = events.filter((e) => e.action === filter.action);
+    }
+    if (filter.resourceType !== void 0) {
+      events = events.filter((e) => e.resource?.type === filter.resourceType);
+    }
+    if (filter.resourceId !== void 0) {
+      events = events.filter((e) => e.resource?.id === filter.resourceId);
+    }
+    if (filter.level !== void 0) {
+      events = events.filter((e) => e.level === filter.level);
+    }
+    if (filter.from !== void 0) {
+      const from = filter.from;
+      events = events.filter((e) => e.timestamp >= from);
+    }
+    if (filter.to !== void 0) {
+      const to = filter.to;
+      events = events.filter((e) => e.timestamp <= to);
+    }
+    if (filter.correlationId !== void 0) {
+      events = events.filter((e) => e.correlationId === filter.correlationId);
+    }
+    return events;
+  }
+};
+
+// src/audit/AuditRecorder.ts
+import { randomUUID } from "crypto";
+var AuditRecorder = class {
+  constructor(repository) {
+    this.repository = repository;
+  }
+  repository;
+  async record(input) {
+    const event = {
+      id: randomUUID(),
+      timestamp: /* @__PURE__ */ new Date(),
+      action: input.action,
+      actor: input.actor,
+      level: input.level ?? "info",
+      resource: input.resource,
+      before: input.before,
+      after: input.after,
+      metadata: input.metadata,
+      correlationId: input.correlationId,
+      requestId: input.requestId,
+      ip: input.ip,
+      userAgent: input.userAgent
+    };
+    await this.repository.record(event);
+    return event;
+  }
+};
+
+// src/rbac/RbacEngine.ts
+var RbacEngine = class {
+  constructor(policy) {
+    this.policy = policy;
+  }
+  policy;
+  can(actor, permission) {
+    const permissions = this.resolvePermissions(actor);
+    return permissions.some((p) => this.matchesPattern(p, permission));
+  }
+  resolvePermissions(actor) {
+    const direct = actor.permissions ?? [];
+    const fromRoles = (actor.roles ?? []).flatMap((roleName) => {
+      const role = this.policy.roles[roleName];
+      return role?.permissions ?? [];
+    });
+    return [...direct, ...fromRoles];
+  }
+  matchesPattern(pattern, target) {
+    if (pattern === "*") return true;
+    if (pattern === target) return true;
+    if (pattern.endsWith(".*")) {
+      const prefix = pattern.slice(0, -2);
+      return target === prefix || target.startsWith(`${prefix}.`);
+    }
+    return false;
+  }
+};
+
+// src/feature-flags/InMemoryFeatureFlagProvider.ts
+var InMemoryFeatureFlagProvider = class {
+  flags = /* @__PURE__ */ new Map();
+  constructor(flags = []) {
+    for (const flag of flags) {
+      this.flags.set(flag.key, flag);
+    }
+  }
+  async isEnabled(key, _actor) {
+    return this.flags.get(key)?.enabled ?? false;
+  }
+  get(key) {
+    return this.flags.get(key);
+  }
+  set(flag) {
+    this.flags.set(flag.key, flag);
+  }
+  list() {
+    return Array.from(this.flags.values());
+  }
+};
+
+// src/config/InMemoryConfigProvider.ts
+var InMemoryConfigProvider = class {
+  store = /* @__PURE__ */ new Map();
+  constructor(initial = {}) {
+    for (const [key, value] of Object.entries(initial)) {
+      this.store.set(key, value);
+    }
+  }
+  get(key) {
+    return this.store.get(key);
+  }
+  set(key, value) {
+    this.store.set(key, value);
+  }
+  has(key) {
+    return this.store.has(key);
+  }
+  getOrDefault(key, defaultValue) {
+    const value = this.store.get(key);
+    return value !== void 0 ? value : defaultValue;
+  }
+};
+
+// src/events/InMemoryEventBus.ts
+var InMemoryEventBus = class {
+  handlers = /* @__PURE__ */ new Map();
+  async publish(event) {
+    const set = this.handlers.get(event.type);
+    if (!set) return;
+    const promises = Array.from(set).map(
+      (handler) => Promise.resolve(handler(event))
+    );
+    await Promise.all(promises);
+  }
+  subscribe(eventType, handler) {
+    if (!this.handlers.has(eventType)) {
+      this.handlers.set(eventType, /* @__PURE__ */ new Set());
+    }
+    this.handlers.get(eventType).add(handler);
+  }
+  unsubscribe(eventType, handler) {
+    this.handlers.get(eventType)?.delete(handler);
+  }
+};
+export {
+  AuditRecorder,
+  ConsoleLogger,
+  ErrorCode,
+  InMemoryAuditRepository,
+  InMemoryConfigProvider,
+  InMemoryEventBus,
+  InMemoryFeatureFlagProvider,
+  MaestroError,
+  RbacEngine
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/ErrorCode.ts","../src/errors/MaestroError.ts","../src/logging/LogLevel.ts","../src/logging/ConsoleLogger.ts","../src/audit/InMemoryAuditRepository.ts","../src/audit/AuditRecorder.ts","../src/rbac/RbacEngine.ts","../src/feature-flags/InMemoryFeatureFlagProvider.ts","../src/config/InMemoryConfigProvider.ts","../src/events/InMemoryEventBus.ts"],"sourcesContent":["export enum ErrorCode {\n  VALIDATION_ERROR = 'VALIDATION_ERROR',\n  PERMISSION_DENIED = 'PERMISSION_DENIED',\n  NOT_FOUND = 'NOT_FOUND',\n  CONFLICT = 'CONFLICT',\n  INTERNAL_ERROR = 'INTERNAL_ERROR',\n  CONFIGURATION_ERROR = 'CONFIGURATION_ERROR',\n}\n","import type { Metadata } from '../types/index.js';\nimport type { ErrorCode } from './ErrorCode.js';\n\nexport class MaestroError extends Error {\n  readonly code: ErrorCode;\n  readonly details?: Metadata;\n  override readonly cause?: unknown;\n\n  constructor(\n    code: ErrorCode,\n    message: string,\n    options?: { details?: Metadata; cause?: unknown },\n  ) {\n    super(message, { cause: options?.cause });\n    this.code = code;\n    this.details = options?.details;\n    this.cause = options?.cause;\n    this.name = 'MaestroError';\n  }\n}\n","export type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nexport const LOG_LEVEL_PRIORITY: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n","import type { Logger, LogEntry } from './Logger.js';\nimport type { LogLevel } from './LogLevel.js';\nimport { LOG_LEVEL_PRIORITY } from './LogLevel.js';\n\nexport class ConsoleLogger implements Logger {\n  constructor(private readonly minLevel: LogLevel = 'info') {}\n\n  debug(entry: LogEntry): void {\n    this.log('debug', entry);\n  }\n\n  info(entry: LogEntry): void {\n    this.log('info', entry);\n  }\n\n  warn(entry: LogEntry): void {\n    this.log('warn', entry);\n  }\n\n  error(entry: LogEntry): void {\n    this.log('error', entry);\n  }\n\n  private log(level: LogLevel, entry: LogEntry): void {\n    if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.minLevel]) return;\n\n    const output = {\n      level,\n      message: entry.message,\n      ...(entry.correlationId && { correlationId: entry.correlationId }),\n      ...(entry.metadata && { metadata: entry.metadata }),\n      ...(entry.error !== undefined && { error: this.serializeError(entry.error) }),\n    };\n\n    const consoleFn = level === 'error' ? console.error\n      : level === 'warn' ? console.warn\n      : level === 'debug' ? console.debug\n      : console.info;\n\n    consoleFn(JSON.stringify(output));\n  }\n\n  private serializeError(error: unknown): unknown {\n    if (error instanceof Error) {\n      return { name: error.name, message: error.message };\n    }\n    return error;\n  }\n}\n","import type { AuditRepository, AuditFilter } from './AuditRepository.js';\nimport type { AuditEvent } from './AuditEvent.js';\n\nexport class InMemoryAuditRepository implements AuditRepository {\n  private readonly store = new Map<string, AuditEvent>();\n\n  async record(event: AuditEvent): Promise<void> {\n    this.store.set(event.id, event);\n  }\n\n  async list(filter?: AuditFilter): Promise<AuditEvent[]> {\n    let events = Array.from(this.store.values());\n\n    if (!filter) return events;\n\n    if (filter.actorId !== undefined) {\n      events = events.filter((e) => e.actor.id === filter.actorId);\n    }\n    if (filter.action !== undefined) {\n      events = events.filter((e) => e.action === filter.action);\n    }\n    if (filter.resourceType !== undefined) {\n      events = events.filter((e) => e.resource?.type === filter.resourceType);\n    }\n    if (filter.resourceId !== undefined) {\n      events = events.filter((e) => e.resource?.id === filter.resourceId);\n    }\n    if (filter.level !== undefined) {\n      events = events.filter((e) => e.level === filter.level);\n    }\n    if (filter.from !== undefined) {\n      const from = filter.from;\n      events = events.filter((e) => e.timestamp >= from);\n    }\n    if (filter.to !== undefined) {\n      const to = filter.to;\n      events = events.filter((e) => e.timestamp <= to);\n    }\n    if (filter.correlationId !== undefined) {\n      events = events.filter((e) => e.correlationId === filter.correlationId);\n    }\n\n    return events;\n  }\n}\n","import { randomUUID } from 'node:crypto';\nimport type { AuditRepository } from './AuditRepository.js';\nimport type { AuditEvent } from './AuditEvent.js';\nimport type { AuditLevel } from './AuditLevel.js';\nimport type { Actor, ResourceRef, Metadata } from '../types/index.js';\n\nexport interface RecordAuditInput {\n  action: string;\n  actor: Actor;\n  level?: AuditLevel;\n  resource?: ResourceRef;\n  before?: Metadata;\n  after?: Metadata;\n  metadata?: Metadata;\n  correlationId?: string;\n  requestId?: string;\n  ip?: string;\n  userAgent?: string;\n}\n\nexport class AuditRecorder {\n  constructor(private readonly repository: AuditRepository) {}\n\n  async record(input: RecordAuditInput): Promise<AuditEvent> {\n    const event: AuditEvent = {\n      id: randomUUID(),\n      timestamp: new Date(),\n      action: input.action,\n      actor: input.actor,\n      level: input.level ?? 'info',\n      resource: input.resource,\n      before: input.before,\n      after: input.after,\n      metadata: input.metadata,\n      correlationId: input.correlationId,\n      requestId: input.requestId,\n      ip: input.ip,\n      userAgent: input.userAgent,\n    };\n\n    await this.repository.record(event);\n    return event;\n  }\n}\n","import type { Actor } from '../types/index.js';\nimport type { RbacPolicy } from './RbacPolicy.js';\n\nexport class RbacEngine {\n  constructor(private readonly policy: RbacPolicy) {}\n\n  can(actor: Actor, permission: string): boolean {\n    const permissions = this.resolvePermissions(actor);\n    return permissions.some((p) => this.matchesPattern(p, permission));\n  }\n\n  private resolvePermissions(actor: Actor): string[] {\n    const direct = actor.permissions ?? [];\n    const fromRoles = (actor.roles ?? []).flatMap((roleName) => {\n      const role = this.policy.roles[roleName];\n      return role?.permissions ?? [];\n    });\n    return [...direct, ...fromRoles];\n  }\n\n  private matchesPattern(pattern: string, target: string): boolean {\n    if (pattern === '*') return true;\n    if (pattern === target) return true;\n    if (pattern.endsWith('.*')) {\n      const prefix = pattern.slice(0, -2);\n      return target === prefix || target.startsWith(`${prefix}.`);\n    }\n    return false;\n  }\n}\n","import type { FeatureFlagProvider } from './FeatureFlagProvider.js';\nimport type { FeatureFlag } from './FeatureFlag.js';\nimport type { Actor } from '../types/index.js';\n\nexport class InMemoryFeatureFlagProvider implements FeatureFlagProvider {\n  private readonly flags = new Map<string, FeatureFlag>();\n\n  constructor(flags: FeatureFlag[] = []) {\n    for (const flag of flags) {\n      this.flags.set(flag.key, flag);\n    }\n  }\n\n  async isEnabled(key: string, _actor?: Actor): Promise<boolean> {\n    return this.flags.get(key)?.enabled ?? false;\n  }\n\n  get(key: string): FeatureFlag | undefined {\n    return this.flags.get(key);\n  }\n\n  set(flag: FeatureFlag): void {\n    this.flags.set(flag.key, flag);\n  }\n\n  list(): FeatureFlag[] {\n    return Array.from(this.flags.values());\n  }\n}\n","import type { ConfigProvider } from './ConfigProvider.js';\nimport type { MetadataValue } from '../types/index.js';\n\nexport class InMemoryConfigProvider implements ConfigProvider {\n  private readonly store = new Map<string, MetadataValue>();\n\n  constructor(initial: Record<string, MetadataValue> = {}) {\n    for (const [key, value] of Object.entries(initial)) {\n      this.store.set(key, value);\n    }\n  }\n\n  get<T extends MetadataValue>(key: string): T | undefined {\n    return this.store.get(key) as T | undefined;\n  }\n\n  set<T extends MetadataValue>(key: string, value: T): void {\n    this.store.set(key, value);\n  }\n\n  has(key: string): boolean {\n    return this.store.has(key);\n  }\n\n  getOrDefault<T extends MetadataValue>(key: string, defaultValue: T): T {\n    const value = this.store.get(key);\n    return value !== undefined ? (value as T) : defaultValue;\n  }\n}\n","import type { EventBus, EventHandler } from './EventBus.js';\nimport type { DomainEvent } from './DomainEvent.js';\n\nexport class InMemoryEventBus implements EventBus {\n  private readonly handlers = new Map<string, Set<EventHandler>>();\n\n  async publish<TPayload>(event: DomainEvent<TPayload>): Promise<void> {\n    const set = this.handlers.get(event.type);\n    if (!set) return;\n\n    const promises = Array.from(set).map((handler) =>\n      Promise.resolve(handler(event as DomainEvent<unknown>)),\n    );\n    await Promise.all(promises);\n  }\n\n  subscribe<TPayload>(eventType: string, handler: EventHandler<TPayload>): void {\n    if (!this.handlers.has(eventType)) {\n      this.handlers.set(eventType, new Set());\n    }\n    this.handlers.get(eventType)!.add(handler as EventHandler);\n  }\n\n  unsubscribe<TPayload>(eventType: string, handler: EventHandler<TPayload>): void {\n    this.handlers.get(eventType)?.delete(handler as EventHandler);\n  }\n}\n"],"mappings":"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","names":["ErrorCode"]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@maykonpaulo/maestro-core",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "rimraf": "^6.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests",
+    "clean": "rimraf dist"
+  }
+}