@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/http/cluster/PodMigrationHttpHandler.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PodMigrationHttpHandler = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const community_server_1 = require("@solid/community-server");
+const community_server_2 = require("@solid/community-server");
+const db_1 = require("../../identity/drizzle/db");
+const PodLookupRepository_1 = require("../../identity/drizzle/PodLookupRepository");
+const EdgeNodeRepository_1 = require("../../identity/drizzle/EdgeNodeRepository");
+const PodMigrationService_1 = require("../../service/PodMigrationService");
+/**
+ * HTTP Handler for Pod migration operations.
+ *
+ * Migration is now instant - it only updates the nodeId in the database.
+ * Binary files are read via cross-region fallback (TieredMinioDataAccessor).
+ *
+ * Endpoints:
+ * - POST /.cluster/pods/{podId}/migrate - Migrate pod to target node (instant)
+ * - GET  /.cluster/pods/{podId} - Get pod info
+ * - GET  /.cluster/pods - List all pods with node info
+ */
+class PodMigrationHttpHandler extends community_server_1.HttpHandler {
+    constructor(options) {
+        super();
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        const db = (0, db_1.getIdentityDatabase)(options.identityDbUrl);
+        this.podLookupRepository = new PodLookupRepository_1.PodLookupRepository(db);
+        this.edgeNodeRepository = new EdgeNodeRepository_1.EdgeNodeRepository(db);
+        this.migrationService = new PodMigrationService_1.PodMigrationService({
+            identityDbUrl: options.identityDbUrl,
+            currentNodeId: options.currentNodeId,
+        });
+        this.basePath = this.normalizeBasePath(options.basePath ?? '/.cluster/pods');
+        this.basePathWithSlash = `${this.basePath}/`;
+        this.enabled = this.normalizeBoolean(options.enabled);
+        this.logger.info(`PodMigrationHttpHandler initialized: basePath=${this.basePath}, enabled=${this.enabled}`);
+    }
+    async canHandle({ request }) {
+        if (!this.enabled) {
+            throw new community_server_2.NotImplementedHttpError('Pod migration API disabled.');
+        }
+        const url = this.parseUrl(request);
+        if (!this.matchesPath(url.pathname)) {
+            throw new community_server_2.NotImplementedHttpError(`Path ${url.pathname} does not match ${this.basePath}`);
+        }
+    }
+    async handle({ request, response }) {
+        const url = this.parseUrl(request);
+        const method = (request.method ?? 'GET').toUpperCase();
+        const relativePath = this.getRelativePath(url.pathname);
+        try {
+            // GET /.cluster/pods - List pods
+            if (relativePath === '' && method === 'GET') {
+                await this.handleListPods(response);
+                return;
+            }
+            // Parse pod ID and action
+            const match = relativePath.match(/^([^/]+)(?:\/(.+))?$/);
+            if (!match) {
+                throw new community_server_2.BadRequestHttpError('Invalid path format. Expected: /pods/{podId} or /pods/{podId}/migrate');
+            }
+            const podId = decodeURIComponent(match[1]);
+            const action = match[2];
+            // GET /.cluster/pods/{podId} - Get pod info
+            if (!action && method === 'GET') {
+                await this.handleGetPod(podId, response);
+                return;
+            }
+            // POST /.cluster/pods/{podId}/migrate - Migrate pod (instant)
+            if (action === 'migrate' && method === 'POST') {
+                const body = await this.parseJsonBody(request);
+                await this.handleMigrate(podId, body, response);
+                return;
+            }
+            throw new community_server_2.NotImplementedHttpError(`${method} ${url.pathname} not implemented`);
+        }
+        catch (error) {
+            if (error instanceof community_server_2.BadRequestHttpError ||
+                error instanceof community_server_2.NotFoundHttpError ||
+                error instanceof community_server_2.NotImplementedHttpError) {
+                throw error;
+            }
+            this.logger.error(`Error handling ${method} ${url.pathname}: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * List all pods with their node assignments.
+     */
+    async handleListPods(response) {
+        const pods = await this.podLookupRepository.listAllPods();
+        this.sendJson(response, 200, {
+            pods: pods.map(pod => ({
+                podId: pod.podId,
+                baseUrl: pod.baseUrl,
+                accountId: pod.accountId,
+                nodeId: pod.nodeId,
+            })),
+        });
+    }
+    /**
+     * Get single pod info.
+     */
+    async handleGetPod(podId, response) {
+        const pod = await this.podLookupRepository.findById(podId);
+        if (!pod) {
+            throw new community_server_2.NotFoundHttpError(`Pod ${podId} not found`);
+        }
+        this.sendJson(response, 200, {
+            podId: pod.podId,
+            baseUrl: pod.baseUrl,
+            accountId: pod.accountId,
+            nodeId: pod.nodeId,
+        });
+    }
+    /**
+     * Migrate pod to target node.
+     * This is instant - only updates nodeId. Binary files use cross-region fallback.
+     */
+    async handleMigrate(podId, body, response) {
+        if (!body.targetNode) {
+            throw new community_server_2.BadRequestHttpError('Missing required field: targetNode');
+        }
+        try {
+            const result = await this.migrationService.migratePod(podId, body.targetNode);
+            this.logger.info(`Pod migrated: pod=${podId}, from=${result.sourceNodeId}, to=${result.targetNodeId}`);
+            this.sendJson(response, 200, {
+                message: 'Migration completed',
+                podId: result.podId,
+                sourceNode: result.sourceNodeId,
+                targetNode: result.targetNodeId,
+                migratedAt: result.migratedAt.toISOString(),
+            });
+        }
+        catch (error) {
+            const message = error.message;
+            if (message.includes('not found')) {
+                throw new community_server_2.NotFoundHttpError(message);
+            }
+            if (message.includes('already on node')) {
+                throw new community_server_2.BadRequestHttpError(message);
+            }
+            throw error;
+        }
+    }
+    // ============ Utility methods ============
+    matchesPath(pathname) {
+        return pathname === this.basePath || pathname.startsWith(this.basePathWithSlash);
+    }
+    getRelativePath(pathname) {
+        if (pathname === this.basePath) {
+            return '';
+        }
+        if (pathname.startsWith(this.basePathWithSlash)) {
+            return pathname.slice(this.basePathWithSlash.length);
+        }
+        return '';
+    }
+    normalizeBasePath(basePath) {
+        let normalized = basePath;
+        if (!normalized.startsWith('/')) {
+            normalized = `/${normalized}`;
+        }
+        if (normalized.endsWith('/')) {
+            normalized = normalized.slice(0, -1);
+        }
+        return normalized;
+    }
+    parseUrl(request) {
+        const hostHeader = request.headers.host ?? 'localhost';
+        return new URL(request.url ?? '/', `http://${hostHeader}`);
+    }
+    async parseJsonBody(request) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            request.on('data', (chunk) => chunks.push(chunk));
+            request.on('end', () => {
+                try {
+                    const body = Buffer.concat(chunks).toString('utf-8');
+                    resolve(body ? JSON.parse(body) : {});
+                }
+                catch (error) {
+                    reject(new community_server_2.BadRequestHttpError('Invalid JSON body'));
+                }
+            });
+            request.on('error', reject);
+        });
+    }
+    sendJson(response, status, data) {
+        const body = JSON.stringify(data);
+        response.statusCode = status;
+        response.setHeader('Content-Type', 'application/json');
+        response.setHeader('Content-Length', Buffer.byteLength(body));
+        response.end(body);
+    }
+    normalizeBoolean(value) {
+        if (typeof value === 'boolean') {
+            return value;
+        }
+        if (typeof value === 'string') {
+            const normalized = value.trim().toLowerCase();
+            return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';
+        }
+        return true; // Enabled by default
+    }
+}
+exports.PodMigrationHttpHandler = PodMigrationHttpHandler;
+//# sourceMappingURL=PodMigrationHttpHandler.js.map

