@asteroidcms/core-utils 0.1.4 → 0.1.6

package/dist/index.d.cts

@@ -41,15 +41,15 @@ declare module "@apollo/client" {
 }
 declare function createApolloClient(config: AsteroidCMSConfig): ApolloClient;
 
-type FieldSelector = string | {
+type FieldSelector$1 = string | {
     field: string;
     as?: string;
 };
-type ReferenceExpansion = {
+type ReferenceExpansion$1 = {
     field: string;
     as?: string;
     single?: boolean;
-    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
 };
 type ContentStatus = "DRAFT" | "PUBLISHED" | "ARCHIVED";
 type CmsSearchCondition = {
@@ -60,7 +60,7 @@ type CmsSearchCondition = {
 type UseCmsContentOptions = {
     schema_slug: string;
     entrySlug?: string;
-    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
     fullData?: boolean;
     limit?: number;
     offset?: number;
@@ -75,7 +75,41 @@ declare function buildCmsQuery({ schema_slug, entrySlug, select, fullData, limit
     isSingle: boolean;
 };
 
-declare function fetchCmsContent<T>(getClient: () => ApolloClient, opts: UseCmsContentOptions): Promise<T>;
+type AnyApolloClient$1 = {
+    query: (...args: any[]) => any;
+};
+declare function fetchCmsContent<T>(getClient: () => AnyApolloClient$1, opts: UseCmsContentOptions): Promise<T>;
+
+type MutationType = "create" | "update" | "delete";
+type FieldSelector = string | {
+    field: string;
+    as?: string;
+    single?: boolean;
+    select?: readonly (FieldSelector | ReferenceExpansion)[];
+};
+type ReferenceExpansion = {
+    field: string;
+    as?: string;
+    single?: boolean;
+    select?: readonly (FieldSelector | ReferenceExpansion)[];
+};
+type CmsMutateOptions = {
+    schema_slug: string;
+    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    fullData?: boolean;
+    mutationType?: MutationType;
+    entryId?: string;
+    variables?: Record<string, unknown>;
+};
+declare function buildCmsMutation({ schema_slug, select, fullData, mutationType, entryId, variables, }: CmsMutateOptions): {
+    mutation: DocumentNode;
+    variables: Record<string, unknown>;
+};
+
+type AnyApolloClient = {
+    mutate: (...args: any[]) => any;
+};
+declare function cmsMutate<T>(getClient: () => AnyApolloClient, opts: CmsMutateOptions): Promise<T>;
 
 /**
  * Build a canonical media URL from an asset id. Pass `cmsUrl` explicitly when
@@ -132,7 +166,7 @@ declare function getContentReadTime(content: string, options?: GetContentReadTim
  *
  * Idempotent: parseRichText(parseRichText(x, opts), opts) === parseRichText(x, opts).
  */
-type RichTextClassKey = "p" | "br" | "hr" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "ul" | "ol" | "li" | "blockquote" | "pre" | "code" | "inlineCode" | "a" | "strong" | "em" | "u" | "s" | "kbd" | "table" | "tableWrapper" | "thead" | "tbody" | "tr" | "th" | "td" | "figure" | "figcaption" | "img" | "span" | "callout" | "calloutTitle";
+type RichTextClassKey = "p" | "br" | "hr" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "ul" | "ol" | "li" | "blockquote" | "pre" | "code" | "inlineCode" | "a" | "strong" | "em" | "u" | "s" | "kbd" | "table" | "tableWrapper" | "thead" | "tbody" | "tr" | "th" | "td" | "figure" | "figcaption" | "img" | "span" | "callout" | "calloutTitle" | "collapsible" | "collapsibleTitle";
 type RichTextClassMap = Partial<Record<RichTextClassKey, string>> & {
     /** Variant overrides keyed as `${matchKey}:${variant}`, e.g. "callout:warning". */
     variants?: Record<string, string>;
@@ -193,4 +227,4 @@ declare function extractHeadingsFromElement(root: HTMLElement, options?: Extract
     scrollMarginTop?: number;
 }): ExtractedHeading[];
 
-export { type AsteroidCMSConfig, type CmsSearchCondition, type ContentStatus, type ExtractHeadingsOptions, type ExtractedHeading, type FieldSelector, type HeadingLevel, type ParseRichTextOptions, type ReferenceExpansion, type ResolvedAsteroidCMSConfig, type RichTextClassKey, type RichTextClassMap, type UseCmsContentOptions, buildCmsQuery, cmsImage, createApolloClient, extractHeadingsFromElement, extractHeadingsFromHtml, fetchCmsContent, getContentReadTime, parseRichText, removeEmptyParagraphs, slugify };
+export { type AsteroidCMSConfig, type CmsMutateOptions, type CmsSearchCondition, type ContentStatus, type ExtractHeadingsOptions, type ExtractedHeading, type FieldSelector$1 as FieldSelector, type HeadingLevel, type MutationType, type ParseRichTextOptions, type ReferenceExpansion$1 as ReferenceExpansion, type ResolvedAsteroidCMSConfig, type RichTextClassKey, type RichTextClassMap, type UseCmsContentOptions, buildCmsMutation, buildCmsQuery, cmsImage, cmsMutate, createApolloClient, extractHeadingsFromElement, extractHeadingsFromHtml, fetchCmsContent, getContentReadTime, parseRichText, removeEmptyParagraphs, slugify };

package/dist/index.d.ts

@@ -41,15 +41,15 @@ declare module "@apollo/client" {
 }
 declare function createApolloClient(config: AsteroidCMSConfig): ApolloClient;
 
-type FieldSelector = string | {
+type FieldSelector$1 = string | {
     field: string;
     as?: string;
 };
-type ReferenceExpansion = {
+type ReferenceExpansion$1 = {
     field: string;
     as?: string;
     single?: boolean;
-    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
 };
 type ContentStatus = "DRAFT" | "PUBLISHED" | "ARCHIVED";
 type CmsSearchCondition = {
@@ -60,7 +60,7 @@ type CmsSearchCondition = {
 type UseCmsContentOptions = {
     schema_slug: string;
     entrySlug?: string;
-    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    select?: readonly (FieldSelector$1 | ReferenceExpansion$1)[];
     fullData?: boolean;
     limit?: number;
     offset?: number;
@@ -75,7 +75,41 @@ declare function buildCmsQuery({ schema_slug, entrySlug, select, fullData, limit
     isSingle: boolean;
 };
 
-declare function fetchCmsContent<T>(getClient: () => ApolloClient, opts: UseCmsContentOptions): Promise<T>;
+type AnyApolloClient$1 = {
+    query: (...args: any[]) => any;
+};
+declare function fetchCmsContent<T>(getClient: () => AnyApolloClient$1, opts: UseCmsContentOptions): Promise<T>;
+
+type MutationType = "create" | "update" | "delete";
+type FieldSelector = string | {
+    field: string;
+    as?: string;
+    single?: boolean;
+    select?: readonly (FieldSelector | ReferenceExpansion)[];
+};
+type ReferenceExpansion = {
+    field: string;
+    as?: string;
+    single?: boolean;
+    select?: readonly (FieldSelector | ReferenceExpansion)[];
+};
+type CmsMutateOptions = {
+    schema_slug: string;
+    select?: readonly (FieldSelector | ReferenceExpansion)[];
+    fullData?: boolean;
+    mutationType?: MutationType;
+    entryId?: string;
+    variables?: Record<string, unknown>;
+};
+declare function buildCmsMutation({ schema_slug, select, fullData, mutationType, entryId, variables, }: CmsMutateOptions): {
+    mutation: DocumentNode;
+    variables: Record<string, unknown>;
+};
+
+type AnyApolloClient = {
+    mutate: (...args: any[]) => any;
+};
+declare function cmsMutate<T>(getClient: () => AnyApolloClient, opts: CmsMutateOptions): Promise<T>;
 
 /**
  * Build a canonical media URL from an asset id. Pass `cmsUrl` explicitly when
@@ -132,7 +166,7 @@ declare function getContentReadTime(content: string, options?: GetContentReadTim
  *
  * Idempotent: parseRichText(parseRichText(x, opts), opts) === parseRichText(x, opts).
  */
-type RichTextClassKey = "p" | "br" | "hr" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "ul" | "ol" | "li" | "blockquote" | "pre" | "code" | "inlineCode" | "a" | "strong" | "em" | "u" | "s" | "kbd" | "table" | "tableWrapper" | "thead" | "tbody" | "tr" | "th" | "td" | "figure" | "figcaption" | "img" | "span" | "callout" | "calloutTitle";
+type RichTextClassKey = "p" | "br" | "hr" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "ul" | "ol" | "li" | "blockquote" | "pre" | "code" | "inlineCode" | "a" | "strong" | "em" | "u" | "s" | "kbd" | "table" | "tableWrapper" | "thead" | "tbody" | "tr" | "th" | "td" | "figure" | "figcaption" | "img" | "span" | "callout" | "calloutTitle" | "collapsible" | "collapsibleTitle";
 type RichTextClassMap = Partial<Record<RichTextClassKey, string>> & {
     /** Variant overrides keyed as `${matchKey}:${variant}`, e.g. "callout:warning". */
     variants?: Record<string, string>;
@@ -193,4 +227,4 @@ declare function extractHeadingsFromElement(root: HTMLElement, options?: Extract
     scrollMarginTop?: number;
 }): ExtractedHeading[];
 
-export { type AsteroidCMSConfig, type CmsSearchCondition, type ContentStatus, type ExtractHeadingsOptions, type ExtractedHeading, type FieldSelector, type HeadingLevel, type ParseRichTextOptions, type ReferenceExpansion, type ResolvedAsteroidCMSConfig, type RichTextClassKey, type RichTextClassMap, type UseCmsContentOptions, buildCmsQuery, cmsImage, createApolloClient, extractHeadingsFromElement, extractHeadingsFromHtml, fetchCmsContent, getContentReadTime, parseRichText, removeEmptyParagraphs, slugify };
+export { type AsteroidCMSConfig, type CmsMutateOptions, type CmsSearchCondition, type ContentStatus, type ExtractHeadingsOptions, type ExtractedHeading, type FieldSelector$1 as FieldSelector, type HeadingLevel, type MutationType, type ParseRichTextOptions, type ReferenceExpansion$1 as ReferenceExpansion, type ResolvedAsteroidCMSConfig, type RichTextClassKey, type RichTextClassMap, type UseCmsContentOptions, buildCmsMutation, buildCmsQuery, cmsImage, cmsMutate, createApolloClient, extractHeadingsFromElement, extractHeadingsFromHtml, fetchCmsContent, getContentReadTime, parseRichText, removeEmptyParagraphs, slugify };

package/dist/index.js

@@ -185,6 +185,94 @@ async function fetchCmsContent(getClient, opts) {
   const { data } = await getClient().query({ query, variables });
   return isSingle ? data.entry : data.entries;
 }
+function buildSelection2(items = []) {
+  const lines = [];
+  for (const item of items) {
+    if (typeof item === "string") {
+      lines.push(`${item}: dataField(slug: "${item}")`);
+      continue;
+    }
+    const { field, as, single, select: subSelect } = item;
+    const alias = as || field;
+    if (!subSelect?.length) {
+      lines.push(`${alias}: dataField(slug: "${field}")`);
+      continue;
+    }
+    const resolver = single ? "expandedReferenceObject" : "expandedReference";
+    const sub = buildSelection2(subSelect) || "id slug";
+    lines.push(`
+        ${alias}: ${resolver}(slug: "${field}") {
+          id
+          slug
+          ${sub}
+        }
+      `);
+  }
+  return lines.join("\n      ").trim();
+}
+function buildCmsMutation({
+  schema_slug,
+  select = [],
+  fullData = false,
+  mutationType = "create",
+  entryId,
+  variables = {}
+}) {
+  const userSelection = buildSelection2(select);
+  let selection = fullData ? "data" : "";
+  if (userSelection) {
+    selection = selection ? `${selection}
+      ${userSelection}` : userSelection;
+  }
+  if (!selection) {
+    selection = "id slug status version created_at updated_at";
+  }
+  const mutationName = `${mutationType}ContentEntry`;
+  const varDecls = ["$schema_slug: String!"];
+  const callArgs = ["schema_slug: $schema_slug"];
+  if (mutationType === "create" || mutationType === "update") {
+    varDecls.unshift("$data: JSONObject!");
+    callArgs.unshift("data: $data");
+  }
+  if (mutationType === "update" || mutationType === "delete") {
+    varDecls.push("$id: ID!");
+    callArgs.push("id: $id");
+  }
+  const returnFields = selection.includes("data") ? selection : `${selection}
+        data`;
+  const mutationStr = `
+    mutation ${mutationName}(${varDecls.join(", ")}) {
+      result: ${mutationName}(${callArgs.join(", ")}) {
+        id
+        status
+        version
+        created_at
+        updated_at
+        schema {
+          id
+          slug
+        }
+        ${returnFields}
+      }
+    }
+  `;
+  const mutationVariables = {
+    schema_slug,
+    ...mutationType === "update" || mutationType === "delete" ? { id: entryId } : {},
+    ...variables
+  };
+  return {
+    mutation: gql(mutationStr),
+    variables: mutationVariables
+  };
+}
+
+// src/cmsMutate.ts
+async function cmsMutate(getClient, opts) {
+  const { mutation, variables } = buildCmsMutation(opts);
+  const { data } = await getClient().mutate({ mutation, variables });
+  return data.result;
+}
 
 // src/utils/cmsImage.ts
 function cmsImage(id, options) {
@@ -270,7 +358,9 @@ var DEFAULT_ALLOWLIST = [
   "section",
   "article",
   "div",
-  "span"
+  "span",
+  "details",
+  "summary"
 ];
 var ALLOWED_ATTRS = {
   a: ["href", "title", "target", "rel"],
@@ -280,7 +370,8 @@ var ALLOWED_ATTRS = {
   col: ["span", "width"],
   colgroup: ["span"],
   table: ["border", "cellpadding", "cellspacing"],
-  span: ["style"]
+  span: ["style"],
+  details: ["open"]
 };
 var ALLOWED_STYLE_PROPS = {
   span: ["font-size"]
@@ -314,7 +405,8 @@ var GLOBAL_ALLOWED_ATTRS = [
   "data-title",
   "data-callout-title",
   "data-language",
-  "data-filename"
+  "data-filename",
+  "data-icon"
 ];
 var URL_ATTRS = /* @__PURE__ */ new Set(["href", "src"]);
 function parseRichText(html, options = {}) {
@@ -728,6 +820,8 @@ function classKeyForTag(tag, attrs, openStack) {
   if (tag === "p" && "data-callout-title" in attrs) return "calloutTitle";
   if (tag === "code" && openStack[openStack.length - 1] !== "pre")
     return "inlineCode";
+  if (tag === "details") return "collapsible";
+  if (tag === "summary") return "collapsibleTitle";
   const known = [
     "p",
     "br",
@@ -968,6 +1062,6 @@ function extractHeadingsFromElement(root, options = {}) {
   return out;
 }
 
-export { buildCmsQuery, cmsImage, createApolloClient, extractHeadingsFromElement, extractHeadingsFromHtml, fetchCmsContent, getContentReadTime, parseRichText, removeEmptyParagraphs, slugify };
+export { buildCmsMutation, buildCmsQuery, cmsImage, cmsMutate, createApolloClient, extractHeadingsFromElement, extractHeadingsFromHtml, fetchCmsContent, getContentReadTime, parseRichText, removeEmptyParagraphs, slugify };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map