@portaki/module-sections 1.0.1 → 1.2.3

package/package.json

@@ -1,16 +1,12 @@
 {
   "name": "@portaki/module-sections",
-  "version": "1.0.1",
+  "version": "1.2.3",
   "description": "Portaki module — editorial sections (TipTap)",
   "license": "AGPL-3.0",
   "type": "module",
   "main": "./src/index.tsx",
-  "scripts": {
-    "lint": "echo \"no lint yet\""
-  },
   "dependencies": {
-    "@portaki/module-sdk": "0.5.0",
-    "@portaki/sdk": "^0.5.0",
+    "@portaki/sdk": "^2.0.4",
     "@tiptap/core": "^3.0.0",
     "@tiptap/html": "^3.0.0",
     "@tiptap/starter-kit": "^3.0.0",
@@ -18,8 +14,14 @@
     "react-dom": "^19.1.0"
   },
   "devDependencies": {
+    "@portaki/cli": "^0.1.2",
+    "@portaki/sdk-test-support": "^2.0.4",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
     "@types/react": "^19",
-    "typescript": "^5"
+    "jsdom": "^26.0.0",
+    "typescript": "^5",
+    "vitest": "^3.0.5"
   },
   "repository": {
     "type": "git",
@@ -28,5 +30,11 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "portaki build --entry src/portaki.gateway.tsx",
+    "lint": "echo \"no lint yet\"",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}

package/portaki.catalog.json

@@ -0,0 +1,124 @@
+{
+  "$schema": "https://raw.githubusercontent.com/PortakiApp/portaki-sdk/main/schema/module.v1.json",
+  "id": "sections",
+  "name": {
+    "fr": "Sections éditoriales",
+    "en": "Editorial sections"
+  },
+  "description": {
+    "fr": "Blocs de contenu riches (TipTap) pour le carnet d’accueil invité.",
+    "en": "Rich content blocks (TipTap) for the guest welcome book."
+  },
+  "version": "1.2.3",
+  "releaseNotesUrl": "https://github.com/PortakiApp/portaki-modules/releases",
+  "changelog": [
+    {
+      "version": "1.2.0",
+      "date": "2026-05-18",
+      "notes": {
+        "fr": "Release catalogue modules 1.2.0.",
+        "en": "Module catalog release 1.2.0."
+      }
+    },
+    {
+      "version": "1.0.0",
+      "date": "2026-05-16",
+      "notes": {
+        "fr": "Première version : sections TipTap, gateway hôte et invité.",
+        "en": "Initial release: TipTap sections, host and guest gateway."
+      }
+    }
+  ],
+  "author": {
+    "name": "Portaki",
+    "url": "https://portaki.app",
+    "type": "official"
+  },
+  "icon": "file-text",
+  "type": "official",
+  "tags": [
+    "editorial",
+    "content",
+    "sections"
+  ],
+  "portakiVersionMin": "1.0.0",
+  "requiresHostSdk": "2.0.0",
+  "database": {
+    "schemaVersion": "1.0.1"
+  },
+  "license": "AGPL-3.0",
+  "repository": "https://github.com/PortakiApp/portaki-modules",
+  "scopes": [
+    "stay:read",
+    "property:read",
+    "host:property:read",
+    "host:property:write"
+  ],
+  "queries": [
+    {
+      "name": "sections.list",
+      "description": {
+        "fr": "Liste des sections du logement.",
+        "en": "Property editorial sections."
+      },
+      "scope": "property:read"
+    }
+  ],
+  "commands": [
+    {
+      "name": "sections.section.save",
+      "description": {
+        "fr": "Créer ou mettre à jour une section.",
+        "en": "Create or update a section."
+      },
+      "scope": "host:property:write"
+    },
+    {
+      "name": "sections.section.delete",
+      "description": {
+        "fr": "Supprimer une section.",
+        "en": "Delete a section."
+      },
+      "scope": "host:property:write"
+    },
+    {
+      "name": "sections.reorder",
+      "description": {
+        "fr": "Réordonner les sections.",
+        "en": "Reorder sections."
+      },
+      "scope": "host:property:write"
+    }
+  ],
+  "hostSurfaces": [
+    {
+      "type": "property-workspace-tab",
+      "pathSegment": "sections",
+      "label": {
+        "fr": "Sections",
+        "en": "Sections"
+      },
+      "icon": "file-text"
+    }
+  ],
+  "config": {
+    "defaults": {},
+    "fields": []
+  },
+  "catalog": {
+    "tagline": {
+      "fr": "Composez votre carnet section par section.",
+      "en": "Build your welcome book section by section."
+    },
+    "npmPackage": "@portaki/module-sections",
+    "npmUrl": "https://www.npmjs.com/package/@portaki/module-sections"
+  },
+  "runtime": {
+    "backend": "wasm",
+    "guest": "remote-esm"
+  },
+  "artifacts": {
+    "wasmUrl": "oci://ghcr.io/portakiapp/portaki-module-sections",
+    "guestEsmUrl": "https://esm.sh/@portaki/module-sections@1.2.3"
+  }
+}

package/portaki.module.json

@@ -9,7 +9,26 @@
     "fr": "Blocs de contenu riches (TipTap) pour le carnet d’accueil invité.",
     "en": "Rich content blocks (TipTap) for the guest welcome book."
   },
