@stackable-labs/sdk-extension-react 1.103.0 → 2.1.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { ApiRequest, FetchRequestInit, FetchResponse, ToastPayload, InvokeAction, ContextData, IdentityBaseClaims, IdentityEventType, IdentityEvent, ExtendIdentityHandler, MessagingEventType, MessagingEventHandler, ActivityEventType, ActivityEventHandler, EventType, AllowedIconName } from '@stackable-labs/sdk-extension-contracts';
+import { InvokeAction, ToastPayload, ContextData, FetchRequestInit, FetchResponse, ApiRequest, IdentityBaseClaims, IdentityEventType, IdentityEvent, ExtendIdentityHandler, MessagingEventType, MessagingEventHandler, ActivityEventType, ActivityEventHandler, EventType, AllowedIconName } from '@stackable-labs/sdk-extension-contracts';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
@@ -54,7 +54,40 @@ interface ExtensionContextValue {
  */
 declare const useSurfaceContext: () => Record<string, unknown>;
 /**
- * Access host-mediated capabilities (data, actions, context).
+ * Per-capability primitives — each is a separate top-level named export
+ * carrying ONLY its own capability literal (e.g. `'data.query'`).
+ *
+ * NOTE: these are NOT React hooks. The `*Capability` suffix is deliberate —
+ * each is a thin wrapper around `callCapability(...)` exposed as an
+ * independent export so that Rollup/Vite can tree-shake unused capabilities
+ * out of an extension's `dist/extension.js`. That, combined with each SDK
+ * package's `"sideEffects": false`, is what makes `bundle-scan.ts` stop
+ * raising spurious `undeclared_permission` errors (STA-157).
+ *
+ * Tree-shaking only works because each capability is its own export. The
+ * `useCapabilities()` aggregator below still references all 6 — anyone who
+ * uses it gets every literal in their bundle, by design (accepted trade-off
+ * for the ergonomic single-import surface). Prefer the per-capability
+ * exports for new code when bundle size or scanner cleanliness matters.
+ */
+declare const contextReadCapability: () => Promise<ContextData>;
+declare const dataQueryCapability: <T = unknown>(payload: ApiRequest) => Promise<T>;
+declare const dataFetchCapability: (url: string, init?: FetchRequestInit) => Promise<FetchResponse>;
+declare const actionsToastCapability: (payload: ToastPayload) => Promise<void>;
+declare const actionsInvokeCapability: <T = unknown>(action: InvokeAction, payload?: Record<string, unknown>) => Promise<T>;
+declare const extendIdentityCapability: (payload: {
+    claims: IdentityBaseClaims;
+}) => Promise<{
+    additionalClaims: Record<string, unknown>;
+}>;
+/**
+ * Access host-mediated capabilities (data, actions, context, extend).
+ *
+ * Aggregator. References every per-capability primitive above as a function,
+ * so a consumer that imports `useCapabilities` pulls all 6 capability
+ * literals into their bundle. First-class part of the API — supported
+ * indefinitely. Per-capability primitives (`*Capability`) are preferred for
+ * new code when bundle size or scanner cleanliness matters.
  */
 declare const useCapabilities: () => {
     data: {
@@ -592,4 +625,4 @@ declare const useContextData: () => UseContextDataResult;
  */
 declare const useSettings: () => Record<string, unknown>;
 
-export { type Store, Surface, createExtension, createStore, ui, useActivityEvent, useCapabilities, useContextData, useEvent, useExtendIdentity, useExtension, useIdentityEvent, useMessagingEvent, useSettings, useStore, useSurfaceContext };
+export { type Store, Surface, actionsInvokeCapability, actionsToastCapability, contextReadCapability, createExtension, createStore, dataFetchCapability, dataQueryCapability, extendIdentityCapability, ui, useActivityEvent, useCapabilities, useContextData, useEvent, useExtendIdentity, useExtension, useIdentityEvent, useMessagingEvent, useSettings, useStore, useSurfaceContext };

package/dist/index.js

@@ -203,21 +203,17 @@ var useSurfaceContext = () => {
   }
   return ctx;
 };
+var contextReadCapability = () => callCapability("context.read");
+var dataQueryCapability = (payload) => callCapability("data.query", payload);
+var dataFetchCapability = (url, init) => callCapability("data.fetch", { url, ...init });
+var actionsToastCapability = (payload) => callCapability("actions.toast", payload);
+var actionsInvokeCapability = (action, payload) => callCapability("actions.invoke", { action, payload });
+var extendIdentityCapability = (payload) => callCapability("extend.identity", payload);
 var useCapabilities = () => ({
-  data: {
-    query: (payload) => callCapability("data.query", payload),
-    fetch: (url, init) => callCapability("data.fetch", { url, ...init })
-  },
-  actions: {
-    toast: (payload) => callCapability("actions.toast", payload),
-    invoke: (action, payload) => callCapability("actions.invoke", { action, payload })
-  },
-  context: {
-    read: () => callCapability("context.read")
-  },
-  extend: {
-    identity: (payload) => callCapability("extend.identity", payload)
-  }
+  data: { query: dataQueryCapability, fetch: dataFetchCapability },
+  actions: { toast: actionsToastCapability, invoke: actionsInvokeCapability },
+  context: { read: contextReadCapability },
+  extend: { identity: extendIdentityCapability }
 });
 var useStore = (store, selector) => {
   const select = selector ?? ((s) => s);
@@ -549,13 +545,12 @@ var FooterLink = (props) => /* @__PURE__ */ jsx(
 var Menu = (props) => /* @__PURE__ */ jsx("ui-menu", { ...props, children: props.children });
 var MenuItem = (props) => /* @__PURE__ */ jsx("ui-menu-item", { ...props });
 var useContextData = () => {
-  const capabilities = useCapabilities();
   const [contextData, setContextData] = useState({});
   const [loading, setLoading] = useState(true);
   useEffect(() => {
     const loadContext = async () => {
       try {
-        const ctx = await capabilities.context.read();
+        const ctx = await contextReadCapability();
         setContextData(ctx);
       } catch (err) {
         console.error("Failed to read context:", err);
@@ -584,4 +579,4 @@ var useSettings = () => {
   return settings ?? {};
 };
 
-export { Surface, createExtension, createStore, ui_exports as ui, useActivityEvent, useCapabilities, useContextData, useEvent, useExtendIdentity, useExtension, useIdentityEvent, useMessagingEvent, useSettings, useStore, useSurfaceContext };
+export { Surface, actionsInvokeCapability, actionsToastCapability, contextReadCapability, createExtension, createStore, dataFetchCapability, dataQueryCapability, extendIdentityCapability, ui_exports as ui, useActivityEvent, useCapabilities, useContextData, useEvent, useExtendIdentity, useExtension, useIdentityEvent, useMessagingEvent, useSettings, useStore, useSurfaceContext };

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@stackable-labs/sdk-extension-react",
-  "version": "1.103.0",
+  "version": "2.1.0",
   "type": "module",
+  "sideEffects": false,
   "private": false,
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",