supabase/apps/studio/data/storage/keys.ts

export const storageKeys = {
  bucket: (projectRef: string | undefined, bucketId: string | undefined) =>
    ['projects', projectRef, 'buckets', bucketId] as const,
  buckets: (projectRef: string | undefined) => ['projects', projectRef, 'buckets'] as const,
  bucketsList: (
    projectRef: string | undefined,
    params: {
      limit?: number
      search?: string
      sortColumn?: string
      sortOrder?: string
    } = {}
  ) =>
    [
      'projects',
      projectRef,
      'buckets',
      'list',
      {
        limit: params.limit,
        search: params.search,
        sortColumn: params.sortColumn,
        sortOrder: params.sortOrder,
      },
    ] as const,
  analyticsBuckets: (projectRef: string | undefined) =>
    ['projects', projectRef, 'analytics-buckets'] as const,
  vectorBuckets: (projectRef: string | undefined) =>
    ['projects', projectRef, 'vector-buckets'] as const,
  vectorBucket: (projectRef: string | undefined, vectorbucketName: string | undefined) =>
    ['projects', projectRef, 'vector-bucket', vectorbucketName] as const,
  vectorBucketsIndexes: (projectRef: string | undefined, vectorBucketName: string | undefined) =>
    ['projects', projectRef, 'vector-buckets', vectorBucketName, 'indexes'] as const,
  archive: (projectRef: string | undefined) => ['projects', projectRef, 'archive'] as const,
  publicBucketsWithSelectPolicies: (projectRef: string | undefined, bucketId: string | undefined) =>
    ['projects', projectRef, 'public-buckets-with-select-policies', bucketId] as const,
  objects: (
    projectRef: string | undefined,
    bucketId: string | undefined,
    path: string,
    params: {
      limit?: number
      search?: string
      sortColumn?: string
      sortOrder?: string
    } = {}
  ) =>
    [
      'projects',
      projectRef,
      'buckets',
      bucketId,
      'objects',
      ...(path ? [path] : []),
      ...(params ? [params] : []),
    ] as const,
  folders: (projectRef: string | undefined, bucketId: string | undefined) =>
    ['projects', projectRef, 'buckets', bucketId, 'folders'] as const,
  bucketLifecycle: (projectRef: string | undefined, bucketId: string | undefined) =>
    ['projects', projectRef, 'buckets', bucketId, 'lifecycle'] as const,
  /** The policy is part of the key: the API derives each version's expiry from it. */
  objectVersions: (
    projectRef: string | undefined,
    bucketId: string | undefined,
    objectName: string | undefined,
    lifecyclePolicy?: { expiryDays: number | null; maxVersions: number | null }
  ) =>
    [
      'projects',
      projectRef,
      'buckets',
      bucketId,
      'object-versions',
      objectName,
      ...(lifecyclePolicy ? [lifecyclePolicy] : []),
    ] as const,
  /** Omit `versionId` for a prefix that matches every version's URL for one object. */
  fileUrl: ({
    projectRef,
    isBucketPublic,
    bucketId,
    path,
    versionId,
  }: {
    projectRef?: string
    isBucketPublic?: boolean
    bucketId?: string
    path: string
    versionId?: string
  }) =>
    [
      projectRef,
      'buckets',
      isBucketPublic,
      bucketId,
      'file',
      path,
      ...(versionId === undefined ? [] : [versionId]),
    ] as const,
  icebergNamespaces: ({ projectRef, warehouse }: { projectRef?: string; warehouse?: string }) =>
    [projectRef, 'warehouse', warehouse, 'namespaces'] as const,
  icebergNamespace: ({
    projectRef,
    warehouse,
    namespace,
  }: {
    projectRef?: string
    warehouse: string
    namespace: string
  }) => [projectRef, 'warehouse', warehouse, 'namespaces', namespace] as const,
  icebergNamespaceTables: ({
    projectRef,
    warehouse,
    namespace,
  }: {
    projectRef?: string
    warehouse?: string
    namespace?: string
  }) => [projectRef, 'warehouse', warehouse, 'namespaces', namespace, 'tables'] as const,
}