@dpuse/dpuse-development 0.3.725 → 0.3.733

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 CHANGED
@@ -1,20 +1,52 @@
1
1
  # DPUse Development
2
2
 
3
+ <!-- OPENING_START -->
4
+
3
5
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
4
- [![npm version](https://img.shields.io/npm/v/@dpuse/dpuse-development.svg)](https://www.npmjs.com/package/@dpuse/dpuse-development)
6
+ [![DPUse version](https://img.shields.io/github/v/release/dpuse/dpuse-development?color=f6821f&label=DPUse)](https://github.com/dpuse/dpuse-development/releases/latest)
7
+ [![CI](https://github.com/dpuse/dpuse-development/actions/workflows/ci.yml/badge.svg)](https://github.com/dpuse/dpuse-development/actions/workflows/ci.yml)
5
8
  [![CodeQL](https://github.com/dpuse/dpuse-development/actions/workflows/codeql.yml/badge.svg)](https://github.com/dpuse/dpuse-development/actions/workflows/codeql.yml)
6
9
  [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=dpuse_dpuse-development&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=dpuse_dpuse-development)
7
- [![CI](https://github.com/dpuse/dpuse-development/actions/workflows/ci.yml/badge.svg)](https://github.com/dpuse/dpuse-development/actions/workflows/ci.yml)
8
10
 
9
- ## Introduction
11
+ [Documentation](https://www.dpuse.app) · [Report a Vulnerability](https://github.com/dpuse/dpuse-development/security/advisories/new) · [Open an Issue](https://github.com/dpuse/dpuse-development/issues)
12
+
13
+ ## About DPUse
14
+
15
+ DPUse (Data Positioning & Use) is an in-browser application that positions your data for use through three core activities: sourcing, contextualising, and publishing.
16
+
17
+ **Sourcing** uses a library of [Connectors](https://www.dpuse.app/connectors) to establish [Connections](https://www.dpuse.app) to applications, databases, file stores, and curated datasets; these connections are subsequently used to configure structured [Data Views](https://www.dpuse.app) from the underlying sources.
18
+
19
+ **Contextualising** extracts chronological events from those [Data Views](https://www.dpuse.app) and maps them into comprehensive [Context Models](https://www.dpuse.app). This gives the DPUse Engine the structural framework needed to generate deterministic transactions, facts, or observations.
10
20
 
11
- <!-- SUMMARY_START -->
21
+ **Publishing** uses a library of [Presenters](https://www.dpuse.app) to render standard [Presentations](https://www.dpuse.app) immediately using the contextualised data; additionally, [Cookbooks](https://www.dpuse.app) of [Recipes](https://www.dpuse.app) let you build Data Apps using your preferred tools.
22
+
23
+ In addition, DPUse provides [Tools](https://www.dpuse.app) used by the application, and you can use them to construct connectors and presenters.
24
+
25
+ ## Introduction
12
26
 
13
27
  Actions for managing DPUse projects.
14
28
 
15
- <!-- SUMMARY_END -->
29
+ <!-- OPENING_END -->
30
+
31
+ ## Usage
32
+
33
+ <!-- USAGE_START -->
34
+
35
+ This connector is automatically uploaded to the DPUse Engine cloud once released and becomes instantly available to all new browser app instances, with existing instances notified of the update.
36
+
37
+ You may view or clone this repository for your own purposes, such as building a new, similar connector, though there is currently no process to accept third-party connectors into DPUse at this stage. Cloned or forked code is unsupported and isn't guaranteed to remain compatible with the DPUse Engine as it evolves.
38
+
39
+ ```bash
40
+ git clone https://github.com/dpuse/dpuse-development.git
41
+ cd dpuse-development
42
+ npm install
43
+ ```
16
44
 
17
- ## Installation
45
+ _Requires [Node.js](https://nodejs.org/) 24 or later, [npm](https://www.npmjs.com/) 12 or later, and [TypeScript](https://www.typescriptlang.org/) 6.0.3 or later._
46
+
47
+ <!-- USAGE_END -->
48
+
49
+ ### OLD Installation
18
50
 
19
51
  > [!WARNING]
20
52
  > This project is currently published to npm, but is not designed for general use. It is custom built for the DPUse CI/CD process. You are welcome to clone and customise it for your own purposes, but you will need to adapt it to your own project structure and tooling.
@@ -74,15 +106,18 @@ Please see other DPUse repositories for actual usage.
74
106
  ## Dependency Licenses
75
107
 
76
108
  <!-- DEPENDENCY_LICENSES_START -->
109
+
77
110
  > [!WARNING]
78
- > Dependency licenses are not documented here: @dpuse/dpuse-development is a development-only tool and is never part of a production release
111
+ > Dependency licenses are not documented here: @dpuse/dpuse-development is a development-only tool and is never part of a production release.
112
+
79
113
  <!-- DEPENDENCY_LICENSES_END -->
80
114
 
81
115
  ### Dependency Tree
82
116
 
83
117
  <!-- DEPENDENCY_TREE_START -->
84
- > [!WARNING]
85
- > Dependency licenses are not documented here: @dpuse/dpuse-development is a development-only tool and is never part of a production release
118
+
119
+
120
+
86
121
  <!-- DEPENDENCY_TREE_END -->
87
122
 
88
123
  ## Bundle Analysis
@@ -104,7 +139,7 @@ _Note: Sonda's Vite reports currently exclude CSS files, since Vite does not gen
104
139
 
105
140
  |Chunk/Module/File|Composition|
106
141
  |:------ |:-----------|
107
- | dist/dpuse-development.es.js | 313.1 kB · brotli 63.5 kB |
142
+ | dist/dpuse-development.es.js | 313.3 kB · brotli 63.5 kB |
108
143
  | &nbsp;&nbsp;&nbsp;&nbsp;acorn → dist/acorn.mjs | `████████░░░░░░░░░░░░` 41.8% |
109
144
  | &nbsp;&nbsp;&nbsp;&nbsp;acorn-typescript → lib/index.mjs | `███████░░░░░░░░░░░░░` 36.6% |
110
145
  | &nbsp;&nbsp;&nbsp;&nbsp;src | `██░░░░░░░░░░░░░░░░░░` 10.8% |
@@ -122,7 +157,7 @@ _Note: Sonda's Vite reports currently exclude CSS files, since Vite does not gen
122
157
  | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;formatCode.ts | `░░░░░░░░░░░░░░░░░░░░` 0.1% |
123
158
  | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;auditDependencies.ts | `░░░░░░░░░░░░░░░░░░░░` 0.1% |
124
159
  | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;lintCode.ts | `░░░░░░░░░░░░░░░░░░░░` 0.1% |
125
- | &nbsp;&nbsp;&nbsp;&nbsp;(unassigned) → [unassigned] | `█░░░░░░░░░░░░░░░░░░░` 7.1% |
160
+ | &nbsp;&nbsp;&nbsp;&nbsp;(unassigned) → [unassigned] | `█░░░░░░░░░░░░░░░░░░░` 7.2% |
126
161
  | &nbsp;&nbsp;&nbsp;&nbsp;@dpuse/dpuse-shared | `█░░░░░░░░░░░░░░░░░░░` 3.6% |
127
162
  | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;dist/componentConfig.schema-DT3mO5rS.js | `█░░░░░░░░░░░░░░░░░░░` 2.7% |
128
163
  | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;dist/dpuse-shared-componentModuleConnector.es.js | `░░░░░░░░░░░░░░░░░░░░` 0.7% |
@@ -176,3 +211,50 @@ If you find a security vulnerability, see [Reporting Vulnerabilities](#reporting
176
211
  This project is licensed under the MIT License, permitting free use, modification, and distribution.
177
212
 
178
213
  [MIT](./LICENSE) © 2026-present Jonathan Terrell
214
+
215
+ <!-- GOVERNANCE_START -->
216
+
217
+ ## Security & Quality
218
+
219
+ ### CodeQL
220
+
221
+ [CodeQL](https://github.com/dpuse/dpuse-development/security/code-scanning) static analysis runs on every push to `main` and on a weekly schedule, scanning TypeScript, JavaScript, Rust, and GitHub Actions workflow files for security vulnerabilities and coding errors.
222
+
223
+ ### SonarCloud
224
+
225
+ [SonarCloud](https://sonarcloud.io/summary/new_code?id=dpuse_dpuse-development) performs continuous code quality and security analysis on every push, detecting bugs, code smells, and security vulnerabilities in the TypeScript source.
226
+
227
+ ### Vulnerability Scanning
228
+
229
+ Two complementary tools continuously monitor dependencies for known vulnerabilities:
230
+
231
+ - [npm audit](https://docs.npmjs.com/cli/v8/commands/npm-audit) runs on every push to `main` via the CI workflow, failing the build if any high or critical severity vulnerabilities are detected.
232
+ - [GitHub Dependabot](https://docs.github.com/en/code-security/dependabot) automatically raises pull requests to update vulnerable dependencies, drawing on the GitHub Advisory Database which combines NVD and npm-specific advisories.
233
+
234
+ ### Supply Chain Security
235
+
236
+ [Socket.dev](https://socket.dev) monitors all dependencies for supply chain risk — detecting malicious packages, dependency confusion, typosquatting, and suspicious behaviour that may not yet have a CVE.
237
+
238
+ ### Reporting Vulnerabilities
239
+
240
+ Please do not open public GitHub issues for security vulnerabilities. Use [GitHub private vulnerability reporting](https://github.com/dpuse/dpuse-development/security/advisories/new) instead. See [SECURITY.md](./SECURITY.md) for the full disclosure policy, contact details, and expected response times.
241
+
242
+ ### OpenSSF 🚧
243
+
244
+ [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/dpuse/dpuse-development/badge)](https://scorecard.dev/viewer/?uri=github.com/dpuse/dpuse-development)
245
+
246
+ This project is working towards the [OpenSSF Best Practices](https://www.bestpractices.dev) Passing badge, a self-certification covering security policy, vulnerability reporting, build processes, code quality, and more. Currently the [OpenSSF Scorecard](https://scorecard.dev/viewer/?uri=github.com/dpuse/dpuse-development) provides an independent automated assessment of the project's security practices and is an ongoing area of improvement.
247
+
248
+ ## Contributing
249
+
250
+ This repository is maintained solely by its owner and does not, at present, accept external contributions into the canonical repo. Its source is published openly under the MIT License — every DPUse project is fully open source except DPUse Engine, which remains closed and proprietary.
251
+
252
+ For security vulnerabilities, see [Reporting Vulnerabilities](#reporting-vulnerabilities). For bugs, inconsistencies, or other feedback, [open a GitHub issue](https://github.com/dpuse/dpuse-development/issues) — feedback is read, but responses and fixes are at the maintainer's discretion.
253
+
254
+ ## License
255
+
256
+ This project is licensed under the MIT License, permitting free use, modification, and distribution.
257
+
258
+ [MIT](./LICENSE) © 2026-present Jonathan Terrell
259
+
260
+ <!-- GOVERNANCE_END -->
@@ -6130,7 +6130,7 @@ function Sr(e) {
6130
6130
  }
6131
6131
  //#endregion
6132
6132
  //#region src/actions/documentDependencies.ts
6133
- var Cr = "<!-- DEPENDENCY_LICENSES_START -->", wr = "<!-- DEPENDENCY_LICENSES_END -->", Tr = "<!-- DEPENDENCY_TREE_START -->", Er = "<!-- DEPENDENCY_TREE_END -->", Dr = "The dependency tree below lists every package in this project — direct and transitive — along with its installed version, release date, and update status. Packages flagged ❗ have a newer version available; ⚠️ indicates a package that hasn't been updated in the last 6 months or longer. Neither flag necessarily indicates a problem: we let new releases stabilise before upgrading, and some packages are simply mature and stable, requiring no active development.";
6133
+ var Cr = "<!-- DEPENDENCY_LICENSES_START -->", wr = "<!-- DEPENDENCY_LICENSES_END -->", Tr = "<!-- DEPENDENCY_TREE_START -->", Er = "<!-- DEPENDENCY_TREE_END -->", Dr = "The dependency tree below lists every package in this project — direct and transitive — along with its installed version, release date, and update status. Packages flagged ❗ have a newer version available; ⚠️ indicates a package that hasn't been updated in the last 6 months or longer. Neither flag necessarily indicates a problem: we let new releases stabilise before upgrading, and some packages are mature and stable (have limited or no dependencies), so they require no active development.";
6134
6134
  async function Or(e = "MIT") {
6135
6135
  try {
6136
6136
  K("Document Dependencies");
@@ -6910,7 +6910,15 @@ function Wi(e, t, n, r) {
6910
6910
 
6911
6911
  ## About DPUse
6912
6912
 
6913
- DPUse (Data Positioning & Use) is an in-browser application that positions your data for use through three core activities: sourcing, contextualising, and publishing. **Sourcing** uses a library of [Connectors](https://www.dpuse.app) to establish [Connections](https://www.dpuse.app) to applications, databases, file stores, and curated datasets; these connections are subsequently used to configure structured [Data Views](https://www.dpuse.app) from the underlying sources. **Contextualising** extracts chronological events from those [Data Views](https://www.dpuse.app) and maps them into comprehensive [Context Models](https://www.dpuse.app). This provides the DPUse Engine with the structural framework required to generate deterministic transactions, facts, or observations. **Publishing** employs a library of [Presenters](https://www.dpuse.app) to render standard [Presentations](https://www.dpuse.app) immediately using the contextualised data; additionally, [Cookbooks](https://www.dpuse.app) of [Recipes](https://www.dpuse.app) allow you to build Data Apps using your preferred tools.
6913
+ DPUse (Data Positioning & Use) is an in-browser application that positions your data for use through three core activities: sourcing, contextualising, and publishing.
6914
+
6915
+ **Sourcing** uses a library of [Connectors](https://www.dpuse.app/connectors) to establish [Connections](https://www.dpuse.app) to applications, databases, file stores, and curated datasets; these connections are subsequently used to configure structured [Data Views](https://www.dpuse.app) from the underlying sources.
6916
+
6917
+ **Contextualising** extracts chronological events from those [Data Views](https://www.dpuse.app) and maps them into comprehensive [Context Models](https://www.dpuse.app). This gives the DPUse Engine the structural framework needed to generate deterministic transactions, facts, or observations.
6918
+
6919
+ **Publishing** uses a library of [Presenters](https://www.dpuse.app) to render standard [Presentations](https://www.dpuse.app) immediately using the contextualised data; additionally, [Cookbooks](https://www.dpuse.app) of [Recipes](https://www.dpuse.app) let you build Data Apps using your preferred tools.
6920
+
6921
+ In addition, DPUse provides [Tools](https://www.dpuse.app) used by the application, and you can use them to construct connectors and presenters.
6914
6922
 
6915
6923
  ## Introduction
6916
6924