Files
logseq/deps/publish/README.md
megayu 79c25837cb Migrate from yarn to pnpm (#12529)
* migrate yarn to pnpm

* chore: update pnpm version to 10.33.0 across all package.json files

* chore: update .npmrc and package.json for improved dependency management

* chore: unify Clojure, Node, and Java version in workflow files

* fix: enable shamefully-hoist for now and add electron, keytar to onlyBuiltDependencies

* feat: add cider/piggieback dependency and update nREPL middleware configuration to silence warnings

* ensure pnpm setup prior to node setup

* fix: update logseq/bb-tasks git SHA

* feat: add pnpm configuration for onlyBuiltDependencies in package.json

* feat: add onlyBuiltDependencies configuration for better-sqlite3 in pnpm settings

* chore: update pnpm lockfile

* fix: resolve merge conflicts

* fix: remove invisible characters from markdown headers

* fix: update .npmrc comments for clarity on lockfile usage

* Revert "feat: add cider/piggieback dependency and update nREPL middleware configuration to silence warnings"

This reverts commit 70a111936f.

* fix: remove invisible characters from various README files and add .editorconfig

* fix: clarify lockfile resolution process in SKILL.md

---------

Co-authored-by: Tienson Qin <tiensonqin@gmail.com>
2026-04-24 23:40:25 +08:00

1.5 KiB

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 for linting examples.

Local Testing

For one-time setup, install the CloudFlare cli 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.