@canva/design 2.7.3-beta.0 → 2.7.4-beta.0

package/beta.d.ts

@@ -1026,6 +1026,14 @@ export declare type ContentType = "richtext" | "fill";
  */
 declare type ContentType_2 = "richtext";
 
+/**
+ * @beta
+ */
+export declare type ContentTypeMap = {
+  richtext: RichtextContentSession;
+  fill: FillContentSession;
+};
+
 /**
  * @public
  * Options for configuring where content in a design should be queried from.
@@ -1587,9 +1595,9 @@ export declare namespace DesignEditing {
   };
   /**
    * @public
-   * The result of reading part of a design when the context is the current page.
+   * Session received by the `openDesign` callback when opening the current page.
    */
-  export type CurrentPageResult<
+  export type CurrentPageSession<
     Page = DesignEditing.Page,
     Helpers = DesignEditing.PageHelpers,
   > = Readonly<{
@@ -1602,7 +1610,7 @@ export declare namespace DesignEditing {
      */
     helpers: Helpers;
     /**
-     * Saves any changes made during the session while keeping the transaction open.
+     * Saves any changes made during the session while keeping the session open.
      *
      * @remarks
      * - Any changes in the session are only reflected in the design after this method is called.
@@ -1610,13 +1618,107 @@ export declare namespace DesignEditing {
      */
     sync(): Promise<void>;
   }>;
+  /**
+   * @deprecated The type has been superseded by `CurrentPageSession`.
+   * @public
+   * Session received by the `openDesign` callback when opening the current page.
+   */
+  export type CurrentPageResult = CurrentPageSession;
+  /**
+   * @beta
+   * The response from `openPage` indicating whether the callback was executed.
+   */
+  export type OpenPageResponse =
+    | OpenPageCallbackExecuted
+    | OpenPageCallbackSkipped;
+  /**
+   * @beta
+   * The response from `openPage` if the callback was executed.
+   */
+  export type OpenPageCallbackExecuted = {
+    status: "executed";
+  };
+  /**
+   * @beta
+   * The response from `openPage` if the callback was not executed.
+   */
+  export type OpenPageCallbackSkipped = {
+    status: "skipped";
+    /**
+     * Reason that the callback was not executed.
+     */
+    reason: string;
+  };
+  /**
+   * @beta
+   * Helpers for use when reading all pages of the design.
+   *
+   * @preventInline
+   */
+  export type AllPagesHelpers = {
+    /**
+     * Reads (and optionally updates) a page of the user's design.
+     * @param pageRef - Reference to the page to be read.
+     * @param callback - A callback for operating on the page of the design.
+     * @returns A response indicating whether the callback was executed.
+     */
+    openPage(
+      pageRef: AbsolutePageRef,
+      callback: DesignOpenPageCallback<AbsolutePage>,
+    ): Promise<OpenPageResponse>;
+    openPage(
+      pageRef: Unsupported,
+      callback: DesignOpenPageCallback<Unsupported>,
+    ): Promise<OpenPageResponse>;
+    openPage(
+      pageRef: PageRef,
+      callback: DesignOpenPageCallback,
+    ): Promise<OpenPageResponse>;
+  };
+  /**
+   * @beta
+   * Session received by the `openDesign` callback when opening all pages.
+   */
+  export type AllPagesSession = Readonly<{
+    /**
+     * References to all pages of the design.
+     */
+    pageRefs: DesignEditing.PageRefList;
+    /**
+     * These are various utilities that allow apps to do more complex operations on the page.
+     */
+    helpers: DesignEditing.AllPagesHelpers;
+    /**
+     * Saves any changes made during the session while keeping the session open.
+     *
+     * @remarks
+     * - Any changes in the session are only reflected in the design after this method is called.
+     * - Once this method is called, further changes in the session can still be made.
+     */
+    sync(): Promise<void>;
+  }>;
+  /**
+   * @beta
+   * Result received by the `openPage` callback.
+   */
+  export type OpenPageResult<
+    Page extends DesignEditing.Page = DesignEditing.Page,
+  > = Readonly<{
+    /**
+     * The page of the design.
+     */
+    page: Page;
+    /**
+     * These are various utilities that allow apps to do more complex operations on the page.
+     */
+    helpers: PageHelpers;
+  }>;
   /**
    * A function called for each item in the list.
    *
    * @param item - The current item in the list.
-   * @param index - The index of the current item.
    */
-  export type ForEachCallback<M> = (item: M, index: number) => void;
+  export type ForEachCallback<M> = (item: M) => void;
   /**
    * A function that determines if an item should be included in the result.
    *
@@ -1736,6 +1838,7 @@ export declare namespace DesignEditing {
     ): U[];
     readonly length: number;
     readonly [n: number]: T;
+    at(index: number): T | undefined;
   }
   /**
    * @public
@@ -2637,6 +2740,32 @@ export declare namespace DesignEditing {
    */
   export type Page = AbsolutePage | Unsupported;
 
+  /**
+   * @beta
+   * A reference to an `absolute` type page.
+   */
+  export type AbsolutePageRef = {
+    /**
+     * The type of page.
+     */
+    readonly type: "absolute";
+    /**
+     * If `true`, the page is locked and cannot be modified.
+     */
+    readonly locked: boolean;
+  };
+
+  /**
+   * @beta
+   * A reference to a page.
+   */
+  export type PageRef = AbsolutePageRef | Unsupported;
+
+  /**
+   * @beta
+   * A list containing the references to pages in the design.
+   */
+  export type PageRefList = ReadableList<PageRef>;
   {
   }
 }
