@resistdesign/voltra 3.0.0-alpha.16 → 3.0.0-alpha.18

package/iac/packs/auth/user-management.d.ts

@@ -1,7 +1,7 @@
 /**
  * Configuration for adding Cognito user management resources.
  */
-export type AddUserManagementConfig = {
+type AddUserManagementConfigBase = {
     /**
      * Base id for Cognito resources.
      */
@@ -14,18 +14,6 @@ export type AddUserManagementConfig = {
      * IAM role name for unauthenticated users.
      */
     unauthRoleName: string;
-    /**
-     * Base domain name for the user pool.
-     */
-    domainName: any;
-    /**
-     * Hosted zone id for DNS records.
-     */
-    hostedZoneId: any;
-    /**
-     * SSL certificate ARN for the user pool domain.
-     */
-    sslCertificateArn: any;
     /**
      * OAuth callback URLs.
      */
@@ -47,10 +35,46 @@ export type AddUserManagementConfig = {
      */
     apiStageName?: any;
 };
+type AddUserManagementConfigWithDomain = AddUserManagementConfigBase & {
+    /**
+     * Enable a custom Cognito user pool domain and associated Route53 records.
+     *
+     * Defaults to `true`.
+     */
+    enableUserPoolDomain?: true;
+    /**
+     * Base domain name for the user pool.
+     */
+    domainName: any;
+    /**
+     * Hosted zone id for DNS records.
+     */
+    hostedZoneId: any;
+    /**
+     * SSL certificate ARN for the user pool domain.
+     */
+    sslCertificateArn: any;
+};
+type AddUserManagementConfigWithoutDomain = AddUserManagementConfigBase & {
+    /**
+     * Disable custom Cognito user pool domain resources.
+     */
+    enableUserPoolDomain: false;
+    domainName?: never;
+    hostedZoneId?: never;
+    sslCertificateArn?: never;
+    baseDomainRecordAliasTargetDNSName?: never;
+};
+/**
+ * Configuration for {@link addUserManagement}.
+ */
+export type AddUserManagementConfig = AddUserManagementConfigWithDomain | AddUserManagementConfigWithoutDomain;
 /**
  * Add Cognito user management resources to a template.
  *
  * @param config - User management configuration.
  * @returns CloudFormation template fragment.
+ * @group Resource Packs
  */
-export declare const addUserManagement: import("../../utils").ResourcePackApplier<AddUserManagementConfig>;
+export declare const addUserManagement: import("../..").ResourcePackApplier<AddUserManagementConfig>;
+export {};

package/iac/packs/auth.d.ts

@@ -1,7 +1,7 @@
 /**
  * Configuration for the auth pack.
  */
-export type AddAuthConfig = {
+type AddAuthConfigBase = {
     /**
      * Cognito user pool resource id.
      */
@@ -14,22 +14,6 @@ export type AddAuthConfig = {
      * IAM role name for unauthenticated users.
      */
     unauthRoleName: string;
-    /**
-     * Parameter name for Route53 hosted zone id.
-     */
-    hostedZoneIdParameterName: string;
-    /**
-     * Parameter name for base domain.
-     */
-    domainNameParameterName: string;
-    /**
-     * SSL certificate resource id for the user pool domain.
-     */
-    sslCertificateId: string;
-    /**
-     * CloudFront distribution id for the main CDN.
-     */
-    mainCDNCloudFrontId: string;
     /**
      * API Gateway REST API id for the backend.
      */
@@ -55,12 +39,48 @@ export type AddAuthConfig = {
      */
     logoutUrls: any[];
 };
+type AddAuthConfigWithUserPoolDomain = AddAuthConfigBase & {
+    /**
+     * Enable a custom Cognito user pool domain and associated Route53 records.
+     *
+     * Defaults to `true`.
+     */
+    enableUserPoolDomain?: true;
+    /**
+     * Parameter name for Route53 hosted zone id.
+     */
+    hostedZoneIdParameterName: string;
+    /**
+     * Parameter name for base domain.
+     */
+    domainNameParameterName: string;
+    /**
+     * SSL certificate resource id for the user pool domain.
+     */
+    sslCertificateId: string;
+    /**
+     * CloudFront distribution id for the main CDN.
+     */
+    mainCDNCloudFrontId: string;
+};
+type AddAuthConfigWithoutUserPoolDomain = AddAuthConfigBase & {
+    /**
+     * Disable custom Cognito user pool domain resources.
+     */
+    enableUserPoolDomain: false;
+    hostedZoneIdParameterName?: never;
+    domainNameParameterName?: never;
+    sslCertificateId?: never;
+    mainCDNCloudFrontId?: never;
+};
 /**
- * Add a user management system.
- *
- * @param config - Auth pack configuration.
- * */
+ * Configuration for {@link addAuth}.
+ */
+export type AddAuthConfig = AddAuthConfigWithUserPoolDomain | AddAuthConfigWithoutUserPoolDomain;
 /**
  * Add auth resources including user management and an admin group.
+ *
+ * @group Resource Packs
  */
-export declare const addAuth: import("../utils").ResourcePackApplier<AddAuthConfig>;
+export declare const addAuth: import("..").ResourcePackApplier<AddAuthConfig>;
+export {};

package/iac/packs/build.d.ts

@@ -87,5 +87,6 @@ export type AddBuildPipelineConfig = {
  * Add a build pipeline with full permissions.
  *
  * @param config - Build pipeline configuration.
+ * @group Resource Packs
  */
-export declare const addBuildPipeline: import("../utils").ResourcePackApplier<AddBuildPipelineConfig>;
+export declare const addBuildPipeline: import("..").ResourcePackApplier<AddBuildPipelineConfig>;

package/iac/packs/cdn.d.ts

@@ -28,5 +28,6 @@ export type AddCDNConfig = {
  * Includes a DNS record for the domain.
  *
  * @param config - CDN configuration.
+ * @group Resource Packs
  * */
-export declare const addCDN: import("../utils").ResourcePackApplier<AddCDNConfig>;
+export declare const addCDN: import("..").ResourcePackApplier<AddCDNConfig>;

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

@@ -61,5 +61,7 @@ export type AddCloudFunctionConfig = {
  * */
 /**
  * Add a cloud function resource with IAM role and configuration.
+ *
+ * @group Resource Packs
  */
-export declare const addCloudFunction: import("../utils").ResourcePackApplier<AddCloudFunctionConfig>;
+export declare const addCloudFunction: import("..").ResourcePackApplier<AddCloudFunctionConfig>;

package/iac/packs/database.d.ts

@@ -27,5 +27,6 @@ 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/iac/packs/dns.d.ts

@@ -29,5 +29,6 @@ export type AddDNSConfig = {
  * 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

@@ -41,5 +41,6 @@ export type AddSecureFileStorageConfig = {
  * 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("../utils").ResourcePackApplier<AddSecureFileStorageConfig>;
+export declare const addSecureFileStorage: import("..").ResourcePackApplier<AddSecureFileStorageConfig>;

package/iac/packs/gateway.d.ts

@@ -73,5 +73,7 @@ export type AddGatewayConfig = {
  * */
 /**
  * Add API Gateway resources with optional authorizer and DNS.
+ *
+ * @group Resource Packs
  */
-export declare const addGateway: import("../utils").ResourcePackApplier<AddGatewayConfig>;
+export declare const addGateway: import("..").ResourcePackApplier<AddGatewayConfig>;

package/iac/packs/index.d.ts

@@ -3,14 +3,58 @@
  *
  * 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";

package/iac/packs/index.js

@@ -170,19 +170,16 @@ var createResourcePack = (creator) => (params, template) => {
 
 // src/iac/packs/auth/user-management.ts
 var addUserManagement = createResourcePack(
-  ({
-    id,
-    authRoleName,
-    unauthRoleName,
-    domainName,
-    hostedZoneId,
-    sslCertificateArn,
-    callbackUrls,
-    logoutUrls,
-    baseDomainRecordAliasTargetDNSName,
-    apiGatewayRESTAPIId,
-    apiStageName
-  }) => {
+  (config) => {
+    const {
+      id,
+      authRoleName,
+      unauthRoleName,
+      callbackUrls,
+      logoutUrls,
+      apiGatewayRESTAPIId,
+      apiStageName
+    } = config;
     const apiRoleConfig = apiGatewayRESTAPIId && apiStageName ? {
       [`${id}IdentityPoolRoles`]: {
         Type: "AWS::Cognito::IdentityPoolRoleAttachment",
@@ -317,6 +314,63 @@ var addUserManagement = createResourcePack(
         }
       }
     } : {};
+    const userPoolDomainConfig = config.enableUserPoolDomain === false ? {} : {
+      [`${id}BaseDomainRecord`]: !!config.baseDomainRecordAliasTargetDNSName ? {
+        Type: "AWS::Route53::RecordSet",
+        DeletionPolicy: "Delete",
+        Properties: {
+          HostedZoneId: config.hostedZoneId,
+          Type: "A",
+          Name: config.domainName,
+          AliasTarget: {
+            HostedZoneId: "Z2FDTNDATAQYW2",
+            DNSName: config.baseDomainRecordAliasTargetDNSName
+          }
+        }
+      } : void 0,
+      [`${id}DomainRecord`]: {
+        Type: "AWS::Route53::RecordSet",
+        DeletionPolicy: "Delete",
+        Properties: {
+          HostedZoneId: config.hostedZoneId,
+          Type: "A",
+          Name: {
+            "Fn::Sub": [
+              "auth.${BaseDomainName}",
+              {
+                BaseDomainName: config.domainName
+              }
+            ]
+          },
+          AliasTarget: {
+            HostedZoneId: "Z2FDTNDATAQYW2",
+            DNSName: {
+              "Fn::GetAtt": [`${id}Domain`, "CloudFrontDistribution"]
+            }
+          }
+        }
+      },
+      [`${id}Domain`]: {
+        Type: "AWS::Cognito::UserPoolDomain",
+        DependsOn: !!config.baseDomainRecordAliasTargetDNSName ? `${id}BaseDomainRecord` : void 0,
+        Properties: {
+          Domain: {
+            "Fn::Sub": [
+              "auth.${BaseDomainName}",
+              {
+                BaseDomainName: config.domainName
+              }
+            ]
+          },
+          UserPoolId: {
+            Ref: id
+          },
+          CustomDomainConfig: {
+            CertificateArn: config.sslCertificateArn
+          }
+        }
+      }
+    };
     return {
       Resources: {
         [id]: {
@@ -370,61 +424,6 @@ var addUserManagement = createResourcePack(
             }
           }
         },
-        [`${id}BaseDomainRecord`]: !!baseDomainRecordAliasTargetDNSName ? {
-          Type: "AWS::Route53::RecordSet",
-          DeletionPolicy: "Delete",
-          Properties: {
-            HostedZoneId: hostedZoneId,
-            Type: "A",
-            Name: domainName,
-            AliasTarget: {
-              HostedZoneId: "Z2FDTNDATAQYW2",
-              DNSName: baseDomainRecordAliasTargetDNSName
-            }
-          }
-        } : void 0,
-        [`${id}DomainRecord`]: {
-          Type: "AWS::Route53::RecordSet",
-          DeletionPolicy: "Delete",
-          Properties: {
-            HostedZoneId: hostedZoneId,
-            Type: "A",
-            Name: {
-              "Fn::Sub": [
-                "auth.${BaseDomainName}",
-                {
-                  BaseDomainName: domainName
-                }
-              ]
-            },
-            AliasTarget: {
-              HostedZoneId: "Z2FDTNDATAQYW2",
-              DNSName: {
-                "Fn::GetAtt": [`${id}Domain`, "CloudFrontDistribution"]
-              }
-            }
-          }
-        },
-        [`${id}Domain`]: {
-          Type: "AWS::Cognito::UserPoolDomain",
-          DependsOn: !!baseDomainRecordAliasTargetDNSName ? `${id}BaseDomainRecord` : void 0,
-          Properties: {
-            Domain: {
-              "Fn::Sub": [
-                "auth.${BaseDomainName}",
-                {
-                  BaseDomainName: domainName
-                }
-              ]
-            },
-            UserPoolId: {
-              Ref: id
-            },
-            CustomDomainConfig: {
-              CertificateArn: sslCertificateArn
-            }
-          }
-        },
         [`${id}Client`]: {
           Type: "AWS::Cognito::UserPoolClient",
           Properties: {
@@ -470,6 +469,7 @@ var addUserManagement = createResourcePack(
             ]
           }
         },
+        ...userPoolDomainConfig,
         ...apiRoleConfig
       }
     };
@@ -488,7 +488,7 @@ var SimpleCFT = class {
   }
   /**
    * Apply a pack with configuration to the stack template.
-   * @see {@link IaC} for an example.
+   * @see `@resistdesign/voltra/iac` and `@resistdesign/voltra/iac/packs` for examples.
    * */
   applyPack = (pack, params) => {
     this.template = pack(params, this.template);
@@ -563,43 +563,45 @@ var SimpleCFT = class {
 };
 
 // src/iac/packs/auth.ts
-var addAuth = createResourcePack(
-  ({
+var addAuth = createResourcePack((config) => {
+  const {
     userManagementId,
     authRoleName,
     unauthRoleName,
-    hostedZoneIdParameterName,
-    domainNameParameterName,
-    sslCertificateId,
     callbackUrls,
     logoutUrls,
-    mainCDNCloudFrontId,
     apiCloudFunctionGatewayId,
     apiStageName,
     adminGroupId,
     userManagementAdminGroupName
-  }) => new SimpleCFT().applyPack(addUserManagement, {
+  } = config;
+  return new SimpleCFT().applyPack(addUserManagement, {
     id: userManagementId,
     authRoleName,
     unauthRoleName,
-    domainName: {
-      Ref: domainNameParameterName
-    },
-    hostedZoneId: {
-      Ref: hostedZoneIdParameterName
-    },
-    sslCertificateArn: {
-      Ref: sslCertificateId
-    },
     callbackUrls,
     logoutUrls,
-    baseDomainRecordAliasTargetDNSName: {
-      "Fn::GetAtt": [mainCDNCloudFrontId, "DomainName"]
-    },
     apiGatewayRESTAPIId: {
       Ref: apiCloudFunctionGatewayId
     },
-    apiStageName
+    apiStageName,
+    ...config.enableUserPoolDomain === false ? {
+      enableUserPoolDomain: false
+    } : {
+      enableUserPoolDomain: true,
+      domainName: {
+        Ref: config.domainNameParameterName
+      },
+      hostedZoneId: {
+        Ref: config.hostedZoneIdParameterName
+      },
+      sslCertificateArn: {
+        Ref: config.sslCertificateId
+      },
+      baseDomainRecordAliasTargetDNSName: {
+        "Fn::GetAtt": [config.mainCDNCloudFrontId, "DomainName"]
+      }
+    }
   }).patch({
     Resources: {
       [adminGroupId]: {
@@ -613,8 +615,8 @@ var addAuth = createResourcePack(
         }
       }
     }
-  }).template
-);
+  }).template;
+});
 
 // src/iac/packs/build.ts
 var DEFAULT_BUILD_PIPELINE_REPO_PROVIDER = "GitHub";

package/iac/packs/repo.d.ts

@@ -23,5 +23,6 @@ export type AddRepoConfig = {
  * Add repository related parameters for reference in other resources like a build pipeline (CI/CD).
  *
  * @param config - Repository parameter configuration.
+ * @group Resource Packs
  * */
-export declare const addRepo: import("../utils").ResourcePackApplier<AddRepoConfig>;
+export declare const addRepo: import("..").ResourcePackApplier<AddRepoConfig>;

package/iac/packs/ssl-certificate.d.ts

@@ -23,5 +23,6 @@ export type AddSSLCertificateConfig = {
  * Add an automatic SSL Certificate for a domain and all of it's subdomains.
  *
  * @param config - SSL certificate configuration.
+ * @group Resource Packs
  * */
-export declare const addSSLCertificate: import("../utils").ResourcePackApplier<AddSSLCertificateConfig>;
+export declare const addSSLCertificate: import("..").ResourcePackApplier<AddSSLCertificateConfig>;

package/native/index.d.ts

@@ -4,14 +4,12 @@
  * Native entrypoint exports.
  */
 /**
- * @deprecated Prefer domain-flat imports such as
- * `import { createNativeFormRenderer } from "@resistdesign/voltra/native"`.
+ * @category native
+ * @group Forms
  */
-export * as Forms from "./forms";
+export * from "./forms";
 /**
- * @deprecated Prefer domain-flat imports such as
- * `import { makeNativeEasyLayout } from "@resistdesign/voltra/native"`.
+ * @category native
+ * @group Layout and Navigation
  */
-export * as Utils from "./utils";
-export * from "./forms";
 export * from "./utils";

package/native/index.js

@@ -1,30 +1,12 @@
 import { createContext, useContext, createElement, useState, useEffect, useMemo, useRef } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
-var __defProp = Object.defineProperty;
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
   get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
 }) : x)(function(x) {
   if (typeof require !== "undefined") return require.apply(this, arguments);
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-// src/native/forms/index.ts
-var forms_exports = {};
-__export(forms_exports, {
-  ArrayContainer: () => ArrayContainer,
-  ArrayItemWrapper: () => ArrayItemWrapper,
-  Button: () => Button,
-  ErrorMessage: () => ErrorMessage,
-  FieldWrapper: () => FieldWrapper,
-  createNativeFormRenderer: () => createNativeFormRenderer,
-  nativeAutoField: () => nativeAutoField,
-  nativeSuite: () => nativeSuite
-});
 
 // src/app/forms/core/getFieldKind.ts
 var hasSelectableValues = (field) => {
@@ -503,33 +485,6 @@ var createNativeFormRenderer = (options) => {
   });
 };
 
-// src/native/utils/index.ts
-var utils_exports = {};
-__export(utils_exports, {
-  NativeEasyLayoutView: () => NativeEasyLayoutView,
-  NativeRoute: () => NativeRoute,
-  NativeRouteProvider: () => NativeRouteProvider,
-  Route: () => Route,
-  RouteContext: () => RouteContext,
-  RouteContextConsumer: () => RouteContextConsumer,
-  RouteContextProvider: () => RouteContextProvider,
-  RouteProvider: () => RouteProvider,
-  buildHistoryPath: () => buildHistoryPath,
-  buildPathFromRouteChain: () => buildPathFromRouteChain,
-  buildQueryString: () => buildQueryString,
-  buildRoutePath: () => buildRoutePath,
-  createManualRouteAdapter: () => createManualRouteAdapter,
-  createMemoryHistory: () => createMemoryHistory,
-  createNativeBackHandler: () => createNativeBackHandler,
-  createNativeHistory: () => createNativeHistory,
-  createNavigationStateRouteAdapter: () => createNavigationStateRouteAdapter,
-  makeNativeEasyLayout: () => makeNativeEasyLayout,
-  mapNativeURLToPath: () => mapNativeURLToPath,
-  parseHistoryPath: () => parseHistoryPath,
-  useNativeEasyLayout: () => useNativeEasyLayout,
-  useRouteContext: () => useRouteContext
-});
-
 // src/common/Routing.ts
 var PATH_DELIMITER = "/";
 var getPotentialJSONValue = (value) => {
@@ -1349,4 +1304,4 @@ var buildPathFromRouteChain = (routeChain, config, query) => {
   return buildRoutePath(segments, query);
 };
 
-export { ArrayContainer, ArrayItemWrapper, Button, ErrorMessage, FieldWrapper, forms_exports as Forms, NativeEasyLayoutView, NativeRoute, NativeRouteProvider, Route, RouteContext, RouteContextConsumer, RouteContextProvider, RouteProvider, utils_exports as Utils, buildHistoryPath, buildPathFromRouteChain, buildQueryString, buildRoutePath, createManualRouteAdapter, createMemoryHistory, createNativeBackHandler, createNativeFormRenderer, createNativeHistory, createNavigationStateRouteAdapter, makeNativeEasyLayout, mapNativeURLToPath, nativeAutoField, nativeSuite, parseHistoryPath, useNativeEasyLayout, useRouteContext };
+export { ArrayContainer, ArrayItemWrapper, Button, ErrorMessage, FieldWrapper, NativeEasyLayoutView, NativeRoute, NativeRouteProvider, Route, RouteContext, RouteContextConsumer, RouteContextProvider, RouteProvider, buildHistoryPath, buildPathFromRouteChain, buildQueryString, buildRoutePath, createManualRouteAdapter, createMemoryHistory, createNativeBackHandler, createNativeFormRenderer, createNativeHistory, createNavigationStateRouteAdapter, makeNativeEasyLayout, mapNativeURLToPath, nativeAutoField, nativeSuite, parseHistoryPath, useNativeEasyLayout, useRouteContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@resistdesign/voltra",
-  "version": "3.0.0-alpha.16",
+  "version": "3.0.0-alpha.18",
   "description": "With our powers combined!",
   "homepage": "https://voltra.app",
   "repository": "git@github.com:resistdesign/voltra.git",

package/web/index.d.ts

@@ -4,14 +4,12 @@
  * Web (DOM) entrypoint exports.
  */
 /**
- * @deprecated Prefer domain-flat imports such as
- * `import { createWebFormRenderer } from "@resistdesign/voltra/web"`.
+ * @category web
+ * @group Forms
  */
-export * as Forms from "./forms";
+export * from "./forms";
 /**
- * @deprecated Prefer domain-flat imports such as
- * `import { getEasyLayout } from "@resistdesign/voltra/web"`.
+ * @category web
+ * @group Layout and Navigation
  */
-export * as Utils from "./utils";
-export * from "./forms";
 export * from "./utils";