@ossy/resources 1.12.0 → 1.12.2

package/src/create.action.js

@@ -1,98 +1 @@
-import { is } from 'ramda'
-import { nanoid } from 'nanoid'
-import { Aggregate } from '@ossy/event-store'
-import { Resource, ResourcesEvents } from '@ossy/resources'
-import { Workspace } from '@ossy/workspaces'
-import { getSystemResourceTemplates, normalizeAndValidateDocumentContent } from '@ossy/platform'
-
-export const id = 'resources/create'
-export const access = 'workspace'
-
-const NativeResourceTypes = { DIRECTORY: 'directory' }
-
-export async function run({ payload, integrations, req }) {
-  const createdBy = payload?.userId ?? req?.userId
-  const workspaceId = payload?.workspaceId ?? req?.workspaceId
-
-  const workspace = await Aggregate.Of(Workspace, workspaceId).then(Aggregate.View())
-  let location = payload?.location
-  const type = payload?.type
-  const name = payload?.name
-  const fileExtension = name?.split?.('.')?.pop?.()
-  const content = payload?.content
-  const size = payload?.size
-
-  if (!is(String, location)) {
-    throw Object.assign(new Error(`Not a valid location path: ${location}`), { status: 400, type: 'INVALID_PATH' })
-  }
-
-  location = location.endsWith('/') ? location : location + '/'
-  location = location.startsWith('/') ? location : '/' + location
-
-  const systemTemplates = getSystemResourceTemplates()
-  const allTemplates = [
-    ...systemTemplates,
-    ...(workspace.resourceTemplates || []).filter(t => !systemTemplates.find(s => s.id === t.id)),
-  ]
-  const isResourceTemplateType = allTemplates.map(t => t.id).includes(type)
-
-  if (type === NativeResourceTypes.DIRECTORY) {
-    const event = ResourcesEvents.Created({
-      type: NativeResourceTypes.DIRECTORY,
-      createdBy,
-      belongsTo: workspace.id,
-      location,
-      name,
-      access: 'workspace',
-    })
-    return Aggregate.Of(Resource, event).then(Aggregate.View())
-  }
-
-  if (isResourceTemplateType) {
-    const template = allTemplates.find(t => t.id === type)
-    const normalized = normalizeAndValidateDocumentContent(content, template)
-    if (!normalized.ok) {
-      throw Object.assign(new Error(normalized.message), { status: 400, type: normalized.code })
-    }
-    const event = ResourcesEvents.Created({
-      type,
-      createdBy,
-      belongsTo: workspace.id,
-      location,
-      name,
-      content: normalized.content,
-    })
-    return Aggregate.Of(Resource, event).then(Aggregate.View())
-  }
-
-  if (!fileExtension) {
-    throw Object.assign(new Error('Missing valid file extension'), { status: 400 })
-  }
-
-  const aggregateId = nanoid()
-  const event = ResourcesEvents.Created({
-    aggregateId,
-    type,
-    createdBy,
-    belongsTo: workspace.id,
-    location,
-    name,
-    content: {
-      Key: `media/${workspace.id}/${aggregateId}/original.${fileExtension}`,
-      ContentLength: size,
-      ContentType: type,
-    },
-  })
-
-  const storageClient = integrations?.get?.('storage')
-  const uploadHeaders = {
-    ContentLength: event.payload.content.ContentLength,
-    ContentType: event.payload.content.ContentType,
-    Key: event.payload.content.Key,
-  }
-  const uploadUrl = storageClient ? await storageClient.createUploadUrl(uploadHeaders) : null
-  const resource = await Aggregate.Of(Resource, event).then(Aggregate.View())
-  return uploadUrl
-    ? { ...resource, content: { ...resource.content, uploadUrl } }
-    : resource
-}
+export const metadata = { id: 'resources/create', access: 'workspace' }

package/src/create.task.js