@@ -2689,21 +2818,86 @@ export declare type DesignMetadata = {
   durationInSeconds: number;
 };
 
+/**
+ * @beta
+ * A callback for operating on all pages of the design.
+ * @param session - Session received by the `openDesign` callback when opening all pages.
+ */
+export declare type DesignOpenAllPagesCallback = (
+  session: DesignEditing.AllPagesSession,
+) => Promise<void>;
+
+/**
+ * @beta
+ * Options for configuring how all pages of the design are read.
+ */
+export declare type DesignOpenAllPagesOptions = {
+  /**
+   * The type of context.
+   */
+  type: "all_pages";
+};
+
 /**
  * @public
  * A callback for reading and updating part of a design.
- * @param session - The result of reading part of a design.
+ * @param session - Session received by the `openDesign` callback.
  */
 export declare type DesignOpenCallback = (
-  session: DesignEditing.CurrentPageResult,
+  session: DesignEditing.CurrentPageSession,
+) => Promise<void>;
+
+/**
+ * @beta
+ * A callback for operating on the design.
+ */
+declare type DesignOpenCallback_2 =
+  | DesignOpenCurrentPageCallback
+  | DesignOpenAllPagesCallback;
+
+/**
+ * @beta
+ * A callback for operating on the current page of the design.
+ * @param session - Session received by the `openDesign` callback when opening the current page.
+ */
+export declare type DesignOpenCurrentPageCallback = (
+  session: DesignEditing.CurrentPageSession,
 ) => Promise<void>;
 
+/**
+ * @beta
+ * Options for configuring how the current page of the design is read.
+ */
+export declare type DesignOpenCurrentPageOptions = {
+  /**
+   * The type of context.
+   */
+  type: "current_page";
+};
+
 /**
  * @public
  * Options for configuring which part of a design to read.
  */
 export declare type DesignOpenOptions = DesignContextOptions;
 
+/**
+ * @beta
+ * Options for configuring how the design is read.
+ */
+declare type DesignOpenOptions_2 =
+  | DesignOpenCurrentPageOptions
+  | DesignOpenAllPagesOptions;
+
+/**
+ * @beta
+ * A callback for operating on a page of the design.
+ * @param response - Result received by the `openPage` callback.
+ */
+export declare type DesignOpenPageCallback<
+  Page extends DesignEditing.Page = DesignEditing.Page,
+> = (response: DesignEditing.OpenPageResult<Page>) => Promise<void>;
+
 /**
  * @public
  * Provides methods for managing the lifecycle of overlays, such as selected image overlays.
@@ -2953,6 +3147,20 @@ export declare function editContent(
   callback: (session: FillContentSession) => Promise<void> | void,
 ): Promise<void>;
 
+/**
+ * @beta
+ * Reads and edits content from the user's design.
+ * @param options - Options for configuring how a design is read. Must specify a content type.
+ * @param callback - A callback that receives a session for editing.
+ * @returns A promise that resolves when editing is complete.
+ */
+export declare function editContent<T extends ContentType>(
+  options: EditContentOptions & {
+    contentType: T;
+  },
+  callback: (session: ContentTypeMap[T]) => Promise<void> | void,
+): Promise<void>;
+
 /**
  * @beta
  * A callback for reading and updating the requested design content.
@@ -3793,17 +4001,22 @@ export declare type NativeVideoElementWithBox = VideoElementAtPoint;
 declare type ObjectPrimitive = Boolean | String;
 
 /**
- * @public
- *
- * Reads a specified part of the user's design and returns all elements in that part.
- *
+ * @beta
+ * Reads (and optionally updates) a specified part of the user's design.
  * @param options - Options for configuring how the design is read.
  * @param callback - A callback for operating on the design.
  */
