@strimz/shared-types 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -1,15 +1,15 @@
 export { ArcEnvironment, EvmAddress, EvmTxHash, Id, IsoTimestamp, MerchantTier, Metadata, Mode, PaginationInput, PaymentCurrency, TokenAmount, TokenSymbol, arcEnvironmentSchema, countryCodeSchema, emailSchema, evmAddressSchema, evmTxHashSchema, httpUrlSchema, httpsUrlSchema, idSchema, isoTimestampSchema, makePaginatedSchema, merchantTierSchema, metadataSchema, modeSchema, paginationInputSchema, paymentCurrencySchema, tokenAmountSchema, tokenSymbolSchema, uintSchema } from './common.js';
-export { ChangeTierInput, CreateMerchantInput, InviteMemberInput, LoginInput, LoginOutput, Merchant, MerchantMember, MerchantRole, MerchantStatus, UpdateMerchantInput, changeTierInputSchema, createMerchantInputSchema, inviteMemberInputSchema, loginInputSchema, loginOutputSchema, merchantMemberSchema, merchantRoleSchema, merchantSchema, merchantStatusSchema, updateMerchantInputSchema } from './merchants.js';
+export { ChangeTierInput, CreateMerchantInput, DEFAULT_MERCHANT_EMAIL_PREFS, InviteMemberInput, LoginInput, LoginOutput, Merchant, MerchantBalanceView, MerchantEmailPrefs, MerchantMember, MerchantPublicBrand, MerchantRole, MerchantStatus, OnboardMerchantInput, UpdateMerchantInput, changeTierInputSchema, createMerchantInputSchema, inviteMemberInputSchema, loginInputSchema, loginOutputSchema, merchantBalanceSchema, merchantEmailPrefsSchema, merchantMemberSchema, merchantPublicBrandSchema, merchantRoleSchema, merchantSchema, merchantStatusSchema, onboardMerchantInputSchema, updateMerchantInputSchema } from './merchants.js';
 export { ApiKey, ApiKeyKind, ApiKeyScope, CreateApiKeyInput, CreateApiKeyOutput, RotateApiKeyInput, apiKeyKindSchema, apiKeySchema, apiKeyScopeSchema, createApiKeyInputSchema, createApiKeyOutputSchema, rotateApiKeyInputSchema } from './api-keys.js';
 export { Customer, UpsertCustomerInput, customerSchema, upsertCustomerInputSchema } from './customers.js';
-export { CreatePaymentSessionInput, PaymentSession, PaymentSessionStatus, SubmitPaymentSessionInput, createPaymentSessionInputSchema, paymentSessionSchema, paymentSessionStatusSchema, submitPaymentSessionInputSchema } from './payment-sessions.js';
+export { CreatePaymentSessionInput, PaymentSession, PaymentSessionStatus, SubmitPaymentSessionInput, callbackUrlSchema, createPaymentSessionInputSchema, paymentSessionSchema, paymentSessionStatusSchema, submitPaymentSessionInputSchema } from './payment-sessions.js';
 export { Transaction, TransactionKind, TransactionStatus, transactionKindSchema, transactionSchema, transactionStatusSchema } from './transactions.js';
 export { CancelSubscriptionInput, CreateSubscriptionInput, CreateSubscriptionPlanInput, Subscription, SubscriptionCharge, SubscriptionChargeOutcome, SubscriptionChargeStatus, SubscriptionInterval, SubscriptionPlan, SubscriptionPlanStatus, SubscriptionStatus, cancelSubscriptionInputSchema, createSubscriptionInputSchema, createSubscriptionPlanInputSchema, subscriptionChargeOutcomeSchema, subscriptionChargeSchema, subscriptionChargeStatusSchema, subscriptionIntervalSchema, subscriptionPlanSchema, subscriptionPlanStatusSchema, subscriptionSchema, subscriptionStatusSchema } from './subscriptions.js';
