@portaki/module-sections 1.2.7 → 1.3.1

package/src/host/sections-editor-design.ts

@@ -0,0 +1,79 @@
+import type { SectionsEditorDesign } from './sections-host.types'
+
+export const sectionsEditorDesign = {
+  id: 'sections-editor-v1',
+  moduleId: 'sections',
+  layout: 'sections-split-panel',
+  gateway: {
+    listQuery: 'sections.list',
+    saveCommand: 'sections.section.save',
+    deleteCommand: 'sections.section.delete',
+    reorderCommand: 'sections.reorder',
+  },
+  createModal: {
+    titleFr: 'Nouvelle section',
+    subtitleFr: 'Choisissez un modèle pour partir vite, ou créez une section vide.',
+    titleFieldLabelFr: 'Titre',
+    titleFieldHintFr: 'Visible par le voyageur, en haut de la section.',
+    footerHintFr: 'Vous pourrez renommer et réordonner ensuite.',
+    cancelLabelFr: 'Annuler',
+    submitLabelFr: 'Créer la section',
+    defaultTemplateId: 'welcome',
+    templates: [
+      {
+        id: 'welcome',
+        icon: '👋',
+        titleFr: 'Mot de bienvenue',
+        titleEn: 'Welcome message',
+        descriptionFr: "Un paragraphe d'accueil personnalisé",
+        contentPreset: 'welcome',
+      },
+      {
+        id: 'beaches',
+        icon: '🏖️',
+        titleFr: 'Plages & criques',
+        titleEn: 'Beaches & coves',
+        descriptionFr: 'Liste de plages avec accès & distance',
+        contentPreset: 'beaches',
+      },
+      {
+        id: 'restaurants',
+        icon: '🍝',
+        titleFr: 'Nos restaurants préférés',
+        titleEn: 'Our favourite restaurants',
+        descriptionFr: 'Recommandations par budget',
+        contentPreset: 'restaurants',
+      },
+      {
+        id: 'transport',
+        icon: '🚂',
+        titleFr: 'Comment venir & repartir',
+        titleEn: 'Getting here & leaving',
+        descriptionFr: 'Train, bus, voiture, taxi',
+        contentPreset: 'transport',
+      },
+      {
+        id: 'emergencies',
+        icon: '🆘',
+        titleFr: 'Urgences & numéros utiles',
+        titleEn: 'Emergencies & useful numbers',
+        descriptionFr: '112, médecin, police',
+        contentPreset: 'emergencies',
+      },
+      {
+        id: 'empty',
+        icon: '📋',
+        titleFr: 'Vide · personnalisée',
+        titleEn: 'Empty · custom',
+        descriptionFr: "Démarrer d'une page blanche",
+        contentPreset: 'empty',
+      },
+    ],
+  },
+  emptyState: {
+    titleFr: 'Aucune section pour l’instant',
+    descriptionFr:
+      'Structurez le carnet d’accueil en blocs (plages, restaurants, consignes…) visibles par vos voyageurs dans le livret.',
+    primaryActionLabelFr: 'Créer une section',
+  },
+} satisfies SectionsEditorDesign

package/src/host/sections-host.types.ts

@@ -0,0 +1,53 @@
+export const SECTION_CONTENT_PRESET_IDS = [
+  'welcome',
+  'beaches',
+  'restaurants',
+  'transport',
+  'emergencies',
+  'empty',
+] as const
+
+export type SectionContentPresetId = (typeof SECTION_CONTENT_PRESET_IDS)[number]
+
+export type SectionTemplateId = SectionContentPresetId
+
+export type SectionsEditorEmptyStateDesign = {
+  titleFr: string
+  descriptionFr: string
+  primaryActionLabelFr: string
+}
+
+export type SectionCreateModalDesign = {
+  titleFr: string
+  subtitleFr: string
+  titleFieldLabelFr: string
+  titleFieldHintFr: string
+  footerHintFr: string
+  cancelLabelFr: string
+  submitLabelFr: string
+  defaultTemplateId: SectionTemplateId
+  templates: readonly SectionTemplateDesign[]
+}
+
+export type SectionTemplateDesign = {
+  id: SectionTemplateId
+  icon: string
+  titleFr: string
+  titleEn: string
+  descriptionFr: string
+  contentPreset: SectionContentPresetId
+}
+
+export type SectionsEditorDesign = {
+  id: 'sections-editor-v1'
+  moduleId: 'sections'
+  layout: 'sections-split-panel'
+  gateway: {
+    listQuery: 'sections.list'
+    saveCommand: 'sections.section.save'
+    deleteCommand: 'sections.section.delete'
+    reorderCommand: 'sections.reorder'
+  }
+  createModal: SectionCreateModalDesign
+  emptyState: SectionsEditorEmptyStateDesign
+}

