@webiny/api-event-handler-standalone 0.0.0-unstable.0156a4c312

package/handlers/NodeHttpAssumePermissionsDecorator.d.ts

@@ -0,0 +1,19 @@
+import type { IncomingMessage } from "node:http";
+import { NodeHttpEventHandler } from "@webiny/event-handler-standalone";
+import { RawAssumePermissions } from "@webiny/api-core/features/requestContext/index.js";
+import type { EventContext } from "@webiny/event-handler-core";
+import type { NextFunction } from "@webiny/event-handler-core";
+/**
+ * EXTRACT (transport-specific): reads the `x-webiny-assume-permissions` header of a Node
+ * `IncomingMessage` into RawAssumePermissions. Node mirror of ApiGatewayAssumePermissionsDecorator.
+ */
+declare class NodeHttpAssumePermissionsDecoratorImpl implements NodeHttpEventHandler.Interface {
+    private rawAssumePermissions;
+    private decoratee;
+    constructor(rawAssumePermissions: RawAssumePermissions.Interface, decoratee: NodeHttpEventHandler.Interface);
+    execute(ctx: EventContext<IncomingMessage>, next: NextFunction): Promise<any>;
+}
+export declare const NodeHttpAssumePermissionsDecorator: typeof NodeHttpAssumePermissionsDecoratorImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/event-handler-standalone").INodeHttpEventHandler>;
+};
+export {};

package/handlers/NodeHttpAssumePermissionsDecorator.js

@@ -0,0 +1,23 @@
+import { NodeHttpEventHandler } from "@webiny/event-handler-standalone";
+import { RawAssumePermissions, extractAssumePermissions } from "@webiny/api-core/features/requestContext/index.js";
+class NodeHttpAssumePermissionsDecoratorImpl {
+    constructor(rawAssumePermissions, decoratee){
+        this.rawAssumePermissions = rawAssumePermissions;
+        this.decoratee = decoratee;
+    }
+    async execute(ctx, next) {
+        const headers = ctx.event?.headers;
+        const requested = extractAssumePermissions(headers);
+        this.rawAssumePermissions.set(requested);
+        return this.decoratee.execute(ctx, next);
+    }
+}
+const NodeHttpAssumePermissionsDecorator = NodeHttpEventHandler.createDecorator({
+    decorator: NodeHttpAssumePermissionsDecoratorImpl,
+    dependencies: [
+        RawAssumePermissions
+    ]
+});
+export { NodeHttpAssumePermissionsDecorator };
+
+//# sourceMappingURL=NodeHttpAssumePermissionsDecorator.js.map

package/handlers/NodeHttpAssumePermissionsDecorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers/NodeHttpAssumePermissionsDecorator.js","sources":["../../src/handlers/NodeHttpAssumePermissionsDecorator.ts"],"sourcesContent":["import type { IncomingMessage } from \"node:http\";\nimport { NodeHttpEventHandler } from \"@webiny/event-handler-standalone\";\nimport { RawAssumePermissions } from \"@webiny/api-core/features/requestContext/index.js\";\nimport { extractAssumePermissions } from \"@webiny/api-core/features/requestContext/index.js\";\nimport type { EventContext } from \"@webiny/event-handler-core\";\nimport type { NextFunction } from \"@webiny/event-handler-core\";\n\n/**\n * EXTRACT (transport-specific): reads the `x-webiny-assume-permissions` header of a Node\n * `IncomingMessage` into RawAssumePermissions. Node mirror of ApiGatewayAssumePermissionsDecorator.\n */\nclass NodeHttpAssumePermissionsDecoratorImpl implements NodeHttpEventHandler.Interface {\n    constructor(\n        private rawAssumePermissions: RawAssumePermissions.Interface,\n        private decoratee: NodeHttpEventHandler.Interface\n    ) {}\n\n    async execute(ctx: EventContext<IncomingMessage>, next: NextFunction): Promise<any> {\n        const headers = ctx.event?.headers;\n        const requested = extractAssumePermissions(headers);\n\n        this.rawAssumePermissions.set(requested);\n\n        return this.decoratee.execute(ctx, next);\n    }\n}\n\nexport const NodeHttpAssumePermissionsDecorator = NodeHttpEventHandler.createDecorator({\n    decorator: NodeHttpAssumePermissionsDecoratorImpl,\n    dependencies: [RawAssumePermissions]\n});\n"],"names":["NodeHttpAssumePermissionsDecoratorImpl","rawAssumePermissions","decoratee","ctx","next","headers","requested","extractAssumePermissions","NodeHttpAssumePermissionsDecorator","NodeHttpEventHandler","RawAssumePermissions"],"mappings":";;AAWA,MAAMA;IACF,YACYC,oBAAoD,EACpDC,SAAyC,CACnD;aAFUD,oBAAoB,GAApBA;aACAC,SAAS,GAATA;IACT;IAEH,MAAM,QAAQC,GAAkC,EAAEC,IAAkB,EAAgB;QAChF,MAAMC,UAAUF,IAAI,KAAK,EAAE;QAC3B,MAAMG,YAAYC,yBAAyBF;QAE3C,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAACC;QAE9B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAACH,KAAKC;IACvC;AACJ;AAEO,MAAMI,qCAAqCC,qBAAqB,eAAe,CAAC;IACnF,WAAWT;IACX,cAAc;QAACU;KAAqB;AACxC"}

package/handlers/NodeHttpIdentityLoaderDecorator.d.ts

@@ -0,0 +1,32 @@
+import type { IncomingMessage } from "node:http";
+import { NodeHttpEventHandler } from "@webiny/event-handler-standalone";
+import { RawAuthToken } from "@webiny/api-core/features/requestContext/index.js";
+import type { IRequestIdentityLoader } from "@webiny/api-core/features/requestContext/abstractions.js";
+import type { EventContext, NextFunction } from "@webiny/event-handler-core";
+/**
+ * EXTRACT (transport-specific): reads the auth token from a Node `IncomingMessage` —
+ * `x-webiny-authorization` first, then the bearer `Authorization` header, then the `wby-id-token`
+ * cookie — into RawAuthToken, then invokes the shared LOAD step (RequestIdentityLoader) which
+ * authenticates it (via the registered identity provider, e.g. the self-hosted JWT IdP) and sets
+ * IdentityContext.
+ *
+ * `x-webiny-authorization` exists for AWS parity: behind CloudFront with Origin Access Control, SigV4
+ * occupies the `Authorization` header, so clients that may traverse such an origin send the token in
+ * that header instead. Standalone has no such constraint, but it accepts the same header so one
+ * client works against both deployments.
+ *
+ * Node mirror of ApiGatewayIdentityLoaderDecorator. Registered BEFORE the tenant loader so identity
+ * is established before tenant.
+ */
+declare class NodeHttpIdentityLoaderDecoratorImpl implements NodeHttpEventHandler.Interface {
+    private rawAuthToken;
+    private identityLoader;
+    private decoratee;
+    constructor(rawAuthToken: RawAuthToken.Interface, identityLoader: IRequestIdentityLoader, decoratee: NodeHttpEventHandler.Interface);
+    execute(ctx: EventContext<IncomingMessage>, next: NextFunction): Promise<any>;
+    private extractToken;
+}
+export declare const NodeHttpIdentityLoaderDecorator: typeof NodeHttpIdentityLoaderDecoratorImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/event-handler-standalone").INodeHttpEventHandler>;
+};
+export {};

package/handlers/NodeHttpIdentityLoaderDecorator.js

