@cogenta/commerce 0.2.0

package/dist/subscription/store.js

@@ -0,0 +1,310 @@
+import { CogentaError, identifier, newId, sql, } from '@cogenta/core';
+import { assertCurrency, assertMinor } from '../money.js';
+import { referenceFrom } from '../order/store.js';
+import { toInt, toNullableText, toText } from '../rows.js';
+import { TABLES } from '../tables.js';
+export const SUBSCRIPTION_STATUSES = ['active', 'paused', 'cancelled'];
+export const INTERVAL_UNITS = ['day', 'week', 'month', 'year'];
+function decode(row) {
+    return {
+        id: toText(row.id, 'subscription.id'),
+        customerId: toText(row.customer_id, 'subscription.customer_id'),
+        variantId: toText(row.variant_id, 'subscription.variant_id'),
+        quantity: toInt(row.quantity, 'subscription.quantity'),
+        status: toText(row.status, 'subscription.status'),
+        intervalUnit: toText(row.interval_unit, 'subscription.interval_unit'),
+        intervalCount: toInt(row.interval_count, 'subscription.interval_count'),
+        priceMinor: toInt(row.price_minor, 'subscription.price_minor'),
+        currency: toText(row.currency, 'subscription.currency'),
+        paymentDriver: toText(row.payment_driver, 'subscription.payment_driver'),
+        currentPeriodStart: toText(row.current_period_start, 'subscription.current_period_start'),
+        currentPeriodEnd: toText(row.current_period_end, 'subscription.current_period_end'),
+        nextBillingAt: toText(row.next_billing_at, 'subscription.next_billing_at'),
+        shippingCountry: toNullableText(row.shipping_country),
+        shippingRegion: toNullableText(row.shipping_region),
+        createdAt: toText(row.created_at, 'subscription.created_at'),
+        updatedAt: toText(row.updated_at, 'subscription.updated_at'),
+        cancelledAt: toNullableText(row.cancelled_at),
+    };
+}
+/**
+ * The end of a billing period.
+ *
+ * Month and year arithmetic is where recurring billing goes wrong, so the rule
+ * is stated rather than inherited from `Date`: adding a month to 31 January
+ * gives **28 February** (or the 29th in a leap year), not 3 March. JavaScript's
+ * `setMonth` overflows into the next month, which would silently move a
+ * subscriber's billing day forward every short month until it drifted off the
+ * end of the calendar.
+ */
+export function advancePeriod(from, unit, count) {
+    const start = new Date(from);
+    if (Number.isNaN(start.getTime())) {
+        throw new CogentaError({
+            code: 'COMMERCE_SUBSCRIPTION_INVALID',
+            message: `"${from}" is not a date a billing period can start on.`,
+            hint: 'Use an ISO 8601 timestamp.',
+        });
+    }
+    if (unit === 'day' || unit === 'week') {
+        const days = count * (unit === 'week' ? 7 : 1);
+        return new Date(start.getTime() + days * 24 * 60 * 60 * 1000).toISOString();
+    }
+    const months = unit === 'year' ? count * 12 : count;
+    const year = start.getUTCFullYear();
+    const month = start.getUTCMonth() + months;
+    const day = start.getUTCDate();
+    const targetYear = year + Math.floor(month / 12);
+    const targetMonth = ((month % 12) + 12) % 12;
+    // Day 0 of the following month is the last day of this one.
+    const lastDay = new Date(Date.UTC(targetYear, targetMonth + 1, 0)).getUTCDate();
+    return new Date(Date.UTC(targetYear, targetMonth, Math.min(day, lastDay), start.getUTCHours(), start.getUTCMinutes(), start.getUTCSeconds(), start.getUTCMilliseconds())).toISOString();
+}
+export function createSubscriptionStore(db, dependencies, now = Date.now) {
+    const d = db.dialect;
+    const subscriptions = identifier(TABLES.subscriptions, d);
+    const cycles = identifier(TABLES.subscriptionCycles, d);
+    const orders = identifier(TABLES.orders, d);
+    const orderLines = identifier(TABLES.orderLines, d);
+    const stamp = () => new Date(now()).toISOString();
+    async function read(id, executor = db) {
+        const result = await executor.query(sql `select * from ${subscriptions} where id = ${id}`);
+        const row = result.rows[0];
+        return row === undefined ? null : decode(row);
+    }
+    async function load(id) {
+        const found = await read(id);
+        if (found === null) {
+            throw new CogentaError({
+                code: 'COMMERCE_SUBSCRIPTION_NOT_FOUND',
+                message: 'This subscription does not exist.',
+                hint: 'It may have been cancelled and removed.',
+            });
+        }
+        return found;
+    }
+    /**
+     * Bills one period, in one transaction.
+     *
+     * `period_key` is unique, and it is claimed **first**. That is what makes
+     * running the biller twice in a minute — a retried cron, two workers, an
+     * impatient operator — charge once: the second attempt collides on the
+     * unique key and unwinds before any stock is taken or any order is written.
+     */
+    async function billOne(subscription) {
+        const periodStart = subscription.nextBillingAt;
+        const periodEnd = advancePeriod(periodStart, subscription.intervalUnit, subscription.intervalCount);
+        const periodKey = `${subscription.id}:${periodStart}`;
+        const variant = await dependencies.catalog.readVariant(subscription.variantId);
+        if (variant === null) {
+            return { skipped: 'The subscribed product no longer exists.' };
+        }
+        const customer = await dependencies.customers.read(subscription.customerId);
+        if (customer === null) {
+            return { skipped: 'The subscriber no longer exists.' };
+        }
+        const orderId = newId(now);
+        const at = stamp();
+        try {
+            return await db.transaction(async (tx) => {
+                await tx.query(sql `
+            insert into ${cycles} (id, subscription_id, period_start, period_end, period_key, order_id, status, created_at)
+            values (${newId(now)}, ${subscription.id}, ${periodStart}, ${periodEnd}, ${periodKey},
+                    ${orderId}, ${'billed'}, ${at})`);
+                const taken = await dependencies.catalog.takeStock([{ variantId: subscription.variantId, quantity: subscription.quantity }], tx);
+                if (taken.kind === 'short') {
+                    throw new CycleRefused('The subscribed product is out of stock.');
+                }
+                const lineTotal = subscription.priceMinor * subscription.quantity;
+                // A renewal is not a basket, so it does not go through the cart. It
+                // is priced at the agreed rate, which is the whole point of a
+                // subscription — and it produces a real order, so it appears in the
+                // same lists, history and invoicing as everything else.
+                await tx.query(sql `
+            insert into ${orders} (id, reference, customer_id, email, status, currency,
+                                   subtotal_minor, discount_minor, shipping_minor, tax_minor, total_minor,
+                                   coupon_code, shipping_country, shipping_region,
+                                   shipping_method_id, shipping_method_label,
+                                   placed_at, updated_at, subscription_id)
+            values (${orderId}, ${referenceFrom(orderId)}, ${customer.id}, ${customer.email},
+                    ${'pending'}, ${subscription.currency},
+                    ${lineTotal}, ${0}, ${0}, ${0}, ${lineTotal},
+                    ${null}, ${subscription.shippingCountry}, ${subscription.shippingRegion},
+                    ${null}, ${null}, ${at}, ${at}, ${subscription.id})`);
+                await tx.query(sql `
+            insert into ${orderLines} (id, order_id, variant_id, sku, title, quantity,
+                                       unit_price_minor, subtotal_minor, discount_minor,
+                                       tax_minor, tax_rate_bp, total_minor, position)
+            values (${newId(now)}, ${orderId}, ${variant.id}, ${variant.sku}, ${variant.title},
+                    ${subscription.quantity}, ${subscription.priceMinor}, ${lineTotal},
+                    ${0}, ${0}, ${0}, ${lineTotal}, ${0})`);
+                await tx.query(sql `
+            update ${subscriptions}
+            set current_period_start = ${periodStart},
+                current_period_end = ${periodEnd},
+                next_billing_at = ${periodEnd},
+                updated_at = ${at}
+            where id = ${subscription.id}`);
+                return { orderId };
+            }, { immediate: true });
+        }
+        catch (error) {
+            if (error instanceof CycleRefused) {
+                // The period is still marked as attempted, so the next run does not
+                // retry it forever — and the billing date still moves, because a
+                // subscriber whose delivery was skipped is not owed two next month.
+                await db.query(sql `
+          insert into ${cycles} (id, subscription_id, period_start, period_end, period_key, order_id, status, created_at)
+          values (${newId(now)}, ${subscription.id}, ${periodStart}, ${periodEnd}, ${`${periodKey}:skipped`},
+                  ${null}, ${'skipped_out_of_stock'}, ${at})`);
+                await db.query(sql `
+          update ${subscriptions}
+          set current_period_start = ${periodStart}, current_period_end = ${periodEnd},
+              next_billing_at = ${periodEnd}, updated_at = ${at}
+          where id = ${subscription.id}`);
+                return { skipped: error.reason };
+            }
+            // Everything else is either a unique-key collision on `period_key` —
+            // somebody else billed this period between the query and here, which is
+            // the correct outcome and not an error — or a genuine failure.
+            //
+            // Told apart by asking, rather than assumed. A blanket "already billed"
+            // would turn a broken database into a silent no-op, and a biller that
+            // reports success while charging nobody is the worst possible failure
+            // mode for this file.
+            const claimed = await db.query(sql `select id from ${cycles} where period_key = ${periodKey}`);
+            if (claimed.rows.length > 0)
+                return { skipped: 'This period was already billed.' };
+            throw error;
+        }
+    }
+    return {
+        create: async (input) => {
+            const variant = await dependencies.catalog.readVariant(input.variantId);
+            if (variant === null) {
+                throw new CogentaError({
+                    code: 'COMMERCE_VARIANT_NOT_FOUND',
+                    message: 'This product variant does not exist.',
+                    hint: 'A subscription needs something to deliver.',
+                });
+            }
+            const count = input.intervalCount ?? 1;
+            if (!Number.isInteger(count) || count < 1 || count > 36) {
+                throw new CogentaError({
+                    code: 'COMMERCE_SUBSCRIPTION_INVALID',
+                    message: `A billing interval must be between 1 and 36, got ${String(count)}.`,
+                    hint: 'Every three months is intervalUnit "month", intervalCount 3.',
+                });
+            }
+            const id = newId(now);
+            const at = stamp();
+            const start = input.startAt ?? at;
+            const end = advancePeriod(start, input.intervalUnit, count);
+            await db.query(sql `
+        insert into ${subscriptions} (id, customer_id, variant_id, quantity, status,
+                                      interval_unit, interval_count, price_minor, currency,
+                                      payment_driver, current_period_start, current_period_end,
+                                      next_billing_at, shipping_country, shipping_region,
+                                      created_at, updated_at, cancelled_at)
+        values (${id}, ${input.customerId}, ${input.variantId}, ${input.quantity ?? 1}, ${'active'},
+                ${input.intervalUnit}, ${count},
+                ${assertMinor(input.priceMinor ?? variant.priceMinor, 'A subscription price')},
+                ${assertCurrency(input.currency ?? variant.currency)},
+                ${input.paymentDriver ?? 'manual'}, ${start}, ${end}, ${start},
+                ${input.shippingCountry ?? null}, ${input.shippingRegion ?? null},
+                ${at}, ${at}, ${null})`);
+            return load(id);
+        },
+        read,
+        list: async (options) => {
+            let statement = sql `select * from ${subscriptions}`;
+            if (options?.customerId !== undefined && options.status !== undefined) {
+                statement = sql `${statement} where customer_id = ${options.customerId} and status = ${options.status}`;
+            }
+            else if (options?.customerId !== undefined) {
+                statement = sql `${statement} where customer_id = ${options.customerId}`;
+            }
+            else if (options?.status !== undefined) {
+                statement = sql `${statement} where status = ${options.status}`;
+            }
+            const result = await db.query(sql `${statement} order by created_at desc, id desc`);
+            return result.rows.map(decode);
+        },
+        pause: async (id) => {
+            await load(id);
+            await db.query(sql `update ${subscriptions} set status = ${'paused'}, updated_at = ${stamp()} where id = ${id} and status = ${'active'}`);
+            return load(id);
+        },
+        resume: async (id) => {
+            const subscription = await load(id);
+            if (subscription.status === 'cancelled') {
+                throw new CogentaError({
+                    code: 'COMMERCE_SUBSCRIPTION_INVALID',
+                    message: 'A cancelled subscription cannot be resumed.',
+                    hint: 'Create a new subscription instead — the old one is a closed record.',
+                });
+            }
+            // Billing resumes from now, not from where it was paused. Charging a
+            // subscriber for the months they were paused is exactly what pausing was
+            // supposed to prevent.
+            const at = stamp();
+            await db.query(sql `
+        update ${subscriptions} set status = ${'active'}, next_billing_at = ${at}, updated_at = ${at}
+        where id = ${id}`);
+            return load(id);
+        },
+        cancel: async (id) => {
+            await load(id);
+            const at = stamp();
+            await db.query(sql `
+        update ${subscriptions} set status = ${'cancelled'}, cancelled_at = ${at}, updated_at = ${at}
+        where id = ${id} and cancelled_at is null`);
+            return load(id);
+        },
+        cycles: async (id) => {
+            const result = await db.query(sql `select * from ${cycles} where subscription_id = ${id} order by period_start asc, id asc`);
+            return result.rows.map((row) => ({
+                id: toText(row.id, 'cycle.id'),
+                subscriptionId: toText(row.subscription_id, 'cycle.subscription_id'),
+                periodStart: toText(row.period_start, 'cycle.period_start'),
+                periodEnd: toText(row.period_end, 'cycle.period_end'),
+                orderId: toNullableText(row.order_id),
+                status: toText(row.status, 'cycle.status'),
+                createdAt: toText(row.created_at, 'cycle.created_at'),
+            }));
+        },
+        runBilling: async (options) => {
+            const due = await db.query(sql `
+        select * from ${subscriptions}
+        where status = ${'active'} and next_billing_at <= ${stamp()}
+        order by next_billing_at asc`);
+            const billed = [];
+            const skipped = [];
+            for (const row of due.rows.slice(0, options?.limit ?? 200)) {
+                const subscription = decode(row);
+                const outcome = await billOne(subscription);
+                if ('orderId' in outcome) {
+                    billed.push({ subscriptionId: subscription.id, orderId: outcome.orderId });
+                    // The renewal starts a payment through the same store as any other
+                    // order, so a subscription with no gateway configured produces bank
+                    // transfer instructions rather than failing (R2).
+                    await dependencies.payments.start(outcome.orderId);
+                }
+                else {
+                    skipped.push({ subscriptionId: subscription.id, reason: outcome.skipped });
+                }
+            }
+            return { billed, skipped };
+        },
+    };
+}
+/** Internal. Unwinds a billing transaction with a reason. */
+class CycleRefused extends Error {
+    reason;
+    constructor(reason) {
+        super(reason);
+        this.name = 'CycleRefused';
+        this.reason = reason;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/subscription/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/subscription/store.ts"],"names":[],"mappings":"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"}

package/dist/tables.d.ts

@@ -0,0 +1,41 @@
+import { type DatabaseHandle } from '@cogenta/core';
+/**
+ * Every table contract E owns.
+ *
+ * Prefixed `cogenta_commerce_` rather than `cogenta_`: a site's content tables
+ * are named after the collections **it** declares, so a shop that also declares
+ * a `product` collection for the storefront page must not collide with the
+ * commercial record of the same product. The two are deliberately different
+ * objects (ADR draft 0023) and they must be able to coexist in one database.
+ */
+export declare const TABLES: {
+    readonly products: 'cogenta_commerce_products';
+    readonly variants: 'cogenta_commerce_variants';
+    readonly customers: 'cogenta_commerce_customers';
+    readonly carts: 'cogenta_commerce_carts';
+    readonly cartLines: 'cogenta_commerce_cart_lines';
+    readonly orders: 'cogenta_commerce_orders';
+    readonly orderLines: 'cogenta_commerce_order_lines';
+    readonly orderEvents: 'cogenta_commerce_order_events';
+    readonly payments: 'cogenta_commerce_payments';
+    readonly refunds: 'cogenta_commerce_refunds';
+    readonly taxRules: 'cogenta_commerce_tax_rules';
+    readonly shippingMethods: 'cogenta_commerce_shipping_methods';
+    readonly coupons: 'cogenta_commerce_coupons';
+    readonly couponRedemptions: 'cogenta_commerce_coupon_redemptions';
+    readonly invoices: 'cogenta_commerce_invoices';
+    readonly invoiceSequences: 'cogenta_commerce_invoice_sequences';
+    readonly subscriptions: 'cogenta_commerce_subscriptions';
+    readonly subscriptionCycles: 'cogenta_commerce_subscription_cycles';
+};
+/**
+ * Creates everything this package owns, idempotently.
+ *
+ * Same shape as `ensureAuthTables`: `create table if not exists`, run once at
+ * startup, so a fresh install and an upgrade take the same path. Commerce is
+ * **not** part of contract A's migration engine on purpose — a site that never
+ * sells anything never creates these tables, which is the whole point of
+ * putting commerce in its own contract rather than raising `schema` to 3.0.
+ */
+export declare function ensureCommerceTables(db: DatabaseHandle): Promise<void>;
+//# sourceMappingURL=tables.d.ts.map

package/dist/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../src/tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAKpB,MAAM,eAAe,CAAA;AAEtB;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM;aACjB,QAAQ,EAAE,2BAA2B;aACrC,QAAQ,EAAE,2BAA2B;aACrC,SAAS,EAAE,4BAA4B;aACvC,KAAK,EAAE,wBAAwB;aAC/B,SAAS,EAAE,6BAA6B;aACxC,MAAM,EAAE,yBAAyB;aACjC,UAAU,EAAE,8BAA8B;aAC1C,WAAW,EAAE,+BAA+B;aAC5C,QAAQ,EAAE,2BAA2B;aACrC,OAAO,EAAE,0BAA0B;aACnC,QAAQ,EAAE,4BAA4B;aACtC,eAAe,EAAE,mCAAmC;aACpD,OAAO,EAAE,0BAA0B;aACnC,iBAAiB,EAAE,qCAAqC;aACxD,QAAQ,EAAE,2BAA2B;aACrC,gBAAgB,EAAE,oCAAoC;aACtD,aAAa,EAAE,gCAAgC;aAC/C,kBAAkB,EAAE,sCAAsC;CAClD,CAAA;AAuBV;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoT5E"}