graphvault-studio 0.1.2

package/dist/admin-ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-ui.js","sourceRoot":"","sources":["../src/admin-ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAqNC,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8pBvD,CAAC"}

package/dist/admin.d.ts

@@ -0,0 +1,4 @@
+export { StorageAdminClient } from "./admin-client.js";
+export type { AdminGraph, AdminGraphEdge, AdminGraphNode, AdminHierarchyPath, AdminHierarchyPathItem, AdminMutation, AdminMutationPreview, GvqlResult, AdminObjectChild, AdminObjectListItem, AdminObjectPage, AdminObjectParent, AdminRootReference, AdminSearchResult, AdminSummary, StorageAdminClientOptions, } from "./admin-client.js";
+export { startAdminServer } from "./admin-server.js";
+export type { AdminServerOptions, RunningAdminServer } from "./admin-server.js";

package/dist/admin.js

@@ -0,0 +1,3 @@
+export { StorageAdminClient } from "./admin-client.js";
+export { startAdminServer } from "./admin-server.js";
+//# sourceMappingURL=admin.js.map

package/dist/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../src/admin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAmBvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/gvql-examples.d.ts

@@ -0,0 +1,6 @@
+export interface StudioGvqlExample {
+    name: string;
+    query: string;
+    parameters?: Record<string, unknown>;
+}
+export declare const STUDIO_GVQL_EXAMPLES: StudioGvqlExample[];

package/dist/gvql-examples.js

