@trpc/tanstack-react-query 0.0.0-alpha.0

package/dist/internals/mutationOptions.d.ts

@@ -0,0 +1,38 @@
+import { type QueryClient, type UseMutationOptions } from '@tanstack/react-query';
+import type { TRPCClientErrorLike, TRPCUntypedClient } from '@trpc/client';
+import type { DistributiveOmit, MaybePromise } from '@trpc/server/unstable-core-do-not-import';
+import type { ResolverDef, TRPCMutationKey, TRPCQueryBaseOptions, TRPCQueryOptionsResult } from './types';
+type ReservedOptions = 'mutationKey' | 'mutationFn';
+interface TRPCMutationOptionsIn<TInput, TError, TOutput, TContext> extends DistributiveOmit<UseMutationOptions<TOutput, TError, TInput, TContext>, ReservedOptions>, TRPCQueryBaseOptions {
+}
+interface TRPCMutationOptionsOut<TInput, TError, TOutput, TContext> extends UseMutationOptions<TOutput, TError, TInput, TContext>, TRPCQueryOptionsResult {
+    mutationKey: TRPCMutationKey;
+}
+export interface TRPCMutationOptions<TDef extends ResolverDef> {
+    <TContext = unknown>(opts?: TRPCMutationOptionsIn<TDef['input'], TRPCClientErrorLike<TDef>, TDef['output'], TContext>): TRPCMutationOptionsOut<TDef['input'], TRPCClientErrorLike<TDef>, TDef['output'], TContext>;
+}
+/**
+ * @internal
+ */
+export interface MutationOptionsOverride {
+    onSuccess: (opts: {
+        /**
+         * Calls the original function that was defined in the query's `onSuccess` option
+         */
+        originalFn: () => MaybePromise<unknown>;
+        queryClient: QueryClient;
+        /**
+         * Meta data passed in from the `useMutation()` hook
+         */
+        meta: Record<string, unknown>;
+    }) => MaybePromise<unknown>;
+}
+export declare function trpcMutationOptions(args: {
+    mutate: typeof TRPCUntypedClient.prototype.mutation;
+    queryClient: QueryClient | (() => QueryClient);
+    path: readonly string[];
+    opts: TRPCMutationOptionsIn<unknown, unknown, unknown, unknown> | undefined;
+    overrides: MutationOptionsOverride | undefined;
+}): TRPCMutationOptionsOut<unknown, unknown, unknown, unknown>;
+export {};
+//# sourceMappingURL=mutationOptions.d.ts.map

package/dist/internals/mutationOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutationOptions.d.ts","sourceRoot":"","sources":["../../src/internals/mutationOptions.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACb,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAQjB,KAAK,eAAe,GAAG,aAAa,GAAG,YAAY,CAAC;AAEpD,UAAU,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAC/D,SAAQ,gBAAgB,CACpB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EACrD,eAAe,CAChB,EACD,oBAAoB;CAAG;AAE3B,UAAU,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAChE,SAAQ,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAC3D,sBAAsB;IACxB,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB,CAAC,IAAI,SAAS,WAAW;IAC3D,CAAC,QAAQ,GAAG,OAAO,EACjB,IAAI,CAAC,EAAE,qBAAqB,CAC1B,IAAI,CAAC,OAAO,CAAC,EACb,mBAAmB,CAAC,IAAI,CAAC,EACzB,IAAI,CAAC,QAAQ,CAAC,EACd,QAAQ,CACT,GACA,sBAAsB,CACvB,IAAI,CAAC,OAAO,CAAC,EACb,mBAAmB,CAAC,IAAI,CAAC,EACzB,IAAI,CAAC,QAAQ,CAAC,EACd,QAAQ,CACT,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,CAAC,IAAI,EAAE;QAChB;;WAEG;QACH,UAAU,EAAE,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QACxC,WAAW,EAAE,WAAW,CAAC;QACzB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,OAAO,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC;IACpD,WAAW,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,CAAC;IAC/C,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5E,SAAS,EAAE,uBAAuB,GAAG,SAAS,CAAC;CAChD,GAAG,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAmC7D"}

package/dist/internals/mutationOptions.js

