@ossy/analytics 3.0.9 → 3.5.0

package/README.md

@@ -0,0 +1,30 @@
+# @ossy/analytics
+
+Analytics feature package for the Ossy platform. Shows **workspace-scoped** traffic and insight KPIs.
+
+Platform-wide (ops) insights belong in a future back-office surface — see [ADR 0014](../../docs/adr/0014-system-insights-in-back-office.md).
+
+## Pages
+
+| Page | Path | Audience |
+|------|------|----------|
+| `analytics/home` | `/analytics` · `/analys` | Signed-in + entitled → product KPIs. Otherwise the public sales page (no KPI loads). |
+
+## Actions
+
+| Action | Access | Notes |
+|--------|--------|-------|
+| `@ossy/analytics/actions/get-workspace-kpis` | `workspace` | Member count + non-removed resource count for the current workspace |
+| `@ossy/resources/actions/get-page-view-stats` | `workspace` | Page-view aggregates (implemented in `@ossy/resources`) |
+
+## Client usage
+
+```js
+import { GetWorkspaceKpis } from '@ossy/analytics'
+
+await sdk.invoke(GetWorkspaceKpis, {})
+```
+
+## Preview
+
+Enable Analytics in workspace entitlements (or `devEntitlements` in `@ossy/app-test`), then open `/analytics`.

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@ossy/analytics",
-  "description": "Analytics module — workspace analytics for website traffic",
-  "version": "3.0.9",
+  "description": "Analytics module — workspace insight KPIs",
+  "version": "3.5.0",
   "type": "module",
   "main": "./src/index.js",
   "module": "./src/index.js",
   "exports": {
     ".": "./src/index.js"
   },
+  "scripts": {
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest --verbose"
+  },
   "author": "Ossy <yourfriends@ossy.se> (https://ossy.se)",
   "license": "MIT",
   "ossy": {
@@ -21,11 +24,23 @@
     "/src",
     "README.md"
   ],
+  "dependencies": {
+    "@ossy/event-store": "^3.4.0",
+    "@ossy/workspaces": "^3.5.0"
+  },
   "peerDependencies": {
+    "@ossy/app": "*",
+    "@ossy/authentication": "*",
     "@ossy/design-system": "*",
     "@ossy/resources": "*",
+    "@ossy/router-react": "*",
     "@ossy/sdk-react": "*",
+    "@ossy/workspaces": "*",
     "react": "*"
   },
-  "gitHead": "908fae28675f6c3c179d4c2eecb451e8a1af886e"
+  "devDependencies": {
+    "@jest/globals": "^30.2.0",
+    "jest": "^30.2.0"
+  },
+  "gitHead": "23167600f991596f122765a53f2b9df08314e115"
 }

package/src/AnalyticsProductHome.jsx

