@stackable-labs/sdk-extension-contracts 2.15.0 → 2.16.0

package/dist/index.d.ts

@@ -659,10 +659,31 @@ interface InstanceConfig {
         identityKey?: string;
     } & Record<string, unknown>;
 }
+/**
+ * ExtensionGroup — an ordered slice of an Instance's authorized extensions with shared collapse behavior.
+ *
+ * Renders to end users as either an always-open stack (collapsible=false) or one of two
+ * collapsible modes controlled by `oneAtATime`:
+ *   - oneAtATime=true  → accordion: one row open at a time, at least one must stay open
+ *   - oneAtATime=false → free-form: any combination open/closed, user can collapse all
+ * Max 4 groups per instance. Single-extension instances do NOT use groups — they render
+ * always-open via the hard-rule fallback.
+ *
+ * Immutability rule: once a group is persisted with a given `id`, that id is stable across all
+ * subsequent updates. Renderer + admin UI key off `id` for collapse-state tracking.
+ */
+interface ExtensionGroup {
+    id: string;
+    label?: string;
+    collapsible: boolean;
+    oneAtATime: boolean;
+    extensionIds: string[];
+}
 interface InstanceOption {
     id: string;
     name: string;
     config?: InstanceConfig;
+    extensionGroups?: ExtensionGroup[];
 }
 
 /**
@@ -1087,4 +1108,4 @@ interface Order {
 declare const TEMPLATE_FLAVORS: readonly ["minimal", "starter", "kitchen-sink"];
 type TemplateFlavor = typeof TEMPLATE_FLAVORS[number];
 
-export { ACTIVITY_EVENT, ALLOWED_ICONS, type ActionInvokePayload, type ActionPayloadMap, type ActivityEvent, type ActivityEventHandler, type ActivityEventType, type Address, type AllowedIconName, type ApiError, type ApiRequest, type ApiResponse, CAPABILITY_PERMISSION_MAP, type Capability, type CapabilityCall, type CapabilityRequest, type CapabilityResponse, type CapabilityType, type ContextData, type ConversationField, type ConversationTags, type Customer, type DataField, type DataFieldType, EVENT_HOOK_PERMISSION_MAP, type EncryptedPayload, type EventDomain, type EventHook, type EventType, type ExtendIdentityHandler, type ExtendIdentityRequest, type ExtendIdentityResponse, type ExtensionManifest, type ExtensionRegistryEntry, type FetchRequest, type FetchRequestInit, type FetchResponse, type HostToSandboxMessage, IDENTITY_EVENT, INVOKE_ACTION, type IdentityBaseClaims, type IdentityEvent, type IdentityEventType, type IdentityState, type InstanceConfig, type InstanceOption, type InvokeAction, type MarketplaceExtension, type MessagingContext, type MessagingEvent, type MessagingEventHandler, type MessagingEventType, type MessagingPostbackEvent, type MessengerCommand, type NamedEntity, type NewConversationPayload, type Order, type OrderAction, type OrderItem, type OrderStatus, type OrderStatuses, PERMISSIONS, type Permission, type Price, RESERVED_CONTEXT_KEYS, type ReservedContextKey, SURFACE_TARGET, type SandboxToHostMessage, type Shipment, type SurfaceContext, type SurfaceLifecycleMessage, type SurfaceTarget, TEMPLATE_FLAVORS, type Target, type TemplateFlavor, type Theme, type ToastPayload, type UITag, type UITagCategory, UI_TAGS, UI_TAG_ATTRIBUTES, UI_TAG_ATTRIBUTE_VALUES, UI_TAG_CATEGORIES, UI_TAG_CHILDREN, UI_TAG_CHILD_ONLY, UI_TAG_COMPOUND, UI_TAG_DEFINITIONS, UI_TAG_SELF_CLOSING, type UserIdentity, type WellKnownActivityEvent, type WidgetAction, tagToComponentName };
+export { ACTIVITY_EVENT, ALLOWED_ICONS, type ActionInvokePayload, type ActionPayloadMap, type ActivityEvent, type ActivityEventHandler, type ActivityEventType, type Address, type AllowedIconName, type ApiError, type ApiRequest, type ApiResponse, CAPABILITY_PERMISSION_MAP, type Capability, type CapabilityCall, type CapabilityRequest, type CapabilityResponse, type CapabilityType, type ContextData, type ConversationField, type ConversationTags, type Customer, type DataField, type DataFieldType, EVENT_HOOK_PERMISSION_MAP, type EncryptedPayload, type EventDomain, type EventHook, type EventType, type ExtendIdentityHandler, type ExtendIdentityRequest, type ExtendIdentityResponse, type ExtensionGroup, type ExtensionManifest, type ExtensionRegistryEntry, type FetchRequest, type FetchRequestInit, type FetchResponse, type HostToSandboxMessage, IDENTITY_EVENT, INVOKE_ACTION, type IdentityBaseClaims, type IdentityEvent, type IdentityEventType, type IdentityState, type InstanceConfig, type InstanceOption, type InvokeAction, type MarketplaceExtension, type MessagingContext, type MessagingEvent, type MessagingEventHandler, type MessagingEventType, type MessagingPostbackEvent, type MessengerCommand, type NamedEntity, type NewConversationPayload, type Order, type OrderAction, type OrderItem, type OrderStatus, type OrderStatuses, PERMISSIONS, type Permission, type Price, RESERVED_CONTEXT_KEYS, type ReservedContextKey, SURFACE_TARGET, type SandboxToHostMessage, type Shipment, type SurfaceContext, type SurfaceLifecycleMessage, type SurfaceTarget, TEMPLATE_FLAVORS, type Target, type TemplateFlavor, type Theme, type ToastPayload, type UITag, type UITagCategory, UI_TAGS, UI_TAG_ATTRIBUTES, UI_TAG_ATTRIBUTE_VALUES, UI_TAG_CATEGORIES, UI_TAG_CHILDREN, UI_TAG_CHILD_ONLY, UI_TAG_COMPOUND, UI_TAG_DEFINITIONS, UI_TAG_SELF_CLOSING, type UserIdentity, type WellKnownActivityEvent, type WidgetAction, tagToComponentName };

package/dist/index.js

@@ -6,10 +6,11 @@ var asClerkOrgId = (value) => value;
 // ../../../lib/contracts/src/marketplace.ts
 var EXTENSION_CATEGORY = {
   COMMERCE: "commerce",
-  SUPPORT: "support",
-  ANALYTICS: "analytics",
+  LOYALTY: "loyalty",
+  CRM: "crm",
   PRODUCTIVITY: "productivity",
-  COMMUNICATION: "communication",
+  MARKETING: "marketing",
+  EMPLOYEE: "employee",
   OTHER: "other"
 };
 var EXTENSION_VISIBILITY = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackable-labs/sdk-extension-contracts",
-  "version": "2.15.0",
+  "version": "2.16.0",
   "type": "module",
   "sideEffects": false,
   "private": false,