@@ -0,0 +1,45 @@
+export const STUDIO_GVQL_EXAMPLES = [
+    { name: "Inspect nodes", query: "MATCH (node) RETURN node.$id AS objectId, node.$type AS type, node.$kind AS kind ORDER BY node.$id ASC LIMIT 25 OFFSET 0" },
+    { name: "Filter types", query: 'MATCH (node) WHERE node.$type IN ["Document", "Workspace"] RETURN node.$id AS objectId, node.$type AS type ORDER BY node.$type ASC, node.$id ASC' },
+    { name: "Distinct values", query: "MATCH (item) RETURN DISTINCT item.status AS status ORDER BY status ASC" },
+    { name: "Type count", query: "MATCH (node) WHERE node.$type IS NOT NULL RETURN count(DISTINCT node.$type) AS types" },
+    { name: "Nullable fields", query: "MATCH (item) WHERE item.archivedAt IS NULL AND item.status IS NOT NULL RETURN item.id AS id, item.title AS title ORDER BY item.id ASC" },
+    { name: "Indexed IN", query: 'MATCH (item) WHERE item.status IN ["draft", "published"] AND item.id IN ["doc-1", "doc-2"] RETURN item.id AS id, item.status AS status ORDER BY item.id ASC' },
+    { name: "Indexed OR", query: 'MATCH (item) WHERE item.id = "missing" OR item.status = "published" RETURN item.id AS id, item.status AS status' },
+    { name: "Parentheses", query: 'MATCH (item) WHERE (item.status = "draft" OR item.status = "published") AND item.views > 20 RETURN item.id AS id, item.status AS status, item.views AS views' },
+    { name: "NOT filter", query: 'MATCH (item) WHERE NOT (item.status = "published" OR item.views < 10) RETURN item.id AS id, item.status AS status, item.views AS views' },
+    { name: "Computed score", query: "MATCH (item) RETURN item.id AS id, (item.views + $bonus) * 2 AS score ORDER BY score DESC LIMIT 25", parameters: { bonus: 5 } },
+    { name: "Aggregate", query: "MATCH (item) RETURN item.status AS status, count(*) AS count GROUP BY item.status HAVING count > 1 ORDER BY count DESC, status ASC" },
+    { name: "Aggregate NOT", query: 'MATCH (item) RETURN item.status AS status, count(*) AS count, avg(item.views) AS avgViews GROUP BY item.status HAVING NOT (status = "published" OR avgViews < 10) ORDER BY status ASC' },
+    {
+        name: "WITH pipeline",
+        query: "MATCH (item) WHERE item.status IS NOT NULL WITH item.status AS status, count(*) AS count, avg(item.views) AS avgViews GROUP BY item.status HAVING count > 0 RETURN status, count, avgViews ORDER BY count DESC",
+    },
+    {
+        name: "WITH filter",
+        query: 'MATCH (item) WHERE item.status IS NOT NULL WITH item.id AS id, CASE WHEN item.views >= 100 THEN "hot" WHEN item.archivedAt IS NOT NULL THEN "archived" ELSE "active" END AS bucket WHERE bucket = "hot" RETURN id, bucket ORDER BY id ASC',
+    },
+    { name: "Traverse owner", query: 'MATCH (item)-[:owner]->(owner) WHERE owner.name = "Platform Team" RETURN item.title AS title' },
+    { name: "Join patterns", query: 'MATCH (item)-[:owner]->(owner), (item)-[:category]->(category) WHERE owner.name = "Platform Team" AND category.slug = "guides" RETURN item.id AS id, item.title AS title, category.label AS category ORDER BY item.title ASC LIMIT 25' },
+    { name: "Optional match", query: "MATCH (item) OPTIONAL MATCH (item)-[:related]->(items)-[:*]->(related) RETURN item.id AS id, related.id AS relatedId ORDER BY item.id ASC LIMIT 25" },
+    {
+        name: "Scalar functions",
+        query: 'MATCH (item) WHERE lower(item.title) CONTAINS lower($needle) RETURN item.id AS id, upper(trim(item.title)) AS title, length(item.title) AS titleLength, coalesce(item.archivedAt, "none") AS archived ORDER BY item.id ASC',
+        parameters: { needle: "storage" },
+    },
+    {
+        name: "CASE buckets",
+        query: 'MATCH (item) WHERE item.status IS NOT NULL RETURN item.id AS id, CASE WHEN item.views >= 100 THEN "hot" WHEN item.archivedAt IS NOT NULL THEN "archived" ELSE "active" END AS bucket ORDER BY item.id ASC LIMIT 25',
+    },
+    { name: "Preview SET", query: 'MATCH (item) WHERE item.status = "draft" SET item.status = "archived" RETURN count(*) AS changed' },
+    {
+        name: "CASE update",
+        query: 'MATCH (item) WHERE item.status IS NOT NULL SET item.status = CASE WHEN item.views >= 100 THEN "featured" WHEN item.archivedAt IS NOT NULL THEN "archived" ELSE item.status END RETURN item.id AS id, item.status AS status',
+    },
+    { name: "Arithmetic SET", query: "MATCH (item) WHERE item.status = \"published\" SET item.views = (item.views + $increment) * 2 RETURN item.id AS id, item.views AS views", parameters: { increment: 5 } },
+    { name: "REMOVE field", query: "MATCH (item) WHERE item.archivedAt IS NOT NULL REMOVE item.archivedAt RETURN count(*) AS changed" },
+    { name: "DELETE object", query: 'MATCH (item) WHERE item.status = "archived" DELETE item RETURN item.id AS id' },
+    { name: "CREATE into collection", query: 'MATCH (workspace:Workspace) WHERE workspace.name = "Developer docs" CREATE (item:Document { id: "doc-4", title: "Release checklist", status: "draft", views: 0 }) INTO workspace.documents RETURN item.id AS id, item.title AS title' },
+    { name: "MERGE into collection", query: 'MATCH (workspace:Workspace) WHERE workspace.name = "Developer docs" MERGE (item:Document { id: "doc-4", title: "Release checklist", status: "draft", views: 0 }) INTO workspace.documents ON item.id RETURN item.id AS id, item.title AS title' },
+];
+//# sourceMappingURL=gvql-examples.js.map

