@lunora/db 1.0.0-alpha.2 → 1.0.0-alpha.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (25) hide show
  1. package/LICENSE.md +6 -0
  2. package/README.md +12 -0
  3. package/__assets__/package-og.svg +1 -1
  4. package/dist/collections/index.d.mts +5 -0
  5. package/dist/collections/index.d.ts +5 -0
  6. package/dist/collections/index.mjs +2 -0
  7. package/dist/index.d.mts +7 -141
  8. package/dist/index.d.ts +7 -141
  9. package/dist/index.mjs +4 -2
  10. package/dist/mutators/index.d.mts +5 -0
  11. package/dist/mutators/index.d.ts +5 -0
  12. package/dist/mutators/index.mjs +1 -0
  13. package/dist/packem_shared/OUTBOX_MUTATION_FN_NAME-Cf8iP6Wa.mjs +102 -0
  14. package/dist/packem_shared/bindMutators-BseARPYg.mjs +70 -0
  15. package/dist/packem_shared/collection-options.d-DgAuvqvn.d.mts +226 -0
  16. package/dist/packem_shared/collection-options.d-DgAuvqvn.d.ts +226 -0
  17. package/dist/packem_shared/createCheckpointRegistry-Bf4JtkVH.mjs +136 -0
  18. package/dist/packem_shared/define-collections.d-1z8QtQW8.d.mts +166 -0
  19. package/dist/packem_shared/define-collections.d-DPgIHAtd.d.ts +166 -0
  20. package/dist/packem_shared/define-mutators.d-10NiOBqm.d.ts +80 -0
  21. package/dist/packem_shared/define-mutators.d-Cq_qr5Z1.d.mts +80 -0
  22. package/dist/packem_shared/defineCollections-yLxJvEsu.mjs +107 -0
  23. package/package.json +12 -3
  24. package/dist/packem_shared/createOptimisticOnlineDetector-CRulWqZ7.mjs +0 -65
  25. package/dist/packem_shared/defineCollections-BAmslSrF.mjs +0 -109
package/LICENSE.md CHANGED
@@ -103,3 +103,9 @@ Unless required by applicable law or agreed to in writing, software distributed
103
103
  under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
104
104
  CONDITIONS OF ANY KIND, either express or implied. See the License for the
105
105
  specific language governing permissions and limitations under the License.
106
+
107
+ <!-- DEPENDENCIES -->
108
+ <!-- /DEPENDENCIES -->
109
+
110
+ <!-- TYPE_DEPENDENCIES -->
111
+ <!-- /TYPE_DEPENDENCIES -->
package/README.md CHANGED
@@ -85,6 +85,18 @@ export const createCollections = (client: LunoraClient) =>
85
85
 
86
86
  > `vis generate lunora-collections` scaffolds this from your `schema.ts` + functions.
87
87
 
88
+ ### Local-first sync engine
89
+
90
+ Beyond whole-table collections, the `@lunora/db/collections` and
91
+ `@lunora/db/mutators` subpaths expose the local-first sync engine:
92
+ `lunoraCollectionOptions({ shape })` syncs a **partial replication shape** (only
93
+ the rows a client needs, scoped by a server-resolved predicate) over the poke
94
+ diff protocol, and `defineMutator` + `bindMutators` run **optimistic custom
95
+ mutators** (a local body first, a server-authoritative impl second, rebased on
96
+ every sync tick). The framework adapters add a `useMutator` / `createMutator` /
97
+ `mutator` hook over a bound handle. See the
98
+ **[local-first guide](https://lunora.sh/docs/concepts/local-first)**.
99
+
88
100
  > This README covers the basics. For the full API, options, and guides, see the **[documentation](https://lunora.sh/docs/addons/db)**.
89
101
 
90
102
  ## Related