Skip to content

Open source personal finance application

docs: rename offline-queue reference to offline-first and drop dead-mechanism references

Ilya Komichevf4bd6eb19c23
diff --git a/docs/content/en/3.reference/01.architecture.md b/docs/content/en/3.reference/01.architecture.md
index 66f6f9e9..2c9294c7 100644
--- a/docs/content/en/3.reference/01.architecture.md
+++ b/docs/content/en/3.reference/01.architecture.md
@@ -204,4 +204,4 @@ The mobile transaction form uses a custom `BottomSheet` component with `useBotto
## Next Steps
- [Sync](/en/reference/sync) - how PowerSync syncs data between server and local SQLite
-- [Offline-first](/en/reference/offline-queue) - offline writes, upload queue, and error handling
+- [Offline-first](/en/reference/offline-first) - offline writes, upload queue, and error handling
diff --git a/docs/content/en/3.reference/03.sync.md b/docs/content/en/3.reference/03.sync.md
index 531f92a5..877f94f9 100644
--- a/docs/content/en/3.reference/03.sync.md
+++ b/docs/content/en/3.reference/03.sync.md
@@ -111,5 +111,5 @@ PowerSync syncs hard deletes natively - when a row is deleted on the server the
## Next Steps
-- [Offline-first](/en/reference/offline-queue) - offline writes, upload queue, and fatal error handling
+- [Offline-first](/en/reference/offline-first) - offline writes, upload queue, and fatal error handling
- [Architecture](/en/reference/architecture) - app initialization and store pattern
diff --git a/docs/content/en/3.reference/04.offline-queue.md b/docs/content/en/3.reference/04.offline-first.md
similarity index 91%
rename from docs/content/en/3.reference/04.offline-queue.md
rename to docs/content/en/3.reference/04.offline-first.md
index 323a4e51..5ecf11f1 100644
--- a/docs/content/en/3.reference/04.offline-queue.md
+++ b/docs/content/en/3.reference/04.offline-first.md
@@ -59,11 +59,11 @@ The server enforces no foreign key constraints (PowerSync upload order is not gu
Every store write snapshots `prev = items.value` before mutating. If the local SQLite write throws, `items.value = prev` is restored and an error toast is shown. This covers local write errors (e.g., SQLite constraint, disk full). Server-rejection errors (RLS, constraint) are handled separately by the upload-error handler.
-## No Manual Offline Queue
+## No Manual Queue
-The hand-written offline queue (`components/offline/helpers.ts`, `replay.ts`, `replayHelpers.ts`, `types.ts`) and the `local_`-prefix frontend ID system have been removed. PowerSync provides the upload queue natively. There is no `replay()`, no `mergeOfflineOps()`, no `cleanupFrontendIds()`, and no ID remapping.
+PowerSync owns the upload queue natively - there is no hand-written queue, no replay step, no op-merging, and no frontend ID remapping.
-Client IDs are regular UUIDs (generated client-side via `crypto.randomUUID()` or equivalent). They are stable and do not need remapping after upload.
+Client IDs are regular UUIDs (generated client-side via `crypto.randomUUID()` or equivalent). They are stable and serve as the permanent primary key on both device and server, so nothing needs remapping after upload.
## Key Files
diff --git a/docs/content/ru/3.reference/01.architecture.md b/docs/content/ru/3.reference/01.architecture.md
index 292042f8..4740cec2 100644
--- a/docs/content/ru/3.reference/01.architecture.md
+++ b/docs/content/ru/3.reference/01.architecture.md
@@ -204,4 +204,4 @@ signOut()
## Следующие шаги
- [Синхронизация](/ru/reference/sync) - как PowerSync синхронизирует данные между сервером и локальной SQLite
-- [Офлайн-first](/ru/reference/offline-queue) - офлайн-записи, очередь загрузки и обработка ошибок
+- [Офлайн-first](/ru/reference/offline-first) - офлайн-записи, очередь загрузки и обработка ошибок
diff --git a/docs/content/ru/3.reference/03.sync.md b/docs/content/ru/3.reference/03.sync.md
index d7fbba70..1a44a2db 100644
--- a/docs/content/ru/3.reference/03.sync.md
+++ b/docs/content/ru/3.reference/03.sync.md
@@ -111,5 +111,5 @@ PowerSync синхронизирует жёсткие удаления нати
## Следующие шаги
-- [Офлайн-first](/ru/reference/offline-queue) - офлайн-записи, очередь загрузки и обработка фатальных ошибок
+- [Офлайн-first](/ru/reference/offline-first) - офлайн-записи, очередь загрузки и обработка фатальных ошибок
- [Архитектура](/ru/reference/architecture) - инициализация приложения и паттерн хранилищ
diff --git a/docs/content/ru/3.reference/04.offline-queue.md b/docs/content/ru/3.reference/04.offline-first.md
similarity index 92%
rename from docs/content/ru/3.reference/04.offline-queue.md
rename to docs/content/ru/3.reference/04.offline-first.md
index 440f5c17..30f28422 100644
--- a/docs/content/ru/3.reference/04.offline-queue.md
+++ b/docs/content/ru/3.reference/04.offline-first.md
@@ -59,11 +59,11 @@ seo:
Каждая запись в хранилище сохраняет снимок `prev = items.value` до мутации. Если локальная запись в SQLite выбрасывает исключение, восстанавливается `items.value = prev` и показывается toast. Это покрывает ошибки локальной записи (например, ограничение SQLite, нехватка места). Ошибки отказа на сервере (RLS, ограничение) обрабатываются отдельно обработчиком ошибок загрузки.
-## Без ручной офлайн-очереди
+## Без ручной очереди
-Написанная вручную офлайн-очередь (`components/offline/helpers.ts`, `replay.ts`, `replayHelpers.ts`, `types.ts`) и система ID с префиксом `local_` были удалены. PowerSync предоставляет очередь загрузки нативно. Нет `replay()`, нет `mergeOfflineOps()`, нет `cleanupFrontendIds()`, нет переназначения ID.
+Очередью загрузки нативно управляет PowerSync - нет написанной вручную очереди, нет шага replay, нет слияния операций, нет переназначения клиентских ID.
-Клиентские ID - это обычные UUID (генерируются на клиенте). Они стабильны и не требуют переназначения после загрузки.
+Клиентские ID - это обычные UUID (генерируются на клиенте через `crypto.randomUUID()` или аналог). Они стабильны и служат постоянным первичным ключом и на устройстве, и на сервере, поэтому ничего не нужно переназначать после загрузки.
## Ключевые файлы