@jchat/addon-sdk 1.0.0-alpha.30 → 1.0.0-alpha.31

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { _ as hasPermission, a as useAddonSDK, c as useAddonInfiniteQuery, d as useQueryClient, f as AbilityBuilder, g as createMongoAbility, h as createAddonAbility, i as getAddonSdkVersion, l as useAddonMutation, m as authorizeResourceOwnership, n as defineAddonManifest, o as verifyAddonEntitlement, p as ForbiddenError, r as defineAddonServer, s as createMockAddonServerContext, t as AddonPipelineAbortError, u as useAddonQuery, v as subject } from "./src.mjs";
+import { _ as createMongoAbility, a as useAddonSDK, c as useAddonInfiniteQuery, d as useAddonSettings, f as useQueryClient, g as createAddonAbility, h as authorizeResourceOwnership, i as getAddonSdkVersion, l as useAddonMutation, m as ForbiddenError, n as defineAddonManifest, o as verifyAddonEntitlement, p as AbilityBuilder, r as defineAddonServer, s as createMockAddonServerContext, t as AddonPipelineAbortError, u as useAddonQuery, v as hasPermission, y as subject } from "./src.mjs";
 import { HOST_LOCALES, MOUNT_POINTS } from "./contracts.mjs";
 import { i as useTranslation, n as createTranslator, r as useLocale, t as LocaleContext } from "./i18n.mjs";
 import { ADDON_ID_PATTERN, COMPATIBILITY_RANGE_PATTERN, MAX_ADDON_ARCHIVE_BYTES, assertSafeRelativePath, canonicalManifest, createCanonicalAddonDigest, isCompatibilityRange, sortValue, validateAddonManifest } from "./signing.mjs";
-export { ADDON_ID_PATTERN, AbilityBuilder, AddonPipelineAbortError, COMPATIBILITY_RANGE_PATTERN, ForbiddenError, HOST_LOCALES, LocaleContext, MAX_ADDON_ARCHIVE_BYTES, MOUNT_POINTS, assertSafeRelativePath, authorizeResourceOwnership, canonicalManifest, createAddonAbility, createCanonicalAddonDigest, createMockAddonServerContext, createMongoAbility, createTranslator, defineAddonManifest, defineAddonServer, getAddonSdkVersion, hasPermission, isCompatibilityRange, sortValue, subject, useAddonInfiniteQuery, useAddonMutation, useAddonQuery, useAddonSDK, useLocale, useQueryClient, useTranslation, validateAddonManifest, verifyAddonEntitlement };
+export { ADDON_ID_PATTERN, AbilityBuilder, AddonPipelineAbortError, COMPATIBILITY_RANGE_PATTERN, ForbiddenError, HOST_LOCALES, LocaleContext, MAX_ADDON_ARCHIVE_BYTES, MOUNT_POINTS, assertSafeRelativePath, authorizeResourceOwnership, canonicalManifest, createAddonAbility, createCanonicalAddonDigest, createMockAddonServerContext, createMongoAbility, createTranslator, defineAddonManifest, defineAddonServer, getAddonSdkVersion, hasPermission, isCompatibilityRange, sortValue, subject, useAddonInfiniteQuery, useAddonMutation, useAddonQuery, useAddonSDK, useAddonSettings, useLocale, useQueryClient, useTranslation, validateAddonManifest, verifyAddonEntitlement };

package/dist/src.mjs

