@cogenta/commerce 0.2.0

package/dist/tables.js

@@ -0,0 +1,383 @@
+import { identifier, sql, unsafeRaw, } 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 const TABLES = {
+    products: 'cogenta_commerce_products',
+    variants: 'cogenta_commerce_variants',
+    customers: 'cogenta_commerce_customers',
+    carts: 'cogenta_commerce_carts',
+    cartLines: 'cogenta_commerce_cart_lines',
+    orders: 'cogenta_commerce_orders',
+    orderLines: 'cogenta_commerce_order_lines',
+    orderEvents: 'cogenta_commerce_order_events',
+    payments: 'cogenta_commerce_payments',
+    refunds: 'cogenta_commerce_refunds',
+    taxRules: 'cogenta_commerce_tax_rules',
+    shippingMethods: 'cogenta_commerce_shipping_methods',
+    coupons: 'cogenta_commerce_coupons',
+    couponRedemptions: 'cogenta_commerce_coupon_redemptions',
+    invoices: 'cogenta_commerce_invoices',
+    invoiceSequences: 'cogenta_commerce_invoice_sequences',
+    subscriptions: 'cogenta_commerce_subscriptions',
+    subscriptionCycles: 'cogenta_commerce_subscription_cycles',
+};
+/** `varchar` on Postgres/MySQL, `text` on SQLite — encapsulated once, here. */
+function textColumn(dialect, length) {
+    return unsafeRaw(dialect === 'sqlite' ? 'text' : `varchar(${length})`);
+}
+function booleanColumn(dialect) {
+    return unsafeRaw(dialect === 'postgres' ? 'boolean' : 'tinyint');
+}
+/**
+ * Every amount and every quantity is a `bigint`.
+ *
+ * `integer` would hold any realistic price, and it is still the wrong choice:
+ * the one place a 32-bit overflow shows up is a yearly turnover total in a
+ * minor-unit currency, i.e. exactly the number an accountant looks at. Eight
+ * bytes to never think about it again.
+ */
+function integerColumn() {
+    return unsafeRaw('bigint');
+}
+/**
+ * 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 async function ensureCommerceTables(db) {
+    const d = db.dialect;
+    const t1024 = textColumn(d, 1024);
+    const t255 = textColumn(d, 255);
+    const t64 = textColumn(d, 64);
+    const t8 = textColumn(d, 8);
+    const bool = booleanColumn(d);
+    const int = integerColumn();
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.products, d)} (
+      id ${t64} not null primary key,
+      -- Stable, human-readable, used in URLs and in the admin. Unique.
+      handle ${t255} not null unique,
+      title ${t255} not null,
+      status ${t64} not null,
+      -- The optional link to the editorial face of this product (contract A).
+      -- Deliberately NOT a foreign key: the entries table of a collection is
+      -- created by contract A's migration engine from the schema the *site*
+      -- declares, so its name is not known here. Checked in application code.
+      content_collection ${t255},
+      content_entry_id ${t64},
+      created_at ${t64} not null,
+      updated_at ${t64} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.variants, d)} (
+      id ${t64} not null primary key,
+      product_id ${t64} not null,
+      sku ${t255} not null unique,
+      title ${t255} not null,
+      price_minor ${int} not null,
+      currency ${t8} not null,
+      -- Units physically available. Never negative: every write that lowers it
+      -- carries its own "on_hand >= quantity" guard (see catalog/store.ts).
+      on_hand ${int} not null,
+      -- When true this variant sells past zero. The guard is then skipped, and
+      -- that is the *only* way on_hand goes below zero — an explicit choice
+      -- per variant, never an accident.
+      allow_backorder ${bool} not null,
+      -- Grams. Integers again, and for the same reason as money.
+      weight_grams ${int} not null,
+      tax_category ${t64} not null,
+      position ${int} not null,
+      created_at ${t64} not null,
+      updated_at ${t64} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.customers, d)} (
+      id ${t64} not null primary key,
+      email ${t255} not null unique,
+      name ${t255},
+      -- Optional link to a @cogenta/auth account. A customer is not a user:
+      -- most shops sell to people who never sign in to the admin.
+      user_id ${t64},
+      created_at ${t64} not null,
+      updated_at ${t64} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.carts, d)} (
+      id ${t64} not null primary key,
+      customer_id ${t64},
+      -- An anonymous shopper. Opaque, supplied by the transport, never a
+      -- session token of @cogenta/auth: a cart must survive signing out.
+      session_key ${t255},
+      currency ${t8} not null,
+      coupon_code ${t64},
+      shipping_country ${t8},
+      shipping_region ${t64},
+      shipping_method_id ${t64},
+      status ${t64} not null,
+      order_id ${t64},
+      created_at ${t64} not null,
+      updated_at ${t64} not null,
+      expires_at ${t64} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.cartLines, d)} (
+      id ${t64} not null primary key,
+      cart_id ${t64} not null,
+      variant_id ${t64} not null,
+      quantity ${int} not null,
+      -- The price when the line was added. A cart shows what the shopper was
+      -- told; the order re-reads the live price and says so if it moved.
+      unit_price_minor ${int} not null,
+      created_at ${t64} not null,
+      updated_at ${t64} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.orders, d)} (
+      id ${t64} not null primary key,
+      -- Human-facing order reference. Unique, and unrelated to the invoice
+      -- number: an order that is never invoiced still needs to be named.
+      reference ${t64} not null unique,
+      customer_id ${t64},
+      email ${t255} not null,
+      status ${t64} not null,
+      currency ${t8} not null,
+      subtotal_minor ${int} not null,
+      discount_minor ${int} not null,
+      shipping_minor ${int} not null,
+      tax_minor ${int} not null,
+      total_minor ${int} not null,
+      coupon_code ${t64},
+      shipping_country ${t8},
+      shipping_region ${t64},
+      shipping_method_id ${t64},
+      shipping_method_label ${t255},
+      placed_at ${t64} not null,
+      updated_at ${t64} not null,
+      -- Set when a subscription cycle produced this order, null otherwise.
+      subscription_id ${t64}
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.orderLines, d)} (
+      id ${t64} not null primary key,
+      order_id ${t64} not null,
+      variant_id ${t64} not null,
+      -- Copied, not joined. A product renamed or deleted next year must not
+      -- change what an order from last year says it sold.
+      sku ${t255} not null,
+      title ${t255} not null,
+      quantity ${int} not null,
+      unit_price_minor ${int} not null,
+      subtotal_minor ${int} not null,
+      discount_minor ${int} not null,
+      tax_minor ${int} not null,
+      tax_rate_bp ${int} not null,
+      total_minor ${int} not null,
+      position ${int} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.orderEvents, d)} (
+      id ${t64} not null primary key,
+      order_id ${t64} not null,
+      at ${t64} not null,
+      kind ${t64} not null,
+      from_status ${t64},
+      to_status ${t64},
+      actor_id ${t64},
+      note ${t1024}
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.payments, d)} (
+      id ${t64} not null primary key,
+      order_id ${t64} not null,
+      driver ${t64} not null,
+      -- The gateway's own id. Null for a driver that settles offline until a
+      -- human records the transfer reference.
+      external_id ${t255},
+      status ${t64} not null,
+      amount_minor ${int} not null,
+      currency ${t8} not null,
+      -- Free-form, driver-specific, shown to the shopper: bank details for a
+      -- transfer, a redirect URL for a gateway.
+      instructions ${t1024},
+      created_at ${t64} not null,
+      updated_at ${t64} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.refunds, d)} (
+      id ${t64} not null primary key,
+      payment_id ${t64} not null,
+      order_id ${t64} not null,
+      external_id ${t255},
+      status ${t64} not null,
+      amount_minor ${int} not null,
+      currency ${t8} not null,
+      reason ${t255},
+      created_at ${t64} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.taxRules, d)} (
+      id ${t64} not null primary key,
+      -- Null country means "everywhere the more specific rules do not cover".
+      country ${t8},
+      region ${t64},
+      tax_category ${t64} not null,
+      name ${t255} not null,
+      rate_bp ${int} not null,
+      -- True when the catalogue price already contains this tax (the European
+      -- convention). The order then shows the tax it *contains*, never adds it.
+      included_in_price ${bool} not null,
+      -- Higher wins. Makes "France, reduced rate" beat "anywhere, standard".
+      priority ${int} not null,
+      active ${bool} not null,
+      created_at ${t64} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.shippingMethods, d)} (
+      id ${t64} not null primary key,
+      label ${t255} not null,
+      country ${t8},
+      region ${t64},
+      kind ${t64} not null,
+      currency ${t8} not null,
+      amount_minor ${int} not null,
+      per_kg_minor ${int} not null,
+      free_over_minor ${int},
+      -- Names a registered carrier driver, or null for a plain stored rate.
+      carrier ${t64},
+      position ${int} not null,
+      active ${bool} not null,
+      created_at ${t64} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.coupons, d)} (
+      code ${t64} not null primary key,
+      kind ${t64} not null,
+      -- Basis points for a percentage coupon, minor units for a fixed one,
+      -- ignored for free shipping. One column because a coupon has exactly
+      -- one number, and three nullable ones would only invite two being set.
+      value ${int} not null,
+      currency ${t8},
+      min_subtotal_minor ${int} not null,
+      starts_at ${t64},
+      ends_at ${t64},
+      -- Null means unlimited. Zero means exhausted, not unlimited.
+      max_redemptions ${int},
+      redemptions ${int} not null,
+      active ${bool} not null,
+      created_at ${t64} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.couponRedemptions, d)} (
+      id ${t64} not null primary key,
+      code ${t64} not null,
+      order_id ${t64} not null unique,
+      customer_id ${t64},
+      at ${t64} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.invoices, d)} (
+      id ${t64} not null primary key,
+      -- One invoice per order. The unique constraint is the last line of
+      -- defence behind the transaction: a double issue burns a number.
+      order_id ${t64} not null unique,
+      series ${t64} not null,
+      seq ${int} not null,
+      number ${t64} not null unique,
+      issued_at ${t64} not null,
+      currency ${t8} not null,
+      total_minor ${int} not null,
+      -- The whole document, frozen at issue. An invoice must say what it said
+      -- the day it was issued, whatever the order becomes afterwards.
+      document text not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.invoiceSequences, d)} (
+      series ${t64} not null primary key,
+      next_seq ${int} not null
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.subscriptions, d)} (
+      id ${t64} not null primary key,
+      customer_id ${t64} not null,
+      variant_id ${t64} not null,
+      quantity ${int} not null,
+      status ${t64} not null,
+      interval_unit ${t64} not null,
+      interval_count ${int} not null,
+      price_minor ${int} not null,
+      currency ${t8} not null,
+      payment_driver ${t64} not null,
+      current_period_start ${t64} not null,
+      current_period_end ${t64} not null,
+      -- The clock this store reads to decide what is due. Kept as its own
+      -- column rather than derived, so a paused subscription simply stops
+      -- moving it forward.
+      next_billing_at ${t64} not null,
+      shipping_country ${t8},
+      shipping_region ${t64},
+      created_at ${t64} not null,
+      updated_at ${t64} not null,
+      cancelled_at ${t64}
+    )`);
+    await db.query(sql `
+    create table if not exists ${identifier(TABLES.subscriptionCycles, d)} (
+      id ${t64} not null primary key,
+      subscription_id ${t64} not null,
+      period_start ${t64} not null,
+      period_end ${t64} not null,
+      -- Unique per period: the guard that makes billing idempotent, so running
+      -- the biller twice in one minute cannot charge twice.
+      period_key ${t255} not null unique,
+      order_id ${t64},
+      status ${t64} not null,
+      created_at ${t64} not null
+    )`);
+    await ensureIndexes(db);
+}
+/**
+ * Indexes for the reads this package actually performs.
+ *
+ * Created separately and after the tables, because `create index if not
+ * exists` is the one piece of DDL the three dialects spell differently enough
+ * to be worth isolating: MySQL before 8.0.29 has no `if not exists` for
+ * indexes at all, so a duplicate-index error there is swallowed rather than
+ * guarded against.
+ */
+async function ensureIndexes(db) {
+    const d = db.dialect;
+    const wanted = [
+        ['cogenta_commerce_variants_product', TABLES.variants, 'product_id'],
+        ['cogenta_commerce_cart_lines_cart', TABLES.cartLines, 'cart_id'],
+        ['cogenta_commerce_order_lines_order', TABLES.orderLines, 'order_id'],
+        ['cogenta_commerce_order_events_order', TABLES.orderEvents, 'order_id'],
+        ['cogenta_commerce_orders_customer', TABLES.orders, 'customer_id'],
+        ['cogenta_commerce_payments_order', TABLES.payments, 'order_id'],
+        ['cogenta_commerce_refunds_payment', TABLES.refunds, 'payment_id'],
+        ['cogenta_commerce_cycles_subscription', TABLES.subscriptionCycles, 'subscription_id'],
+    ];
+    for (const [name, table, column] of wanted) {
+        const statement = sql `create index ${identifier(name, d)} on ${identifier(table, d)} (${identifier(column, d)})`;
+        try {
+            await db.query(d === 'mysql'
+                ? statement
+                : sql `create index if not exists ${identifier(name, d)} on ${identifier(table, d)} (${identifier(column, d)})`);
+        }
+        catch {
+            // Already there. The only failure this swallows is "duplicate index",
+            // and a genuinely broken schema fails loudly on the next real query
+            // rather than here.
+        }
+    }
+}
+//# sourceMappingURL=tables.js.map

