framework-m-core 0.30.2__tar.gz → 0.32.0__tar.gz

{framework_m_core-0.30.2 → framework_m_core-0.32.0}/CHANGELOG.md

@@ -1,3 +1,28 @@
+## framework-m-core v0.32.0
+
+### Features
+
+- add PayloadCryptoProtocol interface for payload encryption (3a036b6)
+- add global search command palette (360fff6)
+
+### Bug Fixes
+
+- unify admin roles into a centralized constant (e557428)
+- enforce user field guard blocks and correct admin roles (184736f)
+
+## framework-m-core v0.31.0
+
+### Features
+
+- add bounded count threshold for list totals (db01634)
+- support dynamic workflow state field configuration (1ae69e1)
+
+### Bug Fixes
+
+- support dynamic workflow state field configuration (cc88877)
+- update package export assertions (e19c1b1)
+- ensure container protocol defaults and type mappings (41df6cb)
+
 ## framework-m-core v0.30.2
 
 ### Bug Fixes

{framework_m_core-0.30.2 → framework_m_core-0.32.0}/PKG-INFO

@@ -1,13 +1,13 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: framework-m-core
-Version: 0.30.2
+Version: 0.32.0
 Summary: Core protocols and dependency injection for Framework M
 Author: Framework M Contributors
 License: Apache-2.0
 License-File: LICENSE
 Requires-Python: >=3.12
-Requires-Dist: cyclopts>=4.22.4
-Requires-Dist: pydantic-settings>=2.14.2
+Requires-Dist: cyclopts>=4.22.5
+Requires-Dist: pydantic-settings>=2.15.0
 Requires-Dist: pydantic>=2.13.4
 Description-Content-Type: text/markdown
 
