@aws-amplify/api-graphql 0.0.0-unstable-1ca644b-20260128091132

package/dist/esm/types/index.d.ts

@@ -0,0 +1,369 @@
+import { AmplifyClassV6, ResourcesConfig } from '@aws-amplify/core';
+import { BaseClient, ClientExtensions, ClientExtensionsSSRCookies, ClientExtensionsSSRRequest, ClientInternals, CustomHeaders, ModelSortDirection } from '@aws-amplify/data-schema/runtime';
+import { DocumentNode, GraphQLError, Source } from 'graphql';
+import { Observable } from 'rxjs';
+import { DocumentType, GraphQLAuthMode } from '@aws-amplify/core/internals/utils';
+import { AmplifyServer } from '@aws-amplify/core/internals/adapter-core';
+import { CommonPublicClientOptions } from '../internals/types';
+export { OperationTypeNode } from 'graphql';
+export { CONTROL_MSG, ConnectionState } from './PubSub';
+export { SelectionSet } from '@aws-amplify/data-schema/runtime';
+export type { CommonPublicClientOptions };
+/**
+ * Loose/Unknown options for raw GraphQLAPICategory `graphql()`.
+ */
+export interface GraphQLOptions {
+    query: string | DocumentNode;
+    endpoint?: string;
+    variables?: Record<string, DocumentType>;
+    authMode?: GraphQLAuthMode;
+    authToken?: string;
+    apiKey?: string;
+    /**
+     * @deprecated This property should not be used
+     */
+    userAgentSuffix?: string;
+}
+export interface GraphQLResult<T = object | null> {
+    data: T;
+    errors?: GraphQLError[];
+    extensions?: Record<string, any>;
+}
+declare const queryType: unique symbol;
+export type GraphQLQuery<T> = T & {
+    readonly [queryType]: 'query';
+};
+export type GraphQLSubscription<T> = T & {
+    readonly [queryType]: 'subscription';
+};
+/**
+ * Accepts a code generated model type and returns a supertype that
+ * can accept return values from the relevant graphql operations.
+ *
+ * For example:
+ *
+ * ```typescript
+ * import { GraphQLReturnType } from 'aws-amplify/api';
+ * import { MyModel } from './API';
+ * import { getMyModel } from './graphql/queries';
+ *
+ * const [item, setItem] = useState<GraphQLReturnType<MyModel>>();
+ * setItem(await client.graphql({ query: getMyModel }).data.getMyModel!)
+ * ```
+ *
+ * Trying to assign the result of a `getMyModel` operation directly to a
+ * `MyModel` variables won't necessarily work, because normally-required related
+ * models might not be part of the selection set.
+ *
+ * This util simply makes related model properties optional recursively.
+ */
+export type GraphQLReturnType<T> = T extends Record<string, unknown> ? {
+    [K in keyof T]?: GraphQLReturnType<T[K]>;
+} : T;
+/**
+ * Describes a paged list result from AppSync, which can either
+ * live at the top query or property (e.g., related model) level.
+ */
+interface PagedList<T, TYPENAME> {
+    __typename: TYPENAME;
+    nextToken?: string | null | undefined;
+    items: T[];
+}
+/**
+ * Recursively looks through a result type and removes nulls and
+ * and undefined from `PagedList` types.
+ *
+ * Although a graphql response might contain empty values in an
+ * array, this will only be the case when we also have errors,
+ * which will then be *thrown*.
+ */
+type WithListsFixed<T> = T extends PagedList<infer IT, infer NAME> ? PagedList<Exclude<IT, null | undefined>, NAME> : T extends Record<string, unknown> ? {
+    [K in keyof T]: WithListsFixed<T[K]>;
+} : T;
+/**
+ * Returns an updated response type to always return a value.
+ */
+type NeverEmpty<T> = {
+    [K in keyof T]-?: Exclude<WithListsFixed<T[K]>, undefined | null>;
+};
+/**
+ * Replaces all list result types in a query result with types to exclude
+ * nulls and undefined from list member unions.
+ *
+ * If empty members are present, there will also be errors present,
+ * and the response will instead be *thrown*.
+ */
+type FixedQueryResult<T> = Exclude<T[keyof T], null | undefined> extends PagedList<any, any> ? {
+    [K in keyof T]-?: WithListsFixed<Exclude<T[K], null | undefined>>;
+} : T;
+/**
+ * The return value from a `graphql({query})` call when `query` is a subscription.
+ *
+ * ```ts
+ * //               |-- You are here
+ * //               v
+ * const subResult: GraphqlSubscriptionResult<T> = client.graphql({
+ * 	query: onCreateWidget
+ * });
+ *
+ * const sub = subResult.subscribe({
+ * 	//
+ * 	//            |-- You are here
+ * 	//            v
+ * 	next(message: GraphqlSubscriptionMessage<OnCreateWidgetSubscription>) {
+ * 		handle(message.value);  // <-- type OnCreateWidgetSubscription
+ * 	}
+ * })
+ * ```
+ */
+export type GraphqlSubscriptionResult<T> = Observable<GraphqlSubscriptionMessage<T>>;
+/**
+ * The shape of messages passed to `next()` from a graphql subscription. E.g.,
+ *
+ * ```ts
+ * const sub = client.graphql({
+ * 	query: onCreateWidget,
+ * }).subscribe({
+ * 	//
+ * 	//            |-- You are here
+ * 	//            v
+ * 	next(message: GraphqlSubscriptionMessage<OnCreateWidgetSubscription>) {
+ * 		handle(message.value);  // <-- type OnCreateWidgetSubscription
+ * 	}
+ * })
+ * ```
+ */
+export interface GraphqlSubscriptionMessage<T> {
+    data: T;
+}
+export interface AWSAppSyncRealTimeProviderOptions {
+    appSyncGraphqlEndpoint?: string;
+    authenticationType?: GraphQLAuthMode;
+    query?: string;
+    variables?: Record<string, unknown>;
+    apiKey?: string;
+    region?: string;
+    libraryConfigHeaders?(): () => Promise<Record<string, unknown> | Headers>;
+    additionalHeaders?: CustomHeaders;
+}
+export interface AWSAppSyncRealTimeProvider {
+    subscribe(options?: AWSAppSyncRealTimeProviderOptions): Observable<Record<string, unknown>>;
+}
+export declare enum GraphQLAuthError {
+    NO_API_KEY = "No api-key configured",
+    NO_CURRENT_USER = "No current user",
+    NO_CREDENTIALS = "No credentials",
+    NO_FEDERATED_JWT = "No federated jwt",
+    NO_AUTH_TOKEN = "No auth token specified"
+}
+/**
+ * GraphQLSource or string, the type of the parameter for calling graphql.parse
+ * @see: https://graphql.org/graphql-js/language/#parse
+ */
+export type GraphQLOperation = Source | string;
+/**
+ * API V6 `graphql({options})` type that can leverage branded graphql `query`
+ * objects and fallback types.
+ */
+export type GraphQLOptionsV6<FALLBACK_TYPES = unknown, TYPED_GQL_STRING extends string = string, Options extends CommonPublicClientOptions = object> = Options['endpoint'] extends string ? Options['apiKey'] extends string ? {
+    query: TYPED_GQL_STRING | DocumentNode;
+    variables?: GraphQLVariablesV6<FALLBACK_TYPES, TYPED_GQL_STRING>;
+    authMode?: GraphQLAuthMode;
+    apiKey?: string;
+    authToken?: string;
+    /**
+     * @deprecated This property should not be used
+     */
+    userAgentSuffix?: string;
+} : {
+    query: TYPED_GQL_STRING | DocumentNode;
+    variables?: GraphQLVariablesV6<FALLBACK_TYPES, TYPED_GQL_STRING>;
+    authMode?: never;
+    apiKey?: never;
+    authToken?: string;
+    /**
+     * @deprecated This property should not be used
+     */
+    userAgentSuffix?: string;
+} | {
+    query: TYPED_GQL_STRING | DocumentNode;
+    variables?: GraphQLVariablesV6<FALLBACK_TYPES, TYPED_GQL_STRING>;
+    authMode: 'apiKey';
+    apiKey: string;
+    authToken?: string;
+    /**
+     * @deprecated This property should not be used
+     */
+    userAgentSuffix?: string;
+} | {
+    query: TYPED_GQL_STRING | DocumentNode;
+    variables?: GraphQLVariablesV6<FALLBACK_TYPES, TYPED_GQL_STRING>;
+    authMode: Exclude<GraphQLAuthMode, 'apiKey'>;
+    apiKey?: never;
+    authToken?: string;
+    /**
+     * @deprecated This property should not be used
+     */
+    userAgentSuffix?: string;
+} : {
+    query: TYPED_GQL_STRING | DocumentNode;
+    variables?: GraphQLVariablesV6<FALLBACK_TYPES, TYPED_GQL_STRING>;
+    authMode?: GraphQLAuthMode;
+    apiKey?: string;
+    authToken?: string;
+    /**
+     * @deprecated This property should not be used
+     */
+    userAgentSuffix?: string;
+};
+/**
+ * Result type for `graphql()` operations that don't include any specific
+ * type information. The result could be either a `Promise` or `Subscription`.
+ *
+ * Invoking code should either cast the result or use `?` and `!` operators to
+ * navigate the result objects.
+ */
+export type UnknownGraphQLResponse = Promise<GraphQLResult<any>> | GraphqlSubscriptionResult<any>;
+/**
+ * The expected type for `variables` in a V6 `graphql()` operation with
+ * respect to the given `FALLBACK_TYPES` and `TYPED_GQL_STRING`.
+ */
+export type GraphQLVariablesV6<FALLBACK_TYPES = unknown, TYPED_GQL_STRING extends string = string> = TYPED_GQL_STRING extends GeneratedQuery<infer IN, any> ? IN : TYPED_GQL_STRING extends GeneratedMutation<infer IN, any> ? IN : TYPED_GQL_STRING extends GeneratedSubscription<infer IN, any> ? IN : FALLBACK_TYPES extends GraphQLOperationType<infer IN, any> ? IN : any;
+/**
+ * The expected return type with respect to the given `FALLBACK_TYPE`
+ * and `TYPED_GQL_STRING`.
+ */
+export type GraphQLResponseV6<FALLBACK_TYPE = unknown, TYPED_GQL_STRING extends string = string> = TYPED_GQL_STRING extends GeneratedQuery<infer _, infer QUERY_OUT> ? Promise<GraphQLResult<FixedQueryResult<QUERY_OUT>>> : TYPED_GQL_STRING extends GeneratedMutation<infer _, infer MUTATION_OUT> ? Promise<GraphQLResult<NeverEmpty<MUTATION_OUT>>> : TYPED_GQL_STRING extends GeneratedSubscription<infer _, infer SUB_OUT> ? GraphqlSubscriptionResult<NeverEmpty<SUB_OUT>> : FALLBACK_TYPE extends GraphQLQuery<infer _> ? Promise<GraphQLResult<FALLBACK_TYPE>> : FALLBACK_TYPE extends GraphQLSubscription<infer _> ? GraphqlSubscriptionResult<FALLBACK_TYPE> : FALLBACK_TYPE extends GraphQLOperationType<infer _, infer CUSTOM_OUT> ? CUSTOM_OUT : UnknownGraphQLResponse;
+/**
+ * The shape customers can use to provide `T` to `graphql<T>()` to specify both
+ * `IN` and `OUT` types (the type of `variables` and the return type, respectively).
+ *
+ * I.E.,
+ *
+ * ```ts
+ * type MyVariablesType = { ... };
+ * type MyResultType = { ... };
+ * type MyOperationType = { variables: MyVariablesType, result: MyResultType };
+ *
+ * const result: MyResultType = graphql<MyOperationType>("graphql string", {
+ * 	variables: {
+ * 		// MyVariablesType
+ * 	}
+ * })
+ * ```
+ */
+export interface GraphQLOperationType<IN extends Record<string, DocumentType>, OUT extends Record<string, DocumentType>> {
+    variables: IN;
+    result: OUT;
+}
+/**
+ * Nominal type for branding generated graphql query operation strings with
+ * input and output types.
+ *
+ * E.g.,
+ *
+ * ```ts
+ * export const getWidget = `...` as GeneratedQuery<
+ * 	GetWidgetQueryVariables,
+ * 	GetWidgetQuery
+ * >;
+ * ```
+ *
+ * This allows `graphql()` to extract `InputType` and `OutputType` to correctly
+ * assign types to the `variables` and result objects.
+ */
+export type GeneratedQuery<InputType, OutputType> = string & {
+    __generatedQueryInput: InputType;
+    __generatedQueryOutput: OutputType;
+};
+/**
+ * Nominal type for branding generated graphql mutation operation strings with
+ * input and output types.
+ *
+ * E.g.,
+ *
+ * ```ts
+ * export const createWidget = `...` as GeneratedQuery<
+ * 	CreateWidgetMutationVariables,
+ * 	CreateWidgetMutation
+ * >;
+ * ```
+ *
+ * This allows `graphql()` to extract `InputType` and `OutputType` to correctly
+ * assign types to the `variables` and result objects.
+ */
+export type GeneratedMutation<InputType, OutputType> = string & {
+    __generatedMutationInput: InputType;
+    __generatedMutationOutput: OutputType;
+};
+/**
+ * Nominal type for branding generated graphql mutation operation strings with
+ * input and output types.
+ *
+ * E.g.,
+ *
+ * ```ts
+ * export const createWidget = `...` as GeneratedMutation<
+ * 	CreateWidgetMutationVariables,
+ * 	CreateWidgetMutation
+ * >;
+ * ```
+ *
+ * This allows `graphql()` to extract `InputType` and `OutputType` to correctly
+ * assign types to the `variables` and result objects.
+ */
+export type GeneratedSubscription<InputType, OutputType> = string & {
+    __generatedSubscriptionInput: InputType;
+    __generatedSubscriptionOutput: OutputType;
+};
+export declare const __amplify: unique symbol;
+export declare const __authMode: unique symbol;
+export declare const __authToken: unique symbol;
+export declare const __apiKey: unique symbol;
+export declare const __headers: unique symbol;
+export declare const __endpoint: unique symbol;
+export declare function getInternals(client: BaseClient): ClientInternals & {
+    apiKey?: string;
+    endpoint?: string;
+};
+export type ClientWithModels = V6Client | V6ClientSSRRequest | V6ClientSSRCookies;
+export type V6Client<T extends Record<any, any> = never, Options extends CommonPublicClientOptions = object> = {
+    graphql: GraphQLMethod<Options>;
+    cancel(promise: Promise<any>, message?: string): boolean;
+    isCancelError(error: any): boolean;
+} & ClientExtensions<T>;
+export type V6ClientSSRRequest<T extends Record<any, any> = never, Options extends CommonPublicClientOptions = object> = {
+    graphql: GraphQLMethodSSR<Options>;
+    cancel(promise: Promise<any>, message?: string): boolean;
+    isCancelError(error: any): boolean;
+} & ClientExtensionsSSRRequest<T>;
+export type V6ClientSSRCookies<T extends Record<any, any> = never, Options extends CommonPublicClientOptions = object> = {
+    graphql: GraphQLMethod<Options>;
+    cancel(promise: Promise<any>, message?: string): boolean;
+    isCancelError(error: any): boolean;
+} & ClientExtensionsSSRCookies<T>;
+export type GraphQLMethod<Options extends CommonPublicClientOptions> = <FALLBACK_TYPES = unknown, TYPED_GQL_STRING extends string = string>(options: GraphQLOptionsV6<FALLBACK_TYPES, TYPED_GQL_STRING, Options>, additionalHeaders?: CustomHeaders | undefined) => GraphQLResponseV6<FALLBACK_TYPES, TYPED_GQL_STRING>;
+export type GraphQLMethodSSR<Options extends CommonPublicClientOptions> = <FALLBACK_TYPES = unknown, TYPED_GQL_STRING extends string = string>(contextSpec: AmplifyServer.ContextSpec, options: GraphQLOptionsV6<FALLBACK_TYPES, TYPED_GQL_STRING, Options>, additionalHeaders?: CustomHeaders | undefined) => GraphQLResponseV6<FALLBACK_TYPES, TYPED_GQL_STRING>;
+/**
+ * @private
+ *
+ * The knobs available for configuring `server/generateClient` internally.
+ */
+export interface ServerClientGenerationParams {
+    amplify: null | ((fn: (amplify: AmplifyClassV6) => Promise<any>) => Promise<any>);
+    config: ResourcesConfig;
+}
+export type QueryArgs = Record<string, unknown>;
+export interface ListArgs extends Record<string, unknown> {
+    selectionSet?: string[];
+    filter?: Record<string, unknown>;
+    sortDirection?: ModelSortDirection;
+    headers?: CustomHeaders;
+}
+export interface AuthModeParams extends Record<string, unknown> {
+    authMode?: GraphQLAuthMode;
+    authToken?: string;
+}
+export type GenerateServerClientParams = {
+    config: ResourcesConfig;
+} & CommonPublicClientOptions;

