@ossy/resources 3.9.0 → 3.11.0

package/src/sort-storage-last-updated.flow.js

@@ -0,0 +1,119 @@
+import signUpFlow from '@ossy/authentication/sign-up.flow.js'
+import { metadata as ConfirmUpload } from './confirm-upload.action.js'
+import { metadata as FinishUpload } from './finish-upload.action.js'
+import { metadata as OpenRename } from './open-rename.action.js'
+import { metadata as OpenSort } from './open-sort.action.js'
+import { metadata as RenameForm } from './rename.form.js'
+import { metadata as SortByLastUpdated } from './sort-by-last-updated.action.js'
+import { metadata as UpdateResourceName } from './update-name.action.js'
+
+export const metadata = {
+  id: '@ossy/resources/flows/sort-storage-last-updated',
+  feature: 'resources',
+  requires: ['server', 'database'],
+  timeout: 180_000,
+}
+
+/**
+ * Upload two files in name order, rename the earlier one (a→b, still before z)
+ * to bump lastUpdated, open the storage sort menu, switch to last updated
+ * ascending, and assert list order is opposite name order.
+ */
+export default {
+  title: 'Sort storage resources by last updated',
+  description:
+    'Signed-in user uploads two files, renames one to bump lastUpdated, opens sort, chooses last updated, and sees last-updated ascending order',
+  steps: [
+    ...signUpFlow.steps,
+    { page: '@upload-media', search: { location: '/' } },
+    { result: { selector: '#upload-resources', timeout: 15000 } },
+    { result: { selector: '[data-flow-stage="upload-idle"]', timeout: 15000 } },
+    {
+      files: {
+        selector: '#upload-resources',
+        items: [{
+          name: 'e2e-lu-a.txt',
+          mimeType: 'text/plain',
+          // Uploaded first so name-asc matches created order; rename later bumps lastUpdated.
+          content: 'last updated a',
+        }],
+      },
+    },
+    { result: { selector: '[data-flow-stage="upload-preview"]', timeout: 15000 } },
+    { result: { action: ConfirmUpload, timeout: 10000 } },
+    { action: ConfirmUpload },
+    { result: { selector: '[data-flow-stage="upload-done"]', timeout: 30000 } },
+    { result: { action: FinishUpload, timeout: 10000 } },
+    { action: FinishUpload },
+    { result: { page: '@storage/home', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="e2e-lu-a.txt"]', timeout: 20000 } },
+    { page: '@upload-media', search: { location: '/' } },
+    { result: { selector: '#upload-resources', timeout: 15000 } },
+    { result: { selector: '[data-flow-stage="upload-idle"]', timeout: 15000 } },
+    {
+      files: {
+        selector: '#upload-resources',
+        items: [{
+          name: 'e2e-lu-z.txt',
+          mimeType: 'text/plain',
+          content: 'last updated z',
+        }],
+      },
+    },
+    { result: { selector: '[data-flow-stage="upload-preview"]', timeout: 15000 } },
+    { result: { action: ConfirmUpload, timeout: 10000 } },
+    { action: ConfirmUpload },
+    { result: { selector: '[data-flow-stage="upload-done"]', timeout: 30000 } },
+    { result: { action: FinishUpload, timeout: 10000 } },
+    { action: FinishUpload },
+    { result: { page: '@storage/home', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="e2e-lu-a.txt"]', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="e2e-lu-z.txt"]', timeout: 20000 } },
+    { result: { selector: '[data-sort-by="name"][data-sort-order="asc"]', timeout: 10000 } },
+    {
+      result: {
+        selector: '[data-resource-name="e2e-lu-a.txt"] ~ [data-resource-name="e2e-lu-z.txt"]',
+        timeout: 10000,
+      },
+    },
+    { click: { selector: '[data-resource-name="e2e-lu-a.txt"]' } },
+    { result: { action: OpenRename, timeout: 15000 } },
+    { action: OpenRename },
+    { result: { action: UpdateResourceName, timeout: 10000 } },
+    // Rename keeps alphabetical order before z, but bumps lastUpdated on this file.
+    { form: RenameForm, fields: { name: 'e2e-lu-b.txt' } },
+    { action: UpdateResourceName },
+    {
+      result: {
+        selector: '[data-resource-name="e2e-lu-b.txt"]',
+        timeout: 20000,
+      },
+    },
+    {
+      result: {
+        selector: '[data-resource-name="e2e-lu-a.txt"]',
+        hidden: true,
+        timeout: 10000,
+      },
+    },
+    {
+      result: {
+        selector: '[data-resource-name="e2e-lu-b.txt"] ~ [data-resource-name="e2e-lu-z.txt"]',
+        timeout: 10000,
+      },
+    },
+    { press: 'Escape' },
+    { result: { action: OpenSort, timeout: 10000 } },
+    { action: OpenSort },
+    { result: { action: SortByLastUpdated, timeout: 10000 } },
+    { action: SortByLastUpdated },
+    { result: { selector: '[data-sort-by="lastUpdated"][data-sort-order="asc"]', timeout: 10000 } },
+    {
+      result: {
+        // z was never renamed, so it sorts before the bumped b under lastUpdated asc.
+        selector: '[data-resource-name="e2e-lu-z.txt"] ~ [data-resource-name="e2e-lu-b.txt"]',
+        timeout: 10000,
+      },
+    },
+  ],
+}

