@better-giving/donation 3.0.4 → 3.0.5

package/dist/donation-msgs-db.d.mts

@@ -0,0 +1,51 @@
+import { Db } from "@better-giving/db";
+import type { ISODate } from "@better-giving/types/alias";
+import type { Environment } from "@better-giving/types/list";
+import type { IPageOpts } from "./schema.mjs";
+import type { IPageKeyed } from "@better-giving/types/api";
+import type { IPublicDonor } from "./interfaces.mjs";
+export type DMKey = `DM#${string}`;
+export declare class DonationDonorsDb extends Db {
+    static readonly table = "donation_messages";
+    static readonly gsi1 = "gsi1";
+    key(id: string): {
+        readonly PK: `DM#${string}`;
+        readonly SK: `DM#${string}`;
+    };
+    gsi1_by_recipient(recipient: string, date: string): {
+        readonly gsi1PK: `Recipient#${string}#staging` | `Recipient#${string}#production`;
+        readonly gsi1SK: ISODate;
+    };
+    list(recipient: string, opts?: IPageOpts): Promise<IPageKeyed<IPublicDonor>>;
+}
+export declare namespace GSI1 {
+    type Name = "recipient-env-gsi";
+    interface Key {
+        /** `Recipient#{recipient_id}#{env}` */
+        gsi1PK: `Recipient#${string}#${Environment}`;
+        gsi1SK: ISODate;
+    }
+}
+export declare namespace DonationMessage {
+    /** `DM#{uuid}` */
+    interface PrimaryKey {
+        PK: DMKey;
+        SK: DMKey;
+    }
+    interface NonKeyAttributes {
+        /** USD amount at the time of donation */
+        amount: number;
+        date: ISODate;
+        donation_id: string;
+        donor_id: string;
+        donor_message: string;
+        donor_name: string;
+        env: Environment;
+        /** uuidv4 */
+        id: string;
+        /** Endow or fund ID */
+        recipient_id: string;
+    }
+    interface DBRecord extends PrimaryKey, NonKeyAttributes, GSI1.Key {
+    }
+}

package/dist/donation-msgs-db.mjs

@@ -0,0 +1,29 @@
+import { Db } from "@better-giving/db";
+import { QueryCommand } from "@aws-sdk/lib-dynamodb";
+export class DonationDonorsDb extends Db {
+    static table = "donation_messages";
+    static gsi1 = "gsi1";
+    key(id) {
+        return { PK: `DM#${id}`, SK: `DM#${id}` };
+    }
+    gsi1_by_recipient(recipient, date) {
+        return {
+            gsi1PK: `Recipient#${recipient}#${this.env}`,
+            gsi1SK: date,
+        };
+    }
+    list(recipient, opts) {
+        const cmd = new QueryCommand({
+            TableName: DonationDonorsDb.table,
+            IndexName: DonationDonorsDb.gsi1,
+            KeyConditionExpression: "gsi1PK = :gsi1PK",
+            ExpressionAttributeValues: {
+                ":gsi1PK": this.gsi1_by_recipient(recipient, "only-sk-is-used").gsi1PK,
+            },
+            Limit: opts?.limit,
+            ExclusiveStartKey: this.key_to_obj(opts?.next),
+            ScanIndexForward: false,
+        });
+        return this.client.send(cmd).then((this.to_page));
+    }
+}

package/dist/donations-db.d.mts

@@ -0,0 +1,18 @@
+import { Db } from "@better-giving/db";
+import type { IDonationFinal, IDonationFinalAttr, TExplicit } from "./interfaces.mjs";
+import { type QueryCommandInput } from "@aws-sdk/lib-dynamodb";
+import type { IPageKeyed } from "@better-giving/types/api";
+import type { IDonationsSearch } from "./schema.mjs";
+export declare class DonationsDb extends Db {
+    static readonly table = "Donations";
+    static readonly gsi_referrer$settled_date = "Referrer-FinalizedDate_index";
+    static readonly gsi_npo$settled_date = "npo-settled_date-gsi";
+    static readonly gsi_email$tx_date = "email-tx_date-gsii";
+    put_txi(data: TExplicit<IDonationFinalAttr>): Promise<import("@aws-sdk/lib-dynamodb").PutCommandOutput>;
+    referred_by_q(referrer: string): Promise<QueryCommandInput>;
+    list_to_npo(npo: number, opts?: IDonationsSearch & {
+        date_start?: string;
+        date_end?: string;
+    }): Promise<IPageKeyed<IDonationFinal>>;
+    list_by_email(email: string, opts?: IDonationsSearch): Promise<IPageKeyed<IDonationFinal>>;
+}