@@ -0,0 +1,45 @@
+import { NodeHttpEventHandler } from "@webiny/event-handler-standalone";
+import { RawAuthToken, RequestIdentityLoader } from "@webiny/api-core/features/requestContext/index.js";
+function headerValue(value) {
+    if (Array.isArray(value)) return value[0] ?? "";
+    return value ?? "";
+}
+function parseCookieHeader(cookieHeader) {
+    return cookieHeader.split(";").reduce((acc, pair)=>{
+        const idx = pair.indexOf("=");
+        if (idx > 0) acc[pair.slice(0, idx).trim()] = decodeURIComponent(pair.slice(idx + 1).trim());
+        return acc;
+    }, {});
+}
+class NodeHttpIdentityLoaderDecoratorImpl {
+    constructor(rawAuthToken, identityLoader, decoratee){
+        this.rawAuthToken = rawAuthToken;
+        this.identityLoader = identityLoader;
+        this.decoratee = decoratee;
+    }
+    async execute(ctx, next) {
+        this.rawAuthToken.set(this.extractToken(ctx.event));
+        await this.identityLoader.establish();
+        return this.decoratee.execute(ctx, next);
+    }
+    extractToken(event) {
+        const headers = event?.headers;
+        if (!headers) return null;
+        const webinyAuth = headerValue(headers["x-webiny-authorization"] ?? headers["X-Webiny-Authorization"]).replace(/^Bearer\s+/i, "");
+        if (webinyAuth) return webinyAuth;
+        const bearer = headerValue(headers["authorization"] ?? headers["Authorization"]).replace(/^Bearer\s+/i, "");
+        if (bearer) return bearer;
+        const cookieHeader = headerValue(headers["cookie"] ?? headers["Cookie"]);
+        return parseCookieHeader(cookieHeader)["wby-id-token"] ?? null;
+    }
+}
+const NodeHttpIdentityLoaderDecorator = NodeHttpEventHandler.createDecorator({
+    decorator: NodeHttpIdentityLoaderDecoratorImpl,
+    dependencies: [
+        RawAuthToken,
+        RequestIdentityLoader
+    ]
+});
+export { NodeHttpIdentityLoaderDecorator };
+
+//# sourceMappingURL=NodeHttpIdentityLoaderDecorator.js.map

package/handlers/NodeHttpIdentityLoaderDecorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers/NodeHttpIdentityLoaderDecorator.js","sources":["../../src/handlers/NodeHttpIdentityLoaderDecorator.ts"],"sourcesContent":["import type { IncomingMessage } from \"node:http\";\nimport { NodeHttpEventHandler } from \"@webiny/event-handler-standalone\";\nimport {\n    RawAuthToken,\n    RequestIdentityLoader\n} from \"@webiny/api-core/features/requestContext/index.js\";\nimport type { IRequestIdentityLoader } from \"@webiny/api-core/features/requestContext/abstractions.js\";\nimport type { EventContext, NextFunction } from \"@webiny/event-handler-core\";\n\nfunction headerValue(value: string | string[] | undefined): string {\n    if (Array.isArray(value)) {\n        return value[0] ?? \"\";\n    }\n    return value ?? \"\";\n}\n\nfunction parseCookieHeader(cookieHeader: string): Record<string, string> {\n    return cookieHeader.split(\";\").reduce<Record<string, string>>((acc, pair) => {\n        const idx = pair.indexOf(\"=\");\n        if (idx > 0) {\n            acc[pair.slice(0, idx).trim()] = decodeURIComponent(pair.slice(idx + 1).trim());\n        }\n        return acc;\n    }, {});\n}\n\n/**\n * EXTRACT (transport-specific): reads the auth token from a Node `IncomingMessage` —\n * `x-webiny-authorization` first, then the bearer `Authorization` header, then the `wby-id-token`\n * cookie — into RawAuthToken, then invokes the shared LOAD step (RequestIdentityLoader) which\n * authenticates it (via the registered identity provider, e.g. the self-hosted JWT IdP) and sets\n * IdentityContext.\n *\n * `x-webiny-authorization` exists for AWS parity: behind CloudFront with Origin Access Control, SigV4\n * occupies the `Authorization` header, so clients that may traverse such an origin send the token in\n * that header instead. Standalone has no such constraint, but it accepts the same header so one\n * client works against both deployments.\n *\n * Node mirror of ApiGatewayIdentityLoaderDecorator. Registered BEFORE the tenant loader so identity\n * is established before tenant.\n */\nclass NodeHttpIdentityLoaderDecoratorImpl implements NodeHttpEventHandler.Interface {\n    constructor(\n        private rawAuthToken: RawAuthToken.Interface,\n        private identityLoader: IRequestIdentityLoader,\n        private decoratee: NodeHttpEventHandler.Interface\n    ) {}\n\n    async execute(ctx: EventContext<IncomingMessage>, next: NextFunction): Promise<any> {\n        this.rawAuthToken.set(this.extractToken(ctx.event));\n        await this.identityLoader.establish();\n        return this.decoratee.execute(ctx, next);\n    }\n\n    private extractToken(event: IncomingMessage): string | null {\n        const headers = event?.headers;\n        if (!headers) {\n            return null;\n        }\n        const webinyAuth = headerValue(\n            headers[\"x-webiny-authorization\"] ?? headers[\"X-Webiny-Authorization\"]\n        ).replace(/^Bearer\\s+/i, \"\");\n        if (webinyAuth) {\n            return webinyAuth;\n        }\n        const bearer = headerValue(headers[\"authorization\"] ?? headers[\"Authorization\"]).replace(\n            /^Bearer\\s+/i,\n            \"\"\n        );\n        if (bearer) {\n            return bearer;\n        }\n        const cookieHeader = headerValue(headers[\"cookie\"] ?? headers[\"Cookie\"]);\n        return parseCookieHeader(cookieHeader)[\"wby-id-token\"] ?? null;\n    }\n}\n\nexport const NodeHttpIdentityLoaderDecorator = NodeHttpEventHandler.createDecorator({\n    decorator: NodeHttpIdentityLoaderDecoratorImpl,\n    dependencies: [RawAuthToken, RequestIdentityLoader]\n});\n"],"names":["headerValue","value","Array","parseCookieHeader","cookieHeader","acc","pair","idx","decodeURIComponent","NodeHttpIdentityLoaderDecoratorImpl","rawAuthToken","identityLoader","decoratee","ctx","next","event","headers","webinyAuth","bearer","NodeHttpIdentityLoaderDecorator","NodeHttpEventHandler","RawAuthToken","RequestIdentityLoader"],"mappings":";;AASA,SAASA,YAAYC,KAAoC;IACrD,IAAIC,MAAM,OAAO,CAACD,QACd,OAAOA,KAAK,CAAC,EAAE,IAAI;IAEvB,OAAOA,SAAS;AACpB;AAEA,SAASE,kBAAkBC,YAAoB;IAC3C,OAAOA,aAAa,KAAK,CAAC,KAAK,MAAM,CAAyB,CAACC,KAAKC;QAChE,MAAMC,MAAMD,KAAK,OAAO,CAAC;QACzB,IAAIC,MAAM,GACNF,GAAG,CAACC,KAAK,KAAK,CAAC,GAAGC,KAAK,IAAI,GAAG,GAAGC,mBAAmBF,KAAK,KAAK,CAACC,MAAM,GAAG,IAAI;QAEhF,OAAOF;IACX,GAAG,CAAC;AACR;AAiBA,MAAMI;IACF,YACYC,YAAoC,EACpCC,cAAsC,EACtCC,SAAyC,CACnD;aAHUF,YAAY,GAAZA;aACAC,cAAc,GAAdA;aACAC,SAAS,GAATA;IACT;IAEH,MAAM,QAAQC,GAAkC,EAAEC,IAAkB,EAAgB;QAChF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAACD,IAAI,KAAK;QACjD,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS;QACnC,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAACA,KAAKC;IACvC;IAEQ,aAAaC,KAAsB,EAAiB;QACxD,MAAMC,UAAUD,OAAO;QACvB,IAAI,CAACC,SACD,OAAO;QAEX,MAAMC,aAAajB,YACfgB,OAAO,CAAC,yBAAyB,IAAIA,OAAO,CAAC,yBAAyB,EACxE,OAAO,CAAC,eAAe;QACzB,IAAIC,YACA,OAAOA;QAEX,MAAMC,SAASlB,YAAYgB,OAAO,CAAC,gBAAgB,IAAIA,OAAO,CAAC,gBAAgB,EAAE,OAAO,CACpF,eACA;QAEJ,IAAIE,QACA,OAAOA;QAEX,MAAMd,eAAeJ,YAAYgB,OAAO,CAAC,SAAS,IAAIA,OAAO,CAAC,SAAS;QACvE,OAAOb,kBAAkBC,aAAa,CAAC,eAAe,IAAI;IAC9D;AACJ;AAEO,MAAMe,kCAAkCC,qBAAqB,eAAe,CAAC;IAChF,WAAWX;IACX,cAAc;QAACY;QAAcC;KAAsB;AACvD"}

