@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.d.cts
ADDED
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
import { A as AcademyAI, a as AcademyOD } from './od-BVdmZf1t.cjs';
|
|
2
|
+
export { O as OdAddressGeocodeQuery, b as OdAddressGeocodeResult, c as OdAddressSuggestQuery, d as OdAddressSuggestResult, e as OdAdminLevel, f as OdAreaSeriesItem, g as OdAreaSeriesQuery, h as OdAreaSeriesResult, i as OdBbox, j as OdBoundaryLookupQuery, k as OdBoundaryLookupResult, l as OdBoundaryProperties, m as OdBriefCoverageResult, n as OdBriefIndicator, o as OdBriefListResult, p as OdBriefResult, q as OdBulletin, r as OdBulletinDetail, s as OdBulletinDetailResult, t as OdBulletinDocumentsQuery, u as OdBulletinDocumentsResult, v as OdBulletinsListQuery, w as OdBulletinsListResult, x as OdCadastreLandInfoResult, y as OdCadastreReversePointResult, z as OdCadastreSection, B as OdCadastreSectionsQuery, C as OdCadastreSectionsResult, D as OdCalendarDay, E as OdCalendarHolidaysResult, F as OdCenter, G as OdChoroplethMetric, H as OdChoroplethResult, I as OdCommunity, J as OdCommunityByAreaQuery, K as OdCommunityByAreaResult, L as OdCommunityDetail, M as OdCommunityDetailResult, N as OdCommunityInBoundsQuery, P as OdCommunityListResult, Q as OdCommunityMatchItem, R as OdCommunityMatchQuery, S as OdCommunityMatchResult, T as OdCommunityNearbyQuery, U as OdCommunityPrice, V as OdCommunitySuggestQuery, W as OdDayType, X as OdFactoriesNearbyQuery, Y as OdFactoriesNearbyResult, Z as OdFactoriesSearchQuery, _ as OdFactoriesSearchResult, $ as OdFactory, a0 as OdFactoryCoverage, a1 as OdFeature, a2 as OdFeatureCollection, a3 as OdGeocodePrecision, a4 as OdGeocodeSource, a5 as OdGeocodeStatus, a6 as OdGeometry, a7 as OdHazardType, a8 as OdHeatDealsQuery, a9 as OdHeatResult, aa as OdHeatTypesQuery, ab as OdIndicatorComparison, ac as OdLicensePenaltiesResult, ad as OdLicensePenalty, ae as OdLocation, af as OdLvrBase, ag as OdLvrDeal, ah as OdLvrDealMoney, ai as OdLvrDealResult, aj as OdLvrMonthlyByRegionQuery, ak as OdLvrMonthlyByRegionResult, al as OdLvrMonthlyTrendQuery, am as OdLvrMonthlyTrendResult, an as OdLvrRentalStatsQuery, ao as OdLvrRentalStatsResult, ap as OdLvrSimilarItem, aq as OdLvrSimilarQuery, ar as OdLvrSimilarResult, as as OdLvrStatsByAreaQuery, at as OdLvrStatsByAreaResult, au as OdLvrSummaryQuery, av as OdLvrSummaryResult, aw as OdLvrTarget, ax as OdLvrTransactionType, ay as OdMarketIndicator, az as OdNewsReportResult, aA as OdNewsTopicsQuery, aB as OdNewsTopicsResult, aC as OdNoticeBase, aD as OdPeriodGetQuery, aE as OdPeriodListQuery, aF as OdPeriodType, aG as OdPeriodViewQuery, aH as OdPoiPointsResult, aI as OdPoiType, aJ as OdPoint, aK as OdPolygon, aL as OdPopulationVillageResult, aM as OdPublicFact, aN as OdPublicSource, aO as OdQuery, aP as OdReportEvent, aQ as OdReportListResult, aR as OdReportQuote, aS as OdResult, aT as OdSchool, aU as OdSchoolLevel, aV as OdSchoolsNearbyBatchResult, aW as OdSchoolsNearbyQuery, aX as OdSchoolsNearbyResult, aY as OdSchoolsSearchQuery, aZ as OdSchoolsSearchResult, a_ as OdSeries, a$ as OdSpatialCompaniesQuery, b0 as OdSpatialCompaniesResult, b1 as OdSpatialLvrSummaryQuery, b2 as OdSpatialLvrSummaryResult, b3 as OdSpatialVillageGeometryResult, b4 as OdSpatialVillagesResult, b5 as OdStatsCpiQuery, b6 as OdStatsCpiResult, b7 as OdStatsMarketQuery, b8 as OdStatsMarketResult, b9 as OdStatsVillagesQuery, ba as OdStatsVillagesResult, bb as OdTileLayer, bc as OdTilesResult, bd as OdUsagePolicy, be as OdVillageStatsItem, bf as OdZoning, bg as OdZoningBatchResult, bh as OdZoningFeatureProperties, bi as OdZoningLayer } from './od-BVdmZf1t.cjs';
|
|
3
|
+
import { m as AppIdentityEnv, b as AcademyContext, f as AcademyJobInfo, M as MemberEntitlement, h as AcademyServiceContext, g as AcademyQuota } from './version-ClrVQNzw.cjs';
|
|
4
|
+
export { a as AcademyClientInfo, c as AcademyEntitlement, d as AcademyError, e as AcademyErrorCode, A as AcademyMe, i as AcademyUser, j as AppClientKind, k as AppEntitlementKind, l as AppEntitlementReason, n as AppJobStatus, C as CONTRACT_VERSION, o as ChatCompletion, p as ChatCompletionChunk, q as ChatCompletionRequest, r as ChatMessage, s as ChatRole, I as ImageGenerateRequest, t as ImageGenerateResponse, u as MembershipTier, S as SDK_VERSION, v as SpeechRequest, w as SpeechResponse } from './version-ClrVQNzw.cjs';
|
|
5
|
+
|
|
6
|
+
interface AcademyOptions {
|
|
7
|
+
/** 預設讀平台注入的 `ACADEMY_APP_UUID` */
|
|
8
|
+
appUuid?: string;
|
|
9
|
+
/** 預設讀平台注入的 `ACADEMY_APP_TOKEN` */
|
|
10
|
+
appToken?: string;
|
|
11
|
+
/** 預設讀 `ACADEMY_BASE_URL`,再沒有用 `https://agentgo.tw` */
|
|
12
|
+
baseUrl?: string;
|
|
13
|
+
/** 預設讀平台注入的 `ACADEMY_ENV`(`test`/`production`) */
|
|
14
|
+
env?: AppIdentityEnv;
|
|
15
|
+
/** 本機開發模式:預設讀 `ACADEMY_DEV_MODE=1`;在平台上(有 `ACADEMY_ENV`)一律忽略 */
|
|
16
|
+
devMode?: boolean;
|
|
17
|
+
/** 開發模式用的個人開發金鑰:預設讀 `ACADEMY_DEV_KEY` */
|
|
18
|
+
devKey?: string;
|
|
19
|
+
/** 開發模式的假身分:預設讀 `ACADEMY_DEV_USER`(會員編號或 email) */
|
|
20
|
+
devUser?: string;
|
|
21
|
+
/** 開發模式下把每個請求都當成來自這個服務(服務代號):預設讀 `ACADEMY_DEV_SERVICE`。單一請求可改帶標頭 `x-academy-dev-service` */
|
|
22
|
+
devService?: string;
|
|
23
|
+
/** 測試用:替換 fetch */
|
|
24
|
+
fetch?: typeof fetch;
|
|
25
|
+
/** 印警告的地方,預設 console.warn */
|
|
26
|
+
warn?: (msg: string) => void;
|
|
27
|
+
}
|
|
28
|
+
/** 工作憑證(spec/16 § 10):可存進資料庫交給背景工作,背景工作以 `academy.jobs.resume(token)` 取回 */
|
|
29
|
+
interface AcademyJobHandle {
|
|
30
|
+
readonly kind: 'job';
|
|
31
|
+
readonly jobUuid: string;
|
|
32
|
+
readonly token: string;
|
|
33
|
+
readonly expiresAt: string;
|
|
34
|
+
/** 查狀態與已用點數 */
|
|
35
|
+
status(): Promise<AcademyJobInfo>;
|
|
36
|
+
/** 結束工作,釋放沒用完的預佔點數(冪等) */
|
|
37
|
+
close(): Promise<AcademyJobInfo>;
|
|
38
|
+
}
|
|
39
|
+
/** `ai()`、`od()`、`getQuota()`、`jobs.open()` 接受:Express 的 req(掛了 `req.academy`)、`AcademyContext`、工作憑證 */
|
|
40
|
+
type AcademyBinding = AcademyContext | AcademyJobHandle | {
|
|
41
|
+
academy?: AcademyContext | null;
|
|
42
|
+
} | null | undefined;
|
|
43
|
+
/** 最小化的 Express 型別(SDK 不依賴 express) */
|
|
44
|
+
interface ReqLike {
|
|
45
|
+
method?: string;
|
|
46
|
+
url?: string;
|
|
47
|
+
originalUrl?: string;
|
|
48
|
+
headers: Record<string, string | string[] | undefined>;
|
|
49
|
+
academy?: AcademyContext | null;
|
|
50
|
+
academyService?: AcademyServiceContext | null;
|
|
51
|
+
}
|
|
52
|
+
interface ResLike {
|
|
53
|
+
status(code: number): ResLike;
|
|
54
|
+
setHeader(name: string, value: string): unknown;
|
|
55
|
+
json(body: unknown): unknown;
|
|
56
|
+
}
|
|
57
|
+
declare class Academy {
|
|
58
|
+
readonly appUuid: string;
|
|
59
|
+
readonly baseUrl: string;
|
|
60
|
+
readonly env: AppIdentityEnv | null;
|
|
61
|
+
/** 是否在本機開發模式(不驗章、用假身分、改帶開發金鑰) */
|
|
62
|
+
readonly devMode: boolean;
|
|
63
|
+
/** 給前端用的網址 */
|
|
64
|
+
readonly urls: {
|
|
65
|
+
subscribe: string;
|
|
66
|
+
upgrade: string;
|
|
67
|
+
points: string;
|
|
68
|
+
logout: string;
|
|
69
|
+
};
|
|
70
|
+
readonly jobs: {
|
|
71
|
+
open(binding: AcademyBinding, opts: {
|
|
72
|
+
maxPoints: number;
|
|
73
|
+
ttlSeconds: number;
|
|
74
|
+
purpose: string;
|
|
75
|
+
}): Promise<AcademyJobHandle>;
|
|
76
|
+
resume(token: string): AcademyJobHandle;
|
|
77
|
+
get(jobUuid: string): Promise<AcademyJobInfo>;
|
|
78
|
+
close(jobUuid: string): Promise<AcademyJobInfo>;
|
|
79
|
+
};
|
|
80
|
+
readonly members: {
|
|
81
|
+
/**
|
|
82
|
+
* 會員權益查詢(spec/16 § 19.4):這位會員現在能不能使用這個工具。
|
|
83
|
+
* 服務憑證的請求帶來會員編號時,讀寫該會員的資料之前先查;背景工作開始前也可用來確認。
|
|
84
|
+
*/
|
|
85
|
+
entitlement(userUuid: string): Promise<MemberEntitlement>;
|
|
86
|
+
};
|
|
87
|
+
private readonly appToken;
|
|
88
|
+
private readonly devKey;
|
|
89
|
+
private readonly devUser;
|
|
90
|
+
private readonly devService;
|
|
91
|
+
private readonly fetchImpl;
|
|
92
|
+
private readonly verifier;
|
|
93
|
+
constructor(opts?: AcademyOptions);
|
|
94
|
+
/** 平台注入的設定是否齊全(自檢回報用) */
|
|
95
|
+
get configOk(): boolean;
|
|
96
|
+
/**
|
|
97
|
+
* 從請求標頭取得會員身分:驗 `X-Academy-Identity`(ES256、`aud` 為本 App、未過期)。
|
|
98
|
+
* 沒有身分或驗不過回 null——公開路徑、尚未啟用的正式環境、服務憑證的請求本來就沒有會員身分。開發模式回假身分。
|
|
99
|
+
*/
|
|
100
|
+
fromHeaders(headers: Headers | Record<string, string | string[] | undefined>): Promise<AcademyContext | null>;
|
|
101
|
+
/**
|
|
102
|
+
* 從請求標頭取得服務身分:驗 `X-Academy-Service`(ES256、`typ` 為 `app_service`、`aud` 為本 App、未過期)。
|
|
103
|
+
* 不是服務憑證的請求回 null。服務身分**不代表任何會員**:要處理會員資料前先用 `members.entitlement()` 確認。
|
|
104
|
+
*/
|
|
105
|
+
serviceFromHeaders(headers: Headers | Record<string, string | string[] | undefined>): Promise<AcademyServiceContext | null>;
|
|
106
|
+
/** fetch 標準 Request 版本的服務身分 */
|
|
107
|
+
serviceFromRequest(request: Request): Promise<AcademyServiceContext | null>;
|
|
108
|
+
/** 開發模式:這個請求要不要當成服務憑證的請求(標頭優先,其次 `ACADEMY_DEV_SERVICE`) */
|
|
109
|
+
private devServiceKey;
|
|
110
|
+
/** fetch 標準 Request 版本(Next.js Route Handler、Hono、Workers…) */
|
|
111
|
+
fromRequest(request: Request): Promise<AcademyContext | null>;
|
|
112
|
+
/**
|
|
113
|
+
* Express/Connect middleware:把會員身分掛到 `req.academy`、服務身分掛到 `req.academyService`(沒有為 null;兩者不會同時有值),
|
|
114
|
+
* 並自動回應 `GET /__academy/selfcheck`(上架自檢)。
|
|
115
|
+
*/
|
|
116
|
+
express(): (req: ReqLike, res: ResLike, next: (err?: unknown) => void) => void;
|
|
117
|
+
/**
|
|
118
|
+
* fetch 標準版本的自檢:路徑是 `/__academy/selfcheck` 時回 Response,否則回 null。
|
|
119
|
+
* Next.js 請放在 `middleware.ts`(`app/` 底下以底線開頭的資料夾不會成為路由)。
|
|
120
|
+
*/
|
|
121
|
+
handleSelfcheck(request: Request): Promise<Response | null>;
|
|
122
|
+
/** 上架自檢的回應(api/app-runtime/reserved-paths.md):驗平台簽章的挑戰值後原樣帶回 */
|
|
123
|
+
selfcheck(url: URL): Promise<{
|
|
124
|
+
status: number;
|
|
125
|
+
body: Record<string, unknown>;
|
|
126
|
+
}>;
|
|
127
|
+
/** 平台 AI(aihub 相容層):綁定這次請求的身分或工作憑證 */
|
|
128
|
+
ai(binding: AcademyBinding): AcademyAI;
|
|
129
|
+
/** 房市資料 */
|
|
130
|
+
od(binding: AcademyBinding): AcademyOD;
|
|
131
|
+
/** 會員當期點數;測試環境與開發模式另附擁有者的開發額度 */
|
|
132
|
+
getQuota(binding: AcademyBinding): Promise<AcademyQuota>;
|
|
133
|
+
private devContext;
|
|
134
|
+
private openJob;
|
|
135
|
+
private jobHandle;
|
|
136
|
+
/** 只帶 App 身分(App token;開發模式為開發金鑰):查詢與結束工作 */
|
|
137
|
+
private appTransport;
|
|
138
|
+
private transport;
|
|
139
|
+
private makeTransport;
|
|
140
|
+
private failing;
|
|
141
|
+
}
|
|
142
|
+
/** 建立 SDK(伺服器端)。預設讀平台注入的 `ACADEMY_*` 環境變數。 */
|
|
143
|
+
declare function createAcademy(opts?: AcademyOptions): Academy;
|
|
144
|
+
|
|
145
|
+
export { Academy, AcademyAI, type AcademyBinding, AcademyContext, type AcademyJobHandle, AcademyJobInfo, AcademyOD, type AcademyOptions, AcademyQuota, AcademyServiceContext, AppIdentityEnv, MemberEntitlement, createAcademy };
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
import { A as AcademyAI, a as AcademyOD } from './od-sGQixHat.js';
|
|
2
|
+
export { O as OdAddressGeocodeQuery, b as OdAddressGeocodeResult, c as OdAddressSuggestQuery, d as OdAddressSuggestResult, e as OdAdminLevel, f as OdAreaSeriesItem, g as OdAreaSeriesQuery, h as OdAreaSeriesResult, i as OdBbox, j as OdBoundaryLookupQuery, k as OdBoundaryLookupResult, l as OdBoundaryProperties, m as OdBriefCoverageResult, n as OdBriefIndicator, o as OdBriefListResult, p as OdBriefResult, q as OdBulletin, r as OdBulletinDetail, s as OdBulletinDetailResult, t as OdBulletinDocumentsQuery, u as OdBulletinDocumentsResult, v as OdBulletinsListQuery, w as OdBulletinsListResult, x as OdCadastreLandInfoResult, y as OdCadastreReversePointResult, z as OdCadastreSection, B as OdCadastreSectionsQuery, C as OdCadastreSectionsResult, D as OdCalendarDay, E as OdCalendarHolidaysResult, F as OdCenter, G as OdChoroplethMetric, H as OdChoroplethResult, I as OdCommunity, J as OdCommunityByAreaQuery, K as OdCommunityByAreaResult, L as OdCommunityDetail, M as OdCommunityDetailResult, N as OdCommunityInBoundsQuery, P as OdCommunityListResult, Q as OdCommunityMatchItem, R as OdCommunityMatchQuery, S as OdCommunityMatchResult, T as OdCommunityNearbyQuery, U as OdCommunityPrice, V as OdCommunitySuggestQuery, W as OdDayType, X as OdFactoriesNearbyQuery, Y as OdFactoriesNearbyResult, Z as OdFactoriesSearchQuery, _ as OdFactoriesSearchResult, $ as OdFactory, a0 as OdFactoryCoverage, a1 as OdFeature, a2 as OdFeatureCollection, a3 as OdGeocodePrecision, a4 as OdGeocodeSource, a5 as OdGeocodeStatus, a6 as OdGeometry, a7 as OdHazardType, a8 as OdHeatDealsQuery, a9 as OdHeatResult, aa as OdHeatTypesQuery, ab as OdIndicatorComparison, ac as OdLicensePenaltiesResult, ad as OdLicensePenalty, ae as OdLocation, af as OdLvrBase, ag as OdLvrDeal, ah as OdLvrDealMoney, ai as OdLvrDealResult, aj as OdLvrMonthlyByRegionQuery, ak as OdLvrMonthlyByRegionResult, al as OdLvrMonthlyTrendQuery, am as OdLvrMonthlyTrendResult, an as OdLvrRentalStatsQuery, ao as OdLvrRentalStatsResult, ap as OdLvrSimilarItem, aq as OdLvrSimilarQuery, ar as OdLvrSimilarResult, as as OdLvrStatsByAreaQuery, at as OdLvrStatsByAreaResult, au as OdLvrSummaryQuery, av as OdLvrSummaryResult, aw as OdLvrTarget, ax as OdLvrTransactionType, ay as OdMarketIndicator, az as OdNewsReportResult, aA as OdNewsTopicsQuery, aB as OdNewsTopicsResult, aC as OdNoticeBase, aD as OdPeriodGetQuery, aE as OdPeriodListQuery, aF as OdPeriodType, aG as OdPeriodViewQuery, aH as OdPoiPointsResult, aI as OdPoiType, aJ as OdPoint, aK as OdPolygon, aL as OdPopulationVillageResult, aM as OdPublicFact, aN as OdPublicSource, aO as OdQuery, aP as OdReportEvent, aQ as OdReportListResult, aR as OdReportQuote, aS as OdResult, aT as OdSchool, aU as OdSchoolLevel, aV as OdSchoolsNearbyBatchResult, aW as OdSchoolsNearbyQuery, aX as OdSchoolsNearbyResult, aY as OdSchoolsSearchQuery, aZ as OdSchoolsSearchResult, a_ as OdSeries, a$ as OdSpatialCompaniesQuery, b0 as OdSpatialCompaniesResult, b1 as OdSpatialLvrSummaryQuery, b2 as OdSpatialLvrSummaryResult, b3 as OdSpatialVillageGeometryResult, b4 as OdSpatialVillagesResult, b5 as OdStatsCpiQuery, b6 as OdStatsCpiResult, b7 as OdStatsMarketQuery, b8 as OdStatsMarketResult, b9 as OdStatsVillagesQuery, ba as OdStatsVillagesResult, bb as OdTileLayer, bc as OdTilesResult, bd as OdUsagePolicy, be as OdVillageStatsItem, bf as OdZoning, bg as OdZoningBatchResult, bh as OdZoningFeatureProperties, bi as OdZoningLayer } from './od-sGQixHat.js';
|
|
3
|
+
import { m as AppIdentityEnv, b as AcademyContext, f as AcademyJobInfo, M as MemberEntitlement, h as AcademyServiceContext, g as AcademyQuota } from './version-ClrVQNzw.js';
|
|
4
|
+
export { a as AcademyClientInfo, c as AcademyEntitlement, d as AcademyError, e as AcademyErrorCode, A as AcademyMe, i as AcademyUser, j as AppClientKind, k as AppEntitlementKind, l as AppEntitlementReason, n as AppJobStatus, C as CONTRACT_VERSION, o as ChatCompletion, p as ChatCompletionChunk, q as ChatCompletionRequest, r as ChatMessage, s as ChatRole, I as ImageGenerateRequest, t as ImageGenerateResponse, u as MembershipTier, S as SDK_VERSION, v as SpeechRequest, w as SpeechResponse } from './version-ClrVQNzw.js';
|
|
5
|
+
|
|
6
|
+
interface AcademyOptions {
|
|
7
|
+
/** 預設讀平台注入的 `ACADEMY_APP_UUID` */
|
|
8
|
+
appUuid?: string;
|
|
9
|
+
/** 預設讀平台注入的 `ACADEMY_APP_TOKEN` */
|
|
10
|
+
appToken?: string;
|
|
11
|
+
/** 預設讀 `ACADEMY_BASE_URL`,再沒有用 `https://agentgo.tw` */
|
|
12
|
+
baseUrl?: string;
|
|
13
|
+
/** 預設讀平台注入的 `ACADEMY_ENV`(`test`/`production`) */
|
|
14
|
+
env?: AppIdentityEnv;
|
|
15
|
+
/** 本機開發模式:預設讀 `ACADEMY_DEV_MODE=1`;在平台上(有 `ACADEMY_ENV`)一律忽略 */
|
|
16
|
+
devMode?: boolean;
|
|
17
|
+
/** 開發模式用的個人開發金鑰:預設讀 `ACADEMY_DEV_KEY` */
|
|
18
|
+
devKey?: string;
|
|
19
|
+
/** 開發模式的假身分:預設讀 `ACADEMY_DEV_USER`(會員編號或 email) */
|
|
20
|
+
devUser?: string;
|
|
21
|
+
/** 開發模式下把每個請求都當成來自這個服務(服務代號):預設讀 `ACADEMY_DEV_SERVICE`。單一請求可改帶標頭 `x-academy-dev-service` */
|
|
22
|
+
devService?: string;
|
|
23
|
+
/** 測試用:替換 fetch */
|
|
24
|
+
fetch?: typeof fetch;
|
|
25
|
+
/** 印警告的地方,預設 console.warn */
|
|
26
|
+
warn?: (msg: string) => void;
|
|
27
|
+
}
|
|
28
|
+
/** 工作憑證(spec/16 § 10):可存進資料庫交給背景工作,背景工作以 `academy.jobs.resume(token)` 取回 */
|
|
29
|
+
interface AcademyJobHandle {
|
|
30
|
+
readonly kind: 'job';
|
|
31
|
+
readonly jobUuid: string;
|
|
32
|
+
readonly token: string;
|
|
33
|
+
readonly expiresAt: string;
|
|
34
|
+
/** 查狀態與已用點數 */
|
|
35
|
+
status(): Promise<AcademyJobInfo>;
|
|
36
|
+
/** 結束工作,釋放沒用完的預佔點數(冪等) */
|
|
37
|
+
close(): Promise<AcademyJobInfo>;
|
|
38
|
+
}
|
|
39
|
+
/** `ai()`、`od()`、`getQuota()`、`jobs.open()` 接受:Express 的 req(掛了 `req.academy`)、`AcademyContext`、工作憑證 */
|
|
40
|
+
type AcademyBinding = AcademyContext | AcademyJobHandle | {
|
|
41
|
+
academy?: AcademyContext | null;
|
|
42
|
+
} | null | undefined;
|
|
43
|
+
/** 最小化的 Express 型別(SDK 不依賴 express) */
|
|
44
|
+
interface ReqLike {
|
|
45
|
+
method?: string;
|
|
46
|
+
url?: string;
|
|
47
|
+
originalUrl?: string;
|
|
48
|
+
headers: Record<string, string | string[] | undefined>;
|
|
49
|
+
academy?: AcademyContext | null;
|
|
50
|
+
academyService?: AcademyServiceContext | null;
|
|
51
|
+
}
|
|
52
|
+
interface ResLike {
|
|
53
|
+
status(code: number): ResLike;
|
|
54
|
+
setHeader(name: string, value: string): unknown;
|
|
55
|
+
json(body: unknown): unknown;
|
|
56
|
+
}
|
|
57
|
+
declare class Academy {
|
|
58
|
+
readonly appUuid: string;
|
|
59
|
+
readonly baseUrl: string;
|
|
60
|
+
readonly env: AppIdentityEnv | null;
|
|
61
|
+
/** 是否在本機開發模式(不驗章、用假身分、改帶開發金鑰) */
|
|
62
|
+
readonly devMode: boolean;
|
|
63
|
+
/** 給前端用的網址 */
|
|
64
|
+
readonly urls: {
|
|
65
|
+
subscribe: string;
|
|
66
|
+
upgrade: string;
|
|
67
|
+
points: string;
|
|
68
|
+
logout: string;
|
|
69
|
+
};
|
|
70
|
+
readonly jobs: {
|
|
71
|
+
open(binding: AcademyBinding, opts: {
|
|
72
|
+
maxPoints: number;
|
|
73
|
+
ttlSeconds: number;
|
|
74
|
+
purpose: string;
|
|
75
|
+
}): Promise<AcademyJobHandle>;
|
|
76
|
+
resume(token: string): AcademyJobHandle;
|
|
77
|
+
get(jobUuid: string): Promise<AcademyJobInfo>;
|
|
78
|
+
close(jobUuid: string): Promise<AcademyJobInfo>;
|
|
79
|
+
};
|
|
80
|
+
readonly members: {
|
|
81
|
+
/**
|
|
82
|
+
* 會員權益查詢(spec/16 § 19.4):這位會員現在能不能使用這個工具。
|
|
83
|
+
* 服務憑證的請求帶來會員編號時,讀寫該會員的資料之前先查;背景工作開始前也可用來確認。
|
|
84
|
+
*/
|
|
85
|
+
entitlement(userUuid: string): Promise<MemberEntitlement>;
|
|
86
|
+
};
|
|
87
|
+
private readonly appToken;
|
|
88
|
+
private readonly devKey;
|
|
89
|
+
private readonly devUser;
|
|
90
|
+
private readonly devService;
|
|
91
|
+
private readonly fetchImpl;
|
|
92
|
+
private readonly verifier;
|
|
93
|
+
constructor(opts?: AcademyOptions);
|
|
94
|
+
/** 平台注入的設定是否齊全(自檢回報用) */
|
|
95
|
+
get configOk(): boolean;
|
|
96
|
+
/**
|
|
97
|
+
* 從請求標頭取得會員身分:驗 `X-Academy-Identity`(ES256、`aud` 為本 App、未過期)。
|
|
98
|
+
* 沒有身分或驗不過回 null——公開路徑、尚未啟用的正式環境、服務憑證的請求本來就沒有會員身分。開發模式回假身分。
|
|
99
|
+
*/
|
|
100
|
+
fromHeaders(headers: Headers | Record<string, string | string[] | undefined>): Promise<AcademyContext | null>;
|
|
101
|
+
/**
|
|
102
|
+
* 從請求標頭取得服務身分:驗 `X-Academy-Service`(ES256、`typ` 為 `app_service`、`aud` 為本 App、未過期)。
|
|
103
|
+
* 不是服務憑證的請求回 null。服務身分**不代表任何會員**:要處理會員資料前先用 `members.entitlement()` 確認。
|
|
104
|
+
*/
|
|
105
|
+
serviceFromHeaders(headers: Headers | Record<string, string | string[] | undefined>): Promise<AcademyServiceContext | null>;
|
|
106
|
+
/** fetch 標準 Request 版本的服務身分 */
|
|
107
|
+
serviceFromRequest(request: Request): Promise<AcademyServiceContext | null>;
|
|
108
|
+
/** 開發模式:這個請求要不要當成服務憑證的請求(標頭優先,其次 `ACADEMY_DEV_SERVICE`) */
|
|
109
|
+
private devServiceKey;
|
|
110
|
+
/** fetch 標準 Request 版本(Next.js Route Handler、Hono、Workers…) */
|
|
111
|
+
fromRequest(request: Request): Promise<AcademyContext | null>;
|
|
112
|
+
/**
|
|
113
|
+
* Express/Connect middleware:把會員身分掛到 `req.academy`、服務身分掛到 `req.academyService`(沒有為 null;兩者不會同時有值),
|
|
114
|
+
* 並自動回應 `GET /__academy/selfcheck`(上架自檢)。
|
|
115
|
+
*/
|
|
116
|
+
express(): (req: ReqLike, res: ResLike, next: (err?: unknown) => void) => void;
|
|
117
|
+
/**
|
|
118
|
+
* fetch 標準版本的自檢:路徑是 `/__academy/selfcheck` 時回 Response,否則回 null。
|
|
119
|
+
* Next.js 請放在 `middleware.ts`(`app/` 底下以底線開頭的資料夾不會成為路由)。
|
|
120
|
+
*/
|
|
121
|
+
handleSelfcheck(request: Request): Promise<Response | null>;
|
|
122
|
+
/** 上架自檢的回應(api/app-runtime/reserved-paths.md):驗平台簽章的挑戰值後原樣帶回 */
|
|
123
|
+
selfcheck(url: URL): Promise<{
|
|
124
|
+
status: number;
|
|
125
|
+
body: Record<string, unknown>;
|
|
126
|
+
}>;
|
|
127
|
+
/** 平台 AI(aihub 相容層):綁定這次請求的身分或工作憑證 */
|
|
128
|
+
ai(binding: AcademyBinding): AcademyAI;
|
|
129
|
+
/** 房市資料 */
|
|
130
|
+
od(binding: AcademyBinding): AcademyOD;
|
|
131
|
+
/** 會員當期點數;測試環境與開發模式另附擁有者的開發額度 */
|
|
132
|
+
getQuota(binding: AcademyBinding): Promise<AcademyQuota>;
|
|
133
|
+
private devContext;
|
|
134
|
+
private openJob;
|
|
135
|
+
private jobHandle;
|
|
136
|
+
/** 只帶 App 身分(App token;開發模式為開發金鑰):查詢與結束工作 */
|
|
137
|
+
private appTransport;
|
|
138
|
+
private transport;
|
|
139
|
+
private makeTransport;
|
|
140
|
+
private failing;
|
|
141
|
+
}
|
|
142
|
+
/** 建立 SDK(伺服器端)。預設讀平台注入的 `ACADEMY_*` 環境變數。 */
|
|
143
|
+
declare function createAcademy(opts?: AcademyOptions): Academy;
|
|
144
|
+
|
|
145
|
+
export { Academy, AcademyAI, type AcademyBinding, AcademyContext, type AcademyJobHandle, AcademyJobInfo, AcademyOD, type AcademyOptions, AcademyQuota, AcademyServiceContext, AppIdentityEnv, MemberEntitlement, createAcademy };
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,364 @@
|
|
|
1
|
+
import {
|
|
2
|
+
createAiClient,
|
|
3
|
+
createOdClient,
|
|
4
|
+
json,
|
|
5
|
+
toQuery
|
|
6
|
+
} from "./chunk-4KBWZDXW.js";
|
|
7
|
+
import {
|
|
8
|
+
AcademyError,
|
|
9
|
+
CONTRACT_VERSION,
|
|
10
|
+
SDK_VERSION
|
|
11
|
+
} from "./chunk-VCZOS6GJ.js";
|
|
12
|
+
|
|
13
|
+
// src/jwt.ts
|
|
14
|
+
var b64urlToBytes = (s) => {
|
|
15
|
+
const pad = s.length % 4 === 2 ? "==" : s.length % 4 === 3 ? "=" : "";
|
|
16
|
+
const bin = atob(s.replace(/-/g, "+").replace(/_/g, "/") + pad);
|
|
17
|
+
const out = new Uint8Array(bin.length);
|
|
18
|
+
for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
|
|
19
|
+
return out;
|
|
20
|
+
};
|
|
21
|
+
var decodeJwtPart = (part) => JSON.parse(new TextDecoder().decode(b64urlToBytes(part)));
|
|
22
|
+
var JwksVerifier = class {
|
|
23
|
+
constructor(jwksUrl, fetchImpl, ttlMs = 5 * 6e4) {
|
|
24
|
+
this.jwksUrl = jwksUrl;
|
|
25
|
+
this.fetchImpl = fetchImpl;
|
|
26
|
+
this.ttlMs = ttlMs;
|
|
27
|
+
}
|
|
28
|
+
jwksUrl;
|
|
29
|
+
fetchImpl;
|
|
30
|
+
ttlMs;
|
|
31
|
+
keys = /* @__PURE__ */ new Map();
|
|
32
|
+
fetchedAt = 0;
|
|
33
|
+
inflight = null;
|
|
34
|
+
/** 驗章與效期;任何一項不符回 null(不拋錯) */
|
|
35
|
+
async verify(token, nowSeconds = Math.floor(Date.now() / 1e3)) {
|
|
36
|
+
const parts = token.split(".");
|
|
37
|
+
if (parts.length !== 3) return null;
|
|
38
|
+
let head;
|
|
39
|
+
let payload;
|
|
40
|
+
try {
|
|
41
|
+
head = decodeJwtPart(parts[0]);
|
|
42
|
+
payload = decodeJwtPart(parts[1]);
|
|
43
|
+
} catch {
|
|
44
|
+
return null;
|
|
45
|
+
}
|
|
46
|
+
if (head.alg !== "ES256" || typeof payload.exp !== "number" || payload.exp <= nowSeconds) return null;
|
|
47
|
+
const key = await this.keyFor(head.kid);
|
|
48
|
+
if (!key) return null;
|
|
49
|
+
try {
|
|
50
|
+
const ok = await crypto.subtle.verify(
|
|
51
|
+
{ name: "ECDSA", hash: "SHA-256" },
|
|
52
|
+
key,
|
|
53
|
+
b64urlToBytes(parts[2]),
|
|
54
|
+
new TextEncoder().encode(`${parts[0]}.${parts[1]}`)
|
|
55
|
+
);
|
|
56
|
+
return ok ? payload : null;
|
|
57
|
+
} catch {
|
|
58
|
+
return null;
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
async keyFor(kid) {
|
|
62
|
+
const stale = Date.now() - this.fetchedAt > this.ttlMs;
|
|
63
|
+
if (stale || kid && !this.keys.has(kid)) await this.refresh();
|
|
64
|
+
if (kid) return this.keys.get(kid) ?? null;
|
|
65
|
+
return this.keys.size === 1 ? [...this.keys.values()][0] : null;
|
|
66
|
+
}
|
|
67
|
+
async refresh() {
|
|
68
|
+
if (!this.inflight) {
|
|
69
|
+
this.inflight = (async () => {
|
|
70
|
+
try {
|
|
71
|
+
const res = await this.fetchImpl(this.jwksUrl, { headers: { Accept: "application/json" } });
|
|
72
|
+
if (!res.ok) return;
|
|
73
|
+
const body = await res.json();
|
|
74
|
+
const next = /* @__PURE__ */ new Map();
|
|
75
|
+
for (const jwk of body.keys ?? []) {
|
|
76
|
+
if (jwk.kty !== "EC" || jwk.crv !== "P-256" || !jwk.kid) continue;
|
|
77
|
+
const { kid, ...material } = jwk;
|
|
78
|
+
next.set(kid, await crypto.subtle.importKey("jwk", { ...material, ext: true }, { name: "ECDSA", namedCurve: "P-256" }, false, ["verify"]));
|
|
79
|
+
}
|
|
80
|
+
if (next.size) {
|
|
81
|
+
this.keys = next;
|
|
82
|
+
this.fetchedAt = Date.now();
|
|
83
|
+
}
|
|
84
|
+
} catch {
|
|
85
|
+
} finally {
|
|
86
|
+
this.inflight = null;
|
|
87
|
+
}
|
|
88
|
+
})();
|
|
89
|
+
}
|
|
90
|
+
await this.inflight;
|
|
91
|
+
}
|
|
92
|
+
};
|
|
93
|
+
|
|
94
|
+
// src/server.ts
|
|
95
|
+
var API_PREFIX = "/api/academy/v1/app-runtime";
|
|
96
|
+
var SELFCHECK_PATH = "/__academy/selfcheck";
|
|
97
|
+
var HEADER_NONE = "-";
|
|
98
|
+
var envOf = (k) => (typeof process !== "undefined" ? process.env?.[k] : void 0) || void 0;
|
|
99
|
+
function headerOf(headers, name) {
|
|
100
|
+
if (typeof headers.get === "function") return headers.get(name);
|
|
101
|
+
const v = headers[name] ?? headers[name.toLowerCase()];
|
|
102
|
+
return Array.isArray(v) ? v[0] ?? null : v ?? null;
|
|
103
|
+
}
|
|
104
|
+
var Academy = class {
|
|
105
|
+
appUuid;
|
|
106
|
+
baseUrl;
|
|
107
|
+
env;
|
|
108
|
+
/** 是否在本機開發模式(不驗章、用假身分、改帶開發金鑰) */
|
|
109
|
+
devMode;
|
|
110
|
+
/** 給前端用的網址 */
|
|
111
|
+
urls;
|
|
112
|
+
jobs;
|
|
113
|
+
members;
|
|
114
|
+
appToken;
|
|
115
|
+
devKey;
|
|
116
|
+
devUser;
|
|
117
|
+
devService;
|
|
118
|
+
fetchImpl;
|
|
119
|
+
verifier;
|
|
120
|
+
constructor(opts = {}) {
|
|
121
|
+
const warn = opts.warn ?? ((m) => console.warn(m));
|
|
122
|
+
this.appUuid = opts.appUuid ?? envOf("ACADEMY_APP_UUID") ?? "";
|
|
123
|
+
this.appToken = opts.appToken ?? envOf("ACADEMY_APP_TOKEN") ?? "";
|
|
124
|
+
this.baseUrl = (opts.baseUrl ?? envOf("ACADEMY_BASE_URL") ?? "https://agentgo.tw").replace(/\/+$/, "");
|
|
125
|
+
const env = opts.env ?? envOf("ACADEMY_ENV");
|
|
126
|
+
this.env = env === "test" || env === "production" ? env : null;
|
|
127
|
+
const wantDev = opts.devMode ?? envOf("ACADEMY_DEV_MODE") === "1";
|
|
128
|
+
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");
|
|
129
|
+
this.devMode = wantDev && !this.env;
|
|
130
|
+
this.devKey = opts.devKey ?? envOf("ACADEMY_DEV_KEY") ?? "";
|
|
131
|
+
this.devUser = opts.devUser ?? envOf("ACADEMY_DEV_USER") ?? "dev-user";
|
|
132
|
+
this.devService = opts.devService ?? envOf("ACADEMY_DEV_SERVICE") ?? "";
|
|
133
|
+
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");
|
|
134
|
+
this.fetchImpl = opts.fetch ?? fetch;
|
|
135
|
+
this.verifier = new JwksVerifier(`${this.baseUrl}/.well-known/app-jwks.json`, this.fetchImpl);
|
|
136
|
+
this.urls = {
|
|
137
|
+
subscribe: `${this.baseUrl}/my/subscriptions`,
|
|
138
|
+
upgrade: `${this.baseUrl}/pricing`,
|
|
139
|
+
points: `${this.baseUrl}/my/points`,
|
|
140
|
+
logout: "/__academy/logout"
|
|
141
|
+
};
|
|
142
|
+
this.jobs = {
|
|
143
|
+
open: (binding, o) => this.openJob(binding, o),
|
|
144
|
+
resume: (token) => this.jobHandle(token),
|
|
145
|
+
get: (id) => json(this.appTransport(), "GET", `/jobs/${encodeURIComponent(id)}`),
|
|
146
|
+
close: (id) => json(this.appTransport(), "POST", `/jobs/${encodeURIComponent(id)}/close`)
|
|
147
|
+
};
|
|
148
|
+
this.members = {
|
|
149
|
+
entitlement: (userUuid) => json(this.appTransport(), "GET", `/members/${encodeURIComponent(userUuid)}/entitlement`, {
|
|
150
|
+
// App token 不分環境:由 SDK 帶入這個程序所在的環境;開發金鑰一律是測試環境
|
|
151
|
+
query: { env: this.devMode ? void 0 : this.env ?? void 0 }
|
|
152
|
+
})
|
|
153
|
+
};
|
|
154
|
+
}
|
|
155
|
+
/** 平台注入的設定是否齊全(自檢回報用) */
|
|
156
|
+
get configOk() {
|
|
157
|
+
return !!this.appUuid && !!this.appToken && !!this.baseUrl && !!this.env;
|
|
158
|
+
}
|
|
159
|
+
// ------------------------------------------------------------------ 身分
|
|
160
|
+
/**
|
|
161
|
+
* 從請求標頭取得會員身分:驗 `X-Academy-Identity`(ES256、`aud` 為本 App、未過期)。
|
|
162
|
+
* 沒有身分或驗不過回 null——公開路徑、尚未啟用的正式環境、服務憑證的請求本來就沒有會員身分。開發模式回假身分。
|
|
163
|
+
*/
|
|
164
|
+
async fromHeaders(headers) {
|
|
165
|
+
if (this.devMode) return this.devServiceKey(headers) ? null : this.devContext();
|
|
166
|
+
const token = headerOf(headers, "x-academy-identity");
|
|
167
|
+
if (!token || token === HEADER_NONE) return null;
|
|
168
|
+
const c = await this.verifier.verify(token);
|
|
169
|
+
if (!c || c.typ !== void 0 || c.aud !== this.appUuid || typeof c.sub !== "string") return null;
|
|
170
|
+
const ent = c.ent && typeof c.ent === "object" ? c.ent : {};
|
|
171
|
+
const rawClient = c.client && typeof c.client === "object" ? c.client : null;
|
|
172
|
+
const client = rawClient && typeof rawClient.key === "string" ? { key: rawClient.key, kind: rawClient.kind ?? "BROWSER_EXTENSION", grant: typeof rawClient.grant === "string" ? rawClient.grant : "" } : null;
|
|
173
|
+
return {
|
|
174
|
+
user: { uuid: c.sub, name: typeof c.name === "string" ? c.name : "", email: typeof c.email === "string" ? c.email : "" },
|
|
175
|
+
entitlement: {
|
|
176
|
+
kind: ent.kind ?? "OPEN",
|
|
177
|
+
tier: ent.tier ?? null,
|
|
178
|
+
billing_mode: ent.billing_mode ?? "FREE",
|
|
179
|
+
period_end: ent.period_end ?? null,
|
|
180
|
+
subscription_uuid: ent.subscription_uuid ?? null
|
|
181
|
+
},
|
|
182
|
+
env: c.env === "test" ? "test" : "production",
|
|
183
|
+
client,
|
|
184
|
+
identityToken: token,
|
|
185
|
+
dev: false
|
|
186
|
+
};
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* 從請求標頭取得服務身分:驗 `X-Academy-Service`(ES256、`typ` 為 `app_service`、`aud` 為本 App、未過期)。
|
|
190
|
+
* 不是服務憑證的請求回 null。服務身分**不代表任何會員**:要處理會員資料前先用 `members.entitlement()` 確認。
|
|
191
|
+
*/
|
|
192
|
+
async serviceFromHeaders(headers) {
|
|
193
|
+
if (this.devMode) {
|
|
194
|
+
const key = this.devServiceKey(headers);
|
|
195
|
+
return key ? { key, name: key, tokenId: "dev", env: "test", dev: true } : null;
|
|
196
|
+
}
|
|
197
|
+
const token = headerOf(headers, "x-academy-service");
|
|
198
|
+
if (!token || token === HEADER_NONE) return null;
|
|
199
|
+
const c = await this.verifier.verify(token);
|
|
200
|
+
if (!c || c.typ !== "app_service" || c.aud !== this.appUuid || typeof c.svc !== "string") return null;
|
|
201
|
+
return {
|
|
202
|
+
key: c.svc,
|
|
203
|
+
name: typeof c.name === "string" ? c.name : c.svc,
|
|
204
|
+
tokenId: typeof c.tid === "string" ? c.tid : "",
|
|
205
|
+
env: c.env === "test" ? "test" : "production",
|
|
206
|
+
dev: false
|
|
207
|
+
};
|
|
208
|
+
}
|
|
209
|
+
/** fetch 標準 Request 版本的服務身分 */
|
|
210
|
+
async serviceFromRequest(request) {
|
|
211
|
+
return await this.serviceFromHeaders(request.headers);
|
|
212
|
+
}
|
|
213
|
+
/** 開發模式:這個請求要不要當成服務憑證的請求(標頭優先,其次 `ACADEMY_DEV_SERVICE`) */
|
|
214
|
+
devServiceKey(headers) {
|
|
215
|
+
return (headerOf(headers, "x-academy-dev-service") ?? "").trim() || this.devService;
|
|
216
|
+
}
|
|
217
|
+
/** fetch 標準 Request 版本(Next.js Route Handler、Hono、Workers…) */
|
|
218
|
+
async fromRequest(request) {
|
|
219
|
+
return await this.fromHeaders(request.headers);
|
|
220
|
+
}
|
|
221
|
+
/**
|
|
222
|
+
* Express/Connect middleware:把會員身分掛到 `req.academy`、服務身分掛到 `req.academyService`(沒有為 null;兩者不會同時有值),
|
|
223
|
+
* 並自動回應 `GET /__academy/selfcheck`(上架自檢)。
|
|
224
|
+
*/
|
|
225
|
+
express() {
|
|
226
|
+
return (req, res, next) => {
|
|
227
|
+
const path = (req.originalUrl ?? req.url ?? "").split("?")[0];
|
|
228
|
+
if (req.method === "GET" && path === SELFCHECK_PATH) {
|
|
229
|
+
void this.selfcheck(new URL(req.originalUrl ?? req.url ?? "", "http://localhost")).then((r) => {
|
|
230
|
+
res.setHeader("Cache-Control", "no-store");
|
|
231
|
+
res.status(r.status).json(r.body);
|
|
232
|
+
});
|
|
233
|
+
return;
|
|
234
|
+
}
|
|
235
|
+
Promise.all([this.fromHeaders(req.headers), this.serviceFromHeaders(req.headers)]).then(([ctx, service]) => {
|
|
236
|
+
req.academy = ctx;
|
|
237
|
+
req.academyService = ctx ? null : service;
|
|
238
|
+
next();
|
|
239
|
+
}).catch(() => {
|
|
240
|
+
req.academy = null;
|
|
241
|
+
req.academyService = null;
|
|
242
|
+
next();
|
|
243
|
+
});
|
|
244
|
+
};
|
|
245
|
+
}
|
|
246
|
+
/**
|
|
247
|
+
* fetch 標準版本的自檢:路徑是 `/__academy/selfcheck` 時回 Response,否則回 null。
|
|
248
|
+
* Next.js 請放在 `middleware.ts`(`app/` 底下以底線開頭的資料夾不會成為路由)。
|
|
249
|
+
*/
|
|
250
|
+
async handleSelfcheck(request) {
|
|
251
|
+
const url = new URL(request.url);
|
|
252
|
+
if (request.method !== "GET" || url.pathname !== SELFCHECK_PATH) return null;
|
|
253
|
+
const r = await this.selfcheck(url);
|
|
254
|
+
return new Response(JSON.stringify(r.body), { status: r.status, headers: { "content-type": "application/json", "cache-control": "no-store" } });
|
|
255
|
+
}
|
|
256
|
+
/** 上架自檢的回應(api/app-runtime/reserved-paths.md):驗平台簽章的挑戰值後原樣帶回 */
|
|
257
|
+
async selfcheck(url) {
|
|
258
|
+
const challenge = url.searchParams.get("challenge") ?? "";
|
|
259
|
+
const c = challenge ? await this.verifier.verify(challenge) : null;
|
|
260
|
+
if (!c || c.purpose !== "selfcheck" || c.aud !== this.appUuid) {
|
|
261
|
+
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 } };
|
|
262
|
+
}
|
|
263
|
+
return {
|
|
264
|
+
status: 200,
|
|
265
|
+
body: { sdk_version: SDK_VERSION, contract_version: CONTRACT_VERSION, app_uuid: this.appUuid, env: this.env, config_ok: this.configOk, challenge }
|
|
266
|
+
};
|
|
267
|
+
}
|
|
268
|
+
// ------------------------------------------------------------------ 平台資源
|
|
269
|
+
/** 平台 AI(aihub 相容層):綁定這次請求的身分或工作憑證 */
|
|
270
|
+
ai(binding) {
|
|
271
|
+
return createAiClient(this.transport(binding), "/ai", { speech: true });
|
|
272
|
+
}
|
|
273
|
+
/** 房市資料 */
|
|
274
|
+
od(binding) {
|
|
275
|
+
return createOdClient(this.transport(binding), "/od");
|
|
276
|
+
}
|
|
277
|
+
/** 會員當期點數;測試環境與開發模式另附擁有者的開發額度 */
|
|
278
|
+
async getQuota(binding) {
|
|
279
|
+
return await json(this.transport(binding, { allowJob: false }), "GET", "/quota");
|
|
280
|
+
}
|
|
281
|
+
// ------------------------------------------------------------------ 內部
|
|
282
|
+
devContext() {
|
|
283
|
+
const isEmail = this.devUser.includes("@");
|
|
284
|
+
return {
|
|
285
|
+
user: { uuid: isEmail ? "dev-user" : this.devUser, name: "\u672C\u6A5F\u958B\u767C", email: isEmail ? this.devUser : "dev@localhost" },
|
|
286
|
+
entitlement: { kind: "OWNER_TEST", tier: null, billing_mode: "FREE", period_end: null, subscription_uuid: null },
|
|
287
|
+
env: "test",
|
|
288
|
+
client: null,
|
|
289
|
+
identityToken: null,
|
|
290
|
+
dev: true
|
|
291
|
+
};
|
|
292
|
+
}
|
|
293
|
+
async openJob(binding, o) {
|
|
294
|
+
const r = await json(this.transport(binding, { allowJob: false }), "POST", "/jobs", {
|
|
295
|
+
body: { max_points: o.maxPoints, ttl_seconds: o.ttlSeconds, purpose: o.purpose }
|
|
296
|
+
});
|
|
297
|
+
return this.jobHandle(r.token, r.job_uuid, r.expires_at);
|
|
298
|
+
}
|
|
299
|
+
jobHandle(token, jobUuid, expiresAt) {
|
|
300
|
+
let id = jobUuid;
|
|
301
|
+
let exp = expiresAt;
|
|
302
|
+
if (!id || !exp) {
|
|
303
|
+
try {
|
|
304
|
+
const p = decodeJwtPart(token.split(".")[1] ?? "");
|
|
305
|
+
id = id ?? p.jti;
|
|
306
|
+
exp = exp ?? (p.exp ? new Date(p.exp * 1e3).toISOString() : void 0);
|
|
307
|
+
} catch {
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
if (!id) throw new AcademyError("JOB_EXPIRED", "\u5DE5\u4F5C\u6191\u8B49\u683C\u5F0F\u4E0D\u6B63\u78BA", 0);
|
|
311
|
+
const jobUuid2 = id;
|
|
312
|
+
return {
|
|
313
|
+
kind: "job",
|
|
314
|
+
jobUuid: jobUuid2,
|
|
315
|
+
token,
|
|
316
|
+
expiresAt: exp ?? "",
|
|
317
|
+
status: () => this.jobs.get(jobUuid2),
|
|
318
|
+
close: () => this.jobs.close(jobUuid2)
|
|
319
|
+
};
|
|
320
|
+
}
|
|
321
|
+
/** 只帶 App 身分(App token;開發模式為開發金鑰):查詢與結束工作 */
|
|
322
|
+
appTransport() {
|
|
323
|
+
return this.makeTransport(this.devMode ? { authorization: `Bearer ${this.devKey}` } : { authorization: `Bearer ${this.appToken}` });
|
|
324
|
+
}
|
|
325
|
+
transport(binding, opts = {}) {
|
|
326
|
+
const auth = { authorization: `Bearer ${this.devMode ? this.devKey : this.appToken}` };
|
|
327
|
+
if (binding && binding.kind === "job") {
|
|
328
|
+
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");
|
|
329
|
+
auth["x-academy-job"] = binding.token;
|
|
330
|
+
return this.makeTransport(auth);
|
|
331
|
+
}
|
|
332
|
+
if (this.devMode) return this.makeTransport(auth);
|
|
333
|
+
const ctx = binding && "user" in binding ? binding : binding?.academy ?? null;
|
|
334
|
+
if (!ctx?.identityToken) {
|
|
335
|
+
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");
|
|
336
|
+
}
|
|
337
|
+
auth["x-academy-identity"] = ctx.identityToken;
|
|
338
|
+
return this.makeTransport(auth);
|
|
339
|
+
}
|
|
340
|
+
makeTransport(headers) {
|
|
341
|
+
return {
|
|
342
|
+
send: (method, path, init) => {
|
|
343
|
+
return this.fetchImpl(`${this.baseUrl}${API_PREFIX}${path}${toQuery(init?.query)}`, {
|
|
344
|
+
method,
|
|
345
|
+
headers: { ...headers, "x-academy-sdk": SDK_VERSION, ...init?.body !== void 0 ? { "content-type": "application/json" } : {} },
|
|
346
|
+
body: init?.body !== void 0 ? JSON.stringify(init.body) : void 0
|
|
347
|
+
});
|
|
348
|
+
}
|
|
349
|
+
};
|
|
350
|
+
}
|
|
351
|
+
failing(code, message) {
|
|
352
|
+
return { send: () => Promise.reject(new AcademyError(code, message, 401)) };
|
|
353
|
+
}
|
|
354
|
+
};
|
|
355
|
+
function createAcademy(opts = {}) {
|
|
356
|
+
return new Academy(opts);
|
|
357
|
+
}
|
|
358
|
+
export {
|
|
359
|
+
Academy,
|
|
360
|
+
AcademyError,
|
|
361
|
+
CONTRACT_VERSION,
|
|
362
|
+
SDK_VERSION,
|
|
363
|
+
createAcademy
|
|
364
|
+
};
|