From 4b96a9faeb4d6f511f551cb9d55a637e514449ff Mon Sep 17 00:00:00 2001
From: Charles Driesler <chuck@speckle.systems>
Date: Mon, 4 Aug 2025 23:05:39 +0100
Subject: [PATCH] fix(acc): getter gql and more

---
 .../components/project/page/acc/FileItem.vue  |   2 +-
 .../components/project/page/acc/Files.vue     |   2 +-
 .../components/project/page/acc/Hubs.vue      |   2 +-
 .../components/project/page/acc/Projects.vue  |   2 +-
 .../project/page/acc/SyncStatus.vue           |  10 +-
 .../components/project/page/acc/Syncs.vue     |  10 +-
 .../components/project/page/acc/Tab.vue       |   2 +-
 packages/frontend-2/lib/acc/types.ts          |  52 ++------
 .../lib/common/generated/gql/graphql.ts       |  10 +-
 .../assets/acc/typedefs/accSyncItems.graphql  |  10 +-
 .../server/modules/acc/clients/autodesk.ts    | 111 ++++++++++++++++++
 .../server/modules/acc/domain/constants.ts    |  10 +-
 .../server/modules/acc/domain/operations.ts   |   7 +-
 packages/server/modules/acc/errors/acc.ts     |   8 ++
 .../acc/graph/resolvers/accSyncItems.ts       |  57 +++++++--
 .../server/modules/acc/helpers/oidcHelper.ts  |  88 --------------
 .../{domain/logic.ts => helpers/svfUtils.ts}  |   0
 packages/server/modules/acc/helpers/types.ts  |   2 +-
 packages/server/modules/acc/index.ts          |  19 ++-
 .../modules/acc/repositories/accSyncItems.ts  |  11 +-
 packages/server/modules/acc/rest/oidc.ts      |  29 +----
 packages/server/modules/acc/rest/webhooks.ts  |   2 +-
 packages/server/modules/acc/services/cron.ts  |   2 +-
 .../server/modules/acc/services/management.ts |  30 ++---
 .../modules/core/graph/dataloaders/index.ts   |  12 ++
 .../modules/core/graph/generated/graphql.ts   |  10 +-
 packages/shared/package.json                  |  11 ++
 packages/shared/src/acc/helpers/types.ts      |  41 +++++++
 packages/shared/src/acc/index.ts              |   1 +
 29 files changed, 318 insertions(+), 235 deletions(-)
 delete mode 100644 packages/server/modules/acc/helpers/oidcHelper.ts
 rename packages/server/modules/acc/{domain/logic.ts => helpers/svfUtils.ts} (100%)
 create mode 100644 packages/shared/src/acc/helpers/types.ts
 create mode 100644 packages/shared/src/acc/index.ts

diff --git a/packages/frontend-2/components/project/page/acc/FileItem.vue b/packages/frontend-2/components/project/page/acc/FileItem.vue
index 6510938b0..b97717d3c 100644
--- a/packages/frontend-2/components/project/page/acc/FileItem.vue
+++ b/packages/frontend-2/components/project/page/acc/FileItem.vue
@@ -44,7 +44,7 @@
 
 <script setup lang="ts">
 import { ChevronDownIcon, ChevronUpIcon } from '@heroicons/vue/20/solid'