@@ -0,0 +1,100 @@
+import { is } from 'ramda'
+import { nanoid } from 'nanoid'
+import { Aggregate } from '@ossy/event-store'
+import { Resource } from './resource.aggregate.js'
+import { ResourcesEvents } from './resources.events.js'
+import { Workspace } from '@ossy/workspaces/server'
+import { getSystemResourceTemplates, normalizeAndValidateDocumentContent } from '@ossy/platform'
+import { mediaContextFromRun, withResourceMedia } from './resources.action-media.js'
+
+export const metadata = { id: 'resources/create' }
+
+const NativeResourceTypes = { DIRECTORY: 'directory' }
+
+export async function run({ payload, integrations, req }) {
+  const createdBy = payload?.userId ?? req?.userId
+  const workspaceId = payload?.workspaceId ?? req?.workspaceId
+
+  const workspace = await Aggregate.Of(Workspace, workspaceId).then(Aggregate.View())
+  let location = payload?.location
+  const type = payload?.type
+  const name = payload?.name
+  const fileExtension = name?.split?.('.')?.pop?.()
+  const content = payload?.content
+  const size = payload?.size
+
+  if (!is(String, location)) {
+    throw Object.assign(new Error(`Not a valid location path: ${location}`), { status: 400, type: 'INVALID_PATH' })
+  }
+
+  location = location.endsWith('/') ? location : location + '/'
+  location = location.startsWith('/') ? location : '/' + location
+
+  const systemTemplates = getSystemResourceTemplates()
+  const allTemplates = [
+    ...systemTemplates,
+    ...(workspace.resourceTemplates || []).filter(t => !systemTemplates.find(s => s.id === t.id)),
+  ]
+  const isResourceTemplateType = allTemplates.map(t => t.id).includes(type)
+
+  if (type === NativeResourceTypes.DIRECTORY) {
+    const event = ResourcesEvents.Created({
+      type: NativeResourceTypes.DIRECTORY,
+      createdBy,
+      belongsTo: workspace.id,
+      location,
+      name,
+      access: 'workspace',
+    })
+    return Aggregate.Of(Resource, event).then(Aggregate.View())
+  }
+
+  if (isResourceTemplateType) {
+    const template = allTemplates.find(t => t.id === type)
+    const normalized = normalizeAndValidateDocumentContent(content, template)
+    if (!normalized.ok) {
+      throw Object.assign(new Error(normalized.message), { status: 400, type: normalized.code })
+    }
+    const event = ResourcesEvents.Created({
+      type,
+      createdBy,
+      belongsTo: workspace.id,
+      location,
+      name,
+      content: normalized.content,
+    })
+    return Aggregate.Of(Resource, event).then(Aggregate.View())
+  }
+
+  if (!fileExtension) {
+    throw Object.assign(new Error('Missing valid file extension'), { status: 400 })
+  }
+
+  const aggregateId = nanoid()
+  const event = ResourcesEvents.Created({
+    aggregateId,
+    type,
+    createdBy,
+    belongsTo: workspace.id,
+    location,
+    name,
+    content: {
+      Key: `media/${workspace.id}/${aggregateId}/original.${fileExtension}`,
+      ContentLength: size,
+      ContentType: type,
+    },
+  })
+
+  const storageClient = integrations?.get?.('storage')
+  const uploadHeaders = {
+    ContentLength: event.payload.content.ContentLength,
+    ContentType: event.payload.content.ContentType,
+    Key: event.payload.content.Key,
+  }
+  const uploadUrl = storageClient ? await storageClient.createUploadUrl(uploadHeaders) : null
+  const resource = await Aggregate.Of(Resource, event).then(Aggregate.View())
+  const withUpload = uploadUrl
+    ? { ...resource, content: { ...resource.content, uploadUrl } }
+    : resource
+  return withResourceMedia(withUpload, mediaContextFromRun({ payload, req }))
+}

package/src/delete.action.js

