@sanity-labs/sdk-addon-dataset-runtime 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sanity Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# `@sanity-labs/sdk-addon-dataset-runtime`
+
+This package provides the narrow runtime values that `@sanity-labs/sdk-comments` and
+`@sanity-labs/sdk-tasks` both need:
+
+- `addonDataset`
+- `contentDataset?`
+- `projectId`
+- `workspaceId?`
+- `workspaceTitle?`
+
+## Installation
+
+```bash
+pnpm add @sanity-labs/sdk-addon-dataset-runtime react react-dom
+```
+
+## Usage
+
+```tsx
+import { AddonDatasetRuntimeProvider } from "@sanity-labs/sdk-addon-dataset-runtime";
+
+<AddonDatasetRuntimeProvider
+  addonDataset="production-comments"
+  contentDataset="production"
+  projectId="myProjectId"
+  workspaceId="news_and_media"
+  workspaceTitle="News and Media"
+>
+  <App />
+</AddonDatasetRuntimeProvider>;
+```
+
+Use this provider when multiple components should share the same addon runtime
+identity. Feature hooks in `@sanity-labs/sdk-comments` and `@sanity-labs/sdk-tasks`
+also support direct configuration, so this package is recommended shared
+infrastructure rather than a mandatory prerequisite for every integration.
+
+## Primary Exports
+
+- `AddonDatasetRuntimeProvider`
+- `useAddonDatasetRuntime()`
+- `useOptionalAddonDatasetRuntime()`
+- `AddonDatasetRuntimeValue`
+
+## What Is Not Included
+
+This package intentionally does not ship:
+
+- task caches
+- optimistic feature state
+- task mutation helpers
+- comment mutation helpers
+
+Feature behavior lives in `@sanity-labs/sdk-comments` and `@sanity-labs/sdk-tasks`.

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from 'react';
+export interface AddonDatasetRuntimeValue {
+    addonDataset: string;
+    contentDataset?: string;
+    projectId: string;
+    workspaceId?: string;
+    workspaceTitle?: string;
+}
+interface AddonDatasetRuntimeProviderProps extends AddonDatasetRuntimeValue {
+    children: ReactNode;
+}
+export declare function AddonDatasetRuntimeProvider({ addonDataset, children, contentDataset, projectId, workspaceId, workspaceTitle, }: AddonDatasetRuntimeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useAddonDatasetRuntime(): AddonDatasetRuntimeValue;
+export declare function useOptionalAddonDatasetRuntime(): AddonDatasetRuntimeValue | null;
+export {};

package/dist/index.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from 'react';
+const AddonDatasetRuntimeContext = createContext(null);
+export function AddonDatasetRuntimeProvider({ addonDataset, children, contentDataset, projectId, workspaceId, workspaceTitle, }) {
+    const value = useMemo(() => ({
+        addonDataset,
+        contentDataset,
+        projectId,
+        workspaceId,
+        workspaceTitle,
+    }), [addonDataset, contentDataset, projectId, workspaceId, workspaceTitle]);
+    return (_jsx(AddonDatasetRuntimeContext.Provider, { value: value, children: children }));
+}
+export function useAddonDatasetRuntime() {
+    const runtime = useContext(AddonDatasetRuntimeContext);
+    if (!runtime) {
+        throw new Error('useAddonDatasetRuntime must be used inside <AddonDatasetRuntimeProvider>');
+    }
+    return runtime;
+}
+export function useOptionalAddonDatasetRuntime() {
+    return useContext(AddonDatasetRuntimeContext);
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@sanity-labs/sdk-addon-dataset-runtime",
+  "version": "1.0.0",
+  "private": false,
+  "type": "module",
+  "license": "MIT",
+  "description": "Shared addon dataset runtime context for Sanity Labs SDK feature packages.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sanity-labs/sdk-addon-dataset-runtime.git"
+  },
+  "homepage": "https://github.com/sanity-labs/sdk-addon-dataset-runtime#readme",
+  "bugs": {
+    "url": "https://github.com/sanity-labs/sdk-addon-dataset-runtime/issues"
+  },
+  "keywords": [
+    "sanity",
+    "sanity-labs",
+    "runtime",
+    "react"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "packageManager": "pnpm@10.32.1",
+  "devDependencies": {
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "typescript": "^6.0.2"
+  }
+}