@asteroidcms/core-utils 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { PropsWithChildren } from 'react';
 import * as _apollo_client from '@apollo/client';
-import { InMemoryCacheConfig, ApolloClientOptions, ApolloClient } from '@apollo/client';
+import { InMemoryCacheConfig, ApolloClientOptions, ApolloClient, DocumentNode } from '@apollo/client';
 import { useMutation } from '@apollo/client/react';
 
 type AsteroidCMSConfig = {
@@ -65,32 +65,32 @@ declare module "@apollo/client" {
 }
 declare function createApolloClient(config: AsteroidCMSConfig): ApolloClient;
 
-type FieldSelector$1 = string | {
+type FieldSelector$2 = string | {
     field: string;
     as?: string;
 };
-type ReferenceExpansion$1 = {
+type ReferenceExpansion$2 = {
     field: string;
     as?: string;
     single?: boolean;
-    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
+    select?: readonly (FieldSelector$2 | ReferenceExpansion$2)[];
 };
-type ContentStatus = "DRAFT" | "PUBLISHED" | "ARCHIVED";
-type CmsSearchCondition = {
+type ContentStatus$1 = "DRAFT" | "PUBLISHED" | "ARCHIVED";
+type CmsSearchCondition$1 = {
     field: string;
     value: string;
     mode?: string;
 };
-type UseCmsContentOptions = {
+type UseCmsContentOptions$1 = {
     schema_slug: string;
     entrySlug?: string;
-    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
+    select?: readonly (FieldSelector$2 | ReferenceExpansion$2)[];
     fullData?: boolean;
     limit?: number;
     offset?: number;
-    status?: ContentStatus;
+    status?: ContentStatus$1;
     filter?: Record<string, string | number | boolean | null>;
-    search?: CmsSearchCondition[];
+    search?: CmsSearchCondition$1[];
     variables?: Record<string, any>;
 };
 /**
@@ -99,7 +99,7 @@ type UseCmsContentOptions = {
  * Supports single-entry fetches (`entrySlug`) and paginated/filtered lists,
  * with arbitrarily nested reference expansion and field aliasing.
  */
-declare function useCmsContent<T = unknown>({ schema_slug, entrySlug, select, fullData, limit, offset, status, filter, search, variables, }: UseCmsContentOptions): {
+declare function useCmsContent<T = unknown>({ schema_slug, entrySlug, select, fullData, limit, offset, status, filter, search, variables, }: UseCmsContentOptions$1): {
     client: _apollo_client.ApolloClient;
     observable: _apollo_client.ObservableQuery<unknown, _apollo_client.OperationVariables>;
     previousData?: unknown;
@@ -167,23 +167,23 @@ declare function useCmsContent<T = unknown>({ schema_slug, entrySlug, select, fu
     data: T | undefined;
 };
 
-type FieldSelector = string | {
+type FieldSelector$1 = string | {
     field: string;
     as?: string;
     single?: boolean;
-    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
 };
-type ReferenceExpansion = {
+type ReferenceExpansion$1 = {
     field: string;
     as?: string;
     single?: boolean;
-    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
 };
 type MutationType = "create" | "update" | "delete";
 type UseCmsMutateOptions = {
     schema_slug: string;
     entrySlug?: string;
-    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
     fullData?: boolean;
     mutationType?: MutationType;
     entryId?: string;
@@ -205,6 +205,42 @@ declare function useCmsMutate<TData = unknown>({ schema_slug, select, fullData,
     }, _apollo_client.ApolloCache, "none">;
 };
 
+type FieldSelector = string | {
+    field: string;
+    as?: string;
+};
+type ReferenceExpansion = {
+    field: string;
+    as?: string;
+    single?: boolean;
+    select?: readonly (FieldSelector | ReferenceExpansion)[];
+};
+type ContentStatus = "DRAFT" | "PUBLISHED" | "ARCHIVED";
+type CmsSearchCondition = {
+    field: string;
+    value: string;
+    mode?: string;
+};
+type UseCmsContentOptions = {
+    schema_slug: string;
+    entrySlug?: string;
+    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    fullData?: boolean;
+    limit?: number;
+    offset?: number;
+    status?: ContentStatus;
+    filter?: Record<string, string | number | boolean | null>;
+    search?: CmsSearchCondition[];
+    variables?: Record<string, unknown>;
+};
+declare function buildCmsQuery({ schema_slug, entrySlug, select, fullData, limit, offset, status, filter, search, variables, }: UseCmsContentOptions): {
+    query: DocumentNode;
+    variables: Record<string, unknown>;
+    isSingle: boolean;
+};
+
+declare function fetchCmsContent<T>(getClient: () => ApolloClient, opts: UseCmsContentOptions): Promise<T>;
+
 /**
  * Build a canonical media URL from an asset id. Pass `cmsUrl` explicitly when
  * calling outside of React (e.g. SSR loaders, scripts). Inside components,
@@ -217,6 +253,38 @@ declare function cmsImage(id: string | undefined, options: {
 /** Hook variant that pulls `cmsUrl`/`mediaPath` from the provider. */
 declare function useCmsImage(): (id?: string) => string;
 
+type ReadTimeUnit = "short" | "long";
+interface GetContentReadTimeOptions {
+    /**
+     * Average words read per minute
+     * @default 200
+     */
+    wordsPerMinute?: number;
+    /**
+     * Output style
+     * short => "3 min read"
+     * long => "3 minutes read"
+     *
+     * @default "short"
+     */
+    format?: ReadTimeUnit;
+    /**
+     * Round mode for minutes
+     * ceil => always round up
+     * round => normal rounding
+     * floor => round down
+     *
+     * @default "ceil"
+     */
+    round?: "ceil" | "round" | "floor";
+    /**
+     * Minimum minutes returned
+     * @default 1
+     */
+    minMinutes?: number;
+}
+declare function getContentReadTime(content: string, options?: GetContentReadTimeOptions): string;
+
 /**
  * Portable rich-text parser for CMS content.
  *
@@ -263,4 +331,4 @@ declare function RichTextContent({ html, classMap, as, className, }: RichTextCon
     };
 }, HTMLElement>;
 
-export { type AsteroidCMSConfig, AsteroidCMSProvider, type AsteroidCMSProviderProps, type ParseRichTextOptions, type ResolvedAsteroidCMSConfig, type RichTextClassKey, type RichTextClassMap, RichTextContent, type UseCmsContentOptions, type UseCmsMutateOptions, cmsImage, createApolloClient, parseRichText, removeEmptyParagraphs, useAsteroidCMSConfig, useCmsContent, useCmsImage, useCmsMutate };
+export { type AsteroidCMSConfig, AsteroidCMSProvider, type AsteroidCMSProviderProps, type CmsSearchCondition, type ContentStatus, type FieldSelector, type ParseRichTextOptions, type ReferenceExpansion, type ResolvedAsteroidCMSConfig, type RichTextClassKey, type RichTextClassMap, RichTextContent, type UseCmsContentOptions$1 as UseCmsContentOptions, type UseCmsMutateOptions, buildCmsQuery, cmsImage, createApolloClient, fetchCmsContent, getContentReadTime, parseRichText, removeEmptyParagraphs, useAsteroidCMSConfig, useCmsContent, useCmsImage, useCmsMutate };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { PropsWithChildren } from 'react';
 import * as _apollo_client from '@apollo/client';
-import { InMemoryCacheConfig, ApolloClientOptions, ApolloClient } from '@apollo/client';
+import { InMemoryCacheConfig, ApolloClientOptions, ApolloClient, DocumentNode } from '@apollo/client';
 import { useMutation } from '@apollo/client/react';
 
 type AsteroidCMSConfig = {
@@ -65,32 +65,32 @@ declare module "@apollo/client" {
 }
 declare function createApolloClient(config: AsteroidCMSConfig): ApolloClient;
 
-type FieldSelector$1 = string | {
+type FieldSelector$2 = string | {
     field: string;
     as?: string;
 };
-type ReferenceExpansion$1 = {
+type ReferenceExpansion$2 = {
     field: string;
     as?: string;
     single?: boolean;
-    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
+    select?: readonly (FieldSelector$2 | ReferenceExpansion$2)[];
 };
-type ContentStatus = "DRAFT" | "PUBLISHED" | "ARCHIVED";
-type CmsSearchCondition = {
+type ContentStatus$1 = "DRAFT" | "PUBLISHED" | "ARCHIVED";
+type CmsSearchCondition$1 = {
     field: string;
     value: string;
     mode?: string;
 };
-type UseCmsContentOptions = {
+type UseCmsContentOptions$1 = {
     schema_slug: string;
     entrySlug?: string;
-    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
+    select?: readonly (FieldSelector$2 | ReferenceExpansion$2)[];
     fullData?: boolean;
     limit?: number;
     offset?: number;
-    status?: ContentStatus;
+    status?: ContentStatus$1;
     filter?: Record<string, string | number | boolean | null>;
-    search?: CmsSearchCondition[];
+    search?: CmsSearchCondition$1[];
     variables?: Record<string, any>;
 };
 /**
@@ -99,7 +99,7 @@ type UseCmsContentOptions = {
  * Supports single-entry fetches (`entrySlug`) and paginated/filtered lists,
  * with arbitrarily nested reference expansion and field aliasing.
  */
-declare function useCmsContent<T = unknown>({ schema_slug, entrySlug, select, fullData, limit, offset, status, filter, search, variables, }: UseCmsContentOptions): {
+declare function useCmsContent<T = unknown>({ schema_slug, entrySlug, select, fullData, limit, offset, status, filter, search, variables, }: UseCmsContentOptions$1): {
     client: _apollo_client.ApolloClient;
     observable: _apollo_client.ObservableQuery<unknown, _apollo_client.OperationVariables>;
     previousData?: unknown;
@@ -167,23 +167,23 @@ declare function useCmsContent<T = unknown>({ schema_slug, entrySlug, select, fu
     data: T | undefined;
 };
 
-type FieldSelector = string | {
+type FieldSelector$1 = string | {
     field: string;
     as?: string;
     single?: boolean;
-    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
 };
-type ReferenceExpansion = {
+type ReferenceExpansion$1 = {
     field: string;
     as?: string;
     single?: boolean;
-    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
 };
 type MutationType = "create" | "update" | "delete";
 type UseCmsMutateOptions = {
     schema_slug: string;
     entrySlug?: string;
-    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
     fullData?: boolean;
     mutationType?: MutationType;
     entryId?: string;
@@ -205,6 +205,42 @@ declare function useCmsMutate<TData = unknown>({ schema_slug, select, fullData,
     }, _apollo_client.ApolloCache, "none">;
 };
 
+type FieldSelector = string | {
+    field: string;
+    as?: string;
+};
+type ReferenceExpansion = {
+    field: string;
+    as?: string;
+    single?: boolean;
+    select?: readonly (FieldSelector | ReferenceExpansion)[];
+};
+type ContentStatus = "DRAFT" | "PUBLISHED" | "ARCHIVED";
+type CmsSearchCondition = {
+    field: string;
+    value: string;
+    mode?: string;
+};
+type UseCmsContentOptions = {
+    schema_slug: string;
+    entrySlug?: string;
+    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    fullData?: boolean;
+    limit?: number;
+    offset?: number;
+    status?: ContentStatus;
+    filter?: Record<string, string | number | boolean | null>;
+    search?: CmsSearchCondition[];
+    variables?: Record<string, unknown>;
+};
+declare function buildCmsQuery({ schema_slug, entrySlug, select, fullData, limit, offset, status, filter, search, variables, }: UseCmsContentOptions): {
+    query: DocumentNode;
+    variables: Record<string, unknown>;
+    isSingle: boolean;
+};
+
+declare function fetchCmsContent<T>(getClient: () => ApolloClient, opts: UseCmsContentOptions): Promise<T>;
+
 /**
  * Build a canonical media URL from an asset id. Pass `cmsUrl` explicitly when
  * calling outside of React (e.g. SSR loaders, scripts). Inside components,
@@ -217,6 +253,38 @@ declare function cmsImage(id: string | undefined, options: {
 /** Hook variant that pulls `cmsUrl`/`mediaPath` from the provider. */
 declare function useCmsImage(): (id?: string) => string;
 
+type ReadTimeUnit = "short" | "long";
+interface GetContentReadTimeOptions {
+    /**
+     * Average words read per minute
+     * @default 200
+     */
+    wordsPerMinute?: number;
+    /**
+     * Output style
+     * short => "3 min read"
+     * long => "3 minutes read"
+     *
+     * @default "short"
+     */
+    format?: ReadTimeUnit;
+    /**
+     * Round mode for minutes
+     * ceil => always round up
+     * round => normal rounding
+     * floor => round down
+     *
+     * @default "ceil"
+     */
+    round?: "ceil" | "round" | "floor";
+    /**
+     * Minimum minutes returned
+     * @default 1
+     */
+    minMinutes?: number;
+}
+declare function getContentReadTime(content: string, options?: GetContentReadTimeOptions): string;
+
 /**
  * Portable rich-text parser for CMS content.
  *
@@ -263,4 +331,4 @@ declare function RichTextContent({ html, classMap, as, className, }: RichTextCon
     };
 }, HTMLElement>;
 
-export { type AsteroidCMSConfig, AsteroidCMSProvider, type AsteroidCMSProviderProps, type ParseRichTextOptions, type ResolvedAsteroidCMSConfig, type RichTextClassKey, type RichTextClassMap, RichTextContent, type UseCmsContentOptions, type UseCmsMutateOptions, cmsImage, createApolloClient, parseRichText, removeEmptyParagraphs, useAsteroidCMSConfig, useCmsContent, useCmsImage, useCmsMutate };
+export { type AsteroidCMSConfig, AsteroidCMSProvider, type AsteroidCMSProviderProps, type CmsSearchCondition, type ContentStatus, type FieldSelector, type ParseRichTextOptions, type ReferenceExpansion, type ResolvedAsteroidCMSConfig, type RichTextClassKey, type RichTextClassMap, RichTextContent, type UseCmsContentOptions$1 as UseCmsContentOptions, type UseCmsMutateOptions, buildCmsQuery, cmsImage, createApolloClient, fetchCmsContent, getContentReadTime, parseRichText, removeEmptyParagraphs, useAsteroidCMSConfig, useCmsContent, useCmsImage, useCmsMutate };

package/dist/index.js

@@ -113,7 +113,7 @@ function useCmsContent({
   variables = {}
 }) {
   const isSingle = !!entrySlug;
-  const buildSelection = (items = []) => {
+  const buildSelection2 = (items = []) => {
     const lines = [];
     items.forEach((item) => {
       if (typeof item === "string") {
@@ -126,7 +126,7 @@ function useCmsContent({
         }
         const alias = item.as || item.field;
         const resolver = item.single ? "expandedReferenceObject" : "expandedReference";
-        const subSelection = item.select?.length ? buildSelection(item.select) : "data { ... }";
+        const subSelection = item.select?.length ? buildSelection2(item.select) : "data { ... }";
         lines.push(`
           ${alias}: ${resolver}(slug: "${item.field}") {
             ${subSelection}
@@ -139,7 +139,7 @@ function useCmsContent({
   const selectionParts = [];
   if (fullData) selectionParts.push("data");
   if (select.length > 0) {
-    const userSelection = buildSelection(select);
+    const userSelection = buildSelection2(select);
     if (userSelection) selectionParts.push(userSelection);
   }
   const selection = selectionParts.join("\n      ").trim() || "id";
@@ -223,7 +223,7 @@ function useCmsMutate({
   entryId,
   variables: inputVariables = {}
 }) {
-  const buildSelection = (items = []) => {
+  const buildSelection2 = (items = []) => {
     const lines = [];
     for (const item of items) {
       if (typeof item === "string") {
@@ -237,7 +237,7 @@ function useCmsMutate({
         continue;
       }
       const resolver = single ? "expandedReferenceObject" : "expandedReference";
-      const sub = buildSelection(subSelect) || "id slug";
+      const sub = buildSelection2(subSelect) || "id slug";
       lines.push(`
         ${alias}: ${resolver}(slug: "${field}") {
           id
@@ -248,7 +248,7 @@ function useCmsMutate({
     }
     return lines.join("\n      ").trim();
   };
-  const userSelection = buildSelection(select);
+  const userSelection = buildSelection2(select);
   let selection = fullData ? "data" : "";
   if (userSelection) {
     selection = selection ? `${selection}
@@ -305,6 +305,129 @@ function useCmsMutate({
     data: resultData
   };
 }
+function buildSelection(items = []) {
+  const lines = [];
+  items.forEach((item) => {
+    if (typeof item === "string") {
+      lines.push(`${item}: dataField(slug: "${item}")`);
+      return;
+    }
+    if ("field" in item && typeof item.field === "string") {
+      if (!("select" in item)) {
+        const alias2 = item.as || item.field;
+        lines.push(`${alias2}: dataField(slug: "${item.field}")`);
+        return;
+      }
+      const alias = item.as || item.field;
+      const resolver = item.single ? "expandedReferenceObject" : "expandedReference";
+      const subSelection = item.select?.length ? buildSelection(item.select) : "data { ... }";
+      lines.push(`
+        ${alias}: ${resolver}(slug: "${item.field}") {
+          ${subSelection}
+        }
+      `);
+    }
+  });
+  return lines.join("\n      ").trim();
+}
+function buildCmsQuery({
+  schema_slug,
+  entrySlug,
+  select = [],
+  fullData = false,
+  limit,
+  offset,
+  status = "PUBLISHED",
+  filter,
+  search,
+  variables = {}
+}) {
+  const isSingle = Boolean(entrySlug);
+  const selectionParts = [];
+  if (fullData) {
+    selectionParts.push("data");
+  }
+  if (select.length > 0) {
+    const userSelection = buildSelection(select);
+    if (userSelection) {
+      selectionParts.push(userSelection);
+    }
+  }
+  const selection = selectionParts.join("\n      ").trim() || "id";
+  const queryVariables = {
+    schema_slug,
+    ...entrySlug && { slug: entrySlug },
+    ...variables
+  };
+  const fieldArgParts = ["schema_slug: $schema_slug"];
+  if (!isSingle) {
+    if (typeof limit === "number" && limit >= 0) {
+      fieldArgParts.push("limit: $limit");
+      queryVariables.limit = limit;
+    }
+    if (typeof offset === "number" && offset >= 0) {
+      fieldArgParts.push("offset: $offset");
+      queryVariables.offset = offset;
+    }
+    if (status) {
+      const statuses = status;
+      if (statuses.length > 0) {
+        fieldArgParts.push("status: $status");
+        queryVariables.status = statuses;
+      }
+    }
+    const hasSearch = Array.isArray(search) && search.length > 0;
+    const hasFilter = filter && typeof filter === "object" && Object.keys(filter).length > 0;
+    if (hasSearch || hasFilter) {
+      const mergedFilter = hasFilter ? { ...filter } : {};
+      if (hasSearch) {
+        for (const condition of search) {
+          mergedFilter[condition.field] = {
+            regex: true,
+            value: condition.value,
+            mode: condition.mode ?? "i"
+          };
+        }
+      }
+      fieldArgParts.push("data: $filter");
+      queryVariables.filter = mergedFilter;
+    }
+  }
+  const varDecls = ["$schema_slug: String!"];
+  if ("limit" in queryVariables) varDecls.push("$limit: Float");
+  if ("offset" in queryVariables) varDecls.push("$offset: Float");
+  if ("status" in queryVariables) varDecls.push("$status: ContentStatus");
+  if ("filter" in queryVariables) varDecls.push("$filter: JSONObject");
+  const varBlock = varDecls.length > 0 ? `(
+  ${varDecls.join("\n  ")}
+)` : "";
+  const contentFieldArgs = fieldArgParts.join(", ");
+  const queryStr = isSingle ? `
+      query Get${schema_slug}Entry($schema_slug: String!, $slug: String!) {
+        entry: contentEntry(schema_slug: $schema_slug, slug: $slug) {
+          ${selection}
+        }
+      }
+    ` : `
+      query Get${schema_slug}Entries${varBlock} {
+        entries: contentEntries(${contentFieldArgs}) {
+          ${selection}
+        }
+      }
+    `;
+  return {
+    query: gql(queryStr),
+    variables: queryVariables,
+    isSingle
+  };
+}
+
+// src/fetchCmsContent.ts
+async function fetchCmsContent(getClient, opts) {
+  const { query, variables, isSingle } = buildCmsQuery(opts);
+  const { data } = await getClient().query({ query, variables });
+  return isSingle ? data.entry : data.entries;
+}
 
 // src/utils/cmsImage.ts
 function cmsImage(id, options) {
@@ -318,6 +441,35 @@ function useCmsImage() {
   return (id) => cmsImage(id, { cmsUrl, mediaPath });
 }
 
+// src/utils/getContentReadTime.ts
+function getContentReadTime(content, options = {}) {
+  const {
+    wordsPerMinute = 200,
+    format = "short",
+    round = "ceil",
+    minMinutes = 1
+  } = options;
+  if (!content || typeof content !== "string") {
+    return format === "short" ? `${minMinutes} min read` : `${minMinutes} minute read`;
+  }
+  let text = content.replace(/<script[\s\S]*?<\/script>/gi, " ").replace(/<style[\s\S]*?<\/style>/gi, " ");
+  text = text.replace(/<\/(p|div|h[1-6]|li|blockquote|pre|code|br|tr)>/gi, " ").replace(/<[^>]+>/g, " ");
+  text = text.replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&#39;/gi, "'").replace(/&quot;/gi, '"');
+  text = text.replace(/\s+/g, " ").trim();
+  const words = text.split(" ").filter(Boolean).length;
+  const rawMinutes = words / wordsPerMinute;
+  const roundMap = {
+    ceil: Math.ceil,
+    round: Math.round,
+    floor: Math.floor
+  };
+  const minutes = Math.max(minMinutes, roundMap[round](rawMinutes));
+  if (format === "long") {
+    return `${minutes} ${minutes === 1 ? "minute" : "minutes"} read`;
+  }
+  return `${minutes} min read`;
+}
+
 // src/components/richTextParser.ts
 var DEFAULT_ALLOWLIST = [
   "p",
@@ -1450,6 +1602,6 @@ function RichTextContent({
   });
 }
 
-export { AsteroidCMSProvider, RichTextContent, cmsImage, createApolloClient, parseRichText, removeEmptyParagraphs, useAsteroidCMSConfig, useCmsContent, useCmsImage, useCmsMutate };
+export { AsteroidCMSProvider, RichTextContent, buildCmsQuery, cmsImage, createApolloClient, fetchCmsContent, getContentReadTime, parseRichText, removeEmptyParagraphs, useAsteroidCMSConfig, useCmsContent, useCmsImage, useCmsMutate };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map