-export { CreateRefundInput, Refund, RefundReason, RefundStatus, SubmitRefundSignatureInput, createRefundInputSchema, refundReasonSchema, refundSchema, refundStatusSchema, submitRefundSignatureInputSchema } from './refunds.js';
-export { CreateWebhookEndpointInput, CreateWebhookEndpointOutput, ReplayDeliveryInput, WebhookDelivery, WebhookDeliveryStatus, WebhookEndpoint, WebhookEndpointStatus, WebhookEventName, createWebhookEndpointInputSchema, createWebhookEndpointOutputSchema, replayDeliveryInputSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEndpointSchema, webhookEndpointStatusSchema, webhookEventNameSchema } from './webhooks.js';
+export { CreateRefundInput, Refund, RefundCreateOutput, RefundReason, RefundSigningInstructions, RefundStatus, SubmitRefundSignatureInput, createRefundInputSchema, refundCreateOutputSchema, refundReasonSchema, refundSchema, refundSigningInstructionsSchema, refundStatusSchema, submitRefundSignatureInputSchema } from './refunds.js';
+export { CreateWebhookEndpointInput, CreateWebhookEndpointOutput, ReplayDeliveryInput, WebhookDelivery, WebhookDeliveryDetail, WebhookDeliveryStatus, WebhookEndpoint, WebhookEndpointStatus, WebhookEventName, createWebhookEndpointInputSchema, createWebhookEndpointOutputSchema, replayDeliveryInputSchema, webhookDeliveryDetailSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEndpointSchema, webhookEndpointStatusSchema, webhookEventNameSchema } from './webhooks.js';
 export { ComplianceLog, ComplianceProvider, ComplianceScreeningContext, ComplianceStatus, complianceLogSchema, complianceProviderSchema, complianceScreeningContextSchema, complianceStatusSchema } from './compliance.js';
 export { AgentActionOutcome, AgentActionType, AgentActivityLog, AgentCapability, AgentIdentity, AgentJob, AgentJobStatus, AgentMerchantConfig, CreateAgentJobInput, UpdateAgentConfigInput, agentActionOutcomeSchema, agentActionTypeSchema, agentActivityLogSchema, agentCapabilitySchema, agentIdentitySchema, agentJobSchema, agentJobStatusSchema, agentMerchantConfigSchema, createAgentJobInputSchema, updateAgentConfigInputSchema } from './agents.js';
-export { CreateStorefrontInput, CreateStorefrontProductInput, Storefront, StorefrontProduct, StorefrontProductType, StorefrontStatus, createStorefrontInputSchema, createStorefrontProductInputSchema, storefrontProductSchema, storefrontProductTypeSchema, storefrontSchema, storefrontStatusSchema } from './storefronts.js';
+export { CreateStorefrontInput, CreateStorefrontProductInput, Storefront, StorefrontCheckoutInput, StorefrontCheckoutResponse, StorefrontProduct, StorefrontProductType, StorefrontStatus, createStorefrontInputSchema, createStorefrontProductInputSchema, storefrontCheckoutInputSchema, storefrontCheckoutResponseSchema, storefrontProductSchema, storefrontProductTypeSchema, storefrontSchema, storefrontStatusSchema } from './storefronts.js';
 export { CreateInvoiceInput, Invoice, InvoiceLineItem, InvoiceStatus, createInvoiceInputSchema, invoiceLineItemSchema, invoiceSchema, invoiceStatusSchema } from './invoices.js';
 export { AgentActionExecutedEvent, AgentJobCompletedEvent, AgentJobDisputedEvent, AgentJobProposedEvent, ComplianceWalletBlockedEvent, ComplianceWalletFlaggedEvent, InvoiceCreatedEvent, InvoiceOverdueEvent, InvoicePaidEvent, PaymentCompletedEvent, PaymentCreatedEvent, PaymentFailedEvent, RefundCompletedEvent, RefundCreatedEvent, RefundFailedEvent, StrimzWebhookEvent, SubscriptionCancelledEvent, SubscriptionChargeFailedEvent, SubscriptionChargedEvent, SubscriptionCreatedEvent, SubscriptionLapsedEvent, SubscriptionRecoveryAttemptEvent, SubscriptionRecoveryOutcomeEvent, agentActionExecutedEventSchema, agentJobCompletedEventSchema, agentJobDisputedEventSchema, agentJobProposedEventSchema, complianceWalletBlockedEventSchema, complianceWalletFlaggedEventSchema, invoiceCreatedEventSchema, invoiceOverdueEventSchema, invoicePaidEventSchema, paymentCompletedEventSchema, paymentCreatedEventSchema, paymentFailedEventSchema, refundCompletedEventSchema, refundCreatedEventSchema, refundFailedEventSchema, subscriptionCancelledEventSchema, subscriptionChargeFailedEventSchema, subscriptionChargedEventSchema, subscriptionCreatedEventSchema, subscriptionLapsedEventSchema, subscriptionRecoveryAttemptEventSchema, subscriptionRecoveryOutcomeEventSchema, webhookEventSchema } from './events.js';
 import { z } from 'zod';
