@stackable-labs/sdk-extension-contracts 1.0.0

package/LICENSE

@@ -0,0 +1,29 @@
+LICENSE
+
+Copyright (c) 2026-present UNIQUELY PARTICULAR LLC, STACKABLE LABS, LLC, agnoStack, Inc., and Adam Grohs ("Author" herein)
+
+Permission is hereby granted to use, copy, and modify this software
+(the "Software") solely for the purpose of developing, testing,
+or maintaining integration with Author's products and services.
+
+The Software may not be used:
+- as a standalone product or service,
+- to integrate with any platform or service other than Author's,
+- to build or enhance a competing product or service,
+- or for any purpose unrelated to integrations with Author.
+
+Redistribution of the Software, in whole or in part, is permitted
+only as part of an application or service that integrates with Author
+and does not expose the Software as a general-purpose library.
+
+This Software is provided "AS IS", without warranty of any kind, express
+or implied, including but not limited to the warranties of merchantability,
+fitness for a particular purpose, and noninfringement.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+PUBLISHER, AUTHORS, ANY CONTRIBUTOR OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
+OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# @stackable-labs/sdk-extension-contracts
+
+TypeScript contracts, interfaces, and types for building Stackable extensions.
+
+## Installation
+
+```bash
+npm install @stackable-labs/sdk-extension-contracts
+```
+
+## What's included
+
+- Extension manifest types (`ExtensionManifest`, `ExtensionRegistryEntry`)
+- Permission interfaces and identifiers
+- Target/slot type definitions
+- Shared RPC protocol types used across the Stackable SDK
+- Domain types (`Customer`, `Order`, etc.) for ecommerce capability responses
+
+## Usage
+
+```ts
+import type { ExtensionManifest, CapabilityCall, Order } from '@stackable-labs/sdk-extension-contracts';
+```
+
+## Changelog
+
+See [npm version history](https://www.npmjs.com/package/@stackable-labs/sdk-extension-contracts?activeTab=versions).
+
+## License
+
+SEE LICENSE IN [LICENSE](./LICENSE)

package/dist/api.d.ts

@@ -0,0 +1,16 @@
+export interface ApiRequest {
+    action: 'getOrder' | 'getOrders' | 'getCustomer';
+    orderId?: string;
+    customerId?: string;
+    email?: string;
+}
+export interface ApiResponse<T = unknown> {
+    success: boolean;
+    data: T;
+    action: string;
+}
+export interface ApiError {
+    error: string;
+    status?: number;
+    message?: string;
+}

package/dist/api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":""}

package/dist/capabilities.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Capabilities Contract
+ * Defines the host-mediated APIs that extensions can call via RPC.
+ */
+import type { ApiRequest } from './api';
+/** Payload for actions.toast capability */
+export interface ToastPayload {
+    message: string;
+    type?: 'success' | 'error' | 'info' | 'warning';
+    duration?: number;
+}
+/** Payload for actions.invoke capability */
+export interface ActionInvokePayload {
+    action: string;
+    payload?: Record<string, unknown>;
+}
+/** Context returned by context.read capability */
+export interface ContextData {
+    customerId?: string;
+    customerEmail?: string;
+    [key: string]: unknown;
+}
+/** Union of all capability call types */
+export type CapabilityCall = {
+    type: 'data.query';
+    payload: ApiRequest;
+} | {
+    type: 'actions.toast';
+    payload: ToastPayload;
+} | {
+    type: 'actions.invoke';
+    payload: ActionInvokePayload;
+} | {
+    type: 'context.read';
+};
+export type CapabilityType = CapabilityCall['type'];

package/dist/capabilities.js

@@ -0,0 +1,6 @@
+/**
+ * Capabilities Contract
+ * Defines the host-mediated APIs that extensions can call via RPC.
+ */
+export {};
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/common.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared primitive types used across contracts.
+ */
+/** Lightweight reference to a named entity (e.g. extension, instance). */
+export interface NamedEntity {
+    id: string;
+    name: string;
+}

package/dist/common.js

@@ -0,0 +1,5 @@
+/**
+ * Shared primitive types used across contracts.
+ */
+export {};
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/components.d.ts

@@ -0,0 +1,18 @@
+/**
+ * UI Component Contract
+ * Defines the fixed set of UI tags that extensions can render.
+ * The host maps these to real React components.
+ */
+export declare const UI_TAGS: readonly ["ui-card", "ui-card-content", "ui-card-header", "ui-button", "ui-text", "ui-heading", "ui-badge", "ui-input", "ui-stack", "ui-inline", "ui-separator", "ui-tabs", "ui-tabs-list", "ui-tabs-trigger", "ui-tabs-content", "ui-scroll-area", "ui-avatar", "ui-avatar-image", "ui-avatar-fallback", "ui-icon", "ui-link", "ui-menu", "ui-menu-item"];
+export type UITag = (typeof UI_TAGS)[number];
+/**
+ * Allowed attributes per UI tag.
+ * Host should reject any attributes not in this allowlist.
+ */
+export declare const UI_TAG_ATTRIBUTES: Record<UITag, readonly string[]>;
+/**
+ * Supported icon names (subset of lucide-react).
+ * Extensions reference icons by name; host renders the actual icon component.
+ */
+export declare const ALLOWED_ICONS: readonly ["arrow-left", "calendar", "check-circle-2", "chevron-left", "chevron-right", "clock", "credit-card", "external-link", "help-circle", "info", "loader-2", "mail", "map-pin", "message-circle", "message-square", "package", "phone", "search", "shopping-bag", "sparkles", "truck", "user", "x-circle", "alert-circle", "book-open"];
+export type AllowedIconName = (typeof ALLOWED_ICONS)[number];

package/dist/components.js

@@ -0,0 +1,91 @@
+/**
+ * UI Component Contract
+ * Defines the fixed set of UI tags that extensions can render.
+ * The host maps these to real React components.
+ */
+export const UI_TAGS = [
+    'ui-card',
+    'ui-card-content',
+    'ui-card-header',
+    'ui-button',
+    'ui-text',
+    'ui-heading',
+    'ui-badge',
+    'ui-input',
+    'ui-stack',
+    'ui-inline',
+    'ui-separator',
+    'ui-tabs',
+    'ui-tabs-list',
+    'ui-tabs-trigger',
+    'ui-tabs-content',
+    'ui-scroll-area',
+    'ui-avatar',
+    'ui-avatar-image',
+    'ui-avatar-fallback',
+    'ui-icon',
+    'ui-link',
+    'ui-menu',
+    'ui-menu-item'
+];
+/**
+ * Allowed attributes per UI tag.
+ * Host should reject any attributes not in this allowlist.
+ */
+export const UI_TAG_ATTRIBUTES = {
+    'ui-card': ['className', 'onClick'],
+    'ui-card-content': ['className'],
+    'ui-card-header': ['className'],
+    'ui-button': ['variant', 'size', 'disabled', 'onClick', 'type', 'className', 'title'],
+    'ui-text': ['className', 'tone'],
+    'ui-heading': ['level', 'className'],
+    'ui-badge': ['variant', 'tone', 'className'],
+    'ui-input': ['type', 'placeholder', 'value', 'onChange', 'disabled', 'className', 'id'],
+    'ui-stack': ['gap', 'direction', 'align', 'className'],
+    'ui-inline': ['gap', 'align', 'className'],
+    'ui-separator': ['className'],
+    'ui-tabs': ['defaultValue', 'className'],
+    'ui-tabs-list': ['className'],
+    'ui-tabs-trigger': ['value', 'className'],
+    'ui-tabs-content': ['value', 'className'],
+    'ui-scroll-area': ['className'],
+    'ui-avatar': ['className'],
+    'ui-avatar-image': ['src', 'alt', 'className'],
+    'ui-avatar-fallback': ['className'],
+    'ui-icon': ['name', 'size', 'className'],
+    'ui-link': ['href', 'target', 'rel', 'className'],
+    'ui-menu-item': ['icon', 'label', 'description', 'onClick', 'className'],
+    'ui-menu': ['title', 'className'],
+};
+/**
+ * Supported icon names (subset of lucide-react).
+ * Extensions reference icons by name; host renders the actual icon component.
+ */
+export const ALLOWED_ICONS = [
+    'arrow-left',
+    'calendar',
+    'check-circle-2',
+    'chevron-left',
+    'chevron-right',
+    'clock',
+    'credit-card',
+    'external-link',
+    'help-circle',
+    'info',
+    'loader-2',
+    'mail',
+    'map-pin',
+    'message-circle',
+    'message-square',
+    'package',
+    'phone',
+    'search',
+    'shopping-bag',
+    'sparkles',
+    'truck',
+    'user',
+    'x-circle',
+    'alert-circle',
+    'book-open'
+];
+//# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,SAAS;IACT,iBAAiB;IACjB,gBAAgB;IAChB,WAAW;IACX,SAAS;IACT,YAAY;IACZ,UAAU;IACV,UAAU;IACV,UAAU;IACV,WAAW;IACX,cAAc;IACd,SAAS;IACT,cAAc;IACd,iBAAiB;IACjB,iBAAiB;IACjB,gBAAgB;IAChB,WAAW;IACX,iBAAiB;IACjB,oBAAoB;IACpB,SAAS;IACT,SAAS;IACT,SAAS;IACT,cAAc;CACN,CAAA;AAIV;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IACjE,SAAS,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;IACnC,iBAAiB,EAAE,CAAC,WAAW,CAAC;IAChC,gBAAgB,EAAE,CAAC,WAAW,CAAC;IAC/B,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC;IACrF,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;IACpC,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC;IAC5C,UAAU,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC;IACvF,UAAU,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC;IACtD,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC;IAC1C,cAAc,EAAE,CAAC,WAAW,CAAC;IAC7B,SAAS,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;IACxC,cAAc,EAAE,CAAC,WAAW,CAAC;IAC7B,iBAAiB,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;IACzC,iBAAiB,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;IACzC,gBAAgB,EAAE,CAAC,WAAW,CAAC;IAC/B,WAAW,EAAE,CAAC,WAAW,CAAC;IAC1B,iBAAiB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC;IAC9C,oBAAoB,EAAE,CAAC,WAAW,CAAC;IACnC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC;IACxC,SAAS,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC;IACjD,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,CAAC;IACxE,SAAS,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;CAClC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,YAAY;IACZ,UAAU;IACV,gBAAgB;IAChB,cAAc;IACd,eAAe;IACf,OAAO;IACP,aAAa;IACb,eAAe;IACf,aAAa;IACb,MAAM;IACN,UAAU;IACV,MAAM;IACN,SAAS;IACT,gBAAgB;IAChB,gBAAgB;IAChB,SAAS;IACT,OAAO;IACP,QAAQ;IACR,cAAc;IACd,UAAU;IACV,OAAO;IACP,MAAM;IACN,UAAU;IACV,cAAc;IACd,WAAW;CACH,CAAA"}

package/dist/ecommerce.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Ecommerce Type Definitions
+ * Ported from zendesk-embedded-widget/app/src/types/ecommerce.ts
+ */
+export interface Price {
+    currency: string;
+    amount: number;
+    precise: number;
+    rounded: string;
+    formatted: string;
+}
+export interface Address {
+    id: string;
+    type: 'address';
+    first_name: string;
+    last_name: string;
+    phone: string;
+    line_1: string;
+    line_2: string;
+    city: string;
+    region: string;
+    postcode: string;
+    country: string;
+    meta?: {
+        entity_id: string;
+    };
+}
+export type DataFieldType = 'data_boolean' | 'data_text' | 'data_pill' | 'data_badge' | 'data_price' | 'data_highlight' | 'data_datestamp';
+export interface DataField {
+    identifier: string;
+    type: DataFieldType;
+    value: unknown;
+    editable?: boolean;
+    label?: string;
+}
+export interface Customer {
+    id: string;
+    url: string;
+    type: 'guest' | 'registered';
+    name: string;
+    first_name: string;
+    last_name: string;
+    email: string;
+    phone: string;
+    data: Array<{
+        data: DataField[];
+        provider: string;
+    }>;
+    meta: {
+        tags: {
+            data: string[];
+        };
+        entity_id: string;
+        total_orders: string;
+    };
+    relationships: {
+        notes: Array<{
+            id: string;
+            type: 'note';
+            messages: string[];
+            editable: boolean;
+        }>;
+        metadata: Array<{
+            identifier: string;
+            data: DataField[];
+        }>;
+        addresses: Address[];
+    };
+}
+export interface OrderStatus {
+    vendor: string;
+    color: string;
+    abbreviation: string;
+    label: string;
+}
+export interface OrderStatuses {
+    note: string;
+    alerts: unknown[];
+    isPaid: boolean;
+    isShipped: boolean;
+    isRefunded: boolean;
+    isCancelled: boolean;
+    isRefundable: boolean;
+    hasBalanceOwed: boolean;
+    isCancellable: boolean;
+    isModifiable: boolean;
+    order: OrderStatus;
+    payment: OrderStatus;
+    shipping: OrderStatus;
+    refund: OrderStatus;
+}
+export interface OrderItem {
+    id: string;
+    type: 'order_item' | 'custom_item';
+    sku: string;
+    name: string;
+    quantity: number;
+    refunded: number;
+    modified?: number;
+    url?: string;
+    statuses?: {
+        isShipped: boolean;
+        isModifiable: boolean;
+    };
+    meta: {
+        entity_id?: string;
+        timestamps: {
+            created_at: string;
+            updated_at: string;
+        };
+        actions?: Array<{
+            id: string;
+            type: string;
+            label: {
+                key: string;
+            };
+            url?: string;
+        }>;
+        product?: unknown;
+        price_mode?: string;
+        display_price: {
+            with_tax: {
+                unit: Price;
+                value: Price;
+            };
+            without_tax: {
+                unit: Price;
+                value: Price;
+            };
+            tax: {
+                unit: Price;
+                value: Price;
+            };
+        };
+        discount_price?: {
+            with_tax: {
+                unit: Price;
+                value: Price;
+            };
+            without_tax: {
+                unit: Price;
+                value: Price;
+            };
+            tax: {
+                unit: Price;
+                value: Price;
+            };
+        };
+        vendor?: string;
+    };
+    relationships?: {
+        shipping?: {
+            parcels?: Array<{
+                id: string;
+                shipment_status: string;
+                trackings: Array<{
+                    tracking_number: string;
+                    carrier: string;
+                    carrier_code: string;
+                    service_code?: string;
+                    url?: string;
+                }>;
+                name?: string;
+                timestamps?: {
+                    created_at: string;
+                };
+            }>;
+        };
+    };
+}
+export interface Shipment {
+    id: string;
+    shipping_address: Address;
+}
+export interface OrderAction {
+    id: string;
+    type: 'order_action';
+    label: {
+        key: string;
+    };
+    url?: string;
+    confirm?: boolean;
+}
+export interface Order {
+    id: string;
+    type: 'order';
+    url: string;
+    transaction_id: string;
+    statuses: OrderStatuses;
+    actions?: OrderAction[];
+    billing_address?: Address;
+    shipments: Shipment[];
+    relationships: {
+        items: {
+            data: OrderItem[];
+        };
+        transactions?: {
+            data: unknown[];
+        };
+        customer: {
+            data: {
+                type: 'customer';
+                id: string;
+                url: string;
+                name: string;
+                phone: string;
+                email: string;
+            };
+        };
+    };
+    meta: {
+        timestamps: {
+            created_at: string;
+            updated_at: string;
+        };
+        tax_mode: string;
+        entity_id: string;
+        tags: {
+            data: string[];
+        };
+        display_price: {
+            with_tax: Price;
+            without_tax: Price;
+            tax: Price;
+        };
+        display_balance_price?: {
+            with_tax: Price;
+        };
+        refundable_balance_price?: {
+            with_tax: Price;
+        };
+    };
+    display_status?: OrderStatus;
+}

package/dist/ecommerce.js

@@ -0,0 +1,6 @@
+/**
+ * Ecommerce Type Definitions
+ * Ported from zendesk-embedded-widget/app/src/types/ecommerce.ts
+ */
+export {};
+//# sourceMappingURL=ecommerce.js.map

package/dist/ecommerce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecommerce.js","sourceRoot":"","sources":["../src/ecommerce.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './common';
+export * from './api';
+export * from './components';
+export * from './capabilities';
+export * from './instance';
+export * from './permissions';
+export * from './manifest';
+export * from './surface';
+export * from './rpc';
+export * from './ecommerce';

package/dist/index.js

@@ -0,0 +1,11 @@
+export * from './common';
+export * from './api';
+export * from './components';
+export * from './capabilities';
+export * from './instance';
+export * from './permissions';
+export * from './manifest';
+export * from './surface';
+export * from './rpc';
+export * from './ecommerce';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,OAAO,CAAA;AACrB,cAAc,aAAa,CAAA"}

package/dist/instance.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Instance Contract
+ * Shared types for extension instances used by both host and admin.
+ */
+export type Theme = 'light' | 'dark';
+export type InstanceSettings = {
+    theme?: Theme;
+} & Record<string, unknown>;
+export interface InstanceOption {
+    id: string;
+    name: string;
+    settings?: InstanceSettings;
+}

package/dist/instance.js

@@ -0,0 +1,6 @@
+/**
+ * Instance Contract
+ * Shared types for extension instances used by both host and admin.
+ */
+export {};
+//# sourceMappingURL=instance.js.map

package/dist/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/manifest.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Extension Manifest Schema
+ * Declared by extension developers in manifest.json.
+ */
+import type { Permission } from './permissions';
+/**
+ * An extension point target identifier (e.g. "slot.header").
+ * Apps define which targets they expose; this is not a fixed list.
+ */
+export type Target = string;
+export interface ExtensionManifest {
+    /** Human-readable extension name */
+    name: string;
+    /** Semver version string */
+    version: string;
+    /** Extension point targets this extension renders into */
+    targets: string[];
+    /** Permissions required by this extension */
+    permissions: Permission[];
+}
+/**
+ * Registry entry for an installed extension (returned by /api/extensions).
+ */
+export interface ExtensionRegistryEntry {
+    /** Unique extension ID */
+    id: string;
+    /** Extension manifest */
+    manifest: ExtensionManifest;
+    /** URL to the extension's JS bundle */
+    bundleUrl: string;
+    /** Whether the extension is enabled */
+    enabled: boolean;
+}

package/dist/manifest.js

@@ -0,0 +1,6 @@
+/**
+ * Extension Manifest Schema
+ * Declared by extension developers in manifest.json.
+ */
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/permissions.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Permissions Contract
+ * Extensions declare required permissions in their manifest.
+ * Host enforces: capability calls must be a subset of granted permissions.
+ */
+export declare const PERMISSIONS: readonly ["context:read", "data:query", "actions:toast", "actions:invoke"];
+export type Permission = (typeof PERMISSIONS)[number];
+/**
+ * Maps capability types to the permission required to use them.
+ */
+export declare const CAPABILITY_PERMISSION_MAP: Record<string, Permission>;

package/dist/permissions.js

@@ -0,0 +1,21 @@
+/**
+ * Permissions Contract
+ * Extensions declare required permissions in their manifest.
+ * Host enforces: capability calls must be a subset of granted permissions.
+ */
+export const PERMISSIONS = [
+    'context:read',
+    'data:query',
+    'actions:toast',
+    'actions:invoke'
+];
+/**
+ * Maps capability types to the permission required to use them.
+ */
+export const CAPABILITY_PERMISSION_MAP = {
+    'context.read': 'context:read',
+    'data.query': 'data:query',
+    'actions.toast': 'actions:toast',
+    'actions.invoke': 'actions:invoke',
+};
+//# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,cAAc;IACd,YAAY;IACZ,eAAe;IACf,gBAAgB;CACR,CAAA;AAIV;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAA+B;IACnE,cAAc,EAAE,cAAc;IAC9B,YAAY,EAAE,YAAY;IAC1B,eAAe,EAAE,eAAe;IAChC,gBAAgB,EAAE,gBAAgB;CACnC,CAAA"}

package/dist/rpc.d.ts

@@ -0,0 +1,35 @@
+/**
+ * RPC Protocol Types
+ * Messages exchanged between sandbox (extension) and host for capability calls.
+ */
+import type { CapabilityType } from './capabilities';
+/** Request from extension sandbox to host */
+export interface CapabilityRequest {
+    type: 'capability-request';
+    id: string;
+    capability: CapabilityType;
+    payload: unknown;
+}
+/** Response from host to extension sandbox */
+export interface CapabilityResponse {
+    type: 'capability-response';
+    id: string;
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+/** All message types that can be sent between host and sandbox */
+export type HostToSandboxMessage = {
+    type: 'surface-lifecycle';
+    data: import('./surface.js').SurfaceLifecycleMessage;
+} | CapabilityResponse | {
+    type: 'context-update';
+    surfaceId: string;
+    context: Record<string, unknown>;
+};
+export type SandboxToHostMessage = CapabilityRequest | {
+    type: 'surface-ready';
+    surfaceId: string;
+} | {
+    type: 'extension-ready';
+};

package/dist/rpc.js

@@ -0,0 +1,6 @@
+/**
+ * RPC Protocol Types
+ * Messages exchanged between sandbox (extension) and host for capability calls.
+ */
+export {};
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/surface.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Surface Lifecycle Contract
+ * Messages exchanged between host and sandbox for surface management.
+ */
+export interface SurfaceContext {
+    [key: string]: unknown;
+}
+export type SurfaceLifecycleMessage = {
+    type: 'createSurface';
+    surfaceId: string;
+    target: string;
+    context: SurfaceContext;
+} | {
+    type: 'updateSurfaceContext';
+    surfaceId: string;
+    context: SurfaceContext;
+} | {
+    type: 'destroySurface';
+    surfaceId: string;
+};

package/dist/surface.js

@@ -0,0 +1,6 @@
+/**
+ * Surface Lifecycle Contract
+ * Messages exchanged between host and sandbox for surface management.
+ */
+export {};
+//# sourceMappingURL=surface.js.map

package/dist/surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@stackable-labs/sdk-extension-contracts",
+  "version": "1.0.0",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "description": "TypeScript contracts and interfaces for Stackable extensions.",
+  "license": "SEE LICENSE IN LICENSE",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://www.npmjs.com/package/@stackable-labs/sdk-extension-contracts",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ]
+}