@leaddreamer/inventorylogic 0.0.3-beta.30 → 0.0.3-beta.38

package/README.md

@@ -19,6 +19,9 @@ services.</p>
 <dd><p>A collection of Business logic and database functions.  Shared between ReactJS
 frontEnd and NodeJS BackEnd</p>
 </dd>
+<dt><a href="#module_Addresses">Addresses</a></dt>
+<dd><p>Types and functins for handling addresses</p>
+</dd>
 <dt><a href="#module_BusinessData">BusinessData</a></dt>
 <dd><p>Functions for managing (potentially)private data for an organization.
 Unified structure as a sub-record of organization, or CityManager accounts</p>
@@ -27,6 +30,10 @@ Unified structure as a sub-record of organization, or CityManager accounts</p>
 <dd><p>Typedefs, constants, support functions and database operations related to Commodity Matrials
 users</p>
 </dd>
+<dt><a href="#module_Fundamentals">Fundamentals</a></dt>
+<dd><p>Typedefs, constants, support functions and database operations related to Fundamental
+setting from the Database *</p>
+</dd>
 <dt><a href="#module_LineItem">LineItem</a></dt>
 <dd><p>Typedefs, constants, support functions and database operations related to LineItem Matrials
 users</p>
@@ -40,6 +47,10 @@ users</p>
 to an individual user.  These do not <em>particularly</em> represent a paymentProvider - they are meant
 as an abstraction above a specific payment processor.</p>
 </dd>
+<dt><a href="#module_PrivateData">PrivateData</a></dt>
+<dd><p>Functions for managing (potentially)private data for a user or organization.
+Unified structure as a sub-record of fan, organization, or CityManager accounts</p>
+</dd>
 <dt><a href="#module_Product">Product</a></dt>
 <dd><p>Typedefs, constants, support functions and database operations related to Products</p>
 </dd>
@@ -182,6 +193,141 @@ called from a cloud environment
 | measurementId: | <code>string</code> | (optional) Analytics/Measurement ID from Firebase Console |
 | mapsAPIKey | <code>string</code> | (optional) App ID for Google Maps API, from Google |
 
