@palantir/pack.state.demo 0.1.1

package/.turbo/turbo-lint.log

@@ -0,0 +1,4 @@
+
+> @palantir/pack.state.demo@0.1.1 lint /home/runner/work/pack/pack/packages/state/demo
+> eslint ./src && dprint check --config $(find-up dprint.json) --allow-no-files
+

package/.turbo/turbo-transpileBrowser.log

@@ -0,0 +1,6 @@
+
+> @palantir/pack.state.demo@0.1.1 transpileBrowser /home/runner/work/pack/pack/packages/state/demo
+> monorepo-transpile -f esm -m bundle -t browser
+
+[baseline-browser-mapping] The data in this module is over two months old.  To ensure accurate Baseline data, please update: `npm i baseline-browser-mapping@latest -D`
+👍

package/.turbo/turbo-transpileCjs.log

@@ -0,0 +1,6 @@
+
+> @palantir/pack.state.demo@0.1.1 transpileCjs /home/runner/work/pack/pack/packages/state/demo
+> monorepo-transpile -f cjs -m bundle -t node
+
+[baseline-browser-mapping] The data in this module is over two months old.  To ensure accurate Baseline data, please update: `npm i baseline-browser-mapping@latest -D`
+👍

package/.turbo/turbo-transpileEsm.log

@@ -0,0 +1,6 @@
+
+> @palantir/pack.state.demo@0.1.1 transpileEsm /home/runner/work/pack/pack/packages/state/demo
+> monorepo-transpile -f esm -m bundle -t node
+
+[baseline-browser-mapping] The data in this module is over two months old.  To ensure accurate Baseline data, please update: `npm i baseline-browser-mapping@latest -D`
+👍

package/.turbo/turbo-transpileTypes.log

@@ -0,0 +1,5 @@
+
+> @palantir/pack.state.demo@0.1.1 transpileTypes /home/runner/work/pack/pack/packages/state/demo
+> monorepo-transpile -f esm -m types -t node
+
+👍

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @palantir/pack.state.demo@0.1.1 typecheck /home/runner/work/pack/pack/packages/state/demo
+> tsc --noEmit --emitDeclarationOnly false
+

package/CHANGELOG.md

@@ -0,0 +1,39 @@
+# @palantir/pack.state.demo
+
+## 0.1.1
+
+### Patch Changes
+
+- 5120719: Update dependency ranges
+- Updated dependencies [5120719]
+  - @palantir/pack.document-schema.model-types@0.3.1
+  - @palantir/pack.state.core@0.3.1
+  - @palantir/pack.core@0.2.2
+
+## 0.1.0
+
+### Minor Changes
+
+- 15f7f90: fix search api to match required types and add search pagination
+
+### Patch Changes
+
+- 319660b: Fix demo client id new generation on page reloads
+- 9f45b8e: Improve document creation API to separate create request from raw API types
+- 887cab4: Fix demo service activity and presence implementation
+- 87f1e63: Support for demo mode (offline) document services
+- e6e40f7: Improve demo mode services and add offline demo oauth implementation
+- 4a44875: Remove bun-specific scripts and dependency
+- Updated dependencies [9f45b8e]
+- Updated dependencies [571578c]
+- Updated dependencies [862daf6]
+- Updated dependencies [87f1e63]
+- Updated dependencies [e6e40f7]
+- Updated dependencies [15f7f90]
+- Updated dependencies [7ee55de]
+- Updated dependencies [4a44875]
+- Updated dependencies [8057223]
+- Updated dependencies [19b8f5b]
+  - @palantir/pack.document-schema.model-types@0.3.0
+  - @palantir/pack.state.core@0.3.0
+  - @palantir/pack.core@0.2.1

package/LICENSE.txt

@@ -0,0 +1,13 @@
+Copyright 2025 Palantir Technologies, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,110 @@
+# @palantir/pack.state.demo
+
+Offline demo implementation of `DocumentService` for local development and testing.
+
+## Purpose
+
+This package provides a browser-based, offline-capable document service implementation that:
+
+- Persists documents locally using IndexedDB (via y-indexeddb)
+- Synchronizes document changes across browser tabs using BroadcastChannel API
+- Implements presence and activity tracking across tabs
+- Requires no backend server or network connectivity
+
+This is intended for:
+
+- Local development without Foundry backend
+- Testing React components and pack layers in isolation
+- Demos and prototypes
+- Unit and integration testing
+
+## Architecture
+
+### Two-tier Persistence
+
+1. **Metadata Store**: Single Y.Doc containing metadata for all documents
+2. **Document Store**: Individual Y.Docs per document, each with its own IndexedDB persistence
+
+### Cross-Tab Synchronization
+
+- **Data Channels**: Y.js updates broadcast via BroadcastChannel for real-time sync
+- **Presence Channels**: Heartbeat mechanism tracks active clients across tabs
+- **Activity Broadcasting**: Custom presence data shared across all document subscribers
+
+### Status Management
+
+Documents transition through standard load and live states:
+
+- Load: `UNLOADED` → `LOADING` → `LOADED`
+- Live: `DISCONNECTED` → `CONNECTING` → `CONNECTED`
+
+## Usage
+
+```typescript
+import { createPackApp } from "@palantir/pack.core";
+import { createDemoDocumentServiceConfig } from "@palantir/pack.state.demo";
+
+const app = createPackApp({
+  modules: [
+    createDemoDocumentServiceConfig({
+      dbPrefix: "my-app", // Optional, defaults to "pack-demo"
+    }),
+  ],
+});
+```
+
+## Implementation Details
+
+### BaseYjsDocumentService Extension
+
+Extends `BaseYjsDocumentService` which handles:
+
+- Y.Doc lifecycle and initialization
+- Record CRUD operations
+- Subscription management
+- Change notifications
+
+Demo implementation adds:
+
+- IndexedDB persistence layer
+- BroadcastChannel synchronization
+- Presence heartbeat management
+
+### Presence Heartbeat Protocol
+
+Clients broadcast heartbeats every 5 seconds. The PresenceManager:
+
+- Tracks all active clients by clientId
+- Emits "arrive" events when new heartbeats appear
+- Emits "depart" events when heartbeats go stale (>15s)
+
+This provides automatic presence detection without explicit arrive/depart messages.
+
+## Testing
+
+Run tests with:
+
+```bash
+pnpm test
+```
+
+Tests cover:
+
+- Document creation and persistence across service instances
+- Cross-tab synchronization (simulated with multiple service instances)
+- Presence arrive/depart events
+- Activity event broadcasting
+- Status transition lifecycle
+- Search functionality
+
+## Limitations
+
+- **Browser-only**: Requires IndexedDB and BroadcastChannel APIs
+- **No conflict resolution**: Relies on Y.js CRDT for concurrent edits
+- **No server sync**: Changes persist only in browser storage
+- **No auth/security**: All documents accessible locally
+- **Storage limits**: Subject to browser IndexedDB quotas
+
+## Private Package
+
+This package is marked as private and not published to npm. It's intended for internal development and testing workflows only.