@trebired/git-host 2.1.0 → 3.0.0

package/dist/api/socket/linguist_connection.js

@@ -0,0 +1,167 @@
+import { text } from "../../utils/text.js";
+import { authorizationAllowed, serializeError, statusForError } from "../handler/response.js";
+import { LINGUIST_DONE_EVENT, LINGUIST_ERROR_EVENT, LINGUIST_PROGRESS_EVENT, LINGUIST_RESULT_EVENT, } from "./events.js";
+function emitMissingRepositoryKey(socket) {
+    socket.emit(LINGUIST_ERROR_EVENT, {
+        error: {
+            code: "repository_not_found",
+            message: "Repository key is required.",
+        },
+        status: 404,
+    });
+    socket.emit(LINGUIST_DONE_EVENT, { ok: false });
+    socket.disconnect();
+}
+function emitMissingRepositoryId(socket, repositoryKey) {
+    socket.emit(LINGUIST_ERROR_EVENT, {
+        error: {
+            code: "repository_not_found",
+            message: "Repository not found.",
+        },
+        status: 404,
+    });
+    socket.emit(LINGUIST_DONE_EVENT, { ok: false, repository_key: repositoryKey });
+    socket.disconnect();
+}
+function emitDeniedSocket(socket, repositoryId, repositoryKey, status, message) {
+    socket.emit(LINGUIST_ERROR_EVENT, {
+        error: {
+            code: "permission_denied",
+            message,
+        },
+        status,
+    });
+    socket.emit(LINGUIST_DONE_EVENT, {
+        ok: false,
+        repository_id: repositoryId,
+        repository_key: repositoryKey,
+    });
+    socket.disconnect();
+}
+async function authorizeLinguistSocket(options, socket, pathname, repositoryId, repositoryKey, ref) {
+    const searchParams = new URLSearchParams();
+    if (ref)
+        searchParams.set("ref", ref);
+    return authorizationAllowed(options.authorize
+        ? await options.authorize({
+            action: "linguist_socket",
+            method: "SOCKET",
+            pathname,
+            remoteAddress: text(socket.handshake.address),
+            repositoryId,
+            repositoryKey,
+            request: socket.request,
+            searchParams,
+        })
+        : undefined);
+}
+function logDeniedSocket(logger, logGroup, pathname, repositoryId, repositoryKey, status) {
+    logger.warn(logGroup, "api socket permission denied", {
+        action: "linguist_socket",
+        pathname,
+        repositoryId,
+        repositoryKey,
+        status,
+    });
+}
+function emitLinguistResult(socket, repositoryId, repositoryKey, data) {
+    socket.emit(LINGUIST_RESULT_EVENT, {
+        action: "linguist",
+        data,
+        repository_id: repositoryId,
+        repository_key: repositoryKey,
+    });
+    socket.emit(LINGUIST_DONE_EVENT, {
+        ok: true,
+        repository_id: repositoryId,
+        repository_key: repositoryKey,
+    });
+}
+function logCompletedSocket(logger, logGroup, repositoryId, repositoryKey, socketId) {
+    logger.info(logGroup, "api linguist socket completed", {
+        repositoryId,
+        repositoryKey,
+        socketId,
+    });
+}
+function logFailedSocket(logger, logGroup, repositoryId, repositoryKey, socketId, error) {
+    logger.error(logGroup, "api linguist socket failed", {
+        error: error instanceof Error ? error.message : String(error),
+        repositoryId,
+        repositoryKey,
+        socketId,
+    });
+}
+function emitFailedSocket(socket, repositoryId, repositoryKey, error) {
+    socket.emit(LINGUIST_ERROR_EVENT, {
+        ...serializeError(error),
+        ok: false,
+        repository_id: repositoryId,
+        repository_key: repositoryKey,
+        status: statusForError(error),
+    });
+    socket.emit(LINGUIST_DONE_EVENT, {
+        ok: false,
+        repository_id: repositoryId,
+        repository_key: repositoryKey,
+    });
+}
+async function resolveLinguistContext(options, socket, basePath, payload) {
+    const repositoryKey = text(payload?.repositoryKey);
+    const ref = text(payload?.ref);
+    if (!repositoryKey)
+        return null;
+    const repositoryId = text(options.resolveRepositoryId
+        ? await options.resolveRepositoryId(repositoryKey, socket.request)
+        : repositoryKey);
+    return {
+        pathname: `${basePath.replace(/\/+$/g, "") || ""}/repositories/${encodeURIComponent(repositoryKey)}/linguist/socket`,
+        ref,
+        repositoryId,
+        repositoryKey,
+    };
+}
+async function runLinguistSocket(options, socket, context, verbose, logger, logGroup) {
+    const auth = await authorizeLinguistSocket(options, socket, context.pathname, context.repositoryId, context.repositoryKey, context.ref);
+    if (!auth.allowed) {
+        const status = auth.status || 403;
+        logDeniedSocket(logger, logGroup, context.pathname, context.repositoryId, context.repositoryKey, status);
+        emitDeniedSocket(socket, context.repositoryId, context.repositoryKey, status, auth.message || "Permission denied.");
+        return;
+    }
+    try {
+        const data = await options.gitHost.readLinguist(context.repositoryId, {
+            onProgress(progressEvent) {
+                socket.emit(LINGUIST_PROGRESS_EVENT, progressEvent);
+            },
+            ref: context.ref,
+        });
+        emitLinguistResult(socket, context.repositoryId, context.repositoryKey, data);
+        if (verbose) {
+            logCompletedSocket(logger, logGroup, context.repositoryId, context.repositoryKey, socket.id);
+        }
+    }
+    catch (error) {
+        logFailedSocket(logger, logGroup, context.repositoryId, context.repositoryKey, socket.id, error);
+        emitFailedSocket(socket, context.repositoryId, context.repositoryKey, error);
+    }
+    finally {
+        socket.disconnect();
+    }
+}
+function createLinguistConnectionHandler(options, logger, logGroup, basePath, verbose) {
+    return async function handleLinguistSocket(socket, payload) {
+        const context = await resolveLinguistContext(options, socket, basePath, payload);
+        if (!context) {
+            emitMissingRepositoryKey(socket);
+            return;
+        }
+        if (!context.repositoryId) {
+            emitMissingRepositoryId(socket, context.repositoryKey);
+            return;
+        }
+        await runLinguistSocket(options, socket, context, verbose, logger, logGroup);
+    };
+}
+export { createLinguistConnectionHandler };
+//# sourceMappingURL=linguist_connection.js.map

