@automate.ax/integration-contracts 0.109.1 → 0.111.0

package/dist/asana/api.d.ts

@@ -9,6 +9,8 @@ export interface AsanaApiCallOptions<TSchema extends z.ZodType> {
      * envelope.
      */
     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";
     /** Provider-native URL query parameters. */

package/dist/asana/api.js

@@ -58,31 +58,58 @@ export function getAsanaApi(secret) {
     const { accessToken } = ASANA_SECRET_SCHEMA.parse(secret);
     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"),
+                method: options.httpMethod ??
+                    (options.body === undefined && options.formData === undefined
+                        ? "GET"
+                        : "POST"),
             });
             const responseBody = await response.text();
             let payload;
-            try {
-                payload = JSON.parse(responseBody);
+            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,
+                    });
+                }
             }
-            catch (cause) {
-                if (response.ok)
-                    throw cause;
+            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/dist/asana/base.d.ts

@@ -0,0 +1,38 @@
+import * as z from "zod";
+export declare const ASANA_RESOURCE_SCHEMA: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ASANA_PAGE_INFO_SCHEMA: z.ZodObject<{
+    nextOffset: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ASANA_PROVIDER_RESOURCE_SCHEMA: z.ZodObject<{
+    gid: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    resource_subtype: z.ZodOptional<z.ZodString>;
+    resource_type: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export declare const ASANA_PROVIDER_PAGE_SCHEMA: z.ZodObject<{
+    next_page: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        offset: z.ZodString;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+/**
+ * Converts a provider resource identity to the public shape.
+ *
+ * @param value - Provider resource identity.
+ */
+export declare function toAsanaResource(value: z.output<typeof ASANA_PROVIDER_RESOURCE_SCHEMA>): {
+    id: string;
+    name: string | undefined;
+    type: string | undefined;
+};
+/**
+ * Converts provider pagination metadata to the public shape.
+ *
+ * @param value - Provider page envelope.
+ */
+export declare function toAsanaPageInfo(value: z.output<typeof ASANA_PROVIDER_PAGE_SCHEMA>): {
+    nextOffset: string | undefined;
+};

package/dist/asana/base.js

@@ -0,0 +1,42 @@
+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) {
+    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) {
+    return { nextOffset: value.next_page?.offset };
+}