@canvas-digital/blog-sdk 2.0.0

package/dist/services/admin-sdk-client.js

@@ -0,0 +1,242 @@
+import { adminSdkRequest, toQuery } from "./http";
+import { normalizePage } from "./pagination";
+function cleanBody(data) {
+    const body = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (value === undefined)
+            continue;
+        body[key] = value;
+    }
+    return body;
+}
+/**
+ * Admin SDK client — `/api/v1/admin/*` with `email` + `apiKey` headers.
+ * Credentials come from the host app that installs this package.
+ */
+export class AdminSdkClient {
+    constructor(config) {
+        this.config = config;
+    }
+    credentials() {
+        return {
+            email: this.config.email,
+            apiKey: this.config.adminApiKey,
+            domain: this.config.domain,
+        };
+    }
+    request(path, options = {}) {
+        return adminSdkRequest(this.config.apiUrl, path, this.credentials(), {
+            timeoutMs: this.config.timeoutMs,
+            ...options,
+        });
+    }
+    me() {
+        return this.request("/admin/admins/me");
+    }
+    async listBrands(params = {}) {
+        const page = params.page ?? 1;
+        const pageSize = params.pageSize ?? 100;
+        const payload = await this.request(`/admin/brands${toQuery({ page, pageSize, status: params.status })}`);
+        return normalizePage(payload, page, pageSize);
+    }
+    createBrand(data) {
+        return this.request("/admin/brands", {
+            method: "POST",
+            body: cleanBody(data),
+        });
+    }
+    async listPosts(params = {}) {
+        const page = params.page ?? 1;
+        const pageSize = params.pageSize ?? 100;
+        const payload = await this.request(`/admin/posts${toQuery({
+            page,
+            pageSize,
+            brandId: params.brandId,
+            status: params.status,
+            q: params.q,
+            categoryId: params.categoryId,
+            includeTrash: params.includeTrash ? "true" : undefined,
+        })}`);
+        return normalizePage(payload, page, pageSize);
+    }
+    getPost(id) {
+        return this.request(`/admin/posts/${encodeURIComponent(id)}`);
+    }
+    createPost(data) {
+        return this.request("/admin/posts", {
+            method: "POST",
+            body: cleanBody({ ...data }),
+        });
+    }
+    updatePost(id, data) {
+        return this.request(`/admin/posts/${encodeURIComponent(id)}`, {
+            method: "PATCH",
+            body: cleanBody({ ...data }),
+        });
+    }
+    deletePost(id, forever = false) {
+        return this.request(`/admin/posts/${encodeURIComponent(id)}${toQuery({ forever: forever ? "true" : undefined })}`, { method: "DELETE" });
+    }
+    publishPost(id) {
+        return this.request(`/admin/posts/${encodeURIComponent(id)}/publish`, {
+            method: "POST",
+        });
+    }
+    unpublishPost(id) {
+        return this.request(`/admin/posts/${encodeURIComponent(id)}/unpublish`, {
+            method: "POST",
+        });
+    }
+    async listCategories(params = {}) {
+        const page = params.page ?? 1;
+        const pageSize = params.pageSize ?? 100;
+        const payload = await this.request(`/admin/categories${toQuery({
+            page,
+            pageSize,
+            brandId: params.brandId,
+            q: params.q,
+            status: params.status,
+        })}`);
+        return normalizePage(payload, page, pageSize);
+    }
+    createCategory(data) {
+        return this.request("/admin/categories", {
+            method: "POST",
+            body: cleanBody(data),
+        });
+    }
+    updateCategory(id, data) {
+        return this.request(`/admin/categories/${encodeURIComponent(id)}`, {
+            method: "PATCH",
+            body: cleanBody(data),
+        });
+    }
+    deleteCategory(id, hard = false) {
+        return this.request(`/admin/categories/${encodeURIComponent(id)}${toQuery({ hard: hard ? "true" : undefined })}`, {
+            method: "DELETE",
+        });
+    }
+    async listComments(params = {}) {
+        const page = params.page ?? 1;
+        const pageSize = params.pageSize ?? 100;
+        const payload = await this.request(`/admin/comments${toQuery({
+            page,
+            pageSize,
+            brandId: params.brandId,
+            postId: params.postId,
+            status: params.status,
+        })}`);
+        return normalizePage(payload, page, pageSize);
+    }
+    setCommentStatus(id, status) {
+        return this.request(`/admin/comments/${encodeURIComponent(id)}/status`, {
+            method: "PATCH",
+            body: { status },
+        });
+    }
+    deleteComment(id) {
+        return this.request(`/admin/comments/${encodeURIComponent(id)}`, { method: "DELETE" });
+    }
+    async listTags(params = {}) {
+        const page = params.page ?? 1;
+        const pageSize = params.pageSize ?? 100;
+        const payload = await this.request(`/admin/tags${toQuery({
+            page,
+            pageSize,
+            brandId: params.brandId,
+            q: params.q,
+            status: params.status,
+        })}`);
+        return normalizePage(payload, page, pageSize);
+    }
+    createTag(data) {
+        return this.request("/admin/tags", {
+            method: "POST",
+            body: cleanBody(data),
+        });
+    }
+    updateTag(id, data) {
+        return this.request(`/admin/tags/${encodeURIComponent(id)}`, {
+            method: "PATCH",
+            body: cleanBody(data),
+        });
+    }
+    deleteTag(id, hard = false) {
+        return this.request(`/admin/tags/${encodeURIComponent(id)}${toQuery({ hard: hard ? "true" : undefined })}`, { method: "DELETE" });
+    }
+    async listAuthors(params = {}) {
+        const page = params.page ?? 1;
+        const pageSize = params.pageSize ?? 100;
+        const payload = await this.request(`/admin/authors${toQuery({
+            page,
+            pageSize,
+            brandId: params.brandId,
+            q: params.q,
+            status: params.status,
+        })}`);
+        return normalizePage(payload, page, pageSize);
+    }
+    createAuthor(data) {
+        return this.request("/admin/authors", {
+            method: "POST",
+            body: cleanBody(data),
+        });
+    }
+    updateAuthor(id, data) {
+        return this.request(`/admin/authors/${encodeURIComponent(id)}`, {
+            method: "PATCH",
+            body: cleanBody(data),
+        });
+    }
+    deleteAuthor(id, hard = false) {
+        return this.request(`/admin/authors/${encodeURIComponent(id)}${toQuery({ hard: hard ? "true" : undefined })}`, { method: "DELETE" });
+    }
+    async listMedia(params = {}) {
+        const page = params.page ?? 1;
+        const pageSize = params.pageSize ?? 100;
+        const payload = await this.request(`/admin/media${toQuery({
+            page,
+            pageSize,
+            brandId: params.brandId,
+            q: params.q,
+        })}`);
+        return normalizePage(payload, page, pageSize);
+    }
+    uploadMedia(file, brandId) {
+        const form = new FormData();
+        form.append("file", file);
+        form.append("brandId", brandId);
+        return this.request("/admin/media", {
+            method: "POST",
+            body: form,
+        });
+    }
+    updateMedia(id, data) {
+        return this.request(`/admin/media/${encodeURIComponent(id)}`, {
+            method: "PATCH",
+            body: cleanBody(data),
+        });
+    }
+    deleteMedia(id) {
+        return this.request(`/admin/media/${encodeURIComponent(id)}`, { method: "DELETE" });
+    }
+    /** Resolve brand for the host `domain` prop (exact domain or url host match). */
+    async resolveBrandByDomain(domain) {
+        const normalized = domain.trim().toLowerCase().replace(/^www\./, "");
+        const page = await this.listBrands({ page: 1, pageSize: 100 });
+        return (page.items.find((b) => (b.domain ?? "").toLowerCase().replace(/^www\./, "") === normalized) ??
+            page.items.find((b) => {
+                try {
+                    const host = new URL(b.url || `https://${b.domain || ""}`).hostname
+                        .toLowerCase()
+                        .replace(/^www\./, "");
+                    return host === normalized;
+                }
+                catch {
+                    return false;
+                }
+            }) ??
+            page.items[0] ??
+            null);
+    }
+}

