@commonpub/layer 0.3.36 → 0.3.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commonpub/layer",
-  "version": "0.3.36",
+  "version": "0.3.37",
   "type": "module",
   "main": "./nuxt.config.ts",
   "files": [
@@ -15,7 +15,12 @@
     "plugins",
     "server",
     "theme",
-    "types"
+    "types",
+    "!**/__tests__/",
+    "!**/*.test.ts",
+    "!**/*.spec.ts",
+    "!vitest.config.ts",
+    "!test-setup.ts"
   ],
   "publishConfig": {
     "access": "public"
@@ -44,11 +49,11 @@
     "vue": "^3.4.0",
     "vue-router": "^4.3.0",
     "zod": "^4.3.6",
-    "@commonpub/config": "0.7.1",
     "@commonpub/auth": "0.5.0",
+    "@commonpub/config": "0.7.1",
     "@commonpub/editor": "0.5.0",
-    "@commonpub/docs": "0.5.2",
     "@commonpub/learning": "0.5.0",
+    "@commonpub/docs": "0.5.2",
     "@commonpub/protocol": "0.9.5",
     "@commonpub/schema": "0.8.13",
     "@commonpub/server": "2.20.1",

package/pages/search.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import type { Serialized, ContentListItem, PaginatedResponse } from '@commonpub/server';
+import type { PaginatedResponse } from '@commonpub/server';
 
 useSeoMeta({
   title: `Search — ${useSiteName()}`,
@@ -67,7 +67,8 @@ const searchQuery = computed(() => ({
   community: communityFilter.value || undefined,
 }));
 
-const { data: results, status } = await useFetch<PaginatedResponse<Serialized<ContentListItem>>>('/api/search', {
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const { data: results, status } = await useFetch<PaginatedResponse<any>>('/api/search', {
   query: searchQuery,
   watch: [searchQuery],
   lazy: true,

package/server/api/search/index.get.ts

@@ -1,5 +1,5 @@
 import { searchContent, listHubs, escapeLike } from '@commonpub/server';
-import type { ContentSearchOptions } from '@commonpub/server';
+import type { ContentSearchOptions, MeiliClient } from '@commonpub/server';
 import { users, follows, hubs } from '@commonpub/schema';
 import { sql, desc, ilike, or, and, isNull, eq } from 'drizzle-orm';
 import { z } from 'zod';
@@ -45,7 +45,7 @@ export default defineEventHandler(async (event): Promise<{ items: unknown[]; tot
         bannerUrl: hub.bannerUrl,
         memberCount: hub.memberCount,
         postCount: hub.postCount,
-        source: (hub as Record<string, unknown>).source ?? 'local',
+        source: (hub as unknown as Record<string, unknown>).source ?? 'local',
       })),
       total: result.total,
     };
@@ -108,7 +108,7 @@ export default defineEventHandler(async (event): Promise<{ items: unknown[]; tot
     const meiliKey = process.env.MEILI_MASTER_KEY;
     if (meiliUrl) {
       const { MeiliSearch } = await import('meilisearch');
-      meiliClient = new MeiliSearch({ host: meiliUrl, apiKey: meiliKey });
+      meiliClient = new MeiliSearch({ host: meiliUrl, apiKey: meiliKey }) as unknown as MeiliClient;
     }
   } catch { /* Meilisearch not available */ }
 

package/types/meilisearch.d.ts

@@ -0,0 +1,5 @@
+declare module 'meilisearch' {
+  export class MeiliSearch {
+    constructor(options: { host: string; apiKey?: string });
+  }
+}

package/components/__tests__/FederatedContentCard.test.ts

@@ -1,340 +0,0 @@
-/**
- * Component tests for FederatedContentCard.
- *
- * Tests rendering of federated content from CommonPub and non-CommonPub sources,
- * computed properties (typeLabel, actorHandle, timeAgo), event emission, and
- * conditional rendering (avatar, cover image, tags, title link).
- */
-import { describe, it, expect } from 'vitest';
-import { render, screen, fireEvent } from '@testing-library/vue';
-import { defineComponent, h } from 'vue';
-import FederatedContentCard from '../FederatedContentCard.vue';
-
-// Stub NuxtLink as a plain <a> tag
-const NuxtLink = defineComponent({
-  name: 'NuxtLink',
-  props: { to: String },
-  setup(props, { slots }) {
-    return () => h('a', { href: props.to }, slots.default?.());
-  },
-});
-
-const stubs = { NuxtLink };
-
-function makeContent(overrides: Record<string, unknown> = {}) {
-  return {
-    id: 'fed-1',
-    objectUri: 'https://remote.example.com/content/test',
-    apType: 'Article',
-    title: 'LED Cube Build',
-    content: '<p>Build a 4x4x4 LED cube</p>',
-    summary: '<p>A <strong>complete</strong> LED cube tutorial</p>',
-    url: 'https://remote.example.com/project/led-cube',
-    coverImageUrl: null,
-    tags: [],
-    attachments: [],
-    inReplyTo: null,
-    cpubType: 'project',
-    cpubMetadata: null,
-    cpubBlocks: null,
-    localLikeCount: 5,
-    localCommentCount: 2,
-    localViewCount: 100,
-    publishedAt: new Date(Date.now() - 3600000).toISOString(), // 1 hour ago
-    receivedAt: new Date().toISOString(),
-    originDomain: 'remote.example.com',
-    actor: {
-      actorUri: 'https://remote.example.com/users/alice',
-      preferredUsername: 'alice',
-      displayName: 'Alice Builder',
-      avatarUrl: 'https://remote.example.com/avatars/alice.png',
-      instanceDomain: 'remote.example.com',
-    },
-    ...overrides,
-  };
-}
-
-describe('FederatedContentCard', () => {
-  // --- Basic rendering ---
-
-  it('renders title', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent() },
-      global: { stubs },
-    });
-    expect(screen.getByText('LED Cube Build')).toBeInTheDocument();
-  });
-
-  it('renders actor name and handle', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent() },
-      global: { stubs },
-    });
-    expect(screen.getByText('Alice Builder')).toBeInTheDocument();
-    expect(screen.getByText('@alice@remote.example.com')).toBeInTheDocument();
-  });
-
-  it('renders origin domain badge', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent() },
-      global: { stubs },
-    });
-    expect(screen.getByText('remote.example.com')).toBeInTheDocument();
-  });
-
-  it('strips HTML from summary', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent() },
-      global: { stubs },
-    });
-    const summary = screen.getByText('A complete LED cube tutorial');
-    expect(summary).toBeInTheDocument();
-    // Should NOT contain HTML tags
-    expect(summary.innerHTML).not.toContain('<strong>');
-    expect(summary.innerHTML).not.toContain('<p>');
-  });
-
-  // --- Type label computed ---
-
-  it('shows cpubType as type badge when present', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent({ cpubType: 'project' }) },
-      global: { stubs },
-    });
-    expect(screen.getByText('project')).toBeInTheDocument();
-  });
-
-  it('shows "article" for AP Article without cpubType', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent({ cpubType: null, apType: 'Article' }) },
-      global: { stubs },
-    });
-    expect(screen.getByText('article')).toBeInTheDocument();
-  });
-
-  it('shows "post" for AP Note without cpubType', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent({ cpubType: null, apType: 'Note' }) },
-      global: { stubs },
-    });
-    expect(screen.getByText('post')).toBeInTheDocument();
-  });
-
-  // --- Avatar rendering ---
-
-  it('renders avatar image when actor has avatarUrl', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent() },
-      global: { stubs },
-    });
-    const img = screen.getByAltText('Alice Builder avatar');
-    expect(img).toBeInTheDocument();
-    expect(img).toHaveAttribute('src', 'https://remote.example.com/avatars/alice.png');
-  });
-
-  it('renders placeholder when actor has no avatarUrl', () => {
-    const { container } = render(FederatedContentCard, {
-      props: {
-        content: makeContent({
-          actor: {
-            actorUri: 'https://remote.example.com/users/bob',
-            preferredUsername: 'bob',
-            displayName: 'Bob',
-            avatarUrl: null,
-            instanceDomain: 'remote.example.com',
-          },
-        }),
-      },
-      global: { stubs },
-    });
-    const placeholder = container.querySelector('.cpub-fed-card__avatar--placeholder');
-    expect(placeholder).toBeInTheDocument();
-    expect(placeholder?.textContent).toBe('B');
-  });
-
-  // --- Cover image ---
-
-  it('renders cover image through proxy when coverImageUrl present', () => {
-    const { container } = render(FederatedContentCard, {
-      props: {
-        content: makeContent({
-          coverImageUrl: 'https://remote.example.com/img/cover.jpg',
-        }),
-      },
-      global: { stubs },
-    });
-    const cover = container.querySelector('.cpub-fed-card__cover img');
-    expect(cover).toBeInTheDocument();
-    expect(cover?.getAttribute('src')).toContain('/api/image-proxy');
-    expect(cover?.getAttribute('src')).toContain(encodeURIComponent('https://remote.example.com/img/cover.jpg'));
-  });
-
-  it('does not render cover image when coverImageUrl is null', () => {
-    const { container } = render(FederatedContentCard, {
-      props: { content: makeContent({ coverImageUrl: null }) },
-      global: { stubs },
-    });
-    expect(container.querySelector('.cpub-fed-card__cover')).not.toBeInTheDocument();
-  });
-
-  // --- Tags ---
-
-  it('renders tags when present', () => {
-    render(FederatedContentCard, {
-      props: {
-        content: makeContent({
-          tags: [
-            { type: 'Hashtag', name: '#electronics' },
-            { type: 'Hashtag', name: '#led' },
-          ],
-        }),
-      },
-      global: { stubs },
-    });
-    expect(screen.getByText('#electronics')).toBeInTheDocument();
-    expect(screen.getByText('#led')).toBeInTheDocument();
-  });
-
-  it('limits tags to 5', () => {
-    const tags = Array.from({ length: 8 }, (_, i) => ({
-      type: 'Hashtag',
-      name: `#tag${i}`,
-    }));
-    const { container } = render(FederatedContentCard, {
-      props: { content: makeContent({ tags }) },
-      global: { stubs },
-    });
-    const tagElements = container.querySelectorAll('.cpub-fed-card__tag');
-    expect(tagElements.length).toBe(5);
-  });
-
-  it('hides tags section when empty', () => {
-    const { container } = render(FederatedContentCard, {
-      props: { content: makeContent({ tags: [] }) },
-      global: { stubs },
-    });
-    expect(container.querySelector('.cpub-fed-card__tags')).not.toBeInTheDocument();
-  });
-
-  // --- Like count ---
-
-  it('shows like count when > 0', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent({ localLikeCount: 5 }) },
-      global: { stubs },
-    });
-    expect(screen.getByLabelText('Like this project')).toHaveTextContent('5 Like');
-  });
-
-  it('hides like count when 0', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent({ localLikeCount: 0 }) },
-      global: { stubs },
-    });
-    expect(screen.getByLabelText('Like this project')).toHaveTextContent('Like');
-    expect(screen.getByLabelText('Like this project').textContent?.trim()).toBe('Like');
-  });
-
-  // --- Events ---
-
-  it('emits like event with content id', async () => {
-    const { emitted } = render(FederatedContentCard, {
-      props: { content: makeContent() },
-      global: { stubs },
-    });
-    await fireEvent.click(screen.getByLabelText('Like this project'));
-    expect(emitted().like).toBeTruthy();
-    expect(emitted().like[0]).toEqual(['fed-1']);
-  });
-
-  it('emits boost event with content id', async () => {
-    const { emitted } = render(FederatedContentCard, {
-      props: { content: makeContent() },
-      global: { stubs },
-    });
-    await fireEvent.click(screen.getByLabelText('Boost this project'));
-    expect(emitted().boost).toBeTruthy();
-    expect(emitted().boost[0]).toEqual(['fed-1']);
-  });
-
-  // --- Title link ---
-
-  it('renders title as link when url is present', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent() },
-      global: { stubs },
-    });
-    const link = screen.getByText('LED Cube Build').closest('a');
-    expect(link).toHaveAttribute('href', 'https://remote.example.com/project/led-cube');
-    expect(link).toHaveAttribute('target', '_blank');
-  });
-
-  it('renders title as plain text when url is null', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent({ url: null }) },
-      global: { stubs },
-    });
-    const title = screen.getByText('LED Cube Build');
-    expect(title.tagName).toBe('SPAN');
-  });
-
-  // --- View Original link ---
-
-  it('shows View Original link when url present', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent() },
-      global: { stubs },
-    });
-    const link = screen.getByText('View Original');
-    expect(link).toHaveAttribute('href', 'https://remote.example.com/project/led-cube');
-    expect(link).toHaveAttribute('rel', 'noopener');
-  });
-
-  it('hides View Original when no url', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent({ url: null }) },
-      global: { stubs },
-    });
-    expect(screen.queryByText('View Original')).not.toBeInTheDocument();
-  });
-
-  // --- Time ago ---
-
-  it('shows relative time for recent content', () => {
-    const { container } = render(FederatedContentCard, {
-      props: {
-        content: makeContent({
-          publishedAt: new Date(Date.now() - 30 * 60000).toISOString(),
-        }),
-      },
-      global: { stubs },
-    });
-    const time = container.querySelector('.cpub-fed-card__time');
-    expect(time?.textContent).toBe('30m');
-  });
-
-  it('shows hours for content from today', () => {
-    const { container } = render(FederatedContentCard, {
-      props: {
-        content: makeContent({
-          publishedAt: new Date(Date.now() - 5 * 3600000).toISOString(),
-        }),
-      },
-      global: { stubs },
-    });
-    const time = container.querySelector('.cpub-fed-card__time');
-    expect(time?.textContent).toBe('5h');
-  });
-
-  // --- Fallback values ---
-
-  it('shows Unknown when actor is null', () => {
-    render(FederatedContentCard, {
-      props: { content: makeContent({ actor: null }) },
-      global: { stubs },
-    });
-    // Both actorName and actorHandle render "Unknown" fallback
-    const unknowns = screen.getAllByText('Unknown');
-    expect(unknowns.length).toBeGreaterThanOrEqual(1);
-  });
-});