@@ -2,7 +2,7 @@ import "./i18n.mjs";
 import { AbilityBuilder, createMongoAbility, subject } from "@casl/ability";
 import { useInfiniteQuery, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 //#region package.json
-var version = "1.0.0-alpha.30";
+var version = "1.0.0-alpha.31";
 //#endregion
 //#region src/permissions.ts
 /**
@@ -192,6 +192,30 @@ function useAddonMutation(options) {
 		}
 	});
 }
+/**
+* Ergonomic hook for loading and updating site configuration for an addon. Handles fetching,
+* caching, pending states, and automatic query cache invalidation.
+*/
+function useAddonSettings(siteId) {
+	const sdk = useAddonSDK();
+	const query = useAddonQuery({
+		queryKey: ["settings", siteId],
+		queryFn: () => sdk.settings.get()
+	});
+	const mutation = useAddonMutation({
+		mutationFn: (settings) => sdk.settings.save(settings),
+		invalidateQueries: [["settings", siteId]]
+	});
+	return {
+		settings: query.data ?? null,
+		isLoading: query.isLoading,
+		isSaving: mutation.isPending,
+		error: query.error ?? mutation.error,
+		saveSettings: mutation.mutate,
+		saveSettingsAsync: mutation.mutateAsync,
+		refetch: query.refetch
+	};
+}
 //#endregion
 //#region src/testing.ts
 /**
@@ -334,6 +358,7 @@ function createMockAddonServerContext(addonId, options = {}) {
 			} },
 			getConfig: async (_targetSiteId) => config,
 			getUser: async (userId) => userId === defaultUser.id ? defaultUser : null,
+			findUserByName: async (name) => name === defaultUser.name ? defaultUser : null,
 			getUsers: async (userIds) => {
 				const map = /* @__PURE__ */ new Map();
 				for (const id of userIds) if (id === defaultUser.id) map.set(id, defaultUser);
@@ -465,4 +490,4 @@ function verifyAddonEntitlement(addonId, target) {
 	return true;
 }
 //#endregion
-export { hasPermission as _, useAddonSDK as a, useAddonInfiniteQuery as c, useQueryClient as d, AbilityBuilder as f, createMongoAbility as g, createAddonAbility as h, getAddonSdkVersion as i, useAddonMutation as l, authorizeResourceOwnership as m, defineAddonManifest as n, verifyAddonEntitlement as o, ForbiddenError as p, defineAddonServer as r, createMockAddonServerContext as s, AddonPipelineAbortError as t, useAddonQuery as u, subject as v };
+export { createMongoAbility as _, useAddonSDK as a, useAddonInfiniteQuery as c, useAddonSettings as d, useQueryClient as f, createAddonAbility as g, authorizeResourceOwnership as h, getAddonSdkVersion as i, useAddonMutation as l, ForbiddenError as m, defineAddonManifest as n, verifyAddonEntitlement as o, AbilityBuilder as p, defineAddonServer as r, createMockAddonServerContext as s, AddonPipelineAbortError as t, useAddonQuery as u, hasPermission as v, subject as y };

package/dist/testing.d.mts

@@ -1,2 +1,2 @@
-import { MockAddonContextResult, MockAddonServerContextOptions, createMockAddonServerContext } from "./index2.mjs";
+import { MockAddonContextResult, MockAddonServerContextOptions, createMockAddonServerContext } from "./index.mjs";
 export { MockAddonContextResult, MockAddonServerContextOptions, createMockAddonServerContext };

package/dist/ui.d.mts

@@ -1,5 +1,6 @@
 import { _ as AddonUser, d as AddonRequestUser } from "./contracts2.mjs";
 import React from "react";
+import ui_default from "@jchat/ui";
 import { Can } from "@casl/react";
 export * from "@jchat/ui";
 //#region src/ui.d.ts
@@ -38,5 +39,10 @@ export interface AddonCanProps {
  * @param children Content rendered when access is granted
  */
 export declare function AddonCan({ actor, ownerId, ownPermission, anyPermission, permission, fallback, children }: AddonCanProps): React.ReactElement | null;
+/** Standard loading spinner for addon settings views. */
+export declare function AddonSettingsLoading({ message, className }: {
+  message?: string;
+  className?: string;
+}): React.ReactElement;
 //#endregion
-export { Can };
+export { Can, ui_default as default };

package/dist/ui.mjs

@@ -1,4 +1,6 @@
-import { _ as hasPermission } from "./src.mjs";
+import { v as hasPermission } from "./src.mjs";
+import React from "react";
+import ui_default from "@jchat/ui";
 import { Can } from "@casl/react";
 export * from "@jchat/ui";
 //#region src/ui.ts
@@ -29,5 +31,9 @@ function AddonCan({ actor, ownerId, ownPermission, anyPermission, permission, fa
 	}
 	return children;
 }
+/** Standard loading spinner for addon settings views. */
+function AddonSettingsLoading({ message = "Loading configuration...", className }) {
+	return React.createElement("div", { className: "flex items-center justify-center p-8 text-sm text-muted-foreground" + (className ? ` ${className}` : "") }, React.createElement("span", { className: "me-2 inline-block size-4 animate-spin rounded-full border-2 border-primary border-t-transparent" }), message);
+}
 //#endregion
-export { AddonCan, Can };
+export { AddonCan, AddonSettingsLoading, Can, ui_default as default };

package/dist/vite.mjs

@@ -60,8 +60,7 @@ function jchatAddon(options) {
 								"@tanstack/react-query",
 								"@jchat/addon-sdk",
 								"@jchat/addon-sdk/state",
-								"@jchat/addon-sdk/ui",
-								"@jchat/addon-sdk/icon"
+								"@jchat/addon-sdk/ui"
 							],
 							output: { format: "esm" }
 						}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jchat/addon-sdk",
-  "version": "1.0.0-alpha.30",
+  "version": "1.0.0-alpha.31",
   "private": false,
   "description": "JChat Addon SDK for building JChat addons.",
   "keywords": [
@@ -19,6 +19,7 @@
   },
   "files": [
     "dist",
+    "src/tailwind.css",
     "tsconfig.addon.json",
     "skills",
     "README.md",
@@ -70,25 +71,16 @@
       "default": "./src/i18n-validator.ts"
     },
     "./ui": {
+      "style": "./src/tailwind.css",
       "types": "./src/ui.ts",
       "import": "./src/ui.ts",
       "default": "./src/ui.ts"
     },
-    "./icon": {
-      "types": "./src/icon.ts",
-      "import": "./src/icon.ts",
-      "default": "./src/icon.ts"
-    },
     "./state": {
       "types": "./src/state.ts",
       "import": "./src/state.ts",
       "default": "./src/state.ts"
     },
-    "./ui/tailwind.css": {
-      "style": "./src/tailwind.css",
-      "import": "./src/tailwind.css",
-      "default": "./src/tailwind.css"
-    },
     "./tsconfig.json": "./tsconfig.addon.json"
   },
   "publishConfig": {
@@ -128,22 +120,14 @@
         "import": "./dist/i18n-validator.mjs"
       },
       "./ui": {
+        "style": "./src/tailwind.css",
         "types": "./dist/ui.d.mts",
         "import": "./dist/ui.mjs"
       },
