Data Positioning File Store Emulator Connector

![OWASP](https://data-positioning.github.io/datapos-connector-file-store-emulator/dependency-check-reports/dependency-check-report.html)

![License: MIT](./LICENSE)

A TypeScript library that implements the File Store Emulator connector. It provides easy access to a curated set of files for demonstration and evaluation purposes.

Rust WebAssembly Helpers

The connector now ships with a lightweight Rust crate located in rust/datapos-connector-file-store-emulator-core. It is compiled to WebAssembly with wasm-pack so TypeScript can call native Rust logic.

- Run npm run build:rust (requires the wasm-pack CLI) whenever you change the Rust sources. The command rebuilds the package into rust/datapos-connector-file-store-emulator-core/pkg.
- The async wrapper in src/rustBridge.ts lazy-loads the generated bindings and surfaces helpers like addNumbersWithRust() and checksumWithRust().
- FileStoreEmulatorConnector exposes addUsingRust() and versionChecksumUsingRust() so consumers can exercise the Rust-backed functionality without dealing with low-level WebAssembly plumbing.

Installation

There’s no need to install this connector manually. Once released, it’s uploaded to the Data Positioning Engine cloud and becomes instantly available to all new instances of the browser app. A notification about the new version is also sent to all existing browser apps.

Reports & Compliance

$3

The OWASP Dependency Check Report identifies known vulnerabilities in project dependencies. It is generated automatically on each release using the npm package owasp-dependency-check. We also rely on GitHub Dependabot to continuously check for vulnerabilities across all dependencies.

View the OWASP Dependency Check Report

$3

The following table lists top-level production and peer dependencies. All these dependencies (including transitive ones) have been recursively verified to use Apache-2.0, CC0-1.0, or MIT—commercially friendly licenses with minimal restrictions. Developers cloning this repository should independently verify dev and optional dependencies; users of the uploaded library are covered by these checks.

| Name | Type | Installed | Latest | Latest Released | Deps | Document |
| :---------------------- | :--- | :-------: | :-----: | :----------------------- | ---: | :---------------------------------------------------------------------------------------- |
| @datapos/datapos-shared | MIT | 0.3.396 | 0.3.396 | this month: 2025-12-23 | 3 | LICENSE |
| nanoid | MIT | 5.1.6 | 5.1.6 | 3 months ago: 2025-09-22 | 0 | LICENSE |

Installed dependencies are kept up-to-date with latest releases.

$3

The Bundle Analysis Report provides a detailed breakdown of the bundle's composition and module sizes, helping to identify which modules contribute most to the final build. It is generated automatically on each release using the npm package rollup-plugin-visualizer.

View the Bundle Analysis Report

Repository Management Commands

The following list details the repository management commands implementation by this project. For more details, please refer to the scripts section of the 'package.json' file in this project.

| Name | VSCode Shortcuts | Notes |
| -------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------- |
| audit | alt+ctrl+shift+a | Audit the project's dependencies for known security vulnerabilities. |
| build | alt+ctrl+shift+b | Type-check, compile and minify for production. Output in '/dist' directory. |
| build:rust | | Compile the Rust helper crate to WebAssembly via wasm-pack. Requires the wasm-pack CLI in your PATH. |
| buildConnectorConfig | | |
| bumpVersion | alt+ctrl+shift+v | |
| check | alt+ctrl+shift+c | List the dependencies in the project that are outdated. |
| document | alt+ctrl+shift+d | Identify the licenses of the project's dependencies. |
| format | alt+ctrl+shift+f | Enforce formatting style rules. |
| lint | alt+ctrl+shift+l | Check the code for potential errors and enforces coding styles. |
| publishToNPM | alt+ctrl+shift+p | ❌ Not implemented. |
| release | alt+ctrl+shift+r | Synchronise local repository with the main GitHub repository and upload connector to Data Positioning platform. |
| syncWithGitHub | alt+ctrl+shift+s | Synchronise local repository with the main GitHub repository. |
| updateDependencies | alt+ctrl+shift+l | Install the latest version of all Data Positioning dependencies. |

Compliance

The following badge reflects FOSSA's assessment of this repository's open-source license compliance.

License