@strimz/shared-types 0.1.0

package/dist/agents.d.ts

@@ -0,0 +1,317 @@
+import { z } from 'zod';
+
+/**
+ * AI AutoPay Agent — identity, configuration, activity log, and ERC-8183 jobs.
+ */
+
+declare const agentIdentitySchema: z.ZodObject<{
+    id: z.ZodString;
+    /** ERC-8004 on-chain identity address. */
+    onchainAddress: z.ZodEffects<z.ZodString, string, string>;
+    /** Public key or agent credential digest, as emitted by ERC-8004. */
+    credentialDigest: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    reputationScore: z.ZodNullable<z.ZodNumber>;
+    registeredAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    onchainAddress: string;
+    credentialDigest: string;
+    name: string;
+    version: string;
+    reputationScore: number | null;
+    registeredAt: string;
+}, {
+    id: string;
+    onchainAddress: string;
+    credentialDigest: string;
+    name: string;
+    version: string;
+    reputationScore: number | null;
+    registeredAt: string;
+}>;
+type AgentIdentity = z.infer<typeof agentIdentitySchema>;
+declare const agentCapabilitySchema: z.ZodEnum<["identity", "recovery", "routing", "cashflow", "commerce", "pricing_intelligence"]>;
+type AgentCapability = z.infer<typeof agentCapabilitySchema>;
+declare const agentMerchantConfigSchema: z.ZodObject<{
+    merchantId: z.ZodString;
+    enabledCapabilities: z.ZodDefault<z.ZodArray<z.ZodEnum<["identity", "recovery", "routing", "cashflow", "commerce", "pricing_intelligence"]>, "many">>;
+    recovery: z.ZodObject<{
+        gracePeriodHours: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<24>, z.ZodLiteral<48>, z.ZodLiteral<72>]>>;
+        strategy: z.ZodDefault<z.ZodEnum<["once", "twice", "until_grace_ends"]>>;
+        notificationTemplate: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        gracePeriodHours: 24 | 48 | 72;
+        strategy: "once" | "twice" | "until_grace_ends";
+        notificationTemplate: string | null;
+    }, {
+        notificationTemplate: string | null;
+        gracePeriodHours?: 24 | 48 | 72 | undefined;
+        strategy?: "once" | "twice" | "until_grace_ends" | undefined;
+    }>;
+    cashflow: z.ZodObject<{
+        digestEnabled: z.ZodDefault<z.ZodBoolean>;
+        anomalySensitivity: z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>;
+        autoConvertToYield: z.ZodDefault<z.ZodBoolean>;
+        minimumLiquidReserveCents: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        digestEnabled: boolean;
+        anomalySensitivity: "low" | "medium" | "high";
+        autoConvertToYield: boolean;
+        minimumLiquidReserveCents: number;
+    }, {
+        digestEnabled?: boolean | undefined;
+        anomalySensitivity?: "low" | "medium" | "high" | undefined;
+        autoConvertToYield?: boolean | undefined;
+        minimumLiquidReserveCents?: number | undefined;
+    }>;
+    commerce: z.ZodObject<{
+        requireHumanApprovalAboveUsdCents: z.ZodDefault<z.ZodNumber>;
+        approvedVendors: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        monthlySpendCapUsdCents: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        requireHumanApprovalAboveUsdCents: number;
+        approvedVendors: string[];
+        monthlySpendCapUsdCents: number | null;
+    }, {
+        monthlySpendCapUsdCents: number | null;
+        requireHumanApprovalAboveUsdCents?: number | undefined;
+        approvedVendors?: string[] | undefined;
+    }>;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    recovery: {
+        gracePeriodHours: 24 | 48 | 72;
+        strategy: "once" | "twice" | "until_grace_ends";
+        notificationTemplate: string | null;
+    };
+    cashflow: {
+        digestEnabled: boolean;
+        anomalySensitivity: "low" | "medium" | "high";
+        autoConvertToYield: boolean;
+        minimumLiquidReserveCents: number;
+    };
+    commerce: {
+        requireHumanApprovalAboveUsdCents: number;
+        approvedVendors: string[];
+        monthlySpendCapUsdCents: number | null;
+    };
+    merchantId: string;
+    enabledCapabilities: ("identity" | "recovery" | "routing" | "cashflow" | "commerce" | "pricing_intelligence")[];
+    updatedAt: string;
+}, {
+    recovery: {
+        notificationTemplate: string | null;
+        gracePeriodHours?: 24 | 48 | 72 | undefined;
+        strategy?: "once" | "twice" | "until_grace_ends" | undefined;
+    };
+    cashflow: {
+        digestEnabled?: boolean | undefined;
+        anomalySensitivity?: "low" | "medium" | "high" | undefined;
+        autoConvertToYield?: boolean | undefined;
+        minimumLiquidReserveCents?: number | undefined;
+    };
+    commerce: {
+        monthlySpendCapUsdCents: number | null;
+        requireHumanApprovalAboveUsdCents?: number | undefined;
+        approvedVendors?: string[] | undefined;
+    };
+    merchantId: string;
+    updatedAt: string;
+    enabledCapabilities?: ("identity" | "recovery" | "routing" | "cashflow" | "commerce" | "pricing_intelligence")[] | undefined;
+}>;
+type AgentMerchantConfig = z.infer<typeof agentMerchantConfigSchema>;
+declare const updateAgentConfigInputSchema: z.ZodObject<{
+    recovery: z.ZodOptional<z.ZodObject<{
+        gracePeriodHours: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<24>, z.ZodLiteral<48>, z.ZodLiteral<72>]>>;
+        strategy: z.ZodDefault<z.ZodEnum<["once", "twice", "until_grace_ends"]>>;
+        notificationTemplate: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        gracePeriodHours: 24 | 48 | 72;
+        strategy: "once" | "twice" | "until_grace_ends";
+        notificationTemplate: string | null;
+    }, {
+        notificationTemplate: string | null;
+        gracePeriodHours?: 24 | 48 | 72 | undefined;
+        strategy?: "once" | "twice" | "until_grace_ends" | undefined;
+    }>>;
+    cashflow: z.ZodOptional<z.ZodObject<{
+        digestEnabled: z.ZodDefault<z.ZodBoolean>;
+        anomalySensitivity: z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>;
+        autoConvertToYield: z.ZodDefault<z.ZodBoolean>;
+        minimumLiquidReserveCents: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        digestEnabled: boolean;
+        anomalySensitivity: "low" | "medium" | "high";
+        autoConvertToYield: boolean;
+        minimumLiquidReserveCents: number;
+    }, {
+        digestEnabled?: boolean | undefined;
+        anomalySensitivity?: "low" | "medium" | "high" | undefined;
+        autoConvertToYield?: boolean | undefined;
+        minimumLiquidReserveCents?: number | undefined;
+    }>>;
+    commerce: z.ZodOptional<z.ZodObject<{
+        requireHumanApprovalAboveUsdCents: z.ZodDefault<z.ZodNumber>;
+        approvedVendors: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        monthlySpendCapUsdCents: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        requireHumanApprovalAboveUsdCents: number;
+        approvedVendors: string[];
+        monthlySpendCapUsdCents: number | null;
+    }, {
+        monthlySpendCapUsdCents: number | null;
+        requireHumanApprovalAboveUsdCents?: number | undefined;
+        approvedVendors?: string[] | undefined;
+    }>>;
+    enabledCapabilities: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodEnum<["identity", "recovery", "routing", "cashflow", "commerce", "pricing_intelligence"]>, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    recovery?: {
+        gracePeriodHours: 24 | 48 | 72;
+        strategy: "once" | "twice" | "until_grace_ends";
+        notificationTemplate: string | null;
+    } | undefined;
+    cashflow?: {
+        digestEnabled: boolean;
+        anomalySensitivity: "low" | "medium" | "high";
+        autoConvertToYield: boolean;
+        minimumLiquidReserveCents: number;
+    } | undefined;
+    commerce?: {
+        requireHumanApprovalAboveUsdCents: number;
+        approvedVendors: string[];
+        monthlySpendCapUsdCents: number | null;
+    } | undefined;
+    enabledCapabilities?: ("identity" | "recovery" | "routing" | "cashflow" | "commerce" | "pricing_intelligence")[] | undefined;
+}, {
+    recovery?: {
+        notificationTemplate: string | null;
+        gracePeriodHours?: 24 | 48 | 72 | undefined;
+        strategy?: "once" | "twice" | "until_grace_ends" | undefined;
+    } | undefined;
+    cashflow?: {
+        digestEnabled?: boolean | undefined;
+        anomalySensitivity?: "low" | "medium" | "high" | undefined;
+        autoConvertToYield?: boolean | undefined;
+        minimumLiquidReserveCents?: number | undefined;
+    } | undefined;
+    commerce?: {
+        monthlySpendCapUsdCents: number | null;
+        requireHumanApprovalAboveUsdCents?: number | undefined;
+        approvedVendors?: string[] | undefined;
+    } | undefined;
+    enabledCapabilities?: ("identity" | "recovery" | "routing" | "cashflow" | "commerce" | "pricing_intelligence")[] | undefined;
+}>;
+type UpdateAgentConfigInput = z.infer<typeof updateAgentConfigInputSchema>;
+declare const agentActionTypeSchema: z.ZodEnum<["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"]>;
+type AgentActionType = z.infer<typeof agentActionTypeSchema>;
+declare const agentActionOutcomeSchema: z.ZodEnum<["success", "failure", "pending", "skipped"]>;
+type AgentActionOutcome = z.infer<typeof agentActionOutcomeSchema>;
+declare const agentActivityLogSchema: z.ZodObject<{
+    id: z.ZodString;
+    merchantId: z.ZodString;
+    capability: z.ZodEnum<["identity", "recovery", "routing", "cashflow", "commerce", "pricing_intelligence"]>;
+    actionType: z.ZodEnum<["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"]>;
+    outcome: z.ZodEnum<["success", "failure", "pending", "skipped"]>;
+    subscriptionId: z.ZodNullable<z.ZodString>;
+    transactionId: z.ZodNullable<z.ZodString>;
+    jobId: z.ZodNullable<z.ZodString>;
+    metadata: z.ZodDefault<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, Record<string, string | number | boolean | null>, Record<string, string | number | boolean | null>>>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    merchantId: string;
+    capability: "identity" | "recovery" | "routing" | "cashflow" | "commerce" | "pricing_intelligence";
+    actionType: "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";
+    outcome: "success" | "failure" | "pending" | "skipped";
+    subscriptionId: string | null;
+    transactionId: string | null;
+    jobId: string | null;
+    metadata: Record<string, string | number | boolean | null>;
+    createdAt: string;
+}, {
+    id: string;
+    merchantId: string;
+    capability: "identity" | "recovery" | "routing" | "cashflow" | "commerce" | "pricing_intelligence";
+    actionType: "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";
+    outcome: "success" | "failure" | "pending" | "skipped";
+    subscriptionId: string | null;
+    transactionId: string | null;
+    jobId: string | null;
+    createdAt: string;
+    metadata?: Record<string, string | number | boolean | null> | undefined;
+}>;
+type AgentActivityLog = z.infer<typeof agentActivityLogSchema>;
+declare const agentJobStatusSchema: z.ZodEnum<["proposed", "accepted", "in_progress", "delivered", "approved", "completed", "disputed", "cancelled"]>;
+type AgentJobStatus = z.infer<typeof agentJobStatusSchema>;
+declare const agentJobSchema: z.ZodObject<{
+    id: z.ZodString;
+    merchantId: z.ZodString;
+    /** On-chain job id from StrimzAgentEscrow. */
+    onchainJobId: z.ZodNullable<z.ZodNumber>;
+    vendorAddress: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodString;
+    amount: z.ZodEffects<z.ZodString, string, string>;
+    currency: z.ZodEnum<["USDC", "EURC"]>;
+    status: z.ZodEnum<["proposed", "accepted", "in_progress", "delivered", "approved", "completed", "disputed", "cancelled"]>;
+    assessorAddress: z.ZodEffects<z.ZodString, string, string>;
+    deliverableHash: z.ZodNullable<z.ZodString>;
+    escrowTxHash: z.ZodNullable<z.ZodString>;
+    releaseTxHash: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    completedAt: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    status: "proposed" | "accepted" | "in_progress" | "delivered" | "approved" | "completed" | "disputed" | "cancelled";
+    merchantId: string;
+    createdAt: string;
+    onchainJobId: number | null;
+    vendorAddress: string;
+    description: string;
+    amount: string;
+    currency: "USDC" | "EURC";
+    assessorAddress: string;
+    deliverableHash: string | null;
+    escrowTxHash: string | null;
+    releaseTxHash: string | null;
+    completedAt: string | null;
+}, {
+    id: string;
+    status: "proposed" | "accepted" | "in_progress" | "delivered" | "approved" | "completed" | "disputed" | "cancelled";
+    merchantId: string;
+    createdAt: string;
+    onchainJobId: number | null;
+    vendorAddress: string;
+    description: string;
+    amount: string;
+    currency: "USDC" | "EURC";
+    assessorAddress: string;
+    deliverableHash: string | null;
+    escrowTxHash: string | null;
+    releaseTxHash: string | null;
+    completedAt: string | null;
+}>;
+type AgentJob = z.infer<typeof agentJobSchema>;
+declare const createAgentJobInputSchema: z.ZodObject<{
+    vendorAddress: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodString;
+    amount: z.ZodEffects<z.ZodString, string, string>;
+    currency: z.ZodEnum<["USDC", "EURC"]>;
+    assessorAddress: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+}, "strip", z.ZodTypeAny, {
+    vendorAddress: string;
+    description: string;
+    amount: string;
+    currency: "USDC" | "EURC";
+    assessorAddress?: string | undefined;
+}, {
+    vendorAddress: string;
+    description: string;
+    amount: string;
+    currency: "USDC" | "EURC";
+    assessorAddress?: string | undefined;
+}>;
+type CreateAgentJobInput = z.infer<typeof createAgentJobInputSchema>;
+
+export { type AgentActionOutcome, type AgentActionType, type AgentActivityLog, type AgentCapability, type AgentIdentity, type AgentJob, type AgentJobStatus, type AgentMerchantConfig, type CreateAgentJobInput, type UpdateAgentConfigInput, agentActionOutcomeSchema, agentActionTypeSchema, agentActivityLogSchema, agentCapabilitySchema, agentIdentitySchema, agentJobSchema, agentJobStatusSchema, agentMerchantConfigSchema, createAgentJobInputSchema, updateAgentConfigInputSchema };

