@absolutejs/commerce 0.0.1-beta.0 → 0.1.1-beta.0

package/dist/core/cart.d.ts

@@ -0,0 +1,17 @@
+export type PricedLine = {
+    quantity: number;
+    /** Per-unit price (major units), excluding the one-time setup fee. */
+    unitPrice: number;
+    /** One-time fee charged once for the whole line (e.g. digitizing/setup). */
+    setupFee: number;
+};
+/** Total units across the cart. */
+export declare const cartCount: <T extends {
+    quantity: number;
+}>(lines: T[]) => number;
+/** Cost of one line: unit × qty + the one-time setup fee. */
+export declare const lineTotal: (line: PricedLine) => number;
+/** Sum of every line's one-time setup fees. */
+export declare const cartSetupTotal: <T extends PricedLine>(lines: T[]) => number;
+/** Cart subtotal (all lines, including setup fees). */
+export declare const cartSubtotal: <T extends PricedLine>(lines: T[]) => number;

package/dist/core/discounts.d.ts

@@ -0,0 +1,15 @@
+export type Discount = {
+    code: string;
+    percentOff: number | null;
+    /** Fixed amount off in minor units (cents). */
+    amountOff: number | null;
+    active: boolean;
+    maxUses: number | null;
+    usedCount: number;
+    /** Expiry as epoch ms, or null for no expiry. */
+    expiresAt: number | null;
+};
+/** Whether a code can be redeemed right now. */
+export declare const isDiscountValid: (discount: Discount | null | undefined, now?: number) => boolean;
+/** The amount a code takes off a subtotal, in minor units (cents). */
+export declare const discountAmountCents: (discount: Discount, subtotalCents: number) => number;

package/dist/core/money.d.ts

@@ -0,0 +1,8 @@
+/** Round a major-unit amount to 2 decimals (avoids float drift in pricing). */
+export declare const roundMoney: (value: number) => number;
+/** Major units → integer minor units (dollars → cents). */
+export declare const toCents: (value: number) => number;
+/** Integer minor units → major units (cents → dollars). */
+export declare const fromCents: (cents: number) => number;
+/** Format a major-unit amount, USD by default. */
+export declare const formatPrice: (value: number, currency?: string) => string;

package/dist/core/orders.d.ts

@@ -0,0 +1,9 @@
+export type OrderStatus = 'paid' | 'shipped' | 'rejected' | 'failed' | 'refunded';
+export declare const PRODUCTION_STAGES: readonly ["queued", "digitizing", "production", "ready"];
+export type ProductionStage = (typeof PRODUCTION_STAGES)[number];
+/** Normalize an unknown stage to a valid one (defaults to the first). */
+export declare const toProductionStage: (stage: string | null | undefined) => "queued" | "digitizing" | "production" | "ready";
+/** The next stage forward, or null at the end. */
+export declare const nextStage: (stage: string) => ProductionStage | null;
+/** The previous stage, or null at the start. */
+export declare const prevStage: (stage: string) => ProductionStage | null;

package/dist/core/payment.d.ts

@@ -0,0 +1,78 @@
+import type { Address } from './shipping';
+export type CheckoutLineItem = {
+    name: string;
+    description?: string;
+    /** Unit price in minor units (cents). */
+    amountCents: number;
+    quantity: number;
+    taxBehavior?: 'inclusive' | 'exclusive';
+};
+export type CheckoutShipping = {
+    mode: 'none';
+} | {
+    mode: 'collect';
+    countries: string[];
+    flatAmountCents?: number;
+    label?: string;
+};
+export type CreateCheckoutInput = {
+    uiMode: 'embedded' | 'hosted';
+    currency?: string;
+    lineItems: CheckoutLineItem[];
+    metadata?: Record<string, string>;
+    /** Embedded checkout return URL. */
+    returnUrl?: string;
+    /** Hosted checkout success/cancel URLs. */
+    successUrl?: string;
+    cancelUrl?: string;
+    shipping?: CheckoutShipping;
+    /** A coupon id from `createCoupon`, applied to the session. */
+    couponId?: string;
+    /** Calculate tax automatically when the provider supports it. */
+    automaticTax?: boolean;
+};
+export type CheckoutResult = {
+    id: string;
+    /** Set for embedded checkout. */
+    clientSecret: string | null;
+    /** Set for hosted checkout (a pay link). */
+    url: string | null;
+};
+export type CreateCouponInput = {
+    percentOff?: number;
+    amountOffCents?: number;
+    currency?: string;
+};
+export type CheckoutSession = {
+    id: string;
+    /** Session lifecycle status (e.g. 'complete' | 'open' | 'expired'). */
+    status: string | null;
+    paymentStatus: string | null;
+    amountTotalCents: number | null;
+    currency: string | null;
+    customerEmail: string | null;
+    customerName: string | null;
+    shippingAddress: Address | null;
+    metadata: Record<string, string>;
+    lineItems: {
+        name: string;
+        quantity: number;
+        amountTotalCents: number;
+    }[];
+};
+export type WebhookEvent = {
+    type: string;
+    /** A checkout that completed successfully (sync or async). */
+    isComplete: boolean;
+    /** A checkout that failed or expired. */
+    isFailed: boolean;
+    session: CheckoutSession;
+};
+export type PaymentProvider = {
+    createCheckout(input: CreateCheckoutInput): Promise<CheckoutResult>;
+    createCoupon(input: CreateCouponInput): Promise<string>;
+    /** Fetch a session's current state (for return pages). */
+    retrieveCheckout(sessionId: string): Promise<CheckoutSession>;
+    refundBySession(sessionId: string): Promise<void>;
+    verifyWebhook(payload: string, signature: string): Promise<WebhookEvent>;
+};

