@strimz/shared-types 0.1.0

package/dist/webhooks.d.ts

@@ -0,0 +1,201 @@
+import { z } from 'zod';
+
+/**
+ * Webhook endpoints and deliveries.
+ *
+ * Endpoint = the URL the merchant registered.
+ * Event    = the thing that happened.
+ * Delivery = one attempt to POST a specific event to a specific endpoint.
+ */
+
+/**
+ * Every webhook event name in the system. Listed here (not imported from
+ * `@strimz/shared-config`) so Zod can produce a concrete string union.
+ */
+declare const webhookEventNameSchema: z.ZodEnum<["payment.created", "payment.completed", "payment.failed", "subscription.created", "subscription.charged", "subscription.charge_failed", "subscription.recovery_attempt", "subscription.recovery_outcome", "subscription.cancelled", "subscription.lapsed", "refund.created", "refund.completed", "refund.failed", "invoice.created", "invoice.paid", "invoice.overdue", "agent.action_executed", "agent.job_proposed", "agent.job_completed", "agent.job_disputed", "compliance.wallet_flagged", "compliance.wallet_blocked"]>;
+type WebhookEventName = z.infer<typeof webhookEventNameSchema>;
+declare const webhookEndpointStatusSchema: z.ZodEnum<["active", "disabled"]>;
+type WebhookEndpointStatus = z.infer<typeof webhookEndpointStatusSchema>;
+declare const webhookEndpointSchema: z.ZodObject<{
+    id: z.ZodString;
+    merchantId: z.ZodString;
+    mode: z.ZodEnum<["test", "live"]>;
+    url: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodNullable<z.ZodString>;
+    events: z.ZodArray<z.ZodEnum<["payment.created", "payment.completed", "payment.failed", "subscription.created", "subscription.charged", "subscription.charge_failed", "subscription.recovery_attempt", "subscription.recovery_outcome", "subscription.cancelled", "subscription.lapsed", "refund.created", "refund.completed", "refund.failed", "invoice.created", "invoice.paid", "invoice.overdue", "agent.action_executed", "agent.job_proposed", "agent.job_completed", "agent.job_disputed", "compliance.wallet_flagged", "compliance.wallet_blocked"]>, "atleastone">;
+    status: z.ZodEnum<["active", "disabled"]>;
+    signingSecretPrefix: z.ZodString;
+    lastDeliveredAt: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "disabled" | "active";
+    id: string;
+    merchantId: string;
+    mode: "test" | "live";
+    createdAt: string;
+    description: string | null;
+    updatedAt: string;
+    url: string;
+    events: ["payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked", ...("payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked")[]];
+    signingSecretPrefix: string;
+    lastDeliveredAt: string | null;
+}, {
+    status: "disabled" | "active";
+    id: string;
+    merchantId: string;
+    mode: "test" | "live";
+    createdAt: string;
+    description: string | null;
+    updatedAt: string;
+    url: string;
+    events: ["payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked", ...("payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked")[]];
+    signingSecretPrefix: string;
+    lastDeliveredAt: string | null;
+}>;
+type WebhookEndpoint = z.infer<typeof webhookEndpointSchema>;
+declare const createWebhookEndpointInputSchema: z.ZodObject<{
+    url: z.ZodEffects<z.ZodString, string, string>;
+    events: z.ZodArray<z.ZodEnum<["payment.created", "payment.completed", "payment.failed", "subscription.created", "subscription.charged", "subscription.charge_failed", "subscription.recovery_attempt", "subscription.recovery_outcome", "subscription.cancelled", "subscription.lapsed", "refund.created", "refund.completed", "refund.failed", "invoice.created", "invoice.paid", "invoice.overdue", "agent.action_executed", "agent.job_proposed", "agent.job_completed", "agent.job_disputed", "compliance.wallet_flagged", "compliance.wallet_blocked"]>, "atleastone">;
+    description: z.ZodOptional<z.ZodString>;
+    mode: z.ZodEnum<["test", "live"]>;
+}, "strip", z.ZodTypeAny, {
+    mode: "test" | "live";
+    url: string;
+    events: ["payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked", ...("payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked")[]];
+    description?: string | undefined;
+}, {
+    mode: "test" | "live";
+    url: string;
+    events: ["payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked", ...("payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked")[]];
+    description?: string | undefined;
+}>;
+type CreateWebhookEndpointInput = z.infer<typeof createWebhookEndpointInputSchema>;
+declare const createWebhookEndpointOutputSchema: z.ZodObject<{
+    endpoint: z.ZodObject<{
+        id: z.ZodString;
+        merchantId: z.ZodString;
+        mode: z.ZodEnum<["test", "live"]>;
+        url: z.ZodEffects<z.ZodString, string, string>;
+        description: z.ZodNullable<z.ZodString>;
+        events: z.ZodArray<z.ZodEnum<["payment.created", "payment.completed", "payment.failed", "subscription.created", "subscription.charged", "subscription.charge_failed", "subscription.recovery_attempt", "subscription.recovery_outcome", "subscription.cancelled", "subscription.lapsed", "refund.created", "refund.completed", "refund.failed", "invoice.created", "invoice.paid", "invoice.overdue", "agent.action_executed", "agent.job_proposed", "agent.job_completed", "agent.job_disputed", "compliance.wallet_flagged", "compliance.wallet_blocked"]>, "atleastone">;
+        status: z.ZodEnum<["active", "disabled"]>;
+        signingSecretPrefix: z.ZodString;
+        lastDeliveredAt: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "disabled" | "active";
+        id: string;
+        merchantId: string;
+        mode: "test" | "live";
+        createdAt: string;
+        description: string | null;
+        updatedAt: string;
+        url: string;
+        events: ["payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked", ...("payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked")[]];
+        signingSecretPrefix: string;
+        lastDeliveredAt: string | null;
+    }, {
+        status: "disabled" | "active";
+        id: string;
+        merchantId: string;
+        mode: "test" | "live";
+        createdAt: string;
+        description: string | null;
+        updatedAt: string;
+        url: string;
+        events: ["payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked", ...("payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked")[]];
+        signingSecretPrefix: string;
+        lastDeliveredAt: string | null;
+    }>;
+    /** Full signing secret — shown exactly once. */
+    signingSecret: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    endpoint: {
+        status: "disabled" | "active";
+        id: string;
+        merchantId: string;
+        mode: "test" | "live";
+        createdAt: string;
+        description: string | null;
+        updatedAt: string;
+        url: string;
+        events: ["payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked", ...("payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked")[]];
+        signingSecretPrefix: string;
+        lastDeliveredAt: string | null;
+    };
+    signingSecret: string;
+}, {
+    endpoint: {
+        status: "disabled" | "active";
+        id: string;
+        merchantId: string;
+        mode: "test" | "live";
+        createdAt: string;
+        description: string | null;
+        updatedAt: string;
+        url: string;
+        events: ["payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked", ...("payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked")[]];
+        signingSecretPrefix: string;
+        lastDeliveredAt: string | null;
+    };
+    signingSecret: string;
+}>;
+type CreateWebhookEndpointOutput = z.infer<typeof createWebhookEndpointOutputSchema>;
+declare const webhookDeliveryStatusSchema: z.ZodEnum<["pending", "delivered", "retrying", "permanently_failed"]>;
+type WebhookDeliveryStatus = z.infer<typeof webhookDeliveryStatusSchema>;
+declare const webhookDeliverySchema: z.ZodObject<{
+    id: z.ZodString;
+    merchantId: z.ZodString;
+    endpointId: z.ZodString;
+    eventId: z.ZodString;
+    eventName: z.ZodEnum<["payment.created", "payment.completed", "payment.failed", "subscription.created", "subscription.charged", "subscription.charge_failed", "subscription.recovery_attempt", "subscription.recovery_outcome", "subscription.cancelled", "subscription.lapsed", "refund.created", "refund.completed", "refund.failed", "invoice.created", "invoice.paid", "invoice.overdue", "agent.action_executed", "agent.job_proposed", "agent.job_completed", "agent.job_disputed", "compliance.wallet_flagged", "compliance.wallet_blocked"]>;
+    status: z.ZodEnum<["pending", "delivered", "retrying", "permanently_failed"]>;
+    attempt: z.ZodNumber;
+    responseCode: z.ZodNullable<z.ZodNumber>;
+    responseMs: z.ZodNullable<z.ZodNumber>;
+    lastError: z.ZodNullable<z.ZodString>;
+    nextAttemptAt: z.ZodNullable<z.ZodString>;
+    deliveredAt: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "retrying" | "delivered" | "permanently_failed";
+    id: string;
+    merchantId: string;
+    createdAt: string;
+    endpointId: string;
+    eventId: string;
+    eventName: "payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked";
+    attempt: number;
+    responseCode: number | null;
+    responseMs: number | null;
+    lastError: string | null;
+    nextAttemptAt: string | null;
+    deliveredAt: string | null;
+}, {
+    status: "pending" | "retrying" | "delivered" | "permanently_failed";
+    id: string;
+    merchantId: string;
+    createdAt: string;
+    endpointId: string;
+    eventId: string;
+    eventName: "payment.created" | "payment.completed" | "payment.failed" | "subscription.created" | "subscription.charged" | "subscription.charge_failed" | "subscription.recovery_attempt" | "subscription.recovery_outcome" | "subscription.cancelled" | "subscription.lapsed" | "refund.created" | "refund.completed" | "refund.failed" | "invoice.created" | "invoice.paid" | "invoice.overdue" | "agent.action_executed" | "agent.job_proposed" | "agent.job_completed" | "agent.job_disputed" | "compliance.wallet_flagged" | "compliance.wallet_blocked";
+    attempt: number;
+    responseCode: number | null;
+    responseMs: number | null;
+    lastError: string | null;
+    nextAttemptAt: string | null;
+    deliveredAt: string | null;
+}>;
+type WebhookDelivery = z.infer<typeof webhookDeliverySchema>;
+declare const replayDeliveryInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+type ReplayDeliveryInput = z.infer<typeof replayDeliveryInputSchema>;
+
+export { type CreateWebhookEndpointInput, type CreateWebhookEndpointOutput, type ReplayDeliveryInput, type WebhookDelivery, type WebhookDeliveryStatus, type WebhookEndpoint, type WebhookEndpointStatus, type WebhookEventName, createWebhookEndpointInputSchema, createWebhookEndpointOutputSchema, replayDeliveryInputSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEndpointSchema, webhookEndpointStatusSchema, webhookEventNameSchema };

