@utilsy/cms-nextjs 0.1.0

package/dist/react.cjs

@@ -0,0 +1,148 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/react/context.ts
+var CmsClientContext = react.createContext(null);
+function CmsProvider({ client, children }) {
+  return /* @__PURE__ */ jsxRuntime.jsx(CmsClientContext.Provider, { value: client, children });
+}
+function useCmsClient() {
+  const client = react.useContext(CmsClientContext);
+  if (!client) {
+    throw new Error("useCmsClient must be used within a <CmsProvider client={...}>");
+  }
+  return client;
+}
+var DEFAULT_STORAGE_KEY = "utilsy_cms_visitor_id";
+function useVisitorId(options) {
+  const storageKey = options?.storageKey ?? DEFAULT_STORAGE_KEY;
+  const [visitorId, setVisitorId] = react.useState("");
+  react.useEffect(() => {
+    if (typeof window === "undefined") return;
+    let id = localStorage.getItem(storageKey);
+    if (!id) {
+      id = typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `v-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+      localStorage.setItem(storageKey, id);
+    }
+    setVisitorId(id);
+  }, [storageKey]);
+  return visitorId;
+}
+function getVisitorId(storageKey = DEFAULT_STORAGE_KEY) {
+  if (typeof window === "undefined") return "";
+  let id = localStorage.getItem(storageKey);
+  if (!id) {
+    id = typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `v-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    localStorage.setItem(storageKey, id);
+  }
+  return id;
+}
+function useBlogEngagement(postId, options) {
+  const client = useCmsClient();
+  const [engagement, setEngagement] = react.useState(null);
+  const [loading, setLoading] = react.useState(true);
+  const [error, setError] = react.useState(null);
+  const refetch = react.useCallback(async () => {
+    if (!postId) return;
+    setLoading(true);
+    setError(null);
+    try {
+      const visitorId = options?.visitorId ?? (typeof window !== "undefined" ? getVisitorId(options?.storageKey) : void 0);
+      const data = await client.blog.getEngagement(postId, { visitorId });
+      setEngagement(data);
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error(String(e)));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, postId, options?.visitorId, options?.storageKey]);
+  react.useEffect(() => {
+    refetch();
+  }, [refetch]);
+  return { engagement, loading, error, refetch };
+}
+function useBlogLike(postId, options) {
+  const client = useCmsClient();
+  const { engagement, loading: engagementLoading, refetch } = useBlogEngagement(postId, options);
+  const [toggling, setToggling] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const toggle = react.useCallback(async () => {
+    if (!postId) return;
+    setToggling(true);
+    setError(null);
+    try {
+      const visitorId = options?.visitorId ?? (typeof window !== "undefined" ? getVisitorId(options?.storageKey) : void 0);
+      await client.blog.toggleLike(postId, { visitorId });
+      await refetch();
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error(String(e)));
+    } finally {
+      setToggling(false);
+    }
+  }, [client, postId, options?.visitorId, options?.storageKey, refetch]);
+  return {
+    liked: engagement?.likedByMe ?? false,
+    likeCount: engagement?.likeCount ?? 0,
+    viewCount: engagement?.viewCount ?? 0,
+    commentCount: engagement?.commentCount ?? 0,
+    loading: engagementLoading,
+    toggling,
+    error,
+    toggle,
+    refetch
+  };
+}
+function useBlogComments(postId) {
+  const client = useCmsClient();
+  const [comments, setComments] = react.useState([]);
+  const [loading, setLoading] = react.useState(true);
+  const [submitting, setSubmitting] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const refetch = react.useCallback(async () => {
+    if (!postId) return;
+    setLoading(true);
+    setError(null);
+    try {
+      const data = await client.blog.listMappedComments(postId);
+      setComments(data ?? []);
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error(String(e)));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, postId]);
+  react.useEffect(() => {
+    refetch();
+  }, [refetch]);
+  const submitComment = react.useCallback(
+    async (input) => {
+      if (!postId) return;
+      setSubmitting(true);
+      setError(null);
+      try {
+        await client.blog.createComment(postId, input);
+        await refetch();
+      } catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        setError(err);
+        throw err;
+      } finally {
+        setSubmitting(false);
+      }
+    },
+    [client, postId, refetch]
+  );
+  return { comments, loading, submitting, error, refetch, submitComment };
+}
+
+exports.CmsProvider = CmsProvider;
+exports.getVisitorId = getVisitorId;
+exports.useBlogComments = useBlogComments;
+exports.useBlogEngagement = useBlogEngagement;
+exports.useBlogLike = useBlogLike;
+exports.useCmsClient = useCmsClient;
+exports.useVisitorId = useVisitorId;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/context.ts","../src/react/provider.tsx","../src/react/use-cms-client.ts","../src/react/use-visitor-id.ts","../src/react/use-blog-engagement.ts","../src/react/use-blog-like.ts","../src/react/use-blog-comments.ts"],"names":["createContext","useContext","useState","useEffect","useCallback"],"mappings":"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","file":"react.cjs","sourcesContent":["import { createContext } from \"react\";\nimport type { CmsClient } from \"../client.js\";\n\nexport const CmsClientContext = createContext<CmsClient | null>(null);\n","\"use client\";\n\nimport type { ReactNode } from \"react\";\nimport type { CmsClient } from \"../client.js\";\nimport { CmsClientContext } from \"./context.js\";\n\nexport type CmsProviderProps = {\n  client: CmsClient;\n  children: ReactNode;\n};\n\nexport function CmsProvider({ client, children }: CmsProviderProps) {\n  return <CmsClientContext.Provider value={client}>{children}</CmsClientContext.Provider>;\n}\n","\"use client\";\n\nimport { useContext } from \"react\";\nimport type { CmsClient } from \"../client.js\";\nimport { CmsClientContext } from \"./context.js\";\n\nexport function useCmsClient(): CmsClient {\n  const client = useContext(CmsClientContext);\n  if (!client) {\n    throw new Error(\"useCmsClient must be used within a <CmsProvider client={...}>\");\n  }\n  return client;\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\nconst DEFAULT_STORAGE_KEY = \"utilsy_cms_visitor_id\";\n\nexport type UseVisitorIdOptions = {\n  storageKey?: string;\n};\n\nexport function useVisitorId(options?: UseVisitorIdOptions): string {\n  const storageKey = options?.storageKey ?? DEFAULT_STORAGE_KEY;\n  const [visitorId, setVisitorId] = useState(\"\");\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n    let id = localStorage.getItem(storageKey);\n    if (!id) {\n      id =\n        typeof crypto !== \"undefined\" && \"randomUUID\" in crypto\n          ? crypto.randomUUID()\n          : `v-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n      localStorage.setItem(storageKey, id);\n    }\n    setVisitorId(id);\n  }, [storageKey]);\n\n  return visitorId;\n}\n\n/** Non-hook helper for event handlers */\nexport function getVisitorId(storageKey = DEFAULT_STORAGE_KEY): string {\n  if (typeof window === \"undefined\") return \"\";\n  let id = localStorage.getItem(storageKey);\n  if (!id) {\n    id =\n      typeof crypto !== \"undefined\" && \"randomUUID\" in crypto\n        ? crypto.randomUUID()\n        : `v-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n    localStorage.setItem(storageKey, id);\n  }\n  return id;\n}\n","\"use client\";\n\nimport { useCallback, useEffect, useState } from \"react\";\nimport type { BlogEngagement } from \"../blog/types.js\";\nimport { useCmsClient } from \"./use-cms-client.js\";\nimport { getVisitorId } from \"./use-visitor-id.js\";\n\nexport type UseBlogEngagementOptions = {\n  visitorId?: string;\n  storageKey?: string;\n};\n\nexport function useBlogEngagement(postId: string, options?: UseBlogEngagementOptions) {\n  const client = useCmsClient();\n  const [engagement, setEngagement] = useState<BlogEngagement | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const refetch = useCallback(async () => {\n    if (!postId) return;\n    setLoading(true);\n    setError(null);\n    try {\n      const visitorId =\n        options?.visitorId ??\n        (typeof window !== \"undefined\" ? getVisitorId(options?.storageKey) : undefined);\n      const data = await client.blog.getEngagement(postId, { visitorId });\n      setEngagement(data);\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n    } finally {\n      setLoading(false);\n    }\n  }, [client, postId, options?.visitorId, options?.storageKey]);\n\n  useEffect(() => {\n    refetch();\n  }, [refetch]);\n\n  return { engagement, loading, error, refetch };\n}\n","\"use client\";\n\nimport { useCallback, useState } from \"react\";\nimport { useBlogEngagement } from \"./use-blog-engagement.js\";\nimport { useCmsClient } from \"./use-cms-client.js\";\nimport { getVisitorId } from \"./use-visitor-id.js\";\n\nexport type UseBlogLikeOptions = {\n  visitorId?: string;\n  storageKey?: string;\n};\n\nexport function useBlogLike(postId: string, options?: UseBlogLikeOptions) {\n  const client = useCmsClient();\n  const { engagement, loading: engagementLoading, refetch } = useBlogEngagement(postId, options);\n  const [toggling, setToggling] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const toggle = useCallback(async () => {\n    if (!postId) return;\n    setToggling(true);\n    setError(null);\n    try {\n      const visitorId =\n        options?.visitorId ??\n        (typeof window !== \"undefined\" ? getVisitorId(options?.storageKey) : undefined);\n      await client.blog.toggleLike(postId, { visitorId });\n      await refetch();\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n    } finally {\n      setToggling(false);\n    }\n  }, [client, postId, options?.visitorId, options?.storageKey, refetch]);\n\n  return {\n    liked: engagement?.likedByMe ?? false,\n    likeCount: engagement?.likeCount ?? 0,\n    viewCount: engagement?.viewCount ?? 0,\n    commentCount: engagement?.commentCount ?? 0,\n    loading: engagementLoading,\n    toggling,\n    error,\n    toggle,\n    refetch,\n  };\n}\n","\"use client\";\n\nimport { useCallback, useEffect, useState } from \"react\";\nimport type { BlogComment, CreateBlogCommentInput } from \"../blog/types.js\";\nimport { useCmsClient } from \"./use-cms-client.js\";\n\nexport function useBlogComments(postId: string) {\n  const client = useCmsClient();\n  const [comments, setComments] = useState<BlogComment[]>([]);\n  const [loading, setLoading] = useState(true);\n  const [submitting, setSubmitting] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const refetch = useCallback(async () => {\n    if (!postId) return;\n    setLoading(true);\n    setError(null);\n    try {\n      const data = await client.blog.listMappedComments(postId);\n      setComments(data ?? []);\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n    } finally {\n      setLoading(false);\n    }\n  }, [client, postId]);\n\n  useEffect(() => {\n    refetch();\n  }, [refetch]);\n\n  const submitComment = useCallback(\n    async (input: CreateBlogCommentInput) => {\n      if (!postId) return;\n      setSubmitting(true);\n      setError(null);\n      try {\n        await client.blog.createComment(postId, input);\n        await refetch();\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        setSubmitting(false);\n      }\n    },\n    [client, postId, refetch],\n  );\n\n  return { comments, loading, submitting, error, refetch, submitComment };\n}\n"]}

