@geekmidas/constructs 0.0.12 → 0.0.14

package/dist/processAudits-DfcB-X-4.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"processAudits-DfcB-X-4.mjs","names":["endpoint: Endpoint<\n    any,\n    any,\n    any,\n    OutSchema,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction\n  >","response: InferStandardSchema<OutSchema>","serviceDiscovery: ServiceDiscovery<any, any>","logger: TLogger","ctx: {\n    session: TSession;\n    header: HeaderFn;\n    cookie: CookieFn;\n    services: Record<string, unknown>;\n  }","existingAuditor?: Auditor<TAuditAction>","auditor: Auditor<TAuditAction>","actor: AuditActor","endpoint: Endpoint<\n    any,\n    any,\n    any,\n    any,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction\n  >","auditContext: AuditExecutionContext<TAuditAction> | undefined","handler: (auditor?: Auditor<TAuditAction>) => Promise<T>","onComplete?: (response: T, auditor: Auditor<TAuditAction>) => Promise<void>","response"],"sources":["../src/endpoints/processAudits.ts"],"sourcesContent":["import type {\n  AuditableAction,\n  AuditActor,\n  Auditor,\n  AuditStorage,\n} from '@geekmidas/audit';\nimport { DefaultAuditor } from '@geekmidas/audit';\nimport { withAuditableTransaction } from '@geekmidas/audit/kysely';\nimport type { Logger } from '@geekmidas/logger';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceDiscovery } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { Endpoint, CookieFn, HeaderFn } from './Endpoint';\nimport type { ActorExtractor, MappedAudit } from './audit';\n\n/**\n * Process declarative audit definitions after successful endpoint execution.\n * Similar to publishConstructEvents for events.\n *\n * @param endpoint - The endpoint with audit configuration\n * @param response - The handler response to generate audit payloads from\n * @param serviceDiscovery - Service discovery for registering audit storage\n * @param logger - Logger for debug/error messages\n * @param ctx - Request context (session, headers, cookies, services)\n * @param existingAuditor - Optional existing auditor instance (e.g., from handler context).\n *                          If provided, uses this auditor (with its stored transaction).\n *                          If not provided, creates a new auditor.\n */\nexport async function processEndpointAudits<\n  TServices extends Service[] = [],\n  TSession = unknown,\n  TLogger extends Logger = Logger,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TAuditStorage extends AuditStorage | undefined = undefined,\n  TAuditStorageServiceName extends string = string,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n>(\n  endpoint: Endpoint<\n    any,\n    any,\n    any,\n    OutSchema,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction\n  >,\n  response: InferStandardSchema<OutSchema>,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: TLogger,\n  ctx: {\n    session: TSession;\n    header: HeaderFn;\n    cookie: CookieFn;\n    services: Record<string, unknown>;\n  },\n  existingAuditor?: Auditor<TAuditAction>,\n): Promise<void> {\n  try {\n    const audits = endpoint.audits as MappedAudit<TAuditAction, OutSchema>[];\n\n    // If we have an existing auditor (from handler context), we need to flush\n    // any manual audits it collected, even if there are no declarative audits\n    const hasExistingRecords = existingAuditor && existingAuditor.getRecords().length > 0;\n\n    // Skip if no declarative audits and no existing records to flush\n    if (!audits?.length && !hasExistingRecords) {\n      logger.debug('No audits to process');\n      return;\n    }\n\n    // If no auditor storage service and we have things to process, warn\n    if (!endpoint.auditorStorageService) {\n      if (hasExistingRecords || audits?.length) {\n        logger.warn('No auditor storage service available');\n      }\n      return;\n    }\n\n    // Get or create auditor\n    let auditor: Auditor<TAuditAction>;\n\n    if (existingAuditor) {\n      // Use existing auditor (preserves stored transaction and manual audits)\n      auditor = existingAuditor;\n      logger.debug('Using existing auditor from handler context');\n    } else {\n      // Create new auditor (backward compatibility)\n      const services = await serviceDiscovery.register([\n        endpoint.auditorStorageService,\n      ]);\n      const storage = services[\n        endpoint.auditorStorageService.serviceName\n      ] as AuditStorage;\n\n      // Extract actor if configured\n      let actor: AuditActor = { id: 'system', type: 'system' };\n      if (endpoint.actorExtractor) {\n        try {\n          actor = await (\n            endpoint.actorExtractor as ActorExtractor<TServices, TSession, TLogger>\n          )({\n            services: ctx.services as any,\n            session: ctx.session,\n            header: ctx.header,\n            cookie: ctx.cookie,\n            logger,\n          });\n        } catch (error) {\n          logger.error(error as Error, 'Failed to extract actor for audits');\n          // Continue with system actor\n        }\n      }\n\n      auditor = new DefaultAuditor<TAuditAction>({\n        actor,\n        storage,\n        metadata: {\n          endpoint: endpoint.route,\n          method: endpoint.method,\n        },\n      });\n    }\n\n    // Process each declarative audit\n    if (audits?.length) {\n      for (const audit of audits) {\n        logger.debug({ audit: audit.type }, 'Processing declarative audit');\n\n        // Check when condition\n        if (audit.when && !audit.when(response as any)) {\n          logger.debug({ audit: audit.type }, 'Audit skipped due to when condition');\n          continue;\n        }\n\n        // Extract payload\n        const payload = audit.payload(response as any);\n\n        // Extract entityId if configured\n        const entityId = audit.entityId?.(response as any);\n\n        // Record the audit\n        auditor.audit(audit.type as any, payload as any, {\n          table: audit.table,\n          entityId,\n        });\n      }\n    }\n\n    // Flush audits to storage\n    // Note: If existingAuditor has a stored transaction (via setTransaction),\n    // flush() will use it automatically\n    const recordCount = auditor.getRecords().length;\n    if (recordCount > 0) {\n      // Check if auditor has a stored transaction (for logging purposes)\n      const trx = 'getTransaction' in auditor\n        ? (auditor as { getTransaction(): unknown }).getTransaction()\n        : undefined;\n      logger.debug(\n        { auditCount: recordCount, hasTransaction: !!trx },\n        'Flushing audits',\n      );\n      await auditor.flush();\n    }\n  } catch (error) {\n    logger.error(error as Error, 'Failed to process audits');\n    // Don't rethrow - audit failures shouldn't fail the request\n  }\n}\n\n/**\n * Context for audit-aware handler execution.\n */\nexport interface AuditExecutionContext<\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n> {\n  /** The auditor instance for recording audits */\n  auditor: Auditor<TAuditAction>;\n  /** The audit storage instance */\n  storage: AuditStorage;\n}\n\n/**\n * Create audit context for handler execution.\n * Returns the auditor and storage for use in the handler.\n *\n * @param endpoint - The endpoint with audit configuration\n * @param serviceDiscovery - Service discovery for getting audit storage\n * @param logger - Logger for debug/error messages\n * @param ctx - Request context for actor extraction\n * @returns Audit context with auditor and storage, or undefined if not configured\n */\nexport async function createAuditContext<\n  TServices extends Service[] = [],\n  TSession = unknown,\n  TLogger extends Logger = Logger,\n  TAuditStorage extends AuditStorage | undefined = undefined,\n  TAuditStorageServiceName extends string = string,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n>(\n  endpoint: Endpoint<\n    any,\n    any,\n    any,\n    any,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction\n  >,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: TLogger,\n  ctx: {\n    session: TSession;\n    header: HeaderFn;\n    cookie: CookieFn;\n    services: Record<string, unknown>;\n  },\n): Promise<AuditExecutionContext<TAuditAction> | undefined> {\n  if (!endpoint.auditorStorageService) {\n    return undefined;\n  }\n\n  const services = await serviceDiscovery.register([\n    endpoint.auditorStorageService,\n  ]);\n  const storage = services[\n    endpoint.auditorStorageService.serviceName\n  ] as AuditStorage;\n\n  // Extract actor if configured\n  let actor: AuditActor = { id: 'system', type: 'system' };\n  if (endpoint.actorExtractor) {\n    try {\n      actor = await (\n        endpoint.actorExtractor as ActorExtractor<TServices, TSession, TLogger>\n      )({\n        services: ctx.services as any,\n        session: ctx.session,\n        header: ctx.header,\n        cookie: ctx.cookie,\n        logger,\n      });\n    } catch (error) {\n      logger.error(error as Error, 'Failed to extract actor for audits');\n    }\n  }\n\n  const auditor = new DefaultAuditor<TAuditAction>({\n    actor,\n    storage,\n    metadata: {\n      endpoint: endpoint.route,\n      method: endpoint.method,\n    },\n  });\n\n  return { auditor, storage };\n}\n\n/**\n * Execute a handler with automatic audit transaction support.\n * If the audit storage has a database (via getDatabase()), wraps execution\n * in a transaction so audits are atomic with handler's database operations.\n *\n * @param auditContext - The audit context from createAuditContext\n * @param handler - The handler function to execute (receives auditor)\n * @param onComplete - Called after handler with response, to process declarative audits\n * @returns The handler result\n */\nexport async function executeWithAuditTransaction<\n  T,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n>(\n  auditContext: AuditExecutionContext<TAuditAction> | undefined,\n  handler: (auditor?: Auditor<TAuditAction>) => Promise<T>,\n  onComplete?: (response: T, auditor: Auditor<TAuditAction>) => Promise<void>,\n): Promise<T> {\n  // No audit context - just run handler\n  if (!auditContext) {\n    return handler(undefined);\n  }\n\n  const { auditor, storage } = auditContext;\n\n  // Check if storage has a database for transactional execution\n  const db = storage.getDatabase?.();\n\n  if (db) {\n    // Wrap in transaction - audits are atomic with handler operations\n    return withAuditableTransaction(\n      db as any,\n      auditor as any,\n      async () => {\n        const response = await handler(auditor);\n\n        // Process declarative audits within the transaction\n        if (onComplete) {\n          await onComplete(response, auditor);\n        }\n\n        // Audits are flushed by withAuditableTransaction before commit\n        return response;\n      },\n    );\n  }\n\n  // No database - run handler and flush audits after\n  const response = await handler(auditor);\n\n  if (onComplete) {\n    await onComplete(response, auditor);\n  }\n\n  // Flush audits (no transaction)\n  await auditor.flush();\n\n  return response;\n}\n"],"mappings":"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"}
+{"version":3,"file":"processAudits-DfcB-X-4.mjs","names":["endpoint: Endpoint<\n    any,\n    any,\n    any,\n    OutSchema,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction\n  >","response: InferStandardSchema<OutSchema>","serviceDiscovery: ServiceDiscovery<any, any>","logger: TLogger","ctx: {\n    session: TSession;\n    header: HeaderFn;\n    cookie: CookieFn;\n    services: Record<string, unknown>;\n  }","existingAuditor?: Auditor<TAuditAction>","auditor: Auditor<TAuditAction>","actor: AuditActor","endpoint: Endpoint<\n    any,\n    any,\n    any,\n    any,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  >","auditContext: AuditExecutionContext<TAuditAction> | undefined","handler: (auditor?: Auditor<TAuditAction>) => Promise<T>","onComplete?: (response: T, auditor: Auditor<TAuditAction>) => Promise<void>","response"],"sources":["../src/endpoints/processAudits.ts"],"sourcesContent":["import type {\n  AuditActor,\n  AuditStorage,\n  AuditableAction,\n  Auditor,\n} from '@geekmidas/audit';\nimport { DefaultAuditor } from '@geekmidas/audit';\nimport { withAuditableTransaction } from '@geekmidas/audit/kysely';\nimport type { Logger } from '@geekmidas/logger';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceDiscovery } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { CookieFn, Endpoint, HeaderFn } from './Endpoint';\nimport type { ActorExtractor, MappedAudit } from './audit';\n\n/**\n * Process declarative audit definitions after successful endpoint execution.\n * Similar to publishConstructEvents for events.\n *\n * @param endpoint - The endpoint with audit configuration\n * @param response - The handler response to generate audit payloads from\n * @param serviceDiscovery - Service discovery for registering audit storage\n * @param logger - Logger for debug/error messages\n * @param ctx - Request context (session, headers, cookies, services)\n * @param existingAuditor - Optional existing auditor instance (e.g., from handler context).\n *                          If provided, uses this auditor (with its stored transaction).\n *                          If not provided, creates a new auditor.\n */\nexport async function processEndpointAudits<\n  TServices extends Service[] = [],\n  TSession = unknown,\n  TLogger extends Logger = Logger,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TAuditStorage extends AuditStorage | undefined = undefined,\n  TAuditStorageServiceName extends string = string,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n>(\n  endpoint: Endpoint<\n    any,\n    any,\n    any,\n    OutSchema,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction\n  >,\n  response: InferStandardSchema<OutSchema>,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: TLogger,\n  ctx: {\n    session: TSession;\n    header: HeaderFn;\n    cookie: CookieFn;\n    services: Record<string, unknown>;\n  },\n  existingAuditor?: Auditor<TAuditAction>,\n): Promise<void> {\n  try {\n    const audits = endpoint.audits as MappedAudit<TAuditAction, OutSchema>[];\n\n    // If we have an existing auditor (from handler context), we need to flush\n    // any manual audits it collected, even if there are no declarative audits\n    const hasExistingRecords =\n      existingAuditor && existingAuditor.getRecords().length > 0;\n\n    // Skip if no declarative audits and no existing records to flush\n    if (!audits?.length && !hasExistingRecords) {\n      logger.debug('No audits to process');\n      return;\n    }\n\n    // If no auditor storage service and we have things to process, warn\n    if (!endpoint.auditorStorageService) {\n      if (hasExistingRecords || audits?.length) {\n        logger.warn('No auditor storage service available');\n      }\n      return;\n    }\n\n    // Get or create auditor\n    let auditor: Auditor<TAuditAction>;\n\n    if (existingAuditor) {\n      // Use existing auditor (preserves stored transaction and manual audits)\n      auditor = existingAuditor;\n      logger.debug('Using existing auditor from handler context');\n    } else {\n      // Create new auditor (backward compatibility)\n      const services = await serviceDiscovery.register([\n        endpoint.auditorStorageService,\n      ]);\n      const storage = services[\n        endpoint.auditorStorageService.serviceName\n      ] as AuditStorage;\n\n      // Extract actor if configured\n      let actor: AuditActor = { id: 'system', type: 'system' };\n      if (endpoint.actorExtractor) {\n        try {\n          actor = await (\n            endpoint.actorExtractor as ActorExtractor<\n              TServices,\n              TSession,\n              TLogger\n            >\n          )({\n            services: ctx.services as any,\n            session: ctx.session,\n            header: ctx.header,\n            cookie: ctx.cookie,\n            logger,\n          });\n        } catch (error) {\n          logger.error(error as Error, 'Failed to extract actor for audits');\n          // Continue with system actor\n        }\n      }\n\n      auditor = new DefaultAuditor<TAuditAction>({\n        actor,\n        storage,\n        metadata: {\n          endpoint: endpoint.route,\n          method: endpoint.method,\n        },\n      });\n    }\n\n    // Process each declarative audit\n    if (audits?.length) {\n      for (const audit of audits) {\n        logger.debug({ audit: audit.type }, 'Processing declarative audit');\n\n        // Check when condition\n        if (audit.when && !audit.when(response as any)) {\n          logger.debug(\n            { audit: audit.type },\n            'Audit skipped due to when condition',\n          );\n          continue;\n        }\n\n        // Extract payload\n        const payload = audit.payload(response as any);\n\n        // Extract entityId if configured\n        const entityId = audit.entityId?.(response as any);\n\n        // Record the audit\n        auditor.audit(audit.type as any, payload as any, {\n          table: audit.table,\n          entityId,\n        });\n      }\n    }\n\n    // Flush audits to storage\n    // Note: If existingAuditor has a stored transaction (via setTransaction),\n    // flush() will use it automatically\n    const recordCount = auditor.getRecords().length;\n    if (recordCount > 0) {\n      // Check if auditor has a stored transaction (for logging purposes)\n      const trx =\n        'getTransaction' in auditor\n          ? (auditor as { getTransaction(): unknown }).getTransaction()\n          : undefined;\n      logger.debug(\n        { auditCount: recordCount, hasTransaction: !!trx },\n        'Flushing audits',\n      );\n      await auditor.flush();\n    }\n  } catch (error) {\n    logger.error(error as Error, 'Failed to process audits');\n    // Don't rethrow - audit failures shouldn't fail the request\n  }\n}\n\n/**\n * Context for audit-aware handler execution.\n */\nexport interface AuditExecutionContext<\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n> {\n  /** The auditor instance for recording audits */\n  auditor: Auditor<TAuditAction>;\n  /** The audit storage instance */\n  storage: AuditStorage;\n}\n\n/**\n * Create audit context for handler execution.\n * Returns the auditor and storage for use in the handler.\n *\n * @param endpoint - The endpoint with audit configuration\n * @param serviceDiscovery - Service discovery for getting audit storage\n * @param logger - Logger for debug/error messages\n * @param ctx - Request context for actor extraction\n * @returns Audit context with auditor and storage, or undefined if not configured\n */\nexport async function createAuditContext<\n  TServices extends Service[] = [],\n  TSession = unknown,\n  TLogger extends Logger = Logger,\n  TAuditStorage extends AuditStorage | undefined = undefined,\n  TAuditStorageServiceName extends string = string,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n  TDatabase = undefined,\n  TDatabaseServiceName extends string = string,\n>(\n  endpoint: Endpoint<\n    any,\n    any,\n    any,\n    any,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  >,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: TLogger,\n  ctx: {\n    session: TSession;\n    header: HeaderFn;\n    cookie: CookieFn;\n    services: Record<string, unknown>;\n  },\n): Promise<AuditExecutionContext<TAuditAction> | undefined> {\n  if (!endpoint.auditorStorageService) {\n    return undefined;\n  }\n\n  const services = await serviceDiscovery.register([\n    endpoint.auditorStorageService,\n  ]);\n  const storage = services[\n    endpoint.auditorStorageService.serviceName\n  ] as AuditStorage;\n\n  // Extract actor if configured\n  let actor: AuditActor = { id: 'system', type: 'system' };\n  if (endpoint.actorExtractor) {\n    try {\n      actor = await (\n        endpoint.actorExtractor as ActorExtractor<TServices, TSession, TLogger>\n      )({\n        services: ctx.services as any,\n        session: ctx.session,\n        header: ctx.header,\n        cookie: ctx.cookie,\n        logger,\n      });\n    } catch (error) {\n      logger.error(error as Error, 'Failed to extract actor for audits');\n    }\n  }\n\n  const auditor = new DefaultAuditor<TAuditAction>({\n    actor,\n    storage,\n    metadata: {\n      endpoint: endpoint.route,\n      method: endpoint.method,\n    },\n  });\n\n  return { auditor, storage };\n}\n\n/**\n * Execute a handler with automatic audit transaction support.\n * If the audit storage has a database (via getDatabase()), wraps execution\n * in a transaction so audits are atomic with handler's database operations.\n *\n * @param auditContext - The audit context from createAuditContext\n * @param handler - The handler function to execute (receives auditor)\n * @param onComplete - Called after handler with response, to process declarative audits\n * @returns The handler result\n */\nexport async function executeWithAuditTransaction<\n  T,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n>(\n  auditContext: AuditExecutionContext<TAuditAction> | undefined,\n  handler: (auditor?: Auditor<TAuditAction>) => Promise<T>,\n  onComplete?: (response: T, auditor: Auditor<TAuditAction>) => Promise<void>,\n): Promise<T> {\n  // No audit context - just run handler\n  if (!auditContext) {\n    return handler(undefined);\n  }\n\n  const { auditor, storage } = auditContext;\n\n  // Check if storage has a database for transactional execution\n  const db = storage.getDatabase?.();\n\n  if (db) {\n    // Wrap in transaction - audits are atomic with handler operations\n    return withAuditableTransaction(db as any, auditor as any, async () => {\n      const response = await handler(auditor);\n\n      // Process declarative audits within the transaction\n      if (onComplete) {\n        await onComplete(response, auditor);\n      }\n\n      // Audits are flushed by withAuditableTransaction before commit\n      return response;\n    });\n  }\n\n  // No database - run handler and flush audits after\n  const response = await handler(auditor);\n\n  if (onComplete) {\n    await onComplete(response, auditor);\n  }\n\n  // Flush audits (no transaction)\n  await auditor.flush();\n\n  return response;\n}\n"],"mappings":"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"}