-import type { AccItem } from '~/lib/acc/types'
+import type { AccItem } from '@speckle/shared/acc'
 
 defineProps<{
   folderContent: AccItem
diff --git a/packages/frontend-2/components/project/page/acc/Files.vue b/packages/frontend-2/components/project/page/acc/Files.vue
index 9530fc0c6..58158a660 100644
--- a/packages/frontend-2/components/project/page/acc/Files.vue
+++ b/packages/frontend-2/components/project/page/acc/Files.vue
@@ -17,7 +17,7 @@
 </template>
 
 <script setup lang="ts">
-import type { AccItem } from '~/lib/acc/types'
+import type { AccItem } from '@speckle/shared/acc'
 import type { ProjectAccSyncItemFragment } from '~/lib/common/generated/gql/graphql'
 
 const props = defineProps<{
diff --git a/packages/frontend-2/components/project/page/acc/Hubs.vue b/packages/frontend-2/components/project/page/acc/Hubs.vue
index bc6f6df69..ea07893e5 100644
--- a/packages/frontend-2/components/project/page/acc/Hubs.vue
+++ b/packages/frontend-2/components/project/page/acc/Hubs.vue
@@ -25,7 +25,7 @@
 
 <script setup lang="ts">
 import { isArray } from 'lodash-es'
-import type { AccHub } from '~/lib/acc/types'
+import type { AccHub } from '@speckle/shared/acc'
 
 const props = defineProps<{
   hubs: AccHub[]
diff --git a/packages/frontend-2/components/project/page/acc/Projects.vue b/packages/frontend-2/components/project/page/acc/Projects.vue
index df1b7cd18..cfd70ce53 100644
--- a/packages/frontend-2/components/project/page/acc/Projects.vue
+++ b/packages/frontend-2/components/project/page/acc/Projects.vue
@@ -27,7 +27,7 @@
 
 <script setup lang="ts">
 import { isArray } from 'lodash-es'
-import type { AccProject } from '~/lib/acc/types'
+import type { AccProject } from '@speckle/shared/acc'
 
 const props = defineProps<{
   hubId: string
diff --git a/packages/frontend-2/components/project/page/acc/SyncStatus.vue b/packages/frontend-2/components/project/page/acc/SyncStatus.vue
index 4d5dc3634..6df02b915 100644
--- a/packages/frontend-2/components/project/page/acc/SyncStatus.vue
+++ b/packages/frontend-2/components/project/page/acc/SyncStatus.vue
@@ -19,19 +19,19 @@ const runStatusClasses = (run: AccSyncItemStatus) => {
   const classParts = ['w-24 justify-center']
 
   switch (run) {
-    case 'SYNCING':
+    case 'syncing':
       classParts.push('bg-info-lighter')
       break
-    case 'PENDING':
+    case 'pending':
       classParts.push('bg-warning-lighter')
       break
-    case 'PAUSED':
+    case 'paused':
       classParts.push('bg-warning-lighter')
       break
-    case 'FAILED':
+    case 'failed':
       classParts.push('bg-danger-lighter')
       break
-    case 'SUCCEEDED':
+    case 'succeeded':
       classParts.push('bg-success-lighter')
       break
   }
diff --git a/packages/frontend-2/components/project/page/acc/Syncs.vue b/packages/frontend-2/components/project/page/acc/Syncs.vue
index 3aaa295d7..20eb00439 100644
--- a/packages/frontend-2/components/project/page/acc/Syncs.vue
+++ b/packages/frontend-2/components/project/page/acc/Syncs.vue
@@ -38,8 +38,8 @@
           <FormButton
             hide-text
             color="outline"
-            :icon-left="item.status === 'PAUSED' ? PlayIcon : PauseIcon"
-            @click="handleStatusSyncItem(item.id, item.status === 'PAUSED')"
+            :icon-left="item.status === 'paused' ? PlayIcon : PauseIcon"
+            @click="handleStatusSyncItem(item.id, item.status === 'paused')"
           />
           <FormButton
             hide-text
@@ -144,7 +144,7 @@
 </template>
 
 <script setup lang="ts">
-import type { AccTokens, AccHub, AccProject, AccItem } from '~/lib/acc/types'
+import type { AccTokens, AccHub, AccProject, AccItem } from '@speckle/shared/acc'
 import { ref, computed } from 'vue'
 import type {
   ProjectLatestModelsPaginationQueryVariables,
@@ -169,8 +169,6 @@ const props = defineProps<{
   isLoggedIn: boolean
 }>()
 
-// TODO ACC: Need to think about data residency from "ACC > Speckle" and warn users accordingly
-
 const step = ref(0)
 
 const showNewSyncDialog = ref(false)
@@ -481,7 +479,7 @@ const handleStatusSyncItem = async (id: string, isPaused: boolean) => {
       input: {
         projectId: props.projectId,
         id,
-        status: isPaused ? 'PENDING' : 'PAUSED'
+        status: isPaused ? 'pending' : 'paused'
       }
     })
   } catch (error) {
diff --git a/packages/frontend-2/components/project/page/acc/Tab.vue b/packages/frontend-2/components/project/page/acc/Tab.vue
index f753259d6..faf94af9d 100644
--- a/packages/frontend-2/components/project/page/acc/Tab.vue
+++ b/packages/frontend-2/components/project/page/acc/Tab.vue
@@ -51,7 +51,7 @@
 </template>
 
 <script setup lang="ts">
-import type { AccTokens, AccUserInfo } from '~/lib/acc/types'
+import type { AccTokens, AccUserInfo } from '@speckle/shared/acc'
 // import { DocumentDuplicateIcon } from '@heroicons/vue/24/outline'
 
 const props = defineProps<{ projectId: string }>()
diff --git a/packages/frontend-2/lib/acc/types.ts b/packages/frontend-2/lib/acc/types.ts
index 8e74d7251..a1df653d3 100644
--- a/packages/frontend-2/lib/acc/types.ts
+++ b/packages/frontend-2/lib/acc/types.ts
@@ -1,47 +1,6 @@
-export type AccTokens = {
-  access_token: string
-  refresh_token: string
-  token_type: string
-  id_token: string
-  expires_in: number
-}
-
-export type AccUserInfo = {
-  userId: string
-  userName: string
-  emailId: string
-  firstName: string
-  lastName: string
-}
-
-export type AccHub = {
-  id: string
-  attributes: { name: string; region: string; extension: Record<string, unknown> }
-}
-
-export type AccProject = {
-  id: string
-  attributes: { name: string; lastModifiedTime: string }
-  relationships: Record<string, unknown>
-}
-
-export type AccItem = {
-  id: string
-  type?: string
-  latestVersionId?: string // we mutate on the way
-  fileExtension: string
-  storageUrn?: string // we mutate on the way
-  attributes: {
-    name: string
-    displayName: string
-    createTime?: string
-    extension?: Record<string, unknown>
-    versionNumber: number
-  }
-}
-
-// TODO: looks stale, we can consider to move this types into @shared
+import type { AccHub, AccItem } from '@speckle/shared/acc'
 
+// TODO ACC: Replace with type information inferred from gql queries, if possible
 export type AccSyncItem = {
   id: string
   accHub: AccHub
@@ -55,4 +14,9 @@ export type AccSyncItem = {
   status: AccSyncItemStatus
 }
 
-export type AccSyncItemStatus = 'sync' | 'syncing' | 'paused' | 'failed'
+export type AccSyncItemStatus =
+  | 'pending'
+  | 'syncing'
+  | 'paused'
+  | 'failed'
+  | 'succeeded'
diff --git a/packages/frontend-2/lib/common/generated/gql/graphql.ts b/packages/frontend-2/lib/common/generated/gql/graphql.ts
index b5adcdfca..f65bd312f 100644
--- a/packages/frontend-2/lib/common/generated/gql/graphql.ts
+++ b/packages/frontend-2/lib/common/generated/gql/graphql.ts
@@ -74,11 +74,11 @@ export type AccSyncItemMutationsUpdateArgs = {
 };
 
 export const AccSyncItemStatus = {
-  Failed: 'FAILED',
-  Paused: 'PAUSED',
-  Pending: 'PENDING',
-  Succeeded: 'SUCCEEDED',
-  Syncing: 'SYNCING'
+  Failed: 'failed',
+  Paused: 'paused',
+  Pending: 'pending',
+  Succeeded: 'succeeded',
+  Syncing: 'syncing'
 } as const;
 
 export type AccSyncItemStatus = typeof AccSyncItemStatus[keyof typeof AccSyncItemStatus];
diff --git a/packages/server/assets/acc/typedefs/accSyncItems.graphql b/packages/server/assets/acc/typedefs/accSyncItems.graphql
index 8b135ad06..5027eb1b2 100644
--- a/packages/server/assets/acc/typedefs/accSyncItems.graphql
+++ b/packages/server/assets/acc/typedefs/accSyncItems.graphql
@@ -31,11 +31,11 @@ type AccSyncItem {
 }
 
 enum AccSyncItemStatus {
-  PENDING
-  SYNCING
-  FAILED
-  SUCCEEDED
-  PAUSED
+  pending
+  syncing
+  failed
+  succeeded
+  paused
 }
 
 input DeleteAccSyncItemInput {
diff --git a/packages/server/modules/acc/clients/autodesk.ts b/packages/server/modules/acc/clients/autodesk.ts
index 30a9154a0..e4b663a56 100644
--- a/packages/server/modules/acc/clients/autodesk.ts
+++ b/packages/server/modules/acc/clients/autodesk.ts
@@ -1,5 +1,6 @@
 /* eslint-disable camelcase */
 
+import type { AccTokens } from '@speckle/shared/acc'
 import type { AccRegion } from '@/modules/acc/domain/constants'
 import { AccRegions } from '@/modules/acc/domain/constants'
 import type { ModelDerivativeServiceDesignManifest } from '@/modules/acc/domain/types'
@@ -10,6 +11,7 @@ import {
 import { logger } from '@/observability/logging'
 import { isObjectLike } from 'lodash-es'
 import { z } from 'zod'
+import crypto from 'crypto'
 
 const invokeJsonRequest = async <T>(params: {
   url: string
@@ -41,12 +43,121 @@ const invokeJsonRequest = async <T>(params: {
   return (await response.json()) as T
 }
 
+interface BuildAuthorizeUrlOptions {
+  clientId: string
+  redirectUri: string
+  codeChallenge: string
+  scopes: string[]
+}
+
+interface ExchangeCodeOptions {
+  code: string
+  codeVerifier: string
+  clientId: string
+  clientSecret: string
+  redirectUri: string
+}
+
+const AccTokens = z.object({
+  access_token: z.string(),
+  refresh_token: z.string(),
+  token_type: z.string(),
+  id_token: z.string(),
+  expires_in: z.number()
+})
+
+export const generateCodeVerifier = () => {
+  const codeVerifier = crypto.randomBytes(32).toString('base64url')
+  const codeChallenge = crypto
+    .createHash('sha256')
+    .update(codeVerifier)
+    .digest('base64url')
+  return { codeVerifier, codeChallenge }
+}
+
+export const buildAuthorizeUrl = ({
+  clientId,
+  redirectUri,
+  codeChallenge,
+  scopes
+}: BuildAuthorizeUrlOptions) => {
+  const params = new URLSearchParams({
+    response_type: 'code',
+    client_id: clientId,
+    redirect_uri: redirectUri,
+    scope: scopes.join(' '),
+    code_challenge: codeChallenge,
+    code_challenge_method: 'S256'
+  })
+
+  return `https://developer.api.autodesk.com/authentication/v2/authorize?${params.toString()}`
+}
+
+export const exchangeCodeForTokens = async ({
+  code,
+  codeVerifier,
+  clientId,
+  clientSecret,
+  redirectUri
+}: ExchangeCodeOptions): Promise<AccTokens> => {
+  const params = new URLSearchParams({
+    grant_type: 'authorization_code',
+    client_id: clientId,
+    client_secret: clientSecret,
+    redirect_uri: redirectUri,
+    code,
+    code_verifier: codeVerifier
+  })
+
+  const response = await fetch(
+    'https://developer.api.autodesk.com/authentication/v2/token',
+    {
+      method: 'POST',
+      body: params,
+      headers: {
+        'Content-Type': 'application/x-www-form-urlencoded'
+      }
+    }
+  )
+
+  const data = await response.json()
+
+  return AccTokens.parse(data)
+}
+
+export const exchangeRefreshTokenForTokens = async (args: {
+  refresh_token: string
+}): Promise<AccTokens> => {
+  const params = new URLSearchParams({
+    grant_type: 'refresh_token',
+    client_id: getAutodeskIntegrationClientId(),
+    client_secret: getAutodeskIntegrationClientSecret(),
+    refresh_token: args.refresh_token
+  })
+
+  const response = await fetch(
+    'https://developer.api.autodesk.com/authentication/v2/token',
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+      body: params
+    }
+  )
+
+  const data = await response.json()
+
+  return AccTokens.parse(data)
+}
+
 type AutodeskIntegrationTokenData = {
   access_token: string
   token_type: string
   expires_in: number
 }
 
+/**
+ * Fetch a valid token for server-side operations as our custom integration
+ */
 export const getToken = async (): Promise<AutodeskIntegrationTokenData> => {
   const clientId = getAutodeskIntegrationClientId()
   const clientSecret = getAutodeskIntegrationClientSecret()
diff --git a/packages/server/modules/acc/domain/constants.ts b/packages/server/modules/acc/domain/constants.ts
index 8035b6b9b..efee7d348 100644
--- a/packages/server/modules/acc/domain/constants.ts
+++ b/packages/server/modules/acc/domain/constants.ts
@@ -7,12 +7,12 @@ export const ImporterAutomateFunctions = {
 
 export const AccSyncItemStatuses = {
   // A new file version had been detected, and we are awaiting a processable file.
-  pending: 'PENDING',
+  pending: 'pending',
   // We are actively processing the new file version. (The Automate function has been triggered.)
-  syncing: 'SYNCING',
-  failed: 'FAILED',
-  paused: 'PAUSED',
-  succeeded: 'SUCCEEDED'
+  syncing: 'syncing',
+  failed: 'failed',
+  paused: 'paused',
+  succeeded: 'succeeded'
 } as const
 export type AccSyncItemStatus =
   (typeof AccSyncItemStatuses)[keyof typeof AccSyncItemStatuses]
diff --git a/packages/server/modules/acc/domain/operations.ts b/packages/server/modules/acc/domain/operations.ts
index 6436dab8a..b4a563559 100644
--- a/packages/server/modules/acc/domain/operations.ts
+++ b/packages/server/modules/acc/domain/operations.ts
@@ -1,7 +1,10 @@
 import type { AccSyncItemStatus } from '@/modules/acc/domain/constants'
 import type { AccSyncItem } from '@/modules/acc/domain/types'
+import type { Exact } from 'type-fest'
 
-export type UpsertAccSyncItem = (item: AccSyncItem) => Promise<void>
+export type UpsertAccSyncItem = <Item extends Exact<AccSyncItem, Item>>(
+  item: Item
+) => Promise<void>
 
 export type UpdateAccSyncItemStatus = (args: {
   id: string
@@ -10,6 +13,8 @@ export type UpdateAccSyncItemStatus = (args: {
 
 export type GetAccSyncItemById = (args: { id: string }) => Promise<AccSyncItem | null>
 
+export type GetAccSyncItemsById = (args: { ids: string[] }) => Promise<AccSyncItem[]>
+
 export type ListAccSyncItems = (args: {
   projectId: string
   filter?: {
diff --git a/packages/server/modules/acc/errors/acc.ts b/packages/server/modules/acc/errors/acc.ts
index e49265a00..8a87f29c1 100644
--- a/packages/server/modules/acc/errors/acc.ts
+++ b/packages/server/modules/acc/errors/acc.ts
@@ -1,5 +1,11 @@
 import { BaseError } from '@/modules/shared/errors/base'
 
+export class AccModuleDisabledError extends BaseError {
+  static defaultMessage = 'ACC integration module is disabled'
+  static code = 'ACC_MODULE_DISABLED'
+  static statusCode = 423
+}
+
 export class DuplicateSyncItemError extends BaseError {
   static defaultMessage = 'A sync item with this lineage urn already exists.'
   static code = 'ACC_DUPLICATE_SYNC_ITEM_LINEAGE_URN'
@@ -14,9 +20,11 @@ export class DuplicateSyncItemError extends BaseError {
 export class SyncItemNotFoundError extends BaseError {
   static defaultMessage = 'Sync item not found'
   static code = 'ACC_SYNC_ITEM_NOT_FOUND'
+  static statusCode = 404
 }
 
 export class SyncItemAutomationTriggerError extends BaseError {
   static defaultMessage = 'Failed to trigger automation associated with sync item'
   static code = 'ACC_SYNC_ITEM_AUTOMATION_TRIGGER_ERROR'
+  static statusCode = 422
 }
diff --git a/packages/server/modules/acc/graph/resolvers/accSyncItems.ts b/packages/server/modules/acc/graph/resolvers/accSyncItems.ts
index ba0dfb385..d84dc353b 100644
--- a/packages/server/modules/acc/graph/resolvers/accSyncItems.ts
+++ b/packages/server/modules/acc/graph/resolvers/accSyncItems.ts
@@ -9,7 +9,6 @@ import {
 import {
   createAccSyncItemFactory,
   deleteAccSyncItemFactory,
-  getAccSyncItemFactory,
   getPaginatedAccSyncItemsFactory,
   updateAccSyncItemFactory
 } from '@/modules/acc/services/management'
@@ -40,7 +39,6 @@ import { TokenResourceIdentifierType } from '@/modules/core/domain/tokens/types'
 import type { Resolvers } from '@/modules/core/graph/generated/graphql'
 import { throwIfResourceAccessNotAllowed } from '@/modules/core/helpers/token'
 import { getBranchesByIdsFactory } from '@/modules/core/repositories/branches'
-import { getUserFactory } from '@/modules/core/repositories/users'
 import { validateStreamAccessFactory } from '@/modules/core/services/streams/access'
 import { getProjectDbClient } from '@/modules/multiregion/utils/dbSelector'
 import { authorizeResolver } from '@/modules/shared'
@@ -61,6 +59,12 @@ import {
   ProjectSubscriptions
 } from '@/modules/shared/utils/subscriptions'
 import { throwIfAuthNotOk } from '@/modules/shared/helpers/errorHelper'
+import { AccModuleDisabledError, SyncItemNotFoundError } from '@/modules/acc/errors/acc'
+import { getFeatureFlags } from '@speckle/shared/environment'
+
+const { FF_ACC_INTEGRATION_ENABLED, FF_AUTOMATE_MODULE_ENABLED } = getFeatureFlags()
+
+const enableAcc = FF_ACC_INTEGRATION_ENABLED && FF_AUTOMATE_MODULE_ENABLED
 
 const resolvers: Resolvers = {
   Mutation: {
@@ -164,8 +168,8 @@ const resolvers: Resolvers = {
     }
   },
   AccSyncItem: {
-    author: async (parent) => {
-      return await getUserFactory({ db })(parent.authorId)
+    author: async (parent, _args, context) => {
+      return await context.loaders.users.getUser.load(parent.authorId)
     }
   },
   Project: {
@@ -198,9 +202,13 @@ const resolvers: Resolvers = {
         resourceType: TokenResourceIdentifierType.Project
       })
 
-      return await getAccSyncItemFactory({
-        getAccSyncItemById: getAccSyncItemByIdFactory({ db })
-      })({ id })
+      const syncItem = await ctx.loaders.acc.getAccSyncItem.load(id)
+
+      if (!syncItem) {
+        throw new SyncItemNotFoundError()
+      }
+
+      return syncItem
     }
   },
   Subscription: {
@@ -231,4 +239,37 @@ const resolvers: Resolvers = {
   }
 }
 
-export default resolvers
+const disabledResolvers: Resolvers = {
+  Mutation: {
+    accSyncItemMutations: () => ({})
+  },
+  AccSyncItemMutations: {
+    async create() {
+      throw new AccModuleDisabledError()
+    },
+    async update() {
+      throw new AccModuleDisabledError()
+    },
+    async delete() {
+      throw new AccModuleDisabledError()
+    }
+  },
+  Project: {
+    async accSyncItem() {
+      throw new AccModuleDisabledError()
+    },
+    async accSyncItems() {
+      throw new AccModuleDisabledError()
+    }
+  },
+  Subscription: {
+    projectAccSyncItemsUpdated: {
+      subscribe: filteredSubscribe(
+        ProjectSubscriptions.ProjectAccSyncItemUpdated,
+        async () => false
+      )
+    }
+  }
+}
+
+export default enableAcc ? resolvers : disabledResolvers
diff --git a/packages/server/modules/acc/helpers/oidcHelper.ts b/packages/server/modules/acc/helpers/oidcHelper.ts
deleted file mode 100644
index 817de6dfd..000000000
--- a/packages/server/modules/acc/helpers/oidcHelper.ts
+++ /dev/null
@@ -1,88 +0,0 @@
-/* eslint-disable camelcase */
-
-import crypto from 'crypto'
-import { z } from 'zod'
-
-interface BuildAuthorizeUrlOptions {
-  clientId: string
-  redirectUri: string
-  codeChallenge: string
-  scopes: string[]
-}
-
-interface ExchangeCodeOptions {
-  code: string
-  codeVerifier: string
-  clientId: string
-  clientSecret: string
-  redirectUri: string
-}
-
-const AccTokens = z.object({
-  access_token: z.string(),
-  refresh_token: z.string(),
-  token_type: z.string(),
-  id_token: z.string(),
-  expires_in: z.number()
-})
-
-export type AccTokens = z.infer<typeof AccTokens>
-
-export const generateCodeVerifier = () => {
-  const codeVerifier = crypto.randomBytes(32).toString('base64url')
-  const codeChallenge = crypto
-    .createHash('sha256')
-    .update(codeVerifier)
-    .digest('base64url')
-  return { codeVerifier, codeChallenge }
-}
-
-export const buildAuthorizeUrl = ({
-  clientId,
-  redirectUri,
-  codeChallenge,
-  scopes
-}: BuildAuthorizeUrlOptions) => {
-  const params = new URLSearchParams({
-    response_type: 'code',
-    client_id: clientId,
-    redirect_uri: redirectUri,
-    scope: scopes.join(' '),
-    code_challenge: codeChallenge,
-    code_challenge_method: 'S256'
-  })
-
-  return `https://developer.api.autodesk.com/authentication/v2/authorize?${params.toString()}`
-}
-
-export const exchangeCodeForTokens = async ({
-  code,
-  codeVerifier,
-  clientId,
-  clientSecret,
-  redirectUri
-}: ExchangeCodeOptions): Promise<AccTokens> => {
-  const params = new URLSearchParams({
-    grant_type: 'authorization_code',
-    client_id: clientId,
-    client_secret: clientSecret,
-    redirect_uri: redirectUri,
-    code,
-    code_verifier: codeVerifier
-  })
-
-  const response = await fetch(
-    'https://developer.api.autodesk.com/authentication/v2/token',
-    {
-      method: 'POST',
-      body: params,
-      headers: {
-        'Content-Type': 'application/x-www-form-urlencoded'
-      }
-    }
-  )
-
-  const data = await response.json()
-
-  return AccTokens.parse(data)
-}
diff --git a/packages/server/modules/acc/domain/logic.ts b/packages/server/modules/acc/helpers/svfUtils.ts
similarity index 100%
rename from packages/server/modules/acc/domain/logic.ts
rename to packages/server/modules/acc/helpers/svfUtils.ts
diff --git a/packages/server/modules/acc/helpers/types.ts b/packages/server/modules/acc/helpers/types.ts
index 0b99798dd..fefb57ef1 100644
--- a/packages/server/modules/acc/helpers/types.ts
+++ b/packages/server/modules/acc/helpers/types.ts
@@ -1,4 +1,4 @@
-import type { AccTokens } from '@/modules/acc/helpers/oidcHelper'
+import type { AccTokens } from '@speckle/shared/acc'
 import type { Session, SessionData } from 'express-session'
 
 declare module 'express-session' {
diff --git a/packages/server/modules/acc/index.ts b/packages/server/modules/acc/index.ts
index 00d3e543c..a80224259 100644
--- a/packages/server/modules/acc/index.ts
+++ b/packages/server/modules/acc/index.ts
@@ -8,14 +8,14 @@ import {
 } from '@/modules/core/repositories/scheduledTasks'
 import type { ScheduleExecution } from '@/modules/core/domain/scheduledTasks/operations'
 import { getFeatureFlags } from '@/modules/shared/helpers/envHelper'
-import { accOidc } from '@/modules/acc/rest/oidc'
-import { accWebhooks } from '@/modules/acc/rest/webhooks'
+import { setupAccOidcEndpoints } from '@/modules/acc/rest/oidc'
+import { setupAccWebhookEndpoints } from '@/modules/acc/rest/webhooks'
 import { schedulePendingSyncItemsCheck } from '@/modules/acc/services/cron'
 import { reportSubscriptionEventsFactory } from '@/modules/acc/events/eventListeners'
 import { getEventBus } from '@/modules/shared/services/eventBus'
 import { publish } from '@/modules/shared/utils/subscriptions'
 
-const { FF_ACC_INTEGRATION_ENABLED } = getFeatureFlags()
+const { FF_ACC_INTEGRATION_ENABLED, FF_AUTOMATE_MODULE_ENABLED } = getFeatureFlags()
 
 const scheduleExecution = scheduleExecutionFactory({
   acquireTaskLock: acquireTaskLockFactory({ db }),
@@ -27,24 +27,23 @@ let scheduledTask: ReturnType<ScheduleExecution> | null = null
 
 const accModule: SpeckleModule = {
   init: async ({ app, isInitial }) => {
-    if (!FF_ACC_INTEGRATION_ENABLED) return
+    if (!FF_ACC_INTEGRATION_ENABLED || !FF_AUTOMATE_MODULE_ENABLED) return
 
-    moduleLogger.info('🖕 Init acc module')
+    moduleLogger.info('🖕 Init ACC module')
 
     if (isInitial) {
-      accOidc(app)
-      accWebhooks(app)
+      setupAccOidcEndpoints(app)
+      setupAccWebhookEndpoints(app)
       quitListeners = reportSubscriptionEventsFactory({
         eventListen: getEventBus().listen,
         publish
-      })
+      })()
       scheduledTask = schedulePendingSyncItemsCheck({ scheduleExecution })
     }
   },
   shutdown: () => {
-    if (!FF_ACC_INTEGRATION_ENABLED) return
     quitListeners?.()
-    scheduledTask?.stop()
+    scheduledTask?.stop?.()
   },
   finalize: () => {}
 }
diff --git a/packages/server/modules/acc/repositories/accSyncItems.ts b/packages/server/modules/acc/repositories/accSyncItems.ts
index f9de48e06..72a490eef 100644
--- a/packages/server/modules/acc/repositories/accSyncItems.ts
+++ b/packages/server/modules/acc/repositories/accSyncItems.ts
@@ -3,6 +3,7 @@ import type {
   CountAccSyncItems,
   DeleteAccSyncItemById,
   GetAccSyncItemById,
+  GetAccSyncItemsById,
   ListAccSyncItems,
   QueryAllAccSyncItems,
   UpdateAccSyncItemStatus,
@@ -23,12 +24,20 @@ export const getAccSyncItemByIdFactory =
     return (
       (await tables
         .accSyncItems(deps.db)
-        .select('*')
+        .select()
         .where(AccSyncItems.col.id, id)
         .first()) ?? null
     )
   }
 
+export const getAccSyncItemsByIdFactory =
+  (deps: { db: Knex }): GetAccSyncItemsById =>
+  async ({ ids }) => {
+    if (!ids.length) return []
+
+    return await tables.accSyncItems(deps.db).select().whereIn(AccSyncItems.col.id, ids)
+  }
+
 export const upsertAccSyncItemFactory =
   (deps: { db: Knex }): UpsertAccSyncItem =>
   async (item) => {
diff --git a/packages/server/modules/acc/rest/oidc.ts b/packages/server/modules/acc/rest/oidc.ts
index b1c6c9667..5baffe2d8 100644
--- a/packages/server/modules/acc/rest/oidc.ts
+++ b/packages/server/modules/acc/rest/oidc.ts
@@ -3,8 +3,9 @@
 import {
   buildAuthorizeUrl,
   exchangeCodeForTokens,
+  exchangeRefreshTokenForTokens,
   generateCodeVerifier
-} from '@/modules/acc/helpers/oidcHelper'
+} from '@/modules/acc/clients/autodesk'
 import { sessionMiddlewareFactory } from '@/modules/auth/middleware'
 import { corsMiddlewareFactory } from '@/modules/core/configs/cors'
 import {
@@ -15,7 +16,7 @@ import {
 } from '@/modules/shared/helpers/envHelper'
 import type { Express } from 'express'
 
-export const accOidc = (app: Express) => {
+export const setupAccOidcEndpoints = (app: Express) => {
   const corsMiddleware = corsMiddlewareFactory({
     corsConfig: {
       origin: [getServerOrigin(), getFrontendOrigin()],
@@ -101,30 +102,8 @@ export const accOidc = (app: Express) => {
       }
 
       try {
-        const params = new URLSearchParams({
-          grant_type: 'refresh_token',
-          client_id: getAutodeskIntegrationClientId(),
-          client_secret: getAutodeskIntegrationClientSecret(),
-          refresh_token
-        })
-
-        const response = await fetch(
-          'https://developer.api.autodesk.com/authentication/v2/token',
-          {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
-            body: params
-          }
-        )
-
-        if (!response.ok) {
-          console.error(await response.text())
-          return res.status(500).json({ error: 'Failed to refresh token' })
-        }
-
-        const newTokens = await response.json()
+        const newTokens = await exchangeRefreshTokenForTokens({ refresh_token })
         req.session.accTokens = newTokens
-
         res.json(newTokens)
       } catch (error) {
         console.error('Error refreshing token:', error)
diff --git a/packages/server/modules/acc/rest/webhooks.ts b/packages/server/modules/acc/rest/webhooks.ts
index 72fc61874..9e9f72893 100644
--- a/packages/server/modules/acc/rest/webhooks.ts
+++ b/packages/server/modules/acc/rest/webhooks.ts
@@ -9,7 +9,7 @@ import type { Express } from 'express'
 import { z } from 'zod'
 import { db } from '@/db/knex'
 
-export const accWebhooks = (app: Express) => {
+export const setupAccWebhookEndpoints = (app: Express) => {
   const sessionMiddleware = sessionMiddlewareFactory()
   app.post('/api/v1/acc/webhook/callback', sessionMiddleware, async (req, res) => {
     logger.info({ hook: req.body?.hook, payload: req.body?.payload })
diff --git a/packages/server/modules/acc/services/cron.ts b/packages/server/modules/acc/services/cron.ts
index 903ee256f..f6b1176f0 100644
--- a/packages/server/modules/acc/services/cron.ts
+++ b/packages/server/modules/acc/services/cron.ts
@@ -5,7 +5,7 @@ import {
 import type { ScheduleExecution } from '@/modules/core/domain/scheduledTasks/operations'
 import { db } from '@/db/knex'
 import { getManifestByUrn, getToken } from '@/modules/acc/clients/autodesk'
-import { isReadyForImport } from '@/modules/acc/domain/logic'
+import { isReadyForImport } from '@/modules/acc/helpers/svfUtils'
 import type { Logger } from '@/observability/logging'
 import { getProjectDbClient } from '@/modules/multiregion/utils/dbSelector'
 import {
diff --git a/packages/server/modules/acc/services/management.ts b/packages/server/modules/acc/services/management.ts
index 7240b5fc5..760eb889c 100644
--- a/packages/server/modules/acc/services/management.ts
+++ b/packages/server/modules/acc/services/management.ts
@@ -3,9 +3,12 @@ import {
   getToken,
   tryRegisterAccWebhook
 } from '@/modules/acc/clients/autodesk'
-import { ImporterAutomateFunctions } from '@/modules/acc/domain/constants'
+import {
+  AccSyncItemStatuses,
+  ImporterAutomateFunctions
+} from '@/modules/acc/domain/constants'
 import { AccSyncItemEvents } from '@/modules/acc/domain/events'
-import { isReadyForImport } from '@/modules/acc/domain/logic'
+import { isReadyForImport } from '@/modules/acc/helpers/svfUtils'
 import type {
   CountAccSyncItems,
   DeleteAccSyncItemById,
@@ -27,6 +30,7 @@ import {
 import { getServerOrigin } from '@/modules/shared/helpers/envHelper'
 import type { EventBusEmit } from '@/modules/shared/services/eventBus'
 import cryptoRandomString from 'crypto-random-string'
+import type { Exact } from 'type-fest'
 
 export type CreateAccSyncItem = (params: {
   syncItem: Pick<
@@ -101,7 +105,7 @@ export const createAccSyncItemFactory =
       ...syncItem,
       id: cryptoRandomString({ length: 10 }),
       automationId: automation.id,
-      status: 'PENDING',
+      status: AccSyncItemStatuses.pending,
       authorId: creatorUserId,
       accWebhookId: webhookId ?? undefined,
       createdAt: new Date(),
@@ -136,20 +140,6 @@ export const createAccSyncItemFactory =
     return await deps.triggerSyncItemAutomation({ id: newSyncItem.id })
   }
 
-export type GetAccSyncItem = (params: { id: string }) => Promise<AccSyncItem>
-
-export const getAccSyncItemFactory =
-  (deps: { getAccSyncItemById: GetAccSyncItemById }): GetAccSyncItem =>
-  async ({ id }) => {
-    const syncItem = await deps.getAccSyncItemById({ id })
-
-    if (!syncItem) {
-      throw new SyncItemNotFoundError()
-    }
-
-    return syncItem
-  }
-
 export type GetPaginatedAccSyncItems = (params: {
   projectId: string
   filter?: {
@@ -190,8 +180,10 @@ export const getPaginatedAccSyncItemsFactory =
     }
   }
 
-export type UpdateAccSyncItem = (params: {
-  syncItem: Partial<AccSyncItem> & Pick<AccSyncItem, 'id'>
+export type UpdateAccSyncItem = <
+  Item extends Exact<Partial<AccSyncItem> & Pick<AccSyncItem, 'id'>, Item>
+>(params: {
+  syncItem: Item
 }) => Promise<AccSyncItem>
 
 export const updateAccSyncItemFactory =
diff --git a/packages/server/modules/core/graph/dataloaders/index.ts b/packages/server/modules/core/graph/dataloaders/index.ts
index 7af871df7..20cb11d3c 100644
--- a/packages/server/modules/core/graph/dataloaders/index.ts
+++ b/packages/server/modules/core/graph/dataloaders/index.ts
@@ -92,6 +92,8 @@ import type {
 import { logger } from '@/observability/logging'
 import { getLastVersionsByProjectIdFactory } from '@/modules/core/repositories/versions'
 import type { StreamRoles } from '@speckle/shared'
+import { getAccSyncItemsByIdFactory } from '@/modules/acc/repositories/accSyncItems'
+import type { AccSyncItem } from '@/modules/acc/domain/types'
 
 declare module '@/modules/core/loaders' {
   interface ModularizedDataLoaders extends ReturnType<typeof dataLoadersDefinition> {}
@@ -139,6 +141,7 @@ const dataLoadersDefinition = defineRequestDataloaders(
     const getStreamsCollaboratorCounts = getStreamsCollaboratorCountsFactory({
       db
     })
+    const getAccSyncItemsById = getAccSyncItemsByIdFactory({ db })
 
     return {
       streams: {
@@ -548,6 +551,15 @@ const dataLoadersDefinition = defineRequestDataloaders(
           return appIds.map((i) => results[i] || [])
         })
       },
+      acc: {
+        getAccSyncItem: createLoader<string, Nullable<AccSyncItem>>(async (ids) => {
+          const results = keyBy(
+            await getAccSyncItemsById({ ids: ids.slice() }),
+            (i) => i.id
+          )
+          return ids.map((i) => results[i] || null)
+        })
+      },
       automations: {
         getAutomation: createLoader<string, Nullable<AutomationRecord>>(async (ids) => {
           const results = keyBy(
diff --git a/packages/server/modules/core/graph/generated/graphql.ts b/packages/server/modules/core/graph/generated/graphql.ts
index d0c80d981..a815e4c02 100644
--- a/packages/server/modules/core/graph/generated/graphql.ts
+++ b/packages/server/modules/core/graph/generated/graphql.ts
@@ -94,11 +94,11 @@ export type AccSyncItemMutationsUpdateArgs = {
 };
 
 export const AccSyncItemStatus = {
-  Failed: 'FAILED',
-  Paused: 'PAUSED',
-  Pending: 'PENDING',
-  Succeeded: 'SUCCEEDED',
-  Syncing: 'SYNCING'
+  Failed: 'failed',
+  Paused: 'paused',
+  Pending: 'pending',
+  Succeeded: 'succeeded',
+  Syncing: 'syncing'
 } as const;
 
 export type AccSyncItemStatus = typeof AccSyncItemStatus[keyof typeof AccSyncItemStatus];
diff --git a/packages/shared/package.json b/packages/shared/package.json
index 724150e6e..25fac255d 100644
--- a/packages/shared/package.json
+++ b/packages/shared/package.json
@@ -104,6 +104,7 @@
       "./viewer/route": "./src/viewer/helpers/route.ts",
       "./viewer/state": "./src/viewer/helpers/state.ts",
       "./automate": "./src/automate/index.ts",
+      "./acc": "./src/acc/index.ts",
       "./dist/*": "./dist/*"
     },
     "exclude": [
@@ -310,6 +311,16 @@
         "default": "./dist/commonjs/automate/index.js"
       }
     },
+    "./acc": {
+      "import": {
+        "types": "./dist/esm/acc/index.d.ts",
+        "default": "./dist/esm/acc/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/acc/index.d.ts",
+        "default": "./dist/commonjs/acc/index.js"
+      }
+    },
     "./dist/*": "./dist/*"
   }
 }
diff --git a/packages/shared/src/acc/helpers/types.ts b/packages/shared/src/acc/helpers/types.ts
new file mode 100644
index 000000000..f6420a3d6
--- /dev/null
+++ b/packages/shared/src/acc/helpers/types.ts
@@ -0,0 +1,41 @@
+export type AccTokens = {
+  access_token: string
+  refresh_token: string
+  token_type: string
+  id_token: string
+  expires_in: number
+}
+
+export type AccUserInfo = {
+  userId: string
+  userName: string
+  emailId: string
+  firstName: string
+  lastName: string
+}
+
+export type AccHub = {
+  id: string
+  attributes: { name: string; region: string; extension: Record<string, unknown> }
+}
+
+export type AccProject = {
+  id: string
+  attributes: { name: string; lastModifiedTime: string }
+  relationships: Record<string, unknown>
+}
+
+export type AccItem = {
+  id: string
+  type?: string
+  latestVersionId?: string // we mutate on the way
+  fileExtension: string
+  storageUrn?: string // we mutate on the way
+  attributes: {
+    name: string
+    displayName: string
+    createTime?: string
+    extension?: Record<string, unknown>
+    versionNumber: number
+  }
+}
diff --git a/packages/shared/src/acc/index.ts b/packages/shared/src/acc/index.ts
new file mode 100644
index 000000000..648d18359
--- /dev/null
+++ b/packages/shared/src/acc/index.ts
@@ -0,0 +1 @@
+export * from './helpers/types.js'