package/dist/agents.js

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+
+// src/agents.ts
+var idSchema = z.string().min(1).max(64).regex(/^[a-zA-Z0-9_-]+$/, "id must be URL-safe");
+var evmAddressSchema = z.string().regex(/^0x[a-fA-F0-9]{40}$/, "must be a 0x-prefixed 40-character hex EVM address").transform((v) => v.toLowerCase());
+var evmTxHashSchema = 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);
+z.string().url().refine((v) => v.startsWith("https://"), {
+  message: "must be an https:// URL"
+});
+z.string().url();
+var tokenAmountSchema = 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()
+});
+var metadataSchema = 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({});
+z.enum(["test", "live"]);
+z.enum(["USDC", "EURC"]);
+z.enum(["USDC", "EURC", "USYC"]);
+z.enum(["free", "growth", "business", "enterprise"]);
+z.enum(["testnet", "mainnet"]);
+
+// src/agents.ts
+var 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
+});
+var agentCapabilitySchema = z.enum([
+  "identity",
+  "recovery",
+  "routing",
+  "cashflow",
+  "commerce",
+  "pricing_intelligence"
+]);
+var 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(2e3).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(1e5)
+  }),
+  commerce: z.object({
+    requireHumanApprovalAboveUsdCents: z.number().int().nonnegative().default(1e5),
+    approvedVendors: z.array(evmAddressSchema).default([]),
+    monthlySpendCapUsdCents: z.number().int().nonnegative().nullable()
+  }),
+  updatedAt: isoTimestampSchema
+});
+var updateAgentConfigInputSchema = agentMerchantConfigSchema.omit({ merchantId: true, updatedAt: true }).partial();
+var 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"
+]);
+var agentActionOutcomeSchema = z.enum(["success", "failure", "pending", "skipped"]);
+var 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
+});
+var agentJobStatusSchema = z.enum([
+  "proposed",
+  "accepted",
+  "in_progress",
+  "delivered",
+  "approved",
+  "completed",
+  "disputed",
+  "cancelled"
+]);
+var 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(2e3),
+  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()
+});
+var createAgentJobInputSchema = z.object({
+  vendorAddress: evmAddressSchema,
+  description: z.string().min(1).max(2e3),
+  amount: tokenAmountSchema,
+  currency: z.enum(["USDC", "EURC"]),
+  assessorAddress: evmAddressSchema.optional()
+});
+
+export { agentActionOutcomeSchema, agentActionTypeSchema, agentActivityLogSchema, agentCapabilitySchema, agentIdentitySchema, agentJobSchema, agentJobStatusSchema, agentMerchantConfigSchema, createAgentJobInputSchema, updateAgentConfigInputSchema };
+//# sourceMappingURL=agents.js.map
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

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

