@paykit-sdk/core/dist/resources/index.mjs

The Payment Toolkit for Typescript

import { z } from 'zod';

// src/resources/checkout.ts
var PAYKIT_METADATA_KEY = "__paykit";
var metadataSchema = z.record(z.string(), z.string());

// src/tools/utils.ts
var schema = () => {
  return (schema2) => schema2;
};
var billingAddressSchema = schema()(
  z.object({
    name: z.string().min(1, "Recipient name is required"),
    line1: z.string().min(1, "Address line 1 is required"),
    line2: z.string().default("").optional(),
    city: z.string().min(1, "City is required"),
    state: z.string().optional(),
    // Optional because not all countries use states
    postal_code: z.string().min(1, "Postal code is required"),
    country: z.string().length(2, "Country must be a 2-letter ISO code").toUpperCase(),
    phone: z.string().optional()
  })
);
var billingSchema = schema()(
  z.object({
    address: billingAddressSchema,
    carrier: z.string().optional(),
    currency: z.string().min(1, "Currency is required")
  })
);
var customerSchema = schema()(
  z.object({
    id: z.string(),
    email: z.string().email(),
    name: z.string(),
    phone: z.string().nullable(),
    metadata: metadataSchema.optional(),
    custom_fields: z.record(z.string(), z.unknown()).optional(),
    created_at: z.date(),
    updated_at: z.date().nullable()
  })
);
var payeeSchema = schema()(
  z.union([
    z.object({ email: z.string().email() }),
    z.object({ id: z.union([z.string(), z.number()]) })
  ])
);
var createCustomerSchema = schema()(
  z.object({
    email: z.string().email(),
    name: z.string().optional(),
    phone: z.string().nullable().optional(),
    metadata: metadataSchema.optional(),
    billing: billingSchema.nullable(),
    provider_metadata: z.record(z.string(), z.unknown()).optional()
  })
);
var updateCustomerSchema = schema()(
  z.object({
    email: z.string().email().optional(),
    name: z.string().optional(),
    metadata: metadataSchema.optional(),
    provider_metadata: z.record(z.string(), z.unknown()).optional()
  })
);
var retrieveCustomerSchema = schema()(
  z.object({
    id: z.string()
  })
);
var isEmailCustomer = (customer) => {
  return typeof customer === "object" && customer !== null && "email" in customer;
};
var isIdCustomer = (customer) => {
  return typeof customer === "object" && customer !== null && "id" in customer;
};
var parseCustomerName = (params) => {
  const full = params.name?.trim() || params.email.split("@")[0];
  const parts = full.split(/\s+/);
  const first = parts[0] || "";
  const last = parts.slice(1).join(" ") || "";
  return {
    fullName: full,
    firstName: first,
    lastName: last,
    initials: `${first[0] || ""}${last[0] || ""}`.toUpperCase()
  };
};
var subscriptionIntervalUnitSchema = z.enum([
  "day",
  "week",
  "month",
  "year"
]);
var subscriptionBillingIntervalSchema = z.union([
  subscriptionIntervalUnitSchema,
  z.object({
    type: z.literal("custom"),
    durationMs: z.number().int().positive()
  })
]);
var subscriptionStatusSchema = z.enum([
  "active",
  "past_due",
  "canceled",
  "expired",
  "trialing",
  "pending"
]);
var subscriptionSchema = schema()(
  z.object({
    id: z.string(),
    customer: payeeSchema.nullable(),
    amount: z.number(),
    currency: z.string(),
    status: subscriptionStatusSchema,
    current_period_start: z.date(),
    current_period_end: z.date(),
    item_id: z.string(),
    billing_interval: subscriptionBillingIntervalSchema,
    metadata: metadataSchema.nullable(),
    custom_fields: z.record(z.string(), z.unknown()).nullable(),
    requires_action: z.boolean(),
    payment_url: z.string().nullable()
  })
);
var updateSubscriptionSchema = schema()(
  z.object({
    metadata: metadataSchema,
    provider_metadata: z.record(z.string(), z.unknown()).optional()
  })
);
var retrieveSubscriptionSchema = schema()(
  z.object({
    id: z.string()
  })
);
var deleteSubscriptionSchema = schema()(
  z.object({
    id: z.string()
  })
);
var createSubscriptionSchema = schema()(
  subscriptionSchema.omit({
    id: true,
    status: true,
    custom_fields: true,
    current_period_start: true,
    current_period_end: true,
    requires_action: true,
    payment_url: true
  }).extend({
    provider_metadata: z.record(z.string(), z.unknown()).optional(),
    quantity: z.number()
  })
);

