refactor(storex): clean API — hide CASRegistry from consumers

createStoreX now accepts { blobStore, manifestStore } directly.
CASRegistry is created internally — callers never see it.
Only export: createStoreX, StoreX, SPI types, and Memory stores for testing.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: deepracticexs

.changeset/storex-clean-api.md

@@ -0,0 +1,9 @@
+---
+"storexjs": minor
+---
+
+refactor: clean API — accept blobStore/manifestStore instead of CASRegistry
+
+createStoreX now takes { blobStore, manifestStore } directly.
+CASRegistry is created internally — callers never see it.
+Removed CASRegistry from public exports.

packages/storex/src/StoreX.ts

@@ -8,8 +8,8 @@
  * ResourceX is for AI agents (add, resolve, ingest, push, pull).
  */
 
-import type { CASRegistry, RXM, RXR, StoredRXM } from "@resourcexjs/core";
-import { parse } from "@resourcexjs/core";
+import type { RXAStore, RXMStore, StoredRXM } from "@resourcexjs/core";
+import { CASRegistry, parse } from "@resourcexjs/core";
 
 /**
  * File metadata returned by list operations.
@@ -28,8 +28,10 @@ export interface ResourceInfo {
  * StoreX configuration.
  */
 export interface StoreXConfig {
-  /** CASRegistry instance (the storage backend) */
-  registry: CASRegistry;
+  /** Blob storage backend (R2, filesystem, memory, etc.) */
+  blobStore: RXAStore;
+  /** Manifest storage backend (SQLite, D1, memory, etc.) */
+  manifestStore: RXMStore;
 }
 
 /**
@@ -39,7 +41,7 @@ export class StoreX {
   private readonly cas: CASRegistry;
 
   constructor(config: StoreXConfig) {
-    this.cas = config.registry;
+    this.cas = new CASRegistry(config.blobStore, config.manifestStore);
   }
 
   /**

packages/storex/src/index.ts

@@ -5,8 +5,10 @@
  * ResourceX is for AI agents.
  */
 
-// Re-export store SPI types for implementors
+// SPI types — for platform implementors (R2RXAStore, DORXMStore, etc.)
 export type { RXAStore, RXMStore, StoredRXM } from "@resourcexjs/core";
-export { CASRegistry, MemoryRXAStore, MemoryRXMStore } from "@resourcexjs/core";
+// Memory implementations — for testing only
+export { MemoryRXAStore, MemoryRXMStore } from "@resourcexjs/core";
 export type { ResourceInfo, StoreXConfig } from "./StoreX.js";
+// StoreX API
 export { createStoreX, StoreX } from "./StoreX.js";

packages/storex/tests/StoreX.test.ts

@@ -1,26 +1,20 @@
 import { beforeEach, describe, expect, it } from "bun:test";
-import {
-  archive,
-  CASRegistry,
-  MemoryRXAStore,
-  MemoryRXMStore,
-  manifest,
-  resource,
-} from "@resourcexjs/core";
-import { createStoreX, type StoreX } from "../src/index";
+import { archive, manifest, resource } from "@resourcexjs/core";
+import { createStoreX, MemoryRXAStore, MemoryRXMStore, type StoreX } from "../src/index";
 
 describe("StoreX", () => {
   let store: StoreX;
-  let cas: CASRegistry;
 
   beforeEach(() => {
-    cas = new CASRegistry(new MemoryRXAStore(), new MemoryRXMStore());
-    store = createStoreX({ registry: cas });
+    store = createStoreX({
+      blobStore: new MemoryRXAStore(),
+      manifestStore: new MemoryRXMStore(),
+    });
   });
 
   describe("list", () => {
     it("lists all resources", async () => {
-      await cas.put(
+      await store.put(
         resource(
           manifest({ name: "img-pack", type: "binary", tag: "latest" }),
           await archive({ "photo.png": Buffer.from("png-data") })
@@ -35,13 +29,13 @@ describe("StoreX", () => {
     });
 
     it("filters by query", async () => {
-      await cas.put(
+      await store.put(
         resource(
           manifest({ name: "issue-5-files", type: "binary", tag: "latest" }),
           await archive({ "a.png": Buffer.from("a") })
         )
       );
-      await cas.put(
+      await store.put(
         resource(
           manifest({ name: "my-skill", type: "skill", tag: "latest" }),
           await archive({ "SKILL.md": Buffer.from("# Skill") })
@@ -56,7 +50,7 @@ describe("StoreX", () => {
 
   describe("getFile", () => {
     it("retrieves a single file by locator and path", async () => {
-      await cas.put(
+      await store.put(
         resource(
           manifest({ name: "attachments", type: "binary", tag: "latest" }),
           await archive({ "screenshot.png": Buffer.from("image-bytes") })
@@ -68,7 +62,7 @@ describe("StoreX", () => {
     });
 
     it("returns null for non-existent file", async () => {
-      await cas.put(
+      await store.put(
         resource(
           manifest({ name: "attachments", type: "binary", tag: "latest" }),
           await archive({ "a.txt": Buffer.from("a") })
@@ -82,7 +76,7 @@ describe("StoreX", () => {
 
   describe("append", () => {
     it("appends files to an existing resource", async () => {
-      await cas.put(
+      await store.put(
         resource(
           manifest({ name: "issue-3", type: "binary", tag: "latest" }),
           await archive({ "img1.png": Buffer.from("first") })
@@ -105,7 +99,7 @@ describe("StoreX", () => {
 
   describe("getManifest", () => {
     it("returns manifest metadata", async () => {
-      await cas.put(
+      await store.put(
         resource(
           manifest({ name: "docs", type: "text", tag: "1.0.0", description: "My docs" }),
           await archive({ "readme.md": Buffer.from("Hello") })
@@ -126,7 +120,7 @@ describe("StoreX", () => {
 
   describe("has", () => {
     it("returns true for existing resource", async () => {
-      await cas.put(
+      await store.put(
         resource(
           manifest({ name: "exists", type: "text", tag: "latest" }),
           await archive({ "a.txt": Buffer.from("a") })
@@ -157,7 +151,7 @@ describe("StoreX", () => {
 
   describe("remove", () => {
     it("removes a resource", async () => {
-      await cas.put(
+      await store.put(
         resource(
           manifest({ name: "temp", type: "text", tag: "latest" }),
           await archive({ "a.txt": Buffer.from("a") })