package/dist/api-keys.cjs

@@ -0,0 +1,91 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/api-keys.ts
+var idSchema = zod.z.string().min(1).max(64).regex(/^[a-zA-Z0-9_-]+$/, "id must be URL-safe");
+zod.z.string().regex(/^0x[a-fA-F0-9]{40}$/, "must be a 0x-prefixed 40-character hex EVM address").transform((v) => v.toLowerCase());
+zod.z.string().regex(/^0x[a-fA-F0-9]{64}$/, "must be a 0x-prefixed 64-character hex EVM transaction hash");
+zod.z.string().email().trim().toLowerCase().max(320);
+zod.z.string().url().refine((v) => v.startsWith("https://"), {
+  message: "must be an https:// URL"
+});
+zod.z.string().url();
+zod.z.string().regex(/^[0-9]+$/, "must be a non-negative integer string (base-10)").refine((v) => BigInt(v) >= 0n, "must be >= 0");
+zod.z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
+var isoTimestampSchema = zod.z.string().datetime({ offset: true, message: "must be an ISO-8601 timestamp" });
+zod.z.string().length(2).regex(/^[A-Z]{2}$/, "must be an ISO-3166 alpha-2 country code");
+zod.z.object({
+  limit: zod.z.number().int().min(1).max(100).default(25),
+  cursor: zod.z.string().min(1).max(200).nullish()
+});
+zod.z.record(
+  zod.z.string().min(1).max(40),
+  zod.z.union([zod.z.string().max(500), zod.z.number(), zod.z.boolean(), zod.z.null()])
+).refine((m) => Object.keys(m).length <= 50, "at most 50 metadata keys").default({});
+var modeSchema = zod.z.enum(["test", "live"]);
+zod.z.enum(["USDC", "EURC"]);
+zod.z.enum(["USDC", "EURC", "USYC"]);
+zod.z.enum(["free", "growth", "business", "enterprise"]);
+zod.z.enum(["testnet", "mainnet"]);
+
+// src/api-keys.ts
+var apiKeyKindSchema = zod.z.enum(["secret", "publishable"]);
+var apiKeyScopeSchema = zod.z.enum([
+  "sessions_read",
+  "sessions_write",
+  "subscriptions_read",
+  "subscriptions_write",
+  "refunds_read",
+  "refunds_write",
+  "transactions_read",
+  "webhooks_read",
+  "webhooks_write",
+  "invoices_read",
+  "invoices_write",
+  "storefronts_read",
+  "storefronts_write",
+  "agents_read",
+  "agents_write",
+  // Meta-tx relayer — submitting payer-signed EIP-3009 / EIP-2612
+  // authorizations on the merchant's behalf. Granted to keys used by
+  // hosted checkout and merchants embedding the SDK.
+  "relay_read",
+  "relay_write"
+]);
+var apiKeySchema = zod.z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  name: zod.z.string().min(1).max(60),
+  kind: apiKeyKindSchema,
+  mode: modeSchema,
+  prefix: zod.z.string().min(8).max(24),
+  lastFour: zod.z.string().length(4),
+  scopes: zod.z.array(apiKeyScopeSchema).nonempty(),
+  createdAt: isoTimestampSchema,
+  lastUsedAt: isoTimestampSchema.nullable(),
+  revokedAt: isoTimestampSchema.nullable()
+});
+var createApiKeyInputSchema = zod.z.object({
+  name: zod.z.string().min(1).max(60),
+  kind: apiKeyKindSchema,
+  mode: modeSchema,
+  scopes: zod.z.array(apiKeyScopeSchema).nonempty()
+});
+var createApiKeyOutputSchema = zod.z.object({
+  apiKey: apiKeySchema,
+  /** Full plaintext key — shown exactly once. */
+  secret: zod.z.string()
+});
+var rotateApiKeyInputSchema = zod.z.object({
+  id: idSchema
+});
+
+exports.apiKeyKindSchema = apiKeyKindSchema;
+exports.apiKeySchema = apiKeySchema;
+exports.apiKeyScopeSchema = apiKeyScopeSchema;
+exports.createApiKeyInputSchema = createApiKeyInputSchema;
+exports.createApiKeyOutputSchema = createApiKeyOutputSchema;
+exports.rotateApiKeyInputSchema = rotateApiKeyInputSchema;
+//# sourceMappingURL=api-keys.cjs.map
+//# sourceMappingURL=api-keys.cjs.map