package/dist/publisher-Bw4770Hi.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"publisher-Bw4770Hi.mjs","names":["logger: Logger","serviceDiscovery: ServiceDiscovery<any, any>","ev: MappedEvent<T, OutSchema>[]","response: InferStandardSchema<OutSchema>","publisherService: TPublisherService","events: MappedEvent<T, OutSchema>[]","construct: Construct<Logger, TServiceName, T, OutSchema, TServices>"],"sources":["../src/publisher.ts"],"sourcesContent":["import type { Logger } from '@geekmidas/logger';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\n\nimport type { EventPublisher, MappedEvent } from '@geekmidas/events';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceDiscovery } from '@geekmidas/services';\nimport type { Construct } from './Construct';\n\nexport async function publishEvents<\n  T extends EventPublisher<any> | undefined,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServiceName extends string = string,\n  TPublisherService extends Service<TServiceName, T> | undefined = undefined,\n>(\n  logger: Logger,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  ev: MappedEvent<T, OutSchema>[] = [],\n  response: InferStandardSchema<OutSchema>,\n  publisherService: TPublisherService,\n) {\n  try {\n    if (!ev?.length) {\n      logger.debug('No events to publish');\n      return;\n    }\n    if (!publisherService) {\n      logger.warn('No publisher service available');\n      return;\n    }\n\n    const services = await serviceDiscovery.register([publisherService]);\n\n    const publisher = services[\n      publisherService.serviceName\n    ] as EventPublisher<any>;\n\n    const events: MappedEvent<T, OutSchema>[] = [];\n\n    for (const { when, payload, type, ...e } of ev) {\n      logger.debug({ event: type }, 'Processing event');\n      const resolvedPayload = await payload(response);\n      const event = {\n        ...e,\n        type,\n        payload: resolvedPayload,\n      };\n\n      if (!when || when(response as any)) {\n        events.push(event);\n      }\n    }\n\n    if (events.length) {\n      logger.debug({ eventCount: ev.length }, 'Publishing events');\n\n      await publisher.publish(events).catch((err) => {\n        logger.error(err, 'Failed to publish events');\n      });\n    }\n  } catch (error) {\n    logger.error(error as any, 'Something went wrong publishing events');\n  }\n}\n\nexport async function publishConstructEvents<\n  T extends EventPublisher<any> | undefined,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServiceName extends string = string,\n  TServices extends Service[] = [],\n>(\n  construct: Construct<Logger, TServiceName, T, OutSchema, TServices>,\n  response: InferStandardSchema<OutSchema>,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: Logger = construct.logger,\n) {\n  return publishEvents(\n    logger,\n    serviceDiscovery,\n    construct.events,\n    response,\n    construct.publisherService,\n  );\n}\n"],"mappings":";AAQA,eAAsB,cAMpBA,QACAC,kBACAC,KAAkC,CAAE,GACpCC,UACAC,kBACA;AACA,KAAI;AACF,OAAK,IAAI,QAAQ;AACf,UAAO,MAAM,uBAAuB;AACpC;EACD;AACD,OAAK,kBAAkB;AACrB,UAAO,KAAK,iCAAiC;AAC7C;EACD;EAED,MAAM,WAAW,MAAM,iBAAiB,SAAS,CAAC,gBAAiB,EAAC;EAEpE,MAAM,YAAY,SAChB,iBAAiB;EAGnB,MAAMC,SAAsC,CAAE;AAE9C,OAAK,MAAM,EAAE,MAAM,SAAS,KAAM,GAAG,GAAG,IAAI,IAAI;AAC9C,UAAO,MAAM,EAAE,OAAO,KAAM,GAAE,mBAAmB;GACjD,MAAM,kBAAkB,MAAM,QAAQ,SAAS;GAC/C,MAAM,QAAQ;IACZ,GAAG;IACH;IACA,SAAS;GACV;AAED,QAAK,QAAQ,KAAK,SAAgB,CAChC,QAAO,KAAK,MAAM;EAErB;AAED,MAAI,OAAO,QAAQ;AACjB,UAAO,MAAM,EAAE,YAAY,GAAG,OAAQ,GAAE,oBAAoB;AAE5D,SAAM,UAAU,QAAQ,OAAO,CAAC,MAAM,CAAC,QAAQ;AAC7C,WAAO,MAAM,KAAK,2BAA2B;GAC9C,EAAC;EACH;CACF,SAAQ,OAAO;AACd,SAAO,MAAM,OAAc,yCAAyC;CACrE;AACF;AAED,eAAsB,uBAMpBC,WACAH,UACAF,kBACAD,SAAiB,UAAU,QAC3B;AACA,QAAO,cACL,QACA,kBACA,UAAU,QACV,UACA,UAAU,iBACX;AACF"}
+{"version":3,"file":"publisher-Bw4770Hi.mjs","names":["logger: Logger","serviceDiscovery: ServiceDiscovery<any, any>","ev: MappedEvent<T, OutSchema>[]","response: InferStandardSchema<OutSchema>","publisherService: TPublisherService","events: MappedEvent<T, OutSchema>[]","construct: Construct<\n    Logger,\n    TServiceName,\n    T,\n    OutSchema,\n    TServices,\n    TAuditStorageServiceName,\n    TAuditStorage\n  >"],"sources":["../src/publisher.ts"],"sourcesContent":["import type { AuditStorage } from '@geekmidas/audit';\nimport type { Logger } from '@geekmidas/logger';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\n\nimport type { EventPublisher, MappedEvent } from '@geekmidas/events';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceDiscovery } from '@geekmidas/services';\nimport type { Construct } from './Construct';\n\nexport async function publishEvents<\n  T extends EventPublisher<any> | undefined,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServiceName extends string = string,\n  TPublisherService extends Service<TServiceName, T> | undefined = undefined,\n>(\n  logger: Logger,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  ev: MappedEvent<T, OutSchema>[] = [],\n  response: InferStandardSchema<OutSchema>,\n  publisherService: TPublisherService,\n) {\n  try {\n    if (!ev?.length) {\n      logger.debug('No events to publish');\n      return;\n    }\n    if (!publisherService) {\n      logger.warn('No publisher service available');\n      return;\n    }\n\n    const services = await serviceDiscovery.register([publisherService]);\n\n    const publisher = services[\n      publisherService.serviceName\n    ] as EventPublisher<any>;\n\n    const events: MappedEvent<T, OutSchema>[] = [];\n\n    for (const { when, payload, type, ...e } of ev) {\n      logger.debug({ event: type }, 'Processing event');\n      const resolvedPayload = await payload(response);\n      const event = {\n        ...e,\n        type,\n        payload: resolvedPayload,\n      };\n\n      if (!when || when(response as any)) {\n        events.push(event);\n      }\n    }\n\n    if (events.length) {\n      logger.debug({ eventCount: ev.length }, 'Publishing events');\n\n      await publisher.publish(events).catch((err) => {\n        logger.error(err, 'Failed to publish events');\n      });\n    }\n  } catch (error) {\n    logger.error(error as any, 'Something went wrong publishing events');\n  }\n}\n\nexport async function publishConstructEvents<\n  T extends EventPublisher<any> | undefined,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServiceName extends string = string,\n  TServices extends Service[] = [],\n  TAuditStorageServiceName extends string = string,\n  TAuditStorage extends AuditStorage | undefined = undefined,\n>(\n  construct: Construct<\n    Logger,\n    TServiceName,\n    T,\n    OutSchema,\n    TServices,\n    TAuditStorageServiceName,\n    TAuditStorage\n  >,\n  response: InferStandardSchema<OutSchema>,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: Logger = construct.logger,\n) {\n  return publishEvents(\n    logger,\n    serviceDiscovery,\n    construct.events,\n    response,\n    construct.publisherService,\n  );\n}\n"],"mappings":";AASA,eAAsB,cAMpBA,QACAC,kBACAC,KAAkC,CAAE,GACpCC,UACAC,kBACA;AACA,KAAI;AACF,OAAK,IAAI,QAAQ;AACf,UAAO,MAAM,uBAAuB;AACpC;EACD;AACD,OAAK,kBAAkB;AACrB,UAAO,KAAK,iCAAiC;AAC7C;EACD;EAED,MAAM,WAAW,MAAM,iBAAiB,SAAS,CAAC,gBAAiB,EAAC;EAEpE,MAAM,YAAY,SAChB,iBAAiB;EAGnB,MAAMC,SAAsC,CAAE;AAE9C,OAAK,MAAM,EAAE,MAAM,SAAS,KAAM,GAAG,GAAG,IAAI,IAAI;AAC9C,UAAO,MAAM,EAAE,OAAO,KAAM,GAAE,mBAAmB;GACjD,MAAM,kBAAkB,MAAM,QAAQ,SAAS;GAC/C,MAAM,QAAQ;IACZ,GAAG;IACH;IACA,SAAS;GACV;AAED,QAAK,QAAQ,KAAK,SAAgB,CAChC,QAAO,KAAK,MAAM;EAErB;AAED,MAAI,OAAO,QAAQ;AACjB,UAAO,MAAM,EAAE,YAAY,GAAG,OAAQ,GAAE,oBAAoB;AAE5D,SAAM,UAAU,QAAQ,OAAO,CAAC,MAAM,CAAC,QAAQ;AAC7C,WAAO,MAAM,KAAK,2BAA2B;GAC9C,EAAC;EACH;CACF,SAAQ,OAAO;AACd,SAAO,MAAM,OAAc,yCAAyC;CACrE;AACF;AAED,eAAsB,uBAQpBC,WASAH,UACAF,kBACAD,SAAiB,UAAU,QAC3B;AACA,QAAO,cACL,QACA,kBACA,UAAU,QACV,UACA,UAAU,iBACX;AACF"}

