@tamyla/clodo-framework 4.3.4 → 4.3.5
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 +7 -0
- package/README.md +32 -8
- package/package.json +8 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,10 @@
|
|
|
1
|
+
## [4.3.5](https://github.com/tamylaa/clodo-framework/compare/v4.3.4...v4.3.5) (2026-02-04)
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
### Bug Fixes
|
|
5
|
+
|
|
6
|
+
* **funding:** use string value for open_collective in FUNDING.yml ([680cb5f](https://github.com/tamylaa/clodo-framework/commit/680cb5fa28499f2297b39a556ee2c60c0573ab4a))
|
|
7
|
+
|
|
1
8
|
## [4.3.4](https://github.com/tamylaa/clodo-framework/compare/v4.3.3...v4.3.4) (2026-02-04)
|
|
2
9
|
|
|
3
10
|
|
package/README.md
CHANGED
|
@@ -1,11 +1,13 @@
|
|
|
1
1
|
# Clodo Framework
|
|
2
2
|
|
|
3
|
+
[](https://github.com/tamylaa/clodo-framework/actions/workflows/validate-on-pr.yml) [](https://github.com/tamylaa/clodo-framework/actions/workflows/full-tests-nightly.yml) [](https://www.npmjs.com/package/@tamyla/clodo-framework) [](https://www.npmjs.com/package/@tamyla/clodo-framework) [](https://github.com/tamylaa/clodo-framework/blob/main/LICENSE) [](https://github.com/sponsors/tamylaa) [](SUPPORT.md)
|
|
4
|
+
|
|
3
5
|
## 🚀 Production-Ready: Promise Delivered
|
|
4
6
|
|
|
5
7
|
**Framework Status: ✅ VALIDATED & PRODUCTION-READY**
|
|
6
8
|
**Validation: 10/10 Phases Passed**
|
|
7
9
|
**Service Generation: 28+ Files Per Service**
|
|
8
|
-
**Test Coverage
|
|
10
|
+
**Test Coverage:** (Latest CI run 2026-02-04) — **115 test suites passed; 4 tests skipped; 2113 passed, 2117 total**
|
|
9
11
|
|
|
10
12
|
A comprehensive framework for building enterprise-grade software architecture on Cloudflare Workers + D1. This framework enables rapid development of autonomous, domain-specific services while maintaining consistency and reusability across your entire ecosystem.
|
|
11
13
|
|
|
@@ -31,6 +33,19 @@ A comprehensive framework for building enterprise-grade software architecture on
|
|
|
31
33
|
- **[Security](docs/SECURITY.md)** - Security considerations
|
|
32
34
|
- **[Framework Evolution](docs/FRAMEWORK_EVOLUTION_NARRATIVE.md)** - Development history
|
|
33
35
|
|
|
36
|
+
## 🧑🤝🧑 Community & Support
|
|
37
|
+
- **Email:** `product@clodo.dev` — product support, feedback, and security reports
|
|
38
|
+
- **Twitter:** [@clodoframework](https://twitter.com/clodoframework) — follow for updates and announcements
|
|
39
|
+
- **Quick ways to help:**
|
|
40
|
+
- ⭐ Star the repository on GitHub
|
|
41
|
+
- 🐛 Open issues for bugs or feature ideas
|
|
42
|
+
- 🔀 Submit PRs or reviews (even small documentation fixes are welcome)
|
|
43
|
+
- 🗣️ Share your experience on Twitter and tag **@clodoframework**
|
|
44
|
+
|
|
45
|
+
Your feedback helps prioritize improvements and signals others that this project is useful.
|
|
46
|
+
|
|
47
|
+
- **Support & SLAs:** See [SUPPORT.md](SUPPORT.md) for response times and escalation procedures.
|
|
48
|
+
|
|
34
49
|
### 📁 **Documentation Structure**
|
|
35
50
|
```
|
|
36
51
|
├── docs/ # 📖 Public documentation (npm package)
|
|
@@ -260,7 +275,7 @@ clodo-framework/
|
|
|
260
275
|
│ ├── analysis/ # Technical analysis
|
|
261
276
|
│ └── licensing/ # License information
|
|
262
277
|
├── src/ # 💻 Source code
|
|
263
|
-
├── test/ # ✅ Test suites (
|
|
278
|
+
├── test/ # ✅ Test suites (Latest CI: 115 suites; 2113 tests passed, 4 skipped)
|
|
264
279
|
├── bin/ # 🔧 CLI executables
|
|
265
280
|
├── dist/ # 📦 Built distribution
|
|
266
281
|
└── templates/ # 📋 Service templates
|
|
@@ -268,8 +283,8 @@ clodo-framework/
|
|
|
268
283
|
```
|
|
269
284
|
|
|
270
285
|
**Quality Metrics:**
|
|
271
|
-
- ✅ **
|
|
272
|
-
- ✅ **
|
|
286
|
+
- ✅ **Latest CI (2026-02-04): 115 test suites passed; 4 tests skipped; 2113/2117 tests passed**
|
|
287
|
+
- ✅ **CLI tests:** passing (all CLI-specific tests passed in the latest run)
|
|
273
288
|
- ✅ **Clean architecture** (no temporary or duplicate files)
|
|
274
289
|
- ✅ **Configuration-based** (no hard-coded values in source)
|
|
275
290
|
|
|
@@ -1371,13 +1386,22 @@ npx wrangler login
|
|
|
1371
1386
|
# - Cloudflare D1:Edit permissions
|
|
1372
1387
|
```
|
|
1373
1388
|
|
|
1374
|
-
#### **
|
|
1389
|
+
#### **Integration tests & DNS: how CI avoids ENOTFOUND**
|
|
1390
|
+
- Integration tests mock network calls when `TEST_URL` is not provided to avoid DNS resolution failures (ENOTFOUND) in CI and developer environments.
|
|
1391
|
+
- To run integration tests against an actual deployment set `TEST_URL` to your deployment URL, for example:
|
|
1392
|
+
|
|
1393
|
+
```bash
|
|
1394
|
+
TEST_URL='https://your-service.workers.dev' npm run test:integration
|
|
1395
|
+
```
|
|
1396
|
+
|
|
1397
|
+
- Database integration tests are disabled by default for CI. Enable them by setting `RUN_DB_TESTS=true` (or `RUN_DB_TESTS=1`) when you have a configured database and credentials available:
|
|
1398
|
+
|
|
1375
1399
|
```bash
|
|
1376
|
-
|
|
1377
|
-
# The system waits 10 seconds but some domains may need longer
|
|
1378
|
-
# Tests failures don't prevent deployment success
|
|
1400
|
+
TEST_URL='https://your-service.workers.dev' RUN_DB_TESTS=true npm run test:integration
|
|
1379
1401
|
```
|
|
1380
1402
|
|
|
1403
|
+
This prevents flaky CI failures while still allowing full end-to-end verification when desired.
|
|
1404
|
+
|
|
1381
1405
|
#### **"npx command not found" on Windows**
|
|
1382
1406
|
```bash
|
|
1383
1407
|
# Problem: Command configuration for cross-platform compatibility
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tamyla/clodo-framework",
|
|
3
|
-
"version": "4.3.
|
|
3
|
+
"version": "4.3.5",
|
|
4
4
|
"description": "Reusable framework for Clodo-style software architecture on Cloudflare Workers + D1",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"sideEffects": [
|
|
@@ -191,7 +191,13 @@
|
|
|
191
191
|
"url": "git+https://github.com/tamylaa/clodo-framework.git"
|
|
192
192
|
},
|
|
193
193
|
"bugs": {
|
|
194
|
-
"url": "https://github.com/tamylaa/clodo-framework/issues"
|
|
194
|
+
"url": "https://github.com/tamylaa/clodo-framework/issues",
|
|
195
|
+
"email": "product@clodo.dev"
|
|
196
|
+
},
|
|
197
|
+
"support": "https://github.com/tamyla/clodo-framework/blob/main/SUPPORT.md",
|
|
198
|
+
"funding": {
|
|
199
|
+
"type": "github",
|
|
200
|
+
"url": "https://github.com/sponsors/tamylaa"
|
|
195
201
|
},
|
|
196
202
|
"homepage": "https://clodo.dev",
|
|
197
203
|
"release": {
|