@strimz/shared-types 0.1.1 → 0.2.0

package/dist/merchants.d.cts

@@ -20,6 +20,8 @@ declare const merchantSchema: z.ZodObject<{
     tier: z.ZodEnum<["free", "growth", "business", "enterprise"]>;
     status: z.ZodEnum<["active", "suspended", "closed"]>;
     payoutAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    walletAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    onboardingCompleted: z.ZodBoolean;
     defaultCurrency: z.ZodEnum<["USDC", "EURC"]>;
     countryCode: z.ZodNullable<z.ZodString>;
     websiteUrl: z.ZodNullable<z.ZodString>;
@@ -32,6 +34,7 @@ declare const merchantSchema: z.ZodObject<{
     status: "active" | "suspended" | "closed";
     id: string;
     createdAt: string;
+    walletAddress: string | null;
     email: string;
     metadata: Record<string, string | number | boolean | null>;
     updatedAt: string;
@@ -39,6 +42,7 @@ declare const merchantSchema: z.ZodObject<{
     businessName: string;
     tier: "free" | "growth" | "business" | "enterprise";
     payoutAddress: string | null;
+    onboardingCompleted: boolean;
     defaultCurrency: "USDC" | "EURC";
     countryCode: string | null;
     websiteUrl: string | null;
@@ -48,12 +52,14 @@ declare const merchantSchema: z.ZodObject<{
     status: "active" | "suspended" | "closed";
     id: string;
     createdAt: string;
+    walletAddress: string | null;
     email: string;
     updatedAt: string;
     onchainMerchantId: number | null;
     businessName: string;
     tier: "free" | "growth" | "business" | "enterprise";
     payoutAddress: string | null;
+    onboardingCompleted: boolean;
     defaultCurrency: "USDC" | "EURC";
     countryCode: string | null;
     websiteUrl: string | null;
@@ -82,6 +88,24 @@ declare const createMerchantInputSchema: z.ZodObject<{
     websiteUrl?: string | undefined;
 }>;
 type CreateMerchantInput = z.infer<typeof createMerchantInputSchema>;
+/**
+ * Merchant email opt-outs, persisted at `Merchant.metadata.emailPrefs`.
+ * Both default to true. Welcome, refunds, and admin broadcasts always send.
+ */
+declare const merchantEmailPrefsSchema: z.ZodObject<{
+    /** "You received X USDC" one-off payment notifications. */
+    paymentReceived: z.ZodBoolean;
+    /** "You were paid X for subscription Y" per-charge notifications. */
+    subscriptionCharged: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    paymentReceived: boolean;
+    subscriptionCharged: boolean;
+}, {
+    paymentReceived: boolean;
+    subscriptionCharged: boolean;
+}>;
+type MerchantEmailPrefs = z.infer<typeof merchantEmailPrefsSchema>;
+declare const DEFAULT_MERCHANT_EMAIL_PREFS: MerchantEmailPrefs;
 declare const updateMerchantInputSchema: z.ZodObject<{
     businessName: z.ZodOptional<z.ZodString>;
     payoutAddress: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -90,6 +114,16 @@ declare const updateMerchantInputSchema: z.ZodObject<{
     logoUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     countryCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     metadata: z.ZodOptional<z.ZodDefault<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, Record<string, string | number | boolean | null>, Record<string, string | number | boolean | null>>>>;
+    emailPrefs: z.ZodOptional<z.ZodObject<{
+        paymentReceived: z.ZodOptional<z.ZodBoolean>;
+        subscriptionCharged: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        paymentReceived?: boolean | undefined;
+        subscriptionCharged?: boolean | undefined;
+    }, {
+        paymentReceived?: boolean | undefined;
+        subscriptionCharged?: boolean | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     metadata?: Record<string, string | number | boolean | null> | undefined;
     businessName?: string | undefined;
@@ -98,6 +132,10 @@ declare const updateMerchantInputSchema: z.ZodObject<{
     countryCode?: string | null | undefined;
     websiteUrl?: string | null | undefined;
     logoUrl?: string | null | undefined;
+    emailPrefs?: {
+        paymentReceived?: boolean | undefined;
+        subscriptionCharged?: boolean | undefined;
+    } | undefined;
 }, {
     metadata?: Record<string, string | number | boolean | null> | undefined;
     businessName?: string | undefined;
@@ -106,6 +144,10 @@ declare const updateMerchantInputSchema: z.ZodObject<{
     countryCode?: string | null | undefined;
     websiteUrl?: string | null | undefined;
     logoUrl?: string | null | undefined;
+    emailPrefs?: {
+        paymentReceived?: boolean | undefined;
+        subscriptionCharged?: boolean | undefined;
+    } | undefined;
 }>;
 type UpdateMerchantInput = z.infer<typeof updateMerchantInputSchema>;
 declare const changeTierInputSchema: z.ZodObject<{
@@ -116,6 +158,124 @@ declare const changeTierInputSchema: z.ZodObject<{
     tier: "free" | "growth" | "business" | "enterprise";
 }>;
 type ChangeTierInput = z.infer<typeof changeTierInputSchema>;
+/**
+ * Self-attested onboarding form the dashboard collects after a
+ * merchant first logs in via Privy. On success the API stamps
+ * `onboardingCompleted: true` on the row, and the dashboard exits
+ * the wizard. Shared here so the API's DTO and the web client's
+ * hook can enforce the same shape.
+ */
+declare const onboardMerchantInputSchema: z.ZodObject<{
+    businessName: z.ZodString;
+    businessSector: z.ZodString;
+    countryCode: z.ZodString;
+    websiteUrl: z.ZodOptional<z.ZodString>;
+    logoUrl: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    payoutAddress: z.ZodEffects<z.ZodString, string, string>;
+    defaultCurrency: z.ZodOptional<z.ZodEnum<["USDC", "EURC"]>>;
+}, "strip", z.ZodTypeAny, {
+    businessName: string;
+    payoutAddress: string;
+    countryCode: string;
+    businessSector: string;
+    defaultCurrency?: "USDC" | "EURC" | undefined;
+    websiteUrl?: string | undefined;
+    logoUrl?: string | undefined;
+    phone?: string | undefined;
+}, {
+    businessName: string;
+    payoutAddress: string;
+    countryCode: string;
+    businessSector: string;
+    defaultCurrency?: "USDC" | "EURC" | undefined;
+    websiteUrl?: string | undefined;
+    logoUrl?: string | undefined;
+    phone?: string | undefined;
+}>;
+type OnboardMerchantInput = z.infer<typeof onboardMerchantInputSchema>;
+declare const merchantPublicBrandSchema: z.ZodObject<{
+    id: z.ZodString;
+    businessName: z.ZodString;
+    logoUrl: z.ZodNullable<z.ZodString>;
+    walletAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    walletAddress: string | null;
+    businessName: string;
+    logoUrl: string | null;
+}, {
+    id: string;
+    walletAddress: string | null;
+    businessName: string;
+    logoUrl: string | null;
+}>;
+type MerchantPublicBrand = z.infer<typeof merchantPublicBrandSchema>;
+/**
+ * On-chain balance view for the withdraw page. Strimz is
+ * non-custodial: payments settle directly into the merchant's
+ * `payoutAddress`, and "withdrawal" means the merchant transferring
+ * out with their own wallet. This shape reports current on-chain
+ * state so the dashboard renders live balances + decides whether to
+ * offer the signing UI.
+ */
+declare const merchantBalanceSchema: z.ZodObject<{
+    /** Payout wallet, checksummed; null when the merchant hasn't set one. */
+    payoutAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    /** Privy embedded wallet, checksummed if resolvable. */
+    walletAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    /**
+     * True when `payoutAddress === walletAddress`, i.e. the merchant
+     * can sign a transfer from the dashboard via Privy. False for
+     * merchants using an external wallet as payout — the UI falls back
+     * to "copy the address, transfer with your wallet."
+     */
+    canSignFromDashboard: z.ZodBoolean;
+    balances: z.ZodArray<z.ZodObject<{
+        currency: z.ZodEnum<["USDC", "EURC"]>;
+        contractAddress: z.ZodEffects<z.ZodString, string, string>;
+        /** Base-6 integer as string. */
+        raw: z.ZodString;
+        /** Human-formatted, e.g. `1234.56`. */
+        formatted: z.ZodString;
+        decimals: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        currency: "USDC" | "EURC";
+        contractAddress: string;
+        raw: string;
+        formatted: string;
+        decimals: number;
+    }, {
+        currency: "USDC" | "EURC";
+        contractAddress: string;
+        raw: string;
+        formatted: string;
+        decimals: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    walletAddress: string | null;
+    payoutAddress: string | null;
+    canSignFromDashboard: boolean;
+    balances: {
+        currency: "USDC" | "EURC";
+        contractAddress: string;
+        raw: string;
+        formatted: string;
+        decimals: number;
+    }[];
+}, {
+    walletAddress: string | null;
+    payoutAddress: string | null;
+    canSignFromDashboard: boolean;
+    balances: {
+        currency: "USDC" | "EURC";
+        contractAddress: string;
+        raw: string;
+        formatted: string;
+        decimals: number;
+    }[];
+}>;
+type MerchantBalanceView = z.infer<typeof merchantBalanceSchema>;
 declare const merchantMemberSchema: z.ZodObject<{
     id: z.ZodString;
     merchantId: z.ZodString;
@@ -172,6 +332,8 @@ declare const loginOutputSchema: z.ZodObject<{
         tier: z.ZodEnum<["free", "growth", "business", "enterprise"]>;
         status: z.ZodEnum<["active", "suspended", "closed"]>;
         payoutAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+        walletAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+        onboardingCompleted: z.ZodBoolean;
         defaultCurrency: z.ZodEnum<["USDC", "EURC"]>;
         countryCode: z.ZodNullable<z.ZodString>;
         websiteUrl: z.ZodNullable<z.ZodString>;
@@ -184,6 +346,7 @@ declare const loginOutputSchema: z.ZodObject<{
         status: "active" | "suspended" | "closed";
         id: string;
         createdAt: string;
+        walletAddress: string | null;
         email: string;
         metadata: Record<string, string | number | boolean | null>;
         updatedAt: string;
@@ -191,6 +354,7 @@ declare const loginOutputSchema: z.ZodObject<{
         businessName: string;
         tier: "free" | "growth" | "business" | "enterprise";
         payoutAddress: string | null;
+        onboardingCompleted: boolean;
         defaultCurrency: "USDC" | "EURC";
         countryCode: string | null;
         websiteUrl: string | null;
@@ -200,12 +364,14 @@ declare const loginOutputSchema: z.ZodObject<{
         status: "active" | "suspended" | "closed";
         id: string;
         createdAt: string;
+        walletAddress: string | null;
         email: string;
         updatedAt: string;
         onchainMerchantId: number | null;
         businessName: string;
         tier: "free" | "growth" | "business" | "enterprise";
         payoutAddress: string | null;
+        onboardingCompleted: boolean;
         defaultCurrency: "USDC" | "EURC";
         countryCode: string | null;
         websiteUrl: string | null;
@@ -220,6 +386,7 @@ declare const loginOutputSchema: z.ZodObject<{
         status: "active" | "suspended" | "closed";
         id: string;
         createdAt: string;
+        walletAddress: string | null;
         email: string;
         metadata: Record<string, string | number | boolean | null>;
         updatedAt: string;
@@ -227,6 +394,7 @@ declare const loginOutputSchema: z.ZodObject<{
         businessName: string;
         tier: "free" | "growth" | "business" | "enterprise";
         payoutAddress: string | null;
+        onboardingCompleted: boolean;
         defaultCurrency: "USDC" | "EURC";
         countryCode: string | null;
         websiteUrl: string | null;
@@ -240,12 +408,14 @@ declare const loginOutputSchema: z.ZodObject<{
         status: "active" | "suspended" | "closed";
         id: string;
         createdAt: string;
+        walletAddress: string | null;
         email: string;
         updatedAt: string;
         onchainMerchantId: number | null;
         businessName: string;
         tier: "free" | "growth" | "business" | "enterprise";
         payoutAddress: string | null;
+        onboardingCompleted: boolean;
         defaultCurrency: "USDC" | "EURC";
         countryCode: string | null;
         websiteUrl: string | null;
@@ -256,4 +426,4 @@ declare const loginOutputSchema: z.ZodObject<{
 }>;
 type LoginOutput = z.infer<typeof loginOutputSchema>;
 
-export { type ChangeTierInput, type CreateMerchantInput, type InviteMemberInput, type LoginInput, type LoginOutput, type Merchant, type MerchantMember, type MerchantRole, type MerchantStatus, type UpdateMerchantInput, changeTierInputSchema, createMerchantInputSchema, inviteMemberInputSchema, loginInputSchema, loginOutputSchema, merchantMemberSchema, merchantRoleSchema, merchantSchema, merchantStatusSchema, updateMerchantInputSchema };
+export { type ChangeTierInput, type CreateMerchantInput, DEFAULT_MERCHANT_EMAIL_PREFS, type InviteMemberInput, type LoginInput, type LoginOutput, type Merchant, type MerchantBalanceView, type MerchantEmailPrefs, type MerchantMember, type MerchantPublicBrand, type MerchantRole, type MerchantStatus, type OnboardMerchantInput, type UpdateMerchantInput, changeTierInputSchema, createMerchantInputSchema, inviteMemberInputSchema, loginInputSchema, loginOutputSchema, merchantBalanceSchema, merchantEmailPrefsSchema, merchantMemberSchema, merchantPublicBrandSchema, merchantRoleSchema, merchantSchema, merchantStatusSchema, onboardMerchantInputSchema, updateMerchantInputSchema };

package/dist/merchants.d.ts

@@ -20,6 +20,8 @@ declare const merchantSchema: z.ZodObject<{
     tier: z.ZodEnum<["free", "growth", "business", "enterprise"]>;
     status: z.ZodEnum<["active", "suspended", "closed"]>;
     payoutAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    walletAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    onboardingCompleted: z.ZodBoolean;
     defaultCurrency: z.ZodEnum<["USDC", "EURC"]>;
     countryCode: z.ZodNullable<z.ZodString>;
     websiteUrl: z.ZodNullable<z.ZodString>;
@@ -32,6 +34,7 @@ declare const merchantSchema: z.ZodObject<{
     status: "active" | "suspended" | "closed";
     id: string;
     createdAt: string;
+    walletAddress: string | null;
     email: string;
     metadata: Record<string, string | number | boolean | null>;
     updatedAt: string;
@@ -39,6 +42,7 @@ declare const merchantSchema: z.ZodObject<{
     businessName: string;
     tier: "free" | "growth" | "business" | "enterprise";
     payoutAddress: string | null;
+    onboardingCompleted: boolean;
     defaultCurrency: "USDC" | "EURC";
     countryCode: string | null;
     websiteUrl: string | null;
@@ -48,12 +52,14 @@ declare const merchantSchema: z.ZodObject<{
     status: "active" | "suspended" | "closed";
     id: string;
     createdAt: string;
+    walletAddress: string | null;
     email: string;
     updatedAt: string;
     onchainMerchantId: number | null;
     businessName: string;
     tier: "free" | "growth" | "business" | "enterprise";
     payoutAddress: string | null;
+    onboardingCompleted: boolean;
     defaultCurrency: "USDC" | "EURC";
     countryCode: string | null;
     websiteUrl: string | null;
@@ -82,6 +88,24 @@ declare const createMerchantInputSchema: z.ZodObject<{
     websiteUrl?: string | undefined;
 }>;
 type CreateMerchantInput = z.infer<typeof createMerchantInputSchema>;
+/**
+ * Merchant email opt-outs, persisted at `Merchant.metadata.emailPrefs`.
+ * Both default to true. Welcome, refunds, and admin broadcasts always send.
+ */
+declare const merchantEmailPrefsSchema: z.ZodObject<{
+    /** "You received X USDC" one-off payment notifications. */
+    paymentReceived: z.ZodBoolean;
+    /** "You were paid X for subscription Y" per-charge notifications. */
+    subscriptionCharged: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    paymentReceived: boolean;
+    subscriptionCharged: boolean;
+}, {
+    paymentReceived: boolean;
+    subscriptionCharged: boolean;
+}>;
+type MerchantEmailPrefs = z.infer<typeof merchantEmailPrefsSchema>;
+declare const DEFAULT_MERCHANT_EMAIL_PREFS: MerchantEmailPrefs;
 declare const updateMerchantInputSchema: z.ZodObject<{
     businessName: z.ZodOptional<z.ZodString>;
     payoutAddress: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -90,6 +114,16 @@ declare const updateMerchantInputSchema: z.ZodObject<{
     logoUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     countryCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     metadata: z.ZodOptional<z.ZodDefault<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, Record<string, string | number | boolean | null>, Record<string, string | number | boolean | null>>>>;
+    emailPrefs: z.ZodOptional<z.ZodObject<{
+        paymentReceived: z.ZodOptional<z.ZodBoolean>;
+        subscriptionCharged: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        paymentReceived?: boolean | undefined;
+        subscriptionCharged?: boolean | undefined;
+    }, {
+        paymentReceived?: boolean | undefined;
+        subscriptionCharged?: boolean | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     metadata?: Record<string, string | number | boolean | null> | undefined;
     businessName?: string | undefined;
@@ -98,6 +132,10 @@ declare const updateMerchantInputSchema: z.ZodObject<{
     countryCode?: string | null | undefined;
     websiteUrl?: string | null | undefined;
     logoUrl?: string | null | undefined;
+    emailPrefs?: {
+        paymentReceived?: boolean | undefined;
+        subscriptionCharged?: boolean | undefined;
+    } | undefined;
 }, {
     metadata?: Record<string, string | number | boolean | null> | undefined;
     businessName?: string | undefined;
@@ -106,6 +144,10 @@ declare const updateMerchantInputSchema: z.ZodObject<{
     countryCode?: string | null | undefined;
     websiteUrl?: string | null | undefined;
     logoUrl?: string | null | undefined;
+    emailPrefs?: {
+        paymentReceived?: boolean | undefined;
+        subscriptionCharged?: boolean | undefined;
+    } | undefined;
 }>;
 type UpdateMerchantInput = z.infer<typeof updateMerchantInputSchema>;
 declare const changeTierInputSchema: z.ZodObject<{
@@ -116,6 +158,124 @@ declare const changeTierInputSchema: z.ZodObject<{
     tier: "free" | "growth" | "business" | "enterprise";
 }>;
 type ChangeTierInput = z.infer<typeof changeTierInputSchema>;
+/**
+ * Self-attested onboarding form the dashboard collects after a
+ * merchant first logs in via Privy. On success the API stamps
+ * `onboardingCompleted: true` on the row, and the dashboard exits
+ * the wizard. Shared here so the API's DTO and the web client's
+ * hook can enforce the same shape.
+ */
+declare const onboardMerchantInputSchema: z.ZodObject<{
+    businessName: z.ZodString;
+    businessSector: z.ZodString;
+    countryCode: z.ZodString;
+    websiteUrl: z.ZodOptional<z.ZodString>;
+    logoUrl: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    payoutAddress: z.ZodEffects<z.ZodString, string, string>;
+    defaultCurrency: z.ZodOptional<z.ZodEnum<["USDC", "EURC"]>>;
+}, "strip", z.ZodTypeAny, {
+    businessName: string;
+    payoutAddress: string;
+    countryCode: string;
+    businessSector: string;
+    defaultCurrency?: "USDC" | "EURC" | undefined;
+    websiteUrl?: string | undefined;
+    logoUrl?: string | undefined;
+    phone?: string | undefined;
+}, {
+    businessName: string;
+    payoutAddress: string;
+    countryCode: string;
+    businessSector: string;
+    defaultCurrency?: "USDC" | "EURC" | undefined;
+    websiteUrl?: string | undefined;
+    logoUrl?: string | undefined;
+    phone?: string | undefined;
+}>;
+type OnboardMerchantInput = z.infer<typeof onboardMerchantInputSchema>;
+declare const merchantPublicBrandSchema: z.ZodObject<{
+    id: z.ZodString;
+    businessName: z.ZodString;
+    logoUrl: z.ZodNullable<z.ZodString>;
+    walletAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    walletAddress: string | null;
+    businessName: string;
+    logoUrl: string | null;
+}, {
+    id: string;
+    walletAddress: string | null;
+    businessName: string;
+    logoUrl: string | null;
+}>;
+type MerchantPublicBrand = z.infer<typeof merchantPublicBrandSchema>;
+/**
+ * On-chain balance view for the withdraw page. Strimz is
+ * non-custodial: payments settle directly into the merchant's
+ * `payoutAddress`, and "withdrawal" means the merchant transferring
+ * out with their own wallet. This shape reports current on-chain
+ * state so the dashboard renders live balances + decides whether to
+ * offer the signing UI.
+ */
+declare const merchantBalanceSchema: z.ZodObject<{
+    /** Payout wallet, checksummed; null when the merchant hasn't set one. */
+    payoutAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    /** Privy embedded wallet, checksummed if resolvable. */
+    walletAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    /**
+     * True when `payoutAddress === walletAddress`, i.e. the merchant
+     * can sign a transfer from the dashboard via Privy. False for
+     * merchants using an external wallet as payout — the UI falls back
+     * to "copy the address, transfer with your wallet."
+     */
+    canSignFromDashboard: z.ZodBoolean;
+    balances: z.ZodArray<z.ZodObject<{
+        currency: z.ZodEnum<["USDC", "EURC"]>;
+        contractAddress: z.ZodEffects<z.ZodString, string, string>;
+        /** Base-6 integer as string. */
+        raw: z.ZodString;
+        /** Human-formatted, e.g. `1234.56`. */
+        formatted: z.ZodString;
+        decimals: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        currency: "USDC" | "EURC";
+        contractAddress: string;
+        raw: string;
+        formatted: string;
+        decimals: number;
+    }, {
+        currency: "USDC" | "EURC";
+        contractAddress: string;
+        raw: string;
+        formatted: string;
+        decimals: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    walletAddress: string | null;
+    payoutAddress: string | null;
+    canSignFromDashboard: boolean;
+    balances: {
+        currency: "USDC" | "EURC";
+        contractAddress: string;
+        raw: string;
+        formatted: string;
+        decimals: number;
+    }[];
+}, {
+    walletAddress: string | null;
+    payoutAddress: string | null;
+    canSignFromDashboard: boolean;
+    balances: {
+        currency: "USDC" | "EURC";
+        contractAddress: string;
+        raw: string;
+        formatted: string;
+        decimals: number;
+    }[];
+}>;
+type MerchantBalanceView = z.infer<typeof merchantBalanceSchema>;
 declare const merchantMemberSchema: z.ZodObject<{
     id: z.ZodString;
     merchantId: z.ZodString;
@@ -172,6 +332,8 @@ declare const loginOutputSchema: z.ZodObject<{
         tier: z.ZodEnum<["free", "growth", "business", "enterprise"]>;
         status: z.ZodEnum<["active", "suspended", "closed"]>;
         payoutAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+        walletAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+        onboardingCompleted: z.ZodBoolean;
         defaultCurrency: z.ZodEnum<["USDC", "EURC"]>;
         countryCode: z.ZodNullable<z.ZodString>;
         websiteUrl: z.ZodNullable<z.ZodString>;
@@ -184,6 +346,7 @@ declare const loginOutputSchema: z.ZodObject<{
         status: "active" | "suspended" | "closed";
         id: string;
         createdAt: string;
+        walletAddress: string | null;
         email: string;
         metadata: Record<string, string | number | boolean | null>;
         updatedAt: string;
@@ -191,6 +354,7 @@ declare const loginOutputSchema: z.ZodObject<{
         businessName: string;
         tier: "free" | "growth" | "business" | "enterprise";
         payoutAddress: string | null;
+        onboardingCompleted: boolean;
         defaultCurrency: "USDC" | "EURC";
         countryCode: string | null;
         websiteUrl: string | null;
@@ -200,12 +364,14 @@ declare const loginOutputSchema: z.ZodObject<{
         status: "active" | "suspended" | "closed";
         id: string;
         createdAt: string;
+        walletAddress: string | null;
         email: string;
         updatedAt: string;
         onchainMerchantId: number | null;
         businessName: string;
         tier: "free" | "growth" | "business" | "enterprise";
         payoutAddress: string | null;
+        onboardingCompleted: boolean;
         defaultCurrency: "USDC" | "EURC";
         countryCode: string | null;
         websiteUrl: string | null;
@@ -220,6 +386,7 @@ declare const loginOutputSchema: z.ZodObject<{
         status: "active" | "suspended" | "closed";
         id: string;
         createdAt: string;
+        walletAddress: string | null;
         email: string;
         metadata: Record<string, string | number | boolean | null>;
         updatedAt: string;
@@ -227,6 +394,7 @@ declare const loginOutputSchema: z.ZodObject<{
         businessName: string;
         tier: "free" | "growth" | "business" | "enterprise";
         payoutAddress: string | null;
+        onboardingCompleted: boolean;
         defaultCurrency: "USDC" | "EURC";
         countryCode: string | null;
         websiteUrl: string | null;
@@ -240,12 +408,14 @@ declare const loginOutputSchema: z.ZodObject<{
         status: "active" | "suspended" | "closed";
         id: string;
         createdAt: string;
+        walletAddress: string | null;
         email: string;
         updatedAt: string;
         onchainMerchantId: number | null;
         businessName: string;
         tier: "free" | "growth" | "business" | "enterprise";
         payoutAddress: string | null;
+        onboardingCompleted: boolean;
         defaultCurrency: "USDC" | "EURC";
         countryCode: string | null;
         websiteUrl: string | null;
@@ -256,4 +426,4 @@ declare const loginOutputSchema: z.ZodObject<{
 }>;
 type LoginOutput = z.infer<typeof loginOutputSchema>;
 
-export { type ChangeTierInput, type CreateMerchantInput, type InviteMemberInput, type LoginInput, type LoginOutput, type Merchant, type MerchantMember, type MerchantRole, type MerchantStatus, type UpdateMerchantInput, changeTierInputSchema, createMerchantInputSchema, inviteMemberInputSchema, loginInputSchema, loginOutputSchema, merchantMemberSchema, merchantRoleSchema, merchantSchema, merchantStatusSchema, updateMerchantInputSchema };
+export { type ChangeTierInput, type CreateMerchantInput, DEFAULT_MERCHANT_EMAIL_PREFS, type InviteMemberInput, type LoginInput, type LoginOutput, type Merchant, type MerchantBalanceView, type MerchantEmailPrefs, type MerchantMember, type MerchantPublicBrand, type MerchantRole, type MerchantStatus, type OnboardMerchantInput, type UpdateMerchantInput, changeTierInputSchema, createMerchantInputSchema, inviteMemberInputSchema, loginInputSchema, loginOutputSchema, merchantBalanceSchema, merchantEmailPrefsSchema, merchantMemberSchema, merchantPublicBrandSchema, merchantRoleSchema, merchantSchema, merchantStatusSchema, onboardMerchantInputSchema, updateMerchantInputSchema };

package/dist/merchants.js

@@ -38,6 +38,8 @@ var merchantSchema = z.object({
   tier: merchantTierSchema,
   status: merchantStatusSchema,
   payoutAddress: evmAddressSchema.nullable(),
+  walletAddress: evmAddressSchema.nullable(),
+  onboardingCompleted: z.boolean(),
   defaultCurrency: z.enum(["USDC", "EURC"]),
   countryCode: z.string().length(2).nullable(),
   websiteUrl: z.string().url().nullable(),
@@ -54,6 +56,16 @@ var createMerchantInputSchema = z.object({
   countryCode: z.string().length(2).optional(),
   websiteUrl: z.string().url().optional()
 });
+var merchantEmailPrefsSchema = z.object({
+  /** "You received X USDC" one-off payment notifications. */
+  paymentReceived: z.boolean(),
+  /** "You were paid X for subscription Y" per-charge notifications. */
+  subscriptionCharged: z.boolean()
+});
+var DEFAULT_MERCHANT_EMAIL_PREFS = {
+  paymentReceived: true,
+  subscriptionCharged: true
+};
 var updateMerchantInputSchema = z.object({
   businessName: z.string().min(2).max(120),
   payoutAddress: evmAddressSchema,
@@ -61,11 +73,52 @@ var updateMerchantInputSchema = z.object({
   websiteUrl: z.string().url().nullable(),
   logoUrl: z.string().url().nullable(),
   countryCode: z.string().length(2).nullable(),
-  metadata: metadataSchema
+  metadata: metadataSchema,
+  emailPrefs: merchantEmailPrefsSchema.partial()
 }).partial();
 var changeTierInputSchema = z.object({
   tier: merchantTierSchema
 });
+var onboardMerchantInputSchema = z.object({
+  businessName: z.string().min(2).max(120),
+  businessSector: z.string().min(2).max(80),
+  countryCode: z.string().length(2).regex(/^[A-Z]{2}$/, "must be a 2-letter ISO country code"),
+  websiteUrl: z.string().url().optional(),
+  logoUrl: z.string().url().optional(),
+  phone: z.string().min(6).max(20).optional(),
+  payoutAddress: evmAddressSchema,
+  defaultCurrency: z.enum(["USDC", "EURC"]).optional()
+});
+var merchantPublicBrandSchema = z.object({
+  id: idSchema,
+  businessName: z.string().min(2).max(120),
+  logoUrl: z.string().url().nullable(),
+  walletAddress: evmAddressSchema.nullable()
+});
+var merchantBalanceSchema = z.object({
+  /** Payout wallet, checksummed; null when the merchant hasn't set one. */
+  payoutAddress: evmAddressSchema.nullable(),
+  /** Privy embedded wallet, checksummed if resolvable. */
+  walletAddress: evmAddressSchema.nullable(),
+  /**
+   * True when `payoutAddress === walletAddress`, i.e. the merchant
+   * can sign a transfer from the dashboard via Privy. False for
+   * merchants using an external wallet as payout — the UI falls back
+   * to "copy the address, transfer with your wallet."
+   */
+  canSignFromDashboard: z.boolean(),
+  balances: z.array(
+    z.object({
+      currency: z.enum(["USDC", "EURC"]),
+      contractAddress: evmAddressSchema,
+      /** Base-6 integer as string. */
+      raw: z.string(),
+      /** Human-formatted, e.g. `1234.56`. */
+      formatted: z.string(),
+      decimals: z.number().int().min(0).max(30)
+    })
+  )
+});
 var merchantMemberSchema = z.object({
   id: idSchema,
   merchantId: idSchema,
@@ -88,6 +141,6 @@ var loginOutputSchema = z.object({
   merchant: merchantSchema
 });
 
-export { changeTierInputSchema, createMerchantInputSchema, inviteMemberInputSchema, loginInputSchema, loginOutputSchema, merchantMemberSchema, merchantRoleSchema, merchantSchema, merchantStatusSchema, updateMerchantInputSchema };
+export { DEFAULT_MERCHANT_EMAIL_PREFS, changeTierInputSchema, createMerchantInputSchema, inviteMemberInputSchema, loginInputSchema, loginOutputSchema, merchantBalanceSchema, merchantEmailPrefsSchema, merchantMemberSchema, merchantPublicBrandSchema, merchantRoleSchema, merchantSchema, merchantStatusSchema, onboardMerchantInputSchema, updateMerchantInputSchema };
 //# sourceMappingURL=merchants.js.map
 //# sourceMappingURL=merchants.js.map