package/dist/gvql-examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gvql-examples.js","sourceRoot":"","sources":["../src/gvql-examples.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,oBAAoB,GAAwB;IACvD,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,0HAA0H,EAAE;IAC5J,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,kJAAkJ,EAAE;IACnL,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,wEAAwE,EAAE;IAC5G,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,sFAAsF,EAAE;IACrH,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,uIAAuI,EAAE;IAC3K,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,6JAA6J,EAAE;IAC5L,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,iHAAiH,EAAE;IAChJ,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,8JAA8J,EAAE;IAC9L,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,wIAAwI,EAAE;IACvK,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,oGAAoG,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IACjK,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,oIAAoI,EAAE;IAClK,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,uLAAuL,EAAE;IACzN;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,gNAAgN;KACxN;IACD;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,2OAA2O;KACnP;IACD,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,8FAA8F,EAAE;IACjI,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,uOAAuO,EAAE;IACzQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,oJAAoJ,EAAE;IACvL;QACE,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,4NAA4N;QACnO,UAAU,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;KAClC;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,oNAAoN;KAC5N;IACD,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,kGAAkG,EAAE;IAClI;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,4NAA4N;KACpO;IACD,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,yIAAyI,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE;IAC1M,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,kGAAkG,EAAE;IACnI,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,8EAA8E,EAAE;IAChH,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,sOAAsO,EAAE;IACjR,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,gPAAgP,EAAE;CAC3R,CAAC"}

package/docs/GVQL.md

