Attachment upload support (#34)

* improve example

* Add support for creating attachment upload urls via the SDK

* Add changeset

Author: mattvagni

.changeset/smooth-peaches-tan.md

@@ -0,0 +1,5 @@
+---
+'@team-plain/typescript-sdk': minor
+---
+
+Add support for creating attachment upload urls via the SDK

src/client.ts

@@ -4,6 +4,8 @@ import type { Context } from './context';
 import type { PlainSDKError } from './error';
 import {
   AddCustomerToCustomerGroupsDocument,
+  type AttachmentUploadUrlPartsFragment,
+  CreateAttachmentUploadUrlDocument,
   CreateIssueDocument,
   CustomerByEmailDocument,
   CustomerByIdDocument,
@@ -223,4 +225,19 @@ export class PlainClient {
       return nonNullable(q.replyToEmail.email);
     });
   }
+
+  async createAttachmentUploadUrl(
+    input: VariablesOf<typeof CreateAttachmentUploadUrlDocument>['input']
+  ): SDKResult<AttachmentUploadUrlPartsFragment> {
+    const res = await request(this.#ctx, {
+      query: CreateAttachmentUploadUrlDocument,
+      variables: {
+        input,
+      },
+    });
+
+    return unwrapData(res, (q) => {
+      return nonNullable(q.createAttachmentUploadUrl.attachmentUploadUrl);
+    });
+  }
 }

src/examples/upsertCustomer.ts

@@ -5,27 +5,26 @@
 
 import { PlainClient } from '../client';
 
-export async function upsertCustomerExample() {
-  const client = new PlainClient({ apiKey: '' });
+export async function createCustomer() {
+  const client = new PlainClient({ apiKey: 'XXX' });
 
   const res = await client.upsertCustomer({
     identifier: {
-      customerId: '',
+      emailAddress: 'jane@gmail.com',
     },
     onCreate: {
-      fullName: '',
+      fullName: 'Jane Fargate',
       email: {
-        email: '',
-        isVerified: false,
+        email: 'jane@gmail.com',
+        isVerified: true,
       },
     },
     onUpdate: {},
   });
 
   if (res.error) {
     console.error(res.error);
-    throw new Error(res.error.message);
+  } else {
+    console.log(`Created customer with id=${res.data.customer.id}`);
   }
-
-  console.log(`Created customer with id=${res.data.customer.id}`);
 }

src/graphql/fragments/attachmentUploadUrlParts.gql

@@ -0,0 +1,14 @@
+fragment AttachmentUploadUrlParts on AttachmentUploadUrl {
+  __typename
+  attachment {
+    ...AttachmentParts
+  }
+  uploadFormUrl
+  uploadFormData {
+    key
+    value
+  }
+  expiresAt {
+    ...DateTimeParts
+  }
+}

src/graphql/mutations/createAttachmentUploadUrl.gql

@@ -0,0 +1,10 @@
+mutation createAttachmentUploadUrl($input: CreateAttachmentUploadUrlInput!) {
+  createAttachmentUploadUrl(input: $input) {
+    attachmentUploadUrl {
+      ...AttachmentUploadUrlParts
+    }
+    error {
+      ...MutationErrorParts
+    }
+  }
+}