@qvac/audiogen-ggml 0.4.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.4.1] - 2026-09-16
11
+
12
+ ### Changed
13
+
14
+ - Raise the `speech-cpp` floor to `2026-09-11`. The pinned engine adds an
15
+ optional Apple-only Core ML sidecar for the ACE-Step VAE decoder
16
+ (`AUDIOGEN_COREML`); the prebuilds keep it disabled, so published behavior
17
+ is unchanged until a build opts in.
18
+
19
+ - The binding loader now verifies that `require.addon()` returned an AudioGen
20
+ native binding before using it. If the result is the JavaScript package entry,
21
+ loading falls through to `#host-addon`; the resolved platform package is
22
+ validated as well, and the original lookup failure is retained as the error
23
+ cause for clearer diagnostics. Without this the wrong module was returned
24
+ verbatim and the first symptom was `createInstance is not a function` deep in
25
+ a model load. Local source-build behaviour is unchanged.
26
+
27
+ ### Fixed
28
+
29
+ - Mobile platform packages (`@qvac/audiogen-ggml-android-arm64`,
30
+ `@qvac/audiogen-ggml-ios`) are no longer `os`-filtered `optionalDependencies`
31
+ of the meta package. No build host ever reports a mobile `os`, so installers
32
+ could never select them during a cross-build and mobile bundles failed
33
+ verification with missing prebuilds. They now publish without install filters;
34
+ mobile applications declare the target's platform package as a direct
35
+ dependency pinned to the exact meta package version.
36
+
37
+
10
38
  ## [0.4.0] - 2026-09-11
11
39
 
12
40
  ### Added
package/README.md CHANGED
@@ -43,8 +43,8 @@ MiniMax-Music3 is available only in the Linux, macOS, and Windows prebuilds.
43
43
  ### Platform packages
44
44
 
45
45
  `@qvac/audiogen-ggml` is a meta package that ships the JavaScript wrapper
46
- only. The native prebuild for each host lives in a version-locked platform
47
- package selected at install time through `os`/`cpu` filtered
46
+ only. The native prebuild for each desktop host lives in a version-locked
47
+ platform package selected at install time through `os`/`cpu` filtered
48
48
  `optionalDependencies`:
49
49
 
50
50
  | Host | Package |
@@ -54,17 +54,34 @@ package selected at install time through `os`/`cpu` filtered
54
54
  | darwin-arm64 | `@qvac/audiogen-ggml-darwin-arm64` |
55
55
  | darwin-x64 | `@qvac/audiogen-ggml-darwin-x64` |
56
56
  | win32-x64 | `@qvac/audiogen-ggml-win32-x64` |
57
- | android-arm64 | `@qvac/audiogen-ggml-android-arm64` |
58
- | ios (device + simulators) | `@qvac/audiogen-ggml-ios` |
59
57
 
60
- Do not depend on platform packages directly. Supported installers are npm 7+,
61
- pnpm, bun, and Yarn Berry. Yarn v1 and `--omit=optional` installs skip the
62
- platform package and fail at require time with an error naming the missing
58
+ Do not depend on desktop platform packages directly. Supported installers are
59
+ npm 7+, pnpm, bun, and Yarn Berry. Yarn v1 and `--omit=optional` installs skip
60
+ the platform package and fail at require time with an error naming the missing
63
61
  package; a locally built `prebuilds/` directory in the package root always
64
62
  takes precedence. Use `require('@qvac/audiogen-ggml').resolveBackendsDir()`
65
63
  to locate the directory holding the host's prebuilt binaries and dynamically
66
64
  loaded ggml backends.
67
65
 
