9 Commits

Author SHA1 Message Date
792216f7c1 v1.12.7
Some checks failed
Default (tags) / security (push) Failing after 0s
Default (tags) / test (push) Failing after 0s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-03-24 19:47:27 +00:00
b1f7342b16 fix(deps): bump aws sdk, smartdata, and tswatch dependencies 2026-03-24 19:47:27 +00:00
2a21ac3075 v1.12.6
Some checks failed
Default (tags) / security (push) Failing after 0s
Default (tags) / test (push) Failing after 0s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-03-24 19:18:35 +00:00
bd3823741b fix(build): remove skiplibcheck from the build script 2026-03-24 19:18:35 +00:00
2c23b8862b v1.12.5
Some checks failed
Default (tags) / security (push) Failing after 0s
Default (tags) / test (push) Failing after 0s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-03-24 19:18:00 +00:00
5a25f22fc5 fix(package): bump package version to 1.12.5 2026-03-24 19:18:00 +00:00
219a34e6a5 v1.12.4
Some checks failed
Default (tags) / security (push) Failing after 0s
Default (tags) / test (push) Failing after 0s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-03-24 19:02:45 +00:00
69ab8f3436 fix(config): migrate project config to .smartconfig.json and refresh build settings 2026-03-24 19:02:45 +00:00
1b5b023556 fix(build): update bundled_ui.ts with latest build output 2026-03-24 15:09:16 +00:00
11 changed files with 1187 additions and 1415 deletions

View File