package/src/sort-storage-name-asc.flow.js

@@ -0,0 +1,34 @@
+import { metadata as OpenSort } from './open-sort.action.js'
+import { metadata as SortAscending } from './sort-ascending.action.js'
+import sortStorageFlow from './sort-storage.flow.js'
+
+export const metadata = {
+  id: '@ossy/resources/flows/sort-storage-name-asc',
+  feature: 'resources',
+  requires: ['server', 'database'],
+  timeout: 180_000,
+}
+
+/**
+ * After name-descending sort is established, flip back to ascending and assert
+ * the original name order under asc markers.
+ */
+export default {
+  title: 'Sort storage resources by name ascending',
+  description:
+    'Signed-in user sorts by name descending, then switches to ascending and sees the restored name order',
+  steps: [
+    ...sortStorageFlow.steps,
+    { result: { action: OpenSort, timeout: 10000 } },
+    { action: OpenSort },
+    { result: { action: SortAscending, timeout: 10000 } },
+    { action: SortAscending },
+    { result: { selector: '[data-sort-by="name"][data-sort-order="asc"]', timeout: 10000 } },
+    {
+      result: {
+        selector: '[data-resource-name="e2e-sort-a.txt"] ~ [data-resource-name="e2e-sort-z.txt"]',
+        timeout: 10000,
+      },
+    },
+  ],
+}

package/src/sort-storage-size-desc.flow.js

@@ -0,0 +1,34 @@
+import { metadata as OpenSort } from './open-sort.action.js'
+import { metadata as SortDescending } from './sort-descending.action.js'
+import sortStorageSizeFlow from './sort-storage-size.flow.js'
+
+export const metadata = {
+  id: '@ossy/resources/flows/sort-storage-size-desc',
+  feature: 'resources',
+  requires: ['server', 'database'],
+  timeout: 180_000,
+}
+
+/**
+ * After size-ascending sort is established, flip to descending and assert the
+ * larger file precedes the smaller one under size desc markers.
+ */
+export default {
+  title: 'Sort storage resources by size descending',
+  description:
+    'Signed-in user sorts by size ascending, then switches to descending and sees the reversed size order',
+  steps: [
+    ...sortStorageSizeFlow.steps,
+    { result: { action: OpenSort, timeout: 10000 } },
+    { action: OpenSort },
+    { result: { action: SortDescending, timeout: 10000 } },
+    { action: SortDescending },
+    { result: { selector: '[data-sort-by="size"][data-sort-order="desc"]', timeout: 10000 } },
+    {
+      result: {
+        selector: '[data-resource-name="e2e-sort-a.txt"] ~ [data-resource-name="e2e-sort-z.txt"]',
+        timeout: 10000,
+      },
+    },
+  ],
+}