-  "version": "1.0.0",
+  "version": "1.2.1",
+  "releaseNotesUrl": "https://github.com/PortakiApp/portaki-modules/releases",
+  "changelog": [
+    {
+      "version": "1.2.0",
+      "date": "2026-05-18",
+      "notes": {
+        "fr": "Release catalogue modules 1.2.0.",
+        "en": "Module catalog release 1.2.0."
+      }
+    },
+    {
+      "version": "1.0.0",
+      "date": "2026-05-16",
+      "notes": {
+        "fr": "Première version : sections TipTap, gateway hôte et invité.",
+        "en": "Initial release: TipTap sections, host and guest gateway."
+      }
+    }
+  ],
   "author": {
     "name": "Portaki",
     "url": "https://portaki.app",
@@ -17,58 +36,68 @@
   },
   "icon": "file-text",
   "type": "official",
-  "tags": ["editorial", "content", "sections"],
+  "tags": [
+    "editorial",
+    "content",
+    "sections"
+  ],
   "portakiVersionMin": "1.0.0",
-  "requiresHostSdk": "0.6.0",
+  "requiresHostSdk": "2.0.0",
+  "database": {
+    "schemaVersion": "1.0.1"
+  },
   "license": "AGPL-3.0",
   "repository": "https://github.com/PortakiApp/portaki-modules",
   "scopes": [
-    "stay:read",
-    "property:read",
     "host:property:read",
-    "host:property:write"
+    "host:property:write",
+    "property:read",
+    "stay:read"
   ],
   "queries": [
     {
       "name": "sections.list",
+      "scope": "property:read",
       "description": {
         "fr": "Liste des sections du logement.",
         "en": "Property editorial sections."
-      },
-      "scope": "property:read"
+      }
     }
   ],
   "commands": [
     {
       "name": "sections.section.save",
+      "scope": "host:property:write",
       "description": {
         "fr": "Créer ou mettre à jour une section.",
         "en": "Create or update a section."
-      },
-      "scope": "host:property:write"
+      }
     },
     {
       "name": "sections.section.delete",
+      "scope": "host:property:write",
       "description": {
         "fr": "Supprimer une section.",
         "en": "Delete a section."
-      },
-      "scope": "host:property:write"
+      }
     },
     {
       "name": "sections.reorder",
+      "scope": "host:property:write",
       "description": {
         "fr": "Réordonner les sections.",
         "en": "Reorder sections."
-      },
-      "scope": "host:property:write"
+      }
     }
   ],
   "hostSurfaces": [
     {
       "type": "property-workspace-tab",
       "pathSegment": "sections",
-      "label": { "fr": "Sections", "en": "Sections" },
+      "label": {
+        "fr": "Sections",
+        "en": "Sections"
+      },
       "icon": "file-text"
     }
   ],
@@ -82,7 +111,14 @@
       "en": "Build your welcome book section by section."
     },
     "npmPackage": "@portaki/module-sections",
-    "npmUrl": "https://www.npmjs.com/package/@portaki/module-sections",
-    "javaArtifact": "app.portaki.module:sections-backend:0.1.0"
+    "npmUrl": "https://www.npmjs.com/package/@portaki/module-sections"
+  },
+  "runtime": {
+    "backend": "wasm",
+    "guest": "remote-esm"
+  },
+  "artifacts": {
+    "wasmUrl": "oci://ghcr.io/portakiapp/portaki-module-sections",
+    "guestEsmUrl": "https://esm.sh/@portaki/module-sections@1.2.3"
   }
 }

package/src/components/SectionsGuestView.tsx

@@ -4,8 +4,8 @@ import type { JSONContent } from '@tiptap/core'
 import { generateHTML } from '@tiptap/html'
 import StarterKit from '@tiptap/starter-kit'
 import { usePortakiQuery } from '@portaki/sdk'