package/dist/donations-db.mjs

@@ -0,0 +1,108 @@
+import { Db } from "@better-giving/db";
+import { PutCommand, QueryCommand, } from "@aws-sdk/lib-dynamodb";
+export class DonationsDb extends Db {
+    static table = "Donations";
+    static gsi_referrer$settled_date = "Referrer-FinalizedDate_index";
+    static gsi_npo$settled_date = "npo-settled_date-gsi";
+    static gsi_email$tx_date = "email-tx_date-gsii";
+    async put_txi(data) {
+        const cmd = new PutCommand({
+            TableName: DonationsDb.table,
+            Item: data,
+            ConditionExpression: `attribute_not_exists(${"transactionId"})`,
+        });
+        return this.client.send(cmd);
+    }
+    async referred_by_q(referrer) {
+        const q = {
+            TableName: DonationsDb.table,
+            IndexName: DonationsDb.gsi_referrer$settled_date,
+            KeyConditionExpression: "#referrer = :referrer",
+            ExpressionAttributeNames: {
+                "#referrer": "referrer",
+            },
+            ExpressionAttributeValues: {
+                ":referrer": referrer,
+            },
+        };
+        return q;
+    }
+    async list_to_npo(npo, opts) {
+        /** key condition expression */
+        let kce = "#npo = :npo";
+        /** expression attribute names */
+        const ean = {
+            "#npo": "endowmentId",
+        };
+        /** expression attribute values */
+        const eav = {
+            ":npo": npo,
+        };
+        if (opts?.date_start && opts?.date_end) {
+            kce += " AND #settled_date BETWEEN :date_start AND :date_end";
+            ean["#settled_date"] = "donationFinalTxDate";
+            eav[":date_start"] = opts.date_start;
+            eav[":date_end"] = opts.date_end;
+        }
+        else if (opts?.date_start) {
+            kce += " AND #settled_date >= :date_start";
+            ean["#settled_date"] = "donationFinalTxDate";
+            eav[":date_start"] = opts.date_start;
+        }
+        else if (opts?.date_end) {
+            kce += " AND #settled_date <= :date_end";
+            ean["#settled_date"] = "donationFinalTxDate";
+            eav[":date_end"] = opts.date_end;
+        }
+        const cmd = new QueryCommand({
+            TableName: DonationsDb.table,
+            IndexName: DonationsDb.gsi_npo$settled_date,
+            KeyConditionExpression: kce,
+            ExpressionAttributeNames: ean,
+            ExpressionAttributeValues: eav,
+            Limit: opts?.limit,
+            ExclusiveStartKey: this.key_to_obj(opts?.next),
+            ScanIndexForward: false,
+        });
+        return this.client.send(cmd).then((this.to_page));
+    }
+    async list_by_email(email, opts) {
+        /** key condition expression */
+        let kce = "#email = :email";
+        /** expression attribute names */
+        const ean = {
+            "#email": "email",
+        };
+        /** expression attribute values */
+        const eav = {
+            ":email": email,
+        };
+        if (opts?.date_start && opts?.date_end) {
+            kce += " AND #settled_date BETWEEN :date_start AND :date_end";
+            ean["#settled_date"] = "transactionDate";
+            eav[":date_start"] = opts.date_start;
+            eav[":date_end"] = opts.date_end;
+        }
+        else if (opts?.date_start) {
+            kce += " AND #settled_date >= :date_start";
+            ean["#settled_date"] = "transactionDate";
+            eav[":date_start"] = opts.date_start;
+        }
+        else if (opts?.date_end) {
+            kce += " AND #settled_date <= :date_end";
+            ean["#settled_date"] = "transactionDate";
+            eav[":date_end"] = opts.date_end;
+        }
+        const cmd = new QueryCommand({
+            TableName: DonationsDb.table,
+            IndexName: DonationsDb.gsi_email$tx_date,
+            KeyConditionExpression: kce,
+            ExpressionAttributeNames: ean,
+            ExpressionAttributeValues: eav,
+            Limit: opts?.limit,
+            ExclusiveStartKey: this.key_to_obj(opts?.next),
+            ScanIndexForward: false,
+        });
+        return this.client.send(cmd).then((this.to_page));
+    }
+}

