nuxt-skew-protection 0.3.0 → 0.3.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/LICENSE.md CHANGED
@@ -1,51 +1,5 @@
1
- Dual License
1
+ ## License
2
2
 
3
- This software is available under two different licenses:
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
- 1. MIT License (for open source and non-commercial projects)
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
- <p align="center">
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
- Congrats on shipping that latest release! Unfortunately, many of your users are going to be using the previous version of your app
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
- Finally fixed that SEO issue? Great, but crawlers will often hit your site and request build chunks that no longer exist, leading
24
- to 500 errors and broken indexes.
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
- You've just been "skewed"! Skew is the version difference between what your users are running and what is deployed.
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
- While Nuxt helps us by hard-reloading on navigation when it detects a new release, it's often not enough to ensure a smooth experience for all users
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
- - ⚡ **Instantly Adopted Releases** - Zero-config Real-time notifications to users when a new version is deployed.
36
- - 🎯 **Targeted User Notifications** - Send update notifications only when the chunks the user has loaded have invalidated. No annoying popups for unrelated updates.
37
- - 📦 **Long-lived Build Assets** - Avoid breaking crawlers or old sessions with previous build assets remain accessible.
38
- - 🎨 **Headless UI** - Ship it quicker with a headless notification component that works perfectly with Nuxt 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
- #### Commercial License
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
- [license-src]: https://img.shields.io/github/license/harlan-zw/nuxt-skew-protection.svg?style=flat&colorA=18181B&colorB=28CF8D
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
@@ -4,7 +4,7 @@
4
4
  "nuxt": ">=4.0.0"
5
5
  },
6
6
  "configKey": "skewProtection",
7
- "version": "0.3.0",
7
+ "version": "0.3.1",
8
8
  "builder": {
9
9
  "@nuxt/module-builder": "1.0.2",
10
10
  "unbuild": "3.6.1"
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 __VLS_7: {
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 __VLS_7) => any;
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 __VLS_7: {
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 __VLS_7) => any;
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.0",
5
- "description": "Instantly adopted Nuxt releases with long-lived build assets.",
4
+ "version": "0.3.1",
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.3",
33
- "@nuxtjs/robots": "^5.5.5",
34
- "@vueuse/core": "^13.9.0",
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.10",
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.1",
42
+ "tinyexec": "^1.0.2",
43
43
  "ufo": "^1.6.1"
44
44
  },
45
45
  "devDependencies": {
46
- "@antfu/eslint-config": "^6.0.0",
46
+ "@antfu/eslint-config": "^6.2.0",
47
47
  "@arethetypeswrong/cli": "^0.18.2",
48
- "@nuxt/content": "^3.7.1",
49
- "@nuxt/devtools-ui-kit": "^2.6.5",
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.19.2",
52
- "@nuxt/ui": "^4.0.1",
53
- "@nuxtjs/color-mode": "^3.5.2",
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.1.1",
55
+ "@nuxtjs/i18n": "^10.2.1",
56
56
  "@types/ioredis": "^5.0.0",
57
57
  "@types/ws": "^8.18.1",
58
- "@unocss/nuxt": "^66.5.4",
59
- "@unocss/preset-icons": "^66.5.4",
60
- "@unocss/preset-uno": "^66.5.4",
61
- "@unocss/runtime": "^66.5.4",
62
- "@vueuse/nuxt": "^13.9.0",
63
- "better-sqlite3": "^12.4.1",
64
- "bumpp": "^10.3.1",
65
- "eslint": "^9.37.0",
66
- "eventsource": "^4.0.0",
67
- "execa": "^9.6.0",
68
- "firebase-functions": "^6.5.0",
69
- "happy-dom": "^20.0.2",
70
- "ioredis": "^5.8.1",
71
- "nuxt": "^4.1.3",
72
- "playwright-core": "^1.56.0",
73
- "tsx": "^4.20.6",
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": "^66.5.4",
76
- "unstorage": "^1.17.1",
77
- "vitest": "^3.2.4",
78
- "vue": "^3.5.22",
79
- "vue-router": "^4.6.2",
80
- "vue-tsc": "^3.1.1",
81
- "wrangler": "^4.43.0",
75
+ "unocss": "66.5.10-beta.1",
76
+ "unstorage": "^1.17.3",
77
+ "vitest": "^4.0.14",
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": {