package/dist/publisher-lFQleddL.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"publisher-lFQleddL.cjs","names":["logger: Logger","serviceDiscovery: ServiceDiscovery<any, any>","ev: MappedEvent<T, OutSchema>[]","response: InferStandardSchema<OutSchema>","publisherService: TPublisherService","events: MappedEvent<T, OutSchema>[]","construct: Construct<Logger, TServiceName, T, OutSchema, TServices>"],"sources":["../src/publisher.ts"],"sourcesContent":["import type { Logger } from '@geekmidas/logger';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\n\nimport type { EventPublisher, MappedEvent } from '@geekmidas/events';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceDiscovery } from '@geekmidas/services';\nimport type { Construct } from './Construct';\n\nexport async function publishEvents<\n  T extends EventPublisher<any> | undefined,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServiceName extends string = string,\n  TPublisherService extends Service<TServiceName, T> | undefined = undefined,\n>(\n  logger: Logger,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  ev: MappedEvent<T, OutSchema>[] = [],\n  response: InferStandardSchema<OutSchema>,\n  publisherService: TPublisherService,\n) {\n  try {\n    if (!ev?.length) {\n      logger.debug('No events to publish');\n      return;\n    }\n    if (!publisherService) {\n      logger.warn('No publisher service available');\n      return;\n    }\n\n    const services = await serviceDiscovery.register([publisherService]);\n\n    const publisher = services[\n      publisherService.serviceName\n    ] as EventPublisher<any>;\n\n    const events: MappedEvent<T, OutSchema>[] = [];\n\n    for (const { when, payload, type, ...e } of ev) {\n      logger.debug({ event: type }, 'Processing event');\n      const resolvedPayload = await payload(response);\n      const event = {\n        ...e,\n        type,\n        payload: resolvedPayload,\n      };\n\n      if (!when || when(response as any)) {\n        events.push(event);\n      }\n    }\n\n    if (events.length) {\n      logger.debug({ eventCount: ev.length }, 'Publishing events');\n\n      await publisher.publish(events).catch((err) => {\n        logger.error(err, 'Failed to publish events');\n      });\n    }\n  } catch (error) {\n    logger.error(error as any, 'Something went wrong publishing events');\n  }\n}\n\nexport async function publishConstructEvents<\n  T extends EventPublisher<any> | undefined,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServiceName extends string = string,\n  TServices extends Service[] = [],\n>(\n  construct: Construct<Logger, TServiceName, T, OutSchema, TServices>,\n  response: InferStandardSchema<OutSchema>,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: Logger = construct.logger,\n) {\n  return publishEvents(\n    logger,\n    serviceDiscovery,\n    construct.events,\n    response,\n    construct.publisherService,\n  );\n}\n"],"mappings":";;AAQA,eAAsB,cAMpBA,QACAC,kBACAC,KAAkC,CAAE,GACpCC,UACAC,kBACA;AACA,KAAI;AACF,OAAK,IAAI,QAAQ;AACf,UAAO,MAAM,uBAAuB;AACpC;EACD;AACD,OAAK,kBAAkB;AACrB,UAAO,KAAK,iCAAiC;AAC7C;EACD;EAED,MAAM,WAAW,MAAM,iBAAiB,SAAS,CAAC,gBAAiB,EAAC;EAEpE,MAAM,YAAY,SAChB,iBAAiB;EAGnB,MAAMC,SAAsC,CAAE;AAE9C,OAAK,MAAM,EAAE,MAAM,SAAS,KAAM,GAAG,GAAG,IAAI,IAAI;AAC9C,UAAO,MAAM,EAAE,OAAO,KAAM,GAAE,mBAAmB;GACjD,MAAM,kBAAkB,MAAM,QAAQ,SAAS;GAC/C,MAAM,QAAQ;IACZ,GAAG;IACH;IACA,SAAS;GACV;AAED,QAAK,QAAQ,KAAK,SAAgB,CAChC,QAAO,KAAK,MAAM;EAErB;AAED,MAAI,OAAO,QAAQ;AACjB,UAAO,MAAM,EAAE,YAAY,GAAG,OAAQ,GAAE,oBAAoB;AAE5D,SAAM,UAAU,QAAQ,OAAO,CAAC,MAAM,CAAC,QAAQ;AAC7C,WAAO,MAAM,KAAK,2BAA2B;GAC9C,EAAC;EACH;CACF,SAAQ,OAAO;AACd,SAAO,MAAM,OAAc,yCAAyC;CACrE;AACF;AAED,eAAsB,uBAMpBC,WACAH,UACAF,kBACAD,SAAiB,UAAU,QAC3B;AACA,QAAO,cACL,QACA,kBACA,UAAU,QACV,UACA,UAAU,iBACX;AACF"}
+{"version":3,"file":"publisher-lFQleddL.cjs","names":["logger: Logger","serviceDiscovery: ServiceDiscovery<any, any>","ev: MappedEvent<T, OutSchema>[]","response: InferStandardSchema<OutSchema>","publisherService: TPublisherService","events: MappedEvent<T, OutSchema>[]","construct: Construct<\n    Logger,\n    TServiceName,\n    T,\n    OutSchema,\n    TServices,\n    TAuditStorageServiceName,\n    TAuditStorage\n  >"],"sources":["../src/publisher.ts"],"sourcesContent":["import type { AuditStorage } from '@geekmidas/audit';\nimport type { Logger } from '@geekmidas/logger';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\n\nimport type { EventPublisher, MappedEvent } from '@geekmidas/events';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceDiscovery } from '@geekmidas/services';\nimport type { Construct } from './Construct';\n\nexport async function publishEvents<\n  T extends EventPublisher<any> | undefined,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServiceName extends string = string,\n  TPublisherService extends Service<TServiceName, T> | undefined = undefined,\n>(\n  logger: Logger,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  ev: MappedEvent<T, OutSchema>[] = [],\n  response: InferStandardSchema<OutSchema>,\n  publisherService: TPublisherService,\n) {\n  try {\n    if (!ev?.length) {\n      logger.debug('No events to publish');\n      return;\n    }\n    if (!publisherService) {\n      logger.warn('No publisher service available');\n      return;\n    }\n\n    const services = await serviceDiscovery.register([publisherService]);\n\n    const publisher = services[\n      publisherService.serviceName\n    ] as EventPublisher<any>;\n\n    const events: MappedEvent<T, OutSchema>[] = [];\n\n    for (const { when, payload, type, ...e } of ev) {\n      logger.debug({ event: type }, 'Processing event');\n      const resolvedPayload = await payload(response);\n      const event = {\n        ...e,\n        type,\n        payload: resolvedPayload,\n      };\n\n      if (!when || when(response as any)) {\n        events.push(event);\n      }\n    }\n\n    if (events.length) {\n      logger.debug({ eventCount: ev.length }, 'Publishing events');\n\n      await publisher.publish(events).catch((err) => {\n        logger.error(err, 'Failed to publish events');\n      });\n    }\n  } catch (error) {\n    logger.error(error as any, 'Something went wrong publishing events');\n  }\n}\n\nexport async function publishConstructEvents<\n  T extends EventPublisher<any> | undefined,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServiceName extends string = string,\n  TServices extends Service[] = [],\n  TAuditStorageServiceName extends string = string,\n  TAuditStorage extends AuditStorage | undefined = undefined,\n>(\n  construct: Construct<\n    Logger,\n    TServiceName,\n    T,\n    OutSchema,\n    TServices,\n    TAuditStorageServiceName,\n    TAuditStorage\n  >,\n  response: InferStandardSchema<OutSchema>,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: Logger = construct.logger,\n) {\n  return publishEvents(\n    logger,\n    serviceDiscovery,\n    construct.events,\n    response,\n    construct.publisherService,\n  );\n}\n"],"mappings":";;AASA,eAAsB,cAMpBA,QACAC,kBACAC,KAAkC,CAAE,GACpCC,UACAC,kBACA;AACA,KAAI;AACF,OAAK,IAAI,QAAQ;AACf,UAAO,MAAM,uBAAuB;AACpC;EACD;AACD,OAAK,kBAAkB;AACrB,UAAO,KAAK,iCAAiC;AAC7C;EACD;EAED,MAAM,WAAW,MAAM,iBAAiB,SAAS,CAAC,gBAAiB,EAAC;EAEpE,MAAM,YAAY,SAChB,iBAAiB;EAGnB,MAAMC,SAAsC,CAAE;AAE9C,OAAK,MAAM,EAAE,MAAM,SAAS,KAAM,GAAG,GAAG,IAAI,IAAI;AAC9C,UAAO,MAAM,EAAE,OAAO,KAAM,GAAE,mBAAmB;GACjD,MAAM,kBAAkB,MAAM,QAAQ,SAAS;GAC/C,MAAM,QAAQ;IACZ,GAAG;IACH;IACA,SAAS;GACV;AAED,QAAK,QAAQ,KAAK,SAAgB,CAChC,QAAO,KAAK,MAAM;EAErB;AAED,MAAI,OAAO,QAAQ;AACjB,UAAO,MAAM,EAAE,YAAY,GAAG,OAAQ,GAAE,oBAAoB;AAE5D,SAAM,UAAU,QAAQ,OAAO,CAAC,MAAM,CAAC,QAAQ;AAC7C,WAAO,MAAM,KAAK,2BAA2B;GAC9C,EAAC;EACH;CACF,SAAQ,OAAO;AACd,SAAO,MAAM,OAAc,yCAAyC;CACrE;AACF;AAED,eAAsB,uBAQpBC,WASAH,UACAF,kBACAD,SAAiB,UAAU,QAC3B;AACA,QAAO,cACL,QACA,kBACA,UAAU,QACV,UACA,UAAU,iBACX;AACF"}

