@exellix/catalox-graphs 1.2.9 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.3.0 — 2026-06-25
+
+### Breaking
+
+- **Layer split:** HTTP BFF and browser/React moved to sibling packages:
+  - `@exellix/catalox-graphs-http` — `registerCataloxGraphRoutes`
+  - `@exellix/catalox-graphs-ui` — `cataloxApi`, `CataloxGraphPicker`, `useCataloxGraphs`
+- Removed subpath exports `./http`, `./browser`, `./react` from this package.
+- This package is now **Node data tier only** (stores, loaders, Catalox runtime).
+
 ## 1.2.9 — 2026-06-24
 
 ### Added

package/README.md

@@ -1,17 +1,24 @@
 # @exellix/catalox-graphs
 
-Shared Catalox data tier for **graphs-studio**, **jobs-api**, and **jobs-ui**: graph catalog CRUD, version checkpoints, templates, execute-time loading, HTTP proxy routes, browser client, and `CataloxGraphPicker`.
+Node data tier for Catalox graph catalogs: CRUD stores, version checkpoints, templates, execute-time loaders, and readiness probes.
 
 **Authoritative store:** Catalox catalog `graphs` (full `AuthoringGraphDocument`). Mongo `exellix.graphs` is matrix id-registry only.
 
+Related packages (split by layer):
+
+| Package | Layer |
+|---------|-------|
+| `@exellix/catalox-graphs` | **Data tier** — stores, loaders, Catalox runtime (this package) |
+| `@exellix/catalox-graphs-http` | **HTTP BFF** — Fastify `/api/catalox/*` routes |
+| `@exellix/catalox-graphs-ui` | **Browser + React** — fetch client, `CataloxGraphPicker` |
+
 ## Exports
 
 | Import | Use |
 |--------|-----|
-| `@exellix/catalox-graphs` | Server stores, `createCataloxGraphDocumentLoader` / `createExecuteGraphLoader`, readiness |
-| `@exellix/catalox-graphs/http` | Fastify route registrar (`/api/catalox/*`) |
-| `@exellix/catalox-graphs/browser` | Browser fetch client |
-| `@exellix/catalox-graphs/react` | `CataloxGraphPicker`, `useCataloxGraphs` |
+| `@exellix/catalox-graphs` | `saveGraphToCatalox`, `loadGraphFromCatalox`, `createExecuteGraphLoader`, stores, types |
+
+For HTTP routes use `@exellix/catalox-graphs-http`. For browser/React use `@exellix/catalox-graphs-ui`.
 
 ## Env
 
@@ -25,10 +32,11 @@ Same Firebase / Catalox vars as graphs-studio:
 
 ## HTTP routes
 
-Mount with:
+Mount BFF from the sibling package:
 
 ```ts
-import { registerCataloxGraphRoutes } from '@x12i/catalox-graphs/http';
+import { registerCataloxGraphRoutes } from '@exellix/catalox-graphs-http';
+
 await registerCataloxGraphRoutes(app, { prefix: '/api/catalox' });
 ```
 
@@ -44,7 +52,7 @@ Key endpoints:
 ## React picker
 
 ```tsx
-import { CataloxGraphPicker } from '@x12i/catalox-graphs/react';
+import { CataloxGraphPicker } from '@exellix/catalox-graphs-ui/react';
 
 <CataloxGraphPicker
   value={graphId}
@@ -55,17 +63,6 @@ import { CataloxGraphPicker } from '@x12i/catalox-graphs/react';
 />
 ```
 
-Studio load mode:
-
-```tsx
-<CataloxGraphPicker
-  onLoad={async (result) => {
-    if (!result.ok) return;
-    applyImportedGraph(result.graph, { versionSource: 'catalox', forceApply: true });
-  }}
-/>
-```
-
 ## graphs-studio integration
 
 See [docs/STUDIO_INTEGRATION.md](./docs/STUDIO_INTEGRATION.md). Pair with [`@x12i/memorix-mongo`](../memorix-mongo/docs/STUDIO_INTEGRATION.md) for job memory context.
