@kittl/sdk 0.0.6 → 0.0.8

package/README.md

@@ -8,6 +8,10 @@ Official JavaScript SDK for building apps on [Kittl](https://www.kittl.com).
 npm install @kittl/sdk
 ```
 
+## Backend helpers
+
+For server-side token verification in your app backend, use [`@kittl/sdk-backend`](https://www.npmjs.com/package/@kittl/sdk-backend). See the [SDK backend guide](https://sdk-docs.kittl.dev/getting-started/sdk-backend) in the docs.
+
 ## Documentation
 
 Guides and API reference are in the [Kittl SDK documentation](https://sdk-docs.kittl.dev/getting-started/sdk).

package/dist/kittl-sdk.esm.js

@@ -2,24 +2,93 @@
 /*! Kittl SDK - https://kittl.com - see license for terms */
 
 
+// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/shared/commands.js
+var FROM_EXTENSION_COMMANDS = {
+  /** SDK API call */
+  SDK_CALL: "sdk-call",
+  /** AI handler registration */
+  AI_REGISTER_HANDLER: "ai-register-handler",
+  /** AI handler unregistration */
+  AI_UNREGISTER_HANDLER: "ai-unregister-handler",
+  /** File browser tab registration */
+  FILE_BROWSER_REGISTER: "file-browser-register",
+  /** File browser fetch content response */
+  FILE_BROWSER_FETCH_CONTENT_RESPONSE: "file-browser-fetch-content-response",
+  /** Stateless message send */
+  STATELESS_SEND: "stateless-send",
+  /** Stateless subscription */
+  STATELESS_SUBSCRIBE: "stateless-subscribe",
+  /** Stateless unsubscription */
+  STATELESS_UNSUBSCRIBE: "stateless-unsubscribe",
+  /** App state subscription */
+  APP_STATE_SUBSCRIBE: "app-state-subscribe",
+  /** App state unsubscription */
+  APP_STATE_UNSUBSCRIBE: "app-state-unsubscribe",
+  /** Batch creation */
+  BATCH_CREATE: "batch-create",
+  /** Batch commit */
+  BATCH_COMMIT: "batch-commit",
+  /** OAuth flow start */
+  AUTH_START: "auth-start",
+  /** OAuth token exchange */
+  AUTH_EXCHANGE: "auth-exchange",
+  /** Get OAuth token */
+  AUTH_GET_TOKEN: "auth-get-token",
+  /** Refresh OAuth token */
+  AUTH_REFRESH: "auth-refresh",
+  /** OAuth logout */
+  AUTH_LOGOUT: "auth-logout",
+  /** Get user token for authentication */
+  AUTH_GET_USER_TOKEN: "auth-get-user-token",
+  /** Context subscription */
+  CONTEXT_SUBSCRIBE: "context-subscribe",
+  /** Context unsubscription */
+  CONTEXT_UNSUBSCRIBE: "context-unsubscribe",
+  /** Design state subscription */
+  DESIGN_STATE_SUBSCRIBE: "design-state-subscribe",
+  /** Design state unsubscription */
+  DESIGN_STATE_UNSUBSCRIBE: "design-state-unsubscribe",
+  /** Extension loaded notification */
+  LOADED: "loaded"
+};
+var TO_EXTENSION_COMMANDS = {
+  /** SDK API response */
+  SDK_RESPONSE: "sdk-response",
+  /** File browser fetch content request */
+  FILE_BROWSER_FETCH_CONTENT_REQUEST: "file-browser-fetch-content-request",
+  /** Stateless message push */
+  STATELESS_MESSAGE: "stateless-message",
+  /** Context update push */
+  CONTEXT_UPDATE: "context-update",
+  /** AI generation update push */
+  AI_GENERATION_UPDATE: "ai-generation-update",
+  /** Design state update push */
+  DESIGN_STATE_UPDATE: "design-state-update",
+  /** App state update push */
+  APP_STATE_UPDATE: "app-state-update"
+};
+
 // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/types/toExtensions.js
 var isSDKResponseMessage = (data) => {
-  return typeof data === "object" && data !== null && "command" in data && data.command === "sdk-response" && "messageId" in data && typeof data.messageId === "string";
+  return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.SDK_RESPONSE && "messageId" in data && typeof data.messageId === "string";
 };
 var isStatelessPushMessage = (data) => {
-  return typeof data === "object" && data !== null && "command" in data && data.command === "stateless-message" && "type" in data && typeof data.type === "string" && "payload" in data && typeof data.payload === "object" && data.payload !== null;
+  return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.STATELESS_MESSAGE && "type" in data && typeof data.type === "string" && "payload" in data && typeof data.payload === "object" && data.payload !== null;
 };
 var isAIGenerationUpdatePushMessage = (data) => {
-  return typeof data === "object" && data !== null && "command" in data && data.command === "ai-generation-update" && "subscriptionId" in data && typeof data.subscriptionId === "string" && "update" in data && typeof data.update === "object" && data.update !== null;
+  return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.AI_GENERATION_UPDATE && "subscriptionId" in data && typeof data.subscriptionId === "string" && "update" in data && typeof data.update === "object" && data.update !== null;
 };
 var isDesignStateUpdatePushMessage = (data) => {
-  return typeof data === "object" && data !== null && "command" in data && data.command === "design-state-update" && "updates" in data && Array.isArray(data.updates);
+  return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.DESIGN_STATE_UPDATE && "updates" in data && Array.isArray(data.updates);
 };
 var isAppStateUpdatePushMessage = (data) => {
-  return typeof data === "object" && data !== null && "command" in data && data.command === "app-state-update" && "updates" in data && Array.isArray(data.updates);
+  return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.APP_STATE_UPDATE && "updates" in data && Array.isArray(data.updates);
 };
 var isContextUpdatePushMessage = (data) => {
-  return typeof data === "object" && data !== null && "command" in data && data.command === "context-update" && "subscriptionId" in data && typeof data.subscriptionId === "string" && "context" in data && typeof data.context === "object" && data.context !== null;
+  return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.CONTEXT_UPDATE && "subscriptionId" in data && typeof data.subscriptionId === "string" && "context" in data && typeof data.context === "object" && data.context !== null;
+};
+var isFileBrowserFetchContentRequestMessage = (data) => {
+  return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.FILE_BROWSER_FETCH_CONTENT_REQUEST && "requestId" in data && typeof data.requestId === "string" && "subscriptionId" in data && typeof data.subscriptionId === "string";
 };
 
 // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/shared/createApiProxyCore.js
@@ -148,56 +217,56 @@ var sendLoaded = () => {
   if (!parent || parent === window) {
     return;
   }
-  const message = { command: "loaded" };
+  const message = { command: FROM_EXTENSION_COMMANDS.LOADED };
   postMessageToParent(message);
 };
 
 // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/apiProxy/index.js
 var createSDKCallMessage = {
   ai: (dots, args, messageId) => ({
-    command: "sdk-call",
+    command: FROM_EXTENSION_COMMANDS.SDK_CALL,
     dots,
     args,
     messageId,
     apiType: "ai"
   }),
   context: (dots, args, messageId) => ({
-    command: "sdk-call",
+    command: FROM_EXTENSION_COMMANDS.SDK_CALL,
     dots,
     args,
     messageId,
     apiType: "context"
   }),
   design: (dots, args, messageId) => ({
-    command: "sdk-call",
+    command: FROM_EXTENSION_COMMANDS.SDK_CALL,
     dots,
     args,
     messageId,
     apiType: "design"
   }),
   font: (dots, args, messageId) => ({
-    command: "sdk-call",
+    command: FROM_EXTENSION_COMMANDS.SDK_CALL,
     dots,
     args,
     messageId,
     apiType: "font"
   }),
   state: (dots, args, messageId) => ({
-    command: "sdk-call",
+    command: FROM_EXTENSION_COMMANDS.SDK_CALL,
     dots,
     args,
     messageId,
     apiType: "state"
   }),
   upload: (dots, args, messageId) => ({
-    command: "sdk-call",
+    command: FROM_EXTENSION_COMMANDS.SDK_CALL,
     dots,
     args,
     messageId,
     apiType: "upload"
   }),
   data: (dots, args, messageId) => ({
-    command: "sdk-call",
+    command: FROM_EXTENSION_COMMANDS.SDK_CALL,
     dots,
     args,
     messageId,
@@ -237,7 +306,7 @@ function createAIApiProxy() {
     generationHandlers.delete(subscriptionId);
     generationSubscriptions.delete(generatorId);
     const unregisterMessage = {
-      command: "ai-unregister-handler",
+      command: FROM_EXTENSION_COMMANDS.AI_UNREGISTER_HANDLER,
       generatorId,
       subscriptionId
     };
@@ -247,7 +316,7 @@ function createAIApiProxy() {
     spendCredits: async (options) => {
       const { onAccept, onDecline, ...serializable } = options;
       const message = {
-        command: "sdk-call",
+        command: FROM_EXTENSION_COMMANDS.SDK_CALL,
         dots: ["spendCredits"],
         args: [serializable],
         messageId: generateMessageId(),
@@ -263,7 +332,7 @@ function createAIApiProxy() {
     },
     startGeneration: (generatorId, inputSettings, output) => {
       const message = {
-        command: "sdk-call",
+        command: FROM_EXTENSION_COMMANDS.SDK_CALL,
         dots: ["startGeneration"],
         args: [generatorId, inputSettings, output],
         messageId: generateMessageId(),
@@ -285,7 +354,7 @@ function createAIApiProxy() {
       generationHandlers.set(subscriptionId, onStatusUpdate);
       generationSubscriptions.set(generatorId, subscriptionId);
       const registerMessage = {
-        command: "ai-register-handler",
+        command: FROM_EXTENSION_COMMANDS.AI_REGISTER_HANDLER,
         messageId: generateMessageId(),
         generatorId,
         subscriptionId
@@ -320,10 +389,87 @@ function createAIApiProxy() {
   };
 }
 
+// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/apiProxy/fileBrowserApiProxy.js
+var fetchContentHandlers = /* @__PURE__ */ new Map();
+var tabIdToSubscriptionId = /* @__PURE__ */ new Map();
+var dispatchFileBrowserFetchContentRequest = (requestId, subscriptionId, params) => {
+  const handler = fetchContentHandlers.get(subscriptionId);
+  if (!handler) {
+    const responseMessage = {
+      command: FROM_EXTENSION_COMMANDS.FILE_BROWSER_FETCH_CONTENT_RESPONSE,
+      requestId,
+      content: []
+    };
+    postMessageToParent(responseMessage);
+    return;
+  }
+  void handler(params).then((result) => {
+    const responseMessage = {
+      command: FROM_EXTENSION_COMMANDS.FILE_BROWSER_FETCH_CONTENT_RESPONSE,
+      requestId,
+      content: result.content,
+      next: result.next
+    };
+    postMessageToParent(responseMessage);
+  }).catch((e) => {
+    const responseMessage = {
+      command: FROM_EXTENSION_COMMANDS.FILE_BROWSER_FETCH_CONTENT_RESPONSE,
+      requestId,
+      content: [],
+      error: e instanceof Error ? e.message : "Unknown error"
+    };
+    postMessageToParent(responseMessage);
+  });
+};
+function createFileBrowserApiProxy() {
+  return {
+    registerUploadBrowser: async (tab) => {
+      const subscriptionId = generateMessageId();
+      const existingSubscriptionId = tabIdToSubscriptionId.get(tab.id);
+      if (existingSubscriptionId) {
+        fetchContentHandlers.delete(existingSubscriptionId);
+      }
+      fetchContentHandlers.set(subscriptionId, tab.fetchContent);
+      tabIdToSubscriptionId.set(tab.id, subscriptionId);
+      const registerMessage = {
+        command: FROM_EXTENSION_COMMANDS.FILE_BROWSER_REGISTER,
+        messageId: generateMessageId(),
+        tabId: tab.id,
+        label: tab.label,
+        subscriptionId
+      };
+      try {
+        const response = await sendMessage(registerMessage);
+        if (!response.isOk) {
+          fetchContentHandlers.delete(subscriptionId);
+          tabIdToSubscriptionId.delete(tab.id);
+          return {
+            isOk: false,
+            error: response.error
+          };
+        }
+        return {
+          isOk: true,
+          result: void 0
+        };
+      } catch {
+        fetchContentHandlers.delete(subscriptionId);
+        return {
+          isOk: false,
+          error: {
+            message: "Failed to register upload browser",
+            name: "SdkInternalError"
+          }
+        };
+      }
+    }
+  };
+}
+
 // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/appState/index.js
 var sendUnsubscribe = (selectorIds) => {
   const message = {
-    command: "app-state-unsubscribe",
+    command: FROM_EXTENSION_COMMANDS.APP_STATE_UNSUBSCRIBE,
     selectorIds
   };
   postMessageToParent(message);
@@ -350,7 +496,7 @@ var createAppStateBridgeApi = () => {
     }
     const messageId = generateMessageId();
     const subscribeMessage = {
-      command: "app-state-subscribe",
+      command: FROM_EXTENSION_COMMANDS.APP_STATE_SUBSCRIBE,
       messageId,
       selectorIds,
       paths: pathArrays
@@ -413,7 +559,7 @@ var createAuthBridgeApi = () => {
         pkceCode = await hashPKCECode(code_verifier);
       }
       const message = {
-        command: "auth-start",
+        command: FROM_EXTENSION_COMMANDS.AUTH_START,
         messageId: generateMessageId(),
         state,
         provider: request.provider,
@@ -439,7 +585,7 @@ var createAuthBridgeApi = () => {
     },
     exchangeCode: (request) => {
       const message = {
-        command: "auth-exchange",
+        command: FROM_EXTENSION_COMMANDS.AUTH_EXCHANGE,
         messageId: generateMessageId(),
         code: request.code,
         code_verifier: request.code_verifier,
@@ -451,7 +597,7 @@ var createAuthBridgeApi = () => {
     },
     getAuthToken: (request) => {
       const message = {
-        command: "auth-get-token",
+        command: FROM_EXTENSION_COMMANDS.AUTH_GET_TOKEN,
         messageId: generateMessageId(),
         provider: request.provider
       };
@@ -459,7 +605,7 @@ var createAuthBridgeApi = () => {
     },
     refreshToken: (request) => {
       const message = {
-        command: "auth-refresh",
+        command: FROM_EXTENSION_COMMANDS.AUTH_REFRESH,
         messageId: generateMessageId(),
         provider: request.provider
       };
@@ -467,7 +613,7 @@ var createAuthBridgeApi = () => {
     },
     logout: (request) => {
       const message = {
-        command: "auth-logout",
+        command: FROM_EXTENSION_COMMANDS.AUTH_LOGOUT,
         messageId: generateMessageId(),
         provider: request.provider
       };
@@ -486,7 +632,7 @@ var createAuthBridgeApi = () => {
 // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/batch/index.js
 var createBatch = async () => {
   const response = await sendMessage({
-    command: "batch-create",
+    command: FROM_EXTENSION_COMMANDS.BATCH_CREATE,
     messageId: generateMessageId()
   });
   if (!response.isOk) {
@@ -494,7 +640,7 @@ var createBatch = async () => {
   }
   const { batchKey } = response.result;
   const sendDesignCall = (dots, args) => sendMessage({
-    command: "sdk-call",
+    command: FROM_EXTENSION_COMMANDS.SDK_CALL,
     dots,
     args,
     messageId: generateMessageId(),
@@ -503,7 +649,7 @@ var createBatch = async () => {
   });
   const commit = async () => {
     const res = await sendMessage({
-      command: "batch-commit",
+      command: FROM_EXTENSION_COMMANDS.BATCH_COMMIT,
       messageId: generateMessageId(),
       batchKey
     });
@@ -543,7 +689,7 @@ var createContextBridgeApi = () => {
     let response;
     try {
       response = await sendMessage({
-        command: "context-subscribe",
+        command: FROM_EXTENSION_COMMANDS.CONTEXT_SUBSCRIBE,
         messageId,
         subscriptionId
       });
@@ -558,7 +704,7 @@ var createContextBridgeApi = () => {
     return () => {
       subscriptionCallbacks.delete(subscriptionId);
       const message = {
-        command: "context-unsubscribe",
+        command: FROM_EXTENSION_COMMANDS.CONTEXT_UNSUBSCRIBE,
         subscriptionId
       };
       postMessageToParent(message);
@@ -578,7 +724,7 @@ var createContextBridgeApi = () => {
 // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/designState/index.js
 var sendUnsubscribe2 = (selectorIds) => {
   const message = {
-    command: "design-state-unsubscribe",
+    command: FROM_EXTENSION_COMMANDS.DESIGN_STATE_UNSUBSCRIBE,
     selectorIds
   };
   postMessageToParent(message);
@@ -605,7 +751,7 @@ var createDesignStateBridgeApi = () => {
     }
     const messageId = generateMessageId();
     const subscribeMessage = {
-      command: "design-state-subscribe",
+      command: FROM_EXTENSION_COMMANDS.DESIGN_STATE_SUBSCRIBE,
       messageId,
       selectorIds,
       paths: pathArrays
@@ -649,7 +795,7 @@ var createStatelessBridgeApi = () => {
     send: (message) => {
       const messageId = generateMessageId();
       const bridgeMessage = {
-        command: "stateless-send",
+        command: FROM_EXTENSION_COMMANDS.STATELESS_SEND,
         messageId,
         type: message.type,
         payload: message.payload
@@ -665,7 +811,7 @@ var createStatelessBridgeApi = () => {
       handlers.add(handler);
       const messageId = generateMessageId();
       const subscribeMessage = {
-        command: "stateless-subscribe",
+        command: FROM_EXTENSION_COMMANDS.STATELESS_SUBSCRIBE,
         messageId,
         key
       };
@@ -675,7 +821,7 @@ var createStatelessBridgeApi = () => {
       subscribers.delete(key);
       const messageId = generateMessageId();
       const unsubscribeMessage = {
-        command: "stateless-unsubscribe",
+        command: FROM_EXTENSION_COMMANDS.STATELESS_UNSUBSCRIBE,
         messageId,
         key
       };
@@ -733,6 +879,14 @@ var handleIncomingMessage = (event) => {
   }
   if (isContextUpdatePushMessage(data)) {
     dispatchContextUpdate(data);
+    return;
+  }
+  if (isFileBrowserFetchContentRequestMessage(data)) {
+    dispatchFileBrowserFetchContentRequest(
+      data.requestId,
+      data.subscriptionId,
+      data.params
+    );
   }
 };
 var bridgeHandlers = {
@@ -745,6 +899,7 @@ var bridgeHandlers = {
   font: createApiProxy("font"),
   state: createApiProxy("state"),
   upload: createApiProxy("upload"),
+  fileBrowser: createFileBrowserApiProxy(),
   auth: createAuthBridgeApi(),
   stateless: statelessApi,
   createBatch
@@ -1078,5 +1233,6 @@ if (typeof document !== "undefined" && typeof window !== "undefined") {
   }
 }
 export {
-  kittl
+  kittl,
+  unwrapResult
 };

package/dist/kittl-sdk.js

@@ -3,24 +3,93 @@
 
 "use strict";
 (() => {
+  // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/shared/commands.js
+  var FROM_EXTENSION_COMMANDS = {
+    /** SDK API call */
+    SDK_CALL: "sdk-call",
+    /** AI handler registration */
+    AI_REGISTER_HANDLER: "ai-register-handler",
+    /** AI handler unregistration */
+    AI_UNREGISTER_HANDLER: "ai-unregister-handler",
+    /** File browser tab registration */
+    FILE_BROWSER_REGISTER: "file-browser-register",
+    /** File browser fetch content response */
+    FILE_BROWSER_FETCH_CONTENT_RESPONSE: "file-browser-fetch-content-response",
+    /** Stateless message send */
+    STATELESS_SEND: "stateless-send",
+    /** Stateless subscription */
+    STATELESS_SUBSCRIBE: "stateless-subscribe",
+    /** Stateless unsubscription */
+    STATELESS_UNSUBSCRIBE: "stateless-unsubscribe",
+    /** App state subscription */
+    APP_STATE_SUBSCRIBE: "app-state-subscribe",
+    /** App state unsubscription */
+    APP_STATE_UNSUBSCRIBE: "app-state-unsubscribe",
+    /** Batch creation */
+    BATCH_CREATE: "batch-create",
+    /** Batch commit */
+    BATCH_COMMIT: "batch-commit",
+    /** OAuth flow start */
+    AUTH_START: "auth-start",
+    /** OAuth token exchange */
+    AUTH_EXCHANGE: "auth-exchange",
+    /** Get OAuth token */
+    AUTH_GET_TOKEN: "auth-get-token",
+    /** Refresh OAuth token */
+    AUTH_REFRESH: "auth-refresh",
+    /** OAuth logout */
+    AUTH_LOGOUT: "auth-logout",
+    /** Get user token for authentication */
+    AUTH_GET_USER_TOKEN: "auth-get-user-token",
+    /** Context subscription */
+    CONTEXT_SUBSCRIBE: "context-subscribe",
+    /** Context unsubscription */
+    CONTEXT_UNSUBSCRIBE: "context-unsubscribe",
+    /** Design state subscription */
+    DESIGN_STATE_SUBSCRIBE: "design-state-subscribe",
+    /** Design state unsubscription */
+    DESIGN_STATE_UNSUBSCRIBE: "design-state-unsubscribe",
+    /** Extension loaded notification */
+    LOADED: "loaded"
+  };
+  var TO_EXTENSION_COMMANDS = {
+    /** SDK API response */
+    SDK_RESPONSE: "sdk-response",
+    /** File browser fetch content request */
+    FILE_BROWSER_FETCH_CONTENT_REQUEST: "file-browser-fetch-content-request",
+    /** Stateless message push */
+    STATELESS_MESSAGE: "stateless-message",
+    /** Context update push */
+    CONTEXT_UPDATE: "context-update",
+    /** AI generation update push */
+    AI_GENERATION_UPDATE: "ai-generation-update",
+    /** Design state update push */
+    DESIGN_STATE_UPDATE: "design-state-update",
+    /** App state update push */
+    APP_STATE_UPDATE: "app-state-update"
+  };
+
   // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/types/toExtensions.js
   var isSDKResponseMessage = (data) => {
-    return typeof data === "object" && data !== null && "command" in data && data.command === "sdk-response" && "messageId" in data && typeof data.messageId === "string";
+    return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.SDK_RESPONSE && "messageId" in data && typeof data.messageId === "string";
   };
   var isStatelessPushMessage = (data) => {
-    return typeof data === "object" && data !== null && "command" in data && data.command === "stateless-message" && "type" in data && typeof data.type === "string" && "payload" in data && typeof data.payload === "object" && data.payload !== null;
+    return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.STATELESS_MESSAGE && "type" in data && typeof data.type === "string" && "payload" in data && typeof data.payload === "object" && data.payload !== null;
   };
   var isAIGenerationUpdatePushMessage = (data) => {
-    return typeof data === "object" && data !== null && "command" in data && data.command === "ai-generation-update" && "subscriptionId" in data && typeof data.subscriptionId === "string" && "update" in data && typeof data.update === "object" && data.update !== null;
+    return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.AI_GENERATION_UPDATE && "subscriptionId" in data && typeof data.subscriptionId === "string" && "update" in data && typeof data.update === "object" && data.update !== null;
   };
   var isDesignStateUpdatePushMessage = (data) => {
-    return typeof data === "object" && data !== null && "command" in data && data.command === "design-state-update" && "updates" in data && Array.isArray(data.updates);
+    return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.DESIGN_STATE_UPDATE && "updates" in data && Array.isArray(data.updates);
   };
   var isAppStateUpdatePushMessage = (data) => {
-    return typeof data === "object" && data !== null && "command" in data && data.command === "app-state-update" && "updates" in data && Array.isArray(data.updates);
+    return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.APP_STATE_UPDATE && "updates" in data && Array.isArray(data.updates);
   };
   var isContextUpdatePushMessage = (data) => {
-    return typeof data === "object" && data !== null && "command" in data && data.command === "context-update" && "subscriptionId" in data && typeof data.subscriptionId === "string" && "context" in data && typeof data.context === "object" && data.context !== null;
+    return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.CONTEXT_UPDATE && "subscriptionId" in data && typeof data.subscriptionId === "string" && "context" in data && typeof data.context === "object" && data.context !== null;
+  };
+  var isFileBrowserFetchContentRequestMessage = (data) => {
+    return typeof data === "object" && data !== null && "command" in data && data.command === TO_EXTENSION_COMMANDS.FILE_BROWSER_FETCH_CONTENT_REQUEST && "requestId" in data && typeof data.requestId === "string" && "subscriptionId" in data && typeof data.subscriptionId === "string";
   };
 
   // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/shared/createApiProxyCore.js
@@ -149,56 +218,56 @@
     if (!parent || parent === window) {
       return;
     }
-    const message = { command: "loaded" };
+    const message = { command: FROM_EXTENSION_COMMANDS.LOADED };
     postMessageToParent(message);
   };
 
   // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/apiProxy/index.js
   var createSDKCallMessage = {
     ai: (dots, args, messageId) => ({
-      command: "sdk-call",
+      command: FROM_EXTENSION_COMMANDS.SDK_CALL,
       dots,
       args,
       messageId,
       apiType: "ai"
     }),
     context: (dots, args, messageId) => ({
-      command: "sdk-call",
+      command: FROM_EXTENSION_COMMANDS.SDK_CALL,
       dots,
       args,
       messageId,
       apiType: "context"
     }),
     design: (dots, args, messageId) => ({
-      command: "sdk-call",
+      command: FROM_EXTENSION_COMMANDS.SDK_CALL,
       dots,
       args,
       messageId,
       apiType: "design"
     }),
     font: (dots, args, messageId) => ({
-      command: "sdk-call",
+      command: FROM_EXTENSION_COMMANDS.SDK_CALL,
       dots,
       args,
       messageId,
       apiType: "font"
     }),
     state: (dots, args, messageId) => ({
-      command: "sdk-call",
+      command: FROM_EXTENSION_COMMANDS.SDK_CALL,
       dots,
       args,
       messageId,
       apiType: "state"
     }),
     upload: (dots, args, messageId) => ({
-      command: "sdk-call",
+      command: FROM_EXTENSION_COMMANDS.SDK_CALL,
       dots,
       args,
       messageId,
       apiType: "upload"
     }),
     data: (dots, args, messageId) => ({
-      command: "sdk-call",
+      command: FROM_EXTENSION_COMMANDS.SDK_CALL,
       dots,
       args,
       messageId,
@@ -238,7 +307,7 @@
       generationHandlers.delete(subscriptionId);
       generationSubscriptions.delete(generatorId);
       const unregisterMessage = {
-        command: "ai-unregister-handler",
+        command: FROM_EXTENSION_COMMANDS.AI_UNREGISTER_HANDLER,
         generatorId,
         subscriptionId
       };
@@ -248,7 +317,7 @@
       spendCredits: async (options) => {
         const { onAccept, onDecline, ...serializable } = options;
         const message = {
-          command: "sdk-call",
+          command: FROM_EXTENSION_COMMANDS.SDK_CALL,
           dots: ["spendCredits"],
           args: [serializable],
           messageId: generateMessageId(),
@@ -264,7 +333,7 @@
       },
       startGeneration: (generatorId, inputSettings, output) => {
         const message = {
-          command: "sdk-call",
+          command: FROM_EXTENSION_COMMANDS.SDK_CALL,
           dots: ["startGeneration"],
           args: [generatorId, inputSettings, output],
           messageId: generateMessageId(),
@@ -286,7 +355,7 @@
         generationHandlers.set(subscriptionId, onStatusUpdate);
         generationSubscriptions.set(generatorId, subscriptionId);
         const registerMessage = {
-          command: "ai-register-handler",
+          command: FROM_EXTENSION_COMMANDS.AI_REGISTER_HANDLER,
           messageId: generateMessageId(),
           generatorId,
           subscriptionId
@@ -321,10 +390,87 @@
     };
   }
 
+  // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/apiProxy/fileBrowserApiProxy.js
+  var fetchContentHandlers = /* @__PURE__ */ new Map();
+  var tabIdToSubscriptionId = /* @__PURE__ */ new Map();
+  var dispatchFileBrowserFetchContentRequest = (requestId, subscriptionId, params) => {
+    const handler = fetchContentHandlers.get(subscriptionId);
+    if (!handler) {
+      const responseMessage = {
+        command: FROM_EXTENSION_COMMANDS.FILE_BROWSER_FETCH_CONTENT_RESPONSE,
+        requestId,
+        content: []
+      };
+      postMessageToParent(responseMessage);
+      return;
+    }
+    void handler(params).then((result) => {
+      const responseMessage = {
+        command: FROM_EXTENSION_COMMANDS.FILE_BROWSER_FETCH_CONTENT_RESPONSE,
+        requestId,
+        content: result.content,
+        next: result.next
+      };
+      postMessageToParent(responseMessage);
+    }).catch((e) => {
+      const responseMessage = {
+        command: FROM_EXTENSION_COMMANDS.FILE_BROWSER_FETCH_CONTENT_RESPONSE,
+        requestId,
+        content: [],
+        error: e instanceof Error ? e.message : "Unknown error"
+      };
+      postMessageToParent(responseMessage);
+    });
+  };
+  function createFileBrowserApiProxy() {
+    return {
+      registerUploadBrowser: async (tab) => {
+        const subscriptionId = generateMessageId();
+        const existingSubscriptionId = tabIdToSubscriptionId.get(tab.id);
+        if (existingSubscriptionId) {
+          fetchContentHandlers.delete(existingSubscriptionId);
+        }
+        fetchContentHandlers.set(subscriptionId, tab.fetchContent);
+        tabIdToSubscriptionId.set(tab.id, subscriptionId);
+        const registerMessage = {
+          command: FROM_EXTENSION_COMMANDS.FILE_BROWSER_REGISTER,
+          messageId: generateMessageId(),
+          tabId: tab.id,
+          label: tab.label,
+          subscriptionId
+        };
+        try {
+          const response = await sendMessage(registerMessage);
+          if (!response.isOk) {
+            fetchContentHandlers.delete(subscriptionId);
+            tabIdToSubscriptionId.delete(tab.id);
+            return {
+              isOk: false,
+              error: response.error
+            };
+          }
+          return {
+            isOk: true,
+            result: void 0
+          };
+        } catch {
+          fetchContentHandlers.delete(subscriptionId);
+          return {
+            isOk: false,
+            error: {
+              message: "Failed to register upload browser",
+              name: "SdkInternalError"
+            }
+          };
+        }
+      }
+    };
+  }
+
   // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/appState/index.js
   var sendUnsubscribe = (selectorIds) => {
     const message = {
-      command: "app-state-unsubscribe",
+      command: FROM_EXTENSION_COMMANDS.APP_STATE_UNSUBSCRIBE,
       selectorIds
     };
     postMessageToParent(message);
@@ -351,7 +497,7 @@
       }
       const messageId = generateMessageId();
       const subscribeMessage = {
-        command: "app-state-subscribe",
+        command: FROM_EXTENSION_COMMANDS.APP_STATE_SUBSCRIBE,
         messageId,
         selectorIds,
         paths: pathArrays
@@ -414,7 +560,7 @@
           pkceCode = await hashPKCECode(code_verifier);
         }
         const message = {
-          command: "auth-start",
+          command: FROM_EXTENSION_COMMANDS.AUTH_START,
           messageId: generateMessageId(),
           state,
           provider: request.provider,
@@ -440,7 +586,7 @@
       },
       exchangeCode: (request) => {
         const message = {
-          command: "auth-exchange",
+          command: FROM_EXTENSION_COMMANDS.AUTH_EXCHANGE,
           messageId: generateMessageId(),
           code: request.code,
           code_verifier: request.code_verifier,
@@ -452,7 +598,7 @@
       },
       getAuthToken: (request) => {
         const message = {
-          command: "auth-get-token",
+          command: FROM_EXTENSION_COMMANDS.AUTH_GET_TOKEN,
           messageId: generateMessageId(),
           provider: request.provider
         };
@@ -460,7 +606,7 @@
       },
       refreshToken: (request) => {
         const message = {
-          command: "auth-refresh",
+          command: FROM_EXTENSION_COMMANDS.AUTH_REFRESH,
           messageId: generateMessageId(),
           provider: request.provider
         };
@@ -468,7 +614,7 @@
       },
       logout: (request) => {
         const message = {
-          command: "auth-logout",
+          command: FROM_EXTENSION_COMMANDS.AUTH_LOGOUT,
           messageId: generateMessageId(),
           provider: request.provider
         };
@@ -487,7 +633,7 @@
   // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/batch/index.js
   var createBatch = async () => {
     const response = await sendMessage({
-      command: "batch-create",
+      command: FROM_EXTENSION_COMMANDS.BATCH_CREATE,
       messageId: generateMessageId()
     });
     if (!response.isOk) {
@@ -495,7 +641,7 @@
     }
     const { batchKey } = response.result;
     const sendDesignCall = (dots, args) => sendMessage({
-      command: "sdk-call",
+      command: FROM_EXTENSION_COMMANDS.SDK_CALL,
       dots,
       args,
       messageId: generateMessageId(),
@@ -504,7 +650,7 @@
     });
     const commit = async () => {
       const res = await sendMessage({
-        command: "batch-commit",
+        command: FROM_EXTENSION_COMMANDS.BATCH_COMMIT,
         messageId: generateMessageId(),
         batchKey
       });
@@ -544,7 +690,7 @@
       let response;
       try {
         response = await sendMessage({
-          command: "context-subscribe",
+          command: FROM_EXTENSION_COMMANDS.CONTEXT_SUBSCRIBE,
           messageId,
           subscriptionId
         });
@@ -559,7 +705,7 @@
       return () => {
         subscriptionCallbacks.delete(subscriptionId);
         const message = {
-          command: "context-unsubscribe",
+          command: FROM_EXTENSION_COMMANDS.CONTEXT_UNSUBSCRIBE,
           subscriptionId
         };
         postMessageToParent(message);
@@ -579,7 +725,7 @@
   // ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/designState/index.js
   var sendUnsubscribe2 = (selectorIds) => {
     const message = {
-      command: "design-state-unsubscribe",
+      command: FROM_EXTENSION_COMMANDS.DESIGN_STATE_UNSUBSCRIBE,
       selectorIds
     };
     postMessageToParent(message);
@@ -606,7 +752,7 @@
       }
       const messageId = generateMessageId();
       const subscribeMessage = {
-        command: "design-state-subscribe",
+        command: FROM_EXTENSION_COMMANDS.DESIGN_STATE_SUBSCRIBE,
         messageId,
         selectorIds,
         paths: pathArrays
@@ -650,7 +796,7 @@
       send: (message) => {
         const messageId = generateMessageId();
         const bridgeMessage = {
-          command: "stateless-send",
+          command: FROM_EXTENSION_COMMANDS.STATELESS_SEND,
           messageId,
           type: message.type,
           payload: message.payload
@@ -666,7 +812,7 @@
         handlers.add(handler);
         const messageId = generateMessageId();
         const subscribeMessage = {
-          command: "stateless-subscribe",
+          command: FROM_EXTENSION_COMMANDS.STATELESS_SUBSCRIBE,
           messageId,
           key
         };
@@ -676,7 +822,7 @@
         subscribers.delete(key);
         const messageId = generateMessageId();
         const unsubscribeMessage = {
-          command: "stateless-unsubscribe",
+          command: FROM_EXTENSION_COMMANDS.STATELESS_UNSUBSCRIBE,
           messageId,
           key
         };
@@ -734,6 +880,14 @@
     }
     if (isContextUpdatePushMessage(data)) {
       dispatchContextUpdate(data);
+      return;
+    }
+    if (isFileBrowserFetchContentRequestMessage(data)) {
+      dispatchFileBrowserFetchContentRequest(
+        data.requestId,
+        data.subscriptionId,
+        data.params
+      );
     }
   };
   var bridgeHandlers = {
@@ -746,6 +900,7 @@
     font: createApiProxy("font"),
     state: createApiProxy("state"),
     upload: createApiProxy("upload"),
+    fileBrowser: createFileBrowserApiProxy(),
     auth: createAuthBridgeApi(),
     stateless: statelessApi,
     createBatch

package/dist/sdk.d.ts

@@ -546,6 +546,7 @@ declare global {
 	}
 }
 export declare const kittl: KittlSDK;
+export declare function unwrapResult<T>(result: SdkResult<T, Error>): T;
 export interface AIGenerationInputSettings {
 	prompt: string;
 	taskType?: AIGenerationModelTaskType;
@@ -566,7 +567,7 @@ export interface AIGenerationOutputSettings {
 }
 export interface AddFontStyleOptions {
 	fontFamilyId: string;
-	objectIds: string[];
+	files: Blob[];
 	styles: string[];
 }
 export interface AppStateAPI {
@@ -818,6 +819,10 @@ export interface DecorationOptions {
 	distance: number;
 	cutDistance: number;
 }
+export interface DeleteFontStyleOptions {
+	fontFamilyId: string;
+	id: string;
+}
 export interface DesignAPI {
 	shape: ShapeAPI;
 	board: BoardAPI;
@@ -878,6 +883,9 @@ export interface ErrorGenerationResult {
 	subtitle: string;
 	status: "warning" | "error";
 }
+export interface FileBrowserAPI {
+	registerUploadBrowser: (tab: FileBrowserTab) => Promise<SdkResponse<void>>;
+}
 export interface FontAPI {
 	createFont: (params: {
 		name: string;
@@ -897,6 +905,7 @@ export interface FontDataAPI {
 	destroy(ids: string[]): SdkResultAsync<void>;
 	addStyle(options: AddFontStyleOptions): SdkResultAsync<FontFamilyDto>;
 	updateStyle(options: UpdateFontStyleOptions): SdkResultAsync<void>;
+	deleteStyle(options: DeleteFontStyleOptions): SdkResultAsync<void>;
 }
 export interface FontFamilyDto extends CatalogItem {
 	styles: FontStyleDto[];
@@ -910,6 +919,7 @@ export interface FontStyleDto {
 	id: string;
 	name: string;
 	style: string | null;
+	deletedAt: string | null;
 }
 export interface FontVariation {
 	name: string;
@@ -927,6 +937,10 @@ export interface GeneratableObject {
 		generatorKey: string;
 	};
 }
+export interface GenerationCreditUse {
+	amount: number;
+	refunded: number;
+}
 export interface GenerationInputData {
 	prompt?: string;
 	style?: {
@@ -1062,6 +1076,7 @@ export interface KittlSDK {
 	state: AsyncAppStateAPI;
 	auth: AsyncAuthAPI;
 	upload: AsyncUploadAPI;
+	fileBrowser: FileBrowserAPI;
 	stateless: AsyncStatelessAPI;
 	font: AsyncFontAPI;
 	createBatch: () => Promise<AsyncBatchDesignAPI>;
@@ -1370,7 +1385,7 @@ export interface WithObjectLayout {
 }
 export type AIGenerationActionOrigin = "COPILOT" | "RIGHT_PANEL" | "LEFT_PANEL" | "MICRO_APP" | "IMAGE_SETS" | "AI_CHAT" | "SMARTBOARD" | "AI_INPUT_GENERATE_IMAGE" | "AI_INPUT_REMIX_IMAGE" | "AI_INPUT_GENERATE_VIDEO" | "AI_HUB_GENERATE_IMAGE" | "AI_HUB_REMIX_IMAGE" | "AI_HUB_GENERATE_VIDEO" | "VIDEOBOARD" | "AGENT" | "WORKFLOW";
 export type AIGenerationContentType = "image" | "video";
-export type AIGenerationModelTaskType = "IMAGE_TO_IMAGE" | "IMAGE_INPAINT" | "TEXT_TO_IMAGE" | "IMAGE_TO_VIDEO";
+export type AIGenerationModelTaskType = "IMAGE_TO_IMAGE" | "IMAGE_INPAINT" | "IMAGE_OUTPAINT" | "TEXT_TO_IMAGE" | "IMAGE_TO_VIDEO";
 export type APIOptions<T extends Record<string, unknown>> = {
 	batchClient?: BatchClient<T>;
 } | {
@@ -1606,6 +1621,37 @@ export type ElementLocation = "origin" | "center";
 export type Expand<T> = T extends infer O ? {
 	[K in keyof O]: O[K];
 } : never;
+export type FileBrowserContent = FileBrowserItem | FileBrowserFolder;
+export type FileBrowserFetchContentParams = {
+	id?: string;
+	next?: string | number;
+};
+export type FileBrowserFetchContentResult = {
+	content: FileBrowserContent[];
+	next?: string | number;
+	error?: string;
+};
+export type FileBrowserFolder = {
+	type: "folder";
+	label: string;
+	id: string;
+	preview?: string;
+	content?: Array<FileBrowserContent>;
+};
+export type FileBrowserItem = {
+	type: "item";
+	label: string;
+	id: string;
+	preview?: string;
+	content: {
+		data: string;
+	};
+};
+export type FileBrowserTab = {
+	id: string;
+	label: string;
+	fetchContent: (params?: FileBrowserFetchContentParams) => Promise<FileBrowserFetchContentResult>;
+};
 export type FillMetaTarget = "border" | "fill";
 export type FlattenUnion<T> = UnionToIntersection<T extends unknown ? Partial<T> : never>;
 export type FontListDto = PaginatedResult<FontFamilyDto>;
@@ -1623,21 +1669,25 @@ export type GenerationStatusUpdate = {
 	generationId: string;
 	status: typeof GenerationStatus.CREATED;
 	inputData: undefined;
+	creditUse: undefined;
 	result: undefined;
 } | {
 	generationId: string;
 	status: typeof GenerationStatus.STARTED;
 	inputData: GenerationInputData;
+	creditUse?: GenerationCreditUse;
 	result: StartedGenerationResult;
 } | {
 	generationId: string;
 	status: typeof GenerationStatus.COMPLETE;
 	inputData: GenerationInputData;
+	creditUse?: GenerationCreditUse;
 	result: SuccessGenerationResult;
 } | {
 	generationId: string;
 	status: typeof GenerationStatus.FAILED;
 	inputData: GenerationInputData | undefined;
+	creditUse?: GenerationCreditUse;
 	result: ErrorGenerationResult;
 };
 export type GuideSerializedObject = typeof GUIDE_DEFAULT_VALUES & OrientationDir;
@@ -1988,6 +2038,13 @@ export type ScreenCoordinates = {
 	y: number;
 };
 export type SdkError = SdkBadInputError | SdkInternalError;
+export type SdkResponse<T> = {
+	isOk: true;
+	result: T;
+} | {
+	isOk: false;
+	error: Error;
+};
 export type SdkResult<T, E = SdkError> = {
 	isOk: true;
 	result: T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kittl/sdk",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "license": "Apache-2.0",
   "private": false,
   "type": "module",