@appthen/sdk-core 0.0.0 → 0.0.1

package/dist/index.d.ts

@@ -612,5 +612,56 @@ export declare class PlatformApi extends BaseApi {
     syncSubject(targetTenantId: string, input: PlatformSyncSubjectInput): Promise<PlatformSyncSubjectResult>;
     resolveTenant(externalCorrelationId: string): Promise<PlatformResolveTenantResult>;
     toggleGrant(grantId: string, status: 'active' | 'revoked'): Promise<Record<string, unknown>>;
+    /**
+     * 按标签/条件圈人并直接触达（声明式，调用方无 subjectId 概念）：
+     * 发送者/收件人按 {source, externalKey, displayName, avatarUrl?} 声明，
+     * 服务端 lazily create-or-get（幂等键 = externalIdentity，与成员同步同一内核）；
+     * 收件人二选一：标签圈人（selector）或单点声明（receive，如微信客服消息迁移）。
+     */
+    notify(targetTenantId: string, request: PlatformNotifyRequest, notify: PlatformNotifyInput): Promise<PlatformNotifyResult>;
+}
+/** 声明式主体引用：调用方只需本地维护 id/昵称/头像，服务端 lazily create-or-get。 */
+export interface PlatformLazySubject {
+    source: string;
+    externalKey: string;
+    displayName: string;
+    avatarUrl?: string;
+}
+export interface PlatformNotifySelector {
+    /** 圈人标签（多个取交集）。命名须带来源前缀，如 lims:role:admin。 */
+    tags: string[];
+    /** 限定主体类（可选）。 */
+    classId?: string;
+}
+export interface PlatformNotifyRequest {
+    /** 标签圈人（与 receive 二选一）。 */
+    selector?: PlatformNotifySelector;
+    /** 单点声明收件人（与 selector 二选一）。 */
+    receive?: PlatformLazySubject;
+}
+export interface PlatformNotifyInput {
+    /** 本次触达涉及的外部主体类（lazy 创建 sender/receiver 所用）。 */
+    classId: string;
+    /** 消息发送者（声明式，lazily create-or-get）。 */
+    sender: PlatformLazySubject;
+    /** 通知会话类型（须已存在；AppThen 侧预建或经 open/types 创建）。 */
+    typeId: string;
+    /** 消息类型（'text' 起，语音播报后续走 kind 扩展）。 */
+    kind: string;
+    content: Record<string, unknown>;
+    /** 通知会话标题（首次创建时使用，默认「LIMS 通知」）。 */
+    title?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface PlatformNotifyResult {
+    /** 圈中人数。 */
+    matched: number;
+    /** 成功送达人数。 */
+    delivered: number;
+    /** 失败明细（含原因，不中断整体）。 */
+    failed: Array<{
+        subjectId: string;
+        reason: string;
+    }>;
 }
 export {};

package/dist/index.js

@@ -786,4 +786,17 @@ export class PlatformApi extends BaseApi {
             body: { status },
         });
     }
+    /**
+     * 按标签/条件圈人并直接触达（声明式，调用方无 subjectId 概念）：
+     * 发送者/收件人按 {source, externalKey, displayName, avatarUrl?} 声明，
+     * 服务端 lazily create-or-get（幂等键 = externalIdentity，与成员同步同一内核）；
+     * 收件人二选一：标签圈人（selector）或单点声明（receive，如微信客服消息迁移）。
+     */
+    async notify(targetTenantId, request, notify) {
+        return this.request({
+            method: 'POST',
+            path: '/open-platform/platform/messages:send',
+            body: { ...notify, ...request, targetTenantId },
+        });
+    }
 }

package/dist-cjs/index.d.ts

@@ -612,5 +612,56 @@ export declare class PlatformApi extends BaseApi {
     syncSubject(targetTenantId: string, input: PlatformSyncSubjectInput): Promise<PlatformSyncSubjectResult>;
     resolveTenant(externalCorrelationId: string): Promise<PlatformResolveTenantResult>;
     toggleGrant(grantId: string, status: 'active' | 'revoked'): Promise<Record<string, unknown>>;
+    /**
+     * 按标签/条件圈人并直接触达（声明式，调用方无 subjectId 概念）：
+     * 发送者/收件人按 {source, externalKey, displayName, avatarUrl?} 声明，
+     * 服务端 lazily create-or-get（幂等键 = externalIdentity，与成员同步同一内核）；
+     * 收件人二选一：标签圈人（selector）或单点声明（receive，如微信客服消息迁移）。
+     */
+    notify(targetTenantId: string, request: PlatformNotifyRequest, notify: PlatformNotifyInput): Promise<PlatformNotifyResult>;
+}
+/** 声明式主体引用：调用方只需本地维护 id/昵称/头像，服务端 lazily create-or-get。 */
+export interface PlatformLazySubject {
+    source: string;
+    externalKey: string;
+    displayName: string;
+    avatarUrl?: string;
+}
+export interface PlatformNotifySelector {
+    /** 圈人标签（多个取交集）。命名须带来源前缀，如 lims:role:admin。 */
+    tags: string[];
+    /** 限定主体类（可选）。 */
+    classId?: string;
+}
+export interface PlatformNotifyRequest {
+    /** 标签圈人（与 receive 二选一）。 */
+    selector?: PlatformNotifySelector;
+    /** 单点声明收件人（与 selector 二选一）。 */
+    receive?: PlatformLazySubject;
+}
+export interface PlatformNotifyInput {
+    /** 本次触达涉及的外部主体类（lazy 创建 sender/receiver 所用）。 */
+    classId: string;
+    /** 消息发送者（声明式，lazily create-or-get）。 */
+    sender: PlatformLazySubject;
+    /** 通知会话类型（须已存在；AppThen 侧预建或经 open/types 创建）。 */
+    typeId: string;
+    /** 消息类型（'text' 起，语音播报后续走 kind 扩展）。 */
+    kind: string;
+    content: Record<string, unknown>;
+    /** 通知会话标题（首次创建时使用，默认「LIMS 通知」）。 */
+    title?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface PlatformNotifyResult {
+    /** 圈中人数。 */
+    matched: number;
+    /** 成功送达人数。 */
+    delivered: number;
+    /** 失败明细（含原因，不中断整体）。 */
+    failed: Array<{
+        subjectId: string;
+        reason: string;
+    }>;
 }
 export {};

package/dist-cjs/index.js

@@ -798,5 +798,18 @@ class PlatformApi extends BaseApi {
             body: { status },
         });
     }
+    /**
+     * 按标签/条件圈人并直接触达（声明式，调用方无 subjectId 概念）：
+     * 发送者/收件人按 {source, externalKey, displayName, avatarUrl?} 声明，
+     * 服务端 lazily create-or-get（幂等键 = externalIdentity，与成员同步同一内核）；
+     * 收件人二选一：标签圈人（selector）或单点声明（receive，如微信客服消息迁移）。
+     */
+    async notify(targetTenantId, request, notify) {
+        return this.request({
+            method: 'POST',
+            path: '/open-platform/platform/messages:send',
+            body: { ...notify, ...request, targetTenantId },
+        });
+    }
 }
 exports.PlatformApi = PlatformApi;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appthen/sdk-core",
-  "version": "0.0.0",
+  "version": "0.0.1",
   "description": "AppThen Conversation Hub SDK - platform-agnostic core",
   "type": "module",
   "main": "./dist/index.js",