package/dist/publisher.d.cts

@@ -1,4 +1,5 @@
 import { Construct } from "./Construct-dI_rgdSp.cjs";
+import { AuditStorage } from "@geekmidas/audit";
 import { EventPublisher, MappedEvent } from "@geekmidas/events";
 import { Logger } from "@geekmidas/logger";
 import { Service, ServiceDiscovery } from "@geekmidas/services";
@@ -7,7 +8,7 @@ import { InferStandardSchema } from "@geekmidas/schema";
 
 //#region src/publisher.d.ts
 declare function publishEvents<T extends EventPublisher<any> | undefined, OutSchema extends StandardSchemaV1 | undefined = undefined, TServiceName extends string = string, TPublisherService extends Service<TServiceName, T> | undefined = undefined>(logger: Logger, serviceDiscovery: ServiceDiscovery<any, any>, ev: MappedEvent<T, OutSchema>[] | undefined, response: InferStandardSchema<OutSchema>, publisherService: TPublisherService): Promise<void>;
-declare function publishConstructEvents<T extends EventPublisher<any> | undefined, OutSchema extends StandardSchemaV1 | undefined = undefined, TServiceName extends string = string, TServices extends Service[] = []>(construct: Construct<Logger, TServiceName, T, OutSchema, TServices>, response: InferStandardSchema<OutSchema>, serviceDiscovery: ServiceDiscovery<any, any>, logger?: Logger): Promise<void>;
+declare function publishConstructEvents<T extends EventPublisher<any> | undefined, OutSchema extends StandardSchemaV1 | undefined = undefined, TServiceName extends string = string, TServices extends Service[] = [], TAuditStorageServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined>(construct: Construct<Logger, TServiceName, T, OutSchema, TServices, TAuditStorageServiceName, TAuditStorage>, response: InferStandardSchema<OutSchema>, serviceDiscovery: ServiceDiscovery<any, any>, logger?: Logger): Promise<void>;
 //#endregion
 export { publishConstructEvents, publishEvents };
 //# sourceMappingURL=publisher.d.cts.map