@@ -69,8 +69,8 @@ declare const tokenMetadataSchema: z.ZodObject<{
     symbol: string;
     name: string;
     version: string;
-    address: string;
     decimals: number;
+    address: string;
     capabilities: {
         permit2612: boolean;
         transferAuth3009: boolean;
@@ -79,8 +79,8 @@ declare const tokenMetadataSchema: z.ZodObject<{
     symbol: string;
     name: string;
     version: string;
-    address: string;
     decimals: number;
+    address: string;
     capabilities: {
         permit2612: boolean;
         transferAuth3009: boolean;
@@ -100,14 +100,299 @@ declare const tokenPermitNonceSchema: z.ZodObject<{
     owner: z.ZodString;
     nonce: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    owner: string;
     token: string;
+    owner: string;
     nonce: string;
 }, {
-    owner: string;
     token: string;
+    owner: string;
     nonce: string;
 }>;
 type TokenPermitNonce = z.infer<typeof tokenPermitNonceSchema>;
 
-export { type TokenCapabilities, type TokenMetadata, type TokenPermitNonce, tokenCapabilitiesSchema, tokenMetadataSchema, tokenPermitNonceSchema };
+/**
+ * Public marketing contact form. Not an authenticated API resource —
+ * routed straight to a support inbox by the contact module in
+ * `apps/api`. Kept shape-compatible with what the marketing form on
+ * the Strimz landing page already validates client-side.
+ */
+
+declare const contactTopicSchema: z.ZodEnum<["sales", "support", "partnership", "security", "other"]>;
+type ContactTopic = z.infer<typeof contactTopicSchema>;
+declare const contactRequestInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    company: z.ZodOptional<z.ZodString>;
+    topic: z.ZodEnum<["sales", "support", "partnership", "security", "other"]>;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    name: string;
+    email: string;
+    topic: "other" | "sales" | "support" | "partnership" | "security";
+    company?: string | undefined;
+}, {
+    message: string;
+    name: string;
+    email: string;
+    topic: "other" | "sales" | "support" | "partnership" | "security";
+    company?: string | undefined;
+}>;
+type ContactRequestInput = z.infer<typeof contactRequestInputSchema>;
+declare const contactRequestOutputSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+}, {
+    ok: true;
+}>;
+type ContactRequestOutput = z.infer<typeof contactRequestOutputSchema>;
+
+/**
+ * Dashboard notifications. Derived server-side from recent activity
+ * (confirmed payment sessions, new subscribers, processed refunds).
+ * Read state is tracked on the merchant record via
+ * `notificationsLastReadAt` — `event.createdAt <= that timestamp` is
+ * "read", anything newer is "unread". No dedicated notifications
+ * table because the source rows already exist; a separate table would
+ * just be a denormalised copy.
+ */
+
+declare const notificationKindSchema: z.ZodEnum<["payment_received", "subscription_started", "refund_processed", "admin_broadcast"]>;
+type NotificationKind = z.infer<typeof notificationKindSchema>;
+declare const broadcastAudienceSchema: z.ZodEnum<["all", "merchant"]>;
+type BroadcastAudience = z.infer<typeof broadcastAudienceSchema>;
+declare const createBroadcastInputSchema: z.ZodEffects<z.ZodObject<{
+    title: z.ZodString;
+    body: z.ZodString;
+    audience: z.ZodDefault<z.ZodEnum<["all", "merchant"]>>;
+    /** Required when `audience === 'merchant'`; ignored otherwise. */
+    merchantId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    body: string;
+    audience: "merchant" | "all";
+    merchantId?: string | undefined;
+}, {
+    title: string;
+    body: string;
+    merchantId?: string | undefined;
+    audience?: "merchant" | "all" | undefined;
+}>, {
+    title: string;
+    body: string;
+    audience: "merchant" | "all";
+    merchantId?: string | undefined;
+}, {
+    title: string;
+    body: string;
+    merchantId?: string | undefined;
+    audience?: "merchant" | "all" | undefined;
+}>;
+type CreateBroadcastInput = z.infer<typeof createBroadcastInputSchema>;
+declare const broadcastSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    body: z.ZodString;
+    audience: z.ZodEnum<["all", "merchant"]>;
+    merchantId: z.ZodNullable<z.ZodString>;
+    merchantEmail: z.ZodNullable<z.ZodString>;
+    senderId: z.ZodString;
+    senderEmail: z.ZodString;
+    emailedAt: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    merchantId: string | null;
+    createdAt: string;
+    title: string;
+    body: string;
+    audience: "merchant" | "all";
+    merchantEmail: string | null;
+    senderId: string;
+    senderEmail: string;
+    emailedAt: string | null;
+}, {
+    id: string;
+    merchantId: string | null;
+    createdAt: string;
+    title: string;
+    body: string;
+    audience: "merchant" | "all";
+    merchantEmail: string | null;
+    senderId: string;
+    senderEmail: string;
+    emailedAt: string | null;
+}>;
+type Broadcast = z.infer<typeof broadcastSchema>;
+declare const broadcastListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        body: z.ZodString;
+        audience: z.ZodEnum<["all", "merchant"]>;
+        merchantId: z.ZodNullable<z.ZodString>;
+        merchantEmail: z.ZodNullable<z.ZodString>;
+        senderId: z.ZodString;
+        senderEmail: z.ZodString;
+        emailedAt: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        merchantId: string | null;
+        createdAt: string;
+        title: string;
+        body: string;
+        audience: "merchant" | "all";
+        merchantEmail: string | null;
+        senderId: string;
+        senderEmail: string;
+        emailedAt: string | null;
+    }, {
+        id: string;
+        merchantId: string | null;
+        createdAt: string;
+        title: string;
+        body: string;
+        audience: "merchant" | "all";
+        merchantEmail: string | null;
+        senderId: string;
+        senderEmail: string;
+        emailedAt: string | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        id: string;
+        merchantId: string | null;
+        createdAt: string;
+        title: string;
+        body: string;
+        audience: "merchant" | "all";
+        merchantEmail: string | null;
+        senderId: string;
+        senderEmail: string;
+        emailedAt: string | null;
+    }[];
+}, {
+    data: {
+        id: string;
+        merchantId: string | null;
+        createdAt: string;
+        title: string;
+        body: string;
+        audience: "merchant" | "all";
+        merchantEmail: string | null;
+        senderId: string;
+        senderEmail: string;
+        emailedAt: string | null;
+    }[];
+}>;
+type BroadcastListResponse = z.infer<typeof broadcastListResponseSchema>;
+declare const notificationSchema: z.ZodObject<{
+    /** Deterministic client id — `{kind}:{sourceId}`. Safe for React keys. */
+    id: z.ZodString;
+    kind: z.ZodEnum<["payment_received", "subscription_started", "refund_processed", "admin_broadcast"]>;
+    title: z.ZodString;
+    detail: z.ZodString;
+    /** Dashboard route the tray links to. */
+    href: z.ZodString;
+    /** ISO timestamp of the source event; drives sort + read comparison. */
+    createdAt: z.ZodString;
+    /** Server-derived from the merchant's `notificationsLastReadAt`. */
+    read: z.ZodBoolean;
+    /** Optional foreign key back to the source row (for deep-linking). */
+    sourceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    kind: "payment_received" | "subscription_started" | "refund_processed" | "admin_broadcast";
+    createdAt: string;
+    title: string;
+    detail: string;
+    href: string;
+    read: boolean;
+    sourceId?: string | undefined;
+}, {
+    id: string;
+    kind: "payment_received" | "subscription_started" | "refund_processed" | "admin_broadcast";
+    createdAt: string;
+    title: string;
+    detail: string;
+    href: string;
+    read: boolean;
+    sourceId?: string | undefined;
+}>;
+type NotificationView = z.infer<typeof notificationSchema>;
+declare const notificationListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        /** Deterministic client id — `{kind}:{sourceId}`. Safe for React keys. */
+        id: z.ZodString;
+        kind: z.ZodEnum<["payment_received", "subscription_started", "refund_processed", "admin_broadcast"]>;
+        title: z.ZodString;
+        detail: z.ZodString;
+        /** Dashboard route the tray links to. */
+        href: z.ZodString;
+        /** ISO timestamp of the source event; drives sort + read comparison. */
+        createdAt: z.ZodString;
+        /** Server-derived from the merchant's `notificationsLastReadAt`. */
+        read: z.ZodBoolean;
+        /** Optional foreign key back to the source row (for deep-linking). */
+        sourceId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: "payment_received" | "subscription_started" | "refund_processed" | "admin_broadcast";
+        createdAt: string;
+        title: string;
+        detail: string;
+        href: string;
+        read: boolean;
+        sourceId?: string | undefined;
+    }, {
+        id: string;
+        kind: "payment_received" | "subscription_started" | "refund_processed" | "admin_broadcast";
+        createdAt: string;
+        title: string;
+        detail: string;
+        href: string;
+        read: boolean;
+        sourceId?: string | undefined;
+    }>, "many">;
+    unreadCount: z.ZodNumber;
+    lastReadAt: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        id: string;
+        kind: "payment_received" | "subscription_started" | "refund_processed" | "admin_broadcast";
+        createdAt: string;
+        title: string;
+        detail: string;
+        href: string;
+        read: boolean;
+        sourceId?: string | undefined;
+    }[];
+    unreadCount: number;
+    lastReadAt: string | null;
+}, {
+    data: {
+        id: string;
+        kind: "payment_received" | "subscription_started" | "refund_processed" | "admin_broadcast";
+        createdAt: string;
+        title: string;
+        detail: string;
+        href: string;
+        read: boolean;
+        sourceId?: string | undefined;
+    }[];
+    unreadCount: number;
+    lastReadAt: string | null;
+}>;
+type NotificationListResponse = z.infer<typeof notificationListResponseSchema>;
+declare const markNotificationsReadResponseSchema: z.ZodObject<{
+    lastReadAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    lastReadAt: string;
+}, {
+    lastReadAt: string;
+}>;
+type MarkNotificationsReadResponse = z.infer<typeof markNotificationsReadResponseSchema>;
+
+export { type Broadcast, type BroadcastAudience, type BroadcastListResponse, type ContactRequestInput, type ContactRequestOutput, type ContactTopic, type CreateBroadcastInput, type MarkNotificationsReadResponse, type NotificationKind, type NotificationListResponse, type NotificationView, type TokenCapabilities, type TokenMetadata, type TokenPermitNonce, broadcastAudienceSchema, broadcastListResponseSchema, broadcastSchema, contactRequestInputSchema, contactRequestOutputSchema, contactTopicSchema, createBroadcastInputSchema, markNotificationsReadResponseSchema, notificationKindSchema, notificationListResponseSchema, notificationSchema, tokenCapabilitiesSchema, tokenMetadataSchema, tokenPermitNonceSchema };

