@sanity/client 7.8.1 → 7.8.2-datasets.0

package/dist/stega.browser.d.cts

@@ -774,6 +774,10 @@ declare type ClientConfigResource =
       type: 'dashboard'
       id: string
     }
+  | {
+      type: 'project'
+      id: string
+    }
 
 /** @public */
 export declare class ClientError extends Error {
@@ -1905,6 +1909,7 @@ export declare interface GroqAgentActionParam {
   type: 'groq'
   query: string
   params?: Record<string, string>
+  perspective?: ClientPerspective
 }
 
 /**
@@ -4005,10 +4010,8 @@ export declare class ProjectsClient {
 declare interface PromptJsonResponse<T extends Record<string, Any> = Record<string, Any>> {
   /**
    *
-   * When true, the response body will be json according to the instruction.
-   * When false, the response is the raw text response to the instruction.
-   *
-   * Note: In addition to setting this to true,  `instruction` MUST include the word 'JSON', or 'json' for this to work.
+   * When format is 'json', the response will be json according to the instruction.
+   * Note: In addition to setting this to 'json',  `instruction` MUST include the word 'JSON', or 'json' for this to work.
    */
   format: 'json'
 }
@@ -4115,13 +4118,9 @@ declare interface PromptRequestBase {
 
 declare interface PromptTextResponse {
   /**
-   *
-   * When true, the response body will be json according to the instruction.
-   * When false, the response is the raw text response to the instruction.
-   *
-   * Note: In addition to setting this to true,  `instruction` MUST include the word 'JSON', or 'json' for this to work.
+   * When format is 'string', the response will be a raw text response to the instruction.
    */
-  format?: 'text'
+  format?: 'string'
 }
 
 /**

package/dist/stega.browser.d.ts

@@ -774,6 +774,10 @@ declare type ClientConfigResource =
       type: 'dashboard'
       id: string
     }
+  | {
+      type: 'project'
+      id: string
+    }
 
 /** @public */
 export declare class ClientError extends Error {
@@ -1905,6 +1909,7 @@ export declare interface GroqAgentActionParam {
   type: 'groq'
   query: string
   params?: Record<string, string>
+  perspective?: ClientPerspective
 }
 
 /**
@@ -4005,10 +4010,8 @@ export declare class ProjectsClient {
 declare interface PromptJsonResponse<T extends Record<string, Any> = Record<string, Any>> {
   /**
    *
-   * When true, the response body will be json according to the instruction.
-   * When false, the response is the raw text response to the instruction.
-   *
-   * Note: In addition to setting this to true,  `instruction` MUST include the word 'JSON', or 'json' for this to work.
+   * When format is 'json', the response will be json according to the instruction.
+   * Note: In addition to setting this to 'json',  `instruction` MUST include the word 'JSON', or 'json' for this to work.
    */
   format: 'json'
 }
@@ -4115,13 +4118,9 @@ declare interface PromptRequestBase {
 
 declare interface PromptTextResponse {
   /**
-   *
-   * When true, the response body will be json according to the instruction.
-   * When false, the response is the raw text response to the instruction.
-   *
-   * Note: In addition to setting this to true,  `instruction` MUST include the word 'JSON', or 'json' for this to work.
+   * When format is 'string', the response will be a raw text response to the instruction.
    */
-  format?: 'text'
+  format?: 'string'
 }
 
 /**

package/dist/stega.d.cts

@@ -774,6 +774,10 @@ declare type ClientConfigResource =
       type: 'dashboard'
       id: string
     }
+  | {
+      type: 'project'
+      id: string
+    }
 
 /** @public */
 export declare class ClientError extends Error {
@@ -1905,6 +1909,7 @@ export declare interface GroqAgentActionParam {
   type: 'groq'
   query: string
   params?: Record<string, string>
+  perspective?: ClientPerspective
 }
 
 /**
@@ -4005,10 +4010,8 @@ export declare class ProjectsClient {
 declare interface PromptJsonResponse<T extends Record<string, Any> = Record<string, Any>> {
   /**
    *
-   * When true, the response body will be json according to the instruction.
-   * When false, the response is the raw text response to the instruction.
-   *
-   * Note: In addition to setting this to true,  `instruction` MUST include the word 'JSON', or 'json' for this to work.
+   * When format is 'json', the response will be json according to the instruction.
+   * Note: In addition to setting this to 'json',  `instruction` MUST include the word 'JSON', or 'json' for this to work.
    */
   format: 'json'
 }
@@ -4115,13 +4118,9 @@ declare interface PromptRequestBase {
 
 declare interface PromptTextResponse {
   /**
-   *
-   * When true, the response body will be json according to the instruction.
-   * When false, the response is the raw text response to the instruction.
-   *
-   * Note: In addition to setting this to true,  `instruction` MUST include the word 'JSON', or 'json' for this to work.
+   * When format is 'string', the response will be a raw text response to the instruction.
    */
-  format?: 'text'
+  format?: 'string'
 }
 
 /**

package/dist/stega.d.ts

@@ -774,6 +774,10 @@ declare type ClientConfigResource =
       type: 'dashboard'
       id: string
     }
+  | {
+      type: 'project'
+      id: string
+    }
 
 /** @public */
 export declare class ClientError extends Error {
@@ -1905,6 +1909,7 @@ export declare interface GroqAgentActionParam {
   type: 'groq'
   query: string
   params?: Record<string, string>
+  perspective?: ClientPerspective
 }
 
 /**
@@ -4005,10 +4010,8 @@ export declare class ProjectsClient {
 declare interface PromptJsonResponse<T extends Record<string, Any> = Record<string, Any>> {
   /**
    *
-   * When true, the response body will be json according to the instruction.
-   * When false, the response is the raw text response to the instruction.
-   *
-   * Note: In addition to setting this to true,  `instruction` MUST include the word 'JSON', or 'json' for this to work.
+   * When format is 'json', the response will be json according to the instruction.
+   * Note: In addition to setting this to 'json',  `instruction` MUST include the word 'JSON', or 'json' for this to work.
    */
   format: 'json'
 }
@@ -4115,13 +4118,9 @@ declare interface PromptRequestBase {
 
 declare interface PromptTextResponse {
   /**
-   *
-   * When true, the response body will be json according to the instruction.
-   * When false, the response is the raw text response to the instruction.
-   *
-   * Note: In addition to setting this to true,  `instruction` MUST include the word 'JSON', or 'json' for this to work.
+   * When format is 'string', the response will be a raw text response to the instruction.
    */
-  format?: 'text'
+  format?: 'string'
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/client",
-  "version": "7.8.1",
+  "version": "7.8.2-datasets.0",
   "description": "Client for retrieving, creating and patching data from Sanity.io",
   "keywords": [
     "sanity",

package/src/agent/actions/commonTypes.ts

@@ -1,3 +1,5 @@
+import type {ClientPerspective} from '@sanity/client'
+
 /**
  * Include a string in the instruction: do not have to escape $ signs in the string.
  *
@@ -128,6 +130,7 @@ export interface GroqAgentActionParam {
   type: 'groq'
   query: string
   params?: Record<string, string>
+  perspective?: ClientPerspective
 }
 
 /**  @beta */

package/src/agent/actions/prompt.ts

@@ -105,23 +105,17 @@ export interface PromptRequestBase {
 interface PromptJsonResponse<T extends Record<string, Any> = Record<string, Any>> {
   /**
    *
-   * When true, the response body will be json according to the instruction.
-   * When false, the response is the raw text response to the instruction.
-   *
-   * Note: In addition to setting this to true,  `instruction` MUST include the word 'JSON', or 'json' for this to work.
+   * When format is 'json', the response will be json according to the instruction.
+   * Note: In addition to setting this to 'json',  `instruction` MUST include the word 'JSON', or 'json' for this to work.
    */
   format: 'json'
 }
 
 interface PromptTextResponse {
   /**
-   *
-   * When true, the response body will be json according to the instruction.
-   * When false, the response is the raw text response to the instruction.
-   *
-   * Note: In addition to setting this to true,  `instruction` MUST include the word 'JSON', or 'json' for this to work.
+   * When format is 'string', the response will be a raw text response to the instruction.
    */
-  format?: 'text'
+  format?: 'string'
 }
 
 /** @beta */

package/src/assets/AssetsClient.ts

@@ -184,6 +184,11 @@ function buildAssetUploadUrl(config: InitializedClientConfig, assetType: 'image'
   if (config['~experimental_resource']) {
     const {type, id} = config['~experimental_resource']
     switch (type) {
+      case 'project': {
+        throw new Error(
+          'Assets are not supported for project resources, yet. Configure the client with `{projectId: <projectId>}` instead.',
+        )
+      }
       case 'dataset': {
         throw new Error(
           'Assets are not supported for dataset resources, yet. Configure the client with `{projectId: <projectId>, dataset: <datasetId>}` instead.',

package/src/data/dataMethods.ts

@@ -664,10 +664,40 @@ export function _getDataUrl(client: Client, operation: string, path?: string): s
   const config = client.config()
   if (config['~experimental_resource']) {
     validators.resourceConfig(config)
+
+    // Special handling for dataset-related operations
+    if (operation === '' && path?.startsWith('datasets')) {
+      const {type, id} = config['~experimental_resource']
+
+      if (type === 'dataset') {
+        // For dataset resource performing dataset management operations,
+        // we need to use the project base URL
+        const segments = id.split('.')
+        if (segments.length !== 2) {
+          throw new Error('Invalid dataset resource ID. Expected format "project.dataset".')
+        }
+        const projectId = segments[0]
+        const base = `/projects/${projectId}`
+        const uri = [path].filter(Boolean).join('/')
+        return `${base}/${uri}`.replace(/\/($|\?)/, '$1')
+      } else if (type === 'project') {
+        // For project resource, use project base directly
+        const base = `/projects/${id}`
+        const uri = [path].filter(Boolean).join('/')
+        return `${base}/${uri}`.replace(/\/($|\?)/, '$1')
+      }
+    }
+
+    // For all other resource operations, use the standard resource base
     const resourceBase = resourceDataBase(config)
-    const uri = path !== undefined ? `${operation}/${path}` : operation
+    const uri = [operation, path].filter(Boolean).join('/')
     return `${resourceBase}/${uri}`.replace(/\/($|\?)/, '$1')
   }
+
+  if (operation === '') {
+    return `/${path || ''}`
+  }
+
   const catalog = validators.hasDataset(config)
   const baseUri = `/${operation}/${catalog}`
   const uri = path !== undefined ? `${baseUri}/${path}` : baseUri
@@ -753,6 +783,9 @@ const resourceDataBase = (config: InitializedClientConfig): string => {
     case 'dashboard': {
       return `/dashboards/${id}`
     }
+    case 'project': {
+      return `/projects/${id}`
+    }
     default:
       // @ts-expect-error - handle all supported resource types
       throw new Error(`Unsupported resource type: ${type.toString()}`)

package/src/datasets/DatasetsClient.ts

@@ -1,6 +1,6 @@
 import {lastValueFrom, type Observable} from 'rxjs'
 
-import {_request} from '../data/dataMethods'
+import {_getDataUrl, _request} from '../data/dataMethods'
 import type {ObservableSanityClient, SanityClient} from '../SanityClient'
 import type {DatasetAclMode, DatasetResponse, DatasetsResponse, HttpRequest} from '../types'
 import * as validate from '../validators'
@@ -47,8 +47,19 @@ export class ObservableDatasetsClient {
    * Fetch a list of datasets for the configured project
    */
   list(): Observable<DatasetsResponse> {
+    const config = this.#client.config()
+    const resource = config['~experimental_resource']
+
+    if (resource) {
+      // Only allow project resource type for listing datasets
+      if (resource.type !== 'project') {
+        throw new Error('`dataset.list()` requires a resource type of "project".')
+      }
+    }
+
+    const uri = _getDataUrl(this.#client, '', 'datasets')
     return _request<DatasetsResponse>(this.#client, this.#httpRequest, {
-      uri: '/datasets',
+      uri,
       tag: null,
     })
   }
@@ -70,7 +81,6 @@ export class DatasetsClient {
    * @param options - Options for the dataset
    */
   create(name: string, options?: {aclMode?: DatasetAclMode}): Promise<DatasetResponse> {
-    validate.resourceGuard('dataset', this.#client.config())
     return lastValueFrom(
       _modify<DatasetResponse>(this.#client, this.#httpRequest, 'PUT', name, options),
     )
@@ -83,7 +93,6 @@ export class DatasetsClient {
    * @param options - New options for the dataset
    */
   edit(name: string, options?: {aclMode?: DatasetAclMode}): Promise<DatasetResponse> {
-    validate.resourceGuard('dataset', this.#client.config())
     return lastValueFrom(
       _modify<DatasetResponse>(this.#client, this.#httpRequest, 'PATCH', name, options),
     )
@@ -95,7 +104,6 @@ export class DatasetsClient {
    * @param name - Name of the dataset to delete
    */
   delete(name: string): Promise<{deleted: true}> {
-    validate.resourceGuard('dataset', this.#client.config())
     return lastValueFrom(_modify<{deleted: true}>(this.#client, this.#httpRequest, 'DELETE', name))
   }
 
@@ -103,9 +111,19 @@ export class DatasetsClient {
    * Fetch a list of datasets for the configured project
    */
   list(): Promise<DatasetsResponse> {
-    validate.resourceGuard('dataset', this.#client.config())
+    const config = this.#client.config()
+    const resource = config['~experimental_resource']
+
+    if (resource) {
+      // Only allow project resource type for listing datasets
+      if (resource.type !== 'project') {
+        throw new Error('`dataset.list()` requires a resource type of "project".')
+      }
+    }
+
+    const uri = _getDataUrl(this.#client, '', 'datasets')
     return lastValueFrom(
-      _request<DatasetsResponse>(this.#client, this.#httpRequest, {uri: '/datasets', tag: null}),
+      _request<DatasetsResponse>(this.#client, this.#httpRequest, {uri, tag: null}),
     )
   }
 }
@@ -117,11 +135,32 @@ function _modify<R = unknown>(
   name: string,
   options?: {aclMode?: DatasetAclMode},
 ) {
-  validate.resourceGuard('dataset', client.config())
   validate.dataset(name)
+
+  const config = client.config()
+  const resource = config['~experimental_resource']
+
+  // For individual dataset operations, only "dataset" resource type makes sense
+  if (resource) {
+    if (resource.type === 'dataset') {
+      // Validate the resource ID format and ensure the name matches
+      const segments = resource.id.split('.')
+      if (segments.length !== 2) {
+        throw new Error('Dataset resource ID must be in the format "project.dataset"')
+      }
+      const datasetName = segments[1]
+      if (name !== datasetName) {
+        throw new Error(`Dataset name "${name}" does not match resource dataset "${datasetName}"`)
+      }
+    } else {
+      throw new Error('Dataset create/edit/delete operations require a resource type of "dataset"')
+    }
+  }
+
+  const uri = _getDataUrl(client, '', `datasets/${name}`)
   return _request<R>(client, httpRequest, {
     method,
-    uri: `/datasets/${name}`,
+    uri,
     body: options,
     tag: null,
   })

package/src/projects/ProjectsClient.ts

@@ -3,7 +3,6 @@ import {lastValueFrom, type Observable} from 'rxjs'
 import {_request} from '../data/dataMethods'
 import type {ObservableSanityClient, SanityClient} from '../SanityClient'
 import type {HttpRequest, SanityProject} from '../types'
-import * as validate from '../validators'
 
 /** @internal */
 export class ObservableProjectsClient {
@@ -25,7 +24,6 @@ export class ObservableProjectsClient {
   list(options?: {
     includeMembers?: boolean
   }): Observable<SanityProject[] | Omit<SanityProject, 'members'>[]> {
-    validate.resourceGuard('projects', this.#client.config())
     const uri = options?.includeMembers === false ? '/projects?includeMembers=false' : '/projects'
     return _request<SanityProject[]>(this.#client, this.#httpRequest, {uri})
   }
@@ -36,7 +34,6 @@ export class ObservableProjectsClient {
    * @param projectId - ID of the project to fetch
    */
   getById(projectId: string): Observable<SanityProject> {
-    validate.resourceGuard('projects', this.#client.config())
     return _request<SanityProject>(this.#client, this.#httpRequest, {uri: `/projects/${projectId}`})
   }
 }
@@ -59,7 +56,6 @@ export class ProjectsClient {
   list(options?: {includeMembers?: true}): Promise<SanityProject[]>
   list(options?: {includeMembers?: false}): Promise<Omit<SanityProject, 'members'>[]>
   list(options?: {includeMembers?: boolean}): Promise<SanityProject[]> {
-    validate.resourceGuard('projects', this.#client.config())
     const uri = options?.includeMembers === false ? '/projects?includeMembers=false' : '/projects'
     return lastValueFrom(_request<SanityProject[]>(this.#client, this.#httpRequest, {uri}))
   }
@@ -70,7 +66,6 @@ export class ProjectsClient {
    * @param projectId - ID of the project to fetch
    */
   getById(projectId: string): Promise<SanityProject> {
-    validate.resourceGuard('projects', this.#client.config())
     return lastValueFrom(
       _request<SanityProject>(this.#client, this.#httpRequest, {uri: `/projects/${projectId}`}),
     )

package/src/stega/filterDefault.ts

@@ -86,13 +86,41 @@ function isValidDate(dateString: string) {
   return /^\d{4}-\d{2}-\d{2}/.test(dateString) ? Boolean(Date.parse(dateString)) : false
 }
 
+const allowedProtocols = new Set([
+  'app:',
+  'data:',
+  'discord:',
+  'file:',
+  'ftp:',
+  'ftps:',
+  'geo:',
+  'http:',
+  'https:',
+  'imap:',
+  'javascript:',
+  'magnet:',
+  'mailto:',
+  'maps:',
+  'ms-excel:',
+  'ms-powerpoint:',
+  'ms-word:',
+  'slack:',
+  'sms:',
+  'spotify:',
+  'steam:',
+  'teams:',
+  'tel:',
+  'vscode:',
+  'zoom:',
+])
+
 function isValidURL(url: string) {
   try {
-    new URL(url, url.startsWith('/') ? 'https://acme.com' : undefined)
+    const {protocol} = new URL(url, url.startsWith('/') ? 'https://acme.com' : undefined)
+    return allowedProtocols.has(protocol) || protocol.startsWith('web+')
   } catch {
     return false
   }
-  return true
 }
 
 function hasTypeLike(path: ContentSourceMapParsedPath): boolean {

package/src/types.ts

@@ -70,6 +70,10 @@ type ClientConfigResource =
       type: 'dashboard'
       id: string
     }
+  | {
+      type: 'project'
+      id: string
+    }
 
 /** @public */
 export interface ClientConfig {

package/src/validators.ts

@@ -113,6 +113,7 @@ export const resourceConfig = (config: InitializedClientConfig): void => {
       }
       return
     }
+    case 'project':
     case 'dashboard':
     case 'media-library':
     case 'canvas': {