@undefineds.co/xpod 0.1.0-local.202602081751

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

@@ -0,0 +1,17 @@
+import type { ApiServer } from '../ApiServer';
+import type { SubdomainService } from '../../subdomain/SubdomainService';
+export interface SubdomainHandlerOptions {
+    subdomainService: SubdomainService;
+}
+/**
+ * Handler for subdomain management API
+ *
+ * GET  /v1/subdomain/check?name=xxx - Check subdomain availability (public)
+ * GET  /v1/subdomain - List user's subdomain registrations
+ * GET  /v1/subdomain/:name - Get subdomain info
+ * POST /v1/subdomain/register - Register a new subdomain
+ * DELETE /v1/subdomain/:name - Release a subdomain
+ * POST /v1/subdomain/:name/start - Start tunnel
+ * POST /v1/subdomain/:name/stop - Stop tunnel
+ */
+export declare function registerSubdomainRoutes(server: ApiServer, options: SubdomainHandlerOptions): void;

package/dist/api/handlers/SubdomainHandler.js

@@ -0,0 +1,312 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSubdomainRoutes = registerSubdomainRoutes;
+const global_logger_factory_1 = require("global-logger-factory");
+const AuthContext_1 = require("../auth/AuthContext");
+/**
+ * Handler for subdomain management API
+ *
+ * GET  /v1/subdomain/check?name=xxx - Check subdomain availability (public)
+ * GET  /v1/subdomain - List user's subdomain registrations
+ * GET  /v1/subdomain/:name - Get subdomain info
+ * POST /v1/subdomain/register - Register a new subdomain
+ * DELETE /v1/subdomain/:name - Release a subdomain
+ * POST /v1/subdomain/:name/start - Start tunnel
+ * POST /v1/subdomain/:name/stop - Stop tunnel
+ */
+function registerSubdomainRoutes(server, options) {
+    const logger = (0, global_logger_factory_1.getLoggerFor)('SubdomainHandler');
+    const service = options.subdomainService;
+    const rejectApiKey = (request, response) => {
+        const auth = request.auth;
+        if (auth && (0, AuthContext_1.isSolidAuth)(auth) && auth.viaApiKey) {
+            sendJson(response, 403, { error: 'API key is not allowed for this endpoint' });
+            return true;
+        }
+        return false;
+    };
+    // GET /v1/subdomain/check?name=xxx - Check availability (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 service.checkAvailability(name);
+            sendJson(response, 200, {
+                subdomain: name,
+                available: result.available,
+                reason: result.reason,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to check availability: ${error}`);
+            sendJson(response, 500, { error: 'Failed to check availability' });
+        }
+    }, { public: true });
+    // GET /v1/subdomain - List user's registrations
+    server.get('/v1/subdomain', async (request, response, _params) => {
+        if (rejectApiKey(request, response)) {
+            return;
+        }
+        const auth = request.auth;
+        const webId = (0, AuthContext_1.getWebId)(auth);
+        if (!webId) {
+            sendJson(response, 400, { error: 'Cannot determine user' });
+            return;
+        }
+        try {
+            // Filter registrations by owner
+            const allRegistrations = service.getAllRegistrations();
+            const userRegistrations = allRegistrations.filter(r => r.ownerId === webId);
+            sendJson(response, 200, {
+                registrations: userRegistrations.map(formatRegistration),
+                total: userRegistrations.length,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to list registrations: ${error}`);
+            sendJson(response, 500, { error: 'Failed to list registrations' });
+        }
+    });
+    // GET /v1/subdomain/:name - Get subdomain info
+    server.get('/v1/subdomain/:name', async (request, response, params) => {
+        if (rejectApiKey(request, response)) {
+            return;
+        }
+        const auth = request.auth;
+        const webId = (0, AuthContext_1.getWebId)(auth);
+        const name = decodeURIComponent(params.name);
+        if (!webId) {
+            sendJson(response, 400, { error: 'Cannot determine user' });
+            return;
+        }
+        try {
+            const registration = service.getRegistration(name);
+            if (!registration) {
+                sendJson(response, 404, { error: 'Subdomain not found' });
+                return;
+            }
+            // Check ownership
+            if (registration.ownerId !== webId) {
+                sendJson(response, 403, { error: 'Access denied' });
+                return;
+            }
+            sendJson(response, 200, {
+                ...formatRegistration(registration),
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to get registration: ${error}`);
+            sendJson(response, 500, { error: 'Failed to get registration' });
+        }
+    });
+    // POST /v1/subdomain/register - Register a new subdomain
+    server.post('/v1/subdomain/register', async (request, response, _params) => {
+        if (rejectApiKey(request, response)) {
+            return;
+        }
+        const auth = request.auth;
+        const webId = (0, AuthContext_1.getWebId)(auth);
+        if (!webId) {
+            sendJson(response, 400, { error: 'Cannot determine user' });
+            return;
+        }
+        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 registration = await service.register({
+                subdomain,
+                localPort,
+                publicIp: typeof publicIp === 'string' ? publicIp : undefined,
+                ownerId: webId,
+            });
+            logger.info(`Registered subdomain: ${registration.fullDomain} for ${webId} (mode: ${registration.mode})`);
+            sendJson(response, 201, {
+                success: true,
+                ...formatRegistration(registration),
+                message: `Subdomain registered successfully in ${registration.mode} mode.`,
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to register subdomain: ${error}`);
+            if (error instanceof Error) {
+                sendJson(response, 400, { error: error.message });
+            }
+            else {
+                sendJson(response, 500, { error: 'Failed to register subdomain' });
+            }
+        }
+    });
+    // DELETE /v1/subdomain/:name - Release a subdomain
+    server.delete('/v1/subdomain/:name', async (request, response, params) => {
+        if (rejectApiKey(request, response)) {
+            return;
+        }
+        const auth = request.auth;
+        const webId = (0, AuthContext_1.getWebId)(auth);
+        const name = decodeURIComponent(params.name);
+        if (!webId) {
+            sendJson(response, 400, { error: 'Cannot determine user' });
+            return;
+        }
+        try {
+            const registration = service.getRegistration(name);
+            if (!registration) {
+                sendJson(response, 404, { error: 'Subdomain not found' });
+                return;
+            }
+            // Check ownership
+            if (registration.ownerId !== webId) {
+                sendJson(response, 403, { error: 'Access denied' });
+                return;
+            }
+            await service.release(name);
+            logger.info(`Released subdomain: ${name} by ${webId}`);
+            sendJson(response, 200, {
+                success: true,
+                subdomain: name,
+                message: 'Subdomain released successfully.',
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to release subdomain: ${error}`);
+            sendJson(response, 500, { error: 'Failed to release subdomain' });
+        }
+    });
+    // POST /v1/subdomain/:name/start - Start tunnel
+    server.post('/v1/subdomain/:name/start', async (request, response, params) => {
+        if (rejectApiKey(request, response)) {
+            return;
+        }
+        const auth = request.auth;
+        const webId = (0, AuthContext_1.getWebId)(auth);
+        const name = decodeURIComponent(params.name);
+        if (!webId) {
+            sendJson(response, 400, { error: 'Cannot determine user' });
+            return;
+        }
+        try {
+            const registration = service.getRegistration(name);
+            if (!registration) {
+                sendJson(response, 404, { error: 'Subdomain not found' });
+                return;
+            }
+            if (registration.ownerId !== webId) {
+                sendJson(response, 403, { error: 'Access denied' });
+                return;
+            }
+            await service.startTunnel(name);
+            logger.info(`Started tunnel for subdomain: ${name}`);
+            sendJson(response, 200, {
+                success: true,
+                subdomain: name,
+                message: 'Tunnel started successfully.',
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to start tunnel: ${error}`);
+            if (error instanceof Error) {
+                sendJson(response, 400, { error: error.message });
+            }
+            else {
+                sendJson(response, 500, { error: 'Failed to start tunnel' });
+            }
+        }
+    });
+    // POST /v1/subdomain/:name/stop - Stop tunnel
+    server.post('/v1/subdomain/:name/stop', async (request, response, params) => {
+        if (rejectApiKey(request, response)) {
+            return;
+        }
+        const auth = request.auth;
+        const webId = (0, AuthContext_1.getWebId)(auth);
+        const name = decodeURIComponent(params.name);
+        if (!webId) {
+            sendJson(response, 400, { error: 'Cannot determine user' });
+            return;
+        }
+        try {
+            const registration = service.getRegistration(name);
+            if (!registration) {
+                sendJson(response, 404, { error: 'Subdomain not found' });
+                return;
+            }
+            if (registration.ownerId !== webId) {
+                sendJson(response, 403, { error: 'Access denied' });
+                return;
+            }
+            await service.stopTunnel();
+            logger.info(`Stopped tunnel for subdomain: ${name}`);
+            sendJson(response, 200, {
+                success: true,
+                subdomain: name,
+                message: 'Tunnel stopped successfully.',
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to stop tunnel: ${error}`);
+            sendJson(response, 500, { error: 'Failed to stop tunnel' });
+        }
+    });
+}
+function formatRegistration(reg) {
+    return {
+        subdomain: reg.subdomain,
+        fullDomain: reg.fullDomain,
+        mode: reg.mode,
+        publicIp: reg.publicIp,
+        tunnelProvider: reg.tunnelConfig?.provider,
+        tunnelEndpoint: reg.tunnelConfig?.endpoint,
+        registeredAt: reg.registeredAt.toISOString(),
+        ownerId: reg.ownerId,
+    };
+}
+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=SubdomainHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SubdomainHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/SubdomainHandler.ts"],"names":[],"mappings":";;AAsBA,0DAkSC;AAvTD,iEAAqD;AAIrD,qDAA4D;AAM5D;;;;;;;;;;GAUG;AACH,SAAgB,uBAAuB,CAAC,MAAiB,EAAE,OAAgC;IACzF,MAAM,MAAM,GAAG,IAAA,oCAAY,EAAC,kBAAkB,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAEzC,MAAM,YAAY,GAAG,CAAC,OAA6B,EAAE,QAAwB,EAAW,EAAE;QACxF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,IAAI,IAAI,IAAI,IAAA,yBAAW,EAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC,CAAC;YAC/E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,iEAAiE;IACjE,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QACrE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;QACzF,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAE1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YACrD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;YACvD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAErB,gDAAgD;IAChD,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QAC/D,IAAI,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAK,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAA,sBAAQ,EAAC,IAAI,CAAC,CAAC;QAE7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,gCAAgC;YAChC,MAAM,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;YACvD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC;YAE5E,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,aAAa,EAAE,iBAAiB,CAAC,GAAG,CAAC,kBAAkB,CAAC;gBACxD,KAAK,EAAE,iBAAiB,CAAC,MAAM;gBAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;YACvD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,+CAA+C;IAC/C,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACpE,IAAI,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAK,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAA,sBAAQ,EAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAEnD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;gBAC1D,OAAO;YACT,CAAC;YAED,kBAAkB;YAClB,IAAI,YAAY,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;gBACnC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,GAAG,kBAAkB,CAAC,YAAY,CAAC;gBACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC;YACrD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,yDAAyD;IACzD,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QACzE,IAAI,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAK,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAA,sBAAQ,EAAC,IAAI,CAAC,CAAC;QAE7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QAED,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAA+B,CAAC;QAE3E,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC,CAAC;YAC3E,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC;gBAC1C,SAAS;gBACT,SAAS;gBACT,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBAC7D,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,yBAAyB,YAAY,CAAC,UAAU,QAAQ,KAAK,WAAW,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC;YAE1G,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,OAAO,EAAE,IAAI;gBACb,GAAG,kBAAkB,CAAC,YAAY,CAAC;gBACnC,OAAO,EAAE,wCAAwC,YAAY,CAAC,IAAI,QAAQ;aAC3E,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;YACvD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,mDAAmD;IACnD,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACvE,IAAI,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAK,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAA,sBAAQ,EAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAEnD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;gBAC1D,OAAO;YACT,CAAC;YAED,kBAAkB;YAClB,IAAI,YAAY,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;gBACnC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAE5B,MAAM,CAAC,IAAI,CAAC,uBAAuB,IAAI,OAAO,KAAK,EAAE,CAAC,CAAC;YACvD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,kCAAkC;gBAC3C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,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,6BAA6B,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAChD,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAC3E,IAAI,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAK,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAA,sBAAQ,EAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAEnD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;gBAC1D,OAAO;YACT,CAAC;YAED,IAAI,YAAY,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;gBACnC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAEhC,MAAM,CAAC,IAAI,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;YACrD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,8BAA8B;gBACvC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;YACjD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,8CAA8C;IAC9C,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAC1E,IAAI,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAK,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAA,sBAAQ,EAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAEnD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;gBAC1D,OAAO;YACT,CAAC;YAED,IAAI,YAAY,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;gBACnC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;YAE3B,MAAM,CAAC,IAAI,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;YACrD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,8BAA8B;gBACvC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;YAChD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,GAA0B;IACpD,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,QAAQ;QAC1C,cAAc,EAAE,GAAG,CAAC,YAAY,EAAE,QAAQ;QAC1C,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC,WAAW,EAAE;QAC5C,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC;AACJ,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 { SubdomainService, SubdomainRegistration } from '../../subdomain/SubdomainService';\nimport { getWebId, isSolidAuth } from '../auth/AuthContext';\n\nexport interface SubdomainHandlerOptions {\n  subdomainService: SubdomainService;\n}\n\n/**\n * Handler for subdomain management API\n *\n * GET  /v1/subdomain/check?name=xxx - Check subdomain availability (public)\n * GET  /v1/subdomain - List user's subdomain registrations\n * GET  /v1/subdomain/:name - Get subdomain info\n * POST /v1/subdomain/register - Register a new subdomain\n * DELETE /v1/subdomain/:name - Release a subdomain\n * POST /v1/subdomain/:name/start - Start tunnel\n * POST /v1/subdomain/:name/stop - Stop tunnel\n */\nexport function registerSubdomainRoutes(server: ApiServer, options: SubdomainHandlerOptions): void {\n  const logger = getLoggerFor('SubdomainHandler');\n  const service = options.subdomainService;\n\n  const rejectApiKey = (request: AuthenticatedRequest, response: ServerResponse): boolean => {\n    const auth = request.auth;\n    if (auth && isSolidAuth(auth) && auth.viaApiKey) {\n      sendJson(response, 403, { error: 'API key is not allowed for this endpoint' });\n      return true;\n    }\n    return false;\n  };\n\n  // GET /v1/subdomain/check?name=xxx - Check availability (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 service.checkAvailability(name);\n      sendJson(response, 200, {\n        subdomain: name,\n        available: result.available,\n        reason: result.reason,\n        timestamp: new Date().toISOString(),\n      });\n    } catch (error) {\n      logger.error(`Failed to check availability: ${error}`);\n      sendJson(response, 500, { error: 'Failed to check availability' });\n    }\n  }, { public: true });\n\n  // GET /v1/subdomain - List user's registrations\n  server.get('/v1/subdomain', async (request, response, _params) => {\n    if (rejectApiKey(request, response)) {\n      return;\n    }\n    const auth = request.auth!;\n    const webId = getWebId(auth);\n\n    if (!webId) {\n      sendJson(response, 400, { error: 'Cannot determine user' });\n      return;\n    }\n\n    try {\n      // Filter registrations by owner\n      const allRegistrations = service.getAllRegistrations();\n      const userRegistrations = allRegistrations.filter(r => r.ownerId === webId);\n\n      sendJson(response, 200, {\n        registrations: userRegistrations.map(formatRegistration),\n        total: userRegistrations.length,\n        timestamp: new Date().toISOString(),\n      });\n    } catch (error) {\n      logger.error(`Failed to list registrations: ${error}`);\n      sendJson(response, 500, { error: 'Failed to list registrations' });\n    }\n  });\n\n  // GET /v1/subdomain/:name - Get subdomain info\n  server.get('/v1/subdomain/:name', async (request, response, params) => {\n    if (rejectApiKey(request, response)) {\n      return;\n    }\n    const auth = request.auth!;\n    const webId = getWebId(auth);\n    const name = decodeURIComponent(params.name);\n\n    if (!webId) {\n      sendJson(response, 400, { error: 'Cannot determine user' });\n      return;\n    }\n\n    try {\n      const registration = service.getRegistration(name);\n      \n      if (!registration) {\n        sendJson(response, 404, { error: 'Subdomain not found' });\n        return;\n      }\n\n      // Check ownership\n      if (registration.ownerId !== webId) {\n        sendJson(response, 403, { error: 'Access denied' });\n        return;\n      }\n\n      sendJson(response, 200, {\n        ...formatRegistration(registration),\n        timestamp: new Date().toISOString(),\n      });\n    } catch (error) {\n      logger.error(`Failed to get registration: ${error}`);\n      sendJson(response, 500, { error: 'Failed to get registration' });\n    }\n  });\n\n  // POST /v1/subdomain/register - Register a new subdomain\n  server.post('/v1/subdomain/register', async (request, response, _params) => {\n    if (rejectApiKey(request, response)) {\n      return;\n    }\n    const auth = request.auth!;\n    const webId = getWebId(auth);\n\n    if (!webId) {\n      sendJson(response, 400, { error: 'Cannot determine user' });\n      return;\n    }\n\n    const body = await readJsonBody(request);\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 registration = await service.register({\n        subdomain,\n        localPort,\n        publicIp: typeof publicIp === 'string' ? publicIp : undefined,\n        ownerId: webId,\n      });\n\n      logger.info(`Registered subdomain: ${registration.fullDomain} for ${webId} (mode: ${registration.mode})`);\n\n      sendJson(response, 201, {\n        success: true,\n        ...formatRegistration(registration),\n        message: `Subdomain registered successfully in ${registration.mode} mode.`,\n      });\n    } catch (error) {\n      logger.error(`Failed to register subdomain: ${error}`);\n      if (error instanceof Error) {\n        sendJson(response, 400, { error: error.message });\n      } else {\n        sendJson(response, 500, { error: 'Failed to register subdomain' });\n      }\n    }\n  });\n\n  // DELETE /v1/subdomain/:name - Release a subdomain\n  server.delete('/v1/subdomain/:name', async (request, response, params) => {\n    if (rejectApiKey(request, response)) {\n      return;\n    }\n    const auth = request.auth!;\n    const webId = getWebId(auth);\n    const name = decodeURIComponent(params.name);\n\n    if (!webId) {\n      sendJson(response, 400, { error: 'Cannot determine user' });\n      return;\n    }\n\n    try {\n      const registration = service.getRegistration(name);\n      \n      if (!registration) {\n        sendJson(response, 404, { error: 'Subdomain not found' });\n        return;\n      }\n\n      // Check ownership\n      if (registration.ownerId !== webId) {\n        sendJson(response, 403, { error: 'Access denied' });\n        return;\n      }\n\n      await service.release(name);\n\n      logger.info(`Released subdomain: ${name} by ${webId}`);\n      sendJson(response, 200, {\n        success: true,\n        subdomain: name,\n        message: 'Subdomain released successfully.',\n        timestamp: new Date().toISOString(),\n      });\n    } catch (error) {\n      logger.error(`Failed to release subdomain: ${error}`);\n      sendJson(response, 500, { error: 'Failed to release subdomain' });\n    }\n  });\n\n  // POST /v1/subdomain/:name/start - Start tunnel\n  server.post('/v1/subdomain/:name/start', async (request, response, params) => {\n    if (rejectApiKey(request, response)) {\n      return;\n    }\n    const auth = request.auth!;\n    const webId = getWebId(auth);\n    const name = decodeURIComponent(params.name);\n\n    if (!webId) {\n      sendJson(response, 400, { error: 'Cannot determine user' });\n      return;\n    }\n\n    try {\n      const registration = service.getRegistration(name);\n      \n      if (!registration) {\n        sendJson(response, 404, { error: 'Subdomain not found' });\n        return;\n      }\n\n      if (registration.ownerId !== webId) {\n        sendJson(response, 403, { error: 'Access denied' });\n        return;\n      }\n\n      await service.startTunnel(name);\n\n      logger.info(`Started tunnel for subdomain: ${name}`);\n      sendJson(response, 200, {\n        success: true,\n        subdomain: name,\n        message: 'Tunnel started successfully.',\n        timestamp: new Date().toISOString(),\n      });\n    } catch (error) {\n      logger.error(`Failed to start tunnel: ${error}`);\n      if (error instanceof Error) {\n        sendJson(response, 400, { error: error.message });\n      } else {\n        sendJson(response, 500, { error: 'Failed to start tunnel' });\n      }\n    }\n  });\n\n  // POST /v1/subdomain/:name/stop - Stop tunnel\n  server.post('/v1/subdomain/:name/stop', async (request, response, params) => {\n    if (rejectApiKey(request, response)) {\n      return;\n    }\n    const auth = request.auth!;\n    const webId = getWebId(auth);\n    const name = decodeURIComponent(params.name);\n\n    if (!webId) {\n      sendJson(response, 400, { error: 'Cannot determine user' });\n      return;\n    }\n\n    try {\n      const registration = service.getRegistration(name);\n      \n      if (!registration) {\n        sendJson(response, 404, { error: 'Subdomain not found' });\n        return;\n      }\n\n      if (registration.ownerId !== webId) {\n        sendJson(response, 403, { error: 'Access denied' });\n        return;\n      }\n\n      await service.stopTunnel();\n\n      logger.info(`Stopped tunnel for subdomain: ${name}`);\n      sendJson(response, 200, {\n        success: true,\n        subdomain: name,\n        message: 'Tunnel stopped successfully.',\n        timestamp: new Date().toISOString(),\n      });\n    } catch (error) {\n      logger.error(`Failed to stop tunnel: ${error}`);\n      sendJson(response, 500, { error: 'Failed to stop tunnel' });\n    }\n  });\n}\n\nfunction formatRegistration(reg: SubdomainRegistration): Record<string, unknown> {\n  return {\n    subdomain: reg.subdomain,\n    fullDomain: reg.fullDomain,\n    mode: reg.mode,\n    publicIp: reg.publicIp,\n    tunnelProvider: reg.tunnelConfig?.provider,\n    tunnelEndpoint: reg.tunnelConfig?.endpoint,\n    registeredAt: reg.registeredAt.toISOString(),\n    ownerId: reg.ownerId,\n  };\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/VectorHandler.d.ts

@@ -0,0 +1,15 @@
+import type { ApiServer } from '../ApiServer';
+import type { VectorService } from '../service/VectorService';
+export interface VectorHandlerOptions {
+    vectorService: VectorService;
+}
+/**
+ * Handler for Vector API endpoints
+ *
+ * POST /v1/vectors/upsert   - Store vectors
+ * POST /v1/vectors/search   - Search vectors
+ * POST /v1/vectors/delete   - Delete vectors
+ * GET  /v1/vectors/status   - Get index status
+ * POST /v1/embeddings       - Generate embeddings (OpenAI-compatible)
+ */
+export declare function registerVectorRoutes(server: ApiServer, options: VectorHandlerOptions): void;