Hulo Global home
For Vendure Vendure edition: for Vendure 3.5+ shops, installed with npm. Also available for WordPress: Quotations for WordPress
For Vendure

Quotations for Vendure: changelog

Release notes for @huloglobal/vendure-plugin-quotations. Latest release: v0.10.0 — 16 November 2026.

Show changes

v0.10.0

NewLatest
Changed
  • Every e-mail restyled to one shared design: a 600px white card on a light grey background, the store's logo (or its name) over a 3px accent bar, a clear heading, the quote's reference, validity and total in a summary box, a button, a "Kind regards" sign-off with the store's reply-to address, and a footer strip with the store's address, phone, website and footer note. Inline styles and tables only, every value escaped, and every message now has a plain-text part. It uses the existing Accent colour, Logo URL and footer settings, so nothing needs setting up. Restyled: the quote e-mail, test sends (now with a "Test send" warning box), the chaser, the expiry reminder (its heading names the date), follow-up steps, the pay-link e-mails for the whole amount, a deposit or the balance (the pay button plus a secondary "View your quotation" button, and the amount due now), and the request acknowledgement (which had no HTML part). Store notifications (new request, first view, accepted, declined) and discount-approval requests and outcomes use the same design, more compact; they were plain text. The weekly report uses the shared design from the licence SDK 0.15.7 with the store's logo and accent colour.
  • Your own e-mail templates are used as they are: the summary box and button go where the template has the quote link on a line of its own (else before its sign-off), and no second sign-off is added when the template has one.
  • Default texts: British English, "Kind regards", "e-mail"; the request acknowledgement no longer promises a reply "usually within one working day" (nothing in the plugin ensures that). Stored templates are not changed.
  • Licence SDK ^0.15.7; dev dependencies refreshed to the latest minor versions (TypeScript 5.9, Vitest 2.1, @types/nodemailer 6.4). Held back: TypeScript 7, Vitest 5 (the monorepo harness pins Vitest 2) and @types/nodemailer 8 (the types for nodemailer 8+, while the peer range starts at 6).
Fixed
  • The plain-text part of the pay-link e-mails had no link (it said "with the button below"); it now carries the pay link and the quote link.
  • The public quote page and the accept/decline form are rate limited per client address (120 page views and 20 responses a minute; 429 after that), as the PDF download already was.
  • Store notification subjects are kept to one line whatever the requester typed.

v0.9.0

New

Parity with HULO Quotations for WordPress (free 0.1.4 and Pro).

Changed (tiers)
  • Free now: sending a quote, test sends, the unopened-quote chaser and the expiry reminder (they ran premium-only before). Auto-expiry was already free and is now listed as such.
  • Premium now: the weekly e-mail report and the set-up checklist. Without a licence or the evaluation the report is not sent (the weekly clock is left as it was, so it resumes on the next Monday once a licence is active), Send me a test and Preview answer 402, and the checklist reports nothing to do. Settings and data are kept.
  • Still premium: converting an accepted quote to a draft order from the admin, plus the new templates, follow-up sequences, discount approval, webhooks, sales reports and deposits below.
  • PREMIUM_FEATURES lists what is actually gated (storefront requests were listed but never gated).
Fixed
  • B5: KPIs and the weekly report no longer add amounts in different currencies together. GET /quotations/stats reports valueByCurrency per status, pipelineByCurrency and last30.valueWonByCurrency (minor units per currency; value and last30.valueWonPence are gone). The weekly report, the admin banner and the dashboard widget show value won per currency ("£1,234.56 + €500.00"). The anonymous heartbeat figure valueWonPence counts the store's main currency only.
  • Expiry is recorded per quote (trail entry "Validity ended" and an event) instead of one silent bulk update.
  • Chasers and expiry reminders are claimed before they are sent and released when the e-mail fails, so an overlapping or late run never sends one twice; the chaser only goes to quotes never opened.