package/dist/core/pricing.d.ts

@@ -0,0 +1,8 @@
+export type QuantityBreak = {
+    min: number;
+    discount: number;
+};
+/** The fractional discount (0–1) that applies at a given quantity. */
+export declare const quantityDiscount: (breaks: QuantityBreak[], quantity: number) => number;
+/** The next break a buyer hasn't reached yet (for "order N+ to save X%" hints). */
+export declare const nextQuantityBreak: (breaks: QuantityBreak[], quantity: number) => QuantityBreak | null;

package/dist/index.d.ts

@@ -1 +1,7 @@
+export * from './core/cart';
+export * from './core/discounts';
+export * from './core/money';
+export * from './core/orders';
+export * from './core/payment';
+export * from './core/pricing';
 export * from './core/shipping';

package/dist/index.js

@@ -1,4 +1,48 @@
 // @bun
+// src/core/cart.ts
+var cartCount = (lines) => lines.reduce((sum, line) => sum + line.quantity, 0);
+var lineTotal = (line) => line.setupFee + line.unitPrice * line.quantity;
+var cartSetupTotal = (lines) => lines.reduce((sum, line) => sum + line.setupFee, 0);
+var cartSubtotal = (lines) => lines.reduce((sum, line) => sum + lineTotal(line), 0);
+// src/core/discounts.ts
+var isDiscountValid = (discount, now = 0) => {
+  if (!discount || !discount.active)
+    return false;
+  const at = now || nowMs();
+  if (discount.expiresAt !== null && discount.expiresAt < at)
+    return false;
+  if (discount.maxUses !== null && discount.usedCount >= discount.maxUses)
+    return false;
+  return true;
+};
+var discountAmountCents = (discount, subtotalCents) => discount.percentOff !== null ? Math.round(subtotalCents * discount.percentOff / 100) : Math.min(subtotalCents, discount.amountOff ?? 0);
+var nowMs = () => Date.now();
+// src/core/money.ts
+var CENTS = 100;
+var roundMoney = (value) => Math.round(value * CENTS) / CENTS;
+var toCents = (value) => Math.round(value * CENTS);
+var fromCents = (cents) => cents / CENTS;
+var formatPrice = (value, currency = "USD") => {
+  const code = currency.toUpperCase();
+  return code === "USD" ? `$${value.toFixed(2)}` : `${value.toFixed(2)} ${code}`;
+};
+// src/core/orders.ts
+var PRODUCTION_STAGES = [
+  "queued",
+  "digitizing",
+  "production",
+  "ready"
+];
+var stageIndex = (stage) => PRODUCTION_STAGES.indexOf(stage);
+var toProductionStage = (stage) => stage && stageIndex(stage) >= 0 ? stage : PRODUCTION_STAGES[0];
+var nextStage = (stage) => PRODUCTION_STAGES[stageIndex(toProductionStage(stage)) + 1] ?? null;
+var prevStage = (stage) => {
+  const index = stageIndex(toProductionStage(stage));
+  return index > 0 ? PRODUCTION_STAGES[index - 1] ?? null : null;
+};
+// src/core/pricing.ts
+var quantityDiscount = (breaks, quantity) => breaks.reduce((best, brk) => quantity >= brk.min ? brk.discount : best, 0);
+var nextQuantityBreak = (breaks, quantity) => breaks.find((brk) => brk.min > quantity) ?? null;
 // src/core/shipping.ts
 var DEFAULT_APPAREL_PARCEL = {
   heightIn: 2,
@@ -7,5 +51,21 @@ var DEFAULT_APPAREL_PARCEL = {
   widthIn: 9
 };
 export {
+  toProductionStage,
+  toCents,
+  roundMoney,
+  quantityDiscount,
+  prevStage,
+  nextStage,
+  nextQuantityBreak,
+  lineTotal,
+  isDiscountValid,
+  fromCents,
+  formatPrice,
+  discountAmountCents,
+  cartSubtotal,
+  cartSetupTotal,
+  cartCount,
+  PRODUCTION_STAGES,
   DEFAULT_APPAREL_PARCEL
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/commerce",
-	"version": "0.0.1-beta.0",
+	"version": "0.1.1-beta.0",
 	"description": "Provider-agnostic commerce primitives (cart, orders, fulfillment, shipping) for AbsoluteJS",
 	"repository": {
 		"type": "git",