@vdaluz/astro-affiliate 0.8.0 → 0.8.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/README.md +8 -15
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# @vdaluz/astro-affiliate
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/@vdaluz/astro-affiliate)
|
|
3
4
|
[](https://github.com/vdaluz/astro-affiliate/actions/workflows/ci.yml)
|
|
5
|
+
[](LICENSE)
|
|
4
6
|
|
|
5
7
|
Affiliate links need FTC-compliant disclosure, per-channel tracking tags for reposts and syndication, and a way to keep the two in sync so a disclosure can't silently drift from the links it's supposed to cover. `@vdaluz/astro-affiliate` is a catalog resolver and disclosure component pair that enforces that link: the remark plugin fails the build if a post uses an affiliate link without declaring its program in frontmatter. Ships raw `.astro` and `.ts` - the consuming app's Astro/Vite compiles them (no prebuild step). Machinery only: the package carries no affiliate data itself, each site supplies its own catalog, tracking tags, and disclosure text via config. Proven in production on [vdaluz.com](https://vdaluz.com) and [imperfectsystems.com](https://imperfectsystems.com) - see [Consumers](#consumers).
|
|
6
8
|
|
|
@@ -10,21 +12,6 @@ Affiliate links need FTC-compliant disclosure, per-channel tracking tags for rep
|
|
|
10
12
|
npm install @vdaluz/astro-affiliate
|
|
11
13
|
```
|
|
12
14
|
|
|
13
|
-
Alternatively, a pinned https tarball from a tag works too, with no registry involved:
|
|
14
|
-
|
|
15
|
-
```jsonc
|
|
16
|
-
// package.json
|
|
17
|
-
"dependencies": {
|
|
18
|
-
"@vdaluz/astro-affiliate": "https://github.com/vdaluz/astro-affiliate/archive/refs/tags/v0.7.0.tar.gz"
|
|
19
|
-
}
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
> **Why a tarball, not `github:vdaluz/astro-affiliate#v0.2.0`?** npm canonicalizes GitHub
|
|
23
|
-
> shorthand (and even an explicit `git+https://` URL) to `git+ssh://` in the lockfile.
|
|
24
|
-
> CI runners (e.g. Cloudflare Pages/Workers) have no SSH key, so `npm ci` would fail to
|
|
25
|
-
> clone it. The `/archive/refs/tags/<tag>.tar.gz` URL is anonymous https with an integrity
|
|
26
|
-
> hash in the lockfile, it just works in CI. Bump the tag in the URL to upgrade.
|
|
27
|
-
|
|
28
15
|
Peer dependency: `astro` >= 6.
|
|
29
16
|
|
|
30
17
|
## Define your config
|
|
@@ -261,3 +248,9 @@ Issues welcome. PRs by discussion - open an issue first for anything beyond a ty
|
|
|
261
248
|
|
|
262
249
|
- [vdaluz.com](https://vdaluz.com)
|
|
263
250
|
- [imperfectsystems.com](https://imperfectsystems.com)
|
|
251
|
+
- [freetoolbox.net](https://freetoolbox.net)
|
|
252
|
+
- [vicstradamus.com](https://vicstradamus.com)
|
|
253
|
+
|
|
254
|
+
## License
|
|
255
|
+
|
|
256
|
+
MIT
|
package/package.json
CHANGED