@@ -1,31 +1 @@
-import { Aggregate } from '@ossy/event-store'
-import { Resource, ResourcesEvents } from '@ossy/resources'
-import { ResourcesQueries } from './resources.queries.js'
-
-export const id = 'resources/delete'
-export const access = 'workspace'
-
-const DIRECTORY_TYPE = 'directory'
-
-export async function run({ payload, req }) {
-  const createdBy = payload?.userId ?? req?.userId
-  const resourceId = payload?.resourceId ?? req?.params?.resourceId
-
-  if (!resourceId) throw Object.assign(new Error('resourceId is required'), { status: 400 })
-
-  const aggregate = await Aggregate.Of(Resource, resourceId)
-  const resource = Aggregate.View()(aggregate)
-
-  if (resource.type === DIRECTORY_TYPE) {
-    const nestedResources = await ResourcesQueries.GetNestedResources({
-      location: resource.location + resource.name + '/',
-    })
-    await Promise.all(nestedResources.map(nested =>
-      Aggregate.Of(Resource, nested.id)
-        .then(Aggregate.Add(ResourcesEvents.Deleted({ createdBy })))
-    ))
-  }
-
-  await Aggregate.Add(ResourcesEvents.Deleted({ createdBy }))(aggregate)
-  return null
-}
+export const metadata = { id: 'resources/delete', access: 'workspace' }

package/src/delete.task.js

@@ -0,0 +1,31 @@
+import { Aggregate } from '@ossy/event-store'
+import { Resource } from './resource.aggregate.js'
+import { ResourcesEvents } from './resources.events.js'
+import { ResourcesQueries } from './resources.queries.js'
+
+export const metadata = { id: 'resources/delete' }
+
+const DIRECTORY_TYPE = 'directory'
+
+export async function run({ payload, req }) {
+  const createdBy = payload?.userId ?? req?.userId
+  const resourceId = payload?.resourceId ?? req?.params?.resourceId
+
+  if (!resourceId) throw Object.assign(new Error('resourceId is required'), { status: 400 })
+
+  const aggregate = await Aggregate.Of(Resource, resourceId)
+  const resource = Aggregate.View()(aggregate)
+
+  if (resource.type === DIRECTORY_TYPE) {
+    const nestedResources = await ResourcesQueries.GetNestedResources({
+      location: resource.location + resource.name + '/',
+    })
+    await Promise.all(nestedResources.map(nested =>
+      Aggregate.Of(Resource, nested.id)
+        .then(Aggregate.Add(ResourcesEvents.Deleted({ createdBy })))
+    ))
+  }
+
+  await Aggregate.Add(ResourcesEvents.Deleted({ createdBy }))(aggregate)
+  return null
+}

package/src/en.translations.json

