@kittl/sdk 0.0.8 → 0.0.9

package/dist/kittl-sdk.esm.js

@@ -1,8 +1,6 @@
 // @ts-self-types="./sdk.d.ts"
 /*! 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",
@@ -68,7 +66,6 @@ var TO_EXTENSION_COMMANDS = {
   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 === TO_EXTENSION_COMMANDS.SDK_RESPONSE && "messageId" in data && typeof data.messageId === "string";
 };
@@ -91,7 +88,13 @@ 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
+var generateMessageId = () => {
+  if (crypto?.randomUUID && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return Math.random().toString(36).substring(7);
+};
+
 var buildMethodPath = (rootPrefix, pathSegments) => {
   if (!rootPrefix) {
     return pathSegments.join(".");
@@ -127,10 +130,6 @@ var createCallablePathProxy = (options) => {
   return createNode([]);
 };
 
-// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/shared/index.js
-var EDITOR_URL = typeof window !== "undefined" ? window.location?.origin : "";
-
-// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/utils/approvedDomain/approvedDomain.js
 var parentDomain;
 var APPROVED_EXTENSION_COMMUNICATION_DOMAINS = [
   "https://app.stagingdesigner.com",
@@ -190,14 +189,7 @@ var getParentDomain = () => {
   return parentDomain;
 };
 
-// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/messageSender.js
 var pendingRequests = /* @__PURE__ */ new Map();
-var generateMessageId = () => {
-  if (crypto?.randomUUID && typeof crypto.randomUUID === "function") {
-    return crypto.randomUUID();
-  }
-  return Math.random().toString(36).substring(7);
-};
 var postMessageToParent = (message) => {
   window.parent.postMessage(message, getParentDomain());
 };
@@ -221,7 +213,6 @@ var sendLoaded = () => {
   postMessageToParent(message);
 };
 
-// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/apiProxy/index.js
 var createSDKCallMessage = {
   ai: (dots, args, messageId) => ({
     command: FROM_EXTENSION_COMMANDS.SDK_CALL,
@@ -244,6 +235,13 @@ var createSDKCallMessage = {
     messageId,
     apiType: "design"
   }),
+  export: (dots, args, messageId) => ({
+    command: FROM_EXTENSION_COMMANDS.SDK_CALL,
+    dots,
+    args,
+    messageId,
+    apiType: "export"
+  }),
   font: (dots, args, messageId) => ({
     command: FROM_EXTENSION_COMMANDS.SDK_CALL,
     dots,
@@ -287,7 +285,6 @@ function createApiProxy(apiType) {
   });
 }
 
-// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/apiProxy/aiApiProxy.js
 var generationHandlers = /* @__PURE__ */ new Map();
 var generationSubscriptions = /* @__PURE__ */ new Map();
 var dispatchAIGenerationUpdate = (subscriptionId, update) => {
@@ -389,9 +386,11 @@ 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 removeSubscriptionHandlers = (subscriptionId) => {
+  fetchContentHandlers.delete(subscriptionId);
+};
 var dispatchFileBrowserFetchContentRequest = (requestId, subscriptionId, params) => {
   const handler = fetchContentHandlers.get(subscriptionId);
   if (!handler) {
@@ -411,12 +410,12 @@ var dispatchFileBrowserFetchContentRequest = (requestId, subscriptionId, params)
       next: result.next
     };
     postMessageToParent(responseMessage);
-  }).catch((e) => {
+  }).catch((error) => {
     const responseMessage = {
       command: FROM_EXTENSION_COMMANDS.FILE_BROWSER_FETCH_CONTENT_RESPONSE,
       requestId,
       content: [],
-      error: e instanceof Error ? e.message : "Unknown error"
+      error: error instanceof Error ? error.message : "Unknown error"
     };
     postMessageToParent(responseMessage);
   });
@@ -427,7 +426,7 @@ function createFileBrowserApiProxy() {
       const subscriptionId = generateMessageId();
       const existingSubscriptionId = tabIdToSubscriptionId.get(tab.id);
       if (existingSubscriptionId) {
-        fetchContentHandlers.delete(existingSubscriptionId);
+        removeSubscriptionHandlers(existingSubscriptionId);
       }
       fetchContentHandlers.set(subscriptionId, tab.fetchContent);
       tabIdToSubscriptionId.set(tab.id, subscriptionId);
@@ -436,12 +435,14 @@ function createFileBrowserApiProxy() {
         messageId: generateMessageId(),
         tabId: tab.id,
         label: tab.label,
+        order: tab.order,
+        emptyState: tab.emptyState,
         subscriptionId
       };
       try {
         const response = await sendMessage(registerMessage);
         if (!response.isOk) {
-          fetchContentHandlers.delete(subscriptionId);
+          removeSubscriptionHandlers(subscriptionId);
           tabIdToSubscriptionId.delete(tab.id);
           return {
             isOk: false,
@@ -453,7 +454,8 @@ function createFileBrowserApiProxy() {
           result: void 0
         };
       } catch {
-        fetchContentHandlers.delete(subscriptionId);
+        removeSubscriptionHandlers(subscriptionId);
+        tabIdToSubscriptionId.delete(tab.id);
         return {
           isOk: false,
           error: {
@@ -466,7 +468,6 @@ function createFileBrowserApiProxy() {
   };
 }
 
-// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/appState/index.js
 var sendUnsubscribe = (selectorIds) => {
   const message = {
     command: FROM_EXTENSION_COMMANDS.APP_STATE_UNSUBSCRIBE,
@@ -531,105 +532,126 @@ var createAppStateBridgeApi = () => {
   return { subscribe, dispatch };
 };
 
-// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/authBridge/index.js
-var hashPKCECode = async (input) => {
-  const textAsBuffer = new TextEncoder().encode(input);
-  const hashBuffer = await window.crypto.subtle.digest("SHA-256", textAsBuffer);
-  const hashArray = new Uint8Array(hashBuffer);
-  const binaryString = String.fromCharCode(...hashArray);
-  const base64 = btoa(binaryString);
-  return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
-};
-var generatePKCECode = () => {
-  if (!window.crypto) {
-    throw new Error("Crypto API not available");
+var SandboxedAuthClient = class {
+  /**
+   * Binds the public start method because the exported SDK API may pass it
+   * around without its client object as the receiver.
+   */
+  constructor() {
+    this.startAuth = this.startAuth.bind(this);
   }
-  const array = new Uint32Array(56);
-  window.crypto.getRandomValues(array);
-  return Array.from(array, (dec) => `0${dec.toString(16)}`.slice(-2)).join("");
-};
-var createAuthBridgeApi = () => {
-  return {
-    startAuth: async (request) => {
-      const state = generateMessageId();
-      let pkceCode = "";
-      let code_verifier = "";
-      if (request.generatePKCE) {
-        code_verifier = generatePKCECode();
-        pkceCode = await hashPKCECode(code_verifier);
+  /**
+   * Starts provider authentication and optionally adds an RFC 7636 PKCE
+   * challenge to the request. Successful responses include the verifier that
+   * the caller must pass to {@link exchangeCode}.
+   */
+  async startAuth(request) {
+    const state = generateMessageId();
+    let pkceCode = "";
+    let code_verifier = "";
+    if (request.generatePKCE) {
+      code_verifier = this.generatePKCECode();
+      pkceCode = await this.hashPKCECode(code_verifier);
+    }
+    const message = {
+      command: FROM_EXTENSION_COMMANDS.AUTH_START,
+      messageId: generateMessageId(),
+      state,
+      provider: request.provider,
+      params: {
+        ...request.params,
+        ...pkceCode ? {
+          code_challenge: pkceCode,
+          code_challenge_method: "S256"
+        } : {}
       }
-      const message = {
-        command: FROM_EXTENSION_COMMANDS.AUTH_START,
-        messageId: generateMessageId(),
-        state,
-        provider: request.provider,
-        params: {
-          ...request.params,
-          ...pkceCode ? {
-            code_challenge: pkceCode,
-            code_challenge_method: "S256"
-          } : {}
-        }
-      };
-      const response = await sendMessage(message);
-      if (!response.isOk) {
-        return response;
+    };
+    const response = await sendMessage(message);
+    if (!response.isOk) {
+      return response;
+    }
+    return {
+      ...response,
+      result: {
+        ...response.result,
+        code_verifier
       }
-      return {
-        ...response,
-        result: {
-          ...response.result,
-          code_verifier
-        }
-      };
-    },
-    exchangeCode: (request) => {
-      const message = {
-        command: FROM_EXTENSION_COMMANDS.AUTH_EXCHANGE,
-        messageId: generateMessageId(),
-        code: request.code,
-        code_verifier: request.code_verifier,
-        provider: request.provider,
-        params: request.params,
-        headers: request.headers
-      };
-      return sendMessage(message);
-    },
-    getAuthToken: (request) => {
-      const message = {
-        command: FROM_EXTENSION_COMMANDS.AUTH_GET_TOKEN,
-        messageId: generateMessageId(),
-        provider: request.provider
-      };
-      return sendMessage(message);
-    },
-    refreshToken: (request) => {
-      const message = {
-        command: FROM_EXTENSION_COMMANDS.AUTH_REFRESH,
-        messageId: generateMessageId(),
-        provider: request.provider
-      };
-      return sendMessage(message);
-    },
-    logout: (request) => {
-      const message = {
-        command: FROM_EXTENSION_COMMANDS.AUTH_LOGOUT,
-        messageId: generateMessageId(),
-        provider: request.provider
-      };
-      return sendMessage(message);
-    },
-    getUserToken: () => {
-      const message = {
-        command: "auth-get-user-token",
-        messageId: generateMessageId()
-      };
-      return sendMessage(message);
+    };
+  }
+  /** Exchanges the provider authorization code for an auth token. */
+  exchangeCode(request) {
+    const message = {
+      command: FROM_EXTENSION_COMMANDS.AUTH_EXCHANGE,
+      messageId: generateMessageId(),
+      code: request.code,
+      code_verifier: request.code_verifier,
+      provider: request.provider,
+      params: request.params,
+      headers: request.headers
+    };
+    return sendMessage(message);
+  }
+  /** Requests the current auth token for a provider. */
+  getAuthToken(request) {
+    const message = {
+      command: FROM_EXTENSION_COMMANDS.AUTH_GET_TOKEN,
+      messageId: generateMessageId(),
+      provider: request.provider
+    };
+    return sendMessage(message);
+  }
+  /** Refreshes the auth token for a provider. */
+  refreshToken(request) {
+    const message = {
+      command: FROM_EXTENSION_COMMANDS.AUTH_REFRESH,
+      messageId: generateMessageId(),
+      provider: request.provider
+    };
+    return sendMessage(message);
+  }
+  /** Logs the current user out of a provider. */
+  logout(request) {
+    const message = {
+      command: FROM_EXTENSION_COMMANDS.AUTH_LOGOUT,
+      messageId: generateMessageId(),
+      provider: request.provider
+    };
+    return sendMessage(message);
+  }
+  /** Requests the authenticated user's user token from the parent window. */
+  getUserToken() {
+    const message = {
+      command: FROM_EXTENSION_COMMANDS.AUTH_GET_USER_TOKEN,
+      messageId: generateMessageId()
+    };
+    return sendMessage(message);
+  }
+  /** Hashes a PKCE verifier and encodes the SHA-256 digest as Base64URL. */
+  async hashPKCECode(input) {
+    const subtle = window.crypto?.subtle;
+    if (!subtle) {
+      throw new Error("Web Crypto SubtleCrypto API not available");
     }
-  };
+    const textAsBuffer = new TextEncoder().encode(input);
+    const hashBuffer = await subtle.digest("SHA-256", textAsBuffer);
+    const hashArray = new Uint8Array(hashBuffer);
+    const binaryString = String.fromCharCode(...hashArray);
+    const base64 = btoa(binaryString);
+    return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+  }
+  /** Generates a high-entropy RFC 7636-compatible PKCE verifier. */
+  generatePKCECode() {
+    if (!window.crypto) {
+      throw new Error("Crypto API not available");
+    }
+    const array = new Uint32Array(56);
+    window.crypto.getRandomValues(array);
+    return Array.from(array, (dec) => `0${dec.toString(16)}`.slice(-2)).join(
+      ""
+    );
+  }
 };
 
-// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/batch/index.js
 var createBatch = async () => {
   const response = await sendMessage({
     command: FROM_EXTENSION_COMMANDS.BATCH_CREATE,
@@ -674,7 +696,6 @@ var createBatch = async () => {
   return buildNode([]);
 };
 
-// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/context/contextBridge.js
 var createContextBridgeApi = () => {
   const contextProxy = createApiProxy("context");
   const subscriptionCallbacks = /* @__PURE__ */ new Map();
@@ -721,7 +742,6 @@ var createContextBridgeApi = () => {
   return { api, dispatch };
 };
 
-// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/designState/index.js
 var sendUnsubscribe2 = (selectorIds) => {
   const message = {
     command: FROM_EXTENSION_COMMANDS.DESIGN_STATE_UNSUBSCRIBE,
@@ -788,7 +808,6 @@ var createDesignStateBridgeApi = () => {
   return { subscribe, dispatch };
 };
 
-// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers/stateless/index.js
 var createStatelessBridgeApi = () => {
   const subscribers = /* @__PURE__ */ new Map();
   return {
@@ -838,11 +857,11 @@ var createStatelessBridgeApi = () => {
   };
 };
 
-// ../../packages/editor-core/sdk/sdk-bridge/dist/bridge/sandboxed/handlers.js
 var statelessApi = createStatelessBridgeApi();
 var designStateApi = createDesignStateBridgeApi();
 var appStateApi = createAppStateBridgeApi();
 var { api: contextApi, dispatch: dispatchContextUpdate } = createContextBridgeApi();
+var authClient = new SandboxedAuthClient();
 var handleIncomingMessage = (event) => {
   const parent = window.parent;
   if (!parent || parent === window) {
@@ -896,11 +915,12 @@ var bridgeHandlers = {
   design: createApiProxy("design"),
   designStore: designStateApi,
   appStore: appStateApi,
+  export: createApiProxy("export"),
   font: createApiProxy("font"),
   state: createApiProxy("state"),
   upload: createApiProxy("upload"),
   fileBrowser: createFileBrowserApiProxy(),
-  auth: createAuthBridgeApi(),
+  auth: authClient,
   stateless: statelessApi,
   createBatch
 };
@@ -1174,6 +1194,31 @@ var DragAndDropApi = class {
   }
 };
 
+// src/createEditorSDKAPIs.ts
+function createEditorSDKAPIs() {
+  return {
+    ai: bridgeHandlers.ai,
+    data: bridgeHandlers.data,
+    design: bridgeHandlers.design,
+    export: bridgeHandlers.export,
+    designStore: bridgeHandlers.designStore,
+    appStore: bridgeHandlers.appStore,
+    context: bridgeHandlers.context,
+    dragAndDrop: new DragAndDropApi({
+      state: bridgeHandlers.state,
+      context: bridgeHandlers.context,
+      design: bridgeHandlers.design,
+      upload: bridgeHandlers.upload
+    }),
+    state: bridgeHandlers.state,
+    auth: bridgeHandlers.auth,
+    upload: bridgeHandlers.upload,
+    stateless: bridgeHandlers.stateless,
+    font: bridgeHandlers.font,
+    createBatch: bridgeHandlers.createBatch
+  };
+}
+
 // src/utils/syncHtmlDataThemeFromHostContext.ts
 async function syncHtmlDataThemeFromHostContext(kittl2) {
   if (typeof document === "undefined") {
@@ -1192,46 +1237,49 @@ async function syncHtmlDataThemeFromHostContext(kittl2) {
   });
 }
 
-// src/index.ts
-var kittl = {
-  onLoadedCallback: null,
-  loaded: false,
-  onReady: (cb) => {
-    if (kittl.loaded) {
-      cb();
-      return;
-    }
-    kittl.onLoadedCallback = cb;
-  },
-  ...bridgeHandlers,
-  dragAndDrop: new DragAndDropApi({
-    state: bridgeHandlers.state,
-    context: bridgeHandlers.context,
-    design: bridgeHandlers.design,
-    upload: bridgeHandlers.upload
-  })
-};
-var initSdk = () => {
-  kittl.loaded = true;
-  window.addEventListener(
-    "message",
-    (event) => {
-      handleIncomingMessage(event);
+// src/createKittlSDK.ts
+function createKittlSDK(apis) {
+  const kittl2 = {
+    onLoadedCallback: null,
+    loaded: false,
+    onReady: (callback) => {
+      if (kittl2.loaded) {
+        callback();
+        return;
+      }
+      kittl2.onLoadedCallback = callback;
+    },
+    ...apis
+  };
+  const initSdk = () => {
+    kittl2.loaded = true;
+    window.addEventListener(
+      "message",
+      (event) => {
+        handleIncomingMessage(event);
+      }
+    );
+    void syncHtmlDataThemeFromHostContext(kittl2).then(() => {
+      kittl2.onLoadedCallback?.();
+      sendLoaded();
+    });
+  };
+  if (typeof document !== "undefined" && typeof window !== "undefined") {
+    window.kittl = kittl2;
+    if (document.readyState === "loading") {
+      document.addEventListener("DOMContentLoaded", initSdk);
+    } else {
+      initSdk();
     }
-  );
-  void syncHtmlDataThemeFromHostContext(kittl).then(() => {
-    kittl.onLoadedCallback?.();
-    sendLoaded();
-  });
-};
-if (typeof document !== "undefined" && typeof window !== "undefined") {
-  window.kittl = kittl;
-  if (document.readyState === "loading") {
-    document.addEventListener("DOMContentLoaded", initSdk);
-  } else {
-    initSdk();
   }
+  return kittl2;
 }
+
+// src/index.ts
+var kittl = createKittlSDK({
+  ...createEditorSDKAPIs(),
+  fileBrowser: bridgeHandlers.fileBrowser
+});
 export {
   kittl,
   unwrapResult