@@ -0,0 +1,124 @@
+import React, { useMemo } from 'react'
+import { Text, View, Page, useLocale } from '@ossy/design-system'
+import { usePageViewStats } from './usePageViewStats.js'
+import { useWorkspaceKpis } from './useWorkspaceKpis.js'
+import { useSdk } from '@ossy/sdk-react'
+import { GetWorkspace } from '@ossy/workspaces'
+
+function SummaryCard ({ label, value }) {
+  return (
+    <View
+      surface="primary"
+      roundness="m"
+      inset="m"
+      style={{ border: '1px solid var(--separator)' }}
+    >
+      <Text variant="small" style={{ opacity: 0.75 }}>{label}</Text>
+      <Text variant="heading-secondary" as="h2">{value}</Text>
+    </View>
+  )
+}
+
+/**
+ * Workspace analytics product UI. Only mount when the caller is authenticated
+ * so KPI / page-view actions do not run for anonymous sessions.
+ */
+export default function AnalyticsProductHome () {
+  const { t } = useLocale()
+  const sdk = useSdk()
+  const { data: workspace } = sdk.read(GetWorkspace)
+  const { from, to } = useMemo(() => {
+    const now = Date.now()
+    return { from: now - 30 * 24 * 60 * 60 * 1000, to: now }
+  }, [])
+
+  const pageViews = usePageViewStats({
+    workspaceId: workspace?.id,
+    from,
+    to,
+    limit: 10,
+  })
+  const workspaceKpis = useWorkspaceKpis({ workspaceId: workspace?.id })
+
+  const { status, totalViews, dailyViews, topPaths } = pageViews
+
+  return (
+    <Page
+      title="analytics.home.title"
+      description="analytics.home.description"
+    >
+      <View gap="m">
+        {(workspaceKpis.status === 'loading' || status === 'loading') && (
+          <View surface="primary" roundness="m" inset="m">
+            <Text>{t('analytics.home.loading')}</Text>
+          </View>
+        )}
+
+        {workspaceKpis.status === 'error' && (
+          <View surface="primary" roundness="m" inset="m">
+            <Text>{t('analytics.home.workspaceKpisError')}</Text>
+          </View>
+        )}
+
+        {workspaceKpis.status === 'success' && (
+          <View layout="row" gap="m">
+            <SummaryCard label={t('analytics.home.members')} value={`${workspaceKpis.members}`} />
+            <SummaryCard label={t('analytics.home.resources')} value={`${workspaceKpis.resources}`} />
+          </View>
+        )}
+
+        {status === 'error' && (
+          <View surface="primary" roundness="m" inset="m">
+            <Text>{t('analytics.home.error')}</Text>
+          </View>
+        )}
+
+        {status === 'success' && (
+          <>
+            <View layout="row" gap="m">
+              <SummaryCard label={t('analytics.home.totalPageViews')} value={`${totalViews}`} />
+              <SummaryCard label={t('analytics.home.trackedPages')} value={`${topPaths.length}`} />
+              <SummaryCard label={t('analytics.home.daysWithTraffic')} value={`${dailyViews.length}`} />
+            </View>
+
+            <View layout="row" gap="m" style={{ alignItems: 'flex-start' }}>
+              <View
+                surface="primary"
+                roundness="m"
+                inset="m"
+                gap="s"
+                style={{ border: '1px solid var(--separator)', flex: 1 }}
+              >
+                <Text variant="heading-secondary" as="h2" text="analytics.home.topPaths" />
+                {topPaths.length === 0 && <Text variant="small" text="analytics.home.noPageViews" />}
+                {topPaths.map((item) => (
+                  <View key={item.path || 'unknown'} layout="row" justifyContent="space-between">
+                    <Text variant="small">{item.path || t('analytics.home.unknownPath')}</Text>
+                    <Text variant="small">{item.views}</Text>
+                  </View>
+                ))}
+              </View>
+
+              <View
+                surface="primary"
+                roundness="m"
+                inset="m"
+                gap="s"
+                style={{ border: '1px solid var(--separator)', flex: 1 }}
+              >
+                <Text variant="heading-secondary" as="h2" text="analytics.home.dailyPageViews" />
+                {dailyViews.length === 0 && <Text variant="small" text="analytics.home.noDailyData" />}
+                {dailyViews.map((item) => (
+                  <View key={item.date} layout="row" justifyContent="space-between">
+                    <Text variant="small">{item.date}</Text>
+                    <Text variant="small">{item.views}</Text>
+                  </View>
+                ))}
+              </View>
+            </View>
+          </>
+        )}
+      </View>
+    </Page>
+  )
+}

package/src/AnalyticsSalesPage.jsx

@@ -0,0 +1,55 @@
+import React, { useState, useCallback } from 'react'
+import { GetWorkspace, EnableService } from '@ossy/workspaces'
+import { useSdk, cacheKey } from '@ossy/sdk-react'
+import { Text, View, Button, Page, useLocale } from '@ossy/design-system'
+import SalesSection from './SalesSection.jsx'
+import { useAnalyticsHomeContent } from './analytics-home-content.js'
+
+const ANALYTICS_SERVICE = '@ossy/analytics'
+
+/**
+ * Public sales surface. Anonymous → sign up; signed-in but not entitled → enable.
+ * Does not load workspace KPI / page-view actions.
+ */
+export default function AnalyticsSalesPage ({ isAuthenticated }) {
+  const { t } = useLocale()
+  const { invoke, invalidate } = useSdk()
+  const [error, setError] = useState(null)
+  const { cover: baseCover, features } = useAnalyticsHomeContent()
+
+  const handleEnable = useCallback(() => {
+    setError(null)
+    invoke(EnableService, { service: ANALYTICS_SERVICE })
+      .then(() => invalidate(cacheKey(GetWorkspace)))
+      .catch(() => setError(t('analytics.sales.enableError')))
+  }, [invoke, invalidate, t])
+
+  const enableAction = {
+    ...EnableService,
+    'data-service': ANALYTICS_SERVICE,
+    variant: 'cta',
+    label: 'analytics.sales.enable',
+    onClick: handleEnable,
+  }
+
+  const cover = isAuthenticated
+    ? { ...baseCover, actions: [] }
+    : baseCover
+
+  return (
+    <View data-analytics-status="off">
+      <SalesSection cover={cover} features={features} />
+
+      {isAuthenticated && (
+        <Page maxWidth="xl" gap="l">
+          <View gap="m" inset="l">
+            <Text variant="heading-secondary" as="h2" text="analytics.sales.enable" />
+            <Text style={{ maxWidth: '600px' }} text="analytics.sales.enableDescription" />
+            <Button {...enableAction} variant="cta" />
+            {error && <Text variant="small">{error}</Text>}
+          </View>
+        </Page>
+      )}
+    </View>
+  )
+}