package/handlers/NodeHttpTenantLoaderDecorator.d.ts

@@ -0,0 +1,24 @@
+import type { IncomingMessage } from "node:http";
+import { NodeHttpEventHandler } from "@webiny/event-handler-standalone";
+import { RawTenantId } from "@webiny/api-core/features/requestContext/index.js";
+import type { IRequestTenantLoader } from "@webiny/api-core/features/requestContext/abstractions.js";
+import type { EventContext, NextFunction } from "@webiny/event-handler-core";
+/**
+ * EXTRACT (transport-specific): reads the tenant id from the `x-tenant` header of a Node
+ * `IncomingMessage` into RawTenantId, then invokes the shared LOAD step (RequestTenantLoader) which
+ * resolves the Tenant and sets TenantContext. A missing header leaves RawTenantId null → the loader
+ * defaults to the "root" tenant.
+ *
+ * Node mirror of ApiGatewayTenantLoaderDecorator. Registered AFTER the identity loader.
+ */
+declare class NodeHttpTenantLoaderDecoratorImpl implements NodeHttpEventHandler.Interface {
+    private rawTenantId;
+    private tenantLoader;
+    private decoratee;
+    constructor(rawTenantId: RawTenantId.Interface, tenantLoader: IRequestTenantLoader, decoratee: NodeHttpEventHandler.Interface);
+    execute(ctx: EventContext<IncomingMessage>, next: NextFunction): Promise<any>;
+}
+export declare const NodeHttpTenantLoaderDecorator: typeof NodeHttpTenantLoaderDecoratorImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/event-handler-standalone").INodeHttpEventHandler>;
+};
+export {};

package/handlers/NodeHttpTenantLoaderDecorator.js

@@ -0,0 +1,29 @@
+import { NodeHttpEventHandler } from "@webiny/event-handler-standalone";
+import { RawTenantId, RequestTenantLoader } from "@webiny/api-core/features/requestContext/index.js";
+function headerValue(value) {
+    if (Array.isArray(value)) return value[0] ?? null;
+    return value ?? null;
+}
+class NodeHttpTenantLoaderDecoratorImpl {
+    constructor(rawTenantId, tenantLoader, decoratee){
+        this.rawTenantId = rawTenantId;
+        this.tenantLoader = tenantLoader;
+        this.decoratee = decoratee;
+    }
+    async execute(ctx, next) {
+        const headers = ctx.event?.headers;
+        this.rawTenantId.set(headers ? headerValue(headers["x-tenant"] ?? headers["X-Tenant"]) : null);
+        await this.tenantLoader.establish();
+        return this.decoratee.execute(ctx, next);
+    }
+}
+const NodeHttpTenantLoaderDecorator = NodeHttpEventHandler.createDecorator({
+    decorator: NodeHttpTenantLoaderDecoratorImpl,
+    dependencies: [
+        RawTenantId,
+        RequestTenantLoader
+    ]
+});
+export { NodeHttpTenantLoaderDecorator };
+
+//# sourceMappingURL=NodeHttpTenantLoaderDecorator.js.map

package/handlers/NodeHttpTenantLoaderDecorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers/NodeHttpTenantLoaderDecorator.js","sources":["../../src/handlers/NodeHttpTenantLoaderDecorator.ts"],"sourcesContent":["import type { IncomingMessage } from \"node:http\";\nimport { NodeHttpEventHandler } from \"@webiny/event-handler-standalone\";\nimport {\n    RawTenantId,\n    RequestTenantLoader\n} from \"@webiny/api-core/features/requestContext/index.js\";\nimport type { IRequestTenantLoader } from \"@webiny/api-core/features/requestContext/abstractions.js\";\nimport type { EventContext, NextFunction } from \"@webiny/event-handler-core\";\n\nfunction headerValue(value: string | string[] | undefined): string | null {\n    if (Array.isArray(value)) {\n        return value[0] ?? null;\n    }\n    return value ?? null;\n}\n\n/**\n * EXTRACT (transport-specific): reads the tenant id from the `x-tenant` header of a Node\n * `IncomingMessage` into RawTenantId, then invokes the shared LOAD step (RequestTenantLoader) which\n * resolves the Tenant and sets TenantContext. A missing header leaves RawTenantId null → the loader\n * defaults to the \"root\" tenant.\n *\n * Node mirror of ApiGatewayTenantLoaderDecorator. Registered AFTER the identity loader.\n */\nclass NodeHttpTenantLoaderDecoratorImpl implements NodeHttpEventHandler.Interface {\n    constructor(\n        private rawTenantId: RawTenantId.Interface,\n        private tenantLoader: IRequestTenantLoader,\n        private decoratee: NodeHttpEventHandler.Interface\n    ) {}\n\n    async execute(ctx: EventContext<IncomingMessage>, next: NextFunction): Promise<any> {\n        const headers = ctx.event?.headers;\n        this.rawTenantId.set(\n            headers ? headerValue(headers[\"x-tenant\"] ?? headers[\"X-Tenant\"]) : null\n        );\n        await this.tenantLoader.establish();\n        return this.decoratee.execute(ctx, next);\n    }\n}\n\nexport const NodeHttpTenantLoaderDecorator = NodeHttpEventHandler.createDecorator({\n    decorator: NodeHttpTenantLoaderDecoratorImpl,\n    dependencies: [RawTenantId, RequestTenantLoader]\n});\n"],"names":["headerValue","value","Array","NodeHttpTenantLoaderDecoratorImpl","rawTenantId","tenantLoader","decoratee","ctx","next","headers","NodeHttpTenantLoaderDecorator","NodeHttpEventHandler","RawTenantId","RequestTenantLoader"],"mappings":";;AASA,SAASA,YAAYC,KAAoC;IACrD,IAAIC,MAAM,OAAO,CAACD,QACd,OAAOA,KAAK,CAAC,EAAE,IAAI;IAEvB,OAAOA,SAAS;AACpB;AAUA,MAAME;IACF,YACYC,WAAkC,EAClCC,YAAkC,EAClCC,SAAyC,CACnD;aAHUF,WAAW,GAAXA;aACAC,YAAY,GAAZA;aACAC,SAAS,GAATA;IACT;IAEH,MAAM,QAAQC,GAAkC,EAAEC,IAAkB,EAAgB;QAChF,MAAMC,UAAUF,IAAI,KAAK,EAAE;QAC3B,IAAI,CAAC,WAAW,CAAC,GAAG,CAChBE,UAAUT,YAAYS,OAAO,CAAC,WAAW,IAAIA,OAAO,CAAC,WAAW,IAAI;QAExE,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS;QACjC,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAACF,KAAKC;IACvC;AACJ;AAEO,MAAME,gCAAgCC,qBAAqB,eAAe,CAAC;IAC9E,WAAWR;IACX,cAAc;QAACS;QAAaC;KAAoB;AACpD"}

package/index.d.ts

@@ -0,0 +1,5 @@
+export { createWebinyApiHandler } from "./createWebinyApiHandler.js";
+export type { CreateWebinyApiHandlerConfig } from "./createWebinyApiHandler.js";
+export { NodeHttpIdentityLoaderDecorator } from "./handlers/NodeHttpIdentityLoaderDecorator.js";
+export { NodeHttpTenantLoaderDecorator } from "./handlers/NodeHttpTenantLoaderDecorator.js";
+export { NodeHttpAssumePermissionsDecorator } from "./handlers/NodeHttpAssumePermissionsDecorator.js";

package/index.js