package/dist/webhooks.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+
+// src/webhooks.ts
+var idSchema = z.string().min(1).max(64).regex(/^[a-zA-Z0-9_-]+$/, "id must be URL-safe");
+z.string().regex(/^0x[a-fA-F0-9]{40}$/, "must be a 0x-prefixed 40-character hex EVM address").transform((v) => v.toLowerCase());
+z.string().regex(/^0x[a-fA-F0-9]{64}$/, "must be a 0x-prefixed 64-character hex EVM transaction hash");
+z.string().email().trim().toLowerCase().max(320);
+var httpsUrlSchema = z.string().url().refine((v) => v.startsWith("https://"), {
+  message: "must be an https:// URL"
+});
+z.string().url();
+z.string().regex(/^[0-9]+$/, "must be a non-negative integer string (base-10)").refine((v) => BigInt(v) >= 0n, "must be >= 0");
+z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
+var isoTimestampSchema = z.string().datetime({ offset: true, message: "must be an ISO-8601 timestamp" });
+z.string().length(2).regex(/^[A-Z]{2}$/, "must be an ISO-3166 alpha-2 country code");
+z.object({
+  limit: z.number().int().min(1).max(100).default(25),
+  cursor: z.string().min(1).max(200).nullish()
+});
+z.record(
+  z.string().min(1).max(40),
+  z.union([z.string().max(500), z.number(), z.boolean(), z.null()])
+).refine((m) => Object.keys(m).length <= 50, "at most 50 metadata keys").default({});
+var modeSchema = z.enum(["test", "live"]);
+z.enum(["USDC", "EURC"]);
+z.enum(["USDC", "EURC", "USYC"]);
+z.enum(["free", "growth", "business", "enterprise"]);
+z.enum(["testnet", "mainnet"]);
+
+// src/webhooks.ts
+var webhookEventNameSchema = z.enum([
+  "payment.created",
+  "payment.completed",
+  "payment.failed",
+  "subscription.created",
+  "subscription.charged",
+  "subscription.charge_failed",
+  "subscription.recovery_attempt",
+  "subscription.recovery_outcome",
+  "subscription.cancelled",
+  "subscription.lapsed",
+  "refund.created",
+  "refund.completed",
+  "refund.failed",
+  "invoice.created",
+  "invoice.paid",
+  "invoice.overdue",
+  "agent.action_executed",
+  "agent.job_proposed",
+  "agent.job_completed",
+  "agent.job_disputed",
+  "compliance.wallet_flagged",
+  "compliance.wallet_blocked"
+]);
+var webhookEndpointStatusSchema = z.enum(["active", "disabled"]);
+var webhookEndpointSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  mode: modeSchema,
+  url: httpsUrlSchema,
+  description: z.string().max(200).nullable(),
+  events: z.array(webhookEventNameSchema).nonempty(),
+  status: webhookEndpointStatusSchema,
+  signingSecretPrefix: z.string().min(4).max(12),
+  lastDeliveredAt: isoTimestampSchema.nullable(),
+  createdAt: isoTimestampSchema,
+  updatedAt: isoTimestampSchema
+});
+var createWebhookEndpointInputSchema = z.object({
+  url: httpsUrlSchema,
+  events: z.array(webhookEventNameSchema).nonempty(),
+  description: z.string().max(200).optional(),
+  mode: modeSchema
+});
+var createWebhookEndpointOutputSchema = z.object({
+  endpoint: webhookEndpointSchema,
+  /** Full signing secret — shown exactly once. */
+  signingSecret: z.string()
+});
+var webhookDeliveryStatusSchema = z.enum([
+  "pending",
+  "delivered",
+  "retrying",
+  "permanently_failed"
+]);
+var webhookDeliverySchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  endpointId: idSchema,
+  eventId: idSchema,
+  eventName: webhookEventNameSchema,
+  status: webhookDeliveryStatusSchema,
+  attempt: z.number().int().min(1).max(6),
+  responseCode: z.number().int().min(100).max(599).nullable(),
+  responseMs: z.number().int().min(0).nullable(),
+  lastError: z.string().max(1e3).nullable(),
+  nextAttemptAt: isoTimestampSchema.nullable(),
+  deliveredAt: isoTimestampSchema.nullable(),
+  createdAt: isoTimestampSchema
+});
+var replayDeliveryInputSchema = z.object({
+  id: idSchema
+});
+
+export { createWebhookEndpointInputSchema, createWebhookEndpointOutputSchema, replayDeliveryInputSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEndpointSchema, webhookEndpointStatusSchema, webhookEventNameSchema };
+//# sourceMappingURL=webhooks.js.map
+//# sourceMappingURL=webhooks.js.map