-import type { LangCode } from '@portaki/module-sdk'
-import { ModuleSection } from '@portaki/module-sdk'
+import type { LangCode } from '@portaki/sdk'
+import { ModuleSection } from '@portaki/sdk'
 
 type SectionRow = {
   id: string

package/src/index.tsx

@@ -1,17 +1 @@
-import type { ModuleContext } from '@portaki/module-sdk'
-import { definePortakiModule } from '@portaki/module-sdk'
-
-import { SectionsGuestView } from './components/SectionsGuestView'
-
-export default definePortakiModule({
-  id: 'sections',
-  label: { fr: 'Sections', en: 'Sections' },
-  description: {
-    fr: 'Contenus éditoriaux du carnet d’accueil.',
-    en: 'Welcome book editorial content.',
-  },
-  version: '1.0.0',
-  icon: 'file-text',
-  navSlot: 'section',
-  render: ({ lang }: ModuleContext) => <SectionsGuestView lang={lang} />,
-})
+export { default } from './portaki.module'

package/src/manifest.test.ts

@@ -0,0 +1,8 @@
+import { describe, it } from 'vitest'
+import { validateSiblingManifest } from '@portaki/sdk-test-support'
+
+describe('portaki.module.json', () => {
+  it('matches module.v1 schema', () => {
+    validateSiblingManifest(import.meta.url)
+  })
+})

package/src/module.test.tsx

@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest'
+import { waitFor } from '@testing-library/react'
+import { assertGuestSurface, renderGuestModule } from '@portaki/sdk-test-support'
+
+import moduleDef from './index'
+
+describe('@portaki/module-sections', () => {
+  it('exposes a valid guest module definition', () => {
+    assertGuestSurface(moduleDef)
+  })
+
+  it('renders without crashing', async () => {
+    const view =
+      moduleDef.surface === 'host' ? renderHostModule(moduleDef) : renderGuestModule(moduleDef)
+    await waitFor(() => {
+      expect(view.container).toBeTruthy()
+    })
+    view.unmount()
+  })
+})

package/src/portaki.gateway.tsx

@@ -0,0 +1,3 @@
+import { defineSectionsModule } from './sections-module-definition'
+
+export default defineSectionsModule(() => null)

package/src/portaki.module.tsx

@@ -0,0 +1,4 @@
+import { SectionsGuestView } from './components/SectionsGuestView'
+import { defineSectionsModule } from './sections-module-definition'
+
+export default defineSectionsModule(({ lang }) => <SectionsGuestView lang={lang} />)

package/src/sections-module-definition.ts

@@ -0,0 +1,223 @@
+import {
+  defineModule,
+  index,
+  int,
+  jsonb,
+  moduleSchema,
+  table,
+  tenantId,
+  tenantPropertyIndex,
+  text,
+  timestamptz,
+  uuid,
+  uuidPrimaryKey,
+  type ModuleContext,
+  type PortakiFullModule,
+} from '@portaki/sdk'
+import type { ReactNode } from 'react'
+
+const sectionsSchema = moduleSchema([
+  table('items', 't_e_module_sections_item', {
+    columns: [
+      uuidPrimaryKey(),
+      uuid('propertyId'),
+      tenantId(),
+      int('sortOrder', { defaultSql: '0' }),
+      text('titleFr', { defaultSql: "''" }),
+      text('titleEn', { defaultSql: "''" }),
+      jsonb('contentFr', { nullable: true }),
+      jsonb('contentEn', { nullable: true }),
+      timestamptz('createdAt', { nullable: false, defaultSql: 'now()' }),
+      timestamptz('updatedAt', { nullable: false, defaultSql: 'now()' }),
+    ],
+    indexes: [tenantPropertyIndex()],
+  }),
+])
+
+function stringParam(params: Record<string, unknown>, key: string): string | null {
+  const value = params[key]
+  if (value == null) {
+    return null
+  }
+  return String(value)
+}
+
+function intParam(params: Record<string, unknown>, key: string, defaultValue: number): number {
+  const value = params[key]
+  if (value == null) {
+    return defaultValue
+  }
+  if (typeof value === 'number') {
+    return value
+  }
+  return Number.parseInt(String(value), 10)
+}
+
+export function defineSectionsModule(render: (ctx: ModuleContext) => ReactNode): PortakiFullModule {
+  return defineModule({
+    id: 'sections',
+    label: { fr: 'Sections', en: 'Sections' },
+    description: {
+      fr: 'Contenus éditoriaux du carnet d’accueil.',
+      en: 'Welcome book editorial content.',
+    },
+    icon: 'file-text',
+    version: '1.2.1',
+    schemaVersion: '1.0.1',
+    schema: sectionsSchema,
+    navSlot: 'section',
+
+    queries: {
+      'sections.list': {
+        scope: 'property:read',
+        description: {
+          fr: 'Liste des sections du logement.',
+          en: 'Property editorial sections.',
+        },
+        async handler(ctx) {
+          const rows = await ctx.db
+            .from('items')
+            .where({ tenantId: ctx.tenantId, propertyId: ctx.propertyId })
+            .many()
+          rows.sort((a, b) => {
+            const orderA = Number(a.sortOrder ?? 0)
+            const orderB = Number(b.sortOrder ?? 0)
+            if (orderA !== orderB) {
+              return orderA - orderB
+            }
+            const createdA = String(a.createdAt ?? '')
+            const createdB = String(b.createdAt ?? '')
+            return createdA.localeCompare(createdB)
+          })
+          const sections = rows.map((row) => {
+            const section: Record<string, unknown> = {
+              id: row.id,
+              sortOrder: row.sortOrder,
+              titleFr: row.titleFr,
+              titleEn: row.titleEn,
+              contentFr: row.contentFr ?? null,
+              contentEn: row.contentEn ?? null,
+            }
+            if (row.updatedAt != null) {
+              section.updatedAt = row.updatedAt
+            }
+            return section
+          })
+          return { sections }
+        },
+      },
+    },
+
+    commands: {
+      'sections.section.save': {
+        scope: 'host:property:write',
+        description: {
+          fr: 'Créer ou mettre à jour une section.',
+          en: 'Create or update a section.',
+        },
+        async handler(ctx, params) {
+          const filters = { tenantId: ctx.tenantId, propertyId: ctx.propertyId }
+          const idRaw = stringParam(params, 'id')
+          const id =
+            idRaw == null || idRaw.trim() === '' ? crypto.randomUUID() : idRaw.trim()
+          let titleFr = stringParam(params, 'titleFr')
+          let titleEn = stringParam(params, 'titleEn')
+          if (titleFr == null || titleFr.trim() === '') {
+            throw new Error('title_fr_required')
+          }
+          titleFr = titleFr.trim()
+          if (titleEn == null || titleEn.trim() === '') {
+            titleEn = titleFr
+          } else {
+            titleEn = titleEn.trim()
+          }
+          const contentFr = params.contentFr ?? null
+          const contentEn = params.contentEn ?? null
+          const existing = await ctx.db
+            .from('items')
+            .where({ ...filters, id })
+            .one()
+          let sortOrder = intParam(params, 'sortOrder', -1)
+          if (sortOrder < 0) {
+            const all = await ctx.db.from('items').where(filters).many()
+            const max = all
+              .filter((row) => String(row.id) !== id)
+              .reduce((acc, row) => Math.max(acc, Number(row.sortOrder ?? 0)), -1)
+            sortOrder = max + 1
+          }
+          const now = new Date().toISOString()
+          const payload = {
+            titleFr,
+            titleEn,
+            contentFr,
+            contentEn,
+            sortOrder,
+            updatedAt: now,
+          }
+          if (existing != null) {
+            await ctx.db.from('items').where({ ...filters, id }).update(payload)
+            return
+          }
+          await ctx.db.from('items').insert({
+            id,
+            ...filters,
+            ...payload,
+            createdAt: now,
+          })
+        },
+      },
+      'sections.section.delete': {
+        scope: 'host:property:write',
+        description: {
+          fr: 'Supprimer une section.',
+          en: 'Delete a section.',
+        },
+        async handler(ctx, params) {
+          const idRaw = stringParam(params, 'id')
+          if (idRaw == null || idRaw.trim() === '') {
+            throw new Error('id_required')
+          }
+          const deleted = await ctx.db
+            .from('items')
+            .where({
+              id: idRaw.trim(),
+              tenantId: ctx.tenantId,
+              propertyId: ctx.propertyId,
+            })
+            .delete()
+          if (deleted === 0) {
+            throw new Error('section_not_found')
+          }
+        },
+      },
+      'sections.reorder': {
+        scope: 'host:property:write',
+        description: {
+          fr: 'Réordonner les sections.',
+          en: 'Reorder sections.',
+        },
+        async handler(ctx, params) {
+          const raw = params.orderedIds
+          if (!Array.isArray(raw) || raw.length === 0) {
+            throw new Error('ordered_ids_required')
+          }
+          const filters = { tenantId: ctx.tenantId, propertyId: ctx.propertyId }
+          const now = new Date().toISOString()
+          let order = 0
+          for (const item of raw) {
+            if (item == null) {
+              continue
+            }
+            const id = String(item)
+            await ctx.db
+              .from('items')
+              .where({ ...filters, id })
+              .update({ sortOrder: order++, updatedAt: now })
+          }
+        },
+      },
+    },
+
+    render,
+  })
+}

package/vitest.config.ts

@@ -0,0 +1,3 @@
+import { portakiModuleVitestConfig } from '@portaki/sdk-test-support/vitest'
+
+export default portakiModuleVitestConfig(import.meta.url)