@portaki/module-sections 1.0.0 → 1.2.1

package/package.json

@@ -1,15 +1,12 @@
 {
   "name": "@portaki/module-sections",
-  "version": "1.0.0",
+  "version": "1.2.1",
   "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/module-sdk": "^1.0.0",
     "@portaki/sdk": "^0.5.0",
     "@tiptap/core": "^3.0.0",
     "@tiptap/html": "^3.0.0",
@@ -19,7 +16,11 @@
   },
   "devDependencies": {
     "@types/react": "^19",
-    "typescript": "^5"
+    "typescript": "^5",
+    "vitest": "^3.0.5",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "jsdom": "^26.0.0"
   },
   "repository": {
     "type": "git",
@@ -28,5 +29,10 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "lint": "echo \"no lint yet\"",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}

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,9 +36,16 @@
   },
   "icon": "file-text",
   "type": "official",
-  "tags": ["editorial", "content", "sections"],
+  "tags": [
+    "editorial",
+    "content",
+    "sections"
+  ],
   "portakiVersionMin": "1.0.0",
-  "requiresHostSdk": "0.6.0",
+  "requiresHostSdk": "1.1.0",
+  "database": {
+    "schemaVersion": "1.0.0"
+  },
   "license": "AGPL-3.0",
   "repository": "https://github.com/PortakiApp/portaki-modules",
   "scopes": [
@@ -68,7 +94,10 @@
     {
       "type": "property-workspace-tab",
       "pathSegment": "sections",
-      "label": { "fr": "Sections", "en": "Sections" },
+      "label": {
+        "fr": "Sections",
+        "en": "Sections"
+      },
       "icon": "file-text"
     }
   ],
@@ -83,6 +112,15 @@
     },
     "npmPackage": "@portaki/module-sections",
     "npmUrl": "https://www.npmjs.com/package/@portaki/module-sections",
-    "javaArtifact": "app.portaki.module:sections-backend:0.1.0"
+    "javaArtifact": "app.portaki.module:sections-backend"
+  },
+  "runtime": {
+    "backend": "wasm",
+    "guest": "remote-esm"
+  },
+  "artifacts": {
+    "wasmUrl": "oci://ghcr.io/portakiapp/portaki-module-sections:1.2.0",
+    "jarMaven": "app.portaki.module:sections-backend:1.2.0",
+    "guestEsmUrl": "https://esm.sh/@portaki/module-sections@1.2.0"
   }
 }

package/src/components/SectionsGuestView.tsx