@@ -0,0 +1,217 @@
+# GraphVault Studio GVQL Examples
+
+## GVQL
+
+Studio includes a GVQL console for GraphVault stores. It supports read queries and safe batch-update previews:
+
+```sql
+MATCH (node)
+RETURN node.$id AS objectId, node.$type AS type, node.$kind AS kind
+ORDER BY node.$id ASC
+LIMIT 25
+OFFSET 0
+```
+
+```sql
+MATCH (node)
+WHERE node.$type IN ["Document", "Workspace"]
+RETURN node.$id AS objectId, node.$type AS type
+ORDER BY node.$type ASC, node.$id ASC
+```
+
+```sql
+MATCH (doc:Document)-[:owner]->(owner:Owner)
+WHERE owner.name = "Platform Team"
+RETURN doc.id AS id, doc.title AS title
+ORDER BY doc.title ASC, doc.id ASC
+LIMIT 25
+OFFSET 0
+```
+
+```sql
+MATCH (doc:Document)-[:owner]->(owner:Owner), (doc)-[:category]->(category:Category)
+WHERE owner.name = "Platform Team" AND category.slug = "guides"
+RETURN doc.id AS id, doc.title AS title, category.label AS category
+ORDER BY doc.title ASC
+LIMIT 25
+```
+
+```sql
+MATCH (doc:Document)
+OPTIONAL MATCH (doc)-[:related]->(items)-[:*]->(related:Document)
+RETURN doc.id AS id, related.id AS relatedId
+ORDER BY doc.id ASC
+LIMIT 25
+```
+
+```sql
+MATCH (doc:Document)
+WHERE lower(doc.title) CONTAINS lower($needle)
+RETURN doc.id AS id, upper(trim(doc.title)) AS title, length(doc.title) AS titleLength, coalesce(doc.archivedAt, "none") AS archived
+ORDER BY doc.id ASC
+```
+
+```sql
+MATCH (doc:Document)
+RETURN DISTINCT doc.status AS status
+ORDER BY status ASC
+```
+
+```sql
+MATCH (node)
+WHERE node.$type IS NOT NULL
+RETURN count(DISTINCT node.$type) AS types
+```
+
+```sql
+MATCH (doc:Document)
+WHERE doc.archivedAt IS NULL AND doc.status IS NOT NULL
+RETURN doc.id AS id, doc.title AS title
+ORDER BY doc.id ASC
+```
+
+```sql
+MATCH (doc:Document)
+WHERE doc.status IN ["draft", "published"] AND doc.id IN ["doc-1", "doc-2"]
+RETURN doc.id AS id, doc.status AS status
+ORDER BY doc.id ASC
+```
+
+```sql
+MATCH (doc:Document)
+WHERE doc.id = "missing" OR doc.status = "published"
+RETURN doc.id AS id, doc.status AS status
+```
+
+```sql
+MATCH (doc:Document)
+WHERE (doc.status = "draft" OR doc.status = "published") AND doc.views > 20
+RETURN doc.id AS id, doc.status AS status, doc.views AS views
+```
+
+```sql
+MATCH (doc:Document)
+WHERE NOT (doc.status = "published" OR doc.views < 10)
+RETURN doc.id AS id, doc.status AS status, doc.views AS views
+```
+
+```sql
+MATCH (doc:Document)
+RETURN doc.id AS id, (doc.views + $bonus) * 2 AS score
+ORDER BY score DESC
+LIMIT 25
+```
+
+```sql
+MATCH (doc:Document)
+WHERE doc.status IS NOT NULL
+RETURN doc.id AS id,
+  CASE
+    WHEN doc.views >= 100 THEN "hot"
+    WHEN doc.archivedAt IS NOT NULL THEN "archived"
+    ELSE "active"
+  END AS bucket
+ORDER BY doc.id ASC
+LIMIT 25
+```
+
+```sql
+MATCH (doc:Document)
+WHERE doc.status IS NOT NULL
+WITH doc.status AS status, count(*) AS count, avg(doc.views) AS avgViews
+GROUP BY doc.status
+HAVING count > 0
+RETURN status, count, avgViews
+ORDER BY count DESC
+```
+
+```sql
+MATCH (doc:Document)
+WHERE doc.status IS NOT NULL
+WITH doc.id AS id,
+  CASE
+    WHEN doc.views >= 100 THEN "hot"
+    WHEN doc.archivedAt IS NOT NULL THEN "archived"
+    ELSE "active"
+  END AS bucket
+WHERE bucket = "hot"
+RETURN id, bucket
+ORDER BY id ASC
+```
+
+```sql
+MATCH (doc:Document)
+WHERE doc.status = "draft"
+SET doc.status = "archived"
+RETURN count(*) AS changed
+```
+
+```sql
+MATCH (doc:Document)
+WHERE doc.status IS NOT NULL
+SET doc.status =
+  CASE
+    WHEN doc.views >= 100 THEN "featured"
+    WHEN doc.archivedAt IS NOT NULL THEN "archived"
+    ELSE doc.status
+  END
+RETURN doc.id AS id, doc.status AS status
+```
+
+```sql
+MATCH (doc:Document)
+WHERE doc.status = "published"
+SET doc.views = (doc.views + $increment) * 2
+RETURN doc.id AS id, doc.views AS views
+```
+
+```sql
+MATCH (doc:Document)
+WHERE doc.archivedAt IS NOT NULL
+REMOVE doc.archivedAt
+RETURN count(*) AS changed
+```
+
+```sql
+MATCH (doc:Document)
+WHERE doc.status = "archived"
+DELETE doc
+RETURN doc.id AS id
+```
+
+```sql
+MATCH (workspace:Workspace)
+WHERE workspace.name = "Developer docs"
+CREATE (doc:Document { id: "doc-4", title: "Release checklist", status: "draft", views: 0 }) INTO workspace.documents
+RETURN doc.id AS id, doc.title AS title
+```
+
+```sql
+MATCH (workspace:Workspace)
+WHERE workspace.name = "Developer docs"
+MERGE (doc:Document { id: "doc-4", title: "Release checklist", status: "draft", views: 0 }) INTO workspace.documents ON doc.id
+RETURN doc.id AS id, doc.title AS title
+```
+
+Aggregate queries can be inspected directly in the same console:
+
+```sql
+MATCH (item)
+RETURN item.status AS status, count(*) AS count
+GROUP BY item.status
+HAVING count > 1
+ORDER BY count DESC, status ASC
+```
+
+```sql
+MATCH (item)
+RETURN item.status AS status, count(*) AS count, avg(item.views) AS avgViews
+GROUP BY item.status
+HAVING NOT (status = "published" OR avgViews < 10)
+ORDER BY status ASC
+```
+
+`Run / Preview` executes read queries and dry-runs updates. `Commit GVQL` applies update statements only when Studio was started with mutation support and the confirmation token matches.
+
+Each GVQL run includes an execution-plan row that shows whether Studio used a type index, primitive-property index, indexed `OR` union, or full scan, plus candidate and returned-row counts. That makes slow queries much easier to tune before they become production habits.
+Use `LIMIT` and `OFFSET` in the console for predictable paging through large result sets. Query parameters such as `$needle` or `$increment` are detected automatically and shown as typed input fields, so you do not need to hand-edit a JSON payload for common runs. Comma-separated `MATCH` patterns let you express join-like graph queries where shared aliases must resolve to the same object. `OPTIONAL MATCH` keeps the primary rows visible when a relationship is missing. `WITH` pipelines let you name intermediate values, aggregate them, and filter row aliases before the final `RETURN`. Computed `RETURN` expressions, `CASE` buckets, and scalar functions such as `lower`, `upper`, `trim`, `length`, and `coalesce` are useful for quick scores, projections, normalization, and sanity checks without changing stored data. `RETURN DISTINCT` and `count(DISTINCT path)` are useful when you want compact lists or cardinality checks for values such as statuses, tenants, regions, types, or object categories. Parentheses and `NOT` in `WHERE` and `HAVING` make mixed filters predictable. `CREATE ... INTO`, idempotent `MERGE ... INTO ... ON`, arithmetic or conditional `SET` expressions, `IS NULL`, `IS NOT NULL`, `REMOVE`, and parent-aware `DELETE` make graph manipulation previewable before commit.