package/dist/api/socket/linguist_connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linguist_connection.js","sourceRoot":"","sources":["../../../src/api/socket/linguist_connection.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGrF,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,SAAS,wBAAwB,CAAC,MAAc;IAC9C,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;QAChC,KAAK,EAAE;YACL,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,6BAA6B;SACvC;QACD,MAAM,EAAE,GAAG;KACZ,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,MAAM,CAAC,UAAU,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc,EAAE,aAAqB;IACpE,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;QAChC,KAAK,EAAE;YACL,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,uBAAuB;SACjC;QACD,MAAM,EAAE,GAAG;KACZ,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;IAC/E,MAAM,CAAC,UAAU,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAc,EACd,YAAoB,EACpB,aAAqB,EACrB,MAAc,EACd,OAAe;IAEf,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;QAChC,KAAK,EAAE;YACL,IAAI,EAAE,mBAAmB;YACzB,OAAO;SACR;QACD,MAAM;KACP,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;QAC/B,EAAE,EAAE,KAAK;QACT,aAAa,EAAE,YAAY;QAC3B,cAAc,EAAE,aAAa;KAC9B,CAAC,CAAC;IACH,MAAM,CAAC,UAAU,EAAE,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,OAAwC,EACxC,MAAc,EACd,QAAgB,EAChB,YAAoB,EACpB,aAAqB,EACrB,GAAW;IAEX,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;IAC3C,IAAI,GAAG;QAAE,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,OAAO,oBAAoB,CAAC,OAAO,CAAC,SAAS;QAC3C,CAAC,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC;YACxB,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,QAAQ;YAChB,QAAQ;YACR,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;YAC7C,YAAY;YACZ,aAAa;YACb,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY;SACb,CAAC;QACF,CAAC,CAAC,SAAS,CAAC,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CACtB,MAA+B,EAC/B,QAAgB,EAChB,QAAgB,EAChB,YAAoB,EACpB,aAAqB,EACrB,MAAc;IAEd,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,8BAA8B,EAAE;QACpD,MAAM,EAAE,iBAAiB;QACzB,QAAQ;QACR,YAAY;QACZ,aAAa;QACb,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAc,EAAE,YAAoB,EAAE,aAAqB,EAAE,IAAa;IACpG,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE;QACjC,MAAM,EAAE,UAAU;QAClB,IAAI;QACJ,aAAa,EAAE,YAAY;QAC3B,cAAc,EAAE,aAAa;KAC9B,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;QAC/B,EAAE,EAAE,IAAI;QACR,aAAa,EAAE,YAAY;QAC3B,cAAc,EAAE,aAAa;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CACzB,MAA+B,EAC/B,QAAgB,EAChB,YAAoB,EACpB,aAAqB,EACrB,QAAgB;IAEhB,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,+BAA+B,EAAE;QACrD,YAAY;QACZ,aAAa;QACb,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,MAA+B,EAC/B,QAAgB,EAChB,YAAoB,EACpB,aAAqB,EACrB,QAAgB,EAChB,KAAc;IAEd,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,4BAA4B,EAAE;QACnD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC7D,YAAY;QACZ,aAAa;QACb,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc,EAAE,YAAoB,EAAE,aAAqB,EAAE,KAAc;IACnG,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;QAChC,GAAG,cAAc,CAAC,KAAK,CAAC;QACxB,EAAE,EAAE,KAAK;QACT,aAAa,EAAE,YAAY;QAC3B,cAAc,EAAE,aAAa;QAC7B,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC;KAC9B,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;QAC/B,EAAE,EAAE,KAAK;QACT,aAAa,EAAE,YAAY;QAC3B,cAAc,EAAE,aAAa;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,OAAwC,EACxC,MAAc,EACd,QAAgB,EAChB,OAAkD;IAElD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB;QACnD,CAAC,CAAC,MAAM,OAAO,CAAC,mBAAmB,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC;QAClE,CAAC,CAAC,aAAa,CAAC,CAAC;IACnB,OAAO;QACL,QAAQ,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,iBAAiB,kBAAkB,CAAC,aAAa,CAAC,kBAAkB;QACpH,GAAG;QACH,YAAY;QACZ,aAAa;KACd,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,OAAwC,EACxC,MAAc,EACd,OAKC,EACD,OAAgB,EAChB,MAA+B,EAC/B,QAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,uBAAuB,CACxC,OAAO,EACP,MAAM,EACN,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,aAAa,EACrB,OAAO,CAAC,GAAG,CACZ,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;QAClC,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACzG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,IAAI,oBAAoB,CAAC,CAAC;QACpH,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE;YACpE,UAAU,CAAC,aAAuC;gBAChD,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC;YACtD,CAAC;YACD,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QACH,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC9E,IAAI,OAAO,EAAE,CAAC;YACZ,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACjG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAC/E,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAED,SAAS,+BAA+B,CACtC,OAAwC,EACxC,MAA+B,EAC/B,QAAgB,EAChB,QAAgB,EAChB,OAAgB;IAEhB,OAAO,KAAK,UAAU,oBAAoB,CACxC,MAAc,EACd,OAAkD;QAElD,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,wBAAwB,CAAC,MAAM,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC1B,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QACD,MAAM,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAoD,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5H,CAAC,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,+BAA+B,EAAE,CAAC"}