@@ -0,0 +1,4 @@
+export { createWebinyApiHandler } from "./createWebinyApiHandler.js";
+export { NodeHttpIdentityLoaderDecorator } from "./handlers/NodeHttpIdentityLoaderDecorator.js";
+export { NodeHttpTenantLoaderDecorator } from "./handlers/NodeHttpTenantLoaderDecorator.js";
+export { NodeHttpAssumePermissionsDecorator } from "./handlers/NodeHttpAssumePermissionsDecorator.js";

package/package.json

@@ -0,0 +1,53 @@
+{
+	"name": "@webiny/api-event-handler-standalone",
+	"version": "0.0.0-unstable.0156a4c312",
+	"type": "module",
+	"main": "index.js",
+	"exports": {
+		".": "./index.js",
+		"./*": "./*"
+	},
+	"types": "index.d.ts",
+	"description": "EXPERIMENTAL: Webiny API handler for the standalone Node HTTP server transport.",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/webiny/webiny-js.git"
+	},
+	"contributors": [
+		"Webiny Team"
+	],
+	"license": "MIT",
+	"dependencies": {
+		"@webiny/api-core": "0.0.0-unstable.0156a4c312",
+		"@webiny/api-event-handler-core": "0.0.0-unstable.0156a4c312",
+		"@webiny/api-file-manager-standalone": "0.0.0-unstable.0156a4c312",
+		"@webiny/api-graphql": "0.0.0-unstable.0156a4c312",
+		"@webiny/api-headless-cms-bulk-actions-standalone": "0.0.0-unstable.0156a4c312",
+		"@webiny/api-scheduler": "0.0.0-unstable.0156a4c312",
+		"@webiny/api-scheduler-standalone": "0.0.0-unstable.0156a4c312",
+		"@webiny/api-websockets-standalone": "0.0.0-unstable.0156a4c312",
+		"@webiny/api-websockets-standalone-redis": "0.0.0-unstable.0156a4c312",
+		"@webiny/background-tasks-standalone": "0.0.0-unstable.0156a4c312",
+		"@webiny/event-handler-core": "0.0.0-unstable.0156a4c312",
+		"@webiny/event-handler-standalone": "0.0.0-unstable.0156a4c312",
+		"@webiny/feature": "0.0.0-unstable.0156a4c312",
+		"@webiny/handler": "0.0.0-unstable.0156a4c312",
+		"@webiny/logger": "0.0.0-unstable.0156a4c312"
+	},
+	"peerDependencies": {
+		"@webiny/di": "^2.0.0"
+	},
+	"devDependencies": {
+		"@webiny/build-tools": "0.0.0-unstable.0156a4c312",
+		"@webiny/di": "2.0.0",
+		"rimraf": "6.1.3",
+		"typescript": "7.0.2",
+		"vitest": "5.0.5"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"webiny": {
+		"publishFrom": "dist"
+	}
+}

package/publicUrls/ConfigPublicUrls.d.ts

@@ -0,0 +1,13 @@
+import { PublicUrls } from "@webiny/api-core/features/publicUrls/index.js";
+import { StandaloneConfig } from "../config/abstractions.js";
+/** Standalone: the URLs come from `WEBINY_API_URL` / `WEBINY_ADMIN_URL`, read at startup. */
+declare class ConfigPublicUrlsImpl implements PublicUrls.Interface {
+    private config;
+    constructor(config: StandaloneConfig.Interface);
+    getApiUrl(): Promise<import("@webiny/api-core/features/publicUrls/PublicUrl").PublicUrl>;
+    getAdminUrl(): Promise<import("@webiny/api-core/features/publicUrls/PublicUrl").PublicUrl>;
+}
+export declare const ConfigPublicUrls: typeof ConfigPublicUrlsImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/publicUrls/abstractions").IPublicUrls>;
+};
+export {};

package/publicUrls/ConfigPublicUrls.js

@@ -0,0 +1,22 @@
+import { PublicUrls } from "@webiny/api-core/features/publicUrls/index.js";
+import { StandaloneConfig } from "../config/abstractions.js";
+class ConfigPublicUrlsImpl {
+    constructor(config){
+        this.config = config;
+    }
+    async getApiUrl() {
+        return this.config.apiUrl;
+    }
+    async getAdminUrl() {
+        return this.config.adminUrl;
+    }
+}
+const ConfigPublicUrls = PublicUrls.createImplementation({
+    implementation: ConfigPublicUrlsImpl,
+    dependencies: [
+        StandaloneConfig
+    ]
+});
+export { ConfigPublicUrls };
+
+//# sourceMappingURL=ConfigPublicUrls.js.map

package/publicUrls/ConfigPublicUrls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicUrls/ConfigPublicUrls.js","sources":["../../src/publicUrls/ConfigPublicUrls.ts"],"sourcesContent":["import { PublicUrls } from \"@webiny/api-core/features/publicUrls/index.js\";\nimport { StandaloneConfig } from \"~/config/abstractions.js\";\n\n/** Standalone: the URLs come from `WEBINY_API_URL` / `WEBINY_ADMIN_URL`, read at startup. */\nclass ConfigPublicUrlsImpl implements PublicUrls.Interface {\n    constructor(private config: StandaloneConfig.Interface) {}\n\n    async getApiUrl() {\n        return this.config.apiUrl;\n    }\n\n    async getAdminUrl() {\n        return this.config.adminUrl;\n    }\n}\n\nexport const ConfigPublicUrls = PublicUrls.createImplementation({\n    implementation: ConfigPublicUrlsImpl,\n    dependencies: [StandaloneConfig]\n});\n"],"names":["ConfigPublicUrlsImpl","config","ConfigPublicUrls","PublicUrls","StandaloneConfig"],"mappings":";;AAIA,MAAMA;IACF,YAAoBC,MAAkC,CAAE;aAApCA,MAAM,GAANA;IAAqC;IAEzD,MAAM,YAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM;IAC7B;IAEA,MAAM,cAAc;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ;IAC/B;AACJ;AAEO,MAAMC,mBAAmBC,WAAW,oBAAoB,CAAC;IAC5D,gBAAgBH;IAChB,cAAc;QAACI;KAAiB;AACpC"}

package/publicUrls/feature.d.ts

@@ -0,0 +1,4 @@
+export declare const ConfigPublicUrlsFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/publicUrls/feature.js

@@ -0,0 +1,11 @@
+import { createFeature } from "@webiny/feature/api";
+import { ConfigPublicUrls } from "./ConfigPublicUrls.js";
+const ConfigPublicUrlsFeature = createFeature({
+    name: "ConfigPublicUrlsFeature",
+    register (container) {
+        container.register(ConfigPublicUrls);
+    }
+});
+export { ConfigPublicUrlsFeature };
+
+//# sourceMappingURL=feature.js.map

package/publicUrls/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicUrls/feature.js","sources":["../../src/publicUrls/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { ConfigPublicUrls } from \"./ConfigPublicUrls.js\";\n\nexport const ConfigPublicUrlsFeature = createFeature({\n    name: \"ConfigPublicUrlsFeature\",\n    register(container) {\n        container.register(ConfigPublicUrls);\n    }\n});\n"],"names":["ConfigPublicUrlsFeature","createFeature","container","ConfigPublicUrls"],"mappings":";;AAGO,MAAMA,0BAA0BC,cAAc;IACjD,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;IACvB;AACJ"}

package/scheduler/RecoverScheduledActionsHandler.d.ts

