@soundworks/core 4.0.0-alpha.9 → 5.0.1

package/CHANGELOG.md

@@ -0,0 +1,102 @@
+## v5.0.0 - 2025-01-30
+
+### Breaking
+
+_Note that most breaking changes won't break but trigger a warning._
+
+Change `SharedState` semantics:
+
+- rename `SharedStateClassSchema` to `SharedStateClassDescription`
+- rename `SharedState#schemaName` to `SharedState#className`
+- rename `SharedState#getSchema()` to `SharedState#getDescription()`
+- rename `SharedStateCollection#schemaName` to `SharedStateCollection#className`
+- rename `SharedStateCollection#getSchema()` to `SharedStateCollection#getDescription()`
+- rename `BaseStateManager.getSchema` to `BaseStateManager.getClassDescription`
+- rename `ServerStateManager.registerSchema` to `ServerStateManager.defineClass`
+- rename `ServerStateManager.deleteSchema` to `ServerStateManager.deleteClass`
+- drop support for `context` in `SharedState.set(updates, context)`
+- rename `ClientDescription.target` to `ClientDescription.runtime`
+- rename `ServerEnvConfig.subpath` to `ServerEnvConfig.baseUlr`
+- move `Server#useDefaultApplicationTemplate` into helpers: `configureHttpRouter(server)`
+- review plugin creation API
+
+### Feat
+
+- allow `SharedState.set(key, value)`
+- implement `ServerStateManager#registerCreateHook` and `ServerStateManager#registerDeleteHook`
+- implement `SharedStateCollection#onChange` --> `onChange`
+
+### Fix
+
+- harmonize all error messages
+
+## v4.0.0-alpha.29 - 2024-09-23
+
+- Feat: add required option for SharedState parameter
+- Chore: Renamed all classes to avoid namespace in doc and improve typescript support
+- Chore: improve shared states abstractions naming
+
+## v4.0.0-alpha.28 - 2024-09-06
+
+- Fix: make it can work without `node_modules` when bundled to `.cjs` for use in Max
+
+## v4.0.0-alpha.27 - 2024-09-06
+
+- Fix: assign to `const`
+
+## v4.0.0-alpha.26 - 2024-09-05
+
+- Fix: improve reconnect strategy in case of socket connection failure
+
+## v4.0.0-alpha.25 - 2024-05-24
+
+- Fix: better default behavior for WebSocket connection URL
+
+## v4.0.0-alpha.24 - 2024-05-24
+
+- Fix: unexpected behavior with new `serverAddress` behavior on browser clients and self-signed certificates
+
+## v4.0.0-alpha.23 - 2024-05-24
+
+- Breaking: remove binary socket
+- Fix: do not terminate socket on missed heartbeat, which seems to create false positive, just warn instead
+- Refactor: some work toward upgrading code to ES2022
+
+## v4.0.0-alpha.22 - 2024-05-16
+
+- Feat: allow configuring socket endpoint on browser clients
+- Feat: check and warn if version inconsistency between server and client
+
+## v4.0.0-alpha.21 - 2024-05-06
+
+- Fix: prevent multiple 'close' events
+- Fix: disable heartbeat check on client-side, was unstable
+- Feat: introduce 'local' option for SharedState parameters
+- Feat: ability to filter parameters of interest in SharedState
+
+## v4.0.0-alpha.20 - 2024-02-19
+
+- Refactor heartbeat - #86
+- Refactor state collection - #85
+- Fix issue with self signed certs and config generated by wizard - #84
+
+## v4.0.0-alpha.19 - 2024-01-17
+
+- Hot fix for #85
+
+## v4.0.0-alpha.18 - 2024-01-15
+
+- Batch network message for SharedStates
+
+## v4.0.0-alpha.17 - 2023-12-16
+
+- Support bundling the server to common js for Max externals
+
+## v4.0.0-alpha.16 - 2023-12-15
+
+- Improve StateCollection performances
+
+## v4.0.0-alpha.15 - 2023-12-13
+
+- Fix several issues with shared states
+- **Breaking Change**: by default, `StateManager::observe` and `SharedStateCollection` now retrieve locally created states