package/dist/api/socket/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/api/socket/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AAIrD,OAAO,KAAK,EACV,+BAA+B,EAEhC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAcrB,iBAAS,wBAAwB,CAAC,OAAO,EAAE,+BAA+B,yIAuJzE;AAED,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/api/socket/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AAIrD,OAAO,KAAK,EACV,+BAA+B,EAChC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAcrB,iBAAS,wBAAwB,CAAC,OAAO,EAAE,+BAA+B,yIAiCzE;AAED,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,CAAC"}

package/dist/api/socket/server.js

@@ -3,7 +3,7 @@ import { logPackageInitialized } from "@trebired/logger-adapter";
 import { resolveLogger } from "../../logging.js";
 import { text } from "../../utils/text.js";
 import { LINGUIST_DONE_EVENT, LINGUIST_ERROR_EVENT, LINGUIST_PROGRESS_EVENT, LINGUIST_RESULT_EVENT, LINGUIST_START_EVENT, } from "./events.js";
-import { authorizationAllowed, serializeError, statusForError } from "../handler/response.js";
+import { createLinguistConnectionHandler } from "./linguist_connection.js";
 function normalizeSocketPath(basePathInput, socketPathInput) {
     const socketPath = text(socketPathInput).replace(/\/+$/g, "");
     if (socketPath) {
@@ -37,125 +37,10 @@ function createGitApiSocketServer(options) {
         ...(options.socketOptions || {}),
         path,
     });
+    const handleLinguistSocket = createLinguistConnectionHandler(options, logger, logGroup, basePath, verbose);
     io.on("connection", (socket) => {
-        socket.on(LINGUIST_START_EVENT, async (payload) => {
-            const repositoryKey = text(payload && payload.repositoryKey);
-            const ref = text(payload && payload.ref);
-            const pathname = `${basePath.replace(/\/+$/g, "") || ""}/repositories/${encodeURIComponent(repositoryKey)}/linguist/socket`;
-            if (!repositoryKey) {
-                socket.emit(LINGUIST_ERROR_EVENT, {
-                    error: {
-                        code: "repository_not_found",
-                        message: "Repository key is required.",
-                    },
-                    status: 404,
-                });
-                socket.emit(LINGUIST_DONE_EVENT, { ok: false });
-                socket.disconnect();
-                return;
-            }
-            const repositoryId = text(options.resolveRepositoryId
-                ? await options.resolveRepositoryId(repositoryKey, socket.request)
-                : repositoryKey);
-            if (!repositoryId) {
-                socket.emit(LINGUIST_ERROR_EVENT, {
-                    error: {
-                        code: "repository_not_found",
-                        message: "Repository not found.",
-                    },
-                    status: 404,
-                });
-                socket.emit(LINGUIST_DONE_EVENT, { ok: false, repository_key: repositoryKey });
-                socket.disconnect();
-                return;
-            }
-            const searchParams = new URLSearchParams();
-            if (ref)
-                searchParams.set("ref", ref);
-            const auth = authorizationAllowed(options.authorize
-                ? await options.authorize({
-                    action: "linguist_socket",
-                    method: "SOCKET",
-                    pathname,
-                    remoteAddress: text(socket.handshake.address),
-                    repositoryId,
-                    repositoryKey,
-                    request: socket.request,
-                    searchParams,
-                })
-                : undefined);
-            if (!auth.allowed) {
-                logger.warn(logGroup, "api socket permission denied", {
-                    action: "linguist_socket",
-                    pathname,
-                    repositoryId,
-                    repositoryKey,
-                    status: auth.status || 403,
-                });
-                socket.emit(LINGUIST_ERROR_EVENT, {
-                    error: {
-                        code: "permission_denied",
-                        message: auth.message || "Permission denied.",
-                    },
-                    status: auth.status || 403,
-                });
-                socket.emit(LINGUIST_DONE_EVENT, {
-                    ok: false,
-                    repository_id: repositoryId,
-                    repository_key: repositoryKey,
-                });
-                socket.disconnect();
-                return;
-            }
-            try {
-                const data = await options.gitHost.readLinguist(repositoryId, {
-                    onProgress(progressEvent) {
-                        socket.emit(LINGUIST_PROGRESS_EVENT, progressEvent);
-                    },
-                    ref,
-                });
-                socket.emit(LINGUIST_RESULT_EVENT, {
-                    action: "linguist",
-                    data,
-                    repository_id: repositoryId,
-                    repository_key: repositoryKey,
-                });
-                socket.emit(LINGUIST_DONE_EVENT, {
-                    ok: true,
-                    repository_id: repositoryId,
-                    repository_key: repositoryKey,
-                });
-                if (verbose) {
-                    logger.info(logGroup, "api linguist socket completed", {
-                        repositoryId,
-                        repositoryKey,
-                        socketId: socket.id,
-                    });
-                }
-            }
-            catch (error) {
-                logger.error(logGroup, "api linguist socket failed", {
-                    error: error instanceof Error ? error.message : String(error),
-                    repositoryId,
-                    repositoryKey,
-                    socketId: socket.id,
-                });
-                socket.emit(LINGUIST_ERROR_EVENT, {
-                    ...serializeError(error),
-                    ok: false,
-                    repository_id: repositoryId,
-                    repository_key: repositoryKey,
-                    status: statusForError(error),
-                });
-                socket.emit(LINGUIST_DONE_EVENT, {
-                    ok: false,
-                    repository_id: repositoryId,
-                    repository_key: repositoryKey,
-                });
-            }
-            finally {
-                socket.disconnect();
-            }
+        socket.on(LINGUIST_START_EVENT, (payload) => {
+            void handleLinguistSocket(socket, payload);
         });
     });
     return io;

package/dist/api/socket/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/api/socket/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/api/socket/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI9C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAE3E,SAAS,mBAAmB,CAAC,aAAsB,EAAE,eAAwB;IAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9D,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,GAAG;QAAE,OAAO,YAAY,CAAC;IACvD,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,YAAY,CAAC;AAC7E,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAwC;IACxE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,IAAI,SAAS,CAAC,yDAAyD,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,qBAAqB,CAAC;IACvC,qBAAqB,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC,aAAa;QAC9B,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,oBAAoB;KAC7B,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,MAAM,EAAE,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE;QAChD,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAChC,IAAI;KACL,CAAC,CAAC;IACH,MAAM,oBAAoB,GAAG,+BAA+B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE3G,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;QAC7B,MAAM,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,OAAkD,EAAE,EAAE;YACrF,KAAK,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,CAAC"}

package/dist/core/actions/artifacts.d.ts

@@ -0,0 +1,21 @@
+import type { GitForgeWorkflowRunArtifact } from "../../types.js";
+type StoredArtifact = {
+    fileCount: number;
+    path: string;
+    size: number;
+};
+declare function artifactStoragePath(artifactsRoot: string, artifactName: string): string;
+declare function uploadArtifact(input: {
+    artifactName: string;
+    artifactsRoot: string;
+    pathSpec: string;
+    workspacePath: string;
+}): StoredArtifact;
+declare function downloadArtifact(input: {
+    artifact: GitForgeWorkflowRunArtifact;
+    artifactsRoot: string;
+    destinationPath: string;
+    workspacePath: string;
+}): void;
+export { artifactStoragePath, downloadArtifact, uploadArtifact, };
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/core/actions/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/core/actions/artifacts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAGjE,KAAK,cAAc,GAAG;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AA6EF,iBAAS,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAEvE;AAED,iBAAS,cAAc,CAAC,KAAK,EAAE;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,cAAc,CAyBjB;AAED,iBAAS,gBAAgB,CAAC,KAAK,EAAE;IAC/B,QAAQ,EAAE,2BAA2B,CAAC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB,QAWA;AAED,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,GACf,CAAC"}

package/dist/core/actions/artifacts.js

@@ -0,0 +1,121 @@
+import fs from "node:fs";
+import path from "node:path";
+import { GitHostError } from "../../errors.js";
+import { text } from "../../utils/text.js";
+function ensureDirectory(directory) {
+    fs.mkdirSync(directory, { recursive: true });
+}
+function walkFiles(root) {
+    if (!fs.existsSync(root))
+        return [];
+    const stat = fs.statSync(root);
+    if (stat.isFile())
+        return [root];
+    const results = [];
+    const stack = [root];
+    while (stack.length) {
+        const current = stack.pop();
+        if (!current)
+            continue;
+        for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+            const absolutePath = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(absolutePath);
+                continue;
+            }
+            if (entry.isFile())
+                results.push(absolutePath);
+        }
+    }
+    return results;
+}
+function toMatcher(pattern) {
+    const escaped = pattern
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        .replace(/\*\*/g, ".*")
+        .replace(/\*/g, "[^/]*")
+        .replace(/\?/g, ".");
+    return new RegExp(`^${escaped}$`);
+}
+function expandArtifactPathSpec(workspacePath, spec) {
+    const normalizedSpec = text(spec).replace(/\\/g, "/");
+    if (!normalizedSpec)
+        return [];
+    const absolute = path.resolve(workspacePath, normalizedSpec);
+    if (!normalizedSpec.includes("*") && !normalizedSpec.includes("?")) {
+        return fs.existsSync(absolute) ? [absolute] : [];
+    }
+    const matcher = toMatcher(normalizedSpec);
+    const candidates = walkFiles(workspacePath)
+        .map((entry) => ({
+        absolutePath: entry,
+        relativePath: path.relative(workspacePath, entry).replace(/\\/g, "/"),
+    }));
+    return candidates
+        .filter((entry) => matcher.test(entry.relativePath))
+        .map((entry) => entry.absolutePath);
+}
+function parseArtifactPathSpecs(input) {
+    return text(input)
+        .split(/\r?\n|,/)
+        .map((entry) => text(entry).trim())
+        .filter(Boolean);
+}
+function directorySize(root) {
+    return walkFiles(root)
+        .map((entry) => fs.statSync(entry).size)
+        .reduce((total, value) => total + value, 0);
+}
+function copyArtifactEntry(sourcePath, destinationPath) {
+    const stat = fs.statSync(sourcePath);
+    if (stat.isDirectory()) {
+        fs.cpSync(sourcePath, destinationPath, { recursive: true });
+        return;
+    }
+    ensureDirectory(path.dirname(destinationPath));
+    fs.copyFileSync(sourcePath, destinationPath);
+}
+function artifactStoragePath(artifactsRoot, artifactName) {
+    return path.join(artifactsRoot, encodeURIComponent(artifactName));
+}
+function uploadArtifact(input) {
+    const specs = parseArtifactPathSpecs(input.pathSpec);
+    const matches = Array.from(new Set(specs.flatMap((spec) => expandArtifactPathSpec(input.workspacePath, spec))));
+    if (!matches.length) {
+        throw new GitHostError("forge_actions_runner_failed", `Artifact "${input.artifactName}" did not match any files.`, {
+            artifactName: input.artifactName,
+            pathSpec: input.pathSpec,
+        });
+    }
+    const destinationRoot = artifactStoragePath(input.artifactsRoot, input.artifactName);
+    fs.rmSync(destinationRoot, { force: true, recursive: true });
+    ensureDirectory(destinationRoot);
+    const copied = new Set();
+    for (const match of matches) {
+        const relativePath = path.relative(input.workspacePath, match);
+        const nextDestination = path.join(destinationRoot, relativePath);
+        if (copied.has(nextDestination))
+            continue;
+        copied.add(nextDestination);
+        copyArtifactEntry(match, nextDestination);
+    }
+    return {
+        fileCount: walkFiles(destinationRoot).length,
+        path: destinationRoot,
+        size: directorySize(destinationRoot),
+    };
+}
+function downloadArtifact(input) {
+    const sourceRoot = input.artifact.path || artifactStoragePath(input.artifactsRoot, input.artifact.name);
+    if (!fs.existsSync(sourceRoot)) {
+        throw new GitHostError("forge_actions_runner_failed", `Artifact "${input.artifact.name}" is missing from storage.`, {
+            artifactId: input.artifact.id,
+            artifactName: input.artifact.name,
+        });
+    }
+    const destination = path.resolve(input.workspacePath, text(input.destinationPath, "."));
+    ensureDirectory(destination);
+    fs.cpSync(sourceRoot, destination, { force: true, recursive: true });
+}
+export { artifactStoragePath, downloadArtifact, uploadArtifact, };
+//# sourceMappingURL=artifacts.js.map

package/dist/core/actions/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../../src/core/actions/artifacts.ts"],"names":[],"mappings":"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"}

package/dist/core/actions/environment.d.ts

@@ -0,0 +1,9 @@
+import type { GitForgeActionsEnvironmentOptions, GitForgeLocalRunnerOptions } from "../../types.js";
+declare function defaultPassthroughKeys(): string[];
+declare function buildStepBaseEnv(policy: GitForgeActionsEnvironmentOptions | undefined): Record<string, string>;
+declare function runnerNeedsPrivilegeWarning(input: {
+    localRunner: GitForgeLocalRunnerOptions | undefined;
+    uid: number | null;
+}): boolean;
+export { buildStepBaseEnv, defaultPassthroughKeys, runnerNeedsPrivilegeWarning, };
+//# sourceMappingURL=environment.d.ts.map

package/dist/core/actions/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/core/actions/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iCAAiC,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAwBnG,iBAAS,sBAAsB,aAE9B;AAiBD,iBAAS,gBAAgB,CAAC,MAAM,EAAE,iCAAiC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAavG;AAID,iBAAS,2BAA2B,CAAC,KAAK,EAAE;IAC1C,WAAW,EAAE,0BAA0B,GAAG,SAAS,CAAC;IACpD,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB,WAMA;AAED,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,GAC5B,CAAC"}

package/dist/core/actions/environment.js

@@ -0,0 +1,64 @@
+// Minimal set of variables that generic tooling (shells, git, common CLIs) needs
+// to function. Everything else is opt-in so host process secrets never leak into
+// workflow steps by default.
+const POSIX_PASSTHROUGH = ["PATH", "HOME", "LANG", "LC_ALL", "TZ", "TERM"];
+const WINDOWS_PASSTHROUGH = [
+    "PATH",
+    "Path",
+    "PATHEXT",
+    "SystemRoot",
+    "SystemDrive",
+    "HOMEDRIVE",
+    "HOMEPATH",
+    "USERPROFILE",
+    "TEMP",
+    "TMP",
+    "COMSPEC",
+    "LANG",
+    "LC_ALL",
+    "TZ",
+    "TERM",
+];
+function defaultPassthroughKeys() {
+    return process.platform === "win32" ? WINDOWS_PASSTHROUGH : POSIX_PASSTHROUGH;
+}
+function inheritKeys(keys) {
+    const inherited = {};
+    for (const key of keys) {
+        const value = process.env[key];
+        if (value !== undefined) {
+            inherited[key] = value;
+        }
+    }
+    return inherited;
+}
+// Builds the clean base environment for a workflow step. By default only the
+// documented passthrough allowlist (plus any caller additions and explicit
+// `baseEnv`) is exposed; `inheritProcessEnv` restores full `process.env`
+// inheritance for callers that depend on the historical behavior.
+function buildStepBaseEnv(policy) {
+    const baseEnv = { ...(policy?.baseEnv || {}) };
+    if (policy?.inheritProcessEnv) {
+        return {
+            ...process.env,
+            ...baseEnv,
+        };
+    }
+    const allow = new Set([...defaultPassthroughKeys(), ...(policy?.passthrough || [])]);
+    return {
+        ...inheritKeys(allow),
+        ...baseEnv,
+    };
+}
+// True when the local runner would execute steps as root without any privilege
+// drop or sandbox, which means workflow code runs as root on the host.
+function runnerNeedsPrivilegeWarning(input) {
+    if (input.uid !== 0)
+        return false;
+    const { localRunner } = input;
+    const dropsPrivileges = localRunner?.uid !== undefined && localRunner.uid !== 0;
+    const sandboxed = typeof localRunner?.beforeSpawn === "function";
+    return !dropsPrivileges && !sandboxed;
+}
+export { buildStepBaseEnv, defaultPassthroughKeys, runnerNeedsPrivilegeWarning, };
+//# sourceMappingURL=environment.js.map

package/dist/core/actions/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/core/actions/environment.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,iFAAiF;AACjF,6BAA6B;AAC7B,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3E,MAAM,mBAAmB,GAAG;IAC1B,MAAM;IACN,MAAM;IACN,SAAS;IACT,YAAY;IACZ,aAAa;IACb,WAAW;IACX,UAAU;IACV,aAAa;IACb,MAAM;IACN,KAAK;IACL,SAAS;IACT,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,MAAM;CACP,CAAC;AAEF,SAAS,sBAAsB;IAC7B,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,iBAAiB,CAAC;AAChF,CAAC;AAED,SAAS,WAAW,CAAC,IAAsB;IACzC,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,6EAA6E;AAC7E,2EAA2E;AAC3E,yEAAyE;AACzE,kEAAkE;AAClE,SAAS,gBAAgB,CAAC,MAAqD;IAC7E,MAAM,OAAO,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,IAAI,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAC9B,OAAO;YACL,GAAI,OAAO,CAAC,GAA8B;YAC1C,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,sBAAsB,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACrF,OAAO;QACL,GAAG,WAAW,CAAC,KAAK,CAAC;QACrB,GAAG,OAAO;KACX,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,uEAAuE;AACvE,SAAS,2BAA2B,CAAC,KAGpC;IACC,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAClC,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAC9B,MAAM,eAAe,GAAG,WAAW,EAAE,GAAG,KAAK,SAAS,IAAI,WAAW,CAAC,GAAG,KAAK,CAAC,CAAC;IAChF,MAAM,SAAS,GAAG,OAAO,WAAW,EAAE,WAAW,KAAK,UAAU,CAAC;IACjE,OAAO,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC;AACxC,CAAC;AAED,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,GAC5B,CAAC"}

package/dist/core/actions/expressions.d.ts

@@ -0,0 +1,15 @@
+type WorkflowExpressionContext = {
+    env?: Record<string, unknown>;
+    github?: Record<string, unknown>;
+    job?: Record<string, unknown>;
+    matrix?: Record<string, unknown>;
+    needs?: Record<string, unknown>;
+    secrets?: Record<string, unknown>;
+};
+declare function booleanValue(input: unknown): boolean;
+declare function resolveWorkflowExpression(input: string, context: WorkflowExpressionContext): unknown;
+declare function resolveWorkflowString(input: string, context: WorkflowExpressionContext): string;
+declare function resolveWorkflowBoolean(input: unknown, context: WorkflowExpressionContext, fallback?: boolean): boolean;
+export { booleanValue, resolveWorkflowBoolean, resolveWorkflowExpression, resolveWorkflowString, };
+export type { WorkflowExpressionContext };
+//# sourceMappingURL=expressions.d.ts.map

package/dist/core/actions/expressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressions.d.ts","sourceRoot":"","sources":["../../../src/core/actions/expressions.ts"],"names":[],"mappings":"AAGA,KAAK,yBAAyB,GAAG;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AA8IF,iBAAS,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU7C;AA6HD,iBAAS,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAG7F;AAED,iBAAS,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,MAAM,CAOxF;AAED,iBAAS,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,UAAO,GAAG,OAAO,CAI5G;AAED,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,GACtB,CAAC;AAEF,YAAY,EAAE,yBAAyB,EAAE,CAAC"}