package/src/sort-storage-size.flow.js

@@ -0,0 +1,87 @@
+import signUpFlow from '@ossy/authentication/sign-up.flow.js'
+import { metadata as ConfirmUpload } from './confirm-upload.action.js'
+import { metadata as FinishUpload } from './finish-upload.action.js'
+import { metadata as OpenSort } from './open-sort.action.js'
+import { metadata as SortBySize } from './sort-by-size.action.js'
+
+export const metadata = {
+  id: '@ossy/resources/flows/sort-storage-size',
+  feature: 'resources',
+  requires: ['server', 'database'],
+  timeout: 180_000,
+}
+
+/**
+ * Upload two files whose name order is opposite their size order, open the
+ * storage sort menu, switch to size ascending, and assert list order + markers.
+ */
+export default {
+  title: 'Sort storage resources by size',
+  description:
+    'Signed-in user uploads two differently sized files, opens sort, chooses size, and sees size ascending order',
+  steps: [
+    ...signUpFlow.steps,
+    { page: '@upload-media', search: { location: '/' } },
+    { result: { selector: '#upload-resources', timeout: 15000 } },
+    { result: { selector: '[data-flow-stage="upload-idle"]', timeout: 15000 } },
+    {
+      files: {
+        selector: '#upload-resources',
+        items: [{
+          name: 'e2e-sort-a.txt',
+          mimeType: 'text/plain',
+          // Larger body so size-asc places this after the small "z" file.
+          content: 'LARGE-SORT-A-CONTENT-'.repeat(40),
+        }],
+      },
+    },
+    { result: { selector: '[data-flow-stage="upload-preview"]', timeout: 15000 } },
+    { result: { action: ConfirmUpload, timeout: 10000 } },
+    { action: ConfirmUpload },
+    { result: { selector: '[data-flow-stage="upload-done"]', timeout: 30000 } },
+    { result: { action: FinishUpload, timeout: 10000 } },
+    { action: FinishUpload },
+    { result: { page: '@storage/home', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="e2e-sort-a.txt"]', timeout: 20000 } },
+    { page: '@upload-media', search: { location: '/' } },
+    { result: { selector: '#upload-resources', timeout: 15000 } },
+    { result: { selector: '[data-flow-stage="upload-idle"]', timeout: 15000 } },
+    {
+      files: {
+        selector: '#upload-resources',
+        items: [{
+          name: 'e2e-sort-z.txt',
+          mimeType: 'text/plain',
+          content: 'z',
+        }],
+      },
+    },
+    { result: { selector: '[data-flow-stage="upload-preview"]', timeout: 15000 } },
+    { result: { action: ConfirmUpload, timeout: 10000 } },
+    { action: ConfirmUpload },
+    { result: { selector: '[data-flow-stage="upload-done"]', timeout: 30000 } },
+    { result: { action: FinishUpload, timeout: 10000 } },
+    { action: FinishUpload },
+    { result: { page: '@storage/home', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="e2e-sort-a.txt"]', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="e2e-sort-z.txt"]', timeout: 20000 } },
+    { result: { selector: '[data-sort-by="name"][data-sort-order="asc"]', timeout: 10000 } },
+    {
+      result: {
+        selector: '[data-resource-name="e2e-sort-a.txt"] ~ [data-resource-name="e2e-sort-z.txt"]',
+        timeout: 10000,
+      },
+    },
+    { result: { action: OpenSort, timeout: 10000 } },
+    { action: OpenSort },
+    { result: { action: SortBySize, timeout: 10000 } },
+    { action: SortBySize },
+    { result: { selector: '[data-sort-by="size"][data-sort-order="asc"]', timeout: 10000 } },
+    {
+      result: {
+        selector: '[data-resource-name="e2e-sort-z.txt"] ~ [data-resource-name="e2e-sort-a.txt"]',
+        timeout: 10000,
+      },
+    },
+  ],
+}

