initial commit

Author: Hamdal

.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dart-lang/setup-dart@v1
+        with:
+          sdk: stable
+
+      - name: Install dependencies
+        run: dart pub get
+        working-directory: packages/syncache
+
+      - name: Check formatting
+        run: dart format --set-exit-if-changed .
+        working-directory: packages/syncache
+
+      - name: Analyze
+        run: dart analyze --fatal-infos
+        working-directory: packages/syncache
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dart-lang/setup-dart@v1
+        with:
+          sdk: stable
+
+      - name: Install dependencies
+        run: dart pub get
+        working-directory: packages/syncache
+
+      - name: Run tests
+        run: dart test
+        working-directory: packages/syncache

.gitignore

@@ -0,0 +1,33 @@
+# Dart/Flutter
+.dart_tool/
+.packages
+build/
+pubspec.lock
+
+# Coverage
+coverage/
+
+# IDE
+.idea/
+*.iml
+.vscode/
+
+# Android
+**/android/local.properties
+**/android/key.properties
+**/*.keystore
+**/*.jks
+
+# iOS
+**/ios/Pods/
+**/ios/.symlinks/
+**/ios/Flutter/Flutter.framework
+**/ios/Flutter/Flutter.podspec
+
+# Environment
+.env*
+*.env
+
+# OS
+.DS_Store
+Thumbs.db

melos.yaml

@@ -0,0 +1,46 @@
+name: syncache
+repository: https://github.com/Hamdal/syncache
+
+packages:
+  - packages/**
+
+command:
+  bootstrap:
+    usePubspecOverrides: true
+
+scripts:
+  analyze:
+    run: dart analyze .
+    exec:
+      concurrency: 1
+    packageFilters:
+      dirExists: lib
+    description: Run static analysis on all packages
+
+  format:
+    run: dart format .
+    exec:
+      concurrency: 1
+    description: Format all packages
+
+  format:check:
+    run: dart format --set-exit-if-changed .
+    exec:
+      concurrency: 1
+    description: Check formatting on all packages
+
+  test:
+    run: dart test
+    exec:
+      concurrency: 1
+    packageFilters:
+      dirExists: test
+    description: Run tests for all packages
+
+  test:coverage:
+    run: dart test --coverage=coverage
+    exec:
+      concurrency: 1
+    packageFilters:
+      dirExists: test
+    description: Run tests with coverage for all packages

packages/syncache/CHANGELOG.md

@@ -0,0 +1,15 @@
+## 0.1.0
+
+- Initial release
+- Core caching with five policies: offlineFirst, cacheOnly, networkOnly, refresh, staleWhileRefresh
+- Reactive streams via `watch()` and `watchWithMeta()`
+- Optimistic mutations with automatic background sync
+- Tag-based cache invalidation
+- Pattern-based cache invalidation (glob support)
+- Request deduplication for concurrent fetches
+- Retry with exponential backoff
+- Cancellation token support
+- Scoped caches with key prefixing
+- Parallel and dependency-graph prefetching
+- Observer pattern for logging and analytics
+- MemoryStore and SharedMemoryStore implementations

packages/syncache/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hameed Abdullateef
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.