@diegoaltoworks/chatter 0.32.0 → 0.34.0

package/dist/channels/whatsapp/images.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Optional image requests in the WhatsApp channel: detect a drawing/picture
+ * request (with or without an attached photo), route it through `../../images`,
+ * and reply with the generated picture. Inert unless `./images` is
+ * configured — `createWhatsAppImageHandler` returns `false` for every
+ * message when it isn't, so callers fall through to normal chat.
+ *
+ * This module ships no bot personality: the detector and subject-cleaning
+ * patterns are generic drawing verbs (no hardcoded bot names), and every
+ * reply string (ack/limit/moderation/error) is caller-configured with no
+ * default text.
+ *
+ * Downloading the attached photo needs Baileys' `downloadMediaMessage`,
+ * which — per this subpath's rule that only `./baileys` touches the
+ * optional peer dependency at runtime — is injected as `downloadPhoto`
+ * rather than imported here. The host wires it via `./whatsapp`'s
+ * `loadBaileys` (see docs/channels.md), not this module.
+ *
+ * Everything pulled in from `../../images` is type-only: each subpath is
+ * built as its own bundle, so a value import here (even just for an
+ * `instanceof` check) would inline the whole `./images` module — OpenAI SDK
+ * included — into `./whatsapp`, and importing from the `../../images`
+ * barrel rather than its leaf files pulls in every sibling module's value
+ * imports too. Error mapping below checks `code`/`name` structurally
+ * instead, which also means it works when the error crossed a bundle
+ * boundary (the two subpaths' `ImageGenerationError` classes are not
+ * `instanceof`-compatible with each other).
+ */
+import type { WAMessage, WASocket } from "@whiskeysockets/baileys";
+import type { CaptionComposer } from "../../images/captionComposer";
+import type { ImageUploader } from "../../images/uploader";
+export interface DrawRequestDetectorConfig {
+    /** Tested against the raw message text to decide whether it's an image request. Defaults to a generic set of drawing verbs — no bot-specific names. */
+    detectPattern?: RegExp;
+    /** Applied in order to derive the subject from the raw text (mention tokens, greetings/politeness, the draw verb itself). */
+    stripPatterns?: readonly RegExp[];
+}
+export declare function isDrawRequest(text: string, config?: DrawRequestDetectorConfig): boolean;
+/** Cleans a draw request into a scene subject: "@1234 please draw me a cat" -> "cat". Falls back to the trimmed original when the patterns strip everything (or nothing). */
+export declare function drawSubject(text: string, config?: DrawRequestDetectorConfig): string;
+/** Neutral, overridable reply strings — this module ships no bot personality. Unset = silent for that outcome. */
+export interface WhatsAppImageStrings {
+    /** Sent immediately on accepting the request, before generation starts. */
+    ack?: string;
+    /** Sent when the per-sender/day cap (`checkAndReserve`) blocks the request. */
+    limitReached?: string;
+    /** Sent when the image API blocks the request on moderation grounds. */
+    moderationBlocked?: string;
+    /** Sent for any other generation/upload/download failure. */
+    error?: string;
+}
+export interface WhatsAppImageHandlerDeps {
+    /** The slice of `./images`' `ImageUploader` this module needs. */
+    images: Pick<ImageUploader, "isConfigured" | "peekCached" | "getOrCreateImage">;
+    /**
+     * Per-sender/day reservation (e.g. `./usage`'s `DailyLimiter.checkAndReserve`).
+     * Omit to skip the cap entirely. Checked AFTER the cache, so a cache hit
+     * never burns a unit.
+     */
+    checkAndReserve?: (senderId: string) => Promise<{
+        allowed: boolean;
+    }>;
+    /**
+     * Downloads the attached photo as bytes. Omit to ignore attached photos —
+     * text-only requests still work. See the module docstring for why this is
+     * injected rather than imported.
+     */
+    downloadPhoto?: (message: WAMessage) => Promise<Uint8Array>;
+    /** Best-effort tailored caption for the reply. Omit to send the image with no caption. */
+    captionComposer?: Pick<CaptionComposer, "composeCaption">;
+    detector?: DrawRequestDetectorConfig;
+    strings?: WhatsAppImageStrings;
+}
+export interface WhatsAppImageRequestContext {
+    sock: WASocket;
+    message: WAMessage;
+    chatId: string;
+    senderId: string;
+    text: string;
+    hasPhoto: boolean;
+}
+/** `true` = the message was an image request and this module replied to it (successfully or with a mapped error) — the caller must not also route it through normal chat. `false` = not an image request, or `./images` isn't configured. */
+export type WhatsAppImageHandler = (ctx: WhatsAppImageRequestContext) => Promise<boolean>;
+export declare function createWhatsAppImageHandler(deps: WhatsAppImageHandlerDeps): WhatsAppImageHandler;
+//# sourceMappingURL=images.d.ts.map

