@canva/intents 2.1.0 → 2.1.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # CHANGELOG
 
+## 2.1.2 - 2026-02-03
+
+### Fixed
+
+- Fix missing id and status fields in Content Publisher email preview type
+
+## 2.1.1 - 2026-01-30
+
+### Changed
+
+- Update NPM readme
+
 ## 2.1.0 - 2026-01-30
 
 ### Added

package/README.md

@@ -22,6 +22,7 @@ An "intent" represents a specific user workflow an app can support. For example:
 
 - Users can select and import data from an app which implements the **Data Connector** intent.
 - An app is able to present interactive and creative tooling alongside the Canva design surface by implementing the **Design Editor** intent.
+- Users can publish their Canva designs directly to external platforms.
 
 The `@canva/intents` package encompasses **all available intents**, exporting each intent's type information and prepare function, grouped by domain.
 This allows your app to prepare one or more intents while keeping each intent's implementation modular and type-safe.
@@ -30,6 +31,7 @@ Currently supported intents:
 
 - [`Data Connector`](#data-connector-example)
 - [`Design Editor`](#design-editor-example)
+- [`Content Publisher`](#content-publisher-example)
 
 New intents will be added to this package in the future.
 
@@ -97,6 +99,69 @@ prepareDesignEditor({
 });
 ```
 
+### Content Publisher example
+
+```ts
+import { prepareContentPublisher } from "@canva/intents/content";
+
+prepareContentPublisher({
+  renderSettingsUi: ({
+    updatePublishSettings,
+    registerOnContextChange,
+  }) => {
+    root.render(
+      <AppUiProvider>
+        <SettingUi
+          updatePublishSettings={updatePublishSettings}
+          registerOnContextChange={registerOnContextChange}
+        />
+      </AppUiProvider>,
+    );
+  },
+
+  renderPreviewUi: ({ registerOnPreviewChange }) => {
+    root.render(
+      <AppUiProvider>
+        <PreviewUi registerOnPreviewChange={registerOnPreviewChange} />
+      </AppUiProvider>,
+    );
+  },
+
+  getPublishConfiguration: async () => {
+    return {
+      status: "completed",
+      outputTypes: [
+        {
+          id: "post",
+          displayName: "Post",
+          mediaSlots: [
+            {
+              id: "media",
+              displayName: "Media",
+              fileCount: { exact: 1 },
+              accepts: {
+                image: {
+                  format: "png",
+                },
+              },
+            },
+          ],
+        },
+      ],
+    };
+  },
+
+  publishContent: async (request: PublishContentRequest) => {
+    // logic to upload media to your platform here
+    return {
+      status: "completed",
+      externalId: "1234567890",
+      externalUrl: "https://example.com/posts/1234567890",
+    };
+  },
+});
+```
+
 ## Related packages
 
 The Apps SDK is made up of the following packages:

package/content/index.d.ts

@@ -413,6 +413,13 @@ export declare interface DocumentRequirement extends BaseFileRequirement {
  */
 export declare type DocumentSize = 'a4' | 'a3' | 'letter' | 'legal';
 
+/**
+ * Email preview stub used before beta preview type is fully supported.
+ */
+declare interface EmailPreviewStub extends BasePreview {
+    kind: 'email';
+}
+
 /**
  * @public
  *
@@ -812,9 +819,7 @@ export declare const prepareContentPublisher: (implementation: ContentPublisherI
  *
  * Check the `kind` and `status` properties to determine the type and state.
  */
-export declare type Preview = ImagePreview | VideoPreview | DocumentPreview | {
-    kind: 'email';
-};
+export declare type Preview = ImagePreview | VideoPreview | DocumentPreview | EmailPreviewStub;
 
 /**
  * @public
@@ -1081,6 +1086,7 @@ export declare type RemoteRequestFailedError = {
  * Provides callbacks for managing preview media and responding to preview updates.
  */
 export declare type RenderPreviewUiRequest = {
+
     /**
      * Callback to upgrade video thumbnail previews to full video media.
      *
@@ -1150,6 +1156,7 @@ export declare type RenderPreviewUiRequest = {
  * a custom publish settings interface where users configure platform-specific options.
  */
 export declare type RenderSettingsUiRequest = {
+
     /**
      * Callback to save and validate the user's publish settings.
      *

package/index.d.ts

@@ -1053,6 +1053,13 @@ declare interface DocumentRequirement extends BaseFileRequirement {
  */
 declare type DocumentSize = 'a4' | 'a3' | 'letter' | 'legal';
 
+/**
+ * Email preview stub used before beta preview type is fully supported.
+ */
+declare interface EmailPreviewStub extends BasePreview {
+    kind: 'email';
+}
+
 /**
  * @public
  *
@@ -1938,9 +1945,7 @@ declare const prepareDesignEditor: (implementation: DesignEditorIntent) => void;
  *
  * Check the `kind` and `status` properties to determine the type and state.
  */
-declare type Preview = ImagePreview | VideoPreview | DocumentPreview | {
-    kind: 'email';
-};
+declare type Preview = ImagePreview | VideoPreview | DocumentPreview | EmailPreviewStub;
 
 /**
  * @public
@@ -2222,6 +2227,7 @@ declare type RemoteRequestFailedError_2 = {
  * Provides callbacks for managing preview media and responding to preview updates.
  */
 declare type RenderPreviewUiRequest = {
+
     /**
      * Callback to upgrade video thumbnail previews to full video media.
      *
@@ -2337,6 +2343,7 @@ declare type RenderSelectionUiRequest = {
  * a custom publish settings interface where users configure platform-specific options.
  */
 declare type RenderSettingsUiRequest = {
+
     /**
      * Callback to save and validate the user's publish settings.
      *

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

@@ -19,6 +19,6 @@ _export(exports, {
         return LATEST_VERSION_BETA;
     }
 });
-const LATEST_VERSION = '2.1.0';
+const LATEST_VERSION = '2.1.2';
 const LATEST_VERSION_BETA = '2.0.2-beta.3';
 const LATEST_VERSION_ALPHA = 'NONE';

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

@@ -1,3 +1,3 @@
-export const LATEST_VERSION = '2.1.0';
+export const LATEST_VERSION = '2.1.2';
 export const LATEST_VERSION_BETA = '2.0.2-beta.3';
 export const LATEST_VERSION_ALPHA = 'NONE';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canva/intents",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "The Canva Apps SDK Intents library",
   "author": "Canva Pty Ltd.",
   "license": "SEE LICENSE IN LICENSE.md FILE",