snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-front/scripts/generate-mock-data.ts

@@ -0,0 +1,45 @@
+/* oxlint-disable no-console */
+import { generateApiKeys } from './mock-data/generate-api-keys.js';
+import { generateBillingPlans } from './mock-data/generate-billing-plans.js';
+import { generateCommandMenuItems } from './mock-data/generate-command-menu-items.js';
+import { generateObjectMetadata } from './mock-data/generate-object-metadata.js';
+import { generateMinimalMetadata } from './mock-data/generate-minimal-metadata.js';
+import { generateRecordData } from './mock-data/generate-record-data.js';
+import { generateRoles } from './mock-data/generate-roles.js';
+import { generateNavigationMenuItems } from './mock-data/generate-navigation-menu-items.js';
+import { generateViews } from './mock-data/generate-views.js';
+import { authenticate } from './mock-data/utils.js';
+
+const main = async () => {
+  const token = await authenticate();
+
+  const metadata = await generateObjectMetadata(token);
+  await generateMinimalMetadata(token);
+  await generateRecordData(token, metadata);
+  await generateRoles(token);
+  await generateViews(token);
+  await generateNavigationMenuItems(token);
+  await generateCommandMenuItems(token);
+
+  try {
+    await generateBillingPlans(token);
+  } catch (error) {
+    console.warn(
+      'Skipping billing plans generation (billing not available):',
+      (error as Error).message,
+    );
+  }
+
+  try {
+    await generateApiKeys(token);
+  } catch (error) {
+    console.warn('Skipping API keys generation:', (error as Error).message);
+  }
+
+  console.log('All mock data generated!');
+};
+
+main().catch((error) => {
+  console.error('Fatal error:', error);
+  process.exit(1);
+});

packages/twenty-front/scripts/inject-runtime-env.sh

@@ -0,0 +1,30 @@
+#!/bin/sh
+
+if [ -z "$REACT_APP_SERVER_BASE_URL" ]; then
+  echo "Error: REACT_APP_SERVER_BASE_URL is not set."
+  exit 1
+fi
+
+echo "Injecting runtime environment variables into index.html..."
+
+CONFIG_BLOCK=$(cat << EOF
+    <script id="twenty-env-config">
+      window._env_ = {
+        REACT_APP_SERVER_BASE_URL: "$REACT_APP_SERVER_BASE_URL"
+      };
+    </script>
+    <!-- END: Twenty Config -->
+EOF
+)
+# Use sed to replace the config block in index.html
+# Using pattern space to match across multiple lines
+echo "$CONFIG_BLOCK" | sed -i.bak '
+  /<!-- BEGIN: Twenty Config -->/,/<!-- END: Twenty Config -->/{
+    /<!-- BEGIN: Twenty Config -->/!{
+      /<!-- END: Twenty Config -->/!d
+    }
+    /<!-- BEGIN: Twenty Config -->/r /dev/stdin
+    /<!-- END: Twenty Config -->/d
+  }
+' build/index.html
+rm -f build/index.html.bak

packages/twenty-front/scripts/mock-data/generate-api-keys.ts

@@ -0,0 +1,40 @@
+/* oxlint-disable no-console */
+import { graphqlRequest, writeGeneratedFile } from './utils.js';
+
+const API_KEYS_QUERY = `
+  query ApiKeys {
+    apiKeys {
+      __typename
+      id
+      name
+      expiresAt
+      createdAt
+      updatedAt
+      revokedAt
+      role {
+        __typename
+        id
+        label
+        icon
+      }
+    }
+  }
+`;
+
+export const generateApiKeys = async (token: string) => {
+  console.log('Fetching API keys from /metadata ...');
+
+  const data = (await graphqlRequest('/metadata', API_KEYS_QUERY, token)) as {
+    apiKeys: Record<string, unknown>[];
+  };
+
+  console.log(`  Got ${data.apiKeys.length} API keys.`);
+
+  writeGeneratedFile(
+    'metadata/api-keys/mock-api-keys-data.ts',
+    'mockedApiKeys',
+    'Record<string, unknown>[]',
+    '',
+    data.apiKeys,
+  );
+};

packages/twenty-front/scripts/mock-data/generate-billing-plans.ts

