@cogenta/commerce 0.2.0

package/dist/coupon/store.js

@@ -0,0 +1,181 @@
+import { CogentaError, identifier, newId, sql, } from '@cogenta/core';
+import { applyBasisPoints, assertCurrency, assertMinor } from '../money.js';
+import { fromBool, toBool, toInt, toNullableInt, toNullableText, toText } from '../rows.js';
+import { TABLES } from '../tables.js';
+/**
+ * Three kinds, and no more.
+ *
+ * "Buy two get one free", tiered discounts and per-collection promotions all
+ * belong to a rules engine, and a rules engine is exactly what a shop does not
+ * need on day one. These three cover the overwhelming majority of real
+ * coupons, and each has an unambiguous arithmetic — which matters more here
+ * than range, because a discount that is a percent of something ambiguous is a
+ * dispute with a customer.
+ */
+export const COUPON_KINDS = ['percentage', 'fixed', 'free_shipping'];
+function decode(row) {
+    return {
+        code: toText(row.code, 'coupon.code'),
+        kind: toText(row.kind, 'coupon.kind'),
+        value: toInt(row.value, 'coupon.value'),
+        currency: toNullableText(row.currency),
+        minSubtotalMinor: toInt(row.min_subtotal_minor, 'coupon.min_subtotal_minor'),
+        startsAt: toNullableText(row.starts_at),
+        endsAt: toNullableText(row.ends_at),
+        maxRedemptions: toNullableInt(row.max_redemptions, 'coupon.max_redemptions'),
+        redemptions: toInt(row.redemptions, 'coupon.redemptions'),
+        active: toBool(row.active),
+        createdAt: toText(row.created_at, 'coupon.created_at'),
+    };
+}
+/** Upper case, trimmed. A coupon typed in lower case is the same coupon. */
+export function normaliseCode(code) {
+    return code.trim().toUpperCase();
+}
+export function createCouponStore(db, now = Date.now) {
+    const d = db.dialect;
+    const table = identifier(TABLES.coupons, d);
+    const redemptions = identifier(TABLES.couponRedemptions, d);
+    async function read(code) {
+        const result = await db.query(sql `select * from ${table} where code = ${normaliseCode(code)}`);
+        const row = result.rows[0];
+        return row === undefined ? null : decode(row);
+    }
+    return {
+        create: async (input) => {
+            const code = normaliseCode(input.code);
+            if (code === '' || code.length > 64) {
+                throw new CogentaError({
+                    code: 'COMMERCE_COUPON_INVALID',
+                    message: 'A coupon code must be between 1 and 64 characters.',
+                    hint: 'Short codes get typed correctly. "SPRING25" beats a UUID.',
+                });
+            }
+            if (input.kind === 'percentage') {
+                const value = input.value ?? 0;
+                if (!Number.isInteger(value) || value <= 0 || value > 10_000) {
+                    throw new CogentaError({
+                        code: 'COMMERCE_COUPON_INVALID',
+                        message: `A percentage coupon must be between 1 and 10000 basis points, got ${String(input.value)}.`,
+                        hint: '25 % off is 2500 basis points. 10000 is everything free.',
+                    });
+                }
+            }
+            if (input.kind === 'fixed') {
+                assertMinor(input.value ?? 0, 'A fixed coupon amount');
+                if ((input.currency ?? null) === null) {
+                    throw new CogentaError({
+                        code: 'COMMERCE_COUPON_INVALID',
+                        message: 'A fixed-amount coupon needs a currency.',
+                        hint: '"£10 off" is not the same offer as "€10 off". A percentage coupon needs no currency.',
+                    });
+                }
+            }
+            if (await read(code)) {
+                throw new CogentaError({
+                    code: 'COMMERCE_COUPON_INVALID',
+                    message: `The coupon code "${code}" already exists.`,
+                    hint: 'Deactivate the existing one, or choose another code.',
+                });
+            }
+            await db.query(sql `
+        insert into ${table} (code, kind, value, currency, min_subtotal_minor, starts_at, ends_at,
+                              max_redemptions, redemptions, active, created_at)
+        values (${code}, ${input.kind}, ${input.value ?? 0},
+                ${input.currency === undefined || input.currency === null ? null : assertCurrency(input.currency)},
+                ${assertMinor(input.minSubtotalMinor ?? 0, 'A coupon minimum')},
+                ${input.startsAt ?? null}, ${input.endsAt ?? null},
+                ${input.maxRedemptions ?? null}, ${0},
+                ${fromBool(input.active ?? true, d)}, ${new Date(now()).toISOString()})`);
+            const created = await read(code);
+            if (created === null) {
+                throw new CogentaError({
+                    code: 'COMMERCE_COUPON_INVALID',
+                    message: 'The coupon was not stored.',
+                    hint: 'Check that the commerce tables exist (ensureCommerceTables).',
+                });
+            }
+            return created;
+        },
+        read,
+        deactivate: async (code) => {
+            await db.query(sql `update ${table} set active = ${fromBool(false, d)} where code = ${normaliseCode(code)}`);
+        },
+        list: async () => {
+            const result = await db.query(sql `select * from ${table} order by created_at desc`);
+            return result.rows.map(decode);
+        },
+        check: async (code, subtotalMinor, currency) => {
+            const coupon = await read(code);
+            if (coupon === null)
+                return { kind: 'unknown' };
+            if (!coupon.active)
+                return { kind: 'inactive' };
+            const at = now();
+            if (coupon.startsAt !== null && new Date(coupon.startsAt).getTime() > at) {
+                return { kind: 'not_yet', startsAt: coupon.startsAt };
+            }
+            if (coupon.endsAt !== null && new Date(coupon.endsAt).getTime() <= at) {
+                return { kind: 'expired', endsAt: coupon.endsAt };
+            }
+            if (coupon.maxRedemptions !== null && coupon.redemptions >= coupon.maxRedemptions) {
+                return { kind: 'exhausted' };
+            }
+            if (subtotalMinor < coupon.minSubtotalMinor) {
+                return { kind: 'below_minimum', minSubtotalMinor: coupon.minSubtotalMinor };
+            }
+            if (coupon.currency !== null && coupon.currency !== currency) {
+                return { kind: 'wrong_currency', currency: coupon.currency };
+            }
+            return { kind: 'ok', coupon };
+        },
+        redeem: async (code, orderId, customerId, tx) => {
+            const normalised = normaliseCode(code);
+            const run = async (executor) => {
+                const claimed = await executor.query(sql `
+          update ${table} set redemptions = redemptions + 1
+          where code = ${normalised}
+            and active = ${fromBool(true, d)}
+            and (max_redemptions is null or redemptions < max_redemptions)`);
+                if (claimed.rowsAffected === 0)
+                    return false;
+                await executor.query(sql `
+          insert into ${redemptions} (id, code, order_id, customer_id, at)
+          values (${newId(now)}, ${normalised}, ${orderId}, ${customerId}, ${new Date(now()).toISOString()})`);
+                return true;
+            };
+            return tx === undefined ? db.transaction(run, { immediate: true }) : run(tx);
+        },
+        release: async (orderId, tx) => {
+            const run = async (executor) => {
+                const found = await executor.query(sql `select code from ${redemptions} where order_id = ${orderId}`);
+                const row = found.rows[0];
+                if (row === undefined)
+                    return;
+                const code = toText(row.code, 'coupon_redemption.code');
+                await executor.query(sql `delete from ${redemptions} where order_id = ${orderId}`);
+                // `redemptions > 0` guards against ever writing a negative count, which
+                // would silently hand out extra redemptions of a one-shot code.
+                await executor.query(sql `update ${table} set redemptions = redemptions - 1 where code = ${code} and redemptions > 0`);
+            };
+            if (tx === undefined)
+                await db.transaction(run, { immediate: true });
+            else
+                await run(tx);
+        },
+    };
+}
+/**
+ * What a coupon takes off a subtotal, and whether it makes shipping free.
+ *
+ * Never more than the subtotal: a £20 coupon on a £15 basket takes £15, not
+ * £20, because the alternative is an order with a negative total — and a
+ * negative total in a payment request is a refund a shop did not intend.
+ */
+export function discountFor(coupon, subtotalMinor) {
+    if (coupon.kind === 'free_shipping')
+        return { discountMinor: 0, freeShipping: true };
+    const raw = coupon.kind === 'percentage' ? applyBasisPoints(subtotalMinor, coupon.value) : coupon.value;
+    return { discountMinor: Math.min(raw, subtotalMinor), freeShipping: false };
+}
+//# sourceMappingURL=store.js.map

