strapi-content-sync-pro 1.0.2 → 1.0.3

package/admin/src/components/SyncTab.jsx

@@ -53,6 +53,7 @@ const SyncTab = () => {
   const [executionStatus, setExecutionStatus] = useState([]);
   const [globalSettings, setGlobalSettings] = useState({});
   const [loading, setLoading] = useState(true);
+  const [syncMode, setSyncMode] = useState('paired');
 
   // Filter and ordering
   const [profileFilter, setProfileFilter] = useState('all');
@@ -84,17 +85,19 @@ const SyncTab = () => {
 
   const loadData = async () => {
     try {
-      const [profilesRes, statusRes, globalRes, depsRes] = await Promise.all([
+      const [profilesRes, statusRes, globalRes, depsRes, configRes] = await Promise.all([
         get(`/${PLUGIN_ID}/sync-profiles`),
         get(`/${PLUGIN_ID}/sync-execution/status`),
         get(`/${PLUGIN_ID}/sync-execution/global-settings`),
         get(`/${PLUGIN_ID}/dependencies/all`).catch(() => ({ data: { data: {} } })),
+        get(`/${PLUGIN_ID}/config`),
       ]);
       const loadedProfiles = profilesRes.data.data || [];
       setProfiles(loadedProfiles);
       setExecutionStatus(statusRes.data.data || []);
       setGlobalSettings(globalRes.data.data || {});
       setDependencies(depsRes.data.data || {});
+      setSyncMode(configRes?.data?.data?.syncMode || 'paired');
 
       // Load saved execution order or calculate from dependencies
       const savedOrder = globalRes.data.data?.executionOrder || {};
@@ -325,7 +328,7 @@ const SyncTab = () => {
   const openSettingsModal = async (profileId) => {
     try {
       const res = await get(`/${PLUGIN_ID}/sync-execution/settings/${profileId}`);
-      setExecutionSettings(res.data.data || {
+      const settings = res.data.data || {
         executionMode: 'on_demand',
         scheduleType: 'interval',
         scheduleInterval: 60,
@@ -333,7 +336,15 @@ const SyncTab = () => {
         enabled: false,
         syncDependencies: false,
         dependencyDepth: 1,
-      });
+      };
+
+      const profile = profiles.find((p) => p.id === profileId);
+      if (profile && profile.syncDeletions && settings.executionMode === 'live') {
+        settings.executionMode = 'on_demand';
+        settings.enabled = false;
+      }
+
+      setExecutionSettings(settings);
       setSelectedProfile(profileId);
       setSettingsModalOpen(true);
     } catch (err) {
@@ -343,7 +354,19 @@ const SyncTab = () => {
 
   const handleSaveExecutionSettings = async () => {
     try {
-      await put(`/${PLUGIN_ID}/sync-execution/settings/${selectedProfile}`, executionSettings);
+      const payload = { ...executionSettings };
+      if (syncMode === 'single_side' && payload.executionMode === 'live') {
+        payload.executionMode = 'on_demand';
+        payload.enabled = false;
+      }
+
+      const selected = profiles.find((p) => p.id === selectedProfile);
+      if (selected?.syncDeletions && payload.executionMode === 'live') {
+        payload.executionMode = 'on_demand';
+        payload.enabled = false;
+      }
+
+      await put(`/${PLUGIN_ID}/sync-execution/settings/${selectedProfile}`, payload);
       setMessage({ type: 'success', text: 'Execution settings saved' });
       setSettingsModalOpen(false);
       loadData();
@@ -441,6 +464,22 @@ const SyncTab = () => {
                 </Flex>
               </Flex>
 
+              {syncMode === 'single_side' && (
+                <Box paddingTop={4}>
+                  <Alert variant="info" title="Single-side mode restrictions">
+                    Live execution is disabled in single-side mode. Use on-demand or scheduled execution with pull-only profiles.
+                  </Alert>
+                </Box>
+              )}
+
+              {profiles.some((p) => p.syncDeletions) && (
+                <Box paddingTop={4}>
+                  <Alert variant="info" title="Deletion sync profile rules">
+                    Profiles with deletion sync enabled run as explicit one-way operations. Avoid live mode for these profiles.
+                  </Alert>
+                </Box>
+              )}
+
               {message && (
                 <Box paddingTop={4}>
                   <Alert variant={message.type} closeLabel="Close" onClose={() => setMessage(null)}>
@@ -474,7 +513,7 @@ const SyncTab = () => {
                       value={profileFilter}
                       onChange={setProfileFilter}
                       size="S"
-                      style={{ width: 150 }}
+                      style={{ width: 180 }}
                     >
                       {FILTER_OPTIONS.map(opt => (
                         <SingleSelectOption key={opt.value} value={opt.value}>
@@ -570,7 +609,7 @@ const SyncTab = () => {
                                     <ArrowDown />
                                   </IconButton>
                                 </Flex>
-                                <TextInput
+                                <TextInput 
                                   value={order}
                                   onChange={(e) => handleOrderChange(profile.id, e.target.value)}
                                   style={{ width: 50, textAlign: 'center' }}
@@ -849,7 +888,11 @@ const SyncTab = () => {
                     onChange={(value) => setExecutionSettings((p) => ({ ...p, executionMode: value }))}
                   >
                     {EXECUTION_MODE_OPTIONS.map((opt) => (
-                      <SingleSelectOption key={opt.value} value={opt.value}>
+                      <SingleSelectOption
+                        key={opt.value}
+                        value={opt.value}
+                        disabled={syncMode === 'single_side' && opt.value === 'live'}
+                      >
                         {opt.label}
                       </SingleSelectOption>
                     ))}
@@ -858,6 +901,7 @@ const SyncTab = () => {
                     {executionSettings.executionMode === 'on_demand' && 'Sync only when manually triggered'}
                     {executionSettings.executionMode === 'scheduled' && 'Sync automatically at regular intervals'}
                     {executionSettings.executionMode === 'live' && 'Sync immediately when changes occur'}
+                    {syncMode === 'single_side' && executionSettings.executionMode === 'live' && ' (not supported in single-side mode)'}
                   </Field.Hint>
                 </Field.Root>
               </Box>

package/admin/src/pages/App/index.jsx

@@ -6,6 +6,7 @@ import { ConfigTab } from '../../components/ConfigTab';
 import { ContentTypesTab } from '../../components/ContentTypesTab';
 import { SyncTab } from '../../components/SyncTab';
 import { LogsTab } from '../../components/LogsTab';
+import { StatsTab } from '../../components/StatsTab';
 import { HelpTab } from '../../components/HelpTab';
 import { SyncProfilesTab } from '../../components/SyncProfilesTab';
 import { MediaTab } from '../../components/MediaTab';
@@ -16,6 +17,7 @@ const TABS = [
     { key: 'sync-profiles', label: 'Sync Profiles' },
     { key: 'sync', label: 'Sync' },
     { key: 'media', label: 'Media' },
+    { key: 'stats', label: 'Stats' },
     { key: 'logs', label: 'Logs' },
     { key: 'help', label: 'Help' },
 ];
@@ -50,6 +52,7 @@ const HomePage = () => {
                 {activeTab === 'sync-profiles' && <SyncProfilesTab />}
                 {activeTab === 'sync' && <SyncTab />}
                 {activeTab === 'media' && <MediaTab />}
+                {activeTab === 'stats' && <StatsTab />}
                 {activeTab === 'logs' && <LogsTab />}
                 {activeTab === 'help' && <HelpTab />}
 

package/docs/production-readiness-status.md

@@ -0,0 +1,34 @@
+# Production Readiness Status — Content Sync Pro
+
+## Current Verdict
+**NO-GO (not yet fully production-ready)**
+
+## Completed
+- Implemented paired/single-side mode behavior and enforcement.
+- Implemented Stats tab + before/after run reports.
+- Implemented manual clear + retention limits for logs/reports.
+- Added production-readiness test matrix:
+  - `docs/production-readiness-test-matrix.md`
+- Added legacy environment notes copy:
+  - `docs/test-environments-setup-legacy.txt`
+
+## Smoke Checks Passed
+- `GET http://localhost:40101/api/strapi-content-sync-pro/ping` => 200
+- `GET http://localhost:4010/api/strapi-content-sync-pro/ping` => 200
+- Package test script passes (`npm run test`) — placeholder only.
+
+## Blocking Items Before GO
+1. Execute full P0 and P1 matrix scenarios in `docs/production-readiness-test-matrix.md`.
+2. Capture evidence for each case (request/response, DB/file verification, screenshots).
+3. Verify restart/recovery after plugin copy in target runtime path.
+4. Validate single-side mode with remote plugin disabled.
+5. Validate media restore scenarios after partial deletions.
+6. Confirm retention pruning under load (high log/report volume).
+
+## Required Release Gate
+- P0 cases: 100% pass
+- P1 cases: pass or accepted risk signed off
+- No open critical defects
+
+## Recommended Next Action
+Run matrix execution in order: P0 -> P1 -> P2, then update this file with final **GO/NO-GO** sign-off.

package/docs/production-readiness-test-matrix.md

@@ -0,0 +1,151 @@
+# Content Sync Pro — Production Readiness Test Matrix
+
+This guide converts the environment notes from `test-enviroments-setup.txt` into a structured, repeatable validation matrix for release readiness.
+
+## 1) Test Environments
+
+### Remote Server
+- Start:
+  - `D:\Rutba\ERP> npm run dev:strapi`
+- URL: `http://localhost:4010`
+- DB: MySQL (`pos_db`)
+- Upload dir: `D:\Rutba\data\rutba-pos-files\uploads`
+
+### Local Server
+- Start:
+  - `D:\Rutba\ERP\pos-strapi> npm run dev`
+- URL: `http://localhost:40101`
+- DB: MySQL (`rutba_pos`)
+- Upload dir: `D:\Rutba\data\rutba-pos-files\tmp\uploads`
+
+### Shared Notes
+- Same Strapi codebase, different `.env` values.
+- Admin credentials (both):
+  - Email: `eharain@yahoo.com`
+  - Password: `At56ZNTxXf6JSTq`
+- Plugin deploy target to test runtime updates:
+  - `D:\Rutba\ERP\pos-strapi\src\plugins\strapi-content-sync-pro`
+- Restart may be required after plugin copy/update.
+
+## 2) Scope of Validation
+
+- Paired mode (plugin installed both sides)
+- Single-side mode (plugin active on local only)
+- Profiles (simple + advanced), dependency depth, execution modes
+- Entity sync (CMS content, products, orders)
+- Media sync + entity-linked media
+- Stats tab snapshots and before/after reports
+- Log/report retention and cleanup controls
+- Failure/recovery behavior
+
+## 3) Pass/Fail Exit Criteria
+
+A build is **production-ready** only if all are true:
+- Critical test cases pass (P0/P1 below)
+- No data corruption in local/remote DBs
+- No orphaned media references after sync runs
+- Stats/report data is generated and retention controls work
+- Plugin starts cleanly after restart in tested configurations
+
+## 4) Test Matrix
+
+| ID | Priority | Area | Scenario | Setup | Steps | Expected Result | Status | Evidence |
+|---|---|---|---|---|---|---|---|---|
+| P0-01 | P0 | Health | Plugin ping reachable both servers (paired) | Both running with plugin enabled | Call `/api/strapi-content-sync-pro/ping` on :40101 and :4010 | HTTP 200 + `{ "status": "ok" }` | TODO |  |
+| P0-02 | P0 | Connection | Connection test in paired mode | Local configured to remote | Run **Test Connection** in Configuration tab | Success, plugin endpoint validated | TODO |  |
+| P0-03 | P0 | Single-side | Connection test in single-side mode | Disable remote plugin load via env | Set local mode `single_side`, run Test Connection | Success without requiring remote plugin routes | TODO |  |
+| P0-04 | P0 | Profiles | Pull-only enforcement in single-side | Local mode `single_side` | Try creating push/bidirectional profile | UI/API enforce pull-only | TODO |  |
+| P0-05 | P0 | Execution | Live mode blocked in single-side | Local mode `single_side` | Try saving execution mode `live` | Rejected or normalized to non-live | TODO |  |
+| P0-06 | P0 | Data | Orders remote → local sync | Create new orders on remote | Run local pull/sync | Orders and order details appear local | TODO |  |
+| P0-07 | P0 | Data | CMS/offers local → remote sync (paired) | Create CMS/offers local | Run push/bidirectional | Entries appear remote correctly | TODO |  |
+| P0-08 | P0 | Media | Entity-linked media sync | Attach media to products/CMS | Run sync profile + media sync | Files + DB refs consistent on target | TODO |  |
+| P0-09 | P0 | Stats | Pre/post run report generation | Any enabled content types | Trigger sync run | Stats report contains before/after snapshots | TODO |  |
+| P0-10 | P0 | Retention | Manual clear logs/reports | Existing logs/reports | Use clear actions in Stats tab | Data removed, UI refreshed | TODO |  |
+| P1-01 | P1 | Dependencies | Min depth profile run | Profile depth=1 | Run profile | Only first-level dependencies handled | TODO |  |
+| P1-02 | P1 | Dependencies | Max depth profile run | Profile depth=5 | Run profile | Deep dependencies handled; no crash | TODO |  |
+| P1-03 | P1 | Media Recovery | Recreate deleted local media from remote | Delete selected local media rows/files | Run downward sync | Missing media restored | TODO |  |
+| P1-04 | P1 | Conflict | Latest/local/remote strategy behavior | Divergent edits both sides | Run with each strategy | Winner follows selected policy | TODO |  |
+| P1-05 | P1 | Restart | Restart resilience | Update plugin files + restart | Restart both servers | Plugin loads without route/service errors | TODO |  |
+| P1-06 | P1 | Retention Auto | Pruning by max entries | Set low limits | Trigger retention run | Old logs/reports pruned to limit | TODO |  |
+| P2-01 | P2 | Performance | Large dataset pagination behavior | Seed high row count | Run sync with page-size variations | Completes with bounded memory/errors | TODO |  |
+| P2-02 | P2 | UX | Stats readability | Run several syncs | Review report history | Clear before/after trend visibility | TODO |  |
+
+## 5) Detailed Execution Checklist
+
+### A. Baseline + Connectivity
+1. Confirm both servers are running.
+2. Verify paired mode ping endpoints.
+3. Configure local plugin connection settings.
+4. Validate **Test Connection** in paired mode.
+
+### B. Single-side Mode
+1. Disable plugin loading on remote using env flag.
+2. Keep local plugin enabled.
+3. Set local `syncMode = single_side`.
+4. Run connection test and verify success without remote plugin route dependency.
+5. Verify profile direction and execution mode restrictions.
+
+### C. Data Sync Scenarios
+1. Create products with variations on source side; sync and verify target.
+2. Create orders on remote; pull to local and verify details.
+3. Create CMS content/offers local; push to remote and verify.
+4. Run scenarios with different conflict strategies.
+
+### D. Media Scenarios
+1. Upload media and attach to products/CMS entities.
+2. Sync and verify both file presence and DB links.
+3. Delete a subset of local media rows/files.
+4. Re-run downward sync; confirm restoration.
+
+### E. Stats + Retention
+1. Trigger sync; confirm report with before/after snapshots appears.
+2. Verify columns: local/remote count, newest timestamps, newest side.
+3. Use manual clear for logs and reports.
+4. Configure low retention limits and run retention; verify pruning.
+
+### F. Restart/Recovery
+1. Copy plugin changes into Strapi plugin destination.
+2. Restart both instances.
+3. Re-check critical routes and one sync run.
+
+## 6) Evidence Template
+
+For each executed case, capture:
+- Timestamp
+- Server mode (paired/single-side)
+- Profile ID/name and execution mode
+- Request/response snippets (or screenshots)
+- DB/file verification notes
+- Result: Pass/Fail + defect link
+
+Example note:
+- `P0-09` | `2026-04-21 10:20` | `Pass`
+- Report ID: `...`
+- Before: products local=120 remote=115 newest=local
+- After: products local=120 remote=120 newest=equal
+
+## 7) Defect Severity Guidance
+
+- **Critical**: Data loss/corruption, wrong direction writes, plugin cannot start
+- **High**: Core sync path broken for common scenario
+- **Medium**: Stats/reporting incorrect but sync still reliable
+- **Low**: UI copy/formatting issues
+
+## 8) Go/No-Go Summary
+
+- Total cases executed:
+- Passed:
+- Failed:
+- Blocked:
+- Critical open defects:
+- Decision: **GO / NO-GO**
+
+---
+
+## Current Session Smoke Result
+
+- Ping local (`:40101`) = PASS
+- Ping remote (`:4010`) = PASS
+- Package test script (`npm run test`) = PASS (`No tests yet` placeholder)
+
+A full production readiness sign-off requires completion of the matrix above.

package/docs/test-environments-setup-legacy.txt

@@ -0,0 +1,60 @@
+
+Remote server :
+D:\>cd d:\Rutba\ERP
+D:\Rutba\ERP>npm run dev:strapi
+
+ Database           = mysql                                            
+ Database name      = pos_db                                           
+ URL= http://localhost:4010
+ Upload dir  =D:\Rutba\data\rutba-pos-files\uploads
+
+
+
+
+Local Server:
+D:\Rutba\ERP>cd pos-strapi
+D:\Rutba\ERP\pos-strapi>npm run dev
+http://localhost:40101
+
+Database         =   mysql                                            │
+Database name    =   rutba_pos 
+Upload Dir = D:\Rutba\data\rutba-pos-files\tmp\uploads
+
+these two servers have same code base of strapi but are running using different .env settings 
+
+you can truncate or partially delete any of their database tables or enteries as well as files. 
+
+
+
+Please note that when the files are copied over the instance try to reboot but any of these can fail to start so you will have to restart.  the restart takes about a minutes each time.
+
+
+Both the servers admin user : eharain@yahoo.com and password : At56ZNTxXf6JSTq
+
+kindly test different settings and different variations and ensure that the plugin works as desired.
+
+the current servers are running in command prompt and you can stop them by pressing ctrl+c and start them again using the above commands. you can run these servers in you own power shels if you want.
+the servers will not restrt unloss you copy the code changes in destination drrectory of the plugin that is :D:\Rutba\ERP\pos-strapi\src\plugins\strapi-content-sync-pro
+
+to understand the entites read the contents of any server or in src directory of the strapi.
+
+to test  single-side mode disable the plugin loading by a special enviromment variable so that specific spin of strapi will not load the plugin and then you can test the sync in one direction.
+
+Tests: 
+kindly create different sync profiles with least and max dependiceis and depth and try executing them.
+
+kindly few media files and then sync also upload connect to entites and then sync and check if the media files are also synced properly with the entities.
+
+Please also test the sync with different data in the tables and check if the sync is working as expected.
+
+insert test data specially cms entites and then sync and check if the data is synced properly in the destination server.
+
+create products and test the sync with different variations of products and check if the products are synced properly in the destination server.
+
+create orders and test the sync with different variations of orders and check if the orders are synced properly in the destination server.
+
+the orders will be created on remote server and should be synced to local server and then you can check the orders in local server and also check the order details and the products in the order and the media files connected to the products in the order.
+
+the cms contenst and offers are created on local servers and set to remote server and then you can check the cms content and offers in remote server and also check the media files connected to the cms content and offers.
+
+complete remove media enteries and few files on local server and then sync downward and check if these are created again. simmilar create new media each side and sync across. 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strapi-content-sync-pro",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Strapi v5 plugin to copy, migrate, and live-sync content, media, and data between multiple Strapi environments with bi-directional sync, field-level policies, scheduling, and alerts.",
   "license": "MIT",
   "author": {

package/server/src/content-types/index.js

@@ -1,7 +1,9 @@
 'use strict';
 
 const syncLogSchema = require('./sync-log/schema.json');
+const syncRunReportSchema = require('./sync-run-report/schema.json');
 
 module.exports = {
   'sync-log': { schema: syncLogSchema },
+  'sync-run-report': { schema: syncRunReportSchema },
 };

package/server/src/content-types/sync-run-report/schema.json

@@ -0,0 +1,26 @@
+{
+  "kind": "collectionType",
+  "collectionName": "sync_run_reports",
+  "info": {
+    "singularName": "sync-run-report",
+    "pluralName": "sync-run-reports",
+    "displayName": "Sync Run Report"
+  },
+  "options": {},
+  "pluginOptions": {
+    "content-manager": { "visible": false },
+    "content-type-builder": { "visible": false }
+  },
+  "attributes": {
+    "runType": { "type": "string" },
+    "trigger": { "type": "string" },
+    "status": { "type": "string" },
+    "startedAt": { "type": "datetime" },
+    "completedAt": { "type": "datetime" },
+    "contentTypes": { "type": "json" },
+    "beforeStats": { "type": "json" },
+    "afterStats": { "type": "json" },
+    "summary": { "type": "json" },
+    "error": { "type": "text" }
+  }
+}

package/server/src/controllers/config.js

@@ -38,8 +38,50 @@ module.exports = {
       };
     }
 
-    // Step 1: Basic reachability via public ping endpoint
+    const syncMode = config.syncMode || 'paired';
+
+    // Step 1: Basic reachability
     const startTime = Date.now();
+    if (syncMode === 'single_side') {
+      try {
+        const reachRes = await fetch(`${config.baseUrl}/api`, {
+          method: 'GET',
+          headers: { Authorization: `Bearer ${config.apiToken}` },
+        });
+
+        if (reachRes.status === 401 || reachRes.status === 403) {
+          return ctx.body = {
+            data: {
+              success: false,
+              stage: 'auth',
+              message: `API token rejected by remote server (${reachRes.status}). Verify the token is valid and can read target content APIs.`,
+              latency: Date.now() - startTime,
+            },
+          };
+        }
+      } catch (err) {
+        return ctx.body = {
+          data: {
+            success: false,
+            stage: 'network',
+            message: `Cannot reach remote server in single-side mode: ${err.message}`,
+            latency: Date.now() - startTime,
+          },
+        };
+      }
+
+      return ctx.body = {
+        data: {
+          success: true,
+          stage: 'complete',
+          message: 'Connection successful in single-side mode. Remote plugin endpoints are not required; only remote content APIs and token access are validated.',
+          latency: Date.now() - startTime,
+          remoteInfo: null,
+          mode: syncMode,
+        },
+      };
+    }
+
     let pingStatus = null;
     try {
       const pingRes = await fetch(`${config.baseUrl}/api/${PLUGIN_ID}/ping`, {
@@ -69,7 +111,7 @@ module.exports = {
 
     const pingLatency = Date.now() - startTime;
 
-    // Step 2: Verify API token works against an authenticated endpoint
+    // Step 2: Verify API token works against an authenticated plugin endpoint
     let authWorks = false;
     let remoteInfo = null;
     try {
@@ -116,10 +158,11 @@ module.exports = {
         success: true,
         stage: 'complete',
         message: authWorks
-          ? 'Connection successful and API token validated'
+          ? 'Connection successful: remote plugin is reachable and API token is valid. Ensure matching sync settings (content types, active profiles, execution mode, and shared secret) on both servers before running sync.'
           : 'Reachable but API token could not be validated',
         latency: pingLatency,
         remoteInfo,
+        mode: syncMode,
       },
     };
   },
@@ -251,10 +294,10 @@ module.exports = {
       // Step 4: Optionally get remote instance ID if plugin is installed
       let remoteInstanceId = null;
       try {
-        const remoteConfigResponse = await fetch(`${baseUrl}/api/${PLUGIN_ID}/config`, {
+        const remoteConfigResponse = await fetch(`${baseUrl}/strapi-content-sync-pro/config`, {
           method: 'GET',
           headers: {
-            Authorization: `Bearer ${apiToken}`,
+            Authorization: `Bearer ${adminJwt}`,
           },
         });
 

package/server/src/controllers/index.js

@@ -12,6 +12,7 @@ const syncEnforcement = require('./sync-enforcement');
 const syncMedia = require('./sync-media');
 const alerts = require('./alerts');
 const dependencies = require('./dependencies');
+const syncStats = require('./sync-stats');
 
 module.exports = {
   ping,
@@ -26,4 +27,5 @@ module.exports = {
   syncMedia,
   alerts,
   dependencies,
+  syncStats,
 };

package/server/src/controllers/sync-log.js

@@ -15,4 +15,10 @@ module.exports = {
 
     ctx.body = result;
   },
+
+  async clear(ctx) {
+    const service = strapi.plugin('strapi-content-sync-pro').service('syncLog');
+    const result = await service.clearLogs();
+    ctx.body = { data: result };
+  },
 };

package/server/src/controllers/sync-media.js

@@ -111,6 +111,25 @@ module.exports = ({ strapi }) => ({
     }
   },
 
+  // ── Morph link sync (documentId-based mapping) ───────────────────────────
+
+  async getMorphLinks(ctx) {
+    try {
+      ctx.body = { data: await service(strapi).exportMorphLinks() };
+    } catch (err) {
+      ctx.throw(500, err.message);
+    }
+  },
+
+  async applyMorphLinks(ctx) {
+    try {
+      const links = ctx.request.body?.links || [];
+      ctx.body = { data: await service(strapi).applyMorphLinks(links) };
+    } catch (err) {
+      ctx.throw(400, err.message);
+    }
+  },
+
   // ── Back-compat (old flat endpoints) ──────────────────────────────────────
 
   async getSettings(ctx) {

package/server/src/controllers/sync-stats.js

@@ -0,0 +1,51 @@
+'use strict';
+
+const PLUGIN_ID = 'strapi-content-sync-pro';
+
+module.exports = ({ strapi }) => ({
+  async getSnapshot(ctx) {
+    try {
+      const data = await strapi.plugin(PLUGIN_ID).service('syncStats').getLatestSnapshot();
+      ctx.body = { data };
+    } catch (err) {
+      ctx.throw(500, err.message);
+    }
+  },
+
+  async getReports(ctx) {
+    const { page, pageSize } = ctx.query;
+    try {
+      const data = await strapi.plugin(PLUGIN_ID).service('syncStats').getReports({
+        page: page ? parseInt(page, 10) : 1,
+        pageSize: pageSize ? parseInt(pageSize, 10) : 10,
+      });
+      ctx.body = data;
+    } catch (err) {
+      ctx.throw(500, err.message);
+    }
+  },
+
+  async clearReports(ctx) {
+    try {
+      const result = await strapi.plugin(PLUGIN_ID).service('syncStats').clearReports();
+      ctx.body = { data: result };
+    } catch (err) {
+      ctx.throw(500, err.message);
+    }
+  },
+
+  async runRetention(ctx) {
+    const body = ctx.request.body || {};
+    try {
+      const syncStats = strapi.plugin(PLUGIN_ID).service('syncStats');
+      const syncLog = strapi.plugin(PLUGIN_ID).service('syncLog');
+      const reports = await syncStats.applyRetention({ maxReports: body.maxReports });
+      const logs = await syncLog.applyRetention({ maxLogs: body.maxLogs });
+      ctx.body = { data: { reports, logs } };
+    } catch (err) {
+      ctx.throw(400, err.message);
+    }
+  },
+
+
+});

package/server/src/controllers/sync.js

@@ -15,14 +15,20 @@ module.exports = {
   async receive(ctx) {
     const { body } = ctx.request;
 
-    if (!body || !body.uid || !body.syncId) {
-      return ctx.badRequest('Missing uid, data, or syncId');
+    if (!body || !body.uid || (!body.syncId && !body.documentId)) {
+      return ctx.badRequest('Missing uid, data, or documentId/syncId');
     }
 
     const syncService = strapi.plugin('strapi-content-sync-pro').service('sync');
 
     try {
-      const result = await syncService.receiveRecord(body.uid, body.data || {}, body.syncId);
+      const result = await syncService.receiveRecord(
+        body.uid,
+        body.data || {},
+        body.syncId || null,
+        !!body.delete,
+        body.documentId || null,
+      );
       ctx.body = { data: result };
     } catch (err) {
       return ctx.badRequest(err.message);