package/dist/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../src/tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EAEV,GAAG,EACH,SAAS,GACV,MAAM,eAAe,CAAA;AAEtB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,QAAQ,EAAE,2BAA2B;IACrC,QAAQ,EAAE,2BAA2B;IACrC,SAAS,EAAE,4BAA4B;IACvC,KAAK,EAAE,wBAAwB;IAC/B,SAAS,EAAE,6BAA6B;IACxC,MAAM,EAAE,yBAAyB;IACjC,UAAU,EAAE,8BAA8B;IAC1C,WAAW,EAAE,+BAA+B;IAC5C,QAAQ,EAAE,2BAA2B;IACrC,OAAO,EAAE,0BAA0B;IACnC,QAAQ,EAAE,4BAA4B;IACtC,eAAe,EAAE,mCAAmC;IACpD,OAAO,EAAE,0BAA0B;IACnC,iBAAiB,EAAE,qCAAqC;IACxD,QAAQ,EAAE,2BAA2B;IACrC,gBAAgB,EAAE,oCAAoC;IACtD,aAAa,EAAE,gCAAgC;IAC/C,kBAAkB,EAAE,sCAAsC;CAClD,CAAA;AAEV,+EAA+E;AAC/E,SAAS,UAAU,CAAC,OAAwB,EAAE,MAAc;IAC1D,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,GAAG,CAAC,CAAA;AACxE,CAAC;AAED,SAAS,aAAa,CAAC,OAAwB;IAC7C,OAAO,SAAS,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AAClE,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa;IACpB,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAA;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EAAkB;IAC3D,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAA;IACpB,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC/B,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC7B,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC3B,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;IAC7B,MAAM,GAAG,GAAG,aAAa,EAAE,CAAA;IAE3B,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;WACpD,GAAG;;eAEC,IAAI;cACL,IAAI;eACH,GAAG;;;;;2BAKS,IAAI;yBACN,GAAG;mBACT,GAAG;mBACH,GAAG;MAChB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;WACpD,GAAG;mBACK,GAAG;YACV,IAAI;cACF,IAAI;oBACE,GAAG;iBACN,EAAE;;;gBAGH,GAAG;;;;wBAIK,IAAI;;qBAEP,GAAG;qBACH,GAAG;iBACP,GAAG;mBACD,GAAG;mBACH,GAAG;MAChB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;WACrD,GAAG;cACA,IAAI;aACL,IAAI;;;gBAGD,GAAG;mBACA,GAAG;mBACH,GAAG;MAChB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;WACjD,GAAG;oBACM,GAAG;;;oBAGH,IAAI;iBACP,EAAE;oBACC,GAAG;yBACE,EAAE;wBACH,GAAG;2BACA,GAAG;eACf,GAAG;iBACD,GAAG;mBACD,GAAG;mBACH,GAAG;mBACH,GAAG;MAChB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;WACrD,GAAG;gBACE,GAAG;mBACA,GAAG;iBACL,GAAG;;;yBAGK,GAAG;mBACT,GAAG;mBACH,GAAG;MAChB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;WAClD,GAAG;;;kBAGI,GAAG;oBACD,GAAG;cACT,IAAI;eACH,GAAG;iBACD,EAAE;uBACI,GAAG;uBACH,GAAG;uBACH,GAAG;kBACR,GAAG;oBACD,GAAG;oBACH,GAAG;yBACE,EAAE;wBACH,GAAG;2BACA,GAAG;8BACA,IAAI;kBAChB,GAAG;mBACF,GAAG;;wBAEE,GAAG;MACrB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;WACtD,GAAG;iBACG,GAAG;mBACD,GAAG;;;YAGV,IAAI;cACF,IAAI;iBACD,GAAG;yBACK,GAAG;uBACL,GAAG;uBACH,GAAG;kBACR,GAAG;oBACD,GAAG;oBACH,GAAG;iBACN,GAAG;MACd,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;WACvD,GAAG;iBACG,GAAG;WACT,GAAG;aACD,GAAG;oBACI,GAAG;kBACL,GAAG;iBACJ,GAAG;aACP,KAAK;MACZ,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;WACpD,GAAG;iBACG,GAAG;eACL,GAAG;;;oBAGE,IAAI;eACT,GAAG;qBACG,GAAG;iBACP,EAAE;;;qBAGE,KAAK;mBACP,GAAG;mBACH,GAAG;MAChB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;WACnD,GAAG;mBACK,GAAG;iBACL,GAAG;oBACA,IAAI;eACT,GAAG;qBACG,GAAG;iBACP,EAAE;eACJ,IAAI;mBACA,GAAG;MAChB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;WACpD,GAAG;;gBAEE,EAAE;eACH,GAAG;qBACG,GAAG;aACX,IAAI;gBACD,GAAG;;;0BAGO,IAAI;;iBAEb,GAAG;eACL,IAAI;mBACA,GAAG;MAChB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;WAC3D,GAAG;cACA,IAAI;gBACF,EAAE;eACH,GAAG;aACL,GAAG;iBACC,EAAE;qBACE,GAAG;qBACH,GAAG;wBACA,GAAG;;gBAEX,GAAG;iBACF,GAAG;eACL,IAAI;mBACA,GAAG;MAChB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;aACjD,GAAG;aACH,GAAG;;;;cAIF,GAAG;iBACA,EAAE;2BACQ,GAAG;kBACZ,GAAG;gBACL,GAAG;;wBAEK,GAAG;oBACP,GAAG;eACR,IAAI;mBACA,GAAG;MAChB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;WAC7D,GAAG;aACD,GAAG;iBACC,GAAG;oBACA,GAAG;WACZ,GAAG;MACR,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;WACpD,GAAG;;;iBAGG,GAAG;eACL,GAAG;YACN,GAAG;eACA,GAAG;kBACA,GAAG;iBACJ,EAAE;oBACC,GAAG;;;;MAIjB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;eACxD,GAAG;iBACD,GAAG;MACd,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;WACzD,GAAG;oBACM,GAAG;mBACJ,GAAG;iBACL,GAAG;eACL,GAAG;sBACI,GAAG;uBACF,GAAG;oBACN,GAAG;iBACN,EAAE;uBACI,GAAG;6BACG,GAAG;2BACL,GAAG;;;;wBAIN,GAAG;yBACF,EAAE;wBACH,GAAG;mBACR,GAAG;mBACH,GAAG;qBACD,GAAG;MAClB,CAAC,CAAA;IAEL,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iCACa,UAAU,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC;WAC9D,GAAG;wBACU,GAAG;qBACN,GAAG;mBACL,GAAG;;;mBAGH,IAAI;iBACN,GAAG;eACL,GAAG;mBACC,GAAG;MAChB,CAAC,CAAA;IAEL,MAAM,aAAa,CAAC,EAAE,CAAC,CAAA;AACzB,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,aAAa,CAAC,EAAkB;IAC7C,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAA;IACpB,MAAM,MAAM,GAAmD;QAC7D,CAAC,mCAAmC,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC;QACpE,CAAC,kCAAkC,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC;QACjE,CAAC,oCAAoC,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC;QACrE,CAAC,qCAAqC,EAAE,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC;QACvE,CAAC,kCAAkC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;QAClE,CAAC,iCAAiC,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC;QAChE,CAAC,kCAAkC,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC;QAClE,CAAC,sCAAsC,EAAE,MAAM,CAAC,kBAAkB,EAAE,iBAAiB,CAAC;KACvF,CAAA;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,GAAG,CAAA,gBAAgB,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAA;QAChH,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CACZ,CAAC,KAAK,OAAO;gBACX,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,GAAG,CAAA,8BAA8B,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CACjH,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;YACtE,oEAAoE;YACpE,oBAAoB;QACtB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/tax/store.d.ts

