cookbook

Version 0.6.11

• [chore] update packages & cleanup & work on improving documentation
• [js-node/expressjs] Breaking Change on configs
  • use .env file for configs, move configs from global to process.env
  • move .env files into apps/[app-template] folder
  • Mongo DB config format change, change ObjectID to ObjectId
  • JWT_CERTS, JWT_REFRESH_CERTS, HTTPS_CERTS format change
  • MONGO_OPTIONS, UPLOAD_STATIC change in format and processing
  • fixed jest tests
• [js-web/vue-vite]
  • remove cypress and use playwright (also renamed document from cypress.md to e2e.md)
  • add useMediaQuery hook
• [@es-labs/node] Breaking Change on configs
  • remove bullmq
• [js-web/react-admin] Moved to new repo https://github.com/ais-one/cookbook-ts
• [js-node/nest-admin] Moved to new repo https://github.com/ais-one/cookbook-ts

Version 0.6.10

• [chore] update packages & cleanup & work on improving documentation

Also includes the Version 0.6.9 changes below

• [chore] update packages & cleanup & work on improving documentation
• [js-web/react-admin] update to react-router-dom v6
• [js-node/nest-microservice] removed, refer to the github projects instead in README.md
• [chore] updated list of useful VS Code plugins README.md

• [chore] update packages & cleanup & work on improving documentation
• [js-web/vue-vite] integrate https://github.com/ais-one/favv/vitevue to js-web/vue-vite
• [js-web/vue-vite] update firebase messaging from 8 to 9, fix PN bugs and improve PN test on UI
• [js-node/expressjs] update firebase messaging from 8 to 9, fix PN bugs
• [chore] add sri and crossorigin to scripts - https://github.com/bigskysoftware/htmx/issues/261#issuecomment-753850081
• [js-node/expressjs] fix eslint 8.0.0 errors (remove babel-eslint package)
• [js-node/expressjs] update documentation on VS Code plugins REST Client and MongoDB for VS Code
• [js-node/expressjs] added playground file for MongoDB for VS Code
• [js-node/wip] removed fido2 project (very outdated), up-to-date example is in js-node/expressjs project
• [react-nestjs] moved projects into js-node or js-web folders as appropriate
• [js-web/lucia] removed can use petite-vue instead
• [chore] migration to node 16 and npm 8, update docs

• [chore] update packages & cleanup & work on improving documentation
• [js-web/vue-vite] make cypress work with cicd, start-server-and-test
• [backend-saml] test node-saml library without passport, implement test route /api/saml/test, you can see how to generate auth url and parse response in the code
• [backend-saml] remediate - https://github.com/node-saml/node-saml/issues/21
• [js-node/expressjs] streaming file download, create pdf, download pdf
• [react-nestjs]
  • [react-nestjs/react-admin] React + TS example from https://www.udemy.com/course/react-nest-admin/, to keep updating and further develop
  • [react-nestjs/nest-admin] NestJS example from https://www.udemy.com/course/react-nest-admin/, to keep updating and further develop
• [feat] removed husky, use git-hooks directly instead

