@deepmaid/maid-delivery 0.0.0-stage → 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kenyonxu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: deepmaid-maid-delivery
+      name: '@deepmaid/maid-delivery'

package/lib/index.d.ts

@@ -0,0 +1,37 @@
+//#region src/types.d.ts
+interface DeliveryAddress {
+  botId: string;
+  targetId: string;
+}
+type DeliveryErrorCode = 'invalid-address' | 'unknown-bot' | 'unknown-target' | 'bot-not-connected' | 'transport' | 'unknown';
+type DeliveryResult = {
+  sent: true;
+} | {
+  sent: false;
+  code: DeliveryErrorCode;
+};
+interface MaidDelivery {
+  send(maidId: string, address: DeliveryAddress, text: string, opts?: {
+    signal?: AbortSignal;
+  }): Promise<DeliveryResult>;
+  verifyAddress(address: DeliveryAddress): Promise<{
+    ok: boolean;
+    reason?: string;
+  }>;
+}
+interface DshImLike {
+  send(botId: string, targetId: string, text: string, opts?: {
+    signal?: AbortSignal;
+  }): Promise<unknown>;
+  listTargets(botId: string): Promise<unknown[]>;
+}
+//#endregion
+//#region src/adapter.d.ts
+declare function createDshImDelivery(dshIm: DshImLike): MaidDelivery;
+//#endregion
+//#region src/index.d.ts
+declare const name = "maid-delivery";
+declare const inject: string[];
+declare const apply: (ctx: any, _config: Record<string, never>) => (() => void);
+//#endregion
+export { type DeliveryAddress, type DeliveryErrorCode, type DeliveryResult, type DshImLike, type MaidDelivery, apply, createDshImDelivery, inject, name };

package/lib/index.js

@@ -0,0 +1,62 @@
+//#region src/adapter.ts
+function dshImErrorCodeToDeliveryCode(code) {
+	switch (code) {
+		case "bad-request":
+		case "invalid-target": return "invalid-address";
+		case "target-conflict":
+		case "unknown-target": return "unknown-target";
+		case "unknown-bot": return "unknown-bot";
+		case "bot-not-connected": return "bot-not-connected";
+		case "ECONNRESET":
+		case "ETIMEDOUT":
+		case "ECONNREFUSED": return "transport";
+		default: return "unknown";
+	}
+}
+function createDshImDelivery(dshIm) {
+	return {
+		async send(_maidId, address, text, opts) {
+			if (address.botId.length === 0 || address.targetId.length === 0) return {
+				sent: false,
+				code: "invalid-address"
+			};
+			try {
+				const res = await dshIm.send(address.botId, address.targetId, text, opts);
+				if (res !== null && typeof res === "object" && "sent" in res && res.sent === true) return { sent: true };
+				return {
+					sent: false,
+					code: "unknown"
+				};
+			} catch (error) {
+				const code = error.code;
+				return {
+					sent: false,
+					code: dshImErrorCodeToDeliveryCode(typeof code === "string" ? code : void 0)
+				};
+			}
+		},
+		async verifyAddress(address) {
+			try {
+				return (await dshIm.listTargets(address.botId)).some((t) => typeof t === "object" && t !== null && Object.values(t).includes(address.targetId)) ? { ok: true } : {
+					ok: false,
+					reason: `targetId '${address.targetId}' not found on bot '${address.botId}'`
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					reason: `listTargets failed: ${error.message}`
+				};
+			}
+		}
+	};
+}
+//#endregion
+//#region src/index.ts
+const name = "maid-delivery";
+const inject = ["dshIm"];
+const apply = (ctx, _config) => {
+	const dispose = ctx.provide("maidDelivery", createDshImDelivery(ctx.dshIm));
+	return () => dispose();
+};
+//#endregion
+export { apply, createDshImDelivery, inject, name };

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@deepmaid/maid-delivery",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-alpha.1",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "engines": {
+      "dsh": ">=0.2.1-rc.2 <0.3"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "meta": {
+      "title": "Maid Delivery",
+      "description": "cron 产物投递 seam:把晨报等 cron 会话结果送抵 IM 渠道(M1 唯一 provider 是 dsh-im 适配器)。关闭=晨报照常生成但无人投递,主人收不到任何定时消息。"
+    }
+  },
+  "devDependencies": {
+    "tsdown": "0.22.14",
+    "typescript": "6.0.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.