@automate.ax/integration-contracts 0.110.0 → 0.111.0

package/src/asana/index.ts

@@ -1,4 +1,5 @@
 import * as z from "zod"
+import * as semantic from "./semantic-events"
 import {
   ASANA_COMMENT_ADDED_EVENT_SCHEMA,
   ASANA_EVENT_SCHEMA,
@@ -10,11 +11,14 @@ import {
 } from "./schemas"
 
 export * from "./api"
+export * from "./base"
+export * from "./resources"
+export * from "./semantic-events"
 export * from "./schemas"
 
 /** Asana resource selected for one webhook subscription. */
 export const ASANA_TRIGGER_CONFIG_SCHEMA = z.object({
-  resourceId: z.string(),
+  resourceId: z.string().min(1),
 })
 
 export const asanaTriggerContracts = {
@@ -22,7 +26,7 @@ export const asanaTriggerContracts = {
     configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
     eventSchema: ASANA_COMMENT_ADDED_EVENT_SCHEMA,
   },
-  "asana.event": {
+  "asana.resource.event": {
     configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
     eventSchema: ASANA_EVENT_SCHEMA,
   },
@@ -46,4 +50,120 @@ export const asanaTriggerContracts = {
     configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
     eventSchema: ASANA_TASK_REMOVED_EVENT_SCHEMA,
   },
+  "asana.attachment.deleted": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_ATTACHMENT_DELETED_EVENT_SCHEMA,
+  },
+  "asana.attachment.restored": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_ATTACHMENT_RESTORED_EVENT_SCHEMA,
+  },
+  "asana.comment.deleted": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_COMMENT_DELETED_EVENT_SCHEMA,
+  },
+  "asana.comment.restored": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_COMMENT_RESTORED_EVENT_SCHEMA,
+  },
+  "asana.comment.updated": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_COMMENT_UPDATED_EVENT_SCHEMA,
+  },
+  "asana.project.added": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_PROJECT_ADDED_EVENT_SCHEMA,
+  },
+  "asana.project.changed": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_PROJECT_CHANGED_EVENT_SCHEMA,
+  },
+  "asana.project.deleted": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_PROJECT_DELETED_EVENT_SCHEMA,
+  },
+  "asana.project.removed": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_PROJECT_REMOVED_EVENT_SCHEMA,
+  },
+  "asana.project.restored": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_PROJECT_RESTORED_EVENT_SCHEMA,
+  },
+  "asana.section.added": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_SECTION_ADDED_EVENT_SCHEMA,
+  },
+  "asana.section.changed": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_SECTION_CHANGED_EVENT_SCHEMA,
+  },
+  "asana.section.deleted": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_SECTION_DELETED_EVENT_SCHEMA,
+  },
+  "asana.section.restored": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_SECTION_RESTORED_EVENT_SCHEMA,
+  },
+  "asana.tag.added": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TAG_ADDED_EVENT_SCHEMA,
+  },
+  "asana.tag.changed": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TAG_CHANGED_EVENT_SCHEMA,
+  },
+  "asana.tag.deleted": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TAG_DELETED_EVENT_SCHEMA,
+  },
+  "asana.tag.restored": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TAG_RESTORED_EVENT_SCHEMA,
+  },
+  "asana.task.assigned": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TASK_ASSIGNED_EVENT_SCHEMA,
+  },
+  "asana.task.due-date.changed": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TASK_DUE_DATE_CHANGED_EVENT_SCHEMA,
+  },
+  "asana.task.follower.added": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TASK_FOLLOWER_ADDED_EVENT_SCHEMA,
+  },
+  "asana.task.follower.removed": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TASK_FOLLOWER_REMOVED_EVENT_SCHEMA,
+  },
+  "asana.task.incomplete": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TASK_INCOMPLETE_EVENT_SCHEMA,
+  },
+  "asana.task.project.added": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TASK_PROJECT_ADDED_EVENT_SCHEMA,
+  },
+  "asana.task.project.removed": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TASK_PROJECT_REMOVED_EVENT_SCHEMA,
+  },
+  "asana.task.restored": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TASK_RESTORED_EVENT_SCHEMA,
+  },
+  "asana.task.tag.added": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TASK_TAG_ADDED_EVENT_SCHEMA,
+  },
+  "asana.task.tag.removed": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TASK_TAG_REMOVED_EVENT_SCHEMA,
+  },
+  "asana.task.unassigned": {
+    configSchema: ASANA_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semantic.ASANA_TASK_UNASSIGNED_EVENT_SCHEMA,
+  },
 } as const

package/src/asana/resources.ts