package/dist/esm/types/index.mjs

@@ -0,0 +1,30 @@
+export { CONTROL_MSG, ConnectionState } from './PubSub.mjs';
+
+var GraphQLAuthError;
+(function (GraphQLAuthError) {
+    GraphQLAuthError["NO_API_KEY"] = "No api-key configured";
+    GraphQLAuthError["NO_CURRENT_USER"] = "No current user";
+    GraphQLAuthError["NO_CREDENTIALS"] = "No credentials";
+    GraphQLAuthError["NO_FEDERATED_JWT"] = "No federated jwt";
+    GraphQLAuthError["NO_AUTH_TOKEN"] = "No auth token specified";
+})(GraphQLAuthError || (GraphQLAuthError = {}));
+const __amplify = Symbol('amplify');
+const __authMode = Symbol('authMode');
+const __authToken = Symbol('authToken');
+const __apiKey = Symbol('apiKey');
+const __headers = Symbol('headers');
+const __endpoint = Symbol('endpoint');
+function getInternals(client) {
+    const c = client;
+    return {
+        amplify: c[__amplify],
+        apiKey: c[__apiKey],
+        authMode: c[__authMode],
+        authToken: c[__authToken],
+        endpoint: c[__endpoint],
+        headers: c[__headers],
+    };
+}
+
+export { GraphQLAuthError, __amplify, __apiKey, __authMode, __authToken, __endpoint, __headers, getInternals };
+//# sourceMappingURL=index.mjs.map

