@agentgo-tw/app-sdk 0.0.0-stage → 2.6.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 +552 -2
- package/dist/browser.cjs +335 -0
- package/dist/browser.d.cts +22 -0
- package/dist/browser.d.ts +22 -0
- package/dist/browser.js +66 -0
- package/dist/chunk-4KBWZDXW.js +208 -0
- package/dist/chunk-VCZOS6GJ.js +61 -0
- package/dist/client.cjs +283 -0
- package/dist/client.d.cts +76 -0
- package/dist/client.d.ts +76 -0
- package/dist/client.js +205 -0
- package/dist/index.cjs +634 -0
- package/dist/index.d.cts +145 -0
- package/dist/index.d.ts +145 -0
- package/dist/index.js +364 -0
- package/dist/od-BVdmZf1t.d.cts +2331 -0
- package/dist/od-sGQixHat.d.ts +2331 -0
- package/dist/version-ClrVQNzw.d.cts +214 -0
- package/dist/version-ClrVQNzw.d.ts +214 -0
- package/package.json +67 -4
package/dist/index.cjs
ADDED
|
@@ -0,0 +1,634 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __export = (target, all) => {
|
|
7
|
+
for (var name in all)
|
|
8
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
9
|
+
};
|
|
10
|
+
var __copyProps = (to, from, except, desc) => {
|
|
11
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
12
|
+
for (let key of __getOwnPropNames(from))
|
|
13
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
14
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
15
|
+
}
|
|
16
|
+
return to;
|
|
17
|
+
};
|
|
18
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
19
|
+
|
|
20
|
+
// src/index.ts
|
|
21
|
+
var src_exports = {};
|
|
22
|
+
__export(src_exports, {
|
|
23
|
+
Academy: () => Academy,
|
|
24
|
+
AcademyError: () => AcademyError,
|
|
25
|
+
CONTRACT_VERSION: () => CONTRACT_VERSION,
|
|
26
|
+
SDK_VERSION: () => SDK_VERSION,
|
|
27
|
+
createAcademy: () => createAcademy
|
|
28
|
+
});
|
|
29
|
+
module.exports = __toCommonJS(src_exports);
|
|
30
|
+
|
|
31
|
+
// src/errors.ts
|
|
32
|
+
var AcademyError = class extends Error {
|
|
33
|
+
code;
|
|
34
|
+
status;
|
|
35
|
+
details;
|
|
36
|
+
constructor(code, message, status = 0, details = {}) {
|
|
37
|
+
super(message);
|
|
38
|
+
this.name = "AcademyError";
|
|
39
|
+
this.code = code;
|
|
40
|
+
this.status = status;
|
|
41
|
+
this.details = details;
|
|
42
|
+
}
|
|
43
|
+
/** `LOGIN_REQUIRED` 的重新登入網址 */
|
|
44
|
+
get loginUrl() {
|
|
45
|
+
return str(this.details.login_url);
|
|
46
|
+
}
|
|
47
|
+
/** `SUBSCRIPTION_REQUIRED` 的訂閱網址 */
|
|
48
|
+
get subscribeUrl() {
|
|
49
|
+
return str(this.details.subscribe_url);
|
|
50
|
+
}
|
|
51
|
+
/** `INSUFFICIENT_POINTS` 的升級網址 */
|
|
52
|
+
get upgradeUrl() {
|
|
53
|
+
return str(this.details.upgrade_url);
|
|
54
|
+
}
|
|
55
|
+
/** 429 類錯誤建議等待的秒數 */
|
|
56
|
+
get retryAfterSeconds() {
|
|
57
|
+
const v = this.details.retry_after_seconds;
|
|
58
|
+
return typeof v === "number" ? v : void 0;
|
|
59
|
+
}
|
|
60
|
+
/** `AI_LIMIT_EXCEEDED`/`DATA_UNAVAILABLE` 的原因 */
|
|
61
|
+
get reason() {
|
|
62
|
+
return str(this.details.reason);
|
|
63
|
+
}
|
|
64
|
+
};
|
|
65
|
+
var str = (v) => typeof v === "string" ? v : void 0;
|
|
66
|
+
async function errorFromResponse(res) {
|
|
67
|
+
let body = {};
|
|
68
|
+
try {
|
|
69
|
+
body = await res.json();
|
|
70
|
+
} catch {
|
|
71
|
+
}
|
|
72
|
+
const { code, message, ...rest } = body;
|
|
73
|
+
const fallback = res.status === 401 ? "IDENTITY_EXPIRED" : res.status === 402 ? "INSUFFICIENT_POINTS" : res.status >= 500 ? "AI_UNAVAILABLE" : "INVALID_REQUEST";
|
|
74
|
+
return new AcademyError(
|
|
75
|
+
typeof code === "string" && code ? code : fallback,
|
|
76
|
+
typeof message === "string" && message ? message : `\u5E73\u53F0\u56DE\u61C9 HTTP ${res.status}`,
|
|
77
|
+
res.status,
|
|
78
|
+
rest
|
|
79
|
+
);
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
// src/sse.ts
|
|
83
|
+
async function* parseSse(body, onError) {
|
|
84
|
+
const reader = body.getReader();
|
|
85
|
+
const decoder = new TextDecoder();
|
|
86
|
+
let buf = "";
|
|
87
|
+
try {
|
|
88
|
+
for (; ; ) {
|
|
89
|
+
const { done, value } = await reader.read();
|
|
90
|
+
if (done) break;
|
|
91
|
+
buf += decoder.decode(value, { stream: true });
|
|
92
|
+
let idx;
|
|
93
|
+
while ((idx = buf.search(/\r?\n\r?\n/)) >= 0) {
|
|
94
|
+
const event = buf.slice(0, idx);
|
|
95
|
+
buf = buf.slice(idx).replace(/^\r?\n\r?\n/, "");
|
|
96
|
+
const data = event.split(/\r?\n/).filter((l) => l.startsWith("data:")).map((l) => l.slice(5).trimStart()).join("\n");
|
|
97
|
+
if (!data) continue;
|
|
98
|
+
if (data === "[DONE]") return;
|
|
99
|
+
let obj;
|
|
100
|
+
try {
|
|
101
|
+
obj = JSON.parse(data);
|
|
102
|
+
} catch {
|
|
103
|
+
continue;
|
|
104
|
+
}
|
|
105
|
+
if (obj.error && typeof obj.error === "object") throw onError(obj.error);
|
|
106
|
+
yield obj;
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
} finally {
|
|
110
|
+
reader.releaseLock();
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
// src/transport.ts
|
|
115
|
+
function toQuery(q) {
|
|
116
|
+
if (!q) return "";
|
|
117
|
+
const sp = new URLSearchParams();
|
|
118
|
+
for (const [k, v] of Object.entries(q)) {
|
|
119
|
+
if (v === void 0 || v === null || v === "") continue;
|
|
120
|
+
sp.set(k, Array.isArray(v) ? v.join(",") : String(v));
|
|
121
|
+
}
|
|
122
|
+
const s = sp.toString();
|
|
123
|
+
return s ? `?${s}` : "";
|
|
124
|
+
}
|
|
125
|
+
async function json(t, method, path, init) {
|
|
126
|
+
const res = await t.send(method, path, init);
|
|
127
|
+
if (res.ok) return await res.json();
|
|
128
|
+
throw await toError(t, res);
|
|
129
|
+
}
|
|
130
|
+
async function toError(t, res) {
|
|
131
|
+
if (t.browser && res.status === 404 && !(res.headers.get("content-type") ?? "").includes("json")) {
|
|
132
|
+
return new AcademyError("IDENTITY_EXPIRED", "\u9019\u500B\u7DB2\u5740\u6C92\u6709\u5E73\u53F0\u4FDD\u7559\u8DEF\u5F91\uFF08\u5C1A\u672A\u555F\u7528\u5165\u53E3\u95DC\u5361\uFF09\uFF0C\u7121\u6CD5\u4F7F\u7528\u5E73\u53F0\u8CC7\u6E90", 404);
|
|
133
|
+
}
|
|
134
|
+
return await errorFromResponse(res);
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
// src/ai.ts
|
|
138
|
+
function createAiClient(t, base, opts) {
|
|
139
|
+
async function create(body) {
|
|
140
|
+
if (!body.stream) return await json(t, "POST", `${base}/chat/completions`, { body });
|
|
141
|
+
const res = await t.send("POST", `${base}/chat/completions`, { body });
|
|
142
|
+
if (!res.ok || !res.body) throw await toError(t, res);
|
|
143
|
+
const stream = res.body;
|
|
144
|
+
return {
|
|
145
|
+
[Symbol.asyncIterator]: () => parseSse(stream, (e) => new AcademyError(typeof e.code === "string" ? e.code : "AI_UNAVAILABLE", typeof e.message === "string" ? e.message : "\u4E32\u6D41\u4E2D\u65B7", 0, e))
|
|
146
|
+
};
|
|
147
|
+
}
|
|
148
|
+
return {
|
|
149
|
+
chat: { completions: { create } },
|
|
150
|
+
images: { generate: (body) => json(t, "POST", `${base}/images/generations`, { body }) },
|
|
151
|
+
audio: {
|
|
152
|
+
speech: {
|
|
153
|
+
create: (body) => {
|
|
154
|
+
if (!opts.speech) return Promise.reject(new AcademyError("INVALID_REQUEST", "\u700F\u89BD\u5668\u7AEF\u4E0D\u63D0\u4F9B\u8A9E\u97F3\uFF0C\u8ACB\u7531 App \u5F8C\u7AEF\u547C\u53EB", 0));
|
|
155
|
+
return json(t, "POST", `${base}/audio/speech`, { body });
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
// src/jwt.ts
|
|
163
|
+
var b64urlToBytes = (s) => {
|
|
164
|
+
const pad = s.length % 4 === 2 ? "==" : s.length % 4 === 3 ? "=" : "";
|
|
165
|
+
const bin = atob(s.replace(/-/g, "+").replace(/_/g, "/") + pad);
|
|
166
|
+
const out = new Uint8Array(bin.length);
|
|
167
|
+
for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
|
|
168
|
+
return out;
|
|
169
|
+
};
|
|
170
|
+
var decodeJwtPart = (part) => JSON.parse(new TextDecoder().decode(b64urlToBytes(part)));
|
|
171
|
+
var JwksVerifier = class {
|
|
172
|
+
constructor(jwksUrl, fetchImpl, ttlMs = 5 * 6e4) {
|
|
173
|
+
this.jwksUrl = jwksUrl;
|
|
174
|
+
this.fetchImpl = fetchImpl;
|
|
175
|
+
this.ttlMs = ttlMs;
|
|
176
|
+
}
|
|
177
|
+
jwksUrl;
|
|
178
|
+
fetchImpl;
|
|
179
|
+
ttlMs;
|
|
180
|
+
keys = /* @__PURE__ */ new Map();
|
|
181
|
+
fetchedAt = 0;
|
|
182
|
+
inflight = null;
|
|
183
|
+
/** 驗章與效期;任何一項不符回 null(不拋錯) */
|
|
184
|
+
async verify(token, nowSeconds = Math.floor(Date.now() / 1e3)) {
|
|
185
|
+
const parts = token.split(".");
|
|
186
|
+
if (parts.length !== 3) return null;
|
|
187
|
+
let head;
|
|
188
|
+
let payload;
|
|
189
|
+
try {
|
|
190
|
+
head = decodeJwtPart(parts[0]);
|
|
191
|
+
payload = decodeJwtPart(parts[1]);
|
|
192
|
+
} catch {
|
|
193
|
+
return null;
|
|
194
|
+
}
|
|
195
|
+
if (head.alg !== "ES256" || typeof payload.exp !== "number" || payload.exp <= nowSeconds) return null;
|
|
196
|
+
const key = await this.keyFor(head.kid);
|
|
197
|
+
if (!key) return null;
|
|
198
|
+
try {
|
|
199
|
+
const ok = await crypto.subtle.verify(
|
|
200
|
+
{ name: "ECDSA", hash: "SHA-256" },
|
|
201
|
+
key,
|
|
202
|
+
b64urlToBytes(parts[2]),
|
|
203
|
+
new TextEncoder().encode(`${parts[0]}.${parts[1]}`)
|
|
204
|
+
);
|
|
205
|
+
return ok ? payload : null;
|
|
206
|
+
} catch {
|
|
207
|
+
return null;
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
async keyFor(kid) {
|
|
211
|
+
const stale = Date.now() - this.fetchedAt > this.ttlMs;
|
|
212
|
+
if (stale || kid && !this.keys.has(kid)) await this.refresh();
|
|
213
|
+
if (kid) return this.keys.get(kid) ?? null;
|
|
214
|
+
return this.keys.size === 1 ? [...this.keys.values()][0] : null;
|
|
215
|
+
}
|
|
216
|
+
async refresh() {
|
|
217
|
+
if (!this.inflight) {
|
|
218
|
+
this.inflight = (async () => {
|
|
219
|
+
try {
|
|
220
|
+
const res = await this.fetchImpl(this.jwksUrl, { headers: { Accept: "application/json" } });
|
|
221
|
+
if (!res.ok) return;
|
|
222
|
+
const body = await res.json();
|
|
223
|
+
const next = /* @__PURE__ */ new Map();
|
|
224
|
+
for (const jwk of body.keys ?? []) {
|
|
225
|
+
if (jwk.kty !== "EC" || jwk.crv !== "P-256" || !jwk.kid) continue;
|
|
226
|
+
const { kid, ...material } = jwk;
|
|
227
|
+
next.set(kid, await crypto.subtle.importKey("jwk", { ...material, ext: true }, { name: "ECDSA", namedCurve: "P-256" }, false, ["verify"]));
|
|
228
|
+
}
|
|
229
|
+
if (next.size) {
|
|
230
|
+
this.keys = next;
|
|
231
|
+
this.fetchedAt = Date.now();
|
|
232
|
+
}
|
|
233
|
+
} catch {
|
|
234
|
+
} finally {
|
|
235
|
+
this.inflight = null;
|
|
236
|
+
}
|
|
237
|
+
})();
|
|
238
|
+
}
|
|
239
|
+
await this.inflight;
|
|
240
|
+
}
|
|
241
|
+
};
|
|
242
|
+
|
|
243
|
+
// src/od.ts
|
|
244
|
+
function createOdClient(t, base) {
|
|
245
|
+
const get = (resource, q) => json(t, "GET", `${base}/${resource.replace(/^\/+/, "")}`, { query: q ?? {} });
|
|
246
|
+
const typed = (resource, q) => get(resource, q);
|
|
247
|
+
return {
|
|
248
|
+
lvr: {
|
|
249
|
+
deals: (q) => get("lvr/deals", q),
|
|
250
|
+
marketContext: (q) => get("lvr/market-context", q),
|
|
251
|
+
deal: (id) => typed("lvr/deal", { id }),
|
|
252
|
+
similar: (q) => typed("lvr/similar", q),
|
|
253
|
+
summary: (q) => typed("lvr/summary", q),
|
|
254
|
+
statsByArea: (q) => typed("lvr/stats/by-area", q ?? {}),
|
|
255
|
+
monthlyTrend: (q) => typed("lvr/stats/monthly-trend", q),
|
|
256
|
+
rentalStats: (q) => typed("lvr/stats/rental", q),
|
|
257
|
+
monthlyByRegion: (q) => typed("lvr/monthly-by-region", q)
|
|
258
|
+
},
|
|
259
|
+
nearby: { deals: (q) => get("nearby/deals", q), amenities: (q) => get("nearby/amenities", q), comparables: (q) => get("nearby/comparables", q) },
|
|
260
|
+
address: { convert: (q) => get("address/convert", q), suggest: (q) => typed("address/suggest", q), geocode: (q) => typed("address/geocode", q) },
|
|
261
|
+
area: { profile: (q) => get("area/profile", q), series: (q) => typed("area/series", q) },
|
|
262
|
+
communities: {
|
|
263
|
+
suggest: (q) => typed("communities/suggest", q),
|
|
264
|
+
match: (q) => typed("communities/match", q),
|
|
265
|
+
nearby: (q) => typed("communities/nearby", q),
|
|
266
|
+
inBounds: (q) => typed("communities/in-bounds", q),
|
|
267
|
+
byArea: (q) => typed("communities/by-area", q),
|
|
268
|
+
get: (id) => typed("communities/detail", { id })
|
|
269
|
+
},
|
|
270
|
+
schools: {
|
|
271
|
+
nearby: (q) => typed("schools/nearby", q),
|
|
272
|
+
search: (q) => typed("schools/search", q),
|
|
273
|
+
// 閘道只有 GET:座標串成「緯度,經度;緯度,經度」一個參數
|
|
274
|
+
nearbyBatch: (points) => typed("schools/nearby-batch", { points: points.map((p) => `${p.lat},${p.lng}`).join(";") })
|
|
275
|
+
},
|
|
276
|
+
population: { village: (q) => typed("population/village", q) },
|
|
277
|
+
stats: {
|
|
278
|
+
villages: (q) => typed("stats/villages", q),
|
|
279
|
+
cpi: (q) => typed("stats/cpi", q ?? {}),
|
|
280
|
+
market: (q) => typed("stats/market", q)
|
|
281
|
+
},
|
|
282
|
+
hazards: (q) => get("hazards", q),
|
|
283
|
+
// 既有的 `marketBriefs(q)` 呼叫不變,另掛 `list` 方法
|
|
284
|
+
marketBriefs: Object.assign((q) => get("market-briefs", q), {
|
|
285
|
+
list: (q) => typed("market-briefs/list", q ?? {})
|
|
286
|
+
}),
|
|
287
|
+
bulletins: {
|
|
288
|
+
list: (q) => typed("bulletins", q ?? {}),
|
|
289
|
+
get: (id) => typed("bulletins/detail", { id }),
|
|
290
|
+
documents: (id, q) => typed("bulletins/documents", { ...q ?? {}, id })
|
|
291
|
+
},
|
|
292
|
+
briefs: {
|
|
293
|
+
latest: (q) => typed("briefs/latest", q ?? {}),
|
|
294
|
+
get: (q) => typed("briefs", q),
|
|
295
|
+
list: (q) => typed("briefs/list", q ?? {}),
|
|
296
|
+
coverage: (q) => typed("briefs/coverage", q ?? {})
|
|
297
|
+
},
|
|
298
|
+
newsReports: {
|
|
299
|
+
latest: (q) => typed("news-reports/latest", q ?? {}),
|
|
300
|
+
get: (q) => typed("news-reports", q),
|
|
301
|
+
list: (q) => typed("news-reports/list", q ?? {}),
|
|
302
|
+
topics: (q) => typed("news-topics", q ?? {})
|
|
303
|
+
},
|
|
304
|
+
tax: { houseRates: (q) => get("tax/house-rates", q) },
|
|
305
|
+
judgments: { search: (q) => get("judgments", q), get: (id) => get("judgments", { id }), meta: () => get("judgments/meta") },
|
|
306
|
+
// 閘道只有 GET:多邊形與座標清單都串成一個參數
|
|
307
|
+
spatial: {
|
|
308
|
+
lvrSummary: (q) => typed("spatial/lvr-summary", { ...q, polygon: polygonParam(q.polygon) }),
|
|
309
|
+
companies: (q) => typed("spatial/companies", { ...q, polygon: polygonParam(q.polygon) }),
|
|
310
|
+
villages: (q) => typed("spatial/villages", { ...q, polygon: polygonParam(q.polygon) }),
|
|
311
|
+
villageGeometry: (q) => typed("spatial/villages/geometry", q),
|
|
312
|
+
boundaries: (q) => typed("spatial/boundaries", q),
|
|
313
|
+
lookup: (q) => typed("spatial/boundaries/lookup", { ...q, ...q.names !== void 0 ? { names: namesParam(q.names) } : {} })
|
|
314
|
+
},
|
|
315
|
+
zoning: {
|
|
316
|
+
batch: (points) => typed("zoning/batch", { points: points.map((p) => `${p.lat},${p.lng}`).join(";") }),
|
|
317
|
+
tiles: () => typed("zoning/tiles-config", {}),
|
|
318
|
+
geojson: (q) => typed("zoning/geojson", q)
|
|
319
|
+
},
|
|
320
|
+
cadastre: {
|
|
321
|
+
sections: (q) => typed("cadastre/sections", q),
|
|
322
|
+
reversePoint: (q) => typed("cadastre/reverse-point", q),
|
|
323
|
+
landInfo: (q) => typed("cadastre/land-info", q),
|
|
324
|
+
locateSources: () => typed("cadastre/locate-sources", {}),
|
|
325
|
+
tiles: () => typed("cadastre/tiles-config", {})
|
|
326
|
+
},
|
|
327
|
+
layers: {
|
|
328
|
+
heat: {
|
|
329
|
+
deals: (q) => typed("layers/heat/deals", q),
|
|
330
|
+
amenities: (q) => typed("layers/heat/amenities", q),
|
|
331
|
+
transport: (q) => typed("layers/heat/transport", q),
|
|
332
|
+
population: (q) => typed("layers/heat/population", q),
|
|
333
|
+
hazards: (q) => typed("layers/heat/hazards", q)
|
|
334
|
+
},
|
|
335
|
+
hazardZones: (q) => typed("layers/hazard-zones", q),
|
|
336
|
+
poi: (q) => typed("layers/poi", q),
|
|
337
|
+
choropleth: (q) => typed("layers/choropleth", q)
|
|
338
|
+
},
|
|
339
|
+
licenses: {
|
|
340
|
+
penalties: (q) => typed("licenses/penalties", q ?? {})
|
|
341
|
+
},
|
|
342
|
+
factories: {
|
|
343
|
+
nearby: (q) => typed("factories/nearby", q),
|
|
344
|
+
search: (q) => typed("factories", q ?? {})
|
|
345
|
+
},
|
|
346
|
+
calendar: { holidays: (q) => typed("holidays", q) },
|
|
347
|
+
get
|
|
348
|
+
};
|
|
349
|
+
}
|
|
350
|
+
function polygonParam(p) {
|
|
351
|
+
if (typeof p === "string") return p;
|
|
352
|
+
return p.map((v) => Array.isArray(v) ? `${v[0]},${v[1]}` : `${v.lat},${v.lng}`).join(";");
|
|
353
|
+
}
|
|
354
|
+
function namesParam(n) {
|
|
355
|
+
if (typeof n === "string") return n;
|
|
356
|
+
return n.map((x) => x.district ? `${x.city}/${x.district}` : x.city).join(";");
|
|
357
|
+
}
|
|
358
|
+
|
|
359
|
+
// src/version.ts
|
|
360
|
+
var SDK_VERSION = "2.6.0";
|
|
361
|
+
var CONTRACT_VERSION = 2;
|
|
362
|
+
|
|
363
|
+
// src/server.ts
|
|
364
|
+
var API_PREFIX = "/api/academy/v1/app-runtime";
|
|
365
|
+
var SELFCHECK_PATH = "/__academy/selfcheck";
|
|
366
|
+
var HEADER_NONE = "-";
|
|
367
|
+
var envOf = (k) => (typeof process !== "undefined" ? process.env?.[k] : void 0) || void 0;
|
|
368
|
+
function headerOf(headers, name) {
|
|
369
|
+
if (typeof headers.get === "function") return headers.get(name);
|
|
370
|
+
const v = headers[name] ?? headers[name.toLowerCase()];
|
|
371
|
+
return Array.isArray(v) ? v[0] ?? null : v ?? null;
|
|
372
|
+
}
|
|
373
|
+
var Academy = class {
|
|
374
|
+
appUuid;
|
|
375
|
+
baseUrl;
|
|
376
|
+
env;
|
|
377
|
+
/** 是否在本機開發模式(不驗章、用假身分、改帶開發金鑰) */
|
|
378
|
+
devMode;
|
|
379
|
+
/** 給前端用的網址 */
|
|
380
|
+
urls;
|
|
381
|
+
jobs;
|
|
382
|
+
members;
|
|
383
|
+
appToken;
|
|
384
|
+
devKey;
|
|
385
|
+
devUser;
|
|
386
|
+
devService;
|
|
387
|
+
fetchImpl;
|
|
388
|
+
verifier;
|
|
389
|
+
constructor(opts = {}) {
|
|
390
|
+
const warn = opts.warn ?? ((m) => console.warn(m));
|
|
391
|
+
this.appUuid = opts.appUuid ?? envOf("ACADEMY_APP_UUID") ?? "";
|
|
392
|
+
this.appToken = opts.appToken ?? envOf("ACADEMY_APP_TOKEN") ?? "";
|
|
393
|
+
this.baseUrl = (opts.baseUrl ?? envOf("ACADEMY_BASE_URL") ?? "https://agentgo.tw").replace(/\/+$/, "");
|
|
394
|
+
const env = opts.env ?? envOf("ACADEMY_ENV");
|
|
395
|
+
this.env = env === "test" || env === "production" ? env : null;
|
|
396
|
+
const wantDev = opts.devMode ?? envOf("ACADEMY_DEV_MODE") === "1";
|
|
397
|
+
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");
|
|
398
|
+
this.devMode = wantDev && !this.env;
|
|
399
|
+
this.devKey = opts.devKey ?? envOf("ACADEMY_DEV_KEY") ?? "";
|
|
400
|
+
this.devUser = opts.devUser ?? envOf("ACADEMY_DEV_USER") ?? "dev-user";
|
|
401
|
+
this.devService = opts.devService ?? envOf("ACADEMY_DEV_SERVICE") ?? "";
|
|
402
|
+
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");
|
|
403
|
+
this.fetchImpl = opts.fetch ?? fetch;
|
|
404
|
+
this.verifier = new JwksVerifier(`${this.baseUrl}/.well-known/app-jwks.json`, this.fetchImpl);
|
|
405
|
+
this.urls = {
|
|
406
|
+
subscribe: `${this.baseUrl}/my/subscriptions`,
|
|
407
|
+
upgrade: `${this.baseUrl}/pricing`,
|
|
408
|
+
points: `${this.baseUrl}/my/points`,
|
|
409
|
+
logout: "/__academy/logout"
|
|
410
|
+
};
|
|
411
|
+
this.jobs = {
|
|
412
|
+
open: (binding, o) => this.openJob(binding, o),
|
|
413
|
+
resume: (token) => this.jobHandle(token),
|
|
414
|
+
get: (id) => json(this.appTransport(), "GET", `/jobs/${encodeURIComponent(id)}`),
|
|
415
|
+
close: (id) => json(this.appTransport(), "POST", `/jobs/${encodeURIComponent(id)}/close`)
|
|
416
|
+
};
|
|
417
|
+
this.members = {
|
|
418
|
+
entitlement: (userUuid) => json(this.appTransport(), "GET", `/members/${encodeURIComponent(userUuid)}/entitlement`, {
|
|
419
|
+
// App token 不分環境:由 SDK 帶入這個程序所在的環境;開發金鑰一律是測試環境
|
|
420
|
+
query: { env: this.devMode ? void 0 : this.env ?? void 0 }
|
|
421
|
+
})
|
|
422
|
+
};
|
|
423
|
+
}
|
|
424
|
+
/** 平台注入的設定是否齊全(自檢回報用) */
|
|
425
|
+
get configOk() {
|
|
426
|
+
return !!this.appUuid && !!this.appToken && !!this.baseUrl && !!this.env;
|
|
427
|
+
}
|
|
428
|
+
// ------------------------------------------------------------------ 身分
|
|
429
|
+
/**
|
|
430
|
+
* 從請求標頭取得會員身分:驗 `X-Academy-Identity`(ES256、`aud` 為本 App、未過期)。
|
|
431
|
+
* 沒有身分或驗不過回 null——公開路徑、尚未啟用的正式環境、服務憑證的請求本來就沒有會員身分。開發模式回假身分。
|
|
432
|
+
*/
|
|
433
|
+
async fromHeaders(headers) {
|
|
434
|
+
if (this.devMode) return this.devServiceKey(headers) ? null : this.devContext();
|
|
435
|
+
const token = headerOf(headers, "x-academy-identity");
|
|
436
|
+
if (!token || token === HEADER_NONE) return null;
|
|
437
|
+
const c = await this.verifier.verify(token);
|
|
438
|
+
if (!c || c.typ !== void 0 || c.aud !== this.appUuid || typeof c.sub !== "string") return null;
|
|
439
|
+
const ent = c.ent && typeof c.ent === "object" ? c.ent : {};
|
|
440
|
+
const rawClient = c.client && typeof c.client === "object" ? c.client : null;
|
|
441
|
+
const client = rawClient && typeof rawClient.key === "string" ? { key: rawClient.key, kind: rawClient.kind ?? "BROWSER_EXTENSION", grant: typeof rawClient.grant === "string" ? rawClient.grant : "" } : null;
|
|
442
|
+
return {
|
|
443
|
+
user: { uuid: c.sub, name: typeof c.name === "string" ? c.name : "", email: typeof c.email === "string" ? c.email : "" },
|
|
444
|
+
entitlement: {
|
|
445
|
+
kind: ent.kind ?? "OPEN",
|
|
446
|
+
tier: ent.tier ?? null,
|
|
447
|
+
billing_mode: ent.billing_mode ?? "FREE",
|
|
448
|
+
period_end: ent.period_end ?? null,
|
|
449
|
+
subscription_uuid: ent.subscription_uuid ?? null
|
|
450
|
+
},
|
|
451
|
+
env: c.env === "test" ? "test" : "production",
|
|
452
|
+
client,
|
|
453
|
+
identityToken: token,
|
|
454
|
+
dev: false
|
|
455
|
+
};
|
|
456
|
+
}
|
|
457
|
+
/**
|
|
458
|
+
* 從請求標頭取得服務身分:驗 `X-Academy-Service`(ES256、`typ` 為 `app_service`、`aud` 為本 App、未過期)。
|
|
459
|
+
* 不是服務憑證的請求回 null。服務身分**不代表任何會員**:要處理會員資料前先用 `members.entitlement()` 確認。
|
|
460
|
+
*/
|
|
461
|
+
async serviceFromHeaders(headers) {
|
|
462
|
+
if (this.devMode) {
|
|
463
|
+
const key = this.devServiceKey(headers);
|
|
464
|
+
return key ? { key, name: key, tokenId: "dev", env: "test", dev: true } : null;
|
|
465
|
+
}
|
|
466
|
+
const token = headerOf(headers, "x-academy-service");
|
|
467
|
+
if (!token || token === HEADER_NONE) return null;
|
|
468
|
+
const c = await this.verifier.verify(token);
|
|
469
|
+
if (!c || c.typ !== "app_service" || c.aud !== this.appUuid || typeof c.svc !== "string") return null;
|
|
470
|
+
return {
|
|
471
|
+
key: c.svc,
|
|
472
|
+
name: typeof c.name === "string" ? c.name : c.svc,
|
|
473
|
+
tokenId: typeof c.tid === "string" ? c.tid : "",
|
|
474
|
+
env: c.env === "test" ? "test" : "production",
|
|
475
|
+
dev: false
|
|
476
|
+
};
|
|
477
|
+
}
|
|
478
|
+
/** fetch 標準 Request 版本的服務身分 */
|
|
479
|
+
async serviceFromRequest(request) {
|
|
480
|
+
return await this.serviceFromHeaders(request.headers);
|
|
481
|
+
}
|
|
482
|
+
/** 開發模式:這個請求要不要當成服務憑證的請求(標頭優先,其次 `ACADEMY_DEV_SERVICE`) */
|
|
483
|
+
devServiceKey(headers) {
|
|
484
|
+
return (headerOf(headers, "x-academy-dev-service") ?? "").trim() || this.devService;
|
|
485
|
+
}
|
|
486
|
+
/** fetch 標準 Request 版本(Next.js Route Handler、Hono、Workers…) */
|
|
487
|
+
async fromRequest(request) {
|
|
488
|
+
return await this.fromHeaders(request.headers);
|
|
489
|
+
}
|
|
490
|
+
/**
|
|
491
|
+
* Express/Connect middleware:把會員身分掛到 `req.academy`、服務身分掛到 `req.academyService`(沒有為 null;兩者不會同時有值),
|
|
492
|
+
* 並自動回應 `GET /__academy/selfcheck`(上架自檢)。
|
|
493
|
+
*/
|
|
494
|
+
express() {
|
|
495
|
+
return (req, res, next) => {
|
|
496
|
+
const path = (req.originalUrl ?? req.url ?? "").split("?")[0];
|
|
497
|
+
if (req.method === "GET" && path === SELFCHECK_PATH) {
|
|
498
|
+
void this.selfcheck(new URL(req.originalUrl ?? req.url ?? "", "http://localhost")).then((r) => {
|
|
499
|
+
res.setHeader("Cache-Control", "no-store");
|
|
500
|
+
res.status(r.status).json(r.body);
|
|
501
|
+
});
|
|
502
|
+
return;
|
|
503
|
+
}
|
|
504
|
+
Promise.all([this.fromHeaders(req.headers), this.serviceFromHeaders(req.headers)]).then(([ctx, service]) => {
|
|
505
|
+
req.academy = ctx;
|
|
506
|
+
req.academyService = ctx ? null : service;
|
|
507
|
+
next();
|
|
508
|
+
}).catch(() => {
|
|
509
|
+
req.academy = null;
|
|
510
|
+
req.academyService = null;
|
|
511
|
+
next();
|
|
512
|
+
});
|
|
513
|
+
};
|
|
514
|
+
}
|
|
515
|
+
/**
|
|
516
|
+
* fetch 標準版本的自檢:路徑是 `/__academy/selfcheck` 時回 Response,否則回 null。
|
|
517
|
+
* Next.js 請放在 `middleware.ts`(`app/` 底下以底線開頭的資料夾不會成為路由)。
|
|
518
|
+
*/
|
|
519
|
+
async handleSelfcheck(request) {
|
|
520
|
+
const url = new URL(request.url);
|
|
521
|
+
if (request.method !== "GET" || url.pathname !== SELFCHECK_PATH) return null;
|
|
522
|
+
const r = await this.selfcheck(url);
|
|
523
|
+
return new Response(JSON.stringify(r.body), { status: r.status, headers: { "content-type": "application/json", "cache-control": "no-store" } });
|
|
524
|
+
}
|
|
525
|
+
/** 上架自檢的回應(api/app-runtime/reserved-paths.md):驗平台簽章的挑戰值後原樣帶回 */
|
|
526
|
+
async selfcheck(url) {
|
|
527
|
+
const challenge = url.searchParams.get("challenge") ?? "";
|
|
528
|
+
const c = challenge ? await this.verifier.verify(challenge) : null;
|
|
529
|
+
if (!c || c.purpose !== "selfcheck" || c.aud !== this.appUuid) {
|
|
530
|
+
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 } };
|
|
531
|
+
}
|
|
532
|
+
return {
|
|
533
|
+
status: 200,
|
|
534
|
+
body: { sdk_version: SDK_VERSION, contract_version: CONTRACT_VERSION, app_uuid: this.appUuid, env: this.env, config_ok: this.configOk, challenge }
|
|
535
|
+
};
|
|
536
|
+
}
|
|
537
|
+
// ------------------------------------------------------------------ 平台資源
|
|
538
|
+
/** 平台 AI(aihub 相容層):綁定這次請求的身分或工作憑證 */
|
|
539
|
+
ai(binding) {
|
|
540
|
+
return createAiClient(this.transport(binding), "/ai", { speech: true });
|
|
541
|
+
}
|
|
542
|
+
/** 房市資料 */
|
|
543
|
+
od(binding) {
|
|
544
|
+
return createOdClient(this.transport(binding), "/od");
|
|
545
|
+
}
|
|
546
|
+
/** 會員當期點數;測試環境與開發模式另附擁有者的開發額度 */
|
|
547
|
+
async getQuota(binding) {
|
|
548
|
+
return await json(this.transport(binding, { allowJob: false }), "GET", "/quota");
|
|
549
|
+
}
|
|
550
|
+
// ------------------------------------------------------------------ 內部
|
|
551
|
+
devContext() {
|
|
552
|
+
const isEmail = this.devUser.includes("@");
|
|
553
|
+
return {
|
|
554
|
+
user: { uuid: isEmail ? "dev-user" : this.devUser, name: "\u672C\u6A5F\u958B\u767C", email: isEmail ? this.devUser : "dev@localhost" },
|
|
555
|
+
entitlement: { kind: "OWNER_TEST", tier: null, billing_mode: "FREE", period_end: null, subscription_uuid: null },
|
|
556
|
+
env: "test",
|
|
557
|
+
client: null,
|
|
558
|
+
identityToken: null,
|
|
559
|
+
dev: true
|
|
560
|
+
};
|
|
561
|
+
}
|
|
562
|
+
async openJob(binding, o) {
|
|
563
|
+
const r = await json(this.transport(binding, { allowJob: false }), "POST", "/jobs", {
|
|
564
|
+
body: { max_points: o.maxPoints, ttl_seconds: o.ttlSeconds, purpose: o.purpose }
|
|
565
|
+
});
|
|
566
|
+
return this.jobHandle(r.token, r.job_uuid, r.expires_at);
|
|
567
|
+
}
|
|
568
|
+
jobHandle(token, jobUuid, expiresAt) {
|
|
569
|
+
let id = jobUuid;
|
|
570
|
+
let exp = expiresAt;
|
|
571
|
+
if (!id || !exp) {
|
|
572
|
+
try {
|
|
573
|
+
const p = decodeJwtPart(token.split(".")[1] ?? "");
|
|
574
|
+
id = id ?? p.jti;
|
|
575
|
+
exp = exp ?? (p.exp ? new Date(p.exp * 1e3).toISOString() : void 0);
|
|
576
|
+
} catch {
|
|
577
|
+
}
|
|
578
|
+
}
|
|
579
|
+
if (!id) throw new AcademyError("JOB_EXPIRED", "\u5DE5\u4F5C\u6191\u8B49\u683C\u5F0F\u4E0D\u6B63\u78BA", 0);
|
|
580
|
+
const jobUuid2 = id;
|
|
581
|
+
return {
|
|
582
|
+
kind: "job",
|
|
583
|
+
jobUuid: jobUuid2,
|
|
584
|
+
token,
|
|
585
|
+
expiresAt: exp ?? "",
|
|
586
|
+
status: () => this.jobs.get(jobUuid2),
|
|
587
|
+
close: () => this.jobs.close(jobUuid2)
|
|
588
|
+
};
|
|
589
|
+
}
|
|
590
|
+
/** 只帶 App 身分(App token;開發模式為開發金鑰):查詢與結束工作 */
|
|
591
|
+
appTransport() {
|
|
592
|
+
return this.makeTransport(this.devMode ? { authorization: `Bearer ${this.devKey}` } : { authorization: `Bearer ${this.appToken}` });
|
|
593
|
+
}
|
|
594
|
+
transport(binding, opts = {}) {
|
|
595
|
+
const auth = { authorization: `Bearer ${this.devMode ? this.devKey : this.appToken}` };
|
|
596
|
+
if (binding && binding.kind === "job") {
|
|
597
|
+
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");
|
|
598
|
+
auth["x-academy-job"] = binding.token;
|
|
599
|
+
return this.makeTransport(auth);
|
|
600
|
+
}
|
|
601
|
+
if (this.devMode) return this.makeTransport(auth);
|
|
602
|
+
const ctx = binding && "user" in binding ? binding : binding?.academy ?? null;
|
|
603
|
+
if (!ctx?.identityToken) {
|
|
604
|
+
return this.failing("IDENTITY_EXPIRED", "\u6C92\u6709\u6703\u54E1\u8EAB\u5206\uFF08\u516C\u958B\u8DEF\u5F91\u3001\u5C1A\u672A\u555F\u7528\u7684\u6B63\u5F0F\u74B0\u5883\u3001\u670D\u52D9\u6191\u8B49\u7684\u8ACB\u6C42\u4E0D\u80FD\u76F4\u63A5\u4F7F\u7528\u5E73\u53F0\u8CC7\u6E90\uFF1B\u80CC\u666F\u5DE5\u4F5C\u8ACB\u7528\u5DE5\u4F5C\u6191\u8B49\uFF09");
|
|
605
|
+
}
|
|
606
|
+
auth["x-academy-identity"] = ctx.identityToken;
|
|
607
|
+
return this.makeTransport(auth);
|
|
608
|
+
}
|
|
609
|
+
makeTransport(headers) {
|
|
610
|
+
return {
|
|
611
|
+
send: (method, path, init) => {
|
|
612
|
+
return this.fetchImpl(`${this.baseUrl}${API_PREFIX}${path}${toQuery(init?.query)}`, {
|
|
613
|
+
method,
|
|
614
|
+
headers: { ...headers, "x-academy-sdk": SDK_VERSION, ...init?.body !== void 0 ? { "content-type": "application/json" } : {} },
|
|
615
|
+
body: init?.body !== void 0 ? JSON.stringify(init.body) : void 0
|
|
616
|
+
});
|
|
617
|
+
}
|
|
618
|
+
};
|
|
619
|
+
}
|
|
620
|
+
failing(code, message) {
|
|
621
|
+
return { send: () => Promise.reject(new AcademyError(code, message, 401)) };
|
|
622
|
+
}
|
|
623
|
+
};
|
|
624
|
+
function createAcademy(opts = {}) {
|
|
625
|
+
return new Academy(opts);
|
|
626
|
+
}
|
|
627
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
628
|
+
0 && (module.exports = {
|
|
629
|
+
Academy,
|
|
630
|
+
AcademyError,
|
|
631
|
+
CONTRACT_VERSION,
|
|
632
|
+
SDK_VERSION,
|
|
633
|
+
createAcademy
|
|
634
|
+
});
|