@resistdesign/voltra 3.0.0-alpha.2 → 3.0.0-alpha.21

package/iac/packs/build.d.ts

@@ -0,0 +1,92 @@
+import { AWS } from "../types/IaCTypes";
+/**
+ * Default repository provider for CodePipeline source actions.
+ */
+export declare const DEFAULT_BUILD_PIPELINE_REPO_PROVIDER = "GitHub";
+/**
+ * Source repository configuration for the build pipeline.
+ */
+export type BuildPipelineRepoConfig = {
+    /**
+     * CodePipeline provider (e.g., GitHub).
+     */
+    provider?: any;
+    /**
+     * Repository owner/organization.
+     */
+    owner: any;
+    /**
+     * Repository name.
+     */
+    repo: any;
+    /**
+     * Repository branch name.
+     */
+    branch: any;
+    /**
+     * OAuth token for source access.
+     */
+    oauthToken: any;
+};
+/**
+ * Helper for custom CodeBuild string literals.
+ */
+export type CustomCodeBuildString<T extends string> = T & {
+    __custom?: never;
+};
+/**
+ * Allowed CodeBuild environment types.
+ */
+export type CodeBuildEnvironmentType = "ARM_CONTAINER" | "LINUX_CONTAINER" | "LINUX_GPU_CONTAINER" | "WINDOWS_SERVER_2019_CONTAINER" | "WINDOWS_SERVER_2022_CONTAINER" | "LINUX_EC2" | "ARM_EC2" | "WINDOWS_EC2" | "MAC_ARM" | CustomCodeBuildString<string>;
+/**
+ * Allowed CodeBuild compute types.
+ */
+export type CodeBuildComputeType = "BUILD_GENERAL1_SMALL" | "BUILD_GENERAL1_MEDIUM" | "BUILD_GENERAL1_LARGE" | "BUILD_GENERAL1_2XLARGE" | "BUILD_GENERAL1_XLARGE" | CustomCodeBuildString<string>;
+/**
+ * Configuration for the build pipeline pack.
+ */
+export type AddBuildPipelineConfig = {
+    /**
+     * Base id for created resources.
+     */
+    id: string;
+    /**
+     * Build spec YAML or JSON.
+     */
+    buildSpec: any;
+    /**
+     * Optional resource dependencies.
+     */
+    dependsOn?: string | string[];
+    /**
+     * CodeBuild environment variables.
+     */
+    environmentVariables?: AWS.CodeBuild.Project.EnvironmentVariable[];
+    /**
+     * Build timeout in minutes.
+     */
+    timeoutInMinutes?: number;
+    /**
+     * CodeBuild environment type.
+     */
+    environmentType?: CodeBuildEnvironmentType;
+    /**
+     * CodeBuild compute type.
+     */
+    environmentComputeType?: CodeBuildComputeType;
+    /**
+     * CodeBuild image to run.
+     */
+    environmentImage?: string;
+    /**
+     * Repository configuration for source stage.
+     */
+    repoConfig: BuildPipelineRepoConfig;
+};
+/**
+ * Add a build pipeline with full permissions.
+ *
+ * @param config - Build pipeline configuration.
+ * @group Resource Packs
+ */
+export declare const addBuildPipeline: import("..").ResourcePackApplier<AddBuildPipelineConfig>;

package/iac/packs/cdn.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Configuration for the CDN pack.
+ */
+export type AddCDNConfig = {
+    /**
+     * CloudFront distribution id.
+     */
+    id: string;
+    /**
+     * Route53 hosted zone id for the domain.
+     */
+    hostedZoneId: any;
+    /**
+     * Domain name to serve.
+     */
+    domainName: any;
+    /**
+     * ACM certificate ARN for the domain.
+     */
+    certificateArn: any;
+    /**
+     * S3 file storage resource id.
+     */
+    fileStorageId: string;
+};
+/**
+ * Add a global cache of static files (a CDN) for things like your front-end, website, etc.
+ * Includes a DNS record for the domain.
+ *
+ * @param config - CDN configuration.
+ * @group Resource Packs
+ * */
+export declare const addCDN: import("..").ResourcePackApplier<AddCDNConfig>;