package/dist/index.d.mts

@@ -0,0 +1,5 @@
+export type { IAllocation, TDonationSource, TDonorTitle, TFrequency, IDonationsSearch, IPageOpts, } from "./schema.mjs";
+export type * from "./paypal.mjs";
+export type * from "./interfaces.mjs";
+export { DonationsDb } from "./donations-db.mjs";
+export { OnHoldDonationsDb } from "./onhold-db.mjs";

package/dist/index.mjs

@@ -0,0 +1,2 @@
+export { DonationsDb } from "./donations-db.mjs";
+export { OnHoldDonationsDb } from "./onhold-db.mjs";

package/dist/interfaces.d.mts

@@ -0,0 +1,300 @@
+import type { Environment } from "@better-giving/types/list";
+import type { IAllocation, TDonationSource, TDonorTitle } from "./schema.mjs";
+interface IReferrerCommission {
+    from_tip: number;
+    from_fee: number;
+    /** exist when paid */
+    transfer_id?: number;
+}
+export interface ITributeNotif {
+    toEmail: string;
+    toFullName: string;
+    fromMsg: string;
+}
+export type TFiatRamp = "STRIPE" | "CHARIOT" | "PAYPAL";
+export type TOnHoldStatus = "intent" | "pending";
+export type TDonationOnholdStatus = "intent" | "pending";
+export interface IDonationOnHoldAttrLegacy {
+    /** @deprecated */
+    apesComplianceReviewStatus?: "approved";
+    /** @deprecated */
+    apesComplianceTimeWindow?: string;
+    /** @deprecated */
+    client?: "apes";
+    /** @deprecated */
+    destinationChainId?: "fiat" | "137";
+    /** @deprecated */
+    donationFinalized?: false;
+    /** @deprecated 1-100 str */
+    splitLiq?: string;
+    /** @deprecated - no more inhouse pipeline */
+    third_party?: boolean;
+}
+export interface IDonationOnHoldAttr {
+    transactionDate: string;
+    transactionId: string;
+    allocation?: IAllocation;
+    amount: number;
+    status: TOnHoldStatus;
+    tipAmount: number;
+    /**
+    "USD", "TRX", "karate-295", "BRL", "GBP", "USDC", "JPY", "ETH", "USDCMATIC", "EUR", "INR", "THB", "PHP",
+    "XRP", "RUB", "CAD", "karate-1" ... */
+    denomination: string;
+    /** bg-marketplace | bg-widget */
+    appUsed: TDonationSource;
+    /** "fiat", "trx", "hbar", "eth", "matic", "xrp-mainnet" */
+    chainId: string;
+    /** "Fiat", "TRON", "Hedera", "Ethereum", "", "Polygon", "Stripe", "XRP Ledger" */
+    chainName: string;
+    charityName: string;
+    claimed?: boolean;
+    /** may be empty */
+    company_name?: string;
+    donor_public?: boolean;
+    kycEmail: string;
+    /** @legacy */
+    email?: string;
+    /** 0 when donating to fund */
+    endowmentId: number;
+    fiatRamp?: TFiatRamp;
+    feeAllowance?: number;
+    fiscalSponsored: boolean;
+    fullName: string;
+    /** may be empty, if donation is to npo */
+    fund_id?: string;
+    fund_members?: number[];
+    fund_name?: string;
+    hideBgTip?: boolean;
+    /** may be empty */
+    inHonorOf?: string;
+    isRecurring?: boolean;
+    msg_to_npo?: string;
+    network: Environment;
+    /** may be empty */
+    nonProfitMsg?: string;
+    /** Nowpayments: number, custom: uuid */
+    payment_id?: number | string;
+    /** e.g. Bank transfer */
+    paymentMethod?: string;
+    /** may be empty */
+    programId?: string;
+    /** may be empty */
+    programName?: string;
+    stripeDepositVerifyUrl?: string;
+    /** TTL attribute */
+    expireAt?: number;
+    title?: TDonorTitle;
+    tributeNotif?: ITributeNotif;
+    ukGiftAid?: boolean;
+    usdValue: number;
+    /** may be empty */
+    walletAddress?: string;
+}
+export interface IDonationOnHold extends IDonationOnHoldAttr, IDonationOnHoldAttrLegacy {
+}
+export interface IDonationFinalAttrLegacy {
+    /** @deprecated "", " "*/
+    addressComplement?: string;
+    /** @deprecated 4 */
+    apesComplianceNewRecipient?: 4;
+    /** @deprecated "approved", "pending" */
+    apesComplianceReviewStatus?: string;
+    /** @deprecated */
+    apesComplianceTimeWindow?: string;
+    /** @deprecated */
+    charityId?: string | number;
+    /** @deprecated */
+    checked8283?: "no" | "yes";
+    /** @deprecated */
+    client?: "apes" | "normal";
+    /** @deprecated */
+    consent_marketing?: boolean;
+    /** @deprecated */
+    consent_tax?: boolean;
+    /** @deprecated */
+    cryptoFee?: number;
+    /** @deprecated - all donations in this table are settled/final */
+    donationFinalized?: boolean;
+    /** @deprecated */
+    fiscalSponsorshipFee?: number;
+    /** @deprecated */
+    fundDepositTxHash?: string;
+    /** @deprecated */
+    fundId?: number;
+    /** @deprecated */
+    fundMembers?: string[];
+    /** @deprecated may be empty */
+    nftAddress?: string;
+    nftRequested?: boolean;
+    /** @deprecated */
+    receiptRequested?: boolean;
+    /** @deprecated */
+    splitLiq?: string;
+    /** @deprecated "null", "UST", "axlUSDC", "USDC", "nulll"  */
+    swapDenomination?: string;
+    /** @deprecated */
+    swapFinalAmount?: number;
+    /** @deprecated */
+    swapFinished?: boolean;
+    /** @deprecated */
+    swapStarted?: boolean;
+    /** @deprecated */
+    taxReceiptSent?: "yes" | "no";
+    /** @deprecated e.g. "White Whale", "Plutos Pot / Lunaverse", "Spaar"..*/
+    tcaAssociation?: string;
+    /** @deprecated */
+    ustFinal?: number;
+    /** @deprecated */
+    walletAddress?: string;
+}
+export type TExplicit<T> = {
+    [K in keyof T]-?: T[K];
+};
+export interface IDonationFinalAttr {
+    amount?: number;
+    allocation?: IAllocation;
+    /** "bg-marketplace", "restore-earth", "angel-protocol",
+    "ukraine-portal", "bg-widget", undefined, "aging", "black-history-month",
+    "make-whole", "mental-health" */
+    appUsed?: TDonationSource | (string & {});
+    baseFee?: number;
+    /**
+    "fiat", "columbus-5", "eth", "matic", "juno-1", "ltc", undefined, "btc", "phoenix-1", "56", "1", "137",
+    "xrp-mainnet", "zec", "sol", "bch", "bsc", "cchain", "xvg", "xrp", "sei-1", "icx", "base",
+    "trx", "avaxc""
+     */
+    chainId?: string;
+    /**
+    "Fiat", "Terra Mainnet", "STRIPE", "Ethereum Mainnet",
+    "Polygon", "Juno Mainnet", "Litecoin", undefined, "Ethereum", "Bitcoin", "Terra Phoenix Mainnet",
+    "Binance Smart Chain", "Polygon Mainnet", "XRP Ledger",
+    "Zcash", "Solana", "BNB Smart Chain Mainnet", "Bitcoin Cash",
+    "Avalanche C-Chain", "Verge", "XRP", "Sei", "ICON", "Base", "TRON", "CHARIOT"
+     */
+    chainName?: string;
+    charityName?: string;
+    /** may be empty */
+    city?: string;
+    claimed?: boolean;
+    /** may be empty */
+    company_name?: string;
+    /** may be empty */
+    country?: string;
+    donor_public?: boolean;
+    donor_message?: string;
+    /**
+    PHP", "UST", "USD", "LUNA", "ETH", "USDCMATIC", "axlUSDC", "LTC", undefined, "EUR", "NZD", "JUNO", "INR",
+    "IDR", "GBP", "USDTMATIC", "PKR", "BTC", "SEK", "HKD", "SGD", "BNB", "CAD", "MATICMAINNET",
+    "USDC", "MOP", "XRP", "JPY", "MATIC", "RSD", "ZEC", "TWD", "SOL", "AUD", "KRW", "BCH", "CHF", "TEL", "USDTBSC",
+    "YER", "ATOM", "AVAXC", "USDTERC20", "XVG", "BUSD", "SEI", "ICX", "ETHBASE", "USDC.e", "USDCBASE", "TRX",
+    "VND", "SZL", "GONE", "AFN", "PLN", "NOK", "WETH", "EGP", "BUSDBSC", "USDCARC20", "USDTTRC20", "THB"
+     */
+    denomination?: string;
+    donationFinalAmount?: number;
+    /**
+    "fiat", undefined, "matic", "137", "noble-1", "eth"*/
+    destinationChainId?: string;
+    /** "fiat", undefined, "matic", "juno-1", "137", "noble-1", "eth" */
+    donationFinalChainId?: string;
+    /**
+     * "USD", "aUSDC", "USDC", "axlUSDC"
+     */
+    donationFinalDenom?: string;
+    /** iso date */
+    donationFinalTxDate?: string;
+    donationFinalTxHash?: string;
+    endowmentId?: number;
+    excessFeeAllowanceUsd?: number;
+    feeAllowance?: number;
+    fiatRamp?: TFiatRamp;
+    fiscalSponsored?: boolean;
+    fiscalSponsorFee?: number;
+    /** may be empty */
+    fullName?: string;
+    fund_id?: string;
+    fund_name?: string;
+    fund_members?: number[];
+    /** may be empty */
+    inHonorOf?: string;
+    isRecurring?: boolean;
+    kycEmail?: string;
+    /** @warning, about 14 legacy records (~2021) contain invalid email */
+    email?: string;
+    msg_to_npo?: string;
+    network?: Environment;
+    /** may be empty */
+    nonProfitMsg?: string;
+    /** indicates this is a tip record */
+    parentTx?: string;
+    /**
+    "Credit Card", undefined, "Stripe Link", "Bank Transfer",
+    "Crypto", "Debit Card", "link", "Card", "Bank", "crypto", "Amazon Pay", "Daf", "Affirm", "eps", "card",
+    "p24", "affirm"
+     */
+    paymentMethod?: string;
+    processingFee?: number;
+    /** may be empty */
+    programId?: string;
+    /** may be empty */
+    programName?: string;
+    referrer_commission?: IReferrerCommission;
+    referrer?: string;
+    settledUsdAmount?: number;
+    state?: string;
+    /** @legacy may be empty */
+    stateAddress?: string;
+    streetAddress?: string;
+    taxReceiptId?: string;
+    /** Mr Ms Mrs Mx, may be empty */
+    title?: string;
+    /** iso */
+    transactionDate?: string;
+    transactionId: string;
+    tributeNotif?: ITributeNotif;
+    ukGiftAid?: boolean;
+    usdValue?: number;
+    /** may be empty */
+    zipCode?: string;
+}
+export interface IDonationFinal extends IDonationFinalAttr, IDonationFinalAttrLegacy {
+}
+export interface IPublicDonor {
+    amount: number;
+    /** iso */
+    date: string;
+    donation_id: string;
+    donor_id: string;
+    donor_message: string;
+    donor_name: string;
+    env: Environment;
+    /** uuidv4 */
+    id: string;
+    /** Endow or fund ID */
+    recipient_id: string;
+}
+export interface ISubscription {
+    subscription_id: string;
+    app_used: string;
+    charity_name: string;
+    customer_id: string;
+    email: string;
+    endowment_id: number;
+    fiat_ramp: "STRIPE";
+    fiscal_sponsored: boolean;
+    hide_bg_tip: boolean;
+    /** url*/
+    latest_invoice?: string;
+    network: Environment;
+    product_id: string;
+    /**
+     * Determines overall price the user has to pay
+     * For example, we have a recurring subscription plan of $1 per month.
+     * If quantity is set to 2 then the user pays $2 per month
+     */
+    quantity: number;
+    split_liq: string;
+    /** @link https://docs.stripe.com/billing/subscriptions/overview#payment-status */
+    status: "active" | "incomplete";
+}
+export {};