package/dist/publisher.d.mts

@@ -1,5 +1,6 @@
 import { Construct } from "./Construct-ZPqE0vhn.mjs";
 import { Service, ServiceDiscovery } from "@geekmidas/services";
+import { AuditStorage } from "@geekmidas/audit";
 import { EventPublisher, MappedEvent } from "@geekmidas/events";
 import { Logger } from "@geekmidas/logger";
 import { StandardSchemaV1 } from "@standard-schema/spec";
@@ -7,7 +8,7 @@ import { InferStandardSchema } from "@geekmidas/schema";
 
 //#region src/publisher.d.ts
 declare function publishEvents<T extends EventPublisher<any> | undefined, OutSchema extends StandardSchemaV1 | undefined = undefined, TServiceName extends string = string, TPublisherService extends Service<TServiceName, T> | undefined = undefined>(logger: Logger, serviceDiscovery: ServiceDiscovery<any, any>, ev: MappedEvent<T, OutSchema>[] | undefined, response: InferStandardSchema<OutSchema>, publisherService: TPublisherService): Promise<void>;
-declare function publishConstructEvents<T extends EventPublisher<any> | undefined, OutSchema extends StandardSchemaV1 | undefined = undefined, TServiceName extends string = string, TServices extends Service[] = []>(construct: Construct<Logger, TServiceName, T, OutSchema, TServices>, response: InferStandardSchema<OutSchema>, serviceDiscovery: ServiceDiscovery<any, any>, logger?: Logger): Promise<void>;
+declare function publishConstructEvents<T extends EventPublisher<any> | undefined, OutSchema extends StandardSchemaV1 | undefined = undefined, TServiceName extends string = string, TServices extends Service[] = [], TAuditStorageServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined>(construct: Construct<Logger, TServiceName, T, OutSchema, TServices, TAuditStorageServiceName, TAuditStorage>, response: InferStandardSchema<OutSchema>, serviceDiscovery: ServiceDiscovery<any, any>, logger?: Logger): Promise<void>;
 //#endregion
 export { publishConstructEvents, publishEvents };
 //# sourceMappingURL=publisher.d.mts.map