package/docs/PUBLISHING.md

@@ -0,0 +1,46 @@
+# Publishing GraphVault Studio
+
+This checklist keeps the first public admin-client release repeatable.
+
+## Preconditions
+
+- `@sprengmeister/graphvault` has already been released.
+- `package.json` has the intended `name`, `version`, `repository`, `homepage`, `bugs`, `license`, `engines`, `bin`, `exports`, and `files`.
+- `CHANGELOG.md` and `docs/RELEASE_NOTES_0.1.0.md` describe the release.
+- `NPM_TOKEN` is configured as a GitHub Actions repository secret for npm publishing.
+
+## Local Release Check
+
+Run these from the repository root:
+
+```bash
+npm ci
+npm test
+npm run demo:store
+npm run pack:dry-run
+```
+
+Inspect the dry-run file list and confirm it contains `README.md`, `LICENSE`, `CHANGELOG.md`, `CONTRIBUTING.md`, `docs`, `dist`, `examples`, logo/screenshot assets, and the `graphvault-studio` CLI entry point.
+
+## Tagging
+
+Create the release tag only after the local release check passes:
+
+```bash
+git tag -a v0.1.0 -m "GraphVault Studio 0.1.0"
+git push origin v0.1.0
+```
+
+## Publishing
+
+Use the GitHub Actions `Release` workflow with the matching tag input, for example `v0.1.0`.
+
+The workflow checks out the tag, installs with `npm ci`, runs tests, creates the demo store, validates the npm tarball with `npm run pack:dry-run`, and publishes with npm provenance.
+
+## Repository Visibility
+
+Recommended GitHub topics:
+
+```text
+typescript, admin-ui, database-admin, graph-database, object-graph, storage-browser, gvql, developer-tools
+```

package/docs/RELEASE_NOTES_0.1.0.md