package/dist/interfaces.mjs

@@ -0,0 +1 @@
+export {};

package/dist/onhold-db.d.mts

@@ -0,0 +1,17 @@
+import { Db, type TxType } from "@better-giving/db";
+import type { IDonationOnHold, IDonationOnHoldAttr, TExplicit } from "./interfaces.mjs";
+import type { IDonationsSearch } from "./schema.mjs";
+import type { IPageKeyed } from "@better-giving/types/api";
+export declare class OnHoldDonationsDb extends Db {
+    static readonly table = "on_hold_donations";
+    static readonly gsi_email$tx_date = "email-tx_date-gsi";
+    key(id: string): {
+        transactionId: string;
+    };
+    put(data: TExplicit<IDonationOnHoldAttr>): Promise<import("@aws-sdk/lib-dynamodb").PutCommandOutput>;
+    update(id: string, data: Partial<Omit<IDonationOnHoldAttr, "transactionId">>): Promise<IDonationOnHold>;
+    item(id: string): Promise<IDonationOnHold | undefined>;
+    put_txi(data: TExplicit<IDonationOnHoldAttr>): Promise<import("@aws-sdk/lib-dynamodb").PutCommandOutput>;
+    del_txi(id: string): TxType["Delete"];
+    list_by_email(email: string, opts?: IDonationsSearch): Promise<IPageKeyed<IDonationOnHold>>;
+}