package/dist/subscribers/Subscriber.cjs

@@ -1,4 +1,4 @@
 require('../Construct-BYSPikVm.cjs');
-const require_Subscriber = require('../Subscriber-D-FPWts6.cjs');
+const require_Subscriber = require('../Subscriber-Bdh8rMSL.cjs');
 
 exports.Subscriber = require_Subscriber.Subscriber;

package/dist/subscribers/Subscriber.mjs

@@ -1,4 +1,4 @@
 import "../Construct-LWeB1rSQ.mjs";
-import { Subscriber } from "../Subscriber-CGb8LjZa.mjs";
+import { Subscriber } from "../Subscriber-CJOWwaw1.mjs";
 
 export { Subscriber };

package/dist/subscribers/SubscriberBuilder.cjs

@@ -1,5 +1,5 @@
 require('../Construct-BYSPikVm.cjs');
-require('../Subscriber-D-FPWts6.cjs');
-const require_SubscriberBuilder = require('../SubscriberBuilder-BfE2cL1q.cjs');
+require('../Subscriber-Bdh8rMSL.cjs');
+const require_SubscriberBuilder = require('../SubscriberBuilder-DieD_60p.cjs');
 
 exports.SubscriberBuilder = require_SubscriberBuilder.SubscriberBuilder;