Added (free)
  • EventBus events: QuotationEvent (exported) for created, requested, updated, sent, viewed, accepted, declined, expired, cancelled, converted, paid, payment, approval, follow-up and deleted, with a quote summary (no token, no internal notes).
  • Mark as sent (POST /quotations/quotes/:id/mark-sent): the store shared the quote itself; a draft or request opens for the customer without an e-mail.
  • Validity counted from the send: a quote keeps its validity period (validityDays) and its date starts when it is first sent (or marked as sent). A resend keeps the date; a quote whose date has passed must be extended first.
  • Staff preview of the customer page (GET /quotations/quotes/:id/page): not counted as an opening, the accept form is switched off.
  • Server-side PDF (built in, no dependency): GET /quotations/quote/:token/pdf from the customer link (rate-limited, not an opening, never cached), GET /quotations/quotes/:id/pdf for staff, a Download PDF button on the customer page and an optional attachment on the quote e-mail (Settings → Attach the quote as a PDF).
  • "My quotes" for signed-in customers: GET /quotations/my (shop session, channel from vendure-token) lists the customer's own quotes (by account, never by e-mail; drafts hidden; requests as "awaiting price") with quote, PDF and pay links. A request posted while signed in is linked to the account; guest requests are no longer linked to an account by e-mail address.
  • 12-month report (GET /quotations/reports/monthly, Reports tab): created, sent, accepted, win rate and value won per currency per month.
  • Per-e-mail request throttle kept in the database (10 an hour per address, across processes and restarts), on top of the per-client limit.
  • HULO Payments pay link on acceptance: with Pay link on acceptance on (Settings, per channel) the accepted quote becomes a draft order at the quoted total, moves to ArrangingPayment (a free shipping method is picked when the channel has one) and the customer is e-mailed a pay link; staff can also create and e-mail it from the quote. HULO Payments for Vendure is detected at runtime (no dependency); a host can pass its own payLinks provider to init(). The quote is marked paid when the order's settled payments cover the total. The converted draft order now carries the quote's customer.
Added (premium)
  • Quote templates: save a quote's lines, discounts, VAT, notes, terms, validity and currency (never the customer or internal notes) and start new drafts from them (Templates tab).
  • Follow-up sequences: up to three extra e-mails N days after sending while the quote is open and unpaid; each step claimed once, in order, at most one a day per quote, never within a day of the chaser or reminder.
  • Discount approval: limits on discount % off list, discount amount and total (per currency). A quote over a limit cannot be sent or marked as sent until an approver approves exactly that version (a hash of lines, discounts, VAT, currency and totals); an edit invalidates the approval. Test sends are never held; without premium the gate is off. Approvers: listed admin e-mails, else any SuperAdmin; the preparer cannot approve their own quote unless they are the only approver and that is allowed.
  • Webhooks (up to five): JSON signed with X-Hulo-Signature: sha256=HMAC(secret, "<timestamp>.<body>"), Slack and Microsoft Teams presets; public http(s) addresses on standard ports only, checked on save and on every delivery with the connection pinned to the checked address; no redirects; retries with back-off (six attempts); 30-day delivery log with retry and test.
  • Sales reports by member of staff and by source, per currency, with a formula-safe CSV export.
  • Deposits: a percentage (optionally only above a per-currency threshold, or per quote) taken first, then the balance, as two pay links on the same order. Deposit + balance = the quoted total exactly in minor units (zero-decimal currencies in whole units); every link is claimed before it is created; the quote is paid only when the balance settles. A deposit already taken is completed whatever the licence state.
Compatibility
  • New tables quotation_template, quotation_followup, quotation_approval, quotation_webhook_log, quotation_deposit and new nullable / defaulted columns, created on start-up on MySQL, MariaDB and PostgreSQL. Tested with Vendure 3.8.2; @vendure/core >=3.5.0 <4.0.0.
  • Pay links need HULO Payments for Vendure exposing createPayLink(ctx, { orderCode, amount?, currency, description, customerEmail?, returnUrl?, expiresInHours?, reference?, metadata? }) → { url, ref } on an exported service (PayLinkService or PaymentsService), or a payLinks provider in init().

