docs(sdk): announce published TypeScript beta and npm installation

Author: crapthings

CHANGELOG.md

@@ -4,7 +4,7 @@ All notable public-contract changes are recorded here. Meldbase remains alpha;
 entries under **Unreleased** are not a published compatibility commitment until
 they are assigned to a release.
 
-## TypeScript SDK 0.1.0-beta.1 (pending npm publication)
+## TypeScript SDK 0.1.0-beta.1 — 2026-10-10
 
 - Establish reviewed public API reports for the client, local collection,
   shared types, React, and trusted-worker entry points. CI rejects unreviewed

docs/.vitepress/theme/components/MeldbaseHome.vue

@@ -111,7 +111,7 @@ async function copy() {
         </div>
         <pre role="tabpanel" :aria-label="`${tab} API excerpt`"><code>{{ snippets[tab] }}</code></pre>
         <a class="editor-footer" :href="withBase(guides[tab])"
-          >{{ tab === "Go" ? "Run the complete Go example" : "Workspace SDK preview · Follow the setup guide" }}
+          >{{ tab === "Go" ? "Run the complete Go example" : "TypeScript SDK beta · Follow the setup guide" }}
           <span>→</span></a
         >
       </div>

docs/browser.md

@@ -4,9 +4,15 @@ Use the Meldbase client in a browser when a web application needs documents and
 live queries. The browser connects to a running `meld serve`; it never opens a
 `.meld` file directly.
 
-The SDK is currently a workspace preview and is not yet published to npm. Its
-public package name will be `@meldbase/client`. Until publication, use the
-included browser example from a Meldbase checkout:
+Install the SDK in your browser application:
+
+```sh
+npm install @meldbase/client@beta
+```
+
+The package is published as `0.1.0-beta.1`; see the
+[SDK compatibility policy](/sdk-status) before upgrading.
+To run the included browser example, use a Meldbase checkout:
 
 ```sh
 pnpm install --frozen-lockfile

docs/installation.md

@@ -36,9 +36,25 @@ Keep this development server local. An externally reachable service requires
 an authentication and collection-policy configuration; inspect `meld serve --help`
 and the server configuration in the repository before deploying it.
 
-## TypeScript workspace preview
+## TypeScript SDK beta
 
-The SDK packages are not yet published to npm. Use the public workspace:
+Install the packages your application needs:
+
+```sh
+npm install @meldbase/client@beta
+npm install @meldbase/react@beta react
+npm install @meldbase/worker@beta
+```
+
+All three packages are published as `0.1.0-beta.1`. Pin that exact version for
+reproducible builds. Node.js 20 or later is required for Node applications.
+See [SDK compatibility and release status](/sdk-status) for the beta API policy.
+
+Continue with the [Browser guide](/browser) or [Node.js guide](/node).
+
+## Run the repository example
+
+To explore the public browser example, use the repository workspace:
 
 ```sh
 git clone https://github.com/crapthings/meldbase.git
@@ -56,7 +72,7 @@ pnpm --filter @meldbase/example-realtime-todos dev
 ```
 
 Start the server in another terminal and follow the [Browser guide](/browser).
-For a runnable Node script importing the built workspace SDK, follow
+For a runnable Node script using the published SDK, follow
 [Node.js](/node).
 
 ## Next step

docs/node.md

@@ -4,9 +4,8 @@ Use the Meldbase client in Node.js when another server process needs to work
 with a running Meldbase service. Node connects over HTTP and WebSocket; it does
 not open a `.meld` file directly.
 
-The SDK is currently a workspace preview and is not yet published to npm. Its
-public package name will be `@meldbase/client`. The API below is available from
-the Meldbase workspace today.
+The `@meldbase/client` SDK is available on npm under the `beta` tag.
+See [SDK compatibility and release status](/sdk-status) before upgrading.
 
 ## Start a local service
 
@@ -21,19 +20,17 @@ network.
 
 ## Create a client
 
-Node.js 20 or later is required. In another terminal, from the checkout root:
+Node.js 20 or later is required. In another terminal, in your application directory:
 
 ```sh
-pnpm install --frozen-lockfile
-pnpm --filter @meldbase/client build
+npm install @meldbase/client@beta ws
 ```
 
-Save this as `node-tour.mjs` in the checkout root. It uses the built workspace
-SDK and the workspace's WebSocket dependency:
+Save this as `node-tour.mjs` in your application directory:
 
 ```js
 import WebSocket from "ws";
-import { MeldbaseClient } from "./sdk/client/dist/index.js";
+import { MeldbaseClient } from "@meldbase/client";
 
 const client = new MeldbaseClient({
   baseUrl: "http://127.0.0.1:8080",

docs/overview.md

@@ -39,7 +39,7 @@ the server. Distributed replication and a multi-node cluster are outside the
 current product scope.
 
 The Go module and CLI releases are available today. The TypeScript SDKs are
-workspace previews targeting `0.1.0-beta.1`; npm publication is pending.
+published as `0.1.0-beta.1` on npm under the `beta` tag.
 See [SDK compatibility and release status](/sdk-status) for the reviewed public
 API boundary and release evidence.
 

docs/sdk-beta-release.md

@@ -33,8 +33,8 @@ retag a different version as `beta`; those practices weaken the release receipt.
 ## First publication
 
 The `@meldbase` npm organization must exist, and the publishing account must
-have permission to create public packages within it. The three packages do not
-yet exist, so a trusted publisher cannot be assumed to be configured.
+have permission to create public packages within it. For a new package,
+a trusted publisher cannot be assumed to be configured before its first publication.
 
 Use `prepare_only` to produce verified archives and a source-commit/integrity
 receipt as the `meldbase-sdk-beta` workflow artifact without publishing.

docs/sdk-status.md

@@ -1,7 +1,7 @@
 # SDK compatibility and release status
 
-The workspace targets TypeScript SDK `0.1.0-beta.1`. npm publication is pending;
-a version number in source is not proof that a package can be installed.
+TypeScript SDK `0.1.0-beta.1` is published on npm under the `beta` tag.
+Install the client with `npm install @meldbase/client@beta`.
 The Go database remains alpha.
 
 ## Public application entry points
@@ -47,5 +47,5 @@ version change. Update mode is a maintainer action and is not run in CI.
 
 The [beta checklist](/sdk-beta-checklist) describes the required validation.
 The [publishing guide](/sdk-beta-release) covers initial npm authentication and
-subsequent trusted publishing. Continue using the workspace quickstarts until
-registry publication is confirmed.
+subsequent trusted publishing. The [SDK beta release](https://github.com/crapthings/meldbase/releases/tag/sdk-v0.1.0-beta.1)
+includes verified archives and a source-commit/integrity receipt.