@fjall/components-infrastructure 0.86.1 → 0.87.4

package/dist/lib/patterns/aws/pattern.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Pattern Factory for High-Level Infrastructure Patterns.
+ *
+ * PatternFactory creates composite infrastructure patterns that encapsulate
+ * multiple related resources into a single, cohesive unit. This reduces
+ * boilerplate and ensures best practices for common deployment scenarios.
+ *
+ * Currently supported patterns:
+ * - `payload`: Payload CMS deployment with OpenNext
+ *
+ * @example
+ * // Minimal - works out of box
+ * const payload = app.addPattern(PatternFactory.build("PayloadApp", {
+ *   type: "payload",
+ *   name: "my-cms",
+ *   source: "../.."
+ * }));
+ *
+ * @example
+ * // Customised with escape hatches
+ * const payload = app.addPattern(PatternFactory.build("PayloadApp", {
+ *   type: "payload",
+ *   name: "my-cms",
+ *   source: "../..",
+ *   database: { type: "Aurora", publiclyAccessible: false },
+ *   compute: { memorySize: 2048 }
+ * }));
+ *
+ * // Access underlying resources for advanced customisation
+ * payload.getDatabase().grantConnect(otherLambda);
+ * payload.getServer().getLambdaFunction().addEnvironment("CUSTOM", "value");
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPattern = exports.isPayloadPattern = exports.Payload = exports.PatternFactory = void 0;
+const payload_js_1 = require("./payload.js");
+Object.defineProperty(exports, "Payload", { enumerable: true, get: function () { return payload_js_1.Payload; } });
+/**
+ * Factory for creating high-level infrastructure patterns.
+ *
+ * Uses discriminated union (type: "payload" | ...) to route to specific implementations.
+ * Each pattern type has specific props and returns a specific interface.
+ */
+class PatternFactory {
+    /**
+     * Implementation of the build method.
+     * Routes to specific pattern implementations based on type discriminator.
+     */
+    static build(id, props) {
+        return (app, scope) => {
+            const { type } = props;
+            switch (type) {
+                case "payload":
+                    return new payload_js_1.Payload(scope, id, app, props);
+                default: {
+                    // Exhaustive check ensures all pattern types are handled
+                    const _exhaustive = type;
+                    throw new Error(`Unsupported pattern type: ${String(_exhaustive)}`);
+                }
+            }
+        };
+    }
+}
+exports.PatternFactory = PatternFactory;
+// Re-export type guards
+var pattern_js_1 = require("./interfaces/pattern.js");
+Object.defineProperty(exports, "isPayloadPattern", { enumerable: true, get: function () { return pattern_js_1.isPayloadPattern; } });
+Object.defineProperty(exports, "isPattern", { enumerable: true, get: function () { return pattern_js_1.isPattern; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGF0dGVybi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL2xpYi9wYXR0ZXJucy9hd3MvcGF0dGVybi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0ErQkc7OztBQUtILDZDQUF1QztBQWtFOUIsd0ZBbEVBLG9CQUFPLE9Ba0VBO0FBM0RoQjs7Ozs7R0FLRztBQUNILE1BQWEsY0FBYztJQTZCekI7OztPQUdHO0lBQ0gsTUFBTSxDQUFDLEtBQUssQ0FDVixFQUFVLEVBQ1YsS0FBb0I7UUFFcEIsT0FBTyxDQUFDLEdBQVEsRUFBRSxLQUFnQixFQUFjLEVBQUU7WUFDaEQsTUFBTSxFQUFFLElBQUksRUFBRSxHQUFHLEtBQUssQ0FBQztZQUN2QixRQUFRLElBQUksRUFBRSxDQUFDO2dCQUNiLEtBQUssU0FBUztvQkFDWixPQUFPLElBQUksb0JBQU8sQ0FBQyxLQUFLLEVBQUUsRUFBRSxFQUFFLEdBQUcsRUFBRSxLQUFLLENBQUMsQ0FBQztnQkFDNUMsT0FBTyxDQUFDLENBQUMsQ0FBQztvQkFDUix5REFBeUQ7b0JBQ3pELE1BQU0sV0FBVyxHQUFVLElBQUksQ0FBQztvQkFDaEMsTUFBTSxJQUFJLEtBQUssQ0FBQyw2QkFBNkIsTUFBTSxDQUFDLFdBQVcsQ0FBQyxFQUFFLENBQUMsQ0FBQztnQkFDdEUsQ0FBQztZQUNILENBQUM7UUFDSCxDQUFDLENBQUM7SUFDSixDQUFDO0NBQ0Y7QUFsREQsd0NBa0RDO0FBY0Qsd0JBQXdCO0FBQ3hCLHNEQUFzRTtBQUE3RCw4R0FBQSxnQkFBZ0IsT0FBQTtBQUFFLHVHQUFBLFNBQVMsT0FBQSIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogUGF0dGVybiBGYWN0b3J5IGZvciBIaWdoLUxldmVsIEluZnJhc3RydWN0dXJlIFBhdHRlcm5zLlxuICpcbiAqIFBhdHRlcm5GYWN0b3J5IGNyZWF0ZXMgY29tcG9zaXRlIGluZnJhc3RydWN0dXJlIHBhdHRlcm5zIHRoYXQgZW5jYXBzdWxhdGVcbiAqIG11bHRpcGxlIHJlbGF0ZWQgcmVzb3VyY2VzIGludG8gYSBzaW5nbGUsIGNvaGVzaXZlIHVuaXQuIFRoaXMgcmVkdWNlc1xuICogYm9pbGVycGxhdGUgYW5kIGVuc3VyZXMgYmVzdCBwcmFjdGljZXMgZm9yIGNvbW1vbiBkZXBsb3ltZW50IHNjZW5hcmlvcy5cbiAqXG4gKiBDdXJyZW50bHkgc3VwcG9ydGVkIHBhdHRlcm5zOlxuICogLSBgcGF5bG9hZGA6IFBheWxvYWQgQ01TIGRlcGxveW1lbnQgd2l0aCBPcGVuTmV4dFxuICpcbiAqIEBleGFtcGxlXG4gKiAvLyBNaW5pbWFsIC0gd29ya3Mgb3V0IG9mIGJveFxuICogY29uc3QgcGF5bG9hZCA9IGFwcC5hZGRQYXR0ZXJuKFBhdHRlcm5GYWN0b3J5LmJ1aWxkKFwiUGF5bG9hZEFwcFwiLCB7XG4gKiAgIHR5cGU6IFwicGF5bG9hZFwiLFxuICogICBuYW1lOiBcIm15LWNtc1wiLFxuICogICBzb3VyY2U6IFwiLi4vLi5cIlxuICogfSkpO1xuICpcbiAqIEBleGFtcGxlXG4gKiAvLyBDdXN0b21pc2VkIHdpdGggZXNjYXBlIGhhdGNoZXNcbiAqIGNvbnN0IHBheWxvYWQgPSBhcHAuYWRkUGF0dGVybihQYXR0ZXJuRmFjdG9yeS5idWlsZChcIlBheWxvYWRBcHBcIiwge1xuICogICB0eXBlOiBcInBheWxvYWRcIixcbiAqICAgbmFtZTogXCJteS1jbXNcIixcbiAqICAgc291cmNlOiBcIi4uLy4uXCIsXG4gKiAgIGRhdGFiYXNlOiB7IHR5cGU6IFwiQXVyb3JhXCIsIHB1YmxpY2x5QWNjZXNzaWJsZTogZmFsc2UgfSxcbiAqICAgY29tcHV0ZTogeyBtZW1vcnlTaXplOiAyMDQ4IH1cbiAqIH0pKTtcbiAqXG4gKiAvLyBBY2Nlc3MgdW5kZXJseWluZyByZXNvdXJjZXMgZm9yIGFkdmFuY2VkIGN1c3RvbWlzYXRpb25cbiAqIHBheWxvYWQuZ2V0RGF0YWJhc2UoKS5ncmFudENvbm5lY3Qob3RoZXJMYW1iZGEpO1xuICogcGF5bG9hZC5nZXRTZXJ2ZXIoKS5nZXRMYW1iZGFGdW5jdGlvbigpLmFkZEVudmlyb25tZW50KFwiQ1VTVE9NXCIsIFwidmFsdWVcIik7XG4gKi9cblxuaW1wb3J0IHsgdHlwZSBDb25zdHJ1Y3QgfSBmcm9tIFwiY29uc3RydWN0c1wiO1xuXG5pbXBvcnQgdHlwZSBBcHAgZnJvbSBcIi4uLy4uL2FwcC5qc1wiO1xuaW1wb3J0IHsgUGF5bG9hZCB9IGZyb20gXCIuL3BheWxvYWQuanNcIjtcbmltcG9ydCB7XG4gIHR5cGUgSVBheWxvYWRQcm9wcyxcbiAgdHlwZSBJUGF0dGVyblByb3BzLFxuICB0eXBlIEFueVBhdHRlcm5cbn0gZnJvbSBcIi4vaW50ZXJmYWNlcy9wYXR0ZXJuLmpzXCI7XG5cbi8qKlxuICogRmFjdG9yeSBmb3IgY3JlYXRpbmcgaGlnaC1sZXZlbCBpbmZyYXN0cnVjdHVyZSBwYXR0ZXJucy5cbiAqXG4gKiBVc2VzIGRpc2NyaW1pbmF0ZWQgdW5pb24gKHR5cGU6IFwicGF5bG9hZFwiIHwgLi4uKSB0byByb3V0ZSB0byBzcGVjaWZpYyBpbXBsZW1lbnRhdGlvbnMuXG4gKiBFYWNoIHBhdHRlcm4gdHlwZSBoYXMgc3BlY2lmaWMgcHJvcHMgYW5kIHJldHVybnMgYSBzcGVjaWZpYyBpbnRlcmZhY2UuXG4gKi9cbmV4cG9ydCBjbGFzcyBQYXR0ZXJuRmFjdG9yeSB7XG4gIC8qKlxuICAgKiBCdWlsZCBhIFBheWxvYWQgQ01TIHBhdHRlcm4uXG4gICAqXG4gICAqIENyZWF0ZXMgYSBjb21wbGV0ZSBQYXlsb2FkIENNUyBpbmZyYXN0cnVjdHVyZTpcbiAgICogLSBSRFMgUG9zdGdyZVNRTCBkYXRhYmFzZSAoQXVyb3JhIG9yIEluc3RhbmNlKVxuICAgKiAtIFMzIGJ1Y2tldHMgKGFzc2V0cywgY2FjaGUsIG1lZGlhKVxuICAgKiAtIER5bmFtb0RCIHRhYmxlICh0YWcgY2FjaGUpXG4gICAqIC0gU1FTIEZJRk8gcXVldWUgKHJldmFsaWRhdGlvbilcbiAgICogLSBMYW1iZGEgZnVuY3Rpb25zIChzZXJ2ZXIsIGltYWdlIG9wdGltaXphdGlvbiwgcmV2YWxpZGF0aW9uKVxuICAgKiAtIENsb3VkRnJvbnQgZGlzdHJpYnV0aW9uXG4gICAqXG4gICAqIEBwYXJhbSBpZCAtIENvbnN0cnVjdCBJRCAodXNlZCBmb3IgcmVzb3VyY2UgbmFtaW5nKVxuICAgKiBAcGFyYW0gcHJvcHMgLSBQYXlsb2FkIHBhdHRlcm4gY29uZmlndXJhdGlvblxuICAgKiBAcmV0dXJucyBGYWN0b3J5IGZ1bmN0aW9uIHRvIGNyZWF0ZSB0aGUgcGF0dGVyblxuICAgKi9cbiAgc3RhdGljIGJ1aWxkKFxuICAgIGlkOiBzdHJpbmcsXG4gICAgcHJvcHM6IElQYXlsb2FkUHJvcHNcbiAgKTogKGFwcDogQXBwLCBzY29wZTogQ29uc3RydWN0KSA9PiBQYXlsb2FkO1xuXG4gIC8qKlxuICAgKiBHZW5lcmljIGJ1aWxkIG1ldGhvZCAoaW1wbGVtZW50YXRpb24gc2lnbmF0dXJlKS5cbiAgICovXG4gIHN0YXRpYyBidWlsZChcbiAgICBpZDogc3RyaW5nLFxuICAgIHByb3BzOiBJUGF0dGVyblByb3BzXG4gICk6IChhcHA6IEFwcCwgc2NvcGU6IENvbnN0cnVjdCkgPT4gQW55UGF0dGVybjtcblxuICAvKipcbiAgICogSW1wbGVtZW50YXRpb24gb2YgdGhlIGJ1aWxkIG1ldGhvZC5cbiAgICogUm91dGVzIHRvIHNwZWNpZmljIHBhdHRlcm4gaW1wbGVtZW50YXRpb25zIGJhc2VkIG9uIHR5cGUgZGlzY3JpbWluYXRvci5cbiAgICovXG4gIHN0YXRpYyBidWlsZChcbiAgICBpZDogc3RyaW5nLFxuICAgIHByb3BzOiBJUGF0dGVyblByb3BzXG4gICk6IChhcHA6IEFwcCwgc2NvcGU6IENvbnN0cnVjdCkgPT4gQW55UGF0dGVybiB7XG4gICAgcmV0dXJuIChhcHA6IEFwcCwgc2NvcGU6IENvbnN0cnVjdCk6IEFueVBhdHRlcm4gPT4ge1xuICAgICAgY29uc3QgeyB0eXBlIH0gPSBwcm9wcztcbiAgICAgIHN3aXRjaCAodHlwZSkge1xuICAgICAgICBjYXNlIFwicGF5bG9hZFwiOlxuICAgICAgICAgIHJldHVybiBuZXcgUGF5bG9hZChzY29wZSwgaWQsIGFwcCwgcHJvcHMpO1xuICAgICAgICBkZWZhdWx0OiB7XG4gICAgICAgICAgLy8gRXhoYXVzdGl2ZSBjaGVjayBlbnN1cmVzIGFsbCBwYXR0ZXJuIHR5cGVzIGFyZSBoYW5kbGVkXG4gICAgICAgICAgY29uc3QgX2V4aGF1c3RpdmU6IG5ldmVyID0gdHlwZTtcbiAgICAgICAgICB0aHJvdyBuZXcgRXJyb3IoYFVuc3VwcG9ydGVkIHBhdHRlcm4gdHlwZTogJHtTdHJpbmcoX2V4aGF1c3RpdmUpfWApO1xuICAgICAgICB9XG4gICAgICB9XG4gICAgfTtcbiAgfVxufVxuXG4vLyBSZS1leHBvcnQgdHlwZXMgZm9yIGNvbnZlbmllbmNlXG5leHBvcnQgeyBQYXlsb2FkIH07XG5leHBvcnQgdHlwZSB7XG4gIElQYXlsb2FkUHJvcHMsXG4gIElQYXR0ZXJuUHJvcHMsXG4gIEFueVBhdHRlcm4sXG4gIElQYXlsb2FkLFxuICBQYXlsb2FkRGF0YWJhc2VDb25maWcsXG4gIFBheWxvYWRDb21wdXRlQ29uZmlnLFxuICBQYXlsb2FkQ2RuQ29uZmlnXG59IGZyb20gXCIuL2ludGVyZmFjZXMvcGF0dGVybi5qc1wiO1xuXG4vLyBSZS1leHBvcnQgdHlwZSBndWFyZHNcbmV4cG9ydCB7IGlzUGF5bG9hZFBhdHRlcm4sIGlzUGF0dGVybiB9IGZyb20gXCIuL2ludGVyZmFjZXMvcGF0dGVybi5qc1wiO1xuIl19

package/dist/lib/patterns/aws/payload.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Payload CMS Pattern.
+ *
+ * A high-level pattern that creates all infrastructure required for a
+ * Payload CMS deployment using OpenNext.
+ *
+ * Resources created:
+ * - RDS PostgreSQL database (Aurora or Instance)
+ * - 3 S3 buckets (assets, cache, media)
+ * - DynamoDB table (tag cache with GSI)
+ * - SQS FIFO queue (revalidation)
+ * - 3 Lambda functions (server, image optimisation, revalidation)
+ * - CloudFront distribution
+ *
+ * @example
+ * const payload = app.addPattern(PatternFactory.build("PayloadApp", {
+ *   type: "payload",
+ *   name: "my-cms"
+ * }));
+ *
+ * // Escape hatches
+ * payload.getDatabase().grantConnect(otherLambda);
+ */
+import { Construct } from "constructs";
+import type App from "../../app.js";
+import { type IPayloadProps, type IPayload } from "./interfaces/pattern.js";
+import { type RelationalDatabase, type DynamoDBDatabase } from "./database.js";
+import { type LambdaCompute } from "./compute.js";
+import { type PrivateStorage } from "./storage.js";
+import { type QueueMessaging } from "./messaging.js";
+import { type Cdn } from "./cdn.js";
+/**
+ * Payload CMS pattern implementation.
+ *
+ * Composes all required AWS resources for a Payload deployment.
+ */
+export declare class Payload extends Construct implements IPayload {
+    readonly patternType: "payload";
+    private readonly app;
+    private readonly props;
+    private readonly pascalName;
+    private readonly payloadSecret;
+    private _database;
+    private _server;
+    private _imageOptimisation;
+    private _revalidation;
+    private _assetsBucket;
+    private _cacheBucket;
+    private _mediaBucket;
+    private _tagCache;
+    private _revalidationQueue;
+    private _cdn;
+    constructor(scope: Construct, id: string, app: App, props: IPayloadProps);
+    private registerManifest;
+    private validateProps;
+    private createDatabase;
+    private buildBaseDatabaseProps;
+    private createAuroraDatabase;
+    private createInstanceDatabase;
+    private createStorageBuckets;
+    private createAssetsBucket;
+    private createCacheBucket;
+    private createMediaBucket;
+    private createTagCache;
+    private createRevalidationQueue;
+    private createLambdaFunctions;
+    private createServerLambda;
+    private buildServerEnvironment;
+    private grantServerPermissions;
+    private createImageLambda;
+    private createRevalidationLambda;
+    private createCdn;
+    private resolveDomainConfig;
+    private resolveSimpleDomain;
+    private resolveAdvancedDomain;
+    private createDnsRecord;
+    getDatabase(): RelationalDatabase;
+    getServer(): LambdaCompute;
+    getImageOptimisation(): LambdaCompute;
+    getRevalidation(): LambdaCompute;
+    getAssetsBucket(): PrivateStorage;
+    getCacheBucket(): PrivateStorage;
+    getMediaBucket(): PrivateStorage;
+    getTagCache(): DynamoDBDatabase;
+    getRevalidationQueue(): QueueMessaging;
+    getCdn(): Cdn;
+}