@xpert-ai/plugin-spaces 0.2.0 → 0.3.0

package/dist/resource-folders.d.ts

@@ -0,0 +1,7 @@
+import type { EntityManager } from 'typeorm';
+import { SpaceItem } from './entities.js';
+import { type SpaceActor } from './domain.js';
+/** Folder deletion must not silently bypass a resource provider's lifecycle policy.
+ * Call under the Space lock when committing a change; the early validation gives
+ * the same error before the Markdown move coordinator retires editor rooms. */
+export declare function assertFolderHasNoResources(manager: EntityManager, actor: SpaceActor, item: SpaceItem): Promise<void>;

package/dist/resource-folders.js

@@ -0,0 +1,21 @@
+import { ConflictException } from '@nestjs/common';
+import { SpaceItem, SpaceResourcePlacement } from './entities.js';
+import { scoped } from './domain.js';
+/** Folder deletion must not silently bypass a resource provider's lifecycle policy.
+ * Call under the Space lock when committing a change; the early validation gives
+ * the same error before the Markdown move coordinator retires editor rooms. */
+export async function assertFolderHasNoResources(manager, actor, item) {
+    if (item.kind !== 'folder')
+        return;
+    const folders = await manager.getRepository(SpaceItem).findBy({ ...scoped(actor), spaceId: item.spaceId, kind: 'folder' });
+    const inside = new Set([item.id]);
+    for (let i = 0; i <= folders.length; i++)
+        for (const folder of folders) {
+            if (folder.parentId && inside.has(folder.parentId))
+                inside.add(folder.id);
+        }
+    const placements = await manager.getRepository(SpaceResourcePlacement).findBy({ ...scoped(actor), spaceId: item.spaceId });
+    if (placements.some(placement => placement.parentId && inside.has(placement.parentId))) {
+        throw new ConflictException('spaces.folder_contains_resources');
+    }
+}

package/dist/resource-provider.d.ts

@@ -1,4 +1,5 @@
 import { type ContentResourceEditor, type ContentResourceRequest, type ContentPrincipal, type ContentPageProvider, type ContentLocationProvider, type ContentPublicationObserver, type ContentReferenceProvider, type IContentResourceProvider } from '@xpert-ai/plugin-sdk';
+import { SpaceItemCatalog } from './item-catalog.js';
 import { SpaceAccess } from './access.js';
 import { SpaceFiles } from './files.js';
 import { SpaceDocuments } from './documents.js';
@@ -12,8 +13,10 @@ export declare class SpacesResourceProvider implements IContentResourceProvider
     private readonly subpages;
     private readonly referenceService;
     private readonly files;
+    private readonly itemCatalog;
     readonly title = "Spaces";
-    constructor(access: SpaceAccess, documents: SpaceDocuments, knowledge: SpaceKnowledge, subpages: SpaceSubpages, referenceService: SpaceReferences, files: SpaceFiles);
+    constructor(access: SpaceAccess, documents: SpaceDocuments, knowledge: SpaceKnowledge, subpages: SpaceSubpages, referenceService: SpaceReferences, files: SpaceFiles, itemCatalog: SpaceItemCatalog);
+    get catalog(): import("@xpert-ai/plugin-sdk").ContentCatalogProvider;
     readonly editor: ContentResourceEditor;
     readonly references: ContentReferenceProvider;
     readonly pages: ContentPageProvider;

package/dist/resource-provider.js

@@ -9,6 +9,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 import { ConflictException, Injectable } from '@nestjs/common';
 import { ContentResourceProvider } from '@xpert-ai/plugin-sdk';
+import { SpaceItemCatalog } from './item-catalog.js';
 import { Space, SpaceItem } from './entities.js';
 import { SpaceAccess } from './access.js';
 import { SpaceFiles } from './files.js';
@@ -17,6 +18,7 @@ import { SpaceKnowledge } from './knowledge.js';
 import { denied, scoped } from './domain.js';
 import { SpaceReferences } from './references.js';
 import { SpaceSubpages } from './subpages.js';