package/dist/webhooks.js.map

@@ -0,0 +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 — mirrors `@strimz/shared-config`. */\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 — mirrors `@strimz/shared-config`. */\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 here (not imported from\n * `@strimz/shared-config`) so Zod can 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\nexport const replayDeliveryInputSchema = z.object({\n  id: idSchema,\n})\nexport type ReplayDeliveryInput = z.infer<typeof replayDeliveryInputSchema>\n"]}

package/package.json

@@ -0,0 +1,134 @@
+{
+  "name": "@strimz/shared-types",
+  "version": "0.1.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>",
+  "homepage": "https://github.com/StrimzLab/strimz/tree/main/packages/shared-types#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/StrimzLab/strimz.git",
+    "directory": "packages/shared-types"
+  },
+  "bugs": {
+    "url": "https://github.com/StrimzLab/strimz/issues"
+  },
+  "keywords": [
+    "strimz",
+    "zod",
+    "types",
+    "schemas",
+    "billing"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./common": {
+      "types": "./dist/common.d.ts",
+      "import": "./dist/common.js",
+      "require": "./dist/common.cjs"
+    },
+    "./merchants": {
+      "types": "./dist/merchants.d.ts",
+      "import": "./dist/merchants.js",
+      "require": "./dist/merchants.cjs"
+    },
+    "./api-keys": {
+      "types": "./dist/api-keys.d.ts",
+      "import": "./dist/api-keys.js",
+      "require": "./dist/api-keys.cjs"
+    },
+    "./customers": {
+      "types": "./dist/customers.d.ts",
+      "import": "./dist/customers.js",
+      "require": "./dist/customers.cjs"
+    },
+    "./payment-sessions": {
+      "types": "./dist/payment-sessions.d.ts",
+      "import": "./dist/payment-sessions.js",
+      "require": "./dist/payment-sessions.cjs"
+    },
+    "./transactions": {
+      "types": "./dist/transactions.d.ts",
+      "import": "./dist/transactions.js",
+      "require": "./dist/transactions.cjs"
+    },
+    "./subscriptions": {
+      "types": "./dist/subscriptions.d.ts",
+      "import": "./dist/subscriptions.js",
+      "require": "./dist/subscriptions.cjs"
+    },
+    "./refunds": {
+      "types": "./dist/refunds.d.ts",
+      "import": "./dist/refunds.js",
+      "require": "./dist/refunds.cjs"
+    },
+    "./webhooks": {
+      "types": "./dist/webhooks.d.ts",
+      "import": "./dist/webhooks.js",
+      "require": "./dist/webhooks.cjs"
+    },
+    "./compliance": {
+      "types": "./dist/compliance.d.ts",
+      "import": "./dist/compliance.js",
+      "require": "./dist/compliance.cjs"
+    },
+    "./agents": {
+      "types": "./dist/agents.d.ts",
+      "import": "./dist/agents.js",
+      "require": "./dist/agents.cjs"
+    },
+    "./storefronts": {
+      "types": "./dist/storefronts.d.ts",
+      "import": "./dist/storefronts.js",
+      "require": "./dist/storefronts.cjs"
+    },
+    "./invoices": {
+      "types": "./dist/invoices.d.ts",
+      "import": "./dist/invoices.js",
+      "require": "./dist/invoices.cjs"
+    },
+    "./events": {
+      "types": "./dist/events.d.ts",
+      "import": "./dist/events.js",
+      "require": "./dist/events.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "zod": "^3.24.1",
+    "@strimz/shared-config": "0.1.0"
+  },
+  "devDependencies": {
+    "eslint": "^9.18.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8",
+    "@strimz/eslint-config": "0.0.0",
+    "@strimz/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo"
+  }
+}

