@aglyn/plugins-commerce 1.0.0-beta.287 → 1.0.0-beta.289

package/src/lib/constants/quote-page.js

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * The customer's quote page (AGL-4094), where a quote's pay link opens.
+ *
+ * The component id is persisted in screen documents; never rename it. The
+ * path is where the site serves the page when it has no page of its own
+ * there. It is `pay-quote` rather than `quote` because a business that sells
+ * made-to-order work often has a "Request a quote" page at `/quote` already,
+ * and a page of the site's own at an address always wins over this one: a pay
+ * link there would open the request form.
+ */ export const QUOTE_PAGE_COMPONENT_ID = 'quote-page';
+export const QUOTE_PAGE_PATH = 'pay-quote';
+/** The page's address for one quote and its signed link token, relative to the site. */ export function quotePageHref(quoteId, token) {
+    const query = new URLSearchParams({
+        q: quoteId,
+        t: token
+    });
+    return `/${QUOTE_PAGE_PATH}?${query.toString()}`;
+}
+
+//# sourceMappingURL=quote-page.js.map

package/src/lib/constants/quote-page.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/constants/quote-page.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The customer's quote page (AGL-4094), where a quote's pay link opens.\n *\n * The component id is persisted in screen documents; never rename it. The\n * path is where the site serves the page when it has no page of its own\n * there. It is `pay-quote` rather than `quote` because a business that sells\n * made-to-order work often has a \"Request a quote\" page at `/quote` already,\n * and a page of the site's own at an address always wins over this one: a pay\n * link there would open the request form.\n */\nexport const QUOTE_PAGE_COMPONENT_ID = 'quote-page'\n\nexport const QUOTE_PAGE_PATH = 'pay-quote'\n\n/** The page's address for one quote and its signed link token, relative to the site. */\nexport function quotePageHref(quoteId: string, token: string): string {\n  const query = new URLSearchParams({ q: quoteId, t: token })\n  return `/${QUOTE_PAGE_PATH}?${query.toString()}`\n}\n"],"names":["QUOTE_PAGE_COMPONENT_ID","QUOTE_PAGE_PATH","quotePageHref","quoteId","token","query","URLSearchParams","q","t","toString"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;CASC,GACD,OAAO,MAAMA,0BAA0B,aAAY;AAEnD,OAAO,MAAMC,kBAAkB,YAAW;AAE1C,sFAAsF,GACtF,OAAO,SAASC,cAAcC,OAAe,EAAEC,KAAa;IAC1D,MAAMC,QAAQ,IAAIC,gBAAgB;QAAEC,GAAGJ;QAASK,GAAGJ;IAAM;IACzD,OAAO,CAAC,CAAC,EAAEH,gBAAgB,CAAC,EAAEI,MAAMI,QAAQ,IAAI;AAClD"}

package/src/lib/declarations.js

@@ -16,6 +16,7 @@
  */ import { registerPluginEntitlements } from "@aglyn/aglyn/plugin-manager/plugin-entitlements";
 import { registerPluginPermissions } from "@aglyn/aglyn/plugin-manager/plugin-permissions";
 import { COMMERCE_PERMISSIONS, COMMERCE_SITE_PERMISSIONS } from "./model/plugin-permissions.js";
+import { COMMERCE_WORKSPACE_SITE_PERMISSIONS } from "./model/workspace-site-permissions.js";
 let declared = false;
 /**
  * The plugin's DECLARATIONS (AGL-4047): its permission keys (the point of
@@ -32,7 +33,10 @@ let declared = false;
     declared = true;
     registerPluginEntitlements({
         pluginId: 'commerce',
-        orgPermissions: COMMERCE_SITE_PERMISSIONS
+        orgPermissions: [
+            ...COMMERCE_SITE_PERMISSIONS,
+            ...COMMERCE_WORKSPACE_SITE_PERMISSIONS
+        ]
     });
     registerPluginPermissions(COMMERCE_PERMISSIONS);
 }

package/src/lib/declarations.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/declarations.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { registerPluginEntitlements } from '@aglyn/aglyn/plugin-manager/plugin-entitlements'\nimport { registerPluginPermissions } from '@aglyn/aglyn/plugin-manager/plugin-permissions'\nimport { COMMERCE_PERMISSIONS, COMMERCE_SITE_PERMISSIONS } from './model/plugin-permissions'\n\nlet declared = false\n\n/**\n * The plugin's DECLARATIONS (AGL-4047): its permission keys (the point of\n * sale's `managePos` and its finer keys, and the reservation keys whose\n * preset is the site role), which the one permission catalog lists beside\n * the core keys. Loaded eagerly by\n * the console (client and server) and the tenant's server through the\n * generated declarations manifest, so the role editor offers the keys, a\n * custom role or a per-member override keeps them, and a route resolves\n * them whether or not a request has touched the plugin yet. Light by\n * construction: nothing here reaches a provider, Firestore or React.\n */\nexport function registerCommerceDeclarations(): void {\n  if (declared) return\n  declared = true\n  registerPluginEntitlements({ pluginId: 'commerce', orgPermissions: COMMERCE_SITE_PERMISSIONS })\n  registerPluginPermissions(COMMERCE_PERMISSIONS)\n}\n\nregisterCommerceDeclarations()\n"],"names":["registerPluginEntitlements","registerPluginPermissions","COMMERCE_PERMISSIONS","COMMERCE_SITE_PERMISSIONS","declared","registerCommerceDeclarations","pluginId","orgPermissions"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,0BAA0B,QAAQ,kDAAiD;AAC5F,SAASC,yBAAyB,QAAQ,iDAAgD;AAC1F,SAASC,oBAAoB,EAAEC,yBAAyB,QAAQ,gCAA4B;AAE5F,IAAIC,WAAW;AAEf;;;;;;;;;;CAUC,GACD,OAAO,SAASC;IACd,IAAID,UAAU;IACdA,WAAW;IACXJ,2BAA2B;QAAEM,UAAU;QAAYC,gBAAgBJ;IAA0B;IAC7FF,0BAA0BC;AAC5B;AAEAG"}
+{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/declarations.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { registerPluginEntitlements } from '@aglyn/aglyn/plugin-manager/plugin-entitlements'\nimport { registerPluginPermissions } from '@aglyn/aglyn/plugin-manager/plugin-permissions'\nimport { COMMERCE_PERMISSIONS, COMMERCE_SITE_PERMISSIONS } from './model/plugin-permissions'\nimport { COMMERCE_WORKSPACE_SITE_PERMISSIONS } from './model/workspace-site-permissions'\n\nlet declared = false\n\n/**\n * The plugin's DECLARATIONS (AGL-4047): its permission keys (the point of\n * sale's `managePos` and its finer keys, and the reservation keys whose\n * preset is the site role), which the one permission catalog lists beside\n * the core keys. Loaded eagerly by\n * the console (client and server) and the tenant's server through the\n * generated declarations manifest, so the role editor offers the keys, a\n * custom role or a per-member override keeps them, and a route resolves\n * them whether or not a request has touched the plugin yet. Light by\n * construction: nothing here reaches a provider, Firestore or React.\n */\nexport function registerCommerceDeclarations(): void {\n  if (declared) return\n  declared = true\n  registerPluginEntitlements({\n    pluginId: 'commerce',\n    orgPermissions: [...COMMERCE_SITE_PERMISSIONS, ...COMMERCE_WORKSPACE_SITE_PERMISSIONS],\n  })\n  registerPluginPermissions(COMMERCE_PERMISSIONS)\n}\n\nregisterCommerceDeclarations()\n"],"names":["registerPluginEntitlements","registerPluginPermissions","COMMERCE_PERMISSIONS","COMMERCE_SITE_PERMISSIONS","COMMERCE_WORKSPACE_SITE_PERMISSIONS","declared","registerCommerceDeclarations","pluginId","orgPermissions"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,0BAA0B,QAAQ,kDAAiD;AAC5F,SAASC,yBAAyB,QAAQ,iDAAgD;AAC1F,SAASC,oBAAoB,EAAEC,yBAAyB,QAAQ,gCAA4B;AAC5F,SAASC,mCAAmC,QAAQ,wCAAoC;AAExF,IAAIC,WAAW;AAEf;;;;;;;;;;CAUC,GACD,OAAO,SAASC;IACd,IAAID,UAAU;IACdA,WAAW;IACXL,2BAA2B;QACzBO,UAAU;QACVC,gBAAgB;eAAIL;eAA8BC;SAAoC;IACxF;IACAH,0BAA0BC;AAC5B;AAEAI"}

