@strimz/shared-types 0.6.0 → 0.8.0

package/dist/webhooks.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/common.ts","../src/webhooks.ts"],"names":["z"],"mappings":"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","file":"webhooks.js","sourcesContent":["/**\n * Primitive schemas shared across every entity.\n * Every higher-level schema builds on these so validation is consistent.\n */\n\nimport { z } from 'zod'\n\n/** CUID2 or UUID-style opaque identifier. */\nexport const idSchema = z\n  .string()\n  .min(1)\n  .max(64)\n  .regex(/^[a-zA-Z0-9_-]+$/, 'id must be URL-safe')\n\n/** EVM address. Hex-encoded, 0x-prefixed, 20 bytes. Normalised to lowercase. */\nexport const evmAddressSchema = z\n  .string()\n  .regex(/^0x[a-fA-F0-9]{40}$/, 'must be a 0x-prefixed 40-character hex EVM address')\n  .transform((v) => v.toLowerCase())\n\n/** EVM transaction hash. 32-byte hex. */\nexport const evmTxHashSchema = z\n  .string()\n  .regex(/^0x[a-fA-F0-9]{64}$/, 'must be a 0x-prefixed 64-character hex EVM transaction hash')\n\n/** Email address, trimmed and lower-cased. */\nexport const emailSchema = z.string().email().trim().toLowerCase().max(320)\n\n/** HTTPS URL. No http:// allowed outside dev. */\nexport const httpsUrlSchema = z\n  .string()\n  .url()\n  .refine((v) => v.startsWith('https://'), {\n    message: 'must be an https:// URL',\n  })\n\n/** URL permitting http and https (dev + prod). */\nexport const httpUrlSchema = z.string().url()\n\n/**\n * Amount expressed in the token's smallest unit, serialised as a string to\n * preserve precision beyond `Number.MAX_SAFE_INTEGER`. For USDC (6 decimals),\n * 1 USDC is the string \"1000000\".\n */\nexport const tokenAmountSchema = z\n  .string()\n  .regex(/^[0-9]+$/, 'must be a non-negative integer string (base-10)')\n  .refine((v) => BigInt(v) >= 0n, 'must be >= 0')\n\n/** Unsigned integer up to 2^53 - 1; validated and returned as number. */\nexport const uintSchema = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER)\n\n/** ISO-8601 timestamp string (`.toISOString()`-compatible). */\nexport const isoTimestampSchema = z\n  .string()\n  .datetime({ offset: true, message: 'must be an ISO-8601 timestamp' })\n\n/** Two-letter ISO-3166 country code. */\nexport const countryCodeSchema = z\n  .string()\n  .length(2)\n  .regex(/^[A-Z]{2}$/, 'must be an ISO-3166 alpha-2 country code')\n\n/** Pagination inputs used by every list endpoint. */\nexport const paginationInputSchema = z.object({\n  limit: z.number().int().min(1).max(100).default(25),\n  cursor: z.string().min(1).max(200).nullish(),\n})\nexport type PaginationInput = z.infer<typeof paginationInputSchema>\n\n/** Pagination envelope used by every list response. */\nexport const makePaginatedSchema = <T extends z.ZodTypeAny>(item: T) =>\n  z.object({\n    data: z.array(item),\n    nextCursor: z.string().nullable(),\n    hasMore: z.boolean(),\n  })\n\n/** Free-form metadata bag the API round-trips for merchants. */\nexport const metadataSchema = z\n  .record(\n    z.string().min(1).max(40),\n    z.union([z.string().max(500), z.number(), z.boolean(), z.null()]),\n  )\n  .refine((m) => Object.keys(m).length <= 50, 'at most 50 metadata keys')\n  .default({})\n\n/** Environment mode carried on every mode-scoped resource. */\nexport const modeSchema = z.enum(['test', 'live'])\nexport type Mode = z.infer<typeof modeSchema>\n\n/** Payment token enum. */\nexport const paymentCurrencySchema = z.enum(['USDC', 'EURC'])\nexport type PaymentCurrency = z.infer<typeof paymentCurrencySchema>\n\n/** Every display-level currency (payment + treasury). */\nexport const tokenSymbolSchema = z.enum(['USDC', 'EURC', 'USYC'])\nexport type TokenSymbol = z.infer<typeof tokenSymbolSchema>\n\n/** Merchant tier enum. */\nexport const merchantTierSchema = z.enum(['free', 'growth', 'business', 'enterprise'])\nexport type MerchantTier = z.infer<typeof merchantTierSchema>\n\n/** Arc environment enum. */\nexport const arcEnvironmentSchema = z.enum(['testnet', 'mainnet'])\nexport type ArcEnvironment = z.infer<typeof arcEnvironmentSchema>\n\nexport type Id = z.infer<typeof idSchema>\nexport type EvmAddress = z.infer<typeof evmAddressSchema>\nexport type EvmTxHash = z.infer<typeof evmTxHashSchema>\nexport type TokenAmount = z.infer<typeof tokenAmountSchema>\nexport type IsoTimestamp = z.infer<typeof isoTimestampSchema>\nexport type Metadata = z.infer<typeof metadataSchema>\n","/**\n * Webhook endpoints and deliveries.\n *\n * Endpoint = the URL the merchant registered.\n * Event    = the thing that happened.\n * Delivery = one attempt to POST a specific event to a specific endpoint.\n */\n\nimport { z } from 'zod'\nimport { httpsUrlSchema, idSchema, isoTimestampSchema, modeSchema } from './common.js'\n\n// ---------- Event name ----------\n\n/**\n * Every webhook event name in the system. Listed inline so Zod can\n * produce a concrete string union.\n */\nexport const webhookEventNameSchema = z.enum([\n  'payment.created',\n  'payment.completed',\n  'payment.failed',\n  'subscription.created',\n  'subscription.charged',\n  'subscription.charge_failed',\n  'subscription.recovery_attempt',\n  'subscription.recovery_outcome',\n  'subscription.cancelled',\n  'subscription.lapsed',\n  'refund.created',\n  'refund.completed',\n  'refund.failed',\n  'invoice.created',\n  'invoice.paid',\n  'invoice.overdue',\n  'agent.action_executed',\n  'agent.job_proposed',\n  'agent.job_completed',\n  'agent.job_disputed',\n  'compliance.wallet_flagged',\n  'compliance.wallet_blocked',\n])\nexport type WebhookEventName = z.infer<typeof webhookEventNameSchema>\n\n// ---------- Endpoints ----------\n\nexport const webhookEndpointStatusSchema = z.enum(['active', 'disabled'])\nexport type WebhookEndpointStatus = z.infer<typeof webhookEndpointStatusSchema>\n\nexport const webhookEndpointSchema = z.object({\n  id: idSchema,\n  merchantId: idSchema,\n  mode: modeSchema,\n  url: httpsUrlSchema,\n  description: z.string().max(200).nullable(),\n  events: z.array(webhookEventNameSchema).nonempty(),\n  status: webhookEndpointStatusSchema,\n  signingSecretPrefix: z.string().min(4).max(12),\n  lastDeliveredAt: isoTimestampSchema.nullable(),\n  createdAt: isoTimestampSchema,\n  updatedAt: isoTimestampSchema,\n})\nexport type WebhookEndpoint = z.infer<typeof webhookEndpointSchema>\n\nexport const createWebhookEndpointInputSchema = z.object({\n  url: httpsUrlSchema,\n  events: z.array(webhookEventNameSchema).nonempty(),\n  description: z.string().max(200).optional(),\n  mode: modeSchema,\n})\nexport type CreateWebhookEndpointInput = z.infer<typeof createWebhookEndpointInputSchema>\n\nexport const createWebhookEndpointOutputSchema = z.object({\n  endpoint: webhookEndpointSchema,\n  /** Full signing secret. Shown exactly once. */\n  signingSecret: z.string(),\n})\nexport type CreateWebhookEndpointOutput = z.infer<typeof createWebhookEndpointOutputSchema>\n\n// ---------- Deliveries ----------\n\nexport const webhookDeliveryStatusSchema = z.enum([\n  'pending',\n  'delivered',\n  'retrying',\n  'permanently_failed',\n])\nexport type WebhookDeliveryStatus = z.infer<typeof webhookDeliveryStatusSchema>\n\nexport const webhookDeliverySchema = z.object({\n  id: idSchema,\n  merchantId: idSchema,\n  endpointId: idSchema,\n  eventId: idSchema,\n  eventName: webhookEventNameSchema,\n  status: webhookDeliveryStatusSchema,\n  attempt: z.number().int().min(1).max(6),\n  responseCode: z.number().int().min(100).max(599).nullable(),\n  responseMs: z.number().int().min(0).nullable(),\n  lastError: z.string().max(1000).nullable(),\n  nextAttemptAt: isoTimestampSchema.nullable(),\n  deliveredAt: isoTimestampSchema.nullable(),\n  createdAt: isoTimestampSchema,\n})\nexport type WebhookDelivery = z.infer<typeof webhookDeliverySchema>\n\n/**\n * Detail projection returned by GET /v1/webhook-deliveries/:id.\n * Carries the payload envelope, response body, and the deliveryId\n * header the receiver saw. Kept separate so list responses stay slim.\n */\nexport const webhookDeliveryDetailSchema = webhookDeliverySchema.extend({\n  deliveryId: z.string(),\n  responseBody: z.string().nullable(),\n  requestPayload: z.record(z.string(), z.unknown()),\n})\nexport type WebhookDeliveryDetail = z.infer<typeof webhookDeliveryDetailSchema>\n\nexport const replayDeliveryInputSchema = z.object({\n  id: idSchema,\n})\nexport type ReplayDeliveryInput = z.infer<typeof replayDeliveryInputSchema>\n"]}
+{"version":3,"sources":["../src/common.ts","../src/webhooks.ts"],"names":["z"],"mappings":"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","file":"webhooks.js","sourcesContent":["/**\n * Primitive schemas shared across every entity.\n * Every higher-level schema builds on these so validation is consistent.\n */\n\nimport { z } from 'zod'\n\n/** CUID2 or UUID-style opaque identifier. */\nexport const idSchema = z\n  .string()\n  .min(1)\n  .max(64)\n  .regex(/^[a-zA-Z0-9_-]+$/, 'id must be URL-safe')\n\n/** EVM address. Hex-encoded, 0x-prefixed, 20 bytes. Normalised to lowercase. */\nexport const evmAddressSchema = z\n  .string()\n  .regex(/^0x[a-fA-F0-9]{40}$/, 'must be a 0x-prefixed 40-character hex EVM address')\n  .transform((v) => v.toLowerCase())\n\n/** EVM transaction hash. 32-byte hex. */\nexport const evmTxHashSchema = z\n  .string()\n  .regex(/^0x[a-fA-F0-9]{64}$/, 'must be a 0x-prefixed 64-character hex EVM transaction hash')\n\n/** Email address, trimmed and lower-cased. */\nexport const emailSchema = z.string().email().trim().toLowerCase().max(320)\n\n/** HTTPS URL. No http:// allowed outside dev. */\nexport const httpsUrlSchema = z\n  .string()\n  .url()\n  .refine((v) => v.startsWith('https://'), {\n    message: 'must be an https:// URL',\n  })\n\n/** URL permitting http and https (dev + prod). */\nexport const httpUrlSchema = z.string().url()\n\n/**\n * Amount expressed in the token's smallest unit, serialised as a string to\n * preserve precision beyond `Number.MAX_SAFE_INTEGER`. For USDC (6 decimals),\n * 1 USDC is the string \"1000000\".\n */\nexport const tokenAmountSchema = z\n  .string()\n  .regex(/^[0-9]+$/, 'must be a non-negative integer string (base-10)')\n  .refine((v) => BigInt(v) >= 0n, 'must be >= 0')\n\n/** Unsigned integer up to 2^53 - 1; validated and returned as number. */\nexport const uintSchema = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER)\n\n/** ISO-8601 timestamp string (`.toISOString()`-compatible). */\nexport const isoTimestampSchema = z\n  .string()\n  .datetime({ offset: true, message: 'must be an ISO-8601 timestamp' })\n\n/** Two-letter ISO-3166 country code. */\nexport const countryCodeSchema = z\n  .string()\n  .length(2)\n  .regex(/^[A-Z]{2}$/, 'must be an ISO-3166 alpha-2 country code')\n\n/** Pagination inputs used by every list endpoint. */\nexport const paginationInputSchema = z.object({\n  limit: z.number().int().min(1).max(100).default(25),\n  cursor: z.string().min(1).max(200).nullish(),\n})\nexport type PaginationInput = z.input<typeof paginationInputSchema>\nexport type PaginationParsed = z.output<typeof paginationInputSchema>\n\n/** Pagination envelope used by every list response. */\nexport const makePaginatedSchema = <T extends z.ZodTypeAny>(item: T) =>\n  z.object({\n    data: z.array(item),\n    nextCursor: z.string().nullable(),\n    hasMore: z.boolean(),\n  })\n\n/** Free-form metadata bag the API round-trips for merchants. */\nexport const metadataSchema = z\n  .record(\n    z.string().min(1).max(40),\n    z.union([z.string().max(500), z.number(), z.boolean(), z.null()]),\n  )\n  .refine((m) => Object.keys(m).length <= 50, 'at most 50 metadata keys')\n  .default({})\n\n/** Environment mode carried on every mode-scoped resource. */\nexport const modeSchema = z.enum(['test', 'live'])\nexport type Mode = z.infer<typeof modeSchema>\n\n/** Payment token enum. */\nexport const paymentCurrencySchema = z.enum(['USDC', 'EURC'])\nexport type PaymentCurrency = z.infer<typeof paymentCurrencySchema>\n\n/** Every display-level currency (payment + treasury). */\nexport const tokenSymbolSchema = z.enum(['USDC', 'EURC', 'USYC'])\nexport type TokenSymbol = z.infer<typeof tokenSymbolSchema>\n\n/** Merchant tier enum. */\nexport const merchantTierSchema = z.enum(['free', 'growth', 'business', 'enterprise'])\nexport type MerchantTier = z.infer<typeof merchantTierSchema>\n\n/** Arc environment enum. */\nexport const arcEnvironmentSchema = z.enum(['testnet', 'mainnet'])\nexport type ArcEnvironment = z.infer<typeof arcEnvironmentSchema>\n\nexport type Id = z.infer<typeof idSchema>\nexport type EvmAddress = z.infer<typeof evmAddressSchema>\nexport type EvmTxHash = z.infer<typeof evmTxHashSchema>\nexport type TokenAmount = z.infer<typeof tokenAmountSchema>\nexport type IsoTimestamp = z.infer<typeof isoTimestampSchema>\nexport type Metadata = z.infer<typeof metadataSchema>\n","/**\n * Webhook endpoints and deliveries.\n *\n * Endpoint = the URL the merchant registered.\n * Event    = the thing that happened.\n * Delivery = one attempt to POST a specific event to a specific endpoint.\n */\n\nimport { z } from 'zod'\nimport { httpsUrlSchema, idSchema, isoTimestampSchema, modeSchema } from './common.js'\n\n// ---------- Event name ----------\n\n/**\n * Every webhook event name in the system. Listed inline so Zod can\n * produce a concrete string union.\n */\nexport const webhookEventNameSchema = z.enum([\n  'payment.created',\n  'payment.completed',\n  'payment.failed',\n  'subscription.created',\n  'subscription.charged',\n  'subscription.charge_failed',\n  'subscription.recovery_attempt',\n  'subscription.recovery_outcome',\n  'subscription.cancelled',\n  'subscription.lapsed',\n  'refund.created',\n  'refund.completed',\n  'refund.failed',\n  'invoice.created',\n  'invoice.paid',\n  'invoice.overdue',\n  'agent.action_executed',\n  'agent.job_proposed',\n  'agent.job_completed',\n  'agent.job_disputed',\n  'compliance.wallet_flagged',\n  'compliance.wallet_blocked',\n])\nexport type WebhookEventName = z.infer<typeof webhookEventNameSchema>\n\n// ---------- Endpoints ----------\n\nexport const webhookEndpointStatusSchema = z.enum(['active', 'disabled'])\nexport type WebhookEndpointStatus = z.infer<typeof webhookEndpointStatusSchema>\n\nexport const webhookEndpointSchema = z.object({\n  id: idSchema,\n  merchantId: idSchema,\n  mode: modeSchema,\n  url: httpsUrlSchema,\n  description: z.string().max(200).nullable(),\n  events: z.array(webhookEventNameSchema).nonempty(),\n  status: webhookEndpointStatusSchema,\n  signingSecretPrefix: z.string().min(4).max(12),\n  lastDeliveredAt: isoTimestampSchema.nullable(),\n  createdAt: isoTimestampSchema,\n  updatedAt: isoTimestampSchema,\n})\nexport type WebhookEndpoint = z.infer<typeof webhookEndpointSchema>\n\nexport const createWebhookEndpointInputSchema = z.object({\n  url: httpsUrlSchema,\n  events: z.array(webhookEventNameSchema).nonempty(),\n  description: z.string().max(200).optional(),\n  mode: modeSchema,\n})\nexport type CreateWebhookEndpointInput = z.input<typeof createWebhookEndpointInputSchema>\nexport type CreateWebhookEndpointParsed = z.output<typeof createWebhookEndpointInputSchema>\n\nexport const createWebhookEndpointOutputSchema = z.object({\n  endpoint: webhookEndpointSchema,\n  /** Full signing secret. Shown exactly once. */\n  signingSecret: z.string(),\n})\nexport type CreateWebhookEndpointOutput = z.infer<typeof createWebhookEndpointOutputSchema>\n\n// ---------- Deliveries ----------\n\nexport const webhookDeliveryStatusSchema = z.enum([\n  'pending',\n  'delivered',\n  'retrying',\n  'permanently_failed',\n])\nexport type WebhookDeliveryStatus = z.infer<typeof webhookDeliveryStatusSchema>\n\nexport const webhookDeliverySchema = z.object({\n  id: idSchema,\n  merchantId: idSchema,\n  endpointId: idSchema,\n  eventId: idSchema,\n  eventName: webhookEventNameSchema,\n  status: webhookDeliveryStatusSchema,\n  attempt: z.number().int().min(1).max(6),\n  responseCode: z.number().int().min(100).max(599).nullable(),\n  responseMs: z.number().int().min(0).nullable(),\n  lastError: z.string().max(1000).nullable(),\n  nextAttemptAt: isoTimestampSchema.nullable(),\n  deliveredAt: isoTimestampSchema.nullable(),\n  createdAt: isoTimestampSchema,\n})\nexport type WebhookDelivery = z.infer<typeof webhookDeliverySchema>\n\n/**\n * Detail projection returned by GET /v1/webhook-deliveries/:id.\n * Carries the payload envelope, response body, and the deliveryId\n * header the receiver saw. Kept separate so list responses stay slim.\n */\nexport const webhookDeliveryDetailSchema = webhookDeliverySchema.extend({\n  deliveryId: z.string(),\n  responseBody: z.string().nullable(),\n  requestPayload: z.record(z.string(), z.unknown()),\n})\nexport type WebhookDeliveryDetail = z.infer<typeof webhookDeliveryDetailSchema>\n\nexport const replayDeliveryInputSchema = z.object({\n  id: idSchema,\n})\nexport type ReplayDeliveryInput = z.input<typeof replayDeliveryInputSchema>\nexport type ReplayDeliveryParsed = z.output<typeof replayDeliveryInputSchema>\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strimz/shared-types",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Zod schemas and inferred TypeScript types for every Strimz platform entity, API input, and webhook event.",
   "license": "MIT",
   "author": "Strimz <hello@strimz.finance>",
@@ -103,6 +103,11 @@
       "types": "./dist/events.d.ts",
       "import": "./dist/events.js",
       "require": "./dist/events.cjs"
+    },
+    "./analytics": {
+      "types": "./dist/analytics.d.ts",
+      "import": "./dist/analytics.js",
+      "require": "./dist/analytics.cjs"
     }
   },
   "files": [

package/src/agents.ts

@@ -65,7 +65,8 @@ export type AgentMerchantConfig = z.infer<typeof agentMerchantConfigSchema>
 export const updateAgentConfigInputSchema = agentMerchantConfigSchema
   .omit({ merchantId: true, updatedAt: true })
   .partial()
-export type UpdateAgentConfigInput = z.infer<typeof updateAgentConfigInputSchema>
+export type UpdateAgentConfigInput = z.input<typeof updateAgentConfigInputSchema>
+export type UpdateAgentConfigParsed = z.output<typeof updateAgentConfigInputSchema>
 
 // ---------- Activity log ----------
 
@@ -153,4 +154,5 @@ export const createAgentJobInputSchema = z.object({
   currency: z.enum(['USDC', 'EURC']),
   assessorAddress: evmAddressSchema.optional(),
 })
-export type CreateAgentJobInput = z.infer<typeof createAgentJobInputSchema>
+export type CreateAgentJobInput = z.input<typeof createAgentJobInputSchema>
+export type CreateAgentJobParsed = z.output<typeof createAgentJobInputSchema>

package/src/analytics.ts

@@ -0,0 +1,275 @@
+import { z } from 'zod'
+import {
+  idSchema,
+  isoTimestampSchema,
+  modeSchema,
+  paymentCurrencySchema,
+  tokenAmountSchema,
+  uintSchema,
+  type PaymentCurrency,
+} from './common.js'
+import { invoiceStatusSchema } from './invoices.js'
+import { paymentSessionStatusSchema } from './payment-sessions.js'
+import { refundStatusSchema } from './refunds.js'
+import { subscriptionStatusSchema } from './subscriptions.js'
+
+export const paymentCurrencies = paymentCurrencySchema.options
+
+const currencyAmountsShape = {
+  USDC: tokenAmountSchema,
+  EURC: tokenAmountSchema,
+} satisfies Record<PaymentCurrency, typeof tokenAmountSchema>
+
+export const currencyAmountsSchema = z.object(currencyAmountsShape).strict()
+export type CurrencyAmounts = z.infer<typeof currencyAmountsSchema>
+
+function countsByStatusSchema<T extends [string, ...string[]]>(statuses: z.ZodEnum<T>) {
+  const shape = Object.fromEntries(statuses.options.map((s) => [s, uintSchema])) as {
+    [K in T[number]]: typeof uintSchema
+  }
+  return z.object(shape).strict()
+}
+
+export const moneySchema = z.object({
+  count: uintSchema,
+  amount: currencyAmountsSchema,
+})
+export type Money = z.infer<typeof moneySchema>
+
+export const volumeWindowSchema = z.object({
+  count: uintSchema,
+  gross: currencyAmountsSchema,
+  fees: currencyAmountsSchema,
+  net: currencyAmountsSchema,
+})
+export type VolumeWindow = z.infer<typeof volumeWindowSchema>
+
+export const statsSummarySchema = z.object({
+  mode: modeSchema,
+  generatedAt: isoTimestampSchema,
+  volume: z.object({
+    last7d: volumeWindowSchema,
+    last30d: volumeWindowSchema,
+    allTime: volumeWindowSchema,
+  }),
+  paymentSessions: z.object({
+    total: uintSchema,
+    byStatus: countsByStatusSchema(paymentSessionStatusSchema),
+    confirmed: moneySchema,
+  }),
+  invoices: z.object({
+    byStatus: countsByStatusSchema(invoiceStatusSchema),
+    outstanding: moneySchema,
+    overdue: moneySchema,
+    paidLast30d: moneySchema,
+  }),
+  refunds: z.object({
+    byStatus: countsByStatusSchema(refundStatusSchema),
+    completed: moneySchema,
+  }),
+  subscriptions: z.object({
+    total: uintSchema,
+    byStatus: countsByStatusSchema(subscriptionStatusSchema),
+  }),
+  customers: z.object({
+    total: uintSchema,
+  }),
+})
+export type StatsSummary = z.infer<typeof statsSummarySchema>
+
+export const STATS_VOLUME_MAX_DAYS = 366
+export const STATS_VOLUME_DEFAULT_DAYS = 30
+
+export function resolveStatsVolumeRange(
+  query: { from?: string; to?: string },
+  now: number = Date.now(),
+): { from: Date; to: Date } {
+  const to = query.to ? new Date(query.to) : new Date(now)
+  const from = query.from
+    ? new Date(query.from)
+    : new Date(to.getTime() - STATS_VOLUME_DEFAULT_DAYS * 86_400_000)
+  return { from, to }
+}
+
+export const statsVolumeQuerySchema = z
+  .object({
+    from: isoTimestampSchema.optional(),
+    to: isoTimestampSchema.optional(),
+  })
+  .strict()
+  .superRefine((q, ctx) => {
+    const { from, to } = resolveStatsVolumeRange(q)
+    if (from.getTime() > to.getTime()) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: 'from must not be after to',
+        path: ['from'],
+      })
+    } else if (to.getTime() - from.getTime() > STATS_VOLUME_MAX_DAYS * 86_400_000) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: `from and to must be at most ${STATS_VOLUME_MAX_DAYS} days apart`,
+        path: ['to'],
+      })
+    }
+  })
+export type StatsVolumeQuery = z.infer<typeof statsVolumeQuerySchema>
+
+const dayKeySchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'must be a YYYY-MM-DD day')
+
+export const statsVolumeDaySchema = z.object({
+  day: dayKeySchema,
+  currency: paymentCurrencySchema,
+  count: uintSchema,
+  gross: tokenAmountSchema,
+  fees: tokenAmountSchema,
+  net: tokenAmountSchema,
+})
+export type StatsVolumeDay = z.infer<typeof statsVolumeDaySchema>
+
+export const statsVolumeSchema = z.object({
+  from: isoTimestampSchema,
+  to: isoTimestampSchema,
+  data: z.array(statsVolumeDaySchema),
+})
+export type StatsVolume = z.infer<typeof statsVolumeSchema>
+
+export const statsMrrSchema = z.object({
+  mrr: currencyAmountsSchema,
+  activeSubscribers: uintSchema,
+})
+export type StatsMrr = z.infer<typeof statsMrrSchema>
+
+export const statsLtvQuerySchema = z
+  .object({
+    currency: paymentCurrencySchema,
+    limit: z.coerce.number().int().min(1).max(100).default(25),
+    cursor: z.string().min(1).max(200).optional(),
+  })
+  .strict()
+export type StatsLtvQuery = z.input<typeof statsLtvQuerySchema>
+export type StatsLtvQueryParsed = z.output<typeof statsLtvQuerySchema>
+
+export const statsLtvRowSchema = z.object({
+  customerId: idSchema,
+  totalSpend: tokenAmountSchema,
+  transactionCount: uintSchema,
+})
+export type StatsLtvRow = z.infer<typeof statsLtvRowSchema>
+
+export const statsLtvSchema = z.object({
+  currency: paymentCurrencySchema,
+  data: z.array(statsLtvRowSchema),
+  nextCursor: z.string().nullable(),
+  hasMore: z.boolean(),
+})
+export type StatsLtv = z.infer<typeof statsLtvSchema>
+
+export const forecastConfidenceSchema = z.enum(['low', 'medium', 'high'])
+export type ForecastConfidence = z.infer<typeof forecastConfidenceSchema>
+
+export const forecastSchema = z.object({
+  confidence: forecastConfidenceSchema,
+  last90DayRevenue: tokenAmountSchema,
+  next30: tokenAmountSchema,
+  next60: tokenAmountSchema,
+  next90: tokenAmountSchema,
+})
+export type Forecast = z.infer<typeof forecastSchema>
+
+const forecastByCurrencyShape = {
+  USDC: forecastSchema,
+  EURC: forecastSchema,
+} satisfies Record<PaymentCurrency, typeof forecastSchema>
+
+export const statsForecastSchema = z.object({
+  byCurrency: z.object(forecastByCurrencyShape).strict(),
+})
+export type StatsForecast = z.infer<typeof statsForecastSchema>
+
+export const adminStatsModeQuerySchema = z
+  .object({
+    mode: modeSchema.default('live'),
+  })
+  .strict()
+export type AdminStatsModeQuery = z.input<typeof adminStatsModeQuerySchema>
+
+export const adminOverviewSchema = z.object({
+  mode: modeSchema,
+  merchants: z.object({
+    total: uintSchema,
+    byStatus: z.record(z.string(), uintSchema),
+    last30dSignups: uintSchema,
+  }),
+  volume: z.object({
+    lifetime: currencyAmountsSchema,
+    lifetimeFees: currencyAmountsSchema,
+    last30d: currencyAmountsSchema,
+    confirmedSessions: uintSchema,
+  }),
+  subscriptions: z.object({
+    active: uintSchema,
+    mrr: currencyAmountsSchema,
+  }),
+})
+export type AdminOverview = z.infer<typeof adminOverviewSchema>
+
+export const adminMerchantStatsSchema = z.object({
+  mode: modeSchema,
+  confirmedPayments: uintSchema,
+  activeSubscriptions: uintSchema,
+  lifetimeVolume: currencyAmountsSchema,
+  last30dVolume: currencyAmountsSchema,
+})
+export type AdminMerchantStats = z.infer<typeof adminMerchantStatsSchema>
+
+export const adminVolumeQuerySchema = z
+  .object({
+    from: isoTimestampSchema.optional(),
+    to: isoTimestampSchema.optional(),
+    mode: modeSchema.default('live'),
+  })
+  .strict()
+export type AdminVolumeQuery = z.input<typeof adminVolumeQuerySchema>
+
+export const adminVolumeDaySchema = z.object({
+  day: dayKeySchema,
+  currency: paymentCurrencySchema,
+  volume: tokenAmountSchema,
+  fees: tokenAmountSchema,
+  count: uintSchema,
+})
+export type AdminVolumeDay = z.infer<typeof adminVolumeDaySchema>
+
+export const adminVolumeSeriesSchema = z.object({
+  mode: modeSchema,
+  from: isoTimestampSchema,
+  to: isoTimestampSchema,
+  data: z.array(adminVolumeDaySchema),
+})
+export type AdminVolumeSeries = z.infer<typeof adminVolumeSeriesSchema>
+
+export const adminTopMerchantsQuerySchema = z
+  .object({
+    currency: paymentCurrencySchema,
+    mode: modeSchema.default('live'),
+    limit: z.coerce.number().int().min(1).max(50).default(10),
+  })
+  .strict()
+export type AdminTopMerchantsQuery = z.input<typeof adminTopMerchantsQuerySchema>
+
+export const adminTopMerchantSchema = z.object({
+  merchantId: idSchema,
+  businessName: z.string().nullable(),
+  email: z.string(),
+  volume: tokenAmountSchema,
+  transactionCount: uintSchema,
+})
+export type AdminTopMerchant = z.infer<typeof adminTopMerchantSchema>
+
+export const adminTopMerchantsSchema = z.object({
+  mode: modeSchema,
+  currency: paymentCurrencySchema,
+  data: z.array(adminTopMerchantSchema),
+})
+export type AdminTopMerchants = z.infer<typeof adminTopMerchantsSchema>

