@donotuse/eas-cli 18.5.0-rc.1

package/build/commandUtils/new/templates/AGENTS.md

@@ -0,0 +1,162 @@
+# AGENTS.md
+
+## Project Overview
+
+This is an Expo/React Native mobile application. Prioritize mobile-first patterns, performance, and cross-platform compatibility.
+
+## Documentation Resources
+
+When working on this project, **always consult the official Expo documentation** available at:
+
+- **https://docs.expo.dev/llms.txt** - Index of all available documentation files
+- **https://docs.expo.dev/llms-full.txt** - Complete Expo documentation including Expo Router, Expo Modules API, development process
+- **https://docs.expo.dev/llms-eas.txt** - Complete EAS (Expo Application Services) documentation
+- **https://docs.expo.dev/llms-sdk.txt** - Complete Expo SDK documentation
+- **https://reactnative.dev/docs/getting-started** - Complete React Native documentation
+
+These documentation files are specifically formatted for AI agents and should be your **primary reference** for:
+
+- Expo APIs and best practices
+- Expo Router navigation patterns
+- EAS Build, Submit, and Update workflows
+- Expo SDK modules and their usage
+- Development and deployment processes
+
+## Project Structure
+
+```
+/
+├── app/                   # Expo Router file-based routing
+│   ├── (tabs)/            # Tab-based navigation screens
+│   │   ├── index.tsx      # Home screen
+│   │   ├── explore.tsx    # Explore screen
+│   │   └── _layout.tsx    # Tabs layout
+│   ├── _layout.tsx        # Root layout with theme provider
+│   └── modal.tsx          # Modal screen example
+├── components/            # Reusable React components
+│   ├── ui/                # UI primitives (IconSymbol, Collapsible)
+│   └── ...                # Feature components (themed, haptic, parallax)
+├── constants/             # App-wide constants (theme, colors)
+├── hooks/                 # Custom React hooks (color scheme, theme)
+├── assets/                # Static assets (images, fonts)
+├── scripts/               # Utility scripts (reset-project)
+├── .eas/workflows/        # EAS Workflows (CI/CD automation)
+├── app.json               # Expo configuration
+├── eas.json               # EAS Build/Submit configuration
+└── package.json           # Dependencies and scripts
+```
+
+## Essential Commands
+
+### Development
+
+```bash
+npx expo start                  # Start dev server
+npx expo start --clear          # Clear cache and start dev server
+npx expo install <package>      # Install packages with compatible versions
+npx expo install --check        # Check which installed packages need to be updated
+npx expo install --fix          # Automatically update any invalid package versions
+npm run development-builds      # Create development builds (workflow)
+npm run reset-project           # Reset to blank template
+```
+
+### Building & Testing
+
+```bash
+npx expo doctor      # Check project health and dependencies
+npx expo lint        # Run ESLint
+npm run draft        # Publish preview update and website (workflow)
+```
+
+### Production
+
+```bash
+npx eas-cli@latest build --platform ios -s          # Use EAS to build for iOS platform and submit to App Store
+npx eas-cli@latest build --platform android -s      # Use EAS to build for Android platform and submit to Google Play Store
+npm run deploy                                      # Deploy to production (workflow)
+```
+
+## Development Guidelines
+
+### Code Style & Standards
+
+- **TypeScript First**: Use TypeScript for all new code with strict type checking
+- **Naming Conventions**: Use meaningful, descriptive names for variables, functions, and components
+- **Self-Documenting Code**: Write clear, readable code that explains itself; only add comments for complex business logic or design decisions
+- **React 19 Patterns**: Follow modern React patterns including:
+  - Function components with hooks
+  - Enable React Compiler
+  - Proper dependency arrays in useEffect
+  - Memoization when appropriate (useMemo, useCallback)
+  - Error boundaries for better error handling
+
+### Navigation & Routing
+
+- Use **Expo Router** for all navigation
+- Import `Link`, `router`, and `useLocalSearchParams` from `expo-router`
+- Docs: https://docs.expo.dev/router/introduction/
+
+### Recommended Libraries
+
+- **Navigation**: `expo-router` for navigation
+- **Images**: `expo-image` for optimized image handling and caching
+- **Animations**: `react-native-reanimated` for performant animations on native thread
+- **Gestures**: `react-native-gesture-handler` for native gesture recognition
+- **Storage**: Use `expo-sqlite` for persistent storage, `expo-sqlite/kv-store` for simple key-value storage
+
+## Debugging & Development Tools
+
+### DevTools Integration
+
+- **React Native DevTools**: Use MCP `open_devtools` command to launch debugging tools
+- **Network Inspection**: Monitor API calls and network requests in DevTools
+- **Element Inspector**: Debug component hierarchy and styles
+- **Performance Profiler**: Identify performance bottlenecks
+- **Logging**: Use `console.log` for debugging (remove before production), `console.warn` for deprecation notices, `console.error` for actual errors, and implement error boundaries for production error handling
+
+### Testing & Quality Assurance
+
+#### Automated Testing with MCP Tools
+
+Developers can configure the Expo MCP server with the following doc: https://docs.expo.dev/eas/ai/mcp/
+
+- **Component Testing**: Add `testID` props to components for automation
+- **Visual Testing**: Use MCP `automation_take_screenshot` to verify UI appearance
+- **Interaction Testing**: Use MCP `automation_tap_by_testid` to simulate user interactions
+- **View Verification**: Use MCP `automation_find_view_by_testid` to validate component rendering
+
+## EAS Workflows CI/CD
+
+This project is pre-configured with **EAS Workflows** for automating development and release processes. Workflows are defined in `.eas/workflows/` directory.
+
+When working with EAS Workflows, **always refer to**:
+
+- https://docs.expo.dev/eas/workflows/ for workflow examples
+- The `.eas/workflows/` directory for existing workflow configurations
+- You can check that a workflow YAML is valid using the workflows schema: https://exp.host/--/api/v2/workflows/schema
+
+### Build Profiles (eas.json)
+
+- **development**: Development builds with dev client
+- **development-simulator**: Development builds for iOS simulator
+- **preview**: Internal distribution preview builds
+- **production**: Production builds with auto-increment
+
+## Troubleshooting
+
+### Expo Go Errors & Development Builds
+
+If there are errors in **Expo Go** or the project is not running, create a **development build**. **Expo Go** is a sandbox environment with a limited set of native modules. To create development builds, run `eas build:dev`. Additionally, after installing new packages or adding config plugins, new development builds are often required.
+
+## AI Agent Instructions
+
+When working on this project:
+
+1. **Always start by consulting the appropriate documentation**:
+   - For general Expo questions: https://docs.expo.dev/llms-full.txt
+   - For EAS/deployment questions: https://docs.expo.dev/llms-eas.txt
+   - For SDK/API questions: https://docs.expo.dev/llms-sdk.txt
+
+2. **Understand before implementing**: Read the relevant docs section before writing code
+
+3. **Follow existing patterns**: Look at existing components and screens for patterns to follow