+<a name="module_Addresses"></a>
+
+## Addresses
+Types and functins for handling addresses
+
+
+* [Addresses](#module_Addresses)
+    * _static_
+        * [.AddressDefault](#module_Addresses.AddressDefault) : <code>AddressType</code>
+        * [.AddressForm](#module_Addresses.AddressForm) : <code>AddressType</code>
+        * [.maplink](#module_Addresses.maplink) : <code>MapLink</code>
+        * [.deleteAddress(address)](#module_Addresses.deleteAddress) ⇒ <code>Promise.&lt;void&gt;</code>
+        * [.deleteAddressByIdAndParent(addressId, parent, batch)](#module_Addresses.deleteAddressByIdAndParent) ⇒ <code>Promise.ChainType</code>
+        * [.formatAddress(address)](#module_Addresses.formatAddress) ⇒ <code>string</code>
+        * [.saveAddress(address, paraentRefPath)](#module_Addresses.saveAddress) ⇒ <code>Promise.&lt;AddressType&gt;</code>
+        * [.fetchAddresses(account)](#module_Addresses.fetchAddresses) ⇒ <code>Promise.&lt;Array.AddressType&gt;</code>
+    * _inner_
+        * [~AddressType](#module_Addresses..AddressType) : <code>object</code>
+        * [~MapLink](#module_Addresses..MapLink) : <code>object</code>
+        * [~ChainType](#module_Addresses..ChainType) : <code>WriteBatch</code> \| <code>Transaction</code> \| <code>void</code>
+
+<a name="module_Addresses.AddressDefault"></a>
+
+### Addresses.AddressDefault : <code>AddressType</code>
+**Kind**: static constant of [<code>Addresses</code>](#module_Addresses)  
+<a name="module_Addresses.AddressForm"></a>
+
+### Addresses.AddressForm : <code>AddressType</code>
+**Kind**: static constant of [<code>Addresses</code>](#module_Addresses)  
+<a name="module_Addresses.maplink"></a>
+
+### Addresses.maplink : <code>MapLink</code>
+**Kind**: static constant of [<code>Addresses</code>](#module_Addresses)  
+**Read only**: true  
+<a name="module_Addresses.deleteAddress"></a>
+
+### Addresses.deleteAddress(address) ⇒ <code>Promise.&lt;void&gt;</code>
+Deletes an existing address record from the database, based on it's own refPath
+
+**Kind**: static method of [<code>Addresses</code>](#module_Addresses)  
+
+| Param | Type |
+| --- | --- |
+| address | <code>AddressType</code> | 
+| address.refPath | <code>string</code> | 
+
+<a name="module_Addresses.deleteAddressByIdAndParent"></a>
+
+### Addresses.deleteAddressByIdAndParent(addressId, parent, batch) ⇒ <code>Promise.ChainType</code>
+Deletes an existing address record from the database, based on it's parent
+record and Id
+
+**Kind**: static method of [<code>Addresses</code>](#module_Addresses)  
+
+| Param | Type |
+| --- | --- |
+| addressId | <code>string</code> | 
+| parent | <code>OrganizationType</code> | 
+| parent.refPath | <code>string</code> | 
+| batch | <code>ChainType</code> | 
+
+<a name="module_Addresses.formatAddress"></a>
+
+### Addresses.formatAddress(address) ⇒ <code>string</code>
+Builds a formatted string from a provided address record
+
+**Kind**: static method of [<code>Addresses</code>](#module_Addresses)  
+
+| Param | Type |
+| --- | --- |
+| address | <code>AddressType</code> | 
+
+<a name="module_Addresses.saveAddress"></a>
+
+### Addresses.saveAddress(address, paraentRefPath) ⇒ <code>Promise.&lt;AddressType&gt;</code>
+Saves an address record to the database below the provided parentRefPath,
+whether exsiting or not
+
+**Kind**: static method of [<code>Addresses</code>](#module_Addresses)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| address | <code>AddressType</code> |  |
+| address.refPath | <code>string</code> | if present, writes back |
+| paraentRefPath | <code>string</code> | required if new record |
+
+<a name="module_Addresses.fetchAddresses"></a>
+
+### Addresses.fetchAddresses(account) ⇒ <code>Promise.&lt;Array.AddressType&gt;</code>
+Fetches all address records for an account
+
+**Kind**: static method of [<code>Addresses</code>](#module_Addresses)  
+
+| Param | Type |
+| --- | --- |
+| account | <code>Record</code> | 
+| account.refPath | <code>string</code> | 
+
+<a name="module_Addresses..AddressType"></a>
+
+### Addresses~AddressType : <code>object</code>
+**Kind**: inner typedef of [<code>Addresses</code>](#module_Addresses)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| Id | <code>string</code> | will be populated for existing record; null or missing for new/minimal object |
+| refPath | <code>string</code> | will be populated for existing record; null or missing for new/minimal object |
+| address_line_1 | <code>string</code> |  |
+| address_line_2 | <code>string</code> |  |
+| city | <code>string</code> |  |
+| region | <code>string</code> | selected from a list of supported Cities/Regions |
+| state | <code>string</code> |  |
+| zip | <code>zip</code> |  |
+| mapLink | <code>maplink</code> | link to Google map location |
+
+<a name="module_Addresses..MapLink"></a>
+
+### Addresses~MapLink : <code>object</code>
+**Kind**: inner typedef of [<code>Addresses</code>](#module_Addresses)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| placeId | <code>string</code> | as defined by Google |
+| latlng | <code>object</code> | coordinates tuple |
+| latlng.lat | <code>string</code> | lattitude |
+| latlng.lng | <code>string</code> | longitude |
+| url | <code>string</code> | link to place/map entry |
+| formatted_address | <code>string</code> | printable string of address |
+
+<a name="module_Addresses..ChainType"></a>
+
+### Addresses~ChainType : <code>WriteBatch</code> \| <code>Transaction</code> \| <code>void</code>
+**Kind**: inner typedef of [<code>Addresses</code>](#module_Addresses)  
 <a name="module_BusinessData"></a>
 
 ## BusinessData
@@ -595,6 +741,166 @@ An object to allow for paginating a table read from Firestore. REQUIRES a sortin
 | PageForward | <code>method</code> | pages the fetch forward |
 | PageBack | <code>method</code> | pages the fetch backward |
 
+<a name="module_Fundamentals"></a>
+
+## Fundamentals
+Typedefs, constants, support functions and database operations related to Fundamental
+setting from the Database *
+
+
+* [Fundamentals](#module_Fundamentals)
+    * _static_
+        * [.fetchFundamentals()](#module_Fundamentals.fetchFundamentals) ⇒ <code>Promise.&lt;Fundamentals&gt;</code>
+        * [.fetchRates()](#module_Fundamentals.fetchRates) ⇒ <code>Promise.&lt;Rates&gt;</code>
+        * [.fetchPayoutRates()](#module_Fundamentals.fetchPayoutRates) ⇒ <code>Promise.&lt;PaymentProcessor&gt;</code>
+        * [.fetchMCCs()](#module_Fundamentals.fetchMCCs) ⇒ <code>Promise.&lt;Array.MCCType&gt;</code>
+        * [.fetchBusinessTypes()](#module_Fundamentals.fetchBusinessTypes) ⇒ <code>Promise.&lt;Array.BusinessType&gt;</code>
+    * _inner_
+        * [~Rates](#module_Fundamentals..Rates) : <code>Rates</code>
+        * [~paymentProcessor](#module_Fundamentals..paymentProcessor) : <code>PaymentProcessor</code>
+        * [~MCCDefault](#module_Fundamentals..MCCDefault) : <code>MCCType</code>
+        * [~BusinessTypeDefault](#module_Fundamentals..BusinessTypeDefault) : <code>BusinessType</code>
+        * [~OrganizationFundamentals](#module_Fundamentals..OrganizationFundamentals) : <code>object</code>
+        * [~Rates](#module_Fundamentals..Rates) : <code>object</code>
+        * [~PaymentProcessor](#module_Fundamentals..PaymentProcessor) : <code>object</code>
+        * [~MCCType](#module_Fundamentals..MCCType) : <code>object</code>
+        * [~BusinessType](#module_Fundamentals..BusinessType) : <code>object</code>
+        * [~Fundamentals](#module_Fundamentals..Fundamentals) : <code>object</code>
+
+<a name="module_Fundamentals.fetchFundamentals"></a>
+
+### Fundamentals.fetchFundamentals() ⇒ <code>Promise.&lt;Fundamentals&gt;</code>
+returns a Promise which resolves with an
+array of all Fundamentals Objects (or err)
+
+**Kind**: static method of [<code>Fundamentals</code>](#module_Fundamentals)  
+<a name="module_Fundamentals.fetchRates"></a>
+
+### Fundamentals.fetchRates() ⇒ <code>Promise.&lt;Rates&gt;</code>
+returns a Promise that resolves  with the Rates record from the database
+
+**Kind**: static method of [<code>Fundamentals</code>](#module_Fundamentals)  
+<a name="module_Fundamentals.fetchPayoutRates"></a>
+
+### Fundamentals.fetchPayoutRates() ⇒ <code>Promise.&lt;PaymentProcessor&gt;</code>
+returns a Promise that resolves  with the Rates record from the database
+
+**Kind**: static method of [<code>Fundamentals</code>](#module_Fundamentals)  
+<a name="module_Fundamentals.fetchMCCs"></a>
+
+### Fundamentals.fetchMCCs() ⇒ <code>Promise.&lt;Array.MCCType&gt;</code>
+returns an array of all MCC (Merchant Commerce Code) available
+
+**Kind**: static method of [<code>Fundamentals</code>](#module_Fundamentals)  
+<a name="module_Fundamentals.fetchBusinessTypes"></a>
+
+### Fundamentals.fetchBusinessTypes() ⇒ <code>Promise.&lt;Array.BusinessType&gt;</code>
+returns an array of all MCC (Merchant Commerce Code) available
+
+**Kind**: static method of [<code>Fundamentals</code>](#module_Fundamentals)  
+<a name="module_Fundamentals..Rates"></a>
+
+### Fundamentals~Rates : <code>Rates</code>
+**Kind**: inner constant of [<code>Fundamentals</code>](#module_Fundamentals)  
+**Default**: <code>{&quot;Id&quot;:null,&quot;service_charge&quot;:&quot;&quot;}</code>  
+<a name="module_Fundamentals..paymentProcessor"></a>
+
+### Fundamentals~paymentProcessor : <code>PaymentProcessor</code>
+**Kind**: inner constant of [<code>Fundamentals</code>](#module_Fundamentals)  
+**Default**: <code>{&quot;connected_active&quot;:200,&quot;processing_concurrency&quot;:10,&quot;processing_rate&quot;:25,&quot;processing_time_window&quot;:1000,&quot;per_payout&quot;:25,&quot;rate_payout&quot;:25,&quot;rate_payout_scale&quot;:10000}</code>  
+<a name="module_Fundamentals..MCCDefault"></a>
+
+### Fundamentals~MCCDefault : <code>MCCType</code>
+**Kind**: inner constant of [<code>Fundamentals</code>](#module_Fundamentals)  
+**Default**: <code>{&quot;Id&quot;:null,&quot;MCC&quot;:null,&quot;name&quot;:null,&quot;description&quot;:null,&quot;long&quot;:null,&quot;type&quot;:null}</code>  
+<a name="module_Fundamentals..BusinessTypeDefault"></a>
+
+### Fundamentals~BusinessTypeDefault : <code>BusinessType</code>
+**Kind**: inner constant of [<code>Fundamentals</code>](#module_Fundamentals)  
+**Default**: <code>{&quot;Id&quot;:null,&quot;business_type&quot;:null,&quot;name&quot;:null,&quot;description&quot;:null}</code>  
+<a name="module_Fundamentals..OrganizationFundamentals"></a>
+
+### Fundamentals~OrganizationFundamentals : <code>object</code>
+**Kind**: inner typedef of [<code>Fundamentals</code>](#module_Fundamentals)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| Types | <code>Array.string</code> | Allowed organization types |
+
+<a name="module_Fundamentals..Rates"></a>
+
+### Fundamentals~Rates : <code>object</code>
+**Kind**: inner typedef of [<code>Fundamentals</code>](#module_Fundamentals)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| Id | <code>string</code> |  |
+| service_charge | <code>object</code> |  |
+| service_charge.minimum | <code>number</code> |  |
+| service_charge.rate | <code>number</code> | percentage |
+| service_charge.rounding_factor | <code>number</code> |  |
+
+<a name="module_Fundamentals..PaymentProcessor"></a>
+
+### Fundamentals~PaymentProcessor : <code>object</code>
+**Kind**: inner typedef of [<code>Fundamentals</code>](#module_Fundamentals)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| connected_active | <code>number</code> | allowed active connections |
+| processing_concurrency | <code>number</code> |  |
+| processing_rate | <code>number</code> |  |
+| processing_time_window | <code>number</code> |  |
+| per_payout | <code>number</code> |  |
+| rate_payout | <code>number</code> |  |
+| rate_payout_scale | <code>number</code> |  |
+
+<a name="module_Fundamentals..MCCType"></a>
+
+### Fundamentals~MCCType : <code>object</code>
+**Kind**: inner typedef of [<code>Fundamentals</code>](#module_Fundamentals)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| Id | <code>string</code> |  |
+| MCC | <code>string</code> | Merchant Class Code |
+| name | <code>string</code> | Merchant Class Code |
+| description | <code>string</code> | description of Merchant Class Code |
+| long | <code>string</code> | long description of Merchant Class Code |
+| type | <code>string</code> | Applicable business model - "Artists", "Venues" or "Brands" |
+
+<a name="module_Fundamentals..BusinessType"></a>
+
+### Fundamentals~BusinessType : <code>object</code>
+**Kind**: inner typedef of [<code>Fundamentals</code>](#module_Fundamentals)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| Id | <code>string</code> |  |
+| business_type | <code>string</code> | allowed business type value |
+| name | <code>string</code> | business type value |
+| description | <code>string</code> | description ofbusiness type value |
+
+<a name="module_Fundamentals..Fundamentals"></a>
+
+### Fundamentals~Fundamentals : <code>object</code>
+**Kind**: inner typedef of [<code>Fundamentals</code>](#module_Fundamentals)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| Rates | <code>Rates</code> |  |
+| PaymentProcessor | <code>PaymentProcessor</code> |  |
+| Defaults | <code>object</code> |  |
+| Defaults.MCC | <code>MCCType</code> |  |
+| Organizations | <code>OrganizationFundamentals</code> |  |
+| Organizations.Types | <code>Array.string</code> | Allowed organization types |
+
 <a name="module_LineItem"></a>
 
 ## LineItem
@@ -1342,6 +1648,127 @@ Changes the paidQ label on a receipt associated with a pledgeTicket
 
 ### Payment~AccountObject : <code>UserObject</code>
 **Kind**: inner typedef of [<code>Payment</code>](#module_Payment)  
+<a name="module_PrivateData"></a>
+
+## PrivateData
+Functions for managing (potentially)private data for a user or organization.
+Unified structure as a sub-record of fan, organization, or CityManager accounts
+
+
+* [PrivateData](#module_PrivateData)
+    * _static_
+        * [.fetchPrivateData(account)](#module_PrivateData.fetchPrivateData) ⇒ <code>Promise.PrivateData</code>
+        * [.createPrivateData(account, batch)](#module_PrivateData.createPrivateData) ⇒ <code>Promise.&lt;ChainType&gt;</code>
+        * [.savePrivateData(privateData)](#module_PrivateData.savePrivateData) ⇒ <code>Promise.&lt;PrivateData&gt;</code>
+        * [.deletePrivateData(privateData)](#module_PrivateData.deletePrivateData) ⇒ <code>Promise.&lt;void&gt;</code>
+        * [.privateDataPath(account)](#module_PrivateData.privateDataPath) ⇒ <code>string</code>
+    * _inner_
+        * [~PrivateDefault](#module_PrivateData..PrivateDefault) : <code>PrivateData</code>
+        * [~PrivateAccountForm](#module_PrivateData..PrivateAccountForm) : <code>PrivateData</code>
+        * [~contact](#module_PrivateData..contact) : <code>object</code>
+        * [~PrivateData](#module_PrivateData..PrivateData) : <code>object</code>
+        * [~ChainType](#module_PrivateData..ChainType) : <code>WriteBatch</code> \| <code>Transaction</code> \| <code>void</code>
+
+<a name="module_PrivateData.fetchPrivateData"></a>
+
+### PrivateData.fetchPrivateData(account) ⇒ <code>Promise.PrivateData</code>
+Fecthes the PrivateData (email, tel, addresses, etc) for a Fan account
+
+**Kind**: static method of [<code>PrivateData</code>](#module_PrivateData)  
+
+| Param | Type |
+| --- | --- |
+| account | <code>AccountType</code> | 
+
+<a name="module_PrivateData.createPrivateData"></a>
+
+### PrivateData.createPrivateData(account, batch) ⇒ <code>Promise.&lt;ChainType&gt;</code>
+**Kind**: static method of [<code>PrivateData</code>](#module_PrivateData)  
+**Returns**: <code>Promise.&lt;ChainType&gt;</code> - WriteBatch, Transaction or Void  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| account | <code>AccountType</code> |  |
+| batch | <code>ChainType</code> | batching object.  Transaction will be added to the batch |
+
+<a name="module_PrivateData.savePrivateData"></a>
+
+### PrivateData.savePrivateData(privateData) ⇒ <code>Promise.&lt;PrivateData&gt;</code>
+Writes the "private" data to the database
+
+**Kind**: static method of [<code>PrivateData</code>](#module_PrivateData)  
+
+| Param | Type |
+| --- | --- |
+| privateData | <code>PrivateData</code> | 
+
+<a name="module_PrivateData.deletePrivateData"></a>
+
+### PrivateData.deletePrivateData(privateData) ⇒ <code>Promise.&lt;void&gt;</code>
+Deletes a PrivateData record (rarely used if ever)
+
+**Kind**: static method of [<code>PrivateData</code>](#module_PrivateData)  
+
+| Param | Type |
+| --- | --- |
+| privateData | <code>PrivateData</code> | 
+| privateData.refPath | <code>string</code> | 
+
+<a name="module_PrivateData.privateDataPath"></a>
+
+### PrivateData.privateDataPath(account) ⇒ <code>string</code>
+creates the "base path" (refPath) to store addresses based on an account (refPath)
+
+**Kind**: static method of [<code>PrivateData</code>](#module_PrivateData)  
+
+| Param | Type |
+| --- | --- |
+| account | <code>Record</code> | 
+| account.refPath | <code>string</code> | 
+
+<a name="module_PrivateData..PrivateDefault"></a>
+
+### PrivateData~PrivateDefault : <code>PrivateData</code>
+**Kind**: inner constant of [<code>PrivateData</code>](#module_PrivateData)  
+**Default**: <code>{&quot;Id&quot;:null,&quot;email&quot;:null,&quot;contact&quot;:null,&quot;business_address&quot;:null,&quot;mailing_address&quot;:null,&quot;billing_address&quot;:null,&quot;tel&quot;:null,&quot;tax_rate&quot;:null,&quot;openIssues&quot;:false}</code>  
+<a name="module_PrivateData..PrivateAccountForm"></a>
+
+### PrivateData~PrivateAccountForm : <code>PrivateData</code>
+**Kind**: inner constant of [<code>PrivateData</code>](#module_PrivateData)  
+**Default**: <code>{&quot;refPath&quot;:&quot;hidden:text&quot;,&quot;email&quot;:&quot;email&quot;,&quot;contact&quot;:&quot;&quot;,&quot;business_address&quot;:&quot;&quot;,&quot;mailing_address&quot;:&quot;&quot;,&quot;billing_address&quot;:&quot;&quot;,&quot;tel&quot;:&quot;tel&quot;}</code>  
+<a name="module_PrivateData..contact"></a>
+
+### PrivateData~contact : <code>object</code>
+**Kind**: inner typedef of [<code>PrivateData</code>](#module_PrivateData)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| contact.Id | <code>string</code> |  |
+| contact.first_name | <code>string</code> |  |
+| contact.last_name | <code>string</code> |  |
+| contact.tel | <code>string</code> |  |
+| contact.email | <code>string</code> | must be filled in to make profile public |
+
+<a name="module_PrivateData..PrivateData"></a>
+
+### PrivateData~PrivateData : <code>object</code>
+**Kind**: inner typedef of [<code>PrivateData</code>](#module_PrivateData)  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| email | <code>string</code> | must be filled in to make profile public |
+| contact | <code>contact</code> |  |
+| tel | <code>string</code> |  |
+| business_address | <code>AddressType</code> |  |
+| mailing_address | <code>AddressType</code> |  |
+| billing_address | <code>AddressType</code> |  |
+
+<a name="module_PrivateData..ChainType"></a>
+
+### PrivateData~ChainType : <code>WriteBatch</code> \| <code>Transaction</code> \| <code>void</code>
+**Kind**: inner typedef of [<code>PrivateData</code>](#module_PrivateData)  
 <a name="module_Product"></a>
 
 ## Product

package/business/Addresses/index.js

@@ -0,0 +1,181 @@
+/**
+ * Types and functins for handling addresses
+ * @module Addresses
+ *
+ */
+
+import {
+  writeRecord,
+  writeBack,
+  deleteRecord,
+  deleteRecordByRefPath,
+  collectRecords,
+} from "@leaddreamer/firebase-wrapper";
+import { Forms } from "@leaddreamer/staticforms";
+import { ADDRESSES } from "../boilerplate";
+import { businessDataPath } from "../BusinessData";
+
+//////////////////////////////////////////////////////////////////////
+//Constants
+/**
+ * @typedef {object} AddressType
+ * @property {?string} Id - will be populated for existing record; null or
+ * missing for new/minimal object
+ * @property {?string} refPath - will be populated for existing record; null or
+ * missing for new/minimal object
+ * @property {string} address_line_1
+ * @property {?string} address_line_2
+ * @property {string} city
+ * @property {string} region - selected from a list of supported Cities/Regions
+ * @property {string} state
+ * @property {zip} zip
+ * @property {?maplink} mapLink - link to Google map location
+ */
+/**
+ * @constant
+ * @type {AddressType}
+ * @default
+ */
+export const AddressDefault = {
+  name: null,
+  tel: null,
+  address_line_1: null,
+  address_line_2: null,
+  city: null,
+  region: null,
+  state: null,
+  zip: null,
+  maplink: null,
+};
+
+/**
+ * @constant
+ * @type {AddressType}
+ * @default
+ */
+export const AddressForm = {
+  name: "text::6",
+  tel: "tel::6",
+  address_line_1: "text::6",
+  address_line_2: "text::6",
+  city: "text::6",
+  //  region: "lookup:Regions:4",
+  state: "text::3",
+  zip: "number::3",
+};
+
+export const AddressSelectForm = {
+  address: `lookupLink:${ADDRESSES}`,
+};
+
+/**
+ * @typedef {object} MapLink
+ * @property {?string} placeId - as defined by Google
+ * @property {?object} latlng - coordinates tuple
+ * @property {string} latlng.lat - lattitude
+ * @property {string} latlng.lng - longitude
+ * @property {?string} url - link to place/map entry
+ * @property {?string} formatted_address - printable string of address
+ */
+/**
+ * @readonly
+ * @constant
+ * @type {MapLink}
+ * @default
+ */
+export const maplink = {
+  placeID: null,
+  latlng: {
+    lat: null,
+    lng: null,
+  },
+  url: null,
+  formatted_address: null,
+};
+
+Forms.Base[ADDRESSES] = AddressDefault;
+Forms.BaseForm[ADDRESSES] = AddressForm;
+Forms.AccountForm[ADDRESSES] = AddressForm;
+
+/**
+ * @external WriteBatch
+ * @external Transaction
+ * @typedef {WriteBatch|Transaction|void} ChainType
+ */
+
+//////////////////////////////////////////////////////////////////////
+//Business Logic
+
+/**
+ * Deletes an existing address record from the database, based on it's own refPath
+ * @param {AddressType} address
+ * @param {!string} address.refPath
+ * @returns {Promise<void>}
+ */
+export async function deleteAddress(address) {
+  //check for real reacord (i.e. refPath)
+  if (!address?.refPath) return null;
+  return deleteRecordByRefPath(address.refPath);
+}
+
+/**
+ * Deletes an existing address record from the database, based on it's parent
+ * record and Id
+ * @param {!string} addressId
+ * @param {OrganizationType} parent
+ * @param {!string} parent.refPath
+ * @param {ChainType} batch
+ * @returns {Promise.ChainType}
+ */
+export async function deleteAddressByIdAndParent(
+  addressId,
+  parent,
+  batch = null
+) {
+  //check for real reacord (i.e. refPath)
+  return deleteRecord(ADDRESSES, addressId, parent?.refPath, batch);
+}
+
+//////////////////////////////////////////////////////////////////////
+//helpers
+
+/**
+ * Builds a formatted string from a provided address record
+ * @param {AddressType} address
+ * @returns {string}
+ */
+export function formatAddress(address) {
+  let formattedString = address
+    ? (address.address_line_1 ? address.address_line_1 + ", " : "") +
+      (address.address_line_2 ? address.address_line_2 + ", " : "") +
+      (address.city ? address.city + ", " : "") +
+      (address.state ? address.state + "  " : "") +
+      (address.zip ? address.zip : "") +
+      (address.region ? " ( " + address.region + " )" : "")
+    : null;
+  return formattedString;
+}
+
+/**
+ * Saves an address record to the database below the provided parentRefPath,
+ * whether exsiting or not
+ * @param {AddressType} address
+ * @param {?string} address.refPath - if present, writes back
+ * @param {string} paraentRefPath - required if new record
+ * @returns {Promise<AddressType>}
+ */
+export async function saveAddress(address, parentRefPath) {
+  return address?.refPath
+    ? writeBack(address)
+    : writeRecord(ADDRESSES, address, parentRefPath);
+}
+
+/**
+ * Fetches all address records for an account
+ * @param {Record} account
+ * @param {!string} account.refPath
+ * @returns {Promise<Array.AddressType>}
+ */
+export async function fetchAddresses(account) {
+  return collectRecords(ADDRESSES, businessDataPath(account));
+}

package/business/BusinessData/index.js

@@ -15,10 +15,9 @@ import {
   BUSINESSDATA,
   BUSINESS_TYPE,
   ADDRESSES,
-  PERSON,
+  USER,
   MCC,
 } from "../boilerplate";
-import { Forms, fillForm } from "../../formModule";
 import { fetchAddresses } from "../Addresses";
 
 //////////////////////////////////////////////////////////////////////
@@ -74,7 +73,7 @@ const BusinessAccountForm = {
   refPath: "hidden:text",
   email: "email",
   business_type: `lookup:${BUSINESS_TYPE}`,
-  contact: `object:${PERSON}`,
+  contact: `object:${USER}`,
   business_address: `lookupLink:${ADDRESSES}`,
   mailing_address: `lookupLink:${ADDRESSES}`,
   billing_address: `lookupLink:${ADDRESSES}`,