package/dist/channels/whatsapp/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/images.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAkB3D,MAAM,WAAW,yBAAyB;IACxC,uJAAuJ;IACvJ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6HAA6H;IAC7H,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAOD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,yBAA8B,GAAG,OAAO,CAE3F;AAED,6KAA6K;AAC7K,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,yBAA8B,GAAG,MAAM,CAUxF;AAED,kHAAkH;AAClH,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,GAAG,YAAY,GAAG,kBAAkB,CAAC,CAAC;IAChF;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtE;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,0FAA0F;IAC1F,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;IAC1D,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IACrC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,6OAA6O;AAC7O,MAAM,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,2BAA2B,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAsB1F,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,wBAAwB,GAAG,oBAAoB,CA4C/F"}

package/dist/channels/whatsapp/images.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=images.test.d.ts.map

package/dist/channels/whatsapp/images.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.test.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/images.test.ts"],"names":[],"mappings":""}

package/dist/channels/whatsapp/inbound.d.ts

@@ -50,6 +50,7 @@ import type { PromptLoader } from "../../core/prompts";
 import type { VectorStore } from "../../core/retrieval";
 import { type SessionIdentityRegistry } from "../gates";
 import type { WhatsAppMessageEvent } from "./channel";
+import type { WhatsAppImageHandler } from "./images";
 export declare function isGroupJid(jid: string): boolean;
 /** "447700900123:17@s.whatsapp.net" (device-suffixed) and "447700900123@s.whatsapp.net" match. */
 export declare function jidsMatch(a: string | undefined, b: string | undefined): boolean;
@@ -124,6 +125,14 @@ export interface WhatsAppInboundConfig {
         senderPhone: string;
         text: string;
     }) => string | undefined | Promise<string | undefined>;
+    /**
+     * Optional image-request routing (see `./images`). Consulted right before
+     * the normal chat pipeline; a `true` result means the message was handled
+     * as an image request (successfully or with a mapped error string) and
+     * this handler returns without answering through chat. Inert unless
+     * `./images` is configured.
+     */
+    images?: WhatsAppImageHandler;
     now?: () => number;
 }
 /** Builds the `onMessage` handler for `createWhatsAppChannel` (see `./channel`) — see the module docstring for how to wire `ServerDependencies` into it. */

package/dist/channels/whatsapp/inbound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/inbound.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,oBAAoB,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAKL,KAAK,uBAAuB,EAE7B,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAItD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAI/E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpD;AAeD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAID,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,GAAG,gBAAgB,CAWnE;AAED,mHAAmH;AACnH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAWtD;AAID,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,QAAQ,EAAE,uBAAuB,CAAC;IAClC,4HAA4H;IAC5H,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gHAAgH;IAChH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,oGAAoG;IACpG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAqBD,4JAA4J;AAC5J,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qBAAqB,GAC5B,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CA0GhD"}
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/inbound.ts"],"names":[],"mappings":"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"}

