react-credly-badges 0.0.0-stage → 1.1.0
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 +21 -0
- package/README.md +91 -2
- package/dist/client/index.cjs +208 -0
- package/dist/client/index.cjs.map +1 -0
- package/dist/client/index.d.cts +23 -0
- package/dist/client/index.d.ts +23 -0
- package/dist/client/index.js +172 -0
- package/dist/client/index.js.map +1 -0
- package/package.json +74 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Ahamed Safnaj
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,92 @@
|
|
|
1
|
-
#
|
|
1
|
+
# react-credly-badges
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
A lightweight React + TypeScript component for displaying public Credly badges.
|
|
4
|
+
Supports React 17, 18.2, and 19, with horizontal or vertical layouts and optional
|
|
5
|
+
grouping by issuer. Badge images link to their Credly verification pages.
|
|
6
|
+
|
|
7
|
+
## Setup
|
|
8
|
+
|
|
9
|
+
Install the library in your React application:
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
npm install react-credly-badges
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Import the component and pass your Credly profile username:
|
|
16
|
+
|
|
17
|
+
```tsx
|
|
18
|
+
import { CredlyBadges } from "react-credly-badges";
|
|
19
|
+
|
|
20
|
+
export default function App() {
|
|
21
|
+
return <CredlyBadges username='ahamed-safnaj' />;
|
|
22
|
+
}
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
No API key or application backend is required. Only public badges are available.
|
|
26
|
+
In frameworks with server components, render this component inside a client
|
|
27
|
+
component.
|
|
28
|
+
|
|
29
|
+
### Options
|
|
30
|
+
|
|
31
|
+
| Prop | Description | Default |
|
|
32
|
+
| ----------- | -------------------------------------------------------- | ------------------------ |
|
|
33
|
+
| `username` | Credly profile username (required). | - |
|
|
34
|
+
| `direction` | `"horizontal"` or `"vertical"`. | `"horizontal"` |
|
|
35
|
+
| `groupBy` | Set to `"issuer"` to group badges under issuer headings. | No grouping |
|
|
36
|
+
| `endpoint` | URL of a compatible proxy, if self-hosting. | Hosted Cloudflare Worker |
|
|
37
|
+
| `className` | CSS class for the outer container. | - |
|
|
38
|
+
| `style` | Inline styles for the outer container. | - |
|
|
39
|
+
|
|
40
|
+
```tsx
|
|
41
|
+
<CredlyBadges username='ahamed-safnaj' direction='vertical' groupBy='issuer' />
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Without grouping, badges retain the endpoint's order. Issuer groups follow their
|
|
45
|
+
first appearance in the response; badges within each group are sorted newest
|
|
46
|
+
first, with undated badges last. Missing issuers appear under "Unknown issuer".
|
|
47
|
+
|
|
48
|
+
## How the proxy works
|
|
49
|
+
|
|
50
|
+
The component sends the username to a hosted Cloudflare Worker. The Worker
|
|
51
|
+
fetches public badge data from Credly, validates and normalizes it, and returns
|
|
52
|
+
JSON with CORS headers so the browser can read it. Images load directly from
|
|
53
|
+
their source URLs; the Worker does not proxy image bytes.
|
|
54
|
+
|
|
55
|
+
Cloudflare Workers provides a serverless endpoint and edge caching without
|
|
56
|
+
requiring every application to run its own backend. Responses are
|
|
57
|
+
cached for six hours, with a stale copy available for up to seven days when
|
|
58
|
+
Credly is unavailable.
|
|
59
|
+
|
|
60
|
+
The proxy source is in [worker/worker.js](worker/worker.js) and is deployed
|
|
61
|
+
separately from the npm package. To self-host, deploy it as a Cloudflare Worker
|
|
62
|
+
and pass its URL through `endpoint`.
|
|
63
|
+
|
|
64
|
+
## Development
|
|
65
|
+
|
|
66
|
+
Use Node.js 24 and npm.
|
|
67
|
+
|
|
68
|
+
```sh
|
|
69
|
+
npm ci
|
|
70
|
+
npm run typecheck
|
|
71
|
+
npm run lint
|
|
72
|
+
npm run build
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Use [Conventional Commits](https://www.conventionalcommits.org/), such as
|
|
76
|
+
`feat: group badges by issuer`, `fix: handle empty responses`, or
|
|
77
|
+
`docs: update setup instructions`. Commit messages and PR titles are checked
|
|
78
|
+
in CI.
|
|
79
|
+
|
|
80
|
+
## Releases
|
|
81
|
+
|
|
82
|
+
After CI passes on `main`, semantic-release publishes release-worthy changes
|
|
83
|
+
to npm and creates a GitHub release. Versions are determined from Conventional
|
|
84
|
+
Commits; no manual version bump is needed.
|
|
85
|
+
|
|
86
|
+
## License and disclaimer
|
|
87
|
+
|
|
88
|
+
This package is `UNLICENSED`; no open-source license or permission to reuse the
|
|
89
|
+
code is granted.
|
|
90
|
+
|
|
91
|
+
This is an unofficial integration, not affiliated with or endorsed by Credly.
|
|
92
|
+
Your username is sent to the configured proxy to retrieve public badges.
|
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
"use strict";
|
|
3
|
+
var __create = Object.create;
|
|
4
|
+
var __defProp = Object.defineProperty;
|
|
5
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
6
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
7
|
+
var __getProtoOf = Object.getPrototypeOf;
|
|
8
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
9
|
+
var __export = (target, all) => {
|
|
10
|
+
for (var name in all)
|
|
11
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
12
|
+
};
|
|
13
|
+
var __copyProps = (to, from, except, desc) => {
|
|
14
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
15
|
+
for (let key of __getOwnPropNames(from))
|
|
16
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
17
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
18
|
+
}
|
|
19
|
+
return to;
|
|
20
|
+
};
|
|
21
|
+
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
|
|
22
|
+
// If the importer is in node compatibility mode or this is not an ESM
|
|
23
|
+
// file that has been converted to a CommonJS file using a Babel-
|
|
24
|
+
// compatible transform (i.e. "__esModule" has not been set), then set
|
|
25
|
+
// "default" to the CommonJS "module.exports" for node compatibility.
|
|
26
|
+
isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
|
|
27
|
+
mod
|
|
28
|
+
));
|
|
29
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
30
|
+
|
|
31
|
+
// src/index.ts
|
|
32
|
+
var src_exports = {};
|
|
33
|
+
__export(src_exports, {
|
|
34
|
+
CredlyBadges: () => CredlyBadges
|
|
35
|
+
});
|
|
36
|
+
module.exports = __toCommonJS(src_exports);
|
|
37
|
+
|
|
38
|
+
// src/components/CredlyBadges.tsx
|
|
39
|
+
var import_react = __toESM(require("react"), 1);
|
|
40
|
+
|
|
41
|
+
// src/shared/badges.ts
|
|
42
|
+
function groupBadgesByIssuer(badges) {
|
|
43
|
+
const groups = /* @__PURE__ */ new Map();
|
|
44
|
+
for (const badge of badges) {
|
|
45
|
+
const issuer = badge.issuerName ?? "Unknown issuer";
|
|
46
|
+
const group = groups.get(issuer);
|
|
47
|
+
if (group) {
|
|
48
|
+
group.badges.push(badge);
|
|
49
|
+
} else {
|
|
50
|
+
groups.set(issuer, { issuer, badges: [badge] });
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
return Array.from(groups.values(), (group) => ({
|
|
54
|
+
...group,
|
|
55
|
+
badges: group.badges.map((badge, index) => ({ badge, index })).sort((a, b) => {
|
|
56
|
+
const aDate = a.badge.issuedAt ? Date.parse(a.badge.issuedAt) : null;
|
|
57
|
+
const bDate = b.badge.issuedAt ? Date.parse(b.badge.issuedAt) : null;
|
|
58
|
+
if (aDate === null && bDate === null) return a.index - b.index;
|
|
59
|
+
if (aDate === null) return 1;
|
|
60
|
+
if (bDate === null) return -1;
|
|
61
|
+
return bDate - aDate || a.index - b.index;
|
|
62
|
+
}).map(({ badge }) => badge)
|
|
63
|
+
}));
|
|
64
|
+
}
|
|
65
|
+
function isRecord(value) {
|
|
66
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
67
|
+
}
|
|
68
|
+
function isNonEmptyString(value) {
|
|
69
|
+
return typeof value === "string" && value.trim().length > 0;
|
|
70
|
+
}
|
|
71
|
+
function isHttpsUrl(value) {
|
|
72
|
+
if (!isNonEmptyString(value)) return false;
|
|
73
|
+
try {
|
|
74
|
+
return new URL(value).protocol === "https:";
|
|
75
|
+
} catch {
|
|
76
|
+
return false;
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
function parseBadges(value) {
|
|
80
|
+
const isWorkerResponse = isRecord(value);
|
|
81
|
+
const badges = isWorkerResponse ? value.badges : value;
|
|
82
|
+
if (!Array.isArray(badges)) {
|
|
83
|
+
throw new Error("The badges endpoint must return a JSON array or an object with a badges array.");
|
|
84
|
+
}
|
|
85
|
+
return badges.map((badge) => {
|
|
86
|
+
const url = isRecord(badge) ? isWorkerResponse ? badge.badgeUrl : badge.url : void 0;
|
|
87
|
+
if (!isRecord(badge) || !isNonEmptyString(badge.id) || !isNonEmptyString(badge.name) || !isHttpsUrl(badge.imageUrl) || !isHttpsUrl(url)) {
|
|
88
|
+
throw new Error("The badges endpoint returned an invalid badge.");
|
|
89
|
+
}
|
|
90
|
+
return {
|
|
91
|
+
id: badge.id,
|
|
92
|
+
name: badge.name,
|
|
93
|
+
imageUrl: badge.imageUrl,
|
|
94
|
+
url,
|
|
95
|
+
issuerName: isNonEmptyString(badge.issuerName) ? badge.issuerName.trim() : null,
|
|
96
|
+
issuedAt: isNonEmptyString(badge.issuedAt) && !Number.isNaN(Date.parse(badge.issuedAt)) ? badge.issuedAt : null
|
|
97
|
+
};
|
|
98
|
+
});
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
// src/components/BadgeItem.tsx
|
|
102
|
+
var React = __toESM(require("react"), 1);
|
|
103
|
+
function BadgeItem({ badge }) {
|
|
104
|
+
return /* @__PURE__ */ React.createElement("li", null, /* @__PURE__ */ React.createElement("a", { href: badge.url, target: "_blank", rel: "noopener noreferrer" }, /* @__PURE__ */ React.createElement(
|
|
105
|
+
"img",
|
|
106
|
+
{
|
|
107
|
+
src: badge.imageUrl,
|
|
108
|
+
alt: badge.name,
|
|
109
|
+
width: 120,
|
|
110
|
+
height: 120,
|
|
111
|
+
loading: "lazy",
|
|
112
|
+
style: { objectFit: "contain" }
|
|
113
|
+
}
|
|
114
|
+
)));
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
// src/components/CredlyBadges.tsx
|
|
118
|
+
function CredlyBadges({
|
|
119
|
+
username,
|
|
120
|
+
direction = "horizontal",
|
|
121
|
+
groupBy,
|
|
122
|
+
endpoint = "https://react-credly-badges.safnaj99.workers.dev/",
|
|
123
|
+
className,
|
|
124
|
+
style
|
|
125
|
+
}) {
|
|
126
|
+
const key = JSON.stringify([username, endpoint]);
|
|
127
|
+
const [state, setState] = import_react.default.useState({
|
|
128
|
+
key,
|
|
129
|
+
status: "loading"
|
|
130
|
+
});
|
|
131
|
+
(0, import_react.useEffect)(() => {
|
|
132
|
+
const controller = new AbortController();
|
|
133
|
+
let active = true;
|
|
134
|
+
setState({ key, status: "loading" });
|
|
135
|
+
async function loadBadges() {
|
|
136
|
+
try {
|
|
137
|
+
if (!username.trim()) {
|
|
138
|
+
throw new Error("A Credly username is required.");
|
|
139
|
+
}
|
|
140
|
+
const url = new URL(endpoint, window.location.href);
|
|
141
|
+
url.searchParams.set("username", username.trim());
|
|
142
|
+
const response = await fetch(url, {
|
|
143
|
+
headers: { Accept: "application/json" },
|
|
144
|
+
signal: controller.signal
|
|
145
|
+
});
|
|
146
|
+
if (!response.ok) {
|
|
147
|
+
throw new Error(
|
|
148
|
+
`Unable to load Credly badges (HTTP ${response.status}).`
|
|
149
|
+
);
|
|
150
|
+
}
|
|
151
|
+
const payload = await response.json();
|
|
152
|
+
const badges = parseBadges(payload);
|
|
153
|
+
if (active) setState({ key, status: "success", badges });
|
|
154
|
+
} catch (error) {
|
|
155
|
+
if (active) {
|
|
156
|
+
setState({
|
|
157
|
+
key,
|
|
158
|
+
status: "error",
|
|
159
|
+
message: error instanceof Error ? error.message : "Unable to load Credly badges."
|
|
160
|
+
});
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
void loadBadges();
|
|
165
|
+
return () => {
|
|
166
|
+
active = false;
|
|
167
|
+
controller.abort();
|
|
168
|
+
};
|
|
169
|
+
}, [username, endpoint, key]);
|
|
170
|
+
const current = state.key === key ? state : { key, status: "loading" };
|
|
171
|
+
const groupedBadges = current.status === "success" && groupBy === "issuer" ? groupBadgesByIssuer(current.badges) : [];
|
|
172
|
+
return /* @__PURE__ */ import_react.default.createElement("div", { className, style }, current.status === "loading" && /* @__PURE__ */ import_react.default.createElement("p", { role: "status" }, "Loading Credly badges..."), current.status === "error" && /* @__PURE__ */ import_react.default.createElement("p", { role: "alert" }, current.message), current.status === "success" && (current.badges.length === 0 ? /* @__PURE__ */ import_react.default.createElement("p", { role: "status" }, "No public Credly badges found.") : /* @__PURE__ */ import_react.default.createElement(
|
|
173
|
+
"ul",
|
|
174
|
+
{
|
|
175
|
+
"aria-label": `Credly badges for ${username}`,
|
|
176
|
+
style: {
|
|
177
|
+
display: "flex",
|
|
178
|
+
flexDirection: direction === "vertical" ? "column" : "row",
|
|
179
|
+
flexWrap: direction === "vertical" ? "nowrap" : "wrap",
|
|
180
|
+
gap: "1rem",
|
|
181
|
+
listStyle: "none",
|
|
182
|
+
margin: 0,
|
|
183
|
+
padding: 0
|
|
184
|
+
}
|
|
185
|
+
},
|
|
186
|
+
groupBy === "issuer" ? groupedBadges.map(({ issuer, badges }) => /* @__PURE__ */ import_react.default.createElement("li", { key: issuer }, /* @__PURE__ */ import_react.default.createElement("h2", null, issuer), /* @__PURE__ */ import_react.default.createElement(
|
|
187
|
+
"ul",
|
|
188
|
+
{
|
|
189
|
+
"aria-label": `Credly badges from ${issuer}`,
|
|
190
|
+
style: {
|
|
191
|
+
display: "flex",
|
|
192
|
+
flexDirection: direction === "vertical" ? "column" : "row",
|
|
193
|
+
flexWrap: direction === "vertical" ? "nowrap" : "wrap",
|
|
194
|
+
gap: "1rem",
|
|
195
|
+
listStyle: "none",
|
|
196
|
+
margin: 0,
|
|
197
|
+
padding: 0
|
|
198
|
+
}
|
|
199
|
+
},
|
|
200
|
+
badges.map((badge) => /* @__PURE__ */ import_react.default.createElement(BadgeItem, { key: badge.id, badge }))
|
|
201
|
+
))) : current.badges.map((badge) => /* @__PURE__ */ import_react.default.createElement(BadgeItem, { key: badge.id, badge }))
|
|
202
|
+
)));
|
|
203
|
+
}
|
|
204
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
205
|
+
0 && (module.exports = {
|
|
206
|
+
CredlyBadges
|
|
207
|
+
});
|
|
208
|
+
//# sourceMappingURL=index.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/index.ts","../../src/components/CredlyBadges.tsx","../../src/shared/badges.ts","../../src/components/BadgeItem.tsx"],"sourcesContent":["export { CredlyBadges } from './components/CredlyBadges';\nexport type { CredlyBadgesProps } from './components/CredlyBadges';\nexport type { CredlyBadge } from './shared/badges';\n","import React, { useEffect } from \"react\";\nimport type { CSSProperties } from \"react\";\nimport { groupBadgesByIssuer, parseBadges } from \"../shared/badges\";\nimport type { CredlyBadge } from \"../shared/badges\";\nimport { BadgeItem } from \"./BadgeItem\";\n\nexport interface CredlyBadgesProps {\n username: string;\n direction?: \"horizontal\" | \"vertical\";\n groupBy?: \"issuer\";\n endpoint?: string;\n className?: string;\n style?: CSSProperties;\n}\n\ntype BadgeState =\n | { key: string; status: \"loading\" }\n | { key: string; status: \"success\"; badges: CredlyBadge[] }\n | { key: string; status: \"error\"; message: string };\n\nexport function CredlyBadges({\n username,\n direction = \"horizontal\",\n groupBy,\n endpoint = \"https://react-credly-badges.safnaj99.workers.dev/\",\n className,\n style,\n}: CredlyBadgesProps) {\n const key = JSON.stringify([username, endpoint]);\n const [state, setState] = React.useState<BadgeState>({\n key,\n status: \"loading\",\n });\n\n useEffect(() => {\n const controller = new AbortController();\n let active = true;\n setState({ key, status: \"loading\" });\n\n async function loadBadges() {\n try {\n if (!username.trim()) {\n throw new Error(\"A Credly username is required.\");\n }\n\n const url = new URL(endpoint, window.location.href);\n url.searchParams.set(\"username\", username.trim());\n const response = await fetch(url, {\n headers: { Accept: \"application/json\" },\n signal: controller.signal,\n });\n\n if (!response.ok) {\n throw new Error(\n `Unable to load Credly badges (HTTP ${response.status}).`,\n );\n }\n\n const payload: unknown = await response.json();\n const badges = parseBadges(payload);\n if (active) setState({ key, status: \"success\", badges });\n } catch (error: unknown) {\n if (active) {\n setState({\n key,\n status: \"error\",\n message:\n error instanceof Error\n ? error.message\n : \"Unable to load Credly badges.\",\n });\n }\n }\n }\n\n void loadBadges();\n\n return () => {\n active = false;\n controller.abort();\n };\n }, [username, endpoint, key]);\n\n // Hide results from the previous profile before the next effect runs.\n const current: BadgeState =\n state.key === key ? state : { key, status: \"loading\" };\n const groupedBadges =\n current.status === \"success\" && groupBy === \"issuer\"\n ? groupBadgesByIssuer(current.badges)\n : [];\n\n return (\n <div className={className} style={style}>\n {current.status === \"loading\" && (\n <p role='status'>Loading Credly badges...</p>\n )}\n {current.status === \"error\" && <p role='alert'>{current.message}</p>}\n {current.status === \"success\" &&\n (current.badges.length === 0 ? (\n <p role='status'>No public Credly badges found.</p>\n ) : (\n <ul\n aria-label={`Credly badges for ${username}`}\n style={{\n display: \"flex\",\n flexDirection: direction === \"vertical\" ? \"column\" : \"row\",\n flexWrap: direction === \"vertical\" ? \"nowrap\" : \"wrap\",\n gap: \"1rem\",\n listStyle: \"none\",\n margin: 0,\n padding: 0,\n }}\n >\n {groupBy === \"issuer\"\n ? groupedBadges.map(({ issuer, badges }) => (\n <li key={issuer}>\n <h2>{issuer}</h2>\n <ul\n aria-label={`Credly badges from ${issuer}`}\n style={{\n display: \"flex\",\n flexDirection:\n direction === \"vertical\" ? \"column\" : \"row\",\n flexWrap: direction === \"vertical\" ? \"nowrap\" : \"wrap\",\n gap: \"1rem\",\n listStyle: \"none\",\n margin: 0,\n padding: 0,\n }}\n >\n {badges.map((badge) => (\n <BadgeItem key={badge.id} badge={badge} />\n ))}\n </ul>\n </li>\n ))\n : current.badges.map((badge) => (\n <BadgeItem key={badge.id} badge={badge} />\n ))}\n </ul>\n ))}\n </div>\n );\n}\n","export interface CredlyBadge {\n id: string;\n name: string;\n imageUrl: string;\n url: string;\n issuerName?: string | null;\n issuedAt?: string | null;\n}\n\nexport function groupBadgesByIssuer(badges: CredlyBadge[]) {\n const groups = new Map<string, { issuer: string; badges: CredlyBadge[] }>();\n\n for (const badge of badges) {\n const issuer = badge.issuerName ?? 'Unknown issuer';\n const group = groups.get(issuer);\n if (group) {\n group.badges.push(badge);\n } else {\n groups.set(issuer, { issuer, badges: [badge] });\n }\n }\n\n return Array.from(groups.values(), (group) => ({\n ...group,\n badges: group.badges\n .map((badge, index) => ({ badge, index }))\n .sort((a, b) => {\n const aDate = a.badge.issuedAt ? Date.parse(a.badge.issuedAt) : null;\n const bDate = b.badge.issuedAt ? Date.parse(b.badge.issuedAt) : null;\n\n if (aDate === null && bDate === null) return a.index - b.index;\n if (aDate === null) return 1;\n if (bDate === null) return -1;\n return bDate - aDate || a.index - b.index;\n })\n .map(({ badge }) => badge),\n }));\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nexport function isNonEmptyString(value: unknown): value is string {\n return typeof value === 'string' && value.trim().length > 0;\n}\n\nexport function isHttpsUrl(value: unknown): value is string {\n if (!isNonEmptyString(value)) return false;\n\n try {\n return new URL(value).protocol === 'https:';\n } catch {\n return false;\n }\n}\n\nexport function parseBadges(value: unknown): CredlyBadge[] {\n const isWorkerResponse = isRecord(value);\n const badges: unknown = isWorkerResponse ? value.badges : value;\n\n if (!Array.isArray(badges)) {\n throw new Error('The badges endpoint must return a JSON array or an object with a badges array.');\n }\n\n return badges.map((badge: unknown) => {\n const url = isRecord(badge)\n ? (isWorkerResponse ? badge.badgeUrl : badge.url)\n : undefined;\n\n if (\n !isRecord(badge) ||\n !isNonEmptyString(badge.id) ||\n !isNonEmptyString(badge.name) ||\n !isHttpsUrl(badge.imageUrl) ||\n !isHttpsUrl(url)\n ) {\n throw new Error('The badges endpoint returned an invalid badge.');\n }\n\n return {\n id: badge.id,\n name: badge.name,\n imageUrl: badge.imageUrl,\n url,\n issuerName: isNonEmptyString(badge.issuerName)\n ? badge.issuerName.trim()\n : null,\n issuedAt:\n isNonEmptyString(badge.issuedAt) &&\n !Number.isNaN(Date.parse(badge.issuedAt))\n ? badge.issuedAt\n : null,\n };\n });\n}\n","import * as React from \"react\";\nimport type { CredlyBadge } from \"../shared/badges\";\n\ninterface BadgeItemProps {\n badge: CredlyBadge;\n}\n\nexport function BadgeItem({ badge }: BadgeItemProps) {\n return (\n <li>\n <a href={badge.url} target='_blank' rel='noopener noreferrer'>\n <img\n src={badge.imageUrl}\n alt={badge.name}\n width={120}\n height={120}\n loading='lazy'\n style={{ objectFit: \"contain\" }}\n />\n </a>\n </li>\n );\n}\n"],"mappings":"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","names":["React"]}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import React, { CSSProperties } from 'react';
|
|
2
|
+
|
|
3
|
+
interface CredlyBadgesProps {
|
|
4
|
+
username: string;
|
|
5
|
+
direction?: "horizontal" | "vertical";
|
|
6
|
+
groupBy?: "issuer";
|
|
7
|
+
endpoint?: string;
|
|
8
|
+
className?: string;
|
|
9
|
+
style?: CSSProperties;
|
|
10
|
+
}
|
|
11
|
+
declare function CredlyBadges({ username, direction, groupBy, endpoint, className, style, }: CredlyBadgesProps): React.JSX.Element;
|
|
12
|
+
|
|
13
|
+
interface CredlyBadge {
|
|
14
|
+
id: string;
|
|
15
|
+
name: string;
|
|
16
|
+
imageUrl: string;
|
|
17
|
+
url: string;
|
|
18
|
+
issuerName?: string | null;
|
|
19
|
+
issuedAt?: string | null;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export { CredlyBadges };
|
|
23
|
+
export type { CredlyBadge, CredlyBadgesProps };
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import React, { CSSProperties } from 'react';
|
|
2
|
+
|
|
3
|
+
interface CredlyBadgesProps {
|
|
4
|
+
username: string;
|
|
5
|
+
direction?: "horizontal" | "vertical";
|
|
6
|
+
groupBy?: "issuer";
|
|
7
|
+
endpoint?: string;
|
|
8
|
+
className?: string;
|
|
9
|
+
style?: CSSProperties;
|
|
10
|
+
}
|
|
11
|
+
declare function CredlyBadges({ username, direction, groupBy, endpoint, className, style, }: CredlyBadgesProps): React.JSX.Element;
|
|
12
|
+
|
|
13
|
+
interface CredlyBadge {
|
|
14
|
+
id: string;
|
|
15
|
+
name: string;
|
|
16
|
+
imageUrl: string;
|
|
17
|
+
url: string;
|
|
18
|
+
issuerName?: string | null;
|
|
19
|
+
issuedAt?: string | null;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export { CredlyBadges };
|
|
23
|
+
export type { CredlyBadge, CredlyBadgesProps };
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
// src/components/CredlyBadges.tsx
|
|
4
|
+
import React2, { useEffect } from "react";
|
|
5
|
+
|
|
6
|
+
// src/shared/badges.ts
|
|
7
|
+
function groupBadgesByIssuer(badges) {
|
|
8
|
+
const groups = /* @__PURE__ */ new Map();
|
|
9
|
+
for (const badge of badges) {
|
|
10
|
+
const issuer = badge.issuerName ?? "Unknown issuer";
|
|
11
|
+
const group = groups.get(issuer);
|
|
12
|
+
if (group) {
|
|
13
|
+
group.badges.push(badge);
|
|
14
|
+
} else {
|
|
15
|
+
groups.set(issuer, { issuer, badges: [badge] });
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
return Array.from(groups.values(), (group) => ({
|
|
19
|
+
...group,
|
|
20
|
+
badges: group.badges.map((badge, index) => ({ badge, index })).sort((a, b) => {
|
|
21
|
+
const aDate = a.badge.issuedAt ? Date.parse(a.badge.issuedAt) : null;
|
|
22
|
+
const bDate = b.badge.issuedAt ? Date.parse(b.badge.issuedAt) : null;
|
|
23
|
+
if (aDate === null && bDate === null) return a.index - b.index;
|
|
24
|
+
if (aDate === null) return 1;
|
|
25
|
+
if (bDate === null) return -1;
|
|
26
|
+
return bDate - aDate || a.index - b.index;
|
|
27
|
+
}).map(({ badge }) => badge)
|
|
28
|
+
}));
|
|
29
|
+
}
|
|
30
|
+
function isRecord(value) {
|
|
31
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
32
|
+
}
|
|
33
|
+
function isNonEmptyString(value) {
|
|
34
|
+
return typeof value === "string" && value.trim().length > 0;
|
|
35
|
+
}
|
|
36
|
+
function isHttpsUrl(value) {
|
|
37
|
+
if (!isNonEmptyString(value)) return false;
|
|
38
|
+
try {
|
|
39
|
+
return new URL(value).protocol === "https:";
|
|
40
|
+
} catch {
|
|
41
|
+
return false;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
function parseBadges(value) {
|
|
45
|
+
const isWorkerResponse = isRecord(value);
|
|
46
|
+
const badges = isWorkerResponse ? value.badges : value;
|
|
47
|
+
if (!Array.isArray(badges)) {
|
|
48
|
+
throw new Error("The badges endpoint must return a JSON array or an object with a badges array.");
|
|
49
|
+
}
|
|
50
|
+
return badges.map((badge) => {
|
|
51
|
+
const url = isRecord(badge) ? isWorkerResponse ? badge.badgeUrl : badge.url : void 0;
|
|
52
|
+
if (!isRecord(badge) || !isNonEmptyString(badge.id) || !isNonEmptyString(badge.name) || !isHttpsUrl(badge.imageUrl) || !isHttpsUrl(url)) {
|
|
53
|
+
throw new Error("The badges endpoint returned an invalid badge.");
|
|
54
|
+
}
|
|
55
|
+
return {
|
|
56
|
+
id: badge.id,
|
|
57
|
+
name: badge.name,
|
|
58
|
+
imageUrl: badge.imageUrl,
|
|
59
|
+
url,
|
|
60
|
+
issuerName: isNonEmptyString(badge.issuerName) ? badge.issuerName.trim() : null,
|
|
61
|
+
issuedAt: isNonEmptyString(badge.issuedAt) && !Number.isNaN(Date.parse(badge.issuedAt)) ? badge.issuedAt : null
|
|
62
|
+
};
|
|
63
|
+
});
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
// src/components/BadgeItem.tsx
|
|
67
|
+
import * as React from "react";
|
|
68
|
+
function BadgeItem({ badge }) {
|
|
69
|
+
return /* @__PURE__ */ React.createElement("li", null, /* @__PURE__ */ React.createElement("a", { href: badge.url, target: "_blank", rel: "noopener noreferrer" }, /* @__PURE__ */ React.createElement(
|
|
70
|
+
"img",
|
|
71
|
+
{
|
|
72
|
+
src: badge.imageUrl,
|
|
73
|
+
alt: badge.name,
|
|
74
|
+
width: 120,
|
|
75
|
+
height: 120,
|
|
76
|
+
loading: "lazy",
|
|
77
|
+
style: { objectFit: "contain" }
|
|
78
|
+
}
|
|
79
|
+
)));
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
// src/components/CredlyBadges.tsx
|
|
83
|
+
function CredlyBadges({
|
|
84
|
+
username,
|
|
85
|
+
direction = "horizontal",
|
|
86
|
+
groupBy,
|
|
87
|
+
endpoint = "https://react-credly-badges.safnaj99.workers.dev/",
|
|
88
|
+
className,
|
|
89
|
+
style
|
|
90
|
+
}) {
|
|
91
|
+
const key = JSON.stringify([username, endpoint]);
|
|
92
|
+
const [state, setState] = React2.useState({
|
|
93
|
+
key,
|
|
94
|
+
status: "loading"
|
|
95
|
+
});
|
|
96
|
+
useEffect(() => {
|
|
97
|
+
const controller = new AbortController();
|
|
98
|
+
let active = true;
|
|
99
|
+
setState({ key, status: "loading" });
|
|
100
|
+
async function loadBadges() {
|
|
101
|
+
try {
|
|
102
|
+
if (!username.trim()) {
|
|
103
|
+
throw new Error("A Credly username is required.");
|
|
104
|
+
}
|
|
105
|
+
const url = new URL(endpoint, window.location.href);
|
|
106
|
+
url.searchParams.set("username", username.trim());
|
|
107
|
+
const response = await fetch(url, {
|
|
108
|
+
headers: { Accept: "application/json" },
|
|
109
|
+
signal: controller.signal
|
|
110
|
+
});
|
|
111
|
+
if (!response.ok) {
|
|
112
|
+
throw new Error(
|
|
113
|
+
`Unable to load Credly badges (HTTP ${response.status}).`
|
|
114
|
+
);
|
|
115
|
+
}
|
|
116
|
+
const payload = await response.json();
|
|
117
|
+
const badges = parseBadges(payload);
|
|
118
|
+
if (active) setState({ key, status: "success", badges });
|
|
119
|
+
} catch (error) {
|
|
120
|
+
if (active) {
|
|
121
|
+
setState({
|
|
122
|
+
key,
|
|
123
|
+
status: "error",
|
|
124
|
+
message: error instanceof Error ? error.message : "Unable to load Credly badges."
|
|
125
|
+
});
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
void loadBadges();
|
|
130
|
+
return () => {
|
|
131
|
+
active = false;
|
|
132
|
+
controller.abort();
|
|
133
|
+
};
|
|
134
|
+
}, [username, endpoint, key]);
|
|
135
|
+
const current = state.key === key ? state : { key, status: "loading" };
|
|
136
|
+
const groupedBadges = current.status === "success" && groupBy === "issuer" ? groupBadgesByIssuer(current.badges) : [];
|
|
137
|
+
return /* @__PURE__ */ React2.createElement("div", { className, style }, current.status === "loading" && /* @__PURE__ */ React2.createElement("p", { role: "status" }, "Loading Credly badges..."), current.status === "error" && /* @__PURE__ */ React2.createElement("p", { role: "alert" }, current.message), current.status === "success" && (current.badges.length === 0 ? /* @__PURE__ */ React2.createElement("p", { role: "status" }, "No public Credly badges found.") : /* @__PURE__ */ React2.createElement(
|
|
138
|
+
"ul",
|
|
139
|
+
{
|
|
140
|
+
"aria-label": `Credly badges for ${username}`,
|
|
141
|
+
style: {
|
|
142
|
+
display: "flex",
|
|
143
|
+
flexDirection: direction === "vertical" ? "column" : "row",
|
|
144
|
+
flexWrap: direction === "vertical" ? "nowrap" : "wrap",
|
|
145
|
+
gap: "1rem",
|
|
146
|
+
listStyle: "none",
|
|
147
|
+
margin: 0,
|
|
148
|
+
padding: 0
|
|
149
|
+
}
|
|
150
|
+
},
|
|
151
|
+
groupBy === "issuer" ? groupedBadges.map(({ issuer, badges }) => /* @__PURE__ */ React2.createElement("li", { key: issuer }, /* @__PURE__ */ React2.createElement("h2", null, issuer), /* @__PURE__ */ React2.createElement(
|
|
152
|
+
"ul",
|
|
153
|
+
{
|
|
154
|
+
"aria-label": `Credly badges from ${issuer}`,
|
|
155
|
+
style: {
|
|
156
|
+
display: "flex",
|
|
157
|
+
flexDirection: direction === "vertical" ? "column" : "row",
|
|
158
|
+
flexWrap: direction === "vertical" ? "nowrap" : "wrap",
|
|
159
|
+
gap: "1rem",
|
|
160
|
+
listStyle: "none",
|
|
161
|
+
margin: 0,
|
|
162
|
+
padding: 0
|
|
163
|
+
}
|
|
164
|
+
},
|
|
165
|
+
badges.map((badge) => /* @__PURE__ */ React2.createElement(BadgeItem, { key: badge.id, badge }))
|
|
166
|
+
))) : current.badges.map((badge) => /* @__PURE__ */ React2.createElement(BadgeItem, { key: badge.id, badge }))
|
|
167
|
+
)));
|
|
168
|
+
}
|
|
169
|
+
export {
|
|
170
|
+
CredlyBadges
|
|
171
|
+
};
|
|
172
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/components/CredlyBadges.tsx","../../src/shared/badges.ts","../../src/components/BadgeItem.tsx"],"sourcesContent":["import React, { useEffect } from \"react\";\nimport type { CSSProperties } from \"react\";\nimport { groupBadgesByIssuer, parseBadges } from \"../shared/badges\";\nimport type { CredlyBadge } from \"../shared/badges\";\nimport { BadgeItem } from \"./BadgeItem\";\n\nexport interface CredlyBadgesProps {\n username: string;\n direction?: \"horizontal\" | \"vertical\";\n groupBy?: \"issuer\";\n endpoint?: string;\n className?: string;\n style?: CSSProperties;\n}\n\ntype BadgeState =\n | { key: string; status: \"loading\" }\n | { key: string; status: \"success\"; badges: CredlyBadge[] }\n | { key: string; status: \"error\"; message: string };\n\nexport function CredlyBadges({\n username,\n direction = \"horizontal\",\n groupBy,\n endpoint = \"https://react-credly-badges.safnaj99.workers.dev/\",\n className,\n style,\n}: CredlyBadgesProps) {\n const key = JSON.stringify([username, endpoint]);\n const [state, setState] = React.useState<BadgeState>({\n key,\n status: \"loading\",\n });\n\n useEffect(() => {\n const controller = new AbortController();\n let active = true;\n setState({ key, status: \"loading\" });\n\n async function loadBadges() {\n try {\n if (!username.trim()) {\n throw new Error(\"A Credly username is required.\");\n }\n\n const url = new URL(endpoint, window.location.href);\n url.searchParams.set(\"username\", username.trim());\n const response = await fetch(url, {\n headers: { Accept: \"application/json\" },\n signal: controller.signal,\n });\n\n if (!response.ok) {\n throw new Error(\n `Unable to load Credly badges (HTTP ${response.status}).`,\n );\n }\n\n const payload: unknown = await response.json();\n const badges = parseBadges(payload);\n if (active) setState({ key, status: \"success\", badges });\n } catch (error: unknown) {\n if (active) {\n setState({\n key,\n status: \"error\",\n message:\n error instanceof Error\n ? error.message\n : \"Unable to load Credly badges.\",\n });\n }\n }\n }\n\n void loadBadges();\n\n return () => {\n active = false;\n controller.abort();\n };\n }, [username, endpoint, key]);\n\n // Hide results from the previous profile before the next effect runs.\n const current: BadgeState =\n state.key === key ? state : { key, status: \"loading\" };\n const groupedBadges =\n current.status === \"success\" && groupBy === \"issuer\"\n ? groupBadgesByIssuer(current.badges)\n : [];\n\n return (\n <div className={className} style={style}>\n {current.status === \"loading\" && (\n <p role='status'>Loading Credly badges...</p>\n )}\n {current.status === \"error\" && <p role='alert'>{current.message}</p>}\n {current.status === \"success\" &&\n (current.badges.length === 0 ? (\n <p role='status'>No public Credly badges found.</p>\n ) : (\n <ul\n aria-label={`Credly badges for ${username}`}\n style={{\n display: \"flex\",\n flexDirection: direction === \"vertical\" ? \"column\" : \"row\",\n flexWrap: direction === \"vertical\" ? \"nowrap\" : \"wrap\",\n gap: \"1rem\",\n listStyle: \"none\",\n margin: 0,\n padding: 0,\n }}\n >\n {groupBy === \"issuer\"\n ? groupedBadges.map(({ issuer, badges }) => (\n <li key={issuer}>\n <h2>{issuer}</h2>\n <ul\n aria-label={`Credly badges from ${issuer}`}\n style={{\n display: \"flex\",\n flexDirection:\n direction === \"vertical\" ? \"column\" : \"row\",\n flexWrap: direction === \"vertical\" ? \"nowrap\" : \"wrap\",\n gap: \"1rem\",\n listStyle: \"none\",\n margin: 0,\n padding: 0,\n }}\n >\n {badges.map((badge) => (\n <BadgeItem key={badge.id} badge={badge} />\n ))}\n </ul>\n </li>\n ))\n : current.badges.map((badge) => (\n <BadgeItem key={badge.id} badge={badge} />\n ))}\n </ul>\n ))}\n </div>\n );\n}\n","export interface CredlyBadge {\n id: string;\n name: string;\n imageUrl: string;\n url: string;\n issuerName?: string | null;\n issuedAt?: string | null;\n}\n\nexport function groupBadgesByIssuer(badges: CredlyBadge[]) {\n const groups = new Map<string, { issuer: string; badges: CredlyBadge[] }>();\n\n for (const badge of badges) {\n const issuer = badge.issuerName ?? 'Unknown issuer';\n const group = groups.get(issuer);\n if (group) {\n group.badges.push(badge);\n } else {\n groups.set(issuer, { issuer, badges: [badge] });\n }\n }\n\n return Array.from(groups.values(), (group) => ({\n ...group,\n badges: group.badges\n .map((badge, index) => ({ badge, index }))\n .sort((a, b) => {\n const aDate = a.badge.issuedAt ? Date.parse(a.badge.issuedAt) : null;\n const bDate = b.badge.issuedAt ? Date.parse(b.badge.issuedAt) : null;\n\n if (aDate === null && bDate === null) return a.index - b.index;\n if (aDate === null) return 1;\n if (bDate === null) return -1;\n return bDate - aDate || a.index - b.index;\n })\n .map(({ badge }) => badge),\n }));\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nexport function isNonEmptyString(value: unknown): value is string {\n return typeof value === 'string' && value.trim().length > 0;\n}\n\nexport function isHttpsUrl(value: unknown): value is string {\n if (!isNonEmptyString(value)) return false;\n\n try {\n return new URL(value).protocol === 'https:';\n } catch {\n return false;\n }\n}\n\nexport function parseBadges(value: unknown): CredlyBadge[] {\n const isWorkerResponse = isRecord(value);\n const badges: unknown = isWorkerResponse ? value.badges : value;\n\n if (!Array.isArray(badges)) {\n throw new Error('The badges endpoint must return a JSON array or an object with a badges array.');\n }\n\n return badges.map((badge: unknown) => {\n const url = isRecord(badge)\n ? (isWorkerResponse ? badge.badgeUrl : badge.url)\n : undefined;\n\n if (\n !isRecord(badge) ||\n !isNonEmptyString(badge.id) ||\n !isNonEmptyString(badge.name) ||\n !isHttpsUrl(badge.imageUrl) ||\n !isHttpsUrl(url)\n ) {\n throw new Error('The badges endpoint returned an invalid badge.');\n }\n\n return {\n id: badge.id,\n name: badge.name,\n imageUrl: badge.imageUrl,\n url,\n issuerName: isNonEmptyString(badge.issuerName)\n ? badge.issuerName.trim()\n : null,\n issuedAt:\n isNonEmptyString(badge.issuedAt) &&\n !Number.isNaN(Date.parse(badge.issuedAt))\n ? badge.issuedAt\n : null,\n };\n });\n}\n","import * as React from \"react\";\nimport type { CredlyBadge } from \"../shared/badges\";\n\ninterface BadgeItemProps {\n badge: CredlyBadge;\n}\n\nexport function BadgeItem({ badge }: BadgeItemProps) {\n return (\n <li>\n <a href={badge.url} target='_blank' rel='noopener noreferrer'>\n <img\n src={badge.imageUrl}\n alt={badge.name}\n width={120}\n height={120}\n loading='lazy'\n style={{ objectFit: \"contain\" }}\n />\n </a>\n </li>\n );\n}\n"],"mappings":"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","names":["React","React"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,76 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "react-credly-badges",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "1.1.0",
|
|
4
|
+
"description": "A lightweight React component for displaying public Credly badges through a Cloudflare Worker.",
|
|
5
|
+
"license": "UNLICENSED",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"main": "./dist/client/index.cjs",
|
|
8
|
+
"module": "./dist/client/index.js",
|
|
9
|
+
"types": "./dist/client/index.d.ts",
|
|
10
|
+
"exports": {
|
|
11
|
+
".": {
|
|
12
|
+
"import": {
|
|
13
|
+
"types": "./dist/client/index.d.ts",
|
|
14
|
+
"default": "./dist/client/index.js"
|
|
15
|
+
},
|
|
16
|
+
"require": {
|
|
17
|
+
"types": "./dist/client/index.d.cts",
|
|
18
|
+
"default": "./dist/client/index.cjs"
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
},
|
|
22
|
+
"files": [
|
|
23
|
+
"dist"
|
|
24
|
+
],
|
|
25
|
+
"sideEffects": false,
|
|
26
|
+
"scripts": {
|
|
27
|
+
"build": "tsup",
|
|
28
|
+
"dev": "tsup --watch",
|
|
29
|
+
"typecheck": "tsc --noEmit",
|
|
30
|
+
"lint": "eslint .",
|
|
31
|
+
"commitlint": "commitlint",
|
|
32
|
+
"release": "semantic-release",
|
|
33
|
+
"prepare": "husky",
|
|
34
|
+
"prepack": "npm run typecheck && npm run lint && npm run build"
|
|
35
|
+
},
|
|
36
|
+
"peerDependencies": {
|
|
37
|
+
"react": "^17.0.0 || ^18.2.0 || ^19.0.0"
|
|
38
|
+
},
|
|
39
|
+
"devDependencies": {
|
|
40
|
+
"@commitlint/cli": "^21.2.4",
|
|
41
|
+
"@commitlint/config-conventional": "^21.2.4",
|
|
42
|
+
"@eslint/js": "^10.0.0",
|
|
43
|
+
"@semantic-release/commit-analyzer": "^13.0.1",
|
|
44
|
+
"@semantic-release/github": "^12.0.10",
|
|
45
|
+
"@semantic-release/npm": "^13.2.0",
|
|
46
|
+
"@semantic-release/release-notes-generator": "^14.1.1",
|
|
47
|
+
"@types/react": "^19.0.0",
|
|
48
|
+
"eslint": "^10.0.0",
|
|
49
|
+
"eslint-plugin-react-hooks": "^7.0.0",
|
|
50
|
+
"globals": "^16.0.0",
|
|
51
|
+
"husky": "^9.1.7",
|
|
52
|
+
"react": "^19.0.0",
|
|
53
|
+
"semantic-release": "^25.0.9",
|
|
54
|
+
"tsup": "^9.0.0",
|
|
55
|
+
"typescript": "~5.9.3",
|
|
56
|
+
"typescript-eslint": "^8.0.0"
|
|
57
|
+
},
|
|
58
|
+
"keywords": [
|
|
59
|
+
"react",
|
|
60
|
+
"credly",
|
|
61
|
+
"badges",
|
|
62
|
+
"typescript"
|
|
63
|
+
],
|
|
64
|
+
"publishConfig": {
|
|
65
|
+
"access": "public",
|
|
66
|
+
"registry": "https://registry.npmjs.org/"
|
|
67
|
+
},
|
|
68
|
+
"homepage": "https://github.com/Safnaj/react-credly-badges#readme",
|
|
69
|
+
"bugs": {
|
|
70
|
+
"url": "https://github.com/Safnaj/react-credly-badges/issues"
|
|
71
|
+
},
|
|
72
|
+
"repository": {
|
|
73
|
+
"type": "git",
|
|
74
|
+
"url": "git+https://github.com/Safnaj/react-credly-badges.git"
|
|
75
|
+
}
|
|
76
|
+
}
|