package/dist/subscribers/SubscriberBuilder.mjs

@@ -1,5 +1,5 @@
 import "../Construct-LWeB1rSQ.mjs";
-import "../Subscriber-CGb8LjZa.mjs";
-import { SubscriberBuilder } from "../SubscriberBuilder-BcAspHv9.mjs";
+import "../Subscriber-CJOWwaw1.mjs";
+import { SubscriberBuilder } from "../SubscriberBuilder-BWQmiYd8.mjs";
 
 export { SubscriberBuilder };

package/dist/subscribers/index.cjs

@@ -1,6 +1,6 @@
 require('../Construct-BYSPikVm.cjs');
-const require_Subscriber = require('../Subscriber-D-FPWts6.cjs');
-const require_SubscriberBuilder = require('../SubscriberBuilder-BfE2cL1q.cjs');
+const require_Subscriber = require('../Subscriber-Bdh8rMSL.cjs');
+const require_SubscriberBuilder = require('../SubscriberBuilder-DieD_60p.cjs');
 
 //#region src/subscribers/index.ts
 const s = new require_SubscriberBuilder.SubscriberBuilder();

package/dist/subscribers/index.d.cts

@@ -1,10 +1,10 @@
 import "../Construct-dI_rgdSp.cjs";
 import { Subscriber } from "../Subscriber-BhzqUzs-.cjs";
 import { SubscriberBuilder } from "../SubscriberBuilder-BCVkp-ga.cjs";
-import * as _geekmidas_logger2 from "@geekmidas/logger";
+import * as _geekmidas_logger4 from "@geekmidas/logger";
 
 //#region src/subscribers/index.d.ts
-declare const s: SubscriberBuilder<[], _geekmidas_logger2.Logger, undefined, undefined, string, []>;
+declare const s: SubscriberBuilder<[], _geekmidas_logger4.Logger, undefined, undefined, string, []>;
 //#endregion
 export { Subscriber, SubscriberBuilder, s };
 //# sourceMappingURL=index.d.cts.map

package/dist/subscribers/index.d.mts

@@ -1,10 +1,10 @@
 import "../Construct-ZPqE0vhn.mjs";
 import { Subscriber } from "../Subscriber-s6yfjeOc.mjs";
 import { SubscriberBuilder } from "../SubscriberBuilder-aCua5_wA.mjs";
-import * as _geekmidas_logger14 from "@geekmidas/logger";
+import * as _geekmidas_logger6 from "@geekmidas/logger";
 
 //#region src/subscribers/index.d.ts
-declare const s: SubscriberBuilder<[], _geekmidas_logger14.Logger, undefined, undefined, string, []>;
+declare const s: SubscriberBuilder<[], _geekmidas_logger6.Logger, undefined, undefined, string, []>;
 //#endregion
 export { Subscriber, SubscriberBuilder, s };
 //# sourceMappingURL=index.d.mts.map

package/dist/subscribers/index.mjs

@@ -1,6 +1,6 @@
 import "../Construct-LWeB1rSQ.mjs";