package/dist/channels/whatsapp/index.d.ts

@@ -29,6 +29,7 @@ export type { Baileys } from "./baileys";
 export { loadBaileys } from "./baileys";
 export { acquireSessionLease, createWhatsAppChannel, type LeaseGatedConnectDeps, reconnectDelayMs, senderNameFor, shutdownWaSessions, type WaSessionHandle, type WhatsAppChannelConfig, type WhatsAppMessageEvent, } from "./channel";
 export { decrypt, encrypt } from "./crypto";
+export { createWhatsAppImageHandler, type DrawRequestDetectorConfig, drawSubject, isDrawRequest, type WhatsAppImageHandler, type WhatsAppImageHandlerDeps, type WhatsAppImageRequestContext, type WhatsAppImageStrings, } from "./images";
 export { createWhatsAppInboundHandler, extractText, isGroupJid, jidsMatch, jidToPhoneNumber, messageContext, senderPhoneFor, type WaMessageContext, type WhatsAppInboundConfig, } from "./inbound";
 export { canAcquireLease, createTursoWaLeaseStore, LEASE_HEARTBEAT_MS, LEASE_STALE_MS, LEASE_WAIT_MS, type WaLeaseRow, type WaLeaseStore, } from "./lease";
 //# sourceMappingURL=index.d.ts.map

package/dist/channels/whatsapp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EACL,4BAA4B,EAC5B,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EACL,0BAA0B,EAC1B,KAAK,yBAAyB,EAC9B,WAAW,EACX,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,4BAA4B,EAC5B,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}

package/dist/channels/whatsapp/index.js