package/dist/react.d.cts

@@ -0,0 +1,56 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { l as CmsClient, e as BlogEngagement, c as BlogComment, n as CreateBlogCommentInput } from './client-C3E94syg.cjs';
+
+type CmsProviderProps = {
+    client: CmsClient;
+    children: ReactNode;
+};
+declare function CmsProvider({ client, children }: CmsProviderProps): react_jsx_runtime.JSX.Element;
+
+declare function useCmsClient(): CmsClient;
+
+type UseVisitorIdOptions = {
+    storageKey?: string;
+};
+declare function useVisitorId(options?: UseVisitorIdOptions): string;
+/** Non-hook helper for event handlers */
+declare function getVisitorId(storageKey?: string): string;
+
+type UseBlogEngagementOptions = {
+    visitorId?: string;
+    storageKey?: string;
+};
+declare function useBlogEngagement(postId: string, options?: UseBlogEngagementOptions): {
+    engagement: BlogEngagement | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+
+type UseBlogLikeOptions = {
+    visitorId?: string;
+    storageKey?: string;
+};
+declare function useBlogLike(postId: string, options?: UseBlogLikeOptions): {
+    liked: boolean;
+    likeCount: number;
+    viewCount: number;
+    commentCount: number;
+    loading: boolean;
+    toggling: boolean;
+    error: Error | null;
+    toggle: () => Promise<void>;
+    refetch: () => Promise<void>;
+};
+
+declare function useBlogComments(postId: string): {
+    comments: BlogComment[];
+    loading: boolean;
+    submitting: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+    submitComment: (input: CreateBlogCommentInput) => Promise<void>;
+};
+
+export { CmsProvider, type CmsProviderProps, type UseBlogEngagementOptions, type UseBlogLikeOptions, type UseVisitorIdOptions, getVisitorId, useBlogComments, useBlogEngagement, useBlogLike, useCmsClient, useVisitorId };

package/dist/react.d.ts

@@ -0,0 +1,56 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { l as CmsClient, e as BlogEngagement, c as BlogComment, n as CreateBlogCommentInput } from './client-C3E94syg.js';
+
+type CmsProviderProps = {
+    client: CmsClient;
+    children: ReactNode;
+};
+declare function CmsProvider({ client, children }: CmsProviderProps): react_jsx_runtime.JSX.Element;
+
+declare function useCmsClient(): CmsClient;
+
+type UseVisitorIdOptions = {
+    storageKey?: string;
+};
+declare function useVisitorId(options?: UseVisitorIdOptions): string;
+/** Non-hook helper for event handlers */
+declare function getVisitorId(storageKey?: string): string;
+
+type UseBlogEngagementOptions = {
+    visitorId?: string;
+    storageKey?: string;
+};
+declare function useBlogEngagement(postId: string, options?: UseBlogEngagementOptions): {
+    engagement: BlogEngagement | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+
+type UseBlogLikeOptions = {
+    visitorId?: string;
+    storageKey?: string;
+};
+declare function useBlogLike(postId: string, options?: UseBlogLikeOptions): {
+    liked: boolean;
+    likeCount: number;
+    viewCount: number;
+    commentCount: number;
+    loading: boolean;
+    toggling: boolean;
+    error: Error | null;
+    toggle: () => Promise<void>;
+    refetch: () => Promise<void>;
+};
+
+declare function useBlogComments(postId: string): {
+    comments: BlogComment[];
+    loading: boolean;
+    submitting: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+    submitComment: (input: CreateBlogCommentInput) => Promise<void>;
+};
+
+export { CmsProvider, type CmsProviderProps, type UseBlogEngagementOptions, type UseBlogLikeOptions, type UseVisitorIdOptions, getVisitorId, useBlogComments, useBlogEngagement, useBlogLike, useCmsClient, useVisitorId };

package/dist/react.js

@@ -0,0 +1,140 @@
+import { createContext, useContext, useState, useEffect, useCallback } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/react/context.ts
+var CmsClientContext = createContext(null);
+function CmsProvider({ client, children }) {
+  return /* @__PURE__ */ jsx(CmsClientContext.Provider, { value: client, children });
+}
+function useCmsClient() {
+  const client = useContext(CmsClientContext);
+  if (!client) {
+    throw new Error("useCmsClient must be used within a <CmsProvider client={...}>");
+  }
+  return client;
+}
+var DEFAULT_STORAGE_KEY = "utilsy_cms_visitor_id";
+function useVisitorId(options) {
+  const storageKey = options?.storageKey ?? DEFAULT_STORAGE_KEY;
+  const [visitorId, setVisitorId] = useState("");
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    let id = localStorage.getItem(storageKey);
+    if (!id) {
+      id = typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `v-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+      localStorage.setItem(storageKey, id);
+    }
+    setVisitorId(id);
+  }, [storageKey]);
+  return visitorId;
+}
+function getVisitorId(storageKey = DEFAULT_STORAGE_KEY) {
+  if (typeof window === "undefined") return "";
+  let id = localStorage.getItem(storageKey);
+  if (!id) {
+    id = typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `v-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    localStorage.setItem(storageKey, id);
+  }
+  return id;
+}
+function useBlogEngagement(postId, options) {
+  const client = useCmsClient();
+  const [engagement, setEngagement] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const refetch = useCallback(async () => {
+    if (!postId) return;
+    setLoading(true);
+    setError(null);
+    try {
+      const visitorId = options?.visitorId ?? (typeof window !== "undefined" ? getVisitorId(options?.storageKey) : void 0);
+      const data = await client.blog.getEngagement(postId, { visitorId });
+      setEngagement(data);
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error(String(e)));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, postId, options?.visitorId, options?.storageKey]);
+  useEffect(() => {
+    refetch();
+  }, [refetch]);
+  return { engagement, loading, error, refetch };
+}
+function useBlogLike(postId, options) {
+  const client = useCmsClient();
+  const { engagement, loading: engagementLoading, refetch } = useBlogEngagement(postId, options);
+  const [toggling, setToggling] = useState(false);
+  const [error, setError] = useState(null);
+  const toggle = useCallback(async () => {
+    if (!postId) return;
+    setToggling(true);
+    setError(null);
+    try {
+      const visitorId = options?.visitorId ?? (typeof window !== "undefined" ? getVisitorId(options?.storageKey) : void 0);
+      await client.blog.toggleLike(postId, { visitorId });
+      await refetch();
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error(String(e)));
+    } finally {
+      setToggling(false);
+    }
+  }, [client, postId, options?.visitorId, options?.storageKey, refetch]);
+  return {
+    liked: engagement?.likedByMe ?? false,
+    likeCount: engagement?.likeCount ?? 0,
+    viewCount: engagement?.viewCount ?? 0,
+    commentCount: engagement?.commentCount ?? 0,
+    loading: engagementLoading,
+    toggling,
+    error,
+    toggle,
+    refetch
+  };
+}
+function useBlogComments(postId) {
+  const client = useCmsClient();
+  const [comments, setComments] = useState([]);
+  const [loading, setLoading] = useState(true);
+  const [submitting, setSubmitting] = useState(false);
+  const [error, setError] = useState(null);
+  const refetch = useCallback(async () => {
+    if (!postId) return;
+    setLoading(true);
+    setError(null);
+    try {
+      const data = await client.blog.listMappedComments(postId);
+      setComments(data ?? []);
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error(String(e)));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, postId]);
+  useEffect(() => {
+    refetch();
+  }, [refetch]);
+  const submitComment = useCallback(
+    async (input) => {
+      if (!postId) return;
+      setSubmitting(true);
+      setError(null);
+      try {
+        await client.blog.createComment(postId, input);
+        await refetch();
+      } catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        setError(err);
+        throw err;
+      } finally {
+        setSubmitting(false);
+      }
+    },
+    [client, postId, refetch]
+  );
+  return { comments, loading, submitting, error, refetch, submitComment };
+}
+
+export { CmsProvider, getVisitorId, useBlogComments, useBlogEngagement, useBlogLike, useCmsClient, useVisitorId };
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/context.ts","../src/react/provider.tsx","../src/react/use-cms-client.ts","../src/react/use-visitor-id.ts","../src/react/use-blog-engagement.ts","../src/react/use-blog-like.ts","../src/react/use-blog-comments.ts"],"names":["useState","useEffect","useCallback"],"mappings":"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","file":"react.js","sourcesContent":["import { createContext } from \"react\";\nimport type { CmsClient } from \"../client.js\";\n\nexport const CmsClientContext = createContext<CmsClient | null>(null);\n","\"use client\";\n\nimport type { ReactNode } from \"react\";\nimport type { CmsClient } from \"../client.js\";\nimport { CmsClientContext } from \"./context.js\";\n\nexport type CmsProviderProps = {\n  client: CmsClient;\n  children: ReactNode;\n};\n\nexport function CmsProvider({ client, children }: CmsProviderProps) {\n  return <CmsClientContext.Provider value={client}>{children}</CmsClientContext.Provider>;\n}\n","\"use client\";\n\nimport { useContext } from \"react\";\nimport type { CmsClient } from \"../client.js\";\nimport { CmsClientContext } from \"./context.js\";\n\nexport function useCmsClient(): CmsClient {\n  const client = useContext(CmsClientContext);\n  if (!client) {\n    throw new Error(\"useCmsClient must be used within a <CmsProvider client={...}>\");\n  }\n  return client;\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\nconst DEFAULT_STORAGE_KEY = \"utilsy_cms_visitor_id\";\n\nexport type UseVisitorIdOptions = {\n  storageKey?: string;\n};\n\nexport function useVisitorId(options?: UseVisitorIdOptions): string {\n  const storageKey = options?.storageKey ?? DEFAULT_STORAGE_KEY;\n  const [visitorId, setVisitorId] = useState(\"\");\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n    let id = localStorage.getItem(storageKey);\n    if (!id) {\n      id =\n        typeof crypto !== \"undefined\" && \"randomUUID\" in crypto\n          ? crypto.randomUUID()\n          : `v-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n      localStorage.setItem(storageKey, id);\n    }\n    setVisitorId(id);\n  }, [storageKey]);\n\n  return visitorId;\n}\n\n/** Non-hook helper for event handlers */\nexport function getVisitorId(storageKey = DEFAULT_STORAGE_KEY): string {\n  if (typeof window === \"undefined\") return \"\";\n  let id = localStorage.getItem(storageKey);\n  if (!id) {\n    id =\n      typeof crypto !== \"undefined\" && \"randomUUID\" in crypto\n        ? crypto.randomUUID()\n        : `v-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n    localStorage.setItem(storageKey, id);\n  }\n  return id;\n}\n","\"use client\";\n\nimport { useCallback, useEffect, useState } from \"react\";\nimport type { BlogEngagement } from \"../blog/types.js\";\nimport { useCmsClient } from \"./use-cms-client.js\";\nimport { getVisitorId } from \"./use-visitor-id.js\";\n\nexport type UseBlogEngagementOptions = {\n  visitorId?: string;\n  storageKey?: string;\n};\n\nexport function useBlogEngagement(postId: string, options?: UseBlogEngagementOptions) {\n  const client = useCmsClient();\n  const [engagement, setEngagement] = useState<BlogEngagement | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const refetch = useCallback(async () => {\n    if (!postId) return;\n    setLoading(true);\n    setError(null);\n    try {\n      const visitorId =\n        options?.visitorId ??\n        (typeof window !== \"undefined\" ? getVisitorId(options?.storageKey) : undefined);\n      const data = await client.blog.getEngagement(postId, { visitorId });\n      setEngagement(data);\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n    } finally {\n      setLoading(false);\n    }\n  }, [client, postId, options?.visitorId, options?.storageKey]);\n\n  useEffect(() => {\n    refetch();\n  }, [refetch]);\n\n  return { engagement, loading, error, refetch };\n}\n","\"use client\";\n\nimport { useCallback, useState } from \"react\";\nimport { useBlogEngagement } from \"./use-blog-engagement.js\";\nimport { useCmsClient } from \"./use-cms-client.js\";\nimport { getVisitorId } from \"./use-visitor-id.js\";\n\nexport type UseBlogLikeOptions = {\n  visitorId?: string;\n  storageKey?: string;\n};\n\nexport function useBlogLike(postId: string, options?: UseBlogLikeOptions) {\n  const client = useCmsClient();\n  const { engagement, loading: engagementLoading, refetch } = useBlogEngagement(postId, options);\n  const [toggling, setToggling] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const toggle = useCallback(async () => {\n    if (!postId) return;\n    setToggling(true);\n    setError(null);\n    try {\n      const visitorId =\n        options?.visitorId ??\n        (typeof window !== \"undefined\" ? getVisitorId(options?.storageKey) : undefined);\n      await client.blog.toggleLike(postId, { visitorId });\n      await refetch();\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n    } finally {\n      setToggling(false);\n    }\n  }, [client, postId, options?.visitorId, options?.storageKey, refetch]);\n\n  return {\n    liked: engagement?.likedByMe ?? false,\n    likeCount: engagement?.likeCount ?? 0,\n    viewCount: engagement?.viewCount ?? 0,\n    commentCount: engagement?.commentCount ?? 0,\n    loading: engagementLoading,\n    toggling,\n    error,\n    toggle,\n    refetch,\n  };\n}\n","\"use client\";\n\nimport { useCallback, useEffect, useState } from \"react\";\nimport type { BlogComment, CreateBlogCommentInput } from \"../blog/types.js\";\nimport { useCmsClient } from \"./use-cms-client.js\";\n\nexport function useBlogComments(postId: string) {\n  const client = useCmsClient();\n  const [comments, setComments] = useState<BlogComment[]>([]);\n  const [loading, setLoading] = useState(true);\n  const [submitting, setSubmitting] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const refetch = useCallback(async () => {\n    if (!postId) return;\n    setLoading(true);\n    setError(null);\n    try {\n      const data = await client.blog.listMappedComments(postId);\n      setComments(data ?? []);\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n    } finally {\n      setLoading(false);\n    }\n  }, [client, postId]);\n\n  useEffect(() => {\n    refetch();\n  }, [refetch]);\n\n  const submitComment = useCallback(\n    async (input: CreateBlogCommentInput) => {\n      if (!postId) return;\n      setSubmitting(true);\n      setError(null);\n      try {\n        await client.blog.createComment(postId, input);\n        await refetch();\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        setSubmitting(false);\n      }\n    },\n    [client, postId, refetch],\n  );\n\n  return { comments, loading, submitting, error, refetch, submitComment };\n}\n"]}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@utilsy/cms-nextjs",
+  "version": "0.1.0",
+  "description": "Headless Next.js SDK for Utilsy gateway-cms public blog APIs",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./react": {
+      "import": {
+        "types": "./dist/react.d.ts",
+        "default": "./dist/react.js"
+      },
+      "require": {
+        "types": "./dist/react.d.cts",
+        "default": "./dist/react.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0",
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.0.0",
+    "jsdom": "^26.1.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.0"
+  },
+  "keywords": [
+    "utilsy",
+    "cms",
+    "nextjs",
+    "blog",
+    "headless"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/utilsy/utilsy-cms-nextjs-sdk"
+  }
+}