package/dist/coupon/store.js.map

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

package/dist/customer/store.d.ts

@@ -0,0 +1,41 @@
+import { type DatabaseHandle } from '@cogenta/core';
+/**
+ * A customer is not a user.
+ *
+ * `@cogenta/auth` models people who sign in to the admin. Most people a shop
+ * sells to never do, and forcing them into that table would mean every buyer
+ * has a role, a session and a credential record they will never use — plus a
+ * password reset flow aimed at an account nobody has. `userId` links the two
+ * when they happen to be the same person, and is null the rest of the time.
+ */
+export interface Customer {
+    readonly id: string;
+    readonly email: string;
+    readonly name: string | null;
+    readonly userId: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface CustomerStore {
+    /** Finds by email or creates. Checkout calls this; it must not fail on a repeat buyer. */
+    ensure(email: string, name?: string | null): Promise<Customer>;
+    read(id: string): Promise<Customer | null>;
+    readByEmail(email: string): Promise<Customer | null>;
+    link(id: string, userId: string | null): Promise<Customer>;
+    list(options?: {
+        readonly search?: string;
+        readonly limit?: number;
+    }): Promise<readonly Customer[]>;
+}
+/**
+ * Lower-cased and trimmed, and that is all.
+ *
+ * No dot-stripping, no plus-tag removal: those are Gmail's rules, not email's,
+ * and applying them would merge two people who are genuinely different on most
+ * other providers. The only normalisation that is safe everywhere is case,
+ * because the domain half is case-insensitive by RFC and no real provider
+ * treats the local half as case-sensitive.
+ */
+export declare function normaliseEmail(email: string): string;
+export declare function createCustomerStore(db: DatabaseHandle, now?: () => number): CustomerStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/customer/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/customer/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAA0B,MAAM,eAAe,CAAA;AAIzF;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC9D,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;IAC1C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;IACpD,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,IAAI,CAAC,OAAO,CAAC,EAAE;QACb,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KACxB,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAA;CACjC;AAsBD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,cAAc,EAClB,GAAG,GAAE,MAAM,MAAiB,GAC3B,aAAa,CA4Ff"}

package/dist/customer/store.js

@@ -0,0 +1,103 @@
+import { CogentaError, identifier, newId, sql } from '@cogenta/core';
+import { toNullableText, toText } from '../rows.js';
+import { TABLES } from '../tables.js';
+function decode(row) {
+    return {
+        id: toText(row.id, 'customer.id'),
+        email: toText(row.email, 'customer.email'),
+        name: toNullableText(row.name),
+        userId: toNullableText(row.user_id),
+        createdAt: toText(row.created_at, 'customer.created_at'),
+        updatedAt: toText(row.updated_at, 'customer.updated_at'),
+    };
+}
+/**
+ * Lower-cased and trimmed, and that is all.
+ *
+ * No dot-stripping, no plus-tag removal: those are Gmail's rules, not email's,
+ * and applying them would merge two people who are genuinely different on most
+ * other providers. The only normalisation that is safe everywhere is case,
+ * because the domain half is case-insensitive by RFC and no real provider
+ * treats the local half as case-sensitive.
+ */
+export function normaliseEmail(email) {
+    return email.trim().toLowerCase();
+}
+export function createCustomerStore(db, now = Date.now) {
+    const d = db.dialect;
+    const table = identifier(TABLES.customers, d);
+    const stamp = () => new Date(now()).toISOString();
+    async function readByEmail(email) {
+        const result = await db.query(sql `select * from ${table} where email = ${normaliseEmail(email)}`);
+        const row = result.rows[0];
+        return row === undefined ? null : decode(row);
+    }
+    async function read(id) {
+        const result = await db.query(sql `select * from ${table} where id = ${id}`);
+        const row = result.rows[0];
+        return row === undefined ? null : decode(row);
+    }
+    return {
+        ensure: async (email, name) => {
+            const normalised = normaliseEmail(email);
+            if (!normalised.includes('@') || normalised.length > 254) {
+                throw new CogentaError({
+                    code: 'COMMERCE_ORDER_NOT_FOUND',
+                    message: 'That is not a usable email address.',
+                    hint: 'An order confirmation has to reach somebody.',
+                });
+            }
+            const existing = await readByEmail(normalised);
+            if (existing !== null) {
+                // A repeat buyer who now gives a name gets it recorded; one who gives
+                // none keeps the name already known, rather than having it wiped.
+                if (name != null && name !== existing.name) {
+                    await db.query(sql `update ${table} set name = ${name}, updated_at = ${stamp()} where id = ${existing.id}`);
+                    const updated = await read(existing.id);
+                    if (updated !== null)
+                        return updated;
+                }
+                return existing;
+            }
+            const id = newId(now);
+            const at = stamp();
+            await db.query(sql `
+        insert into ${table} (id, email, name, user_id, created_at, updated_at)
+        values (${id}, ${normalised}, ${name ?? null}, ${null}, ${at}, ${at})`);
+            const created = await read(id);
+            if (created === null) {
+                throw new CogentaError({
+                    code: 'INTERNAL',
+                    message: 'The customer was not stored.',
+                    hint: 'Check that the commerce tables exist (ensureCommerceTables).',
+                });
+            }
+            return created;
+        },
+        read,
+        readByEmail,
+        link: async (id, userId) => {
+            await db.query(sql `update ${table} set user_id = ${userId}, updated_at = ${stamp()} where id = ${id}`);
+            const linked = await read(id);
+            if (linked === null) {
+                throw new CogentaError({
+                    code: 'INTERNAL',
+                    message: 'This customer does not exist.',
+                    hint: 'It may have been removed.',
+                });
+            }
+            return linked;
+        },
+        list: async (options) => {
+            const search = options?.search?.trim().toLowerCase();
+            const result = search === undefined || search === ''
+                ? await db.query(sql `select * from ${table} order by created_at desc`)
+                : await db.query(sql `
+              select * from ${table}
+              where lower(email) like ${`%${search}%`} or lower(name) like ${`%${search}%`}
+              order by created_at desc`);
+            return result.rows.slice(0, options?.limit ?? 100).map(decode);
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/customer/store.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+export type { CommerceActor, CommercePermission, CommercePermissionLayer, CommercePermissionOptions, } from './admin/permissions.js';
+export { COMMERCE_ANONYMOUS, COMMERCE_PERMISSIONS, createCommercePermissions, DEFAULT_COMMERCE_ROLES, } from './admin/permissions.js';
+export type { CommerceAdminRouter, CommerceAdminRouterOptions, CommerceRequest, CommerceResponse, } from './admin/router.js';
+export { createCommerceAdminRouter } from './admin/router.js';
+export type { Cart, CartLine, CartStatus, CartStore, CartStoreDependencies, OpenCartInput, PricedCart, } from './cart/store.js';
+export { CART_STATUSES, CART_TTL_MS, couponRefusal, createCartStore } from './cart/store.js';
+export type { Totals, TotalsInput, TotalsLine, TotalsLineInput } from './cart/totals.js';
+export { computeTotals } from './cart/totals.js';
+export type { CatalogStore, ProductListOptions, StockOutcome } from './catalog/store.js';
+export { createCatalogStore } from './catalog/store.js';
+export type { ContentRef, CreateProductInput, CreateVariantInput, Product, ProductStatus, StockRequest, StockShortfall, UpdateProductInput, UpdateVariantInput, Variant, } from './catalog/types.js';
+export { PRODUCT_STATUSES } from './catalog/types.js';
+export type { Coupon, CouponCheck, CouponKind, CouponStore, CreateCouponInput, } from './coupon/store.js';
+export { COUPON_KINDS, createCouponStore, discountFor, normaliseCode, } from './coupon/store.js';
+export type { Customer, CustomerStore } from './customer/store.js';
+export { createCustomerStore, normaliseEmail } from './customer/store.js';
+export type { PdfInvoiceDocument, PdfLine } from './invoice/pdf.js';
+export { renderInvoicePdf } from './invoice/pdf.js';
+export type { Invoice, InvoiceDocument, InvoiceStore, InvoiceStoreDependencies, IssueInvoiceInput, SellerDetails, } from './invoice/store.js';
+export { createInvoiceStore, formatInvoiceNumber, pdfDocumentFor } from './invoice/store.js';
+export type { Money } from './money.js';
+export { applyBasisPoints, assertCurrency, assertMinor, assertSameCurrency, distribute, formatMoney, minorUnitExponent, normaliseCurrency, } from './money.js';
+export type { OrderListOptions, OrderStore, OrderStoreDependencies, PlaceOrderInput, PlaceOrderOutcome, } from './order/store.js';
+export { createOrderStore, referenceFrom } from './order/store.js';
+export type { Order, OrderEvent, OrderEventKind, OrderLine, OrderStatus } from './order/types.js';
+export { assertTransition, canTransition, holdsStock, ORDER_EVENT_KINDS, ORDER_STATUSES, } from './order/types.js';
+export { createManualPaymentGateway, manualPaymentDriver, transferReference, } from './payment/manual.js';
+export type { PaymentRegistryOptions } from './payment/registry.js';
+export { createPaymentRegistry } from './payment/registry.js';
+export type { PaymentStore, PaymentStoreDependencies } from './payment/store.js';
+export { createPaymentStore } from './payment/store.js';
+export { stripePaymentDriver } from './payment/stripe.js';
+export type { DriverRefundRequest, DriverRefundResult, PaymentConfig, PaymentDriver, PaymentEvent, PaymentGateway, PaymentRecord, PaymentStatus, RefundRecord, StartedPayment, StartPaymentRequest, } from './payment/types.js';
+export { PAYMENT_STATUSES } from './payment/types.js';
+export type { CarrierRateProvider, CreateShippingMethodInput, ShipmentBasis, ShippingKind, ShippingMethod, ShippingQuote, ShippingStore, ShippingStoreOptions, } from './shipping/store.js';
+export { createShippingStore, SHIPPING_KINDS, storedRate } from './shipping/store.js';
+export type { BillingRunResult, CreateSubscriptionInput, IntervalUnit, Subscription, SubscriptionCycle, SubscriptionStatus, SubscriptionStore, SubscriptionStoreDependencies, } from './subscription/store.js';
+export { advancePeriod, createSubscriptionStore, INTERVAL_UNITS, SUBSCRIPTION_STATUSES, } from './subscription/store.js';
+export { ensureCommerceTables, TABLES } from './tables.js';
+export type { CreateTaxRuleInput, TaxOutcome, TaxRule, TaxStore, TaxZone, } from './tax/store.js';
+export { createTaxStore, taxFor } from './tax/store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,23 @@
+export { COMMERCE_ANONYMOUS, COMMERCE_PERMISSIONS, createCommercePermissions, DEFAULT_COMMERCE_ROLES, } from './admin/permissions.js';
+export { createCommerceAdminRouter } from './admin/router.js';
+export { CART_STATUSES, CART_TTL_MS, couponRefusal, createCartStore } from './cart/store.js';
+export { computeTotals } from './cart/totals.js';
+export { createCatalogStore } from './catalog/store.js';
+export { PRODUCT_STATUSES } from './catalog/types.js';
+export { COUPON_KINDS, createCouponStore, discountFor, normaliseCode, } from './coupon/store.js';
+export { createCustomerStore, normaliseEmail } from './customer/store.js';
+export { renderInvoicePdf } from './invoice/pdf.js';
+export { createInvoiceStore, formatInvoiceNumber, pdfDocumentFor } from './invoice/store.js';
+export { applyBasisPoints, assertCurrency, assertMinor, assertSameCurrency, distribute, formatMoney, minorUnitExponent, normaliseCurrency, } from './money.js';
+export { createOrderStore, referenceFrom } from './order/store.js';
+export { assertTransition, canTransition, holdsStock, ORDER_EVENT_KINDS, ORDER_STATUSES, } from './order/types.js';
+export { createManualPaymentGateway, manualPaymentDriver, transferReference, } from './payment/manual.js';
+export { createPaymentRegistry } from './payment/registry.js';
+export { createPaymentStore } from './payment/store.js';
+export { stripePaymentDriver } from './payment/stripe.js';
+export { PAYMENT_STATUSES } from './payment/types.js';
+export { createShippingStore, SHIPPING_KINDS, storedRate } from './shipping/store.js';
+export { advancePeriod, createSubscriptionStore, INTERVAL_UNITS, SUBSCRIPTION_STATUSES, } from './subscription/store.js';
+export { ensureCommerceTables, TABLES } from './tables.js';
+export { createTaxStore, taxFor } from './tax/store.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,wBAAwB,CAAA;AAO/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAU7D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAE5F,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAavD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAQrD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AASnD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAE5F,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAQnB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAElE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,cAAc,GACf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAczD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAWrD,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAWrF,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,qBAAqB,GACtB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAQ1D,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/invoice/pdf.d.ts

@@ -0,0 +1,67 @@
+/**
+ * An invoice rendered as a PDF, written byte by byte, with no dependency.
+ *
+ * Rule R9 asks for zero dependencies before a small one and rule R10 forbids
+ * native code, which rules out `pdfkit` (a large tree) and `puppeteer` (a
+ * browser download plus a native binary). A PDF that only has to place text on
+ * A4 in a base-14 font is a few hundred lines of byte assembly, so that is what
+ * this is.
+ *
+ * Three decisions shape the file it produces:
+ *
+ * - **Base-14 fonts only.** `/Helvetica` and `/Helvetica-Bold` are guaranteed
+ *   present in every conforming reader, so nothing is embedded and an invoice
+ *   stays a few kilobytes. The price is `WinAnsiEncoding`: one byte per glyph,
+ *   and a character outside that repertoire becomes `?` rather than a broken
+ *   file.
+ * - **No compression.** A `/FlateDecode` stream would need zlib and would make
+ *   the output unreadable to anything but a PDF parser. Uncompressed streams
+ *   keep an invoice greppable and the whole file auditable by eye.
+ * - **Deterministic to the byte.** Nothing here reads the clock or a random
+ *   source. The same document renders to the same bytes forever, so a hash
+ *   stored next to an invoice still means something a year later. `/CreationDate`
+ *   is derived from the document's own `issuedAt` or omitted entirely.
+ */
+/** One row of the line-item table. One string per column. */
+export interface PdfLine {
+    readonly cells: readonly string[];
+}
+/**
+ * Everything the renderer needs, already formatted for a human.
+ *
+ * There is no `Money`, no locale and no date here on purpose: formatting money
+ * and dates is the caller's job (it knows the locale and the currency), and
+ * keeping this structure made of plain strings is what makes the output
+ * reproducible from stored data alone.
+ */
+export interface PdfInvoiceDocument {
+    /** Heading, e.g. `Invoice`. Whatever language the shop sells in. */
+    readonly title: string;
+    /** The invoice number, printed verbatim. */
+    readonly number: string;
+    /** Already formatted for a human, e.g. `2026-03-12` or `12 March 2026`. */
+    readonly issuedAt: string;
+    /** Address block, one string per line. The first line is printed bold. */
+    readonly seller: readonly string[];
+    /** Address block, one string per line. The first line is printed bold. */
+    readonly buyer: readonly string[];
+    /** Table header. Repeated at the top of every continuation page. */
+    readonly columns: readonly string[];
+    readonly lines: readonly PdfLine[];
+    /** Label / amount pairs. The last pair is printed bold. */
+    readonly totals: readonly (readonly [string, string])[];
+    /** Legal mentions, payment terms — printed at the foot of every page. */
+    readonly footer?: string;
+}
+/**
+ * The one entry point: a document in, a complete PDF file out.
+ *
+ * Total by design — it never throws. Every input that could be called invalid
+ * has a defined, lossless rendering instead: a row shorter than the header is
+ * padded, a row longer than the header widens the table, an unrepresentable
+ * character becomes `?`, and text too wide for its column wraps rather than
+ * being cut. An invoice is a legal document; losing a line to a validation
+ * decision taken inside a renderer would be worse than printing it oddly.
+ */
+export declare function renderInvoicePdf(document: PdfInvoiceDocument): Uint8Array;
+//# sourceMappingURL=pdf.d.ts.map

package/dist/invoice/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../src/invoice/pdf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,6DAA6D;AAC7D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAA;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAA;IACvD,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAiED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,UAAU,CAEzE"}