@@ -0,0 +1,31 @@
+import { ListTenantsUseCase } from "@webiny/api-core/features/tenancy/ListTenants/index.js";
+import { TenantContext } from "@webiny/api-core/features/tenancy/TenantContext/index.js";
+import { IdentityContext } from "@webiny/api-core/exports/api/security.js";
+import { Logger } from "@webiny/api-core/features/logger/abstractions.js";
+import { ListScheduledActionsUseCase } from "@webiny/api-scheduler/features/ListScheduledActions/index.js";
+import { ScheduledActionRecoverEventHandler } from "./ScheduledActionRecoverEventHandler.js";
+import { SchedulerSingleton } from "./abstractions/SchedulerSingleton.js";
+/**
+ * Re-arms every tenant's pending scheduled actions in the Bree singleton. Bree keeps its timers in
+ * memory, so a restart loses them all. Overdue actions run at once (see
+ * `BreeSchedulerService.recover`).
+ *
+ * Each tenant is recovered on its own: one that fails is logged and reported in the result, and the
+ * rest are still recovered. A fresh install has no tenants yet and recovers nothing.
+ */
+declare class RecoverScheduledActionsHandlerImpl implements ScheduledActionRecoverEventHandler.Interface {
+    private readonly listTenants;
+    private readonly tenantContext;
+    private readonly identityContext;
+    private readonly listScheduledActions;
+    private readonly scheduler;
+    private readonly logger;
+    constructor(listTenants: ListTenantsUseCase.Interface, tenantContext: TenantContext.Interface, identityContext: IdentityContext.Interface, listScheduledActions: ListScheduledActionsUseCase.Interface, scheduler: SchedulerSingleton.Interface, logger: Logger.Interface);
+    execute(): Promise<ScheduledActionRecoverEventHandler.Result>;
+    private recoverTenant;
+    private recoverAllPending;
+}
+export declare const RecoverScheduledActionsHandler: typeof RecoverScheduledActionsHandlerImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./ScheduledActionRecoverEventHandler.js").IScheduledActionRecoverEventHandler>;
+};
+export {};

package/scheduler/RecoverScheduledActionsHandler.js

@@ -0,0 +1,81 @@
+import { ListTenantsUseCase } from "@webiny/api-core/features/tenancy/ListTenants/index.js";
+import { TenantContext } from "@webiny/api-core/features/tenancy/TenantContext/index.js";
+import { IdentityContext } from "@webiny/api-core/exports/api/security.js";
+import { Logger } from "@webiny/api-core/features/logger/abstractions.js";
+import { ListScheduledActionsUseCase } from "@webiny/api-scheduler/features/ListScheduledActions/index.js";
+import { ScheduledActionRecoverEventHandler } from "./ScheduledActionRecoverEventHandler.js";
+import { SchedulerSingleton } from "./abstractions/SchedulerSingleton.js";
+const PAGE_SIZE = 1000;
+function canRecover(tenant) {
+    return tenant.isInstalled && "disabled" !== tenant.status;
+}
+class RecoverScheduledActionsHandlerImpl {
+    constructor(listTenants, tenantContext, identityContext, listScheduledActions, scheduler, logger){
+        this.listTenants = listTenants;
+        this.tenantContext = tenantContext;
+        this.identityContext = identityContext;
+        this.listScheduledActions = listScheduledActions;
+        this.scheduler = scheduler;
+        this.logger = logger;
+    }
+    async execute() {
+        const tenantsResult = await this.listTenants.execute();
+        if (tenantsResult.isFail()) throw tenantsResult.error;
+        let recovered = 0;
+        const failedTenants = [];
+        for (const tenant of tenantsResult.value)if (canRecover(tenant)) try {
+            recovered += await this.recoverTenant(tenant);
+        } catch (error) {
+            failedTenants.push(tenant.id);
+            this.logger.error({
+                error,
+                tenant: tenant.id
+            }, "Could not recover the tenant's scheduled actions.");
+        }
+        return {
+            recovered,
+            failedTenants
+        };
+    }
+    recoverTenant(tenant) {
+        return this.tenantContext.withTenant(tenant, ()=>this.identityContext.withoutAuthorization(()=>this.recoverAllPending(tenant.id)));
+    }
+    async recoverAllPending(tenant) {
+        let recovered = 0;
+        let after;
+        do {
+            const listResult = await this.listScheduledActions.execute({
+                where: {},
+                limit: PAGE_SIZE,
+                after
+            });
+            if (listResult.isFail()) throw listResult.error;
+            const page = [];
+            for (const action of listResult.value.items)page.push({
+                id: action.id,
+                namespace: action.namespace,
+                tenant,
+                scheduledFor: action.scheduledFor
+            });
+            await this.scheduler.recover(page);
+            recovered += page.length;
+            const { meta } = listResult.value;
+            after = meta.hasMoreItems && meta.cursor ? meta.cursor : void 0;
+        }while (after)
+        return recovered;
+    }
+}
+const RecoverScheduledActionsHandler = ScheduledActionRecoverEventHandler.createImplementation({
+    implementation: RecoverScheduledActionsHandlerImpl,
+    dependencies: [
+        ListTenantsUseCase,
+        TenantContext,
+        IdentityContext,
+        ListScheduledActionsUseCase,
+        SchedulerSingleton,
+        Logger
+    ]
+});
+export { RecoverScheduledActionsHandler };
+
+//# sourceMappingURL=RecoverScheduledActionsHandler.js.map