package/iac/packs/cloud-function.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @packageDocumentation
+ *
+ * Lambda pack that provisions a basic function with an IAM role and optional
+ * environment settings.
+ */
+import { AWS } from "../types/IaCTypes";
+/**
+ * Default inline function code for placeholder Lambda resources.
+ */
+export declare const PLACEHOLDER_FUNCTION_CODE: AWS.Lambda.Function.Code;
+/**
+ * Supported Lambda runtimes for cloud functions.
+ */
+export type CloudFunctionRuntime = "nodejs14.x" | "nodejs16.x" | "nodejs18.x" | "nodejs20.x" | "nodejs22.x" | "nodejs24.x" | "nodejs26.x" | "python3.8" | "python3.9" | "python3.10" | "python3.11" | "python3.12" | "python3.13" | "python3.14" | "python3.15" | "java11" | "java17" | "java21" | "java25" | "dotnet6" | "dotnet8" | "dotnet10" | "go1.x" | "ruby2.7" | "ruby3.2" | "ruby3.3" | "ruby3.4" | "ruby3.5" | "provided" | "provided.al2" | "provided.al2023";
+/**
+ * Configuration for the cloud function pack.
+ */
+export type AddCloudFunctionConfig = {
+    /**
+     * Base id for the function resources.
+     */
+    id: string;
+    /**
+     * Lambda function code.
+     */
+    code?: AWS.Lambda.Function.Code;
+    /**
+     * Lambda environment configuration.
+     */
+    environment?: AWS.Lambda.Function.Environment;
+    /**
+     * Function handler entrypoint.
+     */
+    handler?: any;
+    /**
+     * Lambda runtime.
+     */
+    runtime?: CloudFunctionRuntime;
+    /**
+     * Function timeout in seconds.
+     */
+    timeout?: any;
+    /**
+     * IAM policy statements to attach to the role.
+     */
+    policies?: AWS.IAM.Role.Policy[];
+    /**
+     * Lambda function memory size in MB.
+     *
+     * You can configure memory between 128 MB and 10,240 MB in 1-MB increments.
+     *
+     * @default 128
+     */
+    memorySize?: number;
+};
+/**
+ * Add a serverless cloud function to run part or all of your API (back-end) without always running servers.
+ *
+ * @param config - Cloud function configuration.
+ * */
+/**
+ * Add a cloud function resource with IAM role and configuration.
+ *
+ * @group Resource Packs
+ */
+export declare const addCloudFunction: import("..").ResourcePackApplier<AddCloudFunctionConfig>;

package/{src/iac → iac}/packs/database.d.ts

@@ -25,5 +25,8 @@ export type AddDatabaseConfig = {
 };
 /**
  * Add a highly available key-value database with global scale performance.
+ *
+ * @param config - Database configuration.
+ * @group Resource Packs
  * */
-export declare const addDatabase: import("../utils").ResourcePackApplier<AddDatabaseConfig>;
+export declare const addDatabase: import("..").ResourcePackApplier<AddDatabaseConfig>;

package/{src/iac → iac}/packs/dns.d.ts

@@ -1,13 +1,34 @@
 import { CloudFormationPrimitiveValue } from "../types/IaCTypes";
+/**
+ * Configuration for the DNS record pack.
+ */
 export type AddDNSConfig = {
+    /**
+     * Resource id for the DNS record.
+     */
     id: string;
+    /**
+     * Hosted zone id for the domain.
+     */
     hostedZoneId: CloudFormationPrimitiveValue<string>;
+    /**
+     * Fully qualified domain name.
+     */
     domainName: CloudFormationPrimitiveValue<string>;
+    /**
+     * Resource records for the DNS entry.
+     */
     resourceRecords: CloudFormationPrimitiveValue<string>[];
+    /**
+     * DNS record type.
+     */
     recordType?: CloudFormationPrimitiveValue<string>;
 };
 /**
  * Add DNS parameters for reference in other resources.
  * Optionally includes a front-end live development subdomain.
+ *
+ * @param config - DNS configuration.
+ * @group Resource Packs
  * */
-export declare const addDNS: import("../utils").ResourcePackApplier<AddDNSConfig>;
+export declare const addDNS: import("..").ResourcePackApplier<AddDNSConfig>;