package/src/lib/model/commerce-orders.d.ts

@@ -23,6 +23,7 @@
  * I/O here.
  */
 import type { OrderLineModifier } from './product-modifiers';
+import type { OrderQuote } from './commerce-quotes';
 import type { PaymentRisk } from '@aglyn/aglyn/app-utils/payment-risk';
 import type { ProductType } from './commerce';
 import type { StorefrontTaxMode } from './commerce-tax-decision';
@@ -31,7 +32,8 @@ import type { PosOfflineOrderStamp } from './commerce-pos-offline';
 import type { OrderFulfillmentMethod, OrderLocalDelivery, OrderPickup } from './order-local-fulfillment';
 export type OrderStatus = 'pending' | 'paid' | 'partially_fulfilled' | 'fulfilled' | 'delivered' | 'cancelled' | 'refunded';
 /**
- * Where the sale came through. `subscription` is a recurring cycle of a
+ * Where the sale came through. `quote` is an order a business quoted before
+ * the customer paid it (AGL-4093, `commerce-quotes.ts`). `subscription` is a recurring cycle of a
  * PHYSICAL subscription product (AGL-1750): each paid invoice mints one order
  * so fulfilment has something to pick, pack and label against, and so
  * recurring revenue reaches the surfaces that read `orders`. Digital and
@@ -39,7 +41,7 @@ export type OrderStatus = 'pending' | 'paid' | 'partially_fulfilled' | 'fulfille
  * there is nothing to ship, and AGL-1732's "a subscription is not an order"
  * stands for them.
  */