package/src/host/sections-toast-copy.ts

@@ -0,0 +1,9 @@
+export const sectionsToastCopy = {
+  loadError: 'Impossible de charger les sections.',
+  saveError: 'Enregistrement impossible.',
+  reorderError: 'Réordonnancement impossible.',
+  createSuccess: 'Section créée.',
+  createError: 'Création impossible.',
+  deleteSuccess: 'Section supprimée.',
+  deleteError: 'Suppression impossible.',
+} as const

package/src/module.test.tsx

@@ -1,17 +1,32 @@
 import { describe, expect, it } from 'vitest'
 import { waitFor } from '@testing-library/react'
-import { assertGuestSurface, renderGuestModule } from '@portaki/sdk-test-support'
+import {
+  assertGuestSurface,
+  renderGuestModule,
+  renderHostModule,
+} from '@portaki/sdk-test-support'
 
 import moduleDef from './index'
+import { createSectionsTestHostContext } from './test/mock-host-module-context'
 
 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)
+  it('renders guest surface without crashing', async () => {
+    const view = renderGuestModule(moduleDef)
+    await waitFor(() => {
+      expect(view.container).toBeTruthy()
+    })
+    view.unmount()
+  })
+
+  it('renders host surface without crashing', async () => {
+    if (moduleDef.renderHost == null) {
+      return
+    }
+    const view = renderHostModule(moduleDef, createSectionsTestHostContext())
     await waitFor(() => {
       expect(view.container).toBeTruthy()
     })

package/src/{sections-module-definition.ts → sections-module-definition.tsx}

@@ -1,6 +1,5 @@
 import {
   defineModule,
-  index,
   int,
   jsonb,
   moduleSchema,
@@ -11,11 +10,14 @@ import {
   timestamptz,
   uuid,
   uuidPrimaryKey,
+  type HostModuleContext,
   type ModuleContext,
   type PortakiFullModule,
 } from '@portaki/sdk'
 import type { ReactNode } from 'react'
 
+import { SectionsHostWorkspace } from './host/SectionsHostWorkspace'
+
 const sectionsSchema = moduleSchema([
   table('items', 't_e_module_sections_item', {
     columns: [
@@ -23,17 +25,28 @@ const sectionsSchema = moduleSchema([
       uuid('propertyId'),
       workspaceId(),
       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: [workspacePropertyIndex()],
   }),
+  table('itemLocales', 't_e_module_sections_item_locale', {
+    columns: [
+      uuid('sectionId', { primaryKey: true }),
+      text('lang', { primaryKey: true }),
+      workspaceId(),
+      uuid('propertyId'),
+      text('title', { defaultSql: "''" }),
+      jsonb('content', { nullable: true }),
+    ],
+    indexes: [workspacePropertyIndex()],
+  }),
 ])
 
+const SECTION_LANGS = ['fr', 'en'] as const
+
+type SectionLang = (typeof SECTION_LANGS)[number]
+
 function stringParam(params: Record<string, unknown>, key: string): string | null {
   const value = params[key]
   if (value == null) {
@@ -53,6 +66,75 @@ function intParam(params: Record<string, unknown>, key: string, defaultValue: nu
   return Number.parseInt(String(value), 10)
 }
 
+function localeTitleForLang(
+  lang: SectionLang,
+  titleFr: string,
+  titleEn: string,
+): string {
+  if (lang === 'fr') {
+    return titleFr
+  }
+  return titleEn.trim() === '' ? titleFr : titleEn
+}
+
+function localeContentForLang(
+  lang: SectionLang,
+  contentFr: unknown,
+  contentEn: unknown,
+): unknown {
+  if (lang === 'fr') {
+    return contentFr ?? null
+  }
+  return contentEn ?? null
+}
+
+async function upsertSectionLocale(
+  ctx: ModuleContext,
+  filters: { workspaceId: string; propertyId: string },
+  sectionId: string,
+  lang: SectionLang,
+  title: string,
+  content: unknown,
+): Promise<void> {
+  const where = { ...filters, sectionId, lang }
+  const existing = await ctx.db.from('itemLocales').where(where).one()
+  const payload = { title, content }
+  if (existing != null) {
+    await ctx.db.from('itemLocales').where(where).update(payload)
+    return
+  }
+  await ctx.db.from('itemLocales').insert({
+    ...where,
+    ...payload,
+  })
+}
+
+function sectionDtoFromLocales(
+  item: Record<string, unknown>,
+  locales: Record<string, unknown>[],
+): Record<string, unknown> {
+  const byLang = new Map<string, Record<string, unknown>>()
+  for (const row of locales) {
+    byLang.set(String(row.lang), row)
+  }
+  const fr = byLang.get('fr')
+  const en = byLang.get('en')
+  const titleFr = String(fr?.title ?? '')
+  const titleEnRaw = String(en?.title ?? '')
+  const section: Record<string, unknown> = {
+    id: item.id,
+    sortOrder: item.sortOrder,
+    titleFr,
+    titleEn: titleEnRaw.trim() === '' ? titleFr : titleEnRaw,
+    contentFr: fr?.content ?? null,
+    contentEn: en?.content ?? null,
+  }
+  if (item.updatedAt != null) {
+    section.updatedAt = item.updatedAt
+  }
+  return section
+}
+
 export function defineSectionsModule(render: (ctx: ModuleContext) => ReactNode): PortakiFullModule {
   return defineModule({
     id: 'sections',
@@ -62,8 +144,8 @@ export function defineSectionsModule(render: (ctx: ModuleContext) => ReactNode):
       en: 'Welcome book editorial content.',
     },
     icon: 'file-text',
-    version: '1.2.4',
-    schemaVersion: '1.0.1',
+    version: '1.2.7',
+    schemaVersion: '1.0.2',
     schema: sectionsSchema,
     navSlot: 'section',
 
@@ -75,10 +157,16 @@ export function defineSectionsModule(render: (ctx: ModuleContext) => ReactNode):
           en: 'Property editorial sections.',
         },
         async handler(ctx) {
-          const rows = await ctx.db
-            .from('items')
-            .where({ workspaceId: ctx.workspaceId, propertyId: ctx.propertyId })
-            .many()
+          const filters = { workspaceId: ctx.workspaceId, propertyId: ctx.propertyId }
+          const rows = await ctx.db.from('items').where(filters).many()
+          const locales = await ctx.db.from('itemLocales').where(filters).many()
+          const localesBySection = new Map<string, Record<string, unknown>[]>()
+          for (const locale of locales) {
+            const sectionId = String(locale.sectionId)
+            const bucket = localesBySection.get(sectionId) ?? []
+            bucket.push(locale)
+            localesBySection.set(sectionId, bucket)
+          }
           rows.sort((a, b) => {
             const orderA = Number(a.sortOrder ?? 0)
             const orderB = Number(b.sortOrder ?? 0)
@@ -89,21 +177,9 @@ export function defineSectionsModule(render: (ctx: ModuleContext) => ReactNode):
             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 }
+          return rows.map((row) =>
+            sectionDtoFromLocales(row, localesBySection.get(String(row.id)) ?? []),
+          )
         },
       },
     },
@@ -146,24 +222,30 @@ export function defineSectionsModule(render: (ctx: ModuleContext) => ReactNode):
             sortOrder = max + 1
           }
           const now = new Date().toISOString()
-          const payload = {
-            titleFr,
-            titleEn,
-            contentFr,
-            contentEn,
+          const itemPayload = {
             sortOrder,
             updatedAt: now,
           }
           if (existing != null) {
-            await ctx.db.from('items').where({ ...filters, id }).update(payload)
-            return
+            await ctx.db.from('items').where({ ...filters, id }).update(itemPayload)
+          } else {
+            await ctx.db.from('items').insert({
+              id,
+              ...filters,
+              ...itemPayload,
+              createdAt: now,
+            })
+          }
+          for (const lang of SECTION_LANGS) {
+            await upsertSectionLocale(
+              ctx,
+              filters,
+              id,
+              lang,
+              localeTitleForLang(lang, titleFr, titleEn),
+              localeContentForLang(lang, contentFr, contentEn),
+            )
           }
-          await ctx.db.from('items').insert({
-            id,
-            ...filters,
-            ...payload,
-            createdAt: now,
-          })
         },
       },
       'sections.section.delete': {
@@ -177,14 +259,13 @@ export function defineSectionsModule(render: (ctx: ModuleContext) => ReactNode):
           if (idRaw == null || idRaw.trim() === '') {
             throw new Error('id_required')
           }
-          const deleted = await ctx.db
-            .from('items')
-            .where({
-              id: idRaw.trim(),
-              workspaceId: ctx.workspaceId,
-              propertyId: ctx.propertyId,
-            })
-            .delete()
+          const id = idRaw.trim()
+          const filters = {
+            id,
+            workspaceId: ctx.workspaceId,
+            propertyId: ctx.propertyId,
+          }
+          const deleted = await ctx.db.from('items').where(filters).delete()
           if (deleted === 0) {
             throw new Error('section_not_found')
           }
@@ -208,10 +289,10 @@ export function defineSectionsModule(render: (ctx: ModuleContext) => ReactNode):
             if (item == null) {
               continue
             }
-            const id = String(item)
+            const sectionId = String(item)
             await ctx.db
               .from('items')
-              .where({ ...filters, id })
+              .where({ ...filters, id: sectionId })
               .update({ sortOrder: order++, updatedAt: now })
           }
         },
@@ -219,5 +300,6 @@ export function defineSectionsModule(render: (ctx: ModuleContext) => ReactNode):
     },
 
     render,
+    renderHost: (ctx: HostModuleContext) => <SectionsHostWorkspace ctx={ctx} />,
   })
 }

package/src/test/mock-host-module-context.ts

@@ -0,0 +1,35 @@
+import type { HostModuleContext, HostModuleShellComponents } from '@portaki/sdk'
+import { createMockHostModuleContext } from '@portaki/sdk-test-support'
+
+/** Stubs until published `@portaki/sdk-test-support` includes `shell` / `gateway`. */
+export const mockHostShell: HostModuleShellComponents = {
+  NotionLikeEditor: () => null,
+  HostEmptyPlaceholder: () => null,
+  HostUnderlineTabs: () => null,
+  Button: () => null,
+  Input: () => null,
+  Dialog: ({ children }) => children ?? null,
+  DialogContent: ({ children }) => children ?? null,
+  DialogHeader: ({ children }) => children ?? null,
+  DialogTitle: ({ children }) => children ?? null,
+  DialogDescription: ({ children }) => children ?? null,
+  DialogFooter: ({ children }) => children ?? null,
+  cn: (...parts) => parts.filter(Boolean).join(' '),
+  toast: { success: () => {}, error: () => {} },
+  parseTipTapDoc: () => ({ type: 'doc', content: [{ type: 'paragraph' }] }),
+  serializeTipTapDoc: (doc) => JSON.stringify(doc),
+}
+
+export function createSectionsTestHostContext(
+  overrides: Partial<HostModuleContext> = {},
+): HostModuleContext {
+  const base = createMockHostModuleContext(overrides)
+  return {
+    ...base,
+    gateway: overrides.gateway ?? base.gateway ?? {
+      query: async <T,>() => [] as T,
+      command: async () => {},
+    },
+    shell: overrides.shell ?? base.shell ?? mockHostShell,
+  }
+}