v2.12.1-rc.3

Changed

• Update dependencies

v2.12.0-rc.2

For this release candidate I put an emphasis on improving unit tests. After some painful realizations on how much I've learned about Angular and how many mistakes I made, many changes to the codebase itself were made during test development, not only for the betterment of functionality and test codebase themselves, but to reinforce the principle of division of concerns (which is a cornerstone in Angular, let alone all modern web frameworks).

So current coverage percentages are as follows:

• Statements - 92.34% | 1930/2090
• Branches - 81.25% | 702/864
• Functions - 87.7% | 763/870
• Lines - 92.11% | 1800/1954

Which is higher than the 80% overall percentage I originally aimed for.

However, this also may be the last version to support 1.x versions of the Trébol API, as I'm currently re-design it to implement the JSON: API Specification for better future-proofing.

Which means the real next version here (not a release candidate) will probably be major i.e. v3.0.

Added

• Environment variables
  • Interval in miliseconds to check for current token validity
  • Default product image URL
• Experimental startup loading spinner

Changed

• AppService is replaced by three smaller, more specialized services
  • SessionService - knows (but does not tell) where to save session tokens; knows whether the user has an active one; and allows to fetch (and cache) authorization details
  • AuthenticationService - allows to login as user (or guest) and register, and to cancel any ongoing instance of these processes
  • ProfileService - allows to fetch (and cache) the current user's profile data, and to update it as well
• ManagementHeaderComponent refactored down to simpler components
  • Introduced a common HeaderBrandComponent used in both store and management pages
• Reorganized most form components into accordingly named forms/ directories
• Frontpage lists show a paginator only when they have more than one page
• Make better use of some shared components to display details of carts/sales
  • StoreCartContentsTable superseded by SellDetailsTable
• In the sales management page, a new button triggers the dialog where clerks may view its details
• Checkout-related components (in the store module) split & rewritten against model classes using self-evident nomenclature
  • StoreCheckoutRequestFormComponent has a form that accepts instances of CheckoutRequest
  • StoreBillingDetails has a form that accepts instances of BillingDetails
  • And so forth
• Among other minor changes and refactors

Fixed

• (UI) User name and details would not always be correct or up-to-date
  • (Performance) Make better use of existing auth HTTP APIs
• (UI) Contents of cart would be editable after confirmation
• (UX) After registration (and automatic login), the user would not retain profile info (namely their username)
• (UI) Readjusted spacing of product cards in frontpage catalog
• (UI) Set defined height for registration and guest login dialogs (for better use in mobile devices, where usually a virtual keyboard blocks the view)
• (UX) Allow mobile devices to "tab" correctly in nested forms (when pressing 'Next')
• (UX) Fetching initial sales data into the management page
• (UX) Keep auth status up-to-date and centralized, without calling the API from multiple sources
• Using actual instances of InjectionToken<T> to provide external API services
• And several minor bugfixes

Removed

• Unused components related to file upload (which may be included if the feature ever gets to the external API specification)
• Sales data cannot be edited from the management module, as the SellFormComponent is no longer included
  • This may be reverted in future versions

v2.12.0-rc.1

I'm now getting a better hold of myself with the versioning 😅 There's still lots of things to be improved but I'm more confident of the overall quality. Now I just want to add more testing code before calling it a proper release.

Here's what changed since v2.0.0:

Added

• Service interface methods specific to sales data API
  • markAsConfirmed - To acknowledge an order/sell and notify the customer - HTTP /data/sales/confirmation
  • markAsRejected - To prevent an order/sell to be delivered due to issues and/or refund the customer - HTTP /data/sales/rejection
  • markAsCompleted - To mark an order/sell as delivered - HTTP /data/sales/completion
• Components to display sell data
  • Simple block for general data
  • Table to only display details (products/units/subtotal of each)
  • Dialog component for reviewing all information. Can be accessed by clicking sales management page table rows
    • Includes button to view the receipt of the transaction, only if, and once it has been, paid
    • Three buttons are included in the dialog, each of them acts as interface for the above mentioned interface methods for the sales data API
• Simple component for Google Maps iframe embeds
  • Includes pipe for trusting external resource urls (uses DomSanitizer)
• Search bar component for the frontpage header
• Search products page
  • Can be accessed by clicking on the aforementioned search bar
  • Allows filtering by category and/or product name
• Parameterizable content on the frontpage (settings can be configured using environments)
  • Site logo
  • Location map (at the bottom; uses above mentioned Google Map iframe embed)
  • Banners (top and bottom of the page)
  • Floating WhatsApp button
  • Contact information in footer (email, phone number)
• Two-way binding of state and query params in frontpage. Implemented states are:
  • Searching products by name and/or by category
  • Viewing individual products
• Entity model Image now has a targetUrl property
  • Slideshows images now may be able to hold links to redirect users to

Changed

• Bump Angular to v13.3
• Refactored architecture for inserting and updating data within the management module
  • Removed FormGroupOwner pseudo-interface
  • Introduced EntityTypeNames type
  • Introduced EntityFormGroupFactoryService; specializes in creating entity-specific FormGroups
    • Takes an instance of the aforementioned type
  • All entity forms do not have FormBuilder injected to them; instead, any required FormGroups can be passed through an @Input decorator
    • When none is provided, these form components can fall-back to using the aforementioned service
  • EntityFormDialog will invoke an entity form through its HTML template, not through an inner directive with ViewContainerRef.createComponent
    • Updated signature for EntityFormDialogData
