@jxsuite/catalog 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kevin Shenk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/catalog.json

@@ -0,0 +1,73 @@
+[
+  {
+    "description": "Better Auth sessions, sign-in flows, and table permissions served over /_jx/auth",
+    "docs": "/docs/extending/extensions/first-party#jxsuiteauth-sessions-and-permissions",
+    "name": "@jxsuite/auth",
+    "sections": [
+      {
+        "key": "auth",
+        "title": "Authentication"
+      }
+    ],
+    "title": "Authentication",
+    "requires": [
+      "@jxsuite/connector"
+    ]
+  },
+  {
+    "description": "Database connections and dynamic data tables served over /_jx/data",
+    "docs": "/docs/extending/extensions/first-party#jxsuiteconnector-connections-and-data-tables",
+    "name": "@jxsuite/connector",
+    "sections": [
+      {
+        "key": "connections",
+        "title": "Connections"
+      },
+      {
+        "key": "data",
+        "title": "Data Tables"
+      }
+    ],
+    "title": "Data & Connections"
+  },
+  {
+    "description": "Atom (RFC 4287) and JSON Feed generation from content collections, with RFC 5005 archives and automatic <link rel=\"alternate\"> discovery",
+    "docs": "/docs/extending/extensions/first-party#jxsuitefeed-syndication-feeds",
+    "name": "@jxsuite/feed",
+    "sections": [
+      {
+        "key": "feed",
+        "title": "Feeds"
+      }
+    ],
+    "title": "Feeds"
+  },
+  {
+    "description": "File-based content collections with Markdown and CSV formats",
+    "docs": "/docs/extending/extensions/first-party#jxsuiteparser-content-and-markdown",
+    "name": "@jxsuite/parser",
+    "sections": [
+      {
+        "key": "content",
+        "title": "Content Types"
+      }
+    ],
+    "title": "Content & Markdown",
+    "formats": [
+      ".csv",
+      ".md"
+    ]
+  },
+  {
+    "description": "Build-time search index emission from content collections (MiniSearch) with section-level deep links and a headless browser client",
+    "docs": "/docs/extending/extensions/first-party#jxsuitesearch-build-time-site-search",
+    "name": "@jxsuite/search",
+    "sections": [
+      {
+        "key": "search",
+        "title": "Site Search"
+      }
+    ],
+    "title": "Search"
+  }
+]

package/index.ts

@@ -0,0 +1,84 @@
+/*
+ * Extension catalogue — the first-party Jx extensions a project can turn on, as data.
+ *
+ * This module is metadata-only, and deliberately so: it names `@jxsuite/parser` and its four
+ * siblings without importing any of them, so core never gains a dependency edge on `extensions/*`
+ * (specs/extensions.md §2, enforced by scripts/check-dep-rules.ts).
+ *
+ * `catalog.json` is a BUILD OUTPUT, generated from every `extensions/<name>/jx-extension.json` and
+ * the class descriptors it points at. `bun run catalog:verify` is the gate and `bun run
+ * catalog:sync` is the fixer; never hand-edit it, because the next sync overwrites the edit.
+ *
+ * ## What is NOT here, and why
+ *
+ * **No version, and no semver range.** `packages/studio/src/settings/dependencies-editor.ts`
+ * records what that costs: `@jxsuite/*` rows once targeted the version the Studio build embedded,
+ * which "proposed a version that may never have been published, for a package whose real latest
+ * the table had not looked at". The five extensions release on five independent cadences, and a
+ * catalogue frozen inside a packaged desktop app is strictly worse than the bug already fixed —
+ * it is read months after it was written, and release-please writes a version into package.json
+ * before npm publish completes, so a pinned range here can name a version that never shipped.
+ * `addPackage(name)` already means "latest", resolved at install time. A test asserts this
+ * absence by name.
+ *
+ * **No `bundled`, `installed`, `source` or `problem`.** Those are per-host or per-project facts,
+ * answered by whichever backend serves the catalogue — which is the whole reason the catalogue is
+ * a platform capability rather than a constant. A Worker ships a fixed set of extension packages
+ * (specs/extensions.md §5.5), and a desktop build ships another; neither is knowable from here.
+ */
+
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+
+/** One project.json section an extension's classes claim (specs/extensions.md §9). */
+export interface CatalogSection {
+  /** The project.json top-level property, e.g. "content". */
+  key: string;
+  /** The owning class's `project.title`, e.g. "Content Types". */
+  title?: string;
+}
+
+/** One first-party extension, as the generator derives it from the package's own manifest. */
+export interface ExtensionCatalogMeta {
+  /** Package name — the identity, the project.json entry, and the `bun add` argument. */
+  name: string;
+  /** Manifest `title`, for studio surfaces. */
+  title: string;
+  /** Manifest `description`, one line. */
+  description: string;
+  /** The project.json sections enabling it makes legal, in class declaration order. */
+  sections: CatalogSection[];
+  /** File extensions its format classes claim (".md", ".csv"), when it claims any. */
+  formats?: string[];
+  /** Other catalogue members it depends on — auth needs connector. */
+  requires?: string[];
+  /** Documentation page for this extension. */
+  docs: string;
+}
+
+const CATALOG_DIR = import.meta.dirname;
+
+let _cache: ExtensionCatalogMeta[] | null = null;
+
+/**
+ * Read and cache the shipped catalogue.
+ *
+ * @returns {ExtensionCatalogMeta[]}
+ */
+export function listCatalog(): ExtensionCatalogMeta[] {
+  if (!_cache) {
+    const raw = readFileSync(join(CATALOG_DIR, "catalog.json"), "utf8");
+    _cache = JSON.parse(raw) as ExtensionCatalogMeta[];
+  }
+  return _cache;
+}
+
+/**
+ * One entry by package name, or `undefined`.
+ *
+ * @param {string} name
+ * @returns {ExtensionCatalogMeta | undefined}
+ */
+export function getCatalogEntry(name: string): ExtensionCatalogMeta | undefined {
+  return listCatalog().find((entry) => entry.name === name);
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@jxsuite/catalog",
+  "version": "0.1.0",
+  "description": "The catalogue of first-party Jx extensions a project can turn on",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jxsuite/jx.git",
+    "directory": "packages/catalog"
+  },
+  "files": [
+    "index.ts",
+    "catalog.json"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./index.ts",
+    "./catalog.json": "./catalog.json"
+  },
+  "publishConfig": {
+    "provenance": false
+  },
+  "scripts": {
+    "test": "bun test --isolate",
+    "test:coverage": "bun test --isolate --coverage"
+  }
+}