package/src/sort-storage-type.flow.js

@@ -0,0 +1,83 @@
+import signUpFlow from '@ossy/authentication/sign-up.flow.js'
+import { metadata as ConfirmUpload } from './confirm-upload.action.js'
+import { metadata as CreateResource } from './create.action.js'
+import { metadata as CreateDocumentForm } from './create-document.form.js'
+import { metadata as FinishUpload } from './finish-upload.action.js'
+import { metadata as OpenSort } from './open-sort.action.js'
+import { metadata as SortByType } from './sort-by-type.action.js'
+
+export const metadata = {
+  id: '@ossy/resources/flows/sort-storage-type',
+  feature: 'resources',
+  requires: ['server', 'database'],
+  timeout: 180_000,
+}
+
+/**
+ * Create a markdown doc and upload a file whose name order is opposite their
+ * schema-type order, then sort by type and assert the type order wins.
+ *
+ * Type asc: `@ossy/platform/schema/file` before `@ossy/resources/schema/markdown`.
+ * Names: aaa-note (markdown) vs zzz-file.txt (file) so name-asc is the reverse.
+ */
+export default {
+  title: 'Sort storage resources by type',
+  description:
+    'Signed-in user creates a markdown doc and uploads a file, opens sort, chooses type, and sees type ascending order',
+  steps: [
+    ...signUpFlow.steps,
+    {
+      page: '@create-document',
+      search: {
+        location: '/',
+        schemaId: '@ossy/resources/schema/markdown',
+      },
+    },
+    { result: { selector: '[data-flow-stage="create-document"]', timeout: 15000 } },
+    { result: { action: CreateResource, timeout: 10000 } },
+    { form: CreateDocumentForm, fields: { name: 'aaa-note' } },
+    { action: CreateResource },
+    { result: { page: '@storage/home', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="aaa-note"]', timeout: 20000 } },
+    { page: '@upload-media', search: { location: '/' } },
+    { result: { selector: '#upload-resources', timeout: 15000 } },
+    { result: { selector: '[data-flow-stage="upload-idle"]', timeout: 15000 } },
+    {
+      files: {
+        selector: '#upload-resources',
+        items: [{
+          name: 'zzz-file.txt',
+          mimeType: 'text/plain',
+          content: 'type sort file',
+        }],
+      },
+    },
+    { result: { selector: '[data-flow-stage="upload-preview"]', timeout: 15000 } },
+    { result: { action: ConfirmUpload, timeout: 10000 } },
+    { action: ConfirmUpload },
+    { result: { selector: '[data-flow-stage="upload-done"]', timeout: 30000 } },
+    { result: { action: FinishUpload, timeout: 10000 } },
+    { action: FinishUpload },
+    { result: { page: '@storage/home', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="aaa-note"]', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="zzz-file.txt"]', timeout: 20000 } },
+    { result: { selector: '[data-sort-by="name"][data-sort-order="asc"]', timeout: 10000 } },
+    {
+      result: {
+        selector: '[data-resource-name="aaa-note"] ~ [data-resource-name="zzz-file.txt"]',
+        timeout: 10000,
+      },
+    },
+    { result: { action: OpenSort, timeout: 10000 } },
+    { action: OpenSort },
+    { result: { action: SortByType, timeout: 10000 } },
+    { action: SortByType },
+    { result: { selector: '[data-sort-by="type"][data-sort-order="asc"]', timeout: 10000 } },
+    {
+      result: {
+        selector: '[data-resource-name="zzz-file.txt"] ~ [data-resource-name="aaa-note"]',
+        timeout: 10000,
+      },
+    },
+  ],
+}

package/src/sort-storage.flow.js

