Add hosted service showcase with examples and documentation

Author: devin-ai-integration[bot]

showcases/data/Lambda/Activator - Hosted service/code.pure

@@ -0,0 +1,50 @@
+###Pure
+// Define a simple function to be used by our hosted service
+function model::greet(name: String[1]): String[1]
+{
+  'Hello, ' + $name + '! Welcome to the hosted service.'
+}
+
+function model::processData(data: String[1]): String[1]
+{
+  'Processed data: ' + $data
+}
+
+###HostedService
+// Basic hosted service with UserList ownership
+HostedService model::BasicHostedService
+{
+  pattern: '/api/greet/{name}';
+  ownership: UserList { users: ['user1', 'user2'] };
+  function: model::greet(String[1]):String[1];
+  documentation: 'A simple hosted service that greets users by name';
+  autoActivateUpdates: true;
+}
+
+// Hosted service with Deployment ownership and stereotypes
+HostedService <<meta::pure::profiles::doc.doc>> {doc.doc='Example with deployment ownership'} model::DeploymentHostedService
+{
+  pattern: '/api/process/{data}';
+  ownership: Deployment { identifier: '12345' };
+  function: model::processData(String[1]):String[1];
+  documentation: 'A hosted service that processes data with deployment ownership';
+  autoActivateUpdates: false;
+}
+
+// Hosted service with post-deployment actions
+HostedService model::AdvancedHostedService
+{
+  pattern: '/api/advanced/{param}';
+  ownership: UserList { users: ['admin'] };
+  function: model::processData(String[1]):String[1];
+  documentation: 'Advanced hosted service with post-deployment actions';
+  autoActivateUpdates: true;
+  actions:
+  {
+    SlackNotify
+    {
+      channel: '#deployments';
+      message: 'Hosted service has been deployed';
+    }
+  }
+}

showcases/data/Lambda/Activator - Hosted service/info.md

@@ -1,7 +1,80 @@
 ---
-title: Hosted service activator
-description:
-development: true
+title: Hosted Service Activator
+description: Examples of hosted service definitions and features
 ---
 
-TODO: Some dummy description
+# Hosted Service Activator
+
+This showcase demonstrates how to define and configure hosted services in Legend. Hosted services allow you to expose Pure functions as HTTP endpoints with specific URL patterns.
+
+## Basic Features
+
+A hosted service definition requires the following elements:
+
+- **pattern**: The URL pattern for accessing the service, which can include path parameters
+- **ownership**: Who owns the service (UserList or Deployment)
+- **function**: The Pure function to be executed when the service is called
+- **documentation**: Description of what the service does
+- **autoActivateUpdates**: Whether updates to the service should be automatically activated
+
+## Example 1: Basic Hosted Service with UserList Ownership
+
+```
+HostedService model::BasicHostedService
+{
+  pattern: '/api/greet/{name}';
+  ownership: UserList { users: ['user1', 'user2'] };
+  function: model::greet(String[1]):String[1];
+  documentation: 'A simple hosted service that greets users by name';
+  autoActivateUpdates: true;
+}
+```
+
+This example defines a hosted service that:
+- Is accessible at the URL pattern `/api/greet/{name}`
+- Is owned by a list of users ('user1' and 'user2')
+- Executes the `model::greet` function when called
+- Has automatic activation of updates enabled
+
+## Example 2: Hosted Service with Deployment Ownership
+
+```
+HostedService <<meta::pure::profiles::doc.doc>> {doc.doc='Example with deployment ownership'} model::DeploymentHostedService
+{
+  pattern: '/api/process/{data}';
+  ownership: Deployment { identifier: '12345' };
+  function: model::processData(String[1]):String[1];
+  documentation: 'A hosted service that processes data with deployment ownership';
+  autoActivateUpdates: false;
+}
+```
+
+This example shows:
+- Using stereotypes and tagged values for additional metadata
+- Deployment ownership with an identifier
+- Disabling automatic activation of updates
+
+## Example 3: Advanced Features with Post-Deployment Actions
+
+```
+HostedService model::AdvancedHostedService
+{
+  pattern: '/api/advanced/{param}';
+  ownership: UserList { users: ['admin'] };
+  function: model::processData(String[1]):String[1];
+  documentation: 'Advanced hosted service with post-deployment actions';
+  autoActivateUpdates: true;
+  actions:
+  {
+    SlackNotify
+    {
+      channel: '#deployments';
+      message: 'Hosted service has been deployed';
+    }
+  }
+}
+```
+
+This example demonstrates:
+- Post-deployment actions (SlackNotify in this case)
+- Configuration of the post-deployment action