retold-harness 1.1.10 → 1.1.12

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.
Files changed (6) hide show
  1. package/Dockerfile_Service +7 -3
  2. package/package.json +13 -13
  3. package/source/management-tool/docs/sqlite/linux.md +7 -25
  4. package/source/management-tool/docs/sqlite/mac.md +7 -15
  5. package/source/management-tool/docs/sqlite/windows.md +6 -17
  6. package/source/web/index.html +2 -2
package/Dockerfile_Service CHANGED
@@ -1,8 +1,12 @@
1
- FROM node:20-slim
1
+ FROM node:22-slim
2
2
  LABEL maintainer="steven velozo <steven@velozo.com>"
3
3
 
4
- # Build tools needed to compile better-sqlite3 native addon
5
- RUN apt-get update && apt-get install -y --no-install-recommends python3 make g++ && rm -rf /var/lib/apt/lists/*
4
+ # No build toolchain needed. Retold's SQLite usage flows through
5
+ # meadow-connection-sqlite, which uses Node's built-in `node:sqlite`
6
+ # module (v22.5+) instead of the better-sqlite3 native addon. This
7
+ # eliminates the python3 + make + g++ apt-install that previously broke
8
+ # this image on Colima GPG-signature failures and on architecture
9
+ # mismatches between host (arm64) and container (amd64).
6
10
 
7
11
  VOLUME /retold-harness
8
12
  WORKDIR /retold-harness
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "retold-harness",
3
- "version": "1.1.10",
3
+ "version": "1.1.12",
4
4
  "description": "Restful API harness. Serves on 8086.",
5
5
  "main": "source/Retold-Harness.js",
6
6
  "bin": {
@@ -38,23 +38,23 @@
38
38
  "blessed": "^0.1.81",
39
39
  "meadow-connection-dgraph": "^1.0.3",
40
40
  "meadow-connection-mongodb": "^1.0.3",
41
- "meadow-connection-mssql": "^1.0.22",
42
- "meadow-connection-mysql": "^1.0.18",
43
- "meadow-connection-postgresql": "^1.0.4",
41
+ "meadow-connection-mssql": "^1.0.23",
42
+ "meadow-connection-mysql": "^1.0.19",
43
+ "meadow-connection-postgresql": "^1.0.5",
44
44
  "meadow-connection-solr": "^1.0.3",
45
- "meadow-connection-sqlite": "^1.0.19",
46
- "meadow-integration": "^1.0.38",
47
- "orator-authentication": "^1.0.1",
48
- "pict": "^1.0.365",
49
- "pict-application": "^1.0.33",
45
+ "meadow-connection-sqlite": "^1.0.20",
46
+ "meadow-integration": "^1.0.40",
47
+ "orator-authentication": "^1.0.2",
48
+ "pict": "^1.0.367",
49
+ "pict-application": "^1.0.34",
50
50
  "pict-terminalui": "^0.0.3",
51
51
  "pict-view": "^1.0.68",
52
- "retold-data-service": "^2.1.0"
52
+ "retold-data-service": "^2.1.2"
53
53
  },
54
54
  "devDependencies": {
55
- "pict-docuserve": "^0.1.5",
56
- "quackage": "^1.1.2",
57
- "stricture": "^4.0.2",
55
+ "pict-docuserve": "^1.0.0",
56
+ "quackage": "^1.2.3",
57
+ "stricture": "^4.0.3",
58
58
  "supertest": "^7.2.2"
59
59
  },
60
60
  "mocha": {
package/source/management-tool/docs/sqlite/linux.md CHANGED
@@ -4,24 +4,24 @@ SQLite is the simplest database option for the retold-harness. It is file-based
4
4
 
5
5
  ## Prerequisites
6
6
 
7
- - Node.js (v14 or later)
7
+ - Node.js v22.5.0 or later (the harness uses the built-in `node:sqlite` module)
8
8
  - npm
9
- - A C compiler and build tools (for compiling the native npm module)
10
9
 
11
10
  ## Verify SQLite Is Available
12
11
 
13
- Many Linux distributions include SQLite by default. Check by running:
12
+ The harness does not need a system-wide SQLite — it uses Node's built-in `node:sqlite` module, which bundles the SQLite engine as part of the runtime. No native compile, no build toolchain.
13
+
14
+ The `sqlite3` command-line tool is still handy for inspecting the database file by hand:
14
15
 
15
16
  ```bash
16
17
  sqlite3 --version
17
18
  ```
18
19
 
19
- If it is not installed, use your distribution's package manager:
20
+ If missing, use your distribution's package manager:
20
21
 
21
22
  **Debian / Ubuntu:**
22
23
 
23
24
  ```bash
24
- sudo apt update
25
25
  sudo apt install sqlite3
26
26
  ```
27
27
 
@@ -37,24 +37,6 @@ sudo dnf install sqlite
37
37
  sudo pacman -S sqlite
38
38
  ```
39
39
 
40
- Note: The `sqlite3` command-line tool is useful for inspecting the database, but it is not required to run the harness. The harness uses the `better-sqlite3` npm package, which bundles its own SQLite engine and compiles it during `npm install`.
41
-
42
- ## Install Build Tools
43
-
44
- The `better-sqlite3` package requires a C compiler to build its native addon. Make sure build essentials are installed:
45
-
46
- **Debian / Ubuntu:**
47
-
48
- ```bash
49
- sudo apt install build-essential python3
50
- ```
51
-
52
- **Fedora / RHEL / CentOS:**
53
-
54
- ```bash
55
- sudo dnf groupinstall "Development Tools"
56
- ```
57
-
58
40
  ## Install Dependencies
59
41
 
60
42
  From the retold-harness directory:
@@ -63,7 +45,7 @@ From the retold-harness directory:
63
45
  npm install
64
46
  ```
65
47
 
66
- This will compile the native `better-sqlite3` module.
48
+ No native compilation. No `build-essential` or `python3` required.
67
49
 
68
50
  ## Run the Harness with SQLite
69
51
 
@@ -93,6 +75,6 @@ sqlite3 data/bookstore.sqlite
93
75
 
94
76
  ## Troubleshooting
95
77
 
96
- - If `npm install` fails with compilation errors, ensure `build-essential` (or equivalent) and `python3` are installed.
78
+ - If `require('node:sqlite')` errors with "Unknown module", your Node version is older than 22.5.0 — upgrade Node.
97
79
  - If the `data/` directory does not exist, the harness will create it on first run.
98
80
  - To reset the database, delete `data/bookstore.sqlite` and restart the harness.
package/source/management-tool/docs/sqlite/mac.md CHANGED
@@ -4,24 +4,20 @@ SQLite is the simplest database option for the retold-harness. It is file-based
4
4
 
5
5
  ## Prerequisites
6
6
 
7
- - Node.js (v14 or later)
7
+ - Node.js v22.5.0 or later (the harness uses the built-in `node:sqlite` module)
8
8
  - npm
9
9
 
10
10
  ## Verify SQLite Is Available
11
11
 
12
- macOS ships with SQLite pre-installed. Open a terminal and run:
12
+ The harness does not need a system-wide SQLite — it uses Node's built-in `node:sqlite` module, which bundles the SQLite engine as part of the runtime. No native compile, no install step.
13
13
 
14
- ```bash
15
- sqlite3 --version
16
- ```
17
-
18
- You should see version output such as `3.39.5 2022-10-14`. If for some reason it is missing, install it with Homebrew:
14
+ The `sqlite3` command-line tool is still handy for inspecting the database file by hand. macOS ships with it pre-installed:
19
15
 
20
16
  ```bash
21
- brew install sqlite
17
+ sqlite3 --version
22
18
  ```
23
19
 
24
- Note: The `sqlite3` command-line tool is useful for inspecting the database, but it is not required to run the harness. The harness uses the `better-sqlite3` npm package, which bundles its own SQLite engine and compiles it during `npm install`.
20
+ If missing, `brew install sqlite` installs it.
25
21
 
26
22
  ## Install Dependencies
27
23
 
@@ -31,11 +27,7 @@ From the retold-harness directory:
31
27
  npm install
32
28
  ```
33
29
 
34
- This will compile the native `better-sqlite3` module. If the build fails, make sure you have Xcode Command Line Tools installed:
35
-
36
- ```bash
37
- xcode-select --install
38
- ```
30
+ No native compilation. No Xcode Command Line Tools required.
39
31
 
40
32
  ## Run the Harness with SQLite
41
33
 
@@ -65,6 +57,6 @@ sqlite3 data/bookstore.sqlite
65
57
 
66
58
  ## Troubleshooting
67
59
 
68
- - If `npm install` fails with compilation errors, ensure Xcode Command Line Tools are installed and up to date.
60
+ - If `require('node:sqlite')` errors with "Unknown module", your Node version is older than 22.5.0 — upgrade Node.
69
61
  - If the `data/` directory does not exist, the harness will create it on first run.
70
62
  - To reset the database, delete `data/bookstore.sqlite` and restart the harness.
package/source/management-tool/docs/sqlite/windows.md CHANGED
@@ -4,13 +4,14 @@ SQLite is the simplest database option for the retold-harness. It is file-based
4
4
 
5
5
  ## Prerequisites
6
6
 
7
- - Node.js (v14 or later)
7
+ - Node.js v22.5.0 or later (the harness uses the built-in `node:sqlite` module)
8
8
  - npm
9
- - Windows build tools (for compiling the native npm module)
10
9
 
11
10
  ## Verify SQLite Is Available
12
11
 
13
- SQLite does not come pre-installed on Windows. To install the command-line tool:
12
+ The harness does not need a system-wide SQLite — it uses Node's built-in `node:sqlite` module, which bundles the SQLite engine as part of the runtime. No native compile, no Windows Build Tools, no Visual Studio.
13
+
14
+ The `sqlite3` command-line tool is still handy for inspecting the database file by hand. To install it on Windows:
14
15
 
15
16
  1. Download the **sqlite-tools** zip from https://www.sqlite.org/download.html (look for the "Precompiled Binaries for Windows" section).
16
17
  2. Extract the zip to a folder such as `C:\sqlite`.
@@ -21,18 +22,6 @@ SQLite does not come pre-installed on Windows. To install the command-line tool:
21
22
  sqlite3 --version
22
23
  ```
23
24
 
24
- Note: The `sqlite3` command-line tool is useful for inspecting the database, but it is not required to run the harness. The harness uses the `better-sqlite3` npm package, which bundles its own SQLite engine and compiles it during `npm install`.
25
-
26
- ## Install Windows Build Tools
27
-
28
- The `better-sqlite3` package requires a C compiler to build its native addon. The easiest way to get the necessary tools is to run the following from an elevated (Administrator) PowerShell or Command Prompt:
29
-
30
- ```cmd
31
- npm install -g windows-build-tools
32
- ```
33
-
34
- Alternatively, install Visual Studio Build Tools with the "Desktop development with C++" workload from https://visualstudio.microsoft.com/visual-cpp-build-tools/.
35
-
36
25
  ## Install Dependencies
37
26
 
38
27
  From the retold-harness directory:
@@ -41,7 +30,7 @@ From the retold-harness directory:
41
30
  npm install
42
31
  ```
43
32
 
44
- This will compile the native `better-sqlite3` module.
33
+ No native compilation. No Windows Build Tools required.
45
34
 
46
35
  ## Run the Harness with SQLite
47
36
 
@@ -81,6 +70,6 @@ sqlite3 data\bookstore.sqlite
81
70
 
82
71
  ## Troubleshooting
83
72
 
84
- - If `npm install` fails with compilation errors, ensure Windows Build Tools or Visual Studio Build Tools are installed.
73
+ - If `require('node:sqlite')` errors with "Unknown module", your Node version is older than 22.5.0 — upgrade Node.
85
74
  - If the `data\` directory does not exist, the harness will create it on first run.
86
75
  - To reset the database, delete `data\bookstore.sqlite` and restart the harness.
package/source/web/index.html CHANGED
@@ -42,7 +42,7 @@
42
42
  }
43
43
  .harnessapp-login-header p
44
44
  {
45
- color: #888;
45
+ color: var(--theme-color-text-muted, #888);
46
46
  font-size: 0.85rem;
47
47
  margin: 0;
48
48
  }
@@ -51,7 +51,7 @@
51
51
  margin-top: 1rem;
52
52
  text-align: center;
53
53
  font-size: 0.8rem;
54
- color: #999;
54
+ color: var(--theme-color-text-muted, #999);
55
55
  }
56
56
  .harnessapp-login-hint code
57
57
  {