package/dist/api-keys.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common.ts","../src/api-keys.ts"],"names":["z"],"mappings":"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","file":"api-keys.cjs","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 * API keys.\n *\n * A merchant has independent test and live keys. The full secret is shown\n * exactly once at creation; the backend stores only a hash and a display prefix.\n */\n\nimport { z } from 'zod'\nimport { idSchema, isoTimestampSchema, modeSchema } from './common.js'\n\nexport const apiKeyKindSchema = z.enum(['secret', 'publishable'])\nexport type ApiKeyKind = z.infer<typeof apiKeyKindSchema>\n\n/**\n * Underscore-separated to match the Prisma `ApiKeyScope` enum (Prisma\n * does not allow `:` in enum values). The DB and the wire format use the\n * same form so there is no boundary translation.\n */\nexport const apiKeyScopeSchema = z.enum([\n  'sessions_read',\n  'sessions_write',\n  'subscriptions_read',\n  'subscriptions_write',\n  'refunds_read',\n  'refunds_write',\n  'transactions_read',\n  'webhooks_read',\n  'webhooks_write',\n  'invoices_read',\n  'invoices_write',\n  'storefronts_read',\n  'storefronts_write',\n  'agents_read',\n  'agents_write',\n  // Meta-tx relayer — submitting payer-signed EIP-3009 / EIP-2612\n  // authorizations on the merchant's behalf. Granted to keys used by\n  // hosted checkout and merchants embedding the SDK.\n  'relay_read',\n  'relay_write',\n])\nexport type ApiKeyScope = z.infer<typeof apiKeyScopeSchema>\n\nexport const apiKeySchema = z.object({\n  id: idSchema,\n  merchantId: idSchema,\n  name: z.string().min(1).max(60),\n  kind: apiKeyKindSchema,\n  mode: modeSchema,\n  prefix: z.string().min(8).max(24),\n  lastFour: z.string().length(4),\n  scopes: z.array(apiKeyScopeSchema).nonempty(),\n  createdAt: isoTimestampSchema,\n  lastUsedAt: isoTimestampSchema.nullable(),\n  revokedAt: isoTimestampSchema.nullable(),\n})\nexport type ApiKey = z.infer<typeof apiKeySchema>\n\n// ---------- DTOs ----------\n\nexport const createApiKeyInputSchema = z.object({\n  name: z.string().min(1).max(60),\n  kind: apiKeyKindSchema,\n  mode: modeSchema,\n  scopes: z.array(apiKeyScopeSchema).nonempty(),\n})\nexport type CreateApiKeyInput = z.infer<typeof createApiKeyInputSchema>\n\nexport const createApiKeyOutputSchema = z.object({\n  apiKey: apiKeySchema,\n  /** Full plaintext key — shown exactly once. */\n  secret: z.string(),\n})\nexport type CreateApiKeyOutput = z.infer<typeof createApiKeyOutputSchema>\n\nexport const rotateApiKeyInputSchema = z.object({\n  id: idSchema,\n})\nexport type RotateApiKeyInput = z.infer<typeof rotateApiKeyInputSchema>\n"]}