@@ -0,0 +1,41 @@
+# GraphVault Studio 0.1.0 Release Notes
+
+GraphVault Studio 0.1.0 is the first public graphical admin client for GraphVault object graph stores.
+
+## What Is Included
+
+- Root-first hierarchy browser for object graphs.
+- Search across paths, values, ids, types, references, and encoded object data.
+- Parent-path lookup from an object back toward the root, including multiple direct parents.
+- Paged object browser for large stores.
+- GVQL console for graph queries and dry-run batch mutation previews.
+- Controlled primitive-field editing with confirmation-token safety.
+- Verification, maintenance, backup, transaction, journal, graph, type dictionary, and object detail views.
+- CLI and programmatic server startup.
+- Local filesystem, custom, remote, S3-compatible, HTTP, and SQL-backed storage through GraphVault storage targets.
+
+## Install
+
+```bash
+npm install graphvault-studio
+```
+
+The package is ready for npm registry publishing with the CLI binary:
+
+```bash
+npx graphvault-studio --dir ./data --port 4177
+```
+
+## Demo
+
+```bash
+npm ci
+npm run demo:store
+npx graphvault-studio --dir ./graphvault-studio-demo-store --port 4177 --allow-mutations --confirm-token confirm
+```
+
+Open `http://127.0.0.1:4177`.
+
+## Recommended GitHub Topics
+
+`typescript`, `admin-ui`, `developer-tools`, `graph-database`, `object-graph`, `storage-browser`, `database-admin`, `gvql`, `local-first`, `nestjs`

package/docs/REMOTE_STORAGE.md

@@ -0,0 +1,56 @@
+# Remote And Custom Storage
+
+### Remote Or Custom Storage
+
+For remote storage, start Studio programmatically and pass the same `storageTarget` adapter your app uses. `storageDirectory` is still required; for remote targets it acts as the key prefix or logical root path inside the target.
+
+```ts
+import { S3StorageTarget } from "@sprengmeister/graphvault";
+import { startAdminServer } from "graphvault-studio";
+
+await startAdminServer({
+  storageDirectory: "prod/app-store",
+  storageTarget: new S3StorageTarget({
+    bucket: "graphvault-prod",
+    prefix: "stores",
+    client: s3ClientAdapter,
+  }),
+  port: 4177,
+  authToken: process.env.GRAPHVAULT_ADMIN_TOKEN,
+});
+```
+
+HTTP-backed storage works the same way:
+
+```ts
+import { HttpStorageTarget } from "@sprengmeister/graphvault";
+import { startAdminServer } from "graphvault-studio";
+
+await startAdminServer({
+  storageDirectory: "main",
+  storageTarget: new HttpStorageTarget({
+    baseUrl: "https://storage.example.com/graphvault",
+    headers: { authorization: `Bearer ${process.env.STORAGE_TOKEN}` },
+  }),
+  port: 4177,
+});
+```
+
+SQL-backed storage uses an adapter around your database client:
+
+```ts
+import { SqlStorageTarget } from "@sprengmeister/graphvault";
+import { startAdminServer } from "graphvault-studio";
+
+await startAdminServer({
+  storageDirectory: "main",
+  storageTarget: new SqlStorageTarget({
+    client: sqlClientAdapter,
+    tableName: "graphvault_objects",
+    lockTableName: "graphvault_locks",
+  }),
+  port: 4177,
+});
+```
+
+For mutation endpoints, always set `allowMutations: true` and a `mutationConfirmToken`. For exposed or shared environments, also set `authToken`.

package/examples/create-demo-store.mjs