package/scheduler/RecoverScheduledActionsHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler/RecoverScheduledActionsHandler.js","sources":["../../src/scheduler/RecoverScheduledActionsHandler.ts"],"sourcesContent":["import { ListTenantsUseCase } from \"@webiny/api-core/features/tenancy/ListTenants/index.js\";\nimport { TenantContext } from \"@webiny/api-core/features/tenancy/TenantContext/index.js\";\nimport type { Tenant } from \"@webiny/api-core/types/tenancy.js\";\nimport { IdentityContext } from \"@webiny/api-core/exports/api/security.js\";\nimport { Logger } from \"@webiny/api-core/features/logger/abstractions.js\";\nimport { ListScheduledActionsUseCase } from \"@webiny/api-scheduler/features/ListScheduledActions/index.js\";\nimport { ScheduledActionRecoverEventHandler } from \"./ScheduledActionRecoverEventHandler.js\";\nimport type { IPendingAction } from \"@webiny/api-scheduler-standalone\";\nimport { SchedulerSingleton } from \"./abstractions/SchedulerSingleton.js\";\n\n// Pending actions read per page.\nconst PAGE_SIZE = 1000;\n\n/*\n * A tenant that isn't installed has no scheduler model to read, and a disabled one must not run its\n * schedules. Both are left alone; a disabled tenant's schedules come back on the next restart after\n * it is re-enabled.\n */\nfunction canRecover(tenant: Tenant): boolean {\n    return tenant.isInstalled && tenant.status !== \"disabled\";\n}\n\n/**\n * Re-arms every tenant's pending scheduled actions in the Bree singleton. Bree keeps its timers in\n * memory, so a restart loses them all. Overdue actions run at once (see\n * `BreeSchedulerService.recover`).\n *\n * Each tenant is recovered on its own: one that fails is logged and reported in the result, and the\n * rest are still recovered. A fresh install has no tenants yet and recovers nothing.\n */\nclass RecoverScheduledActionsHandlerImpl implements ScheduledActionRecoverEventHandler.Interface {\n    public constructor(\n        private readonly listTenants: ListTenantsUseCase.Interface,\n        private readonly tenantContext: TenantContext.Interface,\n        private readonly identityContext: IdentityContext.Interface,\n        private readonly listScheduledActions: ListScheduledActionsUseCase.Interface,\n        private readonly scheduler: SchedulerSingleton.Interface,\n        private readonly logger: Logger.Interface\n    ) {}\n\n    public async execute(): Promise<ScheduledActionRecoverEventHandler.Result> {\n        // A failed lookup is not a fresh install: it throws, so the boot step reports it.\n        const tenantsResult = await this.listTenants.execute();\n        if (tenantsResult.isFail()) {\n            throw tenantsResult.error;\n        }\n\n        let recovered = 0;\n        const failedTenants: string[] = [];\n\n        for (const tenant of tenantsResult.value) {\n            if (!canRecover(tenant)) {\n                continue;\n            }\n            try {\n                recovered += await this.recoverTenant(tenant);\n            } catch (error) {\n                failedTenants.push(tenant.id);\n                this.logger.error(\n                    { error, tenant: tenant.id },\n                    \"Could not recover the tenant's scheduled actions.\"\n                );\n            }\n        }\n\n        return { recovered, failedTenants };\n    }\n\n    private recoverTenant(tenant: Tenant): Promise<number> {\n        return this.tenantContext.withTenant(tenant, () => {\n            /*\n             * Nobody is signed in at boot. Listing without authorization is what the run side does\n             * too (ExecuteScheduledActionUseCase); otherwise the anonymous identity fails the\n             * permission check.\n             */\n            return this.identityContext.withoutAuthorization(() => {\n                return this.recoverAllPending(tenant.id);\n            });\n        });\n    }\n\n    /*\n     * Re-arms page by page, so a lookup that fails on a later page still leaves the earlier pages\n     * armed. The failure is rethrown and logged by the boot step.\n     */\n    private async recoverAllPending(tenant: string): Promise<number> {\n        let recovered = 0;\n        let after: string | undefined;\n\n        do {\n            const listResult = await this.listScheduledActions.execute({\n                where: {},\n                limit: PAGE_SIZE,\n                after\n            });\n            if (listResult.isFail()) {\n                throw listResult.error;\n            }\n\n            const page: IPendingAction[] = [];\n            for (const action of listResult.value.items) {\n                page.push({\n                    id: action.id,\n                    namespace: action.namespace,\n                    tenant,\n                    scheduledFor: action.scheduledFor\n                });\n            }\n\n            await this.scheduler.recover(page);\n            recovered += page.length;\n\n            const { meta } = listResult.value;\n            after = meta.hasMoreItems && meta.cursor ? meta.cursor : undefined;\n        } while (after);\n\n        return recovered;\n    }\n}\n\nexport const RecoverScheduledActionsHandler =\n    ScheduledActionRecoverEventHandler.createImplementation({\n        implementation: RecoverScheduledActionsHandlerImpl,\n        dependencies: [\n            ListTenantsUseCase,\n            TenantContext,\n            IdentityContext,\n            ListScheduledActionsUseCase,\n            SchedulerSingleton,\n            Logger\n        ]\n    });\n"],"names":["PAGE_SIZE","canRecover","tenant","RecoverScheduledActionsHandlerImpl","listTenants","tenantContext","identityContext","listScheduledActions","scheduler","logger","tenantsResult","recovered","failedTenants","error","after","listResult","page","action","meta","undefined","RecoverScheduledActionsHandler","ScheduledActionRecoverEventHandler","ListTenantsUseCase","TenantContext","IdentityContext","ListScheduledActionsUseCase","SchedulerSingleton","Logger"],"mappings":";;;;;;;AAWA,MAAMA,YAAY;AAOlB,SAASC,WAAWC,MAAc;IAC9B,OAAOA,OAAO,WAAW,IAAIA,AAAkB,eAAlBA,OAAO,MAAM;AAC9C;AAUA,MAAMC;IACF,YACqBC,WAAyC,EACzCC,aAAsC,EACtCC,eAA0C,EAC1CC,oBAA2D,EAC3DC,SAAuC,EACvCC,MAAwB,CAC3C;aANmBL,WAAW,GAAXA;aACAC,aAAa,GAAbA;aACAC,eAAe,GAAfA;aACAC,oBAAoB,GAApBA;aACAC,SAAS,GAATA;aACAC,MAAM,GAANA;IAClB;IAEH,MAAa,UAA8D;QAEvE,MAAMC,gBAAgB,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO;QACpD,IAAIA,cAAc,MAAM,IACpB,MAAMA,cAAc,KAAK;QAG7B,IAAIC,YAAY;QAChB,MAAMC,gBAA0B,EAAE;QAElC,KAAK,MAAMV,UAAUQ,cAAc,KAAK,CACpC,IAAKT,WAAWC,SAGhB,IAAI;YACAS,aAAa,MAAM,IAAI,CAAC,aAAa,CAACT;QAC1C,EAAE,OAAOW,OAAO;YACZD,cAAc,IAAI,CAACV,OAAO,EAAE;YAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CACb;gBAAEW;gBAAO,QAAQX,OAAO,EAAE;YAAC,GAC3B;QAER;QAGJ,OAAO;YAAES;YAAWC;QAAc;IACtC;IAEQ,cAAcV,MAAc,EAAmB;QACnD,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAACA,QAAQ,IAMlC,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,IACtC,IAAI,CAAC,iBAAiB,CAACA,OAAO,EAAE;IAGnD;IAMA,MAAc,kBAAkBA,MAAc,EAAmB;QAC7D,IAAIS,YAAY;QAChB,IAAIG;QAEJ,GAAG;YACC,MAAMC,aAAa,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC;gBACvD,OAAO,CAAC;gBACR,OAAOf;gBACPc;YACJ;YACA,IAAIC,WAAW,MAAM,IACjB,MAAMA,WAAW,KAAK;YAG1B,MAAMC,OAAyB,EAAE;YACjC,KAAK,MAAMC,UAAUF,WAAW,KAAK,CAAC,KAAK,CACvCC,KAAK,IAAI,CAAC;gBACN,IAAIC,OAAO,EAAE;gBACb,WAAWA,OAAO,SAAS;gBAC3Bf;gBACA,cAAce,OAAO,YAAY;YACrC;YAGJ,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAACD;YAC7BL,aAAaK,KAAK,MAAM;YAExB,MAAM,EAAEE,IAAI,EAAE,GAAGH,WAAW,KAAK;YACjCD,QAAQI,KAAK,YAAY,IAAIA,KAAK,MAAM,GAAGA,KAAK,MAAM,GAAGC;QAC7D,QAASL,MAAO;QAEhB,OAAOH;IACX;AACJ;AAEO,MAAMS,iCACTC,mCAAmC,oBAAoB,CAAC;IACpD,gBAAgBlB;IAChB,cAAc;QACVmB;QACAC;QACAC;QACAC;QACAC;QACAC;KACH;AACL"}

package/scheduler/RunScheduledActionOnceDecorator.d.ts

@@ -0,0 +1,37 @@
+import { ScheduledActionEventHandler } from "@webiny/event-handler-core";
+import type { IScheduledActionEvent } from "@webiny/event-handler-core";
+import type { IScheduledActionResult } from "@webiny/event-handler-core";
+import type { EventContext } from "@webiny/event-handler-core";
+import type { NextFunction } from "@webiny/event-handler-core";
+import { GetTenantByIdUseCase } from "@webiny/api-core/exports/api/tenancy.js";
+import { TenantContext } from "@webiny/api-core/features/tenancy/TenantContext/index.js";
+import { IdentityContext } from "@webiny/api-core/exports/api/security.js";
+import { GlobalKeyValueStore } from "@webiny/api-core/features/keyValueStore/index.js";
+import { GetScheduledActionUseCase } from "@webiny/api-scheduler/features/GetScheduledAction/index.js";
+/**
+ * Runs a fired scheduled action at most once across all processes. Every standalone process holds its
+ * own timers for the same actions, so the same action fires in each of them; on AWS, EventBridge
+ * fires it once and this decorator is not registered.
+ *
+ * Before the action runs, it is read again. Gone means it was cancelled or already ran. Due later
+ * means another process moved it and this timer is stale. Otherwise the process takes a claim on the
+ * action at its due time, and only the process that gets it runs the action. Rescheduling changes
+ * the due time, so a moved action gets a fresh claim.
+ */
+declare class RunScheduledActionOnceDecoratorImpl implements ScheduledActionEventHandler.Interface {
+    private readonly getTenantById;
+    private readonly tenantContext;
+    private readonly identityContext;
+    private readonly getScheduledAction;
+    private readonly store;
+    private readonly decoratee;
+    constructor(getTenantById: GetTenantByIdUseCase.Interface, tenantContext: TenantContext.Interface, identityContext: IdentityContext.Interface, getScheduledAction: GetScheduledActionUseCase.Interface, store: GlobalKeyValueStore.Interface, decoratee: ScheduledActionEventHandler.Interface);
+    execute(eventCtx: EventContext<IScheduledActionEvent>, next: NextFunction): Promise<IScheduledActionResult>;
+    private findDueTime;
+    private takeClaim;
+    private holdAfterFailure;
+}
+export declare const RunScheduledActionOnceDecorator: typeof RunScheduledActionOnceDecoratorImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/event-handler-core/features/scheduledAction/ScheduledActionEventHandler").IScheduledActionEventHandler>;
+};
+export {};

