webiny-api-aco-catalog

Catalogs 32 Webiny ACO abstractions for folder use cases and event handlers.

8.0k|673|Updated Jan 9, 2018
One-click install
npx skills add https://github.com/webiny/webiny-js --skill webiny-api-aco-catalog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webiny-api-aco-catalog
Source: https://github.com/webiny/webiny-js/tree/main/skills/user-skills/generated/api/aco
Command: npx skills add https://github.com/webiny/webiny-js --skill webiny-api-aco-catalog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers extending Webiny's ACO (Advanced Content Organization) API struggle to locate the correct abstraction, import path, and source file among dozens of folder and folder-level-permission interfaces.

Core Features & Use Cases

  • Abstraction Lookup: Lists 32 abstractions covering folder CRUD use cases, repositories, storage operations, and lifecycle event handlers.
  • Import Paths: Provides exact import statements and source file locations for each abstraction, such as CreateFolderUseCase and FolderBeforeCreateEventHandler.
  • Use Case: When building a custom feature that reacts to folder deletion, find FolderBeforeDeleteEventHandler, read its source file for the exact interface, and implement the handler following the referenced event-handler pattern.

Quick Start

Ask the AI to find the Webiny ACO abstraction for listing folders and show its import path and source file.

Frequently Asked Questions about webiny-api-aco-catalog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a folder programmatically in Webiny ACO?

Use the CreateFolderUseCase abstraction imported from webiny/api/aco/folder, defined in @webiny/api-aco/features/folder/CreateFolder/abstractions.ts. Read the source file first to get the exact interface and types before implementing.

How do I hook into folder lifecycle events in Webiny?

Implement one of the folder event handler abstractions such as FolderBeforeCreateEventHandler or FolderAfterDeleteEventHandler. Each handler corresponds to a lifecycle stage of create, get, update, or delete operations.

What are folder-level permissions in Webiny ACO?

Folder-level permissions control access to individual folders through the FolderLevelPermissions abstraction and FLP use cases like CreateFlpUseCase, GetFlpUseCase, UpdateFlpUseCase, and DeleteFlpUseCase, all imported from webiny/api/aco/flp.

Does Webiny ACO support retrieving folder hierarchies?

Yes, GetFolderHierarchyUseCase retrieves the full folder hierarchy and GetAncestorsUseCase retrieves ancestor folders. Both have corresponding repository abstractions for storage access.

When should I use repositories versus use cases in Webiny ACO?

Use cases like CreateFolderUseCase encapsulate business logic, while repositories like CreateFolderRepository handle persistence to storage. Implement repositories for storage customization and use cases for application-level operations.