@@ -37,10 +37,13 @@ __export(index_exports, {
   canAcquireLease: () => canAcquireLease,
   createTursoWaLeaseStore: () => createTursoWaLeaseStore,
   createWhatsAppChannel: () => createWhatsAppChannel,
+  createWhatsAppImageHandler: () => createWhatsAppImageHandler,
   createWhatsAppInboundHandler: () => createWhatsAppInboundHandler,
   decrypt: () => decrypt,
+  drawSubject: () => drawSubject,
   encrypt: () => encrypt,
   extractText: () => extractText,
+  isDrawRequest: () => isDrawRequest,
   isGroupJid: () => isGroupJid,
   jidToPhoneNumber: () => jidToPhoneNumber,
   jidsMatch: () => jidsMatch,
@@ -467,6 +470,71 @@ function createWhatsAppChannel(config) {
   };
 }
 
+// src/channels/whatsapp/images.ts
+var DEFAULT_DETECT_PATTERN = /\b(draw|paint|sketch|illustrate)\b|\b(make|generate|create)\b[^.!?]{0,20}\b(picture|image|drawing|photo|cartoon)\b/i;
+var DEFAULT_STRIP_PATTERNS = [
+  /@\d+/g,
+  /^(hey|hi|please|ok)[,!\s]+/i,
+  /^(can|could|will)\s+you\s+/i,
+  // Longest-alternative-first ((an|a), not (a|an)): a first-match-wins
+  // alternation would otherwise take "a" out of "an" and leave a stray "n".
+  /^(please\s+)?(draw|paint|sketch|illustrate|make|generate|create)\s+(me|us)?\s*(an|a)?\s*(picture|image|drawing|sketch|photo|cartoon)?\s*(of\s+)?/i
+];
+function testPattern(pattern, text) {
+  return new RegExp(pattern.source, pattern.flags.replace(/[gy]/g, "")).test(text);
+}
+function isDrawRequest(text, config = {}) {
+  return testPattern(config.detectPattern ?? DEFAULT_DETECT_PATTERN, text);
+}
+function drawSubject(text, config = {}) {
+  let subject = text;
+  for (const pattern of config.stripPatterns ?? DEFAULT_STRIP_PATTERNS) {
+    subject = subject.replace(pattern, " ").replace(/\s+/g, " ").trim();
+  }
+  return subject.length > 0 ? subject : text.trim();
+}
+function isModerationError(error) {
+  return typeof error === "object" && error !== null && error.name === "ImageGenerationError" && error.code === "moderation";
+}
+async function replyText(sock, chatId, message, text) {
+  if (!text) return;
+  await sock.sendMessage(chatId, { text }, { quoted: message }).catch(() => void 0);
+}
+function createWhatsAppImageHandler(deps) {
+  return async function handleWhatsAppImageRequest(ctx) {
+    if (!deps.images.isConfigured()) return false;
+    if (!isDrawRequest(ctx.text, deps.detector)) return false;
+    const subject = drawSubject(ctx.text, deps.detector);
+    try {
+      const photoBytes = ctx.hasPhoto ? await deps.downloadPhoto?.(ctx.message) : void 0;
+      const inputImages = photoBytes ? [{ bytes: photoBytes }] : void 0;
+      const request = { prompt: subject, inputImages };
+      if (deps.checkAndReserve) {
+        const cached2 = await deps.images.peekCached(request);
+        if (!cached2) {
+          const reserved = await deps.checkAndReserve(ctx.senderId);
+          if (!reserved.allowed) {
+            await replyText(ctx.sock, ctx.chatId, ctx.message, deps.strings?.limitReached);
+            return true;
+          }
+        }
+      }
+      await replyText(ctx.sock, ctx.chatId, ctx.message, deps.strings?.ack);
+      const image = await deps.images.getOrCreateImage(request);
+      const caption = deps.captionComposer ? await deps.captionComposer.composeCaption({ subject }) : void 0;
+      await ctx.sock.sendMessage(
+        ctx.chatId,
+        caption ? { image: { url: image.url }, caption } : { image: { url: image.url } },
+        { quoted: ctx.message }
+      );
+    } catch (error) {
+      const text = isModerationError(error) ? deps.strings?.moderationBlocked : deps.strings?.error;
+      await replyText(ctx.sock, ctx.chatId, ctx.message, text);
+    }
+    return true;
+  };
+}
+
 // src/core/guardrails.ts
 function detectLeakage(text) {
   const flags = [
@@ -751,6 +819,17 @@ function createWhatsAppInboundHandler(config) {
         return;
       }
       const senderPhone = await senderPhoneFor(sock, message, chatId);
+      if (config.images) {
+        const handled = await config.images({
+          sock,
+          message,
+          chatId,
+          senderId: senderPhone,
+          text,
+          hasPhoto: Boolean(message.message?.imageMessage)
+        });
+        if (handled) return;
+      }
       const personaLayer = await resolvePersonaLayer(config, { senderPhone, text });
       const buckets = await resolveBuckets({
         mode: "public",
@@ -793,10 +872,13 @@ function createWhatsAppInboundHandler(config) {
   canAcquireLease,
   createTursoWaLeaseStore,
   createWhatsAppChannel,
+  createWhatsAppImageHandler,
   createWhatsAppInboundHandler,
   decrypt,
+  drawSubject,
   encrypt,
   extractText,
+  isDrawRequest,
   isGroupJid,
   jidToPhoneNumber,
   jidsMatch,

package/dist/channels/whatsapp/index.mjs

@@ -411,6 +411,71 @@ function createWhatsAppChannel(config) {
   };
 }
 
+// src/channels/whatsapp/images.ts
+var DEFAULT_DETECT_PATTERN = /\b(draw|paint|sketch|illustrate)\b|\b(make|generate|create)\b[^.!?]{0,20}\b(picture|image|drawing|photo|cartoon)\b/i;
+var DEFAULT_STRIP_PATTERNS = [
+  /@\d+/g,
+  /^(hey|hi|please|ok)[,!\s]+/i,
+  /^(can|could|will)\s+you\s+/i,
+  // Longest-alternative-first ((an|a), not (a|an)): a first-match-wins
+  // alternation would otherwise take "a" out of "an" and leave a stray "n".
+  /^(please\s+)?(draw|paint|sketch|illustrate|make|generate|create)\s+(me|us)?\s*(an|a)?\s*(picture|image|drawing|sketch|photo|cartoon)?\s*(of\s+)?/i
+];
+function testPattern(pattern, text) {
+  return new RegExp(pattern.source, pattern.flags.replace(/[gy]/g, "")).test(text);
+}
+function isDrawRequest(text, config = {}) {
+  return testPattern(config.detectPattern ?? DEFAULT_DETECT_PATTERN, text);
+}
+function drawSubject(text, config = {}) {
+  let subject = text;
+  for (const pattern of config.stripPatterns ?? DEFAULT_STRIP_PATTERNS) {
+    subject = subject.replace(pattern, " ").replace(/\s+/g, " ").trim();
+  }
+  return subject.length > 0 ? subject : text.trim();
+}
+function isModerationError(error) {
+  return typeof error === "object" && error !== null && error.name === "ImageGenerationError" && error.code === "moderation";
+}
+async function replyText(sock, chatId, message, text) {
+  if (!text) return;
+  await sock.sendMessage(chatId, { text }, { quoted: message }).catch(() => void 0);
+}
+function createWhatsAppImageHandler(deps) {
+  return async function handleWhatsAppImageRequest(ctx) {
+    if (!deps.images.isConfigured()) return false;
+    if (!isDrawRequest(ctx.text, deps.detector)) return false;
+    const subject = drawSubject(ctx.text, deps.detector);
+    try {
+      const photoBytes = ctx.hasPhoto ? await deps.downloadPhoto?.(ctx.message) : void 0;
+      const inputImages = photoBytes ? [{ bytes: photoBytes }] : void 0;
+      const request = { prompt: subject, inputImages };
+      if (deps.checkAndReserve) {
+        const cached2 = await deps.images.peekCached(request);
+        if (!cached2) {
+          const reserved = await deps.checkAndReserve(ctx.senderId);
+          if (!reserved.allowed) {
+            await replyText(ctx.sock, ctx.chatId, ctx.message, deps.strings?.limitReached);
+            return true;
+          }
+        }
+      }
+      await replyText(ctx.sock, ctx.chatId, ctx.message, deps.strings?.ack);
+      const image = await deps.images.getOrCreateImage(request);
+      const caption = deps.captionComposer ? await deps.captionComposer.composeCaption({ subject }) : void 0;
+      await ctx.sock.sendMessage(
+        ctx.chatId,
+        caption ? { image: { url: image.url }, caption } : { image: { url: image.url } },
+        { quoted: ctx.message }
+      );
+    } catch (error) {
+      const text = isModerationError(error) ? deps.strings?.moderationBlocked : deps.strings?.error;
+      await replyText(ctx.sock, ctx.chatId, ctx.message, text);
+    }
+    return true;
+  };
+}
+
 // src/core/guardrails.ts
 function detectLeakage(text) {
   const flags = [
@@ -695,6 +760,17 @@ function createWhatsAppInboundHandler(config) {
         return;
       }
       const senderPhone = await senderPhoneFor(sock, message, chatId);
+      if (config.images) {
+        const handled = await config.images({
+          sock,
+          message,
+          chatId,
+          senderId: senderPhone,
+          text,
+          hasPhoto: Boolean(message.message?.imageMessage)
+        });
+        if (handled) return;
+      }
       const personaLayer = await resolvePersonaLayer(config, { senderPhone, text });
       const buckets = await resolveBuckets({
         mode: "public",
@@ -736,10 +812,13 @@ export {
   canAcquireLease,
   createTursoWaLeaseStore,
   createWhatsAppChannel,
+  createWhatsAppImageHandler,
   createWhatsAppInboundHandler,
   decrypt,
+  drawSubject,
   encrypt,
   extractText,
+  isDrawRequest,
   isGroupJid,
   jidToPhoneNumber,
   jidsMatch,

package/dist/images/cache.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Image cache - deterministic keying and freshness, no I/O.
+ *
+ * The store itself is injected ({@link ImageCacheStore}): a host backs it with
+ * whatever it wants (see `./cacheStore` for the shipped Turso binding), so
+ * this file stays free of any DB client.
+ */
+import type { ImageInput } from "./types";
+/** A cached upload: where it lives, and when it was created. */
+export interface ImageCacheEntry {
+    url: string;
+    /** Epoch milliseconds. */
+    createdAt: number;
+}
+/** Structural cache dependency - a host implements this against its own storage. */
+export interface ImageCacheStore {
+    get(key: string): Promise<ImageCacheEntry | null>;
+    set(key: string, entry: ImageCacheEntry): Promise<void>;
+}
+/** Identical requests are served from cache for this long before regenerating. */
+export declare const CACHE_TTL_MS: number;
+/**
+ * Deterministic cache key (and Cloudinary `public_id`) for a request: the
+ * prompt plus any base/input images. The same prompt against a different
+ * photo must be a different picture.
+ */
+export declare function publicIdForRequest(prompt: string, images?: {
+    baseImage?: ImageInput;
+    inputImages?: ImageInput[];
+}): string;
+export declare function isCacheEntryFresh(entry: ImageCacheEntry, now: number): boolean;
+//# sourceMappingURL=cache.d.ts.map

package/dist/images/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/images/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAClD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED,kFAAkF;AAClF,eAAO,MAAM,YAAY,QAAsB,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,UAAU,CAAC;IAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;CAAE,GAC9D,MAAM,CAOR;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9E"}

package/dist/images/cache.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cache.test.d.ts.map

package/dist/images/cache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.test.d.ts","sourceRoot":"","sources":["../../src/images/cache.test.ts"],"names":[],"mappings":""}

package/dist/images/cacheStore.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Turso/libsql-backed {@link ImageCacheStore}.
+ *
+ * Schema and upsert only, mirroring `../usage/tursoStore`: idempotent table
+ * creation memoized per (client, table), and a table name restricted to a
+ * plain identifier since it is interpolated into SQL.
+ *
+ * `@libsql/client` is imported for its type alone, so this module adds no
+ * runtime dependency to anyone importing `./cache` for the pure key/freshness
+ * helpers.
+ */
+import type { Client } from "@libsql/client";
+import type { ImageCacheStore } from "./cache";
+/**
+ * Creates a cache store backed by `tableName` on `client`. Table creation is
+ * idempotent and happens once per (client, table); give each cached resource
+ * its own table.
+ */
+export declare function createTursoImageCacheStore(client: Client, tableName: string): ImageCacheStore;
+//# sourceMappingURL=cacheStore.d.ts.map

package/dist/images/cacheStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheStore.d.ts","sourceRoot":"","sources":["../../src/images/cacheStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,SAAS,CAAC;AAmChE;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CA0B7F"}

package/dist/images/cacheStore.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Turso image cache store tests.
+ *
+ * Run against a real in-memory libsql client, same rationale as
+ * `../usage/tursoStore.test.ts`: the properties worth proving are SQL-level.
+ */
+export {};
+//# sourceMappingURL=cacheStore.test.d.ts.map

package/dist/images/cacheStore.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheStore.test.d.ts","sourceRoot":"","sources":["../../src/images/cacheStore.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/images/captionComposer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Optional caption helper for a generated image - two tiers, no content of
+ * its own.
+ *
+ * 1. `randomCaption()` picks from a caller-supplied template pool. Always
+ *    works, costs nothing.
+ * 2. `composeCaption()` runs a caller-supplied compose step (typically an LLM
+ *    call) racing a timeout; any failure or timeout falls back to tier 1. It
+ *    never throws.
+ */
+export interface CaptionRequest {
+    /** What the picture is of, used to fill `{subject}` in pool templates. */
+    subject: string;
+    /** Arbitrary extra context a caller's compose function may use. */
+    [key: string]: unknown;
+}
+export type CaptionComposeFn = (request: CaptionRequest) => Promise<string>;
+export interface CaptionComposerOptions {
+    /** Templates with an optional `{subject}` placeholder. Ships no content - always caller-supplied. */
+    pool: readonly string[];
+    /** Best-effort tailored caption step, e.g. wrapping an LLM call. Omit to always use the pool. */
+    compose?: CaptionComposeFn;
+    /** Milliseconds before `compose` is abandoned in favour of the pool. */
+    timeoutMs?: number;
+    /** Injectable randomness for tests. Default `Math.random`. */
+    random?: () => number;
+}
+export interface CaptionComposer {
+    randomCaption(subject?: string): string;
+    composeCaption(request: CaptionRequest): Promise<string>;
+}
+export declare function createCaptionComposer(options: CaptionComposerOptions): CaptionComposer;
+//# sourceMappingURL=captionComposer.d.ts.map

package/dist/images/captionComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captionComposer.d.ts","sourceRoot":"","sources":["../../src/images/captionComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE5E,MAAM,WAAW,sBAAsB;IACrC,qGAAqG;IACrG,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,iGAAiG;IACjG,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1D;AAKD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAsCtF"}

package/dist/images/captionComposer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=captionComposer.test.d.ts.map

package/dist/images/captionComposer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captionComposer.test.d.ts","sourceRoot":"","sources":["../../src/images/captionComposer.test.ts"],"names":[],"mappings":""}

package/dist/images/cloudinaryClient.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The real Cloudinary upload client, over plain HTTP.
+ *
+ * This is the only file in the module that talks to Cloudinary. `fetchImpl`
+ * is injected (defaulting to the global `fetch`), so tests substitute a mock
+ * and never make a real upload. No Cloudinary SDK dependency is needed -
+ * signed uploads are a handful of form fields over `fetch`.
+ */
+import { type CloudinaryModuleConfig } from "./cloudinaryConfig";
+import type { CloudinaryUploadClient } from "./types";
+export declare function createCloudinaryUploadClient(config: CloudinaryModuleConfig, fetchImpl?: typeof fetch): CloudinaryUploadClient;
+//# sourceMappingURL=cloudinaryClient.d.ts.map

package/dist/images/cloudinaryClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudinaryClient.d.ts","sourceRoot":"","sources":["../../src/images/cloudinaryClient.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,sBAAsB,EAA0B,MAAM,oBAAoB,CAAC;AAEzF,OAAO,KAAK,EAAE,sBAAsB,EAA2B,MAAM,SAAS,CAAC;AAO/E,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,sBAAsB,EAC9B,SAAS,GAAE,OAAO,KAAa,GAC9B,sBAAsB,CA6CxB"}

package/dist/images/cloudinaryClient.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cloudinaryClient.test.d.ts.map

package/dist/images/cloudinaryClient.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudinaryClient.test.d.ts","sourceRoot":"","sources":["../../src/images/cloudinaryClient.test.ts"],"names":[],"mappings":""}

package/dist/images/cloudinaryConfig.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cloudinary upload configuration - pure resolution, no I/O.
+ *
+ * Same shape as `./config`: the module never reads process.env itself, a host
+ * passes an env-shaped record in, and the feature is off when unconfigured.
+ */
+export interface CloudinaryModuleConfig {
+    cloudName?: string;
+    apiKey?: string;
+    apiSecret?: string;
+    /** Cloudinary folder generated images are uploaded into. */
+    folder: string;
+}
+export declare const DEFAULT_CLOUDINARY_FOLDER = "generated";
+/** The env vars this module reads, all optional. */
+export interface CloudinaryEnv {
+    CLOUDINARY_CLOUD_NAME?: string;
+    CLOUDINARY_API_KEY?: string;
+    CLOUDINARY_API_SECRET?: string;
+    CLOUDINARY_FOLDER?: string;
+}
+export declare function resolveCloudinaryConfig(env?: CloudinaryEnv, overrides?: Partial<CloudinaryModuleConfig>): CloudinaryModuleConfig;
+/** Feature detection: any credential missing, no upload. Narrows the credential fields to `string`. */
+export declare function isCloudinaryConfigured(config: CloudinaryModuleConfig): config is CloudinaryModuleConfig & {
+    cloudName: string;
+    apiKey: string;
+    apiSecret: string;
+};
+//# sourceMappingURL=cloudinaryConfig.d.ts.map

package/dist/images/cloudinaryConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudinaryConfig.d.ts","sourceRoot":"","sources":["../../src/images/cloudinaryConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,yBAAyB,cAAc,CAAC;AAErD,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAOD,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,aAAkB,EACvB,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,sBAAsB,CASxB;AAED,uGAAuG;AACvG,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,IAAI,sBAAsB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAE7F"}

package/dist/images/cloudinaryConfig.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cloudinaryConfig.test.d.ts.map

package/dist/images/cloudinaryConfig.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudinaryConfig.test.d.ts","sourceRoot":"","sources":["../../src/images/cloudinaryConfig.test.ts"],"names":[],"mappings":""}

package/dist/images/cloudinarySignature.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cloudinary's signed-upload scheme - pure, no I/O.
+ *
+ * Sign every parameter except the file itself: sort keys, join as `key=value`
+ * pairs with `&`, append the API secret with no separator, then SHA-1 the
+ * result. https://cloudinary.com/documentation/signatures
+ */
+export declare function signCloudinaryParams(params: Record<string, string>, apiSecret: string): string;
+//# sourceMappingURL=cloudinarySignature.d.ts.map

package/dist/images/cloudinarySignature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudinarySignature.d.ts","sourceRoot":"","sources":["../../src/images/cloudinarySignature.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM9F"}

package/dist/images/cloudinarySignature.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cloudinarySignature.test.d.ts.map

package/dist/images/cloudinarySignature.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudinarySignature.test.d.ts","sourceRoot":"","sources":["../../src/images/cloudinarySignature.test.ts"],"names":[],"mappings":""}

package/dist/images/config.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Image module configuration - pure resolution, no I/O.
+ *
+ * The module never reads process.env itself; a host passes an env-shaped
+ * record in. That keeps the module liftable and lets tests describe
+ * configured and unconfigured worlds without touching the real environment.
+ */
+export interface ImageModuleConfig {
+    /** Absent or empty means the feature is off; the server still boots. */
+    apiKey?: string;
+    model: string;
+    size: string;
+    quality: string;
+}
+export declare const DEFAULT_IMAGE_MODEL = "gpt-image-1";
+export declare const DEFAULT_IMAGE_SIZE = "1024x1024";
+export declare const DEFAULT_IMAGE_QUALITY = "medium";
+/** The env vars this module reads, all optional. */
+export interface ImageEnv {
+    OPENAI_API_KEY?: string;
+    IMAGE_MODEL?: string;
+    IMAGE_SIZE?: string;
+    IMAGE_QUALITY?: string;
+}
+export declare function resolveImageConfig(env?: ImageEnv, overrides?: Partial<ImageModuleConfig>): ImageModuleConfig;
+/** Feature detection: no key, no image generation. */
+export declare function isImageConfigured(config: ImageModuleConfig): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/images/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/images/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAC9C,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAE9C,oDAAoD;AACpD,MAAM,WAAW,QAAQ;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAOD,wBAAgB,kBAAkB,CAChC,GAAG,GAAE,QAAa,EAClB,SAAS,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACzC,iBAAiB,CAOnB;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAEpE"}

package/dist/images/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/images/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../src/images/config.test.ts"],"names":[],"mappings":""}