@better-zap/hono 0.1.0 → 0.2.1

package/dist/index.d.cts

@@ -1,29 +1,6 @@
-import { BetterZapApi, BetterZapApi as BetterZapApi$1, BetterZapContext, BetterZapContext as BetterZapContext$1, BetterZapCoreConfig, BetterZapCoreConfig as BetterZapCoreConfig$1, BetterZapDatabase, BetterZapDatabase as BetterZapDatabase$1, BetterZapPlugin, BetterZapPlugin as BetterZapPlugin$1, BetterZapPluginInitContext, BetterZapPluginInitResult, BetterZapServices, BetterZapServices as BetterZapServices$1, IncomingMessage, InferBetterZapPluginContext, InferBetterZapPluginContext as InferBetterZapPluginContext$1, InferBetterZapPluginServices, InferBetterZapPluginServices as InferBetterZapPluginServices$1, Logger, LoggerConfig, MessageContext, MessageContext as MessageContext$1, MessageLoggerService, StatusContext, StatusContext as StatusContext$1, TemplateRegistry, WebhookError, WhatsAppLogStore, WhatsAppService } from "better-zap";
+import { BetterZapApi, BetterZapApi as BetterZapApi$1, BetterZapContext, BetterZapContext as BetterZapContext$1, BetterZapCoreConfig, BetterZapCoreConfig as BetterZapCoreConfig$1, BetterZapDatabase, BetterZapDatabase as BetterZapDatabase$1, BetterZapPlugin, BetterZapPlugin as BetterZapPlugin$1, BetterZapPluginInitContext, BetterZapPluginInitResult, BetterZapServices, BetterZapServices as BetterZapServices$1, CoexistenceAccountOffboardedValue, CoexistenceAccountReconnectedValue, CoexistenceAccountUpdateValue, CoexistenceCredentialProvider, CoexistenceHistoryValue, CoexistenceMessageEditValue, CoexistenceMessageRevokeValue, CoexistenceService, CoexistenceSmbAppStateSyncValue, CoexistenceSmbMessageEchoesValue, CoexistenceStore, CoexistenceUnsupportedValue, IncomingMessage, InferBetterZapPluginContext, InferBetterZapPluginContext as InferBetterZapPluginContext$1, InferBetterZapPluginServices, InferBetterZapPluginServices as InferBetterZapPluginServices$1, Logger, LoggerConfig, MessageContext, MessageContext as MessageContext$1, MessageLoggerService, StatusContext, StatusContext as StatusContext$1, TemplateRegistry, WebhookChange, WebhookError, WhatsAppLogStore, WhatsAppService } from "better-zap";
 import { Hono } from "hono";
 