@@ -16,7 +16,7 @@ Description-Content-Type: text/markdown
 [![PyPI version](https://badge.fury.io/py/framework-m-core.svg)](https://badge.fury.io/py/framework-m-core)
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![GitLab Pipeline Status](https://gitlab.com/castlecraft/framework-m/badges/main/pipeline.svg)](https://gitlab.com/castlecraft/framework-m/-/pipelines)
+[![GitLab Pipeline Status](https://gitlab.com/framework-m/framework-m/badges/main/pipeline.svg)](https://gitlab.com/framework-m/framework-m/-/pipelines)
 
 Core protocols and foundation for Framework M.
 
@@ -58,9 +58,9 @@ def my_command():
 
 ## Usage
 
-This package is typically used as a dependency of `framework-m` or `framework-m-standard`. 
+This package is typically used as a dependency of `framework-m` or `framework-m-standard`.
 For most applications, install the full `framework-m` package instead.
 
 ## License
 
-Apache 2.0 License - see [LICENSE](https://gitlab.com/castlecraft/framework-m/blob/main/LICENSE) for details.
+Apache 2.0 License - see [LICENSE](https://gitlab.com/framework-m/framework-m/blob/main/LICENSE) for details.

{framework_m_core-0.30.2 → framework_m_core-0.32.0}/README.md

@@ -3,7 +3,7 @@
 [![PyPI version](https://badge.fury.io/py/framework-m-core.svg)](https://badge.fury.io/py/framework-m-core)
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![GitLab Pipeline Status](https://gitlab.com/castlecraft/framework-m/badges/main/pipeline.svg)](https://gitlab.com/castlecraft/framework-m/-/pipelines)
+[![GitLab Pipeline Status](https://gitlab.com/framework-m/framework-m/badges/main/pipeline.svg)](https://gitlab.com/framework-m/framework-m/-/pipelines)
 
 Core protocols and foundation for Framework M.
 
@@ -45,9 +45,9 @@ def my_command():
 
 ## Usage
 
-This package is typically used as a dependency of `framework-m` or `framework-m-standard`. 
+This package is typically used as a dependency of `framework-m` or `framework-m-standard`.
 For most applications, install the full `framework-m` package instead.
 
 ## License
 
-Apache 2.0 License - see [LICENSE](https://gitlab.com/castlecraft/framework-m/blob/main/LICENSE) for details.
+Apache 2.0 License - see [LICENSE](https://gitlab.com/framework-m/framework-m/blob/main/LICENSE) for details.

{framework_m_core-0.30.2 → framework_m_core-0.32.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "framework-m-core"
-version = "0.30.2"
+version = "0.32.0"
 description = "Core protocols and dependency injection for Framework M"
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -10,8 +10,8 @@ authors = [
 ]
 dependencies = [
     "pydantic>=2.13.4",
-    "pydantic-settings>=2.14.2",
-    "cyclopts>=4.22.4",
+    "pydantic-settings>=2.15.0",
+    "cyclopts>=4.22.5",
 ]
 
 [build-system]

framework_m_core-0.32.0/src/framework_m_core/constants.py

@@ -0,0 +1,12 @@
+"""Core constants used across the framework."""
+
+# Canonical set of roles that grant system-wide administrative privileges.
+# These roles bypass Row-Level Security (RLS) and DocType permissions.
+ADMIN_ROLES: frozenset[str] = frozenset(
+    {
+        "Administrator",
+        "SystemManager",
+        "System",
+        "Admin",
+    }
+)

{framework_m_core-0.30.2 → framework_m_core-0.32.0}/src/framework_m_core/container.py

@@ -178,6 +178,10 @@ class Container(DeclarativeContainer):
     # Usage: container.repository.override(GenericRepository)
     repository: _Provider[Any] = providers.Dependency()
 
+    # Optional request-scoped database search provider. Standard web wiring
+    # composes it with application entry-point providers per request.
+    search_provider: _Provider[Any] = providers.Dependency()
+
     # Repository Factory - dynamically instantiates repositories for DocTypes
     # Usage: container.repository_factory()
     repository_factory: _Provider[Any] = providers.Dependency()
@@ -259,6 +263,9 @@ class Container(DeclarativeContainer):
     # Composition Service - handles federated data aggregation
     composition_service: _Provider[Any] = providers.Dependency()
 
+    # Workflow Service - manages document workflow states and transitions
+    workflow_service: _Provider[Any] = providers.Dependency()
+
 
 def load_overrides(container: Container, group: str = "framework_m.overrides") -> int:
     """
@@ -698,6 +705,7 @@ def get_app_container_names(main_container: Container) -> list[str]:
         "migration_manager",
         "discovery_service",
         "composition_service",
+        "workflow_service",
         "wiring_config",
     }
 

{framework_m_core-0.30.2 → framework_m_core-0.32.0}/src/framework_m_core/doctypes/user.py

@@ -22,6 +22,7 @@ from typing import Any
 
 from pydantic import Field, field_validator, model_validator
 
+from framework_m_core.constants import ADMIN_ROLES
 from framework_m_core.domain.base_controller import BaseController
 from framework_m_core.domain.base_doctype import BaseDocType
 from framework_m_core.exceptions import PermissionDeniedError
@@ -287,6 +288,7 @@ class LocalUserController(BaseController[LocalUser]):
 
     ADMIN_FIELDS: frozenset[str] = frozenset({"roles", "tenants", "is_active"})
     IDENTITY_FIELDS: frozenset[str] = frozenset({"email", "phone_number"})
+    ADMIN_ROLES = ADMIN_ROLES
 
     async def before_save(self, context: Any = None) -> None:
         """Enforce self-service identifier/admin-field protection.
@@ -305,18 +307,16 @@ class LocalUserController(BaseController[LocalUser]):
         if isinstance(context, dict) and context.get("system_bypass") is True:
             return
 
-        if self._is_admin_context(context):
-            return
-
-        changed_admin = {
-            field for field in self.ADMIN_FIELDS if self.has_changed(field)
-        }
-        if changed_admin:
-            raise PermissionDeniedError(
-                t(
-                    "Self-service users cannot modify administrative fields: {fields}"
-                ).format(fields=", ".join(sorted(changed_admin)))
-            )
+        if not self._is_admin_context(context):
+            changed_admin = {
+                field for field in self.ADMIN_FIELDS if self.has_changed(field)
+            }
+            if changed_admin:
+                raise PermissionDeniedError(
+                    t(
+                        "Self-service users cannot modify administrative fields: {fields}"
+                    ).format(fields=", ".join(sorted(changed_admin)))
+                )
 
         changed_identity = {
             field for field in self.IDENTITY_FIELDS if self.has_changed(field)
@@ -369,14 +369,16 @@ class LocalUserController(BaseController[LocalUser]):
 
         await super().after_save(context)
 
-    @staticmethod
-    def _is_admin_context(context: Any) -> bool:
+    @classmethod
+    def _is_admin_context(cls, context: Any) -> bool:
         """Return True when the save is being performed by an admin/system principal."""
         if isinstance(context, dict):
             if context.get("is_admin") is True:
                 return True
             user = context.get("user")
-            if isinstance(user, UserContext) and "Admin" in (user.roles or []):
+            if isinstance(user, UserContext) and any(
+                r in cls.ADMIN_ROLES for r in (user.roles or [])
+            ):
                 return True
         return False
 

{framework_m_core-0.30.2 → framework_m_core-0.32.0}/src/framework_m_core/doctypes/workflow.py

@@ -37,6 +37,10 @@ class Workflow(BaseDocType):
             },
         },
     )
+    workflow_state_field: str = Field(
+        default="workflow_state",
+        description="Field on target DocType that stores the workflow state name",
+    )
     initial_state: str = Field(description="Initial state for new documents")
     states: list[WorkflowStateDefinition] = Field(
         default_factory=list,

{framework_m_core-0.30.2 → framework_m_core-0.32.0}/src/framework_m_core/doctypes/workflow_state_definition.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from typing import ClassVar
 
 from framework_m_core.domain.base_doctype import BaseDocType, Field
+from framework_m_core.domain.mixins import DocStatus
 
 
 class WorkflowStateDefinition(BaseDocType):
@@ -13,12 +14,17 @@ class WorkflowStateDefinition(BaseDocType):
     This is a child table for the Workflow DocType.
 
     Attributes:
-        state_name: Name of the state (e.g., Draft, Approved)
+        current_state: Name of the state (e.g., Draft, Approved)
+        doc_status: Target document status mapping (0: Draft, 1: Submitted, 2: Cancelled)
         allow_edit: Role allowed to edit documents when in this state
         is_terminal: Whether this is a final state (no further transitions)
     """
 
     current_state: str = Field(description="Name of the state (e.g., Draft, Approved)")
+    doc_status: DocStatus | None = Field(
+        default=None,
+        description="Target document status mapping (0: Draft, 1: Submitted, 2: Cancelled)",
+    )
     allow_edit: str | None = Field(
         default=None,
         description="Role allowed to edit in this state",

{framework_m_core-0.30.2 → framework_m_core-0.32.0}/src/framework_m_core/interfaces/__init__.py

@@ -51,6 +51,7 @@ from framework_m_core.interfaces.oauth import (
     OAuth2Token,
     OAuth2UserInfo,
 )
+from framework_m_core.interfaces.payload_crypto import PayloadCryptoProtocol
 from framework_m_core.interfaces.permission import (
     DecisionSource,
     PermissionAction,
@@ -74,7 +75,14 @@ from framework_m_core.interfaces.repository import (
     RepositoryProtocol,
 )
 from framework_m_core.interfaces.schema_mapper import SchemaMapperProtocol
-from framework_m_core.interfaces.search import SearchProtocol, SearchResult
+from framework_m_core.interfaces.search import (
+    GlobalSearchQuery,
+    GlobalSearchResponse,
+    SearchCategory,
+    SearchProtocol,
+    SearchResult,
+    SearchSuggestion,
+)
 from framework_m_core.interfaces.secrets import SecretProtocol
 from framework_m_core.interfaces.session import SessionData, SessionProtocol
 from framework_m_core.interfaces.socket import SocketProtocol
@@ -144,6 +152,7 @@ __all__ = [
     "OrderSpec",
     "PaginatedResult",
     "PasswordCredentials",
+    "PayloadCryptoProtocol",
     "PermissionAction",
     "PermissionProtocol",
     "PolicyEvaluateRequest",
@@ -158,8 +167,12 @@ __all__ = [
     "ReportResult",
     "RepositoryProtocol",
     "SchemaMapperProtocol",
+    "GlobalSearchQuery",
+    "GlobalSearchResponse",
+    "SearchCategory",
     "SearchProtocol",
     "SearchResult",
+    "SearchSuggestion",
     "SecretProtocol",
     "SendResult",
     "SessionData",

framework_m_core-0.32.0/src/framework_m_core/interfaces/payload_crypto.py

@@ -0,0 +1,62 @@
+"""Payload Encryption Protocol (Port).
+
+Defines the interface that payload encryption adapters must implement.
+The framework uses this port to decrypt incoming request bodies and to
+expose public-key material to clients.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Protocol, runtime_checkable
+
+
+@runtime_checkable
+class PayloadCryptoProtocol(Protocol):
+    """Protocol for application-layer payload encryption/decryption.
+
+    Implementations are responsible for:
+    1. Encrypting plaintext request bodies into an opaque envelope.
+    2. Decrypting incoming envelopes back into plaintext bytes.
+    3. Exposing the server's public key in JWK-compatible JSON so the
+       frontend can encrypt payloads without an extra handshake.
+
+    The middleware layer decides *when* to decrypt based on configuration;
+    this provider focuses purely on the cryptographic primitives.
+    """
+
+    def encrypt_payload(self, plaintext: bytes | str) -> bytes:
+        """Encrypt a plaintext payload.
+
+        Args:
+            plaintext: The raw request body as bytes or text.
+
+        Returns:
+            The encrypted envelope as bytes. The concrete format is left to
+            the adapter (e.g. JWE compact serialization, JSON envelope).
+        """
+        ...
+
+    def decrypt_payload(self, payload: bytes | str) -> bytes:
+        """Decrypt an encrypted payload.
+
+        Args:
+            payload: The encrypted envelope as bytes or text.
+
+        Returns:
+            The decrypted plaintext as bytes.
+
+        Raises:
+            ValueError: If the payload is malformed or cannot be decrypted.
+        """
+        ...
+
+    def get_public_key(self) -> dict[str, Any]:
+        """Return the public key in a JWK-compatible dictionary.
+
+        Returns:
+            A JSON-serializable mapping (e.g. ``{"kty": "RSA", "n": "...", ...}``).
+        """
+        ...
+
+
+__all__ = ["PayloadCryptoProtocol"]

{framework_m_core-0.30.2 → framework_m_core-0.32.0}/src/framework_m_core/interfaces/read_model.py

@@ -18,6 +18,7 @@ from typing import Any, Protocol
 from pydantic import BaseModel
 
 from framework_m_core.interfaces.event_bus import Event
+from framework_m_core.interfaces.repository import FilterSpec
 
 
 class ReadQueryResult(BaseModel):
@@ -59,9 +60,12 @@ class ReadModelProtocol(Protocol):
                 if event.type == "invoice.created":
                     await self._update_monthly_totals(event.data)
 
-            async def query(self, filters=None, **kwargs) -> list[dict]:
-                return await self.clickhouse.execute(
-                    "SELECT month, SUM(total) FROM invoices GROUP BY month"
+            async def query(self, filters=None, **kwargs) -> ReadQueryResult:
+                return ReadQueryResult(
+                    items=await self.clickhouse.execute(
+                        "SELECT month, SUM(total) FROM invoices GROUP BY month"
+                    ),
+                    total=12,
                 )
 
             async def rebuild(self) -> None:
@@ -87,11 +91,11 @@ class ReadModelProtocol(Protocol):
 
     async def query(
         self,
-        filters: dict[str, Any] | None = None,
+        filters: list[FilterSpec] | None = None,
         order_by: list[str] | None = None,
         limit: int = 100,
         offset: int = 0,
-    ) -> list[dict[str, Any]]:
+    ) -> ReadQueryResult:
         """Query the read model with optional filtering and pagination.
 
         Read model queries are optimized for fast retrieval and
@@ -99,17 +103,19 @@ class ReadModelProtocol(Protocol):
         (eventual consistency).
 
         Args:
-            filters: Optional key-value filters to apply
+            filters: Optional list of filter specs to apply (operators
+                preserved, e.g. EQ/LT/LIKE/IN)
             order_by: List of fields to sort by (prefix with - for desc)
             limit: Maximum number of results (default: 100)
             offset: Number of records to skip for pagination
 
         Returns:
-            List of dictionaries representing query results
+            ReadQueryResult wrapping the matching items plus a total
+            count (for pagination).
 
         Example:
-            results = await read_model.query(
-                filters={"status": "paid", "year": 2024},
+            result = await read_model.query(
+                filters=[FilterSpec(field="status", operator=FilterOperator.EQ, value="paid")],
                 order_by=["-total", "customer"],
                 limit=50
             )

framework_m_core-0.32.0/src/framework_m_core/interfaces/search.py

@@ -0,0 +1,252 @@
+"""Search Protocol - Core interface for full-text search.
+
+This module defines the SearchProtocol for full-text search
+and indexing operations.
+
+Supports various backends: Meilisearch, Elasticsearch, Whoosh, etc.
+"""
+
+from datetime import datetime
+from enum import StrEnum
+from typing import Any, Protocol
+
+from pydantic import BaseModel, Field, computed_field, field_validator, model_validator
+
+
+class SearchCategory(StrEnum):
+    """Public categories understood by global-search providers and clients."""
+
+    DOCUMENTS = "documents"
+    DOCTYPES = "doctypes"
+    COMMANDS = "commands"
+    NAVIGATION = "navigation"
+    REPORTS = "reports"
+
+
+class SearchSuggestion(BaseModel):
+    """Normalized item returned by a global-search provider.
+
+    ``id`` is the globally stable deduplication key. Providers must use the
+    same ID for the same logical item across queries (for example,
+    ``documents:Customer:CUST-0001``). ``metadata`` is provider metadata for
+    backend composition only; the web adapter must explicitly select the
+    fields it exposes to a browser.
+    """
+
+    id: str = Field(min_length=1, description="Globally stable result identifier")
+    category: SearchCategory
+    label: str = Field(min_length=1)
+    subtitle: str | None = None
+    icon: str | None = None
+    url: str | None = None
+    score: float | None = None
+    created_at: datetime | None = None
+    updated_at: datetime | None = None
+    highlights: dict[str, list[str]] | None = None
+    provider: str | None = Field(default=None, exclude=True)
+    metadata: dict[str, Any] = Field(default_factory=dict, exclude=True)
+
+    @field_validator("id", "label")
+    @classmethod
+    def _strip_required_text(cls, value: str) -> str:
+        """Reject whitespace-only stable IDs and labels."""
+        stripped = value.strip()
+        if not stripped:
+            raise ValueError("must not be blank")
+        return stripped
+
+
+class GlobalSearchQuery(BaseModel):
+    """Normalized request options for the ``/search/global`` contract.
+
+    The route owns the blank-query response (an empty ``suggestions`` list),
+    while providers only receive non-empty :attr:`normalized_query` values.
+    ``categories`` is intentionally a list so its query-string representation
+    has a stable order when clients need shareable URLs.
+    """
+
+    query: str
+    typeahead: bool = False
+    limit: int = Field(default=20, ge=1, le=100)
+    offset: int = Field(default=0, ge=0)
+    categories: list[SearchCategory] = Field(default_factory=list)
+    created_after: datetime | None = None
+    created_before: datetime | None = None
+
+    @field_validator("categories")
+    @classmethod
+    def _deduplicate_categories(
+        cls, categories: list[SearchCategory]
+    ) -> list[SearchCategory]:
+        """Preserve the first requested category while removing duplicates."""
+        return list(dict.fromkeys(categories))
+
+    @model_validator(mode="after")
+    def _validate_date_range(self) -> "GlobalSearchQuery":
+        if (
+            self.created_after is not None
+            and self.created_before is not None
+            and self.created_after > self.created_before
+        ):
+            raise ValueError("created_after must be before or equal to created_before")
+        return self
+
+    @property
+    def normalized_query(self) -> str:
+        """Return query text with leading and trailing whitespace removed."""
+        return self.query.strip()
+
+    @property
+    def is_blank(self) -> bool:
+        """Whether the route must return an empty response without searching."""
+        return not self.normalized_query
+
+
+class GlobalSearchResponse(BaseModel):
+    """Public response shape shared by typeahead and full global search."""
+
+    query: str
+    is_typeahead: bool
+    suggestions: list[SearchSuggestion] = Field(default_factory=list)
+    total: int = Field(default=0, ge=0)
+    limit: int = Field(default=20, ge=1)
+    offset: int = Field(default=0, ge=0)
+    facets: dict[str, dict[str, int]] | None = None
+
+
+class SearchResult(BaseModel):
+    """Result from a search query.
+
+    Contains matching items with pagination metadata.
+
+    Attributes:
+        items: List of matching documents
+        total: Total count of matches
+        limit: Maximum results per page
+        offset: Number of results skipped
+        facets: Optional facet/aggregation results
+        highlights: Optional highlighted snippets per doc ID
+    """
+
+    items: list[dict[str, Any]]
+    total: int
+    limit: int
+    offset: int
+    facets: dict[str, dict[str, int]] | None = None
+    highlights: dict[str, dict[str, str]] | None = None
+
+    @computed_field  # type: ignore[prop-decorator]
+    @property
+    def has_more(self) -> bool:
+        """Check if more results exist beyond current page."""
+        return self.offset + len(self.items) < self.total
+
+
+class SearchProtocol(Protocol):
+    """Protocol defining the contract for full-text search.
+
+    This is the primary port for search operations in the hexagonal
+    architecture. Implementations handle different search engines.
+
+    Global-search convention:
+
+    * ``doctype="*"`` searches every provider-supported DocType. Providers
+      that cannot search a DocType return an empty result rather than raising.
+    * Global results use :class:`SearchSuggestion` dictionaries in
+      :attr:`SearchResult.items`; legacy document dictionaries remain valid for
+      backwards compatibility.
+    * A composite provider invokes providers concurrently, preserves configured
+      provider order for equal scores, deduplicates by suggestion ``id``, and
+      applies ``offset``/``limit`` only after merging and deduplication.
+    * ``SearchResult.total`` for a composite is the post-deduplication count
+      before paging. Individual provider failures are isolated and observable.
+
+    Implementations include:
+    - MeilisearchAdapter: Meilisearch search engine
+    - ElasticsearchAdapter: Elasticsearch/OpenSearch
+    - WhooshAdapter: Pure Python search (for development)
+
+    Example usage:
+        search: SearchProtocol = container.get(SearchProtocol)
+
+        # Index a document
+        await search.index("Todo", "todo-001", {"title": "Buy milk"})
+
+        # Search
+        result = await search.search("Todo", "milk", limit=10)
+        # Process results
+    """
+
+    async def index(
+        self,
+        doctype: str,
+        doc_id: str,
+        doc: dict[str, Any],
+    ) -> None:
+        """Index a document for searching.
+
+        Args:
+            doctype: DocType name (used as index name)
+            doc_id: Document identifier
+            doc: Document data to index
+        """
+        ...
+
+    async def delete_index(
+        self,
+        doctype: str,
+        doc_id: str,
+    ) -> None:
+        """Remove a document from the search index.
+
+        Args:
+            doctype: DocType name
+            doc_id: Document identifier
+        """
+        ...
+
+    async def search(
+        self,
+        doctype: str,
+        query: str,
+        *,
+        filters: dict[str, Any] | None = None,
+        limit: int = 20,
+        offset: int = 0,
+    ) -> SearchResult:
+        """Search for documents.
+
+        Args:
+            doctype: DocType name to search in
+            query: Search query string
+            filters: Optional field filters
+            limit: Maximum results to return
+            offset: Number of results to skip
+
+        Returns:
+            SearchResult with matching documents
+        """
+        ...
+
+    async def reindex(self, doctype: str) -> int:
+        """Rebuild the entire index for a DocType.
+
+        Fetches all documents from the repository and re-indexes them.
+
+        Args:
+            doctype: DocType name to reindex
+
+        Returns:
+            Number of documents indexed
+        """
+        ...
+
+
+__all__ = [
+    "GlobalSearchQuery",
+    "GlobalSearchResponse",
+    "SearchCategory",
+    "SearchProtocol",
+    "SearchResult",
+    "SearchSuggestion",
+]