@@ -0,0 +1,38 @@
+'use strict';
+
+var utils = require('./utils.js');
+
+function trpcMutationOptions(args) {
+    const { mutate, path, opts, overrides } = args;
+    const queryClient = utils.unwrapLazyArg(args.queryClient);
+    const mutationKey = utils.getMutationKeyInternal(path);
+    const defaultOpts = queryClient.defaultMutationOptions(queryClient.getMutationDefaults(mutationKey));
+    const mutationSuccessOverride = overrides?.onSuccess ?? ((options)=>options.originalFn());
+    const mutationFn = async (input)=>{
+        const result = await mutate(...utils.getClientArgs([
+            path,
+            {
+                input
+            }
+        ], opts));
+        return result;
+    };
+    return {
+        ...opts,
+        mutationKey: mutationKey,
+        mutationFn,
+        onSuccess (...args) {
+            const originalFn = ()=>opts?.onSuccess?.(...args) ?? defaultOpts?.onSuccess?.(...args);
+            return mutationSuccessOverride({
+                originalFn,
+                queryClient,
+                meta: opts?.meta ?? defaultOpts?.meta ?? {}
+            });
+        },
+        trpc: utils.createTRPCOptionsResult({
+            path
+        })
+    };
+}
+
+exports.trpcMutationOptions = trpcMutationOptions;

package/dist/internals/mutationOptions.mjs

@@ -0,0 +1,36 @@
+import { unwrapLazyArg, getMutationKeyInternal, createTRPCOptionsResult, getClientArgs } from './utils.mjs';
+
+function trpcMutationOptions(args) {
+    const { mutate, path, opts, overrides } = args;
+    const queryClient = unwrapLazyArg(args.queryClient);
+    const mutationKey = getMutationKeyInternal(path);
+    const defaultOpts = queryClient.defaultMutationOptions(queryClient.getMutationDefaults(mutationKey));
+    const mutationSuccessOverride = overrides?.onSuccess ?? ((options)=>options.originalFn());
+    const mutationFn = async (input)=>{
+        const result = await mutate(...getClientArgs([
+            path,
+            {
+                input
+            }
+        ], opts));
+        return result;
+    };
+    return {
+        ...opts,
+        mutationKey: mutationKey,
+        mutationFn,
+        onSuccess (...args) {
+            const originalFn = ()=>opts?.onSuccess?.(...args) ?? defaultOpts?.onSuccess?.(...args);
+            return mutationSuccessOverride({
+                originalFn,
+                queryClient,
+                meta: opts?.meta ?? defaultOpts?.meta ?? {}
+            });
+        },
+        trpc: createTRPCOptionsResult({
+            path
+        })
+    };
+}
+
+export { trpcMutationOptions };

package/dist/internals/queryOptions.d.ts

