mirror of https://github.com/requarks/wiki
NGPixel
3 days ago
parent
f64d643123
commit
41b1e0e9b5
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,176 @@
|
|||||||
|
import { defineAsyncComponent } from 'vue'
|
||||||
|
import { useI18n } from 'vue-i18n'
|
||||||
|
|
||||||
|
import { confirm, dialog } from '@/composables/dialog'
|
||||||
|
import { loading } from '@/composables/loading'
|
||||||
|
import { notify } from '@/composables/notify'
|
||||||
|
import { apiErrorMessage } from '@/helpers/apiError'
|
||||||
|
import { renderVersionSource } from '@/helpers/pageVersions'
|
||||||
|
|
||||||
|
import { useEditorStore } from '@/stores/editor'
|
||||||
|
import { useSiteStore } from '@/stores/site'
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Bringing a page back out of the recycle bin.
|
||||||
|
*
|
||||||
|
* Shared by the two places that offer it -- the file manager's Recycle Bin, and the version view a
|
||||||
|
* bin entry opens in -- because the flow is the same from both and has more to it than a request: the
|
||||||
|
* page's HTML has to be rendered here first (a version records the source and never the render), and
|
||||||
|
* a path that has been taken since the page went has to become a question about where else to put it.
|
||||||
|
*
|
||||||
|
* Call it during `setup()`, like any composable: it reads the i18n catalogue and the stores.
|
||||||
|
*
|
||||||
|
* @returns {{ restoreDeletedPage: (version: object) => Promise<object | null> }}
|
||||||
|
*/
|
||||||
|
export function useDeletedPages() {
|
||||||
|
const { t } = useI18n()
|
||||||
|
const editorStore = useEditorStore()
|
||||||
|
const siteStore = useSiteStore()
|
||||||
|
|
||||||
|
async function renderFor(version, pagePath) {
|
||||||
|
// -> Configured per site, and the configuration arrives with the editor configs
|
||||||
|
if (!editorStore.configIsLoaded) {
|
||||||
|
await editorStore.fetchConfigs()
|
||||||
|
}
|
||||||
|
return renderVersionSource(version, {
|
||||||
|
markdownConfig: editorStore.editors.markdown,
|
||||||
|
asciidocConfig: editorStore.editors.asciidoc,
|
||||||
|
pagePath
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
function deletedOn(version) {
|
||||||
|
return version.versionDate
|
||||||
|
? Temporal.Instant.from(version.versionDate).toLocaleString(undefined, {
|
||||||
|
year: 'numeric',
|
||||||
|
month: 'short',
|
||||||
|
day: 'numeric',
|
||||||
|
hour: 'numeric',
|
||||||
|
minute: '2-digit'
|
||||||
|
})
|
||||||
|
: ''
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Ask where the page should go instead, in the same tree picker a duplicate or a move uses.
|
||||||
|
*
|
||||||
|
* @returns {Promise<{ path: string, title: string, locale: string } | null>} Null when dismissed.
|
||||||
|
*/
|
||||||
|
function pickDestination(version, path, locale) {
|
||||||
|
return new Promise((resolve) => {
|
||||||
|
dialog({
|
||||||
|
component: defineAsyncComponent(() => import('@/components/TreeBrowserDialog.vue')),
|
||||||
|
componentProps: {
|
||||||
|
mode: 'restorePage',
|
||||||
|
itemId: version.pageId,
|
||||||
|
itemTitle: version.title,
|
||||||
|
itemFileName: path,
|
||||||
|
locale
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.onOk(resolve)
|
||||||
|
.onCancel(() => resolve(null))
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* One attempt at the request, somewhere in particular.
|
||||||
|
*
|
||||||
|
* @returns {Promise<{ page?: object, conflict?: string }>} `conflict` is the server's error name for
|
||||||
|
* the two refusals the caller has an answer to; anything else is thrown.
|
||||||
|
*/
|
||||||
|
async function attempt(version, { path, locale, title }) {
|
||||||
|
loading.show()
|
||||||
|
try {
|
||||||
|
const resp = await API_CLIENT.post(`sites/${siteStore.id}/pages/${version.pageId}/restore`, {
|
||||||
|
json: {
|
||||||
|
versionId: version.id,
|
||||||
|
// -> Rendered for where it is going: a relative link or image resolves against that path
|
||||||
|
render: await renderFor(version, path),
|
||||||
|
path,
|
||||||
|
locale,
|
||||||
|
...(title ? { title } : {})
|
||||||
|
}
|
||||||
|
}).json()
|
||||||
|
// -> The API client does not throw on 400, so a refused path comes back as a parsed error
|
||||||
|
if (resp?.ok === false || !resp?.page?.id) {
|
||||||
|
throw new Error(resp?.message || 'An unexpected error occured.')
|
||||||
|
}
|
||||||
|
return { page: resp.page }
|
||||||
|
} catch (err) {
|
||||||
|
if (['pageDuplicatePath', 'pageRestoreStale'].includes(err?.data?.error)) {
|
||||||
|
return { conflict: err.data.error }
|
||||||
|
}
|
||||||
|
throw err
|
||||||
|
} finally {
|
||||||
|
loading.hide()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Restore a deleted page: confirm, then put it back where it was -- or, when another page has taken
|
||||||
|
* that path since, wherever the reader picks instead.
|
||||||
|
*
|
||||||
|
* @param {object} version The version recording the deletion, WITH its `content`, as
|
||||||
|
* `GET /sites/:siteId/versions/:versionId` answers for a page in the bin: `pagePath` and
|
||||||
|
* `pageLocale` are where it was.
|
||||||
|
* @returns {Promise<object | null | 'stale'>} The restored page; null when the reader backed out or
|
||||||
|
* it failed (already reported); `stale` when the bin changed underneath, which the caller answers
|
||||||
|
* by reloading whatever it listed.
|
||||||
|
*/
|
||||||
|
function restoreDeletedPage(version) {
|
||||||
|
return new Promise((resolve) => {
|
||||||
|
confirm({
|
||||||
|
title: t('history.restore'),
|
||||||
|
message: [
|
||||||
|
t('history.restoreDeletedConfirm', {
|
||||||
|
path: version.pagePath,
|
||||||
|
date: deletedOn(version)
|
||||||
|
}),
|
||||||
|
t('history.restoreDeletedConfirmHint')
|
||||||
|
],
|
||||||
|
cancel: true,
|
||||||
|
okLabel: t('history.restore')
|
||||||
|
})
|
||||||
|
.onOk(async () => {
|
||||||
|
let target = { path: version.pagePath, locale: version.pageLocale }
|
||||||
|
try {
|
||||||
|
for (;;) {
|
||||||
|
const result = await attempt(version, target)
|
||||||
|
if (result.page) {
|
||||||
|
notify({ type: 'positive', message: t('fileman.restoreSuccess') })
|
||||||
|
resolve(result.page)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
if (result.conflict === 'pageRestoreStale') {
|
||||||
|
notify({ type: 'warning', message: t('fileman.restoreStale') })
|
||||||
|
resolve('stale')
|
||||||
|
return
|
||||||
|
}
|
||||||
|
// -> The path is taken. Asked again for as long as the answer is a taken path too
|
||||||
|
notify({
|
||||||
|
type: 'warning',
|
||||||
|
message: t('fileman.restorePathTaken', { path: target.path })
|
||||||
|
})
|
||||||
|
const picked = await pickDestination(version, target.path, target.locale)
|
||||||
|
if (!picked) {
|
||||||
|
resolve(null)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
target = picked
|
||||||
|
}
|
||||||
|
} catch (err) {
|
||||||
|
notify({
|
||||||
|
type: 'negative',
|
||||||
|
message: t('fileman.restoreFailed'),
|
||||||
|
caption: apiErrorMessage(err)
|
||||||
|
})
|
||||||
|
resolve(null)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.onCancel(() => resolve(null))
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
return { restoreDeletedPage }
|
||||||
|
}
|
||||||
Loading…
Reference in new issue