@southwind-ai/server-sdk 0.1.0

package/index.ts

@@ -0,0 +1,5 @@
+export type {
+  ModuleHost,
+  ModuleInitializer,
+  ModuleUploadPolicy,
+} from "./src/module-host.js";

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@southwind-ai/server-sdk",
+  "version": "0.1.0",
+  "license": "UNLICENSED",
+  "type": "module",
+  "engines": {
+    "bun": ">=1.3.0"
+  },
+  "files": [
+    "index.ts",
+    "src/module-host.ts"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit --project tsconfig.json"
+  },
+  "dependencies": {
+    "@southwind-ai/jobs": "workspace:*"
+  },
+  "exports": {
+    ".": "./index.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/module-host.ts

@@ -0,0 +1,29 @@
+import type { DurableHandlerDefinition } from "@southwind-ai/jobs";
+
+export interface ModuleUploadPolicy {
+  purpose: string;
+  maxByteSize: number;
+  maxPartByteSize: number;
+  sessionTtlMs: number;
+  allowedTypes: Readonly<Record<string, readonly string[]>>;
+  signature?: "image" | "none";
+}
+
+/**
+ * 模块作用域 Host。注册的任务 Key 与上传用途必须使用初始化器模块名作为命名空间。
+ */
+export interface ModuleHost {
+  readonly moduleName: string;
+  registerUploadPolicy(policy: ModuleUploadPolicy): void;
+  registerDurableHandler<T>(definition: DurableHandlerDefinition<T>): void;
+}
+
+/**
+ * 已安装模块的 Server 初始化入口。
+ *
+ * 初始化器在 Storage 与 Durable Job 运行时创建前顺序执行；这里只注册定义，不启动 Worker。
+ */
+export interface ModuleInitializer {
+  readonly moduleName: string;
+  initialize(host: ModuleHost): Promise<void> | void;
+}