@asteroidcms/core-utils 0.1.5 → 0.1.7

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
@@ -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
@@ -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) {
@@ -974,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