nuxt-skew-protection 0.3.0 → 0.3.2
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/LICENSE.md
CHANGED
|
@@ -1,51 +1,5 @@
|
|
|
1
|
-
|
|
1
|
+
## License
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Nuxt Skew Protection requires a [Nuxt SEO Pro license](https://nuxtseo.com/pricing) for all use, including development and production environments.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
2. Commercial License (for commercial projects)
|
|
7
|
-
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
## MIT License (Open Source & Non-Commercial Use)
|
|
11
|
-
|
|
12
|
-
Copyright (c) 2025 Harlan Wilton
|
|
13
|
-
|
|
14
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
15
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
16
|
-
in the Software without restriction, including without limitation the rights
|
|
17
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
18
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
19
|
-
furnished to do so, subject to the following conditions:
|
|
20
|
-
|
|
21
|
-
This license applies only to:
|
|
22
|
-
- Open source projects with source code publicly available under an OSI-approved license
|
|
23
|
-
- Non-commercial projects (personal projects, educational use, non-profit organizations)
|
|
24
|
-
|
|
25
|
-
The above copyright notice and this permission notice shall be included in all
|
|
26
|
-
copies or substantial portions of the Software.
|
|
27
|
-
|
|
28
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
29
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
30
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
31
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
32
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
33
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
34
|
-
SOFTWARE.
|
|
35
|
-
|
|
36
|
-
---
|
|
37
|
-
|
|
38
|
-
## Commercial License
|
|
39
|
-
|
|
40
|
-
If you want to use this software for commercial projects, you must obtain a
|
|
41
|
-
Nuxt SEO Pro license.
|
|
42
|
-
|
|
43
|
-
Commercial use includes:
|
|
44
|
-
- Use in commercial products or services
|
|
45
|
-
- Use in projects generating revenue
|
|
46
|
-
- Use in closed-source commercial applications
|
|
47
|
-
|
|
48
|
-
For commercial licensing, please visit: https://nuxtseo.com/pricing
|
|
49
|
-
|
|
50
|
-
With a Nuxt SEO Pro license, your source code remains proprietary and you are
|
|
51
|
-
not required to open source your application.
|
|
5
|
+
Your source code remains proprietary - no open-source requirements.
|
package/README.md
CHANGED
|
@@ -2,40 +2,28 @@
|
|
|
2
2
|
|
|
3
3
|
[![npm version][npm-version-src]][npm-version-href]
|
|
4
4
|
[![npm downloads][npm-downloads-src]][npm-downloads-href]
|
|
5
|
-
[![License][license-src]][license-href]
|
|
6
5
|
[![Nuxt][nuxt-src]][nuxt-href]
|
|
7
6
|
|
|
8
|
-
|
|
9
|
-
<table>
|
|
10
|
-
<tbody>
|
|
11
|
-
<td align="center">
|
|
12
|
-
<sub>Made possible by my <a href="https://github.com/sponsors/harlan-zw">Sponsor Program 💖</a><br> Follow me <a href="https://twitter.com/harlan_zw">@harlan_zw</a> 🐦 • Join <a href="https://discord.gg/275MBUBvgP">Discord</a> for help</sub><br>
|
|
13
|
-
</td>
|
|
14
|
-
</tbody>
|
|
15
|
-
</table>
|
|
16
|
-
</p>
|
|
7
|
+
> Solve Nuxt version skew with persistent assets and instant updates.
|
|
17
8
|
|
|
18
9
|
## Why Nuxt Skew Protection?
|
|
19
10
|
|
|
20
|
-
|
|
21
|
-
for hours to days afterward until they refresh.
|
|
11
|
+
**Version skew** is a mismatch between your deployed build and the chunks running in user browsers and crawler sessions. It can lead to several issues:
|
|
22
12
|
|
|
23
|
-
|
|
24
|
-
to
|
|
13
|
+
- 🕷️ **Crawlers 404 on stale chunks** - Googlebot requests `_nuxt/builds/abc123.js` which no longer exists post-deploy, logging 500s and potentially impacting indexing
|
|
14
|
+
- 💥 **ChunkLoadError in production** - Users mid-session get `Failed to fetch dynamically imported module` when navigating to routes with invalidated chunks
|
|
15
|
+
- 🔄 **Delayed rollout** - Your latest release sits unloaded until users hard refresh, sometimes hours or days later
|
|
25
16
|
|
|
26
|
-
|
|
17
|
+
Nuxt's built-in behavior (hard-reload when a new deployment is detected) helps, but in many cases it's [not enough](https://github.com/nuxt/nuxt/issues/29624).
|
|
27
18
|
|
|
28
|
-
|
|
29
|
-
and crawlers. Just check out one of Nuxt's top commented [issues](https://github.com/nuxt/nuxt/issues/29624).
|
|
30
|
-
|
|
31
|
-
Nuxt Skew Protection aims to solve skews by providing better UX on top of app updates as well as long-lived build assets to avoid breaking crawlers and old sessions.
|
|
19
|
+
Nuxt Skew Protection solves this with proactive update prompts and persistent build assets across deploys.
|
|
32
20
|
|
|
33
21
|
## Features
|
|
34
22
|
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
-
|
|
38
|
-
- 🎨 **Headless UI** -
|
|
23
|
+
- 🕷️ **Persistent Build Assets** - Previous build artifacts remain accessible, so crawlers and stale sessions never hit dead ends.
|
|
24
|
+
- ⚡ **Instant Update Prompts** - Zero-config real-time notifications on deploy. Users adopt your latest build immediately.
|
|
25
|
+
- 🎯 **Chunk-Aware Targeting** - Notifications fire only when the user's loaded chunks are invalidated. No noise for unrelated updates.
|
|
26
|
+
- 🎨 **Headless UI** - Drop-in notification component with first-class Nuxt UI support.
|
|
39
27
|
|
|
40
28
|
## Installation
|
|
41
29
|
|
|
@@ -45,12 +33,6 @@ Install `nuxt-skew-protection` dependency to your project:
|
|
|
45
33
|
npx nuxi@latest module add nuxt-skew-protection
|
|
46
34
|
```
|
|
47
35
|
|
|
48
|
-
## License & Early Access
|
|
49
|
-
|
|
50
|
-
**This module is in early access (v0.x).** All v0.x versions are MIT licensed for all projects to enable broader testing and feedback on stability.
|
|
51
|
-
|
|
52
|
-
Nuxt Skew Protection is a [Nuxt SEO Pro](https://nuxtseo.com/pricing) module. Once stable (v1+), a commercial license will be required for commercial use. **You can always use v0.x versions without a license.** See [licensing](#license) for details.
|
|
53
|
-
|
|
54
36
|
## Documentation
|
|
55
37
|
|
|
56
38
|
[📖 Read the full documentation](https://nuxtseo.com/skew-protection) for more information.
|
|
@@ -65,22 +47,7 @@ Nuxt Skew Protection is a [Nuxt SEO Pro](https://nuxtseo.com/pricing) module. On
|
|
|
65
47
|
|
|
66
48
|
## License
|
|
67
49
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
Nuxt Skew Protection requires a paid license when using it for commercial projects. With this license, your source code remains proprietary.
|
|
71
|
-
|
|
72
|
-
See the [Nuxt SEO Pro](https://nuxtseo.com/pricing) to purchase or contact me at harlan@harlanzw.com.
|
|
73
|
-
|
|
74
|
-
Commercial use includes:
|
|
75
|
-
- Use in commercial products or services
|
|
76
|
-
- Use in projects generating revenue
|
|
77
|
-
- Use in closed-source commercial applications
|
|
78
|
-
|
|
79
|
-
#### Open Source & Non-Commercial License
|
|
80
|
-
|
|
81
|
-
If you are creating an open source project or using this for non-commercial purposes (personal projects, educational use, non-profit organizations), you may use this project under the terms of the MIT License.
|
|
82
|
-
|
|
83
|
-
See [LICENSE](https://github.com/harlan-zw/nuxt-skew-protection/blob/main/LICENSE) for full details.
|
|
50
|
+
Nuxt Skew Protection requires a [Nuxt SEO Pro license](https://nuxtseo.com/pro), see [LICENSE](https://github.com/harlan-zw/nuxt-skew-protection/blob/main/LICENSE) for full details.
|
|
84
51
|
|
|
85
52
|
<!-- Badges -->
|
|
86
53
|
[npm-version-src]: https://img.shields.io/npm/v/nuxt-skew-protection/latest.svg?style=flat&colorA=18181B&colorB=28CF8D
|
|
@@ -89,8 +56,5 @@ See [LICENSE](https://github.com/harlan-zw/nuxt-skew-protection/blob/main/LICENS
|
|
|
89
56
|
[npm-downloads-src]: https://img.shields.io/npm/dm/nuxt-skew-protection.svg?style=flat&colorA=18181B&colorB=28CF8D
|
|
90
57
|
[npm-downloads-href]: https://npmjs.com/package/nuxt-skew-protection
|
|
91
58
|
|
|
92
|
-
[
|
|
93
|
-
[license-href]: https://github.com/harlan-zw/nuxt-skew-protection/blob/main/LICENSE.md
|
|
94
|
-
|
|
95
|
-
[nuxt-src]: https://img.shields.io/badge/Nuxt-18181B?logo=nuxt.js
|
|
59
|
+
[nuxt-src]: https://img.shields.io/badge/Nuxt-18181B?logo=nuxt
|
|
96
60
|
[nuxt-href]: https://nuxt.com
|
package/dist/module.json
CHANGED
package/dist/module.mjs
CHANGED
|
@@ -524,7 +524,7 @@ function createAssetManager(options) {
|
|
|
524
524
|
};
|
|
525
525
|
}
|
|
526
526
|
|
|
527
|
-
const module = defineNuxtModule({
|
|
527
|
+
const module$1 = defineNuxtModule({
|
|
528
528
|
meta: {
|
|
529
529
|
name: "nuxt-skew-protection",
|
|
530
530
|
compatibility: {
|
|
@@ -751,4 +751,4 @@ export {}
|
|
|
751
751
|
}
|
|
752
752
|
});
|
|
753
753
|
|
|
754
|
-
export { module as default };
|
|
754
|
+
export { module$1 as default };
|
|
@@ -5,7 +5,7 @@ interface Props {
|
|
|
5
5
|
*/
|
|
6
6
|
forceOpen?: boolean;
|
|
7
7
|
}
|
|
8
|
-
declare var
|
|
8
|
+
declare var __VLS_8: {
|
|
9
9
|
version: any;
|
|
10
10
|
isCurrentChunksOutdated: any;
|
|
11
11
|
dismiss: any;
|
|
@@ -16,7 +16,7 @@ declare var __VLS_7: {
|
|
|
16
16
|
isAppOutdated: any;
|
|
17
17
|
};
|
|
18
18
|
type __VLS_Slots = {} & {
|
|
19
|
-
default?: (props: typeof
|
|
19
|
+
default?: (props: typeof __VLS_8) => any;
|
|
20
20
|
};
|
|
21
21
|
declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
|
|
22
22
|
dismiss: () => any;
|
|
@@ -5,7 +5,7 @@ interface Props {
|
|
|
5
5
|
*/
|
|
6
6
|
forceOpen?: boolean;
|
|
7
7
|
}
|
|
8
|
-
declare var
|
|
8
|
+
declare var __VLS_8: {
|
|
9
9
|
version: any;
|
|
10
10
|
isCurrentChunksOutdated: any;
|
|
11
11
|
dismiss: any;
|
|
@@ -16,7 +16,7 @@ declare var __VLS_7: {
|
|
|
16
16
|
isAppOutdated: any;
|
|
17
17
|
};
|
|
18
18
|
type __VLS_Slots = {} & {
|
|
19
|
-
default?: (props: typeof
|
|
19
|
+
default?: (props: typeof __VLS_8) => any;
|
|
20
20
|
};
|
|
21
21
|
declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
|
|
22
22
|
dismiss: () => any;
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nuxt-skew-protection",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "0.3.
|
|
5
|
-
"description": "
|
|
4
|
+
"version": "0.3.2",
|
|
5
|
+
"description": "Solve Nuxt version skews with persistent assets and instant updates.",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "Harlan Wilton",
|
|
8
8
|
"email": "harlan@harlanzw.com",
|
|
@@ -29,56 +29,56 @@
|
|
|
29
29
|
"dist"
|
|
30
30
|
],
|
|
31
31
|
"dependencies": {
|
|
32
|
-
"@nuxt/kit": "^4.1
|
|
33
|
-
"@nuxtjs/robots": "^5.
|
|
34
|
-
"@vueuse/core": "^
|
|
32
|
+
"@nuxt/kit": "^4.2.1",
|
|
33
|
+
"@nuxtjs/robots": "^5.6.0",
|
|
34
|
+
"@vueuse/core": "^14.1.0",
|
|
35
35
|
"consola": "^3.4.2",
|
|
36
36
|
"cookie-es": "^2.0.0",
|
|
37
37
|
"defu": "^6.1.4",
|
|
38
|
-
"nuxt-site-config": "^3.2.
|
|
38
|
+
"nuxt-site-config": "^3.2.11",
|
|
39
39
|
"pathe": "^2.0.3",
|
|
40
40
|
"pkg-types": "^2.3.0",
|
|
41
41
|
"std-env": "^3.10.0",
|
|
42
|
-
"tinyexec": "^1.0.
|
|
42
|
+
"tinyexec": "^1.0.2",
|
|
43
43
|
"ufo": "^1.6.1"
|
|
44
44
|
},
|
|
45
45
|
"devDependencies": {
|
|
46
|
-
"@antfu/eslint-config": "^6.
|
|
46
|
+
"@antfu/eslint-config": "^6.2.0",
|
|
47
47
|
"@arethetypeswrong/cli": "^0.18.2",
|
|
48
|
-
"@nuxt/content": "^3.
|
|
49
|
-
"@nuxt/devtools-ui-kit": "^
|
|
48
|
+
"@nuxt/content": "^3.8.2",
|
|
49
|
+
"@nuxt/devtools-ui-kit": "^3.1.1",
|
|
50
50
|
"@nuxt/module-builder": "^1.0.2",
|
|
51
|
-
"@nuxt/test-utils": "^3.
|
|
52
|
-
"@nuxt/ui": "^4.
|
|
53
|
-
"@nuxtjs/color-mode": "^
|
|
51
|
+
"@nuxt/test-utils": "^3.20.1",
|
|
52
|
+
"@nuxt/ui": "^4.2.1",
|
|
53
|
+
"@nuxtjs/color-mode": "^4.0.0",
|
|
54
54
|
"@nuxtjs/eslint-config-typescript": "^12.1.0",
|
|
55
|
-
"@nuxtjs/i18n": "^10.
|
|
55
|
+
"@nuxtjs/i18n": "^10.2.1",
|
|
56
56
|
"@types/ioredis": "^5.0.0",
|
|
57
57
|
"@types/ws": "^8.18.1",
|
|
58
|
-
"@unocss/nuxt": "
|
|
59
|
-
"@unocss/preset-icons": "
|
|
60
|
-
"@unocss/preset-uno": "
|
|
61
|
-
"@unocss/runtime": "
|
|
62
|
-
"@vueuse/nuxt": "^
|
|
63
|
-
"better-sqlite3": "^12.
|
|
64
|
-
"bumpp": "^10.3.
|
|
65
|
-
"eslint": "^9.
|
|
66
|
-
"eventsource": "^4.
|
|
67
|
-
"execa": "^9.6.
|
|
68
|
-
"firebase-functions": "^
|
|
69
|
-
"happy-dom": "^20.0.
|
|
70
|
-
"ioredis": "^5.8.
|
|
71
|
-
"nuxt": "^4.1
|
|
72
|
-
"playwright-core": "^1.
|
|
73
|
-
"tsx": "^4.
|
|
58
|
+
"@unocss/nuxt": "66.5.10-beta.1",
|
|
59
|
+
"@unocss/preset-icons": "66.5.10-beta.1",
|
|
60
|
+
"@unocss/preset-uno": "66.5.10-beta.1",
|
|
61
|
+
"@unocss/runtime": "66.5.10-beta.1",
|
|
62
|
+
"@vueuse/nuxt": "^14.1.0",
|
|
63
|
+
"better-sqlite3": "^12.5.0",
|
|
64
|
+
"bumpp": "^10.3.2",
|
|
65
|
+
"eslint": "^9.39.1",
|
|
66
|
+
"eventsource": "^4.1.0",
|
|
67
|
+
"execa": "^9.6.1",
|
|
68
|
+
"firebase-functions": "^7.0.0",
|
|
69
|
+
"happy-dom": "^20.0.11",
|
|
70
|
+
"ioredis": "^5.8.2",
|
|
71
|
+
"nuxt": "^4.2.1",
|
|
72
|
+
"playwright-core": "^1.57.0",
|
|
73
|
+
"tsx": "^4.21.0",
|
|
74
74
|
"typescript": "^5.9.3",
|
|
75
|
-
"unocss": "
|
|
76
|
-
"unstorage": "^1.17.
|
|
77
|
-
"vitest": "^
|
|
78
|
-
"vue": "^3.5.
|
|
79
|
-
"vue-router": "^4.6.
|
|
80
|
-
"vue-tsc": "^3.1.
|
|
81
|
-
"wrangler": "^4.
|
|
75
|
+
"unocss": "66.5.10-beta.1",
|
|
76
|
+
"unstorage": "^1.17.3",
|
|
77
|
+
"vitest": "^4.0.15",
|
|
78
|
+
"vue": "^3.5.25",
|
|
79
|
+
"vue-router": "^4.6.3",
|
|
80
|
+
"vue-tsc": "^3.1.5",
|
|
81
|
+
"wrangler": "^4.51.0",
|
|
82
82
|
"ws": "^8.18.3"
|
|
83
83
|
},
|
|
84
84
|
"resolutions": {
|