-//#region src/better-zap.types.d.ts
-interface BetterZapConfig<TDatabase extends BetterZapDatabase$1 = BetterZapDatabase$1, TPlugins extends readonly BetterZapPlugin$1<TDatabase, any, any>[] = readonly [], TTemplates extends TemplateRegistry = {}> {
-  database: TDatabase;
-  config: BetterZapCoreConfig$1;
-  plugins?: TPlugins;
-  templates?: TTemplates;
-  conversationSync?: DurableObjectNamespace<any>;
-  webhook: {
-    onMessage: (ctx: MessageContext$1 & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
-    onStatusUpdate: (ctx: StatusContext$1 & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
-  };
-  basePath?: string;
-  logger?: LoggerConfig;
-}
-interface BetterZap<TPluginServices extends Record<string, unknown> = {}, TTemplates extends TemplateRegistry = {}> {
-  handler: (request: Request, env?: any, executionCtx?: any) => Promise<Response>;
-  api: BetterZapApi$1<TTemplates>;
-  services: BetterZapServices$1<TPluginServices>;
-}
-//#endregion
-//#region src/better-zap.d.ts
-declare function betterZap<TDatabase extends BetterZapDatabase$1 = BetterZapDatabase$1, TPlugins extends readonly BetterZapPlugin$1<TDatabase, any, any>[] = readonly BetterZapPlugin$1<TDatabase, any, any>[], TTemplates extends TemplateRegistry = {}>(options: BetterZapConfig<TDatabase, TPlugins, TTemplates>): BetterZap<InferBetterZapPluginServices$1<TPlugins>, TTemplates>;
-//#endregion
 //#region src/webhook/create-webhook-handler.d.ts
 /**
  * Configuration for {@link createWebhookHandler}.
@@ -34,15 +11,70 @@ type WebhookConfig = {
   /** Token for the Meta verification challenge (`GET /webhook`). */verifyToken: string; /** App secret used for HMAC-SHA256 signature verification. */
   appSecret: string; /** logger for automatic message storage. */
   logger: MessageLoggerService; /** Structured logger for operational logging. */
-  log: Logger; /** Called once per incoming message, after SDK pre-processing. */
+  log: Logger; /** Optional database contracts used for automatic coexistence persistence. */
+  database?: BetterZapDatabase$1; /** Called once per incoming message, after SDK pre-processing. */
   onMessage: (ctx: MessageContext$1) => Promise<void>; /** Called once per delivery status update (sent → delivered → read → failed). */
-  onStatusUpdate: (ctx: StatusContext$1) => Promise<void>;
+  onStatusUpdate: (ctx: StatusContext$1) => Promise<void>; /** Called once per history webhook after SDK pre-processing. */
+  onCoexistenceHistory?: (ctx: CoexistenceHistoryContext) => Promise<void>; /** Called once per SMB app state sync webhook after SDK pre-processing. */
+  onSmbAppStateSync?: (ctx: SmbAppStateSyncContext) => Promise<void>; /** Called once per app message echo webhook after SDK pre-processing. */
+  onSmbMessageEcho?: (ctx: SmbMessageEchoContext) => Promise<void>; /** Called once per coexistence account lifecycle webhook. */
+  onCoexistenceAccountUpdate?: (ctx: CoexistenceAccountUpdateContext) => Promise<void>; /** Called once per coexistence offboarding lifecycle webhook. */
+  onCoexistenceAccountOffboarded?: (ctx: CoexistenceAccountOffboardedContext) => Promise<void>; /** Called once per coexistence background reconnection lifecycle webhook. */
+  onCoexistenceAccountReconnected?: (ctx: CoexistenceAccountReconnectedContext) => Promise<void>; /** Called for coexistence message edit webhooks. */
+  onCoexistenceMessageEdit?: (ctx: CoexistenceMessageEditContext) => Promise<void>; /** Called for coexistence message revoke webhooks. */
+  onCoexistenceMessageRevoke?: (ctx: CoexistenceMessageRevokeContext) => Promise<void>; /** Called when a coexistence webhook contains unsupported/error content. */
+  onCoexistenceUnsupportedMessage?: (ctx: CoexistenceUnsupportedMessageContext) => Promise<void>;
   /**
    * Called for Meta platform-level errors.
    * @default Uses the configured {@link WebhookConfig.log} logger's {@code error} method.
    */
   onError?: (error: WebhookError) => void;
 };
+interface CoexistenceHistoryContext {
+  value: CoexistenceHistoryValue;
+  change: WebhookChange;
+  importedMessages: number;
+  duplicateMessages: number;
+}
+interface SmbAppStateSyncContext {
+  value: CoexistenceSmbAppStateSyncValue;
+  change: WebhookChange;
+  upsertedContacts: number;
+  removedContacts: number;
+}
+interface SmbMessageEchoContext {
+  value: CoexistenceSmbMessageEchoesValue;
+  change: WebhookChange;
+  importedMessages: number;
+  duplicateMessages: number;
+}
+interface CoexistenceAccountUpdateContext {
+  value: CoexistenceAccountUpdateValue;
+  change: WebhookChange;
+}
+interface CoexistenceAccountOffboardedContext {
+  value: CoexistenceAccountOffboardedValue;
+  change: WebhookChange;
+}
+interface CoexistenceAccountReconnectedContext {
+  value: CoexistenceAccountReconnectedValue;
+  change: WebhookChange;
+}
+interface CoexistenceMessageEditContext {
+  value: CoexistenceMessageEditValue;
+  change: WebhookChange;
+  editedMessages: number;
+}
+interface CoexistenceMessageRevokeContext {
+  value: CoexistenceMessageRevokeValue;
+  change: WebhookChange;
+  revokedMessages: number;
+}
+interface CoexistenceUnsupportedMessageContext {
+  value: CoexistenceHistoryValue | CoexistenceSmbAppStateSyncValue | CoexistenceUnsupportedValue;
+  change: WebhookChange;
+  errors: WebhookError[];
+}
 /**
  * Creates a Hono router that handles the full WhatsApp webhook lifecycle.
  *
@@ -59,6 +91,60 @@ declare function createWebhookHandler(config: WebhookConfig): Hono<{
   Bindings: Record<string, any>;
 }>;
 //#endregion
+//#region src/better-zap.types.d.ts
+type BetterZapAuthorizeAppRequest = (input: {
+  request: Request;
+  env?: unknown;
+}) => boolean | Promise<boolean>;
+interface BetterZapConfig<TDatabase extends BetterZapDatabase$1 = BetterZapDatabase$1, TPlugins extends readonly BetterZapPlugin$1<TDatabase, any, any>[] = readonly [], TTemplates extends TemplateRegistry = {}> {
+  database: TDatabase;
+  config: BetterZapCoreConfig$1;
+  plugins?: TPlugins;
+  templates?: TTemplates;
+  conversationSync?: DurableObjectNamespace<any>;
+  webhook: {
+    onMessage: (ctx: MessageContext$1 & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onStatusUpdate: (ctx: StatusContext$1 & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceHistory?: (ctx: CoexistenceHistoryContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onSmbAppStateSync?: (ctx: SmbAppStateSyncContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onSmbMessageEcho?: (ctx: SmbMessageEchoContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceAccountUpdate?: (ctx: CoexistenceAccountUpdateContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceAccountOffboarded?: (ctx: CoexistenceAccountOffboardedContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceAccountReconnected?: (ctx: CoexistenceAccountReconnectedContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceMessageEdit?: (ctx: CoexistenceMessageEditContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceMessageRevoke?: (ctx: CoexistenceMessageRevokeContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceUnsupportedMessage?: (ctx: CoexistenceUnsupportedMessageContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+  };
+  coexistence?: {
+    enabled?: boolean;
+    service?: CoexistenceService;
+    credentials?: CoexistenceCredentialProvider;
+    accessToken?: string;
+    appId?: string;
+    appSecret?: string;
+    graphApiVersion?: string;
+    graphBaseUrl?: string;
+    fetch?: typeof fetch;
+    /**
+     * Subscribe the connected WABA to this app after a successful Embedded
+     * Signup code exchange. Defaults to true. Failures are returned and recorded
+     * instead of being silently ignored.
+     */
+    subscribeWabaAfterCodeExchange?: boolean;
+  };
+  basePath?: string;
+  authorizeAppRequest?: BetterZapAuthorizeAppRequest;
+  logger?: LoggerConfig;
+}
+interface BetterZap<TPluginServices extends Record<string, unknown> = {}, TTemplates extends TemplateRegistry = {}> {
+  handler: (request: Request, env?: any, executionCtx?: any) => Promise<Response>;
+  api: BetterZapApi$1<TTemplates>;
+  services: BetterZapServices$1<TPluginServices>;
+}
+//#endregion
+//#region src/better-zap.d.ts
+declare function betterZap<TDatabase extends BetterZapDatabase$1 = BetterZapDatabase$1, TPlugins extends readonly BetterZapPlugin$1<TDatabase, any, any>[] = readonly BetterZapPlugin$1<TDatabase, any, any>[], TTemplates extends TemplateRegistry = {}>(options: BetterZapConfig<TDatabase, TPlugins, TTemplates>): BetterZap<InferBetterZapPluginServices$1<TPlugins>, TTemplates>;
+//#endregion
 //#region src/webhook/signature-verification.d.ts
 declare function verifyMetaWebhookSignature({
   rawBody,
@@ -82,7 +168,10 @@ type BetterZapEnv = {
     whatsapp: WhatsAppService;
     store: WhatsAppLogStore;
     logger: Logger;
+    coexistence?: CoexistenceService;
+    coexistenceStore?: CoexistenceStore;
+    subscribeWabaAfterCodeExchange?: boolean;
   };
 };
 //#endregion
-export { type BetterZap, type BetterZapApi, type BetterZapConfig, type BetterZapContext, type BetterZapCoreConfig, type BetterZapDatabase, type BetterZapEnv, type BetterZapPlugin, type BetterZapPluginInitContext, type BetterZapPluginInitResult, type BetterZapServices, type InferBetterZapPluginContext, type InferBetterZapPluginServices, type MessageContext, type StatusContext, type WebhookConfig, betterZap, createWebhookHandler, getMessageContent, verifyMetaWebhookSignature };
+export { type BetterZap, type BetterZapApi, type BetterZapConfig, type BetterZapContext, type BetterZapCoreConfig, type BetterZapDatabase, type BetterZapEnv, type BetterZapPlugin, type BetterZapPluginInitContext, type BetterZapPluginInitResult, type BetterZapServices, type CoexistenceAccountOffboardedContext, type CoexistenceAccountReconnectedContext, type CoexistenceAccountUpdateContext, type CoexistenceHistoryContext, type CoexistenceMessageEditContext, type CoexistenceMessageRevokeContext, type CoexistenceUnsupportedMessageContext, type InferBetterZapPluginContext, type InferBetterZapPluginServices, type MessageContext, type SmbAppStateSyncContext, type SmbMessageEchoContext, type StatusContext, type WebhookConfig, betterZap, createWebhookHandler, getMessageContent, verifyMetaWebhookSignature };

package/dist/index.d.mts

@@ -1,29 +1,6 @@
 import { Hono } from "hono";
-import { BetterZapApi, BetterZapApi as BetterZapApi$1, BetterZapContext, BetterZapContext as BetterZapContext$1, BetterZapCoreConfig, BetterZapCoreConfig as BetterZapCoreConfig$1, BetterZapDatabase, BetterZapDatabase as BetterZapDatabase$1, BetterZapPlugin, BetterZapPlugin as BetterZapPlugin$1, BetterZapPluginInitContext, BetterZapPluginInitResult, BetterZapServices, BetterZapServices as BetterZapServices$1, IncomingMessage, InferBetterZapPluginContext, InferBetterZapPluginContext as InferBetterZapPluginContext$1, InferBetterZapPluginServices, InferBetterZapPluginServices as InferBetterZapPluginServices$1, Logger, LoggerConfig, MessageContext, MessageContext as MessageContext$1, MessageLoggerService, StatusContext, StatusContext as StatusContext$1, TemplateRegistry, WebhookError, WhatsAppLogStore, WhatsAppService } from "better-zap";
+import { BetterZapApi, BetterZapApi as BetterZapApi$1, BetterZapContext, BetterZapContext as BetterZapContext$1, BetterZapCoreConfig, BetterZapCoreConfig as BetterZapCoreConfig$1, BetterZapDatabase, BetterZapDatabase as BetterZapDatabase$1, BetterZapPlugin, BetterZapPlugin as BetterZapPlugin$1, BetterZapPluginInitContext, BetterZapPluginInitResult, BetterZapServices, BetterZapServices as BetterZapServices$1, CoexistenceAccountOffboardedValue, CoexistenceAccountReconnectedValue, CoexistenceAccountUpdateValue, CoexistenceCredentialProvider, CoexistenceHistoryValue, CoexistenceMessageEditValue, CoexistenceMessageRevokeValue, CoexistenceService, CoexistenceSmbAppStateSyncValue, CoexistenceSmbMessageEchoesValue, CoexistenceStore, CoexistenceUnsupportedValue, IncomingMessage, InferBetterZapPluginContext, InferBetterZapPluginContext as InferBetterZapPluginContext$1, InferBetterZapPluginServices, InferBetterZapPluginServices as InferBetterZapPluginServices$1, Logger, LoggerConfig, MessageContext, MessageContext as MessageContext$1, MessageLoggerService, StatusContext, StatusContext as StatusContext$1, TemplateRegistry, WebhookChange, WebhookError, WhatsAppLogStore, WhatsAppService } from "better-zap";
 
-//#region src/better-zap.types.d.ts
-interface BetterZapConfig<TDatabase extends BetterZapDatabase$1 = BetterZapDatabase$1, TPlugins extends readonly BetterZapPlugin$1<TDatabase, any, any>[] = readonly [], TTemplates extends TemplateRegistry = {}> {
-  database: TDatabase;
-  config: BetterZapCoreConfig$1;
-  plugins?: TPlugins;
-  templates?: TTemplates;
-  conversationSync?: DurableObjectNamespace<any>;
-  webhook: {
-    onMessage: (ctx: MessageContext$1 & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
-    onStatusUpdate: (ctx: StatusContext$1 & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
-  };
-  basePath?: string;
-  logger?: LoggerConfig;
-}
-interface BetterZap<TPluginServices extends Record<string, unknown> = {}, TTemplates extends TemplateRegistry = {}> {
-  handler: (request: Request, env?: any, executionCtx?: any) => Promise<Response>;
-  api: BetterZapApi$1<TTemplates>;
-  services: BetterZapServices$1<TPluginServices>;
-}
-//#endregion
-//#region src/better-zap.d.ts
-declare function betterZap<TDatabase extends BetterZapDatabase$1 = BetterZapDatabase$1, TPlugins extends readonly BetterZapPlugin$1<TDatabase, any, any>[] = readonly BetterZapPlugin$1<TDatabase, any, any>[], TTemplates extends TemplateRegistry = {}>(options: BetterZapConfig<TDatabase, TPlugins, TTemplates>): BetterZap<InferBetterZapPluginServices$1<TPlugins>, TTemplates>;
-//#endregion
 //#region src/webhook/create-webhook-handler.d.ts
 /**
  * Configuration for {@link createWebhookHandler}.
@@ -34,15 +11,70 @@ type WebhookConfig = {
   /** Token for the Meta verification challenge (`GET /webhook`). */verifyToken: string; /** App secret used for HMAC-SHA256 signature verification. */
   appSecret: string; /** logger for automatic message storage. */
   logger: MessageLoggerService; /** Structured logger for operational logging. */
-  log: Logger; /** Called once per incoming message, after SDK pre-processing. */
+  log: Logger; /** Optional database contracts used for automatic coexistence persistence. */
+  database?: BetterZapDatabase$1; /** Called once per incoming message, after SDK pre-processing. */
   onMessage: (ctx: MessageContext$1) => Promise<void>; /** Called once per delivery status update (sent → delivered → read → failed). */
-  onStatusUpdate: (ctx: StatusContext$1) => Promise<void>;
+  onStatusUpdate: (ctx: StatusContext$1) => Promise<void>; /** Called once per history webhook after SDK pre-processing. */
+  onCoexistenceHistory?: (ctx: CoexistenceHistoryContext) => Promise<void>; /** Called once per SMB app state sync webhook after SDK pre-processing. */
+  onSmbAppStateSync?: (ctx: SmbAppStateSyncContext) => Promise<void>; /** Called once per app message echo webhook after SDK pre-processing. */
+  onSmbMessageEcho?: (ctx: SmbMessageEchoContext) => Promise<void>; /** Called once per coexistence account lifecycle webhook. */
+  onCoexistenceAccountUpdate?: (ctx: CoexistenceAccountUpdateContext) => Promise<void>; /** Called once per coexistence offboarding lifecycle webhook. */
+  onCoexistenceAccountOffboarded?: (ctx: CoexistenceAccountOffboardedContext) => Promise<void>; /** Called once per coexistence background reconnection lifecycle webhook. */
+  onCoexistenceAccountReconnected?: (ctx: CoexistenceAccountReconnectedContext) => Promise<void>; /** Called for coexistence message edit webhooks. */
+  onCoexistenceMessageEdit?: (ctx: CoexistenceMessageEditContext) => Promise<void>; /** Called for coexistence message revoke webhooks. */
+  onCoexistenceMessageRevoke?: (ctx: CoexistenceMessageRevokeContext) => Promise<void>; /** Called when a coexistence webhook contains unsupported/error content. */
+  onCoexistenceUnsupportedMessage?: (ctx: CoexistenceUnsupportedMessageContext) => Promise<void>;
   /**
    * Called for Meta platform-level errors.
    * @default Uses the configured {@link WebhookConfig.log} logger's {@code error} method.
    */
   onError?: (error: WebhookError) => void;
 };
+interface CoexistenceHistoryContext {
+  value: CoexistenceHistoryValue;
+  change: WebhookChange;
+  importedMessages: number;
+  duplicateMessages: number;
+}
+interface SmbAppStateSyncContext {
+  value: CoexistenceSmbAppStateSyncValue;
+  change: WebhookChange;
+  upsertedContacts: number;
+  removedContacts: number;
+}
+interface SmbMessageEchoContext {
+  value: CoexistenceSmbMessageEchoesValue;
+  change: WebhookChange;
+  importedMessages: number;
+  duplicateMessages: number;
+}
+interface CoexistenceAccountUpdateContext {
+  value: CoexistenceAccountUpdateValue;
+  change: WebhookChange;
+}
+interface CoexistenceAccountOffboardedContext {
+  value: CoexistenceAccountOffboardedValue;
+  change: WebhookChange;
+}
+interface CoexistenceAccountReconnectedContext {
+  value: CoexistenceAccountReconnectedValue;
+  change: WebhookChange;
+}
+interface CoexistenceMessageEditContext {
+  value: CoexistenceMessageEditValue;
+  change: WebhookChange;
+  editedMessages: number;
+}
+interface CoexistenceMessageRevokeContext {
+  value: CoexistenceMessageRevokeValue;
+  change: WebhookChange;
+  revokedMessages: number;
+}
+interface CoexistenceUnsupportedMessageContext {
+  value: CoexistenceHistoryValue | CoexistenceSmbAppStateSyncValue | CoexistenceUnsupportedValue;
+  change: WebhookChange;
+  errors: WebhookError[];
+}
 /**
  * Creates a Hono router that handles the full WhatsApp webhook lifecycle.
  *
@@ -59,6 +91,60 @@ declare function createWebhookHandler(config: WebhookConfig): Hono<{
   Bindings: Record<string, any>;
 }>;
 //#endregion
+//#region src/better-zap.types.d.ts
+type BetterZapAuthorizeAppRequest = (input: {
+  request: Request;
+  env?: unknown;
+}) => boolean | Promise<boolean>;
+interface BetterZapConfig<TDatabase extends BetterZapDatabase$1 = BetterZapDatabase$1, TPlugins extends readonly BetterZapPlugin$1<TDatabase, any, any>[] = readonly [], TTemplates extends TemplateRegistry = {}> {
+  database: TDatabase;
+  config: BetterZapCoreConfig$1;
+  plugins?: TPlugins;
+  templates?: TTemplates;
+  conversationSync?: DurableObjectNamespace<any>;
+  webhook: {
+    onMessage: (ctx: MessageContext$1 & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onStatusUpdate: (ctx: StatusContext$1 & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceHistory?: (ctx: CoexistenceHistoryContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onSmbAppStateSync?: (ctx: SmbAppStateSyncContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onSmbMessageEcho?: (ctx: SmbMessageEchoContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceAccountUpdate?: (ctx: CoexistenceAccountUpdateContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceAccountOffboarded?: (ctx: CoexistenceAccountOffboardedContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceAccountReconnected?: (ctx: CoexistenceAccountReconnectedContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceMessageEdit?: (ctx: CoexistenceMessageEditContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceMessageRevoke?: (ctx: CoexistenceMessageRevokeContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+    onCoexistenceUnsupportedMessage?: (ctx: CoexistenceUnsupportedMessageContext & BetterZapContext$1<TDatabase, InferBetterZapPluginContext$1<TPlugins>>) => Promise<void>;
+  };
+  coexistence?: {
+    enabled?: boolean;
+    service?: CoexistenceService;
+    credentials?: CoexistenceCredentialProvider;
+    accessToken?: string;
+    appId?: string;
+    appSecret?: string;
+    graphApiVersion?: string;
+    graphBaseUrl?: string;
+    fetch?: typeof fetch;
+    /**
+     * Subscribe the connected WABA to this app after a successful Embedded
+     * Signup code exchange. Defaults to true. Failures are returned and recorded
+     * instead of being silently ignored.
+     */
+    subscribeWabaAfterCodeExchange?: boolean;
+  };
+  basePath?: string;
+  authorizeAppRequest?: BetterZapAuthorizeAppRequest;
+  logger?: LoggerConfig;
+}
+interface BetterZap<TPluginServices extends Record<string, unknown> = {}, TTemplates extends TemplateRegistry = {}> {
+  handler: (request: Request, env?: any, executionCtx?: any) => Promise<Response>;
+  api: BetterZapApi$1<TTemplates>;
+  services: BetterZapServices$1<TPluginServices>;
+}
+//#endregion
+//#region src/better-zap.d.ts
+declare function betterZap<TDatabase extends BetterZapDatabase$1 = BetterZapDatabase$1, TPlugins extends readonly BetterZapPlugin$1<TDatabase, any, any>[] = readonly BetterZapPlugin$1<TDatabase, any, any>[], TTemplates extends TemplateRegistry = {}>(options: BetterZapConfig<TDatabase, TPlugins, TTemplates>): BetterZap<InferBetterZapPluginServices$1<TPlugins>, TTemplates>;
+//#endregion
 //#region src/webhook/signature-verification.d.ts
 declare function verifyMetaWebhookSignature({
   rawBody,
@@ -82,7 +168,10 @@ type BetterZapEnv = {
     whatsapp: WhatsAppService;
     store: WhatsAppLogStore;
     logger: Logger;
+    coexistence?: CoexistenceService;
+    coexistenceStore?: CoexistenceStore;
+    subscribeWabaAfterCodeExchange?: boolean;
   };
 };
 //#endregion
-export { type BetterZap, type BetterZapApi, type BetterZapConfig, type BetterZapContext, type BetterZapCoreConfig, type BetterZapDatabase, type BetterZapEnv, type BetterZapPlugin, type BetterZapPluginInitContext, type BetterZapPluginInitResult, type BetterZapServices, type InferBetterZapPluginContext, type InferBetterZapPluginServices, type MessageContext, type StatusContext, type WebhookConfig, betterZap, createWebhookHandler, getMessageContent, verifyMetaWebhookSignature };
+export { type BetterZap, type BetterZapApi, type BetterZapConfig, type BetterZapContext, type BetterZapCoreConfig, type BetterZapDatabase, type BetterZapEnv, type BetterZapPlugin, type BetterZapPluginInitContext, type BetterZapPluginInitResult, type BetterZapServices, type CoexistenceAccountOffboardedContext, type CoexistenceAccountReconnectedContext, type CoexistenceAccountUpdateContext, type CoexistenceHistoryContext, type CoexistenceMessageEditContext, type CoexistenceMessageRevokeContext, type CoexistenceUnsupportedMessageContext, type InferBetterZapPluginContext, type InferBetterZapPluginServices, type MessageContext, type SmbAppStateSyncContext, type SmbMessageEchoContext, type StatusContext, type WebhookConfig, betterZap, createWebhookHandler, getMessageContent, verifyMetaWebhookSignature };