-import { Subscriber } from "../Subscriber-CGb8LjZa.mjs";
-import { SubscriberBuilder } from "../SubscriberBuilder-BcAspHv9.mjs";
+import { Subscriber } from "../Subscriber-CJOWwaw1.mjs";
+import { SubscriberBuilder } from "../SubscriberBuilder-BWQmiYd8.mjs";
 
 //#region src/subscribers/index.ts
 const s = new SubscriberBuilder();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/constructs",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "private": false,
   "type": "module",
   "exports": {
@@ -66,14 +66,14 @@
     "lodash.set": "~4.3.2",
     "lodash.uniqby": "~4.7.0",
     "openapi-types": "~12.1.3",
+    "@geekmidas/audit": "0.0.4",
+    "@geekmidas/errors": "0.0.1",
     "@geekmidas/cache": "0.0.7",
-    "@geekmidas/audit": "0.0.1",
-    "@geekmidas/logger": "0.0.1",
-    "@geekmidas/rate-limit": "0.1.0",
-    "@geekmidas/schema": "0.0.2",
-    "@geekmidas/services": "0.0.1",
     "@geekmidas/events": "0.0.2",
-    "@geekmidas/errors": "0.0.1"
+    "@geekmidas/services": "0.0.1",
+    "@geekmidas/schema": "0.0.2",
+    "@geekmidas/rate-limit": "0.1.0",
+    "@geekmidas/logger": "0.0.1"
   },
   "devDependencies": {
     "@types/lodash.compact": "~3.0.9",

package/src/crons/Cron.ts

@@ -15,14 +15,20 @@ export class Cron<
   OutSchema extends StandardSchemaV1 | undefined = undefined,
   TEventPublisher extends EventPublisher<any> | undefined = undefined,
   TEventPublisherServiceName extends string = string,
+  TDatabase = undefined,
+  TDatabaseServiceName extends string = string,
 > extends Function<
   TInput,
   TServices,
   TLogger,
   OutSchema,
-  FunctionHandler<TInput, TServices, TLogger, OutSchema>,
+  FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>,
   TEventPublisher,
-  TEventPublisherServiceName
+  TEventPublisherServiceName,
+  undefined,
+  string,
+  TDatabase,
+  TDatabaseServiceName
 > {
   static isCron(obj: any): obj is Cron<any, any, any, any> {
     return Boolean(
@@ -33,7 +39,7 @@ export class Cron<
   }
 
   constructor(
-    fn: FunctionHandler<TInput, TServices, TLogger, OutSchema>,
+    fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>,
     timeout?: number,
     protected _schedule?: ScheduleExpression,
     input?: TInput,
@@ -43,6 +49,7 @@ export class Cron<
     publisherService?: Service<TEventPublisherServiceName, TEventPublisher>,
     events: any[] = [],
     memorySize?: number,
+    databaseService?: Service<TDatabaseServiceName, TDatabase>,
   ) {
     super(
       fn,
@@ -55,6 +62,8 @@ export class Cron<
       publisherService,
       events,
       memorySize,
+      undefined, // auditorStorageService
+      databaseService,
     );
   }
 

package/src/crons/CronBuilder.ts

@@ -19,13 +19,19 @@ export class CronBuilder<
   OutSchema extends StandardSchemaV1 | undefined = undefined,
   TEventPublisher extends EventPublisher<any> | undefined = undefined,
   TEventPublisherServiceName extends string = string,
+  TDatabase = undefined,
+  TDatabaseServiceName extends string = string,
 > extends FunctionBuilder<
   TInput,
   OutSchema,
   TServices,
   TLogger,
   TEventPublisher,
-  TEventPublisherServiceName
+  TEventPublisherServiceName,
+  undefined,
+  string,
+  TDatabase,
+  TDatabaseServiceName
 > {
   private _schedule?: ScheduleExpression;
 
@@ -46,7 +52,9 @@ export class CronBuilder<
     TLogger,
     OutSchema,
     TEventPublisher,
-    TEventPublisherServiceName
+    TEventPublisherServiceName,
+    TDatabase,
+    TDatabaseServiceName
   > {
     this._schedule = _expression;
     return this;
@@ -60,7 +68,9 @@ export class CronBuilder<
     TLogger,
     OutSchema,
     TEventPublisher,
-    TEventPublisherServiceName
+    TEventPublisherServiceName,
+    TDatabase,
+    TDatabaseServiceName
   > {
     this.inputSchema = schema as unknown as TInput;
 
@@ -70,7 +80,9 @@ export class CronBuilder<
       TLogger,
       OutSchema,
       TEventPublisher,
-      TEventPublisherServiceName
+      TEventPublisherServiceName,
+      TDatabase,
+      TDatabaseServiceName
     >;
   }
 
@@ -82,7 +94,9 @@ export class CronBuilder<
     TLogger,
     T,
     TEventPublisher,
-    TEventPublisherServiceName
+    TEventPublisherServiceName,
+    TDatabase,
+    TDatabaseServiceName
   > {
     this.outputSchema = schema as unknown as OutSchema;
 
@@ -92,7 +106,9 @@ export class CronBuilder<
       TLogger,
       T,
       TEventPublisher,
-      TEventPublisherServiceName
+      TEventPublisherServiceName,
+      TDatabase,
+      TDatabaseServiceName
     >;
   }
 
@@ -104,7 +120,9 @@ export class CronBuilder<
     TLogger,
     OutSchema,
     TEventPublisher,
-    TEventPublisherServiceName
+    TEventPublisherServiceName,
+    TDatabase,
+    TDatabaseServiceName
   > {
     this._services = uniqBy(
       [...this._services, ...services],
@@ -117,7 +135,9 @@ export class CronBuilder<
       TLogger,
       OutSchema,
       TEventPublisher,
-      TEventPublisherServiceName
+      TEventPublisherServiceName,
+      TDatabase,
+      TDatabaseServiceName
     >;
   }
 
@@ -129,7 +149,9 @@ export class CronBuilder<
     T,
     OutSchema,
     TEventPublisher,
-    TEventPublisherServiceName
+    TEventPublisherServiceName,
+    TDatabase,
+    TDatabaseServiceName
   > {
     this._logger = logger as unknown as TLogger;
 
@@ -139,13 +161,24 @@ export class CronBuilder<
       T,
       OutSchema,
       TEventPublisher,
-      TEventPublisherServiceName
+      TEventPublisherServiceName,
+      TDatabase,
+      TDatabaseServiceName
     >;
   }
 
   publisher<T extends EventPublisher<any>, TName extends string>(
     publisher: Service<TName, T>,
-  ): CronBuilder<TInput, TServices, TLogger, OutSchema, T, TName> {
+  ): CronBuilder<
+    TInput,
+    TServices,
+    TLogger,
+    OutSchema,
+    T,
+    TName,
+    TDatabase,
+    TDatabaseServiceName
+  > {
     this._publisher = publisher as unknown as Service<
       TEventPublisherServiceName,
       TEventPublisher
@@ -157,19 +190,56 @@ export class CronBuilder<
       TLogger,
       OutSchema,
       T,
+      TName,
+      TDatabase,
+      TDatabaseServiceName
+    >;
+  }
+
+  /**
+   * Set the database service for this cron job.
+   * The database will be available in the handler context as `db`.
+   */
+  database<T, TName extends string>(
+    service: Service<TName, T>,
+  ): CronBuilder<
+    TInput,
+    TServices,
+    TLogger,
+    OutSchema,
+    TEventPublisher,
+    TEventPublisherServiceName,
+    T,
+    TName
+  > {
+    this._databaseService = service as unknown as Service<
+      TDatabaseServiceName,
+      TDatabase
+    >;
+
+    return this as unknown as CronBuilder<
+      TInput,
+      TServices,
+      TLogger,
+      OutSchema,
+      TEventPublisher,
+      TEventPublisherServiceName,
+      T,
       TName
     >;
   }
 
   handle(
-    fn: FunctionHandler<TInput, TServices, TLogger, OutSchema>,
+    fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>,
   ): Cron<
     TInput,
     TServices,
     TLogger,
     OutSchema,
     TEventPublisher,
-    TEventPublisherServiceName
+    TEventPublisherServiceName,
+    TDatabase,
+    TDatabaseServiceName
   > {
     const cron = new Cron(
       fn,
@@ -182,6 +252,7 @@ export class CronBuilder<
       this._publisher,
       this._events,
       this._memorySize,
+      this._databaseService,
     );
 
     // Reset builder state after creating the cron to prevent pollution
@@ -189,6 +260,7 @@ export class CronBuilder<
     this._logger = DEFAULT_LOGGER;
     this._events = [];
     this._publisher = undefined;
+    this._databaseService = undefined;
     this._schedule = undefined;
     this.inputSchema = undefined;
     this.outputSchema = undefined;

package/src/crons/__tests__/CronBuilder.state-isolation.spec.ts

@@ -1,7 +1,7 @@
-import { describe, expect, it } from 'vitest';
 import { ConsoleLogger } from '@geekmidas/logger/console';
-import { CronBuilder } from '../CronBuilder';
 import type { Service } from '@geekmidas/services';
+import { describe, expect, it } from 'vitest';
+import { CronBuilder } from '../CronBuilder';
 
 const ServiceA = {
   serviceName: 'a' as const,

package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts

@@ -1,4 +1,4 @@
-import type { AuditableAction, Auditor, AuditStorage } from '@geekmidas/audit';
+import type { AuditStorage, AuditableAction } from '@geekmidas/audit';
 import type { Logger } from '@geekmidas/logger';
 import type { StandardSchemaV1 } from '@standard-schema/spec';
 import type { HttpMethod } from '../types';
@@ -30,12 +30,12 @@ import type {
   InferStandardSchema,
 } from '@geekmidas/schema';
 import { publishConstructEvents } from '../publisher';
+import type { CookieFn, HeaderFn } from './Endpoint';
+import type { MappedAudit } from './audit';
 import {
-  type AuditExecutionContext,
   createAuditContext,
   executeWithAuditTransaction,
 } from './processAudits';
-import type { MappedAudit } from './audit';
 
 // Helper function to publish events
 
@@ -259,15 +259,37 @@ export abstract class AmazonApiGatewayEndpoint<
     );
 
     // Warn if declarative audits are configured but no audit storage
-    const audits = this.endpoint.audits as MappedAudit<TAuditAction, TOutSchema>[];
+    const audits = this.endpoint.audits as MappedAudit<
+      TAuditAction,
+      TOutSchema
+    >[];
     if (!auditContext && audits?.length) {
       logger.warn('No auditor storage service available');
     }
 
+    // Resolve database service if configured
+    const rawDb = this.endpoint.databaseService
+      ? await serviceDiscovery
+          .register([this.endpoint.databaseService])
+          .then(
+            (s) =>
+              s[this.endpoint.databaseService!.serviceName as keyof typeof s],
+          )
+      : undefined;
+
     // Execute handler with automatic audit transaction support
     const result = await executeWithAuditTransaction(
       auditContext,
       async (auditor) => {
+        // Use audit transaction as db only if the storage uses the same database service
+        const sameDatabase =
+          auditContext?.storage?.databaseServiceName &&
+          auditContext.storage.databaseServiceName ===
+            this.endpoint.databaseService?.serviceName;
+        const db = sameDatabase
+          ? (auditor?.getTransaction?.() ?? rawDb)
+          : rawDb;
+
         const responseBuilder = new ResponseBuilder();
         const response = await this.endpoint.handler(
           {
@@ -277,6 +299,7 @@ export abstract class AmazonApiGatewayEndpoint<
             services: event.services,
             session: event.session,
             auditor,
+            db,
             ...input,
           } as any,
           responseBuilder,
@@ -374,8 +397,8 @@ export type Event<
 > = {
   services: ServiceRecord<TServices>;
   logger: TLogger;
-  header(key: string): string | undefined;
-  cookie(name: string): string | undefined;
+  header: HeaderFn;
+  cookie: CookieFn;
   session: TSession;
 } & TEvent &
   InferComposableStandardSchema<TInput>;