cmx-sdk 0.2.22 → 0.2.23

package/dist/index.d.ts

@@ -69,6 +69,16 @@ declare function sdkCustomInstance<T>(url: string, options?: RequestInit): Promi
  * Next.js ISR/on-demand revalidation対応
  */
 declare function sdkFetchWithTags<T>(path: string, tags?: string[], revalidate?: number | false): Promise<T>;
+/**
+ * MCP APIのベースURL取得
+ */
+declare function getMcpApiBaseUrl(): string;
+/**
+ * キャッシュタグ付きのMCP APIリクエスト用ラッパー
+ * Next.js ISR/on-demand revalidation対応
+ * アセット取得など、MCP APIエンドポイントへのアクセスに使用
+ */
+declare function mcpFetchWithTags<T>(path: string, tags?: string[], revalidate?: number | false): Promise<T>;
 /**
  * SDK API用のPOSTリクエストfetcher
  * サーバーサイド（Server Action等）から使用
@@ -90,6 +100,10 @@ declare const CACHE_TAGS: {
     readonly data: "data";
     /** 特定データタイプ */
     readonly dataType: (slug: string) => string;
+    /** 全アセット共通 */
+    readonly assets: "assets";
+    /** 特定グループのアセット */
+    readonly assetGroup: (group: string) => string;
 };
 
 /**
@@ -3413,6 +3427,60 @@ declare function fetchRuntimeSettings(): Promise<SdkRuntimeSettingsResponse>;
  * Get daily analytics metrics collected by CMX.
  */
 declare function fetchAnalyticsDailyMetrics(params?: GetAnalyticsDailyParams): Promise<SdkAnalyticsDailyListResponse>;