package/dist/onhold-db.mjs

@@ -0,0 +1,88 @@
+import { Db, UpdateBuilder } from "@better-giving/db";
+import { GetCommand, PutCommand, QueryCommand, UpdateCommand, } from "@aws-sdk/lib-dynamodb";
+export class OnHoldDonationsDb extends Db {
+    static table = "on_hold_donations";
+    static gsi_email$tx_date = "email-tx_date-gsi";
+    key(id) {
+        return { transactionId: id };
+    }
+    async put(data) {
+        const cmd = new PutCommand({
+            TableName: OnHoldDonationsDb.table,
+            Item: data,
+            ConditionExpression: `attribute_not_exists(${"transactionId"})`,
+        });
+        return this.client.send(cmd);
+    }
+    async update(id, data) {
+        const upd8 = new UpdateBuilder();
+        for (const k in data) {
+            upd8.set(k, data[k]);
+        }
+        const cmd = new UpdateCommand({
+            TableName: OnHoldDonationsDb.table,
+            Key: this.key(id),
+            ...upd8.collect(),
+        });
+        return this.client.send(cmd).then((r) => r.Attributes);
+    }
+    async item(id) {
+        const cmd = new GetCommand({
+            TableName: OnHoldDonationsDb.table,
+            Key: this.key(id),
+        });
+        return this.client.send(cmd).then((r) => r.Item);
+    }
+    put_txi(data) {
+        const cmd = new PutCommand({
+            TableName: OnHoldDonationsDb.table,
+            Item: data,
+            ConditionExpression: `attribute_not_exists(${"transactionId"})`,
+        });
+        return this.client.send(cmd);
+    }
+    del_txi(id) {
+        return { TableName: OnHoldDonationsDb.table, Key: this.key(id) };
+    }
+    async list_by_email(email, opts) {
+        /** key condition expression */
+        let kce = "#email = :email";
+        /** expression attribute names */
+        const ean = {
+            "#email": "email",
+        };
+        /** expression attribute values */
+        const eav = {
+            ":email": email,
+        };
+        if (opts?.date_start && opts?.date_end) {
+            kce += " AND #settled_date BETWEEN :date_start AND :date_end";
+            ean["#settled_date"] = "transactionDate";
+            eav[":date_start"] = opts.date_start;
+            eav[":date_end"] = opts.date_end;
+        }
+        else if (opts?.date_start) {
+            kce += " AND #settled_date >= :date_start";
+            ean["#settled_date"] = "transactionDate";
+            eav[":date_start"] = opts.date_start;
+        }
+        else if (opts?.date_end) {
+            kce += " AND #settled_date <= :date_end";
+            ean["#settled_date"] = "transactionDate";
+            eav[":date_end"] = opts.date_end;
+        }
+        const cmd = new QueryCommand({
+            TableName: OnHoldDonationsDb.table,
+            IndexName: OnHoldDonationsDb.gsi_email$tx_date,
+            KeyConditionExpression: "#email = :email",
+            ExpressionAttributeNames: {
+                "#email": "email",
+            },
+            ExpressionAttributeValues: {
+                ":email": email,
+            },
+            ScanIndexForward: false,
+        });
+        return this.client.send(cmd).then((this.to_page));
+    }
+}