pankod/refine

View on GitHub
packages/core/src/hooks/router/use-go/index.tsx

Summary

Maintainability
A
1 hr
Test Coverage
import React, { useCallback, useContext } from "react";

import { RouterContext } from "@contexts/router";
import { useResource } from "@hooks/resource";

import { BaseKey } from "../../../contexts/data/types";
import { IResourceItem } from "../../../contexts/resource/types";
import {
  Action,
  GoConfig as GoConfigBase,
} from "../../../contexts/router/types";
import { useGetToPath } from "../use-get-to-path";

type ResourceWithoutId = {
  /**
   *  The name or identifier of the resource.
   */
  resource: string;
  action: Extract<Action, "create" | "list">;
  id?: never;
  meta?: Record<string, unknown>;
};

type ResourceWithId = {
  /**
   *  The name or identifier of the resource.
   */
  resource: string;
  action: Extract<Action, "edit" | "show" | "clone">;
  id: BaseKey;
  meta?: Record<string, unknown>;
};

export type Resource = ResourceWithoutId | ResourceWithId;

export type GoConfigWithResource = Omit<GoConfigBase, "to"> & {
  to?: GoConfigBase["to"] | Resource;
};

export const useGo = () => {
  const routerContext = useContext(RouterContext);
  const { select: resourceSelect } = useResource();
  const getToPath = useGetToPath();

  const useGo = React.useMemo(
    () => routerContext?.go ?? (() => () => undefined),
    [routerContext?.go],
  );

  const goFromRouter = useGo();

  const go = useCallback(
    (config: GoConfigWithResource | GoConfigBase) => {
      if (typeof config.to !== "object") {
        return goFromRouter({ ...config, to: config.to });
      }

      // when config.to is an object, it means that we want to go to a resource.
      // so we need to find the path for the resource.
      const { resource } = resourceSelect(config.to.resource);
      handleResourceErrors(config.to, resource);
      const newTo = getToPath({
        resource,
        action: config.to.action,
        meta: {
          id: config.to.id,
          ...config.to.meta,
        },
      });

      return goFromRouter({
        ...config,
        to: newTo,
      });
    },
    [resourceSelect, goFromRouter],
  );

  return go;
};

/**
 * handle errors for resource
 * @internal
 */
export const handleResourceErrors = (to: Resource, resource: IResourceItem) => {
  if (!to?.action || !to?.resource) {
    throw new Error(`[useGo]: "action" or "resource" is required.`);
  }

  if (["edit", "show", "clone"].includes(to?.action) && !to.id) {
    throw new Error(
      `[useGo]: [action: ${to.action}] requires an "id" for resource [resource: ${to.resource}]`,
    );
  }

  const actionUrl = resource[to.action];
  if (!actionUrl) {
    throw new Error(
      `[useGo]: [action: ${to.action}] is not defined for [resource: ${to.resource}]`,
    );
  }
};