@@ -76,3 +73,30 @@ See [docs/STUDIO_INTEGRATION.md](./docs/STUDIO_INTEGRATION.md). Pair with [`@x12
 - `graph-versions` — version checkpoints
 - `graph-templates` — saved/system templates
 - `graph-concepts` — legacy concept rows (dual-write optional in studio)
+
+## Migration from 1.2.x
+
+Subpath exports moved to dedicated packages:
+
+| Before | After |
+|--------|-------|
+| `@exellix/catalox-graphs/http` | `@exellix/catalox-graphs-http` |
+| `@exellix/catalox-graphs/browser` | `@exellix/catalox-graphs-ui` |
+| `@exellix/catalox-graphs/react` | `@exellix/catalox-graphs-ui/react` |
+
+## Publish
+
+Requires root `.npmrc` with your npm token (copy from `.npmrc.example` at repo root).
+
+```bash
+# This package only
+cd catalox-graphs && npm run publish
+
+# Plan without publishing
+npm run publish:dry
+
+# All three catalox packages in order (graphs → http → ui)
+node ../scripts/publish-all.mjs --packages catalox-graphs,catalox-graphs-http,catalox-graphs-ui --no-bump
+```
+
+From repo root: `npm run publish:all` publishes the full core chain in dependency order.

package/dist/client/catalox-runtime.d.ts

@@ -1,4 +1,6 @@
 import type { CataloxBound } from '@x12i/catalox/embedder';
+/** Share one Catalox/Firebase bound with Memorix retrieval (avoids double Firebase init). */
+export declare function seedCataloxBound(preloaded: CataloxBound): void;
 export declare function resetCataloxRuntimeCache(): void;
 export declare function getCataloxBound(): Promise<CataloxBound>;
 //# sourceMappingURL=catalox-runtime.d.ts.map

package/dist/client/catalox-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalox-runtime.d.ts","sourceRoot":"","sources":["../../src/client/catalox-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAY3D,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAoB7D"}
+{"version":3,"file":"catalox-runtime.d.ts","sourceRoot":"","sources":["../../src/client/catalox-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAY3D,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,CAG9D;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAoB7D"}

package/dist/client/catalox-runtime.js

@@ -3,6 +3,11 @@ import { createCataloxFromEnv } from '@x12i/catalox/firebase';
 import { cataloxContextFromEnv, readCataloxAppId, readCataloxStoreId, } from '../config/catalox-context-from-env.js';
 let bound = null;
 let init = null;
+/** Share one Catalox/Firebase bound with Memorix retrieval (avoids double Firebase init). */
+export function seedCataloxBound(preloaded) {
+    bound = preloaded;
+    init = Promise.resolve(preloaded);
+}
 export function resetCataloxRuntimeCache() {
     bound = null;
     init = null;

package/dist/client/catalox-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalox-runtime.js","sourceRoot":"","sources":["../../src/client/catalox-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uCAAuC,CAAC;AAE/C,IAAI,KAAK,GAAwB,IAAI,CAAC;AACtC,IAAI,IAAI,GAAiC,IAAI,CAAC;AAE9C,MAAM,UAAU,wBAAwB;IACtC,KAAK,GAAG,IAAI,CAAC;IACb,IAAI,GAAG,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE;YACjB,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;YAClF,CAAC;YACD,MAAM,EAAE,OAAO,EAAE,GAAG,oBAAoB,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG;gBACV,KAAK;gBACL,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,GAAG,qBAAqB,EAAE;aAC3B,CAAC;YACF,KAAK,GAAG,kBAAkB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,EAAE,CAAC;IACP,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"catalox-runtime.js","sourceRoot":"","sources":["../../src/client/catalox-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uCAAuC,CAAC;AAE/C,IAAI,KAAK,GAAwB,IAAI,CAAC;AACtC,IAAI,IAAI,GAAiC,IAAI,CAAC;AAE9C,6FAA6F;AAC7F,MAAM,UAAU,gBAAgB,CAAC,SAAuB;IACtD,KAAK,GAAG,SAAS,CAAC;IAClB,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,KAAK,GAAG,IAAI,CAAC;IACb,IAAI,GAAG,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE;YACjB,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;YAClF,CAAC;YACD,MAAM,EAAE,OAAO,EAAE,GAAG,oBAAoB,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG;gBACV,KAAK;gBACL,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,GAAG,qBAAqB,EAAE;aAC3B,CAAC;YACF,KAAK,GAAG,kBAAkB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,EAAE,CAAC;IACP,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { CATALOG_IDS, DEFAULT_LIST_LIMIT, GRAPH_VERSION_HISTORY_MAX } from './config/catalog-ids.js';
 export { cataloxContextFromEnv, hasFirebaseCredentials, readCataloxAppId, readCataloxStoreId, type CataloxServiceContext, } from './config/catalox-context-from-env.js';
-export { getCataloxBound, resetCataloxRuntimeCache } from './client/catalox-runtime.js';
+export { getCataloxBound, resetCataloxRuntimeCache, seedCataloxBound } from './client/catalox-runtime.js';
 export { listCatalogItems, getCatalogItem, upsertCatalogItem, deleteCatalogItem, type CatalogListResponse, type CatalogGetResponse, type CatalogWriteResponse, } from './client/catalox-api.js';
 export { probeCataloxReady, invalidateCataloxReadyCache, type CataloxReadyStatus } from './readiness.js';
 export { listGraphsFromCatalox, loadGraphFromCatalox, saveGraphToCatalox, deleteGraphFromCatalox, listCompatibleGraphsFromCatalox, graphProjectSummaryFromItem, buildGraphProjectDocument, graphToCatalogPayload, readGraphFromProjectData, readAuthoringGraphFromProjectData, type CompatibleGraphFromCatalox, type ReadAuthoringGraphResult, } from './stores/graph-store.js';
@@ -12,5 +12,4 @@ export { saveGraphVersionToCatalox, loadGraphVersionFromCatalox, listGraphVersio
 export { listGraphTemplatesFromCatalox, getGraphTemplateFromCatalox, saveGraphTemplateToCatalox, deleteGraphTemplateFromCatalox, type GraphTemplateSummary, } from './stores/graph-template-store.js';
 export { loadConceptFromCatalox, saveConceptToCatalox, deleteConceptFromCatalox, } from './stores/concept-store.js';
 export type { GraphProjectSummary, GraphProjectDocument, LoadGraphResult, SaveGraphOptions, GraphVersionPayload, GraphTemplatePayload, CataloxGraphErrorCode, } from './types/graph-project.js';
-export { registerCataloxGraphRoutes, type RegisterCataloxGraphRoutesOptions } from './http/register-routes.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACrG,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,qBAAqB,GAC3B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACxF,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzG,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,+BAA+B,EAC/B,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,iCAAiC,EACjC,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAC;AAE7F,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,GACrC,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,wCAAwC,EACxC,2BAA2B,EAC3B,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,GACjC,MAAM,6CAA6C,CAAC;AAErD,OAAO,EACL,gCAAgC,EAChC,wBAAwB,EACxB,KAAK,uCAAuC,EAC5C,KAAK,uBAAuB,GAC7B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,EAC9B,KAAK,oBAAoB,GAC1B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,0BAA0B,EAAE,KAAK,iCAAiC,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACrG,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,qBAAqB,GAC3B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC1G,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzG,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,+BAA+B,EAC/B,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,iCAAiC,EACjC,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAC;AAE7F,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,GACrC,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,wCAAwC,EACxC,2BAA2B,EAC3B,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,GACjC,MAAM,6CAA6C,CAAC;AAErD,OAAO,EACL,gCAAgC,EAChC,wBAAwB,EACxB,KAAK,uCAAuC,EAC5C,KAAK,uBAAuB,GAC7B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,EAC9B,KAAK,oBAAoB,GAC1B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 export { CATALOG_IDS, DEFAULT_LIST_LIMIT, GRAPH_VERSION_HISTORY_MAX } from './config/catalog-ids.js';
 export { cataloxContextFromEnv, hasFirebaseCredentials, readCataloxAppId, readCataloxStoreId, } from './config/catalox-context-from-env.js';
-export { getCataloxBound, resetCataloxRuntimeCache } from './client/catalox-runtime.js';
+export { getCataloxBound, resetCataloxRuntimeCache, seedCataloxBound } from './client/catalox-runtime.js';
 export { listCatalogItems, getCatalogItem, upsertCatalogItem, deleteCatalogItem, } from './client/catalox-api.js';
 export { probeCataloxReady, invalidateCataloxReadyCache } from './readiness.js';
 export { listGraphsFromCatalox, loadGraphFromCatalox, saveGraphToCatalox, deleteGraphFromCatalox, listCompatibleGraphsFromCatalox, graphProjectSummaryFromItem, buildGraphProjectDocument, graphToCatalogPayload, readGraphFromProjectData, readAuthoringGraphFromProjectData, } from './stores/graph-store.js';
@@ -11,5 +11,4 @@ export { createCataloxGraphDocumentLoader, createExecuteGraphLoader, } from './s
 export { saveGraphVersionToCatalox, loadGraphVersionFromCatalox, listGraphVersionsFromCatalox, deleteGraphVersionFromCatalox, pruneGraphVersionsBeyondLimit, graphVersionItemId, parseGraphVersionItemId, } from './stores/graph-version-store.js';
 export { listGraphTemplatesFromCatalox, getGraphTemplateFromCatalox, saveGraphTemplateToCatalox, deleteGraphTemplateFromCatalox, } from './stores/graph-template-store.js';
 export { loadConceptFromCatalox, saveConceptToCatalox, deleteConceptFromCatalox, } from './stores/concept-store.js';
-export { registerCataloxGraphRoutes } from './http/register-routes.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACrG,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACxF,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAIlB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAA2B,MAAM,gBAAgB,CAAC;AAEzG,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,+BAA+B,EAC/B,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,iCAAiC,GAGlC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAC;AAE7F,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,GACrC,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,wCAAwC,EACxC,2BAA2B,EAC3B,+BAA+B,GAIhC,MAAM,6CAA6C,CAAC;AAErD,OAAO,EACL,gCAAgC,EAChC,wBAAwB,GAGzB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,GAE/B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAYnC,OAAO,EAAE,0BAA0B,EAA0C,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACrG,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC1G,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAIlB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAA2B,MAAM,gBAAgB,CAAC;AAEzG,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,+BAA+B,EAC/B,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,iCAAiC,GAGlC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAC;AAE7F,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,GACrC,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,wCAAwC,EACxC,2BAA2B,EAC3B,+BAA+B,GAIhC,MAAM,6CAA6C,CAAC;AAErD,OAAO,EACL,gCAAgC,EAChC,wBAAwB,GAGzB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,GAE/B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC"}

package/docs/STUDIO_INTEGRATION.md

@@ -3,24 +3,30 @@
 **Single source of truth:** executable graph documents live in the Catalox `graphs` catalog only.  
 Do not duplicate save/load logic or persist full graphs to Mongo `exellix.graphs` (matrix id-registry only).
 
-## Package
+## Packages
 
-`@exellix/catalox-graphs` — use this for **all** graph catalog CRUD, listing, and execute-time loading.
+| Layer | Package |
+|-------|---------|
+| Data tier (Node) | `@exellix/catalox-graphs` |
+| HTTP BFF | `@exellix/catalox-graphs-http` |
+| Browser + React | `@exellix/catalox-graphs-ui` |
+
+Use `@exellix/catalox-graphs` for **all** server-side graph catalog CRUD, listing, and execute-time loading.
 
 ## Required studio integration
 
-| Concern | Use from `@exellix/catalox-graphs` | Do not |
-|---------|-----------------------------------|--------|
+| Concern | Use | Do not |
+|---------|-----|--------|
 | Save / load graph | `saveGraphToCatalox`, `loadGraphFromCatalox` | Inline Catalox SDK calls, duplicate HTTP |
-| List / picker | `listGraphsFromCatalox`, `CataloxGraphPicker`, `useCataloxGraphs` | Separate graph list API |
+| List / picker | `CataloxGraphPicker`, `useCataloxGraphs` (`@exellix/catalox-graphs-ui/react`) | Separate graph list API |
 | Execute / compile load | `createCataloxGraphDocumentLoader` or `createExecuteGraphLoader` | Mongo `exellix.graphs` documents |
-| Versions / templates | `saveGraphVersionToCatalox`, `listGraphTemplatesFromCatalox`, HTTP routes | Ad-hoc catalog writes |
+| Versions / templates | store functions from `@exellix/catalox-graphs`, HTTP from `@exellix/catalox-graphs-http` | Ad-hoc catalog writes |
 | HTTP BFF | `registerCataloxGraphRoutes(app, { prefix: '/api/catalox' })` | Re-implement `/api/catalox/*` |
 
 ### Server (BFF)
 
 ```ts
-import { registerCataloxGraphRoutes } from '@exellix/catalox-graphs/http';
+import { registerCataloxGraphRoutes } from '@exellix/catalox-graphs-http';
 
 await registerCataloxGraphRoutes(app, { prefix: '/api/catalox' });
 ```
@@ -28,8 +34,8 @@ await registerCataloxGraphRoutes(app, { prefix: '/api/catalox' });
 ### Browser / React
 
 ```ts
-import { cataloxApi } from '@exellix/catalox-graphs/browser';
-import { CataloxGraphPicker, useCataloxGraphs } from '@exellix/catalox-graphs/react';
+import { cataloxApi } from '@exellix/catalox-graphs-ui';
+import { CataloxGraphPicker, useCataloxGraphs } from '@exellix/catalox-graphs-ui/react';
 ```
 
 ### Save path
@@ -46,7 +52,7 @@ Studio-only metadata (examples, `graphsStudio` UI blobs) stays in the **graphs-s
 
 | Concern | Package |
 |---------|---------|
-| Graph catalog, versions, templates | `@exellix/catalox-graphs` |
+| Graph catalog, versions, templates | `@exellix/catalox-graphs` (+ HTTP/UI siblings) |
 | Context query types, resolution, source reads | `@x12i/memorix-mongo` |
 
 See [`@x12i/memorix-mongo` STUDIO_INTEGRATION.md](../../memorix-mongo/docs/STUDIO_INTEGRATION.md).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@exellix/catalox-graphs",
-  "version": "1.2.9",
-  "description": "Catalox graph catalog data tier: CRUD for graphs, versions, templates, and shared React picker.",
+  "version": "1.3.0",
+  "description": "Catalox graph catalog data tier (Node): CRUD stores, document loaders, and readiness probes.",
   "type": "module",
   "engines": {
     "node": ">=20"
@@ -16,18 +16,6 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    },
-    "./http": {
-      "types": "./dist/http/register-routes.d.ts",
-      "import": "./dist/http/register-routes.js"
-    },
-    "./browser": {
-      "types": "./dist/browser/catalox-api-client.d.ts",
-      "import": "./dist/browser/catalox-api-client.js"
-    },
-    "./react": {
-      "types": "./dist/react/index.d.ts",
-      "import": "./dist/react/index.js"
     }
   },
   "files": [
@@ -37,9 +25,11 @@
     "docs"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && tsc -p tsconfig.react.json",
+    "build": "tsc -p tsconfig.build.json",
     "clean": "node -e \"import('node:fs').then(fs=>fs.promises.rm('dist',{recursive:true,force:true}))\"",
     "prepack": "npm run build",
+    "publish": "node ../scripts/publish-package.mjs",
+    "publish:dry": "node ../scripts/publish-package.mjs --dry-run",
     "test": "vitest run",
     "test:watch": "vitest",
     "patch:graphs-graphid-index": "node scripts/patch-graphs-catalog-graphid-index.mjs"
@@ -52,9 +42,6 @@
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
-    "@types/react": "^19.2.17",
-    "fastify": "^5.8.5",
-    "react": "^19.2.7",
     "typescript": "^5.7.2",
     "vitest": "^3.0.0"
   },