package/dist/services/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details: unknown;
+    constructor(message: string, options?: {
+        status: number;
+        code?: string;
+        details?: unknown;
+    });
+}
+export declare function isApiError(error: unknown): error is ApiError;
+export declare function isAuthError(error: unknown): boolean;
+export declare function getErrorMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/services/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../app/services/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAGxB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAE1D;CAQJ;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQtD"}

package/dist/services/errors.js

@@ -0,0 +1,26 @@
+export class ApiError extends Error {
+    constructor(message, options = {
+        status: 0,
+    }) {
+        super(message);
+        this.name = "ApiError";
+        this.status = options.status;
+        this.code = options.code ?? "API_ERROR";
+        this.details = options.details ?? null;
+    }
+}
+export function isApiError(error) {
+    return error instanceof ApiError;
+}
+export function isAuthError(error) {
+    return isApiError(error) && (error.status === 401 || error.status === 403);
+}
+export function getErrorMessage(error) {
+    if (isApiError(error)) {
+        return error.message;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return "Unexpected error";
+}

package/dist/services/http.d.ts

@@ -0,0 +1,24 @@
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+export type HttpRequestOptions = {
+    method?: HttpMethod;
+    body?: unknown;
+    headers?: Record<string, string>;
+    /** Customer website domain — sent as `domain` (+ `X-Client-Domain` for compatibility). */
+    domain?: string;
+    /** Account / brand email — sent as `email` header. */
+    email?: string;
+    /** API key — sent as `apiKey` header. */
+    apiKey?: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+};
+export declare function toQuery(params: Record<string, unknown> | undefined): string;
+export declare function unwrapData<T>(payload: unknown): T;
+export declare function httpRequest<T>(baseUrl: string, path: string, authHeader: string | null, options?: HttpRequestOptions): Promise<T>;
+/** SDK auth headers from host props: `email` + `apiKey` (+ optional `domain`). No Bearer. */
+export declare function adminSdkRequest<T>(baseUrl: string, path: string, credentials: {
+    email: string;
+    apiKey: string;
+    domain?: string;
+}, options?: HttpRequestOptions): Promise<T>;
+//# sourceMappingURL=http.d.ts.map

package/dist/services/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../app/services/http.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAgBF,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAe3E;AAsCD,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,CAUjD;AAED,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,CAAC,CAAC,CAuGZ;AAED,6FAA6F;AAC7F,wBAAsB,eAAe,CAAC,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/D,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/services/http.js

@@ -0,0 +1,159 @@
+import { ApiError } from "./errors";
+function joinUrl(baseUrl, path) {
+    const base = baseUrl.replace(/\/+$/, "");
+    const suffix = path.startsWith("/") ? path : `/${path}`;
+    return `${base}${suffix}`;
+}
+export function toQuery(params) {
+    if (!params) {
+        return "";
+    }
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null || value === "") {
+            continue;
+        }
+        search.set(key, String(value));
+    }
+    const query = search.toString();
+    return query ? `?${query}` : "";
+}
+function parseErrorPayload(status, payload, fallback) {
+    if (payload && typeof payload === "object") {
+        const body = payload;
+        if (typeof body.message === "string" && body.message) {
+            return new ApiError(body.message, {
+                status,
+                code: typeof body.code === "string" ? body.code : "API_ERROR",
+                details: body.details ?? null,
+            });
+        }
+        if (typeof body.detail === "string" && body.detail) {
+            return new ApiError(body.detail, { status, code: "API_ERROR" });
+        }
+        if (Array.isArray(body.detail)) {
+            const message = body.detail
+                .map((item) => {
+                if (item && typeof item === "object" && "msg" in item) {
+                    return String(item.msg);
+                }
+                return JSON.stringify(item);
+            })
+                .join("; ");
+            return new ApiError(message || fallback, {
+                status,
+                code: "VALIDATION_ERROR",
+                details: body.detail,
+            });
+        }
+    }
+    return new ApiError(fallback, { status, code: "API_ERROR" });
+}
+export function unwrapData(payload) {
+    if (payload &&
+        typeof payload === "object" &&
+        "success" in payload &&
+        "data" in payload) {
+        return payload.data;
+    }
+    return payload;
+}
+export async function httpRequest(baseUrl, path, authHeader, options = {}) {
+    if (typeof fetch !== "function") {
+        throw new ApiError("fetch is not available in this environment", {
+            status: 0,
+            code: "FETCH_UNAVAILABLE",
+        });
+    }
+    const timeoutMs = options.timeoutMs ?? 30000;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    const onExternalAbort = () => controller.abort();
+    options.signal?.addEventListener("abort", onExternalAbort);
+    const headers = {
+        Accept: "application/json",
+        ...options.headers,
+    };
+    if (authHeader) {
+        headers.Authorization = authHeader;
+    }
+    const email = options.email?.trim();
+    if (email) {
+        headers.email = email.toLowerCase();
+    }
+    const apiKey = options.apiKey?.trim();
+    if (apiKey) {
+        headers.apiKey = apiKey;
+    }
+    const domain = options.domain?.trim();
+    if (domain) {
+        headers.domain = domain;
+        headers["X-Client-Domain"] = domain;
+    }
+    let body;
+    if (typeof FormData !== "undefined" && options.body instanceof FormData) {
+        body = options.body;
+    }
+    else if (options.body !== undefined) {
+        headers["Content-Type"] = headers["Content-Type"] ?? "application/json";
+        body = JSON.stringify(options.body);
+    }
+    try {
+        const response = await fetch(joinUrl(baseUrl, path), {
+            method: options.method ?? "GET",
+            headers,
+            body,
+            signal: controller.signal,
+            credentials: "omit",
+        });
+        const rawText = await response.text();
+        const contentType = response.headers.get("content-type") ?? "";
+        const looksJson = contentType.includes("application/json") ||
+            rawText.startsWith("{") ||
+            rawText.startsWith("[");
+        let payload = rawText || null;
+        if (rawText && looksJson) {
+            try {
+                payload = JSON.parse(rawText);
+            }
+            catch {
+                payload = rawText;
+            }
+        }
+        if (!response.ok) {
+            throw parseErrorPayload(response.status, payload, `Blog API error: ${response.status}`);
+        }
+        if (payload === null || payload === "") {
+            return undefined;
+        }
+        return unwrapData(payload);
+    }
+    catch (error) {
+        if (error instanceof ApiError) {
+            throw error;
+        }
+        if (error instanceof Error && error.name === "AbortError") {
+            throw new ApiError("Request timed out", {
+                status: 408,
+                code: "REQUEST_TIMEOUT",
+            });
+        }
+        throw new ApiError(error instanceof Error ? error.message : "Network error", {
+            status: 0,
+            code: "NETWORK_ERROR",
+        });
+    }
+    finally {
+        clearTimeout(timeout);
+        options.signal?.removeEventListener("abort", onExternalAbort);
+    }
+}
+/** SDK auth headers from host props: `email` + `apiKey` (+ optional `domain`). No Bearer. */
+export async function adminSdkRequest(baseUrl, path, credentials, options = {}) {
+    return httpRequest(baseUrl, path, null, {
+        ...options,
+        email: credentials.email,
+        apiKey: credentials.apiKey,
+        domain: credentials.domain ?? options.domain,
+    });
+}

