@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/api/handlers/QuotaHandler.d.ts

@@ -0,0 +1,21 @@
+import type { ApiServer } from '../ApiServer';
+import type { QuotaService } from '../../quota/QuotaService';
+import type { AccountRepository } from '../../identity/drizzle/AccountRepository';
+export interface QuotaHandlerOptions {
+    quotaService: QuotaService;
+    accountRepo: AccountRepository;
+}
+/**
+ * Handler for quota management API
+ *
+ * These endpoints are for internal billing system use.
+ * They require authentication via client credentials.
+ *
+ * GET    /v1/quota/accounts/:accountId - Get account quota
+ * PUT    /v1/quota/accounts/:accountId - Set account quota
+ * DELETE /v1/quota/accounts/:accountId - Clear account quota
+ * GET    /v1/quota/pods/:podId - Get pod quota
+ * PUT    /v1/quota/pods/:podId - Set pod quota
+ * DELETE /v1/quota/pods/:podId - Clear pod quota
+ */
+export declare function registerQuotaRoutes(server: ApiServer, options: QuotaHandlerOptions): void;

package/dist/api/handlers/QuotaHandler.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerQuotaRoutes = registerQuotaRoutes;
+const global_logger_factory_1 = require("global-logger-factory");
+/**
+ * Handler for quota management API
+ *
+ * These endpoints are for internal billing system use.
+ * They require authentication via client credentials.
+ *
+ * GET    /v1/quota/accounts/:accountId - Get account quota
+ * PUT    /v1/quota/accounts/:accountId - Set account quota
+ * DELETE /v1/quota/accounts/:accountId - Clear account quota
+ * GET    /v1/quota/pods/:podId - Get pod quota
+ * PUT    /v1/quota/pods/:podId - Set pod quota
+ * DELETE /v1/quota/pods/:podId - Clear pod quota
+ */
+function registerQuotaRoutes(server, options) {
+    const logger = (0, global_logger_factory_1.getLoggerFor)('QuotaHandler');
+    const { quotaService, accountRepo } = options;
+    // GET /api/quota/accounts/:accountId
+    server.get('/v1/quota/accounts/:accountId', async (request, response, params) => {
+        const accountId = decodeURIComponent(params.accountId);
+        try {
+            const limit = await quotaService.getAccountLimit(accountId);
+            sendJson(response, 200, {
+                type: 'account',
+                accountId,
+                quotaLimit: limit ?? null,
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to get account quota: ${error}`);
+            sendJson(response, 500, { error: 'Failed to get quota' });
+        }
+    });
+    // PUT /api/quota/accounts/:accountId
+    server.put('/v1/quota/accounts/:accountId', async (request, response, params) => {
+        const accountId = decodeURIComponent(params.accountId);
+        const body = await readJsonBody(request);
+        if (!body || typeof body !== 'object') {
+            sendJson(response, 400, { error: 'Request body must be a JSON object' });
+            return;
+        }
+        const payload = body;
+        if (!Object.prototype.hasOwnProperty.call(payload, 'quotaLimit')) {
+            sendJson(response, 400, { error: 'Body must include quotaLimit' });
+            return;
+        }
+        const quota = extractQuota(payload.quotaLimit);
+        if (quota === undefined) {
+            sendJson(response, 400, { error: 'quotaLimit must be a non-negative number or null' });
+            return;
+        }
+        try {
+            await quotaService.setAccountLimit(accountId, quota);
+            const latest = await quotaService.getAccountLimit(accountId);
+            logger.info(`Set account ${accountId} quota to ${quota}`);
+            sendJson(response, 200, {
+                status: 'updated',
+                targetType: 'account',
+                targetId: accountId,
+                quotaLimit: latest ?? null,
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to set account quota: ${error}`);
+            sendJson(response, 500, { error: 'Failed to set quota' });
+        }
+    });
+    // DELETE /api/quota/accounts/:accountId
+    server.delete('/v1/quota/accounts/:accountId', async (request, response, params) => {
+        const accountId = decodeURIComponent(params.accountId);
+        try {
+            await quotaService.setAccountLimit(accountId, null);
+            logger.info(`Cleared account ${accountId} quota`);
+            sendJson(response, 200, {
+                status: 'cleared',
+                targetType: 'account',
+                targetId: accountId,
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to clear account quota: ${error}`);
+            sendJson(response, 500, { error: 'Failed to clear quota' });
+        }
+    });
+    // GET /api/quota/pods/:podId
+    server.get('/v1/quota/pods/:podId', async (request, response, params) => {
+        const podId = decodeURIComponent(params.podId);
+        try {
+            const podInfo = await accountRepo.getPodInfo(podId);
+            if (!podInfo) {
+                sendJson(response, 404, { error: 'Pod not found' });
+                return;
+            }
+            const limit = await quotaService.getPodLimit(podId);
+            sendJson(response, 200, {
+                type: 'pod',
+                podId,
+                accountId: podInfo.accountId,
+                baseUrl: podInfo.baseUrl ?? null,
+                quotaLimit: limit ?? null,
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to get pod quota: ${error}`);
+            sendJson(response, 500, { error: 'Failed to get quota' });
+        }
+    });
+    // PUT /api/quota/pods/:podId
+    server.put('/v1/quota/pods/:podId', async (request, response, params) => {
+        const podId = decodeURIComponent(params.podId);
+        const body = await readJsonBody(request);
+        if (!body || typeof body !== 'object') {
+            sendJson(response, 400, { error: 'Request body must be a JSON object' });
+            return;
+        }
+        const payload = body;
+        if (!Object.prototype.hasOwnProperty.call(payload, 'quotaLimit')) {
+            sendJson(response, 400, { error: 'Body must include quotaLimit' });
+            return;
+        }
+        const quota = extractQuota(payload.quotaLimit);
+        if (quota === undefined) {
+            sendJson(response, 400, { error: 'quotaLimit must be a non-negative number or null' });
+            return;
+        }
+        try {
+            const podInfo = await accountRepo.getPodInfo(podId);
+            if (!podInfo) {
+                sendJson(response, 404, { error: 'Pod not found' });
+                return;
+            }
+            await quotaService.setPodLimit(podId, quota);
+            const latest = await quotaService.getPodLimit(podId);
+            logger.info(`Set pod ${podId} quota to ${quota}`);
+            sendJson(response, 200, {
+                status: 'updated',
+                targetType: 'pod',
+                targetId: podId,
+                quotaLimit: latest ?? null,
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to set pod quota: ${error}`);
+            sendJson(response, 500, { error: 'Failed to set quota' });
+        }
+    });
+    // DELETE /api/quota/pods/:podId
+    server.delete('/v1/quota/pods/:podId', async (request, response, params) => {
+        const podId = decodeURIComponent(params.podId);
+        try {
+            const podInfo = await accountRepo.getPodInfo(podId);
+            if (!podInfo) {
+                sendJson(response, 404, { error: 'Pod not found' });
+                return;
+            }
+            await quotaService.setPodLimit(podId, null);
+            logger.info(`Cleared pod ${podId} quota`);
+            sendJson(response, 200, {
+                status: 'cleared',
+                targetType: 'pod',
+                targetId: podId,
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to clear pod quota: ${error}`);
+            sendJson(response, 500, { error: 'Failed to clear quota' });
+        }
+    });
+}
+function extractQuota(value) {
+    if (value === null) {
+        return null;
+    }
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+        return undefined;
+    }
+    return value;
+}
+async function readJsonBody(request) {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        request.setEncoding('utf8');
+        request.on('data', (chunk) => {
+            data += chunk;
+        });
+        request.on('end', () => {
+            if (!data) {
+                resolve(undefined);
+                return;
+            }
+            try {
+                resolve(JSON.parse(data));
+            }
+            catch {
+                resolve(undefined);
+            }
+        });
+        request.on('error', reject);
+    });
+}
+function sendJson(response, status, data) {
+    response.statusCode = status;
+    response.setHeader('Content-Type', 'application/json');
+    response.end(JSON.stringify(data));
+}
+//# sourceMappingURL=QuotaHandler.js.map