package/src/Definition.js

@@ -1,7 +1,7 @@
 export const Definition = {
   id: 'analytics',
   title: 'Analytics',
-  description: 'Workspace analytics for website traffic and top performing pages.',
+  description: 'Workspace insight KPIs for members, resources, and traffic.',
   icon: 'chart',
   status: ['beta'],
 }

package/src/HeroCover.jsx

@@ -0,0 +1,93 @@
+import React from 'react'
+import { Button, View, PageSection, Text } from '@ossy/design-system'
+
+const Cover = ({
+  title,
+  titleMaxWidth = '1100px',
+  text,
+  actions = [],
+}) => (
+  <View
+    gap="l"
+    placeContent="center"
+    layout="column"
+    justifyContent="center"
+    style={{
+      height: '100%',
+      borderRadius: 'var(--space-m)',
+      padding: 'var(--space-xl) var(--space-s)',
+    }}
+  >
+    <View gap="m" alignItems="center">
+      <Text as="h1" variant="display" style={{ maxWidth: titleMaxWidth, textWrap: 'balance' }}>
+        {title}
+      </Text>
+      <Text as="h2" variant="heading-tertiary" style={{ maxWidth: '800px' }}>
+        {text}
+      </Text>
+    </View>
+    <View gap="m" layout="row" justifyContent="center" style={{ flexWrap: 'wrap' }}>
+      {actions.map(({ label, ...props }) => (
+        <Button {...props} key={label}>
+          {label}
+        </Button>
+      ))}
+    </View>
+  </View>
+)
+
+export function HeroCover ({
+  title,
+  titleMaxWidth = '1100px',
+  text,
+  actions = [],
+  id = 'analytics-hero-cover',
+  surfaceAs = 'div',
+  maxWidth = 'l',
+  surface = 'hero',
+  ...props
+}) {
+  const { style: passthroughStyle, ...pageSectionProps } = props
+
+  return (
+    <PageSection
+      id={id}
+      surfaceAs={surfaceAs}
+      maxWidth={maxWidth}
+      surface={surface}
+      {...pageSectionProps}
+      data-rounded
+      data-component="@ossy/analytics/cover"
+      style={{
+        backgroundAttachment: 'scroll',
+        boxShadow: 'inset 0 1px 0 color-mix(in srgb, var(--foreground) 6%, transparent)',
+        ...passthroughStyle,
+      }}
+    >
+      <style href="@ossy/analytics/cover" precedence="high">
+        {`
+          [data-component="@ossy/analytics/cover"] {
+            gap: var(--space-m);
+            min-height: min(42vh, 420px);
+            height: auto;
+          }
+          [data-rounded] {
+            border-radius: var(--space-m);
+            overflow: hidden;
+          }
+          @media (min-width: 900px) {
+            [data-component="@ossy/analytics/cover"] {
+              min-height: min(46vh, 520px);
+            }
+          }
+        `}
+      </style>
+      <Cover
+        title={title}
+        titleMaxWidth={titleMaxWidth}
+        text={text}
+        actions={actions}
+      />
+    </PageSection>
+  )
+}

package/src/SalesSection.jsx