package/dist/index.js

@@ -41,6 +41,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(),
@@ -57,6 +59,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,
@@ -64,11 +76,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,
@@ -111,7 +164,12 @@ var apiKeyScopeSchema = z.enum([
   // authorizations on the merchant's behalf. Granted to keys used by
   // hosted checkout and merchants embedding the SDK.
   "relay_read",
-  "relay_write"
+  "relay_write",
+  // Self-service key management from an API key holder. Rarely used
+  // day-to-day; needed for partner onboarding flows that mint scoped
+  // keys per sub-tenant.
+  "api_keys_read",
+  "api_keys_write"
 ]);
 var apiKeySchema = z.object({
   id: idSchema,
@@ -168,6 +226,9 @@ var paymentSessionStatusSchema = z.enum([
   "expired",
   "cancelled"
 ]);
+var callbackUrlSchema = z.string().url().refine((v) => v.startsWith("https://") || v.startsWith("http://"), {
+  message: "must be an http:// or https:// URL"
+});
 var paymentSessionSchema = z.object({
   id: idSchema,
   merchantId: idSchema,
@@ -197,8 +258,8 @@ var paymentSessionSchema = z.object({
   description: z.string().max(500).nullable(),
   payerWalletAddress: evmAddressSchema.nullable(),
   payerEmail: z.string().email().nullable(),
-  successUrl: z.string().url().nullable(),
-  cancelUrl: z.string().url().nullable(),
+  successUrl: callbackUrlSchema.nullable(),
+  cancelUrl: callbackUrlSchema.nullable(),
   sourceChain: z.enum(["arc", "ethereum", "base", "polygon", "arbitrum", "optimism", "avalanche", "solana"]).nullable(),
   bridgeTxHash: evmTxHashSchema.nullable(),
   onchainTxHash: evmTxHashSchema.nullable(),
@@ -444,6 +505,16 @@ var submitRefundSignatureInputSchema = z.object({
   id: idSchema,
   refundTxHash: evmTxHashSchema
 });
+var refundSigningInstructionsSchema = z.object({
+  token: evmAddressSchema,
+  to: evmAddressSchema,
+  amount: tokenAmountSchema,
+  note: z.string()
+});
+var refundCreateOutputSchema = z.object({
+  refund: refundSchema,
+  signingInstructions: refundSigningInstructionsSchema
+});
 var webhookEventNameSchema = z.enum([
   "payment.created",
   "payment.completed",
@@ -514,6 +585,11 @@ var webhookDeliverySchema = z.object({
   deliveredAt: isoTimestampSchema.nullable(),
   createdAt: isoTimestampSchema
 });
+var webhookDeliveryDetailSchema = webhookDeliverySchema.extend({
+  deliveryId: z.string(),
+  responseBody: z.string().nullable(),
+  requestPayload: z.record(z.string(), z.unknown())
+});
 var replayDeliveryInputSchema = z.object({
   id: idSchema
 });
@@ -695,6 +771,18 @@ var createStorefrontProductInputSchema = storefrontProductSchema.omit({
 }).extend({
   imageUrl: httpsUrlSchema.optional()
 });
+var storefrontCheckoutInputSchema = z.object({
+  customerEmail: z.string().email().optional(),
+  returnPath: z.string().max(200).optional()
+});
+var storefrontCheckoutResponseSchema = z.object({
+  /** Fully-qualified checkout URL — payer redirects here to sign. */
+  checkoutUrl: z.string().url(),
+  /** Payment-session id (one-time) or plan id (subscription). */
+  ref: idSchema,
+  /** Which downstream checkout the URL points at. */
+  kind: z.enum(["payment_session", "subscription_plan"])
+});
 var invoiceStatusSchema = z.enum(["draft", "sent", "paid", "overdue", "void"]);
 var invoiceLineItemSchema = z.object({
   description: z.string().min(1).max(500),
@@ -852,7 +940,74 @@ var tokenPermitNonceSchema = z.object({
   owner: addressSchema,
   nonce: z.string().regex(/^[0-9]+$/u, "must be a decimal integer string")
 });
+var contactTopicSchema = z.enum(["sales", "support", "partnership", "security", "other"]);
+var contactRequestInputSchema = z.object({
+  name: z.string().min(2).max(120),
+  email: emailSchema,
+  company: z.string().min(1).max(120).optional(),
+  topic: contactTopicSchema,
+  message: z.string().min(20).max(4e3)
+});
+var contactRequestOutputSchema = z.object({
+  ok: z.literal(true)
+});
+var notificationKindSchema = z.enum([
+  "payment_received",
+  "subscription_started",
+  "refund_processed",
+  /** Message an admin broadcast to this merchant (or all merchants). */
+  "admin_broadcast"
+]);
+var broadcastAudienceSchema = z.enum(["all", "merchant"]);
+var createBroadcastInputSchema = z.object({
+  title: z.string().min(4).max(160),
+  body: z.string().min(4).max(4e3),
+  audience: broadcastAudienceSchema.default("all"),
+  /** Required when `audience === 'merchant'`; ignored otherwise. */
+  merchantId: z.string().optional()
+}).refine((v) => v.audience !== "merchant" || !!v.merchantId, {
+  message: "merchantId is required when audience is merchant",
+  path: ["merchantId"]
+});
+var broadcastSchema = z.object({
+  id: idSchema,
+  title: z.string(),
+  body: z.string(),
+  audience: broadcastAudienceSchema,
+  merchantId: idSchema.nullable(),
+  merchantEmail: z.string().nullable(),
+  senderId: idSchema,
+  senderEmail: z.string(),
+  emailedAt: isoTimestampSchema.nullable(),
+  createdAt: isoTimestampSchema
+});
+var broadcastListResponseSchema = z.object({
+  data: z.array(broadcastSchema)
+});
+var notificationSchema = z.object({
+  /** Deterministic client id — `{kind}:{sourceId}`. Safe for React keys. */
+  id: z.string().min(1),
+  kind: notificationKindSchema,
+  title: z.string().min(1),
+  detail: z.string(),
+  /** Dashboard route the tray links to. */
+  href: z.string().min(1),
+  /** ISO timestamp of the source event; drives sort + read comparison. */
+  createdAt: isoTimestampSchema,
+  /** Server-derived from the merchant's `notificationsLastReadAt`. */
+  read: z.boolean(),
+  /** Optional foreign key back to the source row (for deep-linking). */
+  sourceId: idSchema.optional()
+});
+var notificationListResponseSchema = z.object({
+  data: z.array(notificationSchema),
+  unreadCount: z.number().int().min(0),
+  lastReadAt: isoTimestampSchema.nullable()
+});
+var markNotificationsReadResponseSchema = z.object({
+  lastReadAt: isoTimestampSchema
+});
 
-export { agentActionExecutedEventSchema, agentActionOutcomeSchema, agentActionTypeSchema, agentActivityLogSchema, agentCapabilitySchema, agentIdentitySchema, agentJobCompletedEventSchema, agentJobDisputedEventSchema, agentJobProposedEventSchema, agentJobSchema, agentJobStatusSchema, agentMerchantConfigSchema, apiKeyKindSchema, apiKeySchema, apiKeyScopeSchema, arcEnvironmentSchema, cancelSubscriptionInputSchema, changeTierInputSchema, complianceLogSchema, complianceProviderSchema, complianceScreeningContextSchema, complianceStatusSchema, complianceWalletBlockedEventSchema, complianceWalletFlaggedEventSchema, countryCodeSchema, createAgentJobInputSchema, createApiKeyInputSchema, createApiKeyOutputSchema, createInvoiceInputSchema, createMerchantInputSchema, createPaymentSessionInputSchema, createRefundInputSchema, createStorefrontInputSchema, createStorefrontProductInputSchema, createSubscriptionInputSchema, createSubscriptionPlanInputSchema, createWebhookEndpointInputSchema, createWebhookEndpointOutputSchema, customerSchema, emailSchema, evmAddressSchema, evmTxHashSchema, httpUrlSchema, httpsUrlSchema, idSchema, inviteMemberInputSchema, invoiceCreatedEventSchema, invoiceLineItemSchema, invoiceOverdueEventSchema, invoicePaidEventSchema, invoiceSchema, invoiceStatusSchema, isoTimestampSchema, loginInputSchema, loginOutputSchema, makePaginatedSchema, merchantMemberSchema, merchantRoleSchema, merchantSchema, merchantStatusSchema, merchantTierSchema, metadataSchema, modeSchema, paginationInputSchema, paymentCompletedEventSchema, paymentCreatedEventSchema, paymentCurrencySchema, paymentFailedEventSchema, paymentSessionSchema, paymentSessionStatusSchema, refundCompletedEventSchema, refundCreatedEventSchema, refundFailedEventSchema, refundReasonSchema, refundSchema, refundStatusSchema, replayDeliveryInputSchema, rotateApiKeyInputSchema, storefrontProductSchema, storefrontProductTypeSchema, storefrontSchema, storefrontStatusSchema, submitPaymentSessionInputSchema, submitRefundSignatureInputSchema, subscriptionCancelledEventSchema, subscriptionChargeFailedEventSchema, subscriptionChargeOutcomeSchema, subscriptionChargeSchema, subscriptionChargeStatusSchema, subscriptionChargedEventSchema, subscriptionCreatedEventSchema, subscriptionIntervalSchema, subscriptionLapsedEventSchema, subscriptionPlanSchema, subscriptionPlanStatusSchema, subscriptionRecoveryAttemptEventSchema, subscriptionRecoveryOutcomeEventSchema, subscriptionSchema, subscriptionStatusSchema, tokenAmountSchema, tokenCapabilitiesSchema, tokenMetadataSchema, tokenPermitNonceSchema, tokenSymbolSchema, transactionKindSchema, transactionSchema, transactionStatusSchema, uintSchema, updateAgentConfigInputSchema, updateMerchantInputSchema, upsertCustomerInputSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEndpointSchema, webhookEndpointStatusSchema, webhookEventNameSchema, webhookEventSchema };
+export { DEFAULT_MERCHANT_EMAIL_PREFS, agentActionExecutedEventSchema, agentActionOutcomeSchema, agentActionTypeSchema, agentActivityLogSchema, agentCapabilitySchema, agentIdentitySchema, agentJobCompletedEventSchema, agentJobDisputedEventSchema, agentJobProposedEventSchema, agentJobSchema, agentJobStatusSchema, agentMerchantConfigSchema, apiKeyKindSchema, apiKeySchema, apiKeyScopeSchema, arcEnvironmentSchema, broadcastAudienceSchema, broadcastListResponseSchema, broadcastSchema, callbackUrlSchema, cancelSubscriptionInputSchema, changeTierInputSchema, complianceLogSchema, complianceProviderSchema, complianceScreeningContextSchema, complianceStatusSchema, complianceWalletBlockedEventSchema, complianceWalletFlaggedEventSchema, contactRequestInputSchema, contactRequestOutputSchema, contactTopicSchema, countryCodeSchema, createAgentJobInputSchema, createApiKeyInputSchema, createApiKeyOutputSchema, createBroadcastInputSchema, createInvoiceInputSchema, createMerchantInputSchema, createPaymentSessionInputSchema, createRefundInputSchema, createStorefrontInputSchema, createStorefrontProductInputSchema, createSubscriptionInputSchema, createSubscriptionPlanInputSchema, createWebhookEndpointInputSchema, createWebhookEndpointOutputSchema, customerSchema, emailSchema, evmAddressSchema, evmTxHashSchema, httpUrlSchema, httpsUrlSchema, idSchema, inviteMemberInputSchema, invoiceCreatedEventSchema, invoiceLineItemSchema, invoiceOverdueEventSchema, invoicePaidEventSchema, invoiceSchema, invoiceStatusSchema, isoTimestampSchema, loginInputSchema, loginOutputSchema, makePaginatedSchema, markNotificationsReadResponseSchema, merchantBalanceSchema, merchantEmailPrefsSchema, merchantMemberSchema, merchantPublicBrandSchema, merchantRoleSchema, merchantSchema, merchantStatusSchema, merchantTierSchema, metadataSchema, modeSchema, notificationKindSchema, notificationListResponseSchema, notificationSchema, onboardMerchantInputSchema, paginationInputSchema, paymentCompletedEventSchema, paymentCreatedEventSchema, paymentCurrencySchema, paymentFailedEventSchema, paymentSessionSchema, paymentSessionStatusSchema, refundCompletedEventSchema, refundCreateOutputSchema, refundCreatedEventSchema, refundFailedEventSchema, refundReasonSchema, refundSchema, refundSigningInstructionsSchema, refundStatusSchema, replayDeliveryInputSchema, rotateApiKeyInputSchema, storefrontCheckoutInputSchema, storefrontCheckoutResponseSchema, storefrontProductSchema, storefrontProductTypeSchema, storefrontSchema, storefrontStatusSchema, submitPaymentSessionInputSchema, submitRefundSignatureInputSchema, subscriptionCancelledEventSchema, subscriptionChargeFailedEventSchema, subscriptionChargeOutcomeSchema, subscriptionChargeSchema, subscriptionChargeStatusSchema, subscriptionChargedEventSchema, subscriptionCreatedEventSchema, subscriptionIntervalSchema, subscriptionLapsedEventSchema, subscriptionPlanSchema, subscriptionPlanStatusSchema, subscriptionRecoveryAttemptEventSchema, subscriptionRecoveryOutcomeEventSchema, subscriptionSchema, subscriptionStatusSchema, tokenAmountSchema, tokenCapabilitiesSchema, tokenMetadataSchema, tokenPermitNonceSchema, tokenSymbolSchema, transactionKindSchema, transactionSchema, transactionStatusSchema, uintSchema, updateAgentConfigInputSchema, updateMerchantInputSchema, upsertCustomerInputSchema, webhookDeliveryDetailSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEndpointSchema, webhookEndpointStatusSchema, webhookEventNameSchema, webhookEventSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map