@@ -0,0 +1,68 @@
+import { type DatabaseHandle } from '@cogenta/core';
+/**
+ * Where a shopper is, as far as tax is concerned.
+ *
+ * Country and an optional region, and nothing else. Not a postcode: postcode
+ * tax (US local sales tax) is a database problem, not a rules problem, and
+ * pretending to solve it with three stored rows would be worse than saying so.
+ * A site that needs it registers a carrier-style rule source of its own.
+ */
+export interface TaxZone {
+    /** ISO 3166-1 alpha-2, upper case. */
+    readonly country: string;
+    /** A state, province or county code. Free text, matched exactly. */
+    readonly region?: string | null;
+}
+export interface TaxRule {
+    readonly id: string;
+    readonly country: string | null;
+    readonly region: string | null;
+    readonly taxCategory: string;
+    readonly name: string;
+    readonly rateBp: number;
+    /**
+     * True when the catalogue price already contains this tax — the European
+     * convention. The order then shows the tax it *contains*; it never adds it.
+     */
+    readonly includedInPrice: boolean;
+    readonly priority: number;
+    readonly active: boolean;
+    readonly createdAt: string;
+}
+export interface CreateTaxRuleInput {
+    readonly country?: string | null;
+    readonly region?: string | null;
+    readonly taxCategory?: string;
+    readonly name: string;
+    readonly rateBp: number;
+    readonly includedInPrice?: boolean;
+    readonly priority?: number;
+    readonly active?: boolean;
+}
+/** What one line owes. */
+export interface TaxOutcome {
+    readonly rateBp: number;
+    readonly taxMinor: number;
+    readonly includedInPrice: boolean;
+    readonly ruleName: string | null;
+}
+export interface TaxStore {
+    createRule(input: CreateTaxRuleInput): Promise<TaxRule>;
+    deleteRule(id: string): Promise<void>;
+    listRules(): Promise<readonly TaxRule[]>;
+    /** The one rule that applies, or null when nothing does. */
+    resolve(zone: TaxZone | null, taxCategory: string): Promise<TaxRule | null>;
+}
+export declare function createTaxStore(db: DatabaseHandle, now?: () => number): TaxStore;
+/**
+ * What one taxable amount owes under a rule.
+ *
+ * Two arithmetics, and getting them the wrong way round is the classic
+ * European VAT bug. When tax is **added**, it is `amount × rate`. When it is
+ * **included**, the amount already contains it, so the tax is
+ * `amount − amount / (1 + rate)`, computed in integers as
+ * `amount × rate / (10000 + rate)`. Applying the first formula to a
+ * tax-inclusive price overcharges by the tax on the tax.
+ */
+export declare function taxFor(amountMinor: number, rule: TaxRule | null): TaxOutcome;
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/tax/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAA0B,MAAM,eAAe,CAAA;AAKzF;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,0BAA0B;AAC1B,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACvD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,SAAS,IAAI,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IACxC,4DAA4D;IAC5D,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;CAC5E;AAoDD,wBAAgB,cAAc,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,GAAE,MAAM,MAAiB,GAAG,QAAQ,CAmEzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,UAAU,CAe5E"}

