@timesheet/plugin-asana 1.4.1

package/dist/lib/types.d.ts

@@ -0,0 +1,113 @@
+import { TaskDto, ToDoDto } from '@timesheet/integration-sdk';
+export interface AsanaConfig {
+    syncDirection?: 'bidirectional' | 'timesheet-to-asana' | 'asana-to-timesheet' | 'timesheet-to-external' | 'external-to-timesheet';
+    workspaceId?: string;
+    defaultAssignee?: string;
+    webhookSecret?: string;
+}
+export interface AsanaCompactRef {
+    gid: string;
+    name?: string;
+    resource_type?: string;
+}
+export interface AsanaWorkspace {
+    gid: string;
+    name?: string;
+    resource_type?: string;
+}
+export interface AsanaProject {
+    gid: string;
+    name?: string;
+    archived?: boolean;
+    workspace?: AsanaCompactRef;
+    team?: AsanaCompactRef;
+    resource_type?: string;
+}
+export interface AsanaTask {
+    gid: string;
+    name?: string;
+    notes?: string;
+    completed?: boolean;
+    completed_at?: string | null;
+    created_at?: string;
+    modified_at?: string;
+    due_at?: string | null;
+    due_on?: string | null;
+    start_at?: string | null;
+    start_on?: string | null;
+    assignee?: AsanaCompactRef | null;
+    projects?: AsanaCompactRef[];
+    workspace?: AsanaCompactRef;
+    resource_type?: string;
+}
+export interface AsanaTimeTrackingEntry {
+    gid: string;
+    duration_minutes?: number;
+    entered_on?: string;
+    created_at?: string;
+    created_by?: AsanaCompactRef | null;
+    task?: AsanaCompactRef;
+    resource_type?: string;
+}
+export interface AsanaPagedResponse<T> {
+    data: T[];
+    next_page?: {
+        offset?: string;
+        path?: string;
+        uri?: string;
+    } | null;
+}
+export interface AsanaSingleResponse<T> {
+    data: T;
+}
+export interface AsanaWebhookEvent {
+    resource?: {
+        gid?: string;
+        resource_type?: string;
+        resource_subtype?: string;
+    };
+    parent?: {
+        gid?: string;
+        resource_type?: string;
+    } | null;
+    action?: 'changed' | 'added' | 'removed' | 'deleted' | 'undeleted';
+    change?: {
+        field?: string;
+        action?: string;
+    };
+    created_at?: string;
+    user?: {
+        gid?: string;
+    } | null;
+}
+export interface AsanaWebhookPayload {
+    events?: AsanaWebhookEvent[];
+}
+/** Discriminated payload from sync batches / direct invocations. */
+export interface SyncInput {
+    event?: string;
+    triggerId?: string;
+    /** Local Timesheet entity id (task or todo). */
+    entityId?: string;
+    /** Convenience alias kept for backwards compatibility with task-only callers. */
+    taskId?: string;
+    /** Inline payload carried by sync changes — shape depends on entityType. */
+    item?: (Partial<TaskDto> & {
+        taskId?: string;
+        id?: string;
+        projectId?: string;
+        userId?: string;
+        todoId?: string;
+    }) | (Partial<ToDoDto> & {
+        todoId?: string;
+        id?: string;
+        projectId?: string;
+        userId?: string;
+    });
+    externalTaskId?: string;
+    method?: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+    body?: unknown;
+    rawBody?: string;
+}

package/dist/lib/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/manifest.json