package/src/agents.ts

@@ -0,0 +1,149 @@
+/**
+ * AI AutoPay Agent — identity, configuration, activity log, and ERC-8183 jobs.
+ */
+
+import { z } from 'zod'
+import {
+  evmAddressSchema,
+  evmTxHashSchema,
+  idSchema,
+  isoTimestampSchema,
+  metadataSchema,
+  tokenAmountSchema,
+} from './common.js'
+
+// ---------- Identity ----------
+
+export const agentIdentitySchema = z.object({
+  id: idSchema,
+  /** ERC-8004 on-chain identity address. */
+  onchainAddress: evmAddressSchema,
+  /** Public key or agent credential digest, as emitted by ERC-8004. */
+  credentialDigest: z.string().regex(/^0x[a-fA-F0-9]+$/),
+  name: z.string().min(1).max(120),
+  version: z.string().min(1).max(40),
+  reputationScore: z.number().min(0).max(100).nullable(),
+  registeredAt: isoTimestampSchema,
+})
+export type AgentIdentity = z.infer<typeof agentIdentitySchema>
+
+// ---------- Merchant config ----------
+
+export const agentCapabilitySchema = z.enum([
+  'identity',
+  'recovery',
+  'routing',
+  'cashflow',
+  'commerce',
+  'pricing_intelligence',
+])
+export type AgentCapability = z.infer<typeof agentCapabilitySchema>
+
+export const agentMerchantConfigSchema = z.object({
+  merchantId: idSchema,
+  enabledCapabilities: z.array(agentCapabilitySchema).default([]),
+  recovery: z.object({
+    gracePeriodHours: z.union([z.literal(24), z.literal(48), z.literal(72)]).default(48),
+    strategy: z.enum(['once', 'twice', 'until_grace_ends']).default('twice'),
+    notificationTemplate: z.string().max(2000).nullable(),
+  }),
+  cashflow: z.object({
+    digestEnabled: z.boolean().default(false),
+    anomalySensitivity: z.enum(['low', 'medium', 'high']).default('medium'),
+    autoConvertToYield: z.boolean().default(false),
+    minimumLiquidReserveCents: z.number().int().nonnegative().default(100_000),
+  }),
+  commerce: z.object({
+    requireHumanApprovalAboveUsdCents: z.number().int().nonnegative().default(100_000),
+    approvedVendors: z.array(evmAddressSchema).default([]),
+    monthlySpendCapUsdCents: z.number().int().nonnegative().nullable(),
+  }),
+  updatedAt: isoTimestampSchema,
+})
+export type AgentMerchantConfig = z.infer<typeof agentMerchantConfigSchema>
+
+export const updateAgentConfigInputSchema = agentMerchantConfigSchema
+  .omit({ merchantId: true, updatedAt: true })
+  .partial()
+export type UpdateAgentConfigInput = z.infer<typeof updateAgentConfigInputSchema>
+
+// ---------- Activity log ----------
+
+export const agentActionTypeSchema = z.enum([
+  'recovery_notification_sent',
+  'recovery_retry_scheduled',
+  'recovery_retry_executed',
+  'recovery_abandoned',
+  'routing_bridge_initiated',
+  'routing_payment_completed',
+  'cashflow_digest_sent',
+  'cashflow_anomaly_flagged',
+  'cashflow_yield_converted',
+  'commerce_job_created',
+  'commerce_job_approved',
+  'commerce_job_completed',
+  'commerce_job_disputed',
+])
+export type AgentActionType = z.infer<typeof agentActionTypeSchema>
+
+export const agentActionOutcomeSchema = z.enum(['success', 'failure', 'pending', 'skipped'])
+export type AgentActionOutcome = z.infer<typeof agentActionOutcomeSchema>
+
+export const agentActivityLogSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  capability: agentCapabilitySchema,
+  actionType: agentActionTypeSchema,
+  outcome: agentActionOutcomeSchema,
+  subscriptionId: idSchema.nullable(),
+  transactionId: idSchema.nullable(),
+  jobId: idSchema.nullable(),
+  metadata: metadataSchema,
+  createdAt: isoTimestampSchema,
+})
+export type AgentActivityLog = z.infer<typeof agentActivityLogSchema>
+
+// ---------- ERC-8183 jobs ----------
+
+export const agentJobStatusSchema = z.enum([
+  'proposed',
+  'accepted',
+  'in_progress',
+  'delivered',
+  'approved',
+  'completed',
+  'disputed',
+  'cancelled',
+])
+export type AgentJobStatus = z.infer<typeof agentJobStatusSchema>
+
+export const agentJobSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  /** On-chain job id from StrimzAgentEscrow. */
+  onchainJobId: z.number().int().nonnegative().nullable(),
+  vendorAddress: evmAddressSchema,
+  description: z.string().min(1).max(2000),
+  amount: tokenAmountSchema,
+  currency: z.enum(['USDC', 'EURC']),
+  status: agentJobStatusSchema,
+  assessorAddress: evmAddressSchema,
+  deliverableHash: z
+    .string()
+    .regex(/^0x[a-fA-F0-9]+$/)
+    .nullable(),
+  escrowTxHash: evmTxHashSchema.nullable(),
+  releaseTxHash: evmTxHashSchema.nullable(),
+  createdAt: isoTimestampSchema,
+  completedAt: isoTimestampSchema.nullable(),
+})
+export type AgentJob = z.infer<typeof agentJobSchema>
+
+export const createAgentJobInputSchema = z.object({
+  vendorAddress: evmAddressSchema,
+  description: z.string().min(1).max(2000),
+  amount: tokenAmountSchema,
+  currency: z.enum(['USDC', 'EURC']),
+  assessorAddress: evmAddressSchema.optional(),
+})
+export type CreateAgentJobInput = z.infer<typeof createAgentJobInputSchema>