@mearie/core 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -1,36 +1,6 @@
-import { Artifact, Artifact as Artifact$1, ArtifactKind, ArtifactKind as ArtifactKind$1, DataOf, FragmentRefs, FragmentRefs as FragmentRefs$1, SchemaMeta, SchemaMeta as SchemaMeta$1, VariablesOf, VariablesOf as VariablesOf$1 } from "@mearie/shared";
+import { k as Source } from "./make-BhxZYW3l.cjs";
+import { Artifact, Artifact as Artifact$1, ArtifactKind, ArtifactKind as ArtifactKind$1, DataOf, DataOf as DataOf$1, FragmentRefs, FragmentRefs as FragmentRefs$1, SchemaMeta, SchemaMeta as SchemaMeta$1, VariablesOf, VariablesOf as VariablesOf$1 } from "@mearie/shared";
 
-//#region src/stream/types.d.ts
-/**
- * Subscription allows cancelling a stream and cleaning up resources.
- */
-type Subscription = {
-  /**
-   * Cancel the stream and clean up resources.
-   */
-  unsubscribe(): void;
-};
-/**
- * Sink receives values from a Source.
- */
-type Sink<T> = {
-  /**
-   * Receive a data value.
-   * @param value - The data value.
-   */
-  next(value: T): void;
-  /**
-   * Receive completion signal.
-   */
-  complete(): void;
-};
-/**
- * Source is a function that accepts a Sink and returns a Subscription.
- * When called, it starts pushing values to the sink.
- * @returns A subscription that can be used to cancel the stream.
- */
-type Source<T> = (sink: Sink<T>) => Subscription;
-//#endregion
 //#region src/errors.d.ts
 /**
  *
@@ -94,10 +64,19 @@ type ScalarTransformer<TExternal = unknown, TInternal = unknown> = {
 type ScalarsConfig<TMeta extends SchemaMeta$1 = SchemaMeta$1> = { [K in keyof TMeta['scalars']]: ScalarTransformer<TMeta['scalars'][K], unknown> };
 //#endregion
 //#region src/client.d.ts
-type QueryOptions = {};
-type MutationOptions = {};
-type SubscriptionOptions = {};
-type FragmentOptions = {};
+type QueryOptions<T extends Artifact$1<'query'> = Artifact$1<'query'>> = {
+  initialData?: DataOf$1<T>;
+  metadata?: OperationMetadata;
+};
+type MutationOptions = {
+  metadata?: OperationMetadata;
+};
+type SubscriptionOptions = {
+  metadata?: OperationMetadata;
+};
+type FragmentOptions = {
+  metadata?: OperationMetadata;
+};
 type ClientOptions<T extends SchemaMeta$1> = {
   schema: T;
   exchanges: Exchange[];
@@ -114,31 +93,43 @@ declare class Client<TMeta extends SchemaMeta$1 = SchemaMeta$1> {
   get schema(): TMeta;
   get scalars(): ScalarsConfig<TMeta> | undefined;
   private createOperationKey;
-  createOperation(artifact: Artifact$1, variables?: unknown): Operation;
+  createOperation(artifact: Artifact$1, variables?: unknown, metadata?: OperationMetadata): Operation;
   executeOperation(operation: Operation): Source<OperationResult>;
-  executeQuery<T extends Artifact$1<'query'>>(artifact: T, ...[variables, options]: VariablesOf$1<T> extends undefined ? [undefined?, QueryOptions?] : [VariablesOf$1<T>, QueryOptions?]): Source<OperationResult>;
+  executeQuery<T extends Artifact$1<'query'>>(artifact: T, ...[variables, options]: VariablesOf$1<T> extends undefined ? [undefined?, QueryOptions<T>?] : [VariablesOf$1<T>, QueryOptions<T>?]): Source<OperationResult>;
   executeMutation<T extends Artifact$1<'mutation'>>(artifact: T, ...[variables, options]: VariablesOf$1<T> extends undefined ? [undefined?, MutationOptions?] : [VariablesOf$1<T>, MutationOptions?]): Source<OperationResult>;
   executeSubscription<T extends Artifact$1<'subscription'>>(artifact: T, ...[variables, options]: VariablesOf$1<T> extends undefined ? [undefined?, SubscriptionOptions?] : [VariablesOf$1<T>, SubscriptionOptions?]): Source<OperationResult>;
-  executeFragment<T extends Artifact$1<'fragment'>>(artifact: T, fragmentRef: FragmentRefs$1<T['name']>, options?: FragmentOptions): Source<OperationResult>;
+  executeFragment<T extends Artifact$1<'fragment'>>(artifact: T, fragmentRef: FragmentRefs$1<T['name']> | FragmentRefs$1<T['name']>[], options?: FragmentOptions): Source<OperationResult>;
+  query<T extends Artifact$1<'query'>>(artifact: T, ...[variables, options]: VariablesOf$1<T> extends undefined ? [undefined?, QueryOptions<T>?] : [VariablesOf$1<T>, QueryOptions<T>?]): Promise<DataOf$1<T>>;
+  mutation<T extends Artifact$1<'mutation'>>(artifact: T, ...[variables, options]: VariablesOf$1<T> extends undefined ? [undefined?, MutationOptions?] : [VariablesOf$1<T>, MutationOptions?]): Promise<DataOf$1<T>>;
+  /**
+   * Returns the extension registered by a named exchange.
+   * @param name - The exchange name.
+   * @returns The extension object provided by the exchange.
+   */
+  extension<TName extends keyof ExchangeExtensionMap>(name: TName): ExchangeExtensionMap[TName];
+  extension(name: string): unknown;
+  maybeExtension<TName extends keyof ExchangeExtensionMap>(name: TName): ExchangeExtensionMap[TName] | undefined;
+  maybeExtension(name: string): unknown;
   dispose(): void;
 }
 declare const createClient: <T extends SchemaMeta$1>(config: ClientOptions<T>) => Client<T>;
 //#endregion
 //#region src/exchange.d.ts
 interface OperationMetadataMap {}