package/dist/esm/types/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../../src/types/index.ts"],"sourcesContent":["export { CONTROL_MSG, ConnectionState } from './PubSub';\nexport var GraphQLAuthError;\n(function (GraphQLAuthError) {\n    GraphQLAuthError[\"NO_API_KEY\"] = \"No api-key configured\";\n    GraphQLAuthError[\"NO_CURRENT_USER\"] = \"No current user\";\n    GraphQLAuthError[\"NO_CREDENTIALS\"] = \"No credentials\";\n    GraphQLAuthError[\"NO_FEDERATED_JWT\"] = \"No federated jwt\";\n    GraphQLAuthError[\"NO_AUTH_TOKEN\"] = \"No auth token specified\";\n})(GraphQLAuthError || (GraphQLAuthError = {}));\nexport const __amplify = Symbol('amplify');\nexport const __authMode = Symbol('authMode');\nexport const __authToken = Symbol('authToken');\nexport const __apiKey = Symbol('apiKey');\nexport const __headers = Symbol('headers');\nexport const __endpoint = Symbol('endpoint');\nexport function getInternals(client) {\n    const c = client;\n    return {\n        amplify: c[__amplify],\n        apiKey: c[__apiKey],\n        authMode: c[__authMode],\n        authToken: c[__authToken],\n        endpoint: c[__endpoint],\n        headers: c[__headers],\n    };\n}\n"],"names":[],"mappings":";;AACU,IAAC;AACX,CAAC,UAAU,gBAAgB,EAAE;AAC7B,IAAI,gBAAgB,CAAC,YAAY,CAAC,GAAG,uBAAuB;AAC5D,IAAI,gBAAgB,CAAC,iBAAiB,CAAC,GAAG,iBAAiB;AAC3D,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,gBAAgB;AACzD,IAAI,gBAAgB,CAAC,kBAAkB,CAAC,GAAG,kBAAkB;AAC7D,IAAI,gBAAgB,CAAC,eAAe,CAAC,GAAG,yBAAyB;AACjE,CAAC,EAAE,gBAAgB,KAAK,gBAAgB,GAAG,EAAE,CAAC,CAAC;AACnC,MAAC,SAAS,GAAG,MAAM,CAAC,SAAS;AAC7B,MAAC,UAAU,GAAG,MAAM,CAAC,UAAU;AAC/B,MAAC,WAAW,GAAG,MAAM,CAAC,WAAW;AACjC,MAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ;AAC3B,MAAC,SAAS,GAAG,MAAM,CAAC,SAAS;AAC7B,MAAC,UAAU,GAAG,MAAM,CAAC,UAAU;AACpC,SAAS,YAAY,CAAC,MAAM,EAAE;AACrC,IAAI,MAAM,CAAC,GAAG,MAAM;AACpB,IAAI,OAAO;AACX,QAAQ,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;AAC7B,QAAQ,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC;AAC3B,QAAQ,QAAQ,EAAE,CAAC,CAAC,UAAU,CAAC;AAC/B,QAAQ,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC;AACjC,QAAQ,QAAQ,EAAE,CAAC,CAAC,UAAU,CAAC;AAC/B,QAAQ,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;AAC7B,KAAK;AACL;;;;"}

package/dist/esm/utils/ConnectionStateMonitor.d.ts

@@ -0,0 +1,69 @@
+import { Observable } from 'rxjs';
+import { ConnectionState } from '../types/PubSub';
+type LinkedConnectionState = 'connected' | 'disconnected';
+type LinkedHealthState = 'healthy' | 'unhealthy';
+interface LinkedConnectionStates {
+    networkState: LinkedConnectionState;
+    connectionState: LinkedConnectionState | 'connecting';
+    intendedConnectionState: LinkedConnectionState;
+    keepAliveState: LinkedHealthState;
+}
+export declare const CONNECTION_CHANGE: {
+    readonly KEEP_ALIVE_MISSED: {
+        readonly keepAliveState: "unhealthy";
+    };
+    readonly KEEP_ALIVE: {
+        readonly keepAliveState: "healthy";
+    };
+    readonly CONNECTION_ESTABLISHED: {
+        readonly connectionState: "connected";
+    };
+    readonly CONNECTION_FAILED: {
+        readonly intendedConnectionState: "disconnected";
+        readonly connectionState: "disconnected";
+    };
+    readonly CLOSING_CONNECTION: {
+        readonly intendedConnectionState: "disconnected";
+    };
+    readonly OPENING_CONNECTION: {
+        readonly intendedConnectionState: "connected";
+        readonly connectionState: "connecting";
+    };
+    readonly CLOSED: {
+        readonly connectionState: "disconnected";
+    };
+    readonly ONLINE: {
+        readonly networkState: "connected";
+    };
+    readonly OFFLINE: {
+        readonly networkState: "disconnected";
+    };
+};
+export declare class ConnectionStateMonitor {
+    /**
+     * @private
+     */
+    private _linkedConnectionState;
+    private _linkedConnectionStateObservable;
+    private _linkedConnectionStateObserver;
+    private _networkMonitoringSubscription?;
+    private _initialNetworkStateSubscription?;
+    constructor();
+    /**
+     * Turn network state monitoring on if it isn't on already
+     */
+    private enableNetworkMonitoring;
+    /**
+     * Turn network state monitoring off if it isn't off already
+     */
+    private disableNetworkMonitoring;
+    /**
+     * Get the observable that allows us to monitor the connection state
+     *
+     * @returns {Observable<ConnectionState>} - The observable that emits ConnectionState updates
+     */
+    get connectionStateObservable(): Observable<ConnectionState>;
+    record(statusUpdates: Partial<LinkedConnectionStates>): void;
+    private connectionStatesTranslator;
+}
+export {};

package/dist/esm/utils/ConnectionStateMonitor.mjs

@@ -0,0 +1,132 @@
+import { Observable, map, filter } from 'rxjs';
+import { ConnectionState } from '../types/PubSub.mjs';
+import { ReachabilityMonitor } from './ReachabilityMonitor/index.mjs';
+
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const CONNECTION_CHANGE = {
+    KEEP_ALIVE_MISSED: { keepAliveState: 'unhealthy' },
+    KEEP_ALIVE: { keepAliveState: 'healthy' },
+    CONNECTION_ESTABLISHED: { connectionState: 'connected' },
+    CONNECTION_FAILED: {
+        intendedConnectionState: 'disconnected',
+        connectionState: 'disconnected',
+    },
+    CLOSING_CONNECTION: { intendedConnectionState: 'disconnected' },
+    OPENING_CONNECTION: {
+        intendedConnectionState: 'connected',
+        connectionState: 'connecting',
+    },
+    CLOSED: { connectionState: 'disconnected' },
+    ONLINE: { networkState: 'connected' },
+    OFFLINE: { networkState: 'disconnected' },
+};
+class ConnectionStateMonitor {
+    constructor() {
+        this._networkMonitoringSubscription = undefined;
+        this._linkedConnectionState = {
+            networkState: 'connected',
+            connectionState: 'disconnected',
+            intendedConnectionState: 'disconnected',
+            keepAliveState: 'healthy',
+        };
+        // Attempt to update the state with the current actual network state
+        this._initialNetworkStateSubscription = ReachabilityMonitor().subscribe(({ online }) => {
+            this.record(online ? CONNECTION_CHANGE.ONLINE : CONNECTION_CHANGE.OFFLINE);
+            this._initialNetworkStateSubscription?.unsubscribe();
+        });
+        this._linkedConnectionStateObservable =
+            new Observable(connectionStateObserver => {
+                connectionStateObserver.next(this._linkedConnectionState);
+                this._linkedConnectionStateObserver = connectionStateObserver;
+            });
+    }
+    /**
+     * Turn network state monitoring on if it isn't on already
+     */
+    enableNetworkMonitoring() {
+        // If no initial network state was discovered, stop trying
+        this._initialNetworkStateSubscription?.unsubscribe();
+        // Maintain the network state based on the reachability monitor
+        if (this._networkMonitoringSubscription === undefined) {
+            this._networkMonitoringSubscription = ReachabilityMonitor().subscribe(({ online }) => {
+                this.record(online ? CONNECTION_CHANGE.ONLINE : CONNECTION_CHANGE.OFFLINE);
+            });
+        }
+    }
+    /**
+     * Turn network state monitoring off if it isn't off already
+     */
+    disableNetworkMonitoring() {
+        this._networkMonitoringSubscription?.unsubscribe();
+        this._networkMonitoringSubscription = undefined;
+    }
+    /**
+     * Get the observable that allows us to monitor the connection state
+     *
+     * @returns {Observable<ConnectionState>} - The observable that emits ConnectionState updates
+     */
+    get connectionStateObservable() {
+        let previous;
+        // The linked state aggregates state changes to any of the network, connection,
+        // intendedConnection and keepAliveHealth. Some states will change these independent
+        // states without changing the overall connection state.
+        // After translating from linked states to ConnectionState, then remove any duplicates
+        return this._linkedConnectionStateObservable
+            .pipe(map(value => {
+            return this.connectionStatesTranslator(value);
+        }))
+            .pipe(filter(current => {
+            const toInclude = current !== previous;
+            previous = current;
+            return toInclude;
+        }));
+    }
+    /*
+     * Updates local connection state and emits the full state to the observer.
+     */
+    record(statusUpdates) {
+        // Maintain the network monitor
+        if (statusUpdates.intendedConnectionState === 'connected') {
+            this.enableNetworkMonitoring();
+        }
+        else if (statusUpdates.intendedConnectionState === 'disconnected') {
+            this.disableNetworkMonitoring();
+        }
+        // Maintain the socket state
+        const newSocketStatus = {
+            ...this._linkedConnectionState,
+            ...statusUpdates,
+        };
+        this._linkedConnectionState = { ...newSocketStatus };
+        this._linkedConnectionStateObserver?.next(this._linkedConnectionState);
+    }
+    /*
+     * Translate the ConnectionState structure into a specific ConnectionState string literal union
+     */
+    connectionStatesTranslator({ connectionState, networkState, intendedConnectionState, keepAliveState, }) {
+        if (connectionState === 'connected' && networkState === 'disconnected')
+            return ConnectionState.ConnectedPendingNetwork;
+        if (connectionState === 'connected' &&
+            intendedConnectionState === 'disconnected')
+            return ConnectionState.ConnectedPendingDisconnect;
+        if (connectionState === 'disconnected' &&
+            intendedConnectionState === 'connected' &&
+            networkState === 'disconnected')
+            return ConnectionState.ConnectionDisruptedPendingNetwork;
+        if (connectionState === 'disconnected' &&
+            intendedConnectionState === 'connected')
+            return ConnectionState.ConnectionDisrupted;
+        if (connectionState === 'connected' && keepAliveState === 'unhealthy')
+            return ConnectionState.ConnectedPendingKeepAlive;
+        // All remaining states directly correspond to the connection state
+        if (connectionState === 'connecting')
+            return ConnectionState.Connecting;
+        if (connectionState === 'disconnected')
+            return ConnectionState.Disconnected;
+        return ConnectionState.Connected;
+    }
+}
+
+export { CONNECTION_CHANGE, ConnectionStateMonitor };
+//# sourceMappingURL=ConnectionStateMonitor.mjs.map

package/dist/esm/utils/ConnectionStateMonitor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionStateMonitor.mjs","sources":["../../../src/utils/ConnectionStateMonitor.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { Observable, filter, map } from 'rxjs';\nimport { ConnectionState } from '../types/PubSub';\nimport { ReachabilityMonitor } from './ReachabilityMonitor';\nexport const CONNECTION_CHANGE = {\n    KEEP_ALIVE_MISSED: { keepAliveState: 'unhealthy' },\n    KEEP_ALIVE: { keepAliveState: 'healthy' },\n    CONNECTION_ESTABLISHED: { connectionState: 'connected' },\n    CONNECTION_FAILED: {\n        intendedConnectionState: 'disconnected',\n        connectionState: 'disconnected',\n    },\n    CLOSING_CONNECTION: { intendedConnectionState: 'disconnected' },\n    OPENING_CONNECTION: {\n        intendedConnectionState: 'connected',\n        connectionState: 'connecting',\n    },\n    CLOSED: { connectionState: 'disconnected' },\n    ONLINE: { networkState: 'connected' },\n    OFFLINE: { networkState: 'disconnected' },\n};\nexport class ConnectionStateMonitor {\n    constructor() {\n        this._networkMonitoringSubscription = undefined;\n        this._linkedConnectionState = {\n            networkState: 'connected',\n            connectionState: 'disconnected',\n            intendedConnectionState: 'disconnected',\n            keepAliveState: 'healthy',\n        };\n        // Attempt to update the state with the current actual network state\n        this._initialNetworkStateSubscription = ReachabilityMonitor().subscribe(({ online }) => {\n            this.record(online ? CONNECTION_CHANGE.ONLINE : CONNECTION_CHANGE.OFFLINE);\n            this._initialNetworkStateSubscription?.unsubscribe();\n        });\n        this._linkedConnectionStateObservable =\n            new Observable(connectionStateObserver => {\n                connectionStateObserver.next(this._linkedConnectionState);\n                this._linkedConnectionStateObserver = connectionStateObserver;\n            });\n    }\n    /**\n     * Turn network state monitoring on if it isn't on already\n     */\n    enableNetworkMonitoring() {\n        // If no initial network state was discovered, stop trying\n        this._initialNetworkStateSubscription?.unsubscribe();\n        // Maintain the network state based on the reachability monitor\n        if (this._networkMonitoringSubscription === undefined) {\n            this._networkMonitoringSubscription = ReachabilityMonitor().subscribe(({ online }) => {\n                this.record(online ? CONNECTION_CHANGE.ONLINE : CONNECTION_CHANGE.OFFLINE);\n            });\n        }\n    }\n    /**\n     * Turn network state monitoring off if it isn't off already\n     */\n    disableNetworkMonitoring() {\n        this._networkMonitoringSubscription?.unsubscribe();\n        this._networkMonitoringSubscription = undefined;\n    }\n    /**\n     * Get the observable that allows us to monitor the connection state\n     *\n     * @returns {Observable<ConnectionState>} - The observable that emits ConnectionState updates\n     */\n    get connectionStateObservable() {\n        let previous;\n        // The linked state aggregates state changes to any of the network, connection,\n        // intendedConnection and keepAliveHealth. Some states will change these independent\n        // states without changing the overall connection state.\n        // After translating from linked states to ConnectionState, then remove any duplicates\n        return this._linkedConnectionStateObservable\n            .pipe(map(value => {\n            return this.connectionStatesTranslator(value);\n        }))\n            .pipe(filter(current => {\n            const toInclude = current !== previous;\n            previous = current;\n            return toInclude;\n        }));\n    }\n    /*\n     * Updates local connection state and emits the full state to the observer.\n     */\n    record(statusUpdates) {\n        // Maintain the network monitor\n        if (statusUpdates.intendedConnectionState === 'connected') {\n            this.enableNetworkMonitoring();\n        }\n        else if (statusUpdates.intendedConnectionState === 'disconnected') {\n            this.disableNetworkMonitoring();\n        }\n        // Maintain the socket state\n        const newSocketStatus = {\n            ...this._linkedConnectionState,\n            ...statusUpdates,\n        };\n        this._linkedConnectionState = { ...newSocketStatus };\n        this._linkedConnectionStateObserver?.next(this._linkedConnectionState);\n    }\n    /*\n     * Translate the ConnectionState structure into a specific ConnectionState string literal union\n     */\n    connectionStatesTranslator({ connectionState, networkState, intendedConnectionState, keepAliveState, }) {\n        if (connectionState === 'connected' && networkState === 'disconnected')\n            return ConnectionState.ConnectedPendingNetwork;\n        if (connectionState === 'connected' &&\n            intendedConnectionState === 'disconnected')\n            return ConnectionState.ConnectedPendingDisconnect;\n        if (connectionState === 'disconnected' &&\n            intendedConnectionState === 'connected' &&\n            networkState === 'disconnected')\n            return ConnectionState.ConnectionDisruptedPendingNetwork;\n        if (connectionState === 'disconnected' &&\n            intendedConnectionState === 'connected')\n            return ConnectionState.ConnectionDisrupted;\n        if (connectionState === 'connected' && keepAliveState === 'unhealthy')\n            return ConnectionState.ConnectedPendingKeepAlive;\n        // All remaining states directly correspond to the connection state\n        if (connectionState === 'connecting')\n            return ConnectionState.Connecting;\n        if (connectionState === 'disconnected')\n            return ConnectionState.Disconnected;\n        return ConnectionState.Connected;\n    }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/utils/ReachabilityMonitor/index.d.ts

@@ -0,0 +1 @@
+export declare const ReachabilityMonitor: () => import("rxjs").Observable<import("@aws-amplify/core/dist/esm/Reachability/types").NetworkStatus>;

package/dist/esm/utils/ReachabilityMonitor/index.mjs

@@ -0,0 +1,8 @@
+import { Reachability } from '@aws-amplify/core/internals/utils';
+
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const ReachabilityMonitor = () => new Reachability().networkMonitor();
+
+export { ReachabilityMonitor };
+//# sourceMappingURL=index.mjs.map

package/dist/esm/utils/ReachabilityMonitor/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../../../src/utils/ReachabilityMonitor/index.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { Reachability } from '@aws-amplify/core/internals/utils';\nexport const ReachabilityMonitor = () => new Reachability().networkMonitor();\n"],"names":[],"mappings":";;AAAA;AACA;AAEY,MAAC,mBAAmB,GAAG,MAAM,IAAI,YAAY,EAAE,CAAC,cAAc;;;;"}

package/dist/esm/utils/ReachabilityMonitor/index.native.d.ts

@@ -0,0 +1 @@
+export declare const ReachabilityMonitor: () => import("rxjs").Observable<import("@aws-amplify/core/dist/esm/Reachability/types").NetworkStatus>;

package/dist/esm/utils/ReachabilityMonitor/index.native.mjs

@@ -0,0 +1,9 @@
+import { Reachability } from '@aws-amplify/core/internals/utils';
+import NetInfo from '@react-native-community/netinfo';
+
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const ReachabilityMonitor = () => new Reachability().networkMonitor(NetInfo);
+
+export { ReachabilityMonitor };
+//# sourceMappingURL=index.native.mjs.map

package/dist/esm/utils/ReachabilityMonitor/index.native.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.native.mjs","sources":["../../../../src/utils/ReachabilityMonitor/index.native.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { Reachability } from '@aws-amplify/core/internals/utils';\nimport NetInfo from '@react-native-community/netinfo';\nexport const ReachabilityMonitor = () => new Reachability().networkMonitor(NetInfo);\n"],"names":[],"mappings":";;;AAAA;AACA;AAGY,MAAC,mBAAmB,GAAG,MAAM,IAAI,YAAY,EAAE,CAAC,cAAc,CAAC,OAAO;;;;"}