@@ -0,0 +1,68 @@
+/* oxlint-disable no-console */
+import { graphqlRequest, writeGeneratedFile } from './utils.js';
+
+const LIST_PLANS_QUERY = `
+  query listPlans {
+    listPlans {
+      planKey
+      licensedProducts {
+        name
+        description
+        images
+        metadata {
+          productKey
+          planKey
+          priceUsageBased
+        }
+        ... on BillingLicensedProduct {
+          prices {
+            stripePriceId
+            unitAmount
+            recurringInterval
+            priceUsageType
+          }
+        }
+      }
+      meteredProducts {
+        name
+        description
+        images
+        metadata {
+          productKey
+          planKey
+          priceUsageBased
+        }
+        ... on BillingMeteredProduct {
+          prices {
+            priceUsageType
+            recurringInterval
+            stripePriceId
+            tiers {
+              flatAmount
+              unitAmount
+              upTo
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+
+export const generateBillingPlans = async (token: string) => {
+  console.log('Fetching billing plans from /metadata ...');
+
+  const data = (await graphqlRequest('/metadata', LIST_PLANS_QUERY, token)) as {
+    listPlans: Record<string, unknown>[];
+  };
+
+  console.log(`  Got ${data.listPlans.length} billing plans.`);
+
+  writeGeneratedFile(
+    'metadata/billing-plans/mock-billing-plans-data.ts',
+    'mockedBillingPlans',
+    'Record<string, unknown>',
+    '',
+    { listPlans: data.listPlans },
+  );
+};

packages/twenty-front/scripts/mock-data/generate-command-menu-items.ts

@@ -0,0 +1,60 @@
+/* oxlint-disable no-console, lingui/no-unlocalized-strings */
+import { graphqlRequest, writeGeneratedFile } from './utils.js';
+
+const FIND_MANY_COMMAND_MENU_ITEMS_QUERY = `
+  query FindManyCommandMenuItems {
+    commandMenuItems {
+      __typename
+      id
+      applicationId
+      workflowVersionId
+      frontComponentId
+      frontComponent {
+        id
+        name
+        isHeadless
+      }
+      engineComponentKey
+      label
+      icon
+      shortLabel
+      position
+      isPinned
+      payload {
+        __typename
+        ... on PathCommandMenuItemPayload {
+          path
+        }
+      }
+      hotKeys
+      conditionalAvailabilityExpression
+      availabilityType
+      availabilityObjectMetadataId
+      navigationTargetObjectMetadataId
+      pageLayoutId
+      isActive
+    }
+  }
+`;
+
+export const generateCommandMenuItems = async (token: string) => {
+  console.log('Fetching command menu items from /metadata ...');
+
+  const data = (await graphqlRequest(
+    '/metadata',
+    FIND_MANY_COMMAND_MENU_ITEMS_QUERY,
+    token,
+  )) as {
+    commandMenuItems: Record<string, unknown>[];
+  };
+
+  console.log(`  Got ${data.commandMenuItems.length} command menu items.`);
+
+  writeGeneratedFile(
+    'metadata/command-menu-items/mock-command-menu-items-data.ts',
+    'mockedCommandMenuItems',
+    'CommandMenuItemFieldsFragment[]',
+    "import { type CommandMenuItemFieldsFragment } from '~/generated-metadata/graphql';",
+    data.commandMenuItems,
+  );
+};

packages/twenty-front/scripts/mock-data/generate-minimal-metadata.ts

@@ -0,0 +1,50 @@
+/* oxlint-disable no-console */
+import { graphqlRequest, writeGeneratedFile } from './utils.js';
+
+const MINIMAL_METADATA_QUERY = `
+  query FindMinimalMetadata {
+    minimalMetadata {
+      objectMetadataItems {
+        id
+        nameSingular
+        namePlural
+        labelSingular
+        labelPlural
+        icon
+        isActive
+        isSystem
+        isRemote
+      }
+      views {
+        id
+        type
+        key
+        objectMetadataId
+      }
+      collectionHashes {
+        collectionName
+        hash
+      }
+    }
+  }
+`;
+
+export const generateMinimalMetadata = async (token: string) => {
+  console.log('Fetching minimal metadata from /metadata ...');
+
+  const data = (await graphqlRequest(
+    '/metadata',
+    MINIMAL_METADATA_QUERY,
+    token,
+  )) as {
+    minimalMetadata: Record<string, unknown>;
+  };
+
+  writeGeneratedFile(
+    'metadata/minimal/mock-minimal-metadata.ts',
+    'mockedMinimalMetadata',
+    'MinimalMetadata',
+    "import { type MinimalMetadata } from '@/metadata-store/types/MinimalMetadata';",
+    data.minimalMetadata,
+  );
+};

packages/twenty-front/scripts/mock-data/generate-navigation-menu-items.ts

@@ -0,0 +1,52 @@
+/* oxlint-disable no-console, lingui/no-unlocalized-strings */
+import { graphqlRequest, writeGeneratedFile } from './utils.js';
+
+const FIND_MANY_NAVIGATION_MENU_ITEMS_QUERY = `
+  query FindManyNavigationMenuItems {
+    navigationMenuItems {
+      id
+      userWorkspaceId
+      targetRecordId
+      targetObjectMetadataId
+      viewId
+      folderId
+      name
+      link
+      icon
+      color
+      position
+      applicationId
+      createdAt
+      updatedAt
+      targetRecordIdentifier {
+        id
+        labelIdentifier
+        imageIdentifier
+      }
+    }
+  }
+`;
+
+export const generateNavigationMenuItems = async (token: string) => {
+  console.log('Fetching navigation menu items from /metadata ...');
+
+  const data = (await graphqlRequest(
+    '/metadata',
+    FIND_MANY_NAVIGATION_MENU_ITEMS_QUERY,
+    token,
+  )) as {
+    navigationMenuItems: Record<string, unknown>[];
+  };
+
+  console.log(
+    `  Got ${data.navigationMenuItems.length} navigation menu items.`,
+  );
+
+  writeGeneratedFile(
+    'metadata/navigation-menu-items/mock-navigation-menu-items-data.ts',
+    'mockedNavigationMenuItems',
+    'NavigationMenuItem[]',
+    "import { type NavigationMenuItem } from '~/generated-metadata/graphql';",
+    data.navigationMenuItems,
+  );
+};

packages/twenty-front/scripts/mock-data/generate-object-metadata.ts

@@ -0,0 +1,169 @@
+/* oxlint-disable no-console */
+import { graphqlRequest, writeGeneratedFile } from './utils.js';
+
+// Apollo Client automatically adds __typename to every object level;
+// raw fetch does not, so we include it explicitly here.
+const METADATA_QUERY = `
+  query ObjectMetadataItems {
+    objects(paging: { first: 1000 }) {
+      __typename
+      edges {
+        __typename
+        node {
+          __typename
+          id
+          universalIdentifier
+          nameSingular
+          namePlural
+          labelSingular
+          labelPlural
+          description
+          icon
+          isRemote
+          isActive
+          isSystem
+          isUIEditable
+          isUICreatable
+          createdAt
+          updatedAt
+          labelIdentifierFieldMetadataId
+          imageIdentifierFieldMetadataId
+          applicationId
+          shortcut
+          isLabelSyncedWithName
+          isSearchable
+          duplicateCriteria
+          searchFieldMetadataList {
+            __typename
+            id
+            fieldMetadataId
+            tsVectorFieldMetadataId
+            position
+            createdAt
+            updatedAt
+          }
+          indexMetadataList {
+            __typename
+            id
+            createdAt
+            updatedAt
+            name
+            indexWhereClause
+            indexType
+            isUnique
+            isCustom
+            indexFieldMetadataList {
+              __typename
+              id
+              fieldMetadataId
+              createdAt
+              updatedAt
+              order
+            }
+          }
+          fieldsList {
+            __typename
+            id
+            universalIdentifier
+            type
+            name
+            label
+            description
+            icon
+            isActive
+            isSystem
+            isUIEditable
+            isNullable
+            isUnique
+            isSearchable
+            createdAt
+            updatedAt
+            defaultValue
+            options
+            settings
+            isLabelSyncedWithName
+            morphId
+            applicationId
+            relation {
+              __typename
+              type
+              sourceObjectMetadata {
+                __typename
+                id
+                nameSingular
+                namePlural
+              }
+              targetObjectMetadata {
+                __typename
+                id
+                nameSingular
+                namePlural
+              }
+              sourceFieldMetadata {
+                __typename
+                id
+                name
+              }
+              targetFieldMetadata {
+                __typename
+                id
+                name
+              }
+            }
+            morphRelations {
+              __typename
+              type
+              sourceObjectMetadata {
+                __typename
+                id
+                nameSingular
+                namePlural
+              }
+              targetObjectMetadata {
+                __typename
+                id
+                nameSingular
+                namePlural
+              }
+              sourceFieldMetadata {
+                __typename
+                id
+                name
+              }
+              targetFieldMetadata {
+                __typename
+                id
+                name
+              }
+            }
+          }
+        }
+      }
+      pageInfo {
+        __typename
+        hasNextPage
+        hasPreviousPage
+        startCursor
+        endCursor
+      }
+    }
+  }
+`;
+
+export const generateObjectMetadata = async (token: string) => {
+  console.log('Fetching object metadata from /metadata ...');
+
+  const metadata = await graphqlRequest('/metadata', METADATA_QUERY, token);
+
+  writeGeneratedFile(
+    'metadata/objects/mock-objects-metadata.ts',
+    'mockedStandardObjectMetadataQueryResult',
+    'ObjectMetadataItemsQuery',
+    "import { ObjectMetadataItemsQuery } from '~/generated-metadata/graphql';",
+    metadata,
+  );
+
+  return metadata as {
+    objects: { edges: { node: Record<string, unknown> }[] };
+  };
+};

packages/twenty-front/scripts/mock-data/generate-record-data.ts

@@ -0,0 +1,111 @@
+/* oxlint-disable no-console, lingui/no-unlocalized-strings */
+import { print } from 'graphql';
+
+import { type EnrichedObjectMetadataItem } from '@/object-metadata/types/EnrichedObjectMetadataItem';
+import { generateDepthRecordGqlFieldsFromObject } from '@/object-record/graphql/record-gql-fields/utils/generateDepthRecordGqlFieldsFromObject';
+import { generateFindManyRecordsQuery } from '@/object-record/utils/generateFindManyRecordsQuery';
+
+import { graphqlRequest, writeGeneratedFile } from './utils.js';
+
+const RECORDS_LIMIT = 10;
+
+const OBJECTS_TO_GENERATE = [
+  'company',
+  'person',
+  'task',
+  'note',
+  'timelineActivity',
+  'workspaceMember',
+  'connectedAccount',
+  'calendarEvent',
+];
+
+// Production query builders omit __typename on connection/edge wrappers
+// since Apollo Client injects them automatically. Raw fetch needs them explicit.
+const addTypenamesToSelections = (query: string): string =>
+  query.replace(/\{(?!\s*__typename\b)/g, '{\n__typename');
+
+const toObjectMetadataItems = (rawMetadata: {
+  objects: { edges: { node: Record<string, unknown> }[] };
+}): EnrichedObjectMetadataItem[] =>
+  rawMetadata.objects.edges.map((edge) => {
+    const { fieldsList, indexMetadataList, ...rest } = edge.node;
+
+    return {
+      ...rest,
+      fields: fieldsList,
+      readableFields: fieldsList,
+      updatableFields: fieldsList,
+      indexMetadatas: ((indexMetadataList as unknown[]) ?? []).map(
+        (index: any) => ({
+          ...index,
+          indexFieldMetadatas: index.indexFieldMetadataList ?? [],
+        }),
+      ),
+    } as unknown as EnrichedObjectMetadataItem;
+  });
+
+const generateForObject = async (
+  token: string,
+  objectMetadataItems: EnrichedObjectMetadataItem[],
+  objectNameSingular: string,
+) => {
+  const objectMetadataItem = objectMetadataItems.find(
+    (item) => item.nameSingular === objectNameSingular,
+  );
+
+  if (!objectMetadataItem) {
+    throw new Error(`${objectNameSingular} object metadata not found`);
+  }
+
+  const recordGqlFields = generateDepthRecordGqlFieldsFromObject({
+    objectMetadataItems,
+    objectMetadataItem,
+    depth: 1,
+  });
+
+  const queryDocument = generateFindManyRecordsQuery({
+    objectMetadataItem,
+    objectMetadataItems,
+    recordGqlFields,
+    objectPermissionsByObjectMetadataId: {},
+  });
+
+  const query = addTypenamesToSelections(print(queryDocument));
+
+  console.log(
+    `Fetching ${objectMetadataItem.namePlural} (limit: ${RECORDS_LIMIT}) from /graphql ...`,
+  );
+
+  const data = (await graphqlRequest('/graphql', query, token, {
+    limit: RECORDS_LIMIT,
+  })) as Record<string, { edges: { node: Record<string, unknown> }[] }>;
+
+  const records = data[objectMetadataItem.namePlural].edges.map(
+    (edge) => edge.node,
+  );
+
+  console.log(`  Got ${records.length} ${objectMetadataItem.namePlural}.`);
+
+  const pascalName =
+    objectNameSingular.charAt(0).toUpperCase() + objectNameSingular.slice(1);
+
+  writeGeneratedFile(
+    `data/${objectMetadataItem.namePlural}/mock-${objectMetadataItem.namePlural}-data.ts`,
+    `mocked${pascalName}Records`,
+    'ObjectRecord[]',
+    "import { type ObjectRecord } from '@/object-record/types/ObjectRecord';",
+    records,
+  );
+};
+
+export const generateRecordData = async (
+  token: string,
+  rawMetadata: { objects: { edges: { node: Record<string, unknown> }[] } },
+) => {
+  const objectMetadataItems = toObjectMetadataItems(rawMetadata);
+
+  for (const objectNameSingular of OBJECTS_TO_GENERATE) {
+    await generateForObject(token, objectMetadataItems, objectNameSingular);
+  }
+};

packages/twenty-front/scripts/mock-data/generate-roles.ts

@@ -0,0 +1,150 @@
+/* oxlint-disable no-console, lingui/no-unlocalized-strings */
+import { graphqlRequest, writeGeneratedFile } from './utils.js';
+
+// Inline the full GetRoles query with all fragments so we don't need
+// @apollo/client at generation time.
+const GET_ROLES_QUERY = `
+  query GetRoles {
+    getRoles {
+      __typename
+      id
+      label
+      description
+      icon
+      canUpdateAllSettings
+      canAccessAllTools
+      isEditable
+      canReadAllObjectRecords
+      canUpdateAllObjectRecords
+      canSoftDeleteAllObjectRecords
+      canDestroyAllObjectRecords
+      canBeAssignedToUsers
+      canBeAssignedToAgents
+      canBeAssignedToApiKeys
+      workspaceMembers {
+        __typename
+        id
+        name {
+          __typename
+          firstName
+          lastName
+        }
+        avatarUrl
+        userEmail
+      }
+      agents {
+        __typename
+        id
+        name
+        label
+        description
+        icon
+        prompt
+        modelId
+        responseFormat
+        roleId
+        isCustom
+        modelConfiguration
+        evaluationInputs
+        applicationId
+        createdAt
+        updatedAt
+      }
+      apiKeys {
+        __typename
+        id
+        name
+        expiresAt
+        revokedAt
+      }
+      permissionFlags {
+        __typename
+        id
+        flag
+        roleId
+      }
+      objectPermissions {
+        __typename
+        objectMetadataId
+        canReadObjectRecords
+        canUpdateObjectRecords
+        canSoftDeleteObjectRecords
+        canDestroyObjectRecords
+        restrictedFields
+        rowLevelPermissionPredicates {
+          __typename
+          id
+          fieldMetadataId
+          objectMetadataId
+          operand
+          subFieldName
+          workspaceMemberFieldMetadataId
+          workspaceMemberSubFieldName
+          rowLevelPermissionPredicateGroupId
+          positionInRowLevelPermissionPredicateGroup
+          roleId
+          value
+        }
+        rowLevelPermissionPredicateGroups {
+          __typename
+          id
+          parentRowLevelPermissionPredicateGroupId
+          logicalOperator
+          positionInRowLevelPermissionPredicateGroup
+          roleId
+          objectMetadataId
+        }
+      }
+      fieldPermissions {
+        __typename
+        objectMetadataId
+        fieldMetadataId
+        canReadFieldValue
+        canUpdateFieldValue
+        id
+        roleId
+      }
+      rowLevelPermissionPredicates {
+        __typename
+        id
+        fieldMetadataId
+        objectMetadataId
+        operand
+        subFieldName
+        workspaceMemberFieldMetadataId
+        workspaceMemberSubFieldName
+        rowLevelPermissionPredicateGroupId
+        positionInRowLevelPermissionPredicateGroup
+        roleId
+        value
+      }
+      rowLevelPermissionPredicateGroups {
+        __typename
+        id
+        parentRowLevelPermissionPredicateGroupId
+        logicalOperator
+        positionInRowLevelPermissionPredicateGroup
+        roleId
+        objectMetadataId
+      }
+    }
+  }
+`;
+
+export const generateRoles = async (token: string) => {
+  console.log('Fetching roles from /metadata ...');
+
+  const data = (await graphqlRequest('/metadata', GET_ROLES_QUERY, token)) as {
+    getRoles: Record<string, unknown>[];
+  };
+
+  console.log(`  Got ${data.getRoles.length} roles.`);
+
+  writeGeneratedFile(
+    'metadata/roles/mock-roles-data.ts',
+    'mockedRoles',
+    'Role[]',
+    "import { type Role } from '~/generated-metadata/graphql';",
+    data.getRoles,
+  );
+};

packages/twenty-front/scripts/mock-data/generate-views.ts

@@ -0,0 +1,120 @@
+/* oxlint-disable no-console, lingui/no-unlocalized-strings */
+import { graphqlRequest, writeGeneratedFile } from './utils.js';
+
+const FIND_ALL_VIEWS_QUERY = `
+  query FindAllViews {
+    getViews {
+      id
+      name
+      objectMetadataId
+      type
+      key
+      icon
+      position
+      isCompact
+      openRecordIn
+      kanbanAggregateOperation
+      kanbanAggregateOperationFieldMetadataId
+      mainGroupByFieldMetadataId
+      shouldHideEmptyGroups
+      anyFieldFilterValue
+      calendarFieldMetadataId
+      calendarLayout
+      visibility
+      createdByUserWorkspaceId
+      isActive
+      viewFields {
+        id
+        fieldMetadataId
+        viewId
+        isVisible
+        position
+        size
+        aggregateOperation
+        createdAt
+        updatedAt
+        deletedAt
+      }
+      viewFieldGroups {
+        id
+        name
+        position
+        isVisible
+        viewId
+        createdAt
+        updatedAt
+        deletedAt
+        viewFields {
+          id
+          fieldMetadataId
+          viewId
+          isVisible
+          position
+          size
+          aggregateOperation
+          createdAt
+          updatedAt
+          deletedAt
+        }
+      }
+      viewFilters {
+        id
+        fieldMetadataId
+        operand
+        value
+        viewFilterGroupId
+        positionInViewFilterGroup
+        subFieldName
+        viewId
+        createdAt
+        updatedAt
+        deletedAt
+      }
+      viewFilterGroups {
+        id
+        parentViewFilterGroupId
+        logicalOperator
+        positionInViewFilterGroup
+        viewId
+      }
+      viewSorts {
+        id
+        fieldMetadataId
+        direction
+        viewId
+      }
+      viewGroups {
+        id
+        isVisible
+        fieldValue
+        position
+        viewId
+        createdAt
+        updatedAt
+        deletedAt
+      }
+    }
+  }
+`;
+
+export const generateViews = async (token: string) => {
+  console.log('Fetching views from /metadata ...');
+
+  const data = (await graphqlRequest(
+    '/metadata',
+    FIND_ALL_VIEWS_QUERY,
+    token,
+  )) as {
+    getViews: Record<string, unknown>[];
+  };
+
+  console.log(`  Got ${data.getViews.length} views.`);
+
+  writeGeneratedFile(
+    'metadata/views/mock-views-data.ts',
+    'mockedViews',
+    'ViewWithRelations[]',
+    "import { type ViewWithRelations } from '@/views/types/ViewWithRelations';",
+    data.getViews,
+  );
+};

packages/twenty-front/scripts/mock-data/utils.ts

@@ -0,0 +1,134 @@
+/* oxlint-disable no-console */
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+
+process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
+
+const SERVER_BASE_URL =
+  process.env.REACT_APP_SERVER_BASE_URL ?? 'http://localhost:3000';
+const AUTH_EMAIL = 'jane.austen@apple.dev';
+const AUTH_PASSWORD = 'tim@apple.dev';
+const WORKSPACE_SUBDOMAIN = 'apple';
+
+const serverUrl = new URL(SERVER_BASE_URL);
+export const WORKSPACE_ORIGIN = `${serverUrl.protocol}//${WORKSPACE_SUBDOMAIN}.${serverUrl.host}`;
+
+const currentDir = path.dirname(fileURLToPath(import.meta.url));
+export const GENERATED_DIR = path.resolve(
+  currentDir,
+  '../../src/testing/mock-data/generated',
+);
+
+export const graphqlRequest = async (
+  endpoint: string,
+  query: string,
+  token?: string,
+  variables?: Record<string, unknown>,
+): Promise<unknown> => {
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+    Origin: WORKSPACE_ORIGIN,
+  };
+
+  if (token !== undefined) {
+    headers['Authorization'] = `Bearer ${token}`;
+  }
+
+  const response = await fetch(`${SERVER_BASE_URL}${endpoint}`, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify({ query, variables }),
+  });
+
+  const json = (await response.json()) as {
+    data?: unknown;
+    errors?: { message: string }[];
+  };
+
+  if (
+    json.errors !== undefined &&
+    json.errors !== null &&
+    json.errors.length > 0
+  ) {
+    const errorDetails = json.errors.map((error) => error.message).join(', ');
+    throw new Error(`GraphQL error on ${endpoint}: ${errorDetails}`);
+  }
+
+  return json.data;
+};
+
+export const authenticate = async (): Promise<string> => {
+  console.log(
+    `Authenticating as ${AUTH_EMAIL} on workspace ${WORKSPACE_SUBDOMAIN}...`,
+  );
+
+  const loginData = (await graphqlRequest(
+    '/metadata',
+    `mutation GetLoginTokenFromCredentials {
+      getLoginTokenFromCredentials(
+        email: "${AUTH_EMAIL}",
+        password: "${AUTH_PASSWORD}",
+        origin: "${WORKSPACE_ORIGIN}"
+      ) {
+        loginToken { token }
+      }
+    }`,
+  )) as {
+    getLoginTokenFromCredentials: { loginToken: { token: string } };
+  };
+
+  const loginToken = loginData.getLoginTokenFromCredentials.loginToken.token;
+
+  const authData = (await graphqlRequest(
+    '/metadata',
+    `mutation GetAuthTokensFromLoginToken {
+      getAuthTokensFromLoginToken(
+        loginToken: "${loginToken}",
+        origin: "${WORKSPACE_ORIGIN}"
+      ) {
+        tokens {
+          accessOrWorkspaceAgnosticToken { token }
+        }
+      }
+    }`,
+  )) as {
+    getAuthTokensFromLoginToken: {
+      tokens: { accessOrWorkspaceAgnosticToken: { token: string } };
+    };
+  };
+
+  const accessToken =
+    authData.getAuthTokensFromLoginToken.tokens.accessOrWorkspaceAgnosticToken
+      .token;
+
+  console.log('Authenticated successfully.');
+  return accessToken;
+};
+
+export const writeGeneratedFile = (
+  relativePath: string,
+  exportName: string,
+  typeName: string,
+  typeImport: string,
+  data: unknown,
+) => {
+  const filePath = path.join(GENERATED_DIR, relativePath);
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+
+  const content = [
+    '/* oxlint-disable */',
+    '// @ts-nocheck',
+    typeImport,
+    '',
+    '// This file was automatically generated — do not edit manually.',
+    '',
+    '// prettier-ignore',
+    `export const ${exportName}: ${typeName} =`,
+    JSON.stringify(data, null, 2) + ';',
+    '',
+  ].join('\n');
+
+  fs.writeFileSync(filePath, content, 'utf-8');
+  console.log(`Written: ${filePath}`);
+};