package/iac/packs/file-storage.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @packageDocumentation
+ *
+ * Secure S3 bucket pack with configurable CORS and public access controls.
+ */
+import { AWS } from "../types/IaCTypes";
+/**
+ * Configuration for the secure file storage pack.
+ */
+export type AddSecureFileStorageConfig = {
+    /**
+     * S3 bucket resource id.
+     */
+    id: string;
+    /**
+     * Optional bucket name.
+     */
+    bucketName?: any;
+    /**
+     * Whether to delete the bucket on stack delete.
+     */
+    shouldDelete?: boolean;
+    /**
+     * Whether to block all public access.
+     */
+    blockPublicAccess?: boolean;
+    /**
+     * CORS configuration or enablement flag.
+     */
+    cors?: AWS.S3.Bucket["Properties"]["CorsConfiguration"] | boolean;
+    /**
+     * ACL configuration for the bucket.
+     */
+    accessControl?: AWS.S3.Bucket["Properties"]["AccessControl"];
+    /**
+     * Whether to allow ACLs by enabling ownership controls.
+     */
+    allowACLs?: boolean;
+};
+/**
+ * Add a secure S3 Bucket with an optional parameter to set the bucket name.
+ *
+ * @param config - File storage configuration.
+ * @group Resource Packs
+ * */
+export declare const addSecureFileStorage: import("..").ResourcePackApplier<AddSecureFileStorageConfig>;

package/iac/packs/gateway.d.ts

@@ -0,0 +1,79 @@
+import { CloudFormationPrimitiveValue } from "../types/IaCTypes";
+/**
+ * Default API Gateway authorization type.
+ */
+export declare const DEFAULT_AUTH_TYPE = "COGNITO_USER_POOLS";
+/**
+ * Configuration for API Gateway authorizers.
+ */
+export type AddGatewayAuthorizerConfig = {
+    /**
+     * Cognito provider ARNs for authorization.
+     */
+    providerARNs?: string[];
+    /**
+     * Authorization scopes to require.
+     */
+    scopes?: string[];
+    /**
+     * Authorizer type to use.
+     */
+    type?: "TOKEN" | "COGNITO_USER_POOLS" | "REQUEST";
+    /**
+     * Identity source expression for authorization.
+     */
+    identitySource?: string;
+};
+/**
+ * Configuration for the API Gateway pack.
+ */
+export type AddGatewayConfig = {
+    /**
+     * Base id for gateway resources.
+     */
+    id: string;
+    /**
+     * Hosted zone id for the API domain.
+     */
+    hostedZoneId: any;
+    /**
+     * Domain name for the API.
+     */
+    domainName: any;
+    /**
+     * ACM certificate ARN for the API domain.
+     */
+    certificateArn: CloudFormationPrimitiveValue<string>;
+    /**
+     * Target Lambda function information.
+     */
+    cloudFunction: {
+        id: string;
+        region?: string;
+    };
+    /**
+     * Stage name to deploy.
+     */
+    stageName?: any;
+    /**
+     * Authorizer config or boolean to enable/disable.
+     */
+    authorizer?: AddGatewayAuthorizerConfig | boolean;
+    /**
+     * Suffix to ensure unique deployment ids.
+     */
+    deploymentSuffix?: string;
+};
+/**
+ * Add a load-balanced API gateway for your serverless cloud function.
+ * Includes authorization config that connects your user management system to your cloud function.
+ * Also includes a DNS record for your API/back-end.
+ *
+ * @param config - Gateway configuration.
+ * */
+/**
+ * Add API Gateway resources with optional authorizer and DNS.
+ *
+ * @group Resource Packs
+ */
+export declare const addGateway: import("..").ResourcePackApplier<AddGatewayConfig>;

package/iac/packs/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @packageDocumentation
+ *
+ * Aggregated exports for IaC resource packs.
+ */
+/**
+ * @category iac
+ * @group Resource Packs
+ */
+export * from "./auth";
+/**
+ * @category iac
+ * @group Resource Packs
+ */
+export * from "./build";
+/**
+ * @category iac
+ * @group Utilities
+ */
+export * from "./build/utils";
+/**
+ * @category iac
+ * @group Resource Packs
+ */
+export * from "./cdn";
+/**
+ * @category iac
+ * @group Resource Packs
+ */
+export * from "./cloud-function";
+/**
+ * @category iac
+ * @group Resource Packs
+ */
+export * from "./database";
+/**
+ * @category iac
+ * @group Resource Packs
+ */
+export * from "./dns";
+/**
+ * @category iac
+ * @group Resource Packs
+ */
+export * from "./file-storage";
+/**
+ * @category iac
+ * @group Resource Packs
+ */
+export * from "./gateway";
+/**
+ * @category iac
+ * @group Resource Packs
+ */
+export * from "./repo";
+/**
+ * @category iac
+ * @group Resource Packs
+ */
+export * from "./ssl-certificate";