Build a native reader with TypeScript

Install the SDK

pnpm add @prosewire/sdk

The package declares Node.js 24 or newer, ships ESM JavaScript plus bundled TypeScript declarations, and uses fetch for HTTP requests.

Create a client

import { createPublicClient } from "@prosewire/sdk";

const content = createPublicClient({
  baseUrl: "https://publish.example.com",
  blog: "fieldnotes",
});

List and retrieve posts

const posts = await content.listPosts({ page: 1, pageSize: 10 });
const article = await content.getPost("shipping-with-confidence");
const html = await content.getRendered("shipping-with-confidence");

Public queries only return published content whose publication time has arrived. Drafts and future scheduled posts stay private.

What the client returns

• Post content and excerpt
• Canonical slug and publication timestamps
• Authors and categories
• Locale and search metadata
• Reading time and page metadata

listPosts accepts search, category, page, and pageSize; pageSize is capped at 100. The older limit option remains a deprecated alias. A non-success HTTP response rejects with an error that includes the response status.

Use the management API

Create a publication-scoped API key in Settings → Developer. Keep it in a server-only environment variable and grant only the scopes the application needs.

PROSEWIRE_API_URL=https://your-prosewire-deployment
PROSEWIRE_API_KEY=pw_live_...

import { createClient } from "@prosewire/sdk";

const management = createClient({
  baseUrl: process.env.PROSEWIRE_API_URL!,
  apiKey: process.env.PROSEWIRE_API_KEY!,
});

const drafts = await management.posts.list({ status: "draft" });

Never expose a management key in browser JavaScript. Public content clients do not need authentication.

The Promise client exposes these management operations:

await management.health();
await management.blogs.list();
await management.posts.list({ page: 1, pageSize: 20 });
await management.posts.get({ params: { id: postId } });
await management.posts.create(input);
await management.posts.update({ params: { id: postId }, body: patch });
await management.posts.archive({ params: { id: postId } });

createEffectClient exposes the same operations as Effects. Create and update inputs are validated by the shared contract; see Use raw JSON or rendered HTML for field limits and HTTP behavior.