@fjall/components-infrastructure 0.86.1 → 0.87.4

package/dist/lib/patterns/aws/interfaces/database.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Type-safe database interfaces.
+ *
+ * These interfaces provide compile-time type safety for database resources.
+ * Both relational (Aurora, RDS) and NoSQL (DynamoDB) databases are grouped
+ * under the Database umbrella, matching the user mental model of "where data lives".
+ *
+ * @example
+ * const aurora = app.addDatabase(DatabaseFactory.build("Main", { type: "Aurora", ... }));
+ * aurora.getHostEndpoint(); // ✓ Available on IRelationalDatabase
+ *
+ * const dynamo = app.addDatabase(DatabaseFactory.build("Cache", { type: "DynamoDB", ... }));
+ * dynamo.getTableName(); // ✓ Available on IDynamoDBDatabase
+ * dynamo.getHostEndpoint(); // ✗ Compile error - not on IDynamoDBDatabase
+ */
+import { type ITable } from "aws-cdk-lib/aws-dynamodb";
+import { type IConnectable } from "aws-cdk-lib/aws-ec2";
+import { type IGrantable, type Grant } from "aws-cdk-lib/aws-iam";
+import { type Construct } from "constructs";
+import { type Secret } from "../../../resources/aws/secrets";
+/**
+ * Database type discriminator.
+ * Relational types share the IRelationalDatabase interface.
+ * DynamoDB has its own IDynamoDBDatabase interface.
+ */
+export type DatabaseType = "Aurora" | "Instance" | "GlobalAurora" | "DynamoDB";
+/**
+ * Relational database type discriminator.
+ */
+export type RelationalDatabaseType = "Aurora" | "Instance" | "GlobalAurora";
+/**
+ * Base database interface.
+ * All database types implement this interface.
+ */
+export interface IDatabase {
+    /** The type of database resource. Used for runtime type narrowing. */
+    readonly databaseType: DatabaseType;
+    /** The underlying CDK construct node. */
+    readonly node: Construct["node"];
+}
+/**
+ * Relational database interface (Aurora, RDS Instance, GlobalAurora).
+ * Provides access to connection details, credentials, and security group connections.
+ */
+export interface IRelationalDatabase extends IDatabase, IConnectable {
+    readonly databaseType: RelationalDatabaseType;
+    /** Get the database host endpoint. */
+    getHostEndpoint(): string;
+    /** Get the database port. */
+    getHostPort(): string;
+    /** Get the database name. */
+    getDatabaseName(): string;
+    /** Get the database credentials secret (Fjall Secret wrapper with getImport() support). */
+    getCredentials(): Secret;
+    /**
+     * Grant connect permissions to a grantee.
+     * This adds the grantee to the database security group.
+     * @param grantee The principal to grant connect permissions to
+     */
+    grantConnect(grantee: IConnectable): void;
+}
+/**
+ * DynamoDB database interface.
+ * Provides access to table-specific methods and IAM grants.
+ */
+export interface IDynamoDBDatabase extends IDatabase {
+    readonly databaseType: "DynamoDB";
+    /** Get the table name. */
+    getTableName(): string;
+    /** Get the table ARN. */
+    getTableArn(): string;
+    /** Get the underlying DynamoDB table construct. */
+    getTable(): ITable;
+    /** Get the stream ARN if streams are enabled. */
+    getStreamArn(): string | undefined;
+    /**
+     * Grant read access to the table.
+     * @param grantee The principal to grant read access to
+     */
+    grantReadData(grantee: IGrantable): Grant;
+    /**
+     * Grant write access to the table.
+     * @param grantee The principal to grant write access to
+     */
+    grantWriteData(grantee: IGrantable): Grant;
+    /**
+     * Grant read and write access to the table.
+     * @param grantee The principal to grant access to
+     */
+    grantReadWriteData(grantee: IGrantable): Grant;
+    /**
+     * Grant full access to the table (read, write, and stream).
+     * @param grantee The principal to grant full access to
+     */
+    grantFullAccess(grantee: IGrantable): Grant;
+    /**
+     * Grant read access to the table stream.
+     * @param grantee The principal to grant stream read access to
+     */
+    grantStreamRead(grantee: IGrantable): Grant;
+}
+/**
+ * Union type representing any database interface.
+ * Use with type guards for generic handling.
+ */
+export type AnyDatabase = IRelationalDatabase | IDynamoDBDatabase;
+/**
+ * Type guard to check if a database is relational (Aurora, Instance, GlobalAurora).
+ */
+export declare function isRelationalDatabase(database: IDatabase): database is IRelationalDatabase;
+/**
+ * Type guard to check if a database is DynamoDB.
+ */
+export declare function isDynamoDBDatabase(database: IDatabase): database is IDynamoDBDatabase;
+/**
+ * Type guard to check if a database is Aurora.
+ */
+export declare function isAuroraDatabase(database: IDatabase): database is IRelationalDatabase & {
+    readonly databaseType: "Aurora";
+};
+/**
+ * Type guard to check if a database is a single RDS Instance.
+ */
+export declare function isInstanceDatabase(database: IDatabase): database is IRelationalDatabase & {
+    readonly databaseType: "Instance";
+};
+/**
+ * Type guard to check if a database is GlobalAurora.
+ */
+export declare function isGlobalAuroraDatabase(database: IDatabase): database is IRelationalDatabase & {
+    readonly databaseType: "GlobalAurora";
+};
+/**
+ * Type guard to check if a resource is any database type.
+ */
+export declare function isDatabase(resource: unknown): resource is IDatabase;