package/dist/services/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./errors";
+export * from "./http";
+export * from "./pagination";
+export * from "./types";
+export * from "./public-client";
+export * from "./admin-client";
+export * from "./admin-sdk-client";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../app/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,7 @@
+export * from "./errors";
+export * from "./http";
+export * from "./pagination";
+export * from "./types";
+export * from "./public-client";
+export * from "./admin-client";
+export * from "./admin-sdk-client";

package/dist/services/pagination.d.ts

@@ -0,0 +1,4 @@
+import type { Paginated } from "./types";
+export declare function normalizePage<T>(payload: unknown, page: number, pageSize: number): Paginated<T>;
+export declare function slugify(value: string): string;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/services/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../app/services/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,SAAS,CAAC,CAAC,CAAC,CA2Bd;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C"}

package/dist/services/pagination.js

@@ -0,0 +1,32 @@
+export function normalizePage(payload, page, pageSize) {
+    if (Array.isArray(payload)) {
+        return {
+            items: payload,
+            page,
+            pageSize,
+            total: payload.length,
+        };
+    }
+    if (payload && typeof payload === "object") {
+        const record = payload;
+        const items = (record.items ??
+            record.results ??
+            record.data ??
+            []);
+        const resolvedItems = Array.isArray(items) ? items : [];
+        return {
+            items: resolvedItems,
+            page: Number(record.page ?? page) || page,
+            pageSize: Number(record.page_size ?? record.pageSize ?? pageSize) || pageSize,
+            total: Number(record.total ?? record.count ?? resolvedItems.length) || resolvedItems.length,
+        };
+    }
+    return { items: [], page, pageSize, total: 0 };
+}
+export function slugify(value) {
+    return value
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}