v0.8.6

New
Fixed
  • A converted quote keeps its quoted price through checkout on Vendure 3.8+. Vendure 3.8 recalculates every order, draft orders included, when it moves to ArrangingPayment. A draft order converted from a quote then picked up catalogue price or promotion changes made after the conversion: in the e2e test a price rise from 100.00 to 125.00 moved the accepted 168.00 quote to 198.00 at checkout. The plugin now adds an order process that re-balances the quote surcharge right after that recalculation, in the same transaction, so the order total (before shipping) and its VAT split match the quote again; the quote's history records a repriced event. Orders whose lines an admin has changed since the conversion follow the catalogue as before. Shipping is not part of a quote and is not touched. No change on Vendure 3.5 to 3.7, where the transition does not recalculate.
Security
  • Admin REST routes refuse a Shop-API session on Vendure 3.8+. Vendure 3.8 binds every session to the API it was created on and refuses Shop-API sessions on the Admin API (GHSA-5fpx-9m35-w745), but it does not check REST routes added by plugins: an administrator's storefront session still carried their admin permissions into the Quotations admin REST routes. Those routes now also require a session created on the Admin API (isAdminApiSession from the licence SDK 0.15.6, the same rule as Vendure's own AuthGuard). The admin UI is unaffected; administrators logged in before the 3.8 upgrade log in again once, as Vendure already requires. No change on Vendure 3.5 to 3.7.
Compatibility
  • Tested with Vendure 3.8.2 (NestJS 12, @nestjs/graphql 14, Apollo Server 5), as well as 3.5 to 3.7. The peer range stays @vendure/core >=3.5.0 <4.0.0; nothing here needs 3.8.
  • Requires @huloglobal/vendure-licence-sdk ^0.15.6.

v0.8.5

New
Package metadata
  • The license field is now AGPL-3.0-only, matching LICENSE, which grants the GNU Affero General Public License version 3 (it said SEE LICENSE IN LICENSE). Published npm builds remain under the separate commercial licence described in LICENSE. No code changes.

v0.8.4

New
Fixed
  • PostgreSQL: quotes can be created, accepted and converted. With licence SDK 0.15.3 or older, every conditional UPDATE on Postgres reported 2 affected rows, so the plugin's "exactly one row changed" checks always failed. Creating a quote stopped with "Could not allocate a quote number", and the same check broke logging a customer's first view, recording an acceptance and converting a quote to a draft order. The plugin now requires licence SDK ^0.15.4, which reports the real count. Verified against PostgreSQL 17. The first weekly report is no longer skipped either (it used to start a week late). MySQL and MariaDB were not affected.