package/dist/api/handlers/QuotaHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuotaHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/QuotaHandler.ts"],"names":[],"mappings":";;AAyBA,kDAiLC;AAzMD,iEAAqD;AAWrD;;;;;;;;;;;;GAYG;AACH,SAAgB,mBAAmB,CAAC,MAAiB,EAAE,OAA4B;IACjF,MAAM,MAAM,GAAG,IAAA,oCAAY,EAAC,cAAc,CAAC,CAAC;IAC5C,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAE9C,qCAAqC;IACrC,MAAM,CAAC,GAAG,CAAC,+BAA+B,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAC9E,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEvD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAC5D,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,IAAI,EAAE,SAAS;gBACf,SAAS;gBACT,UAAU,EAAE,KAAK,IAAI,IAAI;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;YACtD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,qCAAqC;IACrC,MAAM,CAAC,GAAG,CAAC,+BAA+B,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAC9E,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAA+B,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;YACjE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,kDAAkD,EAAE,CAAC,CAAC;YACvF,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAE7D,MAAM,CAAC,IAAI,CAAC,eAAe,SAAS,aAAa,KAAK,EAAE,CAAC,CAAC;YAE1D,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,MAAM,EAAE,SAAS;gBACjB,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,SAAS;gBACnB,UAAU,EAAE,MAAM,IAAI,IAAI;aAC3B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;YACtD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,wCAAwC;IACxC,MAAM,CAAC,MAAM,CAAC,+BAA+B,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACjF,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEvD,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAEpD,MAAM,CAAC,IAAI,CAAC,mBAAmB,SAAS,QAAQ,CAAC,CAAC;YAElD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,MAAM,EAAE,SAAS;gBACjB,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,KAAK,EAAE,CAAC,CAAC;YACxD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,CAAC,GAAG,CAAC,uBAAuB,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACtE,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE/C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACpD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,IAAI,EAAE,KAAK;gBACX,KAAK;gBACL,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;gBAChC,UAAU,EAAE,KAAK,IAAI,IAAI;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;YAClD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,CAAC,GAAG,CAAC,uBAAuB,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACtE,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAA+B,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;YACjE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,kDAAkD,EAAE,CAAC,CAAC;YACvF,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,MAAM,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAErD,MAAM,CAAC,IAAI,CAAC,WAAW,KAAK,aAAa,KAAK,EAAE,CAAC,CAAC;YAElD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,MAAM,EAAE,SAAS;gBACjB,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,KAAK;gBACf,UAAU,EAAE,MAAM,IAAI,IAAI;aAC3B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;YAClD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,gCAAgC;IAChC,MAAM,CAAC,MAAM,CAAC,uBAAuB,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACzE,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE/C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,MAAM,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAE5C,MAAM,CAAC,IAAI,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC;YAE1C,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,MAAM,EAAE,SAAS;gBACjB,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,KAAK,EAAE,CAAC,CAAC;YACpD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,OAA6B;IACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACnC,IAAI,IAAI,KAAK,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACrB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,SAAS,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,QAAwB,EAAE,MAAc,EAAE,IAAa;IACvE,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IACvD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACrC,CAAC","sourcesContent":["import type { ServerResponse } from 'node:http';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { AuthenticatedRequest } from '../middleware/AuthMiddleware';\nimport type { ApiServer } from '../ApiServer';\nimport type { QuotaService } from '../../quota/QuotaService';\nimport type { AccountRepository } from '../../identity/drizzle/AccountRepository';\n\nexport interface QuotaHandlerOptions {\n  quotaService: QuotaService;\n  accountRepo: AccountRepository;\n}\n\n/**\n * Handler for quota management API\n * \n * These endpoints are for internal billing system use.\n * They require authentication via client credentials.\n * \n * GET    /v1/quota/accounts/:accountId - Get account quota\n * PUT    /v1/quota/accounts/:accountId - Set account quota\n * DELETE /v1/quota/accounts/:accountId - Clear account quota\n * GET    /v1/quota/pods/:podId - Get pod quota\n * PUT    /v1/quota/pods/:podId - Set pod quota\n * DELETE /v1/quota/pods/:podId - Clear pod quota\n */\nexport function registerQuotaRoutes(server: ApiServer, options: QuotaHandlerOptions): void {\n  const logger = getLoggerFor('QuotaHandler');\n  const { quotaService, accountRepo } = options;\n\n  // GET /api/quota/accounts/:accountId\n  server.get('/v1/quota/accounts/:accountId', async (request, response, params) => {\n    const accountId = decodeURIComponent(params.accountId);\n\n    try {\n      const limit = await quotaService.getAccountLimit(accountId);\n      sendJson(response, 200, {\n        type: 'account',\n        accountId,\n        quotaLimit: limit ?? null,\n      });\n    } catch (error) {\n      logger.error(`Failed to get account quota: ${error}`);\n      sendJson(response, 500, { error: 'Failed to get quota' });\n    }\n  });\n\n  // PUT /api/quota/accounts/:accountId\n  server.put('/v1/quota/accounts/:accountId', async (request, response, params) => {\n    const accountId = decodeURIComponent(params.accountId);\n    const body = await readJsonBody(request);\n\n    if (!body || typeof body !== 'object') {\n      sendJson(response, 400, { error: 'Request body must be a JSON object' });\n      return;\n    }\n\n    const payload = body as Record<string, unknown>;\n    if (!Object.prototype.hasOwnProperty.call(payload, 'quotaLimit')) {\n      sendJson(response, 400, { error: 'Body must include quotaLimit' });\n      return;\n    }\n\n    const quota = extractQuota(payload.quotaLimit);\n    if (quota === undefined) {\n      sendJson(response, 400, { error: 'quotaLimit must be a non-negative number or null' });\n      return;\n    }\n\n    try {\n      await quotaService.setAccountLimit(accountId, quota);\n      const latest = await quotaService.getAccountLimit(accountId);\n      \n      logger.info(`Set account ${accountId} quota to ${quota}`);\n      \n      sendJson(response, 200, {\n        status: 'updated',\n        targetType: 'account',\n        targetId: accountId,\n        quotaLimit: latest ?? null,\n      });\n    } catch (error) {\n      logger.error(`Failed to set account quota: ${error}`);\n      sendJson(response, 500, { error: 'Failed to set quota' });\n    }\n  });\n\n  // DELETE /api/quota/accounts/:accountId\n  server.delete('/v1/quota/accounts/:accountId', async (request, response, params) => {\n    const accountId = decodeURIComponent(params.accountId);\n\n    try {\n      await quotaService.setAccountLimit(accountId, null);\n      \n      logger.info(`Cleared account ${accountId} quota`);\n      \n      sendJson(response, 200, {\n        status: 'cleared',\n        targetType: 'account',\n        targetId: accountId,\n      });\n    } catch (error) {\n      logger.error(`Failed to clear account quota: ${error}`);\n      sendJson(response, 500, { error: 'Failed to clear quota' });\n    }\n  });\n\n  // GET /api/quota/pods/:podId\n  server.get('/v1/quota/pods/:podId', async (request, response, params) => {\n    const podId = decodeURIComponent(params.podId);\n\n    try {\n      const podInfo = await accountRepo.getPodInfo(podId);\n      if (!podInfo) {\n        sendJson(response, 404, { error: 'Pod not found' });\n        return;\n      }\n\n      const limit = await quotaService.getPodLimit(podId);\n      sendJson(response, 200, {\n        type: 'pod',\n        podId,\n        accountId: podInfo.accountId,\n        baseUrl: podInfo.baseUrl ?? null,\n        quotaLimit: limit ?? null,\n      });\n    } catch (error) {\n      logger.error(`Failed to get pod quota: ${error}`);\n      sendJson(response, 500, { error: 'Failed to get quota' });\n    }\n  });\n\n  // PUT /api/quota/pods/:podId\n  server.put('/v1/quota/pods/:podId', async (request, response, params) => {\n    const podId = decodeURIComponent(params.podId);\n    const body = await readJsonBody(request);\n\n    if (!body || typeof body !== 'object') {\n      sendJson(response, 400, { error: 'Request body must be a JSON object' });\n      return;\n    }\n\n    const payload = body as Record<string, unknown>;\n    if (!Object.prototype.hasOwnProperty.call(payload, 'quotaLimit')) {\n      sendJson(response, 400, { error: 'Body must include quotaLimit' });\n      return;\n    }\n\n    const quota = extractQuota(payload.quotaLimit);\n    if (quota === undefined) {\n      sendJson(response, 400, { error: 'quotaLimit must be a non-negative number or null' });\n      return;\n    }\n\n    try {\n      const podInfo = await accountRepo.getPodInfo(podId);\n      if (!podInfo) {\n        sendJson(response, 404, { error: 'Pod not found' });\n        return;\n      }\n\n      await quotaService.setPodLimit(podId, quota);\n      const latest = await quotaService.getPodLimit(podId);\n      \n      logger.info(`Set pod ${podId} quota to ${quota}`);\n      \n      sendJson(response, 200, {\n        status: 'updated',\n        targetType: 'pod',\n        targetId: podId,\n        quotaLimit: latest ?? null,\n      });\n    } catch (error) {\n      logger.error(`Failed to set pod quota: ${error}`);\n      sendJson(response, 500, { error: 'Failed to set quota' });\n    }\n  });\n\n  // DELETE /api/quota/pods/:podId\n  server.delete('/v1/quota/pods/:podId', async (request, response, params) => {\n    const podId = decodeURIComponent(params.podId);\n\n    try {\n      const podInfo = await accountRepo.getPodInfo(podId);\n      if (!podInfo) {\n        sendJson(response, 404, { error: 'Pod not found' });\n        return;\n      }\n\n      await quotaService.setPodLimit(podId, null);\n      \n      logger.info(`Cleared pod ${podId} quota`);\n      \n      sendJson(response, 200, {\n        status: 'cleared',\n        targetType: 'pod',\n        targetId: podId,\n      });\n    } catch (error) {\n      logger.error(`Failed to clear pod quota: ${error}`);\n      sendJson(response, 500, { error: 'Failed to clear quota' });\n    }\n  });\n}\n\nfunction extractQuota(value: unknown): number | null | undefined {\n  if (value === null) {\n    return null;\n  }\n  if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {\n    return undefined;\n  }\n  return value;\n}\n\nasync function readJsonBody(request: AuthenticatedRequest): Promise<unknown> {\n  return new Promise((resolve, reject) => {\n    let data = '';\n    request.setEncoding('utf8');\n    request.on('data', (chunk: string) => {\n      data += chunk;\n    });\n    request.on('end', () => {\n      if (!data) {\n        resolve(undefined);\n        return;\n      }\n      try {\n        resolve(JSON.parse(data));\n      } catch {\n        resolve(undefined);\n      }\n    });\n    request.on('error', reject);\n  });\n}\n\nfunction sendJson(response: ServerResponse, status: number, data: unknown): void {\n  response.statusCode = status;\n  response.setHeader('Content-Type', 'application/json');\n  response.end(JSON.stringify(data));\n}\n"]}

package/dist/api/handlers/SignalHandler.d.ts

@@ -0,0 +1,13 @@
+import type { ApiServer } from '../ApiServer';
+import type { EdgeNodeRepository } from '../../identity/drizzle/EdgeNodeRepository';
+export interface SignalHandlerOptions {
+    repository: EdgeNodeRepository;
+}
+/**
+ * Handler for edge node signaling API
+ *
+ * POST /v1/signal - Edge node heartbeat/signal
+ *
+ * Requires API authentication and a nodeId in the request body.
+ */
+export declare function registerSignalRoutes(server: ApiServer, options: SignalHandlerOptions): void;

package/dist/api/handlers/SignalHandler.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSignalRoutes = registerSignalRoutes;
+const global_logger_factory_1 = require("global-logger-factory");
+const AuthContext_1 = require("../auth/AuthContext");
+/**
+ * Handler for edge node signaling API
+ *
+ * POST /v1/signal - Edge node heartbeat/signal
+ *
+ * Requires API authentication and a nodeId in the request body.
+ */
+function registerSignalRoutes(server, options) {
+    const logger = (0, global_logger_factory_1.getLoggerFor)('SignalHandler');
+    const repo = options.repository;
+    // POST /v1/signal - authenticated via API key or Solid token
+    server.post('/v1/signal', async (request, response, _params) => {
+        const auth = request.auth;
+        const webId = auth ? (0, AuthContext_1.getWebId)(auth) : undefined;
+        if (!webId) {
+            sendJson(response, 400, { error: 'Cannot determine user' });
+            return;
+        }
+        const body = await readJsonBody(request);
+        if (!body || typeof body !== 'object') {
+            sendJson(response, 400, { error: 'Request body must be a JSON object' });
+            return;
+        }
+        const payload = body;
+        const nodeId = typeof payload.nodeId === 'string' ? payload.nodeId.trim() : '';
+        if (!nodeId) {
+            sendJson(response, 400, { error: 'nodeId is required' });
+            return;
+        }
+        try {
+            const owner = await repo.getNodeOwner(nodeId);
+            if (!owner) {
+                sendJson(response, 404, { error: 'Node not found' });
+                return;
+            }
+            if (owner !== webId) {
+                sendJson(response, 403, { error: 'Access denied' });
+                return;
+            }
+        }
+        catch (error) {
+            logger.error(`Failed to validate node access: ${error}`);
+            sendJson(response, 500, { error: 'Failed to validate node access' });
+            return;
+        }
+        const now = new Date();
+        try {
+            // Get current metadata to merge
+            const existing = await repo.getNodeMetadata(nodeId);
+            const metadata = mergeMetadata(existing?.metadata ?? {}, payload, now);
+            // Update heartbeat
+            await repo.updateNodeHeartbeat(nodeId, metadata, now);
+            // Update pods if provided
+            if (Array.isArray(payload.pods)) {
+                await repo.replaceNodePods(nodeId, payload.pods);
+            }
+            logger.debug(`Signal received from node ${nodeId}`);
+            sendJson(response, 200, {
+                status: 'ok',
+                nodeId,
+                lastSeen: now.toISOString(),
+                metadata,
+            });
+        }
+        catch (error) {
+            logger.error(`Signal handling error for node ${nodeId}: ${error}`);
+            sendJson(response, 500, { error: 'Failed to process signal' });
+        }
+    });
+}
+function mergeMetadata(previous, payload, now) {
+    const next = { ...previous };
+    next.lastHeartbeatAt = now.toISOString();
+    const copyIfPresent = (key) => {
+        if (payload[key] !== undefined) {
+            next[key] = payload[key];
+        }
+    };
+    copyIfPresent('baseUrl');
+    copyIfPresent('publicAddress');
+    copyIfPresent('hostname');
+    copyIfPresent('ipv4');
+    copyIfPresent('ipv6');
+    copyIfPresent('version');
+    copyIfPresent('status');
+    copyIfPresent('capabilities');
+    copyIfPresent('metrics');
+    return next;
+}
+async function readJsonBody(request) {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        request.setEncoding('utf8');
+        request.on('data', (chunk) => {
+            data += chunk;
+        });
+        request.on('end', () => {
+            if (!data) {
+                resolve(undefined);
+                return;
+            }
+            try {
+                resolve(JSON.parse(data));
+            }
+            catch {
+                resolve(undefined);
+            }
+        });
+        request.on('error', reject);
+    });
+}
+function sendJson(response, status, data) {
+    response.statusCode = status;
+    response.setHeader('Content-Type', 'application/json');
+    response.end(JSON.stringify(data));
+}
+//# sourceMappingURL=SignalHandler.js.map