-export type OrderChannel = 'online' | 'pos' | 'draft' | 'subscription' | 'marketplace';
+export type OrderChannel = 'online' | 'pos' | 'draft' | 'subscription' | 'marketplace' | 'quote';
 /**
  * Where an order sold on an outside channel came from (AGL-3638): a
  * marketplace that took the buyer's money and pays the merchant out. Written
@@ -83,7 +85,20 @@ export interface OrderChannelSource {
 }
 /** Snapshot of what was bought — self-contained for history. */
 export interface OrderLineItem {
+    /**
+     * The product sold. EMPTY on a line typed on a quote (`custom`), which no
+     * product stands behind: every reader that looks a product up by this id
+     * skips an empty one (AGL-4093).
+     */
     productId: string;
+    /** A line typed on a quote rather than picked from the catalog (AGL-4093). */
+    custom?: boolean;
+    /** Included at no charge (AGL-4093): `unitAmountCents` is 0. */
+    included?: boolean;
+    /** What the line is, in the business's words, beyond its name (AGL-4093). */
+    description?: string;
+    /** The product was tax-exempt when the line was priced (AGL-4093). */
+    taxExempt?: boolean;
     variantId?: string;
     /** Display snapshot at purchase time. */
     name: string;
@@ -623,6 +638,8 @@ export interface HostOrder {
     invoiceId?: string;
     /** Draft orders (AGL-287): the link sent to the buyer. */
     paymentLinkUrl?: string;
+    /** What only a quote has (channel `quote`, AGL-4093); see `commerce-quotes.ts`. */
+    quote?: OrderQuote;
     refundedCents?: number;
     /**
      * Line indexes an admin refunded BY NAME (AGL-2454), and therefore the lines
@@ -1120,6 +1137,12 @@ export declare function formatOrderNumber(order: Pick<HostOrder, 'number'>, docI
  * into the v1 shape for display; already-shaped orders pass through.
  */
 export declare function liftLegacyOrder(raw: Partial<HostOrder>): HostOrder;
+/**
+ * What a report groups a line under: its product, or for a line typed on a
+ * quote (no product) its name, so two different typed lines never pool into
+ * one empty-id bucket.
+ */
+export declare function orderLineProductKey(line: Pick<OrderLineItem, 'productId' | 'name'>): string;
 /**
  * Does this order contain `productId`?
  *

package/src/lib/model/commerce-orders.js

@@ -625,6 +625,14 @@ export function computeCheckoutSessionTotals(lineItems, session, parts) {
         }
     });
 }
+/**
+ * What a report groups a line under: its product, or for a line typed on a
+ * quote (no product) its name, so two different typed lines never pool into
+ * one empty-id bucket.
+ */ export function orderLineProductKey(line) {
+    var _line_name;
+    return line.productId ? line.productId : `custom:${(_line_name = line.name) != null ? _line_name : ''}`;
+}
 /**
  * Does this order contain `productId`?
  *
@@ -859,7 +867,8 @@ export function computeCheckoutSessionTotals(lineItems, session, parts) {
     pos: 'POS',
     draft: 'Draft',
     subscription: 'Subscription',
-    marketplace: 'Marketplace'
+    marketplace: 'Marketplace',
+    quote: 'Quote'
 };
 /** Human label for a channel, tolerating a legacy/unknown value. */ export function orderChannelLabel(channel) {
     var _ref, _ORDER_CHANNEL_LABELS_;