@@ -1,7 +1,7 @@
{ {
"json.schemas": [ "json.schemas": [
{ {
"fileMatch": ["/npmextra.json"], "fileMatch": ["/.smartconfig.json"],
"schema": { "schema": {
"type": "object", "type": "object",
"properties": { "properties": {

View File

@@ -1,5 +1,30 @@
# Changelog # Changelog
## 2026-03-24 - 1.12.7 - fix(deps)
bump aws sdk, smartdata, and tswatch dependencies
- update @aws-sdk/client-s3 from ^3.1015.0 to ^3.1016.0
- update @push.rocks/smartdata from ^7.1.0 to ^7.1.1
- update @git.zone/tswatch from ^3.3.1 to ^3.3.2
## 2026-03-24 - 1.12.6 - fix(build)
remove skiplibcheck from the build script
- Updates the build command to run tsbuild without the --skiplibcheck flag.
- Tightens TypeScript build validation by including library type checks during builds.
## 2026-03-24 - 1.12.5 - fix(package)
bump package version to 1.12.5
- Updates the package metadata version from 1.12.4 to 1.12.5.
## 2026-03-24 - 1.12.4 - fix(config)
migrate project config to .smartconfig.json and refresh build settings
- replaces npmextra.json with .smartconfig.json and updates packaged files accordingly
- adds --skiplibcheck to the build script and simplifies tsconfig settings
- bumps build and runtime dependencies and updates README references to the new config file
## 2026-03-24 - 1.12.3 - fix(package) ## 2026-03-24 - 1.12.3 - fix(package)
bump package version to 1.12.3 bump package version to 1.12.3

View File

@@ -1,6 +1,6 @@
{ {
"name": "@git.zone/tsview", "name": "@git.zone/tsview",
"version": "1.12.3", "version": "1.12.7",
"private": false, "private": false,
"description": "A CLI tool for viewing S3 and MongoDB data with a web UI", "description": "A CLI tool for viewing S3 and MongoDB data with a web UI",
"main": "dist_ts/index.js", "main": "dist_ts/index.js",
@@ -21,26 +21,26 @@
}, },
"devDependencies": { "devDependencies": {
"@api.global/typedsocket": "^4.1.2", "@api.global/typedsocket": "^4.1.2",
"@git.zone/tsbuild": "^4.3.0", "@git.zone/tsbuild": "^4.4.0",
"@git.zone/tsbundle": "^2.9.1", "@git.zone/tsbundle": "^2.10.0",
"@git.zone/tsrun": "^2.0.1", "@git.zone/tsrun": "^2.0.1",
"@git.zone/tstest": "^3.3.2", "@git.zone/tstest": "^3.5.1",
"@git.zone/tswatch": "^3.3.0", "@git.zone/tswatch": "^3.3.2",
"@push.rocks/smartrx": "^3.0.10", "@push.rocks/smartrx": "^3.0.10",
"@types/node": "^25.5.0" "@types/node": "^25.5.0"
}, },
"dependencies": { "dependencies": {
"@api.global/typedrequest": "^3.3.0", "@api.global/typedrequest": "^3.3.0",
"@api.global/typedrequest-interfaces": "^3.0.19", "@api.global/typedrequest-interfaces": "^3.0.19",
"@api.global/typedserver": "^8.4.2", "@api.global/typedserver": "^8.4.6",
"@aws-sdk/client-s3": "^3.1009.0", "@aws-sdk/client-s3": "^3.1016.0",
"@design.estate/dees-catalog": "^3.48.5", "@design.estate/dees-catalog": "^3.49.0",
"@design.estate/dees-element": "^2.2.3", "@design.estate/dees-element": "^2.2.3",
"@push.rocks/early": "^4.0.4", "@push.rocks/early": "^4.0.4",
"@push.rocks/smartconfig": "^6.0.0",
"@push.rocks/smartbucket": "^4.5.1", "@push.rocks/smartbucket": "^4.5.1",
"@push.rocks/smartcli": "^4.0.20", "@push.rocks/smartcli": "^4.0.20",
"@push.rocks/smartdata": "^7.1.0", "@push.rocks/smartconfig": "^6.0.1",
"@push.rocks/smartdata": "^7.1.1",
"@push.rocks/smartfile": "^13.1.2", "@push.rocks/smartfile": "^13.1.2",
"@push.rocks/smartlog": "^3.2.1", "@push.rocks/smartlog": "^3.2.1",
"@push.rocks/smartlog-destination-local": "^9.0.2", "@push.rocks/smartlog-destination-local": "^9.0.2",
@@ -48,7 +48,7 @@
"@push.rocks/smartopen": "^2.0.0", "@push.rocks/smartopen": "^2.0.0",
"@push.rocks/smartpath": "^6.0.0", "@push.rocks/smartpath": "^6.0.0",
"@push.rocks/smartpromise": "^4.2.3", "@push.rocks/smartpromise": "^4.2.3",
"mongodb": "^7.1.0" "mongodb": "^7.1.1"
}, },
"files": [ "files": [
"ts/**/*", "ts/**/*",
@@ -59,7 +59,7 @@
"dist_ts_web/**/*", "dist_ts_web/**/*",
"assets/**/*", "assets/**/*",
"cli.js", "cli.js",
"npmextra.json", ".smartconfig.json",
"readme.md" "readme.md"
], ],
"browserslist": [ "browserslist": [

2427
pnpm-lock.yaml generated

File diff suppressed because it is too large Load Diff

112
readme.md
View File

@@ -1,6 +1,6 @@
# @git.zone/tsview # @git.zone/tsview
A powerful developer tool for browsing and managing S3-compatible storage and MongoDB databases through a sleek web UI — with real-time change streaming baked in. Built with TypeScript, designed for developers who need quick, visual access to their data stores. A powerful developer tool for browsing and managing S3-compatible storage and MongoDB databases through a sleek web UI — with real-time change streaming baked in. Built with TypeScript, designed for developers who need quick, visual access to their data stores during development.
## Issue Reporting and Security ## Issue Reporting and Security
@@ -16,54 +16,11 @@ pnpm add -g @git.zone/tsview
pnpm add @git.zone/tsview pnpm add @git.zone/tsview
``` ```
## Features ## 🚀 Quick Start
### S3 Storage Browser
Powered by the `dees-storage-browser` component from `@design.estate/dees-catalog`:
- **Column View Navigation** — Mac Finder-style interface with resizable columns
- **List View** — Traditional key-based view with hierarchical navigation
- **Real-time Preview** — View images, JSON, text files, code, and more directly in the browser
- **Bucket Management** — Create, delete, and switch between buckets
- **File Operations** — Upload, download, delete, move, and copy objects
- **In-place Text Editing** — Edit text files directly in the browser with change tracking
- **Smart Content Type Detection** — Automatic recognition for 20+ file types
- **Breadcrumb Navigation** — Clickable path traversal
### MongoDB Browser
- **Database Explorer** — Hierarchical navigation through databases and collections
- **Database Overview** — Collection counts, data sizes, index stats at a glance
- **Document Viewer** — Paginated table view with JSON filter support
- **Document Editor** — Full CRUD with syntax-highlighted code editor and change tracking
- **Index Management** — View, create, and drop indexes
- **Aggregation Pipeline** — Run aggregation queries directly
- **Collection Stats** — Document counts, sizes, storage metrics
- **Server Status** — Connection info, version, uptime
- **Show/Hide System Databases** — Toggle visibility of `admin`, `local`, `config`
### Real-Time Change Streaming
- **MongoDB Change Streams** — Live updates via native MongoDB change streams
- **S3 Change Detection** — Polling-based bucket monitoring with ETag comparison (5s intervals)
- **Activity Stream** — Combined timeline of all changes from both sources, filterable by type
- **Live Indicators** — Green dot + change count badges on active views
- **WebSocket Subscriptions** — Per-collection, per-bucket, or global activity feed
- **Auto-Reconnect** — Subscriptions automatically restored after connection loss
### Modern Web UI
- Dark theme designed for developer comfort
- Responsive layout with resizable panels
- Context menus for quick actions
- Everything bundled — zero external runtime dependencies in the browser
## Quick Start
### 1. Configure Your Connection ### 1. Configure Your Connection
Create a `.nogit/env.json` file in your project root: Create a `.nogit/env.json` file in your project root (auto-generated by `gitzone service`):
```json ```json
{ {
@@ -83,7 +40,50 @@ Create a `.nogit/env.json` file in your project root:
tsview tsview
``` ```
That's it! Your browser will automatically open to the viewer interface. That's it! Your browser opens automatically to the viewer interface.
## ✨ Features
### 🗄️ S3 Storage Browser
Powered by `dees-storage-browser` from `@design.estate/dees-catalog`:
- **Column View Navigation** — Mac Finder-style interface with resizable columns
- **List View** — Traditional key-based view with hierarchical navigation
- **Real-time Preview** — View images, JSON, text, code, and more directly in the browser
- **Bucket Management** — Create, delete, and switch between buckets
- **File Operations** — Upload, download, delete, move, and copy objects
- **In-place Text Editing** — Edit text files directly with change tracking
- **Smart Content Type Detection** — Automatic recognition for 20+ file types
- **Breadcrumb Navigation** — Clickable path traversal
### 🍃 MongoDB Browser
- **Database Explorer** — Hierarchical navigation through databases and collections
- **Database Overview** — Collection counts, data sizes, index stats at a glance
- **Document Viewer** — Paginated table view with JSON filter support
- **Document Editor** — Full CRUD with syntax-highlighted code editor and change tracking
- **Index Management** — View, create, and drop indexes
- **Aggregation Pipeline** — Run aggregation queries directly
- **Collection Stats** — Document counts, sizes, storage metrics
- **Server Status** — Connection info, version, uptime
- **Show/Hide System Databases** — Toggle visibility of `admin`, `local`, `config`
### ⚡ Real-Time Change Streaming
- **MongoDB Change Streams** — Live updates via native MongoDB change streams
- **S3 Change Detection** — Polling-based bucket monitoring with ETag comparison (5s intervals)
- **Activity Stream** — Combined timeline of all changes from both sources, filterable by type
- **Live Indicators** — Green dot + change count badges on active views
- **WebSocket Subscriptions** — Per-collection, per-bucket, or global activity feed
- **Auto-Reconnect** — Subscriptions automatically restored after connection loss
### 🎨 Modern Web UI
- Dark theme designed for developer comfort
- Responsive layout with resizable panels
- Context menus for quick actions
- Everything bundled — zero external runtime dependencies in the browser
## CLI Usage ## CLI Usage
@@ -116,7 +116,7 @@ const viewer = new TsView();
await viewer.loadConfigFromEnv(); await viewer.loadConfigFromEnv();
// Option 2: Configure programmatically // Option 2: Configure programmatically
viewer.setS3Config({ viewer.setStorageConfig({
endpoint: 'localhost', endpoint: 'localhost',
port: 9000, port: 9000,
accessKey: 'minioadmin', accessKey: 'minioadmin',
@@ -130,7 +130,7 @@ viewer.setMongoConfig({
}); });
// Option 3: Cloud services // Option 3: Cloud services
viewer.setS3Config({ viewer.setStorageConfig({
endpoint: 's3.amazonaws.com', endpoint: 's3.amazonaws.com',
accessKey: 'AKIAXXXXXXX', accessKey: 'AKIAXXXXXXX',
accessSecret: 'your-secret-key', accessSecret: 'your-secret-key',
@@ -156,7 +156,7 @@ await viewer.stop();
## Configuration ## Configuration
### Project-level via `npmextra.json` ### Project-level via `.smartconfig.json`
```json ```json
{ {
@@ -174,7 +174,7 @@ await viewer.stop();
| `killIfBusy` | `boolean` | `false` | Kill existing process if port is busy | | `killIfBusy` | `boolean` | `false` | Kill existing process if port is busy |
| `openBrowser` | `boolean` | `true` | Automatically open browser on start | | `openBrowser` | `boolean` | `true` | Automatically open browser on start |
**Port priority:** CLI `--port` flag → `npmextra.json` → auto-detect **Port priority:** CLI `--port` flag → `.smartconfig.json` → auto-detect
### Environment Variables (`.nogit/env.json`) ### Environment Variables (`.nogit/env.json`)
@@ -229,11 +229,11 @@ tsview works with any S3-compatible storage:
| **Data** | `.csv`, `.xml`, `.yaml`, `.yml` | | **Data** | `.csv`, `.xml`, `.yaml`, `.yml` |
| **Documents** | `.pdf` | | **Documents** | `.pdf` |
## Architecture ## 🏗️ Architecture
``` ```
tsview/ tsview/
├── ts/ # Backend ├── ts/ # Backend (Node.js)
│ ├── api/ # TypedRequest API handlers │ ├── api/ # TypedRequest API handlers
│ │ ├── handlers.s3.ts # S3 bucket & object operations │ │ ├── handlers.s3.ts # S3 bucket & object operations
│ │ └── handlers.mongodb.ts # MongoDB CRUD & admin operations │ │ └── handlers.mongodb.ts # MongoDB CRUD & admin operations
@@ -244,7 +244,7 @@ tsview/
│ │ └── interfaces.streaming.ts # Subscription interfaces │ │ └── interfaces.streaming.ts # Subscription interfaces
│ ├── interfaces/ # Shared TypeScript interfaces │ ├── interfaces/ # Shared TypeScript interfaces
│ └── tsview.classes.tsview.ts # Main class │ └── tsview.classes.tsview.ts # Main class
├── ts_web/ # Frontend ├── ts_web/ # Frontend (bundled via esbuild → base64ts)
│ ├── elements/ # Web components (LitElement) │ ├── elements/ # Web components (LitElement)
│ │ ├── tsview-app.ts # App shell + navigation │ │ ├── tsview-app.ts # App shell + navigation
│ │ ├── tsview-mongo-*.ts # MongoDB browser components │ │ ├── tsview-mongo-*.ts # MongoDB browser components
@@ -254,7 +254,7 @@ tsview/
│ ├── services/ # API + WebSocket clients │ ├── services/ # API + WebSocket clients
│ ├── styles/ # Dark theme │ ├── styles/ # Dark theme
│ └── utilities/ # Formatting helpers │ └── utilities/ # Formatting helpers
└── cli.ts.js # CLI entry point └── .smartconfig.json # Build & runtime config
``` ```
### How It Works ### How It Works
@@ -287,7 +287,7 @@ pnpm test
## License and Legal Information ## License and Legal Information
This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [LICENSE](./LICENSE) file. This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [license](./license) file.
**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file. **Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.

View File

@@ -10,7 +10,7 @@ tsview/
├── cli.ts.js # Dev CLI (uses tsrun to run cli.child.ts) ├── cli.ts.js # Dev CLI (uses tsrun to run cli.child.ts)
├── cli.child.ts # Dev CLI entry (imports ts/index.js) ├── cli.child.ts # Dev CLI entry (imports ts/index.js)
├── package.json # bin: { "tsview": "cli.js" } ├── package.json # bin: { "tsview": "cli.js" }
├── npmextra.json # tsbundle config for UI bundling ├── .smartconfig.json # tsbundle/tswatch config
├── tsconfig.json ├── tsconfig.json
├── readme.md ├── readme.md
├── readme.hints.md ├── readme.hints.md

View File

@@ -3,6 +3,6 @@
*/ */
export const commitinfo = { export const commitinfo = {
name: '@git.zone/tsview', name: '@git.zone/tsview',
version: '1.12.3', version: '1.12.7',
description: 'A CLI tool for viewing S3 and MongoDB data with a web UI' description: 'A CLI tool for viewing S3 and MongoDB data with a web UI'
} }

File diff suppressed because one or more lines are too long

View File

@@ -3,6 +3,6 @@
*/ */
export const commitinfo = { export const commitinfo = {
name: '@git.zone/tsview', name: '@git.zone/tsview',
version: '1.12.3', version: '1.12.7',
description: 'A CLI tool for viewing S3 and MongoDB data with a web UI' description: 'A CLI tool for viewing S3 and MongoDB data with a web UI'
} }

View File

@@ -4,9 +4,7 @@
"module": "NodeNext", "module": "NodeNext",
"moduleResolution": "NodeNext", "moduleResolution": "NodeNext",
"esModuleInterop": true, "esModuleInterop": true,
"verbatimModuleSyntax": true, "verbatimModuleSyntax": true
"baseUrl": ".",
"paths": {}
}, },
"exclude": ["dist_*/**/*.d.ts"] "exclude": ["dist_*/**/*.d.ts"]
} }