@digi-frontend/dgate-api-documentation 4.0.8 → 4.1.1

package/dist/index.mjs

@@ -1592,7 +1592,7 @@ const ViewModeApiHeader = ({ api, viewLayout, onViewLayoutChange }) => {
 };
 //#endregion
 //#region src/view/components/ApiPage/index.tsx
-const APIPage = () => {
+const APIPage = ({ apiOverride }) => {
 	const [selectedUrl, setSelectedUrl] = useState("");
 	const { view: { selectedApi, focusedTag, setFocusedTag } } = useStore();
 	const [viewStyle, setViewStyle] = useState("grid");
@@ -1638,7 +1638,7 @@ const APIPage = () => {
 		vertical: true,
 		gap: token.margin,
 		children: [selectedApi && /* @__PURE__ */ jsx(ViewModeApiHeader, {
-			api: selectedApi,
+			api: apiOverride ?? selectedApi,
 			viewLayout: viewStyle,
 			onViewLayoutChange: setViewStyle
 		}), Object.entries(getEndpointsForSelectedUrl()).sort(([a], [b]) => {
@@ -6754,7 +6754,7 @@ const TagsSection = ({ tags, collapsed, onToggleCollapse, onAddTag, onEditTag, o
 								height: 32
 							}),
 							disabled: tag.isDefault,
-							onClick: () => !tag.isDefault && onDeleteTag?.(tag.name),
+							onClick: () => !tag.isDefault && onDeleteTag?.(tag.name, tags.findIndex((t) => t.name === tag.name)),
 							style: {
 								width: 40,
 								height: 40,
@@ -6930,7 +6930,7 @@ const TagsSection = ({ tags, collapsed, onToggleCollapse, onAddTag, onEditTag, o
 										height: 32
 									}),
 									disabled: tag.isDefault,
-									onClick: () => !tag.isDefault && onDeleteTag?.(tag.name),
+									onClick: () => !tag.isDefault && onDeleteTag?.(tag.name, tags.findIndex((t) => t.name === tag.name)),
 									style: {
 										width: 40,
 										height: 40,
@@ -6973,7 +6973,7 @@ const TagsSection = ({ tags, collapsed, onToggleCollapse, onAddTag, onEditTag, o
 const TAG_NAME_REGEX = /^[A-Za-z0-9_\s-]+$/;
 const TAG_DESC_REGEX = /^[A-Za-z0-9_\s-]+$/;
 const EXTERNAL_DOCS_DESC_REGEX = /^[A-Za-z0-9_\s-]+$/;
-const AddTagDrawer = ({ open, onClose, mode, initialValues, onAddTag, onEditTag }) => {
+const AddTagDrawer = ({ open, onClose, mode, initialValues, onAddTag, onEditTag, existingTags }) => {
 	const [form] = Form.useForm();
 	const [messageApi, contextHolder] = message.useMessage();
 	const [confirmModalOpen, setConfirmModalOpen] = useState(false);
@@ -7104,7 +7104,7 @@ const AddTagDrawer = ({ open, onClose, mode, initialValues, onAddTag, onEditTag
 		}
 	}));
 	const isLinkEnabled = Boolean(extDocsDesc?.trim());
-	const isAddEnabled = !!(tagNameValue && TAG_NAME_REGEX.test(tagNameValue));
+	const isAddEnabled = !!(tagNameValue && TAG_NAME_REGEX.test(tagNameValue)) && !form.getFieldsError().some((field) => field.errors.length > 0);
 	useEffect(() => {
 		if (open && mode === "edit" && initialValues) form.setFieldsValue(initialValues);
 		if (!open) form.resetFields();
@@ -7214,7 +7214,13 @@ const AddTagDrawer = ({ open, onClose, mode, initialValues, onAddTag, onEditTag
 							{
 								pattern: TAG_NAME_REGEX,
 								message: "Only letters, numbers, spaces, underscores, and hyphens"
-							}
+							},
+							{ validator: (_, value) => {
+								if (!value || !existingTags?.length) return Promise.resolve();
+								const originalName = initialValues?.name;
+								if (existingTags.some((t) => t.name.toLowerCase() === value.toLowerCase() && t.name.toLowerCase() !== originalName?.toLowerCase())) return Promise.reject(/* @__PURE__ */ new Error("Tag name already exists"));
+								return Promise.resolve();
+							} }
 						],
 						children: /* @__PURE__ */ jsx(Input, {
 							showCount: true,
@@ -7290,7 +7296,7 @@ const AddTagDrawer = ({ open, onClose, mode, initialValues, onAddTag, onEditTag
 							if (!desc?.trim()) return Promise.resolve();
 							if (!link?.trim()) return Promise.reject(/* @__PURE__ */ new Error("External Docs Link is required when Description is filled"));
 							try {
-								new URL(link);
+								if (!/^https?:\/\/[a-zA-Z0-9]+([\-\.]{1}[a-zA-Z0-9]+)*\.[a-zA-Z]{2,}(:[0-9]{1,5})?(\/.*)?$/.test(link)) return Promise.reject(/* @__PURE__ */ new Error("Please enter a valid URL"));
 								return Promise.resolve();
 							} catch {
 								return Promise.reject(/* @__PURE__ */ new Error("Please enter a valid URL"));
@@ -8485,7 +8491,7 @@ const EndpointPage = () => {
 };
 //#endregion
 //#region src/view/console/MainContent.tsx
-const MainContent = ({ searchEnabled, handleResetSearch, handleVisitLandingPage }) => {
+const MainContent = ({ searchEnabled, handleResetSearch, handleVisitLandingPage, apiOverride }) => {
 	const { focusedContent, transformedData } = useStore(({ view }) => view);
 	const { wrapSSR, cx, token } = useStyle("MainContent", (token, scope) => ({
 		[scope("inner-doc-container")]: {
@@ -8568,7 +8574,7 @@ const MainContent = ({ searchEnabled, handleResetSearch, handleVisitLandingPage
 					children: "Reset Search"
 				})
 			]
-		}) : focusedContent === "ENDPOINT" ? /* @__PURE__ */ jsx(EndpointPage, {}) : /* @__PURE__ */ jsx(APIPage, {})
+		}) : focusedContent === "ENDPOINT" ? /* @__PURE__ */ jsx(EndpointPage, {}) : /* @__PURE__ */ jsx(APIPage, { apiOverride })
 	}));
 };
 //#endregion
@@ -8652,7 +8658,6 @@ function CodeboxSidebar$1() {
 		const queryParams = params.filter((p) => p.in === "query");
 		return [`curl --location '${serverUrl}${resolvedPath}${queryParams.length > 0 ? "?" + queryParams.map((p) => `${p.name}=sample-value`).join("&") : ""}'`, ...params.filter((p) => p.in === "header").map((p) => `--header '${p.name}: sample-value'`)];
 	})();
-	const hasAnyParams = (selectedEndpoint?.parameters ?? []).some((p) => p.in === "header" || p.in === "path" || p.in === "query");
 	const { token: antdToken, theme: themeConfig } = theme.useToken();
 	const isDark = themeConfig.id == 1;
 	const headerBg = isDark ? antdToken.colorBgElevated : "#1d2856";
@@ -8774,7 +8779,7 @@ function CodeboxSidebar$1() {
 	}));
 	return /* @__PURE__ */ jsxs("div", {
 		className: cx("container"),
-		children: [hasAnyParams && /* @__PURE__ */ jsxs("div", {
+		children: [curlCommand && /* @__PURE__ */ jsxs("div", {
 			className: cx("rightCard", "rightCardRequest"),
 			children: [/* @__PURE__ */ jsxs("div", {
 				className: cx("rightCardHeader"),
@@ -8968,7 +8973,7 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 	});
 	const [deleteTagModal, setDeleteTagModal] = useState({
 		open: false,
-		tagName: ""
+		tagIndex: -1
 	});
 	const [localTags, setLocalTags] = useState([]);
 	const [messageApi, contextHolder] = message.useMessage();
@@ -8978,6 +8983,21 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 	const { useBreakpoint } = Grid;
 	const isMobile = !useBreakpoint().md;
 	const allEndpoints = useMemo(() => selectedApi ? Object.values(selectedApi.tags ?? {}).flat() : [], [selectedApi]);
+	const viewModeApi = useMemo(() => {
+		if (!selectedApi) return null;
+		if (mode !== "view") return selectedApi;
+		if (localApiName === selectedApi.title && localDescription === selectedApi.description) return selectedApi;
+		return {
+			...selectedApi,
+			title: localApiName,
+			description: localDescription
+		};
+	}, [
+		mode,
+		selectedApi,
+		localApiName,
+		localDescription
+	]);
 	useEffect(() => {
 		return () => {
 			resetStore();
@@ -9130,7 +9150,9 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 			externalDocsDescription: t.externalDocs?.description,
 			isDefault: t.name.toLowerCase() === "default"
 		})) ?? [];
-		if (!mapped.some((t) => t.isDefault) && selectedApi.tags["default"]) mapped.push({
+		const hasDefault = mapped.some((t) => t.isDefault);
+		const hasDefaultInMapped = mapped.some((t) => t.name.toLowerCase() === "default");
+		if (!hasDefault && !hasDefaultInMapped && selectedApi.tags["default"]) mapped.push({
 			name: "default",
 			isDefault: true
 		});
@@ -9282,6 +9304,12 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 	useEffect(() => {
 		if (mode !== "view" || !selectedEndpoint) return;
 		const epId = selectedEndpoint.id;
+		const localName = endpointNames[epId];
+		const localDesc = endpointDescs[epId];
+		const localEpTags = endpointTags[epId];
+		const patchedSummary = localName !== void 0 && localName !== selectedEndpoint.summary ? localName : selectedEndpoint.summary;
+		const patchedDesc = localDesc !== void 0 && localDesc !== selectedEndpoint.description ? localDesc : selectedEndpoint.description;
+		const patchedTags = localEpTags !== void 0 && JSON.stringify(localEpTags) !== JSON.stringify(selectedEndpoint.tags ?? []) ? localEpTags : selectedEndpoint.tags;
 		const openApiParams = (endpointParams[epId] ?? []).map((p) => ({
 			name: p.name,
 			in: p.in,
@@ -9292,7 +9320,6 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 				...p.enum && p.enum.length > 0 ? { enum: p.enum } : {}
 			}
 		}));
-		if (JSON.stringify(selectedEndpoint.parameters ?? []) === JSON.stringify(openApiParams)) return;
 		const responseHeadersMap = (endpointResponseParams[epId] ?? []).reduce((acc, p) => {
 			acc[p.name] = {
 				schema: {
@@ -9308,14 +9335,21 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 			...resp,
 			headers: Object.keys(responseHeadersMap).length > 0 ? responseHeadersMap : resp.headers
 		}]));
+		if (selectedEndpoint.summary === patchedSummary && selectedEndpoint.description === patchedDesc && JSON.stringify(selectedEndpoint.tags ?? []) === JSON.stringify(patchedTags ?? []) && JSON.stringify(selectedEndpoint.parameters ?? []) === JSON.stringify(openApiParams) && JSON.stringify(selectedEndpoint.responses) === JSON.stringify(patchedResponses)) return;
 		setSelectedEndpoint({
 			...selectedEndpoint,
+			summary: patchedSummary,
+			description: patchedDesc,
+			tags: patchedTags,
 			parameters: openApiParams,
 			responses: patchedResponses
 		});
 	}, [
 		mode,
 		selectedEndpoint,
+		endpointNames,
+		endpointDescs,
+		endpointTags,
 		endpointParams,
 		endpointResponseParams,
 		setSelectedEndpoint
@@ -9343,11 +9377,13 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 		setBannerVisible(true);
 	};
 	const handleDeleteTagConfirm = () => {
-		setLocalTags((prev) => prev.filter((t) => t.name !== deleteTagModal.tagName));
-		messageApi.success(`${deleteTagModal.tagName} tag has been deleted successfully.`);
+		if (deleteTagModal.tagIndex < 0) return;
+		const tagName = localTags[deleteTagModal.tagIndex]?.name ?? "Tag";
+		setLocalTags((prev) => prev.filter((_, index) => index !== deleteTagModal.tagIndex));
+		messageApi.success(`${tagName} tag has been deleted successfully.`);
 		setDeleteTagModal({
 			open: false,
-			tagName: ""
+			tagIndex: -1
 		});
 		setBannerVisible(true);
 	};
@@ -9665,7 +9701,7 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 			/* @__PURE__ */ jsx("div", {
 				className: cx("section"),
 				children: /* @__PURE__ */ jsx(ApiDocumentationBar, {
-					apiName: selectedApi?.title || "API",
+					apiName: localApiName,
 					mode,
 					onModeChange: setMode,
 					onReset: () => setResetConfirmModal(true),
@@ -9746,9 +9782,9 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 										externalDocsLink: tag.externalDocsUrl
 									}
 								}),
-								onDeleteTag: (tagName) => setDeleteTagModal({
+								onDeleteTag: (_tagName, tagIndex) => setDeleteTagModal({
 									open: true,
-									tagName
+									tagIndex
 								})
 							})
 						}),
@@ -9908,9 +9944,9 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 										externalDocsLink: tag.externalDocsUrl
 									}
 								}),
-								onDeleteTag: (tagName) => setDeleteTagModal({
+								onDeleteTag: (_tagName, tagIndex) => setDeleteTagModal({
 									open: true,
-									tagName
+									tagIndex
 								})
 							})
 						}),
@@ -10024,7 +10060,8 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 					children: [/* @__PURE__ */ jsx(MainContent, {
 						handleVisitLandingPage: _handleVisitLandingPage,
 						handleResetSearch,
-						searchEnabled: !!searchValue
+						searchEnabled: !!searchValue,
+						apiOverride: mode === "view" ? viewModeApi : void 0
 					}), !isMobile && focusedContent === "ENDPOINT" && /* @__PURE__ */ jsx(CodeboxSidebar$1, {})]
 				})]
 			}),
@@ -10037,7 +10074,8 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 					mode: "add"
 				}),
 				onAddTag: handleAddTag,
-				onEditTag: handleUpdateTag
+				onEditTag: handleUpdateTag,
+				existingTags: localTags
 			}),
 			/* @__PURE__ */ jsxs(Modal, {
 				open: saveConfirmModal,
@@ -10181,7 +10219,7 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 				open: deleteTagModal.open,
 				onCancel: () => setDeleteTagModal({
 					open: false,
-					tagName: ""
+					tagIndex: -1
 				}),
 				centered: true,
 				title: null,
@@ -10207,14 +10245,14 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 							className: cx("deleteModalTitle"),
 							children: [
 								"Delete ",
-								deleteTagModal.tagName,
+								localTags[deleteTagModal.tagIndex]?.name ?? "Tag",
 								" tag"
 							]
 						}), /* @__PURE__ */ jsx("button", {
 							className: cx("deleteModalCloseBtn"),
 							onClick: () => setDeleteTagModal({
 								open: false,
-								tagName: ""
+								tagIndex: -1
 							}),
 							"aria-label": "Close",
 							children: "×"
@@ -10226,7 +10264,7 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 							className: cx("deleteModalContentText"),
 							children: [
 								"Are you sure you want to delete ",
-								deleteTagModal.tagName,
+								localTags[deleteTagModal.tagIndex]?.name ?? "Tag",
 								" tag?"
 							]
 						})
@@ -10237,7 +10275,7 @@ const ConsoleDocumentationLayout = ({ data, preSelectedApi, handleVisitLandingPa
 							size: "middle",
 							onClick: () => setDeleteTagModal({
 								open: false,
-								tagName: ""
+								tagIndex: -1
 							}),
 							style: {
 								borderRadius: 8,