@stackable-labs/sdk-extension-contracts 1.42.1 → 1.43.0

package/dist/index.d.ts

@@ -404,9 +404,40 @@ type CapabilityCall = {
     payload: ActionInvokePayload;
 } | {
     type: 'context.read';
+} | {
+    type: 'identity.read';
+} | {
+    type: 'identity.extend';
+    payload: {
+        claims: Record<string, unknown>;
+    };
 };
 type CapabilityType = CapabilityCall['type'];
 
+/**
+ * Identity Contract
+ * Types for the identity/auth event system.
+ */
+type AuthEventType = 'identity.login' | 'identity.logout' | 'identity.refresh' | 'identity.expired';
+interface UserIdentity {
+    id: string;
+    email?: string;
+    name?: string;
+    avatarUrl?: string;
+    provider: string;
+    metadata?: Record<string, unknown>;
+}
+interface AuthState {
+    authenticated: boolean;
+    user: UserIdentity | null;
+    expiresAt?: string;
+}
+interface AuthEvent {
+    type: AuthEventType;
+    state: AuthState;
+    timestamp: string;
+}
+
 /**
  * Instance Contract
  * Shared types for extension instances used by both host and admin.
@@ -415,8 +446,12 @@ type Theme = 'light' | 'dark';
 interface InstanceConfig {
     settings?: {
         theme?: Theme;
+        identityId?: string;
+        identityProvider?: string;
+    } & Record<string, unknown>;
+    secrets?: {
+        identityKey?: string;
     } & Record<string, unknown>;
-    secrets?: Record<string, unknown>;
 }
 interface InstanceOption {
     id: string;
@@ -429,7 +464,7 @@ interface InstanceOption {
  * Extensions declare required permissions in their manifest.
  * Host enforces: capability calls must be a subset of granted permissions.
  */
-declare const PERMISSIONS: readonly ["context:read", "data:query", "data:fetch", "actions:toast", "actions:invoke"];
+declare const PERMISSIONS: readonly ["context:read", "data:query", "data:fetch", "actions:toast", "actions:invoke", "identity:read", "identity:subscribe", "identity:extend"];
 type Permission = (typeof PERMISSIONS)[number];
 /**
  * Maps capability types to the permission required to use them.
@@ -536,6 +571,10 @@ type HostToSandboxMessage = {
 } | {
     type: 'extension-encryption-key';
     encryptionKey: string;
+} | {
+    type: 'extension-event';
+    eventType: string;
+    payload: EncryptedPayload | unknown;
 };
 type SandboxToHostMessage = CapabilityRequest | {
     type: 'surface-ready';
@@ -782,4 +821,4 @@ interface Order {
     display_status?: OrderStatus;
 }
 
-export { ALLOWED_ICONS, type ActionInvokePayload, type Address, type AllowedIconName, type ApiError, type ApiRequest, type ApiResponse, CAPABILITY_PERMISSION_MAP, type CapabilityCall, type CapabilityRequest, type CapabilityResponse, type CapabilityType, type ContextData, type Customer, type DataField, type DataFieldType, type EncryptedPayload, type ExtensionManifest, type ExtensionRegistryEntry, type FetchRequest, type FetchRequestInit, type FetchResponse, type HostToSandboxMessage, type InstanceConfig, type InstanceOption, type InvokeAction, type MarketplaceExtension, type MessengerCommand, type NamedEntity, type Order, type OrderAction, type OrderItem, type OrderStatus, type OrderStatuses, PERMISSIONS, type Permission, type Price, type SandboxToHostMessage, type Shipment, type SurfaceContext, type SurfaceLifecycleMessage, type Target, 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_DEFINITIONS, type WidgetAction, tagToComponentName };
+export { ALLOWED_ICONS, type ActionInvokePayload, type Address, type AllowedIconName, type ApiError, type ApiRequest, type ApiResponse, type AuthEvent, type AuthEventType, type AuthState, CAPABILITY_PERMISSION_MAP, type CapabilityCall, type CapabilityRequest, type CapabilityResponse, type CapabilityType, type ContextData, type Customer, type DataField, type DataFieldType, type EncryptedPayload, type ExtensionManifest, type ExtensionRegistryEntry, type FetchRequest, type FetchRequestInit, type FetchResponse, type HostToSandboxMessage, type InstanceConfig, type InstanceOption, type InvokeAction, type MarketplaceExtension, type MessengerCommand, type NamedEntity, type Order, type OrderAction, type OrderItem, type OrderStatus, type OrderStatuses, PERMISSIONS, type Permission, type Price, type SandboxToHostMessage, type Shipment, type SurfaceContext, type SurfaceLifecycleMessage, type Target, 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_DEFINITIONS, type UserIdentity, type WidgetAction, tagToComponentName };

package/dist/index.js

@@ -306,14 +306,19 @@ var PERMISSIONS = [
   "data:query",
   "data:fetch",
   "actions:toast",
-  "actions:invoke"
+  "actions:invoke",
+  "identity:read",
+  "identity:subscribe",
+  "identity:extend"
 ];
 var CAPABILITY_PERMISSION_MAP = {
   "context.read": "context:read",
   "data.query": "data:query",
   "data.fetch": "data:fetch",
   "actions.toast": "actions:toast",
-  "actions.invoke": "actions:invoke"
+  "actions.invoke": "actions:invoke",
+  "identity.read": "identity:read",
+  "identity.extend": "identity:extend"
 };
 
 // ../../../lib/contracts/src/permissions.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackable-labs/sdk-extension-contracts",
-  "version": "1.42.1",
+  "version": "1.43.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",