Security
  • The customer quote page (GET and POST /quotations/quote/:token, whose address carries the quote's secret token) and the admin previews (GET /quotations/quotes/:id/preview, GET /quotations/digest/preview) now send Cache-Control: private, no-store, on their refusals and not-found pages too, so no browser, proxy or CDN keeps a copy. The other HULO plugins already send it on their report previews.
Package metadata
  • The npm package no longer includes the plugin's compiled unit tests.

v0.8.3

New
Documentation
  • The README now shows the plugin logo, hosted on huloglobal.com so it displays on npm and GitHub alike, linking to the product page. No code changes.

v0.8.2

New
Security
  • Request acknowledgements no longer relay requester-written text. POST /quotations/request is public, so anyone could make the store e-mail any address with their own wording (the typed name and free-text line descriptions went into {{customerName}} and {{summary}}). The acknowledgement now greets with "there", lists only catalogue lines by their catalogue name plus a count of items still to price, and goes at most once per address per day (checked in memory and against the event log, so restarts and other processes count) with a cap of 30 per hour per process. Catalogue-matched request lines are always described by the catalogue name. The merchant notification is unchanged.
  • Acceptance is bound to the version the customer saw. The quote page's form carries a fingerprint of the lines, money, VAT, notes and terms (v); an acceptance whose fingerprint no longer matches (the quote was edited after it was opened) is refused with "This quotation has changed since you opened it" and the page shows the current version. The conditional update also re-checks the total. An accept POST without v is refused, so a page opened before the upgrade needs a reload; declines need no fingerprint.
  • Conversion requires CreateOrder on the quote's channel. Converting now also checks the admin's CreateOrder permission on the channel the order is created in (previously UpdateSettings on the open channel was enough).
Fixed
  • Converting an accepted quote created the draft order in whichever channel the admin had open, at that channel's prices and currency. The order is now created in the quote's channel and currency; a quote whose currency the channel does not sell is refused (and stays accepted) instead of being converted at the same number in another currency.
  • The converted order matched the quoted gross total but booked the whole pricing difference as tax-free, so its net and VAT differed from the quote (an all-free-text quote showed no VAT at all). The reconciling surcharge now carries the VAT difference, so the order's net total, VAT and gross total all equal the quote's.

v0.8.1

New
Changed
  • Every install now gets a 14-day evaluation with all features on and no card (granted by the HULO licence server). The licence banner's buttons read Subscribe: during the evaluation the first charge falls on the day it ends, so there is no second free trial.

v0.8.0

Added
  • Weekly report: every Monday at 08:00 server time the plugin emails quotes created, sent and accepted, value won, storefront requests and win rate for the week against the week before, with up to three next steps. Settings → Weekly report: on/off, recipient (defaults to the channel notify or reply-to address, then the licence email, then the trial-reminder address), Send me a test, Preview. Uses the plugin's SMTP settings; worker-only, once per install across workers. Endpoints GET|POST /quotations/digest/settings, POST /quotations/digest/send-test, GET /quotations/digest/preview.
  • Set-up checklist at the top of the Quotes tab with real checks (SMTP reachable, reply-to/notify address, business name or logo, storefront requests arriving or dismissed, first quote sent); GET /quotations/setup, POST /quotations/setup/dismiss.
  • Dashboard widget (Dashboard → Add widget → Quotations): quotes sent, accepted and value won for the last 7 days, the licence notice when one applies, and a link to the page; GET /quotations/widget.
  • Help drawer in the page header: New quote → Send → Convert.
  • Value won · 30d KPI next to the win rate (quotes accepted in the last 30 days).
  • Licence banners show the lifecycle notice (trial ending, key expiring, evaluation ended) in an amber strip, the premium feature list on trial and free installs, and the 30-day figures ("So far: …"). meta / licence/status gain notice, premiumFeatures, recentStats and buyUrl.
Changed
  • Usage stats sent with the evaluation reminders and the daily heartbeat now cover the last 30 days under the keys quotesCreated, quotesSent, quotesAccepted, valueWonPence, requestsReceived, winRatePct (counts and totals only). Licensed installs keep reporting via the heartbeat.
  • 402 responses carry the buy URL https://elite.charity/licence/buy/vendure-plugin-quotations; the admin UI renders any licence-required error as one sentence pointing at the banner.
  • The address given for the evaluation reminder is remembered (plugin pref eval.leadEmail) as the report's last-resort recipient.
  • Requires @huloglobal/vendure-licence-sdk ^0.15.0. New shared table hulo_plugin_prefs (created on boot; shared by all HULO plugins).

v0.7.3

Fixed
  • The hourly cron had no deadline: one stalled pass (seen on ELITE: stuck from noon, every later hour logged "previous run still in progress") blocked expiry and chasers until a restart. A pass now has a 15-minute deadline; on timeout it is logged with the step it was in and the single-flight guard is released. Chaser sends are conditional updates, so a late completion cannot double-send.

v0.7.2

Changed
  • The quote builder's catalogue search reads Vendure's search index (search_index_item) when the channel has been indexed: translated names, SKU and channel price live in one table, so no translation joins. It searches in the admin's language, falls back to English index rows, and to the live product-variant tables when the index is empty or absent (Elasticsearch hosts, before the first reindex). Results and their shape are unchanged; the decision is re-checked every minute.
Fixed
  • PostgreSQL: every camelCase column the plugin reads from Vendure's own tables (customers, administrators, addresses, variants, translations, prices) is now quoted, so catalogue search, request pricing, the customer and staff pickers and customer linking work on Postgres, where unquoted identifiers fold to lowercase. The config-row upsert no longer fails with an ambiguous column reference.
  • A PostgreSQL corpus test (tests/pg-corpus.test.ts, runs when HULO_PG_URL is set) extracts every SQL statement in src/, translates it with the SDK's dialect adapter and prepares it against a scratch database with quoted stand-ins for the Vendure tables, so a quoting or dialect regression fails the unit suite.

v0.7.1

Fixed
  • Editing a sent quote no longer silently pushes its expiry to 30 days from now; validity only changes when the editor sets it.
  • Two concurrent creates can no longer receive the same reference: numbers are claimed with a compare-and-set and (channelId, reference) is unique.
  • Viewing, accepting/declining and converting are now single-shot: parallel first views produce one "opened" event and one notification, a double-submitted accept cannot notify twice, and a double "Convert" cannot create two draft orders (the quote is claimed before the draft is created and released if it fails).
  • A revision now supersedes the original (which is cancelled) instead of leaving both acceptable.
  • Catalogue search and request pricing work on Postgres (enabled IS TRUE instead of = 1) and in non-English shops (the admin's language, falling back to English).
  • requested quotes are no longer served on the public quote URL before they are priced.
Changed
  • One pooled SMTP transport with 10 s connect / 30 s send deadlines instead of a new connection per email with nodemailer's 2 min / 10 min defaults. Merchant notifications and request acknowledgements are sent off the request path, so a slow mail server never stalls the customer's page or the hourly cron.
  • The public request throttle keys on the real client address (no longer trusts a spoofable header), adds a per-email bucket, and evicts idle entries instead of wiping everyone's counters.
  • Quote lines are written in one statement; long text fields are capped; config reads no longer swallow database errors and fall back to defaults.
  • Chaser and expiry-reminder sweeps read each quote once; a skipped hourly tick is logged; the licence-server lead call has a timeout.
  • Line and VAT rounding use integer arithmetic; emails and the quote page format the validity date the same way; expiry is judged by the database clock everywhere.
  • Admin editor: search results that arrive out of order are ignored; timers are cleared on destroy.

v0.7.0

Added
  • Quote requests from your storefront. A public, unauthenticated POST /quotations/request lets any site — a basket, a product page, a calculator or a plain form — ask for a quote. Each request lands in the admin as a requested quote with catalogue lines (by variant id or SKU) pre-priced at the channel's list price, free-text lines left for you to price, the customer's message and where it came from. The channel's notify address gets the details, and the customer receives an acknowledgement carrying the quote reference (editable template in Settings). Existing customers are linked by email.
  • Requests inbox. A new Requests tile on the Quotes page shows how many are waiting for a price (click it to filter); the detail panel shows the customer's message; requested quotes are editable, deletable and sent with the same Send to customer button, which moves them to sent.
  • Per-channel switch. Accept quote requests in Settings (on by default) turns the endpoint off for a channel.
Notes
  • Requests are throttled per client address (10 an hour), a hidden website field acts as a honeypot, and the endpoint never needs a licence — sending the finished quote does, as before.
  • Schema: quotation.requestMessage / requestSource / requestedAt, quotation_config.acceptRequests / requestAckBody (added automatically on boot).

v0.6.1

Changed
  • Branding. The bundled hulo-global-logo.svg is now the HG wordmark on the HULO black rounded square (the same mark as the huloglobal.com header), with explicit -light and -dark variants alongside the auto-switching default.

v0.6.0

Added
  • Licence & billing card in the admin. Always visible: the current state (free tier, free trial with first-charge date, monthly/annual subscription, lifetime, or master licence) with the actions that apply — start the 14-day free trial or subscribe, buy lifetime, Manage billing (Stripe customer portal: update card, cancel, switch plan) and Upgrade to lifetime (the old subscription stops billing at the end of its paid period). Requires licence SDK ^0.14.0.

v0.5.1

Changed
  • The 14-day free trial is now card-backed. Unlicensed installs run in the free tier; start the trial from the admin banner (monthly or annual → Start 14-day free trial) — Stripe collects a card, nothing is charged until day 15, cancel any time before then, one trial per customer — and the licence installs itself within a minute. The automatic no-card evaluation window is retired (licence SDK ^0.13.0).

v0.5.0

Added
  • Buy licence from the admin. The evaluation / free-tier banner now has a plan picker and a Buy licence button: checkout opens in a new tab and, once payment completes, the licence installs itself — no email round-trip, no .env edit, no restart. Renewed subscription keys are picked up automatically too. New admin endpoints licence/purchase-link and licence/claim-status.
Changed
  • Requires @huloglobal/vendure-licence-sdk ^0.12.0.
  • The 7-day card trial at checkout has been retired: every install already gets the 14-day no-card evaluation, and paid plans now bill from day one.

v0.4.0

Added
  • Channel-branded emails, properly. New per-channel branding fields — website, phone, business address and a footer note (company/VAT number) — rendered as a professional footer on both the quote email and the customer quote page, alongside the existing logo, accent colour and business name. Every channel sends fully in its own brand.
  • Dropdowns everywhere sensible. VAT rate (UK standard/reduced/ zero + custom), validity (7/14/30/60/90 days + custom) and currency are now dropdowns in the editor; settings gained preset dropdowns for default VAT/validity, chaser and expiry-reminder cadence, a currency select, accent-colour swatches, and an "Insert variable…" picker for the email template.

v0.3.0

Changed
  • Step-by-step quote wizard. The editor is now four guided steps — Customer → Items → Pricing → Review & send — with a progress bar, per-step validation hints ("a name and a valid email unlock the next step"), clickable completed steps, and a final review that mirrors what the customer will see with one big "Send quote" button. Sensible channel defaults mean most quotes never need the Pricing step touched.
  • The admin nav entry now lives only under Sales.

v0.2.0

Added
  • Send as a member of staff. Pick any administrator in the editor (defaults to you): their name fronts the email's From header, replies go straight to their inbox, the customer page shows "Prepared by", the {{staffName}} variable signs the email body, and accept/decline/ opened notifications reach them directly.
  • Customer picker. Search existing Vendure customers in the editor — name, email, company and phone autofill (and the quote links to the customer record).
  • Preview & test-send. Open the rendered customer email in a tab, or send the real thing to yourself (subject-tagged [TEST]) before it goes to the customer.
  • Extend validity. Push the expiry date out on open quotes — and revive expired ones — in one click, with the audit trail updated.
  • Opened notifications. Optional per-channel "email me when the quote is first opened" — the best moment to pick up the phone.
  • Internal notes. Comment on the activity trail; never shown to the customer.
  • Admin navigation. The plugin now registers a "Quotations" entry in the admin nav (Sales section) — no more typing the URL.
  • Plugin logo.

v0.1.0

Added
  • Initial release. Quote builder (catalogue search with live prices, free-text lines, per-line + quote-level discounts, VAT, validity, notes/terms), per-channel branding + numbering, branded customer email with signed accept/decline link, typed-name signature capture, viewed/accepted/declined tracking with a full per-quote audit trail, auto-expiry, unopened-quote chaser + expires-soon reminder, conversion of accepted quotes to draft orders at the exact quoted total, KPI dashboard (win rate, open pipeline, response time), MySQL/MariaDB + PostgreSQL support, in-admin licence activation and one-click in-app updates. 14-day full-featured evaluation; free tier is draft + preview.