mirror of https://github.com/johannesjo/super-productivity.git synced 2026-07-18 00:46:45 +00:00

History

Johannes Millan b8be00d526 refactor(sync): decompose SuperSync server giants into cohesive modules Split the three oversized SuperSync-server files into focused, single-responsibility modules behind thin SyncService / SnapshotService facades. Behavior, public API, HTTP/wire contract and DB schema are unchanged (verbatim moves). - sync.service.ts 2322 -> ~660, sync.routes.ts 1475 -> ~445, snapshot.service.ts 1215 -> ~390 LOC - src/sync/op-replay.ts: pure replay engine (no Prisma) - src/sync/conflict.ts: conflict detection + resolution - src/sync/sync.routes.payload.ts / .quota.ts: HTTP helper modules - src/sync/sync.routes.ops-handler.ts / .snapshot-handler.ts: POST handlers - services/operation-upload.service.ts: upload pipeline (runs inside the caller's prisma.$transaction; tx threaded, never opens its own) - services/snapshot-generation.service.ts: snapshot replay/generation - StorageQuotaService gains quota-driven eviction; DeviceService gains stale-device cleanup; shared upload/conflict types -> sync.types - EncryptedOpsNotSupportedError re-exported from snapshot.service for identity-stable instanceof in sync.routes - new op-replay.spec.ts / conflict.spec.ts; sanctioned private-spy re-points only (no behavioral spec changes) - includes the decomposition plan (docs/plans) and dead-weight cleanup Verified: tsc --noEmit clean; 717 tests pass / 5 skipped (35 files); checkFile + lint clean. Multi-reviewed (7 agents): behavior-faithful, all sync-correctness invariants preserved. Known gap: route-handler + multi-client integration specs are config-excluded (stale legacy / Postgres-only) and were not executed here — run integration in CI before merge.		2026-05-15 20:06:12 +02:00
..
plugin-api	Plugin tag ids (#7582 )	2026-05-15 01:36:07 +02:00
plugin-dev	fix(calendar): stop Google time-block sync hitting the write rate limit	2026-05-15 17:02:08 +02:00
shared-schema	build: ignore files	2026-05-13 19:59:02 +02:00
super-sync-server	refactor(sync): decompose SuperSync server giants into cohesive modules	2026-05-15 20:06:12 +02:00
sync-core	refactor(sync): post-extraction review cleanup of @sp/sync-core and @sp/sync-providers (#7595 )	2026-05-14 13:06:08 +02:00
sync-providers	fix(sync): preserve WebDAV credentials on transient auth error	2026-05-15 16:51:50 +02:00
vite-plugin	chore(deps): bump the npm_and_yarn group across 1 directory with 9 updates (#7259 )	2026-04-18 20:35:50 +02:00
build-packages.js	refactor(sync-providers): scaffold provider package	2026-05-12 19:14:12 +02:00
README.md	feat: cleanup and update plugins 2	2025-06-29 06:36:02 +02:00

README.md

Super Productivity Packages

This directory contains plugin packages and the plugin API for Super Productivity.

Structure

plugin-api/ - TypeScript definitions for the plugin API
plugin-dev/ - Plugin development examples and tools
- api-test-plugin/ - Basic API test plugin
- procrastination-buster/ - Example SolidJS-based plugin
- yesterday-tasks-plugin/ - Simple plugin showing yesterday's tasks
- boilerplate-solid-js/ - Template for creating new SolidJS plugins (not built)
- sync-md/ - Markdown sync plugin (not built)

Building Packages

All packages are built automatically when running the main build process:

npm run build:packages

This command:

Builds the plugin-api TypeScript definitions
Builds plugins that require compilation (e.g., procrastination-buster)
Copies plugin files to src/assets/ for inclusion in the app

Development

To work on a specific plugin:

cd plugin-dev/[plugin-name]
npm install
npm run dev

Adding a New Plugin

Create a new directory in plugin-dev/
Add the plugin configuration to /packages/build-packages.js
Run npm run build:packages to test the build

Notes

The boilerplate-solid-js and sync-md plugins are development templates and are not included in production builds
Plugin files are automatically copied to src/assets/ during the build process
The build script handles dependency installation automatically