Dasemu
40631362b3
Establishes version control for the personal Logseq DB fork before starting the server-client architecture migration and domain features described in docs/agent-guide and the approved implementation plan. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
42 lines
1.5 KiB
Markdown
42 lines
1.5 KiB
Markdown
## Description
|
|
|
|
Shared library for page publish features (snapshot payloads, SSR helpers, shared schemas, and storage contracts).
|
|
|
|
The Cloudflare Durable Object implementation is expected to use SQLite with the
|
|
Logseq datascript fork layered on top. Page publish payloads are expected to
|
|
send datoms (transit) so the DO can reconstruct/query datascript state.
|
|
|
|
See `deps/publish/worker` for a Cloudflare Worker skeleton that stores transit
|
|
blobs in R2 and metadata in a SQLite-backed Durable Object.
|
|
|
|
## API
|
|
|
|
Namespaces live under `logseq.publish`.
|
|
|
|
## Usage
|
|
|
|
This module is intended to be consumed by the Logseq app and the publish worker.
|
|
|
|
## Dev
|
|
|
|
Keep this module aligned with the main repo's linting and testing conventions.
|
|
Most of the same linters are used, with configurations that are specific to this
|
|
library. See [this library's CI file](/.github/workflows/deps-publish.yml) for
|
|
linting examples.
|
|
|
|
|
|
### Local Testing
|
|
|
|
For one-time setup, install the [CloudFlare cli wrangler](https://developers.cloudflare.com/workers/wrangler/) with `npm install -g wrangler@latest`.
|
|
|
|
To test the publish features locally, follow these steps:
|
|
|
|
* Run `pnpm watch` or `pnpm release` to build the publish worker js asset.
|
|
* Run `wrangler dev` in worker/ to start a local cloudflare worker server.
|
|
* In `frontend.config`, enable the commented out `PUBLISH-API-BASE` which points to a localhost url.
|
|
* Login on the desktop app.
|
|
* Go to any page and select `Publish` from its page menu.
|
|
|
|
### Deploy
|
|
|
|
When changes are ready to be deployed, run `pnpm deploy`. |