@@ -0,0 +1,61 @@
+import type { DataTag, DefinedInitialDataOptions, QueryClient, UndefinedInitialDataOptions, UnusedSkipTokenOptions } from '@tanstack/react-query';
+import { type SkipToken } from '@tanstack/react-query';
+import type { TRPCClientErrorLike, TRPCUntypedClient } from '@trpc/client';
+import type { coerceAsyncIterableToArray, DistributiveOmit } from '@trpc/server/unstable-core-do-not-import';
+import type { ResolverDef, TRPCQueryBaseOptions, TRPCQueryKey, TRPCQueryOptionsResult } from './types';
+type ReservedOptions = 'queryKey' | 'queryFn' | 'queryHashFn' | 'queryHash';
+interface UndefinedTRPCQueryOptionsIn<TQueryFnData, TData, TError> extends DistributiveOmit<UndefinedInitialDataOptions<coerceAsyncIterableToArray<TQueryFnData>, TError, coerceAsyncIterableToArray<TData>, TRPCQueryKey>, ReservedOptions>, TRPCQueryBaseOptions {
+}
+interface UndefinedTRPCQueryOptionsOut<TQueryFnData, TOutput, TError> extends UndefinedInitialDataOptions<coerceAsyncIterableToArray<TQueryFnData>, TError, coerceAsyncIterableToArray<TOutput>, TRPCQueryKey>, TRPCQueryOptionsResult {
+    queryKey: DataTag<TRPCQueryKey, coerceAsyncIterableToArray<TOutput>>;
+}
+interface DefinedTRPCQueryOptionsIn<TQueryFnData, TData, TError> extends DistributiveOmit<DefinedInitialDataOptions<coerceAsyncIterableToArray<TQueryFnData>, TError, coerceAsyncIterableToArray<TData>, TRPCQueryKey>, ReservedOptions>, TRPCQueryBaseOptions {
+}
+interface DefinedTRPCQueryOptionsOut<TQueryFnData, TData, TError> extends DefinedInitialDataOptions<coerceAsyncIterableToArray<TQueryFnData>, TError, coerceAsyncIterableToArray<TData>, TRPCQueryKey>, TRPCQueryOptionsResult {
+    queryKey: DataTag<TRPCQueryKey, coerceAsyncIterableToArray<TData>>;
+}
+interface UnusedSkipTokenTRPCQueryOptionsIn<TQueryFnData, TData, TError> extends DistributiveOmit<UnusedSkipTokenOptions<coerceAsyncIterableToArray<TQueryFnData>, TError, coerceAsyncIterableToArray<TData>, TRPCQueryKey>, ReservedOptions>, TRPCQueryBaseOptions {
+}
+interface UnusedSkipTokenTRPCQueryOptionsOut<TQueryFnData, TOutput, TError> extends UnusedSkipTokenOptions<coerceAsyncIterableToArray<TQueryFnData>, TError, coerceAsyncIterableToArray<TOutput>, TRPCQueryKey>, TRPCQueryOptionsResult {
+    queryKey: DataTag<TRPCQueryKey, coerceAsyncIterableToArray<TOutput>>;
+}
+export interface TRPCQueryOptions<TDef extends ResolverDef> {
+    <TQueryFnData extends TDef['output'], TData = TQueryFnData>(input: TDef['input'] | SkipToken, opts: DefinedTRPCQueryOptionsIn<TQueryFnData, TData, TRPCClientErrorLike<{
+        transformer: TDef['transformer'];
+        errorShape: TDef['errorShape'];
+    }>>): DefinedTRPCQueryOptionsOut<TQueryFnData, TData, TRPCClientErrorLike<{
+        transformer: TDef['transformer'];
+        errorShape: TDef['errorShape'];
+    }>>;
+    <TQueryFnData extends TDef['output'], TData = TQueryFnData>(input: TDef['input'], opts?: UnusedSkipTokenTRPCQueryOptionsIn<TQueryFnData, TData, TRPCClientErrorLike<{
+        transformer: TDef['transformer'];
+        errorShape: TDef['errorShape'];
+    }>>): UnusedSkipTokenTRPCQueryOptionsOut<TQueryFnData, TData, TRPCClientErrorLike<{
+        transformer: TDef['transformer'];
+        errorShape: TDef['errorShape'];
+    }>>;
+    <TQueryFnData extends TDef['output'], TData = TQueryFnData>(input: TDef['input'] | SkipToken, opts?: UndefinedTRPCQueryOptionsIn<TQueryFnData, TData, TRPCClientErrorLike<{
+        transformer: TDef['transformer'];
+        errorShape: TDef['errorShape'];
+    }>>): UndefinedTRPCQueryOptionsOut<TQueryFnData, TData, TRPCClientErrorLike<{
+        transformer: TDef['transformer'];
+        errorShape: TDef['errorShape'];
+    }>>;
+}
+export declare function trpcQueryOptions(args: {
+    query: typeof TRPCUntypedClient.prototype.query;
+    queryClient: QueryClient | (() => QueryClient);
+    path: readonly string[];
+    queryKey: TRPCQueryKey;
+    opts: UndefinedTRPCQueryOptionsIn<unknown, unknown, unknown>;
+}): import("@tanstack/react-query").UseQueryOptions<unknown, unknown, unknown, TRPCQueryKey> & {
+    initialData?: unknown;
+} & {
+    queryKey: DataTag<TRPCQueryKey, unknown>;
+} & {
+    trpc: {
+        path: string;
+    };
+};
+export {};
+//# sourceMappingURL=queryOptions.d.ts.map

package/dist/internals/queryOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryOptions.d.ts","sourceRoot":"","sources":["../../src/internals/queryOptions.ts"],"names":[],"mappings":"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"}

