static_tr_plugin/
module.rs

1//! Static tenant resolver plugin module.
2
3use std::sync::{Arc, OnceLock};
4
5use async_trait::async_trait;
6use modkit::Module;
7use modkit::client_hub::ClientScope;
8use modkit::context::ModuleCtx;
9use modkit::gts::BaseModkitPluginV1;
10use tenant_resolver_sdk::{TenantResolverPluginClient, TenantResolverPluginSpecV1};
11use tracing::info;
12use types_registry_sdk::{RegisterResult, TypesRegistryClient};
13
14use crate::config::StaticTrPluginConfig;
15use crate::domain::Service;
16
17/// Static tenant resolver plugin module.
18///
19/// Provides tenant data from configuration with hierarchical support.
20///
21/// **Plugin registration pattern:**
22/// - Gateway registers the plugin schema (GTS type definition)
23/// - This plugin registers its instance (implementation metadata)
24/// - This plugin registers its scoped client (implementation in `ClientHub`)
25#[modkit::module(
26    name = "static-tr-plugin",
27    deps = ["types-registry"]
28)]
29pub struct StaticTrPlugin {
30    service: OnceLock<Arc<Service>>,
31}
32
33impl Default for StaticTrPlugin {
34    fn default() -> Self {
35        Self {
36            service: OnceLock::new(),
37        }
38    }
39}
40
41#[async_trait]
42impl Module for StaticTrPlugin {
43    async fn init(&self, ctx: &ModuleCtx) -> anyhow::Result<()> {
44        // Load configuration
45        let cfg: StaticTrPluginConfig = ctx.config()?;
46        info!(
47            vendor = %cfg.vendor,
48            priority = cfg.priority,
49            tenant_count = cfg.tenants.len(),
50            "Loaded plugin configuration"
51        );
52
53        // Generate plugin instance ID
54        let instance_id = TenantResolverPluginSpecV1::gts_make_instance_id(
55            "hyperspot.builtin.static_tenant_resolver.plugin.v1",
56        );
57
58        // Register plugin instance in types-registry
59        let registry = ctx.client_hub().get::<dyn TypesRegistryClient>()?;
60        let instance = BaseModkitPluginV1::<TenantResolverPluginSpecV1> {
61            id: instance_id.clone(),
62            vendor: cfg.vendor.clone(),
63            priority: cfg.priority,
64            properties: TenantResolverPluginSpecV1,
65        };
66        let instance_json = serde_json::to_value(&instance)?;
67
68        let results = registry.register(vec![instance_json]).await?;
69        RegisterResult::ensure_all_ok(&results)?;
70
71        // Create service from config
72        let service = Arc::new(Service::from_config(&cfg));
73        self.service
74            .set(service.clone())
75            .map_err(|_| anyhow::anyhow!("{} module already initialized", Self::MODULE_NAME))?;
76
77        // Register scoped client in ClientHub
78        let api: Arc<dyn TenantResolverPluginClient> = service;
79        ctx.client_hub()
80            .register_scoped::<dyn TenantResolverPluginClient>(
81                ClientScope::gts_id(&instance_id),
82                api,
83            );
84
85        info!(instance_id = %instance_id);
86        Ok(())
87    }
88}
static_tr_plugin/module.rs

static_tr_plugin/
module.rs
