@automate.ax/integration-contracts 0.110.0 → 0.111.0

package/dist/resend/schemas.d.ts

@@ -1024,8 +1024,8 @@ export declare const RESEND_DOMAIN_CREATED_EVENT_SCHEMA: z.ZodObject<{
         status: z.ZodEnum<{
             failed: "failed";
             pending: "pending";
-            verified: "verified";
             not_started: "not_started";
+            verified: "verified";
             temporary_failure: "temporary_failure";
         }>;
         ttl: z.ZodString;
@@ -1046,10 +1046,10 @@ export declare const RESEND_DOMAIN_CREATED_EVENT_SCHEMA: z.ZodObject<{
     status: z.ZodEnum<{
         failed: "failed";
         pending: "pending";
+        not_started: "not_started";
         verified: "verified";
         partially_verified: "partially_verified";
         partially_failed: "partially_failed";
-        not_started: "not_started";
     }>;
     event: z.ZodObject<{
         created_at: z.ZodISODateTime;
@@ -1080,8 +1080,8 @@ export declare const RESEND_DOMAIN_CREATED_EVENT_SCHEMA: z.ZodObject<{
                 status: z.ZodEnum<{
                     failed: "failed";
                     pending: "pending";
-                    verified: "verified";
                     not_started: "not_started";
+                    verified: "verified";
                     temporary_failure: "temporary_failure";
                 }>;
                 ttl: z.ZodString;
@@ -1102,10 +1102,10 @@ export declare const RESEND_DOMAIN_CREATED_EVENT_SCHEMA: z.ZodObject<{
             status: z.ZodEnum<{
                 failed: "failed";
                 pending: "pending";
+                not_started: "not_started";
                 verified: "verified";
                 partially_verified: "partially_verified";
                 partially_failed: "partially_failed";
-                not_started: "not_started";
             }>;
         }, z.core.$catchall<z.ZodJSONSchema>>;
         type: z.ZodLiteral<"domain.created">;
@@ -1138,8 +1138,8 @@ export declare const RESEND_DOMAIN_UPDATED_EVENT_SCHEMA: z.ZodObject<{
         status: z.ZodEnum<{
             failed: "failed";
             pending: "pending";
-            verified: "verified";
             not_started: "not_started";
+            verified: "verified";
             temporary_failure: "temporary_failure";
         }>;
         ttl: z.ZodString;
@@ -1160,10 +1160,10 @@ export declare const RESEND_DOMAIN_UPDATED_EVENT_SCHEMA: z.ZodObject<{
     status: z.ZodEnum<{
         failed: "failed";
         pending: "pending";
+        not_started: "not_started";
         verified: "verified";
         partially_verified: "partially_verified";
         partially_failed: "partially_failed";
-        not_started: "not_started";
     }>;
     event: z.ZodObject<{
         created_at: z.ZodISODateTime;
@@ -1194,8 +1194,8 @@ export declare const RESEND_DOMAIN_UPDATED_EVENT_SCHEMA: z.ZodObject<{
                 status: z.ZodEnum<{
                     failed: "failed";
                     pending: "pending";
-                    verified: "verified";
                     not_started: "not_started";
+                    verified: "verified";
                     temporary_failure: "temporary_failure";
                 }>;
                 ttl: z.ZodString;
@@ -1216,10 +1216,10 @@ export declare const RESEND_DOMAIN_UPDATED_EVENT_SCHEMA: z.ZodObject<{
             status: z.ZodEnum<{
                 failed: "failed";
                 pending: "pending";
+                not_started: "not_started";
                 verified: "verified";
                 partially_verified: "partially_verified";
                 partially_failed: "partially_failed";
-                not_started: "not_started";
             }>;
         }, z.core.$catchall<z.ZodJSONSchema>>;
         type: z.ZodLiteral<"domain.updated">;
@@ -1252,8 +1252,8 @@ export declare const RESEND_DOMAIN_DELETED_EVENT_SCHEMA: z.ZodObject<{
         status: z.ZodEnum<{
             failed: "failed";
             pending: "pending";
-            verified: "verified";
             not_started: "not_started";
+            verified: "verified";
             temporary_failure: "temporary_failure";
         }>;
         ttl: z.ZodString;
@@ -1274,10 +1274,10 @@ export declare const RESEND_DOMAIN_DELETED_EVENT_SCHEMA: z.ZodObject<{
     status: z.ZodEnum<{
         failed: "failed";
         pending: "pending";
+        not_started: "not_started";
         verified: "verified";
         partially_verified: "partially_verified";
         partially_failed: "partially_failed";
-        not_started: "not_started";
     }>;
     event: z.ZodObject<{
         created_at: z.ZodISODateTime;
@@ -1308,8 +1308,8 @@ export declare const RESEND_DOMAIN_DELETED_EVENT_SCHEMA: z.ZodObject<{
                 status: z.ZodEnum<{
                     failed: "failed";
                     pending: "pending";
-                    verified: "verified";
                     not_started: "not_started";
+                    verified: "verified";
                     temporary_failure: "temporary_failure";
                 }>;
                 ttl: z.ZodString;
@@ -1330,10 +1330,10 @@ export declare const RESEND_DOMAIN_DELETED_EVENT_SCHEMA: z.ZodObject<{
             status: z.ZodEnum<{
                 failed: "failed";
                 pending: "pending";
+                not_started: "not_started";
                 verified: "verified";
                 partially_verified: "partially_verified";
                 partially_failed: "partially_failed";
-                not_started: "not_started";
             }>;
         }, z.core.$catchall<z.ZodJSONSchema>>;
         type: z.ZodLiteral<"domain.deleted">;
@@ -1366,8 +1366,8 @@ export declare const RESEND_DOMAIN_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodObjec
         status: z.ZodEnum<{
             failed: "failed";
             pending: "pending";
-            verified: "verified";
             not_started: "not_started";
+            verified: "verified";
             temporary_failure: "temporary_failure";
         }>;
         ttl: z.ZodString;
@@ -1388,10 +1388,10 @@ export declare const RESEND_DOMAIN_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodObjec
     status: z.ZodEnum<{
         failed: "failed";
         pending: "pending";
+        not_started: "not_started";
         verified: "verified";
         partially_verified: "partially_verified";
         partially_failed: "partially_failed";
-        not_started: "not_started";
     }>;
     event: z.ZodObject<{
         created_at: z.ZodISODateTime;
@@ -1422,8 +1422,8 @@ export declare const RESEND_DOMAIN_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodObjec
                 status: z.ZodEnum<{
                     failed: "failed";
                     pending: "pending";
-                    verified: "verified";
                     not_started: "not_started";
+                    verified: "verified";
                     temporary_failure: "temporary_failure";
                 }>;
                 ttl: z.ZodString;
@@ -1444,10 +1444,10 @@ export declare const RESEND_DOMAIN_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodObjec
             status: z.ZodEnum<{
                 failed: "failed";
                 pending: "pending";
+                not_started: "not_started";
                 verified: "verified";
                 partially_verified: "partially_verified";
                 partially_failed: "partially_failed";
-                not_started: "not_started";
             }>;
         }, z.core.$catchall<z.ZodJSONSchema>>;
         type: z.ZodLiteral<"domain.created">;
@@ -1479,8 +1479,8 @@ export declare const RESEND_DOMAIN_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodObjec
         status: z.ZodEnum<{
             failed: "failed";
             pending: "pending";
-            verified: "verified";
             not_started: "not_started";
+            verified: "verified";
             temporary_failure: "temporary_failure";
         }>;
         ttl: z.ZodString;
@@ -1501,10 +1501,10 @@ export declare const RESEND_DOMAIN_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodObjec
     status: z.ZodEnum<{
         failed: "failed";
         pending: "pending";
+        not_started: "not_started";
         verified: "verified";
         partially_verified: "partially_verified";
         partially_failed: "partially_failed";
-        not_started: "not_started";
     }>;
     event: z.ZodObject<{
         created_at: z.ZodISODateTime;
@@ -1535,8 +1535,8 @@ export declare const RESEND_DOMAIN_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodObjec
                 status: z.ZodEnum<{
                     failed: "failed";
                     pending: "pending";
-                    verified: "verified";
                     not_started: "not_started";
+                    verified: "verified";
                     temporary_failure: "temporary_failure";
                 }>;
                 ttl: z.ZodString;
@@ -1557,10 +1557,10 @@ export declare const RESEND_DOMAIN_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodObjec
             status: z.ZodEnum<{
                 failed: "failed";
                 pending: "pending";
+                not_started: "not_started";
                 verified: "verified";
                 partially_verified: "partially_verified";
                 partially_failed: "partially_failed";
-                not_started: "not_started";
             }>;
         }, z.core.$catchall<z.ZodJSONSchema>>;
         type: z.ZodLiteral<"domain.updated">;
@@ -1592,8 +1592,8 @@ export declare const RESEND_DOMAIN_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodObjec
         status: z.ZodEnum<{
             failed: "failed";
             pending: "pending";
-            verified: "verified";
             not_started: "not_started";
+            verified: "verified";
             temporary_failure: "temporary_failure";
         }>;
         ttl: z.ZodString;
@@ -1614,10 +1614,10 @@ export declare const RESEND_DOMAIN_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodObjec
     status: z.ZodEnum<{
         failed: "failed";
         pending: "pending";
+        not_started: "not_started";
         verified: "verified";
         partially_verified: "partially_verified";
         partially_failed: "partially_failed";
-        not_started: "not_started";
     }>;
     event: z.ZodObject<{
         created_at: z.ZodISODateTime;
@@ -1648,8 +1648,8 @@ export declare const RESEND_DOMAIN_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodObjec
                 status: z.ZodEnum<{
                     failed: "failed";
                     pending: "pending";
-                    verified: "verified";
                     not_started: "not_started";
+                    verified: "verified";
                     temporary_failure: "temporary_failure";
                 }>;
                 ttl: z.ZodString;
@@ -1670,10 +1670,10 @@ export declare const RESEND_DOMAIN_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodObjec
             status: z.ZodEnum<{
                 failed: "failed";
                 pending: "pending";
+                not_started: "not_started";
                 verified: "verified";
                 partially_verified: "partially_verified";
                 partially_failed: "partially_failed";
-                not_started: "not_started";
             }>;
         }, z.core.$catchall<z.ZodJSONSchema>>;
         type: z.ZodLiteral<"domain.deleted">;
@@ -2295,8 +2295,8 @@ export declare const RESEND_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodUnion<readon
         status: z.ZodEnum<{
             failed: "failed";
             pending: "pending";
-            verified: "verified";
             not_started: "not_started";
+            verified: "verified";
             temporary_failure: "temporary_failure";
         }>;
         ttl: z.ZodString;
@@ -2317,10 +2317,10 @@ export declare const RESEND_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodUnion<readon
     status: z.ZodEnum<{
         failed: "failed";
         pending: "pending";
+        not_started: "not_started";
         verified: "verified";
         partially_verified: "partially_verified";
         partially_failed: "partially_failed";
-        not_started: "not_started";
     }>;
     event: z.ZodObject<{
         created_at: z.ZodISODateTime;
@@ -2351,8 +2351,8 @@ export declare const RESEND_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodUnion<readon
                 status: z.ZodEnum<{
                     failed: "failed";
                     pending: "pending";
-                    verified: "verified";
                     not_started: "not_started";
+                    verified: "verified";
                     temporary_failure: "temporary_failure";
                 }>;
                 ttl: z.ZodString;
@@ -2373,10 +2373,10 @@ export declare const RESEND_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodUnion<readon
             status: z.ZodEnum<{
                 failed: "failed";
                 pending: "pending";
+                not_started: "not_started";
                 verified: "verified";
                 partially_verified: "partially_verified";
                 partially_failed: "partially_failed";
-                not_started: "not_started";
             }>;
         }, z.core.$catchall<z.ZodJSONSchema>>;
         type: z.ZodLiteral<"domain.created">;
@@ -2408,8 +2408,8 @@ export declare const RESEND_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodUnion<readon
         status: z.ZodEnum<{
             failed: "failed";
             pending: "pending";
-            verified: "verified";
             not_started: "not_started";
+            verified: "verified";
             temporary_failure: "temporary_failure";
         }>;
         ttl: z.ZodString;
@@ -2430,10 +2430,10 @@ export declare const RESEND_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodUnion<readon
     status: z.ZodEnum<{
         failed: "failed";
         pending: "pending";
+        not_started: "not_started";
         verified: "verified";
         partially_verified: "partially_verified";
         partially_failed: "partially_failed";
-        not_started: "not_started";
     }>;
     event: z.ZodObject<{
         created_at: z.ZodISODateTime;
@@ -2464,8 +2464,8 @@ export declare const RESEND_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodUnion<readon
                 status: z.ZodEnum<{
                     failed: "failed";
                     pending: "pending";
-                    verified: "verified";
                     not_started: "not_started";
+                    verified: "verified";
                     temporary_failure: "temporary_failure";
                 }>;
                 ttl: z.ZodString;
@@ -2486,10 +2486,10 @@ export declare const RESEND_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodUnion<readon
             status: z.ZodEnum<{
                 failed: "failed";
                 pending: "pending";
+                not_started: "not_started";
                 verified: "verified";
                 partially_verified: "partially_verified";
                 partially_failed: "partially_failed";
-                not_started: "not_started";
             }>;
         }, z.core.$catchall<z.ZodJSONSchema>>;
         type: z.ZodLiteral<"domain.updated">;
@@ -2521,8 +2521,8 @@ export declare const RESEND_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodUnion<readon
         status: z.ZodEnum<{
             failed: "failed";
             pending: "pending";
-            verified: "verified";
             not_started: "not_started";
+            verified: "verified";
             temporary_failure: "temporary_failure";
         }>;
         ttl: z.ZodString;
@@ -2543,10 +2543,10 @@ export declare const RESEND_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodUnion<readon
     status: z.ZodEnum<{
         failed: "failed";
         pending: "pending";
+        not_started: "not_started";
         verified: "verified";
         partially_verified: "partially_verified";
         partially_failed: "partially_failed";
-        not_started: "not_started";
     }>;
     event: z.ZodObject<{
         created_at: z.ZodISODateTime;
@@ -2577,8 +2577,8 @@ export declare const RESEND_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodUnion<readon
                 status: z.ZodEnum<{
                     failed: "failed";
                     pending: "pending";
-                    verified: "verified";
                     not_started: "not_started";
+                    verified: "verified";
                     temporary_failure: "temporary_failure";
                 }>;
                 ttl: z.ZodString;
@@ -2599,10 +2599,10 @@ export declare const RESEND_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodUnion<readon
             status: z.ZodEnum<{
                 failed: "failed";
                 pending: "pending";
+                not_started: "not_started";
                 verified: "verified";
                 partially_verified: "partially_verified";
                 partially_failed: "partially_failed";
-                not_started: "not_started";
             }>;
         }, z.core.$catchall<z.ZodJSONSchema>>;
         type: z.ZodLiteral<"domain.deleted">;
@@ -3102,14 +3102,14 @@ export declare function normalizeResendEvent(value: unknown): {
             records: {
                 name: string;
                 record: "SPF" | "DKIM" | "Receiving MX" | "Tracking" | "TrackingCAA";
-                status: "failed" | "pending" | "verified" | "not_started" | "temporary_failure";
+                status: "failed" | "pending" | "not_started" | "verified" | "temporary_failure";
                 ttl: string;
                 type: "CAA" | "CNAME" | "MX" | "TXT";
                 value: string;
                 priority?: number | undefined;
             }[];
             region: "us-east-1" | "eu-west-1" | "sa-east-1" | "ap-northeast-1";
-            status: "failed" | "pending" | "verified" | "partially_verified" | "partially_failed" | "not_started";
+            status: "failed" | "pending" | "not_started" | "verified" | "partially_verified" | "partially_failed";
             capabilities?: {
                 receiving?: "enabled" | "disabled" | undefined;
                 sending?: "enabled" | "disabled" | undefined;
@@ -3127,14 +3127,14 @@ export declare function normalizeResendEvent(value: unknown): {
             records: {
                 name: string;
                 record: "SPF" | "DKIM" | "Receiving MX" | "Tracking" | "TrackingCAA";
-                status: "failed" | "pending" | "verified" | "not_started" | "temporary_failure";
+                status: "failed" | "pending" | "not_started" | "verified" | "temporary_failure";
                 ttl: string;
                 type: "CAA" | "CNAME" | "MX" | "TXT";
                 value: string;
                 priority?: number | undefined;
             }[];
             region: "us-east-1" | "eu-west-1" | "sa-east-1" | "ap-northeast-1";
-            status: "failed" | "pending" | "verified" | "partially_verified" | "partially_failed" | "not_started";
+            status: "failed" | "pending" | "not_started" | "verified" | "partially_verified" | "partially_failed";
             capabilities?: {
                 receiving?: "enabled" | "disabled" | undefined;
                 sending?: "enabled" | "disabled" | undefined;
@@ -3152,14 +3152,14 @@ export declare function normalizeResendEvent(value: unknown): {
             records: {
                 name: string;
                 record: "SPF" | "DKIM" | "Receiving MX" | "Tracking" | "TrackingCAA";
-                status: "failed" | "pending" | "verified" | "not_started" | "temporary_failure";
+                status: "failed" | "pending" | "not_started" | "verified" | "temporary_failure";
                 ttl: string;
                 type: "CAA" | "CNAME" | "MX" | "TXT";
                 value: string;
                 priority?: number | undefined;
             }[];
             region: "us-east-1" | "eu-west-1" | "sa-east-1" | "ap-northeast-1";
-            status: "failed" | "pending" | "verified" | "partially_verified" | "partially_failed" | "not_started";
+            status: "failed" | "pending" | "not_started" | "verified" | "partially_verified" | "partially_failed";
             capabilities?: {
                 receiving?: "enabled" | "disabled" | undefined;
                 sending?: "enabled" | "disabled" | undefined;
@@ -3173,14 +3173,14 @@ export declare function normalizeResendEvent(value: unknown): {
     records: {
         name: string;
         record: "SPF" | "DKIM" | "Receiving MX" | "Tracking" | "TrackingCAA";
-        status: "failed" | "pending" | "verified" | "not_started" | "temporary_failure";
+        status: "failed" | "pending" | "not_started" | "verified" | "temporary_failure";
         ttl: string;
         type: "CAA" | "CNAME" | "MX" | "TXT";
         value: string;
         priority?: number | undefined;
     }[];
     region: "us-east-1" | "eu-west-1" | "sa-east-1" | "ap-northeast-1";
-    status: "failed" | "pending" | "verified" | "partially_verified" | "partially_failed" | "not_started";
+    status: "failed" | "pending" | "not_started" | "verified" | "partially_verified" | "partially_failed";
     capabilities?: {
         receiving?: "enabled" | "disabled" | undefined;
         sending?: "enabled" | "disabled" | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.110.0",
+  "version": "0.111.0",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -50,7 +50,7 @@
     }
   },
   "dependencies": {
-    "@automate.ax/codec": "0.110.0",
+    "@automate.ax/codec": "0.111.0",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^15.0.0",
     "@googleapis/forms": "^6.0.1",

package/src/asana/api.ts

@@ -27,6 +27,9 @@ export interface AsanaApiCallOptions<TSchema extends z.ZodType> {
    */
   body?: JsonObject
 
+  /** Provider-native multipart body for attachment uploads. */
+  formData?: FormData
+
   /** HTTP method. Defaults to `POST` with a body and `GET` otherwise. */
   httpMethod?: "DELETE" | "GET" | "POST" | "PUT"
 
@@ -110,30 +113,60 @@ export function getAsanaApi(secret: Record<string, unknown>): AsanaApi {
 
   return {
     call: async (path, options) => {
+      if (options.body && options.formData) {
+        throw new Error(
+          "Asana requests cannot include JSON and multipart bodies.",
+        )
+      }
       const normalizedPath = path.startsWith("/") ? path : `/${path}`
-      const url = new URL(`${ASANA_API_BASE_URL}${normalizedPath}`)
+      const url = new URL(path.replace(/^\/+/, ""), `${ASANA_API_BASE_URL}/`)
+      if (
+        url.origin !== new URL(ASANA_API_BASE_URL).origin ||
+        !url.pathname.startsWith("/api/1.0/")
+      ) {
+        throw new Error("Asana API paths must remain under /api/1.0.")
+      }
       for (const [name, value] of Object.entries(options.query ?? {})) {
         if (value !== undefined) url.searchParams.set(name, String(value))
       }
 
       const response = await fetch(url, {
-        body: options.body ? JSON.stringify({ data: options.body }) : undefined,
+        body: options.formData
+          ? options.formData
+          : options.body
+            ? JSON.stringify({ data: options.body })
+            : undefined,
         headers: {
           Accept: "application/json",
           Authorization: `Bearer ${accessToken}`,
           ...(options.body && { "Content-Type": "application/json" }),
         },
         method:
-          options.httpMethod ?? (options.body === undefined ? "GET" : "POST"),
+          options.httpMethod ??
+          (options.body === undefined && options.formData === undefined
+            ? "GET"
+            : "POST"),
       })
       const responseBody = await response.text()
       let payload: unknown
-      try {
-        payload = JSON.parse(responseBody)
-      } catch (cause) {
-        if (response.ok) throw cause
+      if (responseBody === "") {
+        payload = undefined
+      } else {
+        try {
+          payload = JSON.parse(responseBody)
+        } catch (cause) {
+          if (response.ok) throw cause
+          throw new AsanaApiError({
+            message: responseBody.trim() || `HTTP ${response.status}`,
+            path: normalizedPath,
+            retryAfter: parseRetryAfter(response.headers.get("Retry-After")),
+            status: response.status,
+          })
+        }
+      }
+      if (!response.ok && responseBody === "") {
         throw new AsanaApiError({
-          message: responseBody.trim() || `HTTP ${response.status}`,
+          message: `HTTP ${response.status}`,
           path: normalizedPath,
           retryAfter: parseRetryAfter(response.headers.get("Retry-After")),
           status: response.status,

package/src/asana/base.ts

@@ -0,0 +1,54 @@
+import * as z from "zod"
+
+export const ASANA_RESOURCE_SCHEMA = z.object({
+  /** Stable Asana globally unique identifier. */
+  id: z.string(),
+
+  /** Human-readable resource name, when available. */
+  name: z.string().optional(),
+
+  /** Provider resource type. */
+  type: z.string().optional(),
+})
+
+export const ASANA_PAGE_INFO_SCHEMA = z.object({
+  /** Opaque token for the next page, when more results are available. */
+  nextOffset: z.string().optional(),
+})
+
+export const ASANA_PROVIDER_RESOURCE_SCHEMA = z.looseObject({
+  gid: z.string(),
+  name: z.string().optional(),
+  resource_subtype: z.string().optional(),
+  resource_type: z.string().optional(),
+})
+
+export const ASANA_PROVIDER_PAGE_SCHEMA = z.looseObject({
+  next_page: z.looseObject({ offset: z.string() }).nullable().optional(),
+})
+
+/**
+ * Converts a provider resource identity to the public shape.
+ *
+ * @param value - Provider resource identity.
+ */
+export function toAsanaResource(
+  value: z.output<typeof ASANA_PROVIDER_RESOURCE_SCHEMA>,
+) {
+  return {
+    id: value.gid,
+    name: value.name,
+    type: value.resource_type,
+  }
+}
+
+/**
+ * Converts provider pagination metadata to the public shape.
+ *
+ * @param value - Provider page envelope.
+ */
+export function toAsanaPageInfo(
+  value: z.output<typeof ASANA_PROVIDER_PAGE_SCHEMA>,
+) {
+  return { nextOffset: value.next_page?.offset }
+}