@appthen/sdk-core 0.0.3 → 0.0.4

package/dist/index.d.ts

@@ -273,8 +273,17 @@ export interface CreateMessageInput {
     status?: string;
     metadata?: Record<string, unknown>;
 }
+/** 入口客户端信号：网关只认白名单 kind 与短 deviceId，用于运行时路由。 */
+export interface ChatHubEntryClientSignal {
+    kind: 'web' | 'desktop' | 'mobile';
+    deviceId?: string;
+}
+/** 运行偏好：auto = 服务端按入口策略决定；cloud = 用户显式选择云端执行。 */
+export type ChatHubRuntimePreference = 'auto' | 'cloud';
 export interface CreateInternalMessageInput extends CreateMessageInput {
     tenantId: string;
+    client?: ChatHubEntryClientSignal;
+    runtimePreference?: ChatHubRuntimePreference;
 }
 export interface QueryMessagesInput {
     tenantId?: string;
@@ -440,6 +449,10 @@ export interface SendTextMessageOptions {
     mentionedSubjectIds?: string[];
     metadata?: Record<string, unknown>;
     status?: string;
+    /** 这条消息从哪种客户端发出（运行时路由信号）。 */
+    client?: ChatHubEntryClientSignal;
+    /** 仅显式选择云端执行时传 `cloud`；默认不传 = 服务端按 auto 处理。 */
+    runtimePreference?: ChatHubRuntimePreference;
 }
 export interface SendChatHubMessageOptions {
     conversationId: string;
@@ -450,6 +463,8 @@ export interface SendChatHubMessageOptions {
     mentionedSubjectIds?: string[];
     metadata?: Record<string, unknown>;
     status?: string;
+    client?: ChatHubEntryClientSignal;
+    runtimePreference?: ChatHubRuntimePreference;
 }
 export interface ListChatHubMessagesOptions {
     conversationId: string;
@@ -608,6 +623,12 @@ export interface PlatformProvisionTenantInput {
     externalCorrelationId: string;
     /** 该租户被授予的 platform scope，缺省 ['platform:subject:sync']。 */
     grantScopes?: string[];
+    adminIdentifiers?: PlatformAdminIdentifier[];
+    adminDisplayName?: string;
+}
+export interface PlatformAdminIdentifier {
+    type: 'phone' | 'email';
+    value: string;
 }
 export interface PlatformProvisionTenantResult {
     tenantId: string;
@@ -616,6 +637,8 @@ export interface PlatformProvisionTenantResult {
     grantId: string;
     /** 仅首次开通返回（7d 有效）；认领激活时提交。 */
     claimToken?: string;
+    inviteId?: string;
+    inviteUrl?: string;
     /** false = 幂等命中（同 platformId + externalCorrelationId 已开通过）。 */
     created: boolean;
     [key: string]: unknown;
@@ -687,10 +710,21 @@ export interface PlatformResolveTenantResult {
         status: string;
     }>;
 }
+export interface PlatformAdminInviteInput {
+    adminIdentifiers: PlatformAdminIdentifier[];
+    adminDisplayName?: string;
+}
+export interface PlatformAdminInviteResult {
+    tenantId: string;
+    status: string;
+    inviteId: string;
+    inviteUrl: string;
+}
 export declare class PlatformApi extends BaseApi {
     provisionTenant(input: PlatformProvisionTenantInput): Promise<PlatformProvisionTenantResult>;
     syncSubject(targetTenantId: string, input: PlatformSyncSubjectInput): Promise<PlatformSyncSubjectResult>;
     resolveTenant(externalCorrelationId: string): Promise<PlatformResolveTenantResult>;
+    createAdminInvite(tenantId: string, input: PlatformAdminInviteInput): Promise<PlatformAdminInviteResult>;
     toggleGrant(grantId: string, status: 'active' | 'revoked'): Promise<Record<string, unknown>>;
     /**
      * 按标签/条件圈人并直接触达（声明式，调用方无 subjectId 概念）：

package/dist/index.js

@@ -657,6 +657,8 @@ export class ChatHubAppRuntime {
             mentionedSubjectIds: input.mentionedSubjectIds,
             metadata: input.metadata,
             status: input.status,
+            client: input.client,
+            runtimePreference: input.runtimePreference,
         });
     }
     async sendMessage(input) {
@@ -671,6 +673,8 @@ export class ChatHubAppRuntime {
             content: input.content,
             mentionedSubjectIds: input.mentionedSubjectIds,
             metadata: input.metadata,
+            client: input.client,
+            runtimePreference: input.runtimePreference,
         });
     }
     async updateMessage(input) {
@@ -828,6 +832,13 @@ export class PlatformApi extends BaseApi {
             query: { externalCorrelationId },
         });
     }
+    async createAdminInvite(tenantId, input) {
+        return this.request({
+            method: 'POST',
+            path: `/open-platform/platform/tenants/${encodeURIComponent(tenantId)}/admin-invites`,
+            body: input,
+        });
+    }
     async toggleGrant(grantId, status) {
         return this.request({
             method: 'POST',

package/dist-cjs/index.d.ts

@@ -273,8 +273,17 @@ export interface CreateMessageInput {
     status?: string;
     metadata?: Record<string, unknown>;
 }
+/** 入口客户端信号：网关只认白名单 kind 与短 deviceId，用于运行时路由。 */
+export interface ChatHubEntryClientSignal {
+    kind: 'web' | 'desktop' | 'mobile';
+    deviceId?: string;
+}
+/** 运行偏好：auto = 服务端按入口策略决定；cloud = 用户显式选择云端执行。 */
+export type ChatHubRuntimePreference = 'auto' | 'cloud';
 export interface CreateInternalMessageInput extends CreateMessageInput {
     tenantId: string;
+    client?: ChatHubEntryClientSignal;
+    runtimePreference?: ChatHubRuntimePreference;
 }
 export interface QueryMessagesInput {
     tenantId?: string;
@@ -440,6 +449,10 @@ export interface SendTextMessageOptions {
     mentionedSubjectIds?: string[];
     metadata?: Record<string, unknown>;
     status?: string;
+    /** 这条消息从哪种客户端发出（运行时路由信号）。 */
+    client?: ChatHubEntryClientSignal;
+    /** 仅显式选择云端执行时传 `cloud`；默认不传 = 服务端按 auto 处理。 */
+    runtimePreference?: ChatHubRuntimePreference;
 }
 export interface SendChatHubMessageOptions {
     conversationId: string;
@@ -450,6 +463,8 @@ export interface SendChatHubMessageOptions {
     mentionedSubjectIds?: string[];
     metadata?: Record<string, unknown>;
     status?: string;
+    client?: ChatHubEntryClientSignal;
+    runtimePreference?: ChatHubRuntimePreference;
 }
 export interface ListChatHubMessagesOptions {
     conversationId: string;
@@ -608,6 +623,12 @@ export interface PlatformProvisionTenantInput {
     externalCorrelationId: string;
     /** 该租户被授予的 platform scope，缺省 ['platform:subject:sync']。 */
     grantScopes?: string[];
+    adminIdentifiers?: PlatformAdminIdentifier[];
+    adminDisplayName?: string;
+}
+export interface PlatformAdminIdentifier {
+    type: 'phone' | 'email';
+    value: string;
 }
 export interface PlatformProvisionTenantResult {
     tenantId: string;
@@ -616,6 +637,8 @@ export interface PlatformProvisionTenantResult {
     grantId: string;
     /** 仅首次开通返回（7d 有效）；认领激活时提交。 */
     claimToken?: string;
+    inviteId?: string;
+    inviteUrl?: string;
     /** false = 幂等命中（同 platformId + externalCorrelationId 已开通过）。 */
     created: boolean;
     [key: string]: unknown;
@@ -687,10 +710,21 @@ export interface PlatformResolveTenantResult {
         status: string;
     }>;
 }
+export interface PlatformAdminInviteInput {
+    adminIdentifiers: PlatformAdminIdentifier[];
+    adminDisplayName?: string;
+}
+export interface PlatformAdminInviteResult {
+    tenantId: string;
+    status: string;
+    inviteId: string;
+    inviteUrl: string;
+}
 export declare class PlatformApi extends BaseApi {
     provisionTenant(input: PlatformProvisionTenantInput): Promise<PlatformProvisionTenantResult>;
     syncSubject(targetTenantId: string, input: PlatformSyncSubjectInput): Promise<PlatformSyncSubjectResult>;
     resolveTenant(externalCorrelationId: string): Promise<PlatformResolveTenantResult>;
+    createAdminInvite(tenantId: string, input: PlatformAdminInviteInput): Promise<PlatformAdminInviteResult>;
     toggleGrant(grantId: string, status: 'active' | 'revoked'): Promise<Record<string, unknown>>;
     /**
      * 按标签/条件圈人并直接触达（声明式，调用方无 subjectId 概念）：

package/dist-cjs/index.js

@@ -670,6 +670,8 @@ class ChatHubAppRuntime {
             mentionedSubjectIds: input.mentionedSubjectIds,
             metadata: input.metadata,
             status: input.status,
+            client: input.client,
+            runtimePreference: input.runtimePreference,
         });
     }
     async sendMessage(input) {
@@ -684,6 +686,8 @@ class ChatHubAppRuntime {
             content: input.content,
             mentionedSubjectIds: input.mentionedSubjectIds,
             metadata: input.metadata,
+            client: input.client,
+            runtimePreference: input.runtimePreference,
         });
     }
     async updateMessage(input) {
@@ -842,6 +846,13 @@ class PlatformApi extends BaseApi {
             query: { externalCorrelationId },
         });
     }
+    async createAdminInvite(tenantId, input) {
+        return this.request({
+            method: 'POST',
+            path: `/open-platform/platform/tenants/${encodeURIComponent(tenantId)}/admin-invites`,
+            body: input,
+        });
+    }
     async toggleGrant(grantId, status) {
         return this.request({
             method: 'POST',

package/package.json

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