@usezanin/client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Siyabend Oezdemir
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# @usezanin/client
+
+Typed API client for [Zanin](https://github.com/siyabendoezdemir/zanin), the agent-native headless blog CMS. Used by `@usezanin/blog` (the Next.js SDK) and `@usezanin/mcp` (the MCP server); use it directly for scripts and CI.
+
+```bash
+npm install @usezanin/client
+```
+
+```ts
+import { ZaninClient } from "@usezanin/client";
+
+const zanin = new ZaninClient({
+  baseUrl: "https://your-zanin-deployment",
+  apiKey: process.env.ZANIN_API_KEY!, // "zn_...", created in the dashboard
+});
+
+const [site] = await zanin.listSites();
+const post = await zanin.createPost(site.id, {
+  slug: "hello-world",
+  title: "Hello World",
+  body: "# Hi\n\nWritten via the API.",
+  changeSummary: "Initial version",
+});
+await zanin.publishPost(post.id);
+
+// Correlate content changes with search outcomes:
+const perf = await zanin.getPostPerformance(post.id, { days: 90 });
+```
+
+Covers posts (CRUD, publish, revisions), media upload, custom MDX components, and Google Search Console performance (daily metrics with revision markers, top queries).
+
+All mutating post methods require a `changeSummary` — every change is stored as an immutable revision so search performance can be correlated with what changed.
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import type { CreatePostInput, ListPostsOptions, Media, Post, PostPerformance, PostRevision, PostStatus, Site, SiteComponent, SitePerformance, TopQueriesResult, UpdatePostInput, UploadMediaInput, UpsertComponentInput } from "./types.js";
+export * from "./types.js";
+export interface ZaninClientOptions {
+    /** Base URL of the Zanin CMS, e.g. "https://cms.zanin.io". */
+    baseUrl: string;
+    /** Workspace-scoped API key ("zn_..."). */
+    apiKey: string;
+    /** Optional fetch implementation override. */
+    fetch?: typeof fetch;
+}
+export declare class ZaninApiError extends Error {
+    readonly status: number;
+    readonly details?: unknown | undefined;
+    constructor(status: number, message: string, details?: unknown | undefined);
+}
+export declare class ZaninClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly fetchImpl;
+    constructor(options: ZaninClientOptions);
+    private request;
+    listSites(): Promise<Site[]>;
+    listPosts(siteId: string, options?: ListPostsOptions): Promise<Post[]>;
+    getPost(postId: string): Promise<Post>;
+    /**
+     * Fetches a post by slug (with body). Returns null when no post matches,
+     * so host sites can map it straight to a 404.
+     */
+    getPostBySlug(siteId: string, slug: string, options?: {
+        status?: PostStatus;
+    }): Promise<Post | null>;
+    createPost(siteId: string, input: CreatePostInput): Promise<Post>;
+    updatePost(postId: string, input: UpdatePostInput): Promise<Post>;
+    deletePost(postId: string): Promise<void>;
+    publishPost(postId: string): Promise<Post>;
+    unpublishPost(postId: string): Promise<Post>;
+    listRevisions(postId: string, options?: {
+        includeBody?: boolean;
+    }): Promise<PostRevision[]>;
+    /** Daily search metrics for a post with revision markers inline. */
+    getPostPerformance(postId: string, options?: {
+        days?: number;
+    }): Promise<PostPerformance>;
+    /** Site-wide daily search metrics. */
+    getSitePerformance(siteId: string, options?: {
+        days?: number;
+    }): Promise<SitePerformance>;
+    /** Top search queries for a site, optionally scoped to one post. */
+    getTopQueries(siteId: string, options?: {
+        days?: number;
+        limit?: number;
+        postId?: string;
+    }): Promise<TopQueriesResult>;
+    listComponents(siteId: string, options?: {
+        includeCompiled?: boolean;
+    }): Promise<SiteComponent[]>;
+    getComponent(siteId: string, name: string): Promise<SiteComponent>;
+    /** Creates or updates (by name) a custom MDX component from TSX source. */
+    upsertComponent(siteId: string, input: UpsertComponentInput): Promise<SiteComponent>;
+    deleteComponent(siteId: string, name: string): Promise<void>;
+    listMedia(siteId: string): Promise<Media[]>;
+    uploadMedia(siteId: string, input: UploadMediaInput): Promise<Media>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,161 @@
+export * from "./types.js";
+export class ZaninApiError extends Error {
+    status;
+    details;
+    constructor(status, message, details) {
+        super(message);
+        this.status = status;
+        this.details = details;
+        this.name = "ZaninApiError";
+    }
+}
+export class ZaninClient {
+    baseUrl;
+    apiKey;
+    fetchImpl;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+        this.apiKey = options.apiKey;
+        this.fetchImpl = options.fetch ?? fetch;
+    }
+    async request(method, path, opts = {}) {
+        const url = new URL(`${this.baseUrl}/api/v1${path}`);
+        for (const [k, v] of Object.entries(opts.query ?? {})) {
+            url.searchParams.set(k, v);
+        }
+        const res = await this.fetchImpl(url, {
+            method,
+            headers: {
+                authorization: `Bearer ${this.apiKey}`,
+                ...(opts.body !== undefined ? { "content-type": "application/json" } : {}),
+            },
+            body: opts.formData ?? (opts.body !== undefined ? JSON.stringify(opts.body) : undefined),
+        });
+        const text = await res.text();
+        let json = null;
+        try {
+            json = text ? JSON.parse(text) : null;
+        }
+        catch {
+            // fall through with null body
+        }
+        if (!res.ok) {
+            const err = json?.error;
+            throw new ZaninApiError(res.status, err?.message ?? `Request failed with status ${res.status}`, err?.details);
+        }
+        return json;
+    }
+    // -- Sites ----------------------------------------------------------------
+    async listSites() {
+        const { sites } = await this.request("GET", "/sites");
+        return sites;
+    }
+    // -- Posts ----------------------------------------------------------------
+    async listPosts(siteId, options = {}) {
+        const query = {};
+        if (options.status)
+            query.status = options.status;
+        if (options.limit !== undefined)
+            query.limit = String(options.limit);
+        if (options.offset !== undefined)
+            query.offset = String(options.offset);
+        const { posts } = await this.request("GET", `/sites/${encodeURIComponent(siteId)}/posts`, { query });
+        return posts;
+    }
+    async getPost(postId) {
+        const { post } = await this.request("GET", `/posts/${encodeURIComponent(postId)}`);
+        return post;
+    }
+    /**
+     * Fetches a post by slug (with body). Returns null when no post matches,
+     * so host sites can map it straight to a 404.
+     */
+    async getPostBySlug(siteId, slug, options = {}) {
+        try {
+            const { post } = await this.request("GET", `/sites/${encodeURIComponent(siteId)}/posts/by-slug/${encodeURIComponent(slug)}`, { query: options.status ? { status: options.status } : {} });
+            return post;
+        }
+        catch (err) {
+            if (err instanceof ZaninApiError && err.status === 404)
+                return null;
+            throw err;
+        }
+    }
+    async createPost(siteId, input) {
+        const { post } = await this.request("POST", `/sites/${encodeURIComponent(siteId)}/posts`, { body: input });
+        return post;
+    }
+    async updatePost(postId, input) {
+        const { post } = await this.request("PATCH", `/posts/${encodeURIComponent(postId)}`, { body: input });
+        return post;
+    }
+    async deletePost(postId) {
+        await this.request("DELETE", `/posts/${encodeURIComponent(postId)}`);
+    }
+    async publishPost(postId) {
+        const { post } = await this.request("POST", `/posts/${encodeURIComponent(postId)}/publish`);
+        return post;
+    }
+    async unpublishPost(postId) {
+        const { post } = await this.request("POST", `/posts/${encodeURIComponent(postId)}/unpublish`);
+        return post;
+    }
+    async listRevisions(postId, options = {}) {
+        const { revisions } = await this.request("GET", `/posts/${encodeURIComponent(postId)}/revisions`, { query: options.includeBody ? { includeBody: "true" } : {} });
+        return revisions;
+    }
+    // -- Performance (Google Search Console) -------------------------------------
+    /** Daily search metrics for a post with revision markers inline. */
+    async getPostPerformance(postId, options = {}) {
+        return this.request("GET", `/posts/${encodeURIComponent(postId)}/performance`, { query: options.days !== undefined ? { days: String(options.days) } : {} });
+    }
+    /** Site-wide daily search metrics. */
+    async getSitePerformance(siteId, options = {}) {
+        return this.request("GET", `/sites/${encodeURIComponent(siteId)}/performance`, { query: options.days !== undefined ? { days: String(options.days) } : {} });
+    }
+    /** Top search queries for a site, optionally scoped to one post. */
+    async getTopQueries(siteId, options = {}) {
+        const query = {};
+        if (options.days !== undefined)
+            query.days = String(options.days);
+        if (options.limit !== undefined)
+            query.limit = String(options.limit);
+        if (options.postId)
+            query.postId = options.postId;
+        return this.request("GET", `/sites/${encodeURIComponent(siteId)}/top-queries`, { query });
+    }
+    // -- Components -------------------------------------------------------------
+    async listComponents(siteId, options = {}) {
+        const { components } = await this.request("GET", `/sites/${encodeURIComponent(siteId)}/components`, { query: options.includeCompiled ? { includeCompiled: "true" } : {} });
+        return components;
+    }
+    async getComponent(siteId, name) {
+        const { component } = await this.request("GET", `/sites/${encodeURIComponent(siteId)}/components/${encodeURIComponent(name)}`);
+        return component;
+    }
+    /** Creates or updates (by name) a custom MDX component from TSX source. */
+    async upsertComponent(siteId, input) {
+        const { component } = await this.request("POST", `/sites/${encodeURIComponent(siteId)}/components`, { body: input });
+        return component;
+    }
+    async deleteComponent(siteId, name) {
+        await this.request("DELETE", `/sites/${encodeURIComponent(siteId)}/components/${encodeURIComponent(name)}`);
+    }
+    // -- Media ----------------------------------------------------------------
+    async listMedia(siteId) {
+        const { media } = await this.request("GET", `/sites/${encodeURIComponent(siteId)}/media`);
+        return media;
+    }
+    async uploadMedia(siteId, input) {
+        const blob = input.data instanceof Blob
+            ? input.data
+            : new Blob([input.data], { type: input.contentType });
+        const form = new FormData();
+        form.set("file", new File([blob], input.filename, { type: input.contentType }));
+        if (input.alt)
+            form.set("alt", input.alt);
+        const { media } = await this.request("POST", `/sites/${encodeURIComponent(siteId)}/media`, { formData: form });
+        return media;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,133 @@
+export type PostStatus = "draft" | "published";
+export interface Site {
+    id: string;
+    name: string;
+    slug: string;
+    domain: string | null;
+    gscProperty: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Post {
+    id: string;
+    siteId: string;
+    slug: string;
+    title: string;
+    description: string | null;
+    body?: string;
+    status: PostStatus;
+    publishedAt: string | null;
+    tags: string[];
+    ogImageUrl: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PostRevision {
+    id: string;
+    postId: string;
+    revision: number;
+    title: string;
+    description: string | null;
+    body?: string;
+    tags: string[];
+    changeSummary: string;
+    createdBy: string;
+    createdAt: string;
+}
+export interface Media {
+    id: string;
+    siteId: string;
+    filename: string;
+    url: string;
+    contentType: string;
+    sizeBytes: number;
+    alt: string | null;
+    createdAt: string;
+}
+export interface SiteComponent {
+    id: string;
+    siteId: string;
+    name: string;
+    source?: string;
+    /** Compiled CJS; present when requested with includeCompiled. */
+    compiledJs?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface UpsertComponentInput {
+    /** MDX tag name, PascalCase (e.g. "PricingTable"). */
+    name: string;
+    /** TSX source with a default export; may only import react / react/jsx-runtime. */
+    source: string;
+}
+export interface DailyMetrics {
+    date: string;
+    clicks: number;
+    impressions: number;
+    ctr: number;
+    position: number;
+    /** Revisions that happened on this day (post performance only). */
+    events?: RevisionMarker[];
+}
+export interface RevisionMarker {
+    revision: number;
+    date: string;
+    changeSummary: string;
+    createdBy: string;
+}
+export interface PostPerformance {
+    postId: string;
+    slug: string;
+    days: DailyMetrics[];
+    revisions: RevisionMarker[];
+    gscConfigured: boolean;
+}
+export interface SitePerformance {
+    siteId: string;
+    days: DailyMetrics[];
+    gscConfigured: boolean;
+}
+export interface TopQuery {
+    query: string;
+    clicks: number;
+    impressions: number;
+    ctr: number;
+    position: number;
+}
+export interface TopQueriesResult {
+    siteId: string;
+    queries: TopQuery[];
+    gscConfigured: boolean;
+}
+export interface CreatePostInput {
+    slug: string;
+    title: string;
+    description?: string | null;
+    body?: string;
+    tags?: string[];
+    ogImageUrl?: string | null;
+    /** Why this post exists / what it covers. Defaults to "Initial version". */
+    changeSummary?: string;
+}
+export interface UpdatePostInput {
+    slug?: string;
+    title?: string;
+    description?: string | null;
+    body?: string;
+    tags?: string[];
+    ogImageUrl?: string | null;
+    /** Required: what changed and why. Powers revision/SEO correlation. */
+    changeSummary: string;
+}
+export interface ListPostsOptions {
+    status?: PostStatus;
+    limit?: number;
+    offset?: number;
+}
+export interface UploadMediaInput {
+    filename: string;
+    contentType: string;
+    data: ArrayBuffer | Uint8Array | Blob;
+    alt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@usezanin/client",
+  "version": "0.1.0",
+  "description": "Typed API client for the Zanin blog CMS",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "zanin",
+    "cms",
+    "blog",
+    "headless-cms"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/siyabendoezdemir/zanin.git",
+    "directory": "packages/client"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0"
+  }
+}