• DataManagerComponentDirective<T> now exposes items$ as Observable<any[]> instead of Observable<T[]>
• When adding images, code field is now optional
• Hide frontpage heading
• Replace title in frontpage header with search bar
• AppService now exposes an userName$ observable
• Refactored receipt page to have its card as a separate component
• Let all dialogs be closed by clicking out of their bounds, except for the confirmation dialog
• Product cards hovered in frontpage use vertical gradient as a background instead of a solid color
• Renamed ITransactionalProductListContentsDataApiService
• SlideshowComponent now integrates with Angular forms

Fixed

• Modules/chunks are now effectively lazy-loaded, decreasing app loading times enormously!
• Individual item fetching in HTTP API (used when editing any data)
• Change property type of token in Sell model to string
• Missing (optional) property unitValue in SellDetail model
• Missing references in fake APIs
  • Sales data
  • Account profile
• Logic for fetching receipt data
• Several issues with responsive screens in frontpage
• Going backwards in a slideshow would omit the first index
• Prematurely end guest sessions
• Errors in products CRUD operations
  • (UI) Image associations were not loaded into the form
  • (Form validation) Categories were required at parent-form and child-form levels
  • (HTTP API) Image associations were not included in request bodies
  • (HTTP API) Filtering by partial name would send an incorrectly-named query parameter
• Do not state a limit amount of items when fetching product categories; due to their tree-like nature these must not be 'paginated'
• Add more loading indicators in the frontpage
  • Product lists
• Alignment of some components
  • Acept/cancel buttons in dialog to select multiple products
  • Fields in personal information form
  • Size adjustment of frontpage product lists (use appropiate space when there are fewer products in a list)
• Updated localization files

Removed

• All references to deprecated APIs /public/products and /public/categories
• Some placeholder images

v2.0.0

Changed

• Bumped Angular to v13 [BREAKING CHANGE]
  • IE11 is no longer supported

v1.2.2

Added

• Request confirmation from user before trying to delete any data in the management section

Fixed

• Image selection dialog issues
  • Filter not working
  • Data not being paginated

Changed

• Updated localization files

v1.2.1

Fixed

• Issue when trying to add products to cart

v1.2.0

Added

• Support for Product Lists [API v1.2]
  • Include API model, API service, management page and UI form

Changed

• Frontpage displays existing Product Lists and their contents - instead of fetching 'all' products in existence
• Updated localization files

v1.1.2

Added

• Support for sort pagination parameters [API v1.1.2]
• Support for sorting and pagination in datatables in the management page

Changed

• Prices and currency values displayed with Angular currency pipe instead of adding '$' suffix

Fixed

• Creation and general use of categories within local-memory api (such as in, the demo link)
• Issue updating categories due to calling API with wrong query parameters
• Issue opening sales data for edition due to bad template binding

v1.1.1

NOTE: This version is only available for download through this page.
Unfortunately I messed up and published the wrong package files to npm 😅 Sorry for the incovenience.

Added

• Angular i18n support
  • Include localization package
  • Mark text for translation - Now it's possible to generate translation files using the command ng extract-i18n
  • Translate texts to English, set as default language in angular.json
  • Include files and build configurations in angular.json for the following locales:
    • en-US (default)
    • es
    • es-CL (previous default)
• API models
  • New Class Shipper class with a single name property
• UI/UX
  • Manipulation of shippers
  • Manipulation of a product's category
  • Manipulation of all product categories through a tree view
    • Route added to the Management sidenav
    • This tree works on the assumption that categories are identified by a string property named code; see the section below

Changed

• API models
  • Image - add code property (API v1.0.4)
  • Person - split name property into two: lastName and firstName (API v1.1.0)
  • ReceiptDetail - add unitValue property (API v1.1.1)
  • Receipt
    • Add properties token, taxValue, transportValue, totalValue, totalItems (API v1.1.1)
    • totalValue will replace amount; make the former required and the latter optional (API v1.1.1)
      • amount will be removed in future versions
  • ProductCategory - changed type of code from number to string (API v.1.2)
• UI/UX
  • Remove requirement of category in interface for creating/editing products
  • Receipt page
    • Added table component to display details
    • Include new information added to the model itself
• API paths deprecation
  • Use query parameters instead of path parameters for all single-entity operations
    • e.g. /data/products/1 would now be called as /data/products?id=1

Fixed

• Footer remains stuck at the bottom of the page, instead of the viewport
• Interface to upload images in management module not creating any data
  • There is no available API for uploading images; use a plain-text form as fallback

Removed

• Old localhost.proxy.conf.json used to bypass CORS e.g. for servers running in localhost
  • Angular still guides users on how to create these, but it's not a good practice
  • Servers should always have CORS enabled and configured so that JavaScript apps can access them (see https://enable-cors.org/)

Other

• Testing
  • Included Edge browser launcher for Karma tests
  • Fixed all warnings raised during unit tests

v1.0.1

Fixed

• Login status not refreshing when using local memory (mock) api module
  • Fix related unit tests