@@ -0,0 +1,85 @@
+import { rm } from "node:fs/promises";
+import { EmbeddedStorage } from "@sprengmeister/graphvault";
+
+class Workspace {
+  constructor(name) {
+    this.name = name;
+    this.documents = [];
+    this.owners = [];
+    this.categories = [];
+  }
+}
+
+class Owner {
+  constructor(id, name, region) {
+    this.id = id;
+    this.name = name;
+    this.region = region;
+  }
+}
+
+class Category {
+  constructor(slug, label) {
+    this.slug = slug;
+    this.label = label;
+  }
+}
+
+class Document {
+  constructor(id, title, owner, category, status, views) {
+    this.id = id;
+    this.title = title;
+    this.owner = owner;
+    this.category = category;
+    this.status = status;
+    this.views = views;
+    this.tags = new Set();
+    this.related = [];
+    this.metrics = { score: views / 100, revisions: Math.max(1, Math.round(views / 30)) };
+    this.createdAt = new Date(1_765_000_000_000 + views * 60_000);
+  }
+}
+
+const storageDirectory = process.argv[2] ?? "./graphvault-studio-demo-store";
+await rm(storageDirectory, { recursive: true, force: true });
+
+const root = new Workspace("GraphVault product docs");
+root.owners.push(new Owner("owner-platform", "Platform Team", "EU"));
+root.owners.push(new Owner("owner-tools", "Developer Tools", "US"));
+root.categories.push(new Category("architecture", "Architecture"));
+root.categories.push(new Category("operations", "Operations"));
+root.categories.push(new Category("admin", "Admin tooling"));
+
+for (let index = 0; index < 36; index++) {
+  const owner = root.owners[index % root.owners.length];
+  const category = root.categories[index % root.categories.length];
+  const status = index % 11 === 0 ? "archived" : index % 5 === 0 ? "review" : "published";
+  const document = new Document(`doc-${String(index + 1).padStart(3, "0")}`, `GraphVault guide ${index + 1}`, owner, category, status, 20 + index * 17);
+  document.tags.add(index % 2 === 0 ? "typescript" : "storage");
+  document.tags.add(category.slug);
+  root.documents.push(document);
+}
+
+for (let index = 1; index < root.documents.length; index++) {
+  root.documents[index].related.push(root.documents[index - 1]);
+  if (index > 4 && index % 4 === 0) {
+    root.documents[index].related.push(root.documents[index - 4]);
+  }
+}
+
+const storage = await EmbeddedStorage.start({
+  storageDirectory,
+  root,
+  types: [
+    { name: "Workspace", ctor: Workspace },
+    { name: "Owner", ctor: Owner },
+    { name: "Category", ctor: Category },
+    { name: "Document", ctor: Document },
+  ],
+});
+
+await storage.storeRoot();
+await storage.shutdown();
+
+console.log(`Demo store created at ${storageDirectory}`);
+console.log("Run: npx graphvault-studio --dir " + storageDirectory + " --port 4177 --allow-mutations --confirm-token confirm");

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "graphvault-studio",
+  "version": "0.1.2",
+  "description": "Graphical admin client for GraphVault object graph stores.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Sprengmeister-dev/graphvault-studio.git"
+  },
+  "homepage": "https://github.com/Sprengmeister-dev/graphvault-studio#readme",
+  "bugs": {
+    "url": "https://github.com/Sprengmeister-dev/graphvault-studio/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/admin.js",
+  "types": "./dist/admin.d.ts",
+  "bin": {
+    "graphvault-studio": "./dist/admin-cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/admin.d.ts",
+      "import": "./dist/admin.js"
+    }
+  },
+  "files": [
+    "assets",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "docs",
+    "dist",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node tests/smoke.mjs",
+    "demo:store": "npm run build && node examples/create-demo-store.mjs",
+    "pack:dry-run": "npm pack --dry-run --cache ./.npm-cache",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "graphvault",
+    "admin-ui",
+    "database-admin",
+    "graph-database",
+    "object-graph",
+    "storage-browser",
+    "typescript",
+    "gvql",
+    "developer-tools"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@sprengmeister/graphvault": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "typescript": "^5.8.3"
+  }
+}