package/composables/__tests__/useMirrorContent.test.ts

@@ -1,208 +0,0 @@
-/**
- * Unit tests for useMirrorContent composable.
- *
- * Tests the contentType resolution logic which determines how federated
- * content is displayed — critical for distinguishing CommonPub vs non-CommonPub
- * content types.
- */
-import { describe, it, expect } from 'vitest';
-import { ref, nextTick } from 'vue';
-import { useMirrorContent } from '../useMirrorContent';
-
-function makeFedContent(overrides: Record<string, unknown> = {}) {
-  return {
-    id: 'fed-1',
-    objectUri: 'https://remote.example.com/content/test',
-    apType: 'Article',
-    cpubType: null,
-    title: 'Test Content',
-    content: '<p>Hello world</p>',
-    summary: 'A test',
-    url: 'https://remote.example.com/article/test',
-    coverImageUrl: null,
-    tags: [],
-    attachments: [],
-    cpubMetadata: null,
-    cpubBlocks: null,
-    localLikeCount: 0,
-    localCommentCount: 0,
-    localViewCount: 0,
-    publishedAt: '2026-03-20T10:00:00Z',
-    receivedAt: '2026-03-20T11:00:00Z',
-    originDomain: 'remote.example.com',
-    actor: {
-      actorUri: 'https://remote.example.com/users/alice',
-      preferredUsername: 'alice',
-      displayName: 'Alice',
-      avatarUrl: null,
-      instanceDomain: 'remote.example.com',
-    },
-    ...overrides,
-  };
-}
-
-describe('useMirrorContent', () => {
-  // --- contentType resolution ---
-
-  describe('contentType', () => {
-    it('returns cpubType when present (CommonPub project)', () => {
-      const fedContent = ref(makeFedContent({ cpubType: 'project' }));
-      const { contentType } = useMirrorContent(fedContent);
-      expect(contentType.value).toBe('project');
-    });
-
-    it('returns cpubType when present (CommonPub article)', () => {
-      const fedContent = ref(makeFedContent({ cpubType: 'article' }));
-      const { contentType } = useMirrorContent(fedContent);
-      expect(contentType.value).toBe('article');
-    });
-
-    it('returns cpubType when present (CommonPub blog)', () => {
-      const fedContent = ref(makeFedContent({ cpubType: 'blog' }));
-      const { contentType } = useMirrorContent(fedContent);
-      expect(contentType.value).toBe('blog');
-    });
-
-    it('returns cpubType when present (CommonPub explainer)', () => {
-      const fedContent = ref(makeFedContent({ cpubType: 'explainer' }));
-      const { contentType } = useMirrorContent(fedContent);
-      expect(contentType.value).toBe('explainer');
-    });
-
-    it('falls back to apType lowercase for non-CommonPub Article', () => {
-      const fedContent = ref(makeFedContent({ cpubType: null, apType: 'Article' }));
-      const { contentType } = useMirrorContent(fedContent);
-      expect(contentType.value).toBe('article');
-    });
-
-    it('falls back to apType lowercase for Note', () => {
-      const fedContent = ref(makeFedContent({ cpubType: null, apType: 'Note' }));
-      const { contentType } = useMirrorContent(fedContent);
-      expect(contentType.value).toBe('note');
-    });
-
-    it('falls back to "article" when both cpubType and apType are null', () => {
-      const fedContent = ref(makeFedContent({ cpubType: null, apType: null }));
-      const { contentType } = useMirrorContent(fedContent);
-      expect(contentType.value).toBe('article');
-    });
-
-    it('prefers cpubType over apType', () => {
-      const fedContent = ref(makeFedContent({ cpubType: 'project', apType: 'Article' }));
-      const { contentType } = useMirrorContent(fedContent);
-      expect(contentType.value).toBe('project');
-    });
-  });
-
-  // --- transformedContent ---
-
-  describe('transformedContent', () => {
-    it('returns null when fedContent is null', () => {
-      const fedContent = ref(null);
-      const { transformedContent } = useMirrorContent(fedContent);
-      expect(transformedContent.value).toBeNull();
-    });
-
-    it('maps title correctly', () => {
-      const fedContent = ref(makeFedContent({ title: 'LED Cube Build' }));
-      const { transformedContent } = useMirrorContent(fedContent);
-      expect(transformedContent.value?.title).toBe('LED Cube Build');
-    });
-
-    it('uses "Untitled" when title is null', () => {
-      const fedContent = ref(makeFedContent({ title: null }));
-      const { transformedContent } = useMirrorContent(fedContent);
-      expect(transformedContent.value?.title).toBe('Untitled');
-    });
-
-    it('preserves cpubBlocks when present (CommonPub-to-CommonPub)', () => {
-      const blocks = [['paragraph', { text: 'Hello' }], ['heading', { level: 2, text: 'World' }]];
-      const fedContent = ref(makeFedContent({ cpubBlocks: blocks }));
-      const { transformedContent } = useMirrorContent(fedContent);
-      expect(transformedContent.value?.content).toEqual(blocks);
-    });
-
-    it('wraps HTML content as paragraph block (non-CommonPub)', () => {
-      const fedContent = ref(makeFedContent({
-        cpubBlocks: null,
-        content: '<p>Hello from Mastodon</p>',
-      }));
-      const { transformedContent } = useMirrorContent(fedContent);
-      expect(transformedContent.value?.content).toEqual([
-        ['paragraph', { html: '<p>Hello from Mastodon</p>' }],
-      ]);
-    });
-
-    it('extracts metadata from cpubMetadata', () => {
-      const fedContent = ref(makeFedContent({
-        cpubType: 'project',
-        cpubMetadata: { difficulty: 'intermediate', buildTime: '4h', estimatedCost: '$50' },
-      }));
-      const { transformedContent } = useMirrorContent(fedContent);
-      expect(transformedContent.value?.difficulty).toBe('intermediate');
-      expect(transformedContent.value?.buildTime).toBe('4h');
-      expect(transformedContent.value?.estimatedCost).toBe('$50');
-    });
-
-    it('maps tags to expected format', () => {
-      const fedContent = ref(makeFedContent({
-        tags: [
-          { type: 'Hashtag', name: '#electronics' },
-          { type: 'Hashtag', name: '#led' },
-        ],
-      }));
-      const { transformedContent } = useMirrorContent(fedContent);
-      expect(transformedContent.value?.tags).toHaveLength(2);
-      expect(transformedContent.value?.tags[0]?.name).toBe('#electronics');
-    });
-
-    it('maps actor to author format', () => {
-      const fedContent = ref(makeFedContent({
-        actor: {
-          actorUri: 'https://remote.example.com/users/bob',
-          preferredUsername: 'bob',
-          displayName: 'Bob Builder',
-          avatarUrl: 'https://remote.example.com/avatar.png',
-          instanceDomain: 'remote.example.com',
-          followerCount: 42,
-        },
-      }));
-      const { transformedContent } = useMirrorContent(fedContent);
-      expect(transformedContent.value?.author.username).toBe('bob');
-      expect(transformedContent.value?.author.displayName).toBe('Bob Builder');
-      expect(transformedContent.value?.author.avatarUrl).toBe('https://remote.example.com/avatar.png');
-    });
-  });
-
-  // --- originDomain ---
-
-  describe('originDomain', () => {
-    it('extracts origin domain', () => {
-      const fedContent = ref(makeFedContent({ originDomain: 'mastodon.social' }));
-      const { originDomain } = useMirrorContent(fedContent);
-      expect(originDomain.value).toBe('mastodon.social');
-    });
-
-    it('falls back to "unknown" when null', () => {
-      const fedContent = ref(makeFedContent({ originDomain: null }));
-      const { originDomain } = useMirrorContent(fedContent);
-      expect(originDomain.value).toBe('unknown');
-    });
-  });
-
-  // --- authorHandle ---
-
-  describe('authorHandle', () => {
-    it('formats as @user@domain', () => {
-      const fedContent = ref(makeFedContent());
-      const { authorHandle } = useMirrorContent(fedContent);
-      expect(authorHandle.value).toBe('@alice@remote.example.com');
-    });
-
-    it('returns empty string when no actor', () => {
-      const fedContent = ref(makeFedContent({ actor: null }));
-      const { authorHandle } = useMirrorContent(fedContent);
-      expect(authorHandle.value).toBe('');
-    });
-  });
-});