@markwhen/meridiem-client

Typed, dependency-free client for Meridiem's server-side aggregate API.

import { createMeridiemAppClient } from "@markwhen/meridiem-client";

const meridiem = createMeridiemAppClient({
  appId: process.env.MERIDIEM_APP_ID!,
  appSecret: process.env.MERIDIEM_APP_SECRET!,
});

const documents = await meridiem.aggregate.metadata({
  docs: ["alice"],
  sort: "doc_path",
  sort_order: "asc",
});

The client is intended for server, worker, and native environments. Do not ship an app secret to browser code.

Use createMeridiemUserClient({ accessToken }) for Bearer-token document reads and writes, document entry lookup, and media operations. The app client is for Basic-auth aggregate endpoints, including single-entry lookup.

Contract generation

openapi/meridiem.yaml is the public API contract. Run npm run generate after changing it to update src/generated/openapi.ts, then run npm test.