• [chore] update packages & cleanup & work on improving documentation
• [js-node/expressjs] minor breaking change. auth callback delimiter from '-' to ';' because '-' can be found in jwt token (https://stackoverflow.com/questions/55201011/what-characters-are-allowed-in-a-jwt-token) and delimiting using '-' can be wrong, use ';' as it can be used in url hash (https://stackoverflow.com/questions/40636281/what-are-the-eligible-characters-in-a-urls-fragment-location-hash) and is not in jwt token
• [js-node/wip/k8s] moved to [docs]
• [js-web/vue-vite] minor config change VITE_SAML_URL and VITE_CALLBACK_URL to use full URL paths, simplify saml call, @es-labs/esm/saml.js REMOVED
• [js-web/vue-vite] improve structure for deployment of multiple apps
• [chore] add fido2 spa sample in [js-node/expressjs], clean up ssr example from [js-node/wip/fido2]
• [js-web/vue-vite] fix login & logout add loading spinner
• [js-web/vue-vite] cypress e2e testing

• [chore] update packages & cleanup & work on improving documentation
• [js-web/vue-vite] make it configurable
• [js-web/vue-vite] improve logged-in layout and scrollbar when overflow
• [js-node/scaled-ws] scale websockets
• [js-node/expressjs] moved jobs and uploads folder to template application, add JOB_PATH config for jobs, so path to jobs can be specified
• [chore] clean up code based on sonarcloud issues

Version 0.6.4

• [chore] update packages & cleanup & work on improving documentation
• @es-labs/node allow options to be passed in also, currently uses global.CONFIG through (@es-labs/node/config)
• @es-labs/node/services/websocket.js add onClientConnect function
• breaking changes
  • @es-labs/node/auth - convert to class
  • @es-labs/node/services/redis.js - move to @es-labs/node/services/db/redis.js
  • @es-labs/node/services/keyv.js - move to @es-labs/node/services/db/keyv.js
  • @es-labs/node/services/db - convert to class, allow multiple connections
  • @es-labs/node/services/webpush.js - add setup function, move to @es-labs/node/services/comms/webpush.js
  • @es-labs/node/comms - add setup function
  • @es-labs/node/services/gcp.js add setupStorage function
  • js-node/expressjs/apps/app-template/config/secret/README.md - improve oauth configuration
  • js-node/expressjs/router/saml.js - improve saml configuration, only have RelayState in query
  • js-node/expressjs/router/saml.js - allow multiple connections, see also the table configs

• [chore] update packages & cleanup & work on improving documentation
• [chore] improve github workflow and documentation
• [js-web/vue-vite] add sentry when ready
• [fix] typeof xx === 'object' - handle if xx is null
• [js-node/expressjs] make deployment application specific also, moved deploy folder to js-node/expressjs/apps/app-template, migration and seeding, and GCP deployment config adjusted to address the folder location change

• [chore] rename project

• [chore] update packages & cleanup & work on improving documentation
• [note] Folder renames - No breaking change except folder renames in docs and configs
  • vue-nobundler to js-web/vue-nobundler
  • vue-vite to js-web/vue-vite
  • node-utils to node-daemons and remove node-utils
  • node-daemons to js-node
  • node-express to js-node/expressjs
  • wip to js-node/wip
• [js-node/expressjs] add graphql sample code for simple CRUD (with graphiql queries & variables provided) sample
• [js-node/expressjs] improve shutdown / cleanup sample
• [js-web/vue-vite] add multi-page app example
• [js-node/expressjs] add sentry file
• [js-node/expressjs/public/demo-express] add sentry sample
• [chore] disable console.log at frontend @es-labs/esm/log-filter.js and sample

• [chore] update packages & cleanup & work on improving documentation
• [note] rename example-native to vue-nobundler - No breaking change
• [note] rename example-vite to vue-vite - No breaking change
• [note] rename example-app to node-express - Breaking change (major folder reorganization)
• [node-express] create apps/app-template (reference application, we can create more apps inside the apps folder, the custom apps can be in another repo)
• [node-express] move config to apps/app-template/config
• [node-express] move @es-labs/node/express back to node-express/common
  • [node-express] add server side event (SSE) example
  • [node-express] add serve-index function to uploads folder (list files and folders)
  • [node-express] multiple UPLOAD_STATIC & UPLOAD_MEMORY
  • [@es-labs/node] for config, do not restrict environments to development, uat, production, let user define
• [chore] remove example-webpack, document last known good version in README.md
• [node-daemons/tcpserver] stream-based TCP server
• [node-daemons/tcpserver] event-based TCP server
• [@es-labs/node] remove objection ORM
• [chore] prepare package.json for workspaces, added workspaces entry
• [node-daemons] nodejs workers
• [node-express] shared webworkers
• [node-express] openapi implementation and validation middleware
• [node-utils] create openapi file joiner, better for now to create single file for use by swagger-ui-express and express-openapi-validator
• [node-express] replace bloated and flaky apollo with express-graphql and graphql-ws, need to close nicely

Version 0.5.3

• [chore] update packages & cleanup & work on improving documentation
• [example-app] add oidc example (grant_type: authorization_code), improve further on auth structure, rename GITHUB_ to OAUTH_
• [feat] added husky

• [chore] update packages & cleanup & work on improving documentation
• [chore] upload @es-labs/esm and @es-labs/node as scoped public packages on npm
• [chore] add keycloak to docker-devenv, removed saml (kristophjunge/test-saml-idp)
• [@es-labs/node] passport-saml version 3 onward, cert needs to have value! use keycloak
• [wib/fido2] demo for web auth login (for SPA and SSR pages) (https://developers.google.com/codelabs/webauthn-reauth) - need to update webauthnsimple to v3

• [chore] update packages & cleanup & work on improving documentation
• [example-app] implement configs for helmetjs
• [example-app] web worker example file upload - https://kongaraju.blogspot.com/2012/07/large-file-upload-more-than-1gb-using.html
• [example-app] moved common-express folder files to @es-labs\node\express
• [fix] @es-labs/esm/bwc-table.js - fixed filter (so that adding or removing each filter does not remove input values), and page change bugs
• [doc] add note on commit messages
• [example-native] migrate example-webpack vue-crud-x table examples to example-native
  • clean up repeated table code [Done]
  • handle junction tables (many to many) [Done]
  • delete - delete data with related keys in other tables - use soft delete or foreign key [Done]
  • search filter for references
    • m/n (not possible, unless id value is same as label, or filter input is multi-select auto-complete) - https://dba.stackexchange.com/a/239069 [Note]
    • for multiple tags (1/m), the value and label must be same, column must use token seperated string, or filter input is multi-select auto-complete [Note]
    • for single tags (1/1) - need to search join column, or filter input is single-select auto-complete [Done]

• [chore] update packages & cleanup & work on improving documentation
• [example-vite] add rxjs example in demo (debounce, switchMap, etc)
• [example-native] urgent fix resolve CORS issue which stops js from loading

DO NOT USE, CHOOSE 0.4.8 OR HIGHER INSTEAD - FIXED CORS ERROR IN EXAMPLE-NATIVE

• [chore] update packages & cleanup & work on improving documentation
• [@es-labs/esm/bwc-combobox.js] - new component: multi-select tags, autocomplete, optional to create new, use string or object, clear text button
• [@es-labs/esm/bwc-combobox.js] - use onselect instead of onselected (does not detect this event)
• [refactor] merge example-vite and example-vite-antd, remove unnecessary plugins, removed mwc
• [@es-labs/esm/bwc-t4t-form.js] - add autocomplete

Version 0.4.5

• [chore] update packages & cleanup & work on improving documentation
• [github-actions] add github pages workflow, update manual workflow
• [example-nobundle] rename to example-native, /native
• [example-spa] rename to example-webpack (to be kept for legacy purpose)
• [example-vite] echarts v4 to v5 (ESM), mwc to 0.20.0
• [example-native] add google recaptcha
• [common-lib/esm/util.js] clarify debounce usage
• [example-vite] fix build path (dev / production), note need proper SSL cert for SW to work on non-localhost domain
• [example-app] controllers/auth.js/checkGithub - make callback URL configurable, improve github login, callback hash to include tokens instead of just token
• [example-native] moved github login here & improve on github config instructions
• [example-vite] update vite from v1 to v2
• [common-lib/esm/bwc-table.js] fix sort (was showing arrows on all columns), add new CSS variables for top value
• [example-app/router/tables/.] (generic crud) config changes
  • set our internal usage key to __key, to avoid collisions
  • hide = hide table
  • filter & sort is not enabled by default, need to set as true
• [common-lib/esm/bwc-t4t-form.js] - (generic crud) create form using web components - currently only input tag handled (TBD add select tag, and other custom tags, handle file inputs)
• [common-lib/esm/t4t-fe.js] - (generic crud) created utilities also includes validation...
• [common-lib/esm/t4t-validate.js] - (generic crud) created validation for backend use
• [example-vite] NOTE: mwc-multiselect.js is broken
• [example-vite] add initial i18n support

• [chore] update packages & cleanup & work on improving documentation
• [refactor] use common-lib for JS files used in the the frontend or backend
• [refactor] move no bundler frontend app to own folder outside example-app (example-nobundle)
• [example-nobundle] from demo-nobundler, add bulma and improve visuals
• [example-vite] remove oruga (not ready for vue3+vite), implement saml callback and configs, make it work in production build
• [bulma-web-components] created bwc-autocomplete and bwc-table (based on bulma) in common-lib/esm
• [example-app] clean up backend, table csv upload
• [common-lib/esm] https.js handle application/json & multipart/form-data, handle allow empty json() from response

• [chore] update packages & cleanup & work on improving documentation
• [example-app] simple SAML test, fixed httponly cookie, mongo options
• [example-vite] rename folder pages to views, to follow <router-view> term, add oruga ui, fixed httponly cookie
• [docker-devenv] add mysql, hashicorp vault, saml IDP
• [chore] secrets management, reduce duplication deploy e.g. GCP_PROJECT_ID, seperate config (for services) and deploy (for deployments), hashicorp vault
• [backend-deployment] multi-stage docker build

• [chore] update packages & cleanup & work on improving documentation
• [chore] github actions, github dependabot
• [frontend] stripdown & migrate bundleless vue app in express to vue 3
• [backend] lint and husky for express