package/scheduler/RunScheduledActionOnceDecorator.js

@@ -0,0 +1,91 @@
+import { hostname } from "node:os";
+import { SCHEDULED_ACTION_EVENT_IDENTIFIER, ScheduledActionEventHandler } from "@webiny/event-handler-core";
+import { GetTenantByIdUseCase } from "@webiny/api-core/exports/api/tenancy.js";
+import { TenantContext } from "@webiny/api-core/features/tenancy/TenantContext/index.js";
+import { IdentityContext } from "@webiny/api-core/exports/api/security.js";
+import { GlobalKeyValueStore, KeyValueConditionFailedError } from "@webiny/api-core/features/keyValueStore/index.js";
+import { GetScheduledActionUseCase } from "@webiny/api-scheduler/features/GetScheduledAction/index.js";
+const CLAIM_SCOPE = "scheduler/claims";
+const RUN_CLAIM_MS = 600000;
+const RETRY_AFTER_FAILURE_MS = 86400000;
+const EARLY_TOLERANCE_MS = 1000;
+const SUCCESS = {
+    success: true
+};
+const PROCESS_NAME = `${hostname()}:${process.pid}`;
+const expiresIn = (ms)=>{
+    const expiresAtMs = Date.now() + ms;
+    return new Date(expiresAtMs);
+};
+class RunScheduledActionOnceDecoratorImpl {
+    constructor(getTenantById, tenantContext, identityContext, getScheduledAction, store, decoratee){
+        this.getTenantById = getTenantById;
+        this.tenantContext = tenantContext;
+        this.identityContext = identityContext;
+        this.getScheduledAction = getScheduledAction;
+        this.store = store;
+        this.decoratee = decoratee;
+    }
+    async execute(eventCtx, next) {
+        const input = eventCtx.event[SCHEDULED_ACTION_EVENT_IDENTIFIER];
+        const tenantId = input.tenant || this.tenantContext.getTenant().id;
+        const dueAt = await this.findDueTime(tenantId, input);
+        if (!dueAt) return SUCCESS;
+        if (dueAt.getTime() > Date.now() + EARLY_TOLERANCE_MS) return SUCCESS;
+        const key = `${tenantId}/${input.id}/${dueAt.toISOString()}`;
+        const claimed = await this.takeClaim(key);
+        if (!claimed) return SUCCESS;
+        try {
+            return await this.decoratee.execute(eventCtx, next);
+        } catch (error) {
+            await this.holdAfterFailure(key);
+            throw error;
+        }
+    }
+    async findDueTime(tenantId, input) {
+        const tenantResult = await this.getTenantById.execute(tenantId);
+        if (tenantResult.isFail()) throw tenantResult.error;
+        return this.tenantContext.withTenant(tenantResult.value, ()=>this.identityContext.withoutAuthorization(async ()=>{
+                const result = await this.getScheduledAction.execute({
+                    id: input.id,
+                    namespace: input.namespace
+                });
+                if (result.isOk()) return result.value.scheduledFor;
+                if ("Scheduler/ScheduledAction/NotFound" === result.error.code) return null;
+                throw result.error;
+            }));
+    }
+    async takeClaim(key) {
+        const expiresAt = expiresIn(RUN_CLAIM_MS);
+        const result = await this.store.set(key, PROCESS_NAME, {
+            scope: CLAIM_SCOPE,
+            expiresAt,
+            condition: {
+                exists: false
+            }
+        });
+        if (result.isOk()) return true;
+        if (result.error instanceof KeyValueConditionFailedError) return false;
+        throw result.error;
+    }
+    async holdAfterFailure(key) {
+        const expiresAt = expiresIn(RETRY_AFTER_FAILURE_MS);
+        await this.store.set(key, PROCESS_NAME, {
+            scope: CLAIM_SCOPE,
+            expiresAt
+        });
+    }
+}
+const RunScheduledActionOnceDecorator = ScheduledActionEventHandler.createDecorator({
+    decorator: RunScheduledActionOnceDecoratorImpl,
+    dependencies: [
+        GetTenantByIdUseCase,
+        TenantContext,
+        IdentityContext,
+        GetScheduledActionUseCase,
+        GlobalKeyValueStore
+    ]
+});
+export { RunScheduledActionOnceDecorator };
+
+//# sourceMappingURL=RunScheduledActionOnceDecorator.js.map

package/scheduler/RunScheduledActionOnceDecorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler/RunScheduledActionOnceDecorator.js","sources":["../../src/scheduler/RunScheduledActionOnceDecorator.ts"],"sourcesContent":["import { hostname } from \"node:os\";\nimport { ScheduledActionEventHandler } from \"@webiny/event-handler-core\";\nimport { SCHEDULED_ACTION_EVENT_IDENTIFIER } from \"@webiny/event-handler-core\";\nimport type { IScheduledActionEvent } from \"@webiny/event-handler-core\";\nimport type { IScheduledActionEventPayload } from \"@webiny/event-handler-core\";\nimport type { IScheduledActionResult } from \"@webiny/event-handler-core\";\nimport type { EventContext } from \"@webiny/event-handler-core\";\nimport type { NextFunction } from \"@webiny/event-handler-core\";\nimport { GetTenantByIdUseCase } from \"@webiny/api-core/exports/api/tenancy.js\";\nimport { TenantContext } from \"@webiny/api-core/features/tenancy/TenantContext/index.js\";\nimport { IdentityContext } from \"@webiny/api-core/exports/api/security.js\";\nimport { GlobalKeyValueStore } from \"@webiny/api-core/features/keyValueStore/index.js\";\nimport { KeyValueConditionFailedError } from \"@webiny/api-core/features/keyValueStore/index.js\";\nimport { GetScheduledActionUseCase } from \"@webiny/api-scheduler/features/GetScheduledAction/index.js\";\n\nconst CLAIM_SCOPE = \"scheduler/claims\";\n\n/*\n * How long one run of an action holds its claim. Long enough for any action to finish; a run that\n * succeeds deletes the action, so the claim only matters while it runs.\n */\nconst RUN_CLAIM_MS = 10 * 60_000;\n\n// After a failed run, other processes leave the action alone this long before trying it again.\nconst RETRY_AFTER_FAILURE_MS = 24 * 60 * 60_000;\n\n/*\n * Timers fire slightly early or late; an action due within this much is run. One due later than that\n * belongs to a timer another process moved, and this firing is stale.\n */\nconst EARLY_TOLERANCE_MS = 1000;\n\nconst SUCCESS: IScheduledActionResult = { success: true };\n\n// Names this process in the claims it writes, for whoever reads them in the database.\nconst PROCESS_NAME = `${hostname()}:${process.pid}`;\n\nconst expiresIn = (ms: number): Date => {\n    const expiresAtMs = Date.now() + ms;\n    return new Date(expiresAtMs);\n};\n\n/**\n * Runs a fired scheduled action at most once across all processes. Every standalone process holds its\n * own timers for the same actions, so the same action fires in each of them; on AWS, EventBridge\n * fires it once and this decorator is not registered.\n *\n * Before the action runs, it is read again. Gone means it was cancelled or already ran. Due later\n * means another process moved it and this timer is stale. Otherwise the process takes a claim on the\n * action at its due time, and only the process that gets it runs the action. Rescheduling changes\n * the due time, so a moved action gets a fresh claim.\n */\nclass RunScheduledActionOnceDecoratorImpl implements ScheduledActionEventHandler.Interface {\n    public constructor(\n        private readonly getTenantById: GetTenantByIdUseCase.Interface,\n        private readonly tenantContext: TenantContext.Interface,\n        private readonly identityContext: IdentityContext.Interface,\n        private readonly getScheduledAction: GetScheduledActionUseCase.Interface,\n        private readonly store: GlobalKeyValueStore.Interface,\n        private readonly decoratee: ScheduledActionEventHandler.Interface\n    ) {}\n\n    public async execute(\n        eventCtx: EventContext<IScheduledActionEvent>,\n        next: NextFunction\n    ): Promise<IScheduledActionResult> {\n        const input = eventCtx.event[SCHEDULED_ACTION_EVENT_IDENTIFIER];\n        const tenantId = input.tenant || this.tenantContext.getTenant().id;\n\n        const dueAt = await this.findDueTime(tenantId, input);\n        if (!dueAt) {\n            return SUCCESS;\n        }\n        if (dueAt.getTime() > Date.now() + EARLY_TOLERANCE_MS) {\n            return SUCCESS;\n        }\n\n        const key = `${tenantId}/${input.id}/${dueAt.toISOString()}`;\n        const claimed = await this.takeClaim(key);\n        if (!claimed) {\n            return SUCCESS;\n        }\n\n        try {\n            return await this.decoratee.execute(eventCtx, next);\n        } catch (error) {\n            await this.holdAfterFailure(key);\n            throw error;\n        }\n    }\n\n    // The action's due time, or `null` when it no longer exists.\n    private async findDueTime(\n        tenantId: string,\n        input: IScheduledActionEventPayload\n    ): Promise<Date | null> {\n        const tenantResult = await this.getTenantById.execute(tenantId);\n        if (tenantResult.isFail()) {\n            throw tenantResult.error;\n        }\n\n        return this.tenantContext.withTenant(tenantResult.value, () => {\n            // GetScheduledAction checks permissions, and nobody is signed in when a timer fires.\n            return this.identityContext.withoutAuthorization(async () => {\n                const result = await this.getScheduledAction.execute({\n                    id: input.id,\n                    namespace: input.namespace\n                });\n                if (result.isOk()) {\n                    return result.value.scheduledFor;\n                }\n                if (result.error.code === \"Scheduler/ScheduledAction/NotFound\") {\n                    return null;\n                }\n                throw result.error;\n            });\n        });\n    }\n\n    private async takeClaim(key: string): Promise<boolean> {\n        const expiresAt = expiresIn(RUN_CLAIM_MS);\n        const result = await this.store.set(key, PROCESS_NAME, {\n            scope: CLAIM_SCOPE,\n            expiresAt,\n            condition: { exists: false }\n        });\n        if (result.isOk()) {\n            return true;\n        }\n        if (result.error instanceof KeyValueConditionFailedError) {\n            return false;\n        }\n        throw result.error;\n    }\n\n    /*\n     * The action stays stored after a failed run, with the error on it, and every process's\n     * recovery fires overdue actions each minute. Holding the claim keeps that to one retry a day.\n     */\n    private async holdAfterFailure(key: string): Promise<void> {\n        const expiresAt = expiresIn(RETRY_AFTER_FAILURE_MS);\n        await this.store.set(key, PROCESS_NAME, { scope: CLAIM_SCOPE, expiresAt });\n    }\n}\n\nexport const RunScheduledActionOnceDecorator = ScheduledActionEventHandler.createDecorator({\n    decorator: RunScheduledActionOnceDecoratorImpl,\n    dependencies: [\n        GetTenantByIdUseCase,\n        TenantContext,\n        IdentityContext,\n        GetScheduledActionUseCase,\n        GlobalKeyValueStore\n    ]\n});\n"],"names":["CLAIM_SCOPE","RUN_CLAIM_MS","RETRY_AFTER_FAILURE_MS","EARLY_TOLERANCE_MS","SUCCESS","PROCESS_NAME","hostname","process","expiresIn","ms","expiresAtMs","Date","RunScheduledActionOnceDecoratorImpl","getTenantById","tenantContext","identityContext","getScheduledAction","store","decoratee","eventCtx","next","input","SCHEDULED_ACTION_EVENT_IDENTIFIER","tenantId","dueAt","key","claimed","error","tenantResult","result","expiresAt","KeyValueConditionFailedError","RunScheduledActionOnceDecorator","ScheduledActionEventHandler","GetTenantByIdUseCase","TenantContext","IdentityContext","GetScheduledActionUseCase","GlobalKeyValueStore"],"mappings":";;;;;;;AAeA,MAAMA,cAAc;AAMpB,MAAMC,eAAe;AAGrB,MAAMC,yBAAyB;AAM/B,MAAMC,qBAAqB;AAE3B,MAAMC,UAAkC;IAAE,SAAS;AAAK;AAGxD,MAAMC,eAAe,GAAGC,WAAW,CAAC,EAAEC,QAAQ,GAAG,EAAE;AAEnD,MAAMC,YAAY,CAACC;IACf,MAAMC,cAAcC,KAAK,GAAG,KAAKF;IACjC,OAAO,IAAIE,KAAKD;AACpB;AAYA,MAAME;IACF,YACqBC,aAA6C,EAC7CC,aAAsC,EACtCC,eAA0C,EAC1CC,kBAAuD,EACvDC,KAAoC,EACpCC,SAAgD,CACnE;aANmBL,aAAa,GAAbA;aACAC,aAAa,GAAbA;aACAC,eAAe,GAAfA;aACAC,kBAAkB,GAAlBA;aACAC,KAAK,GAALA;aACAC,SAAS,GAATA;IAClB;IAEH,MAAa,QACTC,QAA6C,EAC7CC,IAAkB,EACa;QAC/B,MAAMC,QAAQF,SAAS,KAAK,CAACG,kCAAkC;QAC/D,MAAMC,WAAWF,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa,CAAC,SAAS,GAAG,EAAE;QAElE,MAAMG,QAAQ,MAAM,IAAI,CAAC,WAAW,CAACD,UAAUF;QAC/C,IAAI,CAACG,OACD,OAAOpB;QAEX,IAAIoB,MAAM,OAAO,KAAKb,KAAK,GAAG,KAAKR,oBAC/B,OAAOC;QAGX,MAAMqB,MAAM,GAAGF,SAAS,CAAC,EAAEF,MAAM,EAAE,CAAC,CAAC,EAAEG,MAAM,WAAW,IAAI;QAC5D,MAAME,UAAU,MAAM,IAAI,CAAC,SAAS,CAACD;QACrC,IAAI,CAACC,SACD,OAAOtB;QAGX,IAAI;YACA,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAACe,UAAUC;QAClD,EAAE,OAAOO,OAAO;YACZ,MAAM,IAAI,CAAC,gBAAgB,CAACF;YAC5B,MAAME;QACV;IACJ;IAGA,MAAc,YACVJ,QAAgB,EAChBF,KAAmC,EACf;QACpB,MAAMO,eAAe,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAACL;QACtD,IAAIK,aAAa,MAAM,IACnB,MAAMA,aAAa,KAAK;QAG5B,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAACA,aAAa,KAAK,EAAE,IAE9C,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC;gBAC7C,MAAMC,SAAS,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;oBACjD,IAAIR,MAAM,EAAE;oBACZ,WAAWA,MAAM,SAAS;gBAC9B;gBACA,IAAIQ,OAAO,IAAI,IACX,OAAOA,OAAO,KAAK,CAAC,YAAY;gBAEpC,IAAIA,AAAsB,yCAAtBA,OAAO,KAAK,CAAC,IAAI,EACjB,OAAO;gBAEX,MAAMA,OAAO,KAAK;YACtB;IAER;IAEA,MAAc,UAAUJ,GAAW,EAAoB;QACnD,MAAMK,YAAYtB,UAAUP;QAC5B,MAAM4B,SAAS,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAACJ,KAAKpB,cAAc;YACnD,OAAOL;YACP8B;YACA,WAAW;gBAAE,QAAQ;YAAM;QAC/B;QACA,IAAID,OAAO,IAAI,IACX,OAAO;QAEX,IAAIA,OAAO,KAAK,YAAYE,8BACxB,OAAO;QAEX,MAAMF,OAAO,KAAK;IACtB;IAMA,MAAc,iBAAiBJ,GAAW,EAAiB;QACvD,MAAMK,YAAYtB,UAAUN;QAC5B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAACuB,KAAKpB,cAAc;YAAE,OAAOL;YAAa8B;QAAU;IAC5E;AACJ;AAEO,MAAME,kCAAkCC,4BAA4B,eAAe,CAAC;IACvF,WAAWrB;IACX,cAAc;QACVsB;QACAC;QACAC;QACAC;QACAC;KACH;AACL"}