-      "./icon": {
-        "types": "./dist/icon.d.mts",
-        "import": "./dist/icon.mjs"
-      },
       "./state": {
         "types": "./dist/state.d.mts",
         "import": "./dist/state.mjs"
       },
-      "./ui/tailwind.css": {
-        "style": "./src/tailwind.css",
-        "import": "./src/tailwind.css",
-        "default": "./src/tailwind.css"
-      },
       "./tsconfig.json": "./tsconfig.addon.json"
     },
     "access": "public"
@@ -153,7 +137,7 @@
     "lint": "oxlint .",
     "format": "oxfmt . --write",
     "test": "bun test",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "bun check"
   },
   "dependencies": {
     "@casl/ability": "catalog:",
@@ -161,7 +145,6 @@
     "lucide-react": "catalog:"
   },
   "devDependencies": {
-    "@jchat/icon": "workspace:*",
     "@jchat/ui": "workspace:*",
     "@tailwindcss/vite": "catalog:",
     "@tanstack/react-query": "catalog:",
@@ -169,7 +152,7 @@
     "@types/react": "catalog:",
     "elysia": "catalog:",
     "jotai": "catalog:",
-    "kysely": "^catalog:",
+    "kysely": "catalog:",
     "tsdown": "catalog:",
     "vite": "catalog:"
   },