// src/resources/checkout.ts
var checkoutSubscriptionSchema = schema()(
  z.object({
    billing_interval: subscriptionBillingIntervalSchema,
    billing_interval_count: z.number()
  })
);
var billingModeSchema = z.enum(["one_time", "recurring"]);
var checkoutSchema = schema()(
  z.object({
    id: z.string(),
    customer: payeeSchema.nullable(),
    payment_url: z.string(),
    metadata: metadataSchema.nullable(),
    session_type: billingModeSchema,
    products: z.array(
      z.object({ id: z.string(), quantity: z.number() })
    ),
    currency: z.string(),
    amount: z.number(),
    subscription: checkoutSubscriptionSchema.nullable().optional()
  })
);
var createCheckoutBaseSchema = schema()(
  z.object({
    customer: payeeSchema,
    metadata: metadataSchema.nullable(),
    item_id: z.string(),
    quantity: z.number(),
    provider_metadata: z.record(z.string(), z.unknown()).optional(),
    billing: billingSchema.optional(),
    success_url: z.string(),
    cancel_url: z.string()
  })
);
var createCheckoutSchema = schema()(
  z.object({
    customer: payeeSchema,
    metadata: metadataSchema.nullable(),
    session_type: z.literal(billingModeSchema.enum.one_time),
    item_id: z.string(),
    quantity: z.number(),
    subscription: checkoutSubscriptionSchema.optional(),
    provider_metadata: z.record(z.string(), z.unknown()).optional(),
    billing: billingSchema.optional(),
    success_url: z.string(),
    cancel_url: z.string()
  })
);
var updateCheckoutSchema = schema()(
  createCheckoutSchema.partial()
);
var retrieveCheckoutSchema = schema()(
  z.object({
    id: z.string()
  })
);

// src/resources/webhook.ts
var paykitEvent$InboundSchema = (event) => event;
var invoiceStatusSchema = z.enum(["paid", "open"]);
var invoiceSchema = schema()(
  z.object({
    id: z.string(),
    customer: payeeSchema.nullable(),
    subscription_id: z.string().nullable(),
    billing_mode: billingModeSchema,
    amount_paid: z.number(),
    currency: z.string(),
    status: invoiceStatusSchema,
    paid_at: z.string().nullable(),
    line_items: z.array(z.object({ id: z.string(), quantity: z.number() })).nullable(),
    metadata: metadataSchema.nullable(),
    custom_fields: z.record(z.string(), z.any()).nullable()
  })
);
var paymentStatusSchema = z.enum([
  "pending",
  "processing",
  "requires_action",
  "requires_capture",
  "succeeded",
  "canceled",
  "failed"
]);
var paymentSchema = schema()(
  z.object({
    id: z.string(),
    amount: z.number().min(0),
    currency: z.string(),
    customer: payeeSchema.nullable(),
    status: paymentStatusSchema,
    metadata: metadataSchema,
    item_id: z.string().nullable(),
    requires_action: z.boolean(),
    payment_url: z.string().nullable()
  })
);
var createPaymentSchema = schema()(
  paymentSchema.omit({
    id: true,
    status: true,
    metadata: true,
    requires_action: true,
    payment_url: true
  }).extend({
    metadata: z.record(z.string(), z.unknown()).optional(),
    provider_metadata: z.record(z.string(), z.unknown()).optional(),
    billing: billingSchema.optional(),
    capture_method: z.enum(["automatic", "manual"])
  })
);
var updatePaymentSchema = schema()(
  paymentSchema.partial().extend({
    provider_metadata: z.record(z.string(), z.unknown()).optional()
  })
);
var retrievePaymentSchema = schema()(
  paymentSchema.pick({ id: true })
);
var deletePaymentSchema = schema()(
  paymentSchema.pick({ id: true })
);
var capturePaymentSchema = schema()(
  z.object({
    amount: z.number()
  })
);
var refundReasonSchema = schema()(
  z.string().nullable()
);
var refundSchema = schema()(
  z.object({
    id: z.string(),
    amount: z.number(),
    currency: z.string(),
    reason: refundReasonSchema,
    metadata: metadataSchema.nullable()
  })
);
var createRefundSchema = schema()(
  z.object({
    payment_id: z.string(),
    reason: refundReasonSchema,
    amount: z.number().min(0),
    provider_metadata: z.record(z.string(), z.unknown()).optional(),
    metadata: metadataSchema.nullable()
  })
);

export { PAYKIT_METADATA_KEY, billingAddressSchema, billingModeSchema, billingSchema, capturePaymentSchema, checkoutSchema, checkoutSubscriptionSchema, createCheckoutBaseSchema, createCheckoutSchema, createCustomerSchema, createPaymentSchema, createRefundSchema, createSubscriptionSchema, customerSchema, deletePaymentSchema, deleteSubscriptionSchema, invoiceSchema, invoiceStatusSchema, isEmailCustomer, isIdCustomer, metadataSchema, parseCustomerName, payeeSchema, paykitEvent$InboundSchema, paymentSchema, paymentStatusSchema, refundSchema, retrieveCheckoutSchema, retrieveCustomerSchema, retrievePaymentSchema, retrieveSubscriptionSchema, subscriptionBillingIntervalSchema, subscriptionIntervalUnitSchema, subscriptionSchema, subscriptionStatusSchema, updateCheckoutSchema, updateCustomerSchema, updatePaymentSchema, updateSubscriptionSchema };