@@ -0,0 +1,86 @@
+import signUpFlow from '@ossy/authentication/sign-up.flow.js'
+import { metadata as ConfirmUpload } from './confirm-upload.action.js'
+import { metadata as FinishUpload } from './finish-upload.action.js'
+import { metadata as OpenSort } from './open-sort.action.js'
+import { metadata as SortDescending } from './sort-descending.action.js'
+
+export const metadata = {
+  id: '@ossy/resources/flows/sort-storage',
+  feature: 'resources',
+  requires: ['server', 'database'],
+  timeout: 180_000,
+}
+
+/**
+ * Upload two differently named files, open the storage sort menu, switch to
+ * name descending, and assert list order + sort markers.
+ */
+export default {
+  title: 'Sort storage resources by name',
+  description:
+    'Signed-in user uploads two files, opens sort, chooses name descending, and sees the reversed list order',
+  steps: [
+    ...signUpFlow.steps,
+    { page: '@upload-media', search: { location: '/' } },
+    { result: { selector: '#upload-resources', timeout: 15000 } },
+    { result: { selector: '[data-flow-stage="upload-idle"]', timeout: 15000 } },
+    {
+      files: {
+        selector: '#upload-resources',
+        items: [{
+          name: 'e2e-sort-a.txt',
+          mimeType: 'text/plain',
+          content: 'sort a',
+        }],
+      },
+    },
+    { result: { selector: '[data-flow-stage="upload-preview"]', timeout: 15000 } },
+    { result: { action: ConfirmUpload, timeout: 10000 } },
+    { action: ConfirmUpload },
+    { result: { selector: '[data-flow-stage="upload-done"]', timeout: 30000 } },
+    { result: { action: FinishUpload, timeout: 10000 } },
+    { action: FinishUpload },
+    { result: { page: '@storage/home', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="e2e-sort-a.txt"]', timeout: 20000 } },
+    { page: '@upload-media', search: { location: '/' } },
+    { result: { selector: '#upload-resources', timeout: 15000 } },
+    { result: { selector: '[data-flow-stage="upload-idle"]', timeout: 15000 } },
+    {
+      files: {
+        selector: '#upload-resources',
+        items: [{
+          name: 'e2e-sort-z.txt',
+          mimeType: 'text/plain',
+          content: 'sort z',
+        }],
+      },
+    },
+    { result: { selector: '[data-flow-stage="upload-preview"]', timeout: 15000 } },
+    { result: { action: ConfirmUpload, timeout: 10000 } },
+    { action: ConfirmUpload },
+    { result: { selector: '[data-flow-stage="upload-done"]', timeout: 30000 } },
+    { result: { action: FinishUpload, timeout: 10000 } },
+    { action: FinishUpload },
+    { result: { page: '@storage/home', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="e2e-sort-a.txt"]', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="e2e-sort-z.txt"]', timeout: 20000 } },
+    { result: { selector: '[data-sort-by="name"][data-sort-order="asc"]', timeout: 10000 } },
+    {
+      result: {
+        selector: '[data-resource-name="e2e-sort-a.txt"] ~ [data-resource-name="e2e-sort-z.txt"]',
+        timeout: 10000,
+      },
+    },
+    { result: { action: OpenSort, timeout: 10000 } },
+    { action: OpenSort },
+    { result: { action: SortDescending, timeout: 10000 } },
+    { action: SortDescending },
+    { result: { selector: '[data-sort-by="name"][data-sort-order="desc"]', timeout: 10000 } },
+    {
+      result: {
+        selector: '[data-resource-name="e2e-sort-z.txt"] ~ [data-resource-name="e2e-sort-a.txt"]',
+        timeout: 10000,
+      },
+    },
+  ],
+}

package/src/sv.translations.json

@@ -49,11 +49,29 @@
   "resources.createDirectory.submit": "Skapa mapp",
   "resources.createDirectory.errorEmpty": "Mappnamn får inte vara tomt",
   "resources.createDirectory.errorOssyPrefix": "Mappnamn får inte börja med @ossy",