package/dist/internals/queryOptions.js

@@ -0,0 +1,40 @@
+'use strict';
+
+var reactQuery = require('@tanstack/react-query');
+var unstableCoreDoNotImport = require('@trpc/server/unstable-core-do-not-import');
+var utils = require('./utils.js');
+
+function trpcQueryOptions(args) {
+    const { query, path, queryKey, opts } = args;
+    const queryClient = utils.unwrapLazyArg(args.queryClient);
+    const inputIsSkipToken = queryKey[1]?.input === reactQuery.skipToken;
+    const queryFn = async (queryFnContext)=>{
+        const actualOpts = {
+            ...opts,
+            trpc: {
+                ...opts?.trpc,
+                ...opts?.trpc?.abortOnUnmount ? {
+                    signal: queryFnContext.signal
+                } : {
+                    signal: null
+                }
+            }
+        };
+        const result = await query(...utils.getClientArgs(queryKey, actualOpts));
+        if (unstableCoreDoNotImport.isAsyncIterable(result)) {
+            return utils.buildQueryFromAsyncIterable(result, queryClient, queryKey);
+        }
+        return result;
+    };
+    return Object.assign(reactQuery.queryOptions({
+        ...opts,
+        queryKey,
+        queryFn: inputIsSkipToken ? reactQuery.skipToken : queryFn
+    }), {
+        trpc: utils.createTRPCOptionsResult({
+            path
+        })
+    });
+}
+
+exports.trpcQueryOptions = trpcQueryOptions;

package/dist/internals/queryOptions.mjs

@@ -0,0 +1,38 @@
+import { skipToken, queryOptions } from '@tanstack/react-query';
+import { isAsyncIterable } from '@trpc/server/unstable-core-do-not-import';
+import { unwrapLazyArg, createTRPCOptionsResult, getClientArgs, buildQueryFromAsyncIterable } from './utils.mjs';
+
+function trpcQueryOptions(args) {
+    const { query, path, queryKey, opts } = args;
+    const queryClient = unwrapLazyArg(args.queryClient);
+    const inputIsSkipToken = queryKey[1]?.input === skipToken;
+    const queryFn = async (queryFnContext)=>{
+        const actualOpts = {
+            ...opts,
+            trpc: {
+                ...opts?.trpc,
+                ...opts?.trpc?.abortOnUnmount ? {
+                    signal: queryFnContext.signal
+                } : {
+                    signal: null
+                }
+            }
+        };
+        const result = await query(...getClientArgs(queryKey, actualOpts));
+        if (isAsyncIterable(result)) {
+            return buildQueryFromAsyncIterable(result, queryClient, queryKey);
+        }
+        return result;
+    };
+    return Object.assign(queryOptions({
+        ...opts,
+        queryKey,
+        queryFn: inputIsSkipToken ? skipToken : queryFn
+    }), {
+        trpc: createTRPCOptionsResult({
+            path
+        })
+    });
+}
+
+export { trpcQueryOptions };

package/dist/internals/subscriptionOptions.d.ts