@@ -0,0 +1,69 @@
+import React from 'react'
+import { Text, View, Icon, PageSection, useLocale } from '@ossy/design-system'
+import { HeroCover } from './HeroCover.jsx'
+
+export default function SalesSection ({ cover, features }) {
+  const { t } = useLocale()
+
+  return (
+    <PageSection maxWidth="xl" gap="l">
+      <View
+        gap="l"
+        surface="primary"
+        style={{ padding: 'var(--space-m) var(--space-l)', height: '100%', overflowY: 'auto' }}
+      >
+        <HeroCover {...cover} />
+
+        <View gap="m" inset="s">
+          <Text variant="heading-secondary" as="h2">
+            {t('analytics.sales.overview')}
+          </Text>
+          <View gap="m" layout="row-wrap">
+            {features.map((x) => (
+              <View
+                key={x.title}
+                roundness="m"
+                surface="primary"
+                inset="m"
+                gap="m"
+                style={{
+                  width: 200,
+                  border: '1px solid var(--separator)',
+                }}
+              >
+                <View justifyContent="center" alignItems="center">
+                  <Icon name={x.icon} size="m" />
+                </View>
+                <Text variant="small" style={{ fontWeight: 'bold', textAlign: 'center' }}>{x.title}</Text>
+                <Text variant="small" style={{ textAlign: 'center' }}>{x.text}</Text>
+              </View>
+            ))}
+          </View>
+        </View>
+
+        <View gap="m" inset="s">
+          <Text variant="heading-secondary" as="h2">
+            {t('analytics.sales.features')}
+          </Text>
+          {features.map((x) => (
+            <View
+              key={x.title}
+              roundness="m"
+              gap="m"
+              inset="l"
+              style={{ border: '1px solid var(--separator)' }}
+            >
+              <View layout="row" gap="s" alignItems="center">
+                <View justifyContent="center" alignItems="center">
+                  <Icon name={x.icon} size="m" />
+                </View>
+                <Text variant="heading-tertiary" as="h3">{x.title}</Text>
+              </View>
+              <Text>{x.text}</Text>
+            </View>
+          ))}
+        </View>
+      </View>
+    </PageSection>
+  )
+}

package/src/analytics-home-content.js

@@ -0,0 +1,51 @@
+import { useLocale } from '@ossy/design-system'
+import { useRouter } from '@ossy/router-react'
+import { OpenSignUp } from '@ossy/authentication'
+
+const ANALYTICS_SERVICE = '@ossy/analytics'
+
+export function useAnalyticsHomeContent () {
+  const { t } = useLocale()
+  const router = useRouter()
+
+  const analyticsHome = router.getHref('analytics/home') || '/analytics'
+  const signUpHref = (() => {
+    const base = router.getHref('sign-up') || router.getHref('@sign-up') || '/sign-up'
+    const url = new URL(base, 'http://local.invalid')
+    url.searchParams.set('redirect', analyticsHome)
+    return `${url.pathname}${url.search}`
+  })()
+
+  const cover = {
+    title: t('analytics.home.cover.title'),
+    text: t('analytics.home.cover.text'),
+    actions: [
+      {
+        ...OpenSignUp,
+        variant: 'cta',
+        href: signUpHref,
+        label: t('analytics.home.cover.ctaPrimary'),
+      },
+    ],
+  }
+
+  const features = [
+    {
+      title: t('analytics.home.features.members.title'),
+      icon: 'user',
+      text: t('analytics.home.features.members.text'),
+    },
+    {
+      title: t('analytics.home.features.resources.title'),
+      icon: 'folder',
+      text: t('analytics.home.features.resources.text'),
+    },
+    {
+      title: t('analytics.home.features.traffic.title'),
+      icon: 'chart',
+      text: t('analytics.home.features.traffic.text'),
+    },
+  ]
+
+  return { cover, features, ANALYTICS_SERVICE }
+}

package/src/analytics.page.jsx

@@ -1,8 +1,10 @@
-import React, { useMemo } from 'react'
-import { Text, View, Page, useLocale } from '@ossy/design-system'
-import { usePageViewStats } from './usePageViewStats.js'
-import { useSdk } from '@ossy/sdk-react'
+import React from 'react'
+import { useApp } from '@ossy/app/shell'
 import { GetWorkspace } from '@ossy/workspaces'
+import { isServiceEntitled } from '@ossy/workspaces/entitlements'
+import { useSdk } from '@ossy/sdk-react'
+import AnalyticsSalesPage from './AnalyticsSalesPage.jsx'
+import AnalyticsProductHome from './AnalyticsProductHome.jsx'
 
 export const metadata = {
   id: 'analytics/home',
@@ -12,100 +14,20 @@ export const metadata = {
   },
 }
 