+  "@ossy/resources/actions/create-directory.label": "Skapa mapp",
+  "@ossy/resources/form/create-directory.label": "Skapa mapp",
+  "@ossy/resources/schema/create-directory.name.label": "Mappnamn",
+  "@ossy/resources/form/create-document.label": "Skapa dokument",
+  "@ossy/resources/schema/create-document.name.label": "Dokumentnamn",
   "resources.panel.download": "Ladda ner",
+  "resources.panel.delete": "Ta bort",
+  "resources.panel.rename": "Byt namn",
+  "resources.panel.move": "Flytta",
+  "resources.move.title": "Flytta resurs",
+  "resources.move.errorEmpty": "Målplatsen får inte vara tom",
+  "resources.move.errorFailed": "Kunde inte flytta resursen",
+  "@ossy/resources/form/rename.label": "Byt namn på resurs",
+  "@ossy/resources/schema/rename.name.label": "Namn",
+  "@ossy/resources/form/move.label": "Flytta resurs",
+  "@ossy/resources/schema/move.target.label": "Ny plats",
+  "@ossy/resources/actions/open-move.label": "Flytta resurs",
+  "@ossy/resources/actions/open-move.description": "Öppna dialogen för att flytta en resurs till en ny plats",
   "resources.share.title": "Dela länk",
   "resources.share.confirmPublic": "Gör den här resursen publik så att alla med länken kan öppna den. Du kan kopiera länken efter bekräftelse.",
   "resources.share.alreadyPublic": "Den här resursen är publik. Kopiera länken nedan för att dela den.",
   "resources.share.makePublic": "Gör publik & kopiera länk",
+  "resources.share.makePrivate": "Gör privat",
   "resources.share.copyLink": "Kopiera länk",
   "resources.share.linkCopied": "Länk kopierad",
   "resources.share.copyFailed": "Kunde inte kopiera länken",

package/src/toggle-selection-mode.action.js

@@ -0,0 +1,4 @@
+export const metadata = {
+  id: '@ossy/resources/actions/toggle-selection-mode',
+  access: 'workspace',
+}

package/src/upload-file.flow.js

@@ -0,0 +1,44 @@
+import signUpFlow from '@ossy/authentication/sign-up.flow.js'
+import { metadata as ConfirmUpload } from './confirm-upload.action.js'
+import { metadata as FinishUpload } from './finish-upload.action.js'
+
+export const metadata = {
+  id: '@ossy/resources/flows/upload-file',
+  feature: 'resources',
+  requires: ['server', 'database'],
+  timeout: 120_000,
+}
+
+/**
+ * New user signs up, opens the media upload page, attaches a file via the native
+ * file input, confirms upload, and sees the file listed on storage home.
+ */
+export default {
+  title: 'Upload file to storage',
+  description:
+    'Signed-in user opens upload-media, selects a file, uploads it, and lands on storage home with the file listed',
+  steps: [
+    ...signUpFlow.steps,
+    { page: '@upload-media', search: { location: '/' } },
+    { result: { selector: '#upload-resources', timeout: 15000 } },
+    { result: { selector: '[data-flow-stage="upload-idle"]', timeout: 15000 } },
+    {
+      files: {
+        selector: '#upload-resources',
+        items: [{
+          name: 'e2e-upload.txt',
+          mimeType: 'text/plain',
+          content: 'hello from ossy e2e upload',
+        }],
+      },
+    },
+    { result: { selector: '[data-flow-stage="upload-preview"]', timeout: 15000 } },
+    { result: { action: ConfirmUpload, timeout: 10000 } },
+    { action: ConfirmUpload },
+    { result: { selector: '[data-flow-stage="upload-done"]', timeout: 30000 } },
+    { result: { action: FinishUpload, timeout: 10000 } },
+    { action: FinishUpload },
+    { result: { page: '@storage/home', timeout: 20000 } },
+    { result: { selector: '[data-resource-name="e2e-upload.txt"]', timeout: 20000 } },
+  ],
+}