@@ -33,17 +33,17 @@ function contentToHtml(raw: unknown): string {
 }
 
 export function SectionsGuestView({ lang }: { lang: LangCode }) {
-  const { data, isLoading, isError } = usePortakiQuery<ListResponse>('sections.list', {})
+  const { data, loading, error } = usePortakiQuery<ListResponse>('sections.list', {})
 
-  if (isLoading) {
+  if (loading) {
     return (
-      <ModuleSection>
+      <ModuleSection title={lang === 'fr' ? 'Sections' : 'Sections'}>
         <p className="text-sm opacity-70">{lang === 'fr' ? 'Chargement…' : 'Loading…'}</p>
       </ModuleSection>
     )
   }
 
-  if (isError || !data?.sections?.length) {
+  if (error != null || !data?.sections?.length) {
     return null
   }
 

package/src/index.tsx

@@ -10,7 +10,7 @@ export default definePortakiModule({
     fr: 'Contenus éditoriaux du carnet d’accueil.',
     en: 'Welcome book editorial content.',
   },
-  version: '1.0.0',
+  version: '1.2.0',
   icon: 'file-text',
   navSlot: 'section',
   render: ({ lang }: ModuleContext) => <SectionsGuestView lang={lang} />,

package/src/manifest.test.ts

@@ -0,0 +1,8 @@
+import { describe, it } from 'vitest'
+import { validateSiblingManifest } from '@portaki/module-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/module-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/vitest.config.ts

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

package/backend/pom.xml

@@ -1,57 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
-  <modelVersion>4.0.0</modelVersion>
-
-  <groupId>app.portaki.module</groupId>
-  <artifactId>sections-backend</artifactId>
-  <version>0.1.0</version>
-  <packaging>jar</packaging>
-
-  <name>Sections module (Java backend)</name>
-  <description>Gateway handlers and persistence for the Portaki sections editorial module.</description>
-
-  <properties>
-    <java.version>21</java.version>
-    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-  </properties>
-
-  <dependencies>
-    <dependency>
-      <groupId>app.portaki</groupId>
-      <artifactId>portaki-module-sdk</artifactId>
-      <version>0.6.0</version>
-    </dependency>
-    <dependency>
-      <groupId>org.springframework</groupId>
-      <artifactId>spring-context</artifactId>
-      <version>6.2.5</version>
-      <scope>provided</scope>
-    </dependency>
-    <dependency>
-      <groupId>org.springframework</groupId>
-      <artifactId>spring-jdbc</artifactId>
-      <version>6.2.5</version>
-      <scope>provided</scope>
-    </dependency>
-    <dependency>
-      <groupId>com.fasterxml.jackson.core</groupId>
-      <artifactId>jackson-databind</artifactId>
-      <version>2.18.2</version>
-    </dependency>
-  </dependencies>
-
-  <build>
-    <plugins>
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-compiler-plugin</artifactId>
-        <version>3.14.0</version>
-        <configuration>
-          <release>${java.version}</release>
-        </configuration>
-      </plugin>
-    </plugins>
-  </build>
-</project>

package/backend/src/main/java/app/portaki/module/sections/SectionsGatewayModule.java

@@ -1,251 +0,0 @@
-package app.portaki.module.sections;
-
-import java.sql.ResultSet;
-import java.sql.SQLException;
-import java.time.Instant;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-import java.util.UUID;
-
-import org.springframework.jdbc.core.JdbcTemplate;
-import org.springframework.stereotype.Component;
-
-import com.fasterxml.jackson.core.JsonProcessingException;
-import com.fasterxml.jackson.databind.JsonNode;
-import com.fasterxml.jackson.databind.ObjectMapper;
-
-import app.portaki.sdk.gateway.GatewayModuleContext;
-import app.portaki.sdk.gateway.PortakiCommandHandler;
-import app.portaki.sdk.gateway.PortakiQueryHandler;
-import app.portaki.sdk.module.PortakiModule;
-
-@Component
-@PortakiModule("sections")
-public class SectionsGatewayModule {
-
-    private final JdbcTemplate jdbc;
-    private final ObjectMapper objectMapper;
-
-    public SectionsGatewayModule(JdbcTemplate jdbc, ObjectMapper objectMapper) {
-        this.jdbc = jdbc;
-        this.objectMapper = objectMapper;
-    }
-
-    @PortakiQueryHandler(value = "sections.list", scope = "property:read")
-    public Map<String, Object> listSections(Map<String, Object> params, GatewayModuleContext ctx) {
-        UUID tenantId = ctx.tenantIdInternal();
-        UUID propertyId = UUID.fromString(ctx.propertyId());
-        List<Map<String, Object>> rows =
-                jdbc.query(
-                        """
-                        SELECT id, sort_order, title_fr, title_en, content_fr, content_en, updated_at
-                        FROM t_e_module_sections_item
-                        WHERE tenant_id = ? AND property_id = ?
-                        ORDER BY sort_order ASC, created_at ASC
-                        """,
-                        (rs, rowNum) -> toSectionRow(rs),
-                        tenantId,
-                        propertyId);
-        return Map.of("sections", rows);
-    }
-
-    @PortakiCommandHandler(value = "sections.section.save", scope = "host:property:write")
-    public void saveSection(Map<String, Object> params, GatewayModuleContext ctx) {
-        UUID tenantId = ctx.tenantIdInternal();
-        UUID propertyId = UUID.fromString(ctx.propertyId());
-        String idRaw = stringParam(params, "id");
-        UUID id = idRaw == null || idRaw.isBlank() ? UUID.randomUUID() : UUID.fromString(idRaw);
-        String titleFr = stringParam(params, "titleFr");
-        String titleEn = stringParam(params, "titleEn");
-        JsonNode contentFr = readJsonParam(params, "contentFr");
-        JsonNode contentEn = readJsonParam(params, "contentEn");
-        int sortOrder = intParam(params, "sortOrder", nextSortOrder(tenantId, propertyId, id));
-
-        if (titleFr == null || titleFr.isBlank()) {
-            throw new IllegalArgumentException("title_fr_required");
-        }
-        if (titleEn == null || titleEn.isBlank()) {
-            titleEn = titleFr;
-        }
-
-        boolean exists =
-                Boolean.TRUE.equals(
-                        jdbc.queryForObject(
-                                """
-                                SELECT EXISTS(
-                                  SELECT 1 FROM t_e_module_sections_item
-                                  WHERE id = ? AND tenant_id = ? AND property_id = ?
-                                )
-                                """,
-                                Boolean.class,
-                                id,
-                                tenantId,
-                                propertyId));
-
-        if (exists) {
-            jdbc.update(
-                    """
-                    UPDATE t_e_module_sections_item
-                    SET title_fr = ?, title_en = ?, content_fr = ?::jsonb, content_en = ?::jsonb,
-                        sort_order = ?, updated_at = ?
-                    WHERE id = ? AND tenant_id = ? AND property_id = ?
-                    """,
-                    titleFr,
-                    titleEn,
-                    jsonOrNull(contentFr),
-                    jsonOrNull(contentEn),
-                    sortOrder,
-                    Instant.now(),
-                    id,
-                    tenantId,
-                    propertyId);
-        } else {
-            jdbc.update(
-                    """
-                    INSERT INTO t_e_module_sections_item (
-                      id, tenant_id, property_id, sort_order, title_fr, title_en,
-                      content_fr, content_en, created_at, updated_at
-                    ) VALUES (?, ?, ?, ?, ?, ?, ?::jsonb, ?::jsonb, ?, ?)
-                    """,
-                    id,
-                    tenantId,
-                    propertyId,
-                    sortOrder,
-                    titleFr,
-                    titleEn,
-                    jsonOrNull(contentFr),
-                    jsonOrNull(contentEn),
-                    Instant.now(),
-                    Instant.now());
-        }
-
-    }
-
-    @PortakiCommandHandler(value = "sections.section.delete", scope = "host:property:write")
-    public void deleteSection(Map<String, Object> params, GatewayModuleContext ctx) {
-        UUID tenantId = ctx.tenantIdInternal();
-        UUID propertyId = UUID.fromString(ctx.propertyId());
-        String idRaw = stringParam(params, "id");
-        if (idRaw == null || idRaw.isBlank()) {
-            throw new IllegalArgumentException("id_required");
-        }
-        UUID id = UUID.fromString(idRaw);
-        int deleted =
-                jdbc.update(
-                        """
-                        DELETE FROM t_e_module_sections_item
-                        WHERE id = ? AND tenant_id = ? AND property_id = ?
-                        """,
-                        id,
-                        tenantId,
-                        propertyId);
-        if (deleted == 0) {
-            throw new IllegalArgumentException("section_not_found");
-        }
-    }
-
-    @PortakiCommandHandler(value = "sections.reorder", scope = "host:property:write")
-    public void reorder(Map<String, Object> params, GatewayModuleContext ctx) {
-        UUID tenantId = ctx.tenantIdInternal();
-        UUID propertyId = UUID.fromString(ctx.propertyId());
-        Object raw = params.get("orderedIds");
-        if (!(raw instanceof List<?> list) || list.isEmpty()) {
-            throw new IllegalArgumentException("ordered_ids_required");
-        }
-        int order = 0;
-        for (Object item : list) {
-            if (item == null) {
-                continue;
-            }
-            UUID id = UUID.fromString(item.toString());
-            jdbc.update(
-                    """
-                    UPDATE t_e_module_sections_item
-                    SET sort_order = ?, updated_at = ?
-                    WHERE id = ? AND tenant_id = ? AND property_id = ?
-                    """,
-                    order++,
-                    Instant.now(),
-                    id,
-                    tenantId,
-                    propertyId);
-        }
-    }
-
-    private Map<String, Object> toSectionRow(ResultSet rs) throws SQLException {
-        Map<String, Object> row = new HashMap<>();
-        row.put("id", rs.getObject("id", UUID.class).toString());
-        row.put("sortOrder", rs.getInt("sort_order"));
-        row.put("titleFr", rs.getString("title_fr"));
-        row.put("titleEn", rs.getString("title_en"));
-        row.put("contentFr", parseJsonColumn(rs.getString("content_fr")));
-        row.put("contentEn", parseJsonColumn(rs.getString("content_en")));
-        Instant updatedAt = rs.getObject("updated_at", Instant.class);
-        if (updatedAt != null) {
-            row.put("updatedAt", updatedAt.toString());
-        }
-        return row;
-    }
-
-    private Object parseJsonColumn(String raw) {
-        if (raw == null || raw.isBlank()) {
-            return null;
-        }
-        try {
-            return objectMapper.readValue(raw, Object.class);
-        } catch (JsonProcessingException e) {
-            return null;
-        }
-    }
-
-    private int nextSortOrder(UUID tenantId, UUID propertyId, UUID exceptId) {
-        Integer max =
-                jdbc.queryForObject(
-                        """
-                        SELECT COALESCE(MAX(sort_order), -1)
-                        FROM t_e_module_sections_item
-                        WHERE tenant_id = ? AND property_id = ? AND id <> ?
-                        """,
-                        Integer.class,
-                        tenantId,
-                        propertyId,
-                        exceptId);
-        return max == null ? 0 : max + 1;
-    }
-
-    private static String stringParam(Map<String, Object> params, String key) {
-        Object v = params.get(key);
-        return v == null ? null : v.toString();
-    }
-
-    private static int intParam(Map<String, Object> params, String key, int defaultValue) {
-        Object v = params.get(key);
-        if (v == null) {
-            return defaultValue;
-        }
-        if (v instanceof Number n) {
-            return n.intValue();
-        }
-        return Integer.parseInt(v.toString());
-    }
-
-    private JsonNode readJsonParam(Map<String, Object> params, String key) {
-        Object v = params.get(key);
-        if (v == null) {
-            return null;
-        }
-        return objectMapper.valueToTree(v);
-    }
-
-    private String jsonOrNull(JsonNode node) {
-        if (node == null || node.isNull()) {
-            return null;
-        }
-        try {
-            return objectMapper.writeValueAsString(node);
-        } catch (JsonProcessingException e) {
-            throw new IllegalArgumentException("invalid_json", e);
-        }
-    }
-}

package/backend/src/main/java/app/portaki/module/sections/SectionsModuleBackendConfiguration.java

@@ -1,8 +0,0 @@
-package app.portaki.module.sections;
-
-import org.springframework.context.annotation.ComponentScan;
-import org.springframework.context.annotation.Configuration;
-
-@Configuration
-@ComponentScan(basePackageClasses = SectionsGatewayModule.class)
-public class SectionsModuleBackendConfiguration {}

package/backend/target/maven-archiver/pom.properties

@@ -1,3 +0,0 @@
-artifactId=sections-backend
-groupId=app.portaki.module
-version=0.1.0

package/backend/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst

@@ -1,2 +0,0 @@
-app/portaki/module/sections/SectionsGatewayModule.class
-app/portaki/module/sections/SectionsModuleBackendConfiguration.class

package/backend/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst

@@ -1,2 +0,0 @@
-/Users/cyrilcolinet/Documents/Projects/PortakiApp/Repositories/portaki-modules/modules/sections/backend/src/main/java/app/portaki/module/sections/SectionsGatewayModule.java
-/Users/cyrilcolinet/Documents/Projects/PortakiApp/Repositories/portaki-modules/modules/sections/backend/src/main/java/app/portaki/module/sections/SectionsModuleBackendConfiguration.java

package/db/README.md

@@ -1,8 +0,0 @@
-# Schéma `sections`
-
-- **Propriété** : module `sections` (`app.portaki.module.sections`).
-- **Source de vérité** : `schema.sql` dans ce dossier.
-- **Application aujourd’hui** : copie versionnée dans `portaki-api/.../db/migration/V58__module_sections_items.sql` (Flyway unique sur la base core).
-- **Cible** : job **Atlas** / `portaki-module-migrator` (schéma Postgres dédié ou préfixe module) — voir `portaki-internal-docs/MODULE_PLATFORM_PREPARATION.md`.
-
-Ne pas ajouter d’entités JPA pour ce module dans `portaki-api` : persistance dans `backend/` uniquement.

package/db/schema.sql

@@ -1,18 +0,0 @@
--- Canonical DDL for module `sections` (review in portaki-modules).
--- Runtime: copied to portaki-api Flyway until Atlas module migrator exists.
-
-CREATE TABLE t_e_module_sections_item (
-    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    tenant_id UUID NOT NULL REFERENCES t_e_tenants (id),
-    property_id UUID NOT NULL REFERENCES t_e_properties (id) ON DELETE CASCADE,
-    sort_order INT NOT NULL DEFAULT 0,
-    title_fr TEXT NOT NULL DEFAULT '',
-    title_en TEXT NOT NULL DEFAULT '',
-    content_fr JSONB,
-    content_en JSONB,
-    created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-    updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-);
-
-CREATE INDEX t_e_module_sections_item_property_idx
-    ON t_e_module_sections_item (tenant_id, property_id);