package/dist/services/public-client.d.ts

@@ -0,0 +1,23 @@
+import type { Blog, BlogClientConfig, BlogListParams, Category, Paginated, Tag } from "./types";
+/** Public/read-only API client. Auth via `email` + `apiKey` (+ optional `domain`) headers. */
+export declare class BlogClient {
+    private readonly config;
+    constructor(config: BlogClientConfig);
+    private request;
+    getBlogs(params?: BlogListParams): Promise<Paginated<Blog>>;
+    getBlogById(id: string): Promise<Blog>;
+    getBlogBySlug(slug: string): Promise<Blog>;
+    /** @deprecated Prefer getBlogBySlug */
+    getBlog(slug: string): Promise<Blog>;
+    searchBlogs(query: string, params?: BlogListParams): Promise<Paginated<Blog>>;
+    getFeaturedBlogs(limit?: number): Promise<Blog[]>;
+    getRelatedBlogs(blog: Pick<Blog, "id" | "category_id">, limit?: number): Promise<Blog[]>;
+    getCategories(): Promise<Category[]>;
+    getTags(): Promise<Tag[]>;
+    trackView(blogId: string, referrer?: string | null): Promise<unknown>;
+    getPopularBlogs(limit?: number): Promise<Array<{
+        blog_id: string;
+        views: number;
+    }>>;
+}
+//# sourceMappingURL=public-client.d.ts.map

