@webiny/api-event-handler-standalone 0.0.0-unstable.7c2def32a7 → 0.0.0-unstable.d0f34a8194

package/config/abstractions.d.ts

@@ -10,6 +10,11 @@ export interface IStandaloneConfig {
         /** `WEBINY_UPLOAD_SECRET`. Required. */
         readonly uploadSecret: string;
     };
+    /**
+     * `WEBINY_REDIS_URL`. Optional. When set, websocket messages travel between API processes
+     * through this Redis or Valkey server; required when more than one API process runs.
+     */
+    readonly redisUrl: string | undefined;
 }
 /**
  * Deployment-specific settings of a standalone API, read from env once when the server starts.

package/config/abstractions.js.map

@@ -1 +1 @@
-{"version":3,"file":"config/abstractions.js","sources":["../../src/config/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { PublicUrl } from \"@webiny/api-core/features/publicUrls/index.js\";\n\nexport interface IStandaloneConfig {\n    /** `WEBINY_API_URL`. Required. */\n    readonly apiUrl: PublicUrl;\n    /** `WEBINY_ADMIN_URL`. Optional: unknown when not set. */\n    readonly adminUrl: PublicUrl;\n    readonly fileStorage: {\n        /** `WEBINY_LOCAL_STORAGE_PATH`, resolved to an absolute path. Required. */\n        readonly storagePath: string;\n        /** `WEBINY_UPLOAD_SECRET`. Required. */\n        readonly uploadSecret: string;\n    };\n}\n\n/**\n * Deployment-specific settings of a standalone API, read from env once when the server starts.\n * Nothing here is baked into the build, so one build runs in every environment.\n */\nexport const StandaloneConfig = createAbstraction<IStandaloneConfig>(\"Standalone/Config\");\n\nexport namespace StandaloneConfig {\n    export type Interface = IStandaloneConfig;\n}\n"],"names":["StandaloneConfig","createAbstraction"],"mappings":";AAoBO,MAAMA,mBAAmBC,kBAAqC"}
+{"version":3,"file":"config/abstractions.js","sources":["../../src/config/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { PublicUrl } from \"@webiny/api-core/features/publicUrls/index.js\";\n\nexport interface IStandaloneConfig {\n    /** `WEBINY_API_URL`. Required. */\n    readonly apiUrl: PublicUrl;\n    /** `WEBINY_ADMIN_URL`. Optional: unknown when not set. */\n    readonly adminUrl: PublicUrl;\n    readonly fileStorage: {\n        /** `WEBINY_LOCAL_STORAGE_PATH`, resolved to an absolute path. Required. */\n        readonly storagePath: string;\n        /** `WEBINY_UPLOAD_SECRET`. Required. */\n        readonly uploadSecret: string;\n    };\n    /**\n     * `WEBINY_REDIS_URL`. Optional. When set, websocket messages travel between API processes\n     * through this Redis or Valkey server; required when more than one API process runs.\n     */\n    readonly redisUrl: string | undefined;\n}\n\n/**\n * Deployment-specific settings of a standalone API, read from env once when the server starts.\n * Nothing here is baked into the build, so one build runs in every environment.\n */\nexport const StandaloneConfig = createAbstraction<IStandaloneConfig>(\"Standalone/Config\");\n\nexport namespace StandaloneConfig {\n    export type Interface = IStandaloneConfig;\n}\n"],"names":["StandaloneConfig","createAbstraction"],"mappings":";AAyBO,MAAMA,mBAAmBC,kBAAqC"}

package/config/readStandaloneConfig.js

