@neta-art/cohub 8.12.1 → 8.14.0

package/dist/space-picker.d.ts

@@ -0,0 +1,27 @@
+//#region src/space-picker.d.ts
+/**
+ * Framework-agnostic Space picker model: pure filtering, search, and ordering
+ * shared by every host's consent dialog and Space chooser. Hosts supply their
+ * own recency signal; this module never touches storage.
+ */
+type SpacePickerFilter = "recent" | "all" | "mine" | "pinned";
+type SpacePickerItem = {
+  id: string;
+  name: string | null;
+  ownerUserUuid?: string | null;
+  isPinned?: boolean;
+};
+type SpacePickerOptions = {
+  filter: SpacePickerFilter;
+  query?: string;
+  viewerUserUuid?: string | null;
+  /** Space ids ordered by most-recently visited first. */
+  recentSpaceIds?: readonly string[];
+  limit?: number;
+};
+declare function normalizeSpacePickerQuery(value: string): string;
+declare function orderSpacePickerItems<T extends SpacePickerItem>(items: readonly T[], recentSpaceIds?: readonly string[]): T[];
+declare function filterSpacePickerItems<T extends SpacePickerItem>(items: readonly T[], options: SpacePickerOptions): T[];
+declare function selectSpacePickerItems<T extends SpacePickerItem>(items: readonly T[], options: SpacePickerOptions): T[];
+//#endregion
+export { SpacePickerFilter, SpacePickerItem, SpacePickerOptions, filterSpacePickerItems, normalizeSpacePickerQuery, orderSpacePickerItems, selectSpacePickerItems };

package/dist/space-picker.js

@@ -0,0 +1,35 @@
+//#region src/space-picker.ts
+function normalizeSpacePickerQuery(value) {
+	return value.trim().toLocaleLowerCase();
+}
+function orderSpacePickerItems(items, recentSpaceIds = []) {
+	const recentIndex = new Map(recentSpaceIds.map((id, index) => [id, index]));
+	return [...items].sort((a, b) => {
+		const recentA = recentIndex.get(a.id);
+		const recentB = recentIndex.get(b.id);
+		if (recentA !== void 0 || recentB !== void 0) {
+			if (recentA === void 0) return 1;
+			if (recentB === void 0) return -1;
+			return recentA - recentB;
+		}
+		return (a.name ?? a.id).localeCompare(b.name ?? b.id);
+	});
+}
+function filterSpacePickerItems(items, options) {
+	const recentIds = new Set(options.recentSpaceIds ?? []);
+	const effectiveFilter = options.filter === "recent" && recentIds.size === 0 ? "all" : options.filter;
+	const normalizedQuery = normalizeSpacePickerQuery(options.query ?? "");
+	return items.filter((item) => {
+		if (effectiveFilter === "mine" && item.ownerUserUuid !== options.viewerUserUuid) return false;
+		if (effectiveFilter === "pinned" && !item.isPinned) return false;
+		if (effectiveFilter === "recent" && !recentIds.has(item.id)) return false;
+		if (!normalizedQuery) return true;
+		return normalizeSpacePickerQuery(item.name ?? item.id).includes(normalizedQuery);
+	});
+}
+function selectSpacePickerItems(items, options) {
+	const ordered = orderSpacePickerItems(filterSpacePickerItems(items, options), options.recentSpaceIds ?? []);
+	return options.limit === void 0 ? ordered : ordered.slice(0, options.limit);
+}
+//#endregion
+export { filterSpacePickerItems, normalizeSpacePickerQuery, orderSpacePickerItems, selectSpacePickerItems };

package/docs/app-runtime-guide.md

@@ -65,7 +65,7 @@ These runtime-only APIs form the foundation; everything else is standard SDK:
 
 | API | What it does | Returns |
 |---|---|---|
-| `client.context()` | Asks the host for the App's identity | `{ app, space, viewer?, invocation?, permissions }` or `null` |
+| `client.context()` | Asks the host for the App's identity | `{ app, space, viewer?, invocation?, shell?, permissions }` or `null` |
 | `client.auth.request({ scopes, reason, spaceId?, alwaysAsk? })` | Ensures the app holds these scopes; silent when a grant already covers them, consent dialog otherwise | `true` / `false` |
 | `client.auth.requestSpace({ scopes, reason, alwaysAsk? })` | One consent: the viewer picks a Space and grants the scopes on it | `{ granted, space }` |
 | `client.auth.requestCreateSpace({ scopes, space, reason })` | One consent: create a viewer-owned Space (`CreateSpaceInput`) and grant the scopes on it | `{ granted, space }` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "8.12.1",
+  "version": "8.14.0",
   "description": "Cohub SDK for spaces, sessions, boards, and realtime agent collaboration.",
   "license": "Apache-2.0",
   "private": false,
@@ -45,6 +45,10 @@
       "types": "./dist/debugger.d.ts",
       "import": "./dist/debugger.js"
     },
+    "./space-picker": {
+      "types": "./dist/space-picker.d.ts",
+      "import": "./dist/space-picker.js"
+    },
     "./board": {
       "types": "./dist/board/index.d.ts",
       "import": "./dist/board/index.js"