@@ -0,0 +1,240 @@
+{
+  "id": "asana-sync",
+  "name": "Asana Sync",
+  "version": "1.4.1",
+  "description": "Synchronize Timesheet todos and time entries with Asana",
+  "longDescription": "Bidirectional synchronization between Timesheet and Asana. Timesheet todos are mirrored 1:1 with Asana tasks in the mapped project, and Timesheet time entries (tasks) attached to a todo are logged as Asana time-tracking entries on the corresponding Asana task. Changes made in Asana flow back through webhooks and scheduled syncs.",
+  "icon": "asana",
+  "category": "project-management",
+  "tags": [
+    "sync",
+    "timesheet",
+    "asana",
+    "project-management"
+  ],
+  "dataAccess": [
+    "projects",
+    "tasks",
+    "todos",
+    "colleagues",
+    "settings"
+  ],
+  "externalAuth": [
+    {
+      "id": "asana",
+      "type": "oauth2",
+      "oauth": {
+        "authorizeUrl": "https://app.asana.com/-/oauth_authorize",
+        "tokenUrl": "https://app.asana.com/-/oauth_token",
+        "scopes": [
+          "default"
+        ]
+      }
+    }
+  ],
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "syncDirection": {
+        "type": "string",
+        "title": "Sync Direction",
+        "enum": [
+          "bidirectional",
+          "timesheet-to-asana",
+          "asana-to-timesheet"
+        ],
+        "default": "bidirectional",
+        "x-ui-widget": "radio"
+      },
+      "workspaceId": {
+        "type": "string",
+        "title": "Asana Workspace",
+        "x-ui-help": "Optional. When set, project lookups are scoped to this Asana workspace gid."
+      }
+    },
+    "required": [
+      "syncDirection"
+    ]
+  },
+  "mappingSchema": {
+    "system": "asana",
+    "mappings": [
+      {
+        "id": "projects",
+        "title": "Project Mapping",
+        "description": "Map Timesheet projects to Asana projects",
+        "localEntity": {
+          "type": "project",
+          "label": "Timesheet Project",
+          "display": "{{title}}"
+        },
+        "externalEntity": {
+          "type": "project",
+          "label": "Asana Project",
+          "fetchAction": "list-external-projects"
+        },
+        "required": true,
+        "minMappings": 1
+      }
+    ]
+  },
+  "triggers": [
+    {
+      "id": "todo-changed",
+      "type": "event",
+      "mode": "sync",
+      "name": "Todo Changed",
+      "description": "Sync todo create/update/delete events to Asana tasks",
+      "events": [
+        "todo.create",
+        "todo.update",
+        "todo.delete"
+      ],
+      "configurable": true,
+      "actionId": "handle-sync-batch"
+    },
+    {
+      "id": "task-changed",
+      "type": "event",
+      "mode": "sync",
+      "name": "Time Entry Changed",
+      "description": "Log Timesheet time entries as Asana time-tracking entries",
+      "events": [
+        "task.create",
+        "task.update",
+        "task.delete"
+      ],
+      "configurable": true,
+      "actionId": "handle-sync-batch"
+    },
+    {
+      "id": "integration-webhook",
+      "type": "webhook",
+      "name": "Asana Webhook",
+      "description": "Receive inbound task changes from Asana",
+      "configurable": false,
+      "actionId": "handle-webhook",
+      "webhook": {
+        "signature": {
+          "header": "x-hook-signature",
+          "algorithm": "hmac-sha256",
+          "secretConfigKey": "webhookSecret"
+        }
+      }
+    },
+    {
+      "id": "full-sync",
+      "type": "schedule",
+      "mode": "sync",
+      "name": "Scheduled Full Sync",
+      "description": "Run a complete reconciliation sync",
+      "schedule": "0 2 * * *",
+      "timezone": "UTC",
+      "configurable": true,
+      "events": [
+        "todo.create",
+        "todo.update",
+        "todo.delete",
+        "task.create",
+        "task.update",
+        "task.delete"
+      ],
+      "actionId": "handle-sync-batch"
+    },
+    {
+      "id": "manual-sync",
+      "type": "user_action",
+      "name": "Manual Sync",
+      "description": "Run a full sync from settings",
+      "userAction": {
+        "label": "Sync Now",
+        "placement": "settings"
+      },
+      "actionId": "run-full-sync"
+    }
+  ],
+  "actions": [
+    {
+      "id": "sync-todo-to-external",
+      "name": "Sync todo to Asana task",
+      "handler": "syncTodoToExternal"
+    },
+    {
+      "id": "sync-todo-from-external",
+      "name": "Sync todo from Asana payload",
+      "handler": "syncTodoFromExternal",
+      "internal": true
+    },
+    {
+      "id": "sync-task-to-external",
+      "name": "Sync time entry to Asana",
+      "handler": "syncTaskToExternal"
+    },
+    {
+      "id": "handle-sync-batch",
+      "name": "Handle sync batch",
+      "handler": "handleSyncBatch"
+    },
+    {
+      "id": "sync-task-from-external",
+      "name": "Sync time entry from Asana",
+      "handler": "syncTaskFromExternal",
+      "internal": true
+    },
+    {
+      "id": "handle-webhook",
+      "handler": "handleWebhook",
+      "internal": true
+    },
+    {
+      "id": "run-full-sync",
+      "name": "Run full sync",
+      "handler": "runFullSync"
+    },
+    {
+      "id": "test-connection",
+      "name": "Test connection",
+      "handler": "testConnection"
+    },
+    {
+      "id": "list-external-projects",
+      "handler": "listExternalProjects",
+      "internal": true
+    }
+  ],
+  "pages": [
+    {
+      "id": "dashboard",
+      "title": "Sync Dashboard",
+      "icon": "chart-bar",
+      "layout": "dashboard",
+      "widgets": [
+        {
+          "id": "last-sync",
+          "type": "metric",
+          "title": "Last Sync"
+        },
+        {
+          "id": "sync-stats",
+          "type": "metric",
+          "title": "Sync Statistics"
+        },
+        {
+          "id": "connection-health",
+          "type": "metric",
+          "title": "Connection Health"
+        },
+        {
+          "id": "manual-sync-btn",
+          "type": "action_button",
+          "title": "Manual Sync",
+          "config": {
+            "actionId": "run-full-sync",
+            "label": "Run Full Sync",
+            "variant": "primary"
+          }
+        }
+      ]
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@timesheet/plugin-asana",
+  "version": "1.4.1",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "manifest.json"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@timesheet/integration-sdk": "^0.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "typescript": "^5.9.3"
+  }
+}