Edouard Vanbelle
c65f2b5385
- Add src/application/dtos/cursor.rs with three shared types:
· PageCursor trait — default base64url+JSON encode/decode; one bare
impl line per cursor struct
· CursorQuery struct — standard limit/cursor/sort_by query params with
limit_clamped() and decode_cursor<C>() helpers; compose via flatten
· CursorListResponse<T> — standard {items, next_cursor?} envelope with
from_oversized() and with_cursor() builders
- Migrate GrantCursor to impl PageCursor (remove duplicate encode/decode)
- Update GET /api/grants/incoming/resources:
· SharedWithMeQuery now embeds CursorQuery via #[serde(flatten)]
· Replace file/folder nullable pair with ResourceContentDto (untagged
enum) under a single always-present 'resource' field
· SharedWithMeDto is now a type alias for CursorListResponse<SharedWithMeItemDto>
· Handler uses q.paging.limit_clamped() and decode_cursor<GrantCursor>()
- Add docs/architecture/resource-listing.md — authoritative contract for
all listing endpoints (cursor design, SQL keyset WHERE, sort_by naming,
Rust + JS skeletons, compliance table, migration guide)
- Register doc in VitePress sidebar and architecture index
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
121 lines
3.7 KiB
TypeScript
121 lines
3.7 KiB
TypeScript
import { defineConfig } from "vitepress";
|
|
|
|
export default defineConfig({
|
|
title: "OxiCloud",
|
|
description: "Self-hosted cloud storage, calendar & contacts — blazingly fast",
|
|
|
|
base: "/OxiCloud/",
|
|
|
|
sitemap: {
|
|
hostname: "https://diocrafts.github.io/OxiCloud",
|
|
lastmodDateOnly: false,
|
|
},
|
|
|
|
markdown: {
|
|
image: {
|
|
lazyLoading: true,
|
|
},
|
|
},
|
|
|
|
lastUpdated: true,
|
|
|
|
ignoreDeadLinks: [
|
|
/^https?:\/\/localhost/,
|
|
],
|
|
|
|
locales: {
|
|
root: {
|
|
label: "English",
|
|
lang: "en",
|
|
},
|
|
},
|
|
|
|
head: [
|
|
["link", { rel: "icon", href: "/OxiCloud/logo.svg" }],
|
|
],
|
|
|
|
themeConfig: {
|
|
logo: "/logo.svg",
|
|
|
|
search: {
|
|
provider: "local",
|
|
},
|
|
|
|
editLink: {
|
|
pattern: "https://github.com/DioCrafts/OxiCloud/tree/main/docs/:path",
|
|
text: "Edit this page on GitHub",
|
|
},
|
|
|
|
nav: [
|
|
{ text: "Home", link: "/" },
|
|
{ text: "Guide", link: "/guide/" },
|
|
{ text: "Configuration", link: "/config/" },
|
|
{ text: "FAQ", link: "/faq" },
|
|
],
|
|
|
|
sidebar: {
|
|
"/": [
|
|
{
|
|
text: "Introduction",
|
|
items: [
|
|
{ text: "What is OxiCloud?", link: "/guide/" },
|
|
{ text: "Quick Start", link: "/guide/installation" },
|
|
],
|
|
},
|
|
{
|
|
text: "Configuration",
|
|
items: [
|
|
{ text: "Deployment & Docker", link: "/config/deployment" },
|
|
{ text: "Environment Variables", link: "/config/env" },
|
|
{ text: "Authentication", link: "/config/authentication" },
|
|
{ text: "OIDC / SSO", link: "/config/oidc" },
|
|
{ text: "OIDC Config Examples", link: "/config/oidc-config-examples" },
|
|
{ text: "Admin Settings", link: "/config/admin-settings" },
|
|
{ text: "WOPI (Office Editing)", link: "/config/wopi" },
|
|
],
|
|
},
|
|
{
|
|
text: "Features",
|
|
items: [
|
|
{ text: "WebDAV", link: "/guide/webdav" },
|
|
{ text: "CalDAV & CardDAV", link: "/guide/caldav-carddav" },
|
|
{ text: "DAV Client Setup", link: "/guide/dav-client-setup" },
|
|
{ text: "Chunked Uploads", link: "/guide/chunked-uploads" },
|
|
{ text: "Batch Operations", link: "/guide/batch-operations" },
|
|
{ text: "Deduplication", link: "/guide/deduplication" },
|
|
{ text: "Favorites & Recent", link: "/guide/favorites-and-recent" },
|
|
{ text: "Search", link: "/guide/search" },
|
|
{ text: "Thumbnails & Transcoding", link: "/guide/thumbnails-and-transcoding" },
|
|
{ text: "Trash & Recycle Bin", link: "/guide/trash" },
|
|
{ text: "ZIP & Compression", link: "/guide/zip-and-compression" },
|
|
{ text: "Internationalization", link: "/guide/i18n" },
|
|
],
|
|
},
|
|
{
|
|
text: "Architecture",
|
|
items: [
|
|
{ text: "Internal Architecture", link: "/architecture/" },
|
|
{ text: "Caching", link: "/architecture/caching" },
|
|
{ text: "Resource Listing API", link: "/architecture/resource-listing" },
|
|
{ text: "Storage Safety", link: "/architecture/file-system-safety" },
|
|
{ text: "Database Transactions", link: "/architecture/database-transactions" },
|
|
{ text: "Share Integration", link: "/architecture/share-integration" },
|
|
{ text: "Storage Quotas", link: "/architecture/storage-quotas" },
|
|
{ text: "File and Blob lifecycle", link: "/architecture/file-and-blob-lifecycle" },
|
|
],
|
|
},
|
|
{ text: "FAQ", link: "/faq" },
|
|
],
|
|
},
|
|
|
|
socialLinks: [
|
|
{ icon: "github", link: "https://github.com/DioCrafts/OxiCloud" },
|
|
],
|
|
|
|
footer: {
|
|
message: "Released under the MIT License.",
|
|
copyright: "Copyright © 2025-present DioCrafts",
|
|
},
|
|
},
|
|
});
|