66
+ Mobile targets are cross-built, so no install host ever matches their `os`,
67
+ and `optionalDependencies` filtering can never select them. Mobile
68
+ applications must declare the target's platform package as a direct
69
+ dependency, pinned to the exact `@qvac/audiogen-ggml` version:
70
+
71
+ | Target | Package |
72
+ | --- | --- |
73
+ | android-arm64 | `@qvac/audiogen-ggml-android-arm64` |
74
+ | ios (device + simulators) | `@qvac/audiogen-ggml-ios` |
75
+
76
+ ```json
77
+ {
78
+ "dependencies": {
79
+ "@qvac/audiogen-ggml": "x.y.z",
80
+ "@qvac/audiogen-ggml-android-arm64": "x.y.z"
81
+ }
82
+ }
83
+ ```
84
+
68
85
  The published linux-x64 prebuild bundles the CUDA backend next to Vulkan; the
69
86
  linux-arm64 and Windows prebuilds ship Vulkan, and there CUDA is opt-in at
70
87
  build time via `npm run build:cuda` (or `bare-make generate -D ENABLE_CUDA=ON`;
package/binding.js CHANGED
@@ -1,18 +1,49 @@
1
1
  module.exports = loadAddon()
2
2
 
3
+ // The split meta package has no local prebuild. Some runtimes return this
4
+ // package's Javascript entry from require.addon() instead of throwing, so
5
+ // validate the result before accepting it as the native binding.
6
+
3
7
  function loadAddon() {
8
+ let cause = null
9
+
4
10
  try {
5
- return require.addon()
11
+ const addon = require.addon()
12
+ if (isNativeBinding(addon)) return addon
13
+ cause = new Error(
14
+ '@qvac/audiogen-ggml: require.addon() answered with a module that is not the native binding ' +
15
+ '(no createInstance function), so the prebuild in this package was treated as absent.'
16
+ )
6
17
  } catch (err) {
7
- return loadPlatformPackageAddon(err)
18
+ cause = err
8
19
  }
20
+
21
+ return loadPlatformPackageAddon(cause)
9
22
  }
10
23
 
11
24
  function loadPlatformPackageAddon(cause) {
25
+ let addon
26
+
12
27
  try {
13
- return require('#host-addon')
28
+ addon = require('#host-addon')
14
29
  } catch (err) {
15
30
  if (err.cause === undefined) err.cause = cause
16
31
  throw err
17
32
  }
33
+
34
+ if (!isNativeBinding(addon)) {
35
+ const err = new Error(
36
+ '@qvac/audiogen-ggml resolved #host-addon to a module that is not the native binding: ' +
37
+ 'it has no createInstance function. Check that the platform package for this host ' +
38
+ 'is installed and is not shadowed by another module of the same name.'
39
+ )
40
+ err.cause = cause
41
+ throw err
42
+ }
43
+
44
+ return addon
45
+ }
46
+
47
+ function isNativeBinding(addon) {
48
+ return addon !== null && typeof addon === 'object' && typeof addon.createInstance === 'function'
18
49
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qvac/audiogen-ggml",
3
- "version": "0.4.0",
3
+ "version": "0.4.1",
4
4
  "description": "Audio generation (music) addon for qvac",
5
5
  "addon": true,
6
6
  "engines": {
@@ -173,12 +173,10 @@
173
173
  },
174
174
  "types": "index.d.ts",
175
175
  "optionalDependencies": {
176
- "@qvac/audiogen-ggml-linux-x64": "0.4.0",
177
- "@qvac/audiogen-ggml-linux-arm64": "0.4.0",
178
- "@qvac/audiogen-ggml-darwin-arm64": "0.4.0",
179
- "@qvac/audiogen-ggml-darwin-x64": "0.4.0",
180
- "@qvac/audiogen-ggml-win32-x64": "0.4.0",
181
- "@qvac/audiogen-ggml-android-arm64": "0.4.0",
182
- "@qvac/audiogen-ggml-ios": "0.4.0"
176
+ "@qvac/audiogen-ggml-linux-x64": "0.4.1",
177
+ "@qvac/audiogen-ggml-linux-arm64": "0.4.1",
178
+ "@qvac/audiogen-ggml-darwin-arm64": "0.4.1",
179
+ "@qvac/audiogen-ggml-darwin-x64": "0.4.1",
180
+ "@qvac/audiogen-ggml-win32-x64": "0.4.1"
183
181
  }
184
182
  }