package/dist/tax/store.js

@@ -0,0 +1,126 @@
+import { CogentaError, identifier, newId, sql } from '@cogenta/core';
+import { applyBasisPoints } from '../money.js';
+import { fromBool, toBool, toInt, toNullableText, toText } from '../rows.js';
+import { TABLES } from '../tables.js';
+function decode(row) {
+    return {
+        id: toText(row.id, 'tax_rule.id'),
+        country: toNullableText(row.country),
+        region: toNullableText(row.region),
+        taxCategory: toText(row.tax_category, 'tax_rule.tax_category'),
+        name: toText(row.name, 'tax_rule.name'),
+        rateBp: toInt(row.rate_bp, 'tax_rule.rate_bp'),
+        includedInPrice: toBool(row.included_in_price),
+        priority: toInt(row.priority, 'tax_rule.priority'),
+        active: toBool(row.active),
+        createdAt: toText(row.created_at, 'tax_rule.created_at'),
+    };
+}
+/**
+ * How specific a rule is for a given zone, or null when it does not apply.
+ *
+ * Specificity, not order in the table: "France, Corsica" must beat "France",
+ * which must beat "anywhere". Resolving by insertion order would make the
+ * answer depend on the sequence an operator happened to type the rules in,
+ * which is exactly the kind of invisible dependency a shop discovers at the
+ * worst moment.
+ */
+function specificity(rule, zone) {
+    if (rule.country !== null) {
+        if (zone === null)
+            return null;
+        if (rule.country !== zone.country)
+            return null;
+    }
+    if (rule.region !== null) {
+        const region = zone?.region ?? null;
+        if (region === null || rule.region !== region)
+            return null;
+        return 2;
+    }
+    return rule.country === null ? 0 : 1;
+}
+export function createTaxStore(db, now = Date.now) {
+    const d = db.dialect;
+    const table = identifier(TABLES.taxRules, d);
+    return {
+        createRule: async (input) => {
+            if (!Number.isInteger(input.rateBp) || input.rateBp < 0 || input.rateBp > 100_000) {
+                throw new CogentaError({
+                    code: 'COMMERCE_TAX_RULE_INVALID',
+                    message: `A tax rate must be a whole number of basis points between 0 and 100000, got ${String(input.rateBp)}.`,
+                    hint: '20 % is 2000 basis points. 5.5 % is 550.',
+                });
+            }
+            const id = newId(now);
+            await db.query(sql `
+        insert into ${table} (id, country, region, tax_category, name, rate_bp, included_in_price, priority, active, created_at)
+        values (${id}, ${input.country?.toUpperCase() ?? null}, ${input.region ?? null},
+                ${input.taxCategory ?? 'standard'}, ${input.name}, ${input.rateBp},
+                ${fromBool(input.includedInPrice ?? true, d)}, ${input.priority ?? 0},
+                ${fromBool(input.active ?? true, d)}, ${new Date(now()).toISOString()})`);
+            const result = await db.query(sql `select * from ${table} where id = ${id}`);
+            const row = result.rows[0];
+            if (row === undefined) {
+                throw new CogentaError({
+                    code: 'COMMERCE_TAX_RULE_INVALID',
+                    message: 'The tax rule was not stored.',
+                    hint: 'Check that the commerce tables exist (ensureCommerceTables).',
+                });
+            }
+            return decode(row);
+        },
+        deleteRule: async (id) => {
+            await db.query(sql `delete from ${table} where id = ${id}`);
+        },
+        listRules: async () => {
+            const result = await db.query(sql `select * from ${table} order by priority desc, created_at asc`);
+            return result.rows.map(decode);
+        },
+        resolve: async (zone, taxCategory) => {
+            const result = await db.query(sql `select * from ${table} where tax_category = ${taxCategory}`);
+            let best = null;
+            let bestScore = -1;
+            for (const rule of result.rows.map(decode)) {
+                if (!rule.active)
+                    continue;
+                const score = specificity(rule, zone);
+                if (score === null)
+                    continue;
+                // Priority first, then specificity, then oldest — a total order, so
+                // two equally good rules always resolve the same way.
+                const combined = rule.priority * 10 + score;
+                if (combined > bestScore) {
+                    best = rule;
+                    bestScore = combined;
+                }
+            }
+            return best;
+        },
+    };
+}
+/**
+ * What one taxable amount owes under a rule.
+ *
+ * Two arithmetics, and getting them the wrong way round is the classic
+ * European VAT bug. When tax is **added**, it is `amount × rate`. When it is
+ * **included**, the amount already contains it, so the tax is
+ * `amount − amount / (1 + rate)`, computed in integers as
+ * `amount × rate / (10000 + rate)`. Applying the first formula to a
+ * tax-inclusive price overcharges by the tax on the tax.
+ */
+export function taxFor(amountMinor, rule) {
+    if (rule === null) {
+        return { rateBp: 0, taxMinor: 0, includedInPrice: false, ruleName: null };
+    }
+    const taxMinor = rule.includedInPrice
+        ? Math.floor((amountMinor * rule.rateBp + (10_000 + rule.rateBp) / 2) / (10_000 + rule.rateBp))
+        : applyBasisPoints(amountMinor, rule.rateBp);
+    return {
+        rateBp: rule.rateBp,
+        taxMinor,
+        includedInPrice: rule.includedInPrice,
+        ruleName: rule.name,
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/tax/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/tax/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AA0ErC,SAAS,MAAM,CAAC,GAAe;IAC7B,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,aAAa,CAAC;QACjC,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC;QACpC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC;QAClC,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,uBAAuB,CAAC;QAC9D,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC;QACvC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,kBAAkB,CAAC;QAC9C,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC9C,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,mBAAmB,CAAC;QAClD,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,qBAAqB,CAAC;KACzD,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,WAAW,CAAC,IAAa,EAAE,IAAoB;IACtD,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAC9B,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;IAChD,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,IAAI,CAAA;QACnC,IAAI,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,IAAI,CAAA;QAC1D,OAAO,CAAC,CAAA;IACV,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAkB,EAAE,GAAG,GAAiB,IAAI,CAAC,GAAG;IAC7E,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAA;IACpB,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IAE5C,OAAO;QACL,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;gBAClF,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,2BAA2B;oBACjC,OAAO,EAAE,+EAA+E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;oBAC/G,IAAI,EAAE,0CAA0C;iBACjD,CAAC,CAAA;YACJ,CAAC;YAED,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;YACrB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;sBACF,KAAK;kBACT,EAAE,KAAK,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI;kBACpE,KAAK,CAAC,WAAW,IAAI,UAAU,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM;kBAC/D,QAAQ,CAAC,KAAK,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,QAAQ,IAAI,CAAC;kBAClE,QAAQ,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;YAEnF,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAa,GAAG,CAAA,iBAAiB,KAAK,eAAe,EAAE,EAAE,CAAC,CAAA;YACvF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC1B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,2BAA2B;oBACjC,OAAO,EAAE,8BAA8B;oBACvC,IAAI,EAAE,8DAA8D;iBACrE,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;QACpB,CAAC;QAED,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACvB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA,eAAe,KAAK,eAAe,EAAE,EAAE,CAAC,CAAA;QAC5D,CAAC;QAED,SAAS,EAAE,KAAK,IAAI,EAAE;YACpB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAC3B,GAAG,CAAA,iBAAiB,KAAK,yCAAyC,CACnE,CAAA;YACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAChC,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAC3B,GAAG,CAAA,iBAAiB,KAAK,yBAAyB,WAAW,EAAE,CAChE,CAAA;YAED,IAAI,IAAI,GAAmB,IAAI,CAAA;YAC/B,IAAI,SAAS,GAAG,CAAC,CAAC,CAAA;YAClB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,IAAI,CAAC,MAAM;oBAAE,SAAQ;gBAC1B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;gBACrC,IAAI,KAAK,KAAK,IAAI;oBAAE,SAAQ;gBAC5B,oEAAoE;gBACpE,sDAAsD;gBACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,KAAK,CAAA;gBAC3C,IAAI,QAAQ,GAAG,SAAS,EAAE,CAAC;oBACzB,IAAI,GAAG,IAAI,CAAA;oBACX,SAAS,GAAG,QAAQ,CAAA;gBACtB,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAAC,WAAmB,EAAE,IAAoB;IAC9D,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAC3E,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe;QACnC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/F,CAAC,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IAE9C,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ;QACR,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,QAAQ,EAAE,IAAI,CAAC,IAAI;KACpB,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@cogenta/commerce",
+  "version": "0.2.0",
+  "description": "Contract E: products, carts, orders, payments, tax, shipping, coupons, invoices and subscriptions.",
+  "license": "MPL-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.11.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cogenta-cms/cogenta.git",
+    "directory": "packages/commerce"
+  },
+  "dependencies": {
+    "@cogenta/core": "0.4.0"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "test": "vitest run --passWithNoTests",
+    "test:integration": "vitest run --config vitest.integration.config.ts --passWithNoTests"
+  }
+}