sanity-plugin-smart-asset-manager 1.0.0

package/src/types/index.ts

@@ -0,0 +1,29 @@
+export interface Asset {
+  _id: string
+  _ref?: string
+  _type: string
+  url: string
+  extension: string
+  mimeType?: string
+  size: number
+  originalFilename?: string
+  metadata?: {
+    dimensions?: {
+      width: number
+      height: number
+    }
+  }
+}
+
+export interface ReferencedDocument {
+  _id: string
+  _type: string
+  title: string
+}
+
+export type UsageInfo = {[assetId: string]: ReferencedDocument[]}
+
+export type AssetTab = 'all' | 'analysis' | 'unused'
+export type SortOrder = '_createdAt' | 'size' | 'originalFilename'
+export type AssetTypeFilter = 'all' | 'image' | 'file' | 'video' | 'audio'
+export type SizeFilter = 'all' | 'small' | 'medium' | 'large'

package/src/utils/__tests__/formatBytes.test.ts

@@ -0,0 +1,25 @@
+import {describe, it, expect} from 'vitest'
+import {formatBytes} from '../formatBytes'
+
+describe('formatBytes', () => {
+  it('should format 0 bytes correctly', () => {
+    expect(formatBytes(0)).toBe('0 B')
+  })
+
+  it('should format bytes correctly', () => {
+    expect(formatBytes(512)).toBe('512 B')
+  })
+
+  it('should format KB correctly', () => {
+    expect(formatBytes(1024)).toBe('1 KB')
+    expect(formatBytes(2048)).toBe('2 KB')
+  })
+
+  it('should format MB correctly', () => {
+    expect(formatBytes(1048576)).toBe('1 MB')
+  })
+
+  it('should format decimals correctly', () => {
+    expect(formatBytes(1536)).toBe('1.5 KB')
+  })
+})

package/src/utils/assetQueries.ts

@@ -0,0 +1,59 @@
+import type {SanityClient} from 'sanity'
+import type {Asset, ReferencedDocument} from '@/types'
+
+/**
+ * Checks where a specific asset is used in the studio.
+ */
+export async function getAssetUsage(
+  sanityClient: SanityClient,
+  assetId: string,
+): Promise<ReferencedDocument[]> {
+  const query = `*[references($assetId)] {
+    _id,
+    _type,
+    "title": coalesce(title, name, label, _id)
+  }`
+
+  return await sanityClient.fetch(query, {assetId})
+}
+
+/**
+ * Finds all assets that are not referenced by any other document.
+ */
+export async function findUnusedAssets(sanityClient: SanityClient): Promise<Asset[]> {
+  const query = `*[
+    _type in ["sanity.imageAsset", "sanity.fileAsset"] &&
+    count(*[references(^._id)]) == 0
+  ] {
+    _id,
+    _type,
+    url,
+    size,
+    extension,
+    mimeType,
+    originalFilename,
+    metadata { dimensions }
+  }`
+
+  return await sanityClient.fetch(query)
+}
+
+/**
+ * Bulk delete assets.
+ */
+export async function deleteAssets(sanityClient: SanityClient, assetIds: string[]) {
+  const transaction = sanityClient.transaction()
+  assetIds.forEach((id) => transaction.delete(id))
+  return await transaction.commit()
+}
+
+/**
+ * Update asset original filename.
+ */
+export async function updateAssetFilename(
+  sanityClient: SanityClient,
+  assetId: string,
+  filename: string,
+) {
+  return await sanityClient.patch(assetId).set({originalFilename: filename}).commit()
+}

package/src/utils/formatBytes.ts

@@ -0,0 +1,10 @@
+/**
+ * Formats bytes to human readable format.
+ */
+export const formatBytes = (bytes: number) => {
+  if (bytes === 0) return '0 B'
+  const k = 1024
+  const sizes = ['B', 'KB', 'MB', 'GB']
+  const i = Math.floor(Math.log(bytes) / Math.log(k))
+  return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i]
+}