From 79759d37e0b2a8cff56e11d6ef31c82f48b2a945 Mon Sep 17 00:00:00 2001 From: Alessia Bellisario Date: Mon, 16 Oct 2023 13:46:32 -0400 Subject: [PATCH] chore: run codegen, update graphqlTypes.ts --- src/language-server/graphqlTypes.ts | 10127 ++++++++++++++++++++++---- 1 file changed, 8862 insertions(+), 1265 deletions(-) diff --git a/src/language-server/graphqlTypes.ts b/src/language-server/graphqlTypes.ts index 17dff663..bf2c5cdd 100644 --- a/src/language-server/graphqlTypes.ts +++ b/src/language-server/graphqlTypes.ts @@ -9,22 +9,46 @@ export type Scalars = { Boolean: boolean; Int: number; Float: number; + BigInt: any; /** A blob (base64'ed in JSON & GraphQL) */ Blob: any; + /** ISO 8601 date format, e.g. 'yyyy-MM-dd' */ + Date: any; + /** + * Implement the DateTime scalar + * + * The input/output is a string in RFC3339 format. + */ + DateTime: any; + /** Federation type representing set of fields */ + FieldSet: any; + /** A GraphQL document, such as the definition of an operation or schema. */ GraphQLDocument: any; + JSON: any; + /** A scalar that can represent any JSON Object value. */ + JSONObject: any; /** Long type */ Long: any; - /** Arbitrary JSON object */ + /** + * ISO 8601 combined date and time without timezone. + * + * # Examples + * + * * `2015-07-01T08:59:60.123`, + */ + NaiveDateTime: any; + /** An arbitrary JSON object. */ Object: any; - /** A lowercase hexadecimal SHA-256 */ + /** A SHA-256 hash, represented as a lowercase hexadecimal string. */ SHA256: any; StringOrInt: any; - /** ISO 8601, extended format with nanoseconds, Zulu (or '[+-]seconds' for times relative to now) */ + /** ISO 8601, extended format with nanoseconds, Zulu (or "[+-]seconds" as a string or number relative to now) */ Timestamp: any; /** Always null */ Void: any; }; +/** An organization in Apollo Studio. Can have multiple members and graphs. */ export type Account = { __typename?: 'Account'; auditLogExports: Maybe>; @@ -45,15 +69,28 @@ export type Account = { * but this will not happen for third-party media servers. */ avatarUrl: Maybe; + billingContactEmail: Maybe; billingInfo: Maybe; + billingInsights: BillingInsights; + /** Fetch a CloudOnboarding associated with this account */ + cloudOnboarding: Maybe; companyUrl: Maybe; + /** The time at which the account was created */ + createdAt: Maybe; currentBillingMonth: Maybe; currentPlan: BillingPlan; currentSubscription: Maybe; - experimentalFeatures: AccountExperimentalFeatures; + eligibleForUsageBasedPlan: Scalars['Boolean']; + expiredTrialDismissedAt: Maybe; expiredTrialSubscription: Maybe; graphIDAvailable: Scalars['Boolean']; + /** Graphs belonging to this organization. */ + graphs: Array; + /** Graphs belonging to this organization. */ + graphsConnection: Maybe; hasBeenOnTrial: Scalars['Boolean']; + hasBillingInfo: Maybe; + /** Globally unique identifier, which isn't guaranteed stable (can be changed by administrators). */ id: Scalars['ID']; /** * Internal immutable identifier for the account. Only visible to Apollo admins (because it really @@ -61,57 +98,129 @@ export type Account = { */ internalID: Scalars['ID']; invitations: Maybe>; - invoices: Maybe>; + invoices: Array; + isLocked: Maybe; isOnExpiredTrial: Scalars['Boolean']; isOnTrial: Scalars['Boolean']; + lockDetails: Maybe; memberships: Maybe>; + /** Name of the organization, which can change over time and isn't unique. */ name: Scalars['String']; + /** + * Fetches usage based pricing operations counts for the calling user. If a particular window is not specified, + * totals for the user's current billing period are returned. (Will error if the user is not currently on a usage + * based plan.) + */ + operationUsage: AccountOperationUsage; + /** List the private subgraphs associated with your Apollo account */ + privateSubgraphs: Array; + /** @deprecated use Account.createdAt instead */ provisionedAt: Maybe; - recurlyEmail: Maybe; /** Returns a different registry related stats pertaining to this account. */ registryStatsWindow: Maybe; requests: Maybe; requestsInCurrentBillingPeriod: Maybe; roles: Maybe; + routerEntitlement: Maybe; /** How many seats would be included in your next bill, as best estimated today */ seatCountForNextBill: Maybe; seats: Maybe; secondaryIDs: Array; + /** + * Graphs belonging to this organization. + * @deprecated Use graphs field instead + */ services: Array; /** * If non-null, this organization tracks its members through an upstream, eg PingOne; * invitations are not possible on SSO-synchronized account. */ sso: Maybe; + /** @deprecated no longer relevant; it's only ever populated for enterprise accounts */ state: Maybe; /** A list of reusable invitations for the organization. */ staticInvitations: Maybe>; /** @deprecated use Account.statsWindow instead */ stats: AccountStatsWindow; statsWindow: Maybe; - subscriptions: Maybe>; + subscriptions: Array; + survey: Maybe; /** Gets a ticket for this org, by id */ ticket: Maybe; /** List of Zendesk tickets submitted for this org */ tickets: Maybe>; + /** + * All Variants within the Graphs belonging to this organization. Can be limited to those favorited by the current user. + * @deprecated use Service.variants instead + */ + variants: Maybe; + vitallyTraits: Maybe; }; +/** An organization in Apollo Studio. Can have multiple members and graphs. */ export type AccountAvatarUrlArgs = { size?: Scalars['Int']; }; +/** An organization in Apollo Studio. Can have multiple members and graphs. */ +export type AccountBillingInsightsArgs = { + from: Scalars['Date']; + limit: Maybe; + to: Maybe; + windowSize: Maybe; +}; + + +/** An organization in Apollo Studio. Can have multiple members and graphs. */ +export type AccountCloudOnboardingArgs = { + graphRef: Scalars['String']; +}; + + +/** An organization in Apollo Studio. Can have multiple members and graphs. */ export type AccountGraphIdAvailableArgs = { id: Scalars['ID']; }; +/** An organization in Apollo Studio. Can have multiple members and graphs. */ +export type AccountGraphsArgs = { + filterBy: Maybe; + includeDeleted: Maybe; +}; + + +/** An organization in Apollo Studio. Can have multiple members and graphs. */ +export type AccountGraphsConnectionArgs = { + after: Maybe; + before: Maybe; + filterBy: Maybe; + first: Maybe; + last: Maybe; +}; + + +/** An organization in Apollo Studio. Can have multiple members and graphs. */ export type AccountInvitationsArgs = { includeAccepted?: Scalars['Boolean']; }; +/** An organization in Apollo Studio. Can have multiple members and graphs. */ +export type AccountOperationUsageArgs = { + forWindow: Maybe; +}; + + +/** An organization in Apollo Studio. Can have multiple members and graphs. */ +export type AccountPrivateSubgraphsArgs = { + cloudProvider: CloudProvider; +}; + + +/** An organization in Apollo Studio. Can have multiple members and graphs. */ export type AccountRegistryStatsWindowArgs = { from: Scalars['Timestamp']; resolution: Maybe; @@ -119,17 +228,20 @@ export type AccountRegistryStatsWindowArgs = { }; +/** An organization in Apollo Studio. Can have multiple members and graphs. */ export type AccountRequestsArgs = { from: Scalars['Timestamp']; to: Scalars['Timestamp']; }; +/** An organization in Apollo Studio. Can have multiple members and graphs. */ export type AccountServicesArgs = { includeDeleted: Maybe; }; +/** An organization in Apollo Studio. Can have multiple members and graphs. */ export type AccountStatsArgs = { from: Scalars['Timestamp']; resolution: Maybe; @@ -137,6 +249,7 @@ export type AccountStatsArgs = { }; +/** An organization in Apollo Studio. Can have multiple members and graphs. */ export type AccountStatsWindowArgs = { from: Scalars['Timestamp']; resolution: Maybe; @@ -144,10 +257,107 @@ export type AccountStatsWindowArgs = { }; +/** An organization in Apollo Studio. Can have multiple members and graphs. */ +export type AccountSurveyArgs = { + id: Scalars['String']; +}; + + +/** An organization in Apollo Studio. Can have multiple members and graphs. */ export type AccountTicketArgs = { id: Scalars['ID']; }; + +/** An organization in Apollo Studio. Can have multiple members and graphs. */ +export type AccountVariantsArgs = { + filterBy?: Maybe; +}; + +/** Columns of AccountBillingUsageStats. */ +export enum AccountBillingUsageStatsColumn { + AgentVersion = 'AGENT_VERSION', + GraphDeploymentType = 'GRAPH_DEPLOYMENT_TYPE', + OperationCount = 'OPERATION_COUNT', + OperationCountProvidedExplicitly = 'OPERATION_COUNT_PROVIDED_EXPLICITLY', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', + SchemaTag = 'SCHEMA_TAG', + ServiceId = 'SERVICE_ID', + Timestamp = 'TIMESTAMP' +} + +export type AccountBillingUsageStatsDimensions = { + __typename?: 'AccountBillingUsageStatsDimensions'; + agentVersion: Maybe; + graphDeploymentType: Maybe; + operationCountProvidedExplicitly: Maybe; + operationSubtype: Maybe; + operationType: Maybe; + schemaTag: Maybe; + serviceId: Maybe; +}; + +/** Filter for data in AccountBillingUsageStats. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ +export type AccountBillingUsageStatsFilter = { + /** Selects rows whose agentVersion dimension equals the given value if not null. To query for the null value, use {in: {agentVersion: [null]}} instead. */ + agentVersion: Maybe; + and: Maybe>; + /** Selects rows whose graphDeploymentType dimension equals the given value if not null. To query for the null value, use {in: {graphDeploymentType: [null]}} instead. */ + graphDeploymentType: Maybe; + in: Maybe; + not: Maybe; + /** Selects rows whose operationCountProvidedExplicitly dimension equals the given value if not null. To query for the null value, use {in: {operationCountProvidedExplicitly: [null]}} instead. */ + operationCountProvidedExplicitly: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; + or: Maybe>; + /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ + schemaTag: Maybe; + /** Selects rows whose serviceId dimension equals the given value if not null. To query for the null value, use {in: {serviceId: [null]}} instead. */ + serviceId: Maybe; +}; + +/** Filter for data in AccountBillingUsageStats. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ +export type AccountBillingUsageStatsFilterIn = { + /** Selects rows whose agentVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ + agentVersion: Maybe>>; + /** Selects rows whose graphDeploymentType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + graphDeploymentType: Maybe>>; + /** Selects rows whose operationCountProvidedExplicitly dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationCountProvidedExplicitly: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; + /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ + schemaTag: Maybe>>; + /** Selects rows whose serviceId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + serviceId: Maybe>>; +}; + +export type AccountBillingUsageStatsMetrics = { + __typename?: 'AccountBillingUsageStatsMetrics'; + operationCount: Scalars['Long']; +}; + +export type AccountBillingUsageStatsOrderBySpec = { + column: AccountBillingUsageStatsColumn; + direction: Ordering; +}; + +export type AccountBillingUsageStatsRecord = { + __typename?: 'AccountBillingUsageStatsRecord'; + /** Dimensions of AccountBillingUsageStats that can be grouped by. */ + groupBy: AccountBillingUsageStatsDimensions; + /** Metrics of AccountBillingUsageStats that can be aggregated over. */ + metrics: AccountBillingUsageStatsMetrics; + /** Starting segment timestamp. */ + timestamp: Scalars['Timestamp']; +}; + export type AccountChecksStatsMetrics = { __typename?: 'AccountChecksStatsMetrics'; totalFailedChecks: Scalars['Long']; @@ -161,6 +371,31 @@ export type AccountChecksStatsRecord = { timestamp: Scalars['Timestamp']; }; +export type AccountCustomerTraits = { + __typename?: 'AccountCustomerTraits'; + accountOwner: Maybe; + adminLink: Maybe; + federationInProd: Maybe; + product: Maybe; + requestsLast30Days: Maybe; + sfdcId: Maybe; + sso: Maybe; + tier: Maybe; + totalGraphs: Maybe; + totalRequests: Maybe; + totalSubgraphs: Maybe; + totalVariants: Maybe; + usersCount: Maybe; + usingClassicGraphs: Maybe; + usingCloudGraphs: Maybe; + usingExplorer: Maybe; + usingFederation: Maybe; + usingFederation2: Maybe; + usingRover: Maybe; + usingSchemaChecks: Maybe; + usingVariants: Maybe; +}; + /** Columns of AccountEdgeServerInfos. */ export enum AccountEdgeServerInfosColumn { BootId = 'BOOT_ID', @@ -341,21 +576,82 @@ export type AccountErrorStatsRecord = { timestamp: Scalars['Timestamp']; }; -export type AccountExperimentalFeatures = { - __typename?: 'AccountExperimentalFeatures'; - auditLogs: Scalars['Boolean']; - championDashboard: Scalars['Boolean']; - contractsPreview: Scalars['Boolean']; - federation2Preview: Scalars['Boolean']; - preRequestPreview: Scalars['Boolean']; - publicVariants: Scalars['Boolean']; - variantHomepage: Scalars['Boolean']; - webhooksPreview: Scalars['Boolean']; +/** Columns of AccountFieldExecutions. */ +export enum AccountFieldExecutionsColumn { + ErrorsCount = 'ERRORS_COUNT', + EstimatedExecutionCount = 'ESTIMATED_EXECUTION_COUNT', + FieldName = 'FIELD_NAME', + ObservedExecutionCount = 'OBSERVED_EXECUTION_COUNT', + ParentType = 'PARENT_TYPE', + ReferencingOperationCount = 'REFERENCING_OPERATION_COUNT', + RequestsWithErrorsCount = 'REQUESTS_WITH_ERRORS_COUNT', + SchemaTag = 'SCHEMA_TAG', + ServiceId = 'SERVICE_ID', + Timestamp = 'TIMESTAMP' +} + +export type AccountFieldExecutionsDimensions = { + __typename?: 'AccountFieldExecutionsDimensions'; + fieldName: Maybe; + parentType: Maybe; + schemaTag: Maybe; + serviceId: Maybe; +}; + +/** Filter for data in AccountFieldExecutions. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ +export type AccountFieldExecutionsFilter = { + and: Maybe>; + /** Selects rows whose fieldName dimension equals the given value if not null. To query for the null value, use {in: {fieldName: [null]}} instead. */ + fieldName: Maybe; + in: Maybe; + not: Maybe; + or: Maybe>; + /** Selects rows whose parentType dimension equals the given value if not null. To query for the null value, use {in: {parentType: [null]}} instead. */ + parentType: Maybe; + /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ + schemaTag: Maybe; + /** Selects rows whose serviceId dimension equals the given value if not null. To query for the null value, use {in: {serviceId: [null]}} instead. */ + serviceId: Maybe; +}; + +/** Filter for data in AccountFieldExecutions. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ +export type AccountFieldExecutionsFilterIn = { + /** Selects rows whose fieldName dimension is in the given list. A null value in the list means a row with null for that dimension. */ + fieldName: Maybe>>; + /** Selects rows whose parentType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + parentType: Maybe>>; + /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ + schemaTag: Maybe>>; + /** Selects rows whose serviceId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + serviceId: Maybe>>; +}; + +export type AccountFieldExecutionsMetrics = { + __typename?: 'AccountFieldExecutionsMetrics'; + errorsCount: Scalars['Long']; + estimatedExecutionCount: Scalars['Long']; + observedExecutionCount: Scalars['Long']; + referencingOperationCount: Scalars['Long']; + requestsWithErrorsCount: Scalars['Long']; +}; + +export type AccountFieldExecutionsOrderBySpec = { + column: AccountFieldExecutionsColumn; + direction: Ordering; +}; + +export type AccountFieldExecutionsRecord = { + __typename?: 'AccountFieldExecutionsRecord'; + /** Dimensions of AccountFieldExecutions that can be grouped by. */ + groupBy: AccountFieldExecutionsDimensions; + /** Metrics of AccountFieldExecutions that can be aggregated over. */ + metrics: AccountFieldExecutionsMetrics; + /** Starting segment timestamp. */ + timestamp: Scalars['Timestamp']; }; /** Columns of AccountFieldLatencies. */ export enum AccountFieldLatenciesColumn { - Field = 'FIELD', FieldHistogram = 'FIELD_HISTOGRAM', FieldName = 'FIELD_NAME', ParentType = 'PARENT_TYPE', @@ -378,8 +674,6 @@ export type AccountFieldLatenciesDimensions = { /** Filter for data in AccountFieldLatencies. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ export type AccountFieldLatenciesFilter = { and: Maybe>; - /** Selects rows whose field dimension equals the given value if not null. To query for the null value, use {in: {field: [null]}} instead. */ - field: Maybe; /** Selects rows whose fieldName dimension equals the given value if not null. To query for the null value, use {in: {fieldName: [null]}} instead. */ fieldName: Maybe; in: Maybe; @@ -397,8 +691,6 @@ export type AccountFieldLatenciesFilter = { /** Filter for data in AccountFieldLatencies. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ export type AccountFieldLatenciesFilterIn = { - /** Selects rows whose field dimension is in the given list. A null value in the list means a row with null for that dimension. */ - field: Maybe>>; /** Selects rows whose fieldName dimension is in the given list. A null value in the list means a row with null for that dimension. */ fieldName: Maybe>>; /** Selects rows whose parentType dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -435,9 +727,11 @@ export type AccountFieldLatenciesRecord = { export enum AccountFieldUsageColumn { ClientName = 'CLIENT_NAME', ClientVersion = 'CLIENT_VERSION', + EstimatedExecutionCount = 'ESTIMATED_EXECUTION_COUNT', ExecutionCount = 'EXECUTION_COUNT', - Field = 'FIELD', FieldName = 'FIELD_NAME', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', ParentType = 'PARENT_TYPE', QueryId = 'QUERY_ID', QueryName = 'QUERY_NAME', @@ -452,8 +746,9 @@ export type AccountFieldUsageDimensions = { __typename?: 'AccountFieldUsageDimensions'; clientName: Maybe; clientVersion: Maybe; - field: Maybe; fieldName: Maybe; + operationSubtype: Maybe; + operationType: Maybe; parentType: Maybe; queryId: Maybe; queryName: Maybe; @@ -469,12 +764,14 @@ export type AccountFieldUsageFilter = { clientName: Maybe; /** Selects rows whose clientVersion dimension equals the given value if not null. To query for the null value, use {in: {clientVersion: [null]}} instead. */ clientVersion: Maybe; - /** Selects rows whose field dimension equals the given value if not null. To query for the null value, use {in: {field: [null]}} instead. */ - field: Maybe; /** Selects rows whose fieldName dimension equals the given value if not null. To query for the null value, use {in: {fieldName: [null]}} instead. */ fieldName: Maybe; in: Maybe; not: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; or: Maybe>; /** Selects rows whose parentType dimension equals the given value if not null. To query for the null value, use {in: {parentType: [null]}} instead. */ parentType: Maybe; @@ -496,10 +793,12 @@ export type AccountFieldUsageFilterIn = { clientName: Maybe>>; /** Selects rows whose clientVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ clientVersion: Maybe>>; - /** Selects rows whose field dimension is in the given list. A null value in the list means a row with null for that dimension. */ - field: Maybe>>; /** Selects rows whose fieldName dimension is in the given list. A null value in the list means a row with null for that dimension. */ fieldName: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; /** Selects rows whose parentType dimension is in the given list. A null value in the list means a row with null for that dimension. */ parentType: Maybe>>; /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -516,6 +815,7 @@ export type AccountFieldUsageFilterIn = { export type AccountFieldUsageMetrics = { __typename?: 'AccountFieldUsageMetrics'; + estimatedExecutionCount: Scalars['Long']; executionCount: Scalars['Long']; referencingOperationCount: Scalars['Long']; }; @@ -535,6 +835,122 @@ export type AccountFieldUsageRecord = { timestamp: Scalars['Timestamp']; }; +/** A list of graphs that belong to an account. */ +export type AccountGraphConnection = { + __typename?: 'AccountGraphConnection'; + /** A list of edges from the account to its graphs. */ + edges: Maybe>; + /** A list of graphs attached to the account. */ + nodes: Maybe>; + /** Information to aid in pagination. */ + pageInfo: PageInfo; +}; + +/** An edge between an account and a graph. */ +export type AccountGraphEdge = { + __typename?: 'AccountGraphEdge'; + /** A cursor for use in pagination. */ + cursor: Scalars['String']; + /** A graph attached to the account. */ + node: Maybe; +}; + +/** A list of all variants from all graphs attached to the account. */ +export type AccountGraphVariantConnection = { + __typename?: 'AccountGraphVariantConnection'; + /** A list of edges from the account to its variants. */ + edges: Maybe>; + /** A list of all variants from all graphs attached to the account. */ + nodes: Maybe>; + /** Information to aid in pagination. */ + pageInfo: PageInfo; +}; + +/** An edge between an account and a graph variant. */ +export type AccountGraphVariantEdge = { + __typename?: 'AccountGraphVariantEdge'; + /** A cursor for use in pagination. */ + cursor: Scalars['String']; + /** A variant from a graph attached to the account. */ + node: Maybe; +}; + +/** Columns of AccountGraphosCloudMetrics. */ +export enum AccountGraphosCloudMetricsColumn { + AgentVersion = 'AGENT_VERSION', + ResponseSize = 'RESPONSE_SIZE', + ResponseSizeThrottled = 'RESPONSE_SIZE_THROTTLED', + RouterId = 'ROUTER_ID', + RouterOperations = 'ROUTER_OPERATIONS', + RouterOperationsThrottled = 'ROUTER_OPERATIONS_THROTTLED', + SchemaTag = 'SCHEMA_TAG', + ServiceId = 'SERVICE_ID', + SubgraphFetches = 'SUBGRAPH_FETCHES', + SubgraphFetchesThrottled = 'SUBGRAPH_FETCHES_THROTTLED', + Timestamp = 'TIMESTAMP' +} + +export type AccountGraphosCloudMetricsDimensions = { + __typename?: 'AccountGraphosCloudMetricsDimensions'; + agentVersion: Maybe; + routerId: Maybe; + schemaTag: Maybe; + serviceId: Maybe; +}; + +/** Filter for data in AccountGraphosCloudMetrics. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ +export type AccountGraphosCloudMetricsFilter = { + /** Selects rows whose agentVersion dimension equals the given value if not null. To query for the null value, use {in: {agentVersion: [null]}} instead. */ + agentVersion: Maybe; + and: Maybe>; + in: Maybe; + not: Maybe; + or: Maybe>; + /** Selects rows whose routerId dimension equals the given value if not null. To query for the null value, use {in: {routerId: [null]}} instead. */ + routerId: Maybe; + /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ + schemaTag: Maybe; + /** Selects rows whose serviceId dimension equals the given value if not null. To query for the null value, use {in: {serviceId: [null]}} instead. */ + serviceId: Maybe; +}; + +/** Filter for data in AccountGraphosCloudMetrics. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ +export type AccountGraphosCloudMetricsFilterIn = { + /** Selects rows whose agentVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ + agentVersion: Maybe>>; + /** Selects rows whose routerId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + routerId: Maybe>>; + /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ + schemaTag: Maybe>>; + /** Selects rows whose serviceId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + serviceId: Maybe>>; +}; + +export type AccountGraphosCloudMetricsMetrics = { + __typename?: 'AccountGraphosCloudMetricsMetrics'; + responseSize: Scalars['Long']; + responseSizeThrottled: Scalars['Long']; + routerOperations: Scalars['Long']; + routerOperationsThrottled: Scalars['Long']; + subgraphFetches: Scalars['Long']; + subgraphFetchesThrottled: Scalars['Long']; +}; + +export type AccountGraphosCloudMetricsOrderBySpec = { + column: AccountGraphosCloudMetricsColumn; + direction: Ordering; +}; + +export type AccountGraphosCloudMetricsRecord = { + __typename?: 'AccountGraphosCloudMetricsRecord'; + /** Dimensions of AccountGraphosCloudMetrics that can be grouped by. */ + groupBy: AccountGraphosCloudMetricsDimensions; + /** Metrics of AccountGraphosCloudMetrics that can be aggregated over. */ + metrics: AccountGraphosCloudMetricsMetrics; + /** Starting segment timestamp. */ + timestamp: Scalars['Timestamp']; +}; + export type AccountInvitation = { __typename?: 'AccountInvitation'; /** An accepted invitation cannot be used anymore */ @@ -553,6 +969,19 @@ export type AccountInvitation = { role: UserPermission; }; +export type AccountLockDetails = { + __typename?: 'AccountLockDetails'; + actor: Maybe; + reason: Maybe; + timestamp: Maybe; + type: Maybe; +}; + +export enum AccountLockType { + AutomatedTrialEnd = 'AUTOMATED_TRIAL_END', + Manual = 'MANUAL' +} + export type AccountMembership = { __typename?: 'AccountMembership'; account: Account; @@ -566,47 +995,62 @@ export type AccountMembership = { export type AccountMutation = { __typename?: 'AccountMutation'; auditExport: Maybe; - /** Cancel a pending change from an annual team subscription to a monthly team subscription when the current period expires. */ - cancelConvertAnnualTeamSubscriptionToMonthlyAtNextPeriod: Maybe; - /** Cancel account subscriptions, subscriptions will remain active until the end of the paid period */ + /** + * Cancel account subscriptions, subscriptions will remain active until the end of the paid period. + * Currently only works for Recurly subscriptions on team plans. + */ cancelSubscriptions: Maybe; - /** Changes an annual team subscription to a monthly team subscription when the current period expires. */ - convertAnnualTeamSubscriptionToMonthlyAtNextPeriod: Maybe; - /** Changes a monthly team subscription to an annual team subscription. */ - convertMonthlyTeamSubscriptionToAnnual: Maybe; + /** Create a CloudOnboarding for this account */ + createCloudOnboarding: CreateOnboardingResult; + createGraph: GraphCreationResult; createStaticInvitation: Maybe; + currentSubscription: Maybe; /** Delete the account's avatar. Requires Account.canUpdateAvatar to be true. */ deleteAvatar: Maybe; - /** Acknowledge that a trial has expired and return to community */ - dismissExpiredTrial: Maybe; - /** Apollo admins only: extend an ongoing trial */ + /** If the org is on an enterprise trial, set the end date to a new value. */ extendTrial: Maybe; /** Hard delete an account and all associated services */ hardDelete: Maybe; + /** Get reference to the account ID */ + internalID: Maybe; /** Send an invitation to join the account by E-mail */ invite: Maybe; - /** Reactivate a canceled current subscription */ + /** Lock an account, which limits the functionality available with regard to its graphs. */ + lock: Maybe; + /** See Account type. Field is needed by extending subgraph. */ + name: Maybe; + /** Mutations for interacting with an Apollo account's private subgraphs on GraphOS */ + privateSubgraph: PrivateSubgraphMutation; + /** + * Reactivate a canceled current subscription. + * Currently only works for Recurly subscriptions on team plans. + */ reactivateCurrentSubscription: Maybe; - /** Refresh billing information from third-party billing service */ - refreshBilling: Maybe; /** Delete an invitation */ removeInvitation: Maybe; /** Remove a member of the account */ removeMember: Maybe; + /** Trigger a request for an audit export */ requestAuditExport: Maybe; /** Send a new E-mail for an existing invitation */ resendInvitation: Maybe; revokeStaticInvitation: Maybe; - /** Apollo admins only: set the billing plan to an arbitrary plan */ + /** See Account type. Field is needed by extending subgraph. */ + seats: Maybe; + /** Apollo admins only: set the billing plan to an arbitrary plan effective immediately terminating any current paid plan. */ setPlan: Maybe; - /** Start a new team subscription with the given billing period */ - startTeamSubscription: Maybe; - /** Start a team trial */ - startTrial: Maybe; /** This is called by the form shown to users after they cancel their team subscription. */ submitTeamCancellationFeedback: Maybe; - /** Apollo admins only: terminate any ongoing subscriptions in the account, without refunds */ + /** Apollo admins only: Terminate the ongoing subscription in the account as soon as possible, without refunds. */ + terminateSubscription: Maybe; + /** + * Apollo admins only: terminate any ongoing subscriptions in the account, without refunds + * Currently only works for Recurly subscriptions. + */ terminateSubscriptions: Maybe; + trackTermsAccepted: Maybe; + /** Unlock a locked account. */ + unlock: Maybe; /** Update the billing address for a Recurly token */ updateBillingAddress: Maybe; /** Update the billing information from a Recurly token */ @@ -632,13 +1076,22 @@ export type AccountMutationAuditExportArgs = { }; -export type AccountMutationCreateStaticInvitationArgs = { - role: UserPermission; +export type AccountMutationCreateCloudOnboardingArgs = { + input: CloudOnboardingInput; }; -export type AccountMutationExtendTrialArgs = { - to: Scalars['Timestamp']; +export type AccountMutationCreateGraphArgs = { + graphType: GraphType; + hiddenFromUninvitedNonAdmin: Scalars['Boolean']; + id: Scalars['ID']; + title: Scalars['String']; + variantCreationConfig: Maybe; +}; + + +export type AccountMutationCreateStaticInvitationArgs = { + role: UserPermission; }; @@ -648,6 +1101,12 @@ export type AccountMutationInviteArgs = { }; +export type AccountMutationLockArgs = { + reason: Maybe; + type: Maybe; +}; + + export type AccountMutationRemoveInvitationArgs = { id: Maybe; }; @@ -681,13 +1140,18 @@ export type AccountMutationSetPlanArgs = { }; -export type AccountMutationStartTeamSubscriptionArgs = { - billingPeriod: BillingPeriod; +export type AccountMutationSubmitTeamCancellationFeedbackArgs = { + feedback: Scalars['String']; }; -export type AccountMutationSubmitTeamCancellationFeedbackArgs = { - feedback: Scalars['String']; +export type AccountMutationTerminateSubscriptionArgs = { + providerId: Scalars['ID']; +}; + + +export type AccountMutationTrackTermsAcceptedArgs = { + at: Scalars['Timestamp']; }; @@ -741,7 +1205,10 @@ export enum AccountOperationCheckStatsColumn { CachedRequestsCount = 'CACHED_REQUESTS_COUNT', ClientName = 'CLIENT_NAME', ClientVersion = 'CLIENT_VERSION', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', QueryId = 'QUERY_ID', + QueryName = 'QUERY_NAME', SchemaTag = 'SCHEMA_TAG', ServiceId = 'SERVICE_ID', Timestamp = 'TIMESTAMP', @@ -752,7 +1219,10 @@ export type AccountOperationCheckStatsDimensions = { __typename?: 'AccountOperationCheckStatsDimensions'; clientName: Maybe; clientVersion: Maybe; + operationSubtype: Maybe; + operationType: Maybe; queryId: Maybe; + queryName: Maybe; schemaTag: Maybe; serviceId: Maybe; }; @@ -766,9 +1236,15 @@ export type AccountOperationCheckStatsFilter = { clientVersion: Maybe; in: Maybe; not: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; or: Maybe>; /** Selects rows whose queryId dimension equals the given value if not null. To query for the null value, use {in: {queryId: [null]}} instead. */ queryId: Maybe; + /** Selects rows whose queryName dimension equals the given value if not null. To query for the null value, use {in: {queryName: [null]}} instead. */ + queryName: Maybe; /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ schemaTag: Maybe; /** Selects rows whose serviceId dimension equals the given value if not null. To query for the null value, use {in: {serviceId: [null]}} instead. */ @@ -781,8 +1257,14 @@ export type AccountOperationCheckStatsFilterIn = { clientName: Maybe>>; /** Selects rows whose clientVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ clientVersion: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ queryId: Maybe>>; + /** Selects rows whose queryName dimension is in the given list. A null value in the list means a row with null for that dimension. */ + queryName: Maybe>>; /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ schemaTag: Maybe>>; /** Selects rows whose serviceId dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -810,6 +1292,20 @@ export type AccountOperationCheckStatsRecord = { timestamp: Scalars['Timestamp']; }; +export type AccountOperationUsage = { + __typename?: 'AccountOperationUsage'; + selfHosted: BillableMetricStats; + serverless: BillableMetricStats; + totalOperations: BillableMetricStats; +}; + +export type AccountOperationUsageWindowInput = { + from: Scalars['Date']; + limit: Scalars['Int']; + to: Scalars['Date']; + windowSize: BillingUsageStatsWindowSize; +}; + export type AccountPublishesStatsMetrics = { __typename?: 'AccountPublishesStatsMetrics'; totalPublishes: Scalars['Long']; @@ -831,6 +1327,8 @@ export enum AccountQueryStatsColumn { ClientVersion = 'CLIENT_VERSION', ForbiddenOperationCount = 'FORBIDDEN_OPERATION_COUNT', FromEngineproxy = 'FROM_ENGINEPROXY', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', QueryId = 'QUERY_ID', QueryName = 'QUERY_NAME', RegisteredOperationCount = 'REGISTERED_OPERATION_COUNT', @@ -848,9 +1346,12 @@ export type AccountQueryStatsDimensions = { clientName: Maybe; clientVersion: Maybe; fromEngineproxy: Maybe; + operationSubtype: Maybe; + operationType: Maybe; queryId: Maybe; queryName: Maybe; querySignature: Maybe; + querySignatureLength: Maybe; schemaHash: Maybe; schemaTag: Maybe; serviceId: Maybe; @@ -867,6 +1368,10 @@ export type AccountQueryStatsFilter = { fromEngineproxy: Maybe; in: Maybe; not: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; or: Maybe>; /** Selects rows whose queryId dimension equals the given value if not null. To query for the null value, use {in: {queryId: [null]}} instead. */ queryId: Maybe; @@ -888,6 +1393,10 @@ export type AccountQueryStatsFilterIn = { clientVersion: Maybe>>; /** Selects rows whose fromEngineproxy dimension is in the given list. A null value in the list means a row with null for that dimension. */ fromEngineproxy: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ queryId: Maybe>>; /** Selects rows whose queryName dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -932,17 +1441,12 @@ export type AccountQueryStatsRecord = { export type AccountRoles = { __typename?: 'AccountRoles'; canAudit: Scalars['Boolean']; - canCreateDevGraph: Scalars['Boolean']; canCreateService: Scalars['Boolean']; canDelete: Scalars['Boolean']; - /** @deprecated Use canQueryBillingInfo instead */ - canDownloadInvoice: Scalars['Boolean']; canManageMembers: Scalars['Boolean']; canQuery: Scalars['Boolean']; canQueryAudit: Scalars['Boolean']; canQueryBillingInfo: Scalars['Boolean']; - /** @deprecated Use canQueryBillingInfo instead */ - canQueryInvoices: Scalars['Boolean']; canQueryMembers: Scalars['Boolean']; canQueryStats: Scalars['Boolean']; canReadTickets: Scalars['Boolean']; @@ -962,10 +1466,13 @@ export enum AccountState { /** A time window with a specified granularity over a given account. */ export type AccountStatsWindow = { __typename?: 'AccountStatsWindow'; + billingUsageStats: Array; edgeServerInfos: Array; errorStats: Array; + fieldExecutions: Array; fieldLatencies: Array; fieldUsage: Array; + graphosCloudMetrics: Array; operationCheckStats: Array; queryStats: Array; /** From field rounded down to the nearest resolution. */ @@ -977,6 +1484,14 @@ export type AccountStatsWindow = { }; +/** A time window with a specified granularity over a given account. */ +export type AccountStatsWindowBillingUsageStatsArgs = { + filter: Maybe; + limit?: Maybe; + orderBy: Maybe>; +}; + + /** A time window with a specified granularity over a given account. */ export type AccountStatsWindowEdgeServerInfosArgs = { filter: Maybe; @@ -993,6 +1508,14 @@ export type AccountStatsWindowErrorStatsArgs = { }; +/** A time window with a specified granularity over a given account. */ +export type AccountStatsWindowFieldExecutionsArgs = { + filter: Maybe; + limit?: Maybe; + orderBy: Maybe>; +}; + + /** A time window with a specified granularity over a given account. */ export type AccountStatsWindowFieldLatenciesArgs = { filter: Maybe; @@ -1009,6 +1532,14 @@ export type AccountStatsWindowFieldUsageArgs = { }; +/** A time window with a specified granularity over a given account. */ +export type AccountStatsWindowGraphosCloudMetricsArgs = { + filter: Maybe; + limit?: Maybe; + orderBy: Maybe>; +}; + + /** A time window with a specified granularity over a given account. */ export type AccountStatsWindowOperationCheckStatsArgs = { filter: Maybe; @@ -1165,15 +1696,16 @@ export enum AccountTraceRefsColumn { ClientName = 'CLIENT_NAME', ClientVersion = 'CLIENT_VERSION', DurationBucket = 'DURATION_BUCKET', - DurationNs = 'DURATION_NS', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', QueryId = 'QUERY_ID', QueryName = 'QUERY_NAME', SchemaHash = 'SCHEMA_HASH', SchemaTag = 'SCHEMA_TAG', ServiceId = 'SERVICE_ID', Timestamp = 'TIMESTAMP', - TraceId = 'TRACE_ID', - TraceSizeBytes = 'TRACE_SIZE_BYTES' + TraceCount = 'TRACE_COUNT', + TraceId = 'TRACE_ID' } export type AccountTraceRefsDimensions = { @@ -1181,6 +1713,9 @@ export type AccountTraceRefsDimensions = { clientName: Maybe; clientVersion: Maybe; durationBucket: Maybe; + generatedTraceId: Maybe; + operationSubtype: Maybe; + operationType: Maybe; queryId: Maybe; queryName: Maybe; querySignature: Maybe; @@ -1201,6 +1736,10 @@ export type AccountTraceRefsFilter = { durationBucket: Maybe; in: Maybe; not: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; or: Maybe>; /** Selects rows whose queryId dimension equals the given value if not null. To query for the null value, use {in: {queryId: [null]}} instead. */ queryId: Maybe; @@ -1224,6 +1763,10 @@ export type AccountTraceRefsFilterIn = { clientVersion: Maybe>>; /** Selects rows whose durationBucket dimension is in the given list. A null value in the list means a row with null for that dimension. */ durationBucket: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ queryId: Maybe>>; /** Selects rows whose queryName dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -1240,8 +1783,7 @@ export type AccountTraceRefsFilterIn = { export type AccountTraceRefsMetrics = { __typename?: 'AccountTraceRefsMetrics'; - durationNs: Scalars['Long']; - traceSizeBytes: Scalars['Long']; + traceCount: Scalars['Long']; }; export type AccountTraceRefsOrderBySpec = { @@ -1259,12 +1801,14 @@ export type AccountTraceRefsRecord = { timestamp: Scalars['Timestamp']; }; +/** Represents an actor that performs actions in Apollo Studio. Most actors are either a `USER` or a `GRAPH` (based on a request's provided API key), and they have the corresponding `ActorType`. */ export type Actor = { __typename?: 'Actor'; actorId: Scalars['ID']; type: ActorType; }; +/** Input type to provide when specifying an `Actor` in operation arguments. See also the `Actor` object type. */ export type ActorInput = { actorId: Scalars['ID']; type: ActorType; @@ -1277,9 +1821,47 @@ export enum ActorType { Graph = 'GRAPH', InternalIdentity = 'INTERNAL_IDENTITY', Synchronization = 'SYNCHRONIZATION', + System = 'SYSTEM', User = 'USER' } +/** parentCommentId is only present for replies. schemaCoordinate & subgraph are only present for initial change comments. If all are absent, this is a general parent comment on the proposal. */ +export type AddCommentInput = { + message: Scalars['String']; + parentCommentId: Maybe; + revisionId: Scalars['String']; + schemaCoordinate: Maybe; + schemaScope: Maybe; +}; + +export type AddCommentResult = NotFoundError | ParentChangeProposalComment | ParentGeneralProposalComment | ReplyChangeProposalComment | ReplyGeneralProposalComment | ValidationError; + +export type AddOperationCollectionEntriesResult = AddOperationCollectionEntriesSuccess | PermissionError | ValidationError; + +export type AddOperationCollectionEntriesSuccess = { + __typename?: 'AddOperationCollectionEntriesSuccess'; + operationCollectionEntries: Array; +}; + +export type AddOperationCollectionEntryResult = OperationCollectionEntry | PermissionError | ValidationError; + +export type AddOperationCollectionToVariantResult = GraphVariant | InvalidTarget | PermissionError | ValidationError; + +export type AddOperationInput = { + /** The operation's fields. */ + document: OperationCollectionEntryStateInput; + /** The operation's name. */ + name: Scalars['String']; +}; + +export type AdminUser = { + __typename?: 'AdminUser'; + created_at: Scalars['Timestamp']; + email: Scalars['String']; + id: Scalars['ID']; + team: Scalars['String']; +}; + export type AffectedClient = { __typename?: 'AffectedClient'; /** @@ -1317,9 +1899,16 @@ export type AffectedQuery = { signature: Maybe; }; +/** + * Represents an API key that's used to authenticate a + * particular Apollo user or graph. + */ export type ApiKey = { + /** The API key's ID. */ id: Scalars['ID']; + /** The API key's name, for distinguishing it from other keys. */ keyName: Maybe; + /** The value of the API key. **This is a secret credential!** */ token: Scalars['String']; }; @@ -1329,18 +1918,68 @@ export type ApiKeyProvision = { created: Scalars['Boolean']; }; +/** A generic event for the `trackApolloKotlinUsage` mutation */ +export type ApolloKotlinUsageEventInput = { + /** When the event occurred */ + date: Scalars['Timestamp']; + /** Optional parameters attached to the event */ + payload: Maybe; + /** Type of event */ + type: Scalars['ID']; +}; + +/** A generic property for the `trackApolloKotlinUsage` mutation */ +export type ApolloKotlinUsagePropertyInput = { + /** Optional parameters attached to the property */ + payload: Maybe; + /** Type of property */ + type: Scalars['ID']; +}; + +export enum AuditAction { + BroadcastMessage = 'BroadcastMessage', + CreateMessage = 'CreateMessage', + EditMessage = 'EditMessage', + RecallMessage = 'RecallMessage', + TestMessage = 'TestMessage', + UpdateMessageState = 'UpdateMessageState' +} + +export type AuditLog = { + __typename?: 'AuditLog'; + action: Scalars['String']; + changeLog: Maybe; + channel: Maybe; + createdAt: Scalars['Timestamp']; + id: Scalars['ID']; + message: Maybe; + slackMessageId: Maybe; + userId: Scalars['String']; +}; + export type AuditLogExport = { __typename?: 'AuditLogExport'; + /** The list of actors to filter the audit export */ actors: Maybe>; bigqueryTriggeredAt: Maybe; + /** The time when the audit export was completed */ completedAt: Maybe; + /** The time when the audit export was reqeusted */ createdAt: Scalars['Timestamp']; + /** List of URLs to download the audits for the requested range */ + downloadUrls: Maybe>; exportedFiles: Maybe>; + /** The starting point of audits to include in export */ from: Scalars['Timestamp']; + /** The list of graphs to filter the audit export */ graphs: Maybe>; + /** The id for the audit export */ id: Scalars['ID']; + /** The user that initiated the audit export */ requester: Maybe; + /** The status of the audit export */ status: AuditStatus; + /** The end point of audits to include in export */ to: Scalars['Timestamp']; }; @@ -1383,9 +2022,35 @@ export enum AvatarUploadErrorCode { export type AvatarUploadResult = AvatarUploadError | MediaUploadInfo; -export type BillingAccount = { - __typename?: 'BillingAccount'; - id: Scalars['ID']; +/** AWS-specific information for a Shard */ +export type AwsShard = { + __typename?: 'AwsShard'; + /** AWS Account ID where the Shard is hosted */ + accountId: Scalars['String']; + /** ARN of the ECS Cluster */ + ecsClusterArn: Scalars['String']; + /** DNS endpoint for the load balancer */ + endpoint: Scalars['String']; + /** ARN of the IAM role to perform provisioning operations on this shard */ + iamRoleArn: Scalars['String']; + /** ARN of the load balancer */ + loadbalancerArn: Scalars['String']; + /** ARN of the load balancer listener */ + loadbalancerListenerArn: Scalars['String']; + /** ID of the security group for the load balancer */ + loadbalancerSecurityGroupId: Scalars['String']; + /** ARN of the IAM permissions boundaries for IAM roles provisioned in this shard */ + permissionsBoundaryArn: Scalars['String']; + /** IDs of the subnets */ + subnetIds: Array; + /** ID of the VPC */ + vpcId: Scalars['String']; +}; + +export type BillableMetricStats = { + __typename?: 'BillableMetricStats'; + planThreshold: Maybe; + stats: Array; }; export type BillingAddress = { @@ -1398,7 +2063,7 @@ export type BillingAddress = { zip: Maybe; }; -/** Billing address inpnut */ +/** Billing address input */ export type BillingAddressInput = { address1: Scalars['String']; address2: Maybe; @@ -1408,6 +2073,31 @@ export type BillingAddressInput = { zip: Scalars['String']; }; +export type BillingAdminQuery = { + __typename?: 'BillingAdminQuery'; + /** Look up the current plan of an account by calling the grpc service */ + currentPlanFromGrpc: Maybe; +}; + + +export type BillingAdminQueryCurrentPlanFromGrpcArgs = { + internalAccountId: Scalars['ID']; +}; + +export type BillingCapability = { + __typename?: 'BillingCapability'; + defaultValue: Scalars['Boolean']; + intendedUse: Scalars['String']; + label: Scalars['String']; +}; + +/** Billing capability input */ +export type BillingCapabilityInput = { + defaultValue: Scalars['Boolean']; + intendedUse: Scalars['String']; + label: Scalars['String']; +}; + export type BillingInfo = { __typename?: 'BillingInfo'; address: BillingAddress; @@ -1416,13 +2106,40 @@ export type BillingInfo = { lastFour: Maybe; lastName: Maybe; month: Maybe; + name: Maybe; vatNumber: Maybe; year: Maybe; }; -export enum BillingModel { - RequestBased = 'REQUEST_BASED', - SeatBased = 'SEAT_BASED' +export type BillingInsights = { + __typename?: 'BillingInsights'; + totalOperations: Array; + totalSampledOperations: Array; +}; + +export type BillingInsightsUsage = { + __typename?: 'BillingInsightsUsage'; + timestamp: Scalars['Timestamp']; + totalOperationCount: Scalars['Long']; +}; + +export type BillingLimit = { + __typename?: 'BillingLimit'; + defaultValue: Scalars['Long']; + intendedUse: Scalars['String']; + label: Scalars['String']; +}; + +/** Billing limit input */ +export type BillingLimitInput = { + defaultValue: Scalars['Long']; + intendedUse: Scalars['String']; + label: Scalars['String']; +}; + +export enum BillingModel { + RequestBased = 'REQUEST_BASED', + SeatBased = 'SEAT_BASED' } export type BillingMonth = { @@ -1432,6 +2149,57 @@ export type BillingMonth = { start: Scalars['Timestamp']; }; +export type BillingMutation = { + __typename?: 'BillingMutation'; + /** Temporary utility mutation to convert annual team plan orgs to monthly team plans */ + convertAnnualTeamOrgToMonthly: Maybe; + createSetupIntent: Maybe; + endPaidUsageBasedPlan: Maybe; + reloadPlans: Array; + startFreeUsageBasedPlan: Maybe; + startUsageBasedPlan: Maybe; + /** @deprecated No longer supported */ + syncAccountWithProviders: Maybe; + updatePaymentMethod: Maybe; +}; + + +export type BillingMutationConvertAnnualTeamOrgToMonthlyArgs = { + internalAccountId: Scalars['ID']; +}; + + +export type BillingMutationCreateSetupIntentArgs = { + internalAccountId: Scalars['ID']; +}; + + +export type BillingMutationEndPaidUsageBasedPlanArgs = { + internalAccountId: Scalars['ID']; +}; + + +export type BillingMutationStartFreeUsageBasedPlanArgs = { + internalAccountId: Scalars['ID']; +}; + + +export type BillingMutationStartUsageBasedPlanArgs = { + internalAccountId: Scalars['ID']; + paymentMethodId: Scalars['String']; +}; + + +export type BillingMutationSyncAccountWithProvidersArgs = { + internalAccountId: Scalars['ID']; +}; + + +export type BillingMutationUpdatePaymentMethodArgs = { + internalAccountId: Scalars['ID']; + paymentMethodId: Scalars['String']; +}; + export enum BillingPeriod { Monthly = 'MONTHLY', Quarterly = 'QUARTERLY', @@ -1442,21 +2210,61 @@ export enum BillingPeriod { export type BillingPlan = { __typename?: 'BillingPlan'; addons: Array; + /** Retrieve all capabilities for the plan */ + allCapabilities: Array; + /** Retrieve a list of all effective capability limits for this plan */ + allLimits: Array; billingModel: BillingModel; billingPeriod: Maybe; + /** @deprecated capabilities have been flattened into the BillingPlan type */ capabilities: BillingPlanCapabilities; + clientVersions: Scalars['Boolean']; + clients: Scalars['Boolean']; + contracts: Scalars['Boolean']; + datadog: Scalars['Boolean']; description: Maybe; + /** Retrieve the limit applied to this plan for a capability */ + effectiveLimit: Maybe; + errors: Scalars['Boolean']; + federation: Scalars['Boolean']; + /** Check whether a capability is enabled for the plan */ + hasCapability: Maybe; id: Scalars['ID']; isTrial: Scalars['Boolean']; kind: BillingPlanKind; + launches: Scalars['Boolean']; + maxAuditInDays: Scalars['Int']; + maxRangeInDays: Maybe; + /** The maximum number of days that checks stats will be stored */ + maxRangeInDaysForChecks: Maybe; + maxRequestsPerMonth: Maybe; + metrics: Scalars['Boolean']; name: Scalars['String']; + notifications: Scalars['Boolean']; + operationRegistry: Scalars['Boolean']; + persistedQueries: Scalars['Boolean']; /** The price of every seat */ pricePerSeatInUsdCents: Maybe; /** The price of subscribing to this plan with a quantity of 1 (currently always the case) */ pricePerUnitInUsdCents: Scalars['Int']; /** Whether the plan is accessible by all users in QueryRoot.allPlans, QueryRoot.plan, or AccountMutation.setPlan */ public: Scalars['Boolean']; + ranges: Array; + schemaValidation: Scalars['Boolean']; tier: BillingPlanTier; + traces: Scalars['Boolean']; + userRoles: Scalars['Boolean']; + webhooks: Scalars['Boolean']; +}; + + +export type BillingPlanEffectiveLimitArgs = { + label: Scalars['String']; +}; + + +export type BillingPlanHasCapabilityArgs = { + label: Scalars['String']; }; export type BillingPlanAddon = { @@ -1465,8 +2273,15 @@ export type BillingPlanAddon = { pricePerUnitInUsdCents: Scalars['Int']; }; +/** Billing plan addon input */ +export type BillingPlanAddonInput = { + code: Maybe; + usdCentsPrice: Maybe; +}; + export type BillingPlanCapabilities = { __typename?: 'BillingPlanCapabilities'; + clientVersions: Scalars['Boolean']; clients: Scalars['Boolean']; contracts: Scalars['Boolean']; datadog: Scalars['Boolean']; @@ -1475,10 +2290,12 @@ export type BillingPlanCapabilities = { launches: Scalars['Boolean']; maxAuditInDays: Scalars['Int']; maxRangeInDays: Maybe; + maxRangeInDaysForChecks: Maybe; maxRequestsPerMonth: Maybe; metrics: Scalars['Boolean']; notifications: Scalars['Boolean']; operationRegistry: Scalars['Boolean']; + persistedQueries: Scalars['Boolean']; ranges: Array; schemaValidation: Scalars['Boolean']; traces: Scalars['Boolean']; @@ -1486,32 +2303,154 @@ export type BillingPlanCapabilities = { webhooks: Scalars['Boolean']; }; +export type BillingPlanCapability = { + __typename?: 'BillingPlanCapability'; + label: Scalars['String']; + plan: BillingPlan; + value: Scalars['Boolean']; +}; + +/** Billing plan input */ +export type BillingPlanInput = { + addons: Array; + billingModel: BillingModel; + billingPeriod: BillingPeriod; + clientVersions: Maybe; + clients: Maybe; + contracts: Maybe; + datadog: Maybe; + description: Scalars['String']; + errors: Maybe; + federation: Maybe; + id: Scalars['ID']; + kind: BillingPlanKind; + launches: Maybe; + maxAuditInDays: Maybe; + maxRangeInDays: Maybe; + maxRangeInDaysForChecks: Maybe; + maxRequestsPerMonth: Maybe; + metrics: Maybe; + name: Scalars['String']; + notifications: Maybe; + operationRegistry: Maybe; + persistedQueries: Maybe; + pricePerSeatInUsdCents: Maybe; + pricePerUnitInUsdCents: Maybe; + public: Scalars['Boolean']; + schemaValidation: Maybe; + traces: Maybe; + userRoles: Maybe; + webhooks: Maybe; +}; + export enum BillingPlanKind { Community = 'COMMUNITY', + Dedicated = 'DEDICATED', EnterpriseInternal = 'ENTERPRISE_INTERNAL', EnterprisePaid = 'ENTERPRISE_PAID', EnterprisePilot = 'ENTERPRISE_PILOT', + EnterpriseTrial = 'ENTERPRISE_TRIAL', + OneFree = 'ONE_FREE', + OnePaid = 'ONE_PAID', + Serverless = 'SERVERLESS', + ServerlessFree = 'SERVERLESS_FREE', + ServerlessPaid = 'SERVERLESS_PAID', + Starter = 'STARTER', TeamPaid = 'TEAM_PAID', - TeamTrial = 'TEAM_TRIAL' + TeamTrial = 'TEAM_TRIAL', + Unknown = 'UNKNOWN' } +export type BillingPlanLimit = { + __typename?: 'BillingPlanLimit'; + label: Scalars['String']; + plan: BillingPlan; + value: Scalars['Long']; +}; + +export type BillingPlanMutation = { + __typename?: 'BillingPlanMutation'; + /** Archive this billing plan */ + archive: Maybe; + /** Remove the specified capability from this plan */ + clearCapability: Maybe; + /** Remove the specified limit from this plan */ + clearLimit: Maybe; + id: Scalars['ID']; + /** Reset the specified capability on this plan to the global default value for the capability */ + resetCapability: Maybe; + /** Reset the specified limit on this plan to the global default value for the limit */ + resetLimit: Maybe; + /** Sets the specified capability on this plan to the provided value */ + setCapability: Maybe; + /** Sets the specified limit on this plan to the provided value */ + setLimit: Maybe; +}; + + +export type BillingPlanMutationClearCapabilityArgs = { + label: Scalars['String']; +}; + + +export type BillingPlanMutationClearLimitArgs = { + label: Scalars['String']; +}; + + +export type BillingPlanMutationResetCapabilityArgs = { + label: Scalars['String']; +}; + + +export type BillingPlanMutationResetLimitArgs = { + label: Scalars['String']; +}; + + +export type BillingPlanMutationSetCapabilityArgs = { + label: Scalars['String']; + value: Scalars['Boolean']; +}; + + +export type BillingPlanMutationSetLimitArgs = { + label: Scalars['String']; + value: Scalars['Long']; +}; + export enum BillingPlanTier { Community = 'COMMUNITY', Enterprise = 'ENTERPRISE', - Team = 'TEAM' + One = 'ONE', + Team = 'TEAM', + Unknown = 'UNKNOWN', + UsageBased = 'USAGE_BASED' } export type BillingSubscription = { __typename?: 'BillingSubscription'; activatedAt: Scalars['Timestamp']; addons: Array; + /** Retrieve all capabilities for this subscription */ + allCapabilities: Array; + /** Retrieve a list of all effective capability limits for this subscription */ + allLimits: Array; autoRenew: Scalars['Boolean']; - /** The price of the subscription when ignoring add-ons (such as seats), ie quantity * pricePerUnitInUsdCents */ - basePriceInUsdCents: Scalars['Long']; canceledAt: Maybe; + /** Draft invoice for this subscription */ + currentDraftInvoice: Maybe; currentPeriodEndsAt: Scalars['Timestamp']; currentPeriodStartedAt: Scalars['Timestamp']; + /** Retrieve the limit applied to this subscription for a capability */ + effectiveLimit: Maybe; expiresAt: Maybe; + /** Renewal grace time for updating seat count */ + graceTimeForNextRenewal: Maybe; + /** Check whether a capability is enabled for the subscription */ + hasCapability: Maybe; + maxSelfHostedRequestsPerMonth: Maybe; + maxServerlessRequestsPerMonth: Maybe; plan: BillingPlan; /** The price of every seat */ pricePerSeatInUsdCents: Maybe; @@ -1521,8 +2460,6 @@ export type BillingSubscription = { /** Total price of the subscription when it next renews, including add-ons (such as seats) */ renewalTotalPriceInUsdCents: Scalars['Long']; state: SubscriptionState; - /** Total price of the subscription, including add-ons (such as seats) */ - totalPriceInUsdCents: Scalars['Long']; /** * When this subscription's trial period expires (if it is a trial). Not the same as the * subscription's Recurly expiration). @@ -1531,6 +2468,16 @@ export type BillingSubscription = { uuid: Scalars['ID']; }; + +export type BillingSubscriptionEffectiveLimitArgs = { + label: Scalars['String']; +}; + + +export type BillingSubscriptionHasCapabilityArgs = { + label: Scalars['String']; +}; + export type BillingSubscriptionAddon = { __typename?: 'BillingSubscriptionAddon'; id: Scalars['ID']; @@ -1538,33 +2485,298 @@ export type BillingSubscriptionAddon = { quantity: Scalars['Int']; }; +export type BillingSubscriptionMutation = { + __typename?: 'BillingSubscriptionMutation'; + /** Remove the specified capability override for this subscription */ + clearCapability: Maybe; + /** Remove the specified limit override for this subscription */ + clearLimit: Maybe; + /** Sets the capability override on this subscription to the provided value */ + setCapability: Maybe; + /** Sets the limit override on this subscription to the provided value */ + setLimit: Maybe; + uuid: Scalars['ID']; +}; + + +export type BillingSubscriptionMutationClearCapabilityArgs = { + label: Scalars['String']; +}; + + +export type BillingSubscriptionMutationClearLimitArgs = { + label: Scalars['String']; +}; + + +export type BillingSubscriptionMutationSetCapabilityArgs = { + label: Scalars['String']; + value: Scalars['Boolean']; +}; + + +export type BillingSubscriptionMutationSetLimitArgs = { + label: Scalars['String']; + value: Scalars['Long']; +}; + +export type BillingTier = { + __typename?: 'BillingTier'; + searchAccounts: Array; + tier: BillingPlanTier; +}; + + +export type BillingTierSearchAccountsArgs = { + search: Maybe; +}; + +/** Columns of BillingUsageStats. */ +export enum BillingUsageStatsColumn { + AccountId = 'ACCOUNT_ID', + AgentVersion = 'AGENT_VERSION', + GraphDeploymentType = 'GRAPH_DEPLOYMENT_TYPE', + OperationCount = 'OPERATION_COUNT', + OperationCountProvidedExplicitly = 'OPERATION_COUNT_PROVIDED_EXPLICITLY', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', + SchemaTag = 'SCHEMA_TAG', + ServiceId = 'SERVICE_ID', + Timestamp = 'TIMESTAMP' +} + +export type BillingUsageStatsDimensions = { + __typename?: 'BillingUsageStatsDimensions'; + accountId: Maybe; + agentVersion: Maybe; + graphDeploymentType: Maybe; + operationCountProvidedExplicitly: Maybe; + operationSubtype: Maybe; + operationType: Maybe; + schemaTag: Maybe; + serviceId: Maybe; +}; + +/** Filter for data in BillingUsageStats. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ +export type BillingUsageStatsFilter = { + /** Selects rows whose accountId dimension equals the given value if not null. To query for the null value, use {in: {accountId: [null]}} instead. */ + accountId: Maybe; + /** Selects rows whose agentVersion dimension equals the given value if not null. To query for the null value, use {in: {agentVersion: [null]}} instead. */ + agentVersion: Maybe; + and: Maybe>; + /** Selects rows whose graphDeploymentType dimension equals the given value if not null. To query for the null value, use {in: {graphDeploymentType: [null]}} instead. */ + graphDeploymentType: Maybe; + in: Maybe; + not: Maybe; + /** Selects rows whose operationCountProvidedExplicitly dimension equals the given value if not null. To query for the null value, use {in: {operationCountProvidedExplicitly: [null]}} instead. */ + operationCountProvidedExplicitly: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; + or: Maybe>; + /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ + schemaTag: Maybe; + /** Selects rows whose serviceId dimension equals the given value if not null. To query for the null value, use {in: {serviceId: [null]}} instead. */ + serviceId: Maybe; +}; + +/** Filter for data in BillingUsageStats. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ +export type BillingUsageStatsFilterIn = { + /** Selects rows whose accountId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + accountId: Maybe>>; + /** Selects rows whose agentVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ + agentVersion: Maybe>>; + /** Selects rows whose graphDeploymentType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + graphDeploymentType: Maybe>>; + /** Selects rows whose operationCountProvidedExplicitly dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationCountProvidedExplicitly: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; + /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ + schemaTag: Maybe>>; + /** Selects rows whose serviceId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + serviceId: Maybe>>; +}; + +export type BillingUsageStatsMetrics = { + __typename?: 'BillingUsageStatsMetrics'; + operationCount: Scalars['Long']; +}; + +export type BillingUsageStatsOrderBySpec = { + column: BillingUsageStatsColumn; + direction: Ordering; +}; + +export type BillingUsageStatsRecord = { + __typename?: 'BillingUsageStatsRecord'; + /** Dimensions of BillingUsageStats that can be grouped by. */ + groupBy: BillingUsageStatsDimensions; + /** Metrics of BillingUsageStats that can be aggregated over. */ + metrics: BillingUsageStatsMetrics; + /** Starting segment timestamp. */ + timestamp: Scalars['Timestamp']; +}; + +export enum BillingUsageStatsWindowSize { + Day = 'DAY', + Hour = 'HOUR', + Month = 'MONTH', + None = 'NONE' +} + +/** The building of a Studio variant (including supergraph composition and any contract filtering) as part of a launch. */ export type Build = { __typename?: 'Build'; + /** The inputs provided to the build, including subgraph and contract details. */ input: BuildInput; + /** The result of the build. This value is null until the build completes. */ result: Maybe; }; +export type BuildCheckFailed = { + buildInputs: BuildInputs; + buildPipelineTrack: BuildPipelineTrack; + /** A list of errors generated by this build. */ + errors: Array; + id: Scalars['ID']; + passed: Scalars['Boolean']; + workflowTask: BuildCheckTask; +}; + +export type BuildCheckPassed = { + buildInputs: BuildInputs; + buildPipelineTrack: BuildPipelineTrack; + id: Scalars['ID']; + passed: Scalars['Boolean']; + /** The SHA-256 of the supergraph schema document generated by this build. */ + supergraphSchemaHash: Scalars['SHA256']; + workflowTask: BuildCheckTask; +}; + +export type BuildCheckResult = { + /** The input to the build task. */ + buildInputs: BuildInputs; + /** + * The build pipeline track of the build task, which indicates what gateway/router versions the + * build pipeline is intended to support (and accordingly controls the version of code). + */ + buildPipelineTrack: BuildPipelineTrack; + id: Scalars['ID']; + /** Whether the build task passed or failed. */ + passed: Scalars['Boolean']; + /** The workflow build task that generated this result. */ + workflowTask: BuildCheckTask; +}; + +export type BuildCheckTask = { + /** The result of the build check. This will be null when the task is initializing or running. */ + buildResult: Maybe; + completedAt: Maybe; + createdAt: Scalars['Timestamp']; + id: Scalars['ID']; + /** + * The build input change proposed for this check workflow. Note that for triggered downstream + * workflows, this is not the upstream variant's proposed change, but the changes for the downstream + * variant that are derived from the upstream workflow's results (e.g. the input supergraph schema). + */ + proposedBuildInputChanges: ProposedBuildInputChanges; + status: CheckWorkflowTaskStatus; + targetURL: Maybe; + workflow: CheckWorkflow; +}; + +/** The configuration for building a composition graph variant */ +export type BuildConfig = { + __typename?: 'BuildConfig'; + buildPipelineTrack: BuildPipelineTrack; + /** Show all uses of @tag directives to consumers in Schema Reference and Explorer */ + tagInApiSchema: Scalars['Boolean']; +}; + +/** + * Exactly one of the inputs must be set in a build configuration. + * Which build configuration type is set will determine the type + * of variant that is created. Existing variants of a given type + * cannot be updated in-place to be of a different type. + */ +export type BuildConfigInput = { + /** This list will contain any directives that should get passed through to the api schema from the core schema. Anything included in this list will appear in the consumer facing schema */ + apiDirectivePassThrough: Array; + /** if buildPipelineTrack is null use the graph default */ + buildPipelineTrack: Maybe; + composition: Maybe; + contract: Maybe; +}; + +/** A single error that occurred during the failed execution of a build. */ export type BuildError = { __typename?: 'BuildError'; code: Maybe; + failedStep: Maybe; locations: Array; message: Scalars['String']; }; +/** Contains the details of an executed build that failed. */ export type BuildFailure = { __typename?: 'BuildFailure'; + /** A list of all errors that occurred during the failed build. */ errorMessages: Array; }; export type BuildInput = CompositionBuildInput | FilterBuildInput; +export type BuildInputs = CompositionBuildInputs | FilterBuildInputs; + +export enum BuildPipelineTrack { + Fed_1_0 = 'FED_1_0', + Fed_1_1 = 'FED_1_1', + Fed_2_0 = 'FED_2_0', + Fed_2_1 = 'FED_2_1', + Fed_2_3 = 'FED_2_3', + Fed_2_4 = 'FED_2_4', + Fed_2_5 = 'FED_2_5' +} + +export enum BuildPipelineTrackBadge { + Deprecated = 'DEPRECATED', + Experimental = 'EXPERIMENTAL', + Latest = 'LATEST', + Unsupported = 'UNSUPPORTED' +} + +export type BuildPipelineTrackDetails = { + __typename?: 'BuildPipelineTrackDetails'; + badge: Maybe; + buildPipelineTrack: BuildPipelineTrack; + /** currently running version of composition for this track, includes patch updates */ + compositionVersion: Scalars['String']; + deprecatedAt: Maybe; + displayName: Scalars['String']; + minimumGatewayVersion: Maybe; + /** Minimum supported router and gateway versions. Min router version can be null since fed 1 doesn't have router support. */ + minimumRouterVersion: Maybe; + notSupportedAt: Maybe; +}; + export type BuildResult = BuildFailure | BuildSuccess; +/** Contains the details of an executed build that succeeded. */ export type BuildSuccess = { __typename?: 'BuildSuccess'; + /** Contains the supergraph and API schemas created by composition. */ coreSchema: CoreSchema; }; +export enum CacheControlScope { + Private = 'PRIVATE', + Public = 'PUBLIC' +} + export enum CacheScope { Private = 'PRIVATE', Public = 'PUBLIC', @@ -1572,6 +2784,17 @@ export enum CacheScope { Unrecognized = 'UNRECOGNIZED' } +export type CannotDeleteLinkedPersistedQueryListError = Error & { + __typename?: 'CannotDeleteLinkedPersistedQueryListError'; + message: Scalars['String']; +}; + +export type CannotModifyOperationBodyError = Error & { + __typename?: 'CannotModifyOperationBodyError'; + message: Scalars['String']; +}; + +/** A single change that was made to a definition in a schema. */ export type Change = { __typename?: 'Change'; affectedQueries: Maybe>; @@ -1581,16 +2804,16 @@ export type Change = { category: ChangeCategory; /** * Node related to the top level node that was changed, such as a field in an object, - * a value in an enum or the object of an interface + * a value in an enum or the object of an interface. */ childNode: Maybe; - /** Indication of the kind of target and action of the change, e.g. 'TYPE_REMOVED'. */ + /** Indicates the type of change that was made, and to what (e.g., 'TYPE_REMOVED'). */ code: Scalars['String']; - /** Explanation of both the target of the change and how it was changed. */ + /** A human-readable description of the change. */ description: Scalars['String']; - /** Top level node affected by the change */ + /** Top level node affected by the change. */ parentNode: Maybe; - /** Indication of the success of the overall change, either failure, warning, or notice. */ + /** The severity of the change (e.g., `FAILURE` or `NOTICE`) */ severity: ChangeSeverity; /** * Indication of the success of the overall change, either failure, warning, or notice. @@ -1659,16 +2882,20 @@ export enum ChangeCode { FieldRemoved = 'FIELD_REMOVED', /** Field was removed from the input object. */ FieldRemovedFromInputObject = 'FIELD_REMOVED_FROM_INPUT_OBJECT', - /** Non-nullable field was added to the input object. */ + /** Non-nullable field was added to the input object. (Deprecated.) */ NonNullableFieldAddedToInputObject = 'NON_NULLABLE_FIELD_ADDED_TO_INPUT_OBJECT', - /** Nullable field was added to the input type. */ + /** Nullable field was added to the input type. (Deprecated.) */ NullableFieldAddedToInputObject = 'NULLABLE_FIELD_ADDED_TO_INPUT_OBJECT', /** Nullable argument was added to the field. */ OptionalArgAdded = 'OPTIONAL_ARG_ADDED', + /** Optional field was added to the input type. */ + OptionalFieldAddedToInputObject = 'OPTIONAL_FIELD_ADDED_TO_INPUT_OBJECT', /** Non-nullable argument was added to the field. */ RequiredArgAdded = 'REQUIRED_ARG_ADDED', /** Non-nullable argument added to directive. */ RequiredDirectiveArgAdded = 'REQUIRED_DIRECTIVE_ARG_ADDED', + /** Required field was added to the input object. */ + RequiredFieldAddedToInputObject = 'REQUIRED_FIELD_ADDED_TO_INPUT_OBJECT', /** Type was added to the schema. */ TypeAdded = 'TYPE_ADDED', /** Type now implements the interface. */ @@ -1714,6 +2941,22 @@ export type ChangeOnOperation = { semanticChange: SemanticChange; }; +export type ChangeProposalComment = { + createdAt: Scalars['Timestamp']; + /** null if the user is deleted */ + createdBy: Maybe; + id: Scalars['ID']; + message: Scalars['String']; + /** true if the schemaCoordinate this comment is on doesn't exist in the diff between the most recent revision & the base sdl */ + outdated: Scalars['Boolean']; + schemaCoordinate: Scalars['String']; + /** '#@!api!@#' for api schema, '#@!supergraph!@#' for supergraph schema, subgraph otherwise */ + schemaScope: Scalars['String']; + status: CommentStatus; + /** null if never updated */ + updatedAt: Maybe; +}; + export enum ChangeSeverity { Failure = 'FAILURE', Notice = 'NOTICE' @@ -1748,6 +2991,7 @@ export enum ChangeType { Notice = 'NOTICE' } +/** An addition made to a Studio variant's changelog after a launch. */ export type ChangelogLaunchResult = { __typename?: 'ChangelogLaunchResult'; createdAt: Scalars['Timestamp']; @@ -1768,12 +3012,17 @@ export type ChannelSubscription = { variant: Maybe; }; +/** Graph-level configuration of checks. */ export type CheckConfiguration = { __typename?: 'CheckConfiguration'; /** Time when check configuration was created */ createdAt: Scalars['Timestamp']; + /** Whether to run Linting during schema checks. */ + enableLintChecks: Scalars['Boolean']; /** Clients to ignore during validation */ excludedClients: Array; + /** Operation names to ignore during validation */ + excludedOperationNames: Maybe>>; /** Operations to ignore during validation */ excludedOperations: Array; /** Graph that this check configuration belongs to */ @@ -1792,6 +3041,8 @@ export type CheckConfiguration = { * total request volume) */ operationCountThresholdPercentage: Scalars['Float']; + /** How submitted build input diffs are handled when they match (or don't) a Proposal */ + proposalChangeMismatchSeverity: ProposalChangeMismatchSeverity; /** * Only check operations from the last seconds. * The default is 7 days (604,800 seconds). @@ -1807,62 +3058,152 @@ export type CheckConfiguration = { export type CheckFilterInput = { authors: Maybe>; branches: Maybe>; + ids: Maybe>; + includeProposalChecks: Maybe; status: Maybe; subgraphs: Maybe>; + variants: Maybe>; }; -/** Options for filtering CheckWorkflows by status */ +/** + * Options for filtering CheckWorkflows by status + * This should always match CheckWorkflowStatus + */ export enum CheckFilterInputStatusOption { Failed = 'FAILED', Passed = 'PASSED', Pending = 'PENDING' } +/** The result of performing a subgraph check, including all steps. */ export type CheckPartialSchemaResult = { __typename?: 'CheckPartialSchemaResult'; - /** Result of traffic validation. This will be null if composition validation was unsuccessful. */ + /** Overall result of the check. This will be null if composition validation was unsuccessful. */ checkSchemaResult: Maybe; - /** Result of composition validation run before the schema check. */ + /** Result of compostion run as part of the overall subgraph check. */ compositionValidationResult: CompositionValidationResult; - /** Workflow associated with the composition validation. */ + /** Whether any modifications were detected in the composed core schema. */ + coreSchemaModified: Scalars['Boolean']; + /** Check workflow associated with the overall subgraph check. */ workflow: Maybe; }; +/** The possible results of a request to initiate schema checks (either a success object or one of multiple `Error` objects). */ +export type CheckRequestResult = CheckRequestSuccess | InvalidInputError | PermissionError | PlanError; + +/** Represents a successfully initiated execution of schema checks. This does not indicate the _result_ of the checks, only that they were initiated. */ +export type CheckRequestSuccess = { + __typename?: 'CheckRequestSuccess'; + /** The URL of the Apollo Studio page for this check. */ + targetURL: Scalars['String']; + /** The unique ID for this execution of schema checks. */ + workflowID: Scalars['ID']; +}; + +/** Input type to provide when running schema checks asynchronously for a non-federated graph. */ +export type CheckSchemaAsyncInput = { + /** Configuration options for the check execution. */ + config: HistoricQueryParametersInput; + /** The GitHub context to associate with the check. */ + gitContext: GitContextInput; + /** The URL of the GraphQL endpoint that Apollo Sandbox introspected to obtain the proposed schema. Required if `isSandbox` is `true`. */ + introspectionEndpoint: Maybe; + /** If `true`, the check was initiated automatically by a Proposal update. */ + isProposal: Maybe; + /** If `true`, the check was initiated by Apollo Sandbox. */ + isSandbox: Scalars['Boolean']; + proposedSchemaDocument: Maybe; +}; + +/** The result of running schema checks on a graph variant. */ export type CheckSchemaResult = { __typename?: 'CheckSchemaResult'; - /** Schema diff and affected operations generated by the schema check */ + /** The schema diff and affected operations generated by the schema check. */ diffToPrevious: SchemaDiff; - /** ID of the operations check that was created */ + /** The unique ID of this execution of checks. */ operationsCheckID: Scalars['ID']; - /** Generated url to view schema diff in Engine */ + /** The URL to view the schema diff in Studio. */ targetUrl: Maybe; /** Workflow associated with this check result */ workflow: Maybe; }; +export type CheckStepCompleted = { + __typename?: 'CheckStepCompleted'; + id: Scalars['ID']; + status: CheckStepStatus; +}; + +export type CheckStepFailed = { + __typename?: 'CheckStepFailed'; + message: Scalars['String']; +}; + +export type CheckStepInput = { + graphID: Scalars['String']; + graphVariant: Scalars['String']; + taskID: Scalars['ID']; + workflowID: Scalars['ID']; +}; + +export type CheckStepResult = CheckStepCompleted | CheckStepFailed | ValidationError; + +export enum CheckStepStatus { + Failure = 'FAILURE', + Success = 'SUCCESS' +} + export type CheckWorkflow = { __typename?: 'CheckWorkflow'; + /** The schema provided as the base to check against. */ + baseSchemaHash: Maybe; + /** The base subgraphs provided as the base to check against. */ + baseSubgraphs: Maybe>; /** - * The variant provided as a base to check against. Only the differences from the + * The variant provided as a base to check against. Only the differences from the * base schema will be tested in operations checks. */ baseVariant: Maybe; + /** The build task associated with this workflow, or null if no such task was scheduled. */ + buildTask: Maybe; + /** The timestamp when the check workflow completed. */ completedAt: Maybe; createdAt: Scalars['Timestamp']; + /** The downstream task associated with this workflow, or null if no such task kind was scheduled. */ + downstreamTask: Maybe; /** Contextual parameters supplied by the runtime environment where the check was run. */ gitContext: Maybe; + /** The graph this check workflow belongs to. */ + graph: Service; id: Scalars['ID']; /** The name of the implementing service that was responsible for triggering the validation. */ implementingServiceName: Maybe; - /** If this check was created by rerunning, the original check that was rerun. */ + /** If this check is triggered for an sdl fetched using introspection, this is the endpoint where that schema was being served. */ + introspectionEndpoint: Maybe; + /** Only true if the check was triggered from a proposal update. */ + isProposalCheck: Scalars['Boolean']; + /** Only true if the check was triggered from Sandbox Checks page. */ + isSandboxCheck: Scalars['Boolean']; + /** The operations task associated with this workflow, or null if no such task was scheduled. */ + operationsTask: Maybe; + /** The proposed schema being checked by this check workflow. */ + proposedSchemaHash: Maybe; + /** The proposed subgraphs for this check workflow. */ + proposedSubgraphs: Maybe>; + /** If this check was created by rerunning, the original check workflow that was rerun. */ rerunOf: Maybe; /** Checks created by re-running this check, most recent first. */ reruns: Maybe>; + /** The timestamp when the check workflow started. */ startedAt: Maybe; /** Overall status of the workflow, based on the underlying task statuses. */ status: CheckWorkflowStatus; - /** The set of check tasks associated with this workflow, e.g. OperationsCheck, GraphComposition, etc. */ + /** The set of check tasks associated with this workflow, e.g. composition, operations, etc. */ tasks: Array; + /** Identity of the user who ran this check */ + triggeredBy: Maybe; + /** The upstream workflow that triggered this workflow, or null if such an upstream workflow does not exist. */ + upstreamWorkflow: Maybe; /** Configuration of validation at the time the check was run. */ validationConfig: Maybe; }; @@ -1874,16 +3215,14 @@ export type CheckWorkflowRerunsArgs = { export type CheckWorkflowMutation = { __typename?: 'CheckWorkflowMutation'; - /** Re-run a check workflow using the current configuration. A new workflow is created and returned. */ - rerun: Maybe; -}; - -export type CheckWorkflowRerunResult = { - __typename?: 'CheckWorkflowRerunResult'; - /** Check workflow created by re-running. */ - result: Maybe; - /** Check workflow that was rerun. */ - source: Maybe; + /** The graph this check workflow belongs to. */ + graph: Service; + id: Scalars['ID']; + /** + * Re-run a check workflow using the current check configuration. The result is either a workflow ID that + * can be used to check the status or an error message that explains what went wrong. + */ + rerunAsync: CheckRequestResult; }; export enum CheckWorkflowStatus { @@ -1896,7 +3235,15 @@ export type CheckWorkflowTask = { completedAt: Maybe; createdAt: Scalars['Timestamp']; id: Scalars['ID']; + /** + * The status of this task. All tasks start with the PENDING status while initializing. If any + * prerequisite task fails, then the task status becomes BLOCKED. Otherwise, if all prerequisite + * tasks pass, then this task runs (still having the PENDING status). Once the task completes, the + * task status will become either PASSED or FAILED. + */ status: CheckWorkflowTaskStatus; + /** A studio UI url to view the details of this check workflow task */ + targetURL: Maybe; /** The workflow that this task belongs to. */ workflow: CheckWorkflow; }; @@ -1908,12 +3255,12 @@ export enum CheckWorkflowTaskStatus { Pending = 'PENDING' } -/** Client filter configuration for a graph. */ +/** A client to be filtered. */ export type ClientFilter = { __typename?: 'ClientFilter'; - /** name of the client set by the user and reported alongside metrics */ - name: Maybe; - /** version of the client set by the user and reported alongside metrics */ + /** Name of the client is required. */ + name: Scalars['String']; + /** Version string of the client. */ version: Maybe; }; @@ -1923,14 +3270,14 @@ export type ClientFilter = { */ export type ClientFilterInput = { /** name of the client set by the user and reported alongside metrics */ - name: Maybe; + name: Scalars['String']; /** version of the client set by the user and reported alongside metrics */ version: Maybe; }; /** Filter options to exclude by client reference ID, client name, and client version. */ export type ClientInfoFilter = { - name: Maybe; + name: Scalars['String']; /** Ignored */ referenceID: Maybe; version: Maybe; @@ -1939,10 +3286,279 @@ export type ClientInfoFilter = { /** Filter options to exclude clients. Used as an output type for SchemaDiffValidationConfig. */ export type ClientInfoFilterOutput = { __typename?: 'ClientInfoFilterOutput'; - name: Maybe; + name: Scalars['String']; version: Maybe; }; +/** Cloud queries */ +export type Cloud = { + __typename?: 'Cloud'; + /** Return a given RouterConfigVersion */ + configVersion: Maybe; + /** Return all RouterConfigVersions */ + configVersions: Array; + order: Maybe; + /** The regions where a cloud router can be deployed */ + regions: Array; + /** Return the Cloud Router associated with the provided graphRef */ + router: Maybe; + /** Retrieve all routers */ + routers: Array; + /** Return the Shard associated with the provided id */ + shard: Maybe; + /** Return all Shards */ + shards: Array; + /** Information about a specific Cloud Router version */ + version: RouterVersionResult; + /** A list of Cloud Router versions */ + versions: RouterVersionsResult; +}; + + +/** Cloud queries */ +export type CloudConfigVersionArgs = { + name: Scalars['String']; +}; + + +/** Cloud queries */ +export type CloudConfigVersionsArgs = { + first: Maybe; + offset: Maybe; +}; + + +/** Cloud queries */ +export type CloudOrderArgs = { + orderId: Scalars['String']; +}; + + +/** Cloud queries */ +export type CloudRegionsArgs = { + provider: CloudProvider; +}; + + +/** Cloud queries */ +export type CloudRouterArgs = { + id: Scalars['ID']; +}; + + +/** Cloud queries */ +export type CloudRoutersArgs = { + first: Maybe; + offset: Maybe; + statuses: Maybe>; +}; + + +/** Cloud queries */ +export type CloudShardArgs = { + id: Scalars['ID']; +}; + + +/** Cloud queries */ +export type CloudShardsArgs = { + first: Maybe; + offset: Maybe; + provider: Maybe; +}; + + +/** Cloud queries */ +export type CloudVersionArgs = { + version: Scalars['String']; +}; + + +/** Cloud queries */ +export type CloudVersionsArgs = { + input: RouterVersionsInput; +}; + +/** Invalid input error */ +export type CloudInvalidInputError = { + __typename?: 'CloudInvalidInputError'; + /** Argument related to the error */ + argument: Scalars['String']; + /** Location of the error */ + location: Maybe; + /** Reason for the error */ + reason: Scalars['String']; +}; + +/** Cloud mutations */ +export type CloudMutation = { + __typename?: 'CloudMutation'; + /** Create a new RouterConfigVersion */ + createConfigVersion: RouterVersionConfigResult; + /** Create a new Cloud Router */ + createRouter: CreateRouterResult; + /** Create a new Shard */ + createShard: ShardResult; + /** Create a new router version */ + createVersion: CreateRouterVersionResult; + /** Destroy an existing Cloud Router */ + destroyRouter: DestroyRouterResult; + order: Maybe; + /** Fetch a Cloud Router for mutations */ + router: Maybe; + /** Update a RouterConfigVersion */ + updateConfigVersion: RouterVersionConfigResult; + /** Update an existing Cloud Router */ + updateRouter: UpdateRouterResult; + /** Update an existing Shard */ + updateShard: ShardResult; + /** Update an existing router version */ + updateVersion: UpdateRouterVersionResult; +}; + + +/** Cloud mutations */ +export type CloudMutationCreateConfigVersionArgs = { + input: RouterConfigVersionInput; +}; + + +/** Cloud mutations */ +export type CloudMutationCreateRouterArgs = { + id: Scalars['ID']; + input: CreateRouterInput; +}; + + +/** Cloud mutations */ +export type CloudMutationCreateShardArgs = { + input: CreateShardInput; +}; + + +/** Cloud mutations */ +export type CloudMutationCreateVersionArgs = { + version: RouterVersionCreateInput; +}; + + +/** Cloud mutations */ +export type CloudMutationDestroyRouterArgs = { + id: Scalars['ID']; +}; + + +/** Cloud mutations */ +export type CloudMutationOrderArgs = { + orderId: Scalars['String']; +}; + + +/** Cloud mutations */ +export type CloudMutationRouterArgs = { + id: Scalars['ID']; +}; + + +/** Cloud mutations */ +export type CloudMutationUpdateConfigVersionArgs = { + input: RouterConfigVersionInput; +}; + + +/** Cloud mutations */ +export type CloudMutationUpdateRouterArgs = { + id: Scalars['ID']; + input: UpdateRouterInput; +}; + + +/** Cloud mutations */ +export type CloudMutationUpdateShardArgs = { + input: UpdateShardInput; +}; + + +/** Cloud mutations */ +export type CloudMutationUpdateVersionArgs = { + version: RouterVersionUpdateInput; +}; + +/** Cloud onboarding information */ +export type CloudOnboarding = { + __typename?: 'CloudOnboarding'; + /** Graph variant reference for Cloud Onboarding */ + graphRef: Scalars['String']; + /** Cloud provider for Cloud Onboarding */ + provider: CloudProvider; + /** Region for Cloud Onboarding */ + region: RegionDescription; + /** Tier for Cloud Onboarding */ + tier: CloudTier; +}; + +/** Input to create a new Cloud Onboarding */ +export type CloudOnboardingInput = { + /** graph variant name for the onboarding */ + graphRef: Scalars['String']; + /** The cloud provider */ + provider: CloudProvider; + /** Region for the Cloud Onboarding */ + region: Scalars['String']; + /** Tier for the Cloud Onboarding */ + tier: CloudTier; +}; + +/** List of supported cloud providers */ +export enum CloudProvider { + /** Amazon Web Services */ + Aws = 'AWS', + /** Fly.io */ + Fly = 'FLY' +} + +/** Cloud Router tiers */ +export enum CloudTier { + /** Dedicated tier */ + Dedicated = 'DEDICATED', + /** Enterprise Cloud tier */ + Enterprise = 'ENTERPRISE', + /** Serverless tier */ + Serverless = 'SERVERLESS' +} + +/** Validation result */ +export type CloudValidationResult = CloudValidationSuccess | InternalServerError | InvalidInputErrors; + +/** Config validation success */ +export type CloudValidationSuccess = { + __typename?: 'CloudValidationSuccess'; + message: Scalars['String']; +}; + +export type CommentFilter = { + schemaScope: Maybe; + status: Maybe>; + type: Array; +}; + +export enum CommentStatus { + Deleted = 'DELETED', + Open = 'OPEN', + Resolved = 'RESOLVED' +} + +export enum CommentType { + Change = 'CHANGE', + General = 'GENERAL', + Review = 'REVIEW' +} + +export type CommunicationChannel = { + id: Scalars['ID']; + name: Scalars['String']; +}; + export enum ComparisonOperator { Equals = 'EQUALS', GreaterThan = 'GREATER_THAN', @@ -1953,68 +3569,214 @@ export enum ComparisonOperator { Unrecognized = 'UNRECOGNIZED' } -/** Metadata about the result of composition run in the cloud, combined with removing an implementing service */ +export type ComposeAndFilterPreviewBuildResults = { + __typename?: 'ComposeAndFilterPreviewBuildResults'; + /** The API schema document/SDL generated from composition/filtering. */ + apiSchemaDocument: Scalars['String']; + /** The supergraph core schema document/SDL generated from composition/filtering. */ + supergraphSchemaDocument: Scalars['String']; +}; + +export type ComposeAndFilterPreviewComposeError = { + __typename?: 'ComposeAndFilterPreviewComposeError'; + /** A machine-readable error code. See https://www.apollographql.com/docs/federation/errors/for more info. */ + code: Maybe; + /** The step at which composition failed. */ + failedStep: Maybe; + /** Source locations related to the error. */ + locations: Maybe>; + /** A human-readable message describing the error. */ + message: Scalars['String']; +}; + +export type ComposeAndFilterPreviewComposeFailure = { + __typename?: 'ComposeAndFilterPreviewComposeFailure'; + /** The list of errors from failed composition. */ + composeErrors: Array; +}; + +export type ComposeAndFilterPreviewFilterError = { + __typename?: 'ComposeAndFilterPreviewFilterError'; + /** The step at which filtering failed. See https://www.apollographql.com/docs/studio/contracts/#contract-errors for more info. */ + failedStep: Maybe; + /** A human-readable message describing the error. */ + message: Scalars['String']; +}; + +export type ComposeAndFilterPreviewFilterFailure = { + __typename?: 'ComposeAndFilterPreviewFilterFailure'; + /** The results from successful composition. */ + composeResults: ComposeAndFilterPreviewBuildResults; + /** The list of errors from failed filtering. */ + filterErrors: Array; +}; + +export type ComposeAndFilterPreviewResult = ComposeAndFilterPreviewComposeFailure | ComposeAndFilterPreviewFilterFailure | ComposeAndFilterPreviewSuccess; + +export type ComposeAndFilterPreviewSubgraphChange = { + /** + * The info being changed in the named subgraph. If null, indicates that the named + * subgraph should be removed prior to composition. + */ + info: Maybe; + /** The name of the subgraph being changed. */ + name: Scalars['String']; +}; + +export type ComposeAndFilterPreviewSubgraphChangeInfo = { + /** + * The routing URL of the subgraph. If a subgraph with the same name exists, then this + * field can be null to indicate the existing subgraph's info should be used; using + * null otherwise results in an error. + */ + routingUrl: Maybe; + /** + * The schema document/SDL of the subgraph. If a subgraph with the same name exists, + * then this field can be null to indicate the existing subgraph's info should be + * used; using null otherwise results in an error. + */ + schemaDocument: Maybe; +}; + +export type ComposeAndFilterPreviewSuccess = { + __typename?: 'ComposeAndFilterPreviewSuccess'; + /** The results from successful composition. */ + composeResults: ComposeAndFilterPreviewBuildResults; + /** The results from successful filtering, or null if filtering was skipped. */ + filterResults: Maybe; +}; + +/** The result of supergraph composition that Studio performed in response to an attempted deletion of a subgraph. */ export type CompositionAndRemoveResult = { __typename?: 'CompositionAndRemoveResult'; /** The produced composition config. Will be null if there are any errors */ compositionConfig: Maybe; + createdAt: Scalars['Timestamp']; /** Whether the removed implementing service existed. */ didExist: Scalars['Boolean']; - /** - * List of errors during composition. Errors mean that Apollo was unable to compose the - * graph's implementing services into a GraphQL schema. This partial schema should not be - * published to the implementing service if there were any errors encountered. - */ + /** A list of errors that occurred during composition. Errors mean that Apollo was unable to compose the graph variant's subgraphs into a supergraph schema. If any errors are present, gateways / routers are not updated. */ errors: Array>; /** ID that points to the results of composition. */ graphCompositionID: Scalars['String']; /** List of subgraphs that are included in this composition. */ subgraphConfigs: Array; - /** Whether the gateway link was updated, or would have been for dry runs. */ + /** Whether this composition result resulted in a new supergraph schema passed to Uplink (`true`), or the build failed for any reason (`false`). For dry runs, this value is `true` if Uplink _would have_ been updated with the result. */ updatedGateway: Scalars['Boolean']; }; -/** Metadata about the result of composition run in the cloud, combined with implementing service upsert */ +/** The result of supergraph composition that Studio performed in response to an attempted publish of a subgraph. */ export type CompositionAndUpsertResult = { __typename?: 'CompositionAndUpsertResult'; - /** The produced composition config. Will be null if there are any errors */ + /** The generated composition config, or null if any errors occurred. */ compositionConfig: Maybe; - /** - * List of errors during composition. Errors mean that Apollo was unable to compose the - * graph's implementing services into a GraphQL schema. This partial schema should not be - * published to the implementing service if there were any errors encountered - */ + createdAt: Scalars['Timestamp']; + /** A list of errors that occurred during composition. Errors mean that Apollo was unable to compose the graph variant's subgraphs into a supergraph schema. If any errors are present, gateways / routers are not updated. */ errors: Array>; /** ID that points to the results of composition. */ graphCompositionID: Scalars['String']; + /** Human-readable text describing the launch result of the subgraph publish. */ + launchCliCopy: Maybe; + /** The URL of the Studio page for this update's associated launch, if available. */ + launchUrl: Maybe; /** List of subgraphs that are included in this composition. */ subgraphConfigs: Array; - /** Whether the gateway link was updated. */ + /** All subgraphs that were created from this mutation */ + subgraphsCreated: Array; + /** All subgraphs that were updated from this mutation */ + subgraphsUpdated: Array; + /** Whether this composition result resulted in a new supergraph schema passed to Uplink (`true`), or the build failed for any reason (`false`). For dry runs, this value is `true` if Uplink _would have_ been updated with the result. */ updatedGateway: Scalars['Boolean']; - /** Whether an implementingService was created as part of this mutation */ + /** Whether a new subgraph was created as part of this publish. */ wasCreated: Scalars['Boolean']; /** Whether an implementingService was updated as part of this mutation */ wasUpdated: Scalars['Boolean']; }; +export type CompositionBuildCheckFailed = BuildCheckFailed & BuildCheckResult & CompositionBuildCheckResult & { + __typename?: 'CompositionBuildCheckFailed'; + buildInputs: CompositionBuildInputs; + buildPipelineTrack: BuildPipelineTrack; + compositionPackageVersion: Maybe; + errors: Array; + id: Scalars['ID']; + passed: Scalars['Boolean']; + workflowTask: CompositionCheckTask; +}; + +export type CompositionBuildCheckPassed = BuildCheckPassed & BuildCheckResult & CompositionBuildCheckResult & { + __typename?: 'CompositionBuildCheckPassed'; + buildInputs: CompositionBuildInputs; + buildPipelineTrack: BuildPipelineTrack; + compositionPackageVersion: Maybe; + id: Scalars['ID']; + passed: Scalars['Boolean']; + supergraphSchemaHash: Scalars['SHA256']; + workflowTask: CompositionCheckTask; +}; + +export type CompositionBuildCheckResult = { + buildInputs: CompositionBuildInputs; + buildPipelineTrack: BuildPipelineTrack; + /** The version of the OSS apollo composition package used during build */ + compositionPackageVersion: Maybe; + id: Scalars['ID']; + passed: Scalars['Boolean']; + workflowTask: CompositionCheckTask; +}; + export type CompositionBuildInput = { __typename?: 'CompositionBuildInput'; subgraphs: Array; version: Maybe; }; -export type CompositionCheckTask = CheckWorkflowTask & { +export type CompositionBuildInputSubgraph = { + __typename?: 'CompositionBuildInputSubgraph'; + /** The name of the subgraph. */ + name: Scalars['String']; + /** The routing URL of the subgraph. */ + routingUrl: Scalars['String']; + /** The SHA-256 of the schema document of the subgraph. */ + schemaHash: Scalars['SHA256']; +}; + +export type CompositionBuildInputs = { + __typename?: 'CompositionBuildInputs'; + /** + * The build pipeline track used for composition. Note this is also the build pipeline track used + * for any triggered downstream check workflows as well. + */ + buildPipelineTrack: BuildPipelineTrack; + /** The subgraphs used for composition. */ + subgraphs: Array; +}; + +export type CompositionCheckTask = BuildCheckTask & CheckWorkflowTask & { __typename?: 'CompositionCheckTask'; + /** The result of the composition build check. This will be null when the task is initializing or running. */ + buildResult: Maybe; completedAt: Maybe; + /** + * Whether the build's output supergraph core schema differs from that of the active publish for + * the workflow's variant at the time this field executed (NOT at the time the check workflow + * started). + */ + coreSchemaModified: Scalars['Boolean']; createdAt: Scalars['Timestamp']; + graphID: Scalars['ID']; id: Scalars['ID']; - /** The result of the composition. */ + proposedBuildInputChanges: ProposedCompositionBuildInputChanges; + /** + * An old version of buildResult that returns a very old GraphQL type that generally should be + * avoided. This field will soon be deprecated. + */ result: Maybe; status: CheckWorkflowTaskStatus; + targetURL: Maybe; workflow: CheckWorkflow; }; -/** The composition config exposed to the gateway */ +/** Composition configuration exposed to the gateway. */ export type CompositionConfig = { __typename?: 'CompositionConfig'; /** @@ -2022,53 +3784,53 @@ export type CompositionConfig = { * @deprecated Soon we will stop writing to GCS locations */ implementingServiceLocations: Array; - /** Hash of the composed schema */ + /** The resulting API schema's SHA256 hash, represented as a hexadecimal string. */ schemaHash: Scalars['String']; }; -/** Metadata about the result of composition run in the cloud */ +export type CompositionConfigInput = { + subgraphs: Array; +}; + +/** The result of supergraph composition that Studio performed. */ export type CompositionPublishResult = CompositionResult & { __typename?: 'CompositionPublishResult'; - /** The produced composition config. Will be null if there are any errors */ + /** The generated composition config, or null if any errors occurred. */ compositionConfig: Maybe; - /** - * Supergraph SDL generated by composition (this is not the CSDL, that is a deprecated format). - * @deprecated Use supergraphSdl instead - */ - csdl: Maybe; - /** - * List of errors during composition. Errors mean that Apollo was unable to compose the - * graph's implementing services into a GraphQL schema. This partial schema should not be - * published to the implementing service if there were any errors encountered - */ + createdAt: Scalars['Timestamp']; + /** A list of errors that occurred during composition. Errors mean that Apollo was unable to compose the graph variant's subgraphs into a supergraph schema. If any errors are present, gateways / routers are not updated. */ errors: Array; - /** ID that points to the results of this composition. */ + /** The unique ID for this instance of composition. */ graphCompositionID: Scalars['ID']; + graphID: Scalars['ID']; + /** Null if CompositionPublishResult was not on a Proposal Variant */ + proposalRevision: Maybe; + /** + * Cloud router configuration associated with this build event. + * It will be non-null for any cloud-router variant, and null for any not cloudy variant/graph + */ + routerConfig: Maybe; /** List of subgraphs that are included in this composition. */ subgraphConfigs: Array; - /** Supergraph SDL generated by composition. */ + /** The supergraph SDL generated by composition. */ supergraphSdl: Maybe; - /** Whether the gateway link was updated. */ + /** Whether this composition result updated gateway/router instances via Uplink (`true`), or it was a dry run (`false`). */ updatedGateway: Scalars['Boolean']; - webhookNotificationBody: Maybe; }; -/** Result of a composition, either as the result of a composition validation or a publish. */ +/** The result of supergraph composition performed by Apollo Studio, often as the result of a subgraph check or subgraph publish. See individual implementations for more details. */ export type CompositionResult = { - /** - * Supergraph SDL generated by composition (this is not the CSDL, that is a deprecated format). - * @deprecated Use supergraphSdl instead - */ - csdl: Maybe; - /** - * List of errors during composition. Errors mean that Apollo was unable to compose the - * graph's implementing services into a GraphQL schema. This partial schema should not be - * published to the implementing service if there were any errors encountered - */ + createdAt: Scalars['Timestamp']; + /** A list of errors that occurred during composition. Errors mean that Apollo was unable to compose the graph variant's subgraphs into a supergraph schema. If any errors are present, gateways / routers are not updated. */ errors: Array; - /** ID that points to the results of this composition. */ + /** The unique ID for this instance of composition. */ graphCompositionID: Scalars['ID']; - /** List of subgraphs that are included in this composition. */ + /** + * Cloud router configuration associated with this build event. + * It will be non-null for any cloud-router variant, and null for any not cloudy variant/graph + */ + routerConfig: Maybe; + /** List of subgraphs included in this composition. */ subgraphConfigs: Array; /** Supergraph SDL generated by composition. */ supergraphSdl: Maybe; @@ -2087,81 +3849,94 @@ export type CompositionStatusSubscription = ChannelSubscription & { /** The composition config exposed to the gateway */ export type CompositionValidationDetails = { __typename?: 'CompositionValidationDetails'; - /** List of implementing service partial schemas that comprised the graph composed during validation */ - implementingServices: Array; /** Hash of the composed schema */ schemaHash: Maybe; }; -/** Metadata about the result of compositions validation run in the cloud */ +/** The result of composition validation run by Apollo Studio during a subgraph check. */ export type CompositionValidationResult = CompositionResult & { __typename?: 'CompositionValidationResult'; /** Describes whether composition succeeded. */ compositionSuccess: Scalars['Boolean']; /** - * Akin to a composition config, represents the partial schemas and implementing services that were used + * Akin to a composition config, represents the subgraph schemas and corresponding subgraphs that were used * in running composition. Will be null if any errors are encountered. Also may contain a schema hash if * one could be computed, which can be used for schema validation. */ compositionValidationDetails: Maybe; - /** - * Supergraph SDL generated by composition (this is not the CSDL, that is a deprecated format). - * @deprecated Use supergraphSdl instead - */ - csdl: Maybe; - /** - * List of errors during composition. Errors mean that Apollo was unable to compose the - * graph's implementing services into a GraphQL schema. This partial schema should not be - * published to the implementing service if there were any errors encountered - */ + createdAt: Scalars['Timestamp']; + /** A list of errors that occurred during composition. Errors mean that Apollo was unable to compose the graph variant's subgraphs into a supergraph schema. If any errors are present, gateways / routers are not updated. */ errors: Array; - /** ID that points to the results of this composition. */ + /** The unique ID for this instance of composition. */ graphCompositionID: Scalars['ID']; /** The implementing service that was responsible for triggering the validation */ proposedImplementingService: FederatedImplementingServicePartialSchema; + /** + * Cloud router configuration associated with this build event. + * It will be non-null for any cloud-router variant, and null for any not cloudy variant/graph + */ + routerConfig: Maybe; /** List of subgraphs that are included in this composition. */ subgraphConfigs: Array; - /** Supergraph SDL generated by composition. */ + /** The supergraph schema document generated by composition. */ supergraphSdl: Maybe; /** If created as part of a check workflow, the associated workflow task. */ workflowTask: Maybe; }; +export type ContractConfigInput = { + baseGraphRef: Scalars['String']; + filterConfigInput: FilterConfigInput; +}; + +export type ContractPreview = { + __typename?: 'ContractPreview'; + result: ContractPreviewResult; + upstreamLaunch: Launch; +}; + +export type ContractPreviewErrors = { + __typename?: 'ContractPreviewErrors'; + errors: Array; + failedAt: ContractVariantFailedStep; +}; + +export type ContractPreviewResult = ContractPreviewErrors | ContractPreviewSuccess; + +export type ContractPreviewSuccess = { + __typename?: 'ContractPreviewSuccess'; + apiDocument: Scalars['String']; + coreDocument: Scalars['String']; + fieldCount: Scalars['Int']; + typeCount: Scalars['Int']; +}; + export enum ContractVariantFailedStep { + AddDirectiveDefinitionsIfNotPresent = 'ADD_DIRECTIVE_DEFINITIONS_IF_NOT_PRESENT', + AddInaccessibleSpecPurpose = 'ADD_INACCESSIBLE_SPEC_PURPOSE', DirectiveDefinitionLocationAugmenting = 'DIRECTIVE_DEFINITION_LOCATION_AUGMENTING', + EmptyEnumMasking = 'EMPTY_ENUM_MASKING', + EmptyInputObjectMasking = 'EMPTY_INPUT_OBJECT_MASKING', + EmptyObjectAndInterfaceFieldMasking = 'EMPTY_OBJECT_AND_INTERFACE_FIELD_MASKING', EmptyObjectAndInterfaceMasking = 'EMPTY_OBJECT_AND_INTERFACE_MASKING', EmptyUnionMasking = 'EMPTY_UNION_MASKING', - EnsureQueryTypeAccessible = 'ENSURE_QUERY_TYPE_ACCESSIBLE', InputValidation = 'INPUT_VALIDATION', Parsing = 'PARSING', ParsingTagDirectives = 'PARSING_TAG_DIRECTIVES', PartialInterfaceMasking = 'PARTIAL_INTERFACE_MASKING', SchemaRetrieval = 'SCHEMA_RETRIEVAL', + TagInheriting = 'TAG_INHERITING', TagMatching = 'TAG_MATCHING', ToApiSchema = 'TO_API_SCHEMA', ToFilterSchema = 'TO_FILTER_SCHEMA', - Unknown = 'UNKNOWN' + Unknown = 'UNKNOWN', + UnreachableTypeMasking = 'UNREACHABLE_TYPE_MASKING', + VersionCheck = 'VERSION_CHECK' } -export type ContractVariantPreviewErrors = { - __typename?: 'ContractVariantPreviewErrors'; - errorMessages: Array; - failedStep: ContractVariantFailedStep; -}; - -export type ContractVariantPreviewResult = ContractVariantPreviewErrors | ContractVariantPreviewSuccess; - -export type ContractVariantPreviewSuccess = { - __typename?: 'ContractVariantPreviewSuccess'; - allTags: Array; - baseApiSchema: Scalars['String']; - baseCoreSchema: Scalars['String']; - contractApiSchema: Scalars['String']; - contractCoreSchema: Scalars['String']; -}; - export type ContractVariantUpsertErrors = { __typename?: 'ContractVariantUpsertErrors'; + /** A list of all errors that occurred when attempting to create or update a contract variant. */ errorMessages: Array; }; @@ -2169,14 +3944,141 @@ export type ContractVariantUpsertResult = ContractVariantUpsertErrors | Contract export type ContractVariantUpsertSuccess = { __typename?: 'ContractVariantUpsertSuccess'; + /** The updated contract variant */ contractVariant: GraphVariant; + /** Human-readable text describing the launch result of the contract update. */ + launchCliCopy: Maybe; + /** The URL of the Studio page for this update's associated launch, if available. */ + launchUrl: Maybe; +}; + +export type Coordinate = { + __typename?: 'Coordinate'; + byteOffset: Scalars['Int']; + column: Scalars['Int']; + line: Scalars['Int']; }; +/** Contains the supergraph and API schemas generated by composition. */ export type CoreSchema = { __typename?: 'CoreSchema'; + /** The composed API schema document. */ apiDocument: Scalars['GraphQLDocument']; + /** The composed supergraph schema document. */ coreDocument: Scalars['GraphQLDocument']; + /** The supergraph schema document's SHA256 hash, represented as a hexadecimal string. */ coreHash: Scalars['String']; + fieldCount: Scalars['Int']; + tags: Array; + typeCount: Scalars['Int']; +}; + +/** Input to create a new AWS shard */ +export type CreateAwsShardInput = { + accountId: Scalars['String']; + ecsClusterArn: Scalars['String']; + endpoint: Scalars['String']; + iamRoleArn: Scalars['String']; + loadbalancerArn: Scalars['String']; + loadbalancerListenerArn: Scalars['String']; + loadbalancerSecurityGroupId: Scalars['String']; + permissionsBoundaryArn: Scalars['String']; + region: Scalars['String']; + subnetIds: Array; + vpcId: Scalars['String']; +}; + +/** Input to create a new Fly shard */ +export type CreateFlyShardInput = { + endpoint: Scalars['String']; + etcdEndpoints: Array; + organizationId: Scalars['String']; + region: Scalars['String']; +}; + +/** Result from the createCloudOnboarding mutation */ +export type CreateOnboardingResult = CreateOnboardingSuccess | InternalServerError | InvalidInputErrors; + +/** Success creating a CloudOnboarding */ +export type CreateOnboardingSuccess = { + __typename?: 'CreateOnboardingSuccess'; + onboarding: CloudOnboarding; +}; + +export type CreateOperationCollectionResult = OperationCollection | PermissionError | ValidationError; + +export type CreatePersistedQueryListResult = { + __typename?: 'CreatePersistedQueryListResult'; + persistedQueryList: PersistedQueryList; +}; + +export type CreatePersistedQueryListResultOrError = CreatePersistedQueryListResult | PermissionError; + +/** An error that occurs when creating a proposal fails. */ +export type CreateProposalError = Error & { + __typename?: 'CreateProposalError'; + /** The error's details. */ + message: Scalars['String']; +}; + +export type CreateProposalInput = { + description: Maybe; + displayName: Scalars['String']; + sourceVariantName: Scalars['String']; +}; + +export type CreateProposalResult = CreateProposalError | GraphVariant | PermissionError | ValidationError; + +/** Input to create a new Cloud Router */ +export type CreateRouterInput = { + /** + * Number of GCUs allocated for the Cloud Router + * + * This is ignored for serverless Cloud Routers + */ + gcus: Maybe; + /** Graph composition ID, also known as launch ID */ + graphCompositionId: Maybe; + /** Unique identifier for ordering orders */ + orderingId: Scalars['String']; + /** Configuration for the Cloud Router */ + routerConfig: Maybe; + /** URL for the Cloud Router */ + routerUrl: Maybe; + /** Router version for the Cloud Router */ + routerVersion: Maybe; +}; + +/** Represents the possible outcomes of a createRouter mutation */ +export type CreateRouterResult = CreateRouterSuccess | InternalServerError | InvalidInputErrors; + +/** + * Success branch of a createRouter mutation + * + * id of the order can be polled + * via Query.cloud().order(id: ID!) to check-in on the progress + * of the underlying operation + */ +export type CreateRouterSuccess = { + __typename?: 'CreateRouterSuccess'; + order: Order; +}; + +/** Result of a createVersion mutation */ +export type CreateRouterVersionResult = CloudInvalidInputError | InternalServerError | RouterVersion; + +/** Input to create a new Shard */ +export type CreateShardInput = { + aws: Maybe; + fly: Maybe; + gcuCapacity: Maybe; + gcuUsage: Maybe; + provider: CloudProvider; + routerCapacity: Maybe; + routerUsage: Maybe; + shardId: Scalars['String']; + status: Maybe; + tier: CloudTier; }; export type CronExecution = { @@ -2203,9 +4105,40 @@ export type CronJobRecentExecutionsArgs = { n: Maybe; }; +export type CustomerAccount = { + __typename?: 'CustomerAccount'; + id: Scalars['ID']; + name: Scalars['String']; + next: Maybe; + studioOrgId: Scalars['ID']; + traits: AccountCustomerTraits; +}; + +export type CustomerOrg = { + __typename?: 'CustomerOrg'; + accounts: Array; + externalSlackChannelId: Maybe; + id: Scalars['ID']; + internalSlackChannelId: Maybe; + name: Scalars['String']; + next: Maybe; + sfdcId: Scalars['ID']; + traits: OrgCustomerTraits; +}; + +export type CustomerSupportSlackError = { + __typename?: 'CustomerSupportSlackError'; + message: Scalars['String']; +}; + export enum DatadogApiRegion { Eu = 'EU', - Us = 'US' + Eu1 = 'EU1', + Us = 'US', + Us1 = 'US1', + Us1Fed = 'US1FED', + Us3 = 'US3', + Us5 = 'US5' } export type DatadogMetricsConfig = { @@ -2216,17 +4149,69 @@ export type DatadogMetricsConfig = { legacyMetricNames: Scalars['Boolean']; }; -export type DeleteSchemaTagResult = { - __typename?: 'DeleteSchemaTagResult'; - deleted: Scalars['Boolean']; - deletedSubscriptionIDs: Array; +export type DeleteCommentInput = { + id: Scalars['String']; }; -export enum DeletionTargetType { +export type DeleteCommentResult = DeleteCommentSuccess | NotFoundError | PermissionError | ValidationError; + +export type DeleteCommentSuccess = { + __typename?: 'DeleteCommentSuccess'; + comment: Maybe; +}; + +export type DeleteCommentSuccessResult = ParentChangeProposalComment | ParentGeneralProposalComment; + +export type DeleteOperationCollectionResult = DeleteOperationCollectionSuccess | PermissionError; + +export type DeleteOperationCollectionSuccess = { + __typename?: 'DeleteOperationCollectionSuccess'; + sandboxOwner: Maybe; + variants: Array; +}; + +export type DeletePersistedQueryListResult = { + __typename?: 'DeletePersistedQueryListResult'; + graph: Service; +}; + +export type DeletePersistedQueryListResultOrError = CannotDeleteLinkedPersistedQueryListError | DeletePersistedQueryListResult | PermissionError; + +export type DeleteProposalSubgraphInput = { + previousLaunchId: Maybe; + subgraphName: Scalars['String']; + summary: Scalars['String']; +}; + +export type DeleteProposalSubgraphResult = PermissionError | Proposal | ValidationError; + +/** The result of attempting to delete a graph variant. */ +export type DeleteSchemaTagResult = { + __typename?: 'DeleteSchemaTagResult'; + /** Whether the variant was deleted or not. */ + deleted: Scalars['Boolean']; +}; + +export enum DeletionTargetType { Account = 'ACCOUNT', User = 'USER' } +/** Represents the possible outcomes of a destroyRouter mutation */ +export type DestroyRouterResult = DestroyRouterSuccess | InternalServerError | InvalidInputErrors; + +/** Success branch of a destroyRouter mutation */ +export type DestroyRouterSuccess = { + __typename?: 'DestroyRouterSuccess'; + /** + * Order for the destroyRouter mutation + * + * This could be empty if the router is already destroyed or doesn't exist, but should still + * be treated as a success. + */ + order: Maybe; +}; + /** Support for a single directive on a graph variant */ export type DirectiveSupportStatus = { __typename?: 'DirectiveSupportStatus'; @@ -2236,6 +4221,63 @@ export type DirectiveSupportStatus = { name: Scalars['String']; }; +/** The result of a schema checks workflow that was run on a downstream variant as part of checks for the corresponding source variant. Most commonly, these downstream checks are [contract checks](https://www.apollographql.com/docs/studio/contracts#contract-checks). */ +export type DownstreamCheckResult = { + __typename?: 'DownstreamCheckResult'; + /** Whether the downstream check workflow blocks the upstream check workflow from completing. */ + blocking: Scalars['Boolean']; + /** The ID of the graph that the downstream variant belongs to. */ + downstreamGraphID: Scalars['String']; + /** The name of the downstream variant. */ + downstreamVariantName: Scalars['String']; + /** + * The downstream checks workflow that this result corresponds to. This value is null + * if the workflow hasn't been initialized yet, or if the downstream variant was deleted. + */ + downstreamWorkflow: Maybe; + /** + * Whether the downstream check workflow is causing the upstream check workflow to fail. This occurs + * when the downstream check workflow is both blocking and failing. This may be null while the + * downstream check workflow is pending. + */ + failsUpstreamWorkflow: Maybe; + /** The downstream checks task that this result corresponds to. */ + workflowTask: DownstreamCheckTask; +}; + +export type DownstreamCheckTask = CheckWorkflowTask & { + __typename?: 'DownstreamCheckTask'; + completedAt: Maybe; + createdAt: Scalars['Timestamp']; + id: Scalars['ID']; + /** + * A list of results for all downstream checks triggered as part of the source variant's checks workflow. + * This value is null if the task hasn't been initialized yet, or if the build task fails (the build task is a + * prerequisite to this task). This value is _not_ null _while_ the task is running. The returned list is empty + * if the source variant has no downstream variants. + */ + results: Maybe>; + status: CheckWorkflowTaskStatus; + targetURL: Maybe; + workflow: CheckWorkflow; +}; + +export type DraftInvoice = { + __typename?: 'DraftInvoice'; + billingPeriodEndsAt: Scalars['Timestamp']; + billingPeriodStartsAt: Scalars['Timestamp']; + /** The approximate date in the future we expect the customer to be billed if they fully complete the billing cycle */ + expectedInvoiceAt: Scalars['Timestamp']; + /** When this invoice was sent to the customer, if it's been sent */ + invoicedAt: Maybe; + /** Breakdown of this invoice's charges. May be empty if we don't have a breakdown */ + lineItems: Maybe>; + subtotalInCents: Scalars['Int']; + totalInCents: Scalars['Int']; +}; + +export type DuplicateOperationCollectionResult = OperationCollection | PermissionError | ValidationError; + export type DurationHistogram = { __typename?: 'DurationHistogram'; averageDurationMs: Maybe; @@ -2367,6 +4409,13 @@ export type EdgeServerInfosRecord = { timestamp: Scalars['Timestamp']; }; +export type EditCommentInput = { + id: Scalars['String']; + message: Scalars['String']; +}; + +export type EditCommentResult = NotFoundError | ParentChangeProposalComment | ParentGeneralProposalComment | PermissionError | ReplyChangeProposalComment | ReplyGeneralProposalComment | ValidationError; + export enum EmailCategory { Educational = 'EDUCATIONAL' } @@ -2378,6 +4427,32 @@ export type EmailPreferences = { unsubscribedFromAll: Scalars['Boolean']; }; +export type EndUsageBasedPlanResult = Account | NotFoundError | PermissionError | ValidationError; + +export type EntitiesError = { + __typename?: 'EntitiesError'; + message: Scalars['String']; +}; + +export type EntitiesErrorResponse = { + __typename?: 'EntitiesErrorResponse'; + errors: Array; +}; + +export type EntitiesResponse = { + __typename?: 'EntitiesResponse'; + entities: Array; +}; + +export type EntitiesResponseOrError = EntitiesErrorResponse | EntitiesResponse; + +export type Entity = { + __typename?: 'Entity'; + subgraphKeys: Maybe>; + typename: Scalars['String']; +}; + +/** GraphQL Error */ export type Error = { message: Scalars['String']; }; @@ -2502,6 +4577,7 @@ export type ExcludedOperationInput = { export type FeatureIntros = { __typename?: 'FeatureIntros'; + /** @deprecated No longer supported */ devGraph: Scalars['Boolean']; federatedGraph: Scalars['Boolean']; freeConsumerSeats: Scalars['Boolean']; @@ -2509,40 +4585,30 @@ export type FeatureIntros = { /** Feature Intros Input Type */ export type FeatureIntrosInput = { - devGraph: Maybe; federatedGraph: Maybe; freeConsumerSeats: Maybe; }; +/** A single subgraph in a supergraph. Every supergraph managed by Apollo Studio includes at least one subgraph. See https://www.apollographql.com/docs/federation/managed-federation/overview/ for more information. */ export type FederatedImplementingService = { __typename?: 'FederatedImplementingService'; - /** - * An implementing service could have multiple inactive partial schemas that were previously uploaded - * activePartialSchema returns the one that is designated to be used for composition for a given graph-variant - */ + /** The subgraph's current active schema, used in supergraph composition for the the associated variant. */ activePartialSchema: PartialSchema; - /** Timestamp of when this implementing service was created */ + /** The timestamp when the subgraph was created. */ createdAt: Scalars['Timestamp']; - /** - * Identifies which graph this implementing service belongs to. - * Formerly known as "service_id" - */ + /** The timestamp when the subgraph was deleted. Null if it wasn't deleted. */ + deletedAt: Maybe; + /** The ID of the graph this subgraph belongs to. */ graphID: Scalars['String']; - /** - * Specifies which variant of a graph this implementing service belongs to". - * Formerly known as "tag" - */ + /** The name of the graph variant this subgraph belongs to. */ graphVariant: Scalars['String']; - /** Name of the implementing service */ + /** The subgraph's name. */ name: Scalars['String']; - /** - * A way to capture some customer-specific way of tracking which version / edition - * of the ImplementingService this is. Typically a Git SHA or docker image ID. - */ + /** The current user-provided version/edition of the subgraph. Typically a Git SHA or docker image ID. */ revision: Scalars['String']; - /** Timestamp for when this implementing service was updated */ + /** The timestamp when the subgraph was most recently updated. */ updatedAt: Scalars['Timestamp']; - /** URL of the graphql endpoint of the implementing service */ + /** The URL of the subgraph's GraphQL endpoint. */ url: Maybe; }; @@ -2555,15 +4621,17 @@ export type FederatedImplementingServicePartialSchema = { sdl: Scalars['String']; }; -/** List of federated implementing services that compose a graph */ +/** Container for a list of subgraphs composing a supergraph. */ export type FederatedImplementingServices = { __typename?: 'FederatedImplementingServices'; + /** The list of underlying subgraphs. */ services: Array; }; +/** Counts of changes at the field level, including objects, interfaces, and input fields. */ export type FieldChangeSummaryCounts = { __typename?: 'FieldChangeSummaryCounts'; - /** Number of changes that are additions of fields to object and interface types. */ + /** Number of changes that are additions of fields to object, interface, and input types. */ additions: Scalars['Int']; /** * Number of changes that are field edits. This includes fields changing type and any field @@ -2571,13 +4639,167 @@ export type FieldChangeSummaryCounts = { * field changes. */ edits: Scalars['Int']; - /** Number of changes that are removals of fields from object and interface types. */ + /** Number of changes that are removals of fields from object, interface, and input types. */ removals: Scalars['Int']; }; +/** Columns of FieldExecutions. */ +export enum FieldExecutionsColumn { + ErrorsCount = 'ERRORS_COUNT', + EstimatedExecutionCount = 'ESTIMATED_EXECUTION_COUNT', + FieldName = 'FIELD_NAME', + ObservedExecutionCount = 'OBSERVED_EXECUTION_COUNT', + ParentType = 'PARENT_TYPE', + ReferencingOperationCount = 'REFERENCING_OPERATION_COUNT', + RequestsWithErrorsCount = 'REQUESTS_WITH_ERRORS_COUNT', + SchemaTag = 'SCHEMA_TAG', + ServiceId = 'SERVICE_ID', + Timestamp = 'TIMESTAMP' +} + +export type FieldExecutionsDimensions = { + __typename?: 'FieldExecutionsDimensions'; + fieldName: Maybe; + parentType: Maybe; + schemaTag: Maybe; + serviceId: Maybe; +}; + +/** Filter for data in FieldExecutions. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ +export type FieldExecutionsFilter = { + and: Maybe>; + /** Selects rows whose fieldName dimension equals the given value if not null. To query for the null value, use {in: {fieldName: [null]}} instead. */ + fieldName: Maybe; + in: Maybe; + not: Maybe; + or: Maybe>; + /** Selects rows whose parentType dimension equals the given value if not null. To query for the null value, use {in: {parentType: [null]}} instead. */ + parentType: Maybe; + /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ + schemaTag: Maybe; + /** Selects rows whose serviceId dimension equals the given value if not null. To query for the null value, use {in: {serviceId: [null]}} instead. */ + serviceId: Maybe; +}; + +/** Filter for data in FieldExecutions. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ +export type FieldExecutionsFilterIn = { + /** Selects rows whose fieldName dimension is in the given list. A null value in the list means a row with null for that dimension. */ + fieldName: Maybe>>; + /** Selects rows whose parentType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + parentType: Maybe>>; + /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ + schemaTag: Maybe>>; + /** Selects rows whose serviceId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + serviceId: Maybe>>; +}; + +export type FieldExecutionsMetrics = { + __typename?: 'FieldExecutionsMetrics'; + errorsCount: Scalars['Long']; + estimatedExecutionCount: Scalars['Long']; + observedExecutionCount: Scalars['Long']; + referencingOperationCount: Scalars['Long']; + requestsWithErrorsCount: Scalars['Long']; +}; + +export type FieldExecutionsOrderBySpec = { + column: FieldExecutionsColumn; + direction: Ordering; +}; + +export type FieldExecutionsRecord = { + __typename?: 'FieldExecutionsRecord'; + /** Dimensions of FieldExecutions that can be grouped by. */ + groupBy: FieldExecutionsDimensions; + /** Metrics of FieldExecutions that can be aggregated over. */ + metrics: FieldExecutionsMetrics; + /** Starting segment timestamp. */ + timestamp: Scalars['Timestamp']; +}; + +export type FieldInsights = { + __typename?: 'FieldInsights'; + /** If the first or last seen timestamps are earlier than this timestamp, we can't tell the exact date that we saw this field since our data is bound by the retention period. */ + earliestRetentionTime: Maybe; + /** The earliest time we saw references or executions for this field. Null if the field has never been seen or it is not in the schema. */ + firstSeen: Maybe; + /** The most recent time we saw references or executions for this field. Null if the field has never been seen or it is not in the schema. */ + lastSeen: Maybe; +}; + +export type FieldInsightsListFilterInInput = { + clientName: Maybe>>; + clientVersion: Maybe>>; +}; + +export type FieldInsightsListFilterInput = { + clientName: Maybe; + clientVersion: Maybe; + in: Maybe; + isDeprecated: Maybe; + isUnused: Maybe; + or: Maybe>; + /** Filters on partial string matches of Parent Type and Field Name */ + search: Maybe; +}; + +export type FieldInsightsListItem = { + __typename?: 'FieldInsightsListItem'; + description: Maybe; + errorCount: Scalars['Long']; + errorCountPerMin: Scalars['Float']; + errorPercentage: Scalars['Float']; + estimatedExecutionCount: Scalars['Long']; + executionCount: Scalars['Long']; + fieldName: Scalars['String']; + isDeprecated: Scalars['Boolean']; + isUnused: Scalars['Boolean']; + p50LatencyMs: Scalars['Float']; + p90LatencyMs: Scalars['Float']; + p95LatencyMs: Scalars['Float']; + p99LatencyMs: Scalars['Float']; + parentType: Scalars['String']; + referencingOperationCount: Scalars['Long']; + referencingOperationCountPerMin: Scalars['Float']; + /** @deprecated Use p50LatencyMs, p90LatencyMs, p95LatencyMs, or p99LatencyMs instead */ + totalLatencyHistogram: DurationHistogram; +}; + +export enum FieldInsightsListOrderByColumn { + ErrorCount = 'ERROR_COUNT', + ErrorCountPerMin = 'ERROR_COUNT_PER_MIN', + ErrorPercentage = 'ERROR_PERCENTAGE', + EstimatedExecutionCount = 'ESTIMATED_EXECUTION_COUNT', + ExecutionCount = 'EXECUTION_COUNT', + ParentTypeAndFieldName = 'PARENT_TYPE_AND_FIELD_NAME', + ReferencingOperationCount = 'REFERENCING_OPERATION_COUNT', + ReferencingOperationCountPerMin = 'REFERENCING_OPERATION_COUNT_PER_MIN', + ServiceTimeP50 = 'SERVICE_TIME_P50', + ServiceTimeP90 = 'SERVICE_TIME_P90', + ServiceTimeP95 = 'SERVICE_TIME_P95', + ServiceTimeP99 = 'SERVICE_TIME_P99' +} + +export type FieldInsightsListOrderByInput = { + column: FieldInsightsListOrderByColumn; + direction: Ordering; +}; + +/** Information about pagination in a connection. */ +export type FieldInsightsListPageInfo = { + __typename?: 'FieldInsightsListPageInfo'; + /** When paginating forwards, the cursor to continue. */ + endCursor: Maybe; + /** Not implemented. Always returns true */ + hasNextPage: Scalars['Boolean']; + /** Not implemented. Always returns true */ + hasPreviousPage: Scalars['Boolean']; + /** When paginating backwards, the cursor to continue. */ + startCursor: Maybe; +}; + /** Columns of FieldLatencies. */ export enum FieldLatenciesColumn { - Field = 'FIELD', FieldHistogram = 'FIELD_HISTOGRAM', FieldName = 'FIELD_NAME', ParentType = 'PARENT_TYPE', @@ -2600,8 +4822,6 @@ export type FieldLatenciesDimensions = { /** Filter for data in FieldLatencies. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ export type FieldLatenciesFilter = { and: Maybe>; - /** Selects rows whose field dimension equals the given value if not null. To query for the null value, use {in: {field: [null]}} instead. */ - field: Maybe; /** Selects rows whose fieldName dimension equals the given value if not null. To query for the null value, use {in: {fieldName: [null]}} instead. */ fieldName: Maybe; in: Maybe; @@ -2619,8 +4839,6 @@ export type FieldLatenciesFilter = { /** Filter for data in FieldLatencies. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ export type FieldLatenciesFilterIn = { - /** Selects rows whose field dimension is in the given list. A null value in the list means a row with null for that dimension. */ - field: Maybe>>; /** Selects rows whose fieldName dimension is in the given list. A null value in the list means a row with null for that dimension. */ fieldName: Maybe>>; /** Selects rows whose parentType dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -2657,9 +4875,11 @@ export type FieldLatenciesRecord = { export enum FieldUsageColumn { ClientName = 'CLIENT_NAME', ClientVersion = 'CLIENT_VERSION', + EstimatedExecutionCount = 'ESTIMATED_EXECUTION_COUNT', ExecutionCount = 'EXECUTION_COUNT', - Field = 'FIELD', FieldName = 'FIELD_NAME', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', ParentType = 'PARENT_TYPE', QueryId = 'QUERY_ID', QueryName = 'QUERY_NAME', @@ -2674,8 +4894,9 @@ export type FieldUsageDimensions = { __typename?: 'FieldUsageDimensions'; clientName: Maybe; clientVersion: Maybe; - field: Maybe; fieldName: Maybe; + operationSubtype: Maybe; + operationType: Maybe; parentType: Maybe; queryId: Maybe; queryName: Maybe; @@ -2691,12 +4912,14 @@ export type FieldUsageFilter = { clientName: Maybe; /** Selects rows whose clientVersion dimension equals the given value if not null. To query for the null value, use {in: {clientVersion: [null]}} instead. */ clientVersion: Maybe; - /** Selects rows whose field dimension equals the given value if not null. To query for the null value, use {in: {field: [null]}} instead. */ - field: Maybe; /** Selects rows whose fieldName dimension equals the given value if not null. To query for the null value, use {in: {fieldName: [null]}} instead. */ fieldName: Maybe; in: Maybe; not: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; or: Maybe>; /** Selects rows whose parentType dimension equals the given value if not null. To query for the null value, use {in: {parentType: [null]}} instead. */ parentType: Maybe; @@ -2718,10 +4941,12 @@ export type FieldUsageFilterIn = { clientName: Maybe>>; /** Selects rows whose clientVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ clientVersion: Maybe>>; - /** Selects rows whose field dimension is in the given list. A null value in the list means a row with null for that dimension. */ - field: Maybe>>; /** Selects rows whose fieldName dimension is in the given list. A null value in the list means a row with null for that dimension. */ fieldName: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; /** Selects rows whose parentType dimension is in the given list. A null value in the list means a row with null for that dimension. */ parentType: Maybe>>; /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -2738,6 +4963,7 @@ export type FieldUsageFilterIn = { export type FieldUsageMetrics = { __typename?: 'FieldUsageMetrics'; + estimatedExecutionCount: Scalars['Long']; executionCount: Scalars['Long']; referencingOperationCount: Scalars['Long']; }; @@ -2757,1317 +4983,4631 @@ export type FieldUsageRecord = { timestamp: Scalars['Timestamp']; }; +export type FilterBuildCheckFailed = BuildCheckFailed & BuildCheckResult & FilterBuildCheckResult & { + __typename?: 'FilterBuildCheckFailed'; + buildInputs: FilterBuildInputs; + buildPipelineTrack: BuildPipelineTrack; + errors: Array; + id: Scalars['ID']; + passed: Scalars['Boolean']; + workflowTask: FilterCheckTask; +}; + +export type FilterBuildCheckPassed = BuildCheckPassed & BuildCheckResult & FilterBuildCheckResult & { + __typename?: 'FilterBuildCheckPassed'; + buildInputs: FilterBuildInputs; + buildPipelineTrack: BuildPipelineTrack; + id: Scalars['ID']; + passed: Scalars['Boolean']; + supergraphSchemaHash: Scalars['SHA256']; + workflowTask: FilterCheckTask; +}; + +export type FilterBuildCheckResult = { + buildInputs: FilterBuildInputs; + buildPipelineTrack: BuildPipelineTrack; + id: Scalars['ID']; + passed: Scalars['Boolean']; + workflowTask: FilterCheckTask; +}; + +/** Inputs provided to the build for a contract variant, which filters types and fields from a source variant's schema. */ export type FilterBuildInput = { __typename?: 'FilterBuildInput'; + /** Schema filtering rules for the build, such as tags to include or exclude from the source variant schema. */ filterConfig: FilterConfig; + /** The source variant schema document's SHA256 hash, represented as a hexadecimal string. */ schemaHash: Scalars['String']; }; +export type FilterBuildInputs = { + __typename?: 'FilterBuildInputs'; + /** + * The build pipeline track used for filtering. Note this is taken from upstream check workflow + * or launch. + */ + buildPipelineTrack: BuildPipelineTrack; + /** The exclude filters used for filtering. */ + exclude: Array; + /** + * Whether to hide unreachable objects, interfaces, unions, inputs, enums and scalars from + * the resulting contract schema. + */ + hideUnreachableTypes: Scalars['Boolean']; + /** The include filters used for filtering. */ + include: Array; + /** The SHA-256 of the supergraph schema document used for filtering. */ + supergraphSchemaHash: Scalars['SHA256']; +}; + +export type FilterCheckAsyncInput = { + config: HistoricQueryParametersInput; + filterChanges: FilterCheckFilterChanges; + gitContext: GitContextInput; +}; + +export type FilterCheckFilterChanges = { + excludeAdditions: Maybe>; + excludeRemovals: Maybe>; + hideUnreachableTypesChange: Maybe; + includeAdditions: Maybe>; + includeRemovals: Maybe>; +}; + +export type FilterCheckTask = BuildCheckTask & CheckWorkflowTask & { + __typename?: 'FilterCheckTask'; + /** The result of the filter build check. This will be null when the task is initializing or running. */ + buildResult: Maybe; + completedAt: Maybe; + createdAt: Scalars['Timestamp']; + id: Scalars['ID']; + proposedBuildInputChanges: ProposedFilterBuildInputChanges; + status: CheckWorkflowTaskStatus; + targetURL: Maybe; + workflow: CheckWorkflow; +}; + +/** The filter configuration used to build a contract schema. The configuration consists of lists of tags for schema elements to include or exclude in the resulting schema. */ export type FilterConfig = { __typename?: 'FilterConfig'; + /** Tags of schema elements to exclude from the contract schema. */ exclude: Array; + /** Whether to hide unreachable objects, interfaces, unions, inputs, enums and scalars from the resulting contract schema. */ + hideUnreachableTypes: Scalars['Boolean']; + /** Tags of schema elements to include in the contract schema. */ include: Array; }; export type FilterConfigInput = { + /** A list of tags for schema elements to exclude from the resulting contract schema. */ exclude: Array; + /** + * Whether to hide unreachable objects, interfaces, unions, inputs, enums and scalars from + * the resulting contract schema. Defaults to `false`. + */ + hideUnreachableTypes: Scalars['Boolean']; + /** A list of tags for schema elements to include in the resulting contract schema. */ include: Array; }; -export type GitContext = { - __typename?: 'GitContext'; - branch: Maybe; - commit: Maybe; - commitUrl: Maybe; - committer: Maybe; - message: Maybe; - remoteHost: Maybe; - remoteUrl: Maybe; +/** Experimental, this will likely be replaced by a nested diff. */ +export type FlatDiff = { + __typename?: 'FlatDiff'; + diff: Array; + id: Scalars['ID']; + summary: FlatDiffSummary; }; -/** This is stored with a schema when it is uploaded */ -export type GitContextInput = { - branch: Maybe; - commit: Maybe; - committer: Maybe; - message: Maybe; - remoteUrl: Maybe; +export type FlatDiffAddArgument = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemValue & { + __typename?: 'FlatDiffAddArgument'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; }; -export enum GitRemoteHost { - Bitbucket = 'BITBUCKET', - Github = 'GITHUB', - Gitlab = 'GITLAB' -} +export type FlatDiffAddDirective = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffAddDirective'; + coordinate: Scalars['String']; + type: FlatDiffType; +}; -export type GlobalExperimentalFeatures = { - __typename?: 'GlobalExperimentalFeatures'; - operationsCollections: Scalars['Boolean']; - sandboxesFullRelease: Scalars['Boolean']; - sandboxesPreview: Scalars['Boolean']; - sandboxesSchemaChecksPage: Scalars['Boolean']; - sandboxesSchemaDiffPage: Scalars['Boolean']; +export type FlatDiffAddDirectiveUsage = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemValue & { + __typename?: 'FlatDiffAddDirectiveUsage'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; }; -export type GraphApiKey = ApiKey & { - __typename?: 'GraphApiKey'; - createdAt: Scalars['Timestamp']; - createdBy: Maybe; - id: Scalars['ID']; - keyName: Maybe; - role: UserPermission; - token: Scalars['String']; +export type FlatDiffAddEnum = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffAddEnum'; + coordinate: Scalars['String']; + type: FlatDiffType; }; -/** A union of all combinations that can comprise the implementingServices for a Service */ -export type GraphImplementors = FederatedImplementingServices | NonFederatedImplementingService; +export type FlatDiffAddEnumValue = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffAddEnumValue'; + coordinate: Scalars['String']; + type: FlatDiffType; +}; -/** A variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariant = { - __typename?: 'GraphVariant'; - /** As new schema tags keep getting published, activeSchemaPublish refers to the latest. */ - activeSchemaPublish: Maybe; - /** The version of composition currently in use */ - compositionVersion: Scalars['String']; - /** Filter configuration used to create the contract schema */ - contractFilterConfig: Maybe; - /** Explorer setting for default headers for a graph */ - defaultHeaders: Maybe; - derivedVariantCount: Scalars['Int']; - /** Graph the variant belongs to */ - graph: Service; - /** Graph ID of the variant. Prefer using graph { id } when feasible. */ - graphId: Scalars['String']; - /** Global identifier for the graph variant, in the form `graph@variant`. */ - id: Scalars['ID']; - /** Represents whether this variant is a Contract. */ - isContract: Scalars['Boolean']; - /** Is this variant one of the current user's favorite variants? */ - isFavoriteOfCurrentUser: Scalars['Boolean']; - /** If the variant is protected */ - isProtected: Scalars['Boolean']; - isPublic: Scalars['Boolean']; - /** Represents whether this variant should be listed in the public variants directory. This can only be true if the variant is also public. */ - isPubliclyListed: Scalars['Boolean']; - /** Represents whether Apollo has verified the authenticity of this public variant. This can only be true if the variant is also public. */ - isVerified: Scalars['Boolean']; - latestLaunch: Maybe; - launch: Maybe; - launchHistory: Array; - links: Maybe>; - /** Name of the variant, like `variant`. */ - name: Scalars['String']; - /** Which permissions the current user has for interacting with this variant */ - permissions: GraphVariantPermissions; - /** Explorer setting for preflight script to run before the actual GraphQL operations is run. */ - preflightScript: Maybe; - readme: Maybe; - /** The total number of requests for this variant in the last 24 hours */ - requestsInLastDay: Maybe; - /** If the graphql endpoint is set up to accept cookies */ - sendCookies: Maybe; - sourceVariant: Maybe; - /** URL where the graph subscription can be queried. */ - subscriptionUrl: Maybe; - /** A list of supported directives */ - supportedDirectives: Maybe>; - /** URL where the graph can be queried. */ - url: Maybe; - /** The last instant that usage information (e.g. operation stat, client stats) was reported for this variant */ - usageLastReportedAt: Maybe; +export type FlatDiffAddField = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemValue & { + __typename?: 'FlatDiffAddField'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; }; +export type FlatDiffAddImplementation = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemValue & { + __typename?: 'FlatDiffAddImplementation'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; +}; -/** A variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantLaunchArgs = { - id: Scalars['ID']; +export type FlatDiffAddInput = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffAddInput'; + coordinate: Scalars['String']; + type: FlatDiffType; }; +export type FlatDiffAddInterface = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffAddInterface'; + coordinate: Scalars['String']; + type: FlatDiffType; +}; -/** A variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantLaunchHistoryArgs = { - limit?: Scalars['Int']; +export type FlatDiffAddObject = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffAddObject'; + coordinate: Scalars['String']; + type: FlatDiffType; }; -export type GraphVariantLookup = GraphVariant | InvalidRefFormat; +export type FlatDiffAddScalar = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffAddScalar'; + coordinate: Scalars['String']; + type: FlatDiffType; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutation = { - __typename?: 'GraphVariantMutation'; - addLinkToVariant: GraphVariant; - configureComposition: Maybe; - /** @deprecated Use configureComposition instead */ - enableTagAndInaccessible: Maybe; - /** Graph ID of the variant */ - graphId: Scalars['String']; - /** Global identifier for the graph variant, in the form `graph@variant`. */ - id: Scalars['ID']; - /** Name of the variant, like `variant`. */ - name: Scalars['String']; - relaunch: RelaunchResult; - removeLinkFromVariant: GraphVariant; - setIsFavoriteOfCurrentUser: GraphVariant; - updateDefaultHeaders: Maybe; - updateIsProtected: Maybe; - updatePreflightScript: Maybe; - updateSendCookies: Maybe; - updateSubscriptionURL: Maybe; - updateURL: Maybe; - updateVariantIsPublic: Maybe; - updateVariantIsPubliclyListed: Maybe; - updateVariantIsVerified: Maybe; - updateVariantReadme: Maybe; +export type FlatDiffAddSchemaDefinition = FlatDiffItem & { + __typename?: 'FlatDiffAddSchemaDefinition'; + type: FlatDiffType; }; +export type FlatDiffAddSchemaDirectiveUsage = FlatDiffItem & FlatDiffItemValue & { + __typename?: 'FlatDiffAddSchemaDirectiveUsage'; + type: FlatDiffType; + value: Scalars['String']; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationAddLinkToVariantArgs = { - title: Maybe; - type: LinkInfoType; - url: Scalars['String']; +export type FlatDiffAddSchemaRootOperation = FlatDiffItem & FlatDiffItemRootType & FlatDiffItemValue & { + __typename?: 'FlatDiffAddSchemaRootOperation'; + rootType: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; }; +export type FlatDiffAddUnion = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffAddUnion'; + coordinate: Scalars['String']; + type: FlatDiffType; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationConfigureCompositionArgs = { - enableTagAndInaccessible: Maybe; - version: Maybe; +export type FlatDiffAddUnionMember = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemValue & { + __typename?: 'FlatDiffAddUnionMember'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; }; +export type FlatDiffAddValidLocation = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemValue & { + __typename?: 'FlatDiffAddValidLocation'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationEnableTagAndInaccessibleArgs = { - enabled: Scalars['Boolean']; +export type FlatDiffChangeArgumentDefault = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemNullableValue & { + __typename?: 'FlatDiffChangeArgumentDefault'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Maybe; }; +export type FlatDiffChangeDescription = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemNullableValue & { + __typename?: 'FlatDiffChangeDescription'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Maybe; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationRemoveLinkFromVariantArgs = { - linkInfoId: Scalars['ID']; +export type FlatDiffChangeDirectiveRepeatable = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffChangeDirectiveRepeatable'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['Boolean']; }; +export type FlatDiffChangeInputFieldDefault = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemNullableValue & { + __typename?: 'FlatDiffChangeInputFieldDefault'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Maybe; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationSetIsFavoriteOfCurrentUserArgs = { - favorite: Scalars['Boolean']; +export type FlatDiffChangeSchemaDescription = FlatDiffItem & FlatDiffItemNullableValue & { + __typename?: 'FlatDiffChangeSchemaDescription'; + type: FlatDiffType; + value: Maybe; }; +export type FlatDiffItem = { + type: FlatDiffType; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationUpdateDefaultHeadersArgs = { - defaultHeaders: Maybe; +export type FlatDiffItemCoordinate = { + coordinate: Scalars['String']; + type: FlatDiffType; }; +export type FlatDiffItemNullableValue = { + type: FlatDiffType; + value: Maybe; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationUpdateIsProtectedArgs = { - isProtected: Scalars['Boolean']; +export type FlatDiffItemRootType = { + rootType: Scalars['String']; + type: FlatDiffType; }; +export type FlatDiffItemValue = { + type: FlatDiffType; + value: Scalars['String']; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationUpdatePreflightScriptArgs = { - preflightScript: Maybe; +export type FlatDiffRemoveArgument = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemValue & { + __typename?: 'FlatDiffRemoveArgument'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; }; +export type FlatDiffRemoveDirective = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffRemoveDirective'; + coordinate: Scalars['String']; + type: FlatDiffType; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationUpdateSendCookiesArgs = { - sendCookies: Scalars['Boolean']; +export type FlatDiffRemoveDirectiveUsage = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemValue & { + __typename?: 'FlatDiffRemoveDirectiveUsage'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; }; +export type FlatDiffRemoveEnum = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffRemoveEnum'; + coordinate: Scalars['String']; + type: FlatDiffType; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationUpdateSubscriptionUrlArgs = { - subscriptionUrl: Maybe; +export type FlatDiffRemoveEnumValue = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffRemoveEnumValue'; + coordinate: Scalars['String']; + type: FlatDiffType; }; +export type FlatDiffRemoveField = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemValue & { + __typename?: 'FlatDiffRemoveField'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationUpdateUrlArgs = { - url: Maybe; +export type FlatDiffRemoveImplementation = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemValue & { + __typename?: 'FlatDiffRemoveImplementation'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; }; +export type FlatDiffRemoveInput = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffRemoveInput'; + coordinate: Scalars['String']; + type: FlatDiffType; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationUpdateVariantIsPublicArgs = { - isPublic: Scalars['Boolean']; +export type FlatDiffRemoveInterface = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffRemoveInterface'; + coordinate: Scalars['String']; + type: FlatDiffType; }; +export type FlatDiffRemoveObject = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffRemoveObject'; + coordinate: Scalars['String']; + type: FlatDiffType; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationUpdateVariantIsPubliclyListedArgs = { - isPubliclyListed: Scalars['Boolean']; +export type FlatDiffRemoveScalar = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffRemoveScalar'; + coordinate: Scalars['String']; + type: FlatDiffType; }; +export type FlatDiffRemoveSchemaDefinition = FlatDiffItem & { + __typename?: 'FlatDiffRemoveSchemaDefinition'; + type: FlatDiffType; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationUpdateVariantIsVerifiedArgs = { - isVerified: Scalars['Boolean']; +export type FlatDiffRemoveSchemaDirectiveUsage = FlatDiffItem & FlatDiffItemValue & { + __typename?: 'FlatDiffRemoveSchemaDirectiveUsage'; + type: FlatDiffType; + value: Scalars['String']; }; +export type FlatDiffRemoveSchemaRootOperation = FlatDiffItem & FlatDiffItemRootType & { + __typename?: 'FlatDiffRemoveSchemaRootOperation'; + rootType: Scalars['String']; + type: FlatDiffType; +}; -/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ -export type GraphVariantMutationUpdateVariantReadmeArgs = { - readme: Scalars['String']; +export type FlatDiffRemoveUnion = FlatDiffItem & FlatDiffItemCoordinate & { + __typename?: 'FlatDiffRemoveUnion'; + coordinate: Scalars['String']; + type: FlatDiffType; }; -/** A map from permission String to boolean that the current user is allowed for the root graph variant */ -export type GraphVariantPermissions = { - __typename?: 'GraphVariantPermissions'; - canManageBuildConfig: Scalars['Boolean']; - canManageExplorerSettings: Scalars['Boolean']; - canPushSchemas: Scalars['Boolean']; - canQueryBuildConfig: Scalars['Boolean']; - /** - * Whether the current user can access the schema for this variant. This will be anded with - * the ServiceRoles.canQuerySchemas, this will be true when the service schema permission is - * false for Services with public variants - */ - canQuerySchemas: Scalars['Boolean']; - canUpdateVariantLinkInfo: Scalars['Boolean']; - canUpdateVariantReadme: Scalars['Boolean']; +export type FlatDiffRemoveUnionMember = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemValue & { + __typename?: 'FlatDiffRemoveUnionMember'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; }; -export enum HttpMethod { - Connect = 'CONNECT', - Delete = 'DELETE', - Get = 'GET', - Head = 'HEAD', - Options = 'OPTIONS', - Patch = 'PATCH', - Post = 'POST', - Put = 'PUT', - Trace = 'TRACE', - Unknown = 'UNKNOWN', - Unrecognized = 'UNRECOGNIZED' +export type FlatDiffRemoveValidLocation = FlatDiffItem & FlatDiffItemCoordinate & FlatDiffItemValue & { + __typename?: 'FlatDiffRemoveValidLocation'; + coordinate: Scalars['String']; + type: FlatDiffType; + value: Scalars['String']; +}; + +export type FlatDiffResult = FlatDiff | NotFoundError | SchemaValidationError; + +export type FlatDiffSummary = { + __typename?: 'FlatDiffSummary'; + directive: FlatDiffTypeSummary; + enum: FlatDiffTypeSummary; + input: FlatDiffTypeSummary; + interface: FlatDiffTypeSummary; + object: FlatDiffTypeSummary; + scalar: FlatDiffTypeSummary; + schema: FlatDiffTypeSummary; + union: FlatDiffTypeSummary; +}; + +export enum FlatDiffType { + AddArgument = 'ADD_ARGUMENT', + AddDirective = 'ADD_DIRECTIVE', + AddDirectiveUsage = 'ADD_DIRECTIVE_USAGE', + AddEnum = 'ADD_ENUM', + AddEnumValue = 'ADD_ENUM_VALUE', + AddField = 'ADD_FIELD', + AddImplementation = 'ADD_IMPLEMENTATION', + AddInput = 'ADD_INPUT', + AddInterface = 'ADD_INTERFACE', + AddObject = 'ADD_OBJECT', + AddScalar = 'ADD_SCALAR', + AddSchemaDefinition = 'ADD_SCHEMA_DEFINITION', + AddSchemaDirectiveUsage = 'ADD_SCHEMA_DIRECTIVE_USAGE', + AddSchemaRootOperation = 'ADD_SCHEMA_ROOT_OPERATION', + AddUnion = 'ADD_UNION', + AddUnionMember = 'ADD_UNION_MEMBER', + AddValidLocation = 'ADD_VALID_LOCATION', + ChangeArgumentDefault = 'CHANGE_ARGUMENT_DEFAULT', + ChangeDescription = 'CHANGE_DESCRIPTION', + ChangeInputFieldDefault = 'CHANGE_INPUT_FIELD_DEFAULT', + ChangeRepeatable = 'CHANGE_REPEATABLE', + ChangeSchemaDescription = 'CHANGE_SCHEMA_DESCRIPTION', + RemoveArgument = 'REMOVE_ARGUMENT', + RemoveDirective = 'REMOVE_DIRECTIVE', + RemoveDirectiveUsage = 'REMOVE_DIRECTIVE_USAGE', + RemoveEnum = 'REMOVE_ENUM', + RemoveEnumValue = 'REMOVE_ENUM_VALUE', + RemoveField = 'REMOVE_FIELD', + RemoveImplementation = 'REMOVE_IMPLEMENTATION', + RemoveInput = 'REMOVE_INPUT', + RemoveInterface = 'REMOVE_INTERFACE', + RemoveObject = 'REMOVE_OBJECT', + RemoveScalar = 'REMOVE_SCALAR', + RemoveSchemaDefinition = 'REMOVE_SCHEMA_DEFINITION', + RemoveSchemaDirectiveUsage = 'REMOVE_SCHEMA_DIRECTIVE_USAGE', + RemoveSchemaRootOperation = 'REMOVE_SCHEMA_ROOT_OPERATION', + RemoveUnion = 'REMOVE_UNION', + RemoveUnionMember = 'REMOVE_UNION_MEMBER', + RemoveValidLocation = 'REMOVE_VALID_LOCATION' } -export type HistoricQueryParameters = { - /** A list of clients to filter out during validation. */ - excludedClients: Maybe>; - from: Maybe; - /** A list of operation IDs to filter out during validation. */ - ignoredOperations: Maybe>; - /** - * A list of variants to include in the validation. If no variants are provided - * then this defaults to the "current" variant along with the base variant. The - * base variant indicates the schema that generates diff and marks the metrics that - * are checked for broken queries. We union this base variant with the untagged values('', - * same as null inside of `in`, and 'current') in this metrics fetch. This strategy - * supports users who have not tagged their metrics or schema. - */ - includedVariants: Maybe>; - /** Minimum number of requests within the window for a query to be considered. */ - queryCountThreshold: Maybe; - /** - * Number of requests within the window for a query to be considered, relative to - * total request count. Expected values are between 0 and 0.05 (minimum 5% of total - * request volume) - */ - queryCountThresholdPercentage: Maybe; - to: Maybe; +export type FlatDiffTypeSummary = { + __typename?: 'FlatDiffTypeSummary'; + add: Scalars['Int']; + change: Scalars['Int']; + remove: Scalars['Int']; + typeCount: Scalars['Int']; }; -export type Identity = { - asActor: Actor; - id: Scalars['ID']; - name: Scalars['String']; +/** Error connecting to Fly */ +export type FlyClientError = { + __typename?: 'FlyClientError'; + /** Error message */ + message: Scalars['String']; }; -/** An actor's identity and info about the client they used to perform the action */ -export type IdentityAndClientInfo = { - __typename?: 'IdentityAndClientInfo'; - /** The clientName given to Apollo Cloud when the actor performed the action */ - clientName: Maybe; - /** The clientVersion given to Apollo Cloud when the actor performed the action */ - clientVersion: Maybe; - /** Identity info about the actor */ - identity: Maybe; +/** Error triggering a rolling update */ +export type FlyForceRollingUpdateError = { + __typename?: 'FlyForceRollingUpdateError'; + /** Concrete error for the flyForceRollingUpdate mutation */ + error: FlyForceRollingUpdateErrorValue; }; -export type IdentityMutation = ServiceMutation | UserMutation; +/** Concrete error for the flyForceRollingUpdate mutation */ +export type FlyForceRollingUpdateErrorValue = FlyClientError | InvalidRequest; -export type IgnoreOperationsInChecksResult = { - __typename?: 'IgnoreOperationsInChecksResult'; - graph: Service; +/** Result of a flyForceRollingUpdate mutation */ +export type FlyForceRollingUpdateResult = FlyForceRollingUpdateError | FlyForceRollingUpdateSuccess; + +/** Success triggering a rolling update */ +export type FlyForceRollingUpdateSuccess = { + __typename?: 'FlyForceRollingUpdateSuccess'; + /** Whether the app was updated */ + updated: Scalars['Boolean']; }; -/** The location of the implementing service config file in storage */ -export type ImplementingServiceLocation = { - __typename?: 'ImplementingServiceLocation'; - /** The name of the implementing service */ - name: Scalars['String']; - /** The path in storage to access the implementing service config file */ - path: Scalars['String']; +export type FlyRouterMutation = { + __typename?: 'FlyRouterMutation'; + /** Force a rolling update */ + forceRollingUpdate: FlyForceRollingUpdateResult; }; -export type InternalAdminUser = { - __typename?: 'InternalAdminUser'; - role: InternalMdgAdminRole; - userID: Scalars['String']; +/** Fly-specific information for a Shard */ +export type FlyShard = { + __typename?: 'FlyShard'; + /** DNS endpoint for the orchestrator */ + endpoint: Scalars['String']; + /** Endpoints of the Etcd cluster */ + etcdEndpoints: Array; + /** Fly organization ID */ + organizationId: Scalars['String']; }; -export type InternalIdentity = Identity & { - __typename?: 'InternalIdentity'; - accounts: Array; - asActor: Actor; - email: Maybe; +export type GqlBillingPlanFromGrpc = { + __typename?: 'GQLBillingPlanFromGrpc'; + dbPlan: Maybe; + matchesDbPlan: Maybe; + rawProtoJson: Maybe; +}; + +export type GeneralProposalComment = { + createdAt: Scalars['Timestamp']; + /** null if the user is deleted */ + createdBy: Maybe; id: Scalars['ID']; - name: Scalars['String']; + message: Scalars['String']; + status: CommentStatus; + /** null if never updated */ + updatedAt: Maybe; }; -export enum InternalMdgAdminRole { - InternalMdgReadOnly = 'INTERNAL_MDG_READ_ONLY', - InternalMdgSales = 'INTERNAL_MDG_SALES', - InternalMdgSuperAdmin = 'INTERNAL_MDG_SUPER_ADMIN', - InternalMdgSupport = 'INTERNAL_MDG_SUPPORT' +export type GitContext = { + __typename?: 'GitContext'; + branch: Maybe; + commit: Maybe; + commitUrl: Maybe; + committer: Maybe; + message: Maybe; + remoteHost: Maybe; + remoteUrl: Maybe; +}; + +/** This is stored with a schema when it is uploaded */ +export type GitContextInput = { + /** The Git repository branch used in the check. */ + branch: Maybe; + /** The ID of the Git commit used in the check. */ + commit: Maybe; + /** The username of the user who created the Git commit used in the check. */ + committer: Maybe; + /** The commit message of the Git commit used in the check. */ + message: Maybe; + /** The Git repository's remote URL. */ + remoteUrl: Maybe; +}; + +export enum GitRemoteHost { + Bitbucket = 'BITBUCKET', + Github = 'GITHUB', + Gitlab = 'GITLAB' } -export type IntrospectionDirective = { - __typename?: 'IntrospectionDirective'; - args: Array; - description: Maybe; - locations: Array; - name: Scalars['String']; +/** + * Represents a graph API key, which has permissions scoped to a + * user role for a single Apollo graph. + */ +export type GraphApiKey = ApiKey & { + __typename?: 'GraphApiKey'; + /** The timestamp when the API key was created. */ + createdAt: Scalars['Timestamp']; + /** Details of the user or graph that created the API key. */ + createdBy: Maybe; + /** The API key's ID. */ + id: Scalars['ID']; + /** The API key's name, for distinguishing it from other keys. */ + keyName: Maybe; + /** The permission level assigned to the API key upon creation. */ + role: UserPermission; + /** The value of the API key. **This is a secret credential!** */ + token: Scalars['String']; }; -export type IntrospectionDirectiveInput = { - args: Array; - description: Maybe; - isRepeatable: Maybe; - locations: Array; - name: Scalars['String']; +export type GraphCapabilities = { + __typename?: 'GraphCapabilities'; + /** False if this graph is a cloud supergraph. */ + canPublishMonograph: Scalars['Boolean']; + /** Currently, graph URL is not updatable for cloud supergraphs. */ + canUpdateURL: Scalars['Boolean']; + /** Minimum Federation Version track required for all variants of this graph. */ + minimumBuildPipelineTrack: BuildPipelineTrack; }; -/** __DirectiveLocation introspection type */ -export enum IntrospectionDirectiveLocation { +/** The timing details for the build step of a launch. */ +export type GraphCreationError = { + __typename?: 'GraphCreationError'; + message: Scalars['String']; +}; + +export type GraphCreationResult = GraphCreationError | Service; + +/** Filtering options for graph connections. */ +export type GraphFilter = { + /** Only include graphs in a certain state. */ + state: Maybe; + /** Only include graphs of certain types. */ + type: Maybe>; +}; + +/** A union of all containers that can comprise the components of a Studio graph */ +export type GraphImplementors = FederatedImplementingServices | NonFederatedImplementingService; + +/** The linter configuration for this graph. */ +export type GraphLinterConfiguration = { + __typename?: 'GraphLinterConfiguration'; + /** The set of @tag names allowed in the schema. */ + allowedTagNames: Array; + /** Whether to ignore @deprecated elements from linting violations. */ + ignoreDeprecated: Scalars['Boolean']; + /** Whether to ignore @inaccessible elements from linting violations. */ + ignoreInaccessible: Scalars['Boolean']; + /** The set of lint rules configured for this graph. */ + rules: Array; +}; + +/** The changes to the linter configuration for this graph. */ +export type GraphLinterConfigurationChangesInput = { + /** A set of allowed @tag names to be added to the linting configuration for this graph or null if no changes should be made. */ + allowedTagNameAdditions: Maybe>; + /** A set of @tag names to be removed from the allowed @tag list for this graphs linting configuration or null if no changes should be made. */ + allowedTagNameRemovals: Maybe>; + /** Change whether @deprecated elements should be linted or null if no changes should be made. */ + ignoreDeprecated: Maybe; + /** Change whether @inaccessible elements should be linted or null if no changes should be made. */ + ignoreInaccessible: Maybe; + /** A set of rule changes or null if no changes should be made. */ + rules: Maybe>; +}; + +export type GraphQlDoc = { + __typename?: 'GraphQLDoc'; + graph: Service; + hash: Scalars['ID']; + source: Scalars['GraphQLDocument']; +}; + +/** Various states a graph can be in. */ +export enum GraphState { + /** The graph has not been configured with any variants. */ + Configured = 'CONFIGURED', + /** The graph has not been configured with any variants. */ + NotConfigured = 'NOT_CONFIGURED' +} + +export enum GraphType { + Classic = 'CLASSIC', + CloudSupergraph = 'CLOUD_SUPERGRAPH', + SelfHostedSupergraph = 'SELF_HOSTED_SUPERGRAPH' +} + +/** A graph variant */ +export type GraphVariant = { + __typename?: 'GraphVariant'; + /** As new schema tags keep getting published, activeSchemaPublish refers to the latest. */ + activeSchemaPublish: Maybe; + /** The list of BuildPipelineTracks and their associated details that this variant is allowed to set in their build configuration. */ + allowedTracks: Array; + /** + * If this variant doesn't conduct a build (monograph) then this field will be null + * For contract variants the build config is set based on the upstream composition variant. + */ + buildConfig: Maybe; + /** The time the variant's federation version and/or the supported directives was last updated */ + buildConfigUpdatedAt: Maybe; + checkConfiguration: VariantCheckConfiguration; + /** Compose and filter preview contract schema built from this source variant. */ + composeAndFilterPreview: Maybe; + /** Federation version this variant uses */ + compositionVersion: Maybe; + /** The filter configuration used to build a contract schema. The configuration consists of lists of tags for schema elements to include or exclude in the resulting schema. */ + contractFilterConfig: Maybe; + /** + * A human-readable description of the filter configuration of this contract variant, or null if this isn't a contract + * variant. + */ + contractFilterConfigDescription: Maybe; + /** Preview a Contract schema built from this source variant. */ + contractPreview: ContractPreview; + /** Time the variant was created */ + createdAt: Scalars['Timestamp']; + derivedVariantCount: Scalars['Int']; + /** Returns the list of variants derived from this variant. This currently includes contracts only. */ + derivedVariants: Maybe>; + /** A list of the entities across all subgraphs, exposed to consumers & up. This value is null for non-federated variants. */ + entities: Maybe; + /** + * Returns details about a field in the schema. Unless an error occurs, we will currently always return a non-null + * response here, with the timestamps set to null if there is no usage of the field or if field doesn't exist in the + * schema. However we are keeping the return type as nullable in case we want to update this later in a + * backwards-compatible way to make null mean that the field doesn't exist in the schema at all. + */ + fieldInsights: Maybe; + /** Returns a paginated list of field insights list items, including all fields from the active schema for this variant. */ + fieldInsightsList: GraphVariantFieldInsightsListItemConnection; + /** The graph that this variant belongs to. */ + graph: Service; + /** Graph ID of the variant. Prefer using graph { id } when feasible. */ + graphId: Scalars['String']; + /** If the variant has managed subgraphs. */ + hasManagedSubgraphs: Maybe; + /** + * Represents whether this variant has a supergraph schema. Note that this can only be true for variants with build steps + * (running e.g. federation composition or contracts filtering). This will be false for a variant with a build step if it + * has never successfully published. + */ + hasSupergraphSchema: Scalars['Boolean']; + /** The variant's global identifier in the form `graphID@variant`. */ + id: Scalars['ID']; + internalVariantUUID: Scalars['String']; + /** Represents whether this variant is a Contract. */ + isContract: Maybe; + /** Is this variant one of the current user's favorite variants? */ + isFavoriteOfCurrentUser: Scalars['Boolean']; + /** + * If the variant has managed subgraphs. + * @deprecated Replaced by hasManagedSubgraphs + */ + isFederated: Maybe; + /** Represents whether this variant is a Proposal. */ + isProposal: Maybe; + /** If the variant is protected */ + isProtected: Scalars['Boolean']; + isPublic: Scalars['Boolean']; + /** Represents whether this variant should be listed in the public variants directory. This can only be true if the variant is also public. */ + isPubliclyListed: Scalars['Boolean']; + /** Represents whether Apollo has verified the authenticity of this public variant. This can only be true if the variant is also public. */ + isVerified: Scalars['Boolean']; + /** Latest approved launch for the variant, and what is served through Uplink. */ + latestApprovedLaunch: Maybe; + /** Latest launch for the variant, whether successful or not. */ + latestLaunch: Maybe; + /** The details of the variant's most recent publication. */ + latestPublication: Maybe; + launch: Maybe; + /** A list of launches ordered by date, asc or desc depending on orderBy. The maximum limit is 100. */ + launchHistory: Maybe>; + /** Count of total launch history */ + launchHistoryLength: Maybe; + links: Maybe>; + /** The variant's name (e.g., `staging`). */ + name: Scalars['String']; + /** A list of the saved [operation collections](https://www.apollographql.com/docs/studio/explorer/operation-collections/) associated with this variant. */ + operationCollections: Array; + /** A list of the saved [operation collections](https://www.apollographql.com/docs/studio/explorer/operation-collections/) associated with this variant, paged. */ + operationCollectionsConnection: Maybe; + /** Returns a paginated list of operation insights list items. */ + operationInsightsList: GraphVariantOperationInsightsListItemConnection; + /** The merged/computed/effective check configuration for the operations check task. */ + operationsCheckConfiguration: Maybe; + /** Which permissions the current user has for interacting with this variant */ + permissions: GraphVariantPermissions; + /** The Persisted Query List linked to this variant, if any. */ + persistedQueryList: Maybe; + /** Generate a federated operation plan for a given operation */ + plan: Maybe; + /** Explorer setting for preflight script to run before the actual GraphQL operations is run. */ + preflightScript: Maybe; + proposal: Maybe; + readme: Readme; + /** Registry stats for this particular graph variant */ + registryStatsWindow: Maybe; + /** The total number of requests for this variant in the last 24 hours */ + requestsInLastDay: Maybe; + /** Router associated with this graph variant */ + router: Maybe; + routerConfig: Maybe; + /** If the graphql endpoint is set up to accept cookies. */ + sendCookies: Maybe; + /** Explorer setting for shared headers for a graph */ + sharedHeaders: Maybe; + /** The variant this variant is derived from. This property currently only exists on contract variants. */ + sourceVariant: Maybe; + /** Returns the details of the subgraph with the provided `name`, or null if this variant doesn't include a subgraph with that name. */ + subgraph: Maybe; + /** A list of the subgraphs included in this variant. This value is null for non-federated variants. Set `includeDeleted` to `true` to include deleted subgraphs. */ + subgraphs: Maybe>; + /** The URL of the variant's GraphQL endpoint for subscription operations. */ + subscriptionUrl: Maybe; + /** A list of supported directives */ + supportedDirectives: Maybe>; + /** + * A list of the subgraphs that have been published to since the variant was created. + * Does not include subgraphs that were created & deleted since the variant was created. + */ + updatedSubgraphs: Maybe>; + /** The URL of the variant's GraphQL endpoint for query and mutation operations. For subscription operations, use `subscriptionUrl`. */ + url: Maybe; + /** The last instant that usage information (e.g. operation stat, client stats) was reported for this variant */ + usageLastReportedAt: Maybe; + /** Validate router configuration for this graph variant */ + validateRouter: CloudValidationResult; +}; + + +/** A graph variant */ +export type GraphVariantComposeAndFilterPreviewArgs = { + filterConfig: Maybe; + subgraphChanges: Maybe>; +}; + + +/** A graph variant */ +export type GraphVariantContractPreviewArgs = { + filters: FilterConfigInput; +}; + + +/** A graph variant */ +export type GraphVariantFieldInsightsArgs = { + fieldName: Scalars['String']; + parentType: Scalars['String']; +}; + + +/** A graph variant */ +export type GraphVariantFieldInsightsListArgs = { + after: Maybe; + before: Maybe; + filter: Maybe; + first: Maybe; + from: Scalars['Timestamp']; + last: Maybe; + orderBy: Maybe; + to: Scalars['Timestamp']; +}; + + +/** A graph variant */ +export type GraphVariantLaunchArgs = { + id: Scalars['ID']; +}; + + +/** A graph variant */ +export type GraphVariantLaunchHistoryArgs = { + limit?: Scalars['Int']; + offset?: Scalars['Int']; + orderBy?: LaunchHistoryOrder; +}; + + +/** A graph variant */ +export type GraphVariantOperationCollectionsConnectionArgs = { + after: Maybe; + before: Maybe; + first: Maybe; + last: Maybe; +}; + + +/** A graph variant */ +export type GraphVariantOperationInsightsListArgs = { + after: Maybe; + before: Maybe; + filter: Maybe; + first: Maybe; + from: Scalars['Timestamp']; + last: Maybe; + orderBy: Maybe; + to: Scalars['Timestamp']; +}; + + +/** A graph variant */ +export type GraphVariantOperationsCheckConfigurationArgs = { + overrides: Maybe; +}; + + +/** A graph variant */ +export type GraphVariantPlanArgs = { + document: Scalars['GraphQLDocument']; + operationName: Maybe; +}; + + +/** A graph variant */ +export type GraphVariantRegistryStatsWindowArgs = { + from: Scalars['Timestamp']; + resolution: Maybe; + to: Maybe; +}; + + +/** A graph variant */ +export type GraphVariantSubgraphArgs = { + name: Scalars['ID']; +}; + + +/** A graph variant */ +export type GraphVariantSubgraphsArgs = { + includeDeleted?: Scalars['Boolean']; +}; + + +/** A graph variant */ +export type GraphVariantValidateRouterArgs = { + config: RouterConfigInput; +}; + +export type GraphVariantFieldInsightsListItemConnection = { + __typename?: 'GraphVariantFieldInsightsListItemConnection'; + /** A list of edges from the graph variant to its field insights list items. */ + edges: Maybe>; + /** A list of field insights list items that belong to a graph variant. */ + nodes: Maybe>; + /** Information to aid in pagination. */ + pageInfo: FieldInsightsListPageInfo; + /** The total number of field insights list items connected to the graph variant */ + totalCount: Scalars['Int']; +}; + +/** An edge between a graph variant and a field insights list item. */ +export type GraphVariantFieldInsightsListItemEdge = { + __typename?: 'GraphVariantFieldInsightsListItemEdge'; + /** A cursor for use in pagination. */ + cursor: Scalars['String']; + /** A field insights list item attached to the graph variant. */ + node: Maybe; +}; + +/** Ways to filter graph variants. */ +export enum GraphVariantFilter { + /** All Variants */ + All = 'ALL', + /** Variants favorited by the current user */ + Favorites = 'FAVORITES' +} + +/** Result of looking up a variant by ref */ +export type GraphVariantLookup = GraphVariant | InvalidRefFormat; + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutation = { + __typename?: 'GraphVariantMutation'; + addLinkToVariant: GraphVariant; + buildConfig: Maybe; + createRouter: CreateRouterResult; + /** Delete the variant. */ + delete: DeleteSchemaTagResult; + destroyRouter: DestroyRouterResult; + /** Graph ID of the variant */ + graphId: Scalars['String']; + /** Global identifier for the graph variant, in the form `graph@variant`. */ + id: Scalars['ID']; + internalVariantUUID: Scalars['String']; + linkPersistedQueryList: LinkPersistedQueryListResultOrError; + /** Name of the variant, like `variant`. */ + name: Scalars['String']; + relaunch: RelaunchResult; + removeLinkFromVariant: GraphVariant; + /** Gets the router attached to a graph variant */ + router: Maybe; + runLintCheck: CheckStepResult; + /** Mutation called by CheckCoordinator to find associated proposals to the schema diffs in a check workflow */ + runProposalsCheck: CheckStepResult; + service: Service; + setIsFavoriteOfCurrentUser: GraphVariant; + /** + * _Asynchronously_ kicks off operation checks for a proposed non-federated + * schema change against its associated graph. + * + * Returns a `CheckRequestSuccess` object with a workflow ID that you can use + * to check status, or an error object if the checks workflow failed to start. + */ + submitCheckSchemaAsync: CheckRequestResult; + /** Submit a request for a Filter Schema Check and receive a result with a workflow ID that can be used to check status, or an error message that explains what went wrong. */ + submitFilterCheckAsync: CheckRequestResult; + /** + * _Asynchronously_ kicks off composition and operation checks for a proposed subgraph schema change against its associated supergraph. + * + * Returns a `CheckRequestSuccess` object with a workflow ID that you can use + * to check status, or an error object if the checks workflow failed to start. + */ + submitSubgraphCheckAsync: CheckRequestResult; + unlinkPersistedQueryList: UnlinkPersistedQueryListResultOrError; + updateCheckConfigurationDownstreamVariants: VariantCheckConfiguration; + updateCheckConfigurationEnableOperationsCheck: Maybe; + updateCheckConfigurationExcludedClients: VariantCheckConfiguration; + updateCheckConfigurationExcludedOperations: VariantCheckConfiguration; + updateCheckConfigurationIncludedVariants: VariantCheckConfiguration; + updateCheckConfigurationTimeRange: VariantCheckConfiguration; + updateIsProtected: Maybe; + updatePreflightScript: Maybe; + updateRouter: UpdateRouterResult; + updateSendCookies: Maybe; + updateSharedHeaders: Maybe; + updateSubscriptionURL: Maybe; + updateURL: Maybe; + updateVariantIsPublic: Maybe; + updateVariantIsPubliclyListed: Maybe; + updateVariantIsVerified: Maybe; + /** Updates the [README](https://www.apollographql.com/docs/studio/org/graphs/#the-readme-page) of this variant. */ + updateVariantReadme: Maybe; + upsertRouterConfig: Maybe; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationAddLinkToVariantArgs = { + title: Maybe; + type: LinkInfoType; + url: Scalars['String']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationBuildConfigArgs = { + tagInApiSchema?: Scalars['Boolean']; + version: BuildPipelineTrack; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationCreateRouterArgs = { + input: CreateRouterInput; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationLinkPersistedQueryListArgs = { + persistedQueryListId: Scalars['ID']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationRemoveLinkFromVariantArgs = { + linkInfoId: Scalars['ID']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationRunLintCheckArgs = { + input: RunLintCheckInput; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationRunProposalsCheckArgs = { + input: RunProposalsCheckInput; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationSetIsFavoriteOfCurrentUserArgs = { + favorite: Scalars['Boolean']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationSubmitCheckSchemaAsyncArgs = { + input: CheckSchemaAsyncInput; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationSubmitFilterCheckAsyncArgs = { + input: FilterCheckAsyncInput; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationSubmitSubgraphCheckAsyncArgs = { + input: SubgraphCheckAsyncInput; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateCheckConfigurationDownstreamVariantsArgs = { + blockingDownstreamVariants: Maybe>; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateCheckConfigurationEnableOperationsCheckArgs = { + enabled: Scalars['Boolean']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateCheckConfigurationExcludedClientsArgs = { + appendGraphSettings: Scalars['Boolean']; + excludedClients: Maybe>; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateCheckConfigurationExcludedOperationsArgs = { + appendGraphSettings: Scalars['Boolean']; + excludedOperationNames: Maybe>; + excludedOperations: Maybe>; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateCheckConfigurationIncludedVariantsArgs = { + includedVariants: Maybe>; + useGraphSettings: Scalars['Boolean']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateCheckConfigurationTimeRangeArgs = { + operationCountThreshold: Maybe; + operationCountThresholdPercentage: Maybe; + timeRangeSeconds: Maybe; + useGraphSettings: Scalars['Boolean']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateIsProtectedArgs = { + isProtected: Scalars['Boolean']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdatePreflightScriptArgs = { + preflightScript: Maybe; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateRouterArgs = { + input: UpdateRouterInput; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateSendCookiesArgs = { + sendCookies: Scalars['Boolean']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateSharedHeadersArgs = { + sharedHeaders: Maybe; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateSubscriptionUrlArgs = { + subscriptionUrl: Maybe; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateUrlArgs = { + url: Maybe; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateVariantIsPublicArgs = { + isPublic: Scalars['Boolean']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateVariantIsPubliclyListedArgs = { + isPubliclyListed: Scalars['Boolean']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateVariantIsVerifiedArgs = { + isVerified: Scalars['Boolean']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpdateVariantReadmeArgs = { + readme: Scalars['String']; +}; + + +/** Modifies a variant of a graph, also called a schema tag in parts of our product. */ +export type GraphVariantMutationUpsertRouterConfigArgs = { + configuration: Scalars['String']; +}; + +export type GraphVariantOperationCollectionConnection = { + __typename?: 'GraphVariantOperationCollectionConnection'; + /** A list of edges from the graph variant to its operation collections. */ + edges: Maybe>; + /** A list of operation collections attached to a graph variant. */ + nodes: Maybe>; + /** Information to aid in pagination. */ + pageInfo: PageInfo; + totalCount: Scalars['Int']; +}; + +/** An edge between a graph variant and an operation collection. */ +export type GraphVariantOperationCollectionEdge = { + __typename?: 'GraphVariantOperationCollectionEdge'; + /** A cursor for use in pagination. */ + cursor: Scalars['String']; + /** An operation collection attached to a graph variant. */ + node: Maybe; +}; + +export type GraphVariantOperationInsightsListItemConnection = { + __typename?: 'GraphVariantOperationInsightsListItemConnection'; + /** A list of edges from the graph variant to its operation insights list items. */ + edges: Maybe>; + /** A list of operation insights list items that belong to a graph variant. */ + nodes: Maybe>; + /** Information to aid in pagination. */ + pageInfo: OperationInsightsListPageInfo; + /** The total number of operation insights list items connected to the graph variant. */ + totalCount: Scalars['Int']; +}; + +export type GraphVariantOperationInsightsListItemEdge = { + __typename?: 'GraphVariantOperationInsightsListItemEdge'; + /** A cursor for use in pagination. */ + cursor: Scalars['String']; + /** A operation insights list items attached to the graph variant. */ + node: Maybe; +}; + +/** Individual permissions for the current user when interacting with a particular Studio graph variant. */ +export type GraphVariantPermissions = { + __typename?: 'GraphVariantPermissions'; + canCreateCollectionInVariant: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to manage/update this variant's build configuration (e.g., build pipeline version). */ + canManageBuildConfig: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to manage/update cloud routers */ + canManageCloudRouter: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to update variant-level settings for the Apollo Studio Explorer. */ + canManageExplorerSettings: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to publish schemas to this variant. */ + canPushSchemas: Scalars['Boolean']; + /** Whether the currently authenticated user can read any information about this variant. */ + canQuery: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to view this variant's build configuration details (e.g., build pipeline version). */ + canQueryBuildConfig: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to view details regarding cloud routers */ + canQueryCloudRouter: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to view cloud router logs */ + canQueryCloudRouterLogs: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to view launch history */ + canQueryLaunches: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to download schemas associated to this variant. */ + canQuerySchemas: Scalars['Boolean']; + canShareCollectionInVariant: Scalars['Boolean']; + canUpdateVariantLinkInfo: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to update the README for this variant. */ + canUpdateVariantReadme: Scalars['Boolean']; + variantId: Scalars['ID']; +}; + +/** Columns of GraphosCloudMetrics. */ +export enum GraphosCloudMetricsColumn { + AccountId = 'ACCOUNT_ID', + AgentVersion = 'AGENT_VERSION', + ResponseSize = 'RESPONSE_SIZE', + ResponseSizeThrottled = 'RESPONSE_SIZE_THROTTLED', + RouterId = 'ROUTER_ID', + RouterOperations = 'ROUTER_OPERATIONS', + RouterOperationsThrottled = 'ROUTER_OPERATIONS_THROTTLED', + SchemaTag = 'SCHEMA_TAG', + ServiceId = 'SERVICE_ID', + SubgraphFetches = 'SUBGRAPH_FETCHES', + SubgraphFetchesThrottled = 'SUBGRAPH_FETCHES_THROTTLED', + Timestamp = 'TIMESTAMP' +} + +export type GraphosCloudMetricsDimensions = { + __typename?: 'GraphosCloudMetricsDimensions'; + accountId: Maybe; + agentVersion: Maybe; + routerId: Maybe; + schemaTag: Maybe; + serviceId: Maybe; +}; + +/** Filter for data in GraphosCloudMetrics. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ +export type GraphosCloudMetricsFilter = { + /** Selects rows whose accountId dimension equals the given value if not null. To query for the null value, use {in: {accountId: [null]}} instead. */ + accountId: Maybe; + /** Selects rows whose agentVersion dimension equals the given value if not null. To query for the null value, use {in: {agentVersion: [null]}} instead. */ + agentVersion: Maybe; + and: Maybe>; + in: Maybe; + not: Maybe; + or: Maybe>; + /** Selects rows whose routerId dimension equals the given value if not null. To query for the null value, use {in: {routerId: [null]}} instead. */ + routerId: Maybe; + /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ + schemaTag: Maybe; + /** Selects rows whose serviceId dimension equals the given value if not null. To query for the null value, use {in: {serviceId: [null]}} instead. */ + serviceId: Maybe; +}; + +/** Filter for data in GraphosCloudMetrics. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ +export type GraphosCloudMetricsFilterIn = { + /** Selects rows whose accountId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + accountId: Maybe>>; + /** Selects rows whose agentVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ + agentVersion: Maybe>>; + /** Selects rows whose routerId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + routerId: Maybe>>; + /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ + schemaTag: Maybe>>; + /** Selects rows whose serviceId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + serviceId: Maybe>>; +}; + +export type GraphosCloudMetricsMetrics = { + __typename?: 'GraphosCloudMetricsMetrics'; + responseSize: Scalars['Long']; + responseSizeThrottled: Scalars['Long']; + routerOperations: Scalars['Long']; + routerOperationsThrottled: Scalars['Long']; + subgraphFetches: Scalars['Long']; + subgraphFetchesThrottled: Scalars['Long']; +}; + +export type GraphosCloudMetricsOrderBySpec = { + column: GraphosCloudMetricsColumn; + direction: Ordering; +}; + +export type GraphosCloudMetricsRecord = { + __typename?: 'GraphosCloudMetricsRecord'; + /** Dimensions of GraphosCloudMetrics that can be grouped by. */ + groupBy: GraphosCloudMetricsDimensions; + /** Metrics of GraphosCloudMetrics that can be aggregated over. */ + metrics: GraphosCloudMetricsMetrics; + /** Starting segment timestamp. */ + timestamp: Scalars['Timestamp']; +}; + +export enum HttpMethod { + Connect = 'CONNECT', + Delete = 'DELETE', + Get = 'GET', + Head = 'HEAD', + Options = 'OPTIONS', + Patch = 'PATCH', + Post = 'POST', + Put = 'PUT', + Trace = 'TRACE', + Unknown = 'UNKNOWN', + Unrecognized = 'UNRECOGNIZED' +} + +export type HistoricQueryParameters = { + /** A list of clients to filter out during validation. */ + excludedClients: Maybe>; + /** A list of operation names to filter out during validation. */ + excludedOperationNames: Maybe>; + from: Maybe; + /** A list of operation IDs to filter out during validation. */ + ignoredOperations: Maybe>; + /** + * A list of variants to include in the validation. If no variants are provided + * then this defaults to the "current" variant along with the base variant. The + * base variant indicates the schema that generates diff and marks the metrics that + * are checked for broken queries. We union this base variant with the untagged values('', + * same as null inside of `in`, and 'current') in this metrics fetch. This strategy + * supports users who have not tagged their metrics or schema. + */ + includedVariants: Maybe>; + /** Minimum number of requests within the window for a query to be considered. */ + queryCountThreshold: Maybe; + /** + * Number of requests within the window for a query to be considered, relative to + * total request count. Expected values are between 0 and 0.05 (minimum 5% of total + * request volume) + */ + queryCountThresholdPercentage: Maybe; + to: Maybe; +}; + +/** Input type to provide when specifying configuration details for schema checks. */ +export type HistoricQueryParametersInput = { + /** Clients to be excluded from check. */ + excludedClients: Maybe>; + /** Operations to be ignored in this schema check, specified by operation name. */ + excludedOperationNames: Maybe>; + /** Start time for operations to be checked against. Specified as either a) an ISO formatted date/time string or b) a negative number of seconds relative to the time the check request was submitted. */ + from: Maybe; + /** Operations to be ignored in this schema check, specified by ID. */ + ignoredOperations: Maybe>; + /** Graph variants to be included in check. */ + includedVariants: Maybe>; + /** Maximum number of queries to be checked against the change. */ + queryCountThreshold: Maybe; + /** Only fail check if this percentage of operations would be negatively impacted. */ + queryCountThresholdPercentage: Maybe; + /** End time for operations to be checked against. Specified as either a) an ISO formatted date/time string or b) a negative number of seconds relative to the time the check request was submitted. */ + to: Maybe; +}; + +/** An identity (such as a `User` or `Graph`) in Apollo Studio. See implementing types for details. */ +export type Identity = { + /** Returns a representation of the identity as an `Actor` type. */ + asActor: Actor; + /** The identity's identifier, which is unique among objects of its type. */ + id: Scalars['ID']; + /** The identity's human-readable name. */ + name: Scalars['String']; +}; + +/** An actor's identity and info about the client they used to perform the action */ +export type IdentityAndClientInfo = { + __typename?: 'IdentityAndClientInfo'; + /** Client name provided when the actor performed the action */ + clientName: Maybe; + /** Client version provided when the actor performed the action */ + clientVersion: Maybe; + /** Identity info about the actor */ + identity: Maybe; +}; + +export type IdentityMutation = ServiceMutation | UserMutation; + +export type IgnoreOperationsInChecksResult = { + __typename?: 'IgnoreOperationsInChecksResult'; + graph: Service; +}; + +export type IgnoredRule = { + __typename?: 'IgnoredRule'; + ignoredRule: LintRule; + schemaCoordinate: Scalars['String']; + subgraphName: Maybe; +}; + +export type IgnoredRuleInput = { + ignoredRule: LintRule; + schemaCoordinate: Scalars['String']; + subgraphName: Maybe; +}; + +/** The location of the implementing service config file in storage */ +export type ImplementingServiceLocation = { + __typename?: 'ImplementingServiceLocation'; + /** The name of the implementing service */ + name: Scalars['String']; + /** The path in storage to access the implementing service config file */ + path: Scalars['String']; +}; + +export type InternalAdminUser = { + __typename?: 'InternalAdminUser'; + role: InternalMdgAdminRole; + userID: Scalars['String']; +}; + +export type InternalIdentity = Identity & { + __typename?: 'InternalIdentity'; + accounts: Array; + asActor: Actor; + email: Maybe; + id: Scalars['ID']; + name: Scalars['String']; +}; + +export enum InternalMdgAdminRole { + InternalMdgReadOnly = 'INTERNAL_MDG_READ_ONLY', + InternalMdgSales = 'INTERNAL_MDG_SALES', + InternalMdgSuperAdmin = 'INTERNAL_MDG_SUPER_ADMIN', + InternalMdgSupport = 'INTERNAL_MDG_SUPPORT' +} + +/** Generic server error. This should only ever return 'internal server error' as a message */ +export type InternalServerError = Error & { + __typename?: 'InternalServerError'; + /** Message related to the internal error */ + message: Scalars['String']; +}; + +export type IntrospectionDirective = { + __typename?: 'IntrospectionDirective'; + args: Array; + description: Maybe; + locations: Array; + name: Scalars['String']; +}; + +export type IntrospectionDirectiveInput = { + args: Array; + description: Maybe; + isRepeatable: Maybe; + locations: Array; + name: Scalars['String']; +}; + +/** __DirectiveLocation introspection type */ +export enum IntrospectionDirectiveLocation { /** Location adjacent to an argument definition. */ ArgumentDefinition = 'ARGUMENT_DEFINITION', /** Location adjacent to an enum definition. */ Enum = 'ENUM', - /** Location adjacent to an enum value definition. */ - EnumValue = 'ENUM_VALUE', - /** Location adjacent to a field. */ - Field = 'FIELD', - /** Location adjacent to a field definition. */ - FieldDefinition = 'FIELD_DEFINITION', - /** Location adjacent to a fragment definition. */ - FragmentDefinition = 'FRAGMENT_DEFINITION', - /** Location adjacent to a fragment spread. */ - FragmentSpread = 'FRAGMENT_SPREAD', - /** Location adjacent to an inline fragment. */ - InlineFragment = 'INLINE_FRAGMENT', - /** Location adjacent to an input object field definition. */ - InputFieldDefinition = 'INPUT_FIELD_DEFINITION', - /** Location adjacent to an input object type definition. */ + /** Location adjacent to an enum value definition. */ + EnumValue = 'ENUM_VALUE', + /** Location adjacent to a field. */ + Field = 'FIELD', + /** Location adjacent to a field definition. */ + FieldDefinition = 'FIELD_DEFINITION', + /** Location adjacent to a fragment definition. */ + FragmentDefinition = 'FRAGMENT_DEFINITION', + /** Location adjacent to a fragment spread. */ + FragmentSpread = 'FRAGMENT_SPREAD', + /** Location adjacent to an inline fragment. */ + InlineFragment = 'INLINE_FRAGMENT', + /** Location adjacent to an input object field definition. */ + InputFieldDefinition = 'INPUT_FIELD_DEFINITION', + /** Location adjacent to an input object type definition. */ + InputObject = 'INPUT_OBJECT', + /** Location adjacent to an interface definition. */ + Interface = 'INTERFACE', + /** Location adjacent to a mutation operation. */ + Mutation = 'MUTATION', + /** Location adjacent to an object type definition. */ + Object = 'OBJECT', + /** Location adjacent to a query operation. */ + Query = 'QUERY', + /** Location adjacent to a scalar definition. */ + Scalar = 'SCALAR', + /** Location adjacent to a schema definition. */ + Schema = 'SCHEMA', + /** Location adjacent to a subscription operation. */ + Subscription = 'SUBSCRIPTION', + /** Location adjacent to a union definition. */ + Union = 'UNION', + /** Location adjacent to a variable definition. */ + VariableDefinition = 'VARIABLE_DEFINITION' +} + +/** Values associated with introspection result for an enum value */ +export type IntrospectionEnumValue = { + __typename?: 'IntrospectionEnumValue'; + /** @deprecated Use deprecationReason instead */ + depreactionReason: Maybe; + deprecationReason: Maybe; + description: Maybe; + isDeprecated: Scalars['Boolean']; + name: Scalars['String']; +}; + +/** __EnumValue introspection type */ +export type IntrospectionEnumValueInput = { + deprecationReason: Maybe; + description: Maybe; + isDeprecated: Scalars['Boolean']; + name: Scalars['String']; +}; + +/** Values associated with introspection result for field */ +export type IntrospectionField = { + __typename?: 'IntrospectionField'; + args: Array; + deprecationReason: Maybe; + description: Maybe; + isDeprecated: Scalars['Boolean']; + name: Scalars['String']; + type: IntrospectionType; +}; + +/** __Field introspection type */ +export type IntrospectionFieldInput = { + args: Array; + deprecationReason: Maybe; + description: Maybe; + isDeprecated: Scalars['Boolean']; + name: Scalars['String']; + type: IntrospectionTypeInput; +}; + +/** Values associated with introspection result for an input field */ +export type IntrospectionInputValue = { + __typename?: 'IntrospectionInputValue'; + defaultValue: Maybe; + description: Maybe; + name: Scalars['String']; + type: IntrospectionType; +}; + +/** __Value introspection type */ +export type IntrospectionInputValueInput = { + defaultValue: Maybe; + deprecationReason: Maybe; + description: Maybe; + isDeprecated: Maybe; + name: Scalars['String']; + type: IntrospectionTypeInput; +}; + +export type IntrospectionSchema = { + __typename?: 'IntrospectionSchema'; + directives: Array; + mutationType: Maybe; + queryType: IntrospectionType; + subscriptionType: Maybe; + types: Array; +}; + + +export type IntrospectionSchemaTypesArgs = { + filter?: Maybe; +}; + +/** __Schema introspection type */ +export type IntrospectionSchemaInput = { + description: Maybe; + directives: Array; + mutationType: Maybe; + queryType: IntrospectionTypeRefInput; + subscriptionType: Maybe; + types: Maybe>; +}; + +/** Object containing all possible values for an introspectionType */ +export type IntrospectionType = { + __typename?: 'IntrospectionType'; + /** the base kind of the type this references, ignoring lists and nullability */ + baseKind: Maybe; + description: Maybe; + enumValues: Maybe>; + fields: Maybe>; + inputFields: Maybe>; + interfaces: Maybe>; + kind: Maybe; + name: Maybe; + ofType: Maybe; + possibleTypes: Maybe>; + /** printed representation of type, including nested nullability and list ofTypes */ + printed: Scalars['String']; +}; + + +/** Object containing all possible values for an introspectionType */ +export type IntrospectionTypeEnumValuesArgs = { + includeDeprecated?: Maybe; +}; + +/** __Type introspection type */ +export type IntrospectionTypeInput = { + description: Maybe; + enumValues: Maybe>; + fields: Maybe>; + inputFields: Maybe>; + interfaces: Maybe>; + kind: IntrospectionTypeKind; + name: Maybe; + ofType: Maybe; + possibleTypes: Maybe>; + specifiedByUrl: Maybe; +}; + +export enum IntrospectionTypeKind { + /** Indicates this type is an enum. 'enumValues' is a valid field. */ + Enum = 'ENUM', + /** Indicates this type is an input object. 'inputFields' is a valid field. */ InputObject = 'INPUT_OBJECT', - /** Location adjacent to an interface definition. */ + /** + * Indicates this type is an interface. 'fields' and 'possibleTypes' are valid + * fields + */ Interface = 'INTERFACE', - /** Location adjacent to a mutation operation. */ - Mutation = 'MUTATION', - /** Location adjacent to an object type definition. */ + /** Indicates this type is a list. 'ofType' is a valid field. */ + List = 'LIST', + /** Indicates this type is a non-null. 'ofType' is a valid field. */ + NonNull = 'NON_NULL', + /** Indicates this type is an object. 'fields' and 'interfaces' are valid fields. */ Object = 'OBJECT', - /** Location adjacent to a query operation. */ - Query = 'QUERY', - /** Location adjacent to a scalar definition. */ + /** Indicates this type is a scalar. */ Scalar = 'SCALAR', - /** Location adjacent to a schema definition. */ - Schema = 'SCHEMA', - /** Location adjacent to a subscription operation. */ - Subscription = 'SUBSCRIPTION', - /** Location adjacent to a union definition. */ - Union = 'UNION', - /** Location adjacent to a variable definition. */ - VariableDefinition = 'VARIABLE_DEFINITION' + /** Indicates this type is a union. 'possibleTypes' is a valid field. */ + Union = 'UNION' +} + +/** Shallow __Type introspection type */ +export type IntrospectionTypeRefInput = { + kind: Maybe; + name: Scalars['String']; +}; + +/** An error caused by providing invalid input for a task, such as schema checks. */ +export type InvalidInputError = { + __typename?: 'InvalidInputError'; + /** The error message. */ + message: Scalars['String']; +}; + +/** Generic input error */ +export type InvalidInputErrors = Error & { + __typename?: 'InvalidInputErrors'; + errors: Array; + message: Scalars['String']; +}; + +export type InvalidOperation = { + __typename?: 'InvalidOperation'; + errors: Maybe>; + signature: Scalars['ID']; +}; + +/** This object is returned when a request to fetch a Studio graph variant provides an invalid graph ref. */ +export type InvalidRefFormat = Error & { + __typename?: 'InvalidRefFormat'; + message: Scalars['String']; +}; + +/** Invalid request */ +export type InvalidRequest = { + __typename?: 'InvalidRequest'; + /** Error message */ + message: Scalars['String']; +}; + +export type InvalidTarget = Error & { + __typename?: 'InvalidTarget'; + message: Scalars['String']; +}; + +export type Invoice = { + __typename?: 'Invoice'; + closedAt: Maybe; + collectionMethod: Maybe; + createdAt: Scalars['Timestamp']; + id: Scalars['ID']; + invoiceNumber: Scalars['Int']; + invoiceNumberV2: Scalars['String']; + state: InvoiceState; + totalInCents: Scalars['Int']; + updatedAt: Scalars['Timestamp']; + uuid: Scalars['ID']; +}; + +export type InvoiceLineItem = { + __typename?: 'InvoiceLineItem'; + /** Line items may be grouped to help the customer better understand their charges */ + groupKey: Maybe; + /** Line items may be grouped to help the customer better understand their charges */ + groupValue: Maybe; + name: Scalars['String']; + /** + * The quantity of 'things' in this line item. (e.g. number of operations, seats, etc). + * May be null for flat charges. + */ + quantity: Maybe; + /** The amount this line item costs. */ + totalInCents: Scalars['Int']; +}; + +export enum InvoiceState { + Collected = 'COLLECTED', + Failed = 'FAILED', + Open = 'OPEN', + PastDue = 'PAST_DUE', + Unknown = 'UNKNOWN', + Void = 'VOID' +} + +/** Represents the complete process of making a set of updates to a deployed graph variant. */ +export type Launch = { + __typename?: 'Launch'; + /** The timestamp when the launch was approved. */ + approvedAt: Maybe; + /** The associated build for this launch (a build includes schema composition and contract filtering). This value is null until the build is initiated. */ + build: Maybe; + /** The inputs provided to this launch's associated build, including subgraph schemas and contract filters. */ + buildInput: BuildInput; + /** The timestamp when the launch completed. This value is null until the launch completes. */ + completedAt: Maybe; + /** The timestamp when the launch was initiated. */ + createdAt: Scalars['Timestamp']; + /** Contract launches that were triggered by this launch. */ + downstreamLaunches: Array; + /** The ID of the launch's associated graph. */ + graphId: Scalars['String']; + /** The name of the launch's associated variant. */ + graphVariant: Scalars['String']; + /** The unique identifier for this launch. */ + id: Scalars['ID']; + isAvailable: Maybe; + /** Whether the launch completed. */ + isCompleted: Maybe; + /** Whether the result of the launch has been published to the associated graph and variant. This is always false for a failed launch. */ + isPublished: Maybe; + isTarget: Maybe; + /** The most recent launch sequence step that has started but not necessarily completed. */ + latestSequenceStep: Maybe; + /** Cloud Router order for this launch ID */ + order: OrderOrError; + orders: Array; + /** The launch right before this one. Null if this is the first on this variant. */ + previousLaunch: Maybe; + proposalRevision: Maybe; + /** A specific publication of a graph variant pertaining to this launch. */ + publication: Maybe; + /** A list of results from the completed launch. The items included in this list vary depending on whether the launch succeeded, failed, or was superseded. */ + results: Array; + /** Cloud router configuration associated with this build event. It will be non-null for any cloud-router variant, and null for any not cloudy variant/graph. */ + routerConfig: Maybe; + schemaTag: Maybe; + /** A list of all serial steps in the launch sequence. This list can change as the launch progresses. For example, a `LaunchCompletedStep` is appended after a launch completes. */ + sequence: Array; + /** A shortened version of `Launch.id` that includes only the first 8 characters. */ + shortenedID: Scalars['String']; + /** The launch's status. If a launch is superseded, its status remains `LAUNCH_INITIATED`. To check for a superseded launch, use `supersededAt`. */ + status: LaunchStatus; + /** A list of subgraph changes that are included in this launch. */ + subgraphChanges: Maybe>; + /** The timestamp when this launch was superseded by another launch. If an active launch is superseded, it terminates. */ + supersededAt: Maybe; + /** The launch that superseded this launch, if any. If an active launch is superseded, it terminates. */ + supersededBy: Maybe; + /** The source variant launch that caused this launch to be initiated. This value is present only for contract variant launches. Otherwise, it's null. */ + upstreamLaunch: Maybe; +}; + +export enum LaunchHistoryOrder { + CreatedAsc = 'CREATED_ASC', + CreatedDesc = 'CREATED_DESC' +} + +/** Types of results that can be associated with a `Launch` */ +export type LaunchResult = ChangelogLaunchResult; + +/** The timing details for the build step of a launch. */ +export type LaunchSequenceBuildStep = { + __typename?: 'LaunchSequenceBuildStep'; + /** The timestamp when the step completed. */ + completedAt: Maybe; + /** The timestamp when the step started. */ + startedAt: Maybe; +}; + +/** The timing details for the completion step of a launch. */ +export type LaunchSequenceCompletedStep = { + __typename?: 'LaunchSequenceCompletedStep'; + /** The timestamp when the step (and therefore the launch) completed. */ + completedAt: Maybe; +}; + +/** The timing details for the initiation step of a launch. */ +export type LaunchSequenceInitiatedStep = { + __typename?: 'LaunchSequenceInitiatedStep'; + /** The timestamp when the step (and therefore the launch) started. */ + startedAt: Maybe; +}; + +/** The timing details for the publish step of a launch. */ +export type LaunchSequencePublishStep = { + __typename?: 'LaunchSequencePublishStep'; + /** The timestamp when the step completed. */ + completedAt: Maybe; + /** The timestamp when the step started. */ + startedAt: Maybe; +}; + +/** Represents the various steps that occur in sequence during a single launch. */ +export type LaunchSequenceStep = LaunchSequenceBuildStep | LaunchSequenceCompletedStep | LaunchSequenceInitiatedStep | LaunchSequencePublishStep | LaunchSequenceSupersededStep; + +/** The timing details for the superseded step of a launch. This step occurs only if the launch is superseded by another launch. */ +export type LaunchSequenceSupersededStep = { + __typename?: 'LaunchSequenceSupersededStep'; + /** The timestamp when the step completed, thereby ending the execution of this launch in favor of the superseding launch. */ + completedAt: Maybe; +}; + +export enum LaunchStatus { + LaunchCompleted = 'LAUNCH_COMPLETED', + LaunchFailed = 'LAUNCH_FAILED', + LaunchInitiated = 'LAUNCH_INITIATED' +} + +export type LinkInfo = { + __typename?: 'LinkInfo'; + createdAt: Scalars['Timestamp']; + id: Scalars['ID']; + title: Maybe; + type: LinkInfoType; + url: Scalars['String']; +}; + +export enum LinkInfoType { + DeveloperPortal = 'DEVELOPER_PORTAL', + Other = 'OTHER', + Repository = 'REPOSITORY' +} + +export type LinkPersistedQueryListResult = { + __typename?: 'LinkPersistedQueryListResult'; + graphVariant: GraphVariant; + persistedQueryList: PersistedQueryList; +}; + +export type LinkPersistedQueryListResultOrError = LinkPersistedQueryListResult | ListNotFoundError | PermissionError | VariantAlreadyLinkedError; + +export type LintCheckTask = CheckWorkflowTask & { + __typename?: 'LintCheckTask'; + completedAt: Maybe; + createdAt: Scalars['Timestamp']; + graphID: Scalars['ID']; + id: Scalars['ID']; + result: Maybe; + status: CheckWorkflowTaskStatus; + targetURL: Maybe; + workflow: CheckWorkflow; +}; + +/** A single rule violation. */ +export type LintDiagnostic = { + __typename?: 'LintDiagnostic'; + /** The category used for grouping similar rules. */ + category: LinterRuleCategory; + /** The schema coordinate of this diagnostic. */ + coordinate: Scalars['String']; + /** The graph's configured level for the rule. */ + level: LintDiagnosticLevel; + /** The message describing the rule violation. */ + message: Scalars['String']; + /** The lint rule being violated. */ + rule: LintRule; + /** The human readable position in the file of the rule violation. */ + sourceLocations: Array; +}; + +/** The severity level of an lint result. */ +export enum LintDiagnosticLevel { + Error = 'ERROR', + Ignored = 'IGNORED', + Warning = 'WARNING' +} + +/** The result of linting a schema. */ +export type LintResult = { + __typename?: 'LintResult'; + /** The set of lint rule violations found in the schema. */ + diagnostics: Array; + /** Stats generated from the resulting diagnostics. */ + stats: LintStats; +}; + +export enum LintRule { + AllElementsRequireDescription = 'ALL_ELEMENTS_REQUIRE_DESCRIPTION', + ContactDirectiveMissing = 'CONTACT_DIRECTIVE_MISSING', + DefinedTypesAreUnused = 'DEFINED_TYPES_ARE_UNUSED', + DeprecatedDirectiveMissingReason = 'DEPRECATED_DIRECTIVE_MISSING_REASON', + DirectiveComposition = 'DIRECTIVE_COMPOSITION', + DirectiveNamesShouldBeCamelCase = 'DIRECTIVE_NAMES_SHOULD_BE_CAMEL_CASE', + DoesNotParse = 'DOES_NOT_PARSE', + EnumPrefix = 'ENUM_PREFIX', + EnumSuffix = 'ENUM_SUFFIX', + EnumUsedAsInputWithoutSuffix = 'ENUM_USED_AS_INPUT_WITHOUT_SUFFIX', + EnumUsedAsOutputDespiteSuffix = 'ENUM_USED_AS_OUTPUT_DESPITE_SUFFIX', + EnumValuesShouldBeScreamingSnakeCase = 'ENUM_VALUES_SHOULD_BE_SCREAMING_SNAKE_CASE', + FieldNamesShouldBeCamelCase = 'FIELD_NAMES_SHOULD_BE_CAMEL_CASE', + FromSubgraphDoesNotExist = 'FROM_SUBGRAPH_DOES_NOT_EXIST', + InconsistentArgumentPresence = 'INCONSISTENT_ARGUMENT_PRESENCE', + InconsistentButCompatibleArgumentType = 'INCONSISTENT_BUT_COMPATIBLE_ARGUMENT_TYPE', + InconsistentButCompatibleFieldType = 'INCONSISTENT_BUT_COMPATIBLE_FIELD_TYPE', + InconsistentDefaultValuePresence = 'INCONSISTENT_DEFAULT_VALUE_PRESENCE', + InconsistentDescription = 'INCONSISTENT_DESCRIPTION', + InconsistentEntity = 'INCONSISTENT_ENTITY', + InconsistentEnumValueForInputEnum = 'INCONSISTENT_ENUM_VALUE_FOR_INPUT_ENUM', + InconsistentEnumValueForOutputEnum = 'INCONSISTENT_ENUM_VALUE_FOR_OUTPUT_ENUM', + InconsistentExecutableDirectiveLocations = 'INCONSISTENT_EXECUTABLE_DIRECTIVE_LOCATIONS', + InconsistentExecutableDirectivePresence = 'INCONSISTENT_EXECUTABLE_DIRECTIVE_PRESENCE', + InconsistentExecutableDirectiveRepeatable = 'INCONSISTENT_EXECUTABLE_DIRECTIVE_REPEATABLE', + InconsistentInputObjectField = 'INCONSISTENT_INPUT_OBJECT_FIELD', + InconsistentInterfaceValueTypeField = 'INCONSISTENT_INTERFACE_VALUE_TYPE_FIELD', + InconsistentNonRepeatableDirectiveArguments = 'INCONSISTENT_NON_REPEATABLE_DIRECTIVE_ARGUMENTS', + InconsistentObjectValueTypeField = 'INCONSISTENT_OBJECT_VALUE_TYPE_FIELD', + InconsistentRuntimeTypesForShareableReturn = 'INCONSISTENT_RUNTIME_TYPES_FOR_SHAREABLE_RETURN', + InconsistentTypeSystemDirectiveLocations = 'INCONSISTENT_TYPE_SYSTEM_DIRECTIVE_LOCATIONS', + InconsistentTypeSystemDirectiveRepeatable = 'INCONSISTENT_TYPE_SYSTEM_DIRECTIVE_REPEATABLE', + InconsistentUnionMember = 'INCONSISTENT_UNION_MEMBER', + InputArgumentNamesShouldBeCamelCase = 'INPUT_ARGUMENT_NAMES_SHOULD_BE_CAMEL_CASE', + InputTypeSuffix = 'INPUT_TYPE_SUFFIX', + InterfacePrefix = 'INTERFACE_PREFIX', + InterfaceSuffix = 'INTERFACE_SUFFIX', + MergedNonRepeatableDirectiveArguments = 'MERGED_NON_REPEATABLE_DIRECTIVE_ARGUMENTS', + NoExecutableDirectiveIntersection = 'NO_EXECUTABLE_DIRECTIVE_INTERSECTION', + ObjectPrefix = 'OBJECT_PREFIX', + ObjectSuffix = 'OBJECT_SUFFIX', + OverriddenFieldCanBeRemoved = 'OVERRIDDEN_FIELD_CAN_BE_REMOVED', + OverrideDirectiveCanBeRemoved = 'OVERRIDE_DIRECTIVE_CAN_BE_REMOVED', + QueryDocumentDeclaration = 'QUERY_DOCUMENT_DECLARATION', + RestyFieldNames = 'RESTY_FIELD_NAMES', + TagDirectiveUsesUnknownName = 'TAG_DIRECTIVE_USES_UNKNOWN_NAME', + TypeNamesShouldBePascalCase = 'TYPE_NAMES_SHOULD_BE_PASCAL_CASE', + TypePrefix = 'TYPE_PREFIX', + TypeSuffix = 'TYPE_SUFFIX', + UnusedEnumType = 'UNUSED_ENUM_TYPE' +} + +/** Stats generated from linting a schema against the graph's linter configuration. */ +export type LintStats = { + __typename?: 'LintStats'; + /** Total number of lint errors. */ + errorsCount: Scalars['Int']; + /** Total number of lint rules ignored. */ + ignoredCount: Scalars['Int']; + /** Total number of lint rules violated. */ + totalCount: Scalars['Int']; + /** Total number of lint warnings. */ + warningsCount: Scalars['Int']; +}; + +export type LinterIgnoredRuleChangesInput = { + ruleViolationsToEnable: Array; + ruleViolationsToIgnore: Array; +}; + +/** The category used for grouping similar rules. */ +export enum LinterRuleCategory { + /** These rules are generated during composition. */ + Composition = 'COMPOSITION', + /** These rules enforce naming conventions. */ + Naming = 'NAMING', + /** These rules define conventions for the entire schema and directive usage outside of composition. */ + Other = 'OTHER' +} + +export type LinterRuleLevelConfiguration = { + __typename?: 'LinterRuleLevelConfiguration'; + /** Illustrative code showcasing the potential violation of this rule. */ + badExampleCode: Maybe; + /** The category used for grouping similar rules. */ + category: LinterRuleCategory; + /** A human readable description of the rule. */ + description: Scalars['String']; + /** Illustrative code showcasing the fix for the potential violation of this rule. */ + goodExampleCode: Maybe; + /** The configured level for the rule. */ + level: LintDiagnosticLevel; + /** The name for this lint rule. */ + rule: LintRule; +}; + +export type LinterRuleLevelConfigurationChangesInput = { + level: LintDiagnosticLevel; + rule: LintRule; +}; + +export type ListNotFoundError = Error & { + __typename?: 'ListNotFoundError'; + listId: Scalars['ID']; + message: Scalars['String']; +}; + +export type Location = { + __typename?: 'Location'; + end: Maybe; + start: Maybe; + subgraphName: Maybe; +}; + +/** Level of the log entry */ +export enum LogLevel { + /** Debug log entry */ + Debug = 'DEBUG', + /** Error log entry */ + Error = 'ERROR', + /** Informational log entry */ + Info = 'INFO', + /** Warning log entry */ + Warn = 'WARN' +} + +/** Order log message */ +export type LogMessage = { + __typename?: 'LogMessage'; + /** Log level */ + level: LogLevel; + /** Log message contents */ + message: Scalars['String']; + /** Timestamp in UTC */ + timestamp: Scalars['DateTime']; +}; + +export type MarkChangesForOperationAsSafeResult = { + __typename?: 'MarkChangesForOperationAsSafeResult'; + /** + * Nice to have for the frontend since the Apollo cache is already watching for AffectedQuery to update. + * This might return null if no behavior changes were found for the affected operation ID. + * This is a weird situation that should never happen. + */ + affectedOperation: Maybe; + message: Scalars['String']; + success: Scalars['Boolean']; +}; + +export type MediaUploadInfo = { + __typename?: 'MediaUploadInfo'; + csrfToken: Scalars['String']; + maxContentLength: Scalars['Int']; + url: Scalars['String']; +}; + +export type Message = { + __typename?: 'Message'; + auditLog: Array; + channels: Array; + confirmations: Array>; + content: MessageContent; + createdAt: Scalars['Timestamp']; + id: Scalars['ID']; + modifiedAt: Scalars['Timestamp']; + state: State; + user: RequesterUser; +}; + +export type MessageConfirmation = { + __typename?: 'MessageConfirmation'; + channel: Maybe; + createdAt: Scalars['Timestamp']; + id: Scalars['ID']; + modifiedAt: Scalars['Timestamp']; + slackMessage: SlackMessageMeta; + state: SlackPublishState; +}; + +export type MessageContent = { + __typename?: 'MessageContent'; + body: Scalars['String']; + buttonText: Maybe; + buttonURL: Maybe; + header: Scalars['String']; +}; + +export type MessageInput = { + body_text: Scalars['String']; + button_text: Maybe; + button_url: Maybe; + channel_id: Array; + header_text: Scalars['String']; +}; + +export type MessageMutationResult = CustomerSupportSlackError | Message; + +export type MetricStatWindow = { + __typename?: 'MetricStatWindow'; + timestamp: Scalars['Timestamp']; + value: Scalars['Long']; + windowSize: BillingUsageStatsWindowSize; +}; + +export type MoveOperationCollectionEntryResult = InvalidTarget | MoveOperationCollectionEntrySuccess | PermissionError; + +export type MoveOperationCollectionEntrySuccess = { + __typename?: 'MoveOperationCollectionEntrySuccess'; + operation: OperationCollectionEntry; + originCollection: OperationCollection; + targetCollection: OperationCollection; +}; + +/** GraphQL mutations */ +export type Mutation = { + __typename?: 'Mutation'; + account: Maybe; + approveMessage: MessageMutationResult; + billing: Maybe; + /** Cloud mutations */ + cloud: CloudMutation; + createMessage: MessageMutationResult; + /** Creates an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/) for a given variant, or creates a [sandbox collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/#sandbox-collections) without an associated variant. */ + createOperationCollection: CreateOperationCollectionResult; + editMessage: MessageMutationResult; + /** + * Finalize a password reset with a token included in the E-mail link, + * returns the corresponding login email when successful + */ + finalizePasswordReset: Maybe; + /** Provides access to mutation fields for modifying a Studio graph with the provided ID. */ + graph: Maybe; + /** Join an account with a token */ + joinAccount: Maybe; + me: Maybe; + newAccount: Maybe; + /** Define a new billing plan */ + newBillingPlan: Maybe; + /** Define a new boolean capability to be applied to billing plans and subscriptions */ + newCapability: Maybe; + /** Define a new numeric limit to be applied to billing plans and subscriptions */ + newLimit: Maybe; + newService: Maybe; + operationCollection: Maybe; + plan: Maybe; + proposal: ProposalMutationResult; + proposalByVariantRef: ProposalMutationResult; + publishSlackMessage: MessageMutationResult; + publishSlackTest: MessageMutationResult; + /** Push a lead to Marketo by program ID */ + pushMarketoLead: Scalars['Boolean']; + recallMessage: MessageMutationResult; + /** Report a running GraphQL server's schema. */ + reportSchema: Maybe; + /** Ask for a user's password to be reset by E-mail */ + resetPassword: Maybe; + resolveAllInternalCronExecutions: Maybe; + resolveInternalCronExecution: Maybe; + service: Maybe; + /** Set the subscriptions for a given email */ + setSubscriptions: Maybe; + /** Set the studio settings for the current user */ + setUserSettings: Maybe; + signUp: Maybe; + /** This is called by the form shown to users after they delete their user or organization account. */ + submitPostDeletionFeedback: Maybe; + /** Mutation for basic engagement tracking in studio */ + track: Maybe; + /** Apollo Kotlin usage tracking. */ + trackApolloKotlinUsage: Maybe; + /** Router usage tracking. Reserved to https://router.apollo.dev/telemetry (https://github.com/apollographql/orbiter). */ + trackRouterUsage: Maybe; + /** Rover session tracking. Reserved to https://rover.apollo.dev/telemetry (https://github.com/apollographql/orbiter). */ + trackRoverSession: Maybe; + transferOdysseyProgress: Scalars['Boolean']; + /** Unsubscribe a given email from all emails */ + unsubscribeFromAll: Maybe; + updateSurvey: Survey; + /** + * Provides access to mutation fields for modifying an Apollo user with the + * provided ID. + */ + user: Maybe; +}; + + +/** GraphQL mutations */ +export type MutationAccountArgs = { + id: Scalars['ID']; +}; + + +/** GraphQL mutations */ +export type MutationApproveMessageArgs = { + messageId: Scalars['ID']; + state: State; +}; + + +/** GraphQL mutations */ +export type MutationCreateMessageArgs = { + message: MessageInput; +}; + + +/** GraphQL mutations */ +export type MutationCreateOperationCollectionArgs = { + description: Maybe; + isSandbox: Scalars['Boolean']; + isShared: Scalars['Boolean']; + minEditRole: Maybe; + name: Scalars['String']; + variantRefs: Maybe>; +}; + + +/** GraphQL mutations */ +export type MutationEditMessageArgs = { + messageId: Scalars['ID']; + messageUpdates: MessageInput; +}; + + +/** GraphQL mutations */ +export type MutationFinalizePasswordResetArgs = { + newPassword: Scalars['String']; + resetToken: Scalars['String']; +}; + + +/** GraphQL mutations */ +export type MutationGraphArgs = { + id: Scalars['ID']; +}; + + +/** GraphQL mutations */ +export type MutationJoinAccountArgs = { + accountId: Scalars['ID']; + joinToken: Scalars['String']; +}; + + +/** GraphQL mutations */ +export type MutationNewAccountArgs = { + companyUrl: Maybe; + id: Scalars['ID']; + organizationName: Maybe; + planId: Maybe; +}; + + +/** GraphQL mutations */ +export type MutationNewBillingPlanArgs = { + plan: BillingPlanInput; +}; + + +/** GraphQL mutations */ +export type MutationNewCapabilityArgs = { + capability: BillingCapabilityInput; +}; + + +/** GraphQL mutations */ +export type MutationNewLimitArgs = { + limit: BillingLimitInput; +}; + + +/** GraphQL mutations */ +export type MutationNewServiceArgs = { + accountId: Scalars['ID']; + description: Maybe; + hiddenFromUninvitedNonAdminAccountMembers?: Scalars['Boolean']; + id: Scalars['ID']; + name: Maybe; + onboardingArchitecture: Maybe; + title: Maybe; +}; + + +/** GraphQL mutations */ +export type MutationOperationCollectionArgs = { + id: Scalars['ID']; +}; + + +/** GraphQL mutations */ +export type MutationPlanArgs = { + id: Scalars['ID']; +}; + + +/** GraphQL mutations */ +export type MutationProposalArgs = { + id: Scalars['ID']; +}; + + +/** GraphQL mutations */ +export type MutationProposalByVariantRefArgs = { + variantRef: Scalars['ID']; +}; + + +/** GraphQL mutations */ +export type MutationPublishSlackMessageArgs = { + messageId: Scalars['ID']; +}; + + +/** GraphQL mutations */ +export type MutationPublishSlackTestArgs = { + messageId: Scalars['ID']; +}; + + +/** GraphQL mutations */ +export type MutationPushMarketoLeadArgs = { + input: PushMarketoLeadInput; + programId: Scalars['ID']; + programStatus: Maybe; + source: Maybe; +}; + + +/** GraphQL mutations */ +export type MutationRecallMessageArgs = { + slackChannelId: Scalars['ID']; + slackMessageId: Scalars['ID']; +}; + + +/** GraphQL mutations */ +export type MutationReportSchemaArgs = { + coreSchema: Maybe; + report: SchemaReport; +}; + + +/** GraphQL mutations */ +export type MutationResetPasswordArgs = { + email: Scalars['String']; +}; + + +/** GraphQL mutations */ +export type MutationResolveAllInternalCronExecutionsArgs = { + group: Maybe; + name: Maybe; +}; + + +/** GraphQL mutations */ +export type MutationResolveInternalCronExecutionArgs = { + id: Scalars['ID']; +}; + + +/** GraphQL mutations */ +export type MutationServiceArgs = { + id: Scalars['ID']; +}; + + +/** GraphQL mutations */ +export type MutationSetSubscriptionsArgs = { + email: Scalars['String']; + subscriptions: Array; + token: Scalars['String']; +}; + + +/** GraphQL mutations */ +export type MutationSetUserSettingsArgs = { + newSettings: Maybe; +}; + + +/** GraphQL mutations */ +export type MutationSignUpArgs = { + email: Scalars['String']; + fullName: Scalars['String']; + password: Scalars['String']; + referrer: Maybe; + trackingGoogleClientId: Maybe; + trackingMarketoClientId: Maybe; + userSegment: Maybe; + utmCampaign: Maybe; + utmMedium: Maybe; + utmSource: Maybe; +}; + + +/** GraphQL mutations */ +export type MutationSubmitPostDeletionFeedbackArgs = { + feedback: Scalars['String']; + targetIdentifier: Scalars['ID']; + targetType: DeletionTargetType; +}; + + +/** GraphQL mutations */ +export type MutationTrackArgs = { + event: EventEnum; + graphID: Scalars['String']; + graphVariant?: Scalars['String']; +}; + + +/** GraphQL mutations */ +export type MutationTrackApolloKotlinUsageArgs = { + events: Array; + instanceId: Scalars['ID']; + properties: Array; +}; + + +/** GraphQL mutations */ +export type MutationTrackRouterUsageArgs = { + ci: Maybe; + os: Scalars['String']; + sessionId: Scalars['ID']; + usage: Array; + version: Scalars['String']; +}; + + +/** GraphQL mutations */ +export type MutationTrackRoverSessionArgs = { + anonymousId: Scalars['ID']; + arguments: Array; + ci: Maybe; + command: Scalars['String']; + cwdHash: Scalars['SHA256']; + os: Scalars['String']; + remoteUrlHash: Maybe; + sessionId: Scalars['ID']; + version: Scalars['String']; +}; + + +/** GraphQL mutations */ +export type MutationTransferOdysseyProgressArgs = { + from: Scalars['ID']; + to: Scalars['ID']; +}; + + +/** GraphQL mutations */ +export type MutationUnsubscribeFromAllArgs = { + email: Scalars['String']; + token: Scalars['String']; +}; + + +/** GraphQL mutations */ +export type MutationUpdateSurveyArgs = { + internalAccountId: Scalars['String']; + surveyId: Scalars['String']; + surveyState: Array; +}; + + +/** GraphQL mutations */ +export type MutationUserArgs = { + id: Scalars['ID']; +}; + +export type NamedIntrospectionArg = { + __typename?: 'NamedIntrospectionArg'; + description: Maybe; + name: Maybe; +}; + +export type NamedIntrospectionArgNoDescription = { + __typename?: 'NamedIntrospectionArgNoDescription'; + name: Maybe; +}; + +/** + * The shared fields for a named introspection type. Currently this is returned for the + * top level value affected by a change. In the future, we may update this + * type to be an interface, which is extended by the more specific types: + * scalar, object, input object, union, interface, and enum + * + * For an in-depth look at where these types come from, see: + * https://github.com/DefinitelyTyped/DefinitelyTyped/blob/659eb50d3/types/graphql/utilities/introspectionQuery.d.ts#L31-L37 + */ +export type NamedIntrospectionType = { + __typename?: 'NamedIntrospectionType'; + description: Maybe; + kind: Maybe; + name: Maybe; +}; + +export type NamedIntrospectionTypeNoDescription = { + __typename?: 'NamedIntrospectionTypeNoDescription'; + name: Maybe; +}; + +/** + * Introspection values that can be children of other types for changes, such + * as input fields, objects in interfaces, enum values. In the future, this + * value could become an interface to allow fields specific to the types + * returned. + */ +export type NamedIntrospectionValue = { + __typename?: 'NamedIntrospectionValue'; + description: Maybe; + name: Maybe; + printedType: Maybe; +}; + +export type NamedIntrospectionValueNoDescription = { + __typename?: 'NamedIntrospectionValueNoDescription'; + name: Maybe; + printedType: Maybe; +}; + +/** A non-federated service for a monolithic graph. */ +export type NonFederatedImplementingService = { + __typename?: 'NonFederatedImplementingService'; + /** Timestamp of when this implementing service was created. */ + createdAt: Scalars['Timestamp']; + /** + * Identifies which graph this non-implementing service belongs to. + * Formerly known as "service_id". + */ + graphID: Scalars['String']; + /** + * Specifies which variant of a graph this implementing service belongs to". + * Formerly known as "tag". + */ + graphVariant: Scalars['String']; +}; + +/** An error that occurs when a requested object is not found. */ +export type NotFoundError = Error & { + __typename?: 'NotFoundError'; + /** The error message. */ + message: Scalars['String']; +}; + +export type OdysseyAttempt = { + __typename?: 'OdysseyAttempt'; + completedAt: Maybe; + id: Scalars['ID']; + pass: Maybe; + responses: Array; + startedAt: Scalars['Timestamp']; + testId: Scalars['String']; +}; + +export type OdysseyCertification = { + __typename?: 'OdysseyCertification'; + certificationId: Scalars['String']; + earnedAt: Scalars['Timestamp']; + id: Scalars['ID']; + owner: Maybe; + source: Maybe; +}; + +export type OdysseyCertificationOwner = { + __typename?: 'OdysseyCertificationOwner'; + fullName: Scalars['String']; + id: Scalars['ID']; +}; + +export type OdysseyCourse = { + __typename?: 'OdysseyCourse'; + completedAt: Maybe; + enrolledAt: Maybe; + id: Scalars['ID']; +}; + +export type OdysseyCourseInput = { + completedAt: Maybe; + courseId: Scalars['String']; + isBeta: Maybe; +}; + +export type OdysseyResponse = { + __typename?: 'OdysseyResponse'; + correct: Maybe; + id: Scalars['ID']; + questionId: Scalars['String']; + values: Array; +}; + +export type OdysseyResponseCorrectnessInput = { + correct: Scalars['Boolean']; + id: Scalars['ID']; +}; + +export type OdysseyResponseInput = { + attemptId: Scalars['ID']; + correct: Maybe; + questionId: Scalars['String']; + values: Array; +}; + +export type OdysseyTask = { + __typename?: 'OdysseyTask'; + completedAt: Maybe; + id: Scalars['ID']; + value: Maybe; +}; + +export type OdysseyTaskInput = { + completedAt: Maybe; + taskId: Scalars['String']; + value: Maybe; +}; + +export type OdysseyValue = { + __typename?: 'OdysseyValue'; + id: Scalars['ID']; + value: Scalars['String']; +}; + +export enum OnboardingArchitecture { + Monolith = 'MONOLITH', + Supergraph = 'SUPERGRAPH' } -/** Values associated with introspection result for an enum value */ -export type IntrospectionEnumValue = { - __typename?: 'IntrospectionEnumValue'; - /** @deprecated Use deprecationReason instead */ - depreactionReason: Maybe; - deprecationReason: Maybe; +export type Operation = { + __typename?: 'Operation'; + id: Scalars['ID']; + name: Maybe; + signature: Maybe; + truncated: Scalars['Boolean']; +}; + +export type OperationAcceptedChange = { + __typename?: 'OperationAcceptedChange'; + acceptedAt: Scalars['Timestamp']; + acceptedBy: Maybe; + change: StoredApprovedChange; + checkID: Scalars['ID']; + graphID: Scalars['ID']; + id: Scalars['ID']; + operationID: Scalars['String']; +}; + +/** Columns of OperationCheckStats. */ +export enum OperationCheckStatsColumn { + CachedRequestsCount = 'CACHED_REQUESTS_COUNT', + ClientName = 'CLIENT_NAME', + ClientVersion = 'CLIENT_VERSION', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', + QueryId = 'QUERY_ID', + QueryName = 'QUERY_NAME', + SchemaTag = 'SCHEMA_TAG', + ServiceId = 'SERVICE_ID', + Timestamp = 'TIMESTAMP', + UncachedRequestsCount = 'UNCACHED_REQUESTS_COUNT' +} + +export type OperationCheckStatsDimensions = { + __typename?: 'OperationCheckStatsDimensions'; + clientName: Maybe; + clientVersion: Maybe; + operationSubtype: Maybe; + operationType: Maybe; + queryId: Maybe; + queryName: Maybe; + schemaTag: Maybe; + serviceId: Maybe; +}; + +/** Filter for data in OperationCheckStats. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ +export type OperationCheckStatsFilter = { + and: Maybe>; + /** Selects rows whose clientName dimension equals the given value if not null. To query for the null value, use {in: {clientName: [null]}} instead. */ + clientName: Maybe; + /** Selects rows whose clientVersion dimension equals the given value if not null. To query for the null value, use {in: {clientVersion: [null]}} instead. */ + clientVersion: Maybe; + in: Maybe; + not: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; + or: Maybe>; + /** Selects rows whose queryId dimension equals the given value if not null. To query for the null value, use {in: {queryId: [null]}} instead. */ + queryId: Maybe; + /** Selects rows whose queryName dimension equals the given value if not null. To query for the null value, use {in: {queryName: [null]}} instead. */ + queryName: Maybe; + /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ + schemaTag: Maybe; + /** Selects rows whose serviceId dimension equals the given value if not null. To query for the null value, use {in: {serviceId: [null]}} instead. */ + serviceId: Maybe; +}; + +/** Filter for data in OperationCheckStats. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ +export type OperationCheckStatsFilterIn = { + /** Selects rows whose clientName dimension is in the given list. A null value in the list means a row with null for that dimension. */ + clientName: Maybe>>; + /** Selects rows whose clientVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ + clientVersion: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; + /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + queryId: Maybe>>; + /** Selects rows whose queryName dimension is in the given list. A null value in the list means a row with null for that dimension. */ + queryName: Maybe>>; + /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ + schemaTag: Maybe>>; + /** Selects rows whose serviceId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + serviceId: Maybe>>; +}; + +export type OperationCheckStatsMetrics = { + __typename?: 'OperationCheckStatsMetrics'; + cachedRequestsCount: Scalars['Long']; + uncachedRequestsCount: Scalars['Long']; +}; + +export type OperationCheckStatsOrderBySpec = { + column: OperationCheckStatsColumn; + direction: Ordering; +}; + +export type OperationCheckStatsRecord = { + __typename?: 'OperationCheckStatsRecord'; + /** Dimensions of OperationCheckStats that can be grouped by. */ + groupBy: OperationCheckStatsDimensions; + /** Metrics of OperationCheckStats that can be aggregated over. */ + metrics: OperationCheckStatsMetrics; + /** Starting segment timestamp. */ + timestamp: Scalars['Timestamp']; +}; + +/** A list of saved GraphQL operations. */ +export type OperationCollection = { + __typename?: 'OperationCollection'; + /** The timestamp when the collection was created. */ + createdAt: Scalars['Timestamp']; + /** The user or other entity that created the collection. */ + createdBy: Maybe; + /** The collection's description. A `null` description was never set, and empty string description was set to be empty string by a user, or other entity. */ + description: Maybe; + /** + * If a user has any of these roles, they will be able to edit this + * collection. + * @deprecated deprecated in favour of minEditRole + */ + editRoles: Maybe>; + id: Scalars['ID']; + /** Whether the current user has marked the collection as a favorite. */ + isFavorite: Scalars['Boolean']; + /** Whether the collection is a [sandbox collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/#sandbox-collections). */ + isSandbox: Scalars['Boolean']; + /** Whether the collection is shared across its associated organization. */ + isShared: Scalars['Boolean']; + /** The timestamp when the collection was most recently updated. */ + lastUpdatedAt: Scalars['Timestamp']; + /** The user or other entity that most recently updated the collection. */ + lastUpdatedBy: Maybe; + /** The minimum role a user needs to edit this collection. Valid values: null, CONSUMER, OBSERVER, DOCUMENTER, CONTRIBUTOR, GRAPH_ADMIN. This value is always `null` if `isShared` is `false`. If `null` when `isShared` is `true`, the minimum role is `GRAPH_ADMIN`. */ + minEditRole: Maybe; + /** The collection's name. */ + name: Scalars['String']; + /** Returns the operation in the collection with the specified ID, if any. */ + operation: Maybe; + /** A list of the GraphQL operations that belong to the collection. */ + operations: Array; + /** The permissions that the current user has for the collection. */ + permissions: OperationCollectionPermissions; + variants: Array; +}; + + +/** A list of saved GraphQL operations. */ +export type OperationCollectionOperationArgs = { + id: Scalars['ID']; +}; + +/** A saved operation entry within an Operation Collection. */ +export type OperationCollectionEntry = { + __typename?: 'OperationCollectionEntry'; + collection: OperationCollection; + /** The timestamp when the entry was created. */ + createdAt: Scalars['Timestamp']; + /** The user or other entity that created the entry. */ + createdBy: Maybe; + /** Details of the entry's associated operation, such as its `body` and `variables`. */ + currentOperationRevision: OperationCollectionEntryState; + id: Scalars['ID']; + /** The timestamp when the entry was most recently updated. */ + lastUpdatedAt: Scalars['Timestamp']; + /** The user or other entity that most recently updated the entry. */ + lastUpdatedBy: Maybe; + /** The entry's name. */ + name: Scalars['String']; + /** The entry's lexicographical ordering index within its containing collection. */ + orderingIndex: Scalars['String']; +}; + +/** Provides fields for modifying an operation in a collection. */ +export type OperationCollectionEntryMutation = { + __typename?: 'OperationCollectionEntryMutation'; + moveToCollection: MoveOperationCollectionEntryResult; + reorderEntry: Maybe; + /** Updates the name of an operation. */ + updateName: Maybe; + /** Updates the body, headers, and/or variables of an operation. */ + updateValues: Maybe; +}; + + +/** Provides fields for modifying an operation in a collection. */ +export type OperationCollectionEntryMutationMoveToCollectionArgs = { + collectionId: Scalars['ID']; + lowerOrderingBound: Maybe; + upperOrderingBound: Maybe; +}; + + +/** Provides fields for modifying an operation in a collection. */ +export type OperationCollectionEntryMutationReorderEntryArgs = { + lowerOrderingBound: Maybe; + upperOrderingBound: Maybe; +}; + + +/** Provides fields for modifying an operation in a collection. */ +export type OperationCollectionEntryMutationUpdateNameArgs = { + name: Scalars['String']; +}; + + +/** Provides fields for modifying an operation in a collection. */ +export type OperationCollectionEntryMutationUpdateValuesArgs = { + operationInput: OperationCollectionEntryStateInput; +}; + +export type OperationCollectionEntryMutationResult = NotFoundError | OperationCollectionEntryMutation | PermissionError; + +/** Possible return values when querying for an entry in an operation collection (either the entry object or an `Error` object). */ +export type OperationCollectionEntryResult = NotFoundError | OperationCollectionEntry; + +/** The most recent body, variable and header values of a saved operation entry. */ +export type OperationCollectionEntryState = { + __typename?: 'OperationCollectionEntryState'; + /** The raw body of the entry's GraphQL operation. */ + body: Scalars['String']; + /** The timestamp when the entry state was created. */ + createdAt: Scalars['Timestamp']; + /** The user or other entity that created this entry state. */ + createdBy: Maybe; + /** Headers for the entry's GraphQL operation. */ + headers: Maybe>; + /** The workflow automation script for this entry's GraphQL operation */ + script: Maybe; + /** Variables for the entry's GraphQL operation, as a JSON string. */ + variables: Maybe; +}; + +/** Fields for creating or modifying an operation collection entry. */ +export type OperationCollectionEntryStateInput = { + /** The operation's query body. */ + body: Scalars['String']; + /** The operation's headers. */ + headers: Maybe>; + /** The operation's workflow script */ + script: Maybe; + /** The operation's variables. */ + variables: Maybe; +}; + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutation = { + __typename?: 'OperationCollectionMutation'; + /** Adds an operation to this collection. */ + addOperation: Maybe; + /** Adds operations to this collection. */ + addOperations: Maybe; + /** @deprecated Will throw NotImplemented */ + addToVariant: AddOperationCollectionToVariantResult; + /** Deletes this operation collection. This also deletes all of the collection's associated operations. */ + delete: Maybe; + /** Deletes an operation from this collection. */ + deleteOperation: Maybe; + duplicateCollection: DuplicateOperationCollectionResult; + operation: Maybe; + /** @deprecated Will throw NotImplemented */ + removeFromVariant: RemoveOperationCollectionFromVariantResult; + /** Updates the minimum role a user needs to be able to modify this collection. */ + setMinEditRole: Maybe; + /** Updates this collection's description. */ + updateDescription: Maybe; + /** Updates whether the current user has marked this collection as a favorite. */ + updateIsFavorite: Maybe; + /** Updates whether this collection is shared across its associated organization. */ + updateIsShared: Maybe; + /** Updates this operation collection's name. */ + updateName: Maybe; +}; + + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutationAddOperationArgs = { + name: Scalars['String']; + operationInput: OperationCollectionEntryStateInput; +}; + + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutationAddOperationsArgs = { + operations: Array; +}; + + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutationAddToVariantArgs = { + variantRef: Scalars['ID']; +}; + + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutationDeleteOperationArgs = { + id: Scalars['ID']; +}; + + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutationDuplicateCollectionArgs = { description: Maybe; - isDeprecated: Scalars['Boolean']; + isSandbox: Scalars['Boolean']; + isShared: Scalars['Boolean']; name: Scalars['String']; + variantRef: Maybe; }; -/** __EnumValue introspection type */ -export type IntrospectionEnumValueInput = { - deprecationReason: Maybe; + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutationOperationArgs = { + id: Scalars['ID']; +}; + + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutationRemoveFromVariantArgs = { + variantRef: Scalars['ID']; +}; + + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutationSetMinEditRoleArgs = { + editRole: Maybe; +}; + + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutationUpdateDescriptionArgs = { description: Maybe; - isDeprecated: Scalars['Boolean']; +}; + + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutationUpdateIsFavoriteArgs = { + isFavorite: Scalars['Boolean']; +}; + + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutationUpdateIsSharedArgs = { + isShared: Scalars['Boolean']; +}; + + +/** Provides fields for modifying an [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/). */ +export type OperationCollectionMutationUpdateNameArgs = { name: Scalars['String']; }; -/** Values associated with introspection result for field */ -export type IntrospectionField = { - __typename?: 'IntrospectionField'; - args: Array; - deprecationReason: Maybe; - description: Maybe; - isDeprecated: Scalars['Boolean']; +/** Whether the current user can perform various actions on the associated collection. */ +export type OperationCollectionPermissions = { + __typename?: 'OperationCollectionPermissions'; + /** Whether the current user can edit operations in the associated collection. */ + canEditOperations: Scalars['Boolean']; + /** Whether the current user can delete or update the associated collection's metadata, such as its name and description. */ + canManage: Scalars['Boolean']; + /** Whether the current user can read operations in the associated collection. */ + canReadOperations: Scalars['Boolean']; +}; + +export type OperationCollectionResult = NotFoundError | OperationCollection | PermissionError | ValidationError; + +export type OperationDocument = { + __typename?: 'OperationDocument'; + /** Operation document body */ + body: Scalars['String']; + /** Operation name */ + name: Maybe; +}; + +export type OperationDocumentInput = { + /** Operation document body */ + body: Scalars['String']; + /** Operation name */ + name: Maybe; +}; + +/** Saved headers on a saved operation. */ +export type OperationHeader = { + __typename?: 'OperationHeader'; + /** The header's name. */ name: Scalars['String']; - type: IntrospectionType; + /** The header's value. */ + value: Scalars['String']; }; -/** __Field introspection type */ -export type IntrospectionFieldInput = { - args: Array; - deprecationReason: Maybe; - description: Maybe; - isDeprecated: Scalars['Boolean']; +export type OperationHeaderInput = { + /** The header's name. */ name: Scalars['String']; - type: IntrospectionTypeInput; + /** The header's value. */ + value: Scalars['String']; }; -/** Values associated with introspection result for an input field */ -export type IntrospectionInputValue = { - __typename?: 'IntrospectionInputValue'; - defaultValue: Maybe; - description: Maybe; +export type OperationInfoFilter = { + __typename?: 'OperationInfoFilter'; + id: Scalars['String']; +}; + +export type OperationInfoFilterInput = { + id: Scalars['String']; +}; + +export type OperationInsightsListFilterInInput = { + clientName: Maybe>>; + clientVersion: Maybe>>; +}; + +export type OperationInsightsListFilterInput = { + clientName: Maybe; + clientVersion: Maybe; + in: Maybe; + isUnnamed: Maybe; + isUnregistered: Maybe; + operationTypes: Maybe>; + or: Maybe>; + search: Maybe; +}; + +export type OperationInsightsListItem = { + __typename?: 'OperationInsightsListItem'; + cacheHitRate: Scalars['Float']; + cacheTtlP50Ms: Scalars['Float']; + /** A substring of the query signature for unnamed operations, otherwise the operation name. */ + displayName: Scalars['String']; + errorCount: Scalars['Long']; + errorCountPerMin: Scalars['Float']; + errorPercentage: Scalars['Float']; + /** The unique id for this operation. */ + id: Scalars['ID']; + /** The operation name or null if the operation is unnamed. */ + name: Maybe; + requestCount: Scalars['Long']; + requestCountPerMin: Scalars['Float']; + serviceTimeP50Ms: Scalars['Float']; + serviceTimeP90Ms: Scalars['Float']; + serviceTimeP95Ms: Scalars['Float']; + serviceTimeP99Ms: Scalars['Float']; + signatureBytes: Scalars['Long']; + totalDurationMs: Scalars['Float']; + type: Maybe; +}; + +export enum OperationInsightsListOrderByColumn { + CacheHitRate = 'CACHE_HIT_RATE', + CacheTtlP50 = 'CACHE_TTL_P50', + ErrorCount = 'ERROR_COUNT', + ErrorCountPerMin = 'ERROR_COUNT_PER_MIN', + ErrorPercentage = 'ERROR_PERCENTAGE', + OperationName = 'OPERATION_NAME', + RequestCount = 'REQUEST_COUNT', + RequestCountPerMin = 'REQUEST_COUNT_PER_MIN', + ServiceTimeP50 = 'SERVICE_TIME_P50', + ServiceTimeP90 = 'SERVICE_TIME_P90', + ServiceTimeP95 = 'SERVICE_TIME_P95', + ServiceTimeP99 = 'SERVICE_TIME_P99', + SignatureBytes = 'SIGNATURE_BYTES', + TotalDurationMs = 'TOTAL_DURATION_MS' +} + +export type OperationInsightsListOrderByInput = { + /** The order column used for the operation results. Defaults to ordering by operation names. */ + column: OperationInsightsListOrderByColumn; + /** The direction used to order operation results. Defaults to ascending order. */ + direction: Ordering; +}; + +/** Information about pagination in a connection. */ +export type OperationInsightsListPageInfo = { + __typename?: 'OperationInsightsListPageInfo'; + /** When paginating forwards, the cursor to continue. */ + endCursor: Maybe; + /** Not implemented. Always returns true */ + hasNextPage: Scalars['Boolean']; + /** Not implemented. Always returns true */ + hasPreviousPage: Scalars['Boolean']; + /** When paginating backwards, the cursor to continue. */ + startCursor: Maybe; +}; + +/** Operation name filter configuration for a graph. */ +export type OperationNameFilter = { + __typename?: 'OperationNameFilter'; + /** name of the operation by the user and reported alongside metrics */ name: Scalars['String']; - type: IntrospectionType; + version: Maybe; }; -/** __Value introspection type */ -export type IntrospectionInputValueInput = { - defaultValue: Maybe; - deprecationReason: Maybe; - description: Maybe; - isDeprecated: Maybe; +/** Options to filter by operation name. */ +export type OperationNameFilterInput = { + /** name of the operation set by the user and reported alongside metrics */ name: Scalars['String']; - type: IntrospectionTypeInput; + version: Maybe; }; -export type IntrospectionSchema = { - __typename?: 'IntrospectionSchema'; - directives: Array; - mutationType: Maybe; - queryType: IntrospectionType; - subscriptionType: Maybe; - types: Array; +export enum OperationType { + Mutation = 'MUTATION', + Query = 'QUERY', + Subscription = 'SUBSCRIPTION' +} + +export type OperationValidationError = { + __typename?: 'OperationValidationError'; + message: Scalars['String']; +}; + +export type OperationsCheckConfiguration = { + __typename?: 'OperationsCheckConfiguration'; + /** During the operations check, ignore clients matching any of the filters. */ + excludedClients: Array; + /** During the operations check, ignore operations matching any of the filters. */ + excludedOperationNames: Array; + /** During the operations check, ignore operations matching any of the filters. */ + excludedOperations: Array; + /** + * The start of the time range for the operations check, expressed as an offset from the time the + * check request was received (in seconds) or an ISO-8601 timestamp. This was either provided by the + * user or computed from variant- or graph-level settings. + * @deprecated Use fromNormalized instead + */ + from: Scalars['String']; + /** The start of the time range for the operations check. */ + fromNormalized: Scalars['Timestamp']; + /** + * During the operations check, fetch operations from the metrics data for + * variants. + */ + includedVariants: Array; + /** + * During the operations check, ignore operations that executed less than + * times in the time range. + */ + operationCountThreshold: Scalars['Int']; + /** + * Duration the operations check, ignore operations that constituted less than + * % of the operations in the time range. + */ + operationCountThresholdPercentage: Scalars['Float']; + /** + * The end of the time range for the operations check, expressed as an offset from the time the + * check request was received (in seconds) or an ISO-8601 timestamp. This was either provided by the + * user or computed from variant- or graph-level settings. + * @deprecated Use toNormalized instead + */ + to: Scalars['String']; + /** The end of the time range for the operations check. */ + toNormalized: Scalars['Timestamp']; }; +export type OperationsCheckConfigurationOverridesInput = { + /** + * During the operations check, ignore clients matching any of the filters. + * Providing null will use variant- or graph-level settings instead. + */ + excludedClients: Maybe>; + /** + * During the operations check, ignore operations matching any of the + * filters. Providing null will use variant- or graph-level settings instead. + */ + excludedOperationNames: Maybe>; + /** + * During the operations check, ignore operations matching any of the filters. + * Providing null will use variant- or graph-level settings instead. + */ + excludedOperations: Maybe>; + /** + * The start of the time range for the operations check, expressed as an offset from the time the + * check request is received (in seconds) or an ISO-8601 timestamp. Providing null here and + * useMaxRetention as false will use variant- or graph-level settings instead. It is an error to + * provide a non-null value here and useMaxRetention as true. + */ + from: Maybe; + /** + * During the operations check, fetch operations from the metrics data for + * variants. Providing null will use variant- or graph-level settings instead. + */ + includedVariants: Maybe>; + /** + * During the operations check, ignore operations that executed less than + * times in the time range. Providing null will use variant- or graph-level settings instead. + */ + operationCountThreshold: Maybe; + /** + * During the operations check, ignore operations that executed less than + * times in the time range. Expected values are between 0% and 5%. Providing null will use variant- + * or graph-level settings instead. + */ + operationCountThresholdPercentage: Maybe; + /** + * The end of the time range for the operations check, expressed as an offset from the time the + * check request is received (in seconds) or an ISO-8601 timestamp. Providing null here and + * useMaxRetention as false will use variant- or graph-level settings instead. It is an error to + * provide a non-null value here and useMaxRetention as true. + */ + to: Maybe; + /** + * During the operations check, use the maximum time range allowed by the graph's plan's retention. + * Providing false here and from/to as null will use variant- or graph-level settings instead. It is + * an error to provide true here and from/to as non-null. + */ + useMaxRetention: Scalars['Boolean']; +}; -export type IntrospectionSchemaTypesArgs = { - filter?: Maybe; +export type OperationsCheckResult = { + __typename?: 'OperationsCheckResult'; + /** Operations affected by all changes in diff */ + affectedQueries: Maybe>; + /** Summary/counts for all changes in diff */ + changeSummary: ChangeSummary; + /** List of schema changes with associated affected clients and operations */ + changes: Array; + /** Indication of the success of the change, either failure, warning, or notice. */ + checkSeverity: ChangeSeverity; + /** The variant that was used as a base to check against */ + checkedVariant: GraphVariant; + createdAt: Scalars['Timestamp']; + /** The threshold that was crossed; null if the threshold was not exceeded */ + crossedOperationThreshold: Maybe; + id: Scalars['ID']; + /** Number of affected query operations that are neither marked as SAFE or IGNORED */ + numberOfAffectedOperations: Scalars['Int']; + /** Number of operations that were validated during schema diff */ + numberOfCheckedOperations: Scalars['Int']; + workflowTask: OperationsCheckTask; }; -/** __Schema introspection type */ -export type IntrospectionSchemaInput = { - description: Maybe; - directives: Array; - mutationType: Maybe; - queryType: IntrospectionTypeRefInput; - subscriptionType: Maybe; - types: Maybe>; +export type OperationsCheckTask = CheckWorkflowTask & { + __typename?: 'OperationsCheckTask'; + completedAt: Maybe; + createdAt: Scalars['Timestamp']; + graphID: Scalars['ID']; + id: Scalars['ID']; + /** + * The result of the operations check. This will be null when the task is initializing or running, + * or when the build task fails (which is a prerequisite task to this one). + */ + result: Maybe; + status: CheckWorkflowTaskStatus; + targetURL: Maybe; + workflow: CheckWorkflow; }; -/** Object containing all possible values for an introspectionType */ -export type IntrospectionType = { - __typename?: 'IntrospectionType'; - /** the base kind of the type this references, ignoring lists and nullability */ - baseKind: Maybe; - description: Maybe; - enumValues: Maybe>; - fields: Maybe>; - inputFields: Maybe>; - interfaces: Maybe>; - kind: Maybe; - name: Maybe; - ofType: Maybe; - possibleTypes: Maybe>; - /** printed representation of type, including nested nullability and list ofTypes */ - printed: Scalars['String']; +/** Cloud Router order */ +export type Order = { + __typename?: 'Order'; + /** + * Completion percentage of the order (between 0 and 100) + * + * This will only return data for IN_PROGRESS, COMPLETED, or SUPERSEDED states + */ + completionPercentage: Maybe; + /** When this Order was created */ + createdAt: Scalars['NaiveDateTime']; + /** Order identifier */ + id: Scalars['ID']; + /** Introspect why call to `ready` failed */ + introspectReady: Scalars['String']; + logs: Array; + /** Order type */ + orderType: OrderType; + /** Checks if machines are ready to serve requests */ + ready: Scalars['Boolean']; + /** Checks if we can serve requests through the external endpoint */ + readyExternal: Scalars['Boolean']; + /** Reason for ERRORED or ROLLING_BACK orders */ + reason: Maybe; + /** Router associated with this Order */ + router: Router; + /** Checks if the service is updated */ + serviceReady: Scalars['Boolean']; + /** Shard associated with this Order */ + shard: Shard; + /** Order status */ + status: OrderStatus; + /** Last time this Order was updated */ + updatedAt: Maybe; +}; + +/** The order does not exist */ +export type OrderDoesNotExistError = { + __typename?: 'OrderDoesNotExistError'; + tryAgainSeconds: Scalars['Int']; +}; + +/** Catch-all failure result of a failed order mutation. */ +export type OrderError = { + __typename?: 'OrderError'; + /** Error message */ + message: Scalars['String']; }; +export type OrderMutation = { + __typename?: 'OrderMutation'; + /** Create an ALB rule */ + createAlbRule: OrderResult; + /** Create a new app */ + createApp: OrderResult; + /** Create CNAME record */ + createCname: OrderResult; + /** Create an IAM Role */ + createIamRole: OrderResult; + /** Create machines */ + createMachines: OrderResult; + /** Create a security group */ + createSecurityGroup: OrderResult; + /** Create an ECS service */ + createService: OrderResult; + /** Create a target group */ + createTargetGroup: OrderResult; + /** Create a task definition */ + createTaskDefinition: OrderResult; + /** Delete an ALB rule */ + deleteAlbRule: OrderResult; + /** Delete API key */ + deleteApiKey: OrderResult; + /** Delete application */ + deleteApp: OrderResult; + /** Delete CNAME */ + deleteCname: OrderResult; + /** Delete an IAM Role */ + deleteIamRole: OrderResult; + /** Delete machines */ + deleteMachines: OrderResult; + /** Delete a security group */ + deleteSecurityGroup: OrderResult; + /** Delete an ECS service */ + deleteService: OrderResult; + /** Delete a target group */ + deleteTargetGroup: OrderResult; + /** Delete a task definition */ + deleteTaskDefinition: OrderResult; + /** Force rollback of the order */ + forceRollback: OrderResult; + /** Rollback an ALB rule */ + rollbackAlbRule: OrderResult; + /** Rollback application */ + rollbackApp: OrderResult; + /** Rollback CNAME record */ + rollbackCname: OrderResult; + /** Rollback etcd data */ + rollbackEtcd: OrderResult; + /** Rollback an IAM Role */ + rollbackIamRole: OrderResult; + /** Rollback router information */ + rollbackInfo: OrderResult; + /** Rollback machines */ + rollbackMachines: OrderResult; + /** Rollback router information */ + rollbackSecrets: OrderResult; + /** Rollback a security group */ + rollbackSecurityGroup: OrderResult; + /** Rollback an ECS service */ + rollbackService: OrderResult; + /** Rollback a target group */ + rollbackTargetGroup: OrderResult; + /** Rollback a task definition */ + rollbackTaskDefinition: OrderResult; + /** Set default environment variables */ + setDefaultVars: OrderResult; + /** Update Etcd cluster */ + updateEtcd: OrderResult; + /** Update an IAM Role */ + updateIamRole: OrderResult; + /** Update router information */ + updateInfo: OrderResult; + /** Update a Service */ + updateService: OrderResult; + /** Update order status */ + updateStatus: OrderResult; + /** Update order status with a reason and cause */ + updateStatusWithReason: OrderResult; + /** Update a task definition */ + updateTaskDefinition: OrderResult; +}; + + +export type OrderMutationUpdateStatusArgs = { + status: OrderStatus; +}; + + +export type OrderMutationUpdateStatusWithReasonArgs = { + cause: ReasonCause; + reason: Scalars['String']; + status: OrderStatus; +}; + +/** Return an Order or an error */ +export type OrderOrError = Order | OrderDoesNotExistError; + +/** Represents the possible outcomes of an order mutation */ +export type OrderResult = InvalidInputErrors | Order | OrderError; + +/** Represents the different status for an order */ +export enum OrderStatus { + /** Order was successfully completed */ + Completed = 'COMPLETED', + /** Order was unsuccessful */ + Errored = 'ERRORED', + /** New Order in progress */ + Pending = 'PENDING', + /** + * Order is currently rolling back + * + * All resources created as part of this Order are being deleted + */ + RollingBack = 'ROLLING_BACK', + /** + * Order has been superseded by another, more recent order + * + * This can happen if two update orders arrive in close succession and we already + * started to process the newer order first. + */ + Superseded = 'SUPERSEDED' +} + +/** Represents the different types of order */ +export enum OrderType { + /** Create a new Cloud Router */ + CreateRouter = 'CREATE_ROUTER', + /** Destroy an existing Cloud Router */ + DestroyRouter = 'DESTROY_ROUTER', + /** Update an existing Cloud Router */ + UpdateRouter = 'UPDATE_ROUTER' +} -/** Object containing all possible values for an introspectionType */ -export type IntrospectionTypeEnumValuesArgs = { - includeDeprecated?: Maybe; +export enum Ordering { + Ascending = 'ASCENDING', + Descending = 'DESCENDING' +} + +export type OrgCustomerTraits = { + __typename?: 'OrgCustomerTraits'; + healthScore: Maybe; + nextRenewalDate: Maybe; + tier: Maybe; + usersCount: Maybe; }; -/** __Type introspection type */ -export type IntrospectionTypeInput = { - description: Maybe; - enumValues: Maybe>; - fields: Maybe>; - inputFields: Maybe>; - interfaces: Maybe>; - kind: IntrospectionTypeKind; - name: Maybe; - ofType: Maybe; - possibleTypes: Maybe>; - specifiedByUrl: Maybe; +/** A reusable invite link for an organization. */ +export type OrganizationInviteLink = { + __typename?: 'OrganizationInviteLink'; + createdAt: Scalars['Timestamp']; + /** A joinToken that can be passed to Mutation.joinAccount to join the organization. */ + joinToken: Scalars['String']; + /** The role that the user will receive if they join the organization with this link. */ + role: UserPermission; }; -export enum IntrospectionTypeKind { - /** Indicates this type is an enum. 'enumValues' is a valid field. */ - Enum = 'ENUM', - /** Indicates this type is an input object. 'inputFields' is a valid field. */ - InputObject = 'INPUT_OBJECT', - /** - * Indicates this type is an interface. 'fields' and 'possibleTypes' are valid - * fields - */ - Interface = 'INTERFACE', - /** Indicates this type is a list. 'ofType' is a valid field. */ - List = 'LIST', - /** Indicates this type is a non-null. 'ofType' is a valid field. */ - NonNull = 'NON_NULL', - /** Indicates this type is an object. 'fields' and 'interfaces' are valid fields. */ - Object = 'OBJECT', - /** Indicates this type is a scalar. */ - Scalar = 'SCALAR', - /** Indicates this type is a union. 'possibleTypes' is a valid field. */ - Union = 'UNION' +export type OrganizationSso = { + __typename?: 'OrganizationSSO'; + defaultRole: UserPermission; + idpid: Scalars['ID']; + provider: OrganizationSsoProvider; +}; + +export enum OrganizationSsoProvider { + Pingone = 'PINGONE' } -/** Shallow __Type introspection type */ -export type IntrospectionTypeRefInput = { - kind: Maybe; +/** Information about pagination in a connection. */ +export type PageInfo = { + __typename?: 'PageInfo'; + /** When paginating forwards, the cursor to continue. */ + endCursor: Maybe; + /** When paginating forwards, are there more items? */ + hasNextPage: Scalars['Boolean']; + /** When paginating backwards, are there more items? */ + hasPreviousPage: Scalars['Boolean']; + /** When paginating backwards, the cursor to continue. */ + startCursor: Maybe; +}; + +/** PagerDuty notification channel */ +export type PagerDutyChannel = Channel & { + __typename?: 'PagerDutyChannel'; + id: Scalars['ID']; name: Scalars['String']; + routingKey: Scalars['String']; + subscriptions: Array; }; -export type InvalidOperation = { - __typename?: 'InvalidOperation'; - errors: Maybe>; - signature: Scalars['ID']; +/** PagerDuty notification channel parameters */ +export type PagerDutyChannelInput = { + name: Maybe; + routingKey: Scalars['String']; }; -export type InvalidRefFormat = Error & { - __typename?: 'InvalidRefFormat'; +export type ParentChangeProposalComment = ChangeProposalComment & ProposalComment & { + __typename?: 'ParentChangeProposalComment'; + createdAt: Scalars['Timestamp']; + /** null if the user is deleted */ + createdBy: Maybe; + id: Scalars['ID']; + message: Scalars['String']; + /** true if the schemaCoordinate this comment is on doesn't exist in the diff between the most recent revision & the base sdl */ + outdated: Scalars['Boolean']; + replies: Array; + replyCount: Scalars['Int']; + schemaCoordinate: Scalars['String']; + /** '#@!api!@#' for api schema, '#@!supergraph!@#' for supergraph schema, subgraph otherwise */ + schemaScope: Scalars['String']; + status: CommentStatus; + /** null if never updated */ + updatedAt: Maybe; +}; + +export type ParentGeneralProposalComment = GeneralProposalComment & ProposalComment & { + __typename?: 'ParentGeneralProposalComment'; + createdAt: Scalars['Timestamp']; + /** null if the user is deleted */ + createdBy: Maybe; + id: Scalars['ID']; message: Scalars['String']; + replies: Array; + replyCount: Scalars['Int']; + status: CommentStatus; + /** null if never updated */ + updatedAt: Maybe; }; -export type Invoice = { - __typename?: 'Invoice'; - closedAt: Maybe; - collectionMethod: Maybe; +export type ParentProposalComment = ParentChangeProposalComment | ParentGeneralProposalComment; + +/** The schema for a single published subgraph in Studio. */ +export type PartialSchema = { + __typename?: 'PartialSchema'; + /** Timestamp for when the partial schema was created */ createdAt: Scalars['Timestamp']; - invoiceNumber: Scalars['Int']; - state: InvoiceState; - totalInCents: Scalars['Int']; - updatedAt: Scalars['Timestamp']; - uuid: Scalars['ID']; + /** If this sdl is currently actively composed in the gateway, this is true */ + isLive: Scalars['Boolean']; + /** The subgraph schema document as SDL. */ + sdl: Scalars['String']; }; -export enum InvoiceState { - Collected = 'COLLECTED', - Failed = 'FAILED', - Open = 'OPEN', - PastDue = 'PAST_DUE', - Unknown = 'UNKNOWN' -} +/** + * Input for registering a partial schema to an implementing service. + * One of the fields must be specified (validated server-side). + * + * If a new partialSchemaSDL is passed in, this operation will store it before + * creating the association. + * + * If both the sdl and hash are specified, an error will be thrown if the provided + * hash doesn't match our hash of the sdl contents. If the sdl field is specified, + * the hash does not need to be and will be computed server-side. + */ +export type PartialSchemaInput = { + /** + * Hash of the partial schema to associate; error is thrown if only the hash is + * specified and the hash has not been seen before + */ + hash: Maybe; + /** + * Contents of the partial schema in SDL syntax, but may reference types + * that aren't defined in this document + */ + sdl: Maybe; +}; -export type Launch = { - __typename?: 'Launch'; - approvedAt: Maybe; - build: Maybe; - buildInput: BuildInput; - completedAt: Maybe; - createdAt: Scalars['Timestamp']; - downstreamLaunches: Maybe>; - id: Scalars['ID']; - isAvailable: Maybe; - isCompleted: Maybe; - isPublished: Maybe; - isTarget: Maybe; - latestSequenceStep: Maybe; - results: Array; - schemaTag: Maybe; - sequence: Array; - shortenedID: Scalars['String']; - status: LaunchStatus; - subgraphChanges: Maybe>; - supersededAt: Maybe; - supersededBy: Maybe; +export type Permission = { + __typename?: 'Permission'; + csAdmin: Maybe; + sudo: Scalars['Boolean']; }; -/** more result types will be supported in the future */ -export type LaunchResult = ChangelogLaunchResult; +/** An error that's returned when the current user doesn't have sufficient permissions to perform an action. */ +export type PermissionError = Error & { + __typename?: 'PermissionError'; + /** The error message. */ + message: Scalars['String']; +}; -export type LaunchSequenceBuildStep = { - __typename?: 'LaunchSequenceBuildStep'; - completedAt: Maybe; - startedAt: Maybe; +/** Information about the act of publishing operations to the list */ +export type PersistedQueriesPublish = { + __typename?: 'PersistedQueriesPublish'; + operationCounts: PersistedQueriesPublishOperationCounts; + publishedAt: Scalars['Timestamp']; }; -export type LaunchSequenceCheckStep = { - __typename?: 'LaunchSequenceCheckStep'; - completedAt: Maybe; - startedAt: Maybe; +export type PersistedQueriesPublishOperationCounts = { + __typename?: 'PersistedQueriesPublishOperationCounts'; + /** The number of new operations added to the list by this publish. */ + added: Scalars['Int']; + /** The number of operations included in this publish whose metadata and body were unchanged from the previous list revision. */ + identical: Scalars['Int']; + /** The number of operations removed from the list by this publish. */ + removed: Scalars['Int']; + /** The number of operations in this list that were not mentioned by this publish. */ + unaffected: Scalars['Int']; + /** The number of operations whose metadata or body were changed by this publish. */ + updated: Scalars['Int']; +}; + +export type PersistedQuery = { + __typename?: 'PersistedQuery'; + body: Scalars['GraphQLDocument']; + firstPublishedAt: Scalars['Timestamp']; + id: Scalars['ID']; + lastPublishedAt: Scalars['Timestamp']; + name: Scalars['String']; + type: OperationType; }; -export type LaunchSequenceCompletedStep = { - __typename?: 'LaunchSequenceCompletedStep'; - completedAt: Maybe; +export type PersistedQueryConnection = { + __typename?: 'PersistedQueryConnection'; + edges: Array; + pageInfo: PageInfo; }; -export type LaunchSequenceInitiatedStep = { - __typename?: 'LaunchSequenceInitiatedStep'; - startedAt: Maybe; +export type PersistedQueryEdge = { + __typename?: 'PersistedQueryEdge'; + cursor: Scalars['String']; + node: PersistedQuery; }; -export type LaunchSequencePublishStep = { - __typename?: 'LaunchSequencePublishStep'; - completedAt: Maybe; - startedAt: Maybe; +/** Operations to be published to the Persisted Query List. */ +export type PersistedQueryInput = { + /** The GraphQL document for this operation, including all necessary fragment definitions. */ + body: Scalars['GraphQLDocument']; + /** An opaque identifier for this operation. This should map uniquely to an operation body; editing the body should generally result in a new ID. Apollo's tools generally use the lowercase hex SHA256 of the operation body. */ + id: Scalars['ID']; + /** A name for the operation. Typically this is the name of the actual GraphQL operation in the body. This does not need to be unique within a Persisted Query List; as a client project evolves and its operations change, multiple operations with the same name (but different body and id) can be published. */ + name: Scalars['String']; + /** The operation's type. */ + type: OperationType; +}; + +/** TODO */ +export type PersistedQueryList = { + __typename?: 'PersistedQueryList'; + builds: PersistedQueryListBuildConnection; + createdAt: Scalars['Timestamp']; + createdBy: Maybe; + currentBuild: PersistedQueryListBuild; + description: Scalars['String']; + graph: Service; + /** The immutable ID for this Persisted Query List. */ + id: Scalars['ID']; + lastUpdatedAt: Scalars['Timestamp']; + /** All variants linked to this Persisted Query List, if any. */ + linkedVariants: Array; + /** The list's name; can be changed and does not need to be unique. */ + name: Scalars['String']; + operation: Maybe; + operations: PersistedQueryConnection; }; -export type LaunchSequenceStep = LaunchSequenceBuildStep | LaunchSequenceCheckStep | LaunchSequenceCompletedStep | LaunchSequenceInitiatedStep | LaunchSequencePublishStep | LaunchSequenceSupersededStep; -export type LaunchSequenceSupersededStep = { - __typename?: 'LaunchSequenceSupersededStep'; - completedAt: Maybe; +/** TODO */ +export type PersistedQueryListBuildsArgs = { + after: Maybe; + before: Maybe; + first: Maybe; + last: Maybe; }; -export enum LaunchStatus { - LaunchCompleted = 'LAUNCH_COMPLETED', - LaunchFailed = 'LAUNCH_FAILED', - LaunchInitiated = 'LAUNCH_INITIATED' -} -export type LinkInfo = { - __typename?: 'LinkInfo'; - createdAt: Scalars['Timestamp']; +/** TODO */ +export type PersistedQueryListOperationArgs = { id: Scalars['ID']; - title: Maybe; - type: LinkInfoType; - url: Scalars['String']; }; -export enum LinkInfoType { - DeveloperPortal = 'DEVELOPER_PORTAL', - Other = 'OTHER', - Repository = 'REPOSITORY' -} -export type MarkChangesForOperationAsSafeResult = { - __typename?: 'MarkChangesForOperationAsSafeResult'; - /** - * Nice to have for the frontend since the Apollo cache is already watching for AffectedQuery to update. - * This might return null if no behavior changes were found for the affected operation ID. - * This is a weird situation that should never happen. - */ - affectedOperation: Maybe; - message: Scalars['String']; - success: Scalars['Boolean']; +/** TODO */ +export type PersistedQueryListOperationsArgs = { + after: Maybe; + before: Maybe; + first: Maybe; + last: Maybe; }; -export type MediaUploadInfo = { - __typename?: 'MediaUploadInfo'; - csrfToken: Scalars['String']; - maxContentLength: Scalars['Int']; - url: Scalars['String']; +/** Information about a particular revision of the list, as produced by a particular publish. */ +export type PersistedQueryListBuild = { + __typename?: 'PersistedQueryListBuild'; + /** A unique ID for this build revision; primarily useful as a client cache ID. */ + id: Scalars['String']; + /** The persisted query list that this build built. */ + list: PersistedQueryList; + /** The chunks that made up this build. We do not commit to keeping the full contents of older revisions indefinitely, so this may be null for suitably old revisions. */ + manifestChunks: Maybe>; + /** Information about the publish operation that created this build. */ + publish: PersistedQueriesPublish; + /** The revision of this Persisted Query List. Revision 0 is the initial empty list; each publish increments the revision by 1. */ + revision: Scalars['Int']; + /** The total number of operations in the list after this build. Compare to PersistedQueriesPublish.operationCounts. */ + totalOperationsInList: Scalars['Int']; }; -export type Mutation = { - __typename?: 'Mutation'; - account: Maybe; - /** - * Finalize a password reset with a token included in the E-mail link, - * returns the corresponding login email when successful - */ - finalizePasswordReset: Maybe; - /** Join an account with a token */ - joinAccount: Maybe; - me: Maybe; - newAccount: Maybe; - newService: Maybe; - /** Refresh all plans from third-party billing service */ - plansRefreshBilling: Maybe; - /** Report a running GraphQL server's schema. */ - reportSchema: Maybe; - /** Ask for a user's password to be reset by E-mail */ - resetPassword: Maybe; - resolveAllInternalCronExecutions: Maybe; - resolveInternalCronExecution: Maybe; - service: Maybe; - /** Set the subscriptions for a given email */ - setSubscriptions: Maybe; - /** Set the studio settings for the current user */ - setUserSettings: Maybe; - signUp: Maybe; - /** This is called by the form shown to users after they delete their user or organization account. */ - submitPostDeletionFeedback: Maybe; - /** Mutation for basic engagement tracking in studio */ - track: Maybe; - /** Unsubscribe a given email from all emails */ - unsubscribeFromAll: Maybe; - user: Maybe; +export type PersistedQueryListBuildConnection = { + __typename?: 'PersistedQueryListBuildConnection'; + edges: Array; + pageInfo: PageInfo; }; +export type PersistedQueryListBuildEdge = { + __typename?: 'PersistedQueryListBuildEdge'; + cursor: Scalars['String']; + node: PersistedQueryListBuild; +}; -export type MutationAccountArgs = { +export type PersistedQueryListManifestChunk = { + __typename?: 'PersistedQueryListManifestChunk'; id: Scalars['ID']; + json: Scalars['String']; + list: PersistedQueryList; }; - -export type MutationFinalizePasswordResetArgs = { - newPassword: Scalars['String']; - resetToken: Scalars['String']; +export type PersistedQueryListMutation = { + __typename?: 'PersistedQueryListMutation'; + delete: DeletePersistedQueryListResultOrError; + id: Scalars['ID']; + /** Updates this Persisted Query List by publishing a set of operations and removing other operations. Operations not mentioned remain in the list unchanged. */ + publishOperations: PublishOperationsResultOrError; + updateMetadata: UpdatePersistedQueryListMetadataResultOrError; }; -export type MutationJoinAccountArgs = { - accountId: Scalars['ID']; - joinToken: Scalars['String']; +export type PersistedQueryListMutationPublishOperationsArgs = { + allowOverwrittenOperations: Maybe; + operations: Maybe>; + removeOperations: Maybe>; }; -export type MutationNewAccountArgs = { - companyUrl: Maybe; - id: Scalars['ID']; +export type PersistedQueryListMutationUpdateMetadataArgs = { + description: Maybe; + name: Maybe; }; +/** An error related to an organization's Apollo Studio plan. */ +export type PlanError = { + __typename?: 'PlanError'; + /** The error message. */ + message: Scalars['String']; +}; -export type MutationNewServiceArgs = { - accountId: Scalars['ID']; - description: Maybe; - hiddenFromUninvitedNonAdminAccountMembers?: Scalars['Boolean']; - id: Scalars['ID']; - isDev?: Scalars['Boolean']; +/** GraphQL representation of an AWS private subgraph */ +export type PrivateSubgraph = { + __typename?: 'PrivateSubgraph'; + /** The cloud provider where the subgraph is hosted */ + cloudProvider: CloudProvider; + /** The domain URL of the private subgraph */ + domainUrl: Scalars['String']; + /** The name of the subgraph, if set */ name: Maybe; - title: Maybe; + /** The private subgraph's region */ + region: RegionDescription; + /** The status of the resource share */ + status: PrivateSubgraphShareStatus; +}; + +export type PrivateSubgraphMutation = { + __typename?: 'PrivateSubgraphMutation'; + /** Synchronize private subgraphs to your Apollo account */ + sync: Array; }; -export type MutationReportSchemaArgs = { - coreSchema: Maybe; - report: SchemaReport; +export type PrivateSubgraphMutationSyncArgs = { + input: SyncPrivateSubgraphsInput; }; +/** The status of an association between a private subgraph and your Apollo account */ +export enum PrivateSubgraphShareStatus { + /** The private subgraph is connected to the Apollo service network */ + Connected = 'CONNECTED', + /** The private subgraph is disconnected to the Apollo service network */ + Disconnected = 'DISCONNECTED', + /** The private subgraph's connection to the Apollo service network has errored */ + Errored = 'ERRORED', + /** The current state of the association is unknown */ + Unknown = 'UNKNOWN' +} -export type MutationResetPasswordArgs = { - email: Scalars['String']; +export type PromoteSchemaError = { + __typename?: 'PromoteSchemaError'; + code: PromoteSchemaErrorCode; + message: Scalars['String']; }; +export enum PromoteSchemaErrorCode { + CannotPromoteSchemaForFederatedGraph = 'CANNOT_PROMOTE_SCHEMA_FOR_FEDERATED_GRAPH' +} -export type MutationResolveAllInternalCronExecutionsArgs = { - group: Maybe; - name: Maybe; +export type PromoteSchemaResponse = { + __typename?: 'PromoteSchemaResponse'; + code: PromoteSchemaResponseCode; + tag: SchemaTag; }; +export enum PromoteSchemaResponseCode { + NoChangesDetected = 'NO_CHANGES_DETECTED', + PromotionSuccess = 'PROMOTION_SUCCESS' +} + +export type PromoteSchemaResponseOrError = PromoteSchemaError | PromoteSchemaResponse; -export type MutationResolveInternalCronExecutionArgs = { +export type Proposal = { + __typename?: 'Proposal'; + activities: ProposalActivityConnection; + /** The variant this Proposal is under the hood. */ + backingVariant: GraphVariant; + comment: Maybe; + createdAt: Scalars['Timestamp']; + /** + * null if user is deleted, or if user removed from org + * and others in the org no longer have access to this user's info + */ + createdBy: Maybe; + displayName: Scalars['String']; id: Scalars['ID']; + /** True if only some of the changes in this proposal are currently published to the implementation variant */ + isPartiallyImplemented: Scalars['Boolean']; + latestRevision: ProposalRevision; + parentComments: Array; + rebaseConflicts: Maybe; + /** null if user deleted or removed from org */ + requestedReviewers: Array>; + reviews: Array; + /** This resolver only returns revisions with checks associated with them. For all revisions, use launchHistory. */ + revisionsWithChecks: ProposalRevisionsWithChecksResult; + /** The variant this Proposal was cloned/sourced from. */ + sourceVariant: GraphVariant; + status: ProposalStatus; + updatedAt: Scalars['Timestamp']; + updatedBy: Maybe; }; -export type MutationServiceArgs = { - id: Scalars['ID']; +export type ProposalActivitiesArgs = { + after: Maybe; + before: Maybe; + first: Maybe; + last: Maybe; }; -export type MutationSetSubscriptionsArgs = { - email: Scalars['String']; - subscriptions: Array; - token: Scalars['String']; +export type ProposalCommentArgs = { + id: Scalars['ID']; }; -export type MutationSetUserSettingsArgs = { - newSettings: Maybe; +export type ProposalParentCommentsArgs = { + filter: Maybe; }; -export type MutationSignUpArgs = { - email: Scalars['String']; - fullName: Scalars['String']; - password: Scalars['String']; - referrer: Maybe; - trackingGoogleClientId: Maybe; - trackingMarketoClientId: Maybe; - userSegment: Maybe; - utmCampaign: Maybe; - utmMedium: Maybe; - utmSource: Maybe; +export type ProposalRevisionsWithChecksArgs = { + filter: Maybe; + limit: Maybe; + offset: Maybe; }; +export type ProposalActivity = { + __typename?: 'ProposalActivity'; + activity: Maybe; + createdAt: Scalars['Timestamp']; + createdBy: Maybe; + id: Scalars['ID']; + target: Maybe; +}; + +export enum ProposalActivityAction { + /** When the system changes a Proposal's status back to OPEN from APPROVED when approvals drop below min approvals. */ + ApprovalWithdrawn = 'APPROVAL_WITHDRAWN', + /** When a user manually sets a Proposal to Close */ + CloseProposal = 'CLOSE_PROPOSAL', + /** When a Comment is added to a Proposal. */ + CommentAdded = 'COMMENT_ADDED', + /** When a subgraph in a Proposal is deleted. */ + DeleteSubgraph = 'DELETE_SUBGRAPH', + /** When a diff in a Proposal publish is found to already be in the Implementation target variant that fully implements the Proposal. Status of the Proposal will change to IMPLEMENTED. */ + FullyImplementedProposalOrigin = 'FULLY_IMPLEMENTED_PROPOSAL_ORIGIN', + /** When a diff in an Implementation variant publish is found in a Proposal that fully implements the Proposal. Status of the Proposal will change to IMPLEMENTED. */ + FullyImplementedVariantOrigin = 'FULLY_IMPLEMENTED_VARIANT_ORIGIN', + /** When the system changes a Proposal's status to APPROVED when the min approvals have been met. */ + MetMinApprovalsProposal = 'MET_MIN_APPROVALS_PROPOSAL', + /** When a user manually sets a Proposal to Open */ + OpenProposal = 'OPEN_PROPOSAL', + /** When a diff in a Proposal publish is found to already be in the Implementation target variant that partially implements the Proposal. Does not change the status of the Proposal, but isPartiallyImplemented will return true. */ + PartiallyImplementedProposalOrigin = 'PARTIALLY_IMPLEMENTED_PROPOSAL_ORIGIN', + /** When a diff in an Implementation variant publish is found in a Proposal that partially implements the Proposal. Does not change the status of the Proposal, but isPartiallyImplemented will return true. */ + PartiallyImplementedVariantOrigin = 'PARTIALLY_IMPLEMENTED_VARIANT_ORIGIN', + /** When a new revision is published to subgraphs in a Proposal. */ + PublishSubgraphs = 'PUBLISH_SUBGRAPHS', + /** When a Proposal is moved to DRAFT from another status not on creation. */ + ReturnToDraftProposal = 'RETURN_TO_DRAFT_PROPOSAL', + /** When a Review is added to a Proposal. */ + ReviewAdded = 'REVIEW_ADDED' +} -export type MutationSubmitPostDeletionFeedbackArgs = { - feedback: Scalars['String']; - targetIdentifier: Scalars['ID']; - targetType: DeletionTargetType; +export type ProposalActivityConnection = { + __typename?: 'ProposalActivityConnection'; + edges: Maybe>; + nodes: Array; + pageInfo: PageInfo; + totalCount: Scalars['Int']; }; - -export type MutationTrackArgs = { - event: EventEnum; - graphID: Scalars['String']; - graphVariant?: Scalars['String']; +export type ProposalActivityEdge = { + __typename?: 'ProposalActivityEdge'; + /** A cursor for use in pagination. */ + cursor: Scalars['String']; + node: Maybe; }; +export type ProposalActivityTarget = ParentChangeProposalComment | ParentGeneralProposalComment | Proposal | ProposalFullImplementationProposalOrigin | ProposalFullImplementationVariantOrigin | ProposalPartialImplementationProposalOrigin | ProposalPartialImplementationVariantOrigin | ProposalReview | ProposalRevision; -export type MutationUnsubscribeFromAllArgs = { - email: Scalars['String']; - token: Scalars['String']; +export enum ProposalChangeMismatchSeverity { + Error = 'ERROR', + Off = 'OFF', + Warn = 'WARN' +} + +export type ProposalComment = { + createdAt: Scalars['Timestamp']; + /** null if the user is deleted */ + createdBy: Maybe; + id: Scalars['ID']; + message: Scalars['String']; + status: CommentStatus; + /** null if never updated */ + updatedAt: Maybe; }; +export type ProposalCommentResult = NotFoundError | ParentChangeProposalComment | ParentGeneralProposalComment | ReplyChangeProposalComment | ReplyGeneralProposalComment; -export type MutationUserArgs = { +export enum ProposalCoverage { + Full = 'FULL', + None = 'NONE', + Partial = 'PARTIAL', + Pending = 'PENDING' +} + +export type ProposalFullImplementationProposalOrigin = ProposalImplementation & { + __typename?: 'ProposalFullImplementationProposalOrigin'; + /** the time this Proposal became implemented in the implementation target variant. */ + createdAt: Scalars['Timestamp']; id: Scalars['ID']; + /** the diff that was matched between the Proposal and the implementation target variant. TODO to deserialize this back into a DiffItem NEBULA-2726 */ + jsonDiff: Array; + /** Revision containing a diff that fully implements this Proposal in the implementation target variant. */ + revision: ProposalRevision; + /** the target variant this Proposal became implemented in. */ + variant: GraphVariant; }; -export type NamedIntrospectionArg = { - __typename?: 'NamedIntrospectionArg'; - description: Maybe; - name: Maybe; +export type ProposalFullImplementationVariantOrigin = ProposalImplementation & { + __typename?: 'ProposalFullImplementationVariantOrigin'; + /** the time this Proposal became implemented in the implementation target variant. */ + createdAt: Scalars['Timestamp']; + id: Scalars['ID']; + /** the diff that was matched between the Proposal and the implementation target variant. TODO to deserialize this back into a DiffItem NEBULA-2726 */ + jsonDiff: Array; + /** launch containing a diff that fully implements this Proposal in the implementation target variant. null if user does not have access to launches */ + launch: Maybe; + /** the target variant this Proposal became implemented in. */ + variant: GraphVariant; }; -export type NamedIntrospectionArgNoDescription = { - __typename?: 'NamedIntrospectionArgNoDescription'; - name: Maybe; +export type ProposalImplementation = { + /** the time this Proposal became implemented in the implementation target variant. */ + createdAt: Scalars['Timestamp']; + id: Scalars['ID']; + /** the diff that was matched between the Proposal and the implementation target variant */ + jsonDiff: Array; + /** the target variant this Proposal became implemented in. */ + variant: GraphVariant; }; -/** - * The shared fields for a named introspection type. Currently this is returned for the - * top level value affected by a change. In the future, we may update this - * type to be an interface, which is extended by the more specific types: - * scalar, object, input object, union, interface, and enum - * - * For an in-depth look at where these types come from, see: - * https://github.com/DefinitelyTyped/DefinitelyTyped/blob/659eb50d3/types/graphql/utilities/introspectionQuery.d.ts#L31-L37 - */ -export type NamedIntrospectionType = { - __typename?: 'NamedIntrospectionType'; - description: Maybe; - kind: Maybe; - name: Maybe; +export type ProposalMutation = { + __typename?: 'ProposalMutation'; + addComment: AddCommentResult; + deleteComment: DeleteCommentResult; + /** Delete a subgraph from this proposal. This will write the summary to proposals, record the most up to date diff, and call registry's removeImplementingServiceAndTriggerComposition. If composition is successful, this will update running routers. */ + deleteSubgraph: DeleteProposalSubgraphResult; + editComment: EditCommentResult; + proposal: Maybe; + /** Publish multiple subgraphs. This will write the summary to proposals, record the most up to date diff, and call registry's publishSubgraphs. If composition is successful, this will update running routers. A single launch will be created for this publish. */ + publishSubgraphs: PublishProposalSubgraphResult; + /** @deprecated use updateRequestedReviewers instead */ + setRequestedReviewers: SetRequestedReviewersResult; + updateDisplayName: UpdateProposalResult; + updateRequestedReviewers: UpdateRequestedReviewersResult; + updateStatus: UpdateProposalResult; + updateUpdatedByInfo: UpdateProposalResult; + upsertReview: UpsertReviewResult; }; -export type NamedIntrospectionTypeNoDescription = { - __typename?: 'NamedIntrospectionTypeNoDescription'; - name: Maybe; -}; -/** - * Introspection values that can be children of other types for changes, such - * as input fields, objects in interfaces, enum values. In the future, this - * value could become an interface to allow fields specific to the types - * returned. - */ -export type NamedIntrospectionValue = { - __typename?: 'NamedIntrospectionValue'; - description: Maybe; - name: Maybe; - printedType: Maybe; +export type ProposalMutationAddCommentArgs = { + input: AddCommentInput; }; -export type NamedIntrospectionValueNoDescription = { - __typename?: 'NamedIntrospectionValueNoDescription'; - name: Maybe; - printedType: Maybe; -}; -/** A non-federated service for a monolithic graph */ -export type NonFederatedImplementingService = { - __typename?: 'NonFederatedImplementingService'; - /** Timestamp of when this implementing service was created */ - createdAt: Scalars['Timestamp']; - /** - * Identifies which graph this non-implementing service belongs to. - * Formerly known as "service_id" - */ - graphID: Scalars['String']; - /** - * Specifies which variant of a graph this implementing service belongs to". - * Formerly known as "tag" - */ - graphVariant: Scalars['String']; +export type ProposalMutationDeleteCommentArgs = { + input: DeleteCommentInput; }; -export type OdysseyCourse = { - __typename?: 'OdysseyCourse'; - completedAt: Maybe; - enrolledAt: Maybe; - id: Scalars['ID']; -}; -export type OdysseyCourseInput = { - completedAt: Maybe; - courseId: Scalars['String']; +export type ProposalMutationDeleteSubgraphArgs = { + input: DeleteProposalSubgraphInput; }; -export type OdysseyTask = { - __typename?: 'OdysseyTask'; - completedAt: Maybe; - id: Scalars['ID']; - value: Maybe; -}; -export type OdysseyTaskInput = { - completedAt: Maybe; - taskId: Scalars['String']; - value: Maybe; +export type ProposalMutationEditCommentArgs = { + input: EditCommentInput; }; -export type Operation = { - __typename?: 'Operation'; - id: Scalars['ID']; - name: Maybe; - signature: Maybe; - truncated: Scalars['Boolean']; -}; -export type OperationAcceptedChange = { - __typename?: 'OperationAcceptedChange'; - acceptedAt: Scalars['Timestamp']; - acceptedBy: Identity; - change: StoredApprovedChange; - checkID: Scalars['ID']; - graphID: Scalars['ID']; - id: Scalars['ID']; - operationID: Scalars['String']; +export type ProposalMutationPublishSubgraphsArgs = { + input: PublishProposalSubgraphsInput; }; -/** Columns of OperationCheckStats. */ -export enum OperationCheckStatsColumn { - CachedRequestsCount = 'CACHED_REQUESTS_COUNT', - ClientName = 'CLIENT_NAME', - ClientVersion = 'CLIENT_VERSION', - QueryId = 'QUERY_ID', - SchemaTag = 'SCHEMA_TAG', - ServiceId = 'SERVICE_ID', - Timestamp = 'TIMESTAMP', - UncachedRequestsCount = 'UNCACHED_REQUESTS_COUNT' -} -export type OperationCheckStatsDimensions = { - __typename?: 'OperationCheckStatsDimensions'; - clientName: Maybe; - clientVersion: Maybe; - queryId: Maybe; - schemaTag: Maybe; - serviceId: Maybe; +export type ProposalMutationSetRequestedReviewersArgs = { + input: Maybe; }; -/** Filter for data in OperationCheckStats. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ -export type OperationCheckStatsFilter = { - and: Maybe>; - /** Selects rows whose clientName dimension equals the given value if not null. To query for the null value, use {in: {clientName: [null]}} instead. */ - clientName: Maybe; - /** Selects rows whose clientVersion dimension equals the given value if not null. To query for the null value, use {in: {clientVersion: [null]}} instead. */ - clientVersion: Maybe; - in: Maybe; - not: Maybe; - or: Maybe>; - /** Selects rows whose queryId dimension equals the given value if not null. To query for the null value, use {in: {queryId: [null]}} instead. */ - queryId: Maybe; - /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ - schemaTag: Maybe; - /** Selects rows whose serviceId dimension equals the given value if not null. To query for the null value, use {in: {serviceId: [null]}} instead. */ - serviceId: Maybe; -}; -/** Filter for data in OperationCheckStats. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ -export type OperationCheckStatsFilterIn = { - /** Selects rows whose clientName dimension is in the given list. A null value in the list means a row with null for that dimension. */ - clientName: Maybe>>; - /** Selects rows whose clientVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ - clientVersion: Maybe>>; - /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ - queryId: Maybe>>; - /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ - schemaTag: Maybe>>; - /** Selects rows whose serviceId dimension is in the given list. A null value in the list means a row with null for that dimension. */ - serviceId: Maybe>>; +export type ProposalMutationUpdateDisplayNameArgs = { + displayName: Scalars['String']; }; -export type OperationCheckStatsMetrics = { - __typename?: 'OperationCheckStatsMetrics'; - cachedRequestsCount: Scalars['Long']; - uncachedRequestsCount: Scalars['Long']; + +export type ProposalMutationUpdateRequestedReviewersArgs = { + input: UpdateRequestedReviewersInput; }; -export type OperationCheckStatsOrderBySpec = { - column: OperationCheckStatsColumn; - direction: Ordering; + +export type ProposalMutationUpdateStatusArgs = { + status: ProposalStatus; }; -export type OperationCheckStatsRecord = { - __typename?: 'OperationCheckStatsRecord'; - /** Dimensions of OperationCheckStats that can be grouped by. */ - groupBy: OperationCheckStatsDimensions; - /** Metrics of OperationCheckStats that can be aggregated over. */ - metrics: OperationCheckStatsMetrics; - /** Starting segment timestamp. */ + +export type ProposalMutationUpdateUpdatedByInfoArgs = { timestamp: Scalars['Timestamp']; }; -export type OperationDocument = { - __typename?: 'OperationDocument'; - /** Operation document body */ - body: Scalars['String']; - /** Operation name */ - name: Maybe; -}; -export type OperationDocumentInput = { - /** Operation document body */ - body: Scalars['String']; - /** Operation name */ - name: Maybe; +export type ProposalMutationUpsertReviewArgs = { + input: UpsertReviewInput; }; -export type OperationValidationError = { - __typename?: 'OperationValidationError'; - message: Scalars['String']; -}; +export type ProposalMutationResult = NotFoundError | PermissionError | ProposalMutation | ValidationError; -export type OperationsCheckResult = { - __typename?: 'OperationsCheckResult'; - /** Operations affected by all changes in diff */ - affectedQueries: Maybe>; - /** Summary/counts for all changes in diff */ - changeSummary: ChangeSummary; - /** List of schema changes with associated affected clients and operations */ - changes: Array; - /** Indication of the success of the change, either failure, warning, or notice. */ - checkSeverity: ChangeSeverity; - /** The variant that was used as a base to check against */ - checkedVariant: GraphVariant; +export type ProposalPartialImplementationProposalOrigin = ProposalImplementation & { + __typename?: 'ProposalPartialImplementationProposalOrigin'; + /** the time this Proposal became partially implemented in the implementation target variant. */ createdAt: Scalars['Timestamp']; id: Scalars['ID']; - /** Number of affected query operations that are neither marked as SAFE or IGNORED */ - numberOfAffectedOperations: Scalars['Int']; - /** Number of operations that were validated during schema diff */ - numberOfCheckedOperations: Scalars['Int']; - workflowTask: OperationsCheckTask; + /** the diff that was matched between the Proposal and the implementation target variant. TODO to deserialize this back into a DiffItem NEBULA-2726 */ + jsonDiff: Array; + /** Revision containing a diff that partially implements this Proposal in the implementation target variant. */ + revision: ProposalRevision; + /** the target variant this Proposal became partially implemented in. */ + variant: GraphVariant; }; -export type OperationsCheckTask = CheckWorkflowTask & { - __typename?: 'OperationsCheckTask'; - completedAt: Maybe; +export type ProposalPartialImplementationVariantOrigin = ProposalImplementation & { + __typename?: 'ProposalPartialImplementationVariantOrigin'; + /** the time this Proposal became partially implemented in the implementation target variant. */ createdAt: Scalars['Timestamp']; id: Scalars['ID']; - /** The result of the check. */ - result: Maybe; - status: CheckWorkflowTaskStatus; - workflow: CheckWorkflow; + /** the diff that was matched between the Proposal and the implementation target variant. TODO to deserialize this back into a DiffItem NEBULA-2726 */ + jsonDiff: Array; + /** launch containing a diff that partially implements this Proposal in the implementation target variant. null if user does not have access to launches */ + launch: Maybe; + /** the target variant this Proposal became partially implemented in. */ + variant: GraphVariant; +}; + +export type ProposalRequestedReviewer = { + __typename?: 'ProposalRequestedReviewer'; + currentReview: Maybe; + user: Maybe; +}; + +export type ProposalReview = { + __typename?: 'ProposalReview'; + comment: Maybe; + createdAt: Scalars['Timestamp']; + createdBy: Maybe; + decision: ReviewDecision; + isDismissed: Scalars['Boolean']; + updatedAt: Maybe; + updatedBy: Maybe; }; -export type OperationsCollection = { - __typename?: 'OperationsCollection'; +export type ProposalRevision = { + __typename?: 'ProposalRevision'; + checkWorkflows: Array; + createdBy: Maybe; id: Scalars['ID']; + launch: Maybe; + /** null if this is the first revision */ + previousRevision: Maybe; + summary: Scalars['String']; }; -export enum Ordering { - Ascending = 'ASCENDING', - Descending = 'DESCENDING' -} +export type ProposalRevisionFilterInput = { + authors: Maybe>; + status: Maybe; + subgraphs: Maybe>; +}; -/** A reusable invite link for an organization. */ -export type OrganizationInviteLink = { - __typename?: 'OrganizationInviteLink'; - createdAt: Scalars['Timestamp']; - /** A joinToken that can be passed to Mutation.joinAccount to join the organization. */ - joinToken: Scalars['String']; - /** The role that the user will receive if they join the organization with this link. */ - role: UserPermission; +/** Proposal variants, limited & offset based on Service.proposalVariants & the total count */ +export type ProposalRevisionsWithChecksResult = { + __typename?: 'ProposalRevisionsWithChecksResult'; + revisions: Array; + /** The total number of proposal revisions with checks matching filters. */ + totalCount: Scalars['Int']; }; -export type OrganizationSso = { - __typename?: 'OrganizationSSO'; - defaultRole: UserPermission; - idpid: Scalars['ID']; - provider: OrganizationSsoProvider; +export type ProposalRoles = { + __typename?: 'ProposalRoles'; + create: UserPermission; + edit: UserPermission; }; -export enum OrganizationSsoProvider { - Pingone = 'PINGONE' +export enum ProposalStatus { + Approved = 'APPROVED', + Closed = 'CLOSED', + Draft = 'DRAFT', + Implemented = 'IMPLEMENTED', + Open = 'OPEN' } -/** PagerDuty notification channel */ -export type PagerDutyChannel = Channel & { - __typename?: 'PagerDutyChannel'; - id: Scalars['ID']; - name: Scalars['String']; - routingKey: Scalars['String']; - subscriptions: Array; +export type ProposalVariantCreationErrors = { + __typename?: 'ProposalVariantCreationErrors'; + /** A list of all errors that occurred when attempting to create a proposal variant. */ + errorMessages: Array; }; -/** PagerDuty notification channel parameters */ -export type PagerDutyChannelInput = { - name: Maybe; - routingKey: Scalars['String']; -}; +export type ProposalVariantCreationResult = GraphVariant | ProposalVariantCreationErrors; -/** Schema for an implementing service with associated metadata */ -export type PartialSchema = { - __typename?: 'PartialSchema'; - /** Timestamp for when the partial schema was created */ - createdAt: Scalars['Timestamp']; - /** If this sdl is currently actively composed in the gateway, this is true */ - isLive: Scalars['Boolean']; - /** The enriched sdl of a partial schema */ - sdl: Scalars['String']; - /** The path of deep storage to find the raw enriched partial schema file */ - sdlPath: Scalars['String']; +/** Filtering options for graph connections. */ +export type ProposalVariantsFilter = { + /** Only include proposals of a certain status */ + status: Maybe>; + /** Only include proposals that have updated these subgraph names */ + subgraphs: Maybe>; }; -/** - * Input for registering a partial schema to an implementing service. - * One of the fields must be specified (validated server-side). - * - * If a new partialSchemaSDL is passed in, this operation will store it before - * creating the association. - * - * If both the sdl and hash are specified, an error will be thrown if the provided - * hash doesn't match our hash of the sdl contents. If the sdl field is specified, - * the hash does not need to be and will be computed server-side. - */ -export type PartialSchemaInput = { - /** - * Hash of the partial schema to associate; error is thrown if only the hash is - * specified and the hash has not been seen before - */ - hash: Maybe; - /** - * Contents of the partial schema in SDL syntax, but may reference types - * that aren't defined in this document - */ - sdl: Maybe; +/** Proposal variants, limited & offset based on Service.proposalVariants & the total count */ +export type ProposalVariantsResult = { + __typename?: 'ProposalVariantsResult'; + /** The total number of proposal variants on this graph */ + totalCount: Scalars['Int']; + variants: Array; }; -export type PromoteSchemaError = { - __typename?: 'PromoteSchemaError'; - code: PromoteSchemaErrorCode; - message: Scalars['String']; +export type ProposalsCheckTask = CheckWorkflowTask & { + __typename?: 'ProposalsCheckTask'; + completedAt: Maybe; + createdAt: Scalars['Timestamp']; + /** The results of this proposal check were overridden */ + didOverrideProposalsCheckTask: Scalars['Boolean']; + graphID: Scalars['ID']; + id: Scalars['ID']; + /** Indicates the level of coverage a check's changeset is in approved Proposals. PENDING while Check is still running. */ + proposalCoverage: ProposalCoverage; + /** Proposals with their state at the time the check was run associated to this check task. */ + relatedProposalResults: Array; + /** @deprecated use relatedProposalResults instead */ + relatedProposals: Array; + /** The configured severity at the time the check was run. If the check failed, this is the severity that should be shown. While this Check is PENDING defaults to Service's severityLevel. */ + severityLevel: ProposalChangeMismatchSeverity; + status: CheckWorkflowTaskStatus; + targetURL: Maybe; + workflow: CheckWorkflow; }; -export enum PromoteSchemaErrorCode { - CannotPromoteSchemaForFederatedGraph = 'CANNOT_PROMOTE_SCHEMA_FOR_FEDERATED_GRAPH' -} +export type ProposedBuildInputChanges = ProposedCompositionBuildInputChanges | ProposedFilterBuildInputChanges; -export type PromoteSchemaResponse = { - __typename?: 'PromoteSchemaResponse'; - code: PromoteSchemaResponseCode; - tag: SchemaTag; +export type ProposedCompositionBuildInputChanges = { + __typename?: 'ProposedCompositionBuildInputChanges'; + /** The proposed new build pipeline track, or null if no such change was proposed. */ + buildPipelineTrackChange: Maybe; + /** Any proposed upserts to subgraphs, or the empty list if no such changes were proposed. */ + subgraphUpserts: Array; }; -export enum PromoteSchemaResponseCode { - NoChangesDetected = 'NO_CHANGES_DETECTED', - PromotionSuccess = 'PROMOTION_SUCCESS' -} - -export type PromoteSchemaResponseOrError = PromoteSchemaError | PromoteSchemaResponse; +export type ProposedCompositionBuildInputSubgraphUpsert = { + __typename?: 'ProposedCompositionBuildInputSubgraphUpsert'; + /** The name of the subgraph changed in this subgraph upsert. */ + name: Scalars['String']; + /** The SHA-256 of the schema document in this subgraph upsert. */ + schemaHash: Maybe; +}; + +export type ProposedFilterBuildInputChanges = { + __typename?: 'ProposedFilterBuildInputChanges'; + /** The proposed new build pipeline track, or null if no such change was proposed. */ + buildPipelineTrackChange: Maybe; + /** Any proposed additions to exclude filters, or the empty list if no such changes were proposed. */ + excludeAdditions: Array; + /** Any proposed removals to exclude filters, or the empty list if no such changes were proposed. */ + excludeRemovals: Array; + /** The proposed value for whether to hide unreachable schema elements, or null if no such change was proposed. */ + hideUnreachableTypesChange: Maybe; + /** Any proposed additions to include filters, or the empty list if no such changes were proposed. */ + includeAdditions: Array; + /** Any proposed removals to include filters, or the empty list if no such changes were proposed. */ + includeRemovals: Array; + /** The proposed new build pipeline track, or null if no such change was proposed. */ + supergraphSchemaHashChange: Maybe; +}; export type Protobuf = { __typename?: 'Protobuf'; - json: Maybe; - object: Maybe; + json: Scalars['String']; + object: Scalars['Object']; raw: Scalars['Blob']; text: Scalars['String']; }; +/** The result of a successful call to PersistedQueryListMutation.publishOperations. */ +export type PublishOperationsResult = { + __typename?: 'PublishOperationsResult'; + /** The build created by this publish operation. */ + build: PersistedQueryListBuild; + /** Returns `true` if no changes were made by this publish (and no new revision was created). Otherwise, returns `false`. */ + unchanged: Scalars['Boolean']; +}; + +/** The interface returned by PersistedQueryListMutation.publishOperations. */ +export type PublishOperationsResultOrError = CannotModifyOperationBodyError | PermissionError | PublishOperationsResult; + +export type PublishProposalSubgraphResult = NotFoundError | PermissionError | Proposal | ValidationError; + +export type PublishProposalSubgraphsInput = { + gitContext: Maybe; + previousLaunchId: Scalars['ID']; + revision: Scalars['String']; + subgraphInputs: Array; + summary: Scalars['String']; +}; + +export type PublishSubgraphsSubgraphInput = { + activePartialSchema: PartialSchemaInput; + name: Scalars['String']; + url: Maybe; +}; + +export type PushMarketoLeadInput = { + /** Clearbit enriched LinkedIn URL */ + Clearbit_LinkedIn_URL__c: Maybe; + /** Company domain */ + Company_Domain__c: Maybe; + /** GDPR Explicit Opt in */ + Explicit_Opt_in__c: Maybe; + /** GA Client ID */ + Google_User_ID__c: Maybe; + /** GraphQL Production Stage */ + GraphQL_Production_Stage__c: Maybe; + /** Job Function */ + Job_Function__c: Maybe; + /** Lead Message */ + Lead_Message__c: Maybe; + /** Lead Source Detail */ + Lead_Source_Detail__c: Maybe; + /** Lead Source Most Recent Detail */ + Lead_Source_Most_Recent_Detail__c: Maybe; + /** Lead Source Most Recent */ + Lead_Source_Most_Recent__c: Maybe; + /** Referrer */ + Referrer__c: Maybe; + /** Studio User Id */ + Studio_User_Id__c: Maybe; + /** UTM Campaign First Touch */ + UTM_Campaign_First_Touch__c: Maybe; + /** UTM Campaign */ + UTM_Campaign__c: Maybe; + /** UTM ICID */ + UTM_ICID__c: Maybe; + /** UTM Medium First Touch */ + UTM_Medium_First_Touch__c: Maybe; + /** UTM Medium */ + UTM_Medium__c: Maybe; + /** UTM Source First Touch */ + UTM_Source_First_Touch__c: Maybe; + /** UTM Source */ + UTM_Source__c: Maybe; + /** UTM Term */ + UTM_Term__c: Maybe; + /** Company name */ + company: Maybe; + /** Country */ + country: Maybe; + /** Email address */ + email: Maybe; + /** First name */ + firstName: Maybe; + /** Last name */ + lastName: Maybe; + /** Phone number */ + phone: Maybe; +}; + +/** Queries defined by this subgraph */ export type Query = { __typename?: 'Query'; - _odysseyFakeField: Maybe; /** Account by ID */ account: Maybe; + /** Retrieve account by billing provider identifier */ + accountByBillingCode: Maybe; + /** Retrieve account by internal id */ + accountByInternalID: Maybe; /** Whether an account ID is available for mutation{newAccount(id:)} */ accountIDAvailable: Scalars['Boolean']; /** All accounts */ allAccounts: Maybe>; + /** All accounts on team billable plans with active subscriptions */ + allActiveTeamBillingAccounts: Maybe>; + /** All available billing plan capabilities */ + allBillingCapabilities: Array; + /** All available billing plan limits */ + allBillingLimits: Array; /** All available plans */ - allPlans: Array; + allBillingPlans: Array; + allPublicVariants: Maybe>; + /** All auto-renewing team accounts on active annual plans */ + allRenewingNonEnterpriseAnnualAccounts: Maybe>; + allSelfHostedCommercialRuntimeEntitlements: Array>; /** All services */ allServices: Maybe>; /** All timezones with their offsets from UTC */ allTimezoneOffsets: Array; /** All users */ allUsers: Maybe>; + auditLog: Array>; + billingAdmin: Maybe; + /** Retrieves all past and current subscriptions for an account, even if the account has been deleted */ + billingSubscriptionHistory: Array>; + billingTier: Maybe; /** If this is true, the user is an Apollo administrator who can ignore restrictions based purely on billing plan. */ canBypassPlanRestrictions: Scalars['Boolean']; + /** Cloud queries */ + cloud: Cloud; + /** Escaped JSON string of the public key used for verifying entitlement JWTs */ + commercialRuntimePublicKey: Scalars['String']; + csCommunicationChannel: Maybe; + csCommunicationChannels: Array>; + customerOrg: Maybe; + customerOrgs: Array>; diffSchemas: Array; /** Get the unsubscribe settings for a given email. */ emailPreferences: Maybe; - experimentalFeatures: GlobalExperimentalFeatures; + /** Past and current enterprise trial accounts */ + enterpriseTrialAccounts: Maybe>; + /** Returns the root URL of the Apollo Studio frontend. */ frontendUrlRoot: Scalars['String']; - helloWorldBilling: Maybe; - helloWorldOperationsCollections: Maybe; + getAdminUsers: Array; + getAllMessages: Array>; + getMessage: Maybe; + getRecallLog: Array>; + /** Returns details of the graph with the provided ID. */ + graph: Maybe; + identitySubgraphStatus: Scalars['String']; internalActiveCronJobs: Array; internalAdminUsers: Maybe>; internalUnresolvedCronExecutionFailures: Array; - /** Current identity, null if not authenticated */ + /** Returns details of the authenticated `User` or `Graph` executing this query. If this is an unauthenticated query (i.e., no API key is provided), this field returns null. */ me: Maybe; + myPermissions: Permission; + odysseyCertification: Maybe; + /** Returns the [operation collection](https://www.apollographql.com/docs/studio/explorer/operation-collections/) for the provided ID. */ + operationCollection: OperationCollectionResult; + operationCollectionEntries: Array; + /** Returns details of the Studio organization with the provided ID. */ + organization: Maybe; /** Look up a plan by ID */ plan: Maybe; + proposal: Maybe; /** A list of public variants that have been selected to be shown on our Graph Directory. */ publiclyListedVariants: Maybe>; + /** Accounts with enterprise subscriptions that have expired in the past 45 days */ + recentlyExpiredEnterpriseAccounts: Maybe>; + /** Search all accounts */ + searchAccounts: Array; /** Service by ID */ service: Maybe; + /** Accounts with enterprise subscriptions that will expire within the next 30 days */ + soonToExpireEnterpriseAccounts: Maybe>; /** Query statistics across all services. For admins only; normal users must go through AccountsStatsWindow or ServiceStatsWindow. */ stats: StatsWindow; /** Get the studio settings for the current user */ studioSettings: Maybe; - /** The plan started by AccountMutation.startTeamSubscription */ - teamPlan: BillingPlan; - /** The plan started by AccountMutation.startTrial */ - trialPlan: BillingPlan; - /** User by ID */ + /** Schema transformation for the Apollo platform API. Renames types. Internal to Apollo. */ + transformSchemaForPlatformApi: Maybe; + /** Returns details of the Apollo user with the provided ID. */ user: Maybe; - /** - * Access a variant by reference of the form `graphID@variantName`, or `graphID` for the default `current` variant. - * Returns null when the graph or variant do not exist, or when the graph cannot be accessed. - * Note that we can return more types implementing Error in the future. - */ + /** Returns details of a Studio graph variant with the provided graph ref. A graph ref has the format `graphID@variantName` (or just `graphID` for the default variant `current`). Returns null if the graph or variant doesn't exist, or if the graph isn't accessible by the current actor. */ variant: Maybe; + zendeskUploadToken: Scalars['String']; }; +/** Queries defined by this subgraph */ export type QueryAccountArgs = { id: Scalars['ID']; }; +/** Queries defined by this subgraph */ +export type QueryAccountByBillingCodeArgs = { + id: Scalars['ID']; +}; + + +/** Queries defined by this subgraph */ +export type QueryAccountByInternalIdArgs = { + id: Scalars['ID']; +}; + + +/** Queries defined by this subgraph */ export type QueryAccountIdAvailableArgs = { id: Scalars['ID']; }; +/** Queries defined by this subgraph */ export type QueryAllAccountsArgs = { search: Maybe; tier: Maybe; }; +/** Queries defined by this subgraph */ export type QueryAllServicesArgs = { search: Maybe; }; +/** Queries defined by this subgraph */ export type QueryAllUsersArgs = { search: Maybe; }; +/** Queries defined by this subgraph */ +export type QueryAuditLogArgs = { + messageId: Scalars['ID']; +}; + + +/** Queries defined by this subgraph */ +export type QueryBillingSubscriptionHistoryArgs = { + id: Maybe; +}; + + +/** Queries defined by this subgraph */ +export type QueryBillingTierArgs = { + tier: BillingPlanTier; +}; + + +/** Queries defined by this subgraph */ +export type QueryCsCommunicationChannelArgs = { + id: Scalars['ID']; +}; + + +/** Queries defined by this subgraph */ +export type QueryCustomerOrgArgs = { + id: Scalars['ID']; +}; + + +/** Queries defined by this subgraph */ +export type QueryCustomerOrgsArgs = { + nextHash: Maybe; +}; + + +/** Queries defined by this subgraph */ export type QueryDiffSchemasArgs = { baseSchema: Scalars['String']; nextSchema: Scalars['String']; }; +/** Queries defined by this subgraph */ export type QueryEmailPreferencesArgs = { email: Scalars['String']; token: Scalars['String']; }; +/** Queries defined by this subgraph */ +export type QueryGetMessageArgs = { + messageId: Scalars['ID']; +}; + + +/** Queries defined by this subgraph */ +export type QueryGetRecallLogArgs = { + messageId: Scalars['ID']; +}; + + +/** Queries defined by this subgraph */ +export type QueryGraphArgs = { + id: Scalars['ID']; +}; + + +/** Queries defined by this subgraph */ +export type QueryOdysseyCertificationArgs = { + id: Scalars['ID']; +}; + + +/** Queries defined by this subgraph */ +export type QueryOperationCollectionArgs = { + id: Scalars['ID']; +}; + + +/** Queries defined by this subgraph */ +export type QueryOperationCollectionEntriesArgs = { + collectionEntryIds: Array; +}; + + +/** Queries defined by this subgraph */ +export type QueryOrganizationArgs = { + id: Scalars['ID']; +}; + + +/** Queries defined by this subgraph */ export type QueryPlanArgs = { id: Maybe; }; +/** Queries defined by this subgraph */ +export type QueryProposalArgs = { + id: Scalars['ID']; +}; + + +/** Queries defined by this subgraph */ +export type QuerySearchAccountsArgs = { + search: Maybe; +}; + + +/** Queries defined by this subgraph */ export type QueryServiceArgs = { id: Scalars['ID']; }; +/** Queries defined by this subgraph */ export type QueryStatsArgs = { from: Scalars['Timestamp']; resolution: Maybe; @@ -4075,16 +9615,19 @@ export type QueryStatsArgs = { }; -export type QueryTeamPlanArgs = { - billingPeriod: BillingPeriod; +/** Queries defined by this subgraph */ +export type QueryTransformSchemaForPlatformApiArgs = { + baseSchema: Scalars['GraphQLDocument']; }; +/** Queries defined by this subgraph */ export type QueryUserArgs = { id: Scalars['ID']; }; +/** Queries defined by this subgraph */ export type QueryVariantArgs = { ref: Scalars['ID']; }; @@ -4094,6 +9637,13 @@ export type QueryDocumentInput = { document: Maybe; }; +export type QueryPlan = { + __typename?: 'QueryPlan'; + json: Scalars['String']; + object: Scalars['Object']; + text: Scalars['String']; +}; + /** Columns of QueryStats. */ export enum QueryStatsColumn { AccountId = 'ACCOUNT_ID', @@ -4104,6 +9654,8 @@ export enum QueryStatsColumn { ClientVersion = 'CLIENT_VERSION', ForbiddenOperationCount = 'FORBIDDEN_OPERATION_COUNT', FromEngineproxy = 'FROM_ENGINEPROXY', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', QueryId = 'QUERY_ID', QueryName = 'QUERY_NAME', RegisteredOperationCount = 'REGISTERED_OPERATION_COUNT', @@ -4122,9 +9674,12 @@ export type QueryStatsDimensions = { clientName: Maybe; clientVersion: Maybe; fromEngineproxy: Maybe; + operationSubtype: Maybe; + operationType: Maybe; queryId: Maybe; queryName: Maybe; querySignature: Maybe; + querySignatureLength: Maybe; schemaHash: Maybe; schemaTag: Maybe; serviceId: Maybe; @@ -4143,6 +9698,10 @@ export type QueryStatsFilter = { fromEngineproxy: Maybe; in: Maybe; not: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; or: Maybe>; /** Selects rows whose queryId dimension equals the given value if not null. To query for the null value, use {in: {queryId: [null]}} instead. */ queryId: Maybe; @@ -4166,6 +9725,10 @@ export type QueryStatsFilterIn = { clientVersion: Maybe>>; /** Selects rows whose fromEngineproxy dimension is in the given list. A null value in the list means a row with null for that dimension. */ fromEngineproxy: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ queryId: Maybe>>; /** Selects rows whose queryName dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -4282,14 +9845,80 @@ export enum QueryTriggerWindow { Unrecognized = 'UNRECOGNIZED' } +/** The README documentation for a graph variant, which is displayed in Studio. */ export type Readme = { __typename?: 'Readme'; + /** The contents of the README in plaintext. */ content: Scalars['String']; + /** The README's unique ID. `a15177c0-b003-4837-952a-dbfe76062eb1` for the default README */ id: Scalars['ID']; + /** + * The timestamp when the README was most recently updated. `1970-01-01T00:00:00Z` for the default README + * @deprecated Deprecated in favour of lastUpdatedTime + */ lastUpdatedAt: Scalars['Timestamp']; + /** The actor that most recently updated the README (usually a `User`). `null` for the default README, or if the `User` was deleted. */ lastUpdatedBy: Maybe; + /** The timestamp when the README was most recently updated. `null` for the default README */ + lastUpdatedTime: Maybe; +}; + +/** Responsibility for an errored order */ +export enum ReasonCause { + /** + * Could not complete an order due to internal reason + * + * This could be due to intermittent issues, bug in our code, etc. + */ + Internal = 'INTERNAL', + /** + * Could not complete an order due to invalid User input + * + * For example, the user provided an invalid router configuration or supergraph schema. + */ + User = 'USER' +} + +export type RebaseConflictError = { + __typename?: 'RebaseConflictError'; + errorMessages: Array; +}; + +export type RebaseConflictResult = RebaseConflictError | SchemaValidationError; + +/** Description for a Cloud Router region */ +export type RegionDescription = { + __typename?: 'RegionDescription'; + /** Region identifier */ + code: Scalars['String']; + /** Country of the region, in ISO 3166-1 alpha-2 code */ + country: Scalars['String']; + /** Full name of the region */ + name: Scalars['String']; + /** Cloud Provider related to this region */ + provider: CloudProvider; + /** State of the Region */ + state: RegionState; }; +/** Possible state of a region */ +export enum RegionState { + /** + * Active region + * + * Can be used for Cloud Routers + */ + Active = 'ACTIVE', + /** Does not appear in the API */ + Hidden = 'HIDDEN', + /** + * Inactive region + * + * Cannot yet be used for Cloud Routers + */ + Inactive = 'INACTIVE' +} + export type RegisterOperationsMutationResponse = { __typename?: 'RegisterOperationsMutationResponse'; invalidOperations: Maybe>; @@ -4315,14 +9944,8 @@ export type RegisteredOperationInput = { }; export type RegisteredOperationMetadataInput = { - /** This will be used to link existing records in Engine to a new ID. */ - engineSignature: Maybe; -}; - -export type RegistryApiKey = { - __typename?: 'RegistryApiKey'; - keyName: Maybe; - token: Scalars['String']; + /** This will be used to link existing records in Engine to a new ID. */ + engineSignature: Maybe; }; export type RegistryStatsWindow = { @@ -4344,6 +9967,17 @@ export type RegistrySubscription = ChannelSubscription & { variant: Maybe; }; +/** A Proposal related to a Proposal Check Task. */ +export type RelatedProposalResult = { + __typename?: 'RelatedProposalResult'; + /** The latest revision at the time the check was run, defaults to current revision if nothing found for time of the check. */ + latestRevisionAtCheck: ProposalRevision; + /** The Proposal related to the check. State may have changed since the Check was run. */ + proposal: Proposal; + /** The status of the Proposal at the time the check was run, defaults to current state if nothing found for time of the check. */ + statusAtCheck: ProposalStatus; +}; + export type RelaunchComplete = { __typename?: 'RelaunchComplete'; latestLaunch: Launch; @@ -4357,6 +9991,41 @@ export type RelaunchError = { export type RelaunchResult = RelaunchComplete | RelaunchError; +export type RemoveOperationCollectionEntryResult = OperationCollection | PermissionError; + +export type RemoveOperationCollectionFromVariantResult = GraphVariant | NotFoundError | PermissionError | ValidationError; + +export type ReorderOperationCollectionResult = OperationCollection | PermissionError; + +export type ReplyChangeProposalComment = ChangeProposalComment & ProposalComment & { + __typename?: 'ReplyChangeProposalComment'; + createdAt: Scalars['Timestamp']; + /** null if the user is deleted */ + createdBy: Maybe; + id: Scalars['ID']; + message: Scalars['String']; + /** true if the schemaCoordinate this comment is on doesn't exist in the diff between the most recent revision & the base sdl */ + outdated: Scalars['Boolean']; + schemaCoordinate: Scalars['String']; + /** '#@!api!@#' for api schema, '#@!supergraph!@#' for supergraph schema, subgraph otherwise */ + schemaScope: Scalars['String']; + status: CommentStatus; + /** null if never updated */ + updatedAt: Maybe; +}; + +export type ReplyGeneralProposalComment = GeneralProposalComment & ProposalComment & { + __typename?: 'ReplyGeneralProposalComment'; + createdAt: Scalars['Timestamp']; + /** null if the user is deleted */ + createdBy: Maybe; + id: Scalars['ID']; + message: Scalars['String']; + status: CommentStatus; + /** null if never updated */ + updatedAt: Maybe; +}; + export type ReportSchemaError = ReportSchemaResult & { __typename?: 'ReportSchemaError'; code: ReportSchemaErrorCode; @@ -4417,6 +10086,21 @@ export type ReportServerInfoResult = { withExecutableSchema: Scalars['Boolean']; }; +export type RequestCountsPerGraphVariant = { + __typename?: 'RequestCountsPerGraphVariant'; + cachedRequestsCount: Scalars['Long']; + graphID: Scalars['String']; + uncachedRequestsCount: Scalars['Long']; + variant: Maybe; +}; + +export type RequesterUser = { + __typename?: 'RequesterUser'; + email: Scalars['String']; + id: Scalars['ID']; + name: Scalars['String']; +}; + export enum Resolution { R1D = 'R1D', R1H = 'R1H', @@ -4434,6 +10118,23 @@ export enum ResponseHints { TraceTimings = 'TRACE_TIMINGS' } +export enum ReviewDecision { + Approved = 'APPROVED', + NotApproved = 'NOT_APPROVED' +} + +export type ReviewProposalComment = ProposalComment & { + __typename?: 'ReviewProposalComment'; + createdAt: Scalars['Timestamp']; + /** null if the user is deleted */ + createdBy: Maybe; + id: Scalars['ID']; + message: Scalars['String']; + status: CommentStatus; + /** null if never updated */ + updatedAt: Maybe; +}; + export type RoleOverride = { __typename?: 'RoleOverride'; graph: Service; @@ -4442,6 +10143,305 @@ export type RoleOverride = { user: User; }; +export type Router = { + __typename?: 'Router'; + /** Order currently modifying this Cloud Router */ + currentOrder: Maybe; + /** + * Number of Graph Compute Units (GCUs) associated with this Cloud Router + * + * This value is not present for Cloud Routers on the `SERVERLESS` tier. + */ + gcus: Maybe; + /** graphRef representing the Cloud Router */ + id: Scalars['ID']; + /** Retrieves a specific Order related to this Cloud Router */ + order: Maybe; + /** Retrieves all Orders related to this Cloud Router */ + orders: Array; + /** + * URL where the Cloud Router can be found + * + * This will be null if the Cloud Router is in a deleted status + */ + routerUrl: Maybe; + /** Current version of the Cloud Router */ + routerVersion: RouterVersion; + /** Return the list of secrets for this Cloud Router with their hash values */ + secrets: Array; + /** Shard associated with this Cloud Router */ + shard: Maybe; + /** Current status of the Cloud Router */ + status: RouterStatus; + /** + * Last time when the Cloud Router was updated + * + * If the Cloud Router was never updated, this value will be null + */ + updatedAt: Maybe; +}; + + +export type RouterOrderArgs = { + orderId: Scalars['ID']; +}; + + +export type RouterOrdersArgs = { + first: Maybe; + offset: Maybe; +}; + +/** Router configuration input */ +export type RouterConfigInput = { + /** + * Number of GCUs allocated for the Cloud Router + * + * This is ignored for serverless Cloud Routers + */ + gcus: Maybe; + /** Graph composition ID, also known as launch ID */ + graphCompositionId: Maybe; + /** Configuration for the Cloud Router */ + routerConfig: Maybe; + /** URL for the Cloud Router */ + routerUrl: Maybe; + /** Router version for the Cloud Router */ + routerVersion: Maybe; +}; + +export type RouterConfigVersion = { + __typename?: 'RouterConfigVersion'; + /** JSON schema for validating the router configuration */ + configSchema: Maybe; + /** Name of the RouterConfigVersion */ + name: Scalars['String']; +}; + + +export type RouterConfigVersionConfigSchemaArgs = { + tier: CloudTier; +}; + +/** Input to create a RouterConfigVersion */ +export type RouterConfigVersionInput = { + /** Configuration schema mapping for the RouterConfigVersion */ + configSchemas: Scalars['JSONObject']; + /** Name of the RouterConfigVersion */ + configVersion: Scalars['String']; +}; + +export type RouterEntitlement = { + __typename?: 'RouterEntitlement'; + /** The internal id of the account this entitlement was generated for. */ + accountId: Scalars['String']; + /** Which audiences this entitlement applies to. Cloud and on-premise routers each require the presence of their own audience. */ + audience: Array; + /** Router should stop serving requests after this time if commercial features are in use. */ + haltAt: Maybe; + /** RFC 8037 Ed25519 JWT signed representation of sibling fields. Restricted to internal services only. */ + jwt: Scalars['String']; + /** Organization this entitlement applies to. */ + subject: Scalars['String']; + /** Router should warn users after this time if commercial features are in use. */ + warnAt: Maybe; +}; + +export enum RouterEntitlementAudience { + Cloud = 'CLOUD', + SelfHosted = 'SELF_HOSTED' +} + +/** Represents the possible outcomes of a setGcus mutation */ +export type RouterGcusResult = InternalServerError | InvalidInputErrors | RouterGcusSuccess; + +/** Success branch of a setGcus mutation */ +export type RouterGcusSuccess = { + __typename?: 'RouterGcusSuccess'; + order: Order; +}; + +export type RouterMutation = { + __typename?: 'RouterMutation'; + /** Router mutations for Cloud Routers hosted on Fly */ + fly: Maybe; + /** Set the number of GCUs associated with this Router */ + setGcus: RouterGcusResult; + /** Set the version used for the next update for this Cloud Router */ + setNextVersion: SetNextVersionResult; + /** Set secrets for this Cloud Router */ + setSecrets: RouterSecretsResult; +}; + + +export type RouterMutationSetGcusArgs = { + gcus: Scalars['Int']; +}; + + +export type RouterMutationSetNextVersionArgs = { + version: Scalars['String']; +}; + + +export type RouterMutationSetSecretsArgs = { + input: RouterSecretsInput; +}; + +/** User input for a RouterSecrets mutation */ +export type RouterSecretsInput = { + /** Secrets to create or update */ + secrets: Maybe>; + /** Secrets to remove */ + unsetSecrets: Maybe>; +}; + +/** Represents the possible outcomes of a RouterSecrets mutation */ +export type RouterSecretsResult = InternalServerError | InvalidInputErrors | RouterSecretsSuccess; + +/** Success branch of a RouterSecrets mutation. */ +export type RouterSecretsSuccess = { + __typename?: 'RouterSecretsSuccess'; + order: Order; + secrets: Array; +}; + +/** Current status of Cloud Routers */ +export enum RouterStatus { + /** Cloud Router is not yet provisioned */ + Creating = 'CREATING', + /** Router has been deleted */ + Deleted = 'DELETED', + /** + * Cloud Router is running, but currently being deleted + * + * This is the only mutation state that doesn't support rollback. If we fail to + * delete a Router, the workflows are configured to stop and keep the router into + * the Deleting status. + */ + Deleting = 'DELETING', + /** + * Current order is rolling back to the last known good state + * + * After a RollingBack state, a Router can move either into Running state (from a + * Update order) or Deleted (from a Create order). + * + * If we fail to roll back, the workflows are configured to stop and keep the router + * into the RollingBack status. + */ + RollingBack = 'ROLLING_BACK', + /** Current router is running and able to server requests */ + Running = 'RUNNING', + /** Cloud Router is running, but currently being updated */ + Updating = 'UPDATING' +} + +export type RouterUpsertFailure = { + __typename?: 'RouterUpsertFailure'; + message: Scalars['String']; +}; + +/** A generic key→count type so that router usage metrics can be added to without modifying the `trackRouterUsage` mutation */ +export type RouterUsageInput = { + count: Scalars['Int']; + key: Scalars['String']; +}; + +/** Router Version */ +export type RouterVersion = { + __typename?: 'RouterVersion'; + /** Build number */ + build: Scalars['String']; + /** JSON schema for validating the router configuration for this router version */ + configSchema: Scalars['String']; + /** Config version for this router version */ + configVersion: Scalars['String']; + /** Core version identifier */ + core: Scalars['String']; + /** Status of a router version */ + status: Status; + /** Version identifier */ + version: Scalars['String']; +}; + + +/** Router Version */ +export type RouterVersionConfigSchemaArgs = { + tier: Maybe; +}; + +/** Result of a RouterConfigVersion mutation */ +export type RouterVersionConfigResult = CloudInvalidInputError | InternalServerError | RouterConfigVersion; + +/** Input to create a new router version */ +export type RouterVersionCreateInput = { + /** Version of the configuration */ + configVersion: Scalars['String']; + /** Version status */ + status: Status; + /** Version identifier */ + version: Scalars['String']; +}; + +/** Result of a router version query */ +export type RouterVersionResult = InternalServerError | InvalidInputErrors | RouterVersion; + +/** Input for updating a router version */ +export type RouterVersionUpdateInput = { + /** Version of the configuration */ + configVersion: Maybe; + /** Version status */ + status: Maybe; + /** Version identifier */ + version: Scalars['String']; +}; + +/** List of router versions */ +export type RouterVersions = { + __typename?: 'RouterVersions'; + versions: Array; +}; + +/** Input for filtering router versions */ +export type RouterVersionsInput = { + /** Name of the branch */ + branch: Maybe; + /** Maximum number of versions to return */ + limit: Maybe; + /** Status of the version */ + status: Maybe; +}; + +/** Result of a router versions query */ +export type RouterVersionsResult = InternalServerError | InvalidInputErrors | RouterVersions; + +export type RoverArgumentInput = { + key: Scalars['String']; + value: Maybe; +}; + +export type RunLintCheckInput = { + baseSchema: SchemaHashInput; + checkStep: CheckStepInput; + proposedSchema: SchemaHashInput; +}; + +/** Inputs needed to find all relevant proposals to a check workflow */ +export type RunProposalsCheckInput = { + /** List of subgraph names and hashes from the state of this variant when the check was run. */ + baseSubgraphs: Array; + /** Supergraph hash that was most recently published when the check was run */ + baseSupergraphHash: Scalars['String']; + /** List of subgraph names and hashes that are being proposed in the check task */ + proposedSubgraphs: Array; + /** Supergraph hash that is the output of the check's composition task */ + proposedSupergraphHash: Scalars['String']; + /** The severity to assign the check results if matching proposals are not found */ + severityLevel: ProposalChangeMismatchSeverity; + /** The check workflow task id. Used by Task entities to resolve the results */ + workflowTaskId: Scalars['String']; +}; + export type ScheduledSummary = ChannelSubscription & { __typename?: 'ScheduledSummary'; /** @deprecated Use channels list instead */ @@ -4453,51 +10453,83 @@ export type ScheduledSummary = ChannelSubscription & { variant: Scalars['String']; }; +/** A GraphQL schema document and associated metadata. */ export type Schema = { __typename?: 'Schema'; createTemporaryURL: Maybe; + /** The timestamp of initial ingestion of a schema to a graph. */ createdAt: Scalars['Timestamp']; + /** The GraphQL schema document. */ document: Scalars['GraphQLDocument']; /** The number of fields; this includes user defined fields only, excluding built-in types and fields */ fieldCount: Scalars['Int']; gitContext: Maybe; + /** The GraphQL schema document's SHA256 hash, represented as a hexadecimal string. */ hash: Scalars['ID']; introspection: IntrospectionSchema; + /** + * The list of schema coordinates ('TypeName.fieldName') in the schema + * that can be measured by usage reporting. + * Currently only supports object types and interface types. + */ + observableCoordinates: Maybe>; /** The number of types; this includes user defined types only, excluding built-in types */ typeCount: Scalars['Int']; }; +/** A GraphQL schema document and associated metadata. */ export type SchemaCreateTemporaryUrlArgs = { expiresInSeconds?: Scalars['Int']; }; -/** Represents an error from running schema composition on a list of service definitions. */ +/** An error that occurred while running schema composition on a set of subgraph schemas. */ export type SchemaCompositionError = { __typename?: 'SchemaCompositionError'; + /** A machine-readable error code. */ code: Maybe; + /** Source locations related to the error. */ locations: Array>; + /** A human-readable message describing the error. */ message: Scalars['String']; }; +export type SchemaCoordinate = { + __typename?: 'SchemaCoordinate'; + /** The printed coordinate value, e.g. 'ParentType.fieldName' */ + coordinate: Scalars['String']; + id: Scalars['ID']; + /** Whether the coordinate being referred to is marked as deprecated */ + isDeprecated: Scalars['Boolean']; +}; + +export type SchemaCoordinateFilterInput = { + /** + * If true, only include deprecated coordinates. + * If false, filter out deprecated coordinates. + */ + deprecated: Maybe; +}; + +/** The result of computing the difference between two schemas, usually as part of schema checks. */ export type SchemaDiff = { __typename?: 'SchemaDiff'; /** - * Clients affected by all changes in diff + * Clients affected by all changes in the diff. * @deprecated Unsupported. */ affectedClients: Maybe>; - /** Operations affected by all changes in diff */ + /** Operations affected by all changes in the diff. */ affectedQueries: Maybe>; - /** Summary/counts for all changes in diff */ + /** Numeric summaries for each type of change in the diff. */ changeSummary: ChangeSummary; - /** List of schema changes with associated affected clients and operations */ + /** A list of all schema changes in the diff, including their severity. */ changes: Array; - /** Number of affected query operations that are neither marked as SAFE or IGNORED */ + /** The number of GraphQL operations affected by the diff's changes that are neither marked as safe nor ignored. */ numberOfAffectedOperations: Scalars['Int']; - /** Number of operations that were validated during schema diff */ + /** The number of GraphQL operations that were validated during the check. */ numberOfCheckedOperations: Maybe; - /** Indication of the success of the change, either failure, warning, or notice. */ + /** Indicates the overall safety of the changes included in the diff, based on operation history (e.g., `FAILURE` or `NOTICE`). */ severity: ChangeSeverity; /** The tag against which this diff was created */ tag: Maybe; @@ -4511,6 +10543,8 @@ export type SchemaDiffValidationConfig = { __typename?: 'SchemaDiffValidationConfig'; /** Clients to ignore during validation. */ excludedClients: Maybe>; + /** Operation names to ignore during validation. */ + excludedOperationNames: Maybe>>; /** * delta in seconds from current time that determines the start of the window * for reported metrics included in a schema diff. A day window from the present @@ -4540,6 +10574,14 @@ export type SchemaDiffValidationConfig = { to: Maybe; }; +export type SchemaHashInput = { + /** If provided fetches build messages that are added to linter results. */ + buildID: Maybe; + /** SHA256 of the schema sdl. */ + hash: Scalars['String']; + subgraphs: Maybe>; +}; + export type SchemaPublishSubscription = ChannelSubscription & { __typename?: 'SchemaPublishSubscription'; channels: Array; @@ -4569,11 +10611,13 @@ export type SchemaReport = { userVersion: Maybe; }; +/** Contains details for an individual publication of an individual graph variant. */ export type SchemaTag = { __typename?: 'SchemaTag'; - /** The composition result that corresponds to this schema repo tag, if it exists. */ + /** The result of federated composition executed for this publication. This result includes either a supergraph schema or error details, depending on whether composition succeeded. This value is null when the publication is for a non-federated graph. */ compositionResult: Maybe; createdAt: Scalars['Timestamp']; + /** A schema diff comparing against the schema from the most recent previous successful publication. */ diffToPrevious: Maybe; gitContext: Maybe; /** @@ -4594,53 +10638,71 @@ export type SchemaTag = { * in the tag history. */ historyOrder: Scalars['Int']; - /** - * The identifier for this particular schema tag, which may be either a particular - * run of a check or a specific publish. This ID can be used alongside `schemaTagByID` - * in order to look up a particular entry. - */ + /** The identifier for this specific publication. */ id: Scalars['ID']; /** - * Indicates this schema is "published" meaning that our users correspond this schema - * with a long-running or permanent initiative. Published schemas appear in the UI - * when exploring a service's schemas, and typically refer to either active environments - * with metrics (e.g. "staging") or git branches that are constantly used as a base - * (e.g. "main"). If this field is not found, the schema is "private" to Engine - * and is uploaded but not promoted to published yet. The other benefit is this makes - * for nice UX around publishing events + * The launch for this publication. This value is non-null for contract variants, and sometimes null + * for composition variants (specifically for older publications). This value is null for other + * variants. */ + launch: Maybe; + /** The timestamp when the variant was published to. */ publishedAt: Scalars['Timestamp']; /** * The Identity that published this schema and their client info, or null if this isn't * a publish. Sub-fields may be null if they weren't recorded. */ publishedBy: Maybe; - /** - * Indicates the schemaTag of the schema's original upload, null if this is the - * first upload of the schema. - */ - reversionFrom: Maybe; + /** The schema that was published to the variant. */ schema: Schema; slackNotificationBody: Maybe; /** @deprecated Please use variant { name } instead */ tag: Scalars['String']; - /** The graph variant this schema tag belongs to. */ + /** The variant that was published to." */ variant: GraphVariant; webhookNotificationBody: Scalars['String']; }; +/** Contains details for an individual publication of an individual graph variant. */ export type SchemaTagHistoryArgs = { includeUnchanged?: Scalars['Boolean']; limit?: Scalars['Int']; offset?: Maybe; + orderBy?: Maybe; }; +/** Contains details for an individual publication of an individual graph variant. */ +export type SchemaTagHistoryLengthArgs = { + includeUnchanged?: Scalars['Boolean']; +}; + + +/** Contains details for an individual publication of an individual graph variant. */ export type SchemaTagSlackNotificationBodyArgs = { graphDisplayName: Scalars['String']; }; +export enum SchemaTagHistoryOrder { + CreatedAsc = 'CREATED_ASC', + CreatedDesc = 'CREATED_DESC' +} + +/** An error that occurs when an invalid schema is passed in as user input */ +export type SchemaValidationError = Error & { + __typename?: 'SchemaValidationError'; + issues: Array; + /** The error's details. */ + message: Scalars['String']; +}; + +/** An error that occurs when an invalid schema is passed in as user input */ +export type SchemaValidationIssue = { + __typename?: 'SchemaValidationIssue'; + message: Scalars['String']; +}; + /** How many seats of the given types does an organization have (regardless of plan type)? */ export type Seats = { __typename?: 'Seats'; @@ -4650,6 +10712,29 @@ export type Seats = { fullPrice: Scalars['Int']; }; +/** Cloud Router secret */ +export type Secret = { + __typename?: 'Secret'; + /** When the secret was created */ + createdAt: Scalars['DateTime']; + /** Hash of the secret */ + hash: Scalars['String']; + /** Name of the secret */ + name: Scalars['String']; +}; + +/** Input for creating or updating secrets */ +export type SecretInput = { + /** Name of the secret */ + name: Scalars['String']; + /** + * Value for that secret + * + * This can only be used for input, as it is not possible to retrieve the value of secrets. + */ + value: Scalars['String']; +}; + export type SemanticChange = { __typename?: 'SemanticChange'; /** Target arg of change made. */ @@ -4665,11 +10750,19 @@ export type SemanticChange = { parentNode: Maybe; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type Service = Identity & { __typename?: 'Service'; + /** The organization that this graph belongs to. */ account: Maybe; accountId: Maybe; + /** A list of the graph API keys that are active for this graph. */ apiKeys: Maybe>; + /** Provides a view of the graph as an `Actor` type. */ asActor: Actor; /** * Get an URL to which an avatar image can be uploaded. Client uploads by sending a PUT request @@ -4692,6 +10785,8 @@ export type Service = Identity & { checkConfiguration: Maybe; /** Get a check workflow for this graph by its ID */ checkWorkflow: Maybe; + /** Get a check workflow task for this graph by its ID */ + checkWorkflowTask: Maybe; /** Get check workflows for this graph ordered by creation time, most recent first. */ checkWorkflows: Array; /** @@ -4709,47 +10804,79 @@ export type Service = Identity & { * If a filter is passed, constrains results to match the filter. */ checksSubgraphOptions: Array; + /** Get a composition build check result for this graph by its ID */ + compositionBuildCheckResult: Maybe; /** Given a graphCompositionID, return the results of composition. This can represent either a validation or a publish. */ compositionResultById: Maybe; createdAt: Scalars['Timestamp']; createdBy: Maybe; datadogMetricsConfig: Maybe; + defaultBuildPipelineTrack: Maybe; + /** The time the default build pipeline track version was updated. */ + defaultBuildPipelineTrackUpdatedAt: Maybe; + defaultProposalReviewers: Array>; deletedAt: Maybe; description: Maybe; + /** @deprecated No longer supported */ devGraphOwner: Maybe; - /** Get a graphql by hash */ - document: Maybe; + /** Get a GraphQL document by hash */ + doc: Maybe; + /** + * Get a GraphQL document by hash + * @deprecated Use doc instead + */ + document: Maybe; + flatDiff: FlatDiffResult; + /** The capabilities that are supported for this graph */ + graphCapabilities: GraphCapabilities; + graphType: GraphType; /** * When this is true, this graph will be hidden from non-admin members of the org who haven't been explicitly assigned a * role on this graph. */ hiddenFromUninvitedNonAdminAccountMembers: Scalars['Boolean']; + /** The graph's globally unique identifier. */ id: Scalars['ID']; + /** List of ignored rule violations for the linter */ + ignoredLinterViolations: Array; /** - * List of implementing services that comprise a graph. A non-federated graph should have a single implementing service. - * Set includeDeleted to see deleted implementing services. + * List of subgraphs that comprise a graph. A non-federated graph should have a single implementing service. + * Set includeDeleted to see deleted subgraphs. */ implementingServices: Maybe; lastReportedAt: Maybe; + /** Linter configuration for this graph. */ + linterConfiguration: GraphLinterConfiguration; /** Current identity, null if not authenticated. */ me: Maybe; - /** - * This returns the composition result that was most recently published to the graph. - * Only identities that canQuerySchemas and canQueryImplementingServices have access - * to this field - */ + minProposalApprovers: Scalars['Int']; + minProposalRoles: ProposalRoles; + /** The composition result that was most recently published to a graph variant. */ mostRecentCompositionPublish: Maybe; + /** Permissions of the current user in this graph. */ myRole: Maybe; - /** @deprecated Use Service.title */ name: Scalars['String']; + onboardingArchitecture: Maybe; operation: Maybe; + /** Get request counts by variant for operation checks */ + operationCheckRequestsByVariant: Array; /** Gets the operations and their approved changes for this graph, checkID, and operationID. */ operationsAcceptedChanges: Array; /** Get an operations check result for a specific check ID */ operationsCheck: Maybe; + /** The Persisted Query List associated with this graph with the given ID. */ + persistedQueryList: Maybe; + persistedQueryLists: Maybe>; + /** + * A list of the proposal variants for this graph sorted by created at date. + * limit defaults to Int.MAX_VALUE, offset defaults to 0 + */ + proposalVariants: ProposalVariantsResult; /** Get query triggers for a given variant. If variant is null all the triggers for this service will be gotten. */ queryTriggers: Maybe>; readme: Maybe; + /** Registry specific stats for this graph. */ + registryStatsWindow: Maybe; /** * Whether registry subscriptions (with any options) are enabled. If variant is not passed, returns true if configuration is present for any variant * @deprecated This field will be removed @@ -4758,12 +10885,12 @@ export type Service = Identity & { reportingEnabled: Scalars['Boolean']; /** The list of members that can access this graph, accounting for graph role overrides */ roleOverrides: Maybe>; - /** Which permissions the current user has for interacting with this service */ + /** Describes the permissions that the active user has for this graph. */ roles: Maybe; scheduledSummaries: Array; - /** Get a schema by hash OR current tag */ + /** Get a schema by hash or current tag */ schema: Maybe; - /** Get the schema tag */ + /** The current publish associated to a given variant (with 'tag' as the variant name). */ schemaTag: Maybe; schemaTagById: Maybe; /** @@ -4776,126 +10903,327 @@ export type Service = Identity & { statsWindow: Maybe; /** Generate a test schema publish notification body */ testSchemaPublishBody: Scalars['String']; + /** The graph's name. */ title: Scalars['String']; trace: Maybe; traceStorageEnabled: Scalars['Boolean']; - /** A particular variant (sometimes called "tag") of the graph, often representing a live traffic environment (such as "prod"). Each variant can represent a specific URL or destination to query at, analytics, and its own schema history. */ + /** + * Provides details of the graph variant with the provided `name`, if a variant + * with that name exists for this graph. Otherwise, returns null. + * + * For a list of _all_ variants associated with a graph, use `Graph.variants` instead. + */ variant: Maybe; - /** The list of variants that exist for this graph */ + /** A list of the variants for this graph. */ variants: Array; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceAvatarUrlArgs = { size?: Scalars['Int']; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceChannelsArgs = { channelIds: Maybe>; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceCheckWorkflowArgs = { id: Scalars['ID']; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ +export type ServiceCheckWorkflowTaskArgs = { + id: Scalars['ID']; +}; + + +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceCheckWorkflowsArgs = { filter: Maybe; limit?: Scalars['Int']; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceChecksAuthorOptionsArgs = { filter: Maybe; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceChecksBranchOptionsArgs = { filter: Maybe; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceChecksSubgraphOptionsArgs = { filter: Maybe; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ +export type ServiceCompositionBuildCheckResultArgs = { + id: Scalars['ID']; +}; + + +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceCompositionResultByIdArgs = { id: Scalars['ID']; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ +export type ServiceDocArgs = { + hash: Maybe; +}; + + +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceDocumentArgs = { hash: Maybe; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ +export type ServiceFlatDiffArgs = { + newSdlHash: Maybe; + oldSdlHash: Maybe; +}; + + +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceImplementingServicesArgs = { graphVariant: Scalars['String']; includeDeleted: Maybe; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceLastReportedAtArgs = { graphVariant: Maybe; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceMostRecentCompositionPublishArgs = { graphVariant: Scalars['String']; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceOperationArgs = { id: Scalars['ID']; }; -export type ServiceOperationsAcceptedChangesArgs = { - checkID: Scalars['ID']; - operationID: Scalars['String']; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ +export type ServiceOperationCheckRequestsByVariantArgs = { + from: Scalars['Timestamp']; +}; + + +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ +export type ServiceOperationsAcceptedChangesArgs = { + checkID: Scalars['ID']; + operationID: Scalars['String']; +}; + + +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ +export type ServiceOperationsCheckArgs = { + checkID: Scalars['ID']; +}; + + +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ +export type ServicePersistedQueryListArgs = { + id: Scalars['ID']; }; -export type ServiceOperationsCheckArgs = { - checkID: Scalars['ID']; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ +export type ServiceProposalVariantsArgs = { + filterBy: Maybe; + limit: Maybe; + offset: Maybe; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceQueryTriggersArgs = { graphVariant: Maybe; operationNames: Maybe>; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ +export type ServiceRegistryStatsWindowArgs = { + from: Scalars['Timestamp']; + resolution: Maybe; + to: Maybe; +}; + + +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceRegistrySubscriptionsEnabledArgs = { graphVariant: Maybe; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceSchemaArgs = { hash: Maybe; tag: Maybe; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceSchemaTagArgs = { tag: Scalars['String']; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceSchemaTagByIdArgs = { id: Scalars['ID']; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceSchemaTagsArgs = { tags: Maybe>; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceStatsArgs = { from: Scalars['Timestamp']; resolution: Maybe; @@ -4903,6 +11231,11 @@ export type ServiceStatsArgs = { }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceStatsWindowArgs = { from: Scalars['Timestamp']; resolution: Maybe; @@ -4910,20 +11243,113 @@ export type ServiceStatsWindowArgs = { }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceTestSchemaPublishBodyArgs = { variant: Scalars['String']; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceTraceArgs = { id: Scalars['ID']; }; +/** + * A graph in Apollo Studio represents a graph in your organization. + * Each graph has one or more variants, which correspond to the different environments where that graph runs (such as staging and production). + * Each variant has its own GraphQL schema, which means schemas can differ between environments. + */ export type ServiceVariantArgs = { name: Scalars['String']; }; +/** Columns of ServiceBillingUsageStats. */ +export enum ServiceBillingUsageStatsColumn { + AgentVersion = 'AGENT_VERSION', + GraphDeploymentType = 'GRAPH_DEPLOYMENT_TYPE', + OperationCount = 'OPERATION_COUNT', + OperationCountProvidedExplicitly = 'OPERATION_COUNT_PROVIDED_EXPLICITLY', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', + SchemaTag = 'SCHEMA_TAG', + Timestamp = 'TIMESTAMP' +} + +export type ServiceBillingUsageStatsDimensions = { + __typename?: 'ServiceBillingUsageStatsDimensions'; + agentVersion: Maybe; + graphDeploymentType: Maybe; + operationCountProvidedExplicitly: Maybe; + operationSubtype: Maybe; + operationType: Maybe; + schemaTag: Maybe; +}; + +/** Filter for data in ServiceBillingUsageStats. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ +export type ServiceBillingUsageStatsFilter = { + /** Selects rows whose agentVersion dimension equals the given value if not null. To query for the null value, use {in: {agentVersion: [null]}} instead. */ + agentVersion: Maybe; + and: Maybe>; + /** Selects rows whose graphDeploymentType dimension equals the given value if not null. To query for the null value, use {in: {graphDeploymentType: [null]}} instead. */ + graphDeploymentType: Maybe; + in: Maybe; + not: Maybe; + /** Selects rows whose operationCountProvidedExplicitly dimension equals the given value if not null. To query for the null value, use {in: {operationCountProvidedExplicitly: [null]}} instead. */ + operationCountProvidedExplicitly: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; + or: Maybe>; + /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ + schemaTag: Maybe; +}; + +/** Filter for data in ServiceBillingUsageStats. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ +export type ServiceBillingUsageStatsFilterIn = { + /** Selects rows whose agentVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ + agentVersion: Maybe>>; + /** Selects rows whose graphDeploymentType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + graphDeploymentType: Maybe>>; + /** Selects rows whose operationCountProvidedExplicitly dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationCountProvidedExplicitly: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; + /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ + schemaTag: Maybe>>; +}; + +export type ServiceBillingUsageStatsMetrics = { + __typename?: 'ServiceBillingUsageStatsMetrics'; + operationCount: Scalars['Long']; +}; + +export type ServiceBillingUsageStatsOrderBySpec = { + column: ServiceBillingUsageStatsColumn; + direction: Ordering; +}; + +export type ServiceBillingUsageStatsRecord = { + __typename?: 'ServiceBillingUsageStatsRecord'; + /** Dimensions of ServiceBillingUsageStats that can be grouped by. */ + groupBy: ServiceBillingUsageStatsDimensions; + /** Metrics of ServiceBillingUsageStats that can be aggregated over. */ + metrics: ServiceBillingUsageStatsMetrics; + /** Starting segment timestamp. */ + timestamp: Scalars['Timestamp']; +}; + /** Columns of ServiceEdgeServerInfos. */ export enum ServiceEdgeServerInfosColumn { BootId = 'BOOT_ID', @@ -5092,9 +11518,76 @@ export type ServiceErrorStatsRecord = { timestamp: Scalars['Timestamp']; }; +/** Columns of ServiceFieldExecutions. */ +export enum ServiceFieldExecutionsColumn { + ErrorsCount = 'ERRORS_COUNT', + EstimatedExecutionCount = 'ESTIMATED_EXECUTION_COUNT', + FieldName = 'FIELD_NAME', + ObservedExecutionCount = 'OBSERVED_EXECUTION_COUNT', + ParentType = 'PARENT_TYPE', + ReferencingOperationCount = 'REFERENCING_OPERATION_COUNT', + RequestsWithErrorsCount = 'REQUESTS_WITH_ERRORS_COUNT', + SchemaTag = 'SCHEMA_TAG', + Timestamp = 'TIMESTAMP' +} + +export type ServiceFieldExecutionsDimensions = { + __typename?: 'ServiceFieldExecutionsDimensions'; + fieldName: Maybe; + parentType: Maybe; + schemaTag: Maybe; +}; + +/** Filter for data in ServiceFieldExecutions. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ +export type ServiceFieldExecutionsFilter = { + and: Maybe>; + /** Selects rows whose fieldName dimension equals the given value if not null. To query for the null value, use {in: {fieldName: [null]}} instead. */ + fieldName: Maybe; + in: Maybe; + not: Maybe; + or: Maybe>; + /** Selects rows whose parentType dimension equals the given value if not null. To query for the null value, use {in: {parentType: [null]}} instead. */ + parentType: Maybe; + /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ + schemaTag: Maybe; +}; + +/** Filter for data in ServiceFieldExecutions. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ +export type ServiceFieldExecutionsFilterIn = { + /** Selects rows whose fieldName dimension is in the given list. A null value in the list means a row with null for that dimension. */ + fieldName: Maybe>>; + /** Selects rows whose parentType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + parentType: Maybe>>; + /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ + schemaTag: Maybe>>; +}; + +export type ServiceFieldExecutionsMetrics = { + __typename?: 'ServiceFieldExecutionsMetrics'; + errorsCount: Scalars['Long']; + estimatedExecutionCount: Scalars['Long']; + observedExecutionCount: Scalars['Long']; + referencingOperationCount: Scalars['Long']; + requestsWithErrorsCount: Scalars['Long']; +}; + +export type ServiceFieldExecutionsOrderBySpec = { + column: ServiceFieldExecutionsColumn; + direction: Ordering; +}; + +export type ServiceFieldExecutionsRecord = { + __typename?: 'ServiceFieldExecutionsRecord'; + /** Dimensions of ServiceFieldExecutions that can be grouped by. */ + groupBy: ServiceFieldExecutionsDimensions; + /** Metrics of ServiceFieldExecutions that can be aggregated over. */ + metrics: ServiceFieldExecutionsMetrics; + /** Starting segment timestamp. */ + timestamp: Scalars['Timestamp']; +}; + /** Columns of ServiceFieldLatencies. */ export enum ServiceFieldLatenciesColumn { - Field = 'FIELD', FieldHistogram = 'FIELD_HISTOGRAM', FieldName = 'FIELD_NAME', ParentType = 'PARENT_TYPE', @@ -5115,8 +11608,6 @@ export type ServiceFieldLatenciesDimensions = { /** Filter for data in ServiceFieldLatencies. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ export type ServiceFieldLatenciesFilter = { and: Maybe>; - /** Selects rows whose field dimension equals the given value if not null. To query for the null value, use {in: {field: [null]}} instead. */ - field: Maybe; /** Selects rows whose fieldName dimension equals the given value if not null. To query for the null value, use {in: {fieldName: [null]}} instead. */ fieldName: Maybe; in: Maybe; @@ -5132,8 +11623,6 @@ export type ServiceFieldLatenciesFilter = { /** Filter for data in ServiceFieldLatencies. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ export type ServiceFieldLatenciesFilterIn = { - /** Selects rows whose field dimension is in the given list. A null value in the list means a row with null for that dimension. */ - field: Maybe>>; /** Selects rows whose fieldName dimension is in the given list. A null value in the list means a row with null for that dimension. */ fieldName: Maybe>>; /** Selects rows whose parentType dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -5168,9 +11657,11 @@ export type ServiceFieldLatenciesRecord = { export enum ServiceFieldUsageColumn { ClientName = 'CLIENT_NAME', ClientVersion = 'CLIENT_VERSION', + EstimatedExecutionCount = 'ESTIMATED_EXECUTION_COUNT', ExecutionCount = 'EXECUTION_COUNT', - Field = 'FIELD', FieldName = 'FIELD_NAME', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', ParentType = 'PARENT_TYPE', QueryId = 'QUERY_ID', QueryName = 'QUERY_NAME', @@ -5184,8 +11675,9 @@ export type ServiceFieldUsageDimensions = { __typename?: 'ServiceFieldUsageDimensions'; clientName: Maybe; clientVersion: Maybe; - field: Maybe; fieldName: Maybe; + operationSubtype: Maybe; + operationType: Maybe; parentType: Maybe; queryId: Maybe; queryName: Maybe; @@ -5200,12 +11692,14 @@ export type ServiceFieldUsageFilter = { clientName: Maybe; /** Selects rows whose clientVersion dimension equals the given value if not null. To query for the null value, use {in: {clientVersion: [null]}} instead. */ clientVersion: Maybe; - /** Selects rows whose field dimension equals the given value if not null. To query for the null value, use {in: {field: [null]}} instead. */ - field: Maybe; /** Selects rows whose fieldName dimension equals the given value if not null. To query for the null value, use {in: {fieldName: [null]}} instead. */ fieldName: Maybe; in: Maybe; not: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; or: Maybe>; /** Selects rows whose parentType dimension equals the given value if not null. To query for the null value, use {in: {parentType: [null]}} instead. */ parentType: Maybe; @@ -5225,10 +11719,12 @@ export type ServiceFieldUsageFilterIn = { clientName: Maybe>>; /** Selects rows whose clientVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ clientVersion: Maybe>>; - /** Selects rows whose field dimension is in the given list. A null value in the list means a row with null for that dimension. */ - field: Maybe>>; /** Selects rows whose fieldName dimension is in the given list. A null value in the list means a row with null for that dimension. */ fieldName: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; /** Selects rows whose parentType dimension is in the given list. A null value in the list means a row with null for that dimension. */ parentType: Maybe>>; /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -5243,6 +11739,7 @@ export type ServiceFieldUsageFilterIn = { export type ServiceFieldUsageMetrics = { __typename?: 'ServiceFieldUsageMetrics'; + estimatedExecutionCount: Scalars['Long']; executionCount: Scalars['Long']; referencingOperationCount: Scalars['Long']; }; @@ -5262,28 +11759,107 @@ export type ServiceFieldUsageRecord = { timestamp: Scalars['Timestamp']; }; +/** Columns of ServiceGraphosCloudMetrics. */ +export enum ServiceGraphosCloudMetricsColumn { + AgentVersion = 'AGENT_VERSION', + ResponseSize = 'RESPONSE_SIZE', + ResponseSizeThrottled = 'RESPONSE_SIZE_THROTTLED', + RouterId = 'ROUTER_ID', + RouterOperations = 'ROUTER_OPERATIONS', + RouterOperationsThrottled = 'ROUTER_OPERATIONS_THROTTLED', + SchemaTag = 'SCHEMA_TAG', + SubgraphFetches = 'SUBGRAPH_FETCHES', + SubgraphFetchesThrottled = 'SUBGRAPH_FETCHES_THROTTLED', + Timestamp = 'TIMESTAMP' +} + +export type ServiceGraphosCloudMetricsDimensions = { + __typename?: 'ServiceGraphosCloudMetricsDimensions'; + agentVersion: Maybe; + routerId: Maybe; + schemaTag: Maybe; +}; + +/** Filter for data in ServiceGraphosCloudMetrics. Fields with dimension names represent equality checks. All fields are implicitly ANDed together. */ +export type ServiceGraphosCloudMetricsFilter = { + /** Selects rows whose agentVersion dimension equals the given value if not null. To query for the null value, use {in: {agentVersion: [null]}} instead. */ + agentVersion: Maybe; + and: Maybe>; + in: Maybe; + not: Maybe; + or: Maybe>; + /** Selects rows whose routerId dimension equals the given value if not null. To query for the null value, use {in: {routerId: [null]}} instead. */ + routerId: Maybe; + /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ + schemaTag: Maybe; +}; + +/** Filter for data in ServiceGraphosCloudMetrics. Fields match if the corresponding dimension's value is in the given list. All fields are implicitly ANDed together. */ +export type ServiceGraphosCloudMetricsFilterIn = { + /** Selects rows whose agentVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ + agentVersion: Maybe>>; + /** Selects rows whose routerId dimension is in the given list. A null value in the list means a row with null for that dimension. */ + routerId: Maybe>>; + /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ + schemaTag: Maybe>>; +}; + +export type ServiceGraphosCloudMetricsMetrics = { + __typename?: 'ServiceGraphosCloudMetricsMetrics'; + responseSize: Scalars['Long']; + responseSizeThrottled: Scalars['Long']; + routerOperations: Scalars['Long']; + routerOperationsThrottled: Scalars['Long']; + subgraphFetches: Scalars['Long']; + subgraphFetchesThrottled: Scalars['Long']; +}; + +export type ServiceGraphosCloudMetricsOrderBySpec = { + column: ServiceGraphosCloudMetricsColumn; + direction: Ordering; +}; + +export type ServiceGraphosCloudMetricsRecord = { + __typename?: 'ServiceGraphosCloudMetricsRecord'; + /** Dimensions of ServiceGraphosCloudMetrics that can be grouped by. */ + groupBy: ServiceGraphosCloudMetricsDimensions; + /** Metrics of ServiceGraphosCloudMetrics that can be aggregated over. */ + metrics: ServiceGraphosCloudMetricsMetrics; + /** Starting segment timestamp. */ + timestamp: Scalars['Timestamp']; +}; + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutation = { __typename?: 'ServiceMutation'; /** - * Compose an implementing service's partial schema, diff the composed schema, validate traffic against that schema, - * and store the result so the details can be viewed by users in the UI. - * This mutation will not mark the schema as "published". + * Checks a proposed subgraph schema change against a published subgraph. + * If the proposal composes successfully, perform a usage check for the resulting supergraph schema. + * @deprecated Use GraphVariant.submitSubgraphCheckAsync instead. + * This mutation polls to wait for the check to finish, + * while subgraphSubgraphCheckAsync triggers returns + * without waiting for the check to finish. */ checkPartialSchema: CheckPartialSchemaResult; /** * Checks a proposed schema against the schema that has been published to - * a particular tag, using metrics that have been published to the base tag. - * Callers can set the historicParameters directly, which will be used if - * provided. If useMaximumRetention is provided, but historicParameters is not, - * then validation will use the maximum retention the graph has access to. - * If neither historicParameters nor useMaximumRetention is provided, the - * default time range of one week (7 days) will be used. + * a particular variant, using metrics corresponding to `historicParameters`. + * Callers can set `historicParameters` directly or rely on defaults set in the + * graph's check configuration (7 days by default). + * If they do not set `historicParameters` but set `useMaximumRetention`, + * validation will use the maximum retention the graph has access to. */ checkSchema: CheckSchemaResult; /** Make changes to a check workflow. */ checkWorkflow: Maybe; createCompositionStatusSubscription: SchemaPublishSubscription; + createPersistedQueryList: CreatePersistedQueryListResultOrError; + createProposal: CreateProposalResult; + /** Creates a proposal variant from a source variant and a name, description. Do not call this from any clients, this resolver is exclusively for inter-service proposal -> kotlin registry communication. */ + createProposalVariant: ProposalVariantCreationResult; createSchemaPublishSubscription: SchemaPublishSubscription; + /** Update the default build pipeline track for this graph. */ + defaultBuildPipelineTrack: Maybe; /** Soft delete a graph. Data associated with the graph is not permanently deleted; Apollo support can undo. */ delete: Maybe; /** Delete the service's avatar. Requires Service.roles.canUpdateAvatar to be true. */ @@ -5300,6 +11876,7 @@ export type ServiceMutation = { */ deleteRegistrySubscriptions: Array; deleteScheduledSummary: Scalars['Boolean']; + /** Delete a variant by name. */ deleteSchemaTag: DeleteSchemaTagResult; /** Given a UTC timestamp, delete all traces associated with this Service, on that corresponding day. If a timestamp to is provided, deletes all days inclusive. */ deleteTraces: Maybe; @@ -5316,25 +11893,42 @@ export type ServiceMutation = { * false if it already was. */ ignoreOperationsInChecks: Maybe; + /** Lint a single schema using the graph's linter configuration. */ + lintSchema: LintResult; /** * Mark the changeset that affects an operation in a given check instance as safe. * Note that only operations marked as behavior changes are allowed to be marked as safe. */ markChangesForOperationAsSafe: MarkChangesForOperationAsSafeResult; + /** Generates a new graph API key for this graph with the specified permission level. */ newKey: GraphApiKey; + /** Mutation to set whether a proposals check task's results should be overridden or not */ + overrideProposalsCheckTask: Maybe; /** Adds an override to the given users permission for this graph */ overrideUserPermission: Maybe; - /** Returns a preview of the Core and API schema contracts derived from a source variant and a set of filter configurations */ - previewContractVariant: ContractVariantPreviewResult; + /** Provides access to mutation fields for modifying a Persisted Query List with the provided ID. */ + persistedQueryList: PersistedQueryListMutation; /** Promote the schema with the given SHA-256 hash to active for the given variant/tag. */ promoteSchema: PromoteSchemaResponseOrError; + /** Publish to a subgraph. If composition is successful, this will update running routers. */ + publishSubgraph: Maybe; + /** Publishes multiple subgraphs. If composition is successful, this will update running routers. */ + publishSubgraphs: Maybe; registerOperationsWithResponse: Maybe; + /** Removes a subgraph. If composition is successful, this will update running routers. */ removeImplementingServiceAndTriggerComposition: CompositionAndRemoveResult; + /** Deletes the existing graph API key with the provided ID, if any. */ removeKey: Maybe; + /** Sets a new name for the graph API key with the provided ID, if any. This does not invalidate the key or change its value. */ renameKey: Maybe; /** @deprecated use Mutation.reportSchema instead */ reportServerInfo: Maybe; service: Service; + setDefaultBuildPipelineTrack: Maybe; + setMinProposalApprovers: SetMinApproversResult; + /** The minimum role for create & edit is observer */ + setMinProposalRoles: SetProposalRolesResult; + setProposalDefaultReviewers: SetProposalDefaultReviewersResult; /** * Store a given schema document. This schema will be attached to the graph but * not be associated with any variant. On success, returns the schema hash. @@ -5344,7 +11938,6 @@ export type ServiceMutation = { testSlackChannel: Maybe; testSubscriptionForChannel: Scalars['String']; transfer: Maybe; - triggerRepublish: Maybe; undelete: Maybe; /** * Revert the effects of ignoreOperation. @@ -5360,12 +11953,18 @@ export type ServiceMutation = { updateDescription: Maybe; /** Update hiddenFromUninvitedNonAdminAccountMembers */ updateHiddenFromUninvitedNonAdminAccountMembers: Maybe; + /** Update rule violations to ignore for this graph. */ + updateIgnoredRuleViolations: Array; + /** Update the linter configuration for this graph. */ + updateLinterConfiguration: GraphLinterConfiguration; updateReadme: Maybe; updateTitle: Maybe; + /** Publish a schema to this variant, either via a document or an introspection query result. */ uploadSchema: Maybe; upsertChannel: Maybe; /** Creates a contract schema from a source variant and a set of filter configurations */ upsertContractVariant: ContractVariantUpsertResult; + /** Publish to a subgraph. If composition is successful, this will update running routers. */ upsertImplementingServiceAndTriggerComposition: Maybe; /** Create/update PagerDuty notification channel */ upsertPagerDutyChannel: Maybe; @@ -5383,6 +11982,7 @@ export type ServiceMutation = { * in the mutation's input. Store the composed schema, return the hash of the composed schema, * and any warnings and errors pertaining to composition. * This mutation will not run validation against operations. + * @deprecated Use GraphVariant.submitSubgraphCheckAsync instead */ validatePartialSchemaOfImplementingServiceAgainstGraph: CompositionValidationResult; /** Make changes to a graph variant. */ @@ -5390,22 +11990,31 @@ export type ServiceMutation = { }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationCheckPartialSchemaArgs = { frontend: Maybe; gitContext: Maybe; graphVariant: Scalars['String']; historicParameters: Maybe; implementingServiceName: Scalars['String']; + introspectionEndpoint: Maybe; + isProposalCheck?: Scalars['Boolean']; + isSandboxCheck?: Scalars['Boolean']; partialSchema: PartialSchemaInput; + triggeredBy: Maybe; useMaximumRetention: Maybe; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationCheckSchemaArgs = { baseSchemaTag?: Maybe; frontend: Maybe; gitContext: Maybe; historicParameters: Maybe; + introspectionEndpoint: Maybe; + isProposalCheck?: Scalars['Boolean']; + isSandboxCheck?: Scalars['Boolean']; proposedSchema: Maybe; proposedSchemaDocument: Maybe; proposedSchemaHash: Maybe; @@ -5413,88 +12022,145 @@ export type ServiceMutationCheckSchemaArgs = { }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationCheckWorkflowArgs = { id: Scalars['ID']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationCreateCompositionStatusSubscriptionArgs = { channelID: Scalars['ID']; variant: Scalars['String']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationCreatePersistedQueryListArgs = { + description: Maybe; + linkedVariants: Maybe>; + name: Scalars['String']; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationCreateProposalArgs = { + input: CreateProposalInput; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationCreateProposalVariantArgs = { + description: Maybe; + sourceVariantName: Scalars['ID']; + triggeredBy: Maybe; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationCreateSchemaPublishSubscriptionArgs = { channelID: Scalars['ID']; variant: Scalars['String']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationDefaultBuildPipelineTrackArgs = { + buildPipelineTrack: BuildPipelineTrack; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationDeleteChannelArgs = { id: Scalars['ID']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationDeleteQueryTriggerArgs = { id: Scalars['ID']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationDeleteRegistrySubscriptionArgs = { id: Scalars['ID']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationDeleteRegistrySubscriptionsArgs = { variant: Scalars['String']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationDeleteScheduledSummaryArgs = { id: Scalars['ID']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationDeleteSchemaTagArgs = { tag: Scalars['String']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationDeleteTracesArgs = { from: Scalars['Timestamp']; to: Maybe; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationIgnoreOperationsInChecksArgs = { ids: Array; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationLintSchemaArgs = { + baseSdl: Maybe; + sdl: Scalars['String']; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationMarkChangesForOperationAsSafeArgs = { checkID: Scalars['ID']; operationID: Scalars['ID']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationNewKeyArgs = { keyName: Maybe; role?: UserPermission; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationOverrideProposalsCheckTaskArgs = { + shouldOverride: Scalars['Boolean']; + taskId: Scalars['ID']; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationOverrideUserPermissionArgs = { permission: Maybe; userID: Scalars['ID']; }; -export type ServiceMutationPreviewContractVariantArgs = { - filterConfig: FilterConfigInput; - sourceVariant: Scalars['String']; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationPersistedQueryListArgs = { + id: Scalars['ID']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationPromoteSchemaArgs = { graphVariant: Scalars['String']; historicParameters: Maybe; @@ -5503,6 +12169,27 @@ export type ServiceMutationPromoteSchemaArgs = { }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationPublishSubgraphArgs = { + activePartialSchema: PartialSchemaInput; + gitContext: Maybe; + graphVariant: Scalars['String']; + name: Scalars['String']; + revision: Scalars['String']; + url: Maybe; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationPublishSubgraphsArgs = { + gitContext: Maybe; + graphVariant: Scalars['String']; + revision: Scalars['String']; + subgraphInputs: Array; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationRegisterOperationsWithResponseArgs = { clientIdentity: Maybe; gitContext: Maybe; @@ -5512,6 +12199,7 @@ export type ServiceMutationRegisterOperationsWithResponseArgs = { }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationRemoveImplementingServiceAndTriggerCompositionArgs = { dryRun?: Scalars['Boolean']; graphVariant: Scalars['String']; @@ -5519,72 +12207,105 @@ export type ServiceMutationRemoveImplementingServiceAndTriggerCompositionArgs = }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationRemoveKeyArgs = { - id: Maybe; + id: Scalars['ID']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationRenameKeyArgs = { id: Scalars['ID']; newKeyName: Maybe; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationReportServerInfoArgs = { executableSchema: Maybe; info: EdgeServerInfo; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationSetDefaultBuildPipelineTrackArgs = { + version: Scalars['String']; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationSetMinProposalApproversArgs = { + input: SetMinProposalApproversInput; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationSetMinProposalRolesArgs = { + input: SetProposalRolesInput; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationSetProposalDefaultReviewersArgs = { + input: SetProposalDefaultReviewersInput; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationStoreSchemaDocumentArgs = { schemaDocument: Scalars['String']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationTestSlackChannelArgs = { id: Scalars['ID']; notification: SlackNotificationInput; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationTestSubscriptionForChannelArgs = { channelID: Scalars['ID']; subscriptionID: Scalars['ID']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationTransferArgs = { to: Scalars['String']; }; -export type ServiceMutationTriggerRepublishArgs = { - graphVariant: Scalars['String']; -}; - - +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUnignoreOperationsInChecksArgs = { ids: Array; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUnmarkChangesForOperationAsSafeArgs = { checkID: Scalars['ID']; operationID: Scalars['ID']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpdateCheckConfigurationArgs = { + enableLintChecks: Maybe; excludedClients: Maybe>; + excludedOperationNames: Maybe>; excludedOperations: Maybe>; includeBaseVariant: Maybe; includedVariants: Maybe>; operationCountThreshold: Maybe; operationCountThresholdPercentage: Maybe; + proposalChangeMismatchSeverity: Maybe; timeRangeSeconds: Maybe; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpdateDatadogMetricsConfigArgs = { apiKey: Maybe; apiRegion: Maybe; @@ -5592,26 +12313,43 @@ export type ServiceMutationUpdateDatadogMetricsConfigArgs = { }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpdateDescriptionArgs = { description: Scalars['String']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpdateHiddenFromUninvitedNonAdminAccountMembersArgs = { hiddenFromUninvitedNonAdminAccountMembers: Scalars['Boolean']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationUpdateIgnoredRuleViolationsArgs = { + changes: LinterIgnoredRuleChangesInput; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ +export type ServiceMutationUpdateLinterConfigurationArgs = { + changes: GraphLinterConfigurationChangesInput; +}; + + +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpdateReadmeArgs = { readme: Scalars['String']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpdateTitleArgs = { title: Scalars['String']; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUploadSchemaArgs = { errorOnBadRequest?: Scalars['Boolean']; gitContext: Maybe; @@ -5623,6 +12361,7 @@ export type ServiceMutationUploadSchemaArgs = { }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpsertChannelArgs = { id: Maybe; pagerDutyChannel: Maybe; @@ -5631,14 +12370,16 @@ export type ServiceMutationUpsertChannelArgs = { }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpsertContractVariantArgs = { contractVariantName: Scalars['String']; filterConfig: FilterConfigInput; initiateLaunch?: Scalars['Boolean']; - sourceVariant: Scalars['String']; + sourceVariant: Maybe; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpsertImplementingServiceAndTriggerCompositionArgs = { activePartialSchema: PartialSchemaInput; gitContext: Maybe; @@ -5649,18 +12390,21 @@ export type ServiceMutationUpsertImplementingServiceAndTriggerCompositionArgs = }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpsertPagerDutyChannelArgs = { channel: PagerDutyChannelInput; id: Maybe; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpsertQueryTriggerArgs = { id: Maybe; trigger: QueryTriggerInput; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpsertRegistrySubscriptionArgs = { channelID: Maybe; id: Maybe; @@ -5669,6 +12413,7 @@ export type ServiceMutationUpsertRegistrySubscriptionArgs = { }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpsertScheduledSummaryArgs = { channelID: Maybe; enabled: Maybe; @@ -5679,12 +12424,14 @@ export type ServiceMutationUpsertScheduledSummaryArgs = { }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpsertSlackChannelArgs = { channel: SlackChannelInput; id: Maybe; }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationUpsertWebhookChannelArgs = { id: Maybe; name: Maybe; @@ -5693,6 +12440,7 @@ export type ServiceMutationUpsertWebhookChannelArgs = { }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationValidateOperationsArgs = { gitContext: Maybe; operations: Array; @@ -5700,6 +12448,7 @@ export type ServiceMutationValidateOperationsArgs = { }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationValidatePartialSchemaOfImplementingServiceAgainstGraphArgs = { graphVariant: Scalars['String']; implementingServiceName: Scalars['String']; @@ -5707,6 +12456,7 @@ export type ServiceMutationValidatePartialSchemaOfImplementingServiceAgainstGrap }; +/** Provides access to mutation fields for managing Studio graphs and subgraphs. */ export type ServiceMutationVariantArgs = { name: Scalars['String']; }; @@ -5716,7 +12466,10 @@ export enum ServiceOperationCheckStatsColumn { CachedRequestsCount = 'CACHED_REQUESTS_COUNT', ClientName = 'CLIENT_NAME', ClientVersion = 'CLIENT_VERSION', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', QueryId = 'QUERY_ID', + QueryName = 'QUERY_NAME', SchemaTag = 'SCHEMA_TAG', Timestamp = 'TIMESTAMP', UncachedRequestsCount = 'UNCACHED_REQUESTS_COUNT' @@ -5726,7 +12479,10 @@ export type ServiceOperationCheckStatsDimensions = { __typename?: 'ServiceOperationCheckStatsDimensions'; clientName: Maybe; clientVersion: Maybe; + operationSubtype: Maybe; + operationType: Maybe; queryId: Maybe; + queryName: Maybe; schemaTag: Maybe; }; @@ -5739,9 +12495,15 @@ export type ServiceOperationCheckStatsFilter = { clientVersion: Maybe; in: Maybe; not: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; or: Maybe>; /** Selects rows whose queryId dimension equals the given value if not null. To query for the null value, use {in: {queryId: [null]}} instead. */ queryId: Maybe; + /** Selects rows whose queryName dimension equals the given value if not null. To query for the null value, use {in: {queryName: [null]}} instead. */ + queryName: Maybe; /** Selects rows whose schemaTag dimension equals the given value if not null. To query for the null value, use {in: {schemaTag: [null]}} instead. */ schemaTag: Maybe; }; @@ -5752,8 +12514,14 @@ export type ServiceOperationCheckStatsFilterIn = { clientName: Maybe>>; /** Selects rows whose clientVersion dimension is in the given list. A null value in the list means a row with null for that dimension. */ clientVersion: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ queryId: Maybe>>; + /** Selects rows whose queryName dimension is in the given list. A null value in the list means a row with null for that dimension. */ + queryName: Maybe>>; /** Selects rows whose schemaTag dimension is in the given list. A null value in the list means a row with null for that dimension. */ schemaTag: Maybe>>; }; @@ -5788,6 +12556,8 @@ export enum ServiceQueryStatsColumn { ClientVersion = 'CLIENT_VERSION', ForbiddenOperationCount = 'FORBIDDEN_OPERATION_COUNT', FromEngineproxy = 'FROM_ENGINEPROXY', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', QueryId = 'QUERY_ID', QueryName = 'QUERY_NAME', RegisteredOperationCount = 'REGISTERED_OPERATION_COUNT', @@ -5804,9 +12574,12 @@ export type ServiceQueryStatsDimensions = { clientName: Maybe; clientVersion: Maybe; fromEngineproxy: Maybe; + operationSubtype: Maybe; + operationType: Maybe; queryId: Maybe; queryName: Maybe; querySignature: Maybe; + querySignatureLength: Maybe; schemaHash: Maybe; schemaTag: Maybe; }; @@ -5822,6 +12595,10 @@ export type ServiceQueryStatsFilter = { fromEngineproxy: Maybe; in: Maybe; not: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; or: Maybe>; /** Selects rows whose queryId dimension equals the given value if not null. To query for the null value, use {in: {queryId: [null]}} instead. */ queryId: Maybe; @@ -5841,6 +12618,10 @@ export type ServiceQueryStatsFilterIn = { clientVersion: Maybe>>; /** Selects rows whose fromEngineproxy dimension is in the given list. A null value in the list means a row with null for that dimension. */ fromEngineproxy: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ queryId: Maybe>>; /** Selects rows whose queryName dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -5880,51 +12661,74 @@ export type ServiceQueryStatsRecord = { timestamp: Scalars['Timestamp']; }; -/** A map from role (permission) String to boolean that the current user is allowed for the root service */ +/** Individual permissions for the current user when interacting with a particular Studio graph. */ export type ServiceRoles = { __typename?: 'ServiceRoles'; + /** Whether the currently authenticated user is permitted to perform schema checks (i.e., run `rover (sub)graph check`). */ canCheckSchemas: Scalars['Boolean']; + canCreateProposal: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to create new graph variants. */ canCreateVariants: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to delete the graph in question */ canDelete: Scalars['Boolean']; + canEditProposal: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to manage user access to the graph in question. */ canManageAccess: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to manage the build configuration (e.g., build pipeline version). */ canManageBuildConfig: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to manage third-party integrations (e.g., Datadog forwarding). */ canManageIntegrations: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to manage graph-level API keys. */ canManageKeys: Scalars['Boolean']; + canManagePersistedQueryLists: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to manage proposal permission settings for this graph. */ + canManageProposalPermissions: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to manage proposal settings, like setting the implementation variant, on this graph. */ + canManageProposalSettings: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to perform basic administration of variants (e.g., make a variant public). */ canManageVariants: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to view details about the build configuration (e.g. build pipeline version). */ canQueryBuildConfig: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to view details of the check configuration for this graph. */ canQueryCheckConfiguration: Scalars['Boolean']; canQueryDeletedImplementingServices: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to view which subgraphs the graph is composed of. */ canQueryImplementingServices: Scalars['Boolean']; canQueryIntegrations: Scalars['Boolean']; + canQueryPersistedQueryLists: Scalars['Boolean']; canQueryPrivateInfo: Scalars['Boolean']; + canQueryProposals: Scalars['Boolean']; canQueryPublicInfo: Scalars['Boolean']; canQueryReadmeAuthor: Scalars['Boolean']; canQueryRoleOverrides: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to download schemas owned by this graph. */ canQuerySchemas: Scalars['Boolean']; canQueryStats: Scalars['Boolean']; canQueryTokens: Scalars['Boolean']; canQueryTraces: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to register operations (i.e. `apollo client:push`) for this graph. */ canRegisterOperations: Scalars['Boolean']; canStoreSchemasWithoutVariant: Scalars['Boolean']; canUndelete: Scalars['Boolean']; canUpdateAvatar: Scalars['Boolean']; canUpdateDescription: Scalars['Boolean']; canUpdateTitle: Scalars['Boolean']; - /** @deprecated Replaced with canQueryTraces and canQueryStats */ - canVisualizeStats: Scalars['Boolean']; + /** Whether the currently authenticated user is permitted to make updates to the check configuration for this graph. */ canWriteCheckConfiguration: Scalars['Boolean']; - /** @deprecated Never worked, not replaced */ - canWriteTraces: Scalars['Boolean']; + service: Service; }; /** A time window with a specified granularity over a given service. */ export type ServiceStatsWindow = { __typename?: 'ServiceStatsWindow'; + billingUsageStats: Array; edgeServerInfos: Array; errorStats: Array; + fieldExecutions: Array; fieldLatencies: Array; fieldStats: Array; fieldUsage: Array; + graphosCloudMetrics: Array; operationCheckStats: Array; queryStats: Array; /** From field rounded down to the nearest resolution. */ @@ -5936,6 +12740,14 @@ export type ServiceStatsWindow = { }; +/** A time window with a specified granularity over a given service. */ +export type ServiceStatsWindowBillingUsageStatsArgs = { + filter: Maybe; + limit?: Maybe; + orderBy: Maybe>; +}; + + /** A time window with a specified granularity over a given service. */ export type ServiceStatsWindowEdgeServerInfosArgs = { filter: Maybe; @@ -5952,6 +12764,14 @@ export type ServiceStatsWindowErrorStatsArgs = { }; +/** A time window with a specified granularity over a given service. */ +export type ServiceStatsWindowFieldExecutionsArgs = { + filter: Maybe; + limit?: Maybe; + orderBy: Maybe>; +}; + + /** A time window with a specified granularity over a given service. */ export type ServiceStatsWindowFieldLatenciesArgs = { filter: Maybe; @@ -5976,6 +12796,14 @@ export type ServiceStatsWindowFieldUsageArgs = { }; +/** A time window with a specified granularity over a given service. */ +export type ServiceStatsWindowGraphosCloudMetricsArgs = { + filter: Maybe; + limit?: Maybe; + orderBy: Maybe>; +}; + + /** A time window with a specified granularity over a given service. */ export type ServiceStatsWindowOperationCheckStatsArgs = { filter: Maybe; @@ -6126,14 +12954,15 @@ export enum ServiceTraceRefsColumn { ClientName = 'CLIENT_NAME', ClientVersion = 'CLIENT_VERSION', DurationBucket = 'DURATION_BUCKET', - DurationNs = 'DURATION_NS', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', QueryId = 'QUERY_ID', QueryName = 'QUERY_NAME', SchemaHash = 'SCHEMA_HASH', SchemaTag = 'SCHEMA_TAG', Timestamp = 'TIMESTAMP', - TraceId = 'TRACE_ID', - TraceSizeBytes = 'TRACE_SIZE_BYTES' + TraceCount = 'TRACE_COUNT', + TraceId = 'TRACE_ID' } export type ServiceTraceRefsDimensions = { @@ -6141,6 +12970,9 @@ export type ServiceTraceRefsDimensions = { clientName: Maybe; clientVersion: Maybe; durationBucket: Maybe; + generatedTraceId: Maybe; + operationSubtype: Maybe; + operationType: Maybe; queryId: Maybe; queryName: Maybe; querySignature: Maybe; @@ -6160,6 +12992,10 @@ export type ServiceTraceRefsFilter = { durationBucket: Maybe; in: Maybe; not: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; or: Maybe>; /** Selects rows whose queryId dimension equals the given value if not null. To query for the null value, use {in: {queryId: [null]}} instead. */ queryId: Maybe; @@ -6181,6 +13017,10 @@ export type ServiceTraceRefsFilterIn = { clientVersion: Maybe>>; /** Selects rows whose durationBucket dimension is in the given list. A null value in the list means a row with null for that dimension. */ durationBucket: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ queryId: Maybe>>; /** Selects rows whose queryName dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -6195,8 +13035,7 @@ export type ServiceTraceRefsFilterIn = { export type ServiceTraceRefsMetrics = { __typename?: 'ServiceTraceRefsMetrics'; - durationNs: Scalars['Long']; - traceSizeBytes: Scalars['Long']; + traceCount: Scalars['Long']; }; export type ServiceTraceRefsOrderBySpec = { @@ -6214,6 +13053,104 @@ export type ServiceTraceRefsRecord = { timestamp: Scalars['Timestamp']; }; +export type SetMinApproversResult = PermissionError | Service | ValidationError; + +export type SetMinProposalApproversInput = { + minApprovers: Maybe; +}; + +/** Represents the possible outcomes of a setNextVersion mutation */ +export type SetNextVersionResult = InternalServerError | InvalidInputErrors | RouterVersion; + +export type SetProposalDefaultReviewersInput = { + reviewerUserIds: Array; +}; + +export type SetProposalDefaultReviewersResult = PermissionError | Service | ValidationError; + +export type SetProposalRolesInput = { + create: Maybe; + edit: Maybe; +}; + +export type SetProposalRolesResult = PermissionError | Service | ValidationError; + +export type SetRequestedReviewersInput = { + reviewerUserIds: Array; +}; + +export type SetRequestedReviewersResult = PermissionError | Proposal | ValidationError; + +export type SetupIntentResult = NotFoundError | PermissionError | SetupIntentSuccess; + +export type SetupIntentSuccess = { + __typename?: 'SetupIntentSuccess'; + clientSecret: Scalars['String']; +}; + +/** + * Shard for Cloud Routers + * + * This represents a specific shard where a Cloud Router can run + */ +export type Shard = { + __typename?: 'Shard'; + gcuCapacity: Maybe; + gcuUsage: Scalars['Int']; + id: Scalars['ID']; + provider: CloudProvider; + /** Details of this shard for a specific provider */ + providerDetails: ShardProvider; + region: RegionDescription; + routerCapacity: Maybe; + routerUsage: Scalars['Int']; + routers: Array; + tier: CloudTier; +}; + + +/** + * Shard for Cloud Routers + * + * This represents a specific shard where a Cloud Router can run + */ +export type ShardRoutersArgs = { + first: Maybe; + offset: Maybe; +}; + +/** Provider-specific information for a Shard */ +export type ShardProvider = AwsShard | FlyShard; + +/** Represents the possible outcomes of a shard mutation */ +export type ShardResult = InternalServerError | InvalidInputErrors | ShardSuccess; + +/** Current status of [`Shard`]s */ +export enum ShardStatus { + /** The Shard is active and ready to accept new Cloud Routers */ + Active = 'ACTIVE', + /** The Shard no long exists */ + Deleted = 'DELETED', + /** The Shard is working as expected, but should not be used to provision new Cloud Routers */ + Deprecated = 'DEPRECATED', + /** + * The Shard is suffering from a temporary degradation that might impact provisioning new + * Cloud Routers + */ + Impaired = 'IMPAIRED', + /** + * The Shard is currently being updated and should temporarily not be used to provision new + * Cloud Routers + */ + Updating = 'UPDATING' +} + +/** Success branch of an shard mutation */ +export type ShardSuccess = { + __typename?: 'ShardSuccess'; + shard: Shard; +}; + /** Slack notification channel */ export type SlackChannel = Channel & { __typename?: 'SlackChannel'; @@ -6229,6 +13166,19 @@ export type SlackChannelInput = { url: Scalars['String']; }; +export type SlackCommunicationChannel = CommunicationChannel & { + __typename?: 'SlackCommunicationChannel'; + id: Scalars['ID']; + name: Scalars['String']; + purpose: Maybe; + topic: Maybe; +}; + +export type SlackMessageMeta = { + __typename?: 'SlackMessageMeta'; + id: Scalars['ID']; +}; + export type SlackNotificationField = { key: Scalars['String']; value: Scalars['String']; @@ -6247,19 +13197,46 @@ export type SlackNotificationInput = { username: Maybe; }; +export enum SlackPublishState { + Errored = 'errored', + Published = 'published', + Recalled = 'recalled' +} + +/** A location in a source code file. */ export type SourceLocation = { __typename?: 'SourceLocation'; + /** Column number. */ column: Scalars['Int']; + /** Line number. */ line: Scalars['Int']; }; +export type StartUsageBasedPlanResult = Account | NotFoundError | PermissionError | StartUsageBasedPlanSuccess | ValidationError; + +export type StartUsageBasedPlanSuccess = { + __typename?: 'StartUsageBasedPlanSuccess'; + customerPlanId: Scalars['String']; +}; + +export enum State { + Approved = 'approved', + Denied = 'denied', + Errored = 'errored', + Pending = 'pending', + Published = 'published' +} + /** A time window with a specified granularity. */ export type StatsWindow = { __typename?: 'StatsWindow'; + billingUsageStats: Array; edgeServerInfos: Array; errorStats: Array; + fieldExecutions: Array; fieldLatencies: Array; fieldUsage: Array; + graphosCloudMetrics: Array; operationCheckStats: Array; queryStats: Array; /** From field rounded down to the nearest resolution. */ @@ -6271,6 +13248,14 @@ export type StatsWindow = { }; +/** A time window with a specified granularity. */ +export type StatsWindowBillingUsageStatsArgs = { + filter: Maybe; + limit?: Maybe; + orderBy: Maybe>; +}; + + /** A time window with a specified granularity. */ export type StatsWindowEdgeServerInfosArgs = { filter: Maybe; @@ -6287,6 +13272,14 @@ export type StatsWindowErrorStatsArgs = { }; +/** A time window with a specified granularity. */ +export type StatsWindowFieldExecutionsArgs = { + filter: Maybe; + limit?: Maybe; + orderBy: Maybe>; +}; + + /** A time window with a specified granularity. */ export type StatsWindowFieldLatenciesArgs = { filter: Maybe; @@ -6303,6 +13296,14 @@ export type StatsWindowFieldUsageArgs = { }; +/** A time window with a specified granularity. */ +export type StatsWindowGraphosCloudMetricsArgs = { + filter: Maybe; + limit?: Maybe; + orderBy: Maybe>; +}; + + /** A time window with a specified granularity. */ export type StatsWindowOperationCheckStatsArgs = { filter: Maybe; @@ -6334,6 +13335,26 @@ export type StatsWindowTraceRefsArgs = { orderBy: Maybe>; }; +/** Possible status of a Cloud Router version */ +export enum Status { + /** + * Deprecated version of a Cloud Router + * + * New Cloud Routers should not use this version, and this will not be + * supported at some point in the future. + */ + Deprecated = 'DEPRECATED', + /** + * Upcoming or experimental version of a Cloud Router + * + * This should only be used internally, or to preview new features to + * customers. + */ + Next = 'NEXT', + /** Cloud Router Version is ready to be used by end users */ + Stable = 'STABLE' +} + export type StoreSchemaError = { __typename?: 'StoreSchemaError'; code: StoreSchemaErrorCode; @@ -6371,16 +13392,31 @@ export type StringToStringInput = { value: Scalars['String']; }; +/** A subgraph in a federated Studio supergraph. */ export type Subgraph = { __typename?: 'Subgraph'; + /** The subgraph schema document's SHA256 hash, represented as a hexadecimal string. */ hash: Scalars['String']; + /** The subgraph's registered name. */ name: Scalars['String']; + /** The number of fields in this subgraph */ + numberOfFields: Maybe; + /** The number of types in this subgraph */ + numberOfTypes: Maybe; + /** The revision string of this publish if provided */ + revision: Maybe; + /** The subgraph's routing URL, provided to gateways that use managed federation. */ routingURL: Scalars['String']; + /** Timestamp of when the subgraph was published. */ + updatedAt: Maybe; }; +/** A change made to a subgraph as part of a launch. */ export type SubgraphChange = { __typename?: 'SubgraphChange'; + /** The subgraph's name. */ name: Scalars['ID']; + /** The type of change that was made. */ type: SubgraphChangeType; }; @@ -6390,6 +13426,38 @@ export enum SubgraphChangeType { Modification = 'MODIFICATION' } +/** Input type to provide when running schema checks asynchronously for a federated supergraph. */ +export type SubgraphCheckAsyncInput = { + /** Configuration options for the check execution. */ + config: HistoricQueryParametersInput; + /** The GitHub context to associate with the check. */ + gitContext: GitContextInput; + /** The graph ref of the Studio graph and variant to run checks against (such as `my-graph@current`). */ + graphRef: Maybe; + /** The URL of the GraphQL endpoint that Apollo Sandbox introspected to obtain the proposed schema. Required if `isSandbox` is `true`. */ + introspectionEndpoint: Maybe; + /** If `true`, the check was initiated automatically by a Proposal update. */ + isProposal: Maybe; + /** If `true`, the check was initiated by Apollo Sandbox. */ + isSandbox: Scalars['Boolean']; + /** The proposed subgraph schema to perform checks with. */ + proposedSchema: Scalars['GraphQLDocument']; + /** The source variant that this check should use the operations check configuration from */ + sourceVariant: Maybe; + /** The name of the subgraph to check schema changes for. */ + subgraphName: Scalars['String']; + /** The user that triggered this check. If null, defaults to authContext to determine user. */ + triggeredBy: Maybe; +}; + +/** A subgraph in a federated Studio supergraph. */ +export type SubgraphCheckInput = { + /** The subgraph schema document's SHA256 hash, represented as a hexadecimal string. */ + hash: Scalars['String']; + /** The subgraph's registered name. */ + name: Scalars['String']; +}; + export type SubgraphConfig = { __typename?: 'SubgraphConfig'; id: Scalars['ID']; @@ -6399,6 +13467,45 @@ export type SubgraphConfig = { url: Scalars['String']; }; +export type SubgraphHashInput = { + /** SHA256 of the subgraph schema sdl. */ + hash: Scalars['String']; + name: Scalars['String']; +}; + +export type SubgraphInput = { + /** We are either going to pass in a document or a schema reference */ + document: Maybe; + name: Scalars['String']; + routingURL: Scalars['String']; + /** + * Reference to a schema in studio. + * If this is a mutable ref i.e. graphRef then it will link (tbd) + * If it is a stable ref i.e. hash then it + */ + schemaRef: Maybe; +}; + +export type SubgraphKeyMap = { + __typename?: 'SubgraphKeyMap'; + keys: Array; + subgraphName: Scalars['String']; +}; + +export type SubscriptionCapability = { + __typename?: 'SubscriptionCapability'; + label: Scalars['String']; + subscription: BillingSubscription; + value: Scalars['Boolean']; +}; + +export type SubscriptionLimit = { + __typename?: 'SubscriptionLimit'; + label: Scalars['String']; + subscription: BillingSubscription; + value: Scalars['Long']; +}; + export type SubscriptionOptions = { __typename?: 'SubscriptionOptions'; /** Enables notifications for schema updates */ @@ -6421,6 +13528,40 @@ export enum SubscriptionState { Unknown = 'UNKNOWN' } +export type Survey = { + __typename?: 'Survey'; + id: Scalars['String']; + isComplete: Scalars['Boolean']; + questionAnswers: Array; + shouldShow: Scalars['Boolean']; +}; + +export type SurveyQuestionAnswer = { + __typename?: 'SurveyQuestionAnswer'; + answerValue: Maybe; + questionKey: Scalars['String']; +}; + +export type SurveyQuestionInput = { + answerValue: Maybe; + questionKey: Scalars['String']; +}; + +export type SyncBillingAccountResult = PermissionError | SyncBillingAccountSuccess; + +export type SyncBillingAccountSuccess = { + __typename?: 'SyncBillingAccountSuccess'; + message: Scalars['String']; +}; + +/** User input for a resource share mutation */ +export type SyncPrivateSubgraphsInput = { + /** A unique identifier for the private subgraph */ + identifier: Scalars['String']; + /** The cloud provider where the private subgraph is hosted */ + provider: CloudProvider; +}; + export type TemporaryUrl = { __typename?: 'TemporaryURL'; url: Scalars['String']; @@ -6431,6 +13572,13 @@ export enum ThemeName { Light = 'LIGHT' } +/** Throttle error */ +export type ThrottleError = Error & { + __typename?: 'ThrottleError'; + message: Scalars['String']; + retryAfter: Maybe; +}; + export enum TicketPriority { P0 = 'P0', P1 = 'P1', @@ -6453,6 +13601,7 @@ export type TimezoneOffset = { zoneID: Scalars['String']; }; +/** Counts of changes. */ export type TotalChangeSummaryCounts = { __typename?: 'TotalChangeSummaryCounts'; /** @@ -6479,6 +13628,7 @@ export type TotalChangeSummaryCounts = { export type Trace = { __typename?: 'Trace'; + agentVersion: Maybe; cacheMaxAgeMs: Maybe; cacheScope: Maybe; clientName: Maybe; @@ -6487,12 +13637,18 @@ export type Trace = { endTime: Scalars['Timestamp']; http: Maybe; id: Scalars['ID']; + /** + * True if the report containing the trace was submitted as potentially incomplete, which can happen if the Router's + * trace buffer fills up while constructing the trace. If this is true, the trace might be missing some nodes. + */ + isIncomplete: Scalars['Boolean']; operationName: Maybe; protobuf: Protobuf; root: TraceNode; signature: Scalars['String']; - signatureId: Scalars['ID']; startTime: Scalars['Timestamp']; + unexecutedOperationBody: Maybe; + unexecutedOperationName: Maybe; variablesJSON: Array; }; @@ -6506,13 +13662,9 @@ export type TraceError = { export type TraceHttp = { __typename?: 'TraceHTTP'; - host: Maybe; method: HttpMethod; - path: Maybe; - protocol: Maybe; requestHeaders: Array; responseHeaders: Array; - secure: Scalars['Boolean']; statusCode: Scalars['Int']; }; @@ -6520,19 +13672,76 @@ export type TraceNode = { __typename?: 'TraceNode'; cacheMaxAgeMs: Maybe; cacheScope: Maybe; + /** The total number of children, including the ones that were truncated. */ + childCount: Scalars['Int']; + /** + * The immediate children of the node. There is a maximum number of children we will return so + * this might be truncated, but childCount will always have the total count. + */ children: Array; + /** Whether the children of this node have been truncated because the number of children is over the max. */ + childrenAreTruncated: Scalars['Boolean']; + /** + * The IDs of the immediate children of the node. There is a maximum number of children we will + * return so this might be truncated, but childCount will always have the total count. + */ childrenIds: Array; + /** + * All children, and the children of those children, and so on. Children that have been truncated + * are not included. + */ descendants: Array; + /** + * All IDs of children, and the IDs of the children of those children, and so on. Children that + * have been truncated are not included. + */ descendantsIds: Array; + /** + * The end time of the node. If this is a fetch node (meaning isFetch is true), this will be the + * time that the gateway/router received the response from the subgraph server in the + * gateway/routers clock time. + */ endTime: Scalars['Timestamp']; errors: Array; id: Scalars['ID']; + /** + * Whether the fetch node in question is a descendent of a Deferred node in the trace's query plan. The nodes + * in query plans can be complicated and nested, so this is a fairly simple representation of the structure. + */ + isDeferredFetch: Scalars['Boolean']; + /** + * Whether the node in question represents a fetch node within a query plan. If so, this will contain + * children with timestamps that are calculated by the router/gateway rather than subgraph and the + * fields subgraphStartTime and subgraphEndTime will be non-null. + */ + isFetch: Scalars['Boolean']; key: Maybe; originalFieldName: Maybe; parent: Scalars['ID']; parentId: Maybe; path: Array; + /** + * The start time of the node. If this is a fetch node (meaning isFetch is true), this will be the + * time that the gateway/router sent the request to the subgraph server in the gateway/router's clock + * time. + */ startTime: Scalars['Timestamp']; + /** + * Only present when the node in question is a fetch node, this will indicate the timestamp at which + * the subgraph server returned a response to the gateway/router. This timestamp is based on the + * subgraph server's clock, so if there is a clock skew between the subgraph and the gateway/router, + * this and endTime will not be in sync. If this is a fetch node but we don't receive subgraph traces + * (e.g. if the subgraph doesn't support federated traces), this value will be null. + */ + subgraphEndTime: Maybe; + /** + * Only present when the node in question is a fetch node, this will indicate the timestamp at which + * the fetch was received by the subgraph server. This timestamp is based on the subgraph server's + * clock, so if there is a clock skew between the subgraph and the gateway/router, this and startTime + * will not be in sync. If this is a fetch node but we don't receive subgraph traces (e.g. if the + * subgraph doesn't support federated traces), this value will be null. + */ + subgraphStartTime: Maybe; type: Maybe; }; @@ -6662,15 +13871,16 @@ export enum TraceRefsColumn { ClientName = 'CLIENT_NAME', ClientVersion = 'CLIENT_VERSION', DurationBucket = 'DURATION_BUCKET', - DurationNs = 'DURATION_NS', + OperationSubtype = 'OPERATION_SUBTYPE', + OperationType = 'OPERATION_TYPE', QueryId = 'QUERY_ID', QueryName = 'QUERY_NAME', SchemaHash = 'SCHEMA_HASH', SchemaTag = 'SCHEMA_TAG', ServiceId = 'SERVICE_ID', Timestamp = 'TIMESTAMP', - TraceId = 'TRACE_ID', - TraceSizeBytes = 'TRACE_SIZE_BYTES' + TraceCount = 'TRACE_COUNT', + TraceId = 'TRACE_ID' } export type TraceRefsDimensions = { @@ -6678,6 +13888,9 @@ export type TraceRefsDimensions = { clientName: Maybe; clientVersion: Maybe; durationBucket: Maybe; + generatedTraceId: Maybe; + operationSubtype: Maybe; + operationType: Maybe; queryId: Maybe; queryName: Maybe; querySignature: Maybe; @@ -6698,6 +13911,10 @@ export type TraceRefsFilter = { durationBucket: Maybe; in: Maybe; not: Maybe; + /** Selects rows whose operationSubtype dimension equals the given value if not null. To query for the null value, use {in: {operationSubtype: [null]}} instead. */ + operationSubtype: Maybe; + /** Selects rows whose operationType dimension equals the given value if not null. To query for the null value, use {in: {operationType: [null]}} instead. */ + operationType: Maybe; or: Maybe>; /** Selects rows whose queryId dimension equals the given value if not null. To query for the null value, use {in: {queryId: [null]}} instead. */ queryId: Maybe; @@ -6721,6 +13938,10 @@ export type TraceRefsFilterIn = { clientVersion: Maybe>>; /** Selects rows whose durationBucket dimension is in the given list. A null value in the list means a row with null for that dimension. */ durationBucket: Maybe>>; + /** Selects rows whose operationSubtype dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationSubtype: Maybe>>; + /** Selects rows whose operationType dimension is in the given list. A null value in the list means a row with null for that dimension. */ + operationType: Maybe>>; /** Selects rows whose queryId dimension is in the given list. A null value in the list means a row with null for that dimension. */ queryId: Maybe>>; /** Selects rows whose queryName dimension is in the given list. A null value in the list means a row with null for that dimension. */ @@ -6737,8 +13958,7 @@ export type TraceRefsFilterIn = { export type TraceRefsMetrics = { __typename?: 'TraceRefsMetrics'; - durationNs: Scalars['Long']; - traceSizeBytes: Scalars['Long']; + traceCount: Scalars['Long']; }; export type TraceRefsOrderBySpec = { @@ -6762,6 +13982,7 @@ export type TraceSourceLocation = { line: Scalars['Int']; }; +/** Counts of changes at the type level, including interfaces, unions, enums, scalars, input objects, etc. */ export type TypeChangeSummaryCounts = { __typename?: 'TypeChangeSummaryCounts'; /** Number of changes that are additions of types. */ @@ -6804,20 +14025,144 @@ export type UnignoreOperationsInChecksResult = { graph: Service; }; +export type UnlinkPersistedQueryListResult = { + __typename?: 'UnlinkPersistedQueryListResult'; + graphVariant: GraphVariant; + unlinkedPersistedQueryList: PersistedQueryList; +}; + +export type UnlinkPersistedQueryListResultOrError = PermissionError | UnlinkPersistedQueryListResult | VariantAlreadyUnlinkedError; + +/** Input to update an AWS shard */ +export type UpdateAwsShardInput = { + accountId: Maybe; + ecsClusterArn: Maybe; + endpoint: Maybe; + iamRoleArn: Maybe; + loadbalancerArn: Maybe; + loadbalancerListenerArn: Maybe; + loadbalancerSecurityGroupId: Maybe; + permissionsBoundaryArn: Maybe; + region: Maybe; + subnetIds: Maybe>; + vpcId: Maybe; +}; + +/** Input to update a Fly shard */ +export type UpdateFlyShardInput = { + endpoint: Maybe; + etcdEndpoints: Maybe>; + organizationId: Maybe; + region: Maybe; +}; + +export type UpdateOperationCollectionEntryResult = OperationCollectionEntry | PermissionError | ValidationError; + +export type UpdateOperationCollectionResult = OperationCollection | PermissionError | ValidationError; + +export type UpdatePaymentMethodResult = Account | NotFoundError | PermissionError | UpdatePaymentMethodSuccess; + +export type UpdatePaymentMethodSuccess = { + __typename?: 'UpdatePaymentMethodSuccess'; + paymentMethodId: Scalars['String']; +}; + +export type UpdatePersistedQueryListMetadataResult = { + __typename?: 'UpdatePersistedQueryListMetadataResult'; + persistedQueryList: PersistedQueryList; +}; + +export type UpdatePersistedQueryListMetadataResultOrError = PermissionError | UpdatePersistedQueryListMetadataResult; + +export type UpdateProposalResult = PermissionError | Proposal | ValidationError; + +export type UpdateRequestedReviewersInput = { + reviewerUserIdsToAdd: Maybe>; + reviewerUserIdsToRemove: Maybe>; +}; + +export type UpdateRequestedReviewersResult = PermissionError | Proposal | ValidationError; + +/** Input for updating a Cloud Router */ +export type UpdateRouterInput = { + /** + * Number of GCUs allocated for the Cloud Router + * + * This is ignored for serverless Cloud Routers + */ + gcus: Maybe; + /** Graph composition ID, also known as launch ID */ + graphCompositionId: Maybe; + /** Unique identifier for ordering orders */ + orderingId: Scalars['String']; + /** Configuration for the Cloud Router */ + routerConfig: Maybe; + /** URL for the Cloud Router */ + routerUrl: Maybe; + /** Router version for the Cloud Router */ + routerVersion: Maybe; +}; + +/** Represents the possible outcomes of an updateRouter mutation */ +export type UpdateRouterResult = InternalServerError | InvalidInputErrors | UpdateRouterSuccess; + +/** + * Success branch of an updateRouter mutation. + * id of the order can be polled via Query.cloud().order(id: ID!) to check-in + * on the progress of the underlying operation + */ +export type UpdateRouterSuccess = { + __typename?: 'UpdateRouterSuccess'; + order: Order; +}; + +/** Result of an updateVersion mutation */ +export type UpdateRouterVersionResult = CloudInvalidInputError | InternalServerError | RouterVersion; + +/** Input to update an existing Shard */ +export type UpdateShardInput = { + aws: Maybe; + fly: Maybe; + gcuCapacity: Maybe; + gcuUsage: Maybe; + routerCapacity: Maybe; + routerUsage: Maybe; + shardId: Scalars['String']; + status: Maybe; +}; + +/** Describes the result of publishing a schema to a graph variant. */ export type UploadSchemaMutationResponse = { __typename?: 'UploadSchemaMutationResponse'; + /** A machine-readable response code that indicates the type of result (e.g., `UPLOAD_SUCCESS` or `NO_CHANGES`) */ code: Scalars['String']; + /** A Human-readable message describing the type of result. */ message: Scalars['String']; + /** If the publish operation succeeded, this contains its details. Otherwise, this is null. */ + publication: Maybe; + /** Whether the schema publish operation succeeded (`true`) or encountered errors (`false`). */ success: Scalars['Boolean']; + /** If successful, the corresponding publication. */ tag: Maybe; }; +export type UpsertReviewInput = { + comment: Maybe; + decision: ReviewDecision; + revisionId: Scalars['ID']; +}; + +export type UpsertReviewResult = PermissionError | Proposal | ValidationError; + +export type UpsertRouterResult = GraphVariant | RouterUpsertFailure; + +/** A registered Apollo Studio user. */ export type User = Identity & { __typename?: 'User'; acceptedPrivacyPolicyAt: Maybe; - /** @deprecated Replaced with User.memberships.account */ - accounts: Array; + /** Returns a list of all active user API keys for the user. */ apiKeys: Array; + /** Returns a representation of this user as an `Actor` type. Useful when determining which actor (usually a `User` or `Graph`) performed a particular action in Studio. */ asActor: Actor; /** * Get an URL to which an avatar image can be uploaded. Client uploads by sending a PUT request @@ -6842,24 +14187,38 @@ export type User = Identity & { email: Maybe; emailModifiedAt: Maybe; emailVerified: Scalars['Boolean']; - experimentalFeatures: UserExperimentalFeatures; featureIntros: Maybe; fullName: Scalars['String']; /** The user's GitHub username, if they log in via GitHub. May be null even for GitHub users in some edge cases. */ githubUsername: Maybe; + /** The user's unique ID. */ id: Scalars['ID']; /** - * This role is reserved exclusively for internal MDG employees, and it controls what access they may have to other + * This role is reserved exclusively for internal Apollo employees, and it controls what access they may have to other * organizations. Only admins are allowed to see this field. */ internalAdminRole: Maybe; + /** Whether or not this user is and internal Apollo employee */ + isInternalUser: Scalars['Boolean']; /** Last time any API token from this user was used against AGM services */ lastAuthenticatedAt: Maybe; logoutAfterIdleMs: Maybe; + /** A list of the user's memberships in Apollo Studio organizations. */ memberships: Array; + /** The user's first and last name. */ name: Scalars['String']; - odysseyCourses: Array; - odysseyTasks: Array; + odysseyAttempt: Maybe; + odysseyAttempts: Maybe>; + odysseyCertification: Maybe; + odysseyCertifications: Array; + odysseyCourse: Maybe; + odysseyCourses: Maybe>; + /** @deprecated Unused. Remove from application usage */ + odysseyHasEarlyAccess: Scalars['Boolean']; + /** @deprecated Unused. Remove from application usage */ + odysseyHasRequestedEarlyAccess: Scalars['Boolean']; + odysseyTasks: Maybe>; + sandboxOperationCollections: Array; synchronized: Scalars['Boolean']; /** List of Zendesk tickets this user has submitted */ tickets: Maybe>; @@ -6867,32 +14226,65 @@ export type User = Identity & { }; +/** A registered Apollo Studio user. */ export type UserApiKeysArgs = { includeCookies?: Maybe; }; +/** A registered Apollo Studio user. */ export type UserAvatarUrlArgs = { size?: Scalars['Int']; }; + +/** A registered Apollo Studio user. */ +export type UserOdysseyAttemptArgs = { + id: Scalars['ID']; +}; + + +/** A registered Apollo Studio user. */ +export type UserOdysseyCertificationArgs = { + certificationId: Scalars['ID']; +}; + + +/** A registered Apollo Studio user. */ +export type UserOdysseyCourseArgs = { + courseId: Scalars['ID']; +}; + + +/** A registered Apollo Studio user. */ +export type UserOdysseyTasksArgs = { + in: Maybe>; +}; + +/** + * Represents a user API key, which has permissions identical to + * its associated Apollo user. + */ export type UserApiKey = ApiKey & { __typename?: 'UserApiKey'; + /** The API key's ID. */ id: Scalars['ID']; + /** The API key's name, for distinguishing it from other keys. */ keyName: Maybe; + /** The value of the API key. **This is a secret credential!** */ token: Scalars['String']; }; -export type UserExperimentalFeatures = { - __typename?: 'UserExperimentalFeatures'; - exampleFeature: Scalars['Boolean']; -}; - +/** A single user's membership in a single Apollo Studio organization. */ export type UserMembership = { __typename?: 'UserMembership'; + /** The organization that the user belongs to. */ account: Account; + /** The timestamp when the user was added to the organization. */ createdAt: Scalars['Timestamp']; + /** The user's permission level within the organization. */ permission: UserPermission; + /** The user that belongs to the organization. */ user: User; }; @@ -6901,27 +14293,36 @@ export type UserMutation = { acceptPrivacyPolicy: Maybe; /** Change the user's password */ changePassword: Maybe; + completeOdysseyAttempt: Maybe; + createOdysseyAttempt: Maybe; + createOdysseyCertification: Maybe; createOdysseyCourses: Maybe>; createOdysseyTasks: Maybe>; /** Delete the user's avatar. Requires User.canUpdateAvatar to be true. */ deleteAvatar: Maybe; + deleteOdysseyAttempt: Maybe; + deleteOdysseyCertification: Maybe; + deleteOdysseyCourse: Maybe; + deleteOdysseyTasks: Array>; /** Hard deletes the associated user. Throws an error otherwise with reason included. */ hardDelete: Maybe; - /** Create a new API key for this user. Must take in a name for this key. */ + /** Creates a new user API key for this user. */ newKey: UserApiKey; /** - * Create a new API key for this user if there are no current API keys. - * If an API key already exists, this will return one at random and not create a new one. + * If this user has no active user API keys, this creates one for the user. + * + * If this user has at least one active user API key, this returns one of those keys at random and does _not_ create a new key. */ provisionKey: Maybe; /** Refresh information about the user from its upstream service (eg list of organizations from GitHub) */ refresh: Maybe; - /** Removes the given key from this user. Can be used to remove either a web cookie or a user API key. */ + /** Deletes the user API key with the provided ID, if any. */ removeKey: Maybe; - /** Renames the given key to the new key name. */ + /** Sets a new name for the user API key with the provided ID, if any. This does not invalidate the key or change its value. */ renameKey: Maybe; resendVerificationEmail: Maybe; setOdysseyCourse: Maybe; + setOdysseyResponse: Maybe; setOdysseyTask: Maybe; /** Submit a zendesk ticket for this user */ submitZendeskTicket: Maybe; @@ -6931,6 +14332,7 @@ export type UserMutation = { updateBetaFeaturesOn: Maybe; /** Update the status of a feature for this. For example, if you want to hide an introductory popup. */ updateFeatureIntros: Maybe; + updateOdysseyAttempt: Maybe; /** * Update user to have the given internal mdg admin role. * It is necessary to be an MDG_INTERNAL_SUPER_ADMIN to perform update. @@ -6949,6 +14351,24 @@ export type UserMutationChangePasswordArgs = { }; +export type UserMutationCompleteOdysseyAttemptArgs = { + id: Scalars['ID']; + pass: Scalars['Boolean']; + responses: Array; +}; + + +export type UserMutationCreateOdysseyAttemptArgs = { + testId: Scalars['String']; +}; + + +export type UserMutationCreateOdysseyCertificationArgs = { + certificationId: Scalars['String']; + source: Maybe; +}; + + export type UserMutationCreateOdysseyCoursesArgs = { courses: Array; }; @@ -6959,6 +14379,26 @@ export type UserMutationCreateOdysseyTasksArgs = { }; +export type UserMutationDeleteOdysseyAttemptArgs = { + id: Scalars['ID']; +}; + + +export type UserMutationDeleteOdysseyCertificationArgs = { + id: Scalars['ID']; +}; + + +export type UserMutationDeleteOdysseyCourseArgs = { + courseId: Scalars['String']; +}; + + +export type UserMutationDeleteOdysseyTasksArgs = { + taskIds: Array; +}; + + export type UserMutationNewKeyArgs = { keyName: Scalars['String']; }; @@ -6985,7 +14425,13 @@ export type UserMutationSetOdysseyCourseArgs = { }; +export type UserMutationSetOdysseyResponseArgs = { + response: OdysseyResponseInput; +}; + + export type UserMutationSetOdysseyTaskArgs = { + courseId: Maybe; task: OdysseyTaskInput; }; @@ -7020,6 +14466,13 @@ export type UserMutationUpdateFeatureIntrosArgs = { }; +export type UserMutationUpdateOdysseyAttemptArgs = { + completedAt: Maybe; + id: Scalars['ID']; + pass: Maybe; +}; + + export type UserMutationUpdateRoleArgs = { newRole: Maybe; }; @@ -7033,18 +14486,23 @@ export enum UserPermission { BillingManager = 'BILLING_MANAGER', Consumer = 'CONSUMER', Contributor = 'CONTRIBUTOR', + Documenter = 'DOCUMENTER', GraphAdmin = 'GRAPH_ADMIN', LegacyGraphKey = 'LEGACY_GRAPH_KEY', Observer = 'OBSERVER', - OrgAdmin = 'ORG_ADMIN' + OrgAdmin = 'ORG_ADMIN', + PersistedQueryPublisher = 'PERSISTED_QUERY_PUBLISHER' } export enum UserSegment { JoinMyTeam = 'JOIN_MY_TEAM', LocalDevelopment = 'LOCAL_DEVELOPMENT', NotSpecified = 'NOT_SPECIFIED', + Odyssey = 'ODYSSEY', ProductionGraphs = 'PRODUCTION_GRAPHS', Sandbox = 'SANDBOX', + SandboxOperationCollections = 'SANDBOX_OPERATION_COLLECTIONS', + SandboxPreflightScripts = 'SANDBOX_PREFLIGHT_SCRIPTS', TryTeam = 'TRY_TEAM' } @@ -7082,6 +14540,13 @@ export type ValidateOperationsResult = { validationResults: Array; }; +/** An error that occurs when an operation contains invalid user input. */ +export type ValidationError = Error & { + __typename?: 'ValidationError'; + /** The error's details. */ + message: Scalars['String']; +}; + export enum ValidationErrorCode { DeprecatedField = 'DEPRECATED_FIELD', InvalidOperation = 'INVALID_OPERATION', @@ -7110,6 +14575,136 @@ export type ValidationResult = { type: ValidationErrorType; }; +export type VariantAlreadyLinkedError = Error & { + __typename?: 'VariantAlreadyLinkedError'; + message: Scalars['String']; +}; + +export type VariantAlreadyUnlinkedError = Error & { + __typename?: 'VariantAlreadyUnlinkedError'; + message: Scalars['String']; +}; + +/** Variant-level configuration of checks. */ +export type VariantCheckConfiguration = { + __typename?: 'VariantCheckConfiguration'; + /** Time when the check configuration was created. */ + createdAt: Scalars['Timestamp']; + /** + * Downstream checks configuration for which downstream variants should affect this variant's check + * status. + */ + downstreamVariantsConfig: VariantCheckConfigurationDownstreamVariants; + /** Operation checks configuration for which clients to ignore. */ + excludedClientsConfig: VariantCheckConfigurationExcludedClients; + /** Operation checks configuration for which operation to ignore. */ + excludedOperationsConfig: VariantCheckConfigurationExcludedOperations; + /** Graph that this check configuration belongs to */ + graphID: Scalars['String']; + /** Graph variant that this check configuration belongs to */ + graphVariant: Scalars['String']; + /** ID of the check configuration */ + id: Scalars['ID']; + /** Operation checks configuration for which variants' metrics data to include. */ + includedVariantsConfig: VariantCheckConfigurationIncludedVariants; + /** Whether operations checks are enabled. */ + operationsChecksEnabled: Scalars['Boolean']; + /** Operation checks configuration for time range and associated thresholds. */ + timeRangeConfig: VariantCheckConfigurationTimeRange; + /** Time when the check configuration was updated. */ + updatedAt: Scalars['Timestamp']; + /** Identity of the last actor to update the check configuration, if available. */ + updatedBy: Maybe; +}; + +export type VariantCheckConfigurationDownstreamVariants = { + __typename?: 'VariantCheckConfigurationDownstreamVariants'; + /** + * During downstream checks, this variant's check workflow will wait for all downstream check + * workflows for variants to complete, and if any of them fail, then + * this variant's check workflow will fail. + */ + blockingDownstreamVariants: Array; +}; + +export type VariantCheckConfigurationExcludedClients = { + __typename?: 'VariantCheckConfigurationExcludedClients'; + /** + * When true, indicates that graph-level configuration is appended to the variant-level + * configuration. The default at variant creation is true. + */ + appendGraphSettings: Scalars['Boolean']; + /** + * During operation checks, ignore clients matching any of the filters. The + * default at variant creation is the empty list. + */ + excludedClients: Array; +}; + +export type VariantCheckConfigurationExcludedOperations = { + __typename?: 'VariantCheckConfigurationExcludedOperations'; + /** + * When true, indicates that graph-level configuration is appended to the variant-level + * configuration. The default at variant creation is true. + */ + appendGraphSettings: Scalars['Boolean']; + /** + * During operation checks, ignore operations matching any of the filters. + * The default at variant creation is the empty list. + */ + excludedOperationNames: Array; + /** + * During operation checks, ignore operations matching any of the filters. The + * default at variant creation is the empty list. + */ + excludedOperations: Array; +}; + +export type VariantCheckConfigurationIncludedVariants = { + __typename?: 'VariantCheckConfigurationIncludedVariants'; + /** + * During operation checks, fetch operations from the metrics data for variants. + * Non-null if useGraphSettings is false and is otherwise null. + */ + includedVariants: Maybe>; + /** + * When true, indicates that graph-level configuration is used for this variant setting. The default + * at variant creation is true. + */ + useGraphSettings: Scalars['Boolean']; +}; + +export type VariantCheckConfigurationTimeRange = { + __typename?: 'VariantCheckConfigurationTimeRange'; + /** + * During operation checks, ignore operations that executed less than + * times in the time range. Non-null if useGraphSettings is false and is otherwise null. + */ + operationCountThreshold: Maybe; + /** + * Duration operation checks, ignore operations that constituted less than + * % of the operations in the time range. Expected values are + * between 0% and 5%. Non-null if useGraphSettings is false and is otherwise null. + */ + operationCountThresholdPercentage: Maybe; + /** + * During operation checks, fetch operations from the last seconds. Non-null if + * useGraphSettings is false and is otherwise null. + */ + timeRangeSeconds: Maybe; + /** + * When true, indicates that graph-level configuration is used for this variant setting. The default + * at variant creation is true. + */ + useGraphSettings: Scalars['Boolean']; +}; + +export type VariantCreationConfig = { + buildConfigInput: BuildConfigInput; + endpointSlug: Maybe; + variantName: Scalars['String']; +}; + /** Webhook notification channel */ export type WebhookChannel = Channel & { __typename?: 'WebhookChannel'; @@ -7144,9 +14739,11 @@ export type ZendeskTicket = { export type ZendeskTicketInput = { description: Scalars['String']; graphId: Maybe; + graphType: Maybe; organizationId: Maybe; priority: TicketPriority; subject: Scalars['String']; + uploadToken: Maybe; }; export type FrontendUrlRootQueryVariables = Exact<{ [key: string]: never; }>;