package/dist/lib/patterns/aws/interfaces/database.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Type-safe database interfaces.
+ *
+ * These interfaces provide compile-time type safety for database resources.
+ * Both relational (Aurora, RDS) and NoSQL (DynamoDB) databases are grouped
+ * under the Database umbrella, matching the user mental model of "where data lives".
+ *
+ * @example
+ * const aurora = app.addDatabase(DatabaseFactory.build("Main", { type: "Aurora", ... }));
+ * aurora.getHostEndpoint(); // ✓ Available on IRelationalDatabase
+ *
+ * const dynamo = app.addDatabase(DatabaseFactory.build("Cache", { type: "DynamoDB", ... }));
+ * dynamo.getTableName(); // ✓ Available on IDynamoDBDatabase
+ * dynamo.getHostEndpoint(); // ✗ Compile error - not on IDynamoDBDatabase
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRelationalDatabase = isRelationalDatabase;
+exports.isDynamoDBDatabase = isDynamoDBDatabase;
+exports.isAuroraDatabase = isAuroraDatabase;
+exports.isInstanceDatabase = isInstanceDatabase;
+exports.isGlobalAuroraDatabase = isGlobalAuroraDatabase;
+exports.isDatabase = isDatabase;
+/**
+ * Type guard to check if a database is relational (Aurora, Instance, GlobalAurora).
+ */
+function isRelationalDatabase(database) {
+    return (database.databaseType === "Aurora" ||
+        database.databaseType === "Instance" ||
+        database.databaseType === "GlobalAurora");
+}
+/**
+ * Type guard to check if a database is DynamoDB.
+ */
+function isDynamoDBDatabase(database) {
+    return database.databaseType === "DynamoDB";
+}
+/**
+ * Type guard to check if a database is Aurora.
+ */
+function isAuroraDatabase(database) {
+    return database.databaseType === "Aurora";
+}
+/**
+ * Type guard to check if a database is a single RDS Instance.
+ */
+function isInstanceDatabase(database) {
+    return database.databaseType === "Instance";
+}
+/**
+ * Type guard to check if a database is GlobalAurora.
+ */
+function isGlobalAuroraDatabase(database) {
+    return database.databaseType === "GlobalAurora";
+}
+/**
+ * Type guard to check if a resource is any database type.
+ */
+function isDatabase(resource) {
+    return (resource !== null &&
+        typeof resource === "object" &&
+        "databaseType" in resource &&
+        typeof resource.databaseType === "string");
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGF0YWJhc2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9saWIvcGF0dGVybnMvYXdzL2ludGVyZmFjZXMvZGF0YWJhc2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7Ozs7OztHQWNHOztBQXNISCxvREFRQztBQUtELGdEQUlDO0FBS0QsNENBSUM7QUFLRCxnREFJQztBQUtELHdEQUlDO0FBS0QsZ0NBT0M7QUEzREQ7O0dBRUc7QUFDSCxTQUFnQixvQkFBb0IsQ0FDbEMsUUFBbUI7SUFFbkIsT0FBTyxDQUNMLFFBQVEsQ0FBQyxZQUFZLEtBQUssUUFBUTtRQUNsQyxRQUFRLENBQUMsWUFBWSxLQUFLLFVBQVU7UUFDcEMsUUFBUSxDQUFDLFlBQVksS0FBSyxjQUFjLENBQ3pDLENBQUM7QUFDSixDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixrQkFBa0IsQ0FDaEMsUUFBbUI7SUFFbkIsT0FBTyxRQUFRLENBQUMsWUFBWSxLQUFLLFVBQVUsQ0FBQztBQUM5QyxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixnQkFBZ0IsQ0FDOUIsUUFBbUI7SUFFbkIsT0FBTyxRQUFRLENBQUMsWUFBWSxLQUFLLFFBQVEsQ0FBQztBQUM1QyxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixrQkFBa0IsQ0FDaEMsUUFBbUI7SUFFbkIsT0FBTyxRQUFRLENBQUMsWUFBWSxLQUFLLFVBQVUsQ0FBQztBQUM5QyxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixzQkFBc0IsQ0FDcEMsUUFBbUI7SUFFbkIsT0FBTyxRQUFRLENBQUMsWUFBWSxLQUFLLGNBQWMsQ0FBQztBQUNsRCxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixVQUFVLENBQUMsUUFBaUI7SUFDMUMsT0FBTyxDQUNMLFFBQVEsS0FBSyxJQUFJO1FBQ2pCLE9BQU8sUUFBUSxLQUFLLFFBQVE7UUFDNUIsY0FBYyxJQUFJLFFBQVE7UUFDMUIsT0FBUSxRQUFzQixDQUFDLFlBQVksS0FBSyxRQUFRLENBQ3pELENBQUM7QUFDSixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBUeXBlLXNhZmUgZGF0YWJhc2UgaW50ZXJmYWNlcy5cbiAqXG4gKiBUaGVzZSBpbnRlcmZhY2VzIHByb3ZpZGUgY29tcGlsZS10aW1lIHR5cGUgc2FmZXR5IGZvciBkYXRhYmFzZSByZXNvdXJjZXMuXG4gKiBCb3RoIHJlbGF0aW9uYWwgKEF1cm9yYSwgUkRTKSBhbmQgTm9TUUwgKER5bmFtb0RCKSBkYXRhYmFzZXMgYXJlIGdyb3VwZWRcbiAqIHVuZGVyIHRoZSBEYXRhYmFzZSB1bWJyZWxsYSwgbWF0Y2hpbmcgdGhlIHVzZXIgbWVudGFsIG1vZGVsIG9mIFwid2hlcmUgZGF0YSBsaXZlc1wiLlxuICpcbiAqIEBleGFtcGxlXG4gKiBjb25zdCBhdXJvcmEgPSBhcHAuYWRkRGF0YWJhc2UoRGF0YWJhc2VGYWN0b3J5LmJ1aWxkKFwiTWFpblwiLCB7IHR5cGU6IFwiQXVyb3JhXCIsIC4uLiB9KSk7XG4gKiBhdXJvcmEuZ2V0SG9zdEVuZHBvaW50KCk7IC8vIOKckyBBdmFpbGFibGUgb24gSVJlbGF0aW9uYWxEYXRhYmFzZVxuICpcbiAqIGNvbnN0IGR5bmFtbyA9IGFwcC5hZGREYXRhYmFzZShEYXRhYmFzZUZhY3RvcnkuYnVpbGQoXCJDYWNoZVwiLCB7IHR5cGU6IFwiRHluYW1vREJcIiwgLi4uIH0pKTtcbiAqIGR5bmFtby5nZXRUYWJsZU5hbWUoKTsgLy8g4pyTIEF2YWlsYWJsZSBvbiBJRHluYW1vREJEYXRhYmFzZVxuICogZHluYW1vLmdldEhvc3RFbmRwb2ludCgpOyAvLyDinJcgQ29tcGlsZSBlcnJvciAtIG5vdCBvbiBJRHluYW1vREJEYXRhYmFzZVxuICovXG5cbmltcG9ydCB7IHR5cGUgSVRhYmxlIH0gZnJvbSBcImF3cy1jZGstbGliL2F3cy1keW5hbW9kYlwiO1xuaW1wb3J0IHsgdHlwZSBJQ29ubmVjdGFibGUgfSBmcm9tIFwiYXdzLWNkay1saWIvYXdzLWVjMlwiO1xuaW1wb3J0IHsgdHlwZSBJR3JhbnRhYmxlLCB0eXBlIEdyYW50IH0gZnJvbSBcImF3cy1jZGstbGliL2F3cy1pYW1cIjtcbmltcG9ydCB7IHR5cGUgQ29uc3RydWN0IH0gZnJvbSBcImNvbnN0cnVjdHNcIjtcbmltcG9ydCB7IHR5cGUgU2VjcmV0IH0gZnJvbSBcIi4uLy4uLy4uL3Jlc291cmNlcy9hd3Mvc2VjcmV0c1wiO1xuXG4vKipcbiAqIERhdGFiYXNlIHR5cGUgZGlzY3JpbWluYXRvci5cbiAqIFJlbGF0aW9uYWwgdHlwZXMgc2hhcmUgdGhlIElSZWxhdGlvbmFsRGF0YWJhc2UgaW50ZXJmYWNlLlxuICogRHluYW1vREIgaGFzIGl0cyBvd24gSUR5bmFtb0RCRGF0YWJhc2UgaW50ZXJmYWNlLlxuICovXG5leHBvcnQgdHlwZSBEYXRhYmFzZVR5cGUgPSBcIkF1cm9yYVwiIHwgXCJJbnN0YW5jZVwiIHwgXCJHbG9iYWxBdXJvcmFcIiB8IFwiRHluYW1vREJcIjtcblxuLyoqXG4gKiBSZWxhdGlvbmFsIGRhdGFiYXNlIHR5cGUgZGlzY3JpbWluYXRvci5cbiAqL1xuZXhwb3J0IHR5cGUgUmVsYXRpb25hbERhdGFiYXNlVHlwZSA9IFwiQXVyb3JhXCIgfCBcIkluc3RhbmNlXCIgfCBcIkdsb2JhbEF1cm9yYVwiO1xuXG4vKipcbiAqIEJhc2UgZGF0YWJhc2UgaW50ZXJmYWNlLlxuICogQWxsIGRhdGFiYXNlIHR5cGVzIGltcGxlbWVudCB0aGlzIGludGVyZmFjZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJRGF0YWJhc2Uge1xuICAvKiogVGhlIHR5cGUgb2YgZGF0YWJhc2UgcmVzb3VyY2UuIFVzZWQgZm9yIHJ1bnRpbWUgdHlwZSBuYXJyb3dpbmcuICovXG4gIHJlYWRvbmx5IGRhdGFiYXNlVHlwZTogRGF0YWJhc2VUeXBlO1xuXG4gIC8qKiBUaGUgdW5kZXJseWluZyBDREsgY29uc3RydWN0IG5vZGUuICovXG4gIHJlYWRvbmx5IG5vZGU6IENvbnN0cnVjdFtcIm5vZGVcIl07XG59XG5cbi8qKlxuICogUmVsYXRpb25hbCBkYXRhYmFzZSBpbnRlcmZhY2UgKEF1cm9yYSwgUkRTIEluc3RhbmNlLCBHbG9iYWxBdXJvcmEpLlxuICogUHJvdmlkZXMgYWNjZXNzIHRvIGNvbm5lY3Rpb24gZGV0YWlscywgY3JlZGVudGlhbHMsIGFuZCBzZWN1cml0eSBncm91cCBjb25uZWN0aW9ucy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJUmVsYXRpb25hbERhdGFiYXNlIGV4dGVuZHMgSURhdGFiYXNlLCBJQ29ubmVjdGFibGUge1xuICByZWFkb25seSBkYXRhYmFzZVR5cGU6IFJlbGF0aW9uYWxEYXRhYmFzZVR5cGU7XG5cbiAgLyoqIEdldCB0aGUgZGF0YWJhc2UgaG9zdCBlbmRwb2ludC4gKi9cbiAgZ2V0SG9zdEVuZHBvaW50KCk6IHN0cmluZztcblxuICAvKiogR2V0IHRoZSBkYXRhYmFzZSBwb3J0LiAqL1xuICBnZXRIb3N0UG9ydCgpOiBzdHJpbmc7XG5cbiAgLyoqIEdldCB0aGUgZGF0YWJhc2UgbmFtZS4gKi9cbiAgZ2V0RGF0YWJhc2VOYW1lKCk6IHN0cmluZztcblxuICAvKiogR2V0IHRoZSBkYXRhYmFzZSBjcmVkZW50aWFscyBzZWNyZXQgKEZqYWxsIFNlY3JldCB3cmFwcGVyIHdpdGggZ2V0SW1wb3J0KCkgc3VwcG9ydCkuICovXG4gIGdldENyZWRlbnRpYWxzKCk6IFNlY3JldDtcblxuICAvKipcbiAgICogR3JhbnQgY29ubmVjdCBwZXJtaXNzaW9ucyB0byBhIGdyYW50ZWUuXG4gICAqIFRoaXMgYWRkcyB0aGUgZ3JhbnRlZSB0byB0aGUgZGF0YWJhc2Ugc2VjdXJpdHkgZ3JvdXAuXG4gICAqIEBwYXJhbSBncmFudGVlIFRoZSBwcmluY2lwYWwgdG8gZ3JhbnQgY29ubmVjdCBwZXJtaXNzaW9ucyB0b1xuICAgKi9cbiAgZ3JhbnRDb25uZWN0KGdyYW50ZWU6IElDb25uZWN0YWJsZSk6IHZvaWQ7XG59XG5cbi8qKlxuICogRHluYW1vREIgZGF0YWJhc2UgaW50ZXJmYWNlLlxuICogUHJvdmlkZXMgYWNjZXNzIHRvIHRhYmxlLXNwZWNpZmljIG1ldGhvZHMgYW5kIElBTSBncmFudHMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSUR5bmFtb0RCRGF0YWJhc2UgZXh0ZW5kcyBJRGF0YWJhc2Uge1xuICByZWFkb25seSBkYXRhYmFzZVR5cGU6IFwiRHluYW1vREJcIjtcblxuICAvKiogR2V0IHRoZSB0YWJsZSBuYW1lLiAqL1xuICBnZXRUYWJsZU5hbWUoKTogc3RyaW5nO1xuXG4gIC8qKiBHZXQgdGhlIHRhYmxlIEFSTi4gKi9cbiAgZ2V0VGFibGVBcm4oKTogc3RyaW5nO1xuXG4gIC8qKiBHZXQgdGhlIHVuZGVybHlpbmcgRHluYW1vREIgdGFibGUgY29uc3RydWN0LiAqL1xuICBnZXRUYWJsZSgpOiBJVGFibGU7XG5cbiAgLyoqIEdldCB0aGUgc3RyZWFtIEFSTiBpZiBzdHJlYW1zIGFyZSBlbmFibGVkLiAqL1xuICBnZXRTdHJlYW1Bcm4oKTogc3RyaW5nIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBHcmFudCByZWFkIGFjY2VzcyB0byB0aGUgdGFibGUuXG4gICAqIEBwYXJhbSBncmFudGVlIFRoZSBwcmluY2lwYWwgdG8gZ3JhbnQgcmVhZCBhY2Nlc3MgdG9cbiAgICovXG4gIGdyYW50UmVhZERhdGEoZ3JhbnRlZTogSUdyYW50YWJsZSk6IEdyYW50O1xuXG4gIC8qKlxuICAgKiBHcmFudCB3cml0ZSBhY2Nlc3MgdG8gdGhlIHRhYmxlLlxuICAgKiBAcGFyYW0gZ3JhbnRlZSBUaGUgcHJpbmNpcGFsIHRvIGdyYW50IHdyaXRlIGFjY2VzcyB0b1xuICAgKi9cbiAgZ3JhbnRXcml0ZURhdGEoZ3JhbnRlZTogSUdyYW50YWJsZSk6IEdyYW50O1xuXG4gIC8qKlxuICAgKiBHcmFudCByZWFkIGFuZCB3cml0ZSBhY2Nlc3MgdG8gdGhlIHRhYmxlLlxuICAgKiBAcGFyYW0gZ3JhbnRlZSBUaGUgcHJpbmNpcGFsIHRvIGdyYW50IGFjY2VzcyB0b1xuICAgKi9cbiAgZ3JhbnRSZWFkV3JpdGVEYXRhKGdyYW50ZWU6IElHcmFudGFibGUpOiBHcmFudDtcblxuICAvKipcbiAgICogR3JhbnQgZnVsbCBhY2Nlc3MgdG8gdGhlIHRhYmxlIChyZWFkLCB3cml0ZSwgYW5kIHN0cmVhbSkuXG4gICAqIEBwYXJhbSBncmFudGVlIFRoZSBwcmluY2lwYWwgdG8gZ3JhbnQgZnVsbCBhY2Nlc3MgdG9cbiAgICovXG4gIGdyYW50RnVsbEFjY2VzcyhncmFudGVlOiBJR3JhbnRhYmxlKTogR3JhbnQ7XG5cbiAgLyoqXG4gICAqIEdyYW50IHJlYWQgYWNjZXNzIHRvIHRoZSB0YWJsZSBzdHJlYW0uXG4gICAqIEBwYXJhbSBncmFudGVlIFRoZSBwcmluY2lwYWwgdG8gZ3JhbnQgc3RyZWFtIHJlYWQgYWNjZXNzIHRvXG4gICAqL1xuICBncmFudFN0cmVhbVJlYWQoZ3JhbnRlZTogSUdyYW50YWJsZSk6IEdyYW50O1xufVxuXG4vKipcbiAqIFVuaW9uIHR5cGUgcmVwcmVzZW50aW5nIGFueSBkYXRhYmFzZSBpbnRlcmZhY2UuXG4gKiBVc2Ugd2l0aCB0eXBlIGd1YXJkcyBmb3IgZ2VuZXJpYyBoYW5kbGluZy5cbiAqL1xuZXhwb3J0IHR5cGUgQW55RGF0YWJhc2UgPSBJUmVsYXRpb25hbERhdGFiYXNlIHwgSUR5bmFtb0RCRGF0YWJhc2U7XG5cbi8qKlxuICogVHlwZSBndWFyZCB0byBjaGVjayBpZiBhIGRhdGFiYXNlIGlzIHJlbGF0aW9uYWwgKEF1cm9yYSwgSW5zdGFuY2UsIEdsb2JhbEF1cm9yYSkuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc1JlbGF0aW9uYWxEYXRhYmFzZShcbiAgZGF0YWJhc2U6IElEYXRhYmFzZVxuKTogZGF0YWJhc2UgaXMgSVJlbGF0aW9uYWxEYXRhYmFzZSB7XG4gIHJldHVybiAoXG4gICAgZGF0YWJhc2UuZGF0YWJhc2VUeXBlID09PSBcIkF1cm9yYVwiIHx8XG4gICAgZGF0YWJhc2UuZGF0YWJhc2VUeXBlID09PSBcIkluc3RhbmNlXCIgfHxcbiAgICBkYXRhYmFzZS5kYXRhYmFzZVR5cGUgPT09IFwiR2xvYmFsQXVyb3JhXCJcbiAgKTtcbn1cblxuLyoqXG4gKiBUeXBlIGd1YXJkIHRvIGNoZWNrIGlmIGEgZGF0YWJhc2UgaXMgRHluYW1vREIuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc0R5bmFtb0RCRGF0YWJhc2UoXG4gIGRhdGFiYXNlOiBJRGF0YWJhc2Vcbik6IGRhdGFiYXNlIGlzIElEeW5hbW9EQkRhdGFiYXNlIHtcbiAgcmV0dXJuIGRhdGFiYXNlLmRhdGFiYXNlVHlwZSA9PT0gXCJEeW5hbW9EQlwiO1xufVxuXG4vKipcbiAqIFR5cGUgZ3VhcmQgdG8gY2hlY2sgaWYgYSBkYXRhYmFzZSBpcyBBdXJvcmEuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc0F1cm9yYURhdGFiYXNlKFxuICBkYXRhYmFzZTogSURhdGFiYXNlXG4pOiBkYXRhYmFzZSBpcyBJUmVsYXRpb25hbERhdGFiYXNlICYgeyByZWFkb25seSBkYXRhYmFzZVR5cGU6IFwiQXVyb3JhXCIgfSB7XG4gIHJldHVybiBkYXRhYmFzZS5kYXRhYmFzZVR5cGUgPT09IFwiQXVyb3JhXCI7XG59XG5cbi8qKlxuICogVHlwZSBndWFyZCB0byBjaGVjayBpZiBhIGRhdGFiYXNlIGlzIGEgc2luZ2xlIFJEUyBJbnN0YW5jZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzSW5zdGFuY2VEYXRhYmFzZShcbiAgZGF0YWJhc2U6IElEYXRhYmFzZVxuKTogZGF0YWJhc2UgaXMgSVJlbGF0aW9uYWxEYXRhYmFzZSAmIHsgcmVhZG9ubHkgZGF0YWJhc2VUeXBlOiBcIkluc3RhbmNlXCIgfSB7XG4gIHJldHVybiBkYXRhYmFzZS5kYXRhYmFzZVR5cGUgPT09IFwiSW5zdGFuY2VcIjtcbn1cblxuLyoqXG4gKiBUeXBlIGd1YXJkIHRvIGNoZWNrIGlmIGEgZGF0YWJhc2UgaXMgR2xvYmFsQXVyb3JhLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNHbG9iYWxBdXJvcmFEYXRhYmFzZShcbiAgZGF0YWJhc2U6IElEYXRhYmFzZVxuKTogZGF0YWJhc2UgaXMgSVJlbGF0aW9uYWxEYXRhYmFzZSAmIHsgcmVhZG9ubHkgZGF0YWJhc2VUeXBlOiBcIkdsb2JhbEF1cm9yYVwiIH0ge1xuICByZXR1cm4gZGF0YWJhc2UuZGF0YWJhc2VUeXBlID09PSBcIkdsb2JhbEF1cm9yYVwiO1xufVxuXG4vKipcbiAqIFR5cGUgZ3VhcmQgdG8gY2hlY2sgaWYgYSByZXNvdXJjZSBpcyBhbnkgZGF0YWJhc2UgdHlwZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzRGF0YWJhc2UocmVzb3VyY2U6IHVua25vd24pOiByZXNvdXJjZSBpcyBJRGF0YWJhc2Uge1xuICByZXR1cm4gKFxuICAgIHJlc291cmNlICE9PSBudWxsICYmXG4gICAgdHlwZW9mIHJlc291cmNlID09PSBcIm9iamVjdFwiICYmXG4gICAgXCJkYXRhYmFzZVR5cGVcIiBpbiByZXNvdXJjZSAmJlxuICAgIHR5cGVvZiAocmVzb3VyY2UgYXMgSURhdGFiYXNlKS5kYXRhYmFzZVR5cGUgPT09IFwic3RyaW5nXCJcbiAgKTtcbn1cbiJdfQ==

package/dist/lib/patterns/aws/interfaces/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Type-safe interfaces for Fjall infrastructure factories.
+ *
+ * This module exports all interfaces and type guards for type-safe
+ * factory pattern implementations.
+ */
+export { type ComputeType, type ICompute, type IEcsCompute, type ILambdaCompute, type IEc2Compute, type AnyCompute, isCompute, isEcsCompute, isLambdaCompute, isEc2Compute } from "./compute.js";
+export { type DatabaseType, type RelationalDatabaseType, type IDatabase, type IRelationalDatabase, type IDynamoDBDatabase, type AnyDatabase, isDatabase, isRelationalDatabase, isDynamoDBDatabase, isAuroraDatabase, isInstanceDatabase, isGlobalAuroraDatabase } from "./database.js";
+export { type MessagingType, type IMessaging, type IQueueMessaging, type ITopicMessaging, type IEventBusMessaging, type AnyMessaging, isMessaging, isQueueMessaging, isTopicMessaging, isEventBusMessaging } from "./messaging.js";
+export { type StorageType, type IStorage, type IPrivateStorage, type IWebsiteStorage, type IPublicStorage, type AnyStorage, isStorage, isPrivateStorage, isWebsiteStorage, isPublicStorage } from "./storage.js";
+export { type ConnectorType, type ConnectionAccess, type MessagingAccess, type IConnector, type IStorageConnector, type IDynamoDBConnector, type IQueueConnector, type ISecurityGroupConnector, type AnyConnector, type ConnectionConfig, type ConnectionSpec, type ConnectionResult, isConnector, isConnectable, isConnectionConfig, isStorageConnector, isDynamoDBConnector, isQueueConnector, isSecurityGroupConnector } from "./connector.js";
+export { type PatternType, type IPattern, type IPayload, type IPayloadProps, type IPatternProps, type AnyPattern, type PayloadDatabaseConfig, type PayloadComputeConfig, type PayloadCdnConfig, isPayloadPattern, isPattern } from "./pattern.js";

package/dist/lib/patterns/aws/interfaces/index.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Type-safe interfaces for Fjall infrastructure factories.
+ *
+ * This module exports all interfaces and type guards for type-safe
+ * factory pattern implementations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPattern = exports.isPayloadPattern = exports.isSecurityGroupConnector = exports.isQueueConnector = exports.isDynamoDBConnector = exports.isStorageConnector = exports.isConnectionConfig = exports.isConnectable = exports.isConnector = exports.isPublicStorage = exports.isWebsiteStorage = exports.isPrivateStorage = exports.isStorage = exports.isEventBusMessaging = exports.isTopicMessaging = exports.isQueueMessaging = exports.isMessaging = exports.isGlobalAuroraDatabase = exports.isInstanceDatabase = exports.isAuroraDatabase = exports.isDynamoDBDatabase = exports.isRelationalDatabase = exports.isDatabase = exports.isEc2Compute = exports.isLambdaCompute = exports.isEcsCompute = exports.isCompute = void 0;
+// Compute interfaces
+var compute_js_1 = require("./compute.js");
+Object.defineProperty(exports, "isCompute", { enumerable: true, get: function () { return compute_js_1.isCompute; } });
+Object.defineProperty(exports, "isEcsCompute", { enumerable: true, get: function () { return compute_js_1.isEcsCompute; } });
+Object.defineProperty(exports, "isLambdaCompute", { enumerable: true, get: function () { return compute_js_1.isLambdaCompute; } });
+Object.defineProperty(exports, "isEc2Compute", { enumerable: true, get: function () { return compute_js_1.isEc2Compute; } });
+// Database interfaces
+var database_js_1 = require("./database.js");
+Object.defineProperty(exports, "isDatabase", { enumerable: true, get: function () { return database_js_1.isDatabase; } });
+Object.defineProperty(exports, "isRelationalDatabase", { enumerable: true, get: function () { return database_js_1.isRelationalDatabase; } });
+Object.defineProperty(exports, "isDynamoDBDatabase", { enumerable: true, get: function () { return database_js_1.isDynamoDBDatabase; } });
+Object.defineProperty(exports, "isAuroraDatabase", { enumerable: true, get: function () { return database_js_1.isAuroraDatabase; } });
+Object.defineProperty(exports, "isInstanceDatabase", { enumerable: true, get: function () { return database_js_1.isInstanceDatabase; } });
+Object.defineProperty(exports, "isGlobalAuroraDatabase", { enumerable: true, get: function () { return database_js_1.isGlobalAuroraDatabase; } });
+// Messaging interfaces
+var messaging_js_1 = require("./messaging.js");
+Object.defineProperty(exports, "isMessaging", { enumerable: true, get: function () { return messaging_js_1.isMessaging; } });
+Object.defineProperty(exports, "isQueueMessaging", { enumerable: true, get: function () { return messaging_js_1.isQueueMessaging; } });
+Object.defineProperty(exports, "isTopicMessaging", { enumerable: true, get: function () { return messaging_js_1.isTopicMessaging; } });
+Object.defineProperty(exports, "isEventBusMessaging", { enumerable: true, get: function () { return messaging_js_1.isEventBusMessaging; } });
+// Storage interfaces
+var storage_js_1 = require("./storage.js");
+Object.defineProperty(exports, "isStorage", { enumerable: true, get: function () { return storage_js_1.isStorage; } });
+Object.defineProperty(exports, "isPrivateStorage", { enumerable: true, get: function () { return storage_js_1.isPrivateStorage; } });
+Object.defineProperty(exports, "isWebsiteStorage", { enumerable: true, get: function () { return storage_js_1.isWebsiteStorage; } });
+Object.defineProperty(exports, "isPublicStorage", { enumerable: true, get: function () { return storage_js_1.isPublicStorage; } });
+// Connector interfaces
+var connector_js_1 = require("./connector.js");
+Object.defineProperty(exports, "isConnector", { enumerable: true, get: function () { return connector_js_1.isConnector; } });
+Object.defineProperty(exports, "isConnectable", { enumerable: true, get: function () { return connector_js_1.isConnectable; } });
+Object.defineProperty(exports, "isConnectionConfig", { enumerable: true, get: function () { return connector_js_1.isConnectionConfig; } });
+Object.defineProperty(exports, "isStorageConnector", { enumerable: true, get: function () { return connector_js_1.isStorageConnector; } });
+Object.defineProperty(exports, "isDynamoDBConnector", { enumerable: true, get: function () { return connector_js_1.isDynamoDBConnector; } });
+Object.defineProperty(exports, "isQueueConnector", { enumerable: true, get: function () { return connector_js_1.isQueueConnector; } });
+Object.defineProperty(exports, "isSecurityGroupConnector", { enumerable: true, get: function () { return connector_js_1.isSecurityGroupConnector; } });
+// Pattern interfaces
+var pattern_js_1 = require("./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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9saWIvcGF0dGVybnMvYXdzL2ludGVyZmFjZXMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7OztHQUtHOzs7QUFFSCxxQkFBcUI7QUFDckIsMkNBV3NCO0FBSnBCLHVHQUFBLFNBQVMsT0FBQTtBQUNULDBHQUFBLFlBQVksT0FBQTtBQUNaLDZHQUFBLGVBQWUsT0FBQTtBQUNmLDBHQUFBLFlBQVksT0FBQTtBQUdkLHNCQUFzQjtBQUN0Qiw2Q0FhdUI7QUFOckIseUdBQUEsVUFBVSxPQUFBO0FBQ1YsbUhBQUEsb0JBQW9CLE9BQUE7QUFDcEIsaUhBQUEsa0JBQWtCLE9BQUE7QUFDbEIsK0dBQUEsZ0JBQWdCLE9BQUE7QUFDaEIsaUhBQUEsa0JBQWtCLE9BQUE7QUFDbEIscUhBQUEsc0JBQXNCLE9BQUE7QUFHeEIsdUJBQXVCO0FBQ3ZCLCtDQVd3QjtBQUp0QiwyR0FBQSxXQUFXLE9BQUE7QUFDWCxnSEFBQSxnQkFBZ0IsT0FBQTtBQUNoQixnSEFBQSxnQkFBZ0IsT0FBQTtBQUNoQixtSEFBQSxtQkFBbUIsT0FBQTtBQUdyQixxQkFBcUI7QUFDckIsMkNBV3NCO0FBSnBCLHVHQUFBLFNBQVMsT0FBQTtBQUNULDhHQUFBLGdCQUFnQixPQUFBO0FBQ2hCLDhHQUFBLGdCQUFnQixPQUFBO0FBQ2hCLDZHQUFBLGVBQWUsT0FBQTtBQUdqQix1QkFBdUI7QUFDdkIsK0NBb0J3QjtBQVB0QiwyR0FBQSxXQUFXLE9BQUE7QUFDWCw2R0FBQSxhQUFhLE9BQUE7QUFDYixrSEFBQSxrQkFBa0IsT0FBQTtBQUNsQixrSEFBQSxrQkFBa0IsT0FBQTtBQUNsQixtSEFBQSxtQkFBbUIsT0FBQTtBQUNuQixnSEFBQSxnQkFBZ0IsT0FBQTtBQUNoQix3SEFBQSx3QkFBd0IsT0FBQTtBQUcxQixxQkFBcUI7QUFDckIsMkNBWXNCO0FBRnBCLDhHQUFBLGdCQUFnQixPQUFBO0FBQ2hCLHVHQUFBLFNBQVMsT0FBQSIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogVHlwZS1zYWZlIGludGVyZmFjZXMgZm9yIEZqYWxsIGluZnJhc3RydWN0dXJlIGZhY3Rvcmllcy5cbiAqXG4gKiBUaGlzIG1vZHVsZSBleHBvcnRzIGFsbCBpbnRlcmZhY2VzIGFuZCB0eXBlIGd1YXJkcyBmb3IgdHlwZS1zYWZlXG4gKiBmYWN0b3J5IHBhdHRlcm4gaW1wbGVtZW50YXRpb25zLlxuICovXG5cbi8vIENvbXB1dGUgaW50ZXJmYWNlc1xuZXhwb3J0IHtcbiAgdHlwZSBDb21wdXRlVHlwZSxcbiAgdHlwZSBJQ29tcHV0ZSxcbiAgdHlwZSBJRWNzQ29tcHV0ZSxcbiAgdHlwZSBJTGFtYmRhQ29tcHV0ZSxcbiAgdHlwZSBJRWMyQ29tcHV0ZSxcbiAgdHlwZSBBbnlDb21wdXRlLFxuICBpc0NvbXB1dGUsXG4gIGlzRWNzQ29tcHV0ZSxcbiAgaXNMYW1iZGFDb21wdXRlLFxuICBpc0VjMkNvbXB1dGVcbn0gZnJvbSBcIi4vY29tcHV0ZS5qc1wiO1xuXG4vLyBEYXRhYmFzZSBpbnRlcmZhY2VzXG5leHBvcnQge1xuICB0eXBlIERhdGFiYXNlVHlwZSxcbiAgdHlwZSBSZWxhdGlvbmFsRGF0YWJhc2VUeXBlLFxuICB0eXBlIElEYXRhYmFzZSxcbiAgdHlwZSBJUmVsYXRpb25hbERhdGFiYXNlLFxuICB0eXBlIElEeW5hbW9EQkRhdGFiYXNlLFxuICB0eXBlIEFueURhdGFiYXNlLFxuICBpc0RhdGFiYXNlLFxuICBpc1JlbGF0aW9uYWxEYXRhYmFzZSxcbiAgaXNEeW5hbW9EQkRhdGFiYXNlLFxuICBpc0F1cm9yYURhdGFiYXNlLFxuICBpc0luc3RhbmNlRGF0YWJhc2UsXG4gIGlzR2xvYmFsQXVyb3JhRGF0YWJhc2Vcbn0gZnJvbSBcIi4vZGF0YWJhc2UuanNcIjtcblxuLy8gTWVzc2FnaW5nIGludGVyZmFjZXNcbmV4cG9ydCB7XG4gIHR5cGUgTWVzc2FnaW5nVHlwZSxcbiAgdHlwZSBJTWVzc2FnaW5nLFxuICB0eXBlIElRdWV1ZU1lc3NhZ2luZyxcbiAgdHlwZSBJVG9waWNNZXNzYWdpbmcsXG4gIHR5cGUgSUV2ZW50QnVzTWVzc2FnaW5nLFxuICB0eXBlIEFueU1lc3NhZ2luZyxcbiAgaXNNZXNzYWdpbmcsXG4gIGlzUXVldWVNZXNzYWdpbmcsXG4gIGlzVG9waWNNZXNzYWdpbmcsXG4gIGlzRXZlbnRCdXNNZXNzYWdpbmdcbn0gZnJvbSBcIi4vbWVzc2FnaW5nLmpzXCI7XG5cbi8vIFN0b3JhZ2UgaW50ZXJmYWNlc1xuZXhwb3J0IHtcbiAgdHlwZSBTdG9yYWdlVHlwZSxcbiAgdHlwZSBJU3RvcmFnZSxcbiAgdHlwZSBJUHJpdmF0ZVN0b3JhZ2UsXG4gIHR5cGUgSVdlYnNpdGVTdG9yYWdlLFxuICB0eXBlIElQdWJsaWNTdG9yYWdlLFxuICB0eXBlIEFueVN0b3JhZ2UsXG4gIGlzU3RvcmFnZSxcbiAgaXNQcml2YXRlU3RvcmFnZSxcbiAgaXNXZWJzaXRlU3RvcmFnZSxcbiAgaXNQdWJsaWNTdG9yYWdlXG59IGZyb20gXCIuL3N0b3JhZ2UuanNcIjtcblxuLy8gQ29ubmVjdG9yIGludGVyZmFjZXNcbmV4cG9ydCB7XG4gIHR5cGUgQ29ubmVjdG9yVHlwZSxcbiAgdHlwZSBDb25uZWN0aW9uQWNjZXNzLFxuICB0eXBlIE1lc3NhZ2luZ0FjY2VzcyxcbiAgdHlwZSBJQ29ubmVjdG9yLFxuICB0eXBlIElTdG9yYWdlQ29ubmVjdG9yLFxuICB0eXBlIElEeW5hbW9EQkNvbm5lY3RvcixcbiAgdHlwZSBJUXVldWVDb25uZWN0b3IsXG4gIHR5cGUgSVNlY3VyaXR5R3JvdXBDb25uZWN0b3IsXG4gIHR5cGUgQW55Q29ubmVjdG9yLFxuICB0eXBlIENvbm5lY3Rpb25Db25maWcsXG4gIHR5cGUgQ29ubmVjdGlvblNwZWMsXG4gIHR5cGUgQ29ubmVjdGlvblJlc3VsdCxcbiAgaXNDb25uZWN0b3IsXG4gIGlzQ29ubmVjdGFibGUsXG4gIGlzQ29ubmVjdGlvbkNvbmZpZyxcbiAgaXNTdG9yYWdlQ29ubmVjdG9yLFxuICBpc0R5bmFtb0RCQ29ubmVjdG9yLFxuICBpc1F1ZXVlQ29ubmVjdG9yLFxuICBpc1NlY3VyaXR5R3JvdXBDb25uZWN0b3Jcbn0gZnJvbSBcIi4vY29ubmVjdG9yLmpzXCI7XG5cbi8vIFBhdHRlcm4gaW50ZXJmYWNlc1xuZXhwb3J0IHtcbiAgdHlwZSBQYXR0ZXJuVHlwZSxcbiAgdHlwZSBJUGF0dGVybixcbiAgdHlwZSBJUGF5bG9hZCxcbiAgdHlwZSBJUGF5bG9hZFByb3BzLFxuICB0eXBlIElQYXR0ZXJuUHJvcHMsXG4gIHR5cGUgQW55UGF0dGVybixcbiAgdHlwZSBQYXlsb2FkRGF0YWJhc2VDb25maWcsXG4gIHR5cGUgUGF5bG9hZENvbXB1dGVDb25maWcsXG4gIHR5cGUgUGF5bG9hZENkbkNvbmZpZyxcbiAgaXNQYXlsb2FkUGF0dGVybixcbiAgaXNQYXR0ZXJuXG59IGZyb20gXCIuL3BhdHRlcm4uanNcIjtcbiJdfQ==

package/dist/lib/patterns/aws/interfaces/messaging.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Type-safe messaging interfaces.
+ *
+ * These interfaces provide compile-time type safety for messaging resources.
+ * All messaging types (SQS, SNS, EventBridge, Kinesis) are grouped under the
+ * Messaging umbrella, matching the user mental model of "how systems communicate".
+ *
+ * Currently implemented:
+ * - Queue (SQS)
+ * - Topic (SNS)
+ * - EventBus (EventBridge)
+ *
+ * Future:
+ * - Stream (Kinesis)
+ *
+ * @example
+ * const queue = app.addMessaging(MessagingFactory.build("Events", { type: "queue", ... }));
+ * queue.getQueueUrl(); // ✓ Available on IQueueMessaging
+ *
+ * const topic = app.addMessaging(MessagingFactory.build("Alerts", { type: "topic", ... }));
+ * topic.getTopicArn(); // ✓ Available on ITopicMessaging
+ */
+import { type IQueue } from "aws-cdk-lib/aws-sqs";
+import { type ITopic } from "aws-cdk-lib/aws-sns";
+import { type IEventBus } from "aws-cdk-lib/aws-events";
+import { type IGrantable, type Grant } from "aws-cdk-lib/aws-iam";
+import { type Construct } from "constructs";
+export type { IQueue, ITopic, IEventBus };
+/**
+ * Messaging type discriminator.
+ */
+export type MessagingType = "queue" | "topic" | "eventBus";
+/**
+ * Base messaging interface.
+ * All messaging types implement this interface.
+ */
+export interface IMessaging {
+    /** The type of messaging resource. Used for runtime type narrowing. */
+    readonly messagingType: MessagingType;
+    /** The underlying CDK construct node. */
+    readonly node: Construct["node"];
+}
+/**
+ * Queue messaging interface (SQS).
+ * Provides access to queue-specific resources and permissions.
+ */
+export interface IQueueMessaging extends IMessaging {
+    readonly messagingType: "queue";
+    /** Get the queue URL. */
+    getQueueUrl(): string;
+    /** Get the queue ARN. */
+    getQueueArn(): string;
+    /** Get the queue name. */
+    getQueueName(): string;
+    /** Get the underlying SQS queue construct. */
+    getQueue(): IQueue;
+    /** Get the dead letter queue if one was created. Returns the raw IQueue. */
+    getDeadLetterQueue(): IQueue | undefined;
+    /**
+     * Grant send permissions to a grantee.
+     * @param grantee The principal to grant send permissions to
+     */
+    grantSendMessages(grantee: IGrantable): Grant;
+    /**
+     * Grant consume (receive and delete) permissions to a grantee.
+     * @param grantee The principal to grant consume permissions to
+     */
+    grantConsumeMessages(grantee: IGrantable): Grant;
+    /**
+     * Grant purge permissions to a grantee.
+     * @param grantee The principal to grant purge permissions to
+     */
+    grantPurge(grantee: IGrantable): Grant;
+    /**
+     * Grant full access (send, consume, purge) to a grantee.
+     * @param grantee The principal to grant full access to
+     */
+    grant(grantee: IGrantable, ...actions: string[]): Grant;
+    /**
+     * Grant full access (send and consume) to a grantee.
+     * Convenience method that grants both send and consume permissions.
+     * @param grantee The principal to grant full access to
+     */
+    grantFull(grantee: IGrantable): Grant;
+}
+/**
+ * Topic messaging interface (SNS).
+ * Provides access to topic-specific resources and permissions.
+ */
+export interface ITopicMessaging extends IMessaging {
+    readonly messagingType: "topic";
+    /** Get the topic ARN. */
+    getTopicArn(): string;
+    /** Get the topic name. */
+    getTopicName(): string;
+    /** Get the underlying SNS topic construct. */
+    getTopic(): ITopic;
+    /**
+     * Grant publish permissions to a grantee.
+     * @param grantee The principal to grant publish permissions to
+     */
+    grantPublish(grantee: IGrantable): Grant;
+    /**
+     * Grant subscribe permissions to a grantee.
+     * @param grantee The principal to grant subscribe permissions to
+     */
+    grantSubscribe(grantee: IGrantable): Grant;
+}
+/**
+ * EventBus messaging interface (EventBridge).
+ * Provides access to event bus-specific resources and permissions.
+ */
+export interface IEventBusMessaging extends IMessaging {
+    readonly messagingType: "eventBus";
+    /** Get the event bus ARN. */
+    getEventBusArn(): string;
+    /** Get the event bus name. */
+    getEventBusName(): string;
+    /** Get the underlying EventBridge event bus construct. */
+    getEventBus(): IEventBus;
+    /**
+     * Grant put events permissions to a grantee.
+     * @param grantee The principal to grant put events permissions to
+     */
+    grantPutEventsTo(grantee: IGrantable): Grant;
+}
+/**
+ * Union type representing any messaging interface.
+ */
+export type AnyMessaging = IQueueMessaging | ITopicMessaging | IEventBusMessaging;
+/**
+ * Type guard to check if a messaging resource is a queue.
+ */
+export declare function isQueueMessaging(messaging: IMessaging): messaging is IQueueMessaging;
+/**
+ * Type guard to check if a messaging resource is a topic.
+ */
+export declare function isTopicMessaging(messaging: IMessaging): messaging is ITopicMessaging;
+/**
+ * Type guard to check if a messaging resource is an event bus.
+ */
+export declare function isEventBusMessaging(messaging: IMessaging): messaging is IEventBusMessaging;
+/**
+ * Type guard to check if a resource is any messaging type.
+ */
+export declare function isMessaging(resource: unknown): resource is IMessaging;

package/dist/lib/patterns/aws/interfaces/messaging.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Type-safe messaging interfaces.
+ *
+ * These interfaces provide compile-time type safety for messaging resources.
+ * All messaging types (SQS, SNS, EventBridge, Kinesis) are grouped under the
+ * Messaging umbrella, matching the user mental model of "how systems communicate".
+ *
+ * Currently implemented:
+ * - Queue (SQS)
+ * - Topic (SNS)
+ * - EventBus (EventBridge)
+ *
+ * Future:
+ * - Stream (Kinesis)
+ *
+ * @example
+ * const queue = app.addMessaging(MessagingFactory.build("Events", { type: "queue", ... }));
+ * queue.getQueueUrl(); // ✓ Available on IQueueMessaging
+ *
+ * const topic = app.addMessaging(MessagingFactory.build("Alerts", { type: "topic", ... }));
+ * topic.getTopicArn(); // ✓ Available on ITopicMessaging
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isQueueMessaging = isQueueMessaging;
+exports.isTopicMessaging = isTopicMessaging;
+exports.isEventBusMessaging = isEventBusMessaging;
+exports.isMessaging = isMessaging;
+/**
+ * Type guard to check if a messaging resource is a queue.
+ */
+function isQueueMessaging(messaging) {
+    return messaging.messagingType === "queue";
+}
+/**
+ * Type guard to check if a messaging resource is a topic.
+ */
+function isTopicMessaging(messaging) {
+    return messaging.messagingType === "topic";
+}
+/**
+ * Type guard to check if a messaging resource is an event bus.
+ */
+function isEventBusMessaging(messaging) {
+    return messaging.messagingType === "eventBus";
+}
+/**
+ * Type guard to check if a resource is any messaging type.
+ */
+function isMessaging(resource) {
+    return (resource !== null &&
+        typeof resource === "object" &&
+        "messagingType" in resource &&
+        typeof resource.messagingType === "string");
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVzc2FnaW5nLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vbGliL3BhdHRlcm5zL2F3cy9pbnRlcmZhY2VzL21lc3NhZ2luZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXFCRzs7QUFpSkgsNENBSUM7QUFLRCw0Q0FJQztBQUtELGtEQUlDO0FBS0Qsa0NBT0M7QUFyQ0Q7O0dBRUc7QUFDSCxTQUFnQixnQkFBZ0IsQ0FDOUIsU0FBcUI7SUFFckIsT0FBTyxTQUFTLENBQUMsYUFBYSxLQUFLLE9BQU8sQ0FBQztBQUM3QyxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixnQkFBZ0IsQ0FDOUIsU0FBcUI7SUFFckIsT0FBTyxTQUFTLENBQUMsYUFBYSxLQUFLLE9BQU8sQ0FBQztBQUM3QyxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixtQkFBbUIsQ0FDakMsU0FBcUI7SUFFckIsT0FBTyxTQUFTLENBQUMsYUFBYSxLQUFLLFVBQVUsQ0FBQztBQUNoRCxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixXQUFXLENBQUMsUUFBaUI7SUFDM0MsT0FBTyxDQUNMLFFBQVEsS0FBSyxJQUFJO1FBQ2pCLE9BQU8sUUFBUSxLQUFLLFFBQVE7UUFDNUIsZUFBZSxJQUFJLFFBQVE7UUFDM0IsT0FBUSxRQUF1QixDQUFDLGFBQWEsS0FBSyxRQUFRLENBQzNELENBQUM7QUFDSixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBUeXBlLXNhZmUgbWVzc2FnaW5nIGludGVyZmFjZXMuXG4gKlxuICogVGhlc2UgaW50ZXJmYWNlcyBwcm92aWRlIGNvbXBpbGUtdGltZSB0eXBlIHNhZmV0eSBmb3IgbWVzc2FnaW5nIHJlc291cmNlcy5cbiAqIEFsbCBtZXNzYWdpbmcgdHlwZXMgKFNRUywgU05TLCBFdmVudEJyaWRnZSwgS2luZXNpcykgYXJlIGdyb3VwZWQgdW5kZXIgdGhlXG4gKiBNZXNzYWdpbmcgdW1icmVsbGEsIG1hdGNoaW5nIHRoZSB1c2VyIG1lbnRhbCBtb2RlbCBvZiBcImhvdyBzeXN0ZW1zIGNvbW11bmljYXRlXCIuXG4gKlxuICogQ3VycmVudGx5IGltcGxlbWVudGVkOlxuICogLSBRdWV1ZSAoU1FTKVxuICogLSBUb3BpYyAoU05TKVxuICogLSBFdmVudEJ1cyAoRXZlbnRCcmlkZ2UpXG4gKlxuICogRnV0dXJlOlxuICogLSBTdHJlYW0gKEtpbmVzaXMpXG4gKlxuICogQGV4YW1wbGVcbiAqIGNvbnN0IHF1ZXVlID0gYXBwLmFkZE1lc3NhZ2luZyhNZXNzYWdpbmdGYWN0b3J5LmJ1aWxkKFwiRXZlbnRzXCIsIHsgdHlwZTogXCJxdWV1ZVwiLCAuLi4gfSkpO1xuICogcXVldWUuZ2V0UXVldWVVcmwoKTsgLy8g4pyTIEF2YWlsYWJsZSBvbiBJUXVldWVNZXNzYWdpbmdcbiAqXG4gKiBjb25zdCB0b3BpYyA9IGFwcC5hZGRNZXNzYWdpbmcoTWVzc2FnaW5nRmFjdG9yeS5idWlsZChcIkFsZXJ0c1wiLCB7IHR5cGU6IFwidG9waWNcIiwgLi4uIH0pKTtcbiAqIHRvcGljLmdldFRvcGljQXJuKCk7IC8vIOKckyBBdmFpbGFibGUgb24gSVRvcGljTWVzc2FnaW5nXG4gKi9cblxuaW1wb3J0IHsgdHlwZSBJUXVldWUgfSBmcm9tIFwiYXdzLWNkay1saWIvYXdzLXNxc1wiO1xuaW1wb3J0IHsgdHlwZSBJVG9waWMgfSBmcm9tIFwiYXdzLWNkay1saWIvYXdzLXNuc1wiO1xuaW1wb3J0IHsgdHlwZSBJRXZlbnRCdXMgfSBmcm9tIFwiYXdzLWNkay1saWIvYXdzLWV2ZW50c1wiO1xuaW1wb3J0IHsgdHlwZSBJR3JhbnRhYmxlLCB0eXBlIEdyYW50IH0gZnJvbSBcImF3cy1jZGstbGliL2F3cy1pYW1cIjtcbmltcG9ydCB7IHR5cGUgQ29uc3RydWN0IH0gZnJvbSBcImNvbnN0cnVjdHNcIjtcblxuLy8gUmUtZXhwb3J0IHR5cGVzIGZvciBjb252ZW5pZW5jZVxuZXhwb3J0IHR5cGUgeyBJUXVldWUsIElUb3BpYywgSUV2ZW50QnVzIH07XG5cbi8qKlxuICogTWVzc2FnaW5nIHR5cGUgZGlzY3JpbWluYXRvci5cbiAqL1xuZXhwb3J0IHR5cGUgTWVzc2FnaW5nVHlwZSA9IFwicXVldWVcIiB8IFwidG9waWNcIiB8IFwiZXZlbnRCdXNcIjtcblxuLyoqXG4gKiBCYXNlIG1lc3NhZ2luZyBpbnRlcmZhY2UuXG4gKiBBbGwgbWVzc2FnaW5nIHR5cGVzIGltcGxlbWVudCB0aGlzIGludGVyZmFjZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJTWVzc2FnaW5nIHtcbiAgLyoqIFRoZSB0eXBlIG9mIG1lc3NhZ2luZyByZXNvdXJjZS4gVXNlZCBmb3IgcnVudGltZSB0eXBlIG5hcnJvd2luZy4gKi9cbiAgcmVhZG9ubHkgbWVzc2FnaW5nVHlwZTogTWVzc2FnaW5nVHlwZTtcblxuICAvKiogVGhlIHVuZGVybHlpbmcgQ0RLIGNvbnN0cnVjdCBub2RlLiAqL1xuICByZWFkb25seSBub2RlOiBDb25zdHJ1Y3RbXCJub2RlXCJdO1xufVxuXG4vKipcbiAqIFF1ZXVlIG1lc3NhZ2luZyBpbnRlcmZhY2UgKFNRUykuXG4gKiBQcm92aWRlcyBhY2Nlc3MgdG8gcXVldWUtc3BlY2lmaWMgcmVzb3VyY2VzIGFuZCBwZXJtaXNzaW9ucy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJUXVldWVNZXNzYWdpbmcgZXh0ZW5kcyBJTWVzc2FnaW5nIHtcbiAgcmVhZG9ubHkgbWVzc2FnaW5nVHlwZTogXCJxdWV1ZVwiO1xuXG4gIC8qKiBHZXQgdGhlIHF1ZXVlIFVSTC4gKi9cbiAgZ2V0UXVldWVVcmwoKTogc3RyaW5nO1xuXG4gIC8qKiBHZXQgdGhlIHF1ZXVlIEFSTi4gKi9cbiAgZ2V0UXVldWVBcm4oKTogc3RyaW5nO1xuXG4gIC8qKiBHZXQgdGhlIHF1ZXVlIG5hbWUuICovXG4gIGdldFF1ZXVlTmFtZSgpOiBzdHJpbmc7XG5cbiAgLyoqIEdldCB0aGUgdW5kZXJseWluZyBTUVMgcXVldWUgY29uc3RydWN0LiAqL1xuICBnZXRRdWV1ZSgpOiBJUXVldWU7XG5cbiAgLyoqIEdldCB0aGUgZGVhZCBsZXR0ZXIgcXVldWUgaWYgb25lIHdhcyBjcmVhdGVkLiBSZXR1cm5zIHRoZSByYXcgSVF1ZXVlLiAqL1xuICBnZXREZWFkTGV0dGVyUXVldWUoKTogSVF1ZXVlIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBHcmFudCBzZW5kIHBlcm1pc3Npb25zIHRvIGEgZ3JhbnRlZS5cbiAgICogQHBhcmFtIGdyYW50ZWUgVGhlIHByaW5jaXBhbCB0byBncmFudCBzZW5kIHBlcm1pc3Npb25zIHRvXG4gICAqL1xuICBncmFudFNlbmRNZXNzYWdlcyhncmFudGVlOiBJR3JhbnRhYmxlKTogR3JhbnQ7XG5cbiAgLyoqXG4gICAqIEdyYW50IGNvbnN1bWUgKHJlY2VpdmUgYW5kIGRlbGV0ZSkgcGVybWlzc2lvbnMgdG8gYSBncmFudGVlLlxuICAgKiBAcGFyYW0gZ3JhbnRlZSBUaGUgcHJpbmNpcGFsIHRvIGdyYW50IGNvbnN1bWUgcGVybWlzc2lvbnMgdG9cbiAgICovXG4gIGdyYW50Q29uc3VtZU1lc3NhZ2VzKGdyYW50ZWU6IElHcmFudGFibGUpOiBHcmFudDtcblxuICAvKipcbiAgICogR3JhbnQgcHVyZ2UgcGVybWlzc2lvbnMgdG8gYSBncmFudGVlLlxuICAgKiBAcGFyYW0gZ3JhbnRlZSBUaGUgcHJpbmNpcGFsIHRvIGdyYW50IHB1cmdlIHBlcm1pc3Npb25zIHRvXG4gICAqL1xuICBncmFudFB1cmdlKGdyYW50ZWU6IElHcmFudGFibGUpOiBHcmFudDtcblxuICAvKipcbiAgICogR3JhbnQgZnVsbCBhY2Nlc3MgKHNlbmQsIGNvbnN1bWUsIHB1cmdlKSB0byBhIGdyYW50ZWUuXG4gICAqIEBwYXJhbSBncmFudGVlIFRoZSBwcmluY2lwYWwgdG8gZ3JhbnQgZnVsbCBhY2Nlc3MgdG9cbiAgICovXG4gIGdyYW50KGdyYW50ZWU6IElHcmFudGFibGUsIC4uLmFjdGlvbnM6IHN0cmluZ1tdKTogR3JhbnQ7XG5cbiAgLyoqXG4gICAqIEdyYW50IGZ1bGwgYWNjZXNzIChzZW5kIGFuZCBjb25zdW1lKSB0byBhIGdyYW50ZWUuXG4gICAqIENvbnZlbmllbmNlIG1ldGhvZCB0aGF0IGdyYW50cyBib3RoIHNlbmQgYW5kIGNvbnN1bWUgcGVybWlzc2lvbnMuXG4gICAqIEBwYXJhbSBncmFudGVlIFRoZSBwcmluY2lwYWwgdG8gZ3JhbnQgZnVsbCBhY2Nlc3MgdG9cbiAgICovXG4gIGdyYW50RnVsbChncmFudGVlOiBJR3JhbnRhYmxlKTogR3JhbnQ7XG59XG5cbi8qKlxuICogVG9waWMgbWVzc2FnaW5nIGludGVyZmFjZSAoU05TKS5cbiAqIFByb3ZpZGVzIGFjY2VzcyB0byB0b3BpYy1zcGVjaWZpYyByZXNvdXJjZXMgYW5kIHBlcm1pc3Npb25zLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIElUb3BpY01lc3NhZ2luZyBleHRlbmRzIElNZXNzYWdpbmcge1xuICByZWFkb25seSBtZXNzYWdpbmdUeXBlOiBcInRvcGljXCI7XG5cbiAgLyoqIEdldCB0aGUgdG9waWMgQVJOLiAqL1xuICBnZXRUb3BpY0FybigpOiBzdHJpbmc7XG5cbiAgLyoqIEdldCB0aGUgdG9waWMgbmFtZS4gKi9cbiAgZ2V0VG9waWNOYW1lKCk6IHN0cmluZztcblxuICAvKiogR2V0IHRoZSB1bmRlcmx5aW5nIFNOUyB0b3BpYyBjb25zdHJ1Y3QuICovXG4gIGdldFRvcGljKCk6IElUb3BpYztcblxuICAvKipcbiAgICogR3JhbnQgcHVibGlzaCBwZXJtaXNzaW9ucyB0byBhIGdyYW50ZWUuXG4gICAqIEBwYXJhbSBncmFudGVlIFRoZSBwcmluY2lwYWwgdG8gZ3JhbnQgcHVibGlzaCBwZXJtaXNzaW9ucyB0b1xuICAgKi9cbiAgZ3JhbnRQdWJsaXNoKGdyYW50ZWU6IElHcmFudGFibGUpOiBHcmFudDtcblxuICAvKipcbiAgICogR3JhbnQgc3Vic2NyaWJlIHBlcm1pc3Npb25zIHRvIGEgZ3JhbnRlZS5cbiAgICogQHBhcmFtIGdyYW50ZWUgVGhlIHByaW5jaXBhbCB0byBncmFudCBzdWJzY3JpYmUgcGVybWlzc2lvbnMgdG9cbiAgICovXG4gIGdyYW50U3Vic2NyaWJlKGdyYW50ZWU6IElHcmFudGFibGUpOiBHcmFudDtcbn1cblxuLyoqXG4gKiBFdmVudEJ1cyBtZXNzYWdpbmcgaW50ZXJmYWNlIChFdmVudEJyaWRnZSkuXG4gKiBQcm92aWRlcyBhY2Nlc3MgdG8gZXZlbnQgYnVzLXNwZWNpZmljIHJlc291cmNlcyBhbmQgcGVybWlzc2lvbnMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSUV2ZW50QnVzTWVzc2FnaW5nIGV4dGVuZHMgSU1lc3NhZ2luZyB7XG4gIHJlYWRvbmx5IG1lc3NhZ2luZ1R5cGU6IFwiZXZlbnRCdXNcIjtcblxuICAvKiogR2V0IHRoZSBldmVudCBidXMgQVJOLiAqL1xuICBnZXRFdmVudEJ1c0FybigpOiBzdHJpbmc7XG5cbiAgLyoqIEdldCB0aGUgZXZlbnQgYnVzIG5hbWUuICovXG4gIGdldEV2ZW50QnVzTmFtZSgpOiBzdHJpbmc7XG5cbiAgLyoqIEdldCB0aGUgdW5kZXJseWluZyBFdmVudEJyaWRnZSBldmVudCBidXMgY29uc3RydWN0LiAqL1xuICBnZXRFdmVudEJ1cygpOiBJRXZlbnRCdXM7XG5cbiAgLyoqXG4gICAqIEdyYW50IHB1dCBldmVudHMgcGVybWlzc2lvbnMgdG8gYSBncmFudGVlLlxuICAgKiBAcGFyYW0gZ3JhbnRlZSBUaGUgcHJpbmNpcGFsIHRvIGdyYW50IHB1dCBldmVudHMgcGVybWlzc2lvbnMgdG9cbiAgICovXG4gIGdyYW50UHV0RXZlbnRzVG8oZ3JhbnRlZTogSUdyYW50YWJsZSk6IEdyYW50O1xufVxuXG4vKipcbiAqIFVuaW9uIHR5cGUgcmVwcmVzZW50aW5nIGFueSBtZXNzYWdpbmcgaW50ZXJmYWNlLlxuICovXG5leHBvcnQgdHlwZSBBbnlNZXNzYWdpbmcgPVxuICB8IElRdWV1ZU1lc3NhZ2luZ1xuICB8IElUb3BpY01lc3NhZ2luZ1xuICB8IElFdmVudEJ1c01lc3NhZ2luZztcblxuLyoqXG4gKiBUeXBlIGd1YXJkIHRvIGNoZWNrIGlmIGEgbWVzc2FnaW5nIHJlc291cmNlIGlzIGEgcXVldWUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc1F1ZXVlTWVzc2FnaW5nKFxuICBtZXNzYWdpbmc6IElNZXNzYWdpbmdcbik6IG1lc3NhZ2luZyBpcyBJUXVldWVNZXNzYWdpbmcge1xuICByZXR1cm4gbWVzc2FnaW5nLm1lc3NhZ2luZ1R5cGUgPT09IFwicXVldWVcIjtcbn1cblxuLyoqXG4gKiBUeXBlIGd1YXJkIHRvIGNoZWNrIGlmIGEgbWVzc2FnaW5nIHJlc291cmNlIGlzIGEgdG9waWMuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc1RvcGljTWVzc2FnaW5nKFxuICBtZXNzYWdpbmc6IElNZXNzYWdpbmdcbik6IG1lc3NhZ2luZyBpcyBJVG9waWNNZXNzYWdpbmcge1xuICByZXR1cm4gbWVzc2FnaW5nLm1lc3NhZ2luZ1R5cGUgPT09IFwidG9waWNcIjtcbn1cblxuLyoqXG4gKiBUeXBlIGd1YXJkIHRvIGNoZWNrIGlmIGEgbWVzc2FnaW5nIHJlc291cmNlIGlzIGFuIGV2ZW50IGJ1cy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzRXZlbnRCdXNNZXNzYWdpbmcoXG4gIG1lc3NhZ2luZzogSU1lc3NhZ2luZ1xuKTogbWVzc2FnaW5nIGlzIElFdmVudEJ1c01lc3NhZ2luZyB7XG4gIHJldHVybiBtZXNzYWdpbmcubWVzc2FnaW5nVHlwZSA9PT0gXCJldmVudEJ1c1wiO1xufVxuXG4vKipcbiAqIFR5cGUgZ3VhcmQgdG8gY2hlY2sgaWYgYSByZXNvdXJjZSBpcyBhbnkgbWVzc2FnaW5nIHR5cGUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc01lc3NhZ2luZyhyZXNvdXJjZTogdW5rbm93bik6IHJlc291cmNlIGlzIElNZXNzYWdpbmcge1xuICByZXR1cm4gKFxuICAgIHJlc291cmNlICE9PSBudWxsICYmXG4gICAgdHlwZW9mIHJlc291cmNlID09PSBcIm9iamVjdFwiICYmXG4gICAgXCJtZXNzYWdpbmdUeXBlXCIgaW4gcmVzb3VyY2UgJiZcbiAgICB0eXBlb2YgKHJlc291cmNlIGFzIElNZXNzYWdpbmcpLm1lc3NhZ2luZ1R5cGUgPT09IFwic3RyaW5nXCJcbiAgKTtcbn1cbiJdfQ==