+import { assertFolderHasNoResources } from './resource-folders.js';
 let SpacesResourceProvider = class SpacesResourceProvider {
     access;
     documents;
@@ -24,15 +26,18 @@ let SpacesResourceProvider = class SpacesResourceProvider {
     subpages;
     referenceService;
     files;
+    itemCatalog;
     title = 'Spaces';
-    constructor(access, documents, knowledge, subpages, referenceService, files) {
+    constructor(access, documents, knowledge, subpages, referenceService, files, itemCatalog) {
         this.access = access;
         this.documents = documents;
         this.knowledge = knowledge;
         this.subpages = subpages;
         this.referenceService = referenceService;
         this.files = files;
+        this.itemCatalog = itemCatalog;
     }
+    get catalog() { return this.itemCatalog.catalog; }
     editor = {
         describe: async (input) => {
             const actor = { ...input.actor, projectId: input.projectId, assistantId: input.assistantId };
@@ -68,6 +73,8 @@ let SpacesResourceProvider = class SpacesResourceProvider {
             throw new ConflictException('spaces.version_conflict');
         if (item.deleted !== input.deleted)
             await this.access.resource(actor, item.id, 'manage', !input.deleted);
+        if (input.deleted)
+            await assertFolderHasNoResources(this.access.items.manager, actor, item);
         const parent = await this.access.resource(actor, input.parentResourceId ?? item.spaceId, 'write');
         if (parent.space.id !== item.spaceId || (parent.item && parent.item.kind !== 'folder'))
             throw denied();
@@ -79,7 +86,16 @@ let SpacesResourceProvider = class SpacesResourceProvider {
         }
     }
     async onLocationPrepared(input) {
-        await this.access.items.update({ ...scoped(input.actor), id: input.source.resourceId, version: input.expectedSourceVersion }, { syncStatus: 'pending', syncError: 'spaces.location_pending' });
+        await this.access.items.manager.transaction(async (manager) => {
+            const repo = manager.getRepository(SpaceItem);
+            const item = await repo.findOneByOrFail({ ...scoped(input.actor), id: input.source.resourceId });
+            await manager.getRepository(Space).findOneOrFail({ where: { ...scoped(input.actor), id: item.spaceId }, lock: { mode: 'pessimistic_write' } });
+            if (input.deleted)
+                await assertFolderHasNoResources(manager, input.actor, item);
+            // Resource placement takes the same Space lock and rejects a pending ancestor.
+            // Once prepared, no resource can enter a folder while its durable move finishes.
+            await repo.update({ ...scoped(input.actor), id: item.id, version: input.expectedSourceVersion }, { syncStatus: 'pending', syncError: 'spaces.location_pending' });
+        });
     }
     async onLocationChanged(input) {
         // Projection of a durable authorized operation: it must still finish if the initiating user leaves.
@@ -139,6 +155,6 @@ let SpacesResourceProvider = class SpacesResourceProvider {
 SpacesResourceProvider = __decorate([
     Injectable(),
     ContentResourceProvider('spaces'),
-    __metadata("design:paramtypes", [SpaceAccess, SpaceDocuments, SpaceKnowledge, SpaceSubpages, SpaceReferences, SpaceFiles])
+    __metadata("design:paramtypes", [SpaceAccess, SpaceDocuments, SpaceKnowledge, SpaceSubpages, SpaceReferences, SpaceFiles, SpaceItemCatalog])
 ], SpacesResourceProvider);
 export { SpacesResourceProvider };

package/dist/spaces.js

@@ -20,7 +20,9 @@ import { Space, SpaceItem } from './entities.js';
 import { SpaceAccess } from './access.js';
 import { denied, id, kindSchema, scoped, title } from './domain.js';
 import { isInternalSpacePath, SpaceDocuments } from './documents.js';
+import { coveredByContent } from './content-coverage.js';
 import { SpaceKnowledge } from './knowledge.js';
+import { assertFolderHasNoResources } from './resource-folders.js';
 export const createItemSchema = z.object({ spaceId: id, parentId: id.nullable().default(null), title,
     kind: kindSchema, artifactId: id.optional(), artifactVersionId: id.optional(), content: z.string().max(100000).optional() }).strict();
 export const editItemSchema = z.object({ itemId: id, expectedVersion: z.number().int().positive(),
@@ -57,10 +59,11 @@ let SpacesService = class SpacesService {
     async tree(actor, resourceId, trash = false) {
         const principal = await this.access.principal(actor);
         const root = await this.access.resolve(principal, resourceId, trash ? 'manage' : 'read');
+        const coverage = await this.documents.resourceCoverage(actor, root.space);
         if (!trash)
             await this.spaces.manager.transaction(async (manager) => {
                 await manager.getRepository(Space).findOneOrFail({ where: { ...scoped(actor), id: root.space.id }, lock: { mode: 'pessimistic_write' } });
-                await this.documents.discover(actor, root.space, root.canWrite);
+                await this.documents.discover(actor, root.space, root.canWrite, coverage);
             });
         const all = await this.access.items.find({ where: { ...scoped(actor), spaceId: root.space.id }, order: { createdAt: 'ASC' } });
         const items = [];
@@ -78,7 +81,7 @@ let SpacesService = class SpacesService {
         }
         for (const item of all) {
             if (!descendants.has(item.id) || item.deleted !== trash ||
-                (!trash && item.filePath && isInternalSpacePath(item.filePath)))
+                (!trash && item.filePath && (isInternalSpacePath(item.filePath) || coveredByContent(item.filePath, coverage))))
                 continue;
             try {
                 const result = await this.access.resolve(principal, item.id, 'read', trash);
@@ -152,6 +155,8 @@ let SpacesService = class SpacesService {
                 await this.access.resource(actor, input.itemId, input.deleted !== undefined ? 'manage' : 'write', input.deleted === false);
                 const repo = manager.getRepository(SpaceItem);
                 const item = await repo.findOneByOrFail({ ...scoped(actor), id: input.itemId });
+                if (input.deleted === true)
+                    await assertFolderHasNoResources(manager, actor, item);
                 const previousPath = item.filePath;
                 if (item.version !== input.expectedVersion)
                     throw new ConflictException('spaces.version_conflict');

package/dist/subpages.js

@@ -72,7 +72,7 @@ let SpaceSubpages = class SpaceSubpages {
                 item.parentPageId !== parent.id || item.childRequestTitle !== request.title || item.createdById !== actor.userId || item.deleted))
                 throw new ConflictException('spaces.child_request_conflict');
             if (!item) {
-                // New IDs cannot make cycles. Bound depth so corrupt legacy metadata cannot loop forever.
+                // New IDs cannot make cycles. Bound depth so corrupt metadata cannot loop forever.
                 // Count the child itself as level one, then count its ancestors.
                 let cursor = parent, depth = 1;
                 while (cursor) {

package/dist/view.d.ts

@@ -1,3 +1,4 @@
+import { SpaceCatalog } from './catalog.js';
 import { SpaceImports } from './imports.js';
 import type { XpertExtensionViewManifest, XpertResolvedViewHostContext, XpertViewQuery, XpertViewActionRequest, XpertRemoteComponentViewSchema, XpertViewFileAccessRequest } from '@xpert-ai/contracts';
 import { type IXpertViewExtensionProvider, type XpertViewFileActionFile } from '@xpert-ai/plugin-sdk';
@@ -10,6 +11,7 @@ import { SpaceKnowledge } from './knowledge.js';
 import { SpaceContent } from './content.js';
 import { SpaceAccess } from './access.js';
 export declare class SpacesView implements IXpertViewExtensionProvider {
+    private readonly catalog;
     private readonly imports;
     private readonly content;
     private readonly spaces;
@@ -19,7 +21,7 @@ export declare class SpacesView implements IXpertViewExtensionProvider {
     private readonly editors;
     private readonly knowledge;
     private readonly access;
-    constructor(imports: SpaceImports, content: SpaceContent, spaces: SpacesService, pages: SpacePages, ai: SpaceAi, files: SpaceFiles, editors: SpaceEditors, knowledge: SpaceKnowledge, access: SpaceAccess);
+    constructor(catalog: SpaceCatalog, imports: SpaceImports, content: SpaceContent, spaces: SpacesService, pages: SpacePages, ai: SpaceAi, files: SpaceFiles, editors: SpaceEditors, knowledge: SpaceKnowledge, access: SpaceAccess);
     supports(context: XpertResolvedViewHostContext): boolean;
     getViewManifests(context: XpertResolvedViewHostContext, slot: string): XpertExtensionViewManifest[];
     getRemoteComponentEntry(context: XpertResolvedViewHostContext, viewKey: string, component: XpertRemoteComponentViewSchema['component']): Promise<{

package/dist/view.js

@@ -7,6 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+import { SpaceCatalog, catalogQuery, catalogCreate, catalogRename, catalogDuplicate, catalogLifecycle, catalogMove } from './catalog.js';
 import { SpaceImports, sourceSelection, importSelection } from './imports.js';
 import { BadRequestException, Injectable } from '@nestjs/common';
 import { readFile } from 'node:fs/promises';
@@ -23,10 +24,11 @@ import { SpaceContent } from './content.js';
 import { SpaceAccess } from './access.js';
 const selection = z.object({ itemId: id }).strict();
 const label = (en_US, zh_Hans) => ({ en_US, zh_Hans });
-const actions = ['source.list', 'source.search', 'source.preview', 'source.import', 'document.open', 'knowledge.enable',
+const actions = ['catalog.duplicate', 'catalog.backup', 'catalog.preferences', 'catalog.preference.set', 'catalog.move', 'catalog.types', 'catalog.list', 'catalog.create', 'catalog.rename', 'catalog.lifecycle', 'source.list', 'source.search', 'source.preview', 'source.import', 'document.open', 'knowledge.enable',
     'knowledge.status', 'knowledge.refresh', 'knowledge.search', 'item.create', 'item.edit', 'page.read', 'search',
     'file.list', 'page.export', 'artifact.list', 'artifact.collect', 'artifact.open', 'editor.list', 'editor.create'];
 let SpacesView = class SpacesView {
+    catalog;
     imports;
     content;
     spaces;
@@ -36,7 +38,8 @@ let SpacesView = class SpacesView {
     editors;
     knowledge;
     access;
-    constructor(imports, content, spaces, pages, ai, files, editors, knowledge, access) {
+    constructor(catalog, imports, content, spaces, pages, ai, files, editors, knowledge, access) {
+        this.catalog = catalog;
         this.imports = imports;
         this.content = content;
         this.spaces = spaces;
@@ -65,7 +68,7 @@ let SpacesView = class SpacesView {
                     { key: 'editor.import', label: label('Import document', '导入文档'), actionType: 'invoke', transport: 'file' },
                     { key: 'file.upload', label: label('Upload file', '上传文件'), actionType: 'invoke', transport: 'file' }],
                 // Declare both phases: platform resource resolution, then container-local navigation.
-                clientCommands: ['assistant.context.set', 'workbench.content.resolve', 'workbench.navigation.open'].map((key) => ({ key, required: key === 'workbench.content.resolve', label: label(key, key) })) }];
+                clientCommands: ['assistant.chat.send_message', 'assistant.context.set', 'workbench.content.resolve', 'workbench.navigation.open'].map((key) => ({ key, required: key === 'workbench.content.resolve', label: label(key, key) })) }];
     }
     async getRemoteComponentEntry(context, viewKey, component) {
         if (viewKey !== VIEW || component.entry !== 'spaces')
@@ -146,6 +149,36 @@ let SpacesView = class SpacesView {
                 result = await this.knowledge.search(actor, p.spaceId, p.query);
                 break;
             }
+            case 'catalog.backup':
+                result = await this.catalog.backup(actor, z.object({ contentId: id }).strict().parse(input).contentId);
+                break;
+            case 'catalog.preferences':
+                result = await this.catalog.preferences(actor, z.object({ contentId: id }).strict().parse(input).contentId);
+                break;
+            case 'catalog.preference.set':
+                result = await this.catalog.setPreference(actor, z.object({ contentId: id, scope: z.enum(['resource', 'project', 'organization']), editorKey: z.string().min(1).max(200).nullable(), expectedRevision: z.number().int().nonnegative() }).strict().parse(input));
+                break;
+            case 'catalog.move':
+                result = await this.catalog.move(actor, catalogMove.parse(input));
+                break;
+            case 'catalog.types':
+                result = await this.catalog.types(actor);
+                break;
+            case 'catalog.list':
+                result = await this.catalog.list(actor, catalogQuery.parse(input));
+                break;
+            case 'catalog.lifecycle':
+                result = await this.catalog.lifecycle(actor, catalogLifecycle.parse(input));
+                break;
+            case 'catalog.duplicate':
+                result = await this.catalog.duplicate(actor, catalogDuplicate.parse(input));
+                break;
+            case 'catalog.rename':
+                result = await this.catalog.rename(actor, catalogRename.parse(input));
+                break;
+            case 'catalog.create':
+                result = await this.catalog.create(actor, catalogCreate.parse(input));
+                break;
             case 'editor.list':
                 result = await this.editors.list(actor);
                 break;
@@ -221,6 +254,6 @@ let SpacesView = class SpacesView {
 SpacesView = __decorate([
     Injectable(),
     ViewExtensionProvider('spaces.views'),
-    __metadata("design:paramtypes", [SpaceImports, SpaceContent, SpacesService, SpacePages, SpaceAi, SpaceFiles, SpaceEditors, SpaceKnowledge, SpaceAccess])
+    __metadata("design:paramtypes", [SpaceCatalog, SpaceImports, SpaceContent, SpacesService, SpacePages, SpaceAi, SpaceFiles, SpaceEditors, SpaceKnowledge, SpaceAccess])
 ], SpacesView);
 export { SpacesView };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-spaces",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -48,8 +48,8 @@
     "@nestjs/common": "^11.1.6",
     "@nestjs/core": "^11.1.6",
     "@nestjs/typeorm": "^11.0.0",
-    "@xpert-ai/contracts": "^3.27.0",
-    "@xpert-ai/plugin-sdk": "^3.27.0",
+    "@xpert-ai/contracts": "^3.28.0",
+    "@xpert-ai/plugin-sdk": "^3.28.0",
     "typeorm": "^0.3.24",
     "zod": "3.25.67"
   },
@@ -62,8 +62,8 @@
     "@types/node": "^22.13.0",
     "@types/react": "^18.3.18",
     "@types/react-dom": "^18.3.5",
-    "@xpert-ai/contracts": "3.27.0",
-    "@xpert-ai/plugin-sdk": "3.27.0",
+    "@xpert-ai/contracts": "3.28.0",
+    "@xpert-ai/plugin-sdk": "3.28.0",
     "@xpert-ai/plugin-shadcn-ui": "workspace:*",
     "esbuild": "0.28.1",
     "playwright-core": "^1.55.0",