+/**
+ * Asset item returned from the assets search API
+ */
+interface AssetItem {
+    id: string;
+    url: string;
+    alt: string | null;
+    description: string | null;
+    aiSummary: string | null;
+    width: number | null;
+    height: number | null;
+    mime: string;
+    size: number;
+    variants: Record<string, string>;
+    groupId: string | null;
+    createdAt: string;
+    tags: Array<{
+        name: string;
+    }>;
+    group: {
+        slug: string;
+        name: string;
+    } | null;
+}
+/**
+ * Response from the assets search API
+ */
+interface AssetsResponse {
+    assets: AssetItem[];
+    pagination: {
+        total: number;
+        limit: number;
+        offset: number;
+    };
+}
+/**
+ * Options for fetching assets
+ */
+interface AssetsOptions extends FetchOptions {
+    group?: string;
+    tags?: string;
+    query?: string;
+    mime?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Get assets from the MCP assets search API
+ */
+declare function getAssets(options?: AssetsOptions): Promise<AssetsResponse>;
+/**
+ * Get assets filtered by group slug
+ */
+declare function getAssetsByGroup(group: string, options?: Omit<AssetsOptions, "group">): Promise<AssetsResponse>;
 
 interface CalloutProps {
     type?: "info" | "warning" | "error" | "success" | "tip";
@@ -4052,4 +4120,4 @@ declare function renderMdx(mdx: string, references?: References, options?: Rende
  */
 declare function renderMdxPreview(mdx: string, additionalComponents?: Record<string, React.ComponentType<any>>): Promise<React.ReactElement>;
 
-export { type ApiResponse, type AssetReference, type AssetReferenceVariants, BlogCard, Button, CACHE_TAGS, Callout, CmxApiError, type CollectionConfig, type CollectionConfigDefaults, type CollectionContentDetailResponse, type CollectionContentsOptions, type CollectionContentsResponse, type CollectionListResponse, type CollectionResponse, CollectionType, type ComponentDefinition, type ComponentName, type ContentReference, ContentStatus, type CreateCollectionRequest, type CreateContentRequest, type CreateDataTypeRequest, type CreateFormDefinitionRequest, type CreateSocialPostRequest, CreateSocialPostRequestStatus, type CreateSocialPostRequestTargetsItem, type CreateSocialPostRequestTargetsItemPlatformMeta, type DataEntriesOptions, type DataEntryDetailResponse, type DataEntryItem, type DataListResponse, type DataTypeConfig, type DataTypeResponse, type DeleteManageContentsIdParams, type DeleteManageDataTypeSlugIdParams, Embed, type ErrorResponse, type ErrorResponseDetails, type FetchOptions, type FieldDefinition, type FieldOptions, type FieldOptionsChoicesItem, FieldType, type FormDefinitionResponse, type FormDefinitionResponseConfigJson, type GetAnalyticsDailyParams, type GetCollectionsSlugContentsParams, GetCollectionsSlugContentsSortBy, GetCollectionsSlugContentsSortOrder, type GetDataTypeSlugParams, GetDataTypeSlugSortBy, GetDataTypeSlugSortOrder, type GetManageCollectionPresets200, type GetManageCollectionPresetsParams, GetManageCollectionPresetsType, type GetManageContentsIdParams, type GetManageContentsParams, type GetManageDataTypeSlugIdParams, type GetManageDataTypeSlugParams, GetManageDataTypeSlugSortBy, GetManageDataTypeSlugSortOrder, GetManageDataTypeSlugStatus, type GetManageSocialPostsParams, GetManageSocialPostsStatus, type GetPreviewToken200, type GetPreviewToken200Collection, type GetPreviewToken200Content, type GetPreviewToken200References, type GetPreviewToken200ReferencesAssets, type GetPreviewToken200ReferencesAssetsVariants, type GetPreviewToken200ReferencesContents, Image, type PreviewResponse, type PublicCollectionInfo, type PublicContentDetail, type PublicContentListItem, type PublicContentParent, type PublicFetcherOptions, type PublicSubmissionRequest, type PublicSubmissionRequestData, type PublicSubmissionResponse, type ReferenceField, ReferenceFieldReferenceType, type References, type ReferencesAssets, type ReferencesContents, type RenderOptions, type RenderResult, type ResolvedReferences, type RevalidationConfig, type SchemaCollection, type SchemaDataType, type SchemaFieldDefinition, type SchemaFieldOption, type SchemaFieldOptionChoicesItem, type SchemaFormDefinition, type SchemaResponse, type SdkAddCollectionDataTypeRequest, SdkAddCollectionDataTypeRequestReferenceType, type SdkAnalyticsDailyListResponse, type SdkAnalyticsDailyMetric, type SdkAnalyticsDailyMetricRawJson, type SdkBugReportResponse, SdkBugSeverity, type SdkCollectionDataTypeResponse, type SdkComponentDefinition, type SdkComponentDefinitionPropsSchema, type SdkComponentProp, type SdkComponentSuccessResponse, type SdkComponentSyncRequest, type SdkContentDetail, type SdkContentDetailFrontmatterJson, type SdkContentDetailSeoJson, type SdkContentDetailSeoJsonStructuredData, type SdkContentItem, type SdkContentListResponse, type SdkContentReferencesResponse, type SdkContentReferencesResponseReferencesItem, type SdkContentReferencesResponseReferencesItemDataEntriesItem, type SdkContentReferencesResponseReferencesItemDataEntriesItemData, type SdkCreateBugReportBody, type SdkCreateBugReportBodyEnvironmentInfo, type SdkCreateContentResponse, type SdkCreateContentResponseWarningsItem, SdkCreateContentResponseWarningsItemIssueType, SdkCreateContentResponseWarningsItemTargetType, type SdkCreateEntryRequest, type SdkCreateEntryRequestDataJson, SdkCreateEntryRequestStatus, type SdkCustomComponentResponse, type SdkCustomComponentResponsePropsSchema, SdkCustomComponentResponseStatus, type SdkCustomComponentsListResponse, type SdkDataEntriesListResponse, type SdkDataEntryDeletionImpactItem, type SdkDataEntryDeletionImpactResponse, type SdkDataEntryDetailResponse, type SdkDataEntryResponse, type SdkDataEntryResponseDataJson, SdkDataEntryResponseStatus, type SdkDataTypeInfo, type SdkDeleteCollectionDataTypeResponse, type SdkDeleteCollectionResponse, type SdkDeleteContentResponse, type SdkDeleteDataEntryResponse, type SdkDeleteDataTypeResponse, type SdkDeleteFormDefinitionResponse, type SdkDeleteSocialPostResponse, type SdkDocResponse, SdkDocType, type SdkLinkExistingDataTypeRequest, SdkLinkExistingDataTypeRequestReferenceType, type SdkPreset, SdkPresetReferenceType, type SdkPublishContentResponse, type SdkRequestReviewResponse, type SdkRuntimeSettingsResponse, type SdkRuntimeSettingsResponseSettings, type SdkRuntimeSettingsResponseSettingsAnalytics, SdkRuntimeSettingsResponseSettingsAnalyticsProvider, type SdkRuntimeSettingsResponseSettingsAnalyticsTracking, type SdkRuntimeSettingsResponseSettingsRevalidation, type SdkSetContentReferencesRequest, type SdkSetContentReferencesRequestReferencesItem, type SdkSetContentReferencesResponse, type SdkUpdateContentResponse, type SdkUpdateContentResponseWarningsItem, SdkUpdateContentResponseWarningsItemIssueType, SdkUpdateContentResponseWarningsItemTargetType, type SdkUpdateEntryRequest, type SdkUpdateEntryRequestDataJson, SdkUpdateEntryRequestStatus, type SdkUpsertDocBody, type SdkValidateContentResponse, type SdkValidateContentResponseIssuesItem, SdkValidateContentResponseIssuesItemIssueType, SdkValidateContentResponseIssuesItemTargetType, type SocialAccountListResponse, type SocialAccountResponse, SocialAccountResponsePlatform, SocialAccountResponseStatus, type SocialPostListItem, SocialPostListItemStatus, type SocialPostListItemTargetSummary, SocialPostListItemTargetSummaryPlatformsItem, type SocialPostListItemTargetSummaryStatusCounts, type SocialPostListResponse, type SocialPostResponse, SocialPostResponseStatus, type SocialPostResponseTargetSummary, SocialPostResponseTargetSummaryPlatformsItem, type SocialPostResponseTargetSummaryStatusCounts, type SocialPostResponseTargetsItem, SocialPostResponseTargetsItemPlatform, type SocialPostResponseTargetsItemPlatformMeta, SocialPostResponseTargetsItemStatus, type UpdateCollectionRequest, type UpdateContentRequest, type UpdateDataTypeRequest, type UpdateFormDefinitionRequest, type UpdateFormDefinitionRequestConfigJson, type UpdateSocialPostRequest, UpdateSocialPostRequestStatus, type ValidationError, type ValidationResult, basicComponents, componentCatalog, componentSchemas, customComponents, fetchAnalyticsDailyMetrics, fetchRuntimeSettings, getAnalyticsDaily, getCatalogForAI, getCollectionContentDetail, getCollectionContentDetailOrThrow, getCollectionContents, getCollectionContentsOrThrow, getCollections, getCollectionsSlugContents, getCollectionsSlugContentsContentSlug, getComponentsByCategory, getComponentsWithReferences, getDataEntries, getDataEntriesOrThrow, getDataEntry, getDataEntryOrThrow, getDataTypeSlug, getGetAnalyticsDailyUrl, getGetCollectionsSlugContentsContentSlugUrl, getGetCollectionsSlugContentsUrl, getGetDataTypeSlugUrl, getGetPreviewTokenUrl, getGetRuntimeSettingsUrl, getPreviewByToken, getPreviewToken, getRuntimeSettings, getSchema, getSdkApiBaseUrl, getSdkApiToken, isValidComponent, markdownComponents, mdxComponents, quickValidateMdx, renderMdx, renderMdxPreview, sdkCustomInstance, sdkFetchWithTags, sdkFetcher, sdkPostFetcher, submitFormData, validateComponentProps, validateMdx };
+export { type ApiResponse, type AssetItem, type AssetReference, type AssetReferenceVariants, type AssetsOptions, type AssetsResponse, BlogCard, Button, CACHE_TAGS, Callout, CmxApiError, type CollectionConfig, type CollectionConfigDefaults, type CollectionContentDetailResponse, type CollectionContentsOptions, type CollectionContentsResponse, type CollectionListResponse, type CollectionResponse, CollectionType, type ComponentDefinition, type ComponentName, type ContentReference, ContentStatus, type CreateCollectionRequest, type CreateContentRequest, type CreateDataTypeRequest, type CreateFormDefinitionRequest, type CreateSocialPostRequest, CreateSocialPostRequestStatus, type CreateSocialPostRequestTargetsItem, type CreateSocialPostRequestTargetsItemPlatformMeta, type DataEntriesOptions, type DataEntryDetailResponse, type DataEntryItem, type DataListResponse, type DataTypeConfig, type DataTypeResponse, type DeleteManageContentsIdParams, type DeleteManageDataTypeSlugIdParams, Embed, type ErrorResponse, type ErrorResponseDetails, type FetchOptions, type FieldDefinition, type FieldOptions, type FieldOptionsChoicesItem, FieldType, type FormDefinitionResponse, type FormDefinitionResponseConfigJson, type GetAnalyticsDailyParams, type GetCollectionsSlugContentsParams, GetCollectionsSlugContentsSortBy, GetCollectionsSlugContentsSortOrder, type GetDataTypeSlugParams, GetDataTypeSlugSortBy, GetDataTypeSlugSortOrder, type GetManageCollectionPresets200, type GetManageCollectionPresetsParams, GetManageCollectionPresetsType, type GetManageContentsIdParams, type GetManageContentsParams, type GetManageDataTypeSlugIdParams, type GetManageDataTypeSlugParams, GetManageDataTypeSlugSortBy, GetManageDataTypeSlugSortOrder, GetManageDataTypeSlugStatus, type GetManageSocialPostsParams, GetManageSocialPostsStatus, type GetPreviewToken200, type GetPreviewToken200Collection, type GetPreviewToken200Content, type GetPreviewToken200References, type GetPreviewToken200ReferencesAssets, type GetPreviewToken200ReferencesAssetsVariants, type GetPreviewToken200ReferencesContents, Image, type PreviewResponse, type PublicCollectionInfo, type PublicContentDetail, type PublicContentListItem, type PublicContentParent, type PublicFetcherOptions, type PublicSubmissionRequest, type PublicSubmissionRequestData, type PublicSubmissionResponse, type ReferenceField, ReferenceFieldReferenceType, type References, type ReferencesAssets, type ReferencesContents, type RenderOptions, type RenderResult, type ResolvedReferences, type RevalidationConfig, type SchemaCollection, type SchemaDataType, type SchemaFieldDefinition, type SchemaFieldOption, type SchemaFieldOptionChoicesItem, type SchemaFormDefinition, type SchemaResponse, type SdkAddCollectionDataTypeRequest, SdkAddCollectionDataTypeRequestReferenceType, type SdkAnalyticsDailyListResponse, type SdkAnalyticsDailyMetric, type SdkAnalyticsDailyMetricRawJson, type SdkBugReportResponse, SdkBugSeverity, type SdkCollectionDataTypeResponse, type SdkComponentDefinition, type SdkComponentDefinitionPropsSchema, type SdkComponentProp, type SdkComponentSuccessResponse, type SdkComponentSyncRequest, type SdkContentDetail, type SdkContentDetailFrontmatterJson, type SdkContentDetailSeoJson, type SdkContentDetailSeoJsonStructuredData, type SdkContentItem, type SdkContentListResponse, type SdkContentReferencesResponse, type SdkContentReferencesResponseReferencesItem, type SdkContentReferencesResponseReferencesItemDataEntriesItem, type SdkContentReferencesResponseReferencesItemDataEntriesItemData, type SdkCreateBugReportBody, type SdkCreateBugReportBodyEnvironmentInfo, type SdkCreateContentResponse, type SdkCreateContentResponseWarningsItem, SdkCreateContentResponseWarningsItemIssueType, SdkCreateContentResponseWarningsItemTargetType, type SdkCreateEntryRequest, type SdkCreateEntryRequestDataJson, SdkCreateEntryRequestStatus, type SdkCustomComponentResponse, type SdkCustomComponentResponsePropsSchema, SdkCustomComponentResponseStatus, type SdkCustomComponentsListResponse, type SdkDataEntriesListResponse, type SdkDataEntryDeletionImpactItem, type SdkDataEntryDeletionImpactResponse, type SdkDataEntryDetailResponse, type SdkDataEntryResponse, type SdkDataEntryResponseDataJson, SdkDataEntryResponseStatus, type SdkDataTypeInfo, type SdkDeleteCollectionDataTypeResponse, type SdkDeleteCollectionResponse, type SdkDeleteContentResponse, type SdkDeleteDataEntryResponse, type SdkDeleteDataTypeResponse, type SdkDeleteFormDefinitionResponse, type SdkDeleteSocialPostResponse, type SdkDocResponse, SdkDocType, type SdkLinkExistingDataTypeRequest, SdkLinkExistingDataTypeRequestReferenceType, type SdkPreset, SdkPresetReferenceType, type SdkPublishContentResponse, type SdkRequestReviewResponse, type SdkRuntimeSettingsResponse, type SdkRuntimeSettingsResponseSettings, type SdkRuntimeSettingsResponseSettingsAnalytics, SdkRuntimeSettingsResponseSettingsAnalyticsProvider, type SdkRuntimeSettingsResponseSettingsAnalyticsTracking, type SdkRuntimeSettingsResponseSettingsRevalidation, type SdkSetContentReferencesRequest, type SdkSetContentReferencesRequestReferencesItem, type SdkSetContentReferencesResponse, type SdkUpdateContentResponse, type SdkUpdateContentResponseWarningsItem, SdkUpdateContentResponseWarningsItemIssueType, SdkUpdateContentResponseWarningsItemTargetType, type SdkUpdateEntryRequest, type SdkUpdateEntryRequestDataJson, SdkUpdateEntryRequestStatus, type SdkUpsertDocBody, type SdkValidateContentResponse, type SdkValidateContentResponseIssuesItem, SdkValidateContentResponseIssuesItemIssueType, SdkValidateContentResponseIssuesItemTargetType, type SocialAccountListResponse, type SocialAccountResponse, SocialAccountResponsePlatform, SocialAccountResponseStatus, type SocialPostListItem, SocialPostListItemStatus, type SocialPostListItemTargetSummary, SocialPostListItemTargetSummaryPlatformsItem, type SocialPostListItemTargetSummaryStatusCounts, type SocialPostListResponse, type SocialPostResponse, SocialPostResponseStatus, type SocialPostResponseTargetSummary, SocialPostResponseTargetSummaryPlatformsItem, type SocialPostResponseTargetSummaryStatusCounts, type SocialPostResponseTargetsItem, SocialPostResponseTargetsItemPlatform, type SocialPostResponseTargetsItemPlatformMeta, SocialPostResponseTargetsItemStatus, type UpdateCollectionRequest, type UpdateContentRequest, type UpdateDataTypeRequest, type UpdateFormDefinitionRequest, type UpdateFormDefinitionRequestConfigJson, type UpdateSocialPostRequest, UpdateSocialPostRequestStatus, type ValidationError, type ValidationResult, basicComponents, componentCatalog, componentSchemas, customComponents, fetchAnalyticsDailyMetrics, fetchRuntimeSettings, getAnalyticsDaily, getAssets, getAssetsByGroup, getCatalogForAI, getCollectionContentDetail, getCollectionContentDetailOrThrow, getCollectionContents, getCollectionContentsOrThrow, getCollections, getCollectionsSlugContents, getCollectionsSlugContentsContentSlug, getComponentsByCategory, getComponentsWithReferences, getDataEntries, getDataEntriesOrThrow, getDataEntry, getDataEntryOrThrow, getDataTypeSlug, getGetAnalyticsDailyUrl, getGetCollectionsSlugContentsContentSlugUrl, getGetCollectionsSlugContentsUrl, getGetDataTypeSlugUrl, getGetPreviewTokenUrl, getGetRuntimeSettingsUrl, getMcpApiBaseUrl, getPreviewByToken, getPreviewToken, getRuntimeSettings, getSchema, getSdkApiBaseUrl, getSdkApiToken, isValidComponent, markdownComponents, mcpFetchWithTags, mdxComponents, quickValidateMdx, renderMdx, renderMdxPreview, sdkCustomInstance, sdkFetchWithTags, sdkFetcher, sdkPostFetcher, submitFormData, validateComponentProps, validateMdx };

package/dist/index.js

@@ -132,6 +132,31 @@ async function sdkFetchWithTags(path, tags, revalidate) {
   }
   return response.json();
 }
+function getMcpApiBaseUrl() {
+  const apiUrl = process.env.CMX_API_URL || DEFAULT_API_URL;
+  return `${apiUrl}/api/mcp`;
+}
+async function mcpFetchWithTags(path, tags, revalidate) {
+  const token = getSdkApiToken();
+  const baseUrl = getMcpApiBaseUrl();
+  const url = `${baseUrl}${path}`;
+  const fetchOptions = {
+    method: "GET",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`
+    },
+    next: {
+      tags: tags || [],
+      ...revalidate !== void 0 && { revalidate }
+    }
+  };
+  const response = await fetch(url, fetchOptions);
+  if (!response.ok) {
+    throw await toCmxApiError(response);
+  }
+  return response.json();
+}
 async function sdkPostFetcher(path, body) {
   const token = getSdkApiToken();
   const baseUrl = getSdkApiBaseUrl();
@@ -162,7 +187,11 @@ var CACHE_TAGS = {
   /** 全データタイプ共通 */
   data: "data",
   /** 特定データタイプ */
-  dataType: (slug) => `data:${slug}`
+  dataType: (slug) => `data:${slug}`,
+  /** 全アセット共通 */
+  assets: "assets",
+  /** 特定グループのアセット */
+  assetGroup: (group) => `assets:${group}`
 };
 
 // src/core/date-reviver.ts
@@ -404,6 +433,25 @@ async function fetchAnalyticsDailyMetrics(params) {
   }
   return response.data;
 }
+async function getAssets(options) {
+  const params = new URLSearchParams();
+  if (options?.group) params.set("group", options.group);
+  if (options?.tags) params.set("tags", options.tags);
+  if (options?.query) params.set("q", options.query);
+  if (options?.mime) params.set("mime", options.mime);
+  if (options?.limit !== void 0) params.set("limit", String(options.limit));
+  if (options?.offset !== void 0) params.set("offset", String(options.offset));
+  const query = params.toString();
+  const tags = options?.group ? [CACHE_TAGS.assets, CACHE_TAGS.assetGroup(options.group)] : [CACHE_TAGS.assets];
+  return mcpFetchWithTags(
+    `/assets/search${query ? `?${query}` : ""}`,
+    tags,
+    options?.revalidate
+  );
+}
+async function getAssetsByGroup(group, options) {
+  return getAssets({ ...options, group });
+}
 
 // src/mdx/components/basic/Callout.tsx
 import { AlertCircle, AlertTriangle, CheckCircle, Info, Lightbulb } from "lucide-react";
@@ -2211,6 +2259,8 @@ export {
   fetchAnalyticsDailyMetrics,
   fetchRuntimeSettings,
   getAnalyticsDaily,
+  getAssets,
+  getAssetsByGroup,
   getCatalogForAI,
   getCollectionContentDetail,
   getCollectionContentDetailOrThrow,
@@ -2232,6 +2282,7 @@ export {
   getGetDataTypeSlugUrl,
   getGetPreviewTokenUrl,
   getGetRuntimeSettingsUrl,
+  getMcpApiBaseUrl,
   getPreviewByToken,
   getPreviewToken,
   getRuntimeSettings,
@@ -2240,6 +2291,7 @@ export {
   getSdkApiToken,
   isValidComponent,
   markdownComponents,
+  mcpFetchWithTags,
   mdxComponents,
   quickValidateMdx,
   renderMdx,