@@ -0,0 +1,77 @@
+import { type SkipToken } from '@tanstack/react-query';
+import type { TRPCClientErrorLike, TRPCUntypedClient } from '@trpc/client';
+import type { TRPCConnectionState } from '@trpc/client/unstable-internals';
+import type { Unsubscribable } from '@trpc/server/observable';
+import type { inferAsyncIterableYield } from '@trpc/server/unstable-core-do-not-import';
+import type { ResolverDef, TRPCQueryKey, TRPCQueryOptionsResult } from './types';
+interface BaseTRPCSubscriptionOptionsIn<TOutput, TError> {
+    enabled?: boolean;
+    onStarted?: () => void;
+    onData: (data: inferAsyncIterableYield<TOutput>) => void;
+    onError?: (err: TError) => void;
+}
+interface UnusedSkipTokenTRPCSubscriptionOptionsIn<TOutput, TError> {
+    onStarted?: () => void;
+    onData: (data: inferAsyncIterableYield<TOutput>) => void;
+    onError?: (err: TError) => void;
+    onConnectionStateChange: (state: TRPCConnectionState<TError>) => void;
+}
+interface TRPCSubscriptionOptionsOut<TOutput, TError> extends UnusedSkipTokenTRPCSubscriptionOptionsIn<TOutput, TError>, TRPCQueryOptionsResult {
+    enabled: boolean;
+    queryKey: TRPCQueryKey;
+    subscribe: (innerOpts: UnusedSkipTokenTRPCSubscriptionOptionsIn<TOutput, TError>) => Unsubscribable;
+}
+export interface TRPCSubscriptionOptions<TDef extends ResolverDef> {
+    (input: TDef['input'], opts?: UnusedSkipTokenTRPCSubscriptionOptionsIn<inferAsyncIterableYield<TDef['output']>, TRPCClientErrorLike<TDef>>): TRPCSubscriptionOptionsOut<inferAsyncIterableYield<TDef['output']>, TRPCClientErrorLike<TDef>>;
+    (input: TDef['input'] | SkipToken, opts?: BaseTRPCSubscriptionOptionsIn<inferAsyncIterableYield<TDef['output']>, TRPCClientErrorLike<TDef>>): TRPCSubscriptionOptionsOut<inferAsyncIterableYield<TDef['output']>, TRPCClientErrorLike<TDef>>;
+}
+export type TRPCSubscriptionStatus = 'idle' | 'connecting' | 'pending' | 'error';
+export interface TRPCSubscriptionBaseResult<TOutput, TError> {
+    status: TRPCSubscriptionStatus;
+    data: undefined | TOutput;
+    error: null | TError;
+    /**
+     * Reset the subscription
+     */
+    reset: () => void;
+}
+export interface TRPCSubscriptionIdleResult<TOutput> extends TRPCSubscriptionBaseResult<TOutput, null> {
+    status: 'idle';
+    data: undefined;
+    error: null;
+}
+export interface TRPCSubscriptionConnectingResult<TOutput, TError> extends TRPCSubscriptionBaseResult<TOutput, TError> {
+    status: 'connecting';
+    data: undefined | TOutput;
+    error: TError | null;
+}
+export interface TRPCSubscriptionPendingResult<TOutput> extends TRPCSubscriptionBaseResult<TOutput, undefined> {
+    status: 'pending';
+    data: TOutput;
+    error: null;
+}
+export interface TRPCSubscriptionErrorResult<TOutput, TError> extends TRPCSubscriptionBaseResult<TOutput, TError> {
+    status: 'error';
+    data: TOutput | undefined;
+    error: TError;
+}
+export type TRPCSubscriptionResult<TOutput, TError> = TRPCSubscriptionIdleResult<TOutput> | TRPCSubscriptionConnectingResult<TOutput, TError> | TRPCSubscriptionErrorResult<TOutput, TError> | TRPCSubscriptionPendingResult<TOutput>;
+export declare const trpcSubscriptionOptions: (args: {
+    subscribe: typeof TRPCUntypedClient.prototype.subscription;
+    path: readonly string[];
+    queryKey: TRPCQueryKey;
+    opts: BaseTRPCSubscriptionOptionsIn<unknown, unknown> | undefined;
+}) => {
+    enabled: boolean;
+    subscribe: (innerOpts: UnusedSkipTokenTRPCSubscriptionOptionsIn<any, TRPCClientErrorLike<any>>) => Unsubscribable;
+    queryKey: TRPCQueryKey;
+    trpc: {
+        path: string;
+    };
+    onStarted?: () => void;
+    onData?: ((data: unknown) => void) | undefined;
+    onError?: ((err: unknown) => void) | undefined;
+};
+export declare function useSubscription<TOutput, TError>(opts: TRPCSubscriptionOptionsOut<TOutput, TError>): TRPCSubscriptionResult<TOutput, TError>;
+export {};
+//# sourceMappingURL=subscriptionOptions.d.ts.map

package/dist/internals/subscriptionOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptionOptions.d.ts","sourceRoot":"","sources":["../../src/internals/subscriptionOptions.ts"],"names":[],"mappings":"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"}

package/dist/internals/subscriptionOptions.js