package/dist/services/public-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-client.d.ts","sourceRoot":"","sources":["../../app/services/public-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,IAAI,EACJ,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,SAAS,EACT,GAAG,EACJ,MAAM,SAAS,CAAC;AAiBjB,8FAA8F;AAC9F,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,gBAAgB;IAErD,OAAO,CAAC,OAAO;IAUT,QAAQ,CAAC,MAAM,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAOrE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,uCAAuC;IACvC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9B,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAIjF,gBAAgB,CAAC,KAAK,SAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAU5C,eAAe,CACnB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,CAAC,EACtC,KAAK,SAAI,GACR,OAAO,CAAC,IAAI,EAAE,CAAC;IAeZ,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAOpC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAK/B,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrE,eAAe,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAGhF"}

package/dist/services/public-client.js

@@ -0,0 +1,94 @@
+import { httpRequest, toQuery } from "./http";
+import { normalizePage } from "./pagination";
+function blogQuery(params, page, pageSize) {
+    return toQuery({
+        page,
+        page_size: pageSize,
+        search: params.search,
+        status: params.status,
+        category_id: params.category_id,
+        tag_id: params.tag_id,
+        published_after: params.published_after,
+        published_before: params.published_before,
+        sort: params.sort,
+        order: params.order,
+    });
+}
+/** Public/read-only API client. Auth via `email` + `apiKey` (+ optional `domain`) headers. */
+export class BlogClient {
+    constructor(config) {
+        this.config = config;
+    }
+    request(path, options = {}) {
+        return httpRequest(this.config.apiUrl, path, null, {
+            timeoutMs: this.config.timeoutMs,
+            email: this.config.email,
+            apiKey: this.config.publicApiKey,
+            domain: this.config.domain,
+            ...options,
+        });
+    }
+    async getBlogs(params = {}) {
+        const page = params.page ?? 1;
+        const pageSize = params.page_size ?? 12;
+        const payload = await this.request(`/blogs${blogQuery(params, page, pageSize)}`);
+        return normalizePage(payload, page, pageSize);
+    }
+    getBlogById(id) {
+        return this.request(`/blogs/${encodeURIComponent(id)}`);
+    }
+    getBlogBySlug(slug) {
+        return this.request(`/blogs/slug/${encodeURIComponent(slug)}`);
+    }
+    /** @deprecated Prefer getBlogBySlug */
+    getBlog(slug) {
+        return this.getBlogBySlug(slug);
+    }
+    async searchBlogs(query, params = {}) {
+        return this.getBlogs({ ...params, search: query });
+    }
+    async getFeaturedBlogs(limit = 3) {
+        const page = await this.getBlogs({
+            page: 1,
+            page_size: limit,
+            sort: "published_at",
+            order: "desc",
+        });
+        return page.items;
+    }
+    async getRelatedBlogs(blog, limit = 3) {
+        if (!blog.category_id) {
+            return [];
+        }
+        const page = await this.getBlogs({
+            category_id: blog.category_id,
+            page: 1,
+            page_size: limit + 1,
+            sort: "published_at",
+            order: "desc",
+        });
+        return page.items.filter((item) => item.id !== blog.id).slice(0, limit);
+    }
+    async getCategories() {
+        const payload = await this.request("/categories");
+        return Array.isArray(payload)
+            ? payload
+            : normalizePage(payload, 1, 100).items;
+    }
+    async getTags() {
+        const payload = await this.request("/tags");
+        return Array.isArray(payload) ? payload : normalizePage(payload, 1, 100).items;
+    }
+    trackView(blogId, referrer) {
+        return this.request("/analytics/views", {
+            method: "POST",
+            body: {
+                blog_id: blogId,
+                referrer: referrer ?? undefined,
+            },
+        });
+    }
+    getPopularBlogs(limit = 10) {
+        return this.request(`/analytics/popular${toQuery({ limit })}`);
+    }
+}