@@ -17,6 +17,8 @@ function readStandaloneConfig(env) {
     if (!storagePath) problems.push("WEBINY_LOCAL_STORAGE_PATH is not set.");
     const uploadSecret = read(env, "WEBINY_UPLOAD_SECRET");
     if (!uploadSecret) problems.push("WEBINY_UPLOAD_SECRET is not set.");
+    const redisUrl = read(env, "WEBINY_REDIS_URL");
+    if (redisUrl && !/^rediss?:\/\//.test(redisUrl)) problems.push("WEBINY_REDIS_URL must start with redis:// or rediss://.");
     if (problems.length > 0) throw new Error([
         "The standalone API is missing required configuration:",
         ...problems
@@ -27,7 +29,8 @@ function readStandaloneConfig(env) {
         fileStorage: {
             storagePath: node_path.resolve(storagePath),
             uploadSecret
-        }
+        },
+        redisUrl: redisUrl || void 0
     };
 }
 export { readStandaloneConfig };

package/config/readStandaloneConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"config/readStandaloneConfig.js","sources":["../../src/config/readStandaloneConfig.ts"],"sourcesContent":["import nodePath from \"node:path\";\nimport { PublicUrl } from \"@webiny/api-core/features/publicUrls/index.js\";\nimport type { StandaloneConfig } from \"./abstractions.js\";\n\ntype Env = Record<string, string | undefined>;\n\nfunction read(env: Env, name: string): string {\n    return env[name]?.trim() ?? \"\";\n}\n\n/**\n * Reads the standalone API's settings from env. Throws one error naming every missing or invalid\n * variable, so a misconfigured container fails at boot instead of on the first upload or login.\n *\n * Nothing falls back to a default: `webiny watch` and `webiny serve` get their values from\n * `<Infra.ApiUrl>`, `<Infra.AdminUrl>` and `<Infra.FileStorage>` in webiny.config, and a deployed\n * container must set them explicitly.\n */\nexport function readStandaloneConfig(env: Env): StandaloneConfig.Interface {\n    const problems: string[] = [];\n\n    const apiUrlValue = read(env, \"WEBINY_API_URL\");\n    const apiUrl = PublicUrl.from(apiUrlValue);\n    if (!apiUrlValue) {\n        problems.push(\"WEBINY_API_URL is not set.\");\n    } else if (!apiUrl.isKnown()) {\n        problems.push(`WEBINY_API_URL is not an absolute http(s) URL: \"${apiUrlValue}\".`);\n    }\n\n    const adminUrlValue = read(env, \"WEBINY_ADMIN_URL\");\n    const adminUrl = PublicUrl.from(adminUrlValue);\n    if (adminUrlValue && !adminUrl.isKnown()) {\n        problems.push(`WEBINY_ADMIN_URL is not an absolute http(s) URL: \"${adminUrlValue}\".`);\n    }\n\n    const storagePath = read(env, \"WEBINY_LOCAL_STORAGE_PATH\");\n    if (!storagePath) {\n        problems.push(\"WEBINY_LOCAL_STORAGE_PATH is not set.\");\n    }\n\n    const uploadSecret = read(env, \"WEBINY_UPLOAD_SECRET\");\n    if (!uploadSecret) {\n        problems.push(\"WEBINY_UPLOAD_SECRET is not set.\");\n    }\n\n    if (problems.length > 0) {\n        throw new Error(\n            [\"The standalone API is missing required configuration:\", ...problems].join(\"\\n  \")\n        );\n    }\n\n    return {\n        apiUrl,\n        adminUrl,\n        fileStorage: {\n            storagePath: nodePath.resolve(storagePath),\n            uploadSecret\n        }\n    };\n}\n"],"names":["read","env","name","readStandaloneConfig","problems","apiUrlValue","apiUrl","PublicUrl","adminUrlValue","adminUrl","storagePath","uploadSecret","Error","nodePath"],"mappings":";;AAMA,SAASA,KAAKC,GAAQ,EAAEC,IAAY;IAChC,OAAOD,GAAG,CAACC,KAAK,EAAE,UAAU;AAChC;AAUO,SAASC,qBAAqBF,GAAQ;IACzC,MAAMG,WAAqB,EAAE;IAE7B,MAAMC,cAAcL,KAAKC,KAAK;IAC9B,MAAMK,SAASC,UAAU,IAAI,CAACF;IAC9B,IAAKA,aAEE;QAAA,IAAI,CAACC,OAAO,OAAO,IACtBF,SAAS,IAAI,CAAC,CAAC,gDAAgD,EAAEC,YAAY,EAAE,CAAC;IACpF,OAHID,SAAS,IAAI,CAAC;IAKlB,MAAMI,gBAAgBR,KAAKC,KAAK;IAChC,MAAMQ,WAAWF,UAAU,IAAI,CAACC;IAChC,IAAIA,iBAAiB,CAACC,SAAS,OAAO,IAClCL,SAAS,IAAI,CAAC,CAAC,kDAAkD,EAAEI,cAAc,EAAE,CAAC;IAGxF,MAAME,cAAcV,KAAKC,KAAK;IAC9B,IAAI,CAACS,aACDN,SAAS,IAAI,CAAC;IAGlB,MAAMO,eAAeX,KAAKC,KAAK;IAC/B,IAAI,CAACU,cACDP,SAAS,IAAI,CAAC;IAGlB,IAAIA,SAAS,MAAM,GAAG,GAClB,MAAM,IAAIQ,MACN;QAAC;WAA4DR;KAAS,CAAC,IAAI,CAAC;IAIpF,OAAO;QACHE;QACAG;QACA,aAAa;YACT,aAAaI,UAAAA,OAAgB,CAACH;YAC9BC;QACJ;IACJ;AACJ"}
+{"version":3,"file":"config/readStandaloneConfig.js","sources":["../../src/config/readStandaloneConfig.ts"],"sourcesContent":["import nodePath from \"node:path\";\nimport { PublicUrl } from \"@webiny/api-core/features/publicUrls/index.js\";\nimport type { StandaloneConfig } from \"./abstractions.js\";\n\ntype Env = Record<string, string | undefined>;\n\nfunction read(env: Env, name: string): string {\n    return env[name]?.trim() ?? \"\";\n}\n\n/**\n * Reads the standalone API's settings from env. Throws one error naming every missing or invalid\n * variable, so a misconfigured container fails at boot instead of on the first upload or login.\n *\n * Nothing falls back to a default: `webiny watch` and `webiny serve` get their values from\n * `<Infra.ApiUrl>`, `<Infra.AdminUrl>` and `<Infra.FileStorage>` in webiny.config, and a deployed\n * container must set them explicitly.\n */\nexport function readStandaloneConfig(env: Env): StandaloneConfig.Interface {\n    const problems: string[] = [];\n\n    const apiUrlValue = read(env, \"WEBINY_API_URL\");\n    const apiUrl = PublicUrl.from(apiUrlValue);\n    if (!apiUrlValue) {\n        problems.push(\"WEBINY_API_URL is not set.\");\n    } else if (!apiUrl.isKnown()) {\n        problems.push(`WEBINY_API_URL is not an absolute http(s) URL: \"${apiUrlValue}\".`);\n    }\n\n    const adminUrlValue = read(env, \"WEBINY_ADMIN_URL\");\n    const adminUrl = PublicUrl.from(adminUrlValue);\n    if (adminUrlValue && !adminUrl.isKnown()) {\n        problems.push(`WEBINY_ADMIN_URL is not an absolute http(s) URL: \"${adminUrlValue}\".`);\n    }\n\n    const storagePath = read(env, \"WEBINY_LOCAL_STORAGE_PATH\");\n    if (!storagePath) {\n        problems.push(\"WEBINY_LOCAL_STORAGE_PATH is not set.\");\n    }\n\n    const uploadSecret = read(env, \"WEBINY_UPLOAD_SECRET\");\n    if (!uploadSecret) {\n        problems.push(\"WEBINY_UPLOAD_SECRET is not set.\");\n    }\n\n    const redisUrl = read(env, \"WEBINY_REDIS_URL\");\n    if (redisUrl && !/^rediss?:\\/\\//.test(redisUrl)) {\n        problems.push(\"WEBINY_REDIS_URL must start with redis:// or rediss://.\");\n    }\n\n    if (problems.length > 0) {\n        throw new Error(\n            [\"The standalone API is missing required configuration:\", ...problems].join(\"\\n  \")\n        );\n    }\n\n    return {\n        apiUrl,\n        adminUrl,\n        fileStorage: {\n            storagePath: nodePath.resolve(storagePath),\n            uploadSecret\n        },\n        redisUrl: redisUrl || undefined\n    };\n}\n"],"names":["read","env","name","readStandaloneConfig","problems","apiUrlValue","apiUrl","PublicUrl","adminUrlValue","adminUrl","storagePath","uploadSecret","redisUrl","Error","nodePath","undefined"],"mappings":";;AAMA,SAASA,KAAKC,GAAQ,EAAEC,IAAY;IAChC,OAAOD,GAAG,CAACC,KAAK,EAAE,UAAU;AAChC;AAUO,SAASC,qBAAqBF,GAAQ;IACzC,MAAMG,WAAqB,EAAE;IAE7B,MAAMC,cAAcL,KAAKC,KAAK;IAC9B,MAAMK,SAASC,UAAU,IAAI,CAACF;IAC9B,IAAKA,aAEE;QAAA,IAAI,CAACC,OAAO,OAAO,IACtBF,SAAS,IAAI,CAAC,CAAC,gDAAgD,EAAEC,YAAY,EAAE,CAAC;IACpF,OAHID,SAAS,IAAI,CAAC;IAKlB,MAAMI,gBAAgBR,KAAKC,KAAK;IAChC,MAAMQ,WAAWF,UAAU,IAAI,CAACC;IAChC,IAAIA,iBAAiB,CAACC,SAAS,OAAO,IAClCL,SAAS,IAAI,CAAC,CAAC,kDAAkD,EAAEI,cAAc,EAAE,CAAC;IAGxF,MAAME,cAAcV,KAAKC,KAAK;IAC9B,IAAI,CAACS,aACDN,SAAS,IAAI,CAAC;IAGlB,MAAMO,eAAeX,KAAKC,KAAK;IAC/B,IAAI,CAACU,cACDP,SAAS,IAAI,CAAC;IAGlB,MAAMQ,WAAWZ,KAAKC,KAAK;IAC3B,IAAIW,YAAY,CAAC,gBAAgB,IAAI,CAACA,WAClCR,SAAS,IAAI,CAAC;IAGlB,IAAIA,SAAS,MAAM,GAAG,GAClB,MAAM,IAAIS,MACN;QAAC;WAA4DT;KAAS,CAAC,IAAI,CAAC;IAIpF,OAAO;QACHE;QACAG;QACA,aAAa;YACT,aAAaK,UAAAA,OAAgB,CAACJ;YAC9BC;QACJ;QACA,UAAUC,YAAYG;IAC1B;AACJ"}

package/createWebinyApiHandler.js

@@ -1,9 +1,10 @@
 import { GraphQLSchemaCacheFeature } from "@webiny/api-graphql";
 import { EncryptionKeyCacheFeature } from "@webiny/api-core/features/encryption/index.js";
 import { JwksStoreFeature } from "@webiny/api-core/idp/index.js";
-import { NodeHttpFeature, RandomProcessOwner, createServerHandler } from "@webiny/event-handler-standalone";
+import { NodeHttpFeature, ProcessOwner, RandomProcessOwner, createServerHandler } from "@webiny/event-handler-standalone";
 import { registerApiRequestStack } from "@webiny/api-event-handler-core";
-import { NodeWsAdapter, ServerConnectionManager, WebsocketsConnectionManager, WebsocketsStandaloneFeature, attachWebsocketsServer } from "@webiny/api-websockets-standalone";
+import { InProcessMessageBus, NodeWsAdapter, ServerConnectionManager, WebsocketsConnectionManager, WebsocketsMessageBus, WebsocketsServerAdapter, WebsocketsStandaloneFeature, attachWebsocketsServer, createBusMessageHandler } from "@webiny/api-websockets-standalone";
+import { WebsocketsRedisFeature } from "@webiny/api-websockets-standalone-redis";
 import { BackgroundTasksStandaloneFeature, startTaskRecovery, stopBackgroundTasks } from "@webiny/background-tasks-standalone";
 import { FileManagerStandaloneFeature } from "@webiny/api-file-manager-standalone";
 import { registerSchedulerServer, startSchedulerServer } from "./scheduler/schedulerServer.js";
@@ -17,11 +18,13 @@ import { mkdirSync } from "node:fs";
 import { ConfigPublicUrlsFeature } from "./publicUrls/feature.js";
 import { StandaloneConfig } from "./config/abstractions.js";
 import { readStandaloneConfig } from "./config/readStandaloneConfig.js";
+import { consoleLogger } from "./logger/consoleLogger.js";
 const SHUTDOWN_WAIT_MS = 6000;
 function createWebinyApiHandler(config) {
     let stopTaskRecovery;
     let stopScheduler;
     let stopWebsockets;
+    let closeMessageBus;
     const standaloneConfig = readStandaloneConfig(process.env);
     return createServerHandler({
         root: async (rootContainer)=>{
@@ -37,6 +40,11 @@ function createWebinyApiHandler(config) {
             await config.registerRootStorage(rootContainer);
             rootContainer.register(ServerConnectionManager).inSingletonScope();
             rootContainer.register(NodeWsAdapter).inSingletonScope();
+            if (standaloneConfig.redisUrl) WebsocketsRedisFeature.register(rootContainer, {
+                url: standaloneConfig.redisUrl,
+                logger: consoleLogger
+            });
+            else rootContainer.register(InProcessMessageBus).inSingletonScope();
             GraphQLSchemaCacheFeature.register(rootContainer);
             EncryptionKeyCacheFeature.register(rootContainer);
             JwksStoreFeature.register(rootContainer);
@@ -61,13 +69,27 @@ function createWebinyApiHandler(config) {
             });
         },
         onServer: async (server, rootContainer)=>{
+            const connectionManager = rootContainer.resolve(WebsocketsConnectionManager);
             const websockets = attachWebsocketsServer({
                 server,
-                connectionManager: rootContainer.resolve(WebsocketsConnectionManager),
+                connectionManager,
                 authenticate: createWebsocketsAuthenticator(rootContainer, config.extensions)
             });
             await websockets.start();
             stopWebsockets = ()=>websockets.stop();
+            const messageBus = rootContainer.resolve(WebsocketsMessageBus);
+            const processOwner = rootContainer.resolve(ProcessOwner);
+            const adapter = rootContainer.resolve(WebsocketsServerAdapter);
+            const handleBusMessage = createBusMessageHandler({
+                connectionManager,
+                adapter,
+                logger: consoleLogger
+            });
+            await messageBus.subscribe(processOwner.id, handleBusMessage);
+            closeMessageBus = ()=>messageBus.close();
+            consoleLogger.info({
+                messageBus: standaloneConfig.redisUrl ? "redis" : "in-process"
+            }, "[websockets] using message bus");
             stopScheduler = await startSchedulerServer(rootContainer);
             startBulkActionsServer(rootContainer);
             stopTaskRecovery = startTaskRecovery(rootContainer);
@@ -77,10 +99,16 @@ function createWebinyApiHandler(config) {
             const tasks = stopBackgroundTasks(rootContainer, SHUTDOWN_WAIT_MS);
             const scheduledActions = stopScheduler?.(SHUTDOWN_WAIT_MS);
             const websockets = stopWebsockets?.();
+            const workDone = Promise.allSettled([
+                tasks,
+                scheduledActions
+            ]);
+            const messageBus = workDone.then(()=>closeMessageBus?.());
             const results = await Promise.allSettled([
                 tasks,
                 scheduledActions,
-                websockets
+                websockets,
+                messageBus
             ]);
             const failed = results.find((result)=>"rejected" === result.status);
             if (failed) throw failed.reason;

package/createWebinyApiHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"createWebinyApiHandler.js","sources":["../src/createWebinyApiHandler.ts"],"sourcesContent":["/**\n * Webiny API handler for the standalone Node HTTP server transport — storage-agnostic BASE.\n *\n * The ROOT container wires the Node HTTP transport (NodeHttpFeature = event type + router + HttpFeature)\n * plus the auth/tenant loader decorators (extract token / x-tenant from the IncomingMessage → shared\n * RequestIdentityLoader / RequestTenantLoader). The per-request feature stack is the transport-agnostic\n * `registerApiRequestStack` from `@webiny/api-event-handler-core` — the SAME stack the AWS handler uses.\n * The realtime transport hook installs the server WebSockets transport (vs AWS's API Gateway Management\n * API) with a SINGLE-PROCESS, in-process implementation. Background tasks and the Bree scheduler are\n * ROOT-container singletons (below) — mirroring how the AWS handler registers background tasks at root,\n * and the WebSockets connection manager — rather than per-request transports; the scheduler fires timers\n * in-process (vs AWS's EventBridge). The storage variant (and identity provider) is injected via\n * `registerRootStorage`.\n *\n * The identity provider (e.g. `@webiny/self-hosted-auth`'s JWT IdP) must be registered by the variant\n * in `registerRootStorage`, so the RequestIdentityLoader driven by the identity decorator can resolve it.\n */\nimport { GraphQLSchemaCacheFeature } from \"@webiny/api-graphql\";\nimport { EncryptionKeyCacheFeature } from \"@webiny/api-core/features/encryption/index.js\";\nimport { JwksStoreFeature } from \"@webiny/api-core/idp/index.js\";\nimport type { Container } from \"@webiny/di\";\nimport { createServerHandler, NodeHttpFeature } from \"@webiny/event-handler-standalone\";\nimport { RandomProcessOwner } from \"@webiny/event-handler-standalone\";\nimport { registerExtensions } from \"@webiny/handler\";\nimport { registerApiRequestStack } from \"@webiny/api-event-handler-core\";\nimport {\n    ServerConnectionManager,\n    NodeWsAdapter,\n    WebsocketsStandaloneFeature,\n    WebsocketsConnectionManager,\n    attachWebsocketsServer\n} from \"@webiny/api-websockets-standalone\";\nimport { BackgroundTasksStandaloneFeature } from \"@webiny/background-tasks-standalone\";\nimport { startTaskRecovery } from \"@webiny/background-tasks-standalone\";\nimport { stopBackgroundTasks } from \"@webiny/background-tasks-standalone\";\nimport { FileManagerStandaloneFeature } from \"@webiny/api-file-manager-standalone\";\nimport { registerSchedulerServer, startSchedulerServer } from \"~/scheduler/schedulerServer.js\";\nimport { startBulkActionsServer } from \"~/bulkActions/bulkActionsServer.js\";\nimport { NodeHttpIdentityLoaderDecorator } from \"~/handlers/NodeHttpIdentityLoaderDecorator.js\";\nimport { NodeHttpTenantLoaderDecorator } from \"~/handlers/NodeHttpTenantLoaderDecorator.js\";\nimport { NodeHttpAssumePermissionsDecorator } from \"~/handlers/NodeHttpAssumePermissionsDecorator.js\";\nimport { createWebsocketsAuthenticator } from \"~/websockets/createWebsocketsAuthenticator.js\";\nimport { EmptyTrashBinsFeature } from \"@webiny/api-headless-cms-bulk-actions-standalone\";\nimport { mkdirSync } from \"node:fs\";\nimport { ConfigPublicUrlsFeature } from \"~/publicUrls/feature.js\";\nimport { StandaloneConfig } from \"~/config/abstractions.js\";\nimport { readStandaloneConfig } from \"~/config/readStandaloneConfig.js\";\n\nexport interface CreateWebinyApiHandlerConfig {\n    /**\n     * Project-defined extensions, applied at register() time.\n     */\n    extensions: () => Parameters<typeof registerExtensions>[1];\n    /**\n     * Register ALL root-container storage for this deployment (the DB feature + CMS storage ops +\n     * registries) AND the identity provider. Unlike the AWS base, the server base bakes in no DB or\n     * IdP assumption — the variant supplies the complete storage + auth wiring.\n     */\n    registerRootStorage: (container: Container) => void | Promise<void>;\n}\n\n/*\n * The part of the 8 seconds a shutdown gets that running tasks and scheduled actions may spend\n * finishing or handing back; both wait at the same time. The rest leaves room to exit before a\n * process manager loses patience.\n */\nconst SHUTDOWN_WAIT_MS = 6000;\n\nexport function createWebinyApiHandler(config: CreateWebinyApiHandlerConfig) {\n    let stopTaskRecovery: (() => void) | undefined;\n    let stopScheduler: ((timeoutMs: number) => Promise<void>) | undefined;\n    let stopWebsockets: (() => Promise<void>) | undefined;\n\n    // Deployment-specific settings (public URLs, file storage) come from env, read once here so a\n    // missing value stops the server at boot. Nothing deployment-specific is baked into the build.\n    const standaloneConfig = readStandaloneConfig(process.env);\n\n    return createServerHandler({\n        root: async rootContainer => {\n            rootContainer.registerInstance(StandaloneConfig, standaloneConfig);\n\n            // Names this process in shared storage: task claims and websocket connections.\n            rootContainer.register(RandomProcessOwner).inSingletonScope();\n            mkdirSync(standaloneConfig.fileStorage.storagePath, { recursive: true });\n\n            // ── Transport (Node HTTP) ──────────────────────────────────\n            // NodeHttpFeature registers the event type + HttpFeature (router) + the routing terminal.\n            NodeHttpFeature.register(rootContainer);\n\n            // ── Tenant + auth (extract → shared load) ──────────────────\n            // registerDecorator applies LATER registrations as the OUTER wrapper (whose execute()\n            // runs first). TENANT must be established before IDENTITY: API-key authentication resolves\n            // the key by tenant partition (ApiKeysRepository reads TenantContext.getTenant()), so\n            // identity depends on the tenant; the reverse is not true (RequestTenantLoader has no\n            // identity dependency). Register identity first (inner) and tenant last (outer) → tenant\n            // runs, then identity, then the router.\n            rootContainer.registerDecorator(NodeHttpIdentityLoaderDecorator);\n            rootContainer.registerDecorator(NodeHttpTenantLoaderDecorator);\n\n            // Preview-as. Mirrors the AWS handler.\n            rootContainer.registerDecorator(NodeHttpAssumePermissionsDecorator);\n\n            // ── Storage + identity provider (variant-supplied) ─────────\n            await config.registerRootStorage(rootContainer);\n\n            // ── WebSockets transport (root) ────────────────────────────\n            // Live-socket registry + adapter live in the root as singletons: the connection manager\n            // is shared between the upgrade acceptor (attachWebsocketsServer, below) and the\n            // per-request ServerWebsocketsTransport that sends to those live sockets. The persistent\n            // connection registry (ConnectionRegistry) is the storage variant's job (e.g. sql).\n            rootContainer.register(ServerConnectionManager).inSingletonScope();\n            rootContainer.register(NodeWsAdapter).inSingletonScope();\n\n            // ── GraphQL schema cache (root) ────────────────────────────\n            // Root, so a built schema outlives the request that built it.\n            GraphQLSchemaCacheFeature.register(rootContainer);\n\n            // ── Encryption key cache (root) ────────────────────────────\n            // Root, so the scrypt-derived key is computed once per process instead of per request.\n            EncryptionKeyCacheFeature.register(rootContainer);\n            // Root, so identity providers' signing keys are fetched once per process, not per request.\n            JwksStoreFeature.register(rootContainer);\n\n            // ── Background tasks (root) ────────────────────────────────\n            // Mirrors the AWS handler registering its background-task transport at root. Where AWS\n            // has Step Functions invoke the Lambda once per iteration, a root task loop dispatches a\n            // BackgroundTaskEvent per iteration through the EventDispatcher (registered by\n            // createServerHandler), and each one runs in a fresh request container.\n            BackgroundTasksStandaloneFeature.register(rootContainer);\n\n            // ── Scheduler (root) ───────────────────────────────────────\n            // The Bree scheduler is a single long-lived instance for ALL tenants, started once at boot\n            // (onServer, below) — the counterpart of the WebSockets connection manager, NOT a per-request\n            // transport. Registered here as SchedulerService (per-request create/update/delete during\n            // mutations manipulate this one live timer set) plus the run/recover event handlers. When a\n            // timer fires (outside any request) it dispatches a ScheduledActionEvent, handled in a fresh\n            // request container by the same handler AWS uses.\n            registerSchedulerServer(rootContainer);\n\n            // ── Bulk actions (root) ───────────────────────────────────\n            // Registers the EmptyTrashBinsEvent handler that the periodic trigger\n            // (startBulkActionsServer, onServer below) dispatches.\n            EmptyTrashBinsFeature.register(rootContainer);\n        },\n\n        child: async container => {\n            // The transport-agnostic per-request stack. The realtime hook installs the server\n            // WebSockets transport (overriding the domain's NullWebsocketsTransport); it resolves the\n            // shared connection manager + adapter from the root. Scheduler is NOT a per-request\n            // transport here — it's a root singleton wired in `root` + `onServer` (see above).\n            await registerApiRequestStack(container, {\n                extensions: config.extensions,\n                // Why hooks (and not just registering the transports ourselves): `.register()` calls\n                // are otherwise order-independent — you can register Features in any order, because\n                // they only REGISTER, they don't RESOLVE during registration (resolution happens\n                // later, in Initializers / SchemaFactories). The one thing that makes order matter is\n                // a DEFAULT registration: e.g. `WebsocketsFeature` registers `NullWebsocketsTransport`\n                // so the abstraction is always resolvable. Overriding it (last-registration-wins) means\n                // our transport MUST be registered AFTER that Feature. These hooks are the seams\n                // `registerApiRequestStack` provides for exactly that — each runs right after its Null\n                // default, so the override is guaranteed without the caller knowing the internal order.\n                transports: {\n                    // Public URLs: no deploy step to discover them from, so they come from\n                    // `WEBINY_API_URL` / `WEBINY_ADMIN_URL` (StandaloneConfig, registered on the root).\n                    publicUrls: requestContainer => {\n                        ConfigPublicUrlsFeature.register(requestContainer);\n                    },\n                    // Server WebSockets transport; resolves the shared connection manager + adapter\n                    // from the root (registered as singletons above).\n                    realtime: requestContainer => {\n                        WebsocketsStandaloneFeature.register(requestContainer);\n                    },\n                    // File-manager storage transport: local disk. Where AWS uses S3 (+ a separate asset-\n                    // delivery Lambda), the single-process server stores files on disk and serves them\n                    // in-process — FileManagerStandaloneFeature registers local asset delivery (overriding\n                    // the domain's null impls), the upload/multipart HTTP routes, and disk file ops.\n                    fileManager: requestContainer => {\n                        FileManagerStandaloneFeature.register(\n                            requestContainer,\n                            standaloneConfig.fileStorage\n                        );\n                    }\n                }\n            });\n        },\n\n        onServer: async (server, rootContainer) => {\n            // Attach the WebSockets upgrade handler to the running HTTP server, backed by the shared\n            // (root) connection manager so request-time sends reach the live sockets.\n            //\n            // Authenticate each WebSocket connection from its `?token` JWT so it's registered under\n            // the real identity (targeted server→client sends match by identity id). It's a callback\n            // the handler supplies rather than something the WS server resolves itself — see\n            // createWebsocketsAuthenticator for why (AuthenticationContext is per-request, unreachable\n            // from the root container the WS server is attached to).\n            const websockets = attachWebsocketsServer({\n                server,\n                connectionManager: rootContainer.resolve(WebsocketsConnectionManager),\n                authenticate: createWebsocketsAuthenticator(rootContainer, config.extensions)\n            });\n            await websockets.start();\n            stopWebsockets = () => websockets.stop();\n\n            /*\n             * Start the in-process scheduler timers, then re-arm persisted schedules in the\n             * background, at boot and then every minute (see startSchedulerServer).\n             */\n            stopScheduler = await startSchedulerServer(rootContainer);\n\n            // Start the periodic empty-trash-bin trigger.\n            startBulkActionsServer(rootContainer);\n\n            /*\n             * Take over tasks a restart or another process left behind, at boot and then every\n             * minute (see startTaskRecovery).\n             */\n            stopTaskRecovery = startTaskRecovery(rootContainer);\n        },\n\n        onShutdown: async rootContainer => {\n            /*\n             * Stop starting new work first: task recovery, and the scheduler's timers and recovery.\n             * Then wait for what is running: tasks hand themselves back, so another process picks\n             * them up at its next sweep, and scheduled actions already running get to finish.\n             * Websockets close at the same time, with 1012 so clients reconnect to a process that\n             * is up, and their connections leave the registry; that takes about a second.\n             */\n            stopTaskRecovery?.();\n            const tasks = stopBackgroundTasks(rootContainer, SHUTDOWN_WAIT_MS);\n            const scheduledActions = stopScheduler?.(SHUTDOWN_WAIT_MS);\n            const websockets = stopWebsockets?.();\n\n            // One failing part must not cut the others short; the first failure is reported after.\n            const results = await Promise.allSettled([tasks, scheduledActions, websockets]);\n            const failed = results.find((result): result is PromiseRejectedResult => {\n                return result.status === \"rejected\";\n            });\n            if (failed) {\n                throw failed.reason;\n            }\n        }\n    });\n}\n"],"names":["SHUTDOWN_WAIT_MS","createWebinyApiHandler","config","stopTaskRecovery","stopScheduler","stopWebsockets","standaloneConfig","readStandaloneConfig","process","createServerHandler","rootContainer","StandaloneConfig","RandomProcessOwner","mkdirSync","NodeHttpFeature","NodeHttpIdentityLoaderDecorator","NodeHttpTenantLoaderDecorator","NodeHttpAssumePermissionsDecorator","ServerConnectionManager","NodeWsAdapter","GraphQLSchemaCacheFeature","EncryptionKeyCacheFeature","JwksStoreFeature","BackgroundTasksStandaloneFeature","registerSchedulerServer","EmptyTrashBinsFeature","container","registerApiRequestStack","requestContainer","ConfigPublicUrlsFeature","WebsocketsStandaloneFeature","FileManagerStandaloneFeature","server","websockets","attachWebsocketsServer","WebsocketsConnectionManager","createWebsocketsAuthenticator","startSchedulerServer","startBulkActionsServer","startTaskRecovery","tasks","stopBackgroundTasks","scheduledActions","results","Promise","failed","result"],"mappings":";;;;;;;;;;;;;;;;;;;AAkEA,MAAMA,mBAAmB;AAElB,SAASC,uBAAuBC,MAAoC;IACvE,IAAIC;IACJ,IAAIC;IACJ,IAAIC;IAIJ,MAAMC,mBAAmBC,qBAAqBC,QAAQ,GAAG;IAEzD,OAAOC,oBAAoB;QACvB,MAAM,OAAMC;YACRA,cAAc,gBAAgB,CAACC,kBAAkBL;YAGjDI,cAAc,QAAQ,CAACE,oBAAoB,gBAAgB;YAC3DC,UAAUP,iBAAiB,WAAW,CAAC,WAAW,EAAE;gBAAE,WAAW;YAAK;YAItEQ,gBAAgB,QAAQ,CAACJ;YASzBA,cAAc,iBAAiB,CAACK;YAChCL,cAAc,iBAAiB,CAACM;YAGhCN,cAAc,iBAAiB,CAACO;YAGhC,MAAMf,OAAO,mBAAmB,CAACQ;YAOjCA,cAAc,QAAQ,CAACQ,yBAAyB,gBAAgB;YAChER,cAAc,QAAQ,CAACS,eAAe,gBAAgB;YAItDC,0BAA0B,QAAQ,CAACV;YAInCW,0BAA0B,QAAQ,CAACX;YAEnCY,iBAAiB,QAAQ,CAACZ;YAO1Ba,iCAAiC,QAAQ,CAACb;YAS1Cc,wBAAwBd;YAKxBe,sBAAsB,QAAQ,CAACf;QACnC;QAEA,OAAO,OAAMgB;YAKT,MAAMC,wBAAwBD,WAAW;gBACrC,YAAYxB,OAAO,UAAU;gBAU7B,YAAY;oBAGR,YAAY0B,CAAAA;wBACRC,wBAAwB,QAAQ,CAACD;oBACrC;oBAGA,UAAUA,CAAAA;wBACNE,4BAA4B,QAAQ,CAACF;oBACzC;oBAKA,aAAaA,CAAAA;wBACTG,6BAA6B,QAAQ,CACjCH,kBACAtB,iBAAiB,WAAW;oBAEpC;gBACJ;YACJ;QACJ;QAEA,UAAU,OAAO0B,QAAQtB;YASrB,MAAMuB,aAAaC,uBAAuB;gBACtCF;gBACA,mBAAmBtB,cAAc,OAAO,CAACyB;gBACzC,cAAcC,8BAA8B1B,eAAeR,OAAO,UAAU;YAChF;YACA,MAAM+B,WAAW,KAAK;YACtB5B,iBAAiB,IAAM4B,WAAW,IAAI;YAMtC7B,gBAAgB,MAAMiC,qBAAqB3B;YAG3C4B,uBAAuB5B;YAMvBP,mBAAmBoC,kBAAkB7B;QACzC;QAEA,YAAY,OAAMA;YAQdP;YACA,MAAMqC,QAAQC,oBAAoB/B,eAAeV;YACjD,MAAM0C,mBAAmBtC,gBAAgBJ;YACzC,MAAMiC,aAAa5B;YAGnB,MAAMsC,UAAU,MAAMC,QAAQ,UAAU,CAAC;gBAACJ;gBAAOE;gBAAkBT;aAAW;YAC9E,MAAMY,SAASF,QAAQ,IAAI,CAAC,CAACG,SAClBA,AAAkB,eAAlBA,OAAO,MAAM;YAExB,IAAID,QACA,MAAMA,OAAO,MAAM;QAE3B;IACJ;AACJ"}
+{"version":3,"file":"createWebinyApiHandler.js","sources":["../src/createWebinyApiHandler.ts"],"sourcesContent":["/**\n * Webiny API handler for the standalone Node HTTP server transport — storage-agnostic BASE.\n *\n * The ROOT container wires the Node HTTP transport (NodeHttpFeature = event type + router + HttpFeature)\n * plus the auth/tenant loader decorators (extract token / x-tenant from the IncomingMessage → shared\n * RequestIdentityLoader / RequestTenantLoader). The per-request feature stack is the transport-agnostic\n * `registerApiRequestStack` from `@webiny/api-event-handler-core` — the SAME stack the AWS handler uses.\n * The realtime transport hook installs the server WebSockets transport (vs AWS's API Gateway Management\n * API) with a SINGLE-PROCESS, in-process implementation. Background tasks and the Bree scheduler are\n * ROOT-container singletons (below) — mirroring how the AWS handler registers background tasks at root,\n * and the WebSockets connection manager — rather than per-request transports; the scheduler fires timers\n * in-process (vs AWS's EventBridge). The storage variant (and identity provider) is injected via\n * `registerRootStorage`.\n *\n * The identity provider (e.g. `@webiny/self-hosted-auth`'s JWT IdP) must be registered by the variant\n * in `registerRootStorage`, so the RequestIdentityLoader driven by the identity decorator can resolve it.\n */\nimport { GraphQLSchemaCacheFeature } from \"@webiny/api-graphql\";\nimport { EncryptionKeyCacheFeature } from \"@webiny/api-core/features/encryption/index.js\";\nimport { JwksStoreFeature } from \"@webiny/api-core/idp/index.js\";\nimport type { Container } from \"@webiny/di\";\nimport { createServerHandler, NodeHttpFeature } from \"@webiny/event-handler-standalone\";\nimport { RandomProcessOwner } from \"@webiny/event-handler-standalone\";\nimport { registerExtensions } from \"@webiny/handler\";\nimport { registerApiRequestStack } from \"@webiny/api-event-handler-core\";\nimport {\n    ServerConnectionManager,\n    NodeWsAdapter,\n    WebsocketsStandaloneFeature,\n    WebsocketsConnectionManager,\n    attachWebsocketsServer\n} from \"@webiny/api-websockets-standalone\";\nimport { WebsocketsServerAdapter } from \"@webiny/api-websockets-standalone\";\nimport { WebsocketsMessageBus } from \"@webiny/api-websockets-standalone\";\nimport { InProcessMessageBus } from \"@webiny/api-websockets-standalone\";\nimport { createBusMessageHandler } from \"@webiny/api-websockets-standalone\";\nimport { WebsocketsRedisFeature } from \"@webiny/api-websockets-standalone-redis\";\nimport { ProcessOwner } from \"@webiny/event-handler-standalone\";\nimport { BackgroundTasksStandaloneFeature } from \"@webiny/background-tasks-standalone\";\nimport { startTaskRecovery } from \"@webiny/background-tasks-standalone\";\nimport { stopBackgroundTasks } from \"@webiny/background-tasks-standalone\";\nimport { FileManagerStandaloneFeature } from \"@webiny/api-file-manager-standalone\";\nimport { registerSchedulerServer, startSchedulerServer } from \"~/scheduler/schedulerServer.js\";\nimport { startBulkActionsServer } from \"~/bulkActions/bulkActionsServer.js\";\nimport { NodeHttpIdentityLoaderDecorator } from \"~/handlers/NodeHttpIdentityLoaderDecorator.js\";\nimport { NodeHttpTenantLoaderDecorator } from \"~/handlers/NodeHttpTenantLoaderDecorator.js\";\nimport { NodeHttpAssumePermissionsDecorator } from \"~/handlers/NodeHttpAssumePermissionsDecorator.js\";\nimport { createWebsocketsAuthenticator } from \"~/websockets/createWebsocketsAuthenticator.js\";\nimport { EmptyTrashBinsFeature } from \"@webiny/api-headless-cms-bulk-actions-standalone\";\nimport { mkdirSync } from \"node:fs\";\nimport { ConfigPublicUrlsFeature } from \"~/publicUrls/feature.js\";\nimport { StandaloneConfig } from \"~/config/abstractions.js\";\nimport { readStandaloneConfig } from \"~/config/readStandaloneConfig.js\";\nimport { consoleLogger } from \"~/logger/consoleLogger.js\";\n\nexport interface CreateWebinyApiHandlerConfig {\n    /**\n     * Project-defined extensions, applied at register() time.\n     */\n    extensions: () => Parameters<typeof registerExtensions>[1];\n    /**\n     * Register ALL root-container storage for this deployment (the DB feature + CMS storage ops +\n     * registries) AND the identity provider. Unlike the AWS base, the server base bakes in no DB or\n     * IdP assumption — the variant supplies the complete storage + auth wiring.\n     */\n    registerRootStorage: (container: Container) => void | Promise<void>;\n}\n\n/*\n * The part of the 8 seconds a shutdown gets that running tasks and scheduled actions may spend\n * finishing or handing back; both wait at the same time. The rest leaves room to exit before a\n * process manager loses patience.\n */\nconst SHUTDOWN_WAIT_MS = 6000;\n\nexport function createWebinyApiHandler(config: CreateWebinyApiHandlerConfig) {\n    let stopTaskRecovery: (() => void) | undefined;\n    let stopScheduler: ((timeoutMs: number) => Promise<void>) | undefined;\n    let stopWebsockets: (() => Promise<void>) | undefined;\n    let closeMessageBus: (() => Promise<void>) | undefined;\n\n    // Deployment-specific settings (public URLs, file storage) come from env, read once here so a\n    // missing value stops the server at boot. Nothing deployment-specific is baked into the build.\n    const standaloneConfig = readStandaloneConfig(process.env);\n\n    return createServerHandler({\n        root: async rootContainer => {\n            rootContainer.registerInstance(StandaloneConfig, standaloneConfig);\n\n            // Names this process in shared storage: task claims and websocket connections.\n            rootContainer.register(RandomProcessOwner).inSingletonScope();\n            mkdirSync(standaloneConfig.fileStorage.storagePath, { recursive: true });\n\n            // ── Transport (Node HTTP) ──────────────────────────────────\n            // NodeHttpFeature registers the event type + HttpFeature (router) + the routing terminal.\n            NodeHttpFeature.register(rootContainer);\n\n            // ── Tenant + auth (extract → shared load) ──────────────────\n            // registerDecorator applies LATER registrations as the OUTER wrapper (whose execute()\n            // runs first). TENANT must be established before IDENTITY: API-key authentication resolves\n            // the key by tenant partition (ApiKeysRepository reads TenantContext.getTenant()), so\n            // identity depends on the tenant; the reverse is not true (RequestTenantLoader has no\n            // identity dependency). Register identity first (inner) and tenant last (outer) → tenant\n            // runs, then identity, then the router.\n            rootContainer.registerDecorator(NodeHttpIdentityLoaderDecorator);\n            rootContainer.registerDecorator(NodeHttpTenantLoaderDecorator);\n\n            // Preview-as. Mirrors the AWS handler.\n            rootContainer.registerDecorator(NodeHttpAssumePermissionsDecorator);\n\n            // ── Storage + identity provider (variant-supplied) ─────────\n            await config.registerRootStorage(rootContainer);\n\n            // ── WebSockets transport (root) ────────────────────────────\n            // Live-socket registry + adapter live in the root as singletons: the connection manager\n            // is shared between the upgrade acceptor (attachWebsocketsServer, below) and the\n            // per-request ServerWebsocketsTransport that sends to those live sockets. The persistent\n            // connection registry (ConnectionRegistry) is the storage variant's job (e.g. sql).\n            rootContainer.register(ServerConnectionManager).inSingletonScope();\n            rootContainer.register(NodeWsAdapter).inSingletonScope();\n\n            /*\n             * How a send reaches a socket another API process holds. Without a Redis URL there is\n             * one process, and every socket is in it.\n             */\n            if (standaloneConfig.redisUrl) {\n                WebsocketsRedisFeature.register(rootContainer, {\n                    url: standaloneConfig.redisUrl,\n                    logger: consoleLogger\n                });\n            } else {\n                rootContainer.register(InProcessMessageBus).inSingletonScope();\n            }\n\n            // ── GraphQL schema cache (root) ────────────────────────────\n            // Root, so a built schema outlives the request that built it.\n            GraphQLSchemaCacheFeature.register(rootContainer);\n\n            // ── Encryption key cache (root) ────────────────────────────\n            // Root, so the scrypt-derived key is computed once per process instead of per request.\n            EncryptionKeyCacheFeature.register(rootContainer);\n            // Root, so identity providers' signing keys are fetched once per process, not per request.\n            JwksStoreFeature.register(rootContainer);\n\n            // ── Background tasks (root) ────────────────────────────────\n            // Mirrors the AWS handler registering its background-task transport at root. Where AWS\n            // has Step Functions invoke the Lambda once per iteration, a root task loop dispatches a\n            // BackgroundTaskEvent per iteration through the EventDispatcher (registered by\n            // createServerHandler), and each one runs in a fresh request container.\n            BackgroundTasksStandaloneFeature.register(rootContainer);\n\n            // ── Scheduler (root) ───────────────────────────────────────\n            // The Bree scheduler is a single long-lived instance for ALL tenants, started once at boot\n            // (onServer, below) — the counterpart of the WebSockets connection manager, NOT a per-request\n            // transport. Registered here as SchedulerService (per-request create/update/delete during\n            // mutations manipulate this one live timer set) plus the run/recover event handlers. When a\n            // timer fires (outside any request) it dispatches a ScheduledActionEvent, handled in a fresh\n            // request container by the same handler AWS uses.\n            registerSchedulerServer(rootContainer);\n\n            // ── Bulk actions (root) ───────────────────────────────────\n            // Registers the EmptyTrashBinsEvent handler that the periodic trigger\n            // (startBulkActionsServer, onServer below) dispatches.\n            EmptyTrashBinsFeature.register(rootContainer);\n        },\n\n        child: async container => {\n            // The transport-agnostic per-request stack. The realtime hook installs the server\n            // WebSockets transport (overriding the domain's NullWebsocketsTransport); it resolves the\n            // shared connection manager + adapter from the root. Scheduler is NOT a per-request\n            // transport here — it's a root singleton wired in `root` + `onServer` (see above).\n            await registerApiRequestStack(container, {\n                extensions: config.extensions,\n                // Why hooks (and not just registering the transports ourselves): `.register()` calls\n                // are otherwise order-independent — you can register Features in any order, because\n                // they only REGISTER, they don't RESOLVE during registration (resolution happens\n                // later, in Initializers / SchemaFactories). The one thing that makes order matter is\n                // a DEFAULT registration: e.g. `WebsocketsFeature` registers `NullWebsocketsTransport`\n                // so the abstraction is always resolvable. Overriding it (last-registration-wins) means\n                // our transport MUST be registered AFTER that Feature. These hooks are the seams\n                // `registerApiRequestStack` provides for exactly that — each runs right after its Null\n                // default, so the override is guaranteed without the caller knowing the internal order.\n                transports: {\n                    // Public URLs: no deploy step to discover them from, so they come from\n                    // `WEBINY_API_URL` / `WEBINY_ADMIN_URL` (StandaloneConfig, registered on the root).\n                    publicUrls: requestContainer => {\n                        ConfigPublicUrlsFeature.register(requestContainer);\n                    },\n                    // Server WebSockets transport; resolves the shared connection manager + adapter\n                    // from the root (registered as singletons above).\n                    realtime: requestContainer => {\n                        WebsocketsStandaloneFeature.register(requestContainer);\n                    },\n                    // File-manager storage transport: local disk. Where AWS uses S3 (+ a separate asset-\n                    // delivery Lambda), the single-process server stores files on disk and serves them\n                    // in-process — FileManagerStandaloneFeature registers local asset delivery (overriding\n                    // the domain's null impls), the upload/multipart HTTP routes, and disk file ops.\n                    fileManager: requestContainer => {\n                        FileManagerStandaloneFeature.register(\n                            requestContainer,\n                            standaloneConfig.fileStorage\n                        );\n                    }\n                }\n            });\n        },\n\n        onServer: async (server, rootContainer) => {\n            // Attach the WebSockets upgrade handler to the running HTTP server, backed by the shared\n            // (root) connection manager so request-time sends reach the live sockets.\n            //\n            // Authenticate each WebSocket connection from its `?token` JWT so it's registered under\n            // the real identity (targeted server→client sends match by identity id). It's a callback\n            // the handler supplies rather than something the WS server resolves itself — see\n            // createWebsocketsAuthenticator for why (AuthenticationContext is per-request, unreachable\n            // from the root container the WS server is attached to).\n            const connectionManager = rootContainer.resolve(WebsocketsConnectionManager);\n            const websockets = attachWebsocketsServer({\n                server,\n                connectionManager,\n                authenticate: createWebsocketsAuthenticator(rootContainer, config.extensions)\n            });\n            await websockets.start();\n            stopWebsockets = () => websockets.stop();\n\n            // Receive sends and disconnects other API processes publish for this one's sockets.\n            const messageBus = rootContainer.resolve(WebsocketsMessageBus);\n            const processOwner = rootContainer.resolve(ProcessOwner);\n            const adapter = rootContainer.resolve(WebsocketsServerAdapter);\n            const handleBusMessage = createBusMessageHandler({\n                connectionManager,\n                adapter,\n                logger: consoleLogger\n            });\n            await messageBus.subscribe(processOwner.id, handleBusMessage);\n            closeMessageBus = () => messageBus.close();\n            consoleLogger.info(\n                { messageBus: standaloneConfig.redisUrl ? \"redis\" : \"in-process\" },\n                \"[websockets] using message bus\"\n            );\n\n            /*\n             * Start the in-process scheduler timers, then re-arm persisted schedules in the\n             * background, at boot and then every minute (see startSchedulerServer).\n             */\n            stopScheduler = await startSchedulerServer(rootContainer);\n\n            // Start the periodic empty-trash-bin trigger.\n            startBulkActionsServer(rootContainer);\n\n            /*\n             * Take over tasks a restart or another process left behind, at boot and then every\n             * minute (see startTaskRecovery).\n             */\n            stopTaskRecovery = startTaskRecovery(rootContainer);\n        },\n\n        onShutdown: async rootContainer => {\n            /*\n             * Stop starting new work first: task recovery, and the scheduler's timers and recovery.\n             * Then wait for what is running: tasks hand themselves back, so another process picks\n             * them up at its next sweep, and scheduled actions already running get to finish.\n             * Websockets close at the same time, with 1012 so clients reconnect to a process that\n             * is up, and their connections leave the registry; that takes about a second. The\n             * message bus closes last, once tasks and scheduled actions are done: what they still\n             * send to browsers on other processes goes through it.\n             */\n            stopTaskRecovery?.();\n            const tasks = stopBackgroundTasks(rootContainer, SHUTDOWN_WAIT_MS);\n            const scheduledActions = stopScheduler?.(SHUTDOWN_WAIT_MS);\n            const websockets = stopWebsockets?.();\n            const workDone = Promise.allSettled([tasks, scheduledActions]);\n            const messageBus = workDone.then(() => closeMessageBus?.());\n\n            // One failing part must not cut the others short; the first failure is reported after.\n            const results = await Promise.allSettled([\n                tasks,\n                scheduledActions,\n                websockets,\n                messageBus\n            ]);\n            const failed = results.find((result): result is PromiseRejectedResult => {\n                return result.status === \"rejected\";\n            });\n            if (failed) {\n                throw failed.reason;\n            }\n        }\n    });\n}\n"],"names":["SHUTDOWN_WAIT_MS","createWebinyApiHandler","config","stopTaskRecovery","stopScheduler","stopWebsockets","closeMessageBus","standaloneConfig","readStandaloneConfig","process","createServerHandler","rootContainer","StandaloneConfig","RandomProcessOwner","mkdirSync","NodeHttpFeature","NodeHttpIdentityLoaderDecorator","NodeHttpTenantLoaderDecorator","NodeHttpAssumePermissionsDecorator","ServerConnectionManager","NodeWsAdapter","WebsocketsRedisFeature","consoleLogger","InProcessMessageBus","GraphQLSchemaCacheFeature","EncryptionKeyCacheFeature","JwksStoreFeature","BackgroundTasksStandaloneFeature","registerSchedulerServer","EmptyTrashBinsFeature","container","registerApiRequestStack","requestContainer","ConfigPublicUrlsFeature","WebsocketsStandaloneFeature","FileManagerStandaloneFeature","server","connectionManager","WebsocketsConnectionManager","websockets","attachWebsocketsServer","createWebsocketsAuthenticator","messageBus","WebsocketsMessageBus","processOwner","ProcessOwner","adapter","WebsocketsServerAdapter","handleBusMessage","createBusMessageHandler","startSchedulerServer","startBulkActionsServer","startTaskRecovery","tasks","stopBackgroundTasks","scheduledActions","workDone","Promise","results","failed","result"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAyEA,MAAMA,mBAAmB;AAElB,SAASC,uBAAuBC,MAAoC;IACvE,IAAIC;IACJ,IAAIC;IACJ,IAAIC;IACJ,IAAIC;IAIJ,MAAMC,mBAAmBC,qBAAqBC,QAAQ,GAAG;IAEzD,OAAOC,oBAAoB;QACvB,MAAM,OAAMC;YACRA,cAAc,gBAAgB,CAACC,kBAAkBL;YAGjDI,cAAc,QAAQ,CAACE,oBAAoB,gBAAgB;YAC3DC,UAAUP,iBAAiB,WAAW,CAAC,WAAW,EAAE;gBAAE,WAAW;YAAK;YAItEQ,gBAAgB,QAAQ,CAACJ;YASzBA,cAAc,iBAAiB,CAACK;YAChCL,cAAc,iBAAiB,CAACM;YAGhCN,cAAc,iBAAiB,CAACO;YAGhC,MAAMhB,OAAO,mBAAmB,CAACS;YAOjCA,cAAc,QAAQ,CAACQ,yBAAyB,gBAAgB;YAChER,cAAc,QAAQ,CAACS,eAAe,gBAAgB;YAMtD,IAAIb,iBAAiB,QAAQ,EACzBc,uBAAuB,QAAQ,CAACV,eAAe;gBAC3C,KAAKJ,iBAAiB,QAAQ;gBAC9B,QAAQe;YACZ;iBAEAX,cAAc,QAAQ,CAACY,qBAAqB,gBAAgB;YAKhEC,0BAA0B,QAAQ,CAACb;YAInCc,0BAA0B,QAAQ,CAACd;YAEnCe,iBAAiB,QAAQ,CAACf;YAO1BgB,iCAAiC,QAAQ,CAAChB;YAS1CiB,wBAAwBjB;YAKxBkB,sBAAsB,QAAQ,CAAClB;QACnC;QAEA,OAAO,OAAMmB;YAKT,MAAMC,wBAAwBD,WAAW;gBACrC,YAAY5B,OAAO,UAAU;gBAU7B,YAAY;oBAGR,YAAY8B,CAAAA;wBACRC,wBAAwB,QAAQ,CAACD;oBACrC;oBAGA,UAAUA,CAAAA;wBACNE,4BAA4B,QAAQ,CAACF;oBACzC;oBAKA,aAAaA,CAAAA;wBACTG,6BAA6B,QAAQ,CACjCH,kBACAzB,iBAAiB,WAAW;oBAEpC;gBACJ;YACJ;QACJ;QAEA,UAAU,OAAO6B,QAAQzB;YASrB,MAAM0B,oBAAoB1B,cAAc,OAAO,CAAC2B;YAChD,MAAMC,aAAaC,uBAAuB;gBACtCJ;gBACAC;gBACA,cAAcI,8BAA8B9B,eAAeT,OAAO,UAAU;YAChF;YACA,MAAMqC,WAAW,KAAK;YACtBlC,iBAAiB,IAAMkC,WAAW,IAAI;YAGtC,MAAMG,aAAa/B,cAAc,OAAO,CAACgC;YACzC,MAAMC,eAAejC,cAAc,OAAO,CAACkC;YAC3C,MAAMC,UAAUnC,cAAc,OAAO,CAACoC;YACtC,MAAMC,mBAAmBC,wBAAwB;gBAC7CZ;gBACAS;gBACA,QAAQxB;YACZ;YACA,MAAMoB,WAAW,SAAS,CAACE,aAAa,EAAE,EAAEI;YAC5C1C,kBAAkB,IAAMoC,WAAW,KAAK;YACxCpB,cAAc,IAAI,CACd;gBAAE,YAAYf,iBAAiB,QAAQ,GAAG,UAAU;YAAa,GACjE;YAOJH,gBAAgB,MAAM8C,qBAAqBvC;YAG3CwC,uBAAuBxC;YAMvBR,mBAAmBiD,kBAAkBzC;QACzC;QAEA,YAAY,OAAMA;YAUdR;YACA,MAAMkD,QAAQC,oBAAoB3C,eAAeX;YACjD,MAAMuD,mBAAmBnD,gBAAgBJ;YACzC,MAAMuC,aAAalC;YACnB,MAAMmD,WAAWC,QAAQ,UAAU,CAAC;gBAACJ;gBAAOE;aAAiB;YAC7D,MAAMb,aAAac,SAAS,IAAI,CAAC,IAAMlD;YAGvC,MAAMoD,UAAU,MAAMD,QAAQ,UAAU,CAAC;gBACrCJ;gBACAE;gBACAhB;gBACAG;aACH;YACD,MAAMiB,SAASD,QAAQ,IAAI,CAAC,CAACE,SAClBA,AAAkB,eAAlBA,OAAO,MAAM;YAExB,IAAID,QACA,MAAMA,OAAO,MAAM;QAE3B;IACJ;AACJ"}

package/logger/consoleLogger.d.ts

@@ -0,0 +1,2 @@
+import type { Logger } from "@webiny/api-core/features/logger/abstractions.js";
+export declare const consoleLogger: Logger.Interface;

package/logger/consoleLogger.js

@@ -0,0 +1,12 @@
+const consoleLogger = {
+    trace: (...args)=>console.trace(...args),
+    debug: (...args)=>console.debug(...args),
+    info: (...args)=>console.info(...args),
+    warn: (...args)=>console.warn(...args),
+    error: (...args)=>console.error(...args),
+    fatal: (...args)=>console.error(...args),
+    log: (...args)=>console.log(...args)
+};
+export { consoleLogger };
+
+//# sourceMappingURL=consoleLogger.js.map

package/logger/consoleLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger/consoleLogger.js","sources":["../../src/logger/consoleLogger.ts"],"sourcesContent":["import type { Logger } from \"@webiny/api-core/features/logger/abstractions.js\";\n\n/*\n * Minimal console-backed logger for root singletons: the scheduler and the websocket message bus.\n * The real DI Logger is registered per-request (via ApiCoreFeature/LoggerFeature), so it isn't\n * resolvable at the root where these singletons are built. And even if we bridged to it, they run\n * outside any request, so there's no request context for a context-aware logger to enrich, and\n * console is functionally equivalent, not a downgrade. Revisit (a shared boot-time logger for all\n * root singletons) tracked in https://github.com/webiny/webiny-js/issues/5446.\n */\nexport const consoleLogger: Logger.Interface = {\n    trace: (...args: any[]) => console.trace(...args),\n    debug: (...args: any[]) => console.debug(...args),\n    info: (...args: any[]) => console.info(...args),\n    warn: (...args: any[]) => console.warn(...args),\n    error: (...args: any[]) => console.error(...args),\n    fatal: (...args: any[]) => console.error(...args),\n    log: (...args: any[]) => console.log(...args)\n};\n"],"names":["consoleLogger","args","console"],"mappings":"AAUO,MAAMA,gBAAkC;IAC3C,OAAO,CAAC,GAAGC,OAAgBC,QAAQ,KAAK,IAAID;IAC5C,OAAO,CAAC,GAAGA,OAAgBC,QAAQ,KAAK,IAAID;IAC5C,MAAM,CAAC,GAAGA,OAAgBC,QAAQ,IAAI,IAAID;IAC1C,MAAM,CAAC,GAAGA,OAAgBC,QAAQ,IAAI,IAAID;IAC1C,OAAO,CAAC,GAAGA,OAAgBC,QAAQ,KAAK,IAAID;IAC5C,OAAO,CAAC,GAAGA,OAAgBC,QAAQ,KAAK,IAAID;IAC5C,KAAK,CAAC,GAAGA,OAAgBC,QAAQ,GAAG,IAAID;AAC5C"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@webiny/api-event-handler-standalone",
-	"version": "0.0.0-unstable.7c2def32a7",
+	"version": "0.0.0-unstable.d0f34a8194",
 	"type": "module",
 	"main": "index.js",
 	"exports": {
@@ -18,25 +18,26 @@
 	],
 	"license": "MIT",
 	"dependencies": {
-		"@webiny/api-core": "0.0.0-unstable.7c2def32a7",
-		"@webiny/api-event-handler-core": "0.0.0-unstable.7c2def32a7",
-		"@webiny/api-file-manager-standalone": "0.0.0-unstable.7c2def32a7",
-		"@webiny/api-graphql": "0.0.0-unstable.7c2def32a7",
-		"@webiny/api-headless-cms-bulk-actions-standalone": "0.0.0-unstable.7c2def32a7",
-		"@webiny/api-scheduler": "0.0.0-unstable.7c2def32a7",
-		"@webiny/api-scheduler-standalone": "0.0.0-unstable.7c2def32a7",
-		"@webiny/api-websockets-standalone": "0.0.0-unstable.7c2def32a7",
-		"@webiny/background-tasks-standalone": "0.0.0-unstable.7c2def32a7",
-		"@webiny/event-handler-core": "0.0.0-unstable.7c2def32a7",
-		"@webiny/event-handler-standalone": "0.0.0-unstable.7c2def32a7",
-		"@webiny/feature": "0.0.0-unstable.7c2def32a7",
-		"@webiny/handler": "0.0.0-unstable.7c2def32a7"
+		"@webiny/api-core": "0.0.0-unstable.d0f34a8194",
+		"@webiny/api-event-handler-core": "0.0.0-unstable.d0f34a8194",
+		"@webiny/api-file-manager-standalone": "0.0.0-unstable.d0f34a8194",
+		"@webiny/api-graphql": "0.0.0-unstable.d0f34a8194",
+		"@webiny/api-headless-cms-bulk-actions-standalone": "0.0.0-unstable.d0f34a8194",
+		"@webiny/api-scheduler": "0.0.0-unstable.d0f34a8194",
+		"@webiny/api-scheduler-standalone": "0.0.0-unstable.d0f34a8194",
+		"@webiny/api-websockets-standalone": "0.0.0-unstable.d0f34a8194",
+		"@webiny/api-websockets-standalone-redis": "0.0.0-unstable.d0f34a8194",
+		"@webiny/background-tasks-standalone": "0.0.0-unstable.d0f34a8194",
+		"@webiny/event-handler-core": "0.0.0-unstable.d0f34a8194",
+		"@webiny/event-handler-standalone": "0.0.0-unstable.d0f34a8194",
+		"@webiny/feature": "0.0.0-unstable.d0f34a8194",
+		"@webiny/handler": "0.0.0-unstable.d0f34a8194"
 	},
 	"peerDependencies": {
 		"@webiny/di": "^2.0.0"
 	},
 	"devDependencies": {
-		"@webiny/build-tools": "0.0.0-unstable.7c2def32a7",
+		"@webiny/build-tools": "0.0.0-unstable.d0f34a8194",
 		"@webiny/di": "2.0.0",
 		"rimraf": "6.1.3",
 		"typescript": "7.0.2",

package/scheduler/schedulerServer.js

@@ -6,15 +6,7 @@ import { SchedulerSingleton } from "./abstractions/SchedulerSingleton.js";
 import { SCHEDULED_ACTION_RECOVER_EVENT_IDENTIFIER, ScheduledActionRecoverEventType } from "./ScheduledActionRecoverEventType.js";
 import { RecoverScheduledActionsHandler } from "./RecoverScheduledActionsHandler.js";
 import { RunScheduledActionOnceDecorator } from "./RunScheduledActionOnceDecorator.js";
-const consoleLogger = {
-    trace: (...args)=>console.trace(...args),
-    debug: (...args)=>console.debug(...args),
-    info: (...args)=>console.info(...args),
-    warn: (...args)=>console.warn(...args),
-    error: (...args)=>console.error(...args),
-    fatal: (...args)=>console.error(...args),
-    log: (...args)=>console.log(...args)
-};
+import { consoleLogger } from "../logger/consoleLogger.js";
 function registerSchedulerServer(rootContainer) {
     const dispatcher = rootContainer.resolve(EventDispatcher);
     const service = new BreeSchedulerService({

package/scheduler/schedulerServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler/schedulerServer.js","sources":["../../src/scheduler/schedulerServer.ts"],"sourcesContent":["import type { Container } from \"@webiny/di\";\nimport { EventDispatcher } from \"@webiny/event-handler-core\";\nimport { ScheduledActionEventType } from \"@webiny/event-handler-core\";\nimport { SCHEDULED_ACTION_EVENT_IDENTIFIER } from \"@webiny/event-handler-core\";\nimport type { IScheduledActionEvent } from \"@webiny/event-handler-core\";\nimport { SchedulerService } from \"@webiny/api-scheduler/shared/abstractions.js\";\nimport { ScheduledActionLambdaHandler } from \"@webiny/api-scheduler\";\nimport { BreeSchedulerService } from \"@webiny/api-scheduler-standalone\";\nimport type { Logger } from \"@webiny/api-core/features/logger/abstractions.js\";\nimport { SchedulerSingleton } from \"./abstractions/SchedulerSingleton.js\";\nimport { ScheduledActionRecoverEventType } from \"./ScheduledActionRecoverEventType.js\";\nimport { SCHEDULED_ACTION_RECOVER_EVENT_IDENTIFIER } from \"./ScheduledActionRecoverEventType.js\";\nimport type { IScheduledActionRecoverEvent } from \"./ScheduledActionRecoverEventType.js\";\nimport { RecoverScheduledActionsHandler } from \"./RecoverScheduledActionsHandler.js\";\nimport { ScheduledActionRecoverEventHandler } from \"./ScheduledActionRecoverEventHandler.js\";\nimport { RunScheduledActionOnceDecorator } from \"./RunScheduledActionOnceDecorator.js\";\n\n/**\n * Minimal console-backed logger for the root scheduler singleton. The real DI Logger is registered\n * per-request (via ApiCoreFeature/LoggerFeature), so it isn't resolvable here at the root where the\n * singleton is built. And even if we bridged to it, timers fire outside any request — there's no\n * request context for a context-aware logger to enrich — so console is functionally equivalent, not\n * a downgrade. Revisit (a shared boot-time logger for all root singletons) tracked in\n * https://github.com/webiny/webiny-js/issues/5446.\n */\nconst consoleLogger: Logger.Interface = {\n    trace: (...args: any[]) => console.trace(...args),\n    debug: (...args: any[]) => console.debug(...args),\n    info: (...args: any[]) => console.info(...args),\n    warn: (...args: any[]) => console.warn(...args),\n    error: (...args: any[]) => console.error(...args),\n    fatal: (...args: any[]) => console.error(...args),\n    log: (...args: any[]) => console.log(...args)\n};\n\n/**\n * ROOT wiring for the standalone (Bree, in-process) scheduler. Unlike AWS (per-request EventBridge\n * binding), the server holds ONE long-lived Bree instance for all tenants, started once at boot —\n * the counterpart of the WebSockets connection manager. Registered as `SchedulerService` so\n * per-request create/update/delete (during GraphQL mutations) manipulate that single live timer set.\n *\n * When a timer fires (outside any request), the singleton dispatches a `ScheduledActionEvent`. The\n * handler is the one AWS runs for an EventBridge Scheduler invocation, in a fresh request container.\n */\nexport function registerSchedulerServer(rootContainer: Container): void {\n    const dispatcher = rootContainer.resolve(EventDispatcher);\n\n    const service = new BreeSchedulerService({\n        logger: consoleLogger,\n        runAction: async (id, namespace, tenant) => {\n            /*\n             * `scheduleFor` is the time it fired. The event type needs one to recognise the event,\n             * and nothing downstream reads it.\n             */\n            const event: IScheduledActionEvent = {\n                [SCHEDULED_ACTION_EVENT_IDENTIFIER]: {\n                    id,\n                    namespace,\n                    tenant,\n                    scheduleFor: new Date().toISOString()\n                }\n            };\n            try {\n                await dispatcher.dispatch(event);\n            } catch (err) {\n                consoleLogger.error(\n                    { error: err, id, tenant },\n                    \"[scheduler] scheduled action failed\"\n                );\n            }\n        }\n    });\n\n    // Register the ONE Bree instance under TWO tokens — two views of the same object:\n    //\n    //   - SchedulerService: the hosting-agnostic contract (create/update/delete/exists) that AWS\n    //     implements too. This is what per-request GraphQL mutations resolve to schedule/reschedule.\n    //   - SchedulerSingleton: typed as the CONCRETE BreeSchedulerService, so it also exposes the\n    //     methods that aren't on that contract — start() and recover(). Those are Bree-only: AWS's\n    //     EventBridge is managed infra (nothing to start) and persists its own schedules (nothing to\n    //     recover), so they don't belong on the shared interface. The boot step + recover handler\n    //     resolve this token precisely because they need start()/recover().\n    //\n    // registerInstance (not register) because it's a single live object holding all tenants' timers —\n    // every caller must get the SAME instance, not a per-scope construction. Registered at root, so\n    // per-request child containers inherit it via the parent chain; nothing registers a per-request\n    // SchedulerService default that would shadow it (unlike e.g. the WS transport's Null default).\n    rootContainer.registerInstance(SchedulerSingleton, service);\n    rootContainer.registerInstance(SchedulerService, service);\n\n    rootContainer.register(ScheduledActionEventType);\n    rootContainer.register(ScheduledActionLambdaHandler);\n    // Every process holds timers for the same actions; this lets only one of them run each action.\n    rootContainer.registerDecorator(RunScheduledActionOnceDecorator);\n\n    rootContainer.register(ScheduledActionRecoverEventType);\n    rootContainer.register(RecoverScheduledActionsHandler);\n}\n\n// How often each process re-arms pending actions and fires overdue ones.\nconst RECOVER_EVERY_MS = 60_000;\n\nasync function recoverPendingSchedules(\n    dispatcher: EventDispatcher.Interface,\n    atBoot: boolean\n): Promise<void> {\n    const event: IScheduledActionRecoverEvent = {\n        [SCHEDULED_ACTION_RECOVER_EVENT_IDENTIFIER]: true\n    };\n\n    try {\n        const result = await dispatcher.dispatch<ScheduledActionRecoverEventHandler.Result>(event);\n        if (atBoot) {\n            consoleLogger.info(\n                { recovered: result.recovered },\n                \"[scheduler] boot recovery re-armed pending actions\"\n            );\n        }\n        if (result.failedTenants.length > 0) {\n            consoleLogger.error(\n                { tenants: result.failedTenants },\n                \"[scheduler] recovery failed for some tenants\"\n            );\n        }\n    } catch (err) {\n        consoleLogger.error({ error: err }, \"[scheduler] recovery failed\");\n    }\n}\n\n/**\n * Boot step (onServer): start the timers, then re-arm the persisted schedules, at boot and then every\n * minute. Recovery runs in the background: it executes overdue actions one by one, and the server\n * should not wait for that before it starts listening. A failure is logged and never crashes startup.\n *\n * Running it every minute is what makes several processes work. Each holds its own timers, so an\n * action scheduled or moved through one process reaches the others' timers within a minute, and an\n * action whose process died is still fired, as an overdue one. `RunScheduledActionOnceDecorator`\n * keeps the processes from all running it. Runs never overlap.\n *\n * Returns a function for the shutdown: it stops the timers and recovery, then waits up to\n * `timeoutMs` for actions already running.\n */\nexport async function startSchedulerServer(\n    rootContainer: Container\n): Promise<(timeoutMs: number) => Promise<void>> {\n    const scheduler = rootContainer.resolve(SchedulerSingleton);\n    await scheduler.start();\n\n    const dispatcher = rootContainer.resolve(EventDispatcher);\n    let recovering = false;\n    const recover = async (atBoot: boolean) => {\n        if (recovering) {\n            return;\n        }\n        recovering = true;\n        try {\n            await recoverPendingSchedules(dispatcher, atBoot);\n        } finally {\n            recovering = false;\n        }\n    };\n\n    void recover(true);\n    const everyMinute = setInterval(() => {\n        void recover(false);\n    }, RECOVER_EVERY_MS);\n\n    return async (timeoutMs: number) => {\n        clearInterval(everyMinute);\n        await scheduler.stop();\n        await scheduler.waitForRunning(timeoutMs);\n    };\n}\n"],"names":["consoleLogger","args","console","registerSchedulerServer","rootContainer","dispatcher","EventDispatcher","service","BreeSchedulerService","id","namespace","tenant","event","SCHEDULED_ACTION_EVENT_IDENTIFIER","Date","err","SchedulerSingleton","SchedulerService","ScheduledActionEventType","ScheduledActionLambdaHandler","RunScheduledActionOnceDecorator","ScheduledActionRecoverEventType","RecoverScheduledActionsHandler","RECOVER_EVERY_MS","recoverPendingSchedules","atBoot","SCHEDULED_ACTION_RECOVER_EVENT_IDENTIFIER","result","startSchedulerServer","scheduler","recovering","recover","everyMinute","setInterval","timeoutMs","clearInterval"],"mappings":";;;;;;;;AAyBA,MAAMA,gBAAkC;IACpC,OAAO,CAAC,GAAGC,OAAgBC,QAAQ,KAAK,IAAID;IAC5C,OAAO,CAAC,GAAGA,OAAgBC,QAAQ,KAAK,IAAID;IAC5C,MAAM,CAAC,GAAGA,OAAgBC,QAAQ,IAAI,IAAID;IAC1C,MAAM,CAAC,GAAGA,OAAgBC,QAAQ,IAAI,IAAID;IAC1C,OAAO,CAAC,GAAGA,OAAgBC,QAAQ,KAAK,IAAID;IAC5C,OAAO,CAAC,GAAGA,OAAgBC,QAAQ,KAAK,IAAID;IAC5C,KAAK,CAAC,GAAGA,OAAgBC,QAAQ,GAAG,IAAID;AAC5C;AAWO,SAASE,wBAAwBC,aAAwB;IAC5D,MAAMC,aAAaD,cAAc,OAAO,CAACE;IAEzC,MAAMC,UAAU,IAAIC,qBAAqB;QACrC,QAAQR;QACR,WAAW,OAAOS,IAAIC,WAAWC;YAK7B,MAAMC,QAA+B;gBACjC,CAACC,kCAAkC,EAAE;oBACjCJ;oBACAC;oBACAC;oBACA,aAAa,IAAIG,OAAO,WAAW;gBACvC;YACJ;YACA,IAAI;gBACA,MAAMT,WAAW,QAAQ,CAACO;YAC9B,EAAE,OAAOG,KAAK;gBACVf,cAAc,KAAK,CACf;oBAAE,OAAOe;oBAAKN;oBAAIE;gBAAO,GACzB;YAER;QACJ;IACJ;IAgBAP,cAAc,gBAAgB,CAACY,oBAAoBT;IACnDH,cAAc,gBAAgB,CAACa,kBAAkBV;IAEjDH,cAAc,QAAQ,CAACc;IACvBd,cAAc,QAAQ,CAACe;IAEvBf,cAAc,iBAAiB,CAACgB;IAEhChB,cAAc,QAAQ,CAACiB;IACvBjB,cAAc,QAAQ,CAACkB;AAC3B;AAGA,MAAMC,mBAAmB;AAEzB,eAAeC,wBACXnB,UAAqC,EACrCoB,MAAe;IAEf,MAAMb,QAAsC;QACxC,CAACc,0CAA0C,EAAE;IACjD;IAEA,IAAI;QACA,MAAMC,SAAS,MAAMtB,WAAW,QAAQ,CAA4CO;QACpF,IAAIa,QACAzB,cAAc,IAAI,CACd;YAAE,WAAW2B,OAAO,SAAS;QAAC,GAC9B;QAGR,IAAIA,OAAO,aAAa,CAAC,MAAM,GAAG,GAC9B3B,cAAc,KAAK,CACf;YAAE,SAAS2B,OAAO,aAAa;QAAC,GAChC;IAGZ,EAAE,OAAOZ,KAAK;QACVf,cAAc,KAAK,CAAC;YAAE,OAAOe;QAAI,GAAG;IACxC;AACJ;AAeO,eAAea,qBAClBxB,aAAwB;IAExB,MAAMyB,YAAYzB,cAAc,OAAO,CAACY;IACxC,MAAMa,UAAU,KAAK;IAErB,MAAMxB,aAAaD,cAAc,OAAO,CAACE;IACzC,IAAIwB,aAAa;IACjB,MAAMC,UAAU,OAAON;QACnB,IAAIK,YACA;QAEJA,aAAa;QACb,IAAI;YACA,MAAMN,wBAAwBnB,YAAYoB;QAC9C,SAAU;YACNK,aAAa;QACjB;IACJ;IAEKC,QAAQ;IACb,MAAMC,cAAcC,YAAY;QACvBF,QAAQ;IACjB,GAAGR;IAEH,OAAO,OAAOW;QACVC,cAAcH;QACd,MAAMH,UAAU,IAAI;QACpB,MAAMA,UAAU,cAAc,CAACK;IACnC;AACJ"}
+{"version":3,"file":"scheduler/schedulerServer.js","sources":["../../src/scheduler/schedulerServer.ts"],"sourcesContent":["import type { Container } from \"@webiny/di\";\nimport { EventDispatcher } from \"@webiny/event-handler-core\";\nimport { ScheduledActionEventType } from \"@webiny/event-handler-core\";\nimport { SCHEDULED_ACTION_EVENT_IDENTIFIER } from \"@webiny/event-handler-core\";\nimport type { IScheduledActionEvent } from \"@webiny/event-handler-core\";\nimport { SchedulerService } from \"@webiny/api-scheduler/shared/abstractions.js\";\nimport { ScheduledActionLambdaHandler } from \"@webiny/api-scheduler\";\nimport { BreeSchedulerService } from \"@webiny/api-scheduler-standalone\";\nimport { SchedulerSingleton } from \"./abstractions/SchedulerSingleton.js\";\nimport { ScheduledActionRecoverEventType } from \"./ScheduledActionRecoverEventType.js\";\nimport { SCHEDULED_ACTION_RECOVER_EVENT_IDENTIFIER } from \"./ScheduledActionRecoverEventType.js\";\nimport type { IScheduledActionRecoverEvent } from \"./ScheduledActionRecoverEventType.js\";\nimport { RecoverScheduledActionsHandler } from \"./RecoverScheduledActionsHandler.js\";\nimport { ScheduledActionRecoverEventHandler } from \"./ScheduledActionRecoverEventHandler.js\";\nimport { RunScheduledActionOnceDecorator } from \"./RunScheduledActionOnceDecorator.js\";\nimport { consoleLogger } from \"~/logger/consoleLogger.js\";\n\n/**\n * ROOT wiring for the standalone (Bree, in-process) scheduler. Unlike AWS (per-request EventBridge\n * binding), the server holds ONE long-lived Bree instance for all tenants, started once at boot —\n * the counterpart of the WebSockets connection manager. Registered as `SchedulerService` so\n * per-request create/update/delete (during GraphQL mutations) manipulate that single live timer set.\n *\n * When a timer fires (outside any request), the singleton dispatches a `ScheduledActionEvent`. The\n * handler is the one AWS runs for an EventBridge Scheduler invocation, in a fresh request container.\n */\nexport function registerSchedulerServer(rootContainer: Container): void {\n    const dispatcher = rootContainer.resolve(EventDispatcher);\n\n    const service = new BreeSchedulerService({\n        logger: consoleLogger,\n        runAction: async (id, namespace, tenant) => {\n            /*\n             * `scheduleFor` is the time it fired. The event type needs one to recognise the event,\n             * and nothing downstream reads it.\n             */\n            const event: IScheduledActionEvent = {\n                [SCHEDULED_ACTION_EVENT_IDENTIFIER]: {\n                    id,\n                    namespace,\n                    tenant,\n                    scheduleFor: new Date().toISOString()\n                }\n            };\n            try {\n                await dispatcher.dispatch(event);\n            } catch (err) {\n                consoleLogger.error(\n                    { error: err, id, tenant },\n                    \"[scheduler] scheduled action failed\"\n                );\n            }\n        }\n    });\n\n    // Register the ONE Bree instance under TWO tokens — two views of the same object:\n    //\n    //   - SchedulerService: the hosting-agnostic contract (create/update/delete/exists) that AWS\n    //     implements too. This is what per-request GraphQL mutations resolve to schedule/reschedule.\n    //   - SchedulerSingleton: typed as the CONCRETE BreeSchedulerService, so it also exposes the\n    //     methods that aren't on that contract — start() and recover(). Those are Bree-only: AWS's\n    //     EventBridge is managed infra (nothing to start) and persists its own schedules (nothing to\n    //     recover), so they don't belong on the shared interface. The boot step + recover handler\n    //     resolve this token precisely because they need start()/recover().\n    //\n    // registerInstance (not register) because it's a single live object holding all tenants' timers —\n    // every caller must get the SAME instance, not a per-scope construction. Registered at root, so\n    // per-request child containers inherit it via the parent chain; nothing registers a per-request\n    // SchedulerService default that would shadow it (unlike e.g. the WS transport's Null default).\n    rootContainer.registerInstance(SchedulerSingleton, service);\n    rootContainer.registerInstance(SchedulerService, service);\n\n    rootContainer.register(ScheduledActionEventType);\n    rootContainer.register(ScheduledActionLambdaHandler);\n    // Every process holds timers for the same actions; this lets only one of them run each action.\n    rootContainer.registerDecorator(RunScheduledActionOnceDecorator);\n\n    rootContainer.register(ScheduledActionRecoverEventType);\n    rootContainer.register(RecoverScheduledActionsHandler);\n}\n\n// How often each process re-arms pending actions and fires overdue ones.\nconst RECOVER_EVERY_MS = 60_000;\n\nasync function recoverPendingSchedules(\n    dispatcher: EventDispatcher.Interface,\n    atBoot: boolean\n): Promise<void> {\n    const event: IScheduledActionRecoverEvent = {\n        [SCHEDULED_ACTION_RECOVER_EVENT_IDENTIFIER]: true\n    };\n\n    try {\n        const result = await dispatcher.dispatch<ScheduledActionRecoverEventHandler.Result>(event);\n        if (atBoot) {\n            consoleLogger.info(\n                { recovered: result.recovered },\n                \"[scheduler] boot recovery re-armed pending actions\"\n            );\n        }\n        if (result.failedTenants.length > 0) {\n            consoleLogger.error(\n                { tenants: result.failedTenants },\n                \"[scheduler] recovery failed for some tenants\"\n            );\n        }\n    } catch (err) {\n        consoleLogger.error({ error: err }, \"[scheduler] recovery failed\");\n    }\n}\n\n/**\n * Boot step (onServer): start the timers, then re-arm the persisted schedules, at boot and then every\n * minute. Recovery runs in the background: it executes overdue actions one by one, and the server\n * should not wait for that before it starts listening. A failure is logged and never crashes startup.\n *\n * Running it every minute is what makes several processes work. Each holds its own timers, so an\n * action scheduled or moved through one process reaches the others' timers within a minute, and an\n * action whose process died is still fired, as an overdue one. `RunScheduledActionOnceDecorator`\n * keeps the processes from all running it. Runs never overlap.\n *\n * Returns a function for the shutdown: it stops the timers and recovery, then waits up to\n * `timeoutMs` for actions already running.\n */\nexport async function startSchedulerServer(\n    rootContainer: Container\n): Promise<(timeoutMs: number) => Promise<void>> {\n    const scheduler = rootContainer.resolve(SchedulerSingleton);\n    await scheduler.start();\n\n    const dispatcher = rootContainer.resolve(EventDispatcher);\n    let recovering = false;\n    const recover = async (atBoot: boolean) => {\n        if (recovering) {\n            return;\n        }\n        recovering = true;\n        try {\n            await recoverPendingSchedules(dispatcher, atBoot);\n        } finally {\n            recovering = false;\n        }\n    };\n\n    void recover(true);\n    const everyMinute = setInterval(() => {\n        void recover(false);\n    }, RECOVER_EVERY_MS);\n\n    return async (timeoutMs: number) => {\n        clearInterval(everyMinute);\n        await scheduler.stop();\n        await scheduler.waitForRunning(timeoutMs);\n    };\n}\n"],"names":["registerSchedulerServer","rootContainer","dispatcher","EventDispatcher","service","BreeSchedulerService","consoleLogger","id","namespace","tenant","event","SCHEDULED_ACTION_EVENT_IDENTIFIER","Date","err","SchedulerSingleton","SchedulerService","ScheduledActionEventType","ScheduledActionLambdaHandler","RunScheduledActionOnceDecorator","ScheduledActionRecoverEventType","RecoverScheduledActionsHandler","RECOVER_EVERY_MS","recoverPendingSchedules","atBoot","SCHEDULED_ACTION_RECOVER_EVENT_IDENTIFIER","result","startSchedulerServer","scheduler","recovering","recover","everyMinute","setInterval","timeoutMs","clearInterval"],"mappings":";;;;;;;;;AA0BO,SAASA,wBAAwBC,aAAwB;IAC5D,MAAMC,aAAaD,cAAc,OAAO,CAACE;IAEzC,MAAMC,UAAU,IAAIC,qBAAqB;QACrC,QAAQC;QACR,WAAW,OAAOC,IAAIC,WAAWC;YAK7B,MAAMC,QAA+B;gBACjC,CAACC,kCAAkC,EAAE;oBACjCJ;oBACAC;oBACAC;oBACA,aAAa,IAAIG,OAAO,WAAW;gBACvC;YACJ;YACA,IAAI;gBACA,MAAMV,WAAW,QAAQ,CAACQ;YAC9B,EAAE,OAAOG,KAAK;gBACVP,cAAc,KAAK,CACf;oBAAE,OAAOO;oBAAKN;oBAAIE;gBAAO,GACzB;YAER;QACJ;IACJ;IAgBAR,cAAc,gBAAgB,CAACa,oBAAoBV;IACnDH,cAAc,gBAAgB,CAACc,kBAAkBX;IAEjDH,cAAc,QAAQ,CAACe;IACvBf,cAAc,QAAQ,CAACgB;IAEvBhB,cAAc,iBAAiB,CAACiB;IAEhCjB,cAAc,QAAQ,CAACkB;IACvBlB,cAAc,QAAQ,CAACmB;AAC3B;AAGA,MAAMC,mBAAmB;AAEzB,eAAeC,wBACXpB,UAAqC,EACrCqB,MAAe;IAEf,MAAMb,QAAsC;QACxC,CAACc,0CAA0C,EAAE;IACjD;IAEA,IAAI;QACA,MAAMC,SAAS,MAAMvB,WAAW,QAAQ,CAA4CQ;QACpF,IAAIa,QACAjB,cAAc,IAAI,CACd;YAAE,WAAWmB,OAAO,SAAS;QAAC,GAC9B;QAGR,IAAIA,OAAO,aAAa,CAAC,MAAM,GAAG,GAC9BnB,cAAc,KAAK,CACf;YAAE,SAASmB,OAAO,aAAa;QAAC,GAChC;IAGZ,EAAE,OAAOZ,KAAK;QACVP,cAAc,KAAK,CAAC;YAAE,OAAOO;QAAI,GAAG;IACxC;AACJ;AAeO,eAAea,qBAClBzB,aAAwB;IAExB,MAAM0B,YAAY1B,cAAc,OAAO,CAACa;IACxC,MAAMa,UAAU,KAAK;IAErB,MAAMzB,aAAaD,cAAc,OAAO,CAACE;IACzC,IAAIyB,aAAa;IACjB,MAAMC,UAAU,OAAON;QACnB,IAAIK,YACA;QAEJA,aAAa;QACb,IAAI;YACA,MAAMN,wBAAwBpB,YAAYqB;QAC9C,SAAU;YACNK,aAAa;QACjB;IACJ;IAEKC,QAAQ;IACb,MAAMC,cAAcC,YAAY;QACvBF,QAAQ;IACjB,GAAGR;IAEH,OAAO,OAAOW;QACVC,cAAcH;QACd,MAAMH,UAAU,IAAI;QACpB,MAAMA,UAAU,cAAc,CAACK;IACnC;AACJ"}