package/build/commandUtils/new/templates/CLAUDE.md

@@ -0,0 +1,9 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+**Note**: This project uses `AGENTS.md` files for detailed guidance.
+
+## Primary Reference
+
+Please see `AGENTS.md` in this same directory for the main project documentation and guidance.

package/build/commandUtils/new/templates/readme-additions.md

@@ -0,0 +1,36 @@
+## Get started
+
+To start the app, in your terminal run:
+
+```bash
+npm run start
+```
+
+In the output, you'll find options to open the app in:
+
+- [a development build](https://docs.expo.dev/develop/development-builds/introduction/)
+- [an Android emulator](https://docs.expo.dev/workflow/android-studio-emulator/)
+- [an iOS simulator](https://docs.expo.dev/workflow/ios-simulator/)
+- [Expo Go](https://expo.dev/go), a limited sandbox for trying out app development with Expo
+
+You can start developing by editing the files inside the **app** directory. This project uses [file-based routing](https://docs.expo.dev/router/introduction).
+
+## Workflows
+
+This project is configured to use [EAS Workflows](https://docs.expo.dev/eas/workflows/get-started/) to automate some development and release processes. These commands are set up in [`package.json`](./package.json) and can be run using NPM scripts in your terminal.
+
+### Previews
+
+Run `npm run draft` to [publish a preview update](https://docs.expo.dev/eas/workflows/examples/publish-preview-update/) of your project, which can be viewed in Expo Go or in a development build.
+
+### Development Builds
+
+Run `npm run development-builds` to [create a development build](https://docs.expo.dev/eas/workflows/examples/create-development-builds/). Note - you'll need to follow the [Prerequisites](https://docs.expo.dev/eas/workflows/examples/create-development-builds/#prerequisites) to ensure you have the correct emulator setup on your machine.
+
+### Production Deployments
+
+Run `npm run deploy` to [deploy to production](https://docs.expo.dev/eas/workflows/examples/deploy-to-production/). Note - you'll need to follow the [Prerequisites](https://docs.expo.dev/eas/workflows/examples/deploy-to-production/#prerequisites) to ensure you're set up to submit to the Apple and Google stores.
+
+## Hosting
+
+Expo offers hosting for websites and API functions via EAS Hosting. See the [Getting Started](https://docs.expo.dev/eas/hosting/get-started/) guide to learn more.

package/build/commandUtils/new/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Formats a directory path for display.
+ * If the directory is within the current working directory, returns a relative path.
+ * Otherwise, returns the absolute path.
+ */
+export declare function printDirectory(directory: string): string;

package/build/commandUtils/new/utils.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printDirectory = printDirectory;
+const tslib_1 = require("tslib");
+const path_1 = tslib_1.__importDefault(require("path"));
+/**
+ * Formats a directory path for display.
+ * If the directory is within the current working directory, returns a relative path.
+ * Otherwise, returns the absolute path.
+ */
+function printDirectory(directory) {
+    const cwd = process.cwd();
+    const absoluteDir = path_1.default.isAbsolute(directory) ? directory : path_1.default.resolve(cwd, directory);
+    const relativePath = path_1.default.relative(cwd, absoluteDir);
+    // If the relative path doesn't start with '..' it means it's within or at the cwd
+    if (!relativePath.startsWith('..') && !path_1.default.isAbsolute(relativePath)) {
+        return relativePath !== '' ? `./${relativePath}` : '.';
+    }
+    return absoluteDir;
+}

package/build/commandUtils/pagination.d.ts

@@ -0,0 +1,17 @@
+import { Interfaces } from '@oclif/core';
+import { EasNonInteractiveAndJsonFlags } from './flags';
+export declare const getPaginatedQueryOptions: (flags: Partial<Record<keyof typeof EasPaginatedQueryFlags | keyof typeof EasNonInteractiveAndJsonFlags, any>>) => PaginatedQueryOptions;
+export declare const getLimitFlagWithCustomValues: ({ defaultTo, limit, }: {
+    defaultTo: number;
+    limit: number;
+}) => Interfaces.OptionFlag<number | undefined>;
+export declare const EasPaginatedQueryFlags: {
+    offset: Interfaces.OptionFlag<number | undefined, Interfaces.CustomOptions>;
+    limit: Interfaces.OptionFlag<number | undefined>;
+};
+export type PaginatedQueryOptions = {
+    nonInteractive: boolean;
+    json: boolean;
+    limit?: number;
+    offset: number;
+};

package/build/commandUtils/pagination.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EasPaginatedQueryFlags = exports.getLimitFlagWithCustomValues = exports.getPaginatedQueryOptions = void 0;
+const core_1 = require("@oclif/core");
+const flags_1 = require("./flags");
+const getPaginatedQueryOptions = (flags) => {
+    const { json, nonInteractive } = (0, flags_1.resolveNonInteractiveAndJsonFlags)(flags);
+    return {
+        ...('limit' in flags && { limit: flags.limit }),
+        offset: flags.offset ?? 0,
+        nonInteractive,
+        json,
+    };
+};
+exports.getPaginatedQueryOptions = getPaginatedQueryOptions;
+const parseFlagInputStringAsInteger = (input, flagName, lowerLimit, upperLimit) => {
+    const inputAsNumber = Number(input);
+    if (isNaN(inputAsNumber)) {
+        throw new Error(`Unable to parse ${input} as a number`);
+    }
+    if (inputAsNumber < lowerLimit || inputAsNumber > upperLimit) {
+        throw new Error(`--${flagName} must be between ${lowerLimit} and ${upperLimit}`);
+    }
+    return inputAsNumber;
+};
+const getLimitFlagWithCustomValues = ({ defaultTo, limit, }) => core_1.Flags.integer({
+    description: `The number of items to fetch each query. Defaults to ${defaultTo} and is capped at ${limit}.`,
+    // eslint-disable-next-line async-protect/async-suffix
+    parse: async (input) => parseFlagInputStringAsInteger(input, 'limit', 1, limit),
+});
+exports.getLimitFlagWithCustomValues = getLimitFlagWithCustomValues;
+exports.EasPaginatedQueryFlags = {
+    offset: core_1.Flags.integer({
+        description: 'Start queries from specified index. Use for paginating results. Defaults to 0.',
+        // eslint-disable-next-line async-protect/async-suffix
+        parse: async (input) => parseFlagInputStringAsInteger(input, 'offset', 0, Number.MAX_SAFE_INTEGER),
+    }),
+    limit: (0, exports.getLimitFlagWithCustomValues)({ defaultTo: 50, limit: 100 }),
+};

package/build/commandUtils/projectNameValidation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Perform the same validation as the server, to avoid GraphQL errors.
+ */
+export declare function validateFullNameAndSlug(fullName: string, slug: string): void;
+/**
+ * Attempt to derive a valid slug name from the one passed in
+ */
+export declare function validSlugName(slug: string): string;

package/build/commandUtils/projectNameValidation.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFullNameAndSlug = validateFullNameAndSlug;
+exports.validSlugName = validSlugName;
+const experienceParser_1 = require("./experienceParser");
+/**
+ * Perform the same validation as the server, to avoid GraphQL errors.
+ */
+function validateFullNameAndSlug(fullName, slug) {
+    if (!(0, experienceParser_1.isValidExperienceName)(fullName)) {
+        throw new Error(`Invalid project name: ${fullName}`);
+    }
+    if (!(0, experienceParser_1.isValidSlugStrict)(slug)) {
+        throw new Error(`Invalid slug: ${slug}`);
+    }
+    if ((0, experienceParser_1.isSlugForbidden)(slug)) {
+        throw new Error(`Cannot create an app named "${slug}" because it would conflict with a dependency of the same name.`);
+    }
+    if (fullName.length > 255) {
+        throw new Error(`Project full name (${fullName}) can not be longer than 255 characters.`);
+    }
+}
+/**
+ * Attempt to derive a valid slug name from the one passed in
+ */
+function validSlugName(slug) {
+    const chars = slug.split('');
+    const validChars = chars.filter(char => (0, experienceParser_1.isValidSlugStrict)(char));
+    return validChars.join('');
+}

package/build/commandUtils/usageUtils.d.ts

@@ -0,0 +1,58 @@
+import { AppPlatform, EasBuildBillingResourceClass } from '../graphql/generated';
+import { AccountFullUsageData } from '../graphql/queries/AccountQuery';
+export interface UsageMetricDisplay {
+    name: string;
+    planValue: number;
+    limit: number;
+    percentUsed: number;
+    overageValue: number;
+    overageCost: number;
+    unit?: string;
+}
+export interface BuildOverageByWorkerSize {
+    platform: AppPlatform;
+    resourceClass: EasBuildBillingResourceClass;
+    count: number;
+    costCents: number;
+}
+export interface BuildCountByPlatformAndSize {
+    platform: 'ios' | 'android';
+    resourceClass: 'medium' | 'large';
+    count: number;
+}
+export interface UsageDisplayData {
+    accountName: string;
+    subscriptionPlan: string;
+    billingPeriod: {
+        start: string;
+        end: string;
+    };
+    builds: {
+        total: UsageMetricDisplay;
+        ios?: UsageMetricDisplay;
+        android?: UsageMetricDisplay;
+        countsByPlatformAndSize: BuildCountByPlatformAndSize[];
+        overagesByWorkerSize: BuildOverageByWorkerSize[];
+        overageCostCents: number;
+    };
+    updates: {
+        mau: UsageMetricDisplay;
+        bandwidth: UsageMetricDisplay;
+        overageCostCents: number;
+    };
+    totalOverageCostCents: number;
+    estimatedBillCents: number;
+    recurringCents: number | null;
+}
+export declare function formatDate(dateString: string): string;
+export declare function formatCurrency(cents: number): string;
+export declare function formatNumber(value: number, decimals?: number): string;
+export declare function calculateDaysRemaining(endDate: string): number;
+export declare function calculateDaysElapsed(startDate: string): number;
+export declare function calculateBillingPeriodDays(startDate: string, endDate: string): number;
+export declare function extractUsageData(data: AccountFullUsageData): UsageDisplayData;
+export declare function calculateBillingPeriodInfo(data: UsageDisplayData): {
+    daysRemaining: number;
+    daysElapsed: number;
+    totalDays: number;
+};

package/build/commandUtils/usageUtils.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDate = formatDate;
+exports.formatCurrency = formatCurrency;
+exports.formatNumber = formatNumber;
+exports.calculateDaysRemaining = calculateDaysRemaining;
+exports.calculateDaysElapsed = calculateDaysElapsed;
+exports.calculateBillingPeriodDays = calculateBillingPeriodDays;
+exports.extractUsageData = extractUsageData;
+exports.calculateBillingPeriodInfo = calculateBillingPeriodInfo;
+const generated_1 = require("../graphql/generated");
+const checkForOverages_1 = require("../utils/usage/checkForOverages");
+function formatDate(dateString) {
+    const date = new Date(dateString);
+    return date.toLocaleDateString('en-US', {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+    });
+}
+function formatCurrency(cents) {
+    return `$${(cents / 100).toFixed(2)}`;
+}
+function formatNumber(value, decimals = 0) {
+    if (decimals === 0) {
+        return Math.round(value).toLocaleString();
+    }
+    return value.toLocaleString(undefined, {
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+    });
+}
+function calculateDaysRemaining(endDate) {
+    const end = new Date(endDate);
+    const now = new Date();
+    const diffTime = end.getTime() - now.getTime();
+    return Math.max(0, Math.ceil(diffTime / (1000 * 60 * 60 * 24)));
+}
+function calculateDaysElapsed(startDate) {
+    const start = new Date(startDate);
+    const now = new Date();
+    const diffTime = now.getTime() - start.getTime();
+    return Math.max(1, Math.ceil(diffTime / (1000 * 60 * 60 * 24)));
+}
+function calculateBillingPeriodDays(startDate, endDate) {
+    const start = new Date(startDate);
+    const end = new Date(endDate);
+    const diffTime = end.getTime() - start.getTime();
+    return Math.max(1, Math.ceil(diffTime / (1000 * 60 * 60 * 24)));
+}
+function extractUsageData(data) {
+    const { name, subscription, billingPeriod, usageMetrics } = data;
+    const { EAS_BUILD, EAS_UPDATE, MEDIUM_ANDROID_BUILDS, LARGE_ANDROID_BUILDS, MEDIUM_IOS_BUILDS, LARGE_IOS_BUILDS, } = usageMetrics;
+    // Find build metrics
+    const buildMetric = EAS_BUILD.planMetrics.find(m => m.serviceMetric === generated_1.EasServiceMetric.Builds && m.metricType === generated_1.UsageMetricType.Build);
+    // Extract build counts by platform and worker size
+    const countsByPlatformAndSize = [];
+    const mediumAndroidCount = MEDIUM_ANDROID_BUILDS?.[0]?.value ?? 0;
+    const largeAndroidCount = LARGE_ANDROID_BUILDS?.[0]?.value ?? 0;
+    const mediumIosCount = MEDIUM_IOS_BUILDS?.[0]?.value ?? 0;
+    const largeIosCount = LARGE_IOS_BUILDS?.[0]?.value ?? 0;
+    if (mediumAndroidCount > 0) {
+        countsByPlatformAndSize.push({
+            platform: 'android',
+            resourceClass: 'medium',
+            count: mediumAndroidCount,
+        });
+    }
+    if (largeAndroidCount > 0) {
+        countsByPlatformAndSize.push({
+            platform: 'android',
+            resourceClass: 'large',
+            count: largeAndroidCount,
+        });
+    }
+    if (mediumIosCount > 0) {
+        countsByPlatformAndSize.push({
+            platform: 'ios',
+            resourceClass: 'medium',
+            count: mediumIosCount,
+        });
+    }
+    if (largeIosCount > 0) {
+        countsByPlatformAndSize.push({ platform: 'ios', resourceClass: 'large', count: largeIosCount });
+    }
+    // Extract build overages by worker size from overage metrics with metadata
+    const overagesByWorkerSize = [];
+    for (const overage of EAS_BUILD.overageMetrics) {
+        if (overage.serviceMetric === generated_1.EasServiceMetric.Builds &&
+            overage.metadata?.billingResourceClass &&
+            overage.metadata?.platform) {
+            overagesByWorkerSize.push({
+                platform: overage.metadata.platform,
+                resourceClass: overage.metadata.billingResourceClass,
+                count: overage.value,
+                costCents: overage.totalCost,
+            });
+        }
+    }
+    // Find update metrics
+    const mauMetric = EAS_UPDATE.planMetrics.find(m => m.serviceMetric === generated_1.EasServiceMetric.UniqueUpdaters && m.metricType === generated_1.UsageMetricType.Update);
+    const bandwidthMetric = EAS_UPDATE.planMetrics.find(m => m.serviceMetric === generated_1.EasServiceMetric.BandwidthUsage &&
+        m.metricType === generated_1.UsageMetricType.Bandwidth);
+    const mauOverage = EAS_UPDATE.overageMetrics.find(m => m.serviceMetric === generated_1.EasServiceMetric.UniqueUpdaters && m.metricType === generated_1.UsageMetricType.Update);
+    const bandwidthOverage = EAS_UPDATE.overageMetrics.find(m => m.serviceMetric === generated_1.EasServiceMetric.BandwidthUsage &&
+        m.metricType === generated_1.UsageMetricType.Bandwidth);
+    // Build metrics - plan values from planMetrics, overage from overageMetrics
+    const buildPlanValue = buildMetric?.value ?? 0;
+    const buildLimit = buildMetric?.limit ?? 0;
+    const iosBuildPlanValue = buildMetric?.platformBreakdown?.ios.value ?? 0;
+    const iosBuildLimit = buildMetric?.platformBreakdown?.ios.limit ?? 0;
+    const androidBuildPlanValue = buildMetric?.platformBreakdown?.android.value ?? 0;
+    const androidBuildLimit = buildMetric?.platformBreakdown?.android.limit ?? 0;
+    // Update metrics - plan values from planMetrics, overage from overageMetrics
+    const mauPlanValue = mauMetric?.value ?? 0;
+    const mauOverageValue = mauOverage?.value ?? 0;
+    const mauLimit = mauMetric?.limit ?? 0;
+    const bandwidthPlanValue = bandwidthMetric?.value ?? 0;
+    const bandwidthOverageValue = bandwidthOverage?.value ?? 0;
+    const bandwidthLimit = bandwidthMetric?.limit ?? 0;
+    const buildOverageCostCents = EAS_BUILD.totalCost;
+    const updateOverageCostCents = EAS_UPDATE.totalCost;
+    const totalOverageCostCents = buildOverageCostCents + updateOverageCostCents;
+    // Calculate total overage count for display
+    const totalOverageBuilds = overagesByWorkerSize.reduce((sum, o) => sum + o.count, 0);
+    return {
+        accountName: name,
+        subscriptionPlan: subscription?.name ?? 'Free',
+        billingPeriod: {
+            start: billingPeriod.start,
+            end: billingPeriod.end,
+        },
+        builds: {
+            total: {
+                name: 'Builds',
+                planValue: buildPlanValue,
+                limit: buildLimit,
+                percentUsed: (0, checkForOverages_1.calculatePercentUsed)(buildPlanValue, buildLimit),
+                overageValue: totalOverageBuilds,
+                overageCost: buildOverageCostCents,
+                unit: 'builds',
+            },
+            ios: buildMetric?.platformBreakdown
+                ? {
+                    name: 'iOS Builds',
+                    planValue: iosBuildPlanValue,
+                    limit: iosBuildLimit,
+                    percentUsed: (0, checkForOverages_1.calculatePercentUsed)(iosBuildPlanValue, iosBuildLimit),
+                    overageValue: 0,
+                    overageCost: 0,
+                    unit: 'builds',
+                }
+                : undefined,
+            android: buildMetric?.platformBreakdown
+                ? {
+                    name: 'Android Builds',
+                    planValue: androidBuildPlanValue,
+                    limit: androidBuildLimit,
+                    percentUsed: (0, checkForOverages_1.calculatePercentUsed)(androidBuildPlanValue, androidBuildLimit),
+                    overageValue: 0,
+                    overageCost: 0,
+                    unit: 'builds',
+                }
+                : undefined,
+            countsByPlatformAndSize,
+            overagesByWorkerSize,
+            overageCostCents: buildOverageCostCents,
+        },
+        updates: {
+            mau: {
+                name: 'Unique Updaters',
+                planValue: mauPlanValue,
+                limit: mauLimit,
+                percentUsed: (0, checkForOverages_1.calculatePercentUsed)(mauPlanValue, mauLimit),
+                overageValue: mauOverageValue,
+                overageCost: mauOverage?.totalCost ?? 0,
+                unit: 'users',
+            },
+            bandwidth: {
+                name: 'Bandwidth',
+                planValue: bandwidthPlanValue,
+                limit: bandwidthLimit,
+                percentUsed: (0, checkForOverages_1.calculatePercentUsed)(bandwidthPlanValue, bandwidthLimit),
+                overageValue: bandwidthOverageValue,
+                overageCost: bandwidthOverage?.totalCost ?? 0,
+                unit: 'bytes',
+            },
+            overageCostCents: updateOverageCostCents,
+        },
+        totalOverageCostCents,
+        estimatedBillCents: (subscription?.recurringCents ?? 0) + totalOverageCostCents,
+        recurringCents: subscription?.recurringCents ?? null,
+    };
+}
+function calculateBillingPeriodInfo(data) {
+    const daysElapsed = calculateDaysElapsed(data.billingPeriod.start);
+    const totalDays = calculateBillingPeriodDays(data.billingPeriod.start, data.billingPeriod.end);
+    const daysRemaining = calculateDaysRemaining(data.billingPeriod.end);
+    return {
+        daysRemaining,
+        daysElapsed,
+        totalDays,
+    };
+}

package/build/commandUtils/workflow/buildProfileUtils.d.ts

@@ -0,0 +1,36 @@
+import { ExpoConfig } from '@expo/config';
+import { BuildProfile, Platform } from '@expo/eas-json';
+import { AndroidBuildProfile, IosBuildProfile } from '@expo/eas-json/build/build/types';
+export declare function buildProfileNamesFromProjectAsync(projectDir: string): Promise<Set<string>>;
+export declare function getBuildProfileAsync(projectDir: string, platform: Platform, profileName: string): Promise<BuildProfile<Platform>>;
+export declare function buildProfilesFromProjectAsync(projectDir: string): Promise<Map<string, {
+    android: AndroidBuildProfile;
+    ios: IosBuildProfile;
+}>>;
+export declare function isBuildProfileForDevelopment(buildProfile: BuildProfile<Platform>, platform: Platform): boolean;
+export declare function isIosBuildProfileForSimulator(buildProfile: BuildProfile<Platform.IOS>): boolean;
+export declare function addAndroidDevelopmentBuildProfileToEasJsonAsync(projectDir: string, buildProfileName: string): Promise<void>;
+export declare function addIosDevelopmentBuildProfileToEasJsonAsync(projectDir: string, buildProfileName: string, simulator: boolean): Promise<void>;
+export declare function addProductionBuildProfileToEasJsonIfNeededAsync(projectDir: string): Promise<boolean>;
+export declare function hasBuildConfigureBeenRunAsync({ projectDir, expoConfig, }: {
+    projectDir: string;
+    expoConfig: ExpoConfig;
+}): Promise<boolean>;
+export declare function hasUpdateConfigureBeenRunAsync({ projectDir, expoConfig, }: {
+    projectDir: string;
+    expoConfig: ExpoConfig;
+}): Promise<boolean>;
+/**
+ * Runs update:configure if needed. Returns a boolean (proceed with workflow creation, or not)
+ */
+export declare function runUpdateConfigureIfNeededAsync({ projectDir, expoConfig, }: {
+    projectDir: string;
+    expoConfig: ExpoConfig;
+}): Promise<boolean>;
+/**
+ * Runs build:configure if needed. Returns a boolean (proceed with workflow creation, or not)
+ */
+export declare function runBuildConfigureIfNeededAsync({ projectDir, expoConfig, }: {
+    projectDir: string;
+    expoConfig: ExpoConfig;
+}): Promise<boolean>;