@@ -0,0 +1,173 @@
+'use strict';
+
+var reactQuery = require('@tanstack/react-query');
+var React = require('react');
+var utils = require('./utils.js');
+
+function _interopNamespaceDefault(e) {
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespaceDefault(React);
+
+const trpcSubscriptionOptions = (args)=>{
+    const { subscribe, path, queryKey, opts } = args;
+    const input = queryKey[1]?.input;
+    const enabled = opts?.enabled ?? input !== reactQuery.skipToken;
+    const _subscribe = (innerOpts)=>{
+        return subscribe(path.join('.'), input ?? undefined, innerOpts);
+    };
+    return {
+        ...opts,
+        enabled,
+        subscribe: _subscribe,
+        queryKey,
+        trpc: utils.createTRPCOptionsResult({
+            path
+        })
+    };
+};
+function useSubscription(opts) {
+    const optsRef = React__namespace.useRef(opts);
+    optsRef.current = opts;
+    const trackedProps = React__namespace.useRef(new Set([]));
+    const addTrackedProp = React__namespace.useCallback((key)=>{
+        trackedProps.current.add(key);
+    }, []);
+    const currentSubscriptionRef = React__namespace.useRef();
+    const reset = React__namespace.useCallback(()=>{
+        // unsubscribe from the previous subscription
+        currentSubscriptionRef.current?.();
+        updateState(getInitialState);
+        if (!opts.enabled) {
+            return;
+        }
+        let isStopped = false;
+        const subscription = opts.subscribe({
+            onStarted: ()=>{
+                if (!isStopped) {
+                    optsRef.current.onStarted?.();
+                    updateState((prev)=>({
+                            ...prev,
+                            status: 'pending',
+                            error: null
+                        }));
+                }
+            },
+            onData: (data)=>{
+                if (!isStopped) {
+                    optsRef.current.onData?.(data);
+                    updateState((prev)=>({
+                            ...prev,
+                            status: 'pending',
+                            data,
+                            error: null
+                        }));
+                }
+            },
+            onError: (error)=>{
+                if (!isStopped) {
+                    optsRef.current.onError?.(error);
+                    updateState((prev)=>({
+                            ...prev,
+                            status: 'error',
+                            error
+                        }));
+                }
+            },
+            onConnectionStateChange: (result)=>{
+                const delta = {
+                    status: result.state,
+                    error: result.error
+                };
+                updateState((prev)=>{
+                    return {
+                        ...prev,
+                        ...delta
+                    };
+                });
+            }
+        });
+        currentSubscriptionRef.current = ()=>{
+            isStopped = true;
+            subscription.unsubscribe();
+        };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        reactQuery.hashKey(opts.queryKey),
+        opts.enabled
+    ]);
+    const getInitialState = React__namespace.useCallback(()=>{
+        return opts.enabled ? {
+            data: undefined,
+            error: null,
+            status: 'connecting',
+            reset
+        } : {
+            data: undefined,
+            error: null,
+            status: 'idle',
+            reset
+        };
+    }, [
+        opts.enabled,
+        reset
+    ]);
+    const resultRef = React__namespace.useRef(getInitialState());
+    const [state, setState] = React__namespace.useState(trackResult(resultRef.current, addTrackedProp));
+    state.reset = reset;
+    const updateState = React__namespace.useCallback((callback)=>{
+        const prev = resultRef.current;
+        const next = resultRef.current = callback(prev);
+        let shouldUpdate = false;
+        for (const key of trackedProps.current){
+            if (prev[key] !== next[key]) {
+                shouldUpdate = true;
+                break;
+            }
+        }
+        if (shouldUpdate) {
+            setState(trackResult(next, addTrackedProp));
+        }
+    }, [
+        addTrackedProp
+    ]);
+    React__namespace.useEffect(()=>{
+        if (!opts.enabled) {
+            return;
+        }
+        reset();
+        return ()=>{
+            currentSubscriptionRef.current?.();
+        };
+    }, [
+        reset,
+        opts.enabled
+    ]);
+    return state;
+}
+function trackResult(result, onTrackResult) {
+    const trackedResult = new Proxy(result, {
+        get (target, prop) {
+            onTrackResult(prop);
+            return target[prop];
+        }
+    });
+    return trackedResult;
+}
+
+exports.trpcSubscriptionOptions = trpcSubscriptionOptions;
+exports.useSubscription = useSubscription;