package/README.md

@@ -3,64 +3,49 @@
 [![npm version](https://badge.fury.io/js/@soundworks%2Fcore.svg)](https://badge.fury.io/js/@soundworks%2Fcore)
 [![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
 
-![soundworks-logo](./assets/logo-200x200.png)
+![soundworks-logo](./misc/assets/logo-200x200.png)
 
 Open-source creative coding framework for distributed applications based on Web technologies.
 
 Primarily focused on music, **soundworks** aims at supporting rapid development of real-time distributed applications using _JavaScript_. It provides abstractions to hide the complexity of the network and to foster very rapid-prototyping and trial-and-error workflows that are typical in artistic practices.
 
-*__WARNING: The version 4 of `@soundworks/core` is under heavy development.__*
-
-## Getting Started
-
-The best and most simple way to start using **soundworks** is to use the `@soundworks/create` wizard. 
-
-```sh
-npx @soundworks/create@latest
-```
-
-![./assets/soundworks-create-min.gif](./assets/soundworks-create-min.gif)
-
-See [https://soundworks.dev/tutorials/getting-started.html](https://soundworks.dev/tutorials/getting-started.html) for more informations on the wizard and how to start with **soundworks**.
-
-<!--
 ## Documentation
 
 - Guides and Tutorials: [https://soundworks.dev](https://soundworks.dev)
 - API: [https://soundworks.dev/api](https://soundworks.dev/api)
--->
 
-## API
+## Getting started
 
-The API is not publicly published for now. To access the API documentation locally, just clone this repository, go to the v4 branch and launch some http server in the docs directory. For example, using the [serve](https://www.npmjs.com/package/serve) package:
+The best and most simple way to start using **soundworks** is to use the `@soundworks/create` wizard. 
 
 ```sh
-git clone https://github.com/collective-soundworks/soundworks.git
-cd soundworks
-git checkout v4
-serve docs
+npx @soundworks/create@latest
 ```
 
-Feel welcome to open an [issue](https://github.com/collective-soundworks/soundworks/issues) or a PR if you find any inconsistency, error or missing information in the documentation.
+![soundworks-create](./misc/assets/soundworks-create-min.gif)
 
-## Share with Us
+See [https://soundworks.dev/tutorials/getting-started.html](https://soundworks.dev/tutorials/getting-started.html) for more information on the wizard and how to start using **soundworks**.
 
-If you made an application using **soundworks** please let us know here: https://github.com/collective-soundworks/soundworks/discussions/61
+## Misc
 
-## TypeScript Support
+### TypeScript support
 
 Basic TypeScript support will be proposed in a (hopefully) near future. 
 
 However, for maintenance reasons, we aim at following the TC39 and W3C specifications as close as possible. Therefore, we will wait for the https://github.com/tc39/proposal-type-annotations proposal to reach stage 3 to update the source code in a more integrated manner.
 
-## Install
+### Manual install
 
-Note that the `@soundworks/core` package is automatically installed when creating an application using the `@soundworks/create` wizard, so most of the time you should not have to install this package manually. See [https://soundworks.dev/guides/getting-started.html](https://soundworks.dev/guides/getting-started.html) for more informations on the **soundworks** wizard.
+Note that the `@soundworks/core` package is automatically installed when creating an application using the `@soundworks/create` wizard, so most of the time you should not have to install this package manually. See [https://soundworks.dev/guides/getting-started.html](https://soundworks.dev/guides/getting-started.html) for more information on the **soundworks** wizard.
 
 ```
 npm install @soundworks/core
 ```
 
+## Share with Us
+
+If you made an application using **soundworks** please let us know here: https://github.com/collective-soundworks/soundworks/discussions/61
+
 ## Credits
 
 [https://soundworks.dev/credits.html](https://soundworks.dev/credits.html)

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@soundworks/core",
-  "version": "4.0.0-alpha.9",
+  "version": "5.0.1",
   "description": "Open-source creative coding framework for distributed applications based on Web technologies",
-  "authors": [
+  "collaborators": [
     "Benjamin Matuszewski",
+    "Jean-Philippe Lambert",
     "Sébastien Robaszkiewicz",
     "Norbert Schnell"
   ],
@@ -43,59 +44,40 @@
     "node": ">=16.0.0"
   },
   "scripts": {
-    "doc": "rm -Rf docs && jsdoc -c .jsdoc.json --verbose && cp -R assets docs/",
+    "doc": "npm run types && rm -rf docs && jsdoc -c .jsdoc --verbose && cp -R misc/assets docs/",
     "lint": "npx eslint src",
-    "test": "mocha",
-    "toc": "markdown-toc -i README.md",
-    "types": "rm -Rf types && tsc",
-    "preversion": "npm run toc && git commit -am 'docs: build' --allow-empty"
+    "test": "npx mocha tests/*/*.spec.js",
+    "test:only": "npx mocha",
+    "types": "rm -rf types && tsc",
+    "preversion": "npm run lint && npm run test && node ./misc/scripts/generate-version-file.js $npm_new_version && npm run types",
+    "postversion": "node ./misc/scripts/check-changelog.js && git commit -am \"$npm_new_version\" --allow-empty"
   },
   "dependencies": {
-    "@ircam/sc-gettime": "^1.0.1",
-    "@ircam/sc-utils": "^1.1.1",
+    "@ircam/sc-utils": "^1.8.0",
     "chalk": "^5.3.0",
-    "columnify": "^1.6.0",
-    "compression": "^1.7.1",
-    "cross-fetch": "^3.1.8",
-    "express": "^4.18.1",
     "fast-deep-equal": "^3.1.3",
-    "fast-text-encoding": "^1.0.0",
     "isomorphic-ws": "^5.0.0",
-    "keyv": "^4.2.2",
-    "keyv-file": "^0.2.0",
-    "lodash.clonedeep": "^4.5.0",
-    "lodash.merge": "^4.6.2",
+    "keyv": "^4.5.4",
+    "keyv-file": "^0.3.1",
+    "lodash": "^4.17.21",
     "pem": "^1.14.8",
-    "template-literal": "^1.0.4",
-    "uuid": "^9.0.0",
-    "window-or-global": "^1.0.1",
-    "ws": "^8.12.0"
+    "uuid": "^9.0.1",
+    "ws": "^8.17.0"
   },
   "devDependencies": {
-    "@ircam/eslint-config": "^1.3.0",
-    "chai": "^4.3.6",
-    "chai-shallow-deep-equal": "^1.4.6",
-    "commitizen": "^4.2.5",
-    "cz-conventional-changelog": "^3.3.0",
-    "docdash": "^2.0.1",
-    "dotenv": "^16.3.1",
-    "eslint": "^8.44.0",
-    "eslint-plugin-jsdoc": "^46.4.3",
-    "generate-changelog": "^1.8.0",
-    "jsdoc": "^4.0.0",
-    "markdown-toc": "^1.2.0",
-    "mocha": "^10.2.0",
-    "puppeteer": "^20.7.4",
+    "@ircam/eslint-config": "^2.0.1",
+    "chai": "^5.1.1",
+    "docdash": "^2.0.2",
+    "dotenv": "^16.4.5",
+    "eslint": "^9.18.0",
+    "jsdoc": "^4.0.3",
+    "mocha": "^10.4.0",
+    "puppeteer": "^22.9.0",
     "tcp-ping": "^0.1.1",
-    "typescript": "^5.1.6"
+    "typescript": "^5.4.5"
   },
   "optionalDependencies": {
     "bufferutil": "^4.0.5",
     "utf-8-validate": "^5.0.7"
-  },
-  "config": {
-    "commitizen": {
-      "path": "./node_modules/cz-conventional-changelog"
-    }
   }
 }