@@ -1,5 +1,5 @@
 {
-  "resources.home.documentTitle": "Free Resources",
+  "resources/home.documentTitle": "Free Resources",
   "resources.home.title": "Free Resources",
   "resources.home.description": "We believe in providing value at every step of your journey with us. That's why we've curated a collection of free resources. Whether you're looking to enhance your creative projects or simply seeking inspiration, explore the gallery below to discover valuable assets that align with your vision. We hope you find them useful, and we're here if you have any questions!",
   "resources.form.nameRequired": "Name is required",
@@ -31,10 +31,10 @@
   "resources/create-page-view.description": "Record a page view analytics event",
   "resources/get-page-view-stats.label": "Get page view stats",
   "resources/get-page-view-stats.description": "Fetch aggregated page view statistics",
-  "resources.create.generic.documentTitle": "Create resource",
-  "createDirectory.documentTitle": "Create directory",
-  "createDocument.documentTitle": "Create document",
-  "uploadMedia.documentTitle": "Upload",
+  "resources/create/generic.documentTitle": "Create resource",
+  "create-directory.documentTitle": "Create directory",
+  "create-document.documentTitle": "Create document",
+  "upload-media.documentTitle": "Upload",
   "@resource.documentTitle": "Resource",
   "resources.upload.title": "Upload",
   "resources.upload.location": "Location: {location}",

package/src/get-page-view-stats.action.js

@@ -1,65 +1 @@
-import { Aggregate } from '@ossy/event-store'
-import { Workspace } from '@ossy/workspaces'
-
-export const id = 'resources/get-page-view-stats'
-export const access = 'workspace'
-
-const PAGE_VIEW_TEMPLATE_ID = '@ossy/web/page-view'
-const PAGE_VIEW_LOCATION = '/@ossy/analytics/page-views/'
-
-function parseMillis(input, fallback) {
-  if (input === undefined || input === null || input === '') return fallback
-  const n = Number(input)
-  if (!Number.isFinite(n) || n <= 0) return fallback
-  return n
-}
-
-export async function run({ payload, req }) {
-  const workspaceId = payload?.workspaceId ?? req?.workspaceId
-  if (!workspaceId) throw Object.assign(new Error('workspaceId is required'), { status: 400 })
-
-  const workspace = await Aggregate.Of(Workspace, workspaceId).then(Aggregate.View())
-
-  const now = Date.now()
-  const defaultFrom = now - (30 * 24 * 60 * 60 * 1000)
-  const from = parseMillis(payload?.from ?? req?.query?.from, defaultFrom)
-  const to = parseMillis(payload?.to ?? req?.query?.to, now)
-  const topLimit = Math.min(Math.max(Number(payload?.limit ?? req?.query?.limit ?? 10), 1), 50)
-
-  const baseMatch = {
-    type: 'Resource',
-    'state.status': { $ne: 'removed' },
-    'state.belongsTo': workspace.id,
-    'state.type': PAGE_VIEW_TEMPLATE_ID,
-    'state.location': PAGE_VIEW_LOCATION,
-    'state.content.eventAt': { $gte: from, $lte: to },
-  }
-
-  const [dailyViews, topPaths, totals] = await Promise.all([
-    Aggregate.Collection.aggregate([
-      { $match: baseMatch },
-      { $project: { date: { $dateToString: { format: '%Y-%m-%d', date: { $toDate: '$state.content.eventAt' } } } } },
-      { $group: { _id: '$date', views: { $sum: 1 } } },
-      { $sort: { _id: 1 } },
-    ]).toArray(),
-    Aggregate.Collection.aggregate([
-      { $match: baseMatch },
-      { $group: { _id: '$state.content.path', views: { $sum: 1 } } },
-      { $sort: { views: -1 } },
-      { $limit: topLimit },
-      { $project: { _id: 0, path: '$_id', views: 1 } },
-    ]).toArray(),
-    Aggregate.Collection.aggregate([
-      { $match: baseMatch },
-      { $count: 'views' },
-    ]).toArray(),
-  ])
-
-  return {
-    from,
-    to,
-    totalViews: totals?.[0]?.views || 0,
-    dailyViews: dailyViews.map(x => ({ date: x._id, views: x.views })),
-    topPaths,
-  }
-}
+export const metadata = { id: 'resources/get-page-view-stats', access: 'workspace' }

package/src/get-page-view-stats.task.js

@@ -0,0 +1,64 @@
+import { Aggregate } from '@ossy/event-store'
+import { Workspace } from '@ossy/workspaces/server'
+
+export const metadata = { id: 'resources/get-page-view-stats' }
+
+const PAGE_VIEW_TEMPLATE_ID = '@ossy/web/page-view'
+const PAGE_VIEW_LOCATION = '/@ossy/analytics/page-views/'
+
+function parseMillis(input, fallback) {
+  if (input === undefined || input === null || input === '') return fallback
+  const n = Number(input)
+  if (!Number.isFinite(n) || n <= 0) return fallback
+  return n
+}
+
+export async function run({ payload, req }) {
+  const workspaceId = payload?.workspaceId ?? req?.workspaceId
+  if (!workspaceId) throw Object.assign(new Error('workspaceId is required'), { status: 400 })
+
+  const workspace = await Aggregate.Of(Workspace, workspaceId).then(Aggregate.View())
+
+  const now = Date.now()
+  const defaultFrom = now - (30 * 24 * 60 * 60 * 1000)
+  const from = parseMillis(payload?.from ?? req?.query?.from, defaultFrom)
+  const to = parseMillis(payload?.to ?? req?.query?.to, now)
+  const topLimit = Math.min(Math.max(Number(payload?.limit ?? req?.query?.limit ?? 10), 1), 50)
+
+  const baseMatch = {
+    type: 'Resource',
+    'state.status': { $ne: 'removed' },
+    'state.belongsTo': workspace.id,
+    'state.type': PAGE_VIEW_TEMPLATE_ID,
+    'state.location': PAGE_VIEW_LOCATION,
+    'state.content.eventAt': { $gte: from, $lte: to },
+  }
+
+  const [dailyViews, topPaths, totals] = await Promise.all([
+    Aggregate.Collection.aggregate([
+      { $match: baseMatch },
+      { $project: { date: { $dateToString: { format: '%Y-%m-%d', date: { $toDate: '$state.content.eventAt' } } } } },
+      { $group: { _id: '$date', views: { $sum: 1 } } },
+      { $sort: { _id: 1 } },
+    ]).toArray(),
+    Aggregate.Collection.aggregate([
+      { $match: baseMatch },
+      { $group: { _id: '$state.content.path', views: { $sum: 1 } } },
+      { $sort: { views: -1 } },
+      { $limit: topLimit },
+      { $project: { _id: 0, path: '$_id', views: 1 } },
+    ]).toArray(),
+    Aggregate.Collection.aggregate([
+      { $match: baseMatch },
+      { $count: 'views' },
+    ]).toArray(),
+  ])
+
+  return {
+    from,
+    to,
+    totalViews: totals?.[0]?.views || 0,
+    dailyViews: dailyViews.map(x => ({ date: x._id, views: x.views })),
+    topPaths,
+  }
+}

package/src/get.action.js

@@ -1,14 +1 @@
-import { Aggregate } from '@ossy/event-store'
-import { Resource } from '@ossy/resources'
-
-export const id = 'resources/get'
-export const access = 'workspace'
-
-export async function run({ payload, req }) {
-  const resourceId = payload?.resourceId ?? req?.params?.resourceId
-  if (!resourceId) throw Object.assign(new Error('resourceId is required'), { status: 400 })
-
-  const resource = await Aggregate.Of(Resource, resourceId).then(Aggregate.View())
-  if (!resource?.id) throw Object.assign(new Error('Resource not found'), { status: 404 })
-  return resource
-}
+export const metadata = { id: 'resources/get', access: 'workspace' }

package/src/get.task.js

@@ -0,0 +1,14 @@
+import { Aggregate } from '@ossy/event-store'
+import { Resource } from './resource.aggregate.js'
+import { mediaContextFromRun, withResourceMedia } from './resources.action-media.js'
+
+export const metadata = { id: 'resources/get' }
+
+export async function run({ payload, req }) {
+  const resourceId = payload?.resourceId ?? req?.params?.resourceId
+  if (!resourceId) throw Object.assign(new Error('resourceId is required'), { status: 400 })
+
+  const resource = await Aggregate.Of(Resource, resourceId).then(Aggregate.View())
+  if (!resource?.id) throw Object.assign(new Error('Resource not found'), { status: 404 })
+  return withResourceMedia(resource, mediaContextFromRun({ payload, req }))
+}

package/src/index.js

@@ -1,7 +1,15 @@
-export * from './resource.aggregate.js'
-export * from './resources.events.js'
-export * from './resources.queries.js'
-
+export { metadata as CreateResource } from './create.action.js'
+export { metadata as GetResource } from './get.action.js'
+export { metadata as ListResources } from './list.action.js'
+export { metadata as SearchResources } from './search.action.js'
+export { metadata as DeleteResource } from './delete.action.js'
+export { metadata as UpdateResourceContent } from './update-content.action.js'
+export { metadata as UpdateResourceLocation } from './update-location.action.js'
+export { metadata as UpdateResourceName } from './update-name.action.js'
+export { metadata as UpdateResourceAccess } from './update-access.action.js'
+export { metadata as UploadNamedVersion } from './upload-named-version.action.js'
+export { metadata as CreatePageView } from './create-page-view.action.js'
+export { metadata as GetPageViewStats } from './get-page-view-stats.action.js'
 export * from './AudioResource.jsx'
 export * from './CreateDirectory.jsx'
 export * from './CreateDocument.jsx'
@@ -29,3 +37,4 @@ export * from './UploadResources.jsx'
 export * from './VideoResource.jsx'
 export * from './useActivePath.jsx'
 export * from './useForm.js'
+export * from './resource.helpers.js'

package/src/list.action.js

@@ -1,19 +1 @@
-import { ResourcesQueries } from './resources.queries.js'
-
-export const id = 'resources/list'
-export const access = 'workspace'
-
-export async function run({ payload, req }) {
-  const query = { ...(payload?.query ?? {}) }
-  const workspaceId = payload?.workspaceId ?? req?.workspaceId
-  const user = payload?.user ?? req?.user
-  let location = payload?.location ?? query.location
-
-  if (location && !location.endsWith('/')) location += '/'
-  if (location && !location.startsWith('/')) location = '/' + location
-  if (location) query.location = location
-
-  if (workspaceId) query.belongsTo = workspaceId
-
-  return ResourcesQueries.GetResources(query, user)
-}
+export const metadata = { id: 'resources/list', access: 'workspace' }

package/src/list.task.js

@@ -0,0 +1,20 @@
+import { ResourcesQueries } from './resources.queries.js'
+import { mediaContextFromRun, withResourceMedia } from './resources.action-media.js'
+
+export const metadata = { id: 'resources/list' }
+
+export async function run({ payload, req }) {
+  const query = { ...(payload?.query ?? {}) }
+  const workspaceId = payload?.workspaceId ?? req?.workspaceId
+  const user = payload?.user ?? req?.user
+  let location = payload?.location ?? query.location
+
+  if (location && !location.endsWith('/')) location += '/'
+  if (location && !location.startsWith('/')) location = '/' + location
+  if (location) query.location = location
+
+  if (workspaceId) query.belongsTo = workspaceId
+
+  const resources = await ResourcesQueries.GetResources(query, user)
+  return withResourceMedia(resources, mediaContextFromRun({ payload, req }))
+}

package/src/resource-create.page.jsx

@@ -1,5 +1,6 @@
 import React, { useState } from 'react'
-import { useResources } from '@ossy/sdk-react'
+import { createDocument } from './resource.helpers.js'
+import { useSdk } from '@ossy/sdk-react'
 import { View, useLocale } from '@ossy/design-system'
 import { useRouter } from '@ossy/router-react'
 import { GenericResourceForm } from './GenericResourceForm.jsx'
@@ -18,7 +19,7 @@ export default function GenericResourceCreatePage () {
   const { t } = useLocale()
   const templateId = decodeURIComponent(router.params.templateId || '')
   const location = router.searchParams.location
-  const { createDocument } = useResources()
+  const sdk = useSdk()
   const [error, setError] = useState()
 
   const onCancel = () => {
@@ -27,7 +28,7 @@ export default function GenericResourceCreatePage () {
   }
 
   const onSubmit = ({ name, content, type }) => {
-    createDocument({ type, location, name, content })
+    createDocument(sdk, { type, location, name, content })
       .then(() => onCancel())
       .catch((err) => setError(err?.message || t('resources.form.createFailed')))
   }

package/src/resource.helpers.js

@@ -0,0 +1,83 @@
+import { cacheKey, normalizeLocation } from '@ossy/sdk-react'
+import { metadata as CreateResource } from './create.action.js'
+import { metadata as DeleteResource } from './delete.action.js'
+import { metadata as ListResources } from './list.action.js'
+import { metadata as UpdateResourceAccess } from './update-access.action.js'
+import { metadata as UpdateResourceContent } from './update-content.action.js'
+import { metadata as UpdateResourceLocation } from './update-location.action.js'
+import { metadata as UpdateResourceName } from './update-name.action.js'
+
+function invalidateLocation(sdk, location) {
+  sdk.invalidate(cacheKey(ListResources, { location: normalizeLocation(location) }))
+}
+
+export async function createDocument(sdk, document) {
+  const resource = await sdk.invoke(CreateResource, {
+    type: document.type,
+    location: normalizeLocation(document.location),
+    name: document.name,
+    content: document.content,
+  })
+  invalidateLocation(sdk, resource.location)
+  return resource
+}
+
+export async function createDirectory(sdk, { location, name }) {
+  const resource = await sdk.invoke(CreateResource, {
+    type: 'directory',
+    location: normalizeLocation(location),
+    name,
+  })
+  invalidateLocation(sdk, resource.location)
+  return resource
+}
+
+export async function uploadFile(sdk, uploadLocation, file) {
+  const location = normalizeLocation(uploadLocation)
+  const resource = await sdk.invoke(CreateResource, {
+    type: file.type,
+    location,
+    name: file.name,
+    size: file.size,
+  })
+  if (resource.content?.uploadUrl) {
+    await fetch(resource.content.uploadUrl, { method: 'PUT', body: file })
+  }
+  invalidateLocation(sdk, location)
+  return resource
+}
+
+export async function removeResource(sdk, id, location) {
+  await sdk.invoke(DeleteResource, { id })
+  if (location) invalidateLocation(sdk, location)
+  sdk.invalidate(cacheKey({ id: 'resources/get' }, { id }))
+}
+
+export async function updateResourceContent(sdk, id, content) {
+  const resource = await sdk.invoke(UpdateResourceContent, { id, content })
+  invalidateLocation(sdk, resource.location)
+  sdk.invalidate(cacheKey({ id: 'resources/get' }, { id }))
+  return resource
+}
+
+export async function moveResource(sdk, id, target, sourceLocation) {
+  const resource = await sdk.invoke(UpdateResourceLocation, { id, target })
+  invalidateLocation(sdk, resource.location)
+  if (sourceLocation) invalidateLocation(sdk, sourceLocation)
+  sdk.invalidate(cacheKey({ id: 'resources/get' }, { id }))
+  return resource
+}
+
+export async function renameResource(sdk, id, name) {
+  const resource = await sdk.invoke(UpdateResourceName, { id, name })
+  invalidateLocation(sdk, resource.location)
+  sdk.invalidate(cacheKey({ id: 'resources/get' }, { id }))
+  return resource
+}
+
+export async function updateResourceAccess(sdk, params) {
+  const resource = await sdk.invoke(UpdateResourceAccess, params)
+  invalidateLocation(sdk, resource.location)
+  sdk.invalidate(cacheKey({ id: 'resources/get' }, { id: params.id }))
+  return resource
+}

package/src/resources.action-media.js

@@ -0,0 +1,18 @@
+import { attachResourceMediaUrls } from './resources.attach-media-urls.js'
+
+export function mediaContextFromRun({ payload, req }) {
+  return {
+    userId: payload?.userId ?? req?.userId,
+    workspaceId: payload?.workspaceId ?? req?.workspaceId,
+  }
+}
+
+export async function withResourceMedia(result, context) {
+  if (Array.isArray(result)) {
+    return Promise.all(result.map(r => attachResourceMediaUrls(r, context)))
+  }
+  if (result && typeof result === 'object' && result.id) {
+    return attachResourceMediaUrls(result, context)
+  }
+  return result
+}

package/src/resources.attach-media-urls.js

@@ -1,6 +1,6 @@
 import { StorageClient } from '@ossy/platform'
 import { Aggregate } from '@ossy/event-store'
-import { Workspace } from '@ossy/workspaces'
+import { Workspace } from '@ossy/workspaces/server'
 
 /**
  * Adds `content.src` (and `content.sizes[*]` URLs) for file resources, respecting

package/src/resources.events.js

@@ -75,6 +75,7 @@ export class ResourcesEvents {
     })
   }
 
+  // TODO: remove named version concept
   static NamedVersionUploaded({
     createdBy,
     namedVersion,