package/dist/http/cluster/PodMigrationHttpHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PodMigrationHttpHandler.js","sourceRoot":"","sources":["../../../src/http/cluster/PodMigrationHttpHandler.ts"],"names":[],"mappings":";;;AACA,iEAAqD;AACrD,8DAAsD;AAEtD,8DAKiC;AACjC,kDAAgE;AAChE,oFAAiF;AACjF,kFAA+E;AAC/E,2EAAwE;AAaxE;;;;;;;;;;GAUG;AACH,MAAa,uBAAwB,SAAQ,8BAAW;IAUtD,YAAmB,OAAuC;QACxD,KAAK,EAAE,CAAC;QAVS,WAAM,GAAG,IAAA,oCAAY,EAAC,IAAI,CAAC,CAAC;QAW7C,MAAM,EAAE,GAAG,IAAA,wBAAmB,EAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACtD,IAAI,CAAC,mBAAmB,GAAG,IAAI,yCAAmB,CAAC,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,kBAAkB,GAAG,IAAI,uCAAkB,CAAC,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,gBAAgB,GAAG,IAAI,yCAAmB,CAAC;YAC9C,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC,CAAC;QAC7E,IAAI,CAAC,iBAAiB,GAAG,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iDAAiD,IAAI,CAAC,QAAQ,aAAa,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9G,CAAC;IAEe,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAoB;QAC3D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,0CAAuB,CAAC,6BAA6B,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,0CAAuB,CAAC,QAAQ,GAAG,CAAC,QAAQ,mBAAmB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IAEe,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAoB;QAClE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAExD,IAAI,CAAC;YACH,iCAAiC;YACjC,IAAI,YAAY,KAAK,EAAE,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBAC5C,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;gBACpC,OAAO;YACT,CAAC;YAED,0BAA0B;YAC1B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACzD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,sCAAmB,CAAC,uEAAuE,CAAC,CAAC;YACzG,CAAC;YAED,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAExB,4CAA4C;YAC5C,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBACzC,OAAO;YACT,CAAC;YAED,8DAA8D;YAC9D,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC9C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC/C,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAChD,OAAO;YACT,CAAC;YAED,MAAM,IAAI,0CAAuB,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC,QAAQ,kBAAkB,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,sCAAmB;gBACpC,KAAK,YAAY,oCAAiB;gBAClC,KAAK,YAAY,0CAAuB,EAAE,CAAC;gBAC7C,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3F,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,QAAsB;QACjD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,WAAW,EAAE,CAAC;QAE1D,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;YAC3B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,QAAsB;QAC9D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC3D,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,oCAAiB,CAAC,OAAO,KAAK,YAAY,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;YAC3B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,aAAa,CACzB,KAAa,EACb,IAAoB,EACpB,QAAsB;QAEtB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,sCAAmB,CAAC,oCAAoC,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAE9E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,KAAK,UAAU,MAAM,CAAC,YAAY,QAAQ,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YAEvG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBAC3B,OAAO,EAAE,qBAAqB;gBAC9B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU,EAAE,MAAM,CAAC,YAAY;gBAC/B,UAAU,EAAE,MAAM,CAAC,YAAY;gBAC/B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE;aAC5C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAI,KAAe,CAAC,OAAO,CAAC;YAEzC,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,oCAAiB,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;YACD,IAAI,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,sCAAmB,CAAC,OAAO,CAAC,CAAC;YACzC,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,4CAA4C;IAEpC,WAAW,CAAC,QAAgB;QAClC,OAAO,QAAQ,KAAK,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACnF,CAAC;IAEO,eAAe,CAAC,QAAgB;QACtC,IAAI,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAChD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,iBAAiB,CAAC,QAAgB;QACxC,IAAI,UAAU,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,QAAQ,CAAC,OAAwB;QACvC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QACvD,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,UAAU,EAAE,CAAC,CAAC;IAC7D,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,OAAwB;QAClD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACrB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;oBACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACxC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,sCAAmB,CAAC,mBAAmB,CAAC,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,QAAQ,CAAC,QAAsB,EAAE,MAAc,EAAE,IAAY;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QACvD,QAAQ,CAAC,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAEO,gBAAgB,CAAC,KAAwB;QAC/C,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC9C,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,IAAI,CAAC;QACpG,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,qBAAqB;IACpC,CAAC;CACF;AA7ND,0DA6NC","sourcesContent":["import type { IncomingMessage } from 'node:http';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { HttpHandler } from '@solid/community-server';\nimport type { HttpHandlerInput, HttpResponse } from '@solid/community-server';\nimport {\n  NotImplementedHttpError,\n  BadRequestHttpError,\n  NotFoundHttpError,\n  \n} from '@solid/community-server';\nimport { getIdentityDatabase } from '../../identity/drizzle/db';\nimport { PodLookupRepository } from '../../identity/drizzle/PodLookupRepository';\nimport { EdgeNodeRepository } from '../../identity/drizzle/EdgeNodeRepository';\nimport { PodMigrationService } from '../../service/PodMigrationService';\n\ninterface PodMigrationHttpHandlerOptions {\n  identityDbUrl: string;\n  currentNodeId: string;\n  basePath?: string;\n  enabled?: boolean | string;\n}\n\ninterface MigrateRequest {\n  targetNode: string;\n}\n\n/**\n * HTTP Handler for Pod migration operations.\n * \n * Migration is now instant - it only updates the nodeId in the database.\n * Binary files are read via cross-region fallback (TieredMinioDataAccessor).\n * \n * Endpoints:\n * - POST /.cluster/pods/{podId}/migrate - Migrate pod to target node (instant)\n * - GET  /.cluster/pods/{podId} - Get pod info\n * - GET  /.cluster/pods - List all pods with node info\n */\nexport class PodMigrationHttpHandler extends HttpHandler {\n  protected readonly logger = getLoggerFor(this);\n  \n  private readonly podLookupRepository: PodLookupRepository;\n  private readonly edgeNodeRepository: EdgeNodeRepository;\n  private readonly migrationService: PodMigrationService;\n  private readonly basePath: string;\n  private readonly basePathWithSlash: string;\n  private readonly enabled: boolean;\n\n  public constructor(options: PodMigrationHttpHandlerOptions) {\n    super();\n    const db = getIdentityDatabase(options.identityDbUrl);\n    this.podLookupRepository = new PodLookupRepository(db);\n    this.edgeNodeRepository = new EdgeNodeRepository(db);\n    this.migrationService = new PodMigrationService({\n      identityDbUrl: options.identityDbUrl,\n      currentNodeId: options.currentNodeId,\n    });\n    this.basePath = this.normalizeBasePath(options.basePath ?? '/.cluster/pods');\n    this.basePathWithSlash = `${this.basePath}/`;\n    this.enabled = this.normalizeBoolean(options.enabled);\n\n    this.logger.info(`PodMigrationHttpHandler initialized: basePath=${this.basePath}, enabled=${this.enabled}`);\n  }\n\n  public override async canHandle({ request }: HttpHandlerInput): Promise<void> {\n    if (!this.enabled) {\n      throw new NotImplementedHttpError('Pod migration API disabled.');\n    }\n\n    const url = this.parseUrl(request);\n    if (!this.matchesPath(url.pathname)) {\n      throw new NotImplementedHttpError(`Path ${url.pathname} does not match ${this.basePath}`);\n    }\n  }\n\n  public override async handle({ request, response }: HttpHandlerInput): Promise<void> {\n    const url = this.parseUrl(request);\n    const method = (request.method ?? 'GET').toUpperCase();\n    const relativePath = this.getRelativePath(url.pathname);\n\n    try {\n      // GET /.cluster/pods - List pods\n      if (relativePath === '' && method === 'GET') {\n        await this.handleListPods(response);\n        return;\n      }\n\n      // Parse pod ID and action\n      const match = relativePath.match(/^([^/]+)(?:\\/(.+))?$/);\n      if (!match) {\n        throw new BadRequestHttpError('Invalid path format. Expected: /pods/{podId} or /pods/{podId}/migrate');\n      }\n\n      const podId = decodeURIComponent(match[1]);\n      const action = match[2];\n\n      // GET /.cluster/pods/{podId} - Get pod info\n      if (!action && method === 'GET') {\n        await this.handleGetPod(podId, response);\n        return;\n      }\n\n      // POST /.cluster/pods/{podId}/migrate - Migrate pod (instant)\n      if (action === 'migrate' && method === 'POST') {\n        const body = await this.parseJsonBody(request);\n        await this.handleMigrate(podId, body, response);\n        return;\n      }\n\n      throw new NotImplementedHttpError(`${method} ${url.pathname} not implemented`);\n    } catch (error: unknown) {\n      if (error instanceof BadRequestHttpError || \n          error instanceof NotFoundHttpError ||\n          error instanceof NotImplementedHttpError) {\n        throw error;\n      }\n      this.logger.error(`Error handling ${method} ${url.pathname}: ${(error as Error).message}`);\n      throw error;\n    }\n  }\n\n  /**\n   * List all pods with their node assignments.\n   */\n  private async handleListPods(response: HttpResponse): Promise<void> {\n    const pods = await this.podLookupRepository.listAllPods();\n    \n    this.sendJson(response, 200, {\n      pods: pods.map(pod => ({\n        podId: pod.podId,\n        baseUrl: pod.baseUrl,\n        accountId: pod.accountId,\n        nodeId: pod.nodeId,\n      })),\n    });\n  }\n\n  /**\n   * Get single pod info.\n   */\n  private async handleGetPod(podId: string, response: HttpResponse): Promise<void> {\n    const pod = await this.podLookupRepository.findById(podId);\n    if (!pod) {\n      throw new NotFoundHttpError(`Pod ${podId} not found`);\n    }\n\n    this.sendJson(response, 200, {\n      podId: pod.podId,\n      baseUrl: pod.baseUrl,\n      accountId: pod.accountId,\n      nodeId: pod.nodeId,\n    });\n  }\n\n  /**\n   * Migrate pod to target node.\n   * This is instant - only updates nodeId. Binary files use cross-region fallback.\n   */\n  private async handleMigrate(\n    podId: string,\n    body: MigrateRequest,\n    response: HttpResponse,\n  ): Promise<void> {\n    if (!body.targetNode) {\n      throw new BadRequestHttpError('Missing required field: targetNode');\n    }\n\n    try {\n      const result = await this.migrationService.migratePod(podId, body.targetNode);\n\n      this.logger.info(`Pod migrated: pod=${podId}, from=${result.sourceNodeId}, to=${result.targetNodeId}`);\n\n      this.sendJson(response, 200, {\n        message: 'Migration completed',\n        podId: result.podId,\n        sourceNode: result.sourceNodeId,\n        targetNode: result.targetNodeId,\n        migratedAt: result.migratedAt.toISOString(),\n      });\n    } catch (error) {\n      const message = (error as Error).message;\n      \n      if (message.includes('not found')) {\n        throw new NotFoundHttpError(message);\n      }\n      if (message.includes('already on node')) {\n        throw new BadRequestHttpError(message);\n      }\n      \n      throw error;\n    }\n  }\n\n  // ============ Utility methods ============\n\n  private matchesPath(pathname: string): boolean {\n    return pathname === this.basePath || pathname.startsWith(this.basePathWithSlash);\n  }\n\n  private getRelativePath(pathname: string): string {\n    if (pathname === this.basePath) {\n      return '';\n    }\n    if (pathname.startsWith(this.basePathWithSlash)) {\n      return pathname.slice(this.basePathWithSlash.length);\n    }\n    return '';\n  }\n\n  private normalizeBasePath(basePath: string): string {\n    let normalized = basePath;\n    if (!normalized.startsWith('/')) {\n      normalized = `/${normalized}`;\n    }\n    if (normalized.endsWith('/')) {\n      normalized = normalized.slice(0, -1);\n    }\n    return normalized;\n  }\n\n  private parseUrl(request: IncomingMessage): URL {\n    const hostHeader = request.headers.host ?? 'localhost';\n    return new URL(request.url ?? '/', `http://${hostHeader}`);\n  }\n\n  private async parseJsonBody(request: IncomingMessage): Promise<any> {\n    return new Promise((resolve, reject) => {\n      const chunks: Buffer[] = [];\n      request.on('data', (chunk: Buffer) => chunks.push(chunk));\n      request.on('end', () => {\n        try {\n          const body = Buffer.concat(chunks).toString('utf-8');\n          resolve(body ? JSON.parse(body) : {});\n        } catch (error) {\n          reject(new BadRequestHttpError('Invalid JSON body'));\n        }\n      });\n      request.on('error', reject);\n    });\n  }\n\n  private sendJson(response: HttpResponse, status: number, data: object): void {\n    const body = JSON.stringify(data);\n    response.statusCode = status;\n    response.setHeader('Content-Type', 'application/json');\n    response.setHeader('Content-Length', Buffer.byteLength(body));\n    response.end(body);\n  }\n\n  private normalizeBoolean(value?: string | boolean): boolean {\n    if (typeof value === 'boolean') {\n      return value;\n    }\n    if (typeof value === 'string') {\n      const normalized = value.trim().toLowerCase();\n      return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';\n    }\n    return true; // Enabled by default\n  }\n}\n"]}

package/dist/http/cluster/PodMigrationHttpHandler.jsonld

@@ -0,0 +1,169 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^8.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler",
+      "@type": "Class",
+      "requireElement": "PodMigrationHttpHandler",
+      "extends": [
+        "css:dist/server/HttpHandler.jsonld#HttpHandler"
+      ],
+      "comment": "HTTP Handler for Pod migration operations.  Migration is now instant - it only updates the nodeId in the database. Binary files are read via cross-region fallback (TieredMinioDataAccessor).  Endpoints: - POST /.cluster/pods/{podId}/migrate - Migrate pod to target node (instant) - GET  /.cluster/pods/{podId} - Get pod info - GET  /.cluster/pods - List all pods with node info",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler_options_identityDbUrl",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler_options_currentNodeId",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler_options_basePath",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler_options_enabled",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_podLookupRepository",
+          "memberFieldName": "podLookupRepository"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_edgeNodeRepository",
+          "memberFieldName": "edgeNodeRepository"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_migrationService",
+          "memberFieldName": "migrationService"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_basePath",
+          "memberFieldName": "basePath"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_basePathWithSlash",
+          "memberFieldName": "basePathWithSlash"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_enabled",
+          "memberFieldName": "enabled"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_canHandle",
+          "memberFieldName": "canHandle"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_handle",
+          "memberFieldName": "handle"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_handleListPods",
+          "memberFieldName": "handleListPods"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_handleGetPod",
+          "memberFieldName": "handleGetPod"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_handleMigrate",
+          "memberFieldName": "handleMigrate"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_matchesPath",
+          "memberFieldName": "matchesPath"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_getRelativePath",
+          "memberFieldName": "getRelativePath"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_normalizeBasePath",
+          "memberFieldName": "normalizeBasePath"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_parseUrl",
+          "memberFieldName": "parseUrl"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_parseJsonBody",
+          "memberFieldName": "parseJsonBody"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_sendJson",
+          "memberFieldName": "sendJson"
+        },
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler__member_normalizeBoolean",
+          "memberFieldName": "normalizeBoolean"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "identityDbUrl",
+              "value": {
+                "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler_options_identityDbUrl"
+              }
+            },
+            {
+              "keyRaw": "currentNodeId",
+              "value": {
+                "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler_options_currentNodeId"
+              }
+            },
+            {
+              "keyRaw": "basePath",
+              "value": {
+                "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler_options_basePath"
+              }
+            },
+            {
+              "keyRaw": "enabled",
+              "value": {
+                "@id": "undefineds:dist/http/cluster/PodMigrationHttpHandler.jsonld#PodMigrationHttpHandler_options_enabled"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/http/quota/QuotaAdminHttpHandler.d.ts

@@ -0,0 +1,34 @@
+import { HttpHandler } from '@solid/community-server';
+import type { HttpHandlerInput } from '@solid/community-server';
+import { AccountRoleRepository } from '../../identity/drizzle/AccountRoleRepository';
+import type { QuotaService } from '../../quota/QuotaService';
+interface QuotaAdminHttpHandlerOptions {
+    identityDbUrl: string;
+    basePath?: string;
+    roleRepository?: AccountRoleRepository;
+    quotaService: QuotaService;
+}
+export declare class QuotaAdminHttpHandler extends HttpHandler {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly verify;
+    private readonly accountRepo;
+    private readonly roleRepo;
+    private readonly quotaService;
+    private readonly basePath;
+    constructor(options: QuotaAdminHttpHandlerOptions);
+    canHandle({ request }: HttpHandlerInput): Promise<void>;
+    handle({ request, response }: HttpHandlerInput): Promise<void>;
+    private handleGet;
+    private handlePut;
+    private handleDelete;
+    private authenticateAdmin;
+    private parseTarget;
+    private readJson;
+    private extractQuota;
+    private writeOptions;
+    private writeJson;
+    private readBody;
+    private getUrl;
+    private extractWebId;
+}
+export {};