@agentgo-tw/app-sdk 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +261 -2
- package/dist/browser.cjs +233 -0
- package/dist/browser.d.cts +20 -0
- package/dist/browser.d.ts +20 -0
- package/dist/browser.js +64 -0
- package/dist/chunk-6QX4VARC.js +159 -0
- package/dist/index.cjs +484 -0
- package/dist/index.d.cts +122 -0
- package/dist/index.d.ts +122 -0
- package/dist/index.js +314 -0
- package/dist/version-CAQs9BfE.d.cts +225 -0
- package/dist/version-CAQs9BfE.d.ts +225 -0
- package/package.json +51 -4
package/dist/index.d.cts
ADDED
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
import { k as AppIdentityEnv, c as AcademyContext, g as AcademyJobInfo, a as AcademyAI, b as AcademyOD, h as AcademyQuota } from './version-CAQs9BfE.cjs';
|
|
2
|
+
export { d as AcademyEntitlement, e as AcademyError, f as AcademyErrorCode, A as AcademyMe, i as AcademyUser, j as AppEntitlementKind, l as AppJobStatus, C as CONTRACT_VERSION, m as ChatCompletion, n as ChatCompletionChunk, o as ChatCompletionRequest, p as ChatMessage, q as ChatRole, I as ImageGenerateRequest, r as ImageGenerateResponse, M as MembershipTier, O as OdQuery, s as OdResult, S as SDK_VERSION, t as SpeechRequest, u as SpeechResponse } from './version-CAQs9BfE.cjs';
|
|
3
|
+
|
|
4
|
+
interface AcademyOptions {
|
|
5
|
+
/** 預設讀平台注入的 `ACADEMY_APP_UUID` */
|
|
6
|
+
appUuid?: string;
|
|
7
|
+
/** 預設讀平台注入的 `ACADEMY_APP_TOKEN` */
|
|
8
|
+
appToken?: string;
|
|
9
|
+
/** 預設讀 `ACADEMY_BASE_URL`,再沒有用 `https://agentgo.tw` */
|
|
10
|
+
baseUrl?: string;
|
|
11
|
+
/** 預設讀平台注入的 `ACADEMY_ENV`(`test`/`production`) */
|
|
12
|
+
env?: AppIdentityEnv;
|
|
13
|
+
/** 本機開發模式:預設讀 `ACADEMY_DEV_MODE=1`;在平台上(有 `ACADEMY_ENV`)一律忽略 */
|
|
14
|
+
devMode?: boolean;
|
|
15
|
+
/** 開發模式用的個人開發金鑰:預設讀 `ACADEMY_DEV_KEY` */
|
|
16
|
+
devKey?: string;
|
|
17
|
+
/** 開發模式的假身分:預設讀 `ACADEMY_DEV_USER`(會員編號或 email) */
|
|
18
|
+
devUser?: string;
|
|
19
|
+
/** 測試用:替換 fetch */
|
|
20
|
+
fetch?: typeof fetch;
|
|
21
|
+
/** 印警告的地方,預設 console.warn */
|
|
22
|
+
warn?: (msg: string) => void;
|
|
23
|
+
}
|
|
24
|
+
/** 工作憑證(spec/16 § 10):可存進資料庫交給背景工作,背景工作以 `academy.jobs.resume(token)` 取回 */
|
|
25
|
+
interface AcademyJobHandle {
|
|
26
|
+
readonly kind: 'job';
|
|
27
|
+
readonly jobUuid: string;
|
|
28
|
+
readonly token: string;
|
|
29
|
+
readonly expiresAt: string;
|
|
30
|
+
/** 查狀態與已用點數 */
|
|
31
|
+
status(): Promise<AcademyJobInfo>;
|
|
32
|
+
/** 結束工作,釋放沒用完的預佔點數(冪等) */
|
|
33
|
+
close(): Promise<AcademyJobInfo>;
|
|
34
|
+
}
|
|
35
|
+
/** `ai()`、`od()`、`getQuota()`、`jobs.open()` 接受:Express 的 req(掛了 `req.academy`)、`AcademyContext`、工作憑證 */
|
|
36
|
+
type AcademyBinding = AcademyContext | AcademyJobHandle | {
|
|
37
|
+
academy?: AcademyContext | null;
|
|
38
|
+
} | null | undefined;
|
|
39
|
+
/** 最小化的 Express 型別(SDK 不依賴 express) */
|
|
40
|
+
interface ReqLike {
|
|
41
|
+
method?: string;
|
|
42
|
+
url?: string;
|
|
43
|
+
originalUrl?: string;
|
|
44
|
+
headers: Record<string, string | string[] | undefined>;
|
|
45
|
+
academy?: AcademyContext | null;
|
|
46
|
+
}
|
|
47
|
+
interface ResLike {
|
|
48
|
+
status(code: number): ResLike;
|
|
49
|
+
setHeader(name: string, value: string): unknown;
|
|
50
|
+
json(body: unknown): unknown;
|
|
51
|
+
}
|
|
52
|
+
declare class Academy {
|
|
53
|
+
readonly appUuid: string;
|
|
54
|
+
readonly baseUrl: string;
|
|
55
|
+
readonly env: AppIdentityEnv | null;
|
|
56
|
+
/** 是否在本機開發模式(不驗章、用假身分、改帶開發金鑰) */
|
|
57
|
+
readonly devMode: boolean;
|
|
58
|
+
/** 給前端用的網址 */
|
|
59
|
+
readonly urls: {
|
|
60
|
+
subscribe: string;
|
|
61
|
+
upgrade: string;
|
|
62
|
+
points: string;
|
|
63
|
+
logout: string;
|
|
64
|
+
};
|
|
65
|
+
readonly jobs: {
|
|
66
|
+
open(binding: AcademyBinding, opts: {
|
|
67
|
+
maxPoints: number;
|
|
68
|
+
ttlSeconds: number;
|
|
69
|
+
purpose: string;
|
|
70
|
+
}): Promise<AcademyJobHandle>;
|
|
71
|
+
resume(token: string): AcademyJobHandle;
|
|
72
|
+
get(jobUuid: string): Promise<AcademyJobInfo>;
|
|
73
|
+
close(jobUuid: string): Promise<AcademyJobInfo>;
|
|
74
|
+
};
|
|
75
|
+
private readonly appToken;
|
|
76
|
+
private readonly devKey;
|
|
77
|
+
private readonly devUser;
|
|
78
|
+
private readonly fetchImpl;
|
|
79
|
+
private readonly verifier;
|
|
80
|
+
constructor(opts?: AcademyOptions);
|
|
81
|
+
/** 平台注入的設定是否齊全(自檢回報用) */
|
|
82
|
+
get configOk(): boolean;
|
|
83
|
+
/**
|
|
84
|
+
* 從請求標頭取得身分:驗 `X-Academy-Identity`(ES256、`aud` 為本 App、未過期)。
|
|
85
|
+
* 沒有身分或驗不過回 null——公開路徑與尚未啟用的正式環境本來就沒有身分。開發模式回假身分。
|
|
86
|
+
*/
|
|
87
|
+
fromHeaders(headers: Headers | Record<string, string | string[] | undefined>): Promise<AcademyContext | null>;
|
|
88
|
+
/** fetch 標準 Request 版本(Next.js Route Handler、Hono、Workers…) */
|
|
89
|
+
fromRequest(request: Request): Promise<AcademyContext | null>;
|
|
90
|
+
/**
|
|
91
|
+
* Express/Connect middleware:把身分掛到 `req.academy`(沒有為 null),並自動回應 `GET /__academy/selfcheck`(上架自檢)。
|
|
92
|
+
*/
|
|
93
|
+
express(): (req: ReqLike, res: ResLike, next: (err?: unknown) => void) => void;
|
|
94
|
+
/**
|
|
95
|
+
* fetch 標準版本的自檢:路徑是 `/__academy/selfcheck` 時回 Response,否則回 null。
|
|
96
|
+
* Next.js 請放在 `middleware.ts`(`app/` 底下以底線開頭的資料夾不會成為路由)。
|
|
97
|
+
*/
|
|
98
|
+
handleSelfcheck(request: Request): Promise<Response | null>;
|
|
99
|
+
/** 上架自檢的回應(api/app-runtime/reserved-paths.md):驗平台簽章的挑戰值後原樣帶回 */
|
|
100
|
+
selfcheck(url: URL): Promise<{
|
|
101
|
+
status: number;
|
|
102
|
+
body: Record<string, unknown>;
|
|
103
|
+
}>;
|
|
104
|
+
/** 平台 AI(aihub 相容層):綁定這次請求的身分或工作憑證 */
|
|
105
|
+
ai(binding: AcademyBinding): AcademyAI;
|
|
106
|
+
/** 房市資料 */
|
|
107
|
+
od(binding: AcademyBinding): AcademyOD;
|
|
108
|
+
/** 會員當期點數;測試環境與開發模式另附擁有者的開發額度 */
|
|
109
|
+
getQuota(binding: AcademyBinding): Promise<AcademyQuota>;
|
|
110
|
+
private devContext;
|
|
111
|
+
private openJob;
|
|
112
|
+
private jobHandle;
|
|
113
|
+
/** 只帶 App 身分(App token;開發模式為開發金鑰):查詢與結束工作 */
|
|
114
|
+
private appTransport;
|
|
115
|
+
private transport;
|
|
116
|
+
private makeTransport;
|
|
117
|
+
private failing;
|
|
118
|
+
}
|
|
119
|
+
/** 建立 SDK(伺服器端)。預設讀平台注入的 `ACADEMY_*` 環境變數。 */
|
|
120
|
+
declare function createAcademy(opts?: AcademyOptions): Academy;
|
|
121
|
+
|
|
122
|
+
export { Academy, AcademyAI, type AcademyBinding, AcademyContext, type AcademyJobHandle, AcademyJobInfo, AcademyOD, type AcademyOptions, AcademyQuota, AppIdentityEnv, createAcademy };
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
import { k as AppIdentityEnv, c as AcademyContext, g as AcademyJobInfo, a as AcademyAI, b as AcademyOD, h as AcademyQuota } from './version-CAQs9BfE.js';
|
|
2
|
+
export { d as AcademyEntitlement, e as AcademyError, f as AcademyErrorCode, A as AcademyMe, i as AcademyUser, j as AppEntitlementKind, l as AppJobStatus, C as CONTRACT_VERSION, m as ChatCompletion, n as ChatCompletionChunk, o as ChatCompletionRequest, p as ChatMessage, q as ChatRole, I as ImageGenerateRequest, r as ImageGenerateResponse, M as MembershipTier, O as OdQuery, s as OdResult, S as SDK_VERSION, t as SpeechRequest, u as SpeechResponse } from './version-CAQs9BfE.js';
|
|
3
|
+
|
|
4
|
+
interface AcademyOptions {
|
|
5
|
+
/** 預設讀平台注入的 `ACADEMY_APP_UUID` */
|
|
6
|
+
appUuid?: string;
|
|
7
|
+
/** 預設讀平台注入的 `ACADEMY_APP_TOKEN` */
|
|
8
|
+
appToken?: string;
|
|
9
|
+
/** 預設讀 `ACADEMY_BASE_URL`,再沒有用 `https://agentgo.tw` */
|
|
10
|
+
baseUrl?: string;
|
|
11
|
+
/** 預設讀平台注入的 `ACADEMY_ENV`(`test`/`production`) */
|
|
12
|
+
env?: AppIdentityEnv;
|
|
13
|
+
/** 本機開發模式:預設讀 `ACADEMY_DEV_MODE=1`;在平台上(有 `ACADEMY_ENV`)一律忽略 */
|
|
14
|
+
devMode?: boolean;
|
|
15
|
+
/** 開發模式用的個人開發金鑰:預設讀 `ACADEMY_DEV_KEY` */
|
|
16
|
+
devKey?: string;
|
|
17
|
+
/** 開發模式的假身分:預設讀 `ACADEMY_DEV_USER`(會員編號或 email) */
|
|
18
|
+
devUser?: string;
|
|
19
|
+
/** 測試用:替換 fetch */
|
|
20
|
+
fetch?: typeof fetch;
|
|
21
|
+
/** 印警告的地方,預設 console.warn */
|
|
22
|
+
warn?: (msg: string) => void;
|
|
23
|
+
}
|
|
24
|
+
/** 工作憑證(spec/16 § 10):可存進資料庫交給背景工作,背景工作以 `academy.jobs.resume(token)` 取回 */
|
|
25
|
+
interface AcademyJobHandle {
|
|
26
|
+
readonly kind: 'job';
|
|
27
|
+
readonly jobUuid: string;
|
|
28
|
+
readonly token: string;
|
|
29
|
+
readonly expiresAt: string;
|
|
30
|
+
/** 查狀態與已用點數 */
|
|
31
|
+
status(): Promise<AcademyJobInfo>;
|
|
32
|
+
/** 結束工作,釋放沒用完的預佔點數(冪等) */
|
|
33
|
+
close(): Promise<AcademyJobInfo>;
|
|
34
|
+
}
|
|
35
|
+
/** `ai()`、`od()`、`getQuota()`、`jobs.open()` 接受:Express 的 req(掛了 `req.academy`)、`AcademyContext`、工作憑證 */
|
|
36
|
+
type AcademyBinding = AcademyContext | AcademyJobHandle | {
|
|
37
|
+
academy?: AcademyContext | null;
|
|
38
|
+
} | null | undefined;
|
|
39
|
+
/** 最小化的 Express 型別(SDK 不依賴 express) */
|
|
40
|
+
interface ReqLike {
|
|
41
|
+
method?: string;
|
|
42
|
+
url?: string;
|
|
43
|
+
originalUrl?: string;
|
|
44
|
+
headers: Record<string, string | string[] | undefined>;
|
|
45
|
+
academy?: AcademyContext | null;
|
|
46
|
+
}
|
|
47
|
+
interface ResLike {
|
|
48
|
+
status(code: number): ResLike;
|
|
49
|
+
setHeader(name: string, value: string): unknown;
|
|
50
|
+
json(body: unknown): unknown;
|
|
51
|
+
}
|
|
52
|
+
declare class Academy {
|
|
53
|
+
readonly appUuid: string;
|
|
54
|
+
readonly baseUrl: string;
|
|
55
|
+
readonly env: AppIdentityEnv | null;
|
|
56
|
+
/** 是否在本機開發模式(不驗章、用假身分、改帶開發金鑰) */
|
|
57
|
+
readonly devMode: boolean;
|
|
58
|
+
/** 給前端用的網址 */
|
|
59
|
+
readonly urls: {
|
|
60
|
+
subscribe: string;
|
|
61
|
+
upgrade: string;
|
|
62
|
+
points: string;
|
|
63
|
+
logout: string;
|
|
64
|
+
};
|
|
65
|
+
readonly jobs: {
|
|
66
|
+
open(binding: AcademyBinding, opts: {
|
|
67
|
+
maxPoints: number;
|
|
68
|
+
ttlSeconds: number;
|
|
69
|
+
purpose: string;
|
|
70
|
+
}): Promise<AcademyJobHandle>;
|
|
71
|
+
resume(token: string): AcademyJobHandle;
|
|
72
|
+
get(jobUuid: string): Promise<AcademyJobInfo>;
|
|
73
|
+
close(jobUuid: string): Promise<AcademyJobInfo>;
|
|
74
|
+
};
|
|
75
|
+
private readonly appToken;
|
|
76
|
+
private readonly devKey;
|
|
77
|
+
private readonly devUser;
|
|
78
|
+
private readonly fetchImpl;
|
|
79
|
+
private readonly verifier;
|
|
80
|
+
constructor(opts?: AcademyOptions);
|
|
81
|
+
/** 平台注入的設定是否齊全(自檢回報用) */
|
|
82
|
+
get configOk(): boolean;
|
|
83
|
+
/**
|
|
84
|
+
* 從請求標頭取得身分:驗 `X-Academy-Identity`(ES256、`aud` 為本 App、未過期)。
|
|
85
|
+
* 沒有身分或驗不過回 null——公開路徑與尚未啟用的正式環境本來就沒有身分。開發模式回假身分。
|
|
86
|
+
*/
|
|
87
|
+
fromHeaders(headers: Headers | Record<string, string | string[] | undefined>): Promise<AcademyContext | null>;
|
|
88
|
+
/** fetch 標準 Request 版本(Next.js Route Handler、Hono、Workers…) */
|
|
89
|
+
fromRequest(request: Request): Promise<AcademyContext | null>;
|
|
90
|
+
/**
|
|
91
|
+
* Express/Connect middleware:把身分掛到 `req.academy`(沒有為 null),並自動回應 `GET /__academy/selfcheck`(上架自檢)。
|
|
92
|
+
*/
|
|
93
|
+
express(): (req: ReqLike, res: ResLike, next: (err?: unknown) => void) => void;
|
|
94
|
+
/**
|
|
95
|
+
* fetch 標準版本的自檢:路徑是 `/__academy/selfcheck` 時回 Response,否則回 null。
|
|
96
|
+
* Next.js 請放在 `middleware.ts`(`app/` 底下以底線開頭的資料夾不會成為路由)。
|
|
97
|
+
*/
|
|
98
|
+
handleSelfcheck(request: Request): Promise<Response | null>;
|
|
99
|
+
/** 上架自檢的回應(api/app-runtime/reserved-paths.md):驗平台簽章的挑戰值後原樣帶回 */
|
|
100
|
+
selfcheck(url: URL): Promise<{
|
|
101
|
+
status: number;
|
|
102
|
+
body: Record<string, unknown>;
|
|
103
|
+
}>;
|
|
104
|
+
/** 平台 AI(aihub 相容層):綁定這次請求的身分或工作憑證 */
|
|
105
|
+
ai(binding: AcademyBinding): AcademyAI;
|
|
106
|
+
/** 房市資料 */
|
|
107
|
+
od(binding: AcademyBinding): AcademyOD;
|
|
108
|
+
/** 會員當期點數;測試環境與開發模式另附擁有者的開發額度 */
|
|
109
|
+
getQuota(binding: AcademyBinding): Promise<AcademyQuota>;
|
|
110
|
+
private devContext;
|
|
111
|
+
private openJob;
|
|
112
|
+
private jobHandle;
|
|
113
|
+
/** 只帶 App 身分(App token;開發模式為開發金鑰):查詢與結束工作 */
|
|
114
|
+
private appTransport;
|
|
115
|
+
private transport;
|
|
116
|
+
private makeTransport;
|
|
117
|
+
private failing;
|
|
118
|
+
}
|
|
119
|
+
/** 建立 SDK(伺服器端)。預設讀平台注入的 `ACADEMY_*` 環境變數。 */
|
|
120
|
+
declare function createAcademy(opts?: AcademyOptions): Academy;
|
|
121
|
+
|
|
122
|
+
export { Academy, AcademyAI, type AcademyBinding, AcademyContext, type AcademyJobHandle, AcademyJobInfo, AcademyOD, type AcademyOptions, AcademyQuota, AppIdentityEnv, createAcademy };
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,314 @@
|
|
|
1
|
+
import {
|
|
2
|
+
AcademyError,
|
|
3
|
+
CONTRACT_VERSION,
|
|
4
|
+
SDK_VERSION,
|
|
5
|
+
createAiClient,
|
|
6
|
+
createOdClient,
|
|
7
|
+
json,
|
|
8
|
+
toQuery
|
|
9
|
+
} from "./chunk-6QX4VARC.js";
|
|
10
|
+
|
|
11
|
+
// src/jwt.ts
|
|
12
|
+
var b64urlToBytes = (s) => {
|
|
13
|
+
const pad = s.length % 4 === 2 ? "==" : s.length % 4 === 3 ? "=" : "";
|
|
14
|
+
const bin = atob(s.replace(/-/g, "+").replace(/_/g, "/") + pad);
|
|
15
|
+
const out = new Uint8Array(bin.length);
|
|
16
|
+
for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
|
|
17
|
+
return out;
|
|
18
|
+
};
|
|
19
|
+
var decodeJwtPart = (part) => JSON.parse(new TextDecoder().decode(b64urlToBytes(part)));
|
|
20
|
+
var JwksVerifier = class {
|
|
21
|
+
constructor(jwksUrl, fetchImpl, ttlMs = 5 * 6e4) {
|
|
22
|
+
this.jwksUrl = jwksUrl;
|
|
23
|
+
this.fetchImpl = fetchImpl;
|
|
24
|
+
this.ttlMs = ttlMs;
|
|
25
|
+
}
|
|
26
|
+
jwksUrl;
|
|
27
|
+
fetchImpl;
|
|
28
|
+
ttlMs;
|
|
29
|
+
keys = /* @__PURE__ */ new Map();
|
|
30
|
+
fetchedAt = 0;
|
|
31
|
+
inflight = null;
|
|
32
|
+
/** 驗章與效期;任何一項不符回 null(不拋錯) */
|
|
33
|
+
async verify(token, nowSeconds = Math.floor(Date.now() / 1e3)) {
|
|
34
|
+
const parts = token.split(".");
|
|
35
|
+
if (parts.length !== 3) return null;
|
|
36
|
+
let head;
|
|
37
|
+
let payload;
|
|
38
|
+
try {
|
|
39
|
+
head = decodeJwtPart(parts[0]);
|
|
40
|
+
payload = decodeJwtPart(parts[1]);
|
|
41
|
+
} catch {
|
|
42
|
+
return null;
|
|
43
|
+
}
|
|
44
|
+
if (head.alg !== "ES256" || typeof payload.exp !== "number" || payload.exp <= nowSeconds) return null;
|
|
45
|
+
const key = await this.keyFor(head.kid);
|
|
46
|
+
if (!key) return null;
|
|
47
|
+
try {
|
|
48
|
+
const ok = await crypto.subtle.verify(
|
|
49
|
+
{ name: "ECDSA", hash: "SHA-256" },
|
|
50
|
+
key,
|
|
51
|
+
b64urlToBytes(parts[2]),
|
|
52
|
+
new TextEncoder().encode(`${parts[0]}.${parts[1]}`)
|
|
53
|
+
);
|
|
54
|
+
return ok ? payload : null;
|
|
55
|
+
} catch {
|
|
56
|
+
return null;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
async keyFor(kid) {
|
|
60
|
+
const stale = Date.now() - this.fetchedAt > this.ttlMs;
|
|
61
|
+
if (stale || kid && !this.keys.has(kid)) await this.refresh();
|
|
62
|
+
if (kid) return this.keys.get(kid) ?? null;
|
|
63
|
+
return this.keys.size === 1 ? [...this.keys.values()][0] : null;
|
|
64
|
+
}
|
|
65
|
+
async refresh() {
|
|
66
|
+
if (!this.inflight) {
|
|
67
|
+
this.inflight = (async () => {
|
|
68
|
+
try {
|
|
69
|
+
const res = await this.fetchImpl(this.jwksUrl, { headers: { Accept: "application/json" } });
|
|
70
|
+
if (!res.ok) return;
|
|
71
|
+
const body = await res.json();
|
|
72
|
+
const next = /* @__PURE__ */ new Map();
|
|
73
|
+
for (const jwk of body.keys ?? []) {
|
|
74
|
+
if (jwk.kty !== "EC" || jwk.crv !== "P-256" || !jwk.kid) continue;
|
|
75
|
+
const { kid, ...material } = jwk;
|
|
76
|
+
next.set(kid, await crypto.subtle.importKey("jwk", { ...material, ext: true }, { name: "ECDSA", namedCurve: "P-256" }, false, ["verify"]));
|
|
77
|
+
}
|
|
78
|
+
if (next.size) {
|
|
79
|
+
this.keys = next;
|
|
80
|
+
this.fetchedAt = Date.now();
|
|
81
|
+
}
|
|
82
|
+
} catch {
|
|
83
|
+
} finally {
|
|
84
|
+
this.inflight = null;
|
|
85
|
+
}
|
|
86
|
+
})();
|
|
87
|
+
}
|
|
88
|
+
await this.inflight;
|
|
89
|
+
}
|
|
90
|
+
};
|
|
91
|
+
|
|
92
|
+
// src/server.ts
|
|
93
|
+
var API_PREFIX = "/api/academy/v1/app-runtime";
|
|
94
|
+
var SELFCHECK_PATH = "/__academy/selfcheck";
|
|
95
|
+
var envOf = (k) => (typeof process !== "undefined" ? process.env?.[k] : void 0) || void 0;
|
|
96
|
+
function headerOf(headers, name) {
|
|
97
|
+
if (typeof headers.get === "function") return headers.get(name);
|
|
98
|
+
const v = headers[name] ?? headers[name.toLowerCase()];
|
|
99
|
+
return Array.isArray(v) ? v[0] ?? null : v ?? null;
|
|
100
|
+
}
|
|
101
|
+
var Academy = class {
|
|
102
|
+
appUuid;
|
|
103
|
+
baseUrl;
|
|
104
|
+
env;
|
|
105
|
+
/** 是否在本機開發模式(不驗章、用假身分、改帶開發金鑰) */
|
|
106
|
+
devMode;
|
|
107
|
+
/** 給前端用的網址 */
|
|
108
|
+
urls;
|
|
109
|
+
jobs;
|
|
110
|
+
appToken;
|
|
111
|
+
devKey;
|
|
112
|
+
devUser;
|
|
113
|
+
fetchImpl;
|
|
114
|
+
verifier;
|
|
115
|
+
constructor(opts = {}) {
|
|
116
|
+
const warn = opts.warn ?? ((m) => console.warn(m));
|
|
117
|
+
this.appUuid = opts.appUuid ?? envOf("ACADEMY_APP_UUID") ?? "";
|
|
118
|
+
this.appToken = opts.appToken ?? envOf("ACADEMY_APP_TOKEN") ?? "";
|
|
119
|
+
this.baseUrl = (opts.baseUrl ?? envOf("ACADEMY_BASE_URL") ?? "https://agentgo.tw").replace(/\/+$/, "");
|
|
120
|
+
const env = opts.env ?? envOf("ACADEMY_ENV");
|
|
121
|
+
this.env = env === "test" || env === "production" ? env : null;
|
|
122
|
+
const wantDev = opts.devMode ?? envOf("ACADEMY_DEV_MODE") === "1";
|
|
123
|
+
if (wantDev && this.env) warn("[academy-sdk] \u5075\u6E2C\u5230 ACADEMY_ENV\uFF0C\u4EE3\u8868\u8DD1\u5728\u5E73\u53F0\u4E0A\uFF1A\u5FFD\u7565 ACADEMY_DEV_MODE\uFF0C\u4E0D\u9032\u5165\u958B\u767C\u6A21\u5F0F");
|
|
124
|
+
this.devMode = wantDev && !this.env;
|
|
125
|
+
this.devKey = opts.devKey ?? envOf("ACADEMY_DEV_KEY") ?? "";
|
|
126
|
+
this.devUser = opts.devUser ?? envOf("ACADEMY_DEV_USER") ?? "dev-user";
|
|
127
|
+
if (this.devMode && !this.devKey) warn("[academy-sdk] \u958B\u767C\u6A21\u5F0F\u6C92\u6709\u8A2D\u5B9A ACADEMY_DEV_KEY\uFF1A\u5E73\u53F0 AI\u3001\u623F\u5E02\u8CC7\u6599\u8207\u5DE5\u4F5C\u6191\u8B49\u6703\u5931\u6557");
|
|
128
|
+
this.fetchImpl = opts.fetch ?? fetch;
|
|
129
|
+
this.verifier = new JwksVerifier(`${this.baseUrl}/.well-known/app-jwks.json`, this.fetchImpl);
|
|
130
|
+
this.urls = {
|
|
131
|
+
subscribe: `${this.baseUrl}/my/subscriptions`,
|
|
132
|
+
upgrade: `${this.baseUrl}/pricing`,
|
|
133
|
+
points: `${this.baseUrl}/my/points`,
|
|
134
|
+
logout: "/__academy/logout"
|
|
135
|
+
};
|
|
136
|
+
this.jobs = {
|
|
137
|
+
open: (binding, o) => this.openJob(binding, o),
|
|
138
|
+
resume: (token) => this.jobHandle(token),
|
|
139
|
+
get: (id) => json(this.appTransport(), "GET", `/jobs/${encodeURIComponent(id)}`),
|
|
140
|
+
close: (id) => json(this.appTransport(), "POST", `/jobs/${encodeURIComponent(id)}/close`)
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
/** 平台注入的設定是否齊全(自檢回報用) */
|
|
144
|
+
get configOk() {
|
|
145
|
+
return !!this.appUuid && !!this.appToken && !!this.baseUrl && !!this.env;
|
|
146
|
+
}
|
|
147
|
+
// ------------------------------------------------------------------ 身分
|
|
148
|
+
/**
|
|
149
|
+
* 從請求標頭取得身分:驗 `X-Academy-Identity`(ES256、`aud` 為本 App、未過期)。
|
|
150
|
+
* 沒有身分或驗不過回 null——公開路徑與尚未啟用的正式環境本來就沒有身分。開發模式回假身分。
|
|
151
|
+
*/
|
|
152
|
+
async fromHeaders(headers) {
|
|
153
|
+
if (this.devMode) return this.devContext();
|
|
154
|
+
const token = headerOf(headers, "x-academy-identity");
|
|
155
|
+
if (!token) return null;
|
|
156
|
+
const c = await this.verifier.verify(token);
|
|
157
|
+
if (!c || c.typ !== void 0 || c.aud !== this.appUuid || typeof c.sub !== "string") return null;
|
|
158
|
+
const ent = c.ent && typeof c.ent === "object" ? c.ent : {};
|
|
159
|
+
return {
|
|
160
|
+
user: { uuid: c.sub, name: typeof c.name === "string" ? c.name : "", email: typeof c.email === "string" ? c.email : "" },
|
|
161
|
+
entitlement: {
|
|
162
|
+
kind: ent.kind ?? "OPEN",
|
|
163
|
+
tier: ent.tier ?? null,
|
|
164
|
+
billing_mode: ent.billing_mode ?? "FREE",
|
|
165
|
+
period_end: ent.period_end ?? null,
|
|
166
|
+
subscription_uuid: ent.subscription_uuid ?? null
|
|
167
|
+
},
|
|
168
|
+
env: c.env === "test" ? "test" : "production",
|
|
169
|
+
identityToken: token,
|
|
170
|
+
dev: false
|
|
171
|
+
};
|
|
172
|
+
}
|
|
173
|
+
/** fetch 標準 Request 版本(Next.js Route Handler、Hono、Workers…) */
|
|
174
|
+
async fromRequest(request) {
|
|
175
|
+
return await this.fromHeaders(request.headers);
|
|
176
|
+
}
|
|
177
|
+
/**
|
|
178
|
+
* Express/Connect middleware:把身分掛到 `req.academy`(沒有為 null),並自動回應 `GET /__academy/selfcheck`(上架自檢)。
|
|
179
|
+
*/
|
|
180
|
+
express() {
|
|
181
|
+
return (req, res, next) => {
|
|
182
|
+
const path = (req.originalUrl ?? req.url ?? "").split("?")[0];
|
|
183
|
+
if (req.method === "GET" && path === SELFCHECK_PATH) {
|
|
184
|
+
void this.selfcheck(new URL(req.originalUrl ?? req.url ?? "", "http://localhost")).then((r) => {
|
|
185
|
+
res.setHeader("Cache-Control", "no-store");
|
|
186
|
+
res.status(r.status).json(r.body);
|
|
187
|
+
});
|
|
188
|
+
return;
|
|
189
|
+
}
|
|
190
|
+
this.fromHeaders(req.headers).then((ctx) => {
|
|
191
|
+
req.academy = ctx;
|
|
192
|
+
next();
|
|
193
|
+
}).catch(() => {
|
|
194
|
+
req.academy = null;
|
|
195
|
+
next();
|
|
196
|
+
});
|
|
197
|
+
};
|
|
198
|
+
}
|
|
199
|
+
/**
|
|
200
|
+
* fetch 標準版本的自檢:路徑是 `/__academy/selfcheck` 時回 Response,否則回 null。
|
|
201
|
+
* Next.js 請放在 `middleware.ts`(`app/` 底下以底線開頭的資料夾不會成為路由)。
|
|
202
|
+
*/
|
|
203
|
+
async handleSelfcheck(request) {
|
|
204
|
+
const url = new URL(request.url);
|
|
205
|
+
if (request.method !== "GET" || url.pathname !== SELFCHECK_PATH) return null;
|
|
206
|
+
const r = await this.selfcheck(url);
|
|
207
|
+
return new Response(JSON.stringify(r.body), { status: r.status, headers: { "content-type": "application/json", "cache-control": "no-store" } });
|
|
208
|
+
}
|
|
209
|
+
/** 上架自檢的回應(api/app-runtime/reserved-paths.md):驗平台簽章的挑戰值後原樣帶回 */
|
|
210
|
+
async selfcheck(url) {
|
|
211
|
+
const challenge = url.searchParams.get("challenge") ?? "";
|
|
212
|
+
const c = challenge ? await this.verifier.verify(challenge) : null;
|
|
213
|
+
if (!c || c.purpose !== "selfcheck" || c.aud !== this.appUuid) {
|
|
214
|
+
return { status: 403, body: { code: "INVALID_CHALLENGE", message: "\u6311\u6230\u503C\u7121\u6548\u6216\u4E0D\u662F\u7D66\u9019\u500B App \u7684", sdk_version: SDK_VERSION } };
|
|
215
|
+
}
|
|
216
|
+
return {
|
|
217
|
+
status: 200,
|
|
218
|
+
body: { sdk_version: SDK_VERSION, contract_version: CONTRACT_VERSION, app_uuid: this.appUuid, env: this.env, config_ok: this.configOk, challenge }
|
|
219
|
+
};
|
|
220
|
+
}
|
|
221
|
+
// ------------------------------------------------------------------ 平台資源
|
|
222
|
+
/** 平台 AI(aihub 相容層):綁定這次請求的身分或工作憑證 */
|
|
223
|
+
ai(binding) {
|
|
224
|
+
return createAiClient(this.transport(binding), "/ai", { speech: true });
|
|
225
|
+
}
|
|
226
|
+
/** 房市資料 */
|
|
227
|
+
od(binding) {
|
|
228
|
+
return createOdClient(this.transport(binding), "/od");
|
|
229
|
+
}
|
|
230
|
+
/** 會員當期點數;測試環境與開發模式另附擁有者的開發額度 */
|
|
231
|
+
async getQuota(binding) {
|
|
232
|
+
return await json(this.transport(binding, { allowJob: false }), "GET", "/quota");
|
|
233
|
+
}
|
|
234
|
+
// ------------------------------------------------------------------ 內部
|
|
235
|
+
devContext() {
|
|
236
|
+
const isEmail = this.devUser.includes("@");
|
|
237
|
+
return {
|
|
238
|
+
user: { uuid: isEmail ? "dev-user" : this.devUser, name: "\u672C\u6A5F\u958B\u767C", email: isEmail ? this.devUser : "dev@localhost" },
|
|
239
|
+
entitlement: { kind: "OWNER_TEST", tier: null, billing_mode: "FREE", period_end: null, subscription_uuid: null },
|
|
240
|
+
env: "test",
|
|
241
|
+
identityToken: null,
|
|
242
|
+
dev: true
|
|
243
|
+
};
|
|
244
|
+
}
|
|
245
|
+
async openJob(binding, o) {
|
|
246
|
+
const r = await json(this.transport(binding, { allowJob: false }), "POST", "/jobs", {
|
|
247
|
+
body: { max_points: o.maxPoints, ttl_seconds: o.ttlSeconds, purpose: o.purpose }
|
|
248
|
+
});
|
|
249
|
+
return this.jobHandle(r.token, r.job_uuid, r.expires_at);
|
|
250
|
+
}
|
|
251
|
+
jobHandle(token, jobUuid, expiresAt) {
|
|
252
|
+
let id = jobUuid;
|
|
253
|
+
let exp = expiresAt;
|
|
254
|
+
if (!id || !exp) {
|
|
255
|
+
try {
|
|
256
|
+
const p = decodeJwtPart(token.split(".")[1] ?? "");
|
|
257
|
+
id = id ?? p.jti;
|
|
258
|
+
exp = exp ?? (p.exp ? new Date(p.exp * 1e3).toISOString() : void 0);
|
|
259
|
+
} catch {
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
if (!id) throw new AcademyError("JOB_EXPIRED", "\u5DE5\u4F5C\u6191\u8B49\u683C\u5F0F\u4E0D\u6B63\u78BA", 0);
|
|
263
|
+
const jobUuid2 = id;
|
|
264
|
+
return {
|
|
265
|
+
kind: "job",
|
|
266
|
+
jobUuid: jobUuid2,
|
|
267
|
+
token,
|
|
268
|
+
expiresAt: exp ?? "",
|
|
269
|
+
status: () => this.jobs.get(jobUuid2),
|
|
270
|
+
close: () => this.jobs.close(jobUuid2)
|
|
271
|
+
};
|
|
272
|
+
}
|
|
273
|
+
/** 只帶 App 身分(App token;開發模式為開發金鑰):查詢與結束工作 */
|
|
274
|
+
appTransport() {
|
|
275
|
+
return this.makeTransport(this.devMode ? { authorization: `Bearer ${this.devKey}` } : { authorization: `Bearer ${this.appToken}` });
|
|
276
|
+
}
|
|
277
|
+
transport(binding, opts = {}) {
|
|
278
|
+
const auth = { authorization: `Bearer ${this.devMode ? this.devKey : this.appToken}` };
|
|
279
|
+
if (binding && binding.kind === "job") {
|
|
280
|
+
if (opts.allowJob === false) return this.failing("IDENTITY_EXPIRED", "\u9019\u500B\u64CD\u4F5C\u9700\u8981\u6703\u54E1\u5728\u5834\u7684\u8EAB\u5206\uFF0C\u4E0D\u80FD\u7528\u5DE5\u4F5C\u6191\u8B49");
|
|
281
|
+
auth["x-academy-job"] = binding.token;
|
|
282
|
+
return this.makeTransport(auth);
|
|
283
|
+
}
|
|
284
|
+
if (this.devMode) return this.makeTransport(auth);
|
|
285
|
+
const ctx = binding && "user" in binding ? binding : binding?.academy ?? null;
|
|
286
|
+
if (!ctx?.identityToken) return this.failing("IDENTITY_EXPIRED", "\u6C92\u6709\u6703\u54E1\u8EAB\u5206\uFF08\u516C\u958B\u8DEF\u5F91\u6216\u5C1A\u672A\u555F\u7528\u7684\u6B63\u5F0F\u74B0\u5883\u4E0D\u80FD\u4F7F\u7528\u5E73\u53F0\u8CC7\u6E90\uFF09");
|
|
287
|
+
auth["x-academy-identity"] = ctx.identityToken;
|
|
288
|
+
return this.makeTransport(auth);
|
|
289
|
+
}
|
|
290
|
+
makeTransport(headers) {
|
|
291
|
+
return {
|
|
292
|
+
send: (method, path, init) => {
|
|
293
|
+
return this.fetchImpl(`${this.baseUrl}${API_PREFIX}${path}${toQuery(init?.query)}`, {
|
|
294
|
+
method,
|
|
295
|
+
headers: { ...headers, "x-academy-sdk": SDK_VERSION, ...init?.body !== void 0 ? { "content-type": "application/json" } : {} },
|
|
296
|
+
body: init?.body !== void 0 ? JSON.stringify(init.body) : void 0
|
|
297
|
+
});
|
|
298
|
+
}
|
|
299
|
+
};
|
|
300
|
+
}
|
|
301
|
+
failing(code, message) {
|
|
302
|
+
return { send: () => Promise.reject(new AcademyError(code, message, 401)) };
|
|
303
|
+
}
|
|
304
|
+
};
|
|
305
|
+
function createAcademy(opts = {}) {
|
|
306
|
+
return new Academy(opts);
|
|
307
|
+
}
|
|
308
|
+
export {
|
|
309
|
+
Academy,
|
|
310
|
+
AcademyError,
|
|
311
|
+
CONTRACT_VERSION,
|
|
312
|
+
SDK_VERSION,
|
|
313
|
+
createAcademy
|
|
314
|
+
};
|