package/src/useResourceList.js

@@ -0,0 +1,94 @@
+'use client'
+import { useEffect, useMemo } from 'react'
+import { useCollectionView } from '@ossy/design-system'
+import { useSdk } from '@ossy/sdk-react'
+import { metadata as ListResources } from './list.action.js'
+import { DEFAULT_RESOURCE_LIST_LIMIT } from './resources-list-options.js'
+import { useResourceListQuery } from './resource-list-query.js'
+
+/**
+ * Read a resource folder with shared list/grid collection controls.
+ *
+ * When `limit` is set, list options are sent to `ListResources` so Mongo
+ * `$sort` / `$skip` / `$limit` run server-side. Without `limit`, behavior
+ * matches the legacy full-folder array response.
+ *
+ * Page and sort are stored in the URL (`page`, `sort`, `order`), same as the
+ * open resource id (`r`).
+ *
+ * @param {{
+ *   location: string,
+ *   limit?: number | null,
+ *   enabled?: boolean,
+ *   initialSortBy?: string,
+ *   initialSortOrder?: 'asc' | 'desc',
+ * }} options
+ */
+export function useResourceList ({
+  location,
+  limit = DEFAULT_RESOURCE_LIST_LIMIT,
+  enabled = true,
+  initialSortBy = 'name',
+  initialSortOrder = 'asc',
+} = {}) {
+  const sdk = useSdk()
+  const pageLimit = limit == null ? DEFAULT_RESOURCE_LIST_LIMIT : Math.max(1, Number(limit) || DEFAULT_RESOURCE_LIST_LIMIT)
+  const query = useResourceListQuery({
+    defaultSortBy: initialSortBy,
+    defaultSortOrder: initialSortOrder,
+  })
+  const {
+    pageIndex,
+    sortBy,
+    sortOrder,
+    setPage,
+  } = query
+  const offset = Math.max(0, pageIndex) * pageLimit
+
+  const controls = useMemo(() => ({
+    ...query,
+    limit: pageLimit,
+    offset,
+  }), [query, pageLimit, offset])
+
+  const payload = useMemo(() => {
+    const next = { location }
+    if (limit != null) {
+      next.limit = pageLimit
+      next.offset = offset
+      next.sortBy = sortBy
+      next.sortOrder = sortOrder
+    }
+    return next
+  }, [location, limit, pageLimit, offset, sortBy, sortOrder])
+
+  const {
+    status,
+    data,
+    error,
+    refetch,
+  } = sdk.read(ListResources, payload, { enabled: Boolean(enabled && location) })
+
+  const collection = useCollectionView(controls, { data, status, error })
+
+  useEffect(() => {
+    if (collection.total > 0 && pageIndex > collection.pageCount - 1) {
+      setPage(collection.pageCount - 1)
+    }
+  }, [collection.total, pageIndex, collection.pageCount, setPage])
+
+  return {
+    ...collection,
+    paginated: collection.paginated || limit != null,
+    refetch,
+    offset: collection.pageIndex * collection.limit,
+  }
+}
+
+export { normalizeCollectionResult } from '@ossy/design-system'
+export {
+  parseResourceListQuery,
+  resourceListQuerySearchString,
+  serializeResourceListQuery,
+  useResourceListQuery,
+} from './resource-list-query.js'

package/src/view-grid.action.js

@@ -0,0 +1,5 @@
+/** Client-only — switch storage resources to grid layout. */
+export const metadata = {
+  id: '@ossy/resources/actions/view-grid',
+  access: 'workspace',
+}

package/src/view-list.action.js

@@ -0,0 +1,5 @@
+/** Client-only — switch storage resources to list layout. */
+export const metadata = {
+  id: '@ossy/resources/actions/view-list',
+  access: 'workspace',
+}