@@ -0,0 +1,401 @@
+import * as z from "zod"
+import {
+  ASANA_PROVIDER_RESOURCE_SCHEMA,
+  ASANA_RESOURCE_SCHEMA,
+  toAsanaResource,
+} from "./base"
+
+export const ASANA_ATTACHMENT_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+  /** RFC 3339 creation timestamp. */
+  createdAt: z.string().optional(),
+
+  /** Temporary authenticated download URL. */
+  downloadUrl: z.string().optional(),
+
+  /** Attachment host, such as `asana`, `dropbox`, or `gdrive`. */
+  host: z.string().optional(),
+
+  /** Resource containing the attachment. */
+  parent: ASANA_RESOURCE_SCHEMA.optional(),
+
+  /** Stable provider URL for the attachment. */
+  permanentUrl: z.string().optional(),
+
+  /** File size in bytes. */
+  size: z.number().int().nonnegative().optional(),
+
+  /** Browser URL for viewing the attachment. */
+  viewUrl: z.string().optional(),
+})
+
+export const ASANA_TAG_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+  /** Provider color token. */
+  color: z.string().optional(),
+
+  /** RFC 3339 creation timestamp. */
+  createdAt: z.string().optional(),
+
+  /** Users following this tag. */
+  followers: ASANA_RESOURCE_SCHEMA.array(),
+
+  /** Tag description. */
+  notes: z.string().optional(),
+
+  /** Workspace containing the tag. */
+  workspace: ASANA_RESOURCE_SCHEMA.optional(),
+})
+
+export const ASANA_TEAM_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+  /** Plain-text team description. */
+  description: z.string().optional(),
+
+  /** Rich-text team description. */
+  htmlDescription: z.string().optional(),
+
+  /** Organization containing the team. */
+  organization: ASANA_RESOURCE_SCHEMA.optional(),
+
+  /** Browser URL for the team. */
+  permalinkUrl: z.string().optional(),
+})
+
+export const ASANA_ENUM_OPTION_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+  /** Provider color token. */
+  color: z.string().optional(),
+
+  /** Whether users may select this option. */
+  enabled: z.boolean(),
+})
+
+export const ASANA_CUSTOM_FIELD_DATE_VALUE_SCHEMA = z.object({
+  /** Calendar date in YYYY-MM-DD format. */
+  date: z.string(),
+
+  /** RFC 3339 timestamp when the field includes a time. */
+  dateTime: z.string().optional(),
+})
+
+const ASANA_CUSTOM_FIELD_DATE_INPUT_VALUE_SCHEMA = z
+  .object({
+    /** Calendar date in YYYY-MM-DD format. */
+    date: z.string().optional(),
+
+    /** RFC 3339 timestamp when the field includes a time. */
+    dateTime: z.string().optional(),
+  })
+  .refine(({ date, dateTime }) => Boolean(date) !== Boolean(dateTime), {
+    message: "Provide exactly one custom-field date value.",
+  })
+
+export const ASANA_CUSTOM_FIELD_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+  /** Custom currency label. */
+  customLabel: z.string().optional(),
+
+  /** ISO currency code. */
+  currencyCode: z.string().optional(),
+
+  /** Field description. */
+  description: z.string().optional(),
+
+  /** Selectable enum options. */
+  enumOptions: ASANA_ENUM_OPTION_SCHEMA.array(),
+
+  /** Numeric display format. */
+  format: z.string().optional(),
+
+  /** Decimal precision for number fields. */
+  precision: z.number().int().nonnegative().optional(),
+
+  /** Custom field subtype. */
+  subtype: z.string(),
+})
+
+export const ASANA_CUSTOM_FIELD_VALUE_SCHEMA = ASANA_CUSTOM_FIELD_SCHEMA.extend(
+  {
+    /** Structured date value. */
+    dateValue: ASANA_CUSTOM_FIELD_DATE_VALUE_SCHEMA.optional(),
+
+    /** Human-readable value rendered by Asana. */
+    displayValue: z.string().optional(),
+
+    /** Selected single-enum option. */
+    enumValue: ASANA_ENUM_OPTION_SCHEMA.optional(),
+
+    /** Selected multi-enum options. */
+    multiEnumValues: ASANA_ENUM_OPTION_SCHEMA.array(),
+
+    /** Numeric value. */
+    numberValue: z.number().optional(),
+
+    /** Selected people. */
+    peopleValue: ASANA_RESOURCE_SCHEMA.array(),
+
+    /** Selected referenced resources. */
+    referenceValue: ASANA_RESOURCE_SCHEMA.array(),
+
+    /** Text value. */
+    textValue: z.string().optional(),
+  },
+)
+
+export const ASANA_CUSTOM_FIELD_INPUT_VALUE_SCHEMA = z.union([
+  z.string(),
+  z.number(),
+  z.string().array(),
+  ASANA_CUSTOM_FIELD_DATE_INPUT_VALUE_SCHEMA,
+  z.null(),
+])
+
+export const ASANA_PROJECT_TASK_COUNTS_SCHEMA = z.object({
+  numCompletedMilestones: z.number().int().nonnegative(),
+  numCompletedTasks: z.number().int().nonnegative(),
+  numIncompleteMilestones: z.number().int().nonnegative(),
+  numIncompleteTasks: z.number().int().nonnegative(),
+  numMilestones: z.number().int().nonnegative(),
+  numTasks: z.number().int().nonnegative(),
+})
+
+export const ASANA_JOB_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+  /** Newly created project, when the job duplicates a project. */
+  newProject: ASANA_RESOURCE_SCHEMA.optional(),
+
+  /** Newly created task, when the job duplicates a task. */
+  newTask: ASANA_RESOURCE_SCHEMA.optional(),
+
+  /** Current asynchronous job state. */
+  status: z.enum(["failed", "in_progress", "not_started", "succeeded"]),
+
+  /** Provider job subtype. */
+  subtype: z.string().optional(),
+})
+
+export const ASANA_PROVIDER_ATTACHMENT_SCHEMA =
+  ASANA_PROVIDER_RESOURCE_SCHEMA.extend({
+    created_at: z.string().optional(),
+    download_url: z.string().nullish(),
+    host: z.string().optional(),
+    parent: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+    permanent_url: z.string().nullish(),
+    size: z.number().int().nonnegative().nullish(),
+    view_url: z.string().nullish(),
+  })
+
+export const ASANA_PROVIDER_TAG_SCHEMA = ASANA_PROVIDER_RESOURCE_SCHEMA.extend({
+  color: z.string().nullish(),
+  created_at: z.string().optional(),
+  followers: ASANA_PROVIDER_RESOURCE_SCHEMA.array().optional(),
+  notes: z.string().optional(),
+  workspace: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+})
+
+export const ASANA_PROVIDER_TEAM_SCHEMA = ASANA_PROVIDER_RESOURCE_SCHEMA.extend(
+  {
+    description: z.string().optional(),
+    html_description: z.string().optional(),
+    organization: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+    permalink_url: z.string().optional(),
+  },
+)
+
+export const ASANA_PROVIDER_ENUM_OPTION_SCHEMA =
+  ASANA_PROVIDER_RESOURCE_SCHEMA.extend({
+    color: z.string().nullish(),
+    enabled: z.boolean(),
+  })
+
+export const ASANA_PROVIDER_CUSTOM_FIELD_SCHEMA =
+  ASANA_PROVIDER_RESOURCE_SCHEMA.extend({
+    custom_label: z.string().nullish(),
+    currency_code: z.string().nullish(),
+    description: z.string().optional(),
+    enum_options: ASANA_PROVIDER_ENUM_OPTION_SCHEMA.array().optional(),
+    format: z.string().nullish(),
+    precision: z.number().int().nonnegative().nullish(),
+    resource_subtype: z.string(),
+  })
+
+export const ASANA_PROVIDER_CUSTOM_FIELD_VALUE_SCHEMA =
+  ASANA_PROVIDER_CUSTOM_FIELD_SCHEMA.extend({
+    date_value: z
+      .looseObject({
+        date: z.string(),
+        date_time: z.string().nullish(),
+      })
+      .nullish(),
+    display_value: z.string().nullish(),
+    enum_value: ASANA_PROVIDER_ENUM_OPTION_SCHEMA.nullish(),
+    multi_enum_values: ASANA_PROVIDER_ENUM_OPTION_SCHEMA.array().optional(),
+    number_value: z.number().nullish(),
+    people_value: ASANA_PROVIDER_RESOURCE_SCHEMA.array().optional(),
+    reference_value: ASANA_PROVIDER_RESOURCE_SCHEMA.array().optional(),
+    text_value: z.string().nullish(),
+  })
+
+export const ASANA_PROVIDER_PROJECT_TASK_COUNTS_SCHEMA = z.looseObject({
+  num_completed_milestones: z.number().int().nonnegative(),
+  num_completed_tasks: z.number().int().nonnegative(),
+  num_incomplete_milestones: z.number().int().nonnegative(),
+  num_incomplete_tasks: z.number().int().nonnegative(),
+  num_milestones: z.number().int().nonnegative(),
+  num_tasks: z.number().int().nonnegative(),
+})
+
+export const ASANA_PROVIDER_JOB_SCHEMA = ASANA_PROVIDER_RESOURCE_SCHEMA.extend({
+  new_project: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+  new_task: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+  resource_subtype: z.string().optional(),
+  status: z.enum(["failed", "in_progress", "not_started", "succeeded"]),
+})
+
+/**
+ * Converts a provider attachment to the public shape.
+ *
+ * @param value - Provider attachment.
+ */
+export function toAsanaAttachment(
+  value: z.output<typeof ASANA_PROVIDER_ATTACHMENT_SCHEMA>,
+) {
+  return {
+    ...toAsanaResource(value),
+    createdAt: value.created_at,
+    downloadUrl: value.download_url ?? undefined,
+    host: value.host,
+    parent: value.parent ? toAsanaResource(value.parent) : undefined,
+    permanentUrl: value.permanent_url ?? undefined,
+    size: value.size ?? undefined,
+    viewUrl: value.view_url ?? undefined,
+  }
+}
+
+/**
+ * Converts a provider tag to the public shape.
+ *
+ * @param value - Provider tag.
+ */
+export function toAsanaTag(value: z.output<typeof ASANA_PROVIDER_TAG_SCHEMA>) {
+  return {
+    ...toAsanaResource(value),
+    color: value.color ?? undefined,
+    createdAt: value.created_at,
+    followers: (value.followers ?? []).map(toAsanaResource),
+    notes: value.notes,
+    workspace: value.workspace ? toAsanaResource(value.workspace) : undefined,
+  }
+}
+
+/**
+ * Converts a provider team to the public shape.
+ *
+ * @param value - Provider team.
+ */
+export function toAsanaTeam(
+  value: z.output<typeof ASANA_PROVIDER_TEAM_SCHEMA>,
+) {
+  return {
+    ...toAsanaResource(value),
+    description: value.description,
+    htmlDescription: value.html_description,
+    organization: value.organization
+      ? toAsanaResource(value.organization)
+      : undefined,
+    permalinkUrl: value.permalink_url,
+  }
+}
+
+/**
+ * Converts a provider enum option to the public shape.
+ *
+ * @param value - Provider enum option.
+ */
+export function toAsanaEnumOption(
+  value: z.output<typeof ASANA_PROVIDER_ENUM_OPTION_SCHEMA>,
+) {
+  return {
+    ...toAsanaResource(value),
+    color: value.color ?? undefined,
+    enabled: value.enabled,
+  }
+}
+
+/**
+ * Converts a provider custom field to the public shape.
+ *
+ * @param value - Provider custom field.
+ */
+export function toAsanaCustomField(
+  value: z.output<typeof ASANA_PROVIDER_CUSTOM_FIELD_SCHEMA>,
+) {
+  return {
+    ...toAsanaResource(value),
+    customLabel: value.custom_label ?? undefined,
+    currencyCode: value.currency_code ?? undefined,
+    description: value.description,
+    enumOptions: (value.enum_options ?? []).map(toAsanaEnumOption),
+    format: value.format ?? undefined,
+    precision: value.precision ?? undefined,
+    subtype: value.resource_subtype,
+  }
+}
+
+/**
+ * Converts a provider custom-field value to the public shape.
+ *
+ * @param value - Provider field value.
+ */
+export function toAsanaCustomFieldValue(
+  value: z.output<typeof ASANA_PROVIDER_CUSTOM_FIELD_VALUE_SCHEMA>,
+) {
+  return {
+    ...toAsanaCustomField(value),
+    dateValue: value.date_value
+      ? {
+          date: value.date_value.date,
+          dateTime: value.date_value.date_time ?? undefined,
+        }
+      : undefined,
+    displayValue: value.display_value ?? undefined,
+    enumValue: value.enum_value
+      ? toAsanaEnumOption(value.enum_value)
+      : undefined,
+    multiEnumValues: (value.multi_enum_values ?? []).map(toAsanaEnumOption),
+    numberValue: value.number_value ?? undefined,
+    peopleValue: (value.people_value ?? []).map(toAsanaResource),
+    referenceValue: (value.reference_value ?? []).map(toAsanaResource),
+    textValue: value.text_value ?? undefined,
+  }
+}
+
+/**
+ * Converts provider project task counts to the public shape.
+ *
+ * @param value - Provider counts.
+ */
+export function toAsanaProjectTaskCounts(
+  value: z.output<typeof ASANA_PROVIDER_PROJECT_TASK_COUNTS_SCHEMA>,
+) {
+  return {
+    numCompletedMilestones: value.num_completed_milestones,
+    numCompletedTasks: value.num_completed_tasks,
+    numIncompleteMilestones: value.num_incomplete_milestones,
+    numIncompleteTasks: value.num_incomplete_tasks,
+    numMilestones: value.num_milestones,
+    numTasks: value.num_tasks,
+  }
+}
+
+/**
+ * Converts a provider asynchronous job to the public shape.
+ *
+ * @param value - Provider job.
+ */
+export function toAsanaJob(value: z.output<typeof ASANA_PROVIDER_JOB_SCHEMA>) {
+  return {
+    ...toAsanaResource(value),
+    newProject: value.new_project
+      ? toAsanaResource(value.new_project)
+      : undefined,
+    newTask: value.new_task ? toAsanaResource(value.new_task) : undefined,
+    status: value.status,
+    subtype: value.resource_subtype,
+  }
+}