discord-mudlet-map 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -3,5 +3,6 @@ export * as LocationResolvers from "./location-resolvers.js";
 export * as MapProviders from "./map-providers.js";
 export * as SearchFunctions from "./search-functions.js";
 export { prepareMap } from "./prepare-map.js";
+export { renderLocation, type LocationReply } from "./message-create.js";
 export type { MapConfig, MapConfigEntry, MapProvider, LocationExtractor, MessageCreator, RendererOptions, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACV,SAAS,EACT,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzE,YAAY,EACV,SAAS,EACT,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -3,4 +3,5 @@ export * as LocationResolvers from "./location-resolvers.js";
 export * as MapProviders from "./map-providers.js";
 export * as SearchFunctions from "./search-functions.js";
 export { prepareMap } from "./prepare-map.js";
+export { renderLocation } from "./message-create.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAsB,MAAM,qBAAqB,CAAC"}

package/dist/message-create.d.ts

@@ -1,4 +1,22 @@
 import type { Message } from "discord.js";
-import type { MapConfig } from "./types.js";
+import type { MapConfigEntry, MapConfig } from "./types.js";
+/** What a location turns into: a reply to send, or `null` when there is nothing to send. */
+export type LocationReply = string | {
+    content: string;
+    files?: {
+        attachment: Buffer;
+        name: string;
+    }[];
+} | null;
+/**
+ * Renders one room of one configured map into a reply, independent of how it
+ * was asked for — a message matched by `locationExtractor`, or a slash command
+ * that already holds the room id.
+ *
+ * A plain string is an explanation (map not ready, unknown room); an object is
+ * the reply proper. `null` means the entry cannot answer at all (no reader yet,
+ * or the export came back empty), and the caller stays silent as before.
+ */
+export declare function renderLocation(key: string, entry: MapConfigEntry, roomId: number): LocationReply;
 export default function mapCommand(config: MapConfig): (message: Message) => Promise<void>;
 //# sourceMappingURL=message-create.d.ts.map

package/dist/message-create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-create.d.ts","sourceRoot":"","sources":["../src/message-create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAwB,MAAM,YAAY,CAAC;AAKlE,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,MAAM,EAAE,SAAS,IACpC,SAAS,OAAO,mBAoF/B"}
+{"version":3,"file":"message-create.d.ts","sourceRoot":"","sources":["../src/message-create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAwB,MAAM,YAAY,CAAC;AAKlF,4FAA4F;AAC5F,MAAM,MAAM,aAAa,GACrB,MAAM,GACN;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,GACnE,IAAI,CAAC;AAET;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,GACb,aAAa,CA0Cf;AAED,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,MAAM,EAAE,SAAS,IACpC,SAAS,OAAO,mBAoB/B"}

package/dist/message-create.js

@@ -1,5 +1,55 @@
 import { PngBytesExporter } from "mudlet-map-renderer";
 const defaultMessageCreator = (key, area) => `${key} - ${area.areaName}`;
+/**
+ * Renders one room of one configured map into a reply, independent of how it
+ * was asked for — a message matched by `locationExtractor`, or a slash command
+ * that already holds the room id.
+ *
+ * A plain string is an explanation (map not ready, unknown room); an object is
+ * the reply proper. `null` means the entry cannot answer at all (no reader yet,
+ * or the export came back empty), and the caller stays silent as before.
+ */
+export function renderLocation(key, entry, roomId) {
+    const reader = entry.reader;
+    if (!reader)
+        return null;
+    const renderArea = entry.renderArea ?? false;
+    const textOnly = !entry.provider && !entry.mapRenderer;
+    if (!entry.mapRenderer && !textOnly)
+        return `${key} - map not ready`;
+    let room;
+    let area;
+    try {
+        room = reader.getRoom(roomId);
+        area = reader.getArea(room.area);
+    }
+    catch {
+        return `${key} - no location ID`;
+    }
+    if (!room || !area)
+        return `${key} - no location ID`;
+    const areaInfo = { areaName: area.getAreaName(), areaId: area.getAreaId() };
+    const content = (entry.messageCreator ?? defaultMessageCreator)(key, areaInfo, room);
+    if (textOnly)
+        return { content };
+    const renderer = entry.mapRenderer;
+    renderer.drawArea(room.area, room.z);
+    renderer.setPosition(roomId, true);
+    const bytes = renderer.export(new PngBytesExporter({
+        width: 1200,
+        height: 1200,
+        roomId: renderArea ? undefined : roomId,
+        padding: renderArea ? 3 : 10,
+    }));
+    if (!bytes) {
+        console.log(`${key} - PNG export returned empty buffer`);
+        return null;
+    }
+    return {
+        content,
+        files: [{ attachment: Buffer.from(bytes), name: `${key} - ${roomId}.png` }],
+    };
+}
 export default function mapCommand(config) {
     return async (message) => {
         const channel = message.channel;
@@ -7,70 +57,16 @@ export default function mapCommand(config) {
             return;
         for (const key of Object.keys(config)) {
             const element = config[key];
-            element.renderArea = element.renderArea ?? false;
             const reader = element.reader;
             if (!reader)
                 continue;
             const extracted = element.locationExtractor(message.content, reader);
             if (!extracted)
                 continue;
-            const textOnly = !element.provider && !element.mapRenderer;
-            if (!element.mapRenderer && !textOnly) {
-                await channel.send(`${key} - map not ready`);
-                continue;
-            }
-            const roomId = Number(extracted);
-            let room;
-            let area;
-            try {
-                room = reader.getRoom(roomId);
-                area = reader.getArea(room.area);
-            }
-            catch {
-                await channel.send(`${key} - no location ID`);
-                continue;
-            }
-            if (!room || !area) {
-                await channel.send(`${key} - no location ID`);
-                continue;
-            }
-            const areaInfo = {
-                areaName: area.getAreaName(),
-                areaId: area.getAreaId(),
-            };
-            const content = (element.messageCreator ?? defaultMessageCreator)(key, areaInfo, room);
-            if (textOnly) {
-                try {
-                    await channel.send({ content });
-                }
-                catch (err) {
-                    console.log(err);
-                }
-                continue;
-            }
             try {
-                const renderer = element.mapRenderer;
-                renderer.drawArea(room.area, room.z);
-                renderer.setPosition(roomId, true);
-                const bytes = renderer.export(new PngBytesExporter({
-                    width: 1200,
-                    height: 1200,
-                    roomId: element.renderArea ? undefined : roomId,
-                    padding: element.renderArea ? 3 : 10
-                }));
-                if (!bytes) {
-                    console.log(`${key} - PNG export returned empty buffer`);
-                    continue;
-                }
-                await channel.send({
-                    content,
-                    files: [
-                        {
-                            attachment: Buffer.from(bytes),
-                            name: `${key} - ${roomId}.png`,
-                        },
-                    ],
-                });
+                const reply = renderLocation(key, element, Number(extracted));
+                if (reply !== null)
+                    await channel.send(reply);
             }
             catch (err) {
                 console.log(err);

package/dist/message-create.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-create.js","sourceRoot":"","sources":["../src/message-create.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"message-create.js","sourceRoot":"","sources":["../src/message-create.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "discord-mudlet-map",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",