package/dist/api/handlers/SignalHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/SignalHandler.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ServerResponse } from 'node:http';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { AuthenticatedRequest } from '../middleware/AuthMiddleware';\nimport type { ApiServer } from '../ApiServer';\nimport type { EdgeNodeRepository } from '../../identity/drizzle/EdgeNodeRepository';\nimport { getWebId } from '../auth/AuthContext';\n\nexport interface SignalHandlerOptions {\n  repository: EdgeNodeRepository;\n}\n\n/**\n * Handler for edge node signaling API\n *\n * POST /v1/signal - Edge node heartbeat/signal\n *\n * Requires API authentication and a nodeId in the request body.\n */\nexport function registerSignalRoutes(server: ApiServer, options: SignalHandlerOptions): void {\n  const logger = getLoggerFor('SignalHandler');\n  const repo = options.repository;\n\n  // POST /v1/signal - authenticated via API key or Solid token\n  server.post('/v1/signal', async (request, response, _params) => {\n    const auth = request.auth;\n    const webId = auth ? getWebId(auth) : undefined;\n    if (!webId) {\n      sendJson(response, 400, { error: 'Cannot determine user' });\n      return;\n    }\n    const body = await readJsonBody(request);\n\n    if (!body || typeof body !== 'object') {\n      sendJson(response, 400, { error: 'Request body must be a JSON object' });\n      return;\n    }\n\n    const payload = body as Record<string, unknown>;\n    const nodeId = typeof payload.nodeId === 'string' ? payload.nodeId.trim() : '';\n    if (!nodeId) {\n      sendJson(response, 400, { error: 'nodeId is required' });\n      return;\n    }\n\n    try {\n      const owner = await repo.getNodeOwner(nodeId);\n      if (!owner) {\n        sendJson(response, 404, { error: 'Node not found' });\n        return;\n      }\n      if (owner !== webId) {\n        sendJson(response, 403, { error: 'Access denied' });\n        return;\n      }\n    } catch (error) {\n      logger.error(`Failed to validate node access: ${error}`);\n      sendJson(response, 500, { error: 'Failed to validate node access' });\n      return;\n    }\n\n\n    const now = new Date();\n\n    try {\n      // Get current metadata to merge\n      const existing = await repo.getNodeMetadata(nodeId);\n      const metadata = mergeMetadata(existing?.metadata ?? {}, payload, now);\n\n      // Update heartbeat\n      await repo.updateNodeHeartbeat(nodeId, metadata, now);\n\n      // Update pods if provided\n      if (Array.isArray(payload.pods)) {\n        await repo.replaceNodePods(nodeId, payload.pods as string[]);\n      }\n\n      logger.debug(`Signal received from node ${nodeId}`);\n\n      sendJson(response, 200, {\n        status: 'ok',\n        nodeId,\n        lastSeen: now.toISOString(),\n        metadata,\n      });\n    } catch (error) {\n      logger.error(`Signal handling error for node ${nodeId}: ${error}`);\n      sendJson(response, 500, { error: 'Failed to process signal' });\n    }\n  });\n}\n\nfunction mergeMetadata(\n  previous: Record<string, unknown>,\n  payload: Record<string, unknown>,\n  now: Date,\n): Record<string, unknown> {\n  const next: Record<string, unknown> = { ...previous };\n  next.lastHeartbeatAt = now.toISOString();\n\n  const copyIfPresent = (key: string) => {\n    if (payload[key] !== undefined) {\n      next[key] = payload[key];\n    }\n  };\n\n  copyIfPresent('baseUrl');\n  copyIfPresent('publicAddress');\n  copyIfPresent('hostname');\n  copyIfPresent('ipv4');\n  copyIfPresent('ipv6');\n  copyIfPresent('version');\n  copyIfPresent('status');\n  copyIfPresent('capabilities');\n  copyIfPresent('metrics');\n\n  return next;\n}\n\nasync function readJsonBody(request: AuthenticatedRequest): Promise<unknown> {\n  return new Promise((resolve, reject) => {\n    let data = '';\n    request.setEncoding('utf8');\n    request.on('data', (chunk: string) => {\n      data += chunk;\n    });\n    request.on('end', () => {\n      if (!data) {\n        resolve(undefined);\n        return;\n      }\n      try {\n        resolve(JSON.parse(data));\n      } catch {\n        resolve(undefined);\n      }\n    });\n    request.on('error', reject);\n  });\n}\n\nfunction sendJson(response: ServerResponse, status: number, data: unknown): void {\n  response.statusCode = status;\n  response.setHeader('Content-Type', 'application/json');\n  response.end(JSON.stringify(data));\n}\n"]}

package/dist/api/handlers/SubdomainClientHandler.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SubdomainClientHandler - Local 模式子域名 API
+ *
+ * 代理请求到 Cloud API，供本地 UI 调用
+ */
+import type { ApiServer } from '../ApiServer';
+import type { SubdomainClient } from '../../subdomain/SubdomainClient';
+export interface SubdomainClientHandlerOptions {
+    subdomainClient: SubdomainClient;
+}
+/**
+ * 注册 Local 模式子域名路由
+ *
+ * 这些路由是本地 UI 调用的入口，内部通过 SubdomainClient 转发到 Cloud
+ *
+ * GET  /v1/subdomain/check?name=xxx - 检查子域名可用性
+ * GET  /v1/subdomain - 列出子域名
+ * GET  /v1/subdomain/:name - 获取子域名详情
+ * POST /v1/subdomain/register - 注册子域名
+ * DELETE /v1/subdomain/:name - 释放子域名
+ * POST /v1/subdomain/:name/start - 启动隧道
+ * POST /v1/subdomain/:name/stop - 停止隧道
+ */
+export declare function registerSubdomainClientRoutes(server: ApiServer, options: SubdomainClientHandlerOptions): void;

package/dist/api/handlers/SubdomainClientHandler.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * SubdomainClientHandler - Local 模式子域名 API
+ *
+ * 代理请求到 Cloud API，供本地 UI 调用
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSubdomainClientRoutes = registerSubdomainClientRoutes;
+const global_logger_factory_1 = require("global-logger-factory");
+/**
+ * 注册 Local 模式子域名路由
+ *
+ * 这些路由是本地 UI 调用的入口，内部通过 SubdomainClient 转发到 Cloud
+ *
+ * GET  /v1/subdomain/check?name=xxx - 检查子域名可用性
+ * GET  /v1/subdomain - 列出子域名
+ * GET  /v1/subdomain/:name - 获取子域名详情
+ * POST /v1/subdomain/register - 注册子域名
+ * DELETE /v1/subdomain/:name - 释放子域名
+ * POST /v1/subdomain/:name/start - 启动隧道
+ * POST /v1/subdomain/:name/stop - 停止隧道
+ */
+function registerSubdomainClientRoutes(server, options) {
+    const logger = (0, global_logger_factory_1.getLoggerFor)('SubdomainClientHandler');
+    const client = options.subdomainClient;
+    // GET /v1/subdomain/check?name=xxx - 检查可用性 (public)
+    server.get('/v1/subdomain/check', async (request, response, _params) => {
+        const url = new URL(request.url ?? '/', `http://${request.headers.host ?? 'localhost'}`);
+        const name = url.searchParams.get('name');
+        if (!name) {
+            sendJson(response, 400, { error: 'Missing "name" query parameter' });
+            return;
+        }
+        try {
+            const result = await client.checkAvailability(name);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Failed to check availability: ${error}`);
+            sendErrorJson(response, error);
+        }
+    }, { public: true });
+    // GET /v1/subdomain - 列出子域名
+    server.get('/v1/subdomain', async (_request, response, _params) => {
+        try {
+            const result = await client.list();
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Failed to list subdomains: ${error}`);
+            sendErrorJson(response, error);
+        }
+    });
+    // GET /v1/subdomain/:name - 获取子域名详情
+    server.get('/v1/subdomain/:name', async (_request, response, params) => {
+        const name = decodeURIComponent(params.name);
+        try {
+            const result = await client.getInfo(name);
+            if (!result) {
+                sendJson(response, 404, { error: 'Subdomain not found' });
+                return;
+            }
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Failed to get subdomain info: ${error}`);
+            sendErrorJson(response, error);
+        }
+    });
+    // POST /v1/subdomain/register - 注册子域名
+    server.post('/v1/subdomain/register', async (request, response, _params) => {
+        const body = await readJsonBody(request);
+        if (!body || typeof body !== 'object') {
+            sendJson(response, 400, { error: 'Invalid request body' });
+            return;
+        }
+        const { subdomain, localPort, publicIp } = body;
+        if (!subdomain || typeof subdomain !== 'string') {
+            sendJson(response, 400, { error: 'Missing "subdomain" field' });
+            return;
+        }
+        if (!localPort || typeof localPort !== 'number') {
+            sendJson(response, 400, { error: 'Missing or invalid "localPort" field' });
+            return;
+        }
+        try {
+            const result = await client.register({
+                subdomain,
+                localPort,
+                publicIp: typeof publicIp === 'string' ? publicIp : undefined,
+            });
+            sendJson(response, 201, result);
+        }
+        catch (error) {
+            logger.error(`Failed to register subdomain: ${error}`);
+            sendErrorJson(response, error);
+        }
+    });
+    // DELETE /v1/subdomain/:name - 释放子域名
+    server.delete('/v1/subdomain/:name', async (_request, response, params) => {
+        const name = decodeURIComponent(params.name);
+        try {
+            const result = await client.release(name);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Failed to release subdomain: ${error}`);
+            sendErrorJson(response, error);
+        }
+    });
+    // POST /v1/subdomain/:name/start - 启动隧道
+    server.post('/v1/subdomain/:name/start', async (_request, response, params) => {
+        const name = decodeURIComponent(params.name);
+        try {
+            const result = await client.startTunnel(name);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Failed to start tunnel: ${error}`);
+            sendErrorJson(response, error);
+        }
+    });
+    // POST /v1/subdomain/:name/stop - 停止隧道
+    server.post('/v1/subdomain/:name/stop', async (_request, response, params) => {
+        const name = decodeURIComponent(params.name);
+        try {
+            const result = await client.stopTunnel(name);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Failed to stop tunnel: ${error}`);
+            sendErrorJson(response, error);
+        }
+    });
+}
+// ============ Helper Functions ============
+async function readJsonBody(request) {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        request.setEncoding('utf8');
+        request.on('data', (chunk) => {
+            data += chunk;
+        });
+        request.on('end', () => {
+            if (!data) {
+                resolve(undefined);
+                return;
+            }
+            try {
+                resolve(JSON.parse(data));
+            }
+            catch {
+                resolve(undefined);
+            }
+        });
+        request.on('error', reject);
+    });
+}
+function sendJson(response, status, data) {
+    response.statusCode = status;
+    response.setHeader('Content-Type', 'application/json');
+    response.end(JSON.stringify(data));
+}
+function sendErrorJson(response, error) {
+    const status = error?.status ?? 500;
+    const message = error instanceof Error ? error.message : 'Unknown error';
+    sendJson(response, status, { error: message });
+}
+//# sourceMappingURL=SubdomainClientHandler.js.map