-function SummaryCard({ label, value }) {
-  return (
-    <View
-      surface="primary"
-      roundness="m"
-      inset="m"
-      style={{ border: '1px solid var(--separator)' }}
-    >
-      <Text variant="small" style={{ opacity: 0.75 }}>{label}</Text>
-      <Text variant="heading-secondary" as="h2">{value}</Text>
-    </View>
-  )
-}
-
-export default function AnalyticsPage() {
-  const { t } = useLocale()
+/**
+ * Analytics home — product KPIs only when signed in and entitled.
+ * Otherwise show the sales page (no KPI / page-view loads).
+ */
+export default function AnalyticsPage () {
+  const app = useApp()
   const sdk = useSdk()
-  const { data: workspace } = sdk.read(GetWorkspace)
-  const { from, to } = useMemo(() => {
-    const now = Date.now()
-    return { from: now - 30 * 24 * 60 * 60 * 1000, to: now }
-  }, [])
-
-  const { status, totalViews, dailyViews, topPaths } = usePageViewStats({
-    workspaceId: workspace?.id,
-    from,
-    to,
-    limit: 10,
-  })
-
-  return (
-    <Page
-      title="analytics.home.title"
-      description="analytics.home.description"
-    >
-      <View gap="m">
-      {status === 'loading' && (
-        <View surface="primary" roundness="m" inset="m">
-          <Text>{t('analytics.home.loading')}</Text>
-        </View>
-      )}
-
-      {status === 'error' && (
-        <View surface="primary" roundness="m" inset="m">
-          <Text>{t('analytics.home.error')}</Text>
-        </View>
-      )}
-
-      {status === 'success' && (
-        <>
-          <View layout="row" gap="m">
-            <SummaryCard label={t('analytics.home.totalPageViews')} value={`${totalViews}`} />
-            <SummaryCard label={t('analytics.home.trackedPages')} value={`${topPaths.length}`} />
-            <SummaryCard label={t('analytics.home.daysWithTraffic')} value={`${dailyViews.length}`} />
-          </View>
+  const isAuthenticated = !!app?.isAuthenticated
+  const { data: workspace } = sdk.read(GetWorkspace, undefined, { enabled: isAuthenticated })
+  const entitled = isServiceEntitled(workspace?.services, '@ossy/analytics')
 
-          <View layout="row" gap="m" style={{ alignItems: 'flex-start' }}>
-            <View
-              surface="primary"
-              roundness="m"
-              inset="m"
-              gap="s"
-              style={{ border: '1px solid var(--separator)', flex: 1 }}
-            >
-              <Text variant="heading-secondary" as="h2" text="analytics.home.topPaths" />
-              {topPaths.length === 0 && <Text variant="small" text="analytics.home.noPageViews" />}
-              {topPaths.map((item) => (
-                <View key={item.path || 'unknown'} layout="row" justifyContent="space-between">
-                  <Text variant="small">{item.path || t('analytics.home.unknownPath')}</Text>
-                  <Text variant="small">{item.views}</Text>
-                </View>
-              ))}
-            </View>
+  if (isAuthenticated && entitled) {
+    return <AnalyticsProductHome />
+  }
 
-            <View
-              surface="primary"
-              roundness="m"
-              inset="m"
-              gap="s"
-              style={{ border: '1px solid var(--separator)', flex: 1 }}
-            >
-              <Text variant="heading-secondary" as="h2" text="analytics.home.dailyPageViews" />
-              {dailyViews.length === 0 && <Text variant="small" text="analytics.home.noDailyData" />}
-              {dailyViews.map((item) => (
-                <View key={item.date} layout="row" justifyContent="space-between">
-                  <Text variant="small">{item.date}</Text>
-                  <Text variant="small">{item.views}</Text>
-                </View>
-              ))}
-            </View>
-          </View>
-        </>
-      )}
-      </View>
-    </Page>
-  )
+  return <AnalyticsSalesPage isAuthenticated={isAuthenticated} />
 }

package/src/en.translations.json

@@ -1,9 +1,12 @@
 {
   "analytics/home.documentTitle": "Analytics",
   "analytics.home.title": "Analytics",
-  "analytics.home.description": "Workspace analytics for website traffic and top performing pages.",
+  "analytics.home.description": "Workspace insight KPIs for members, resources, and traffic.",
   "analytics.home.loading": "Loading analytics...",
   "analytics.home.error": "Could not load analytics data.",
+  "analytics.home.members": "Members",
+  "analytics.home.resources": "Resources",
+  "analytics.home.workspaceKpisError": "Could not load workspace KPIs.",
   "analytics.home.totalPageViews": "Total page views (30 days)",
   "analytics.home.trackedPages": "Tracked pages (30 days)",
   "analytics.home.daysWithTraffic": "Days with traffic",
@@ -11,5 +14,19 @@
   "analytics.home.noPageViews": "No page views yet.",
   "analytics.home.unknownPath": "(unknown path)",
   "analytics.home.dailyPageViews": "Daily page views",
-  "analytics.home.noDailyData": "No daily data yet."
+  "analytics.home.noDailyData": "No daily data yet.",
+  "analytics.home.cover.title": "See how your workspace is used",
+  "analytics.home.cover.text": "Members, resources, and page traffic — insight KPIs for the teams building on the platform.",
+  "analytics.home.cover.ctaPrimary": "Get started free",
+  "analytics.home.features.members.title": "Members",
+  "analytics.home.features.members.text": "Track how many people are in the workspace.",
+  "analytics.home.features.resources.title": "Resources",
+  "analytics.home.features.resources.text": "See how much content and data you store.",
+  "analytics.home.features.traffic.title": "Traffic",
+  "analytics.home.features.traffic.text": "Page views over the last 30 days, by path and by day.",
+  "analytics.sales.overview": "Overview",
+  "analytics.sales.features": "Features",
+  "analytics.sales.enable": "Enable analytics",
+  "analytics.sales.enableDescription": "Activate analytics for your workspace to view member, resource, and traffic KPIs.",
+  "analytics.sales.enableError": "Could not enable analytics. Try again or contact support."
 }

package/src/get-workspace-kpis.action.js

@@ -0,0 +1,4 @@
+export const metadata = {
+  id: '@ossy/analytics/actions/get-workspace-kpis',
+  access: 'workspace',
+}

package/src/get-workspace-kpis.task.js

@@ -0,0 +1,27 @@
+import { Aggregate } from '@ossy/event-store'
+import { Workspace } from '@ossy/workspaces/server'
+
+export const metadata = { id: '@ossy/analytics/tasks/get-workspace-kpis' }
+
+const RESOURCE_SCHEMA_TYPE = { $regex: /^@[^/]+\/[^/]+\/schema\// }
+
+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 members = Array.isArray(workspace.users) ? workspace.users.length : 0
+
+  const resources = await Aggregate.Collection.countDocuments({
+    type: RESOURCE_SCHEMA_TYPE,
+    'state.belongsTo': workspace.id,
+    'state.status': { $ne: 'removed' },
+  })
+
+  return {
+    scope: 'workspace',
+    workspaceId: workspace.id,
+    members,
+    resources,
+  }
+}

package/src/get-workspace-kpis.task.spec.js

@@ -0,0 +1,61 @@
+import { beforeEach, describe, expect, it, jest } from '@jest/globals'
+
+const countDocuments = jest.fn()
+const ofMock = jest.fn()
+const viewMock = jest.fn()
+
+jest.unstable_mockModule('@ossy/event-store', () => ({
+  Aggregate: {
+    Of: ofMock,
+    View: viewMock,
+    Collection: { countDocuments },
+  },
+}))
+
+jest.unstable_mockModule('@ossy/workspaces/server', () => ({
+  Workspace: { name: 'Workspace' },
+}))
+
+const { run } = await import('./get-workspace-kpis.task.js')
+
+describe('get-workspace-kpis task', () => {
+  beforeEach(() => {
+    countDocuments.mockReset()
+    ofMock.mockReset()
+    viewMock.mockReset()
+  })
+
+  it('requires workspaceId', async () => {
+    await expect(run({ payload: {}, req: {} })).rejects.toMatchObject({
+      message: 'workspaceId is required',
+      status: 400,
+    })
+  })
+
+  it('returns member and resource counts for the workspace', async () => {
+    ofMock.mockReturnValue(Promise.resolve({ id: 'ws-1' }))
+    viewMock.mockReturnValue(() => ({ id: 'ws-1', users: ['u1', 'u2', 'u3'] }))
+    countDocuments.mockResolvedValue(7)
+
+    // Aggregate.Of(...).then(Aggregate.View()) — View() returns a function applied by then
+    ofMock.mockImplementation(() => ({
+      then(fn) {
+        return Promise.resolve(fn({ id: 'ws-1', users: ['u1', 'u2', 'u3'] }))
+      },
+    }))
+    viewMock.mockReturnValue((saved) => saved)
+
+    const result = await run({ payload: { workspaceId: 'ws-1' }, req: {} })
+
+    expect(result).toEqual({
+      scope: 'workspace',
+      workspaceId: 'ws-1',
+      members: 3,
+      resources: 7,
+    })
+    expect(countDocuments).toHaveBeenCalledWith(expect.objectContaining({
+      'state.belongsTo': 'ws-1',
+      'state.status': { $ne: 'removed' },
+    }))
+  })
+})

package/src/index.js

@@ -1 +1,2 @@
 export { Definition } from './Definition.js'
+export { metadata as GetWorkspaceKpis } from './get-workspace-kpis.action.js'

package/src/sv.translations.json

@@ -1,9 +1,12 @@
 {
   "analytics/home.documentTitle": "Analys",
   "analytics.home.title": "Analys",
-  "analytics.home.description": "Workspace-analys för webbtrafik och mest besökta sidor.",
+  "analytics.home.description": "Workspace-KPIer för medlemmar, resurser och trafik.",
   "analytics.home.loading": "Laddar analys...",
   "analytics.home.error": "Kunde inte ladda analysdata.",
+  "analytics.home.members": "Medlemmar",
+  "analytics.home.resources": "Resurser",
+  "analytics.home.workspaceKpisError": "Kunde inte ladda workspace-KPIer.",
   "analytics.home.totalPageViews": "Totala sidvisningar (30 dagar)",
   "analytics.home.trackedPages": "Spårade sidor (30 dagar)",
   "analytics.home.daysWithTraffic": "Dagar med trafik",
@@ -11,5 +14,19 @@
   "analytics.home.noPageViews": "Inga sidvisningar ännu.",
   "analytics.home.unknownPath": "(okänd sökväg)",
   "analytics.home.dailyPageViews": "Dagliga sidvisningar",
-  "analytics.home.noDailyData": "Ingen daglig data ännu."
+  "analytics.home.noDailyData": "Ingen daglig data ännu.",
+  "analytics.home.cover.title": "Se hur workspace används",
+  "analytics.home.cover.text": "Medlemmar, resurser och sidtrafik — KPIer för team som bygger på plattformen.",
+  "analytics.home.cover.ctaPrimary": "Kom igång gratis",
+  "analytics.home.features.members.title": "Medlemmar",
+  "analytics.home.features.members.text": "Se hur många personer som finns i workspace.",
+  "analytics.home.features.resources.title": "Resurser",
+  "analytics.home.features.resources.text": "Följ hur mycket innehåll och data ni lagrar.",
+  "analytics.home.features.traffic.title": "Trafik",
+  "analytics.home.features.traffic.text": "Sidvisningar de senaste 30 dagarna, per sökväg och dag.",
+  "analytics.sales.overview": "Översikt",
+  "analytics.sales.features": "Funktioner",
+  "analytics.sales.enable": "Aktivera analys",
+  "analytics.sales.enableDescription": "Aktivera analys för workspace för att se KPIer för medlemmar, resurser och trafik.",
+  "analytics.sales.enableError": "Kunde inte aktivera analys. Försök igen eller kontakta support."
 }

package/src/useWorkspaceKpis.js

@@ -0,0 +1,34 @@
+import { useEffect, useState } from 'react'
+import { useSdk } from '@ossy/sdk-react'
+import { metadata as GetWorkspaceKpis } from './get-workspace-kpis.action.js'
+
+export function useWorkspaceKpis({ workspaceId }) {
+  const sdk = useSdk()
+  const [status, setStatus] = useState('idle')
+  const [data, setData] = useState({
+    members: 0,
+    resources: 0,
+  })
+
+  useEffect(() => {
+    if (!workspaceId) return
+
+    setStatus('loading')
+    sdk.invoke(GetWorkspaceKpis, {})
+      .then((json) => {
+        setData({
+          members: json?.members || 0,
+          resources: json?.resources || 0,
+        })
+        setStatus('success')
+      })
+      .catch(() => {
+        setStatus('error')
+      })
+  }, [sdk, workspaceId])
+
+  return {
+    status,
+    ...data,
+  }
+}