package/src/api-keys.ts

@@ -71,7 +71,8 @@ export const createApiKeyInputSchema = z.object({
   mode: modeSchema,
   scopes: z.array(apiKeyScopeSchema).nonempty(),
 })
-export type CreateApiKeyInput = z.infer<typeof createApiKeyInputSchema>
+export type CreateApiKeyInput = z.input<typeof createApiKeyInputSchema>
+export type CreateApiKeyParsed = z.output<typeof createApiKeyInputSchema>
 
 export const createApiKeyOutputSchema = z.object({
   apiKey: apiKeySchema,
@@ -83,4 +84,5 @@ export type CreateApiKeyOutput = z.infer<typeof createApiKeyOutputSchema>
 export const rotateApiKeyInputSchema = z.object({
   id: idSchema,
 })
-export type RotateApiKeyInput = z.infer<typeof rotateApiKeyInputSchema>
+export type RotateApiKeyInput = z.input<typeof rotateApiKeyInputSchema>
+export type RotateApiKeyParsed = z.output<typeof rotateApiKeyInputSchema>

package/src/common.ts

@@ -66,7 +66,8 @@ export const paginationInputSchema = z.object({
   limit: z.number().int().min(1).max(100).default(25),
   cursor: z.string().min(1).max(200).nullish(),
 })
-export type PaginationInput = z.infer<typeof paginationInputSchema>
+export type PaginationInput = z.input<typeof paginationInputSchema>
+export type PaginationParsed = z.output<typeof paginationInputSchema>
 
 /** Pagination envelope used by every list response. */
 export const makePaginatedSchema = <T extends z.ZodTypeAny>(item: T) =>

package/src/contact.ts

@@ -18,7 +18,8 @@ export const contactRequestInputSchema = z.object({
   topic: contactTopicSchema,
   message: z.string().min(20).max(4000),
 })
-export type ContactRequestInput = z.infer<typeof contactRequestInputSchema>
+export type ContactRequestInput = z.input<typeof contactRequestInputSchema>
+export type ContactRequestParsed = z.output<typeof contactRequestInputSchema>
 
 export const contactRequestOutputSchema = z.object({
   ok: z.literal(true),

package/src/customers.ts

@@ -37,4 +37,5 @@ export const upsertCustomerInputSchema = z.object({
   displayName: z.string().min(1).max(120).optional(),
   metadata: metadataSchema.optional(),
 })
-export type UpsertCustomerInput = z.infer<typeof upsertCustomerInputSchema>
+export type UpsertCustomerInput = z.input<typeof upsertCustomerInputSchema>
+export type UpsertCustomerParsed = z.output<typeof upsertCustomerInputSchema>

package/src/index.ts

@@ -23,3 +23,4 @@ export * from './events.js'
 export * from './tokens.js'
 export * from './contact.js'
 export * from './notifications.js'
+export * from './analytics.js'

package/src/invoices.ts

@@ -50,4 +50,5 @@ export const createInvoiceInputSchema = z.object({
   note: z.string().max(2000).optional(),
   dueInDays: z.number().int().min(1).max(90).default(7),
 })
-export type CreateInvoiceInput = z.infer<typeof createInvoiceInputSchema>
+export type CreateInvoiceInput = z.input<typeof createInvoiceInputSchema>
+export type CreateInvoiceParsed = z.output<typeof createInvoiceInputSchema>

package/src/merchants.ts

@@ -52,7 +52,8 @@ export const createMerchantInputSchema = z.object({
   countryCode: z.string().length(2).optional(),
   websiteUrl: z.string().url().optional(),
 })
-export type CreateMerchantInput = z.infer<typeof createMerchantInputSchema>
+export type CreateMerchantInput = z.input<typeof createMerchantInputSchema>
+export type CreateMerchantParsed = z.output<typeof createMerchantInputSchema>
 
 /**
  * Merchant email opt-outs, persisted at `Merchant.metadata.emailPrefs`.
@@ -83,12 +84,14 @@ export const updateMerchantInputSchema = z
     emailPrefs: merchantEmailPrefsSchema.partial(),
   })
   .partial()
-export type UpdateMerchantInput = z.infer<typeof updateMerchantInputSchema>
+export type UpdateMerchantInput = z.input<typeof updateMerchantInputSchema>
+export type UpdateMerchantParsed = z.output<typeof updateMerchantInputSchema>
 
 export const changeTierInputSchema = z.object({
   tier: merchantTierSchema,
 })
-export type ChangeTierInput = z.infer<typeof changeTierInputSchema>
+export type ChangeTierInput = z.input<typeof changeTierInputSchema>
+export type ChangeTierParsed = z.output<typeof changeTierInputSchema>
 
 /**
  * Self-attested onboarding form the dashboard collects after a
@@ -110,7 +113,8 @@ export const onboardMerchantInputSchema = z.object({
   payoutAddress: evmAddressSchema,
   defaultCurrency: z.enum(['USDC', 'EURC']).optional(),
 })
-export type OnboardMerchantInput = z.infer<typeof onboardMerchantInputSchema>
+export type OnboardMerchantInput = z.input<typeof onboardMerchantInputSchema>
+export type OnboardMerchantParsed = z.output<typeof onboardMerchantInputSchema>
 
 export const merchantPublicBrandSchema = z.object({
   id: idSchema,
@@ -170,7 +174,8 @@ export const inviteMemberInputSchema = z.object({
   email: emailSchema,
   role: merchantRoleSchema,
 })
-export type InviteMemberInput = z.infer<typeof inviteMemberInputSchema>
+export type InviteMemberInput = z.input<typeof inviteMemberInputSchema>
+export type InviteMemberParsed = z.output<typeof inviteMemberInputSchema>
 
 // ---------- Auth ----------
 
@@ -178,7 +183,8 @@ export const loginInputSchema = z.object({
   email: emailSchema,
   password: z.string().min(1).max(128),
 })
-export type LoginInput = z.infer<typeof loginInputSchema>
+export type LoginInput = z.input<typeof loginInputSchema>
+export type LoginParsed = z.output<typeof loginInputSchema>
 
 export const loginOutputSchema = z.object({
   accessToken: z.string(),

package/src/notifications.ts

@@ -37,7 +37,8 @@ export const createBroadcastInputSchema = z
     message: 'merchantId is required when audience is merchant',
     path: ['merchantId'],
   })
-export type CreateBroadcastInput = z.infer<typeof createBroadcastInputSchema>
+export type CreateBroadcastInput = z.input<typeof createBroadcastInputSchema>
+export type CreateBroadcastParsed = z.output<typeof createBroadcastInputSchema>
 
 export const broadcastSchema = z.object({
   id: idSchema,

package/src/payment-sessions.ts

@@ -133,7 +133,8 @@ export const createPaymentSessionInputSchema = z.object({
     .optional(),
   metadata: metadataSchema.optional(),
 })
-export type CreatePaymentSessionInput = z.infer<typeof createPaymentSessionInputSchema>
+export type CreatePaymentSessionInput = z.input<typeof createPaymentSessionInputSchema>
+export type CreatePaymentSessionParsed = z.output<typeof createPaymentSessionInputSchema>
 
 export const submitPaymentSessionInputSchema = z.object({
   sourceChain: z.enum([
@@ -150,4 +151,5 @@ export const submitPaymentSessionInputSchema = z.object({
   bridgeTxHash: evmTxHashSchema.optional(),
   payerWalletAddress: evmAddressSchema,
 })
-export type SubmitPaymentSessionInput = z.infer<typeof submitPaymentSessionInputSchema>
+export type SubmitPaymentSessionInput = z.input<typeof submitPaymentSessionInputSchema>
+export type SubmitPaymentSessionParsed = z.output<typeof submitPaymentSessionInputSchema>

package/src/refunds.ts

@@ -59,13 +59,15 @@ export const createRefundInputSchema = z.object({
   reason: refundReasonSchema,
   note: z.string().max(500).optional(),
 })
-export type CreateRefundInput = z.infer<typeof createRefundInputSchema>
+export type CreateRefundInput = z.input<typeof createRefundInputSchema>
+export type CreateRefundParsed = z.output<typeof createRefundInputSchema>
 
 export const submitRefundSignatureInputSchema = z.object({
   id: idSchema,
   refundTxHash: evmTxHashSchema,
 })
-export type SubmitRefundSignatureInput = z.infer<typeof submitRefundSignatureInputSchema>
+export type SubmitRefundSignatureInput = z.input<typeof submitRefundSignatureInputSchema>
+export type SubmitRefundSignatureParsed = z.output<typeof submitRefundSignatureInputSchema>
 
 /**
  * Response envelope for `POST /v1/refunds`. The API returns the newly

package/src/storefronts.ts

@@ -47,7 +47,8 @@ export const createStorefrontInputSchema = storefrontSchema.pick({
   accentColor: true,
   socialLinks: true,
 })
-export type CreateStorefrontInput = z.infer<typeof createStorefrontInputSchema>
+export type CreateStorefrontInput = z.input<typeof createStorefrontInputSchema>
+export type CreateStorefrontParsed = z.output<typeof createStorefrontInputSchema>
 
 // ---------- Products ----------
 
@@ -103,7 +104,8 @@ export const createStorefrontProductInputSchema = storefrontProductSchema
       })
     }
   })
-export type CreateStorefrontProductInput = z.infer<typeof createStorefrontProductInputSchema>
+export type CreateStorefrontProductInput = z.input<typeof createStorefrontProductInputSchema>
+export type CreateStorefrontProductParsed = z.output<typeof createStorefrontProductInputSchema>
 
 /**
  * Payload for the public `/store/:slug/products/:id/checkout` endpoint.
@@ -116,7 +118,8 @@ export const storefrontCheckoutInputSchema = z.object({
   customerEmail: z.string().email().optional(),
   returnPath: z.string().max(200).optional(),
 })
-export type StorefrontCheckoutInput = z.infer<typeof storefrontCheckoutInputSchema>
+export type StorefrontCheckoutInput = z.input<typeof storefrontCheckoutInputSchema>
+export type StorefrontCheckoutParsed = z.output<typeof storefrontCheckoutInputSchema>
 
 /** Response shape from the public product-checkout endpoint. */
 export const storefrontCheckoutResponseSchema = z.object({

package/src/subscriptions.ts

@@ -81,7 +81,8 @@ export const createSubscriptionPlanInputSchema = z.object({
   trialPeriodDays: z.number().int().min(0).max(365).optional(),
   metadata: metadataSchema.optional(),
 })
-export type CreateSubscriptionPlanInput = z.infer<typeof createSubscriptionPlanInputSchema>
+export type CreateSubscriptionPlanInput = z.input<typeof createSubscriptionPlanInputSchema>
+export type CreateSubscriptionPlanParsed = z.output<typeof createSubscriptionPlanInputSchema>
 
 // ---------- Subscriptions ----------
 
@@ -143,13 +144,15 @@ export const createSubscriptionInputSchema = z.object({
   gracePeriodHours: z.union([z.literal(24), z.literal(48), z.literal(72)]).default(48),
   metadata: metadataSchema.optional(),
 })
-export type CreateSubscriptionInput = z.infer<typeof createSubscriptionInputSchema>
+export type CreateSubscriptionInput = z.input<typeof createSubscriptionInputSchema>
+export type CreateSubscriptionParsed = z.output<typeof createSubscriptionInputSchema>
 
 export const cancelSubscriptionInputSchema = z.object({
   id: idSchema,
   reason: z.string().max(500).optional(),
 })
-export type CancelSubscriptionInput = z.infer<typeof cancelSubscriptionInputSchema>
+export type CancelSubscriptionInput = z.input<typeof cancelSubscriptionInputSchema>
+export type CancelSubscriptionParsed = z.output<typeof cancelSubscriptionInputSchema>
 
 // ---------- Charges ----------
 

package/src/webhooks.ts

@@ -67,7 +67,8 @@ export const createWebhookEndpointInputSchema = z.object({
   description: z.string().max(200).optional(),
   mode: modeSchema,
 })
-export type CreateWebhookEndpointInput = z.infer<typeof createWebhookEndpointInputSchema>
+export type CreateWebhookEndpointInput = z.input<typeof createWebhookEndpointInputSchema>
+export type CreateWebhookEndpointParsed = z.output<typeof createWebhookEndpointInputSchema>
 
 export const createWebhookEndpointOutputSchema = z.object({
   endpoint: webhookEndpointSchema,
@@ -118,4 +119,5 @@ export type WebhookDeliveryDetail = z.infer<typeof webhookDeliveryDetailSchema>
 export const replayDeliveryInputSchema = z.object({
   id: idSchema,
 })
-export type ReplayDeliveryInput = z.infer<typeof replayDeliveryInputSchema>
+export type ReplayDeliveryInput = z.input<typeof replayDeliveryInputSchema>
+export type ReplayDeliveryParsed = z.output<typeof replayDeliveryInputSchema>