-export declare const openDesign: (
-  options: DesignOpenOptions,
-  callback: DesignOpenCallback,
-) => Promise<void>;
+export declare const openDesign: {
+  (
+    options: DesignOpenCurrentPageOptions,
+    callback: DesignOpenCurrentPageCallback,
+  ): Promise<void>;
+  (
+    options: DesignOpenAllPagesOptions,
+    callback: DesignOpenAllPagesCallback,
+  ): Promise<void>;
+  (options: DesignOpenOptions_2, callback: DesignOpenCallback_2): Promise<void>;
+};
 
 /**
  * @public

package/index.d.ts

@@ -0,0 +1 @@
+export * from "./beta";

package/lib/cjs/sdk/design/beta.js

@@ -2,12 +2,21 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-Object.defineProperty(exports, "editContent", {
-    enumerable: true,
-    get: function() {
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get editContent () {
         return editContent;
+    },
+    get openDesign () {
+        return openDesign;
     }
 });
+const _version = require("./version");
 _export_star(require("./public"), exports);
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {
@@ -22,9 +31,9 @@ function _export_star(from, to) {
     });
     return from;
 }
-var _window___canva___sdkRegistration, _window___canva__;
 const { canva_sdk } = window;
 function editContent(options, callback) {
     return canva_sdk.design.v2.designInteraction.editContent(options, (session)=>callback(session));
 }
-(_window___canva__ = window.__canva__) === null || _window___canva__ === void 0 ? void 0 : (_window___canva___sdkRegistration = _window___canva__.sdkRegistration) === null || _window___canva___sdkRegistration === void 0 ? void 0 : _window___canva___sdkRegistration.registerPackageVersion('design', '2.7.2', 'beta');
+const openDesign = canva_sdk.design.v2.designInteraction.openDesign;
+window.__canva__?.sdkRegistration?.registerPackageVersion('design', _version.LATEST_VERSION, 'beta');

package/lib/cjs/sdk/design/fake/create_beta.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "createBetaFakeDesignClients", {
+    enumerable: true,
+    get: function() {
+        return createBetaFakeDesignClients;
+    }
+});
+const _synthetic_delay = require('../../utils/synthetic_delay');
+const _fake_design_interaction_client = require("./fake_design_interaction_client");
+const _fake_drag_and_drop_client = require("./fake_drag_and_drop_client");
+const _fake_export_client = require("./fake_export_client");
+function createBetaFakeDesignClients() {
+    const syntheticDelay = (0, _synthetic_delay.createSyntheticDelay)(10);
+    const v2 = {
+        designInteraction: new FakeBetaDesignInteractionClient(syntheticDelay),
+        dragAndDrop: new _fake_drag_and_drop_client.FakeDragAndDropClient(syntheticDelay),
+        export: new _fake_export_client.FakeExportClient(syntheticDelay)
+    };
+    return {
+        design: {
+            v2
+        }
+    };
+}
+class FakeBetaDesignInteractionClient extends _fake_design_interaction_client.FakeDesignInteractionClient {
+    async editContent(options, callback) {
+        await this.delay();
+        await callback({
+            contents: [],
+            sync: async ()=>{
+                await this.delay();
+            }
+        });
+    }
+    async openDesign(options, callback) {
+        await this.delay();
+        await callback({
+            page: _fake_design_interaction_client.fakePage,
+            pageRefs: fakePageRefList,
+            sync: async ()=>{
+                await this.delay();
+            },
+            helpers: {
+                ..._fake_design_interaction_client.fakeOpenDesignHelpers,
+                openPage: async (_, callback)=>{
+                    await callback({
+                        page: _fake_design_interaction_client.fakePage,
+                        helpers: _fake_design_interaction_client.fakeOpenDesignHelpers
+                    });
+                    return {
+                        status: 'executed'
+                    };
+                }
+            }
+        });
+    }
+}
+const fakePageRef = {
+    type: 'absolute',
+    locked: false
+};
+const fakePageRefList = {
+    forEach (callback) {},
+    toArray () {
+        return [
+            fakePageRef
+        ];
+    },
+    count () {
+        return 0;
+    },
+    filter (filter) {}
+};

package/lib/cjs/sdk/design/fake/fake_design_interaction_client.js

@@ -2,10 +2,21 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-Object.defineProperty(exports, "FakeDesignInteractionClient", {
-    enumerable: true,
-    get: function() {
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get FakeDesignInteractionClient () {
         return FakeDesignInteractionClient;
+    },
+    get fakeOpenDesignHelpers () {
+        return fakeOpenDesignHelpers;
+    },
+    get fakePage () {
+        return fakePage;
     }
 });
 class FakeDesignInteractionClient {
@@ -114,14 +125,7 @@ class FakeDesignInteractionClient {
             sync: async ()=>{
                 await this.delay();
             },
-            helpers: {
-                elementStateBuilder: fakeElementStateBuilder,
-                group: fakeAsyncOperations.group,
-                ungroup: fakeAsyncOperations.ungroup,
-                snapshot: ()=>{
-                    return {};
-                }
-            }
+            helpers: fakeOpenDesignHelpers
         });
     }
     constructor(delay){
@@ -360,3 +364,11 @@ const fakeAsyncOperations = {
         ];
     }
 };
+const fakeOpenDesignHelpers = {
+    elementStateBuilder: fakeElementStateBuilder,
+    group: fakeAsyncOperations.group,
+    ungroup: fakeAsyncOperations.ungroup,
+    snapshot: ()=>{
+        return {};
+    }
+};

package/lib/cjs/sdk/design/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./beta"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}

package/lib/cjs/sdk/design/test/beta.js

@@ -2,17 +2,15 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-_export_star(require("./index"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
+Object.defineProperty(exports, "initTestEnvironment", {
+    enumerable: true,
+    get: function() {
+        return initTestEnvironment;
+    }
+});
+const _create_beta = require('../fake/create_beta');
+const _canva_sdk = require('../../utils/canva_sdk');
+function initTestEnvironment() {
+    (0, _canva_sdk.assertIsTestCanvaSdk)();
+    (0, _canva_sdk.injectFakeAPIClients)((0, _create_beta.createBetaFakeDesignClients)());
 }

package/lib/cjs/sdk/design/test/index.js

@@ -1,16 +1,18 @@
-"use strict"
+"use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-Object.defineProperty(exports, "initTestEnvironment", {
-    enumerable: true,
-    get: function() {
-        return initTestEnvironment;
-    }
-});
-const _create = require('../fake/create');
-const _canva_sdk = require('../../utils/canva_sdk');
-function initTestEnvironment() {
-    (0, _canva_sdk.assertIsTestCanvaSdk)();
-    (0, _canva_sdk.injectFakeAPIClients)((0, _create.createFakeDesignClients)());
+_export_star(require("./beta"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
 }

package/lib/cjs/sdk/design/version.js

@@ -0,0 +1,11 @@
+"use strict"
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "LATEST_VERSION", {
+    enumerable: true,
+    get: function() {
+        return LATEST_VERSION;
+    }
+});
+const LATEST_VERSION = '2.7.3';

package/lib/cjs/sdk/utils/canva_sdk.js

@@ -26,10 +26,8 @@ function getCanvaSdk() {
     return window.canva_sdk;
 }
 function assertIsTestCanvaSdk() {
-    var _window___canva__;
-    if ((_window___canva__ = window.__canva__) === null || _window___canva__ === void 0 ? void 0 : _window___canva__.uiKit) {
-        var _getCanvaSdk_error, _getCanvaSdk;
-        const CanvaError = (_getCanvaSdk = getCanvaSdk()) === null || _getCanvaSdk === void 0 ? void 0 : (_getCanvaSdk_error = _getCanvaSdk.error) === null || _getCanvaSdk_error === void 0 ? void 0 : _getCanvaSdk_error.v2.CanvaError;
+    if (window.__canva__?.uiKit) {
+        const CanvaError = getCanvaSdk()?.error?.v2.CanvaError;
         throw new CanvaError({
             code: 'failed_precondition',
             message: "Canva App SDK: You're attempting to call `initTestEnvironment` in a non-test environment, such as in production. This method should be called in test environments, once and only once. For more info refer to https://canva.dev/docs/apps/testing/"

package/lib/esm/sdk/design/beta.js

@@ -1,7 +1,8 @@
-var _window___canva___sdkRegistration, _window___canva__;
+import { LATEST_VERSION } from './version';
 const { canva_sdk } = window;
 export function editContent(options, callback) {
     return canva_sdk.design.v2.designInteraction.editContent(options, (session)=>callback(session));
 }
+export const openDesign = canva_sdk.design.v2.designInteraction.openDesign;
 export * from './public';
-(_window___canva__ = window.__canva__) === null || _window___canva__ === void 0 ? void 0 : (_window___canva___sdkRegistration = _window___canva__.sdkRegistration) === null || _window___canva___sdkRegistration === void 0 ? void 0 : _window___canva___sdkRegistration.registerPackageVersion('design', '2.7.2', 'beta');
+window.__canva__?.sdkRegistration?.registerPackageVersion('design', LATEST_VERSION, 'beta');

package/lib/esm/sdk/design/fake/create_beta.js

@@ -0,0 +1,66 @@
+import { createSyntheticDelay } from '../../utils/synthetic_delay';
+import { FakeDesignInteractionClient, fakeOpenDesignHelpers, fakePage } from './fake_design_interaction_client';
+import { FakeDragAndDropClient } from './fake_drag_and_drop_client';
+import { FakeExportClient } from './fake_export_client';
+export function createBetaFakeDesignClients() {
+    const syntheticDelay = createSyntheticDelay(10);
+    const v2 = {
+        designInteraction: new FakeBetaDesignInteractionClient(syntheticDelay),
+        dragAndDrop: new FakeDragAndDropClient(syntheticDelay),
+        export: new FakeExportClient(syntheticDelay)
+    };
+    return {
+        design: {
+            v2
+        }
+    };
+}
+class FakeBetaDesignInteractionClient extends FakeDesignInteractionClient {
+    async editContent(options, callback) {
+        await this.delay();
+        await callback({
+            contents: [],
+            sync: async ()=>{
+                await this.delay();
+            }
+        });
+    }
+    async openDesign(options, callback) {
+        await this.delay();
+        await callback({
+            page: fakePage,
+            pageRefs: fakePageRefList,
+            sync: async ()=>{
+                await this.delay();
+            },
+            helpers: {
+                ...fakeOpenDesignHelpers,
+                openPage: async (_, callback)=>{
+                    await callback({
+                        page: fakePage,
+                        helpers: fakeOpenDesignHelpers
+                    });
+                    return {
+                        status: 'executed'
+                    };
+                }
+            }
+        });
+    }
+}
+const fakePageRef = {
+    type: 'absolute',
+    locked: false
+};
+const fakePageRefList = {
+    forEach (callback) {},
+    toArray () {
+        return [
+            fakePageRef
+        ];
+    },
+    count () {
+        return 0;
+    },
+    filter (filter) {}
+};

package/lib/esm/sdk/design/fake/fake_design_interaction_client.js

@@ -104,14 +104,7 @@ export class FakeDesignInteractionClient {
             sync: async ()=>{
                 await this.delay();
             },
-            helpers: {
-                elementStateBuilder: fakeElementStateBuilder,
-                group: fakeAsyncOperations.group,
-                ungroup: fakeAsyncOperations.ungroup,
-                snapshot: ()=>{
-                    return {};
-                }
-            }
+            helpers: fakeOpenDesignHelpers
         });
     }
     constructor(delay){
@@ -202,7 +195,7 @@ const fakeElementList = {
         return fakeRectElement;
     }
 };
-const fakePage = {
+export const fakePage = {
     type: 'absolute',
     locked: false,
     dimensions: fakePageDimensions,
@@ -350,3 +343,11 @@ const fakeAsyncOperations = {
         ];
     }
 };
+export const fakeOpenDesignHelpers = {
+    elementStateBuilder: fakeElementStateBuilder,
+    group: fakeAsyncOperations.group,
+    ungroup: fakeAsyncOperations.ungroup,
+    snapshot: ()=>{
+        return {};
+    }
+};

package/lib/esm/sdk/design/index.js

@@ -0,0 +1 @@
+export * from './beta';

package/lib/esm/sdk/design/test/beta.js

@@ -1 +1,6 @@
-export * from './index';
+import { createBetaFakeDesignClients } from '../fake/create_beta';
+import { assertIsTestCanvaSdk, injectFakeAPIClients } from '../../utils/canva_sdk';
+export function initTestEnvironment() {
+    assertIsTestCanvaSdk();
+    injectFakeAPIClients(createBetaFakeDesignClients());
+}

package/lib/esm/sdk/design/test/index.js

@@ -1,6 +1 @@
-import { createFakeDesignClients } from '../fake/create';
-import { assertIsTestCanvaSdk, injectFakeAPIClients } from '../../utils/canva_sdk';
-export function initTestEnvironment() {
-    assertIsTestCanvaSdk();
-    injectFakeAPIClients(createFakeDesignClients());
-}
+export * from './beta';

package/lib/esm/sdk/design/version.js

@@ -0,0 +1 @@
+export const LATEST_VERSION = '2.7.3';

package/lib/esm/sdk/utils/canva_sdk.js

@@ -2,10 +2,8 @@ export function getCanvaSdk() {
     return window.canva_sdk;
 }
 export function assertIsTestCanvaSdk() {
-    var _window___canva__;
-    if ((_window___canva__ = window.__canva__) === null || _window___canva__ === void 0 ? void 0 : _window___canva__.uiKit) {
-        var _getCanvaSdk_error, _getCanvaSdk;
-        const CanvaError = (_getCanvaSdk = getCanvaSdk()) === null || _getCanvaSdk === void 0 ? void 0 : (_getCanvaSdk_error = _getCanvaSdk.error) === null || _getCanvaSdk_error === void 0 ? void 0 : _getCanvaSdk_error.v2.CanvaError;
+    if (window.__canva__?.uiKit) {
+        const CanvaError = getCanvaSdk()?.error?.v2.CanvaError;
         throw new CanvaError({
             code: 'failed_precondition',
             message: "Canva App SDK: You're attempting to call `initTestEnvironment` in a non-test environment, such as in production. This method should be called in test environments, once and only once. For more info refer to https://canva.dev/docs/apps/testing/"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canva/design",
-  "version": "2.7.3-beta.0",
+  "version": "2.7.4-beta.0",
   "description": "The Canva Apps SDK design library",
   "author": "Canva Pty Ltd.",
   "license": "SEE LICENSE IN LICENSE.md FILE",

package/test/beta.d.ts

@@ -1,5 +1,5 @@
 /**
- * @public
+ * @beta
  * Initializes a test environment for the `@canva/design` package, enabling unit tests to mock Canva's APIs.
  * @remarks
  * This method should only be called once in a test environment, such as in a Jest setup file.

package/test/index.d.ts

@@ -0,0 +1 @@
+export * from "./beta";

package/lib/cjs/sdk/design/fake/create.js

@@ -1,27 +0,0 @@
-"use strict"
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "createFakeDesignClients", {
-    enumerable: true,
-    get: function() {
-        return createFakeDesignClients;
-    }
-});
-const _synthetic_delay = require('../../utils/synthetic_delay');
-const _fake_design_interaction_client = require("./fake_design_interaction_client");
-const _fake_drag_and_drop_client = require("./fake_drag_and_drop_client");
-const _fake_export_client = require("./fake_export_client");
-function createFakeDesignClients() {
-    const syntheticDelay = (0, _synthetic_delay.createSyntheticDelay)(10);
-    const v2 = {
-        designInteraction: new _fake_design_interaction_client.FakeDesignInteractionClient(syntheticDelay),
-        dragAndDrop: new _fake_drag_and_drop_client.FakeDragAndDropClient(syntheticDelay),
-        export: new _fake_export_client.FakeExportClient(syntheticDelay)
-    };
-    return {
-        design: {
-            v2
-        }
-    };
-}

package/lib/esm/sdk/design/fake/create.js

@@ -1,17 +0,0 @@
-import { createSyntheticDelay } from '../../utils/synthetic_delay';
-import { FakeDesignInteractionClient } from './fake_design_interaction_client';
-import { FakeDragAndDropClient } from './fake_drag_and_drop_client';
-import { FakeExportClient } from './fake_export_client';
-export function createFakeDesignClients() {
-    const syntheticDelay = createSyntheticDelay(10);
-    const v2 = {
-        designInteraction: new FakeDesignInteractionClient(syntheticDelay),
-        dragAndDrop: new FakeDragAndDropClient(syntheticDelay),
-        export: new FakeExportClient(syntheticDelay)
-    };
-    return {
-        design: {
-            v2
-        }
-    };
-}