@@ -178,7 +161,7 @@
     "@tanstack/react-query": "catalog:",
     "elysia": "catalog:",
     "jotai": "catalog:",
-    "kysely": "^catalog:",
+    "kysely": "catalog:",
     "react": "catalog:",
     "vite": "catalog:"
   }

package/skills/jchat-addon-development/SKILL.md

@@ -12,11 +12,11 @@ Use this skill when developing, updating, or debugging JChat addons using `@jcha
 ## 1. Architectural Guardrails (Non-Negotiable)
 
 1. **Import Boundaries**:
-   - Addons MUST ONLY import `@jchat/addon-sdk` and `@jchat/addon-sdk/icon`.
-   - NEVER import private internal monorepo packages (`@jchat/icon`, `@jchat/ui`, `@jchat/db`, `@jchat/shared`, etc.).
+   - Addons MUST ONLY import `@jchat/addon-sdk`, `@jchat/addon-sdk/ui` (components, icons & toast), `@jchat/addon-sdk/state` (atomic state), and `@jchat/addon-sdk/server`.
+   - NEVER import private internal monorepo packages (`@jchat/ui`, `@jchat/db`, `@jchat/shared`, etc.).
    - Host externals (`react`, `react-dom`, `@tanstack/react-query`) are provided at runtime by the JChat host.
 2. **Icons**:
-   - Use direct imports: `import Icons from "@jchat/addon-sdk/icon"`.
+   - Use direct imports: `import { Icons } from "@jchat/addon-sdk/ui"`.
    - Never call `useIcons()` or install `lucide-react` / `react-icons` directly in the addon.
 3. **Database Isolation**:
    - All addon tables MUST reside in the isolated `addons` PostgreSQL schema (e.g. `addons.GlimpseStories`).
@@ -98,7 +98,7 @@ import {
   useAddonMutation,
   useAddonTranslation
 } from "@jchat/addon-sdk"
-import Icons from "@jchat/addon-sdk/icon"
+import { Icons } from "@jchat/addon-sdk/ui"
 
 export default function PollwiseAddon({ mountPoint, roomId }: AddonProps) {
   const sdk = useAddonSDK()
@@ -154,7 +154,7 @@ export default function PollwiseAddon({ mountPoint, roomId }: AddonProps) {
 Icons are rendered directly:
 
 ```tsx
-import Icons, { resolveIcon } from "@jchat/addon-sdk/icon"
+import { Icons, resolveIcon } from "@jchat/addon-sdk/ui"
 
 // Direct JSX:
 <Icons.Sparkles className="size-4 text-primary" />

package/src/tailwind.css

@@ -0,0 +1 @@
+@import "@jchat/ui/tailwind.css";

package/dist/icon.d.mts

@@ -1,4 +0,0 @@
-import { i as IconPack, n as IconComponent, r as IconName, t as ICON_NAMES } from "./types.mjs";
-import { a as getIconPack, c as lucidePack, i as fa6Pack, l as phosphorPack, n as Icons, o as heroPack, r as Youtube, s as isIconName, t as IconPackName, u as resolveIcon } from "./index.mjs";
-export * from "lucide-react";
-export { ICON_NAMES, type IconComponent, type IconName, type IconPack, IconPackName, Icons, Icons as default, Youtube, fa6Pack, getIconPack, heroPack, isIconName, lucidePack, phosphorPack, resolveIcon };

package/dist/icon.mjs

@@ -1,4 +0,0 @@
-import { i as IconPack, n as IconComponent, r as IconName, t as ICON_NAMES } from "./types.d.mts";
-import { a as getIconPack, c as lucidePack, i as fa6Pack, l as phosphorPack, n as Icons, o as heroPack, r as Youtube, s as isIconName, t as IconPackName, u as resolveIcon } from "./index.d.mts";
-export * from "lucide-react";
-export { ICON_NAMES, IconComponent, IconName, IconPack, IconPackName, Icons, Icons as default, Youtube, fa6Pack, getIconPack, heroPack, isIconName, lucidePack, phosphorPack, resolveIcon };