+type OperationMetadata = { [K in keyof OperationMetadataMap]?: OperationMetadataMap[K] } & Record<string, unknown>;
 type BaseOperation = {
   key: string;
   metadata: OperationMetadataMap & Record<string, unknown>;
 };
-type RequestOperation<K$1 extends ArtifactKind$1 = ArtifactKind$1> = BaseOperation & {
+type RequestOperation<K extends ArtifactKind$1 = ArtifactKind$1> = BaseOperation & {
   variant: 'request';
-  artifact: Artifact$1<K$1>;
-  variables: VariablesOf$1<Artifact$1<K$1>>;
+  artifact: Artifact$1<K>;
+  variables: VariablesOf$1<Artifact$1<K>>;
 };
 type TeardownOperation = BaseOperation & {
   variant: 'teardown';
 };
-type Operation<K$1 extends ArtifactKind$1 = ArtifactKind$1> = RequestOperation<K$1> | TeardownOperation;
+type Operation<K extends ArtifactKind$1 = ArtifactKind$1> = RequestOperation<K> | TeardownOperation;
 type OperationResult = {
   operation: Operation;
   data?: unknown;
@@ -151,16 +142,17 @@ type ExchangeInput<TMeta extends SchemaMeta$1 = SchemaMeta$1> = {
   client: Client<TMeta>;
 };
 type ExchangeIO = (operations: Source<Operation>) => Source<OperationResult>;
-type Exchange = <TMeta extends SchemaMeta$1 = SchemaMeta$1>(input: ExchangeInput<TMeta>) => ExchangeIO;
-//#endregion
-//#region src/exchanges/compose.d.ts
-type ComposeExchangeOptions = {
-  exchanges: Exchange[];
-};
-declare const composeExchange: (options: ComposeExchangeOptions) => Exchange;
+interface ExchangeExtensionMap {}
+type ExchangeResult<TName extends keyof ExchangeExtensionMap | (string & {}) = string> = {
+  name: TName;
+  io: ExchangeIO;
+} & (TName extends keyof ExchangeExtensionMap ? {
+  extension: ExchangeExtensionMap[TName];
+} : {});
+type Exchange<TName extends keyof ExchangeExtensionMap | (string & {}) = string> = <TMeta extends SchemaMeta$1 = SchemaMeta$1>(input: ExchangeInput<TMeta>) => ExchangeResult<TName>;
 //#endregion
 //#region src/exchanges/http.d.ts
-declare module '../errors.ts' {
+declare module '@mearie/core' {
   interface ExchangeErrorExtensionsMap {
     http?: {
       statusCode?: number;
@@ -172,11 +164,12 @@ type HttpOptions = {
   headers?: HeadersInit;
   mode?: RequestMode;
   credentials?: RequestCredentials;
+  fetch?: typeof globalThis.fetch;
 };
 declare const httpExchange: (options: HttpOptions) => Exchange;
 //#endregion
 //#region src/exchanges/dedup.d.ts
-declare module '../exchange.ts' {
+declare module '@mearie/core' {
   interface OperationMetadataMap {
     dedup?: {
       skip?: boolean;
@@ -200,14 +193,64 @@ declare module '../exchange.ts' {
  */
 declare const dedupExchange: () => Exchange;
 //#endregion
+//#region src/cache/types.d.ts
+/**
+ * Identifier for a single entity, supporting simple or composite keys.
+ */
+type EntityId = string | number | Record<string, string | number>;
+/**
+ * Target specification for cache invalidation operations.
+ */
+type InvalidateTarget = {
+  __typename: string;
+  id: EntityId;
+} | {
+  __typename: string;
+  id: EntityId;
+  field: string;
+  args?: Record<string, unknown>;
+} | {
+  __typename: 'Query';
+} | {
+  __typename: 'Query';
+  field: string;
+  args?: Record<string, unknown>;
+} | {
+  __typename: string;
+} | {
+  __typename: string;
+  field: string;
+  args?: Record<string, unknown>;
+};
+/**
+ * Opaque type representing a serializable cache snapshot.
+ */
+type CacheSnapshot = {
+  readonly __brand: unique symbol;
+};
+/**
+ * Operations available for programmatic cache manipulation.
+ */
+type CacheOperations = {
+  extract(): CacheSnapshot;
+  hydrate(data: CacheSnapshot): void;
+  invalidate(...targets: InvalidateTarget[]): void;
+  clear(): void;
+};
+//#endregion
 //#region src/exchanges/cache.d.ts
+declare module '@mearie/core' {
+  interface ExchangeExtensionMap {
+    cache: CacheOperations;
+  }
+}
 type CacheOptions = {
   fetchPolicy?: 'cache-first' | 'cache-and-network' | 'network-only' | 'cache-only';
 };
-declare const cacheExchange: (options?: CacheOptions) => Exchange;
+declare const cacheExchange: (options?: CacheOptions) => Exchange<"cache">;
 //#endregion
 //#region src/exchanges/retry.d.ts
-declare module '../exchange.ts' {
+declare module '@mearie/core' {
   interface OperationMetadataMap {
     retry?: {
       attempt: number;
@@ -223,13 +266,16 @@ type RetryOptions = {
 declare const retryExchange: (options?: RetryOptions) => Exchange;
 //#endregion
 //#region src/exchanges/fragment.d.ts
-declare module '../exchange.ts' {
+declare module '@mearie/core' {
   interface OperationMetadataMap {
     fragmentRef?: unknown;
   }
 }
 declare const fragmentExchange: () => Exchange;
 //#endregion
+//#region src/exchanges/required.d.ts
+declare const requiredExchange: () => Exchange;
+//#endregion
 //#region src/exchanges/subscription.d.ts
 interface SubscriptionClient {
   subscribe(payload: {
@@ -244,6 +290,13 @@ interface SubscriptionClient {
 type SubscriptionExchangeOptions = {
   client: SubscriptionClient;
 };
+declare module '@mearie/core' {
+  interface OperationMetadataMap {
+    subscription?: {
+      transport?: boolean;
+    };
+  }
+}
 /**
  * Creates an exchange for handling GraphQL subscriptions using a subscription client.
  *
@@ -273,6 +326,14 @@ type SubscriptionExchangeOptions = {
  */
 declare const subscriptionExchange: (options: SubscriptionExchangeOptions) => Exchange;
 //#endregion
+//#region src/required.d.ts
+type RequiredAction = 'THROW' | 'CASCADE';
+declare class RequiredFieldError extends Error {
+  fieldPath: string[];
+  fieldName: string;
+  constructor(fieldPath: string[], fieldName: string);
+}
+//#endregion
 //#region src/utils.d.ts
 /**
  * Stable JSON serialization with sorted keys.
@@ -283,4 +344,4 @@ declare const subscriptionExchange: (options: SubscriptionExchangeOptions) => Ex
  */
 declare const stringify: (value: unknown) => string;
 //#endregion
-export { AggregatedError, type Artifact, type ArtifactKind, type CacheOptions, Client, type ClientOptions, type ComposeExchangeOptions, type DataOf, type Exchange, ExchangeError, type ExchangeErrorExtensionsMap, type ExchangeIO, type FragmentOptions, type FragmentRefs, GraphQLError, type HttpOptions, type MutationOptions, type Operation, type OperationError, type OperationMetadataMap, type OperationResult, type QueryOptions, type RetryOptions, type SchemaMeta, type SubscriptionClient, type SubscriptionExchangeOptions, type SubscriptionOptions, type VariablesOf, cacheExchange, composeExchange, createClient, dedupExchange, fragmentExchange, httpExchange, isAggregatedError, isExchangeError, isGraphQLError, retryExchange, stringify, subscriptionExchange };
+export { AggregatedError, type Artifact, type ArtifactKind, type CacheOptions, type CacheSnapshot, Client, type ClientOptions, type DataOf, type Exchange, ExchangeError, type ExchangeErrorExtensionsMap, type ExchangeExtensionMap, type ExchangeIO, type ExchangeResult, type FragmentOptions, type FragmentRefs, GraphQLError, type HttpOptions, type MutationOptions, type Operation, type OperationError, type OperationMetadata, type OperationMetadataMap, type OperationResult, type QueryOptions, type RequiredAction, RequiredFieldError, type RetryOptions, type SchemaMeta, type SubscriptionClient, type SubscriptionExchangeOptions, type SubscriptionOptions, type VariablesOf, cacheExchange, createClient, dedupExchange, fragmentExchange, httpExchange, isAggregatedError, isExchangeError, isGraphQLError, requiredExchange, retryExchange, stringify, subscriptionExchange };

package/dist/{index.d.ts → index.d.mts}

@@ -1,36 +1,6 @@
-import { Artifact, Artifact as Artifact$1, ArtifactKind, ArtifactKind as ArtifactKind$1, DataOf, FragmentRefs, FragmentRefs as FragmentRefs$1, SchemaMeta, SchemaMeta as SchemaMeta$1, VariablesOf, VariablesOf as VariablesOf$1 } from "@mearie/shared";
+import { k as Source } from "./make-Ve8TkMHJ.mjs";
+import { Artifact, Artifact as Artifact$1, ArtifactKind, ArtifactKind as ArtifactKind$1, DataOf, DataOf as DataOf$1, FragmentRefs, FragmentRefs as FragmentRefs$1, SchemaMeta, SchemaMeta as SchemaMeta$1, VariablesOf, VariablesOf as VariablesOf$1 } from "@mearie/shared";
 
-//#region src/stream/types.d.ts
-/**
- * Subscription allows cancelling a stream and cleaning up resources.
- */
-type Subscription = {
-  /**
-   * Cancel the stream and clean up resources.
-   */
-  unsubscribe(): void;
-};
-/**
- * Sink receives values from a Source.
- */
-type Sink<T> = {
-  /**
-   * Receive a data value.
-   * @param value - The data value.
-   */
-  next(value: T): void;
-  /**
-   * Receive completion signal.
-   */
-  complete(): void;
-};
-/**
- * Source is a function that accepts a Sink and returns a Subscription.
- * When called, it starts pushing values to the sink.
- * @returns A subscription that can be used to cancel the stream.
- */
-type Source<T> = (sink: Sink<T>) => Subscription;
-//#endregion
 //#region src/errors.d.ts
 /**
  *
@@ -94,10 +64,19 @@ type ScalarTransformer<TExternal = unknown, TInternal = unknown> = {
 type ScalarsConfig<TMeta extends SchemaMeta$1 = SchemaMeta$1> = { [K in keyof TMeta['scalars']]: ScalarTransformer<TMeta['scalars'][K], unknown> };
 //#endregion
 //#region src/client.d.ts
-type QueryOptions = {};
-type MutationOptions = {};
-type SubscriptionOptions = {};
-type FragmentOptions = {};
+type QueryOptions<T extends Artifact$1<'query'> = Artifact$1<'query'>> = {
+  initialData?: DataOf$1<T>;
+  metadata?: OperationMetadata;
+};
+type MutationOptions = {
+  metadata?: OperationMetadata;
+};
+type SubscriptionOptions = {
+  metadata?: OperationMetadata;
+};
+type FragmentOptions = {
+  metadata?: OperationMetadata;
+};
 type ClientOptions<T extends SchemaMeta$1> = {
   schema: T;
   exchanges: Exchange[];
@@ -114,31 +93,43 @@ declare class Client<TMeta extends SchemaMeta$1 = SchemaMeta$1> {
   get schema(): TMeta;
   get scalars(): ScalarsConfig<TMeta> | undefined;
   private createOperationKey;
-  createOperation(artifact: Artifact$1, variables?: unknown): Operation;
+  createOperation(artifact: Artifact$1, variables?: unknown, metadata?: OperationMetadata): Operation;
   executeOperation(operation: Operation): Source<OperationResult>;
-  executeQuery<T extends Artifact$1<'query'>>(artifact: T, ...[variables, options]: VariablesOf$1<T> extends undefined ? [undefined?, QueryOptions?] : [VariablesOf$1<T>, QueryOptions?]): Source<OperationResult>;
+  executeQuery<T extends Artifact$1<'query'>>(artifact: T, ...[variables, options]: VariablesOf$1<T> extends undefined ? [undefined?, QueryOptions<T>?] : [VariablesOf$1<T>, QueryOptions<T>?]): Source<OperationResult>;
   executeMutation<T extends Artifact$1<'mutation'>>(artifact: T, ...[variables, options]: VariablesOf$1<T> extends undefined ? [undefined?, MutationOptions?] : [VariablesOf$1<T>, MutationOptions?]): Source<OperationResult>;
   executeSubscription<T extends Artifact$1<'subscription'>>(artifact: T, ...[variables, options]: VariablesOf$1<T> extends undefined ? [undefined?, SubscriptionOptions?] : [VariablesOf$1<T>, SubscriptionOptions?]): Source<OperationResult>;
-  executeFragment<T extends Artifact$1<'fragment'>>(artifact: T, fragmentRef: FragmentRefs$1<T['name']>, options?: FragmentOptions): Source<OperationResult>;
+  executeFragment<T extends Artifact$1<'fragment'>>(artifact: T, fragmentRef: FragmentRefs$1<T['name']> | FragmentRefs$1<T['name']>[], options?: FragmentOptions): Source<OperationResult>;
+  query<T extends Artifact$1<'query'>>(artifact: T, ...[variables, options]: VariablesOf$1<T> extends undefined ? [undefined?, QueryOptions<T>?] : [VariablesOf$1<T>, QueryOptions<T>?]): Promise<DataOf$1<T>>;
+  mutation<T extends Artifact$1<'mutation'>>(artifact: T, ...[variables, options]: VariablesOf$1<T> extends undefined ? [undefined?, MutationOptions?] : [VariablesOf$1<T>, MutationOptions?]): Promise<DataOf$1<T>>;
+  /**
+   * Returns the extension registered by a named exchange.
+   * @param name - The exchange name.
+   * @returns The extension object provided by the exchange.
+   */
+  extension<TName extends keyof ExchangeExtensionMap>(name: TName): ExchangeExtensionMap[TName];
+  extension(name: string): unknown;
+  maybeExtension<TName extends keyof ExchangeExtensionMap>(name: TName): ExchangeExtensionMap[TName] | undefined;
+  maybeExtension(name: string): unknown;
   dispose(): void;
 }
 declare const createClient: <T extends SchemaMeta$1>(config: ClientOptions<T>) => Client<T>;
 //#endregion
 //#region src/exchange.d.ts
 interface OperationMetadataMap {}
+type OperationMetadata = { [K in keyof OperationMetadataMap]?: OperationMetadataMap[K] } & Record<string, unknown>;
 type BaseOperation = {
   key: string;
   metadata: OperationMetadataMap & Record<string, unknown>;
 };
-type RequestOperation<K$1 extends ArtifactKind$1 = ArtifactKind$1> = BaseOperation & {
+type RequestOperation<K extends ArtifactKind$1 = ArtifactKind$1> = BaseOperation & {
   variant: 'request';
-  artifact: Artifact$1<K$1>;
-  variables: VariablesOf$1<Artifact$1<K$1>>;
+  artifact: Artifact$1<K>;
+  variables: VariablesOf$1<Artifact$1<K>>;
 };
 type TeardownOperation = BaseOperation & {
   variant: 'teardown';
 };
-type Operation<K$1 extends ArtifactKind$1 = ArtifactKind$1> = RequestOperation<K$1> | TeardownOperation;
+type Operation<K extends ArtifactKind$1 = ArtifactKind$1> = RequestOperation<K> | TeardownOperation;
 type OperationResult = {
   operation: Operation;
   data?: unknown;
@@ -151,16 +142,17 @@ type ExchangeInput<TMeta extends SchemaMeta$1 = SchemaMeta$1> = {
   client: Client<TMeta>;
 };
 type ExchangeIO = (operations: Source<Operation>) => Source<OperationResult>;
-type Exchange = <TMeta extends SchemaMeta$1 = SchemaMeta$1>(input: ExchangeInput<TMeta>) => ExchangeIO;
-//#endregion
-//#region src/exchanges/compose.d.ts
-type ComposeExchangeOptions = {
-  exchanges: Exchange[];
-};
-declare const composeExchange: (options: ComposeExchangeOptions) => Exchange;
+interface ExchangeExtensionMap {}
+type ExchangeResult<TName extends keyof ExchangeExtensionMap | (string & {}) = string> = {
+  name: TName;
+  io: ExchangeIO;
+} & (TName extends keyof ExchangeExtensionMap ? {
+  extension: ExchangeExtensionMap[TName];
+} : {});
+type Exchange<TName extends keyof ExchangeExtensionMap | (string & {}) = string> = <TMeta extends SchemaMeta$1 = SchemaMeta$1>(input: ExchangeInput<TMeta>) => ExchangeResult<TName>;
 //#endregion
 //#region src/exchanges/http.d.ts
-declare module '../errors.ts' {
+declare module '@mearie/core' {
   interface ExchangeErrorExtensionsMap {
     http?: {
       statusCode?: number;
@@ -172,11 +164,12 @@ type HttpOptions = {
   headers?: HeadersInit;
   mode?: RequestMode;
   credentials?: RequestCredentials;
+  fetch?: typeof globalThis.fetch;
 };
 declare const httpExchange: (options: HttpOptions) => Exchange;
 //#endregion
 //#region src/exchanges/dedup.d.ts
-declare module '../exchange.ts' {
+declare module '@mearie/core' {
   interface OperationMetadataMap {
     dedup?: {
       skip?: boolean;
@@ -200,14 +193,64 @@ declare module '../exchange.ts' {
  */
 declare const dedupExchange: () => Exchange;
 //#endregion
+//#region src/cache/types.d.ts
+/**
+ * Identifier for a single entity, supporting simple or composite keys.
+ */
+type EntityId = string | number | Record<string, string | number>;
+/**
+ * Target specification for cache invalidation operations.
+ */
+type InvalidateTarget = {
+  __typename: string;
+  id: EntityId;
+} | {
+  __typename: string;
+  id: EntityId;
+  field: string;
+  args?: Record<string, unknown>;
+} | {
+  __typename: 'Query';
+} | {
+  __typename: 'Query';
+  field: string;
+  args?: Record<string, unknown>;
+} | {
+  __typename: string;
+} | {
+  __typename: string;
+  field: string;
+  args?: Record<string, unknown>;
+};
+/**
+ * Opaque type representing a serializable cache snapshot.
+ */
+type CacheSnapshot = {
+  readonly __brand: unique symbol;
+};
+/**
+ * Operations available for programmatic cache manipulation.
+ */
+type CacheOperations = {
+  extract(): CacheSnapshot;
+  hydrate(data: CacheSnapshot): void;
+  invalidate(...targets: InvalidateTarget[]): void;
+  clear(): void;
+};
+//#endregion
 //#region src/exchanges/cache.d.ts
+declare module '@mearie/core' {
+  interface ExchangeExtensionMap {
+    cache: CacheOperations;
+  }
+}
 type CacheOptions = {
   fetchPolicy?: 'cache-first' | 'cache-and-network' | 'network-only' | 'cache-only';
 };
-declare const cacheExchange: (options?: CacheOptions) => Exchange;
+declare const cacheExchange: (options?: CacheOptions) => Exchange<"cache">;
 //#endregion
 //#region src/exchanges/retry.d.ts
-declare module '../exchange.ts' {
+declare module '@mearie/core' {
   interface OperationMetadataMap {
     retry?: {
       attempt: number;
@@ -223,13 +266,16 @@ type RetryOptions = {
 declare const retryExchange: (options?: RetryOptions) => Exchange;
 //#endregion
 //#region src/exchanges/fragment.d.ts
-declare module '../exchange.ts' {
+declare module '@mearie/core' {
   interface OperationMetadataMap {
     fragmentRef?: unknown;
   }
 }
 declare const fragmentExchange: () => Exchange;
 //#endregion
+//#region src/exchanges/required.d.ts
+declare const requiredExchange: () => Exchange;
+//#endregion
 //#region src/exchanges/subscription.d.ts
 interface SubscriptionClient {
   subscribe(payload: {
@@ -244,6 +290,13 @@ interface SubscriptionClient {
 type SubscriptionExchangeOptions = {
   client: SubscriptionClient;
 };
+declare module '@mearie/core' {
+  interface OperationMetadataMap {
+    subscription?: {
+      transport?: boolean;
+    };
+  }
+}
 /**
  * Creates an exchange for handling GraphQL subscriptions using a subscription client.
  *
@@ -273,6 +326,14 @@ type SubscriptionExchangeOptions = {
  */
 declare const subscriptionExchange: (options: SubscriptionExchangeOptions) => Exchange;
 //#endregion
+//#region src/required.d.ts
+type RequiredAction = 'THROW' | 'CASCADE';
+declare class RequiredFieldError extends Error {
+  fieldPath: string[];
+  fieldName: string;
+  constructor(fieldPath: string[], fieldName: string);
+}
+//#endregion
 //#region src/utils.d.ts
 /**
  * Stable JSON serialization with sorted keys.
@@ -283,4 +344,4 @@ declare const subscriptionExchange: (options: SubscriptionExchangeOptions) => Ex
  */
 declare const stringify: (value: unknown) => string;
 //#endregion
-export { AggregatedError, type Artifact, type ArtifactKind, type CacheOptions, Client, type ClientOptions, type ComposeExchangeOptions, type DataOf, type Exchange, ExchangeError, type ExchangeErrorExtensionsMap, type ExchangeIO, type FragmentOptions, type FragmentRefs, GraphQLError, type HttpOptions, type MutationOptions, type Operation, type OperationError, type OperationMetadataMap, type OperationResult, type QueryOptions, type RetryOptions, type SchemaMeta, type SubscriptionClient, type SubscriptionExchangeOptions, type SubscriptionOptions, type VariablesOf, cacheExchange, composeExchange, createClient, dedupExchange, fragmentExchange, httpExchange, isAggregatedError, isExchangeError, isGraphQLError, retryExchange, stringify, subscriptionExchange };
+export { AggregatedError, type Artifact, type ArtifactKind, type CacheOptions, type CacheSnapshot, Client, type ClientOptions, type DataOf, type Exchange, ExchangeError, type ExchangeErrorExtensionsMap, type ExchangeExtensionMap, type ExchangeIO, type ExchangeResult, type FragmentOptions, type FragmentRefs, GraphQLError, type HttpOptions, type MutationOptions, type Operation, type OperationError, type OperationMetadata, type OperationMetadataMap, type OperationResult, type QueryOptions, type RequiredAction, RequiredFieldError, type RetryOptions, type SchemaMeta, type SubscriptionClient, type SubscriptionExchangeOptions, type SubscriptionOptions, type VariablesOf, cacheExchange, createClient, dedupExchange, fragmentExchange, httpExchange, isAggregatedError, isExchangeError, isGraphQLError, requiredExchange, retryExchange, stringify, subscriptionExchange };