package/dist/api/handlers/SubdomainClientHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubdomainClientHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/SubdomainClientHandler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SubdomainClientHandler - Local 模式子域名 API\n * \n * 代理请求到 Cloud API，供本地 UI 调用\n */\n\nimport type { ServerResponse } from 'node:http';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { AuthenticatedRequest } from '../middleware/AuthMiddleware';\nimport type { ApiServer } from '../ApiServer';\nimport type { SubdomainClient } from '../../subdomain/SubdomainClient';\n\nexport interface SubdomainClientHandlerOptions {\n  subdomainClient: SubdomainClient;\n}\n\n/**\n * 注册 Local 模式子域名路由\n * \n * 这些路由是本地 UI 调用的入口，内部通过 SubdomainClient 转发到 Cloud\n * \n * GET  /v1/subdomain/check?name=xxx - 检查子域名可用性\n * GET  /v1/subdomain - 列出子域名\n * GET  /v1/subdomain/:name - 获取子域名详情\n * POST /v1/subdomain/register - 注册子域名\n * DELETE /v1/subdomain/:name - 释放子域名\n * POST /v1/subdomain/:name/start - 启动隧道\n * POST /v1/subdomain/:name/stop - 停止隧道\n */\nexport function registerSubdomainClientRoutes(\n  server: ApiServer,\n  options: SubdomainClientHandlerOptions,\n): void {\n  const logger = getLoggerFor('SubdomainClientHandler');\n  const client = options.subdomainClient;\n\n  // GET /v1/subdomain/check?name=xxx - 检查可用性 (public)\n  server.get('/v1/subdomain/check', async (request, response, _params) => {\n    const url = new URL(request.url ?? '/', `http://${request.headers.host ?? 'localhost'}`);\n    const name = url.searchParams.get('name');\n\n    if (!name) {\n      sendJson(response, 400, { error: 'Missing \"name\" query parameter' });\n      return;\n    }\n\n    try {\n      const result = await client.checkAvailability(name);\n      sendJson(response, 200, result);\n    } catch (error) {\n      logger.error(`Failed to check availability: ${error}`);\n      sendErrorJson(response, error);\n    }\n  }, { public: true });\n\n  // GET /v1/subdomain - 列出子域名\n  server.get('/v1/subdomain', async (_request, response, _params) => {\n    try {\n      const result = await client.list();\n      sendJson(response, 200, result);\n    } catch (error) {\n      logger.error(`Failed to list subdomains: ${error}`);\n      sendErrorJson(response, error);\n    }\n  });\n\n  // GET /v1/subdomain/:name - 获取子域名详情\n  server.get('/v1/subdomain/:name', async (_request, response, params) => {\n    const name = decodeURIComponent(params.name);\n\n    try {\n      const result = await client.getInfo(name);\n      if (!result) {\n        sendJson(response, 404, { error: 'Subdomain not found' });\n        return;\n      }\n      sendJson(response, 200, result);\n    } catch (error) {\n      logger.error(`Failed to get subdomain info: ${error}`);\n      sendErrorJson(response, error);\n    }\n  });\n\n  // POST /v1/subdomain/register - 注册子域名\n  server.post('/v1/subdomain/register', async (request, response, _params) => {\n    const body = await readJsonBody(request);\n    \n    if (!body || typeof body !== 'object') {\n      sendJson(response, 400, { error: 'Invalid request body' });\n      return;\n    }\n\n    const { subdomain, localPort, publicIp } = body as Record<string, unknown>;\n\n    if (!subdomain || typeof subdomain !== 'string') {\n      sendJson(response, 400, { error: 'Missing \"subdomain\" field' });\n      return;\n    }\n\n    if (!localPort || typeof localPort !== 'number') {\n      sendJson(response, 400, { error: 'Missing or invalid \"localPort\" field' });\n      return;\n    }\n\n    try {\n      const result = await client.register({\n        subdomain,\n        localPort,\n        publicIp: typeof publicIp === 'string' ? publicIp : undefined,\n      });\n      sendJson(response, 201, result);\n    } catch (error) {\n      logger.error(`Failed to register subdomain: ${error}`);\n      sendErrorJson(response, error);\n    }\n  });\n\n  // DELETE /v1/subdomain/:name - 释放子域名\n  server.delete('/v1/subdomain/:name', async (_request, response, params) => {\n    const name = decodeURIComponent(params.name);\n\n    try {\n      const result = await client.release(name);\n      sendJson(response, 200, result);\n    } catch (error) {\n      logger.error(`Failed to release subdomain: ${error}`);\n      sendErrorJson(response, error);\n    }\n  });\n\n  // POST /v1/subdomain/:name/start - 启动隧道\n  server.post('/v1/subdomain/:name/start', async (_request, response, params) => {\n    const name = decodeURIComponent(params.name);\n\n    try {\n      const result = await client.startTunnel(name);\n      sendJson(response, 200, result);\n    } catch (error) {\n      logger.error(`Failed to start tunnel: ${error}`);\n      sendErrorJson(response, error);\n    }\n  });\n\n  // POST /v1/subdomain/:name/stop - 停止隧道\n  server.post('/v1/subdomain/:name/stop', async (_request, response, params) => {\n    const name = decodeURIComponent(params.name);\n\n    try {\n      const result = await client.stopTunnel(name);\n      sendJson(response, 200, result);\n    } catch (error) {\n      logger.error(`Failed to stop tunnel: ${error}`);\n      sendErrorJson(response, error);\n    }\n  });\n}\n\n// ============ Helper Functions ============\n\nasync function readJsonBody(request: AuthenticatedRequest): Promise<unknown> {\n  return new Promise((resolve, reject) => {\n    let data = '';\n    request.setEncoding('utf8');\n    request.on('data', (chunk: string) => {\n      data += chunk;\n    });\n    request.on('end', () => {\n      if (!data) {\n        resolve(undefined);\n        return;\n      }\n      try {\n        resolve(JSON.parse(data));\n      } catch {\n        resolve(undefined);\n      }\n    });\n    request.on('error', reject);\n  });\n}\n\nfunction sendJson(response: ServerResponse, status: number, data: unknown): void {\n  response.statusCode = status;\n  response.setHeader('Content-Type', 'application/json');\n  response.end(JSON.stringify(data));\n}\n\nfunction sendErrorJson(response: ServerResponse, error: unknown): void {\n  const status = (error as any)?.status ?? 500;\n  const message = error instanceof Error ? error.message : 'Unknown error';\n  sendJson(response, status, { error: message });\n}\n"]}