@seaverse/data-service-sdk 0.1.0

package/README.md

@@ -0,0 +1,296 @@
+# @seaverse/data-service-sdk
+
+SeaVerse Data Service SDK for managing Firestore tokens in frontend applications.
+
+## Features
+
+- Generate Firestore tokens for authenticated users
+- Generate Firestore tokens for guest users
+- TypeScript support with full type definitions
+- Promise-based API using axios
+- Automatic response unwrapping
+
+## Installation
+
+```bash
+npm install @seaverse/data-service-sdk
+```
+
+## Quick Start
+
+```typescript
+import { DataServiceClient } from '@seaverse/data-service-sdk';
+
+// Create client instance
+const client = new DataServiceClient();
+
+// For authenticated users
+const token = await client.generateFirestoreToken({
+  token: 'user-jwt-token',
+  app_id: 'your-app-id',
+});
+
+// For guest users
+const guestToken = await client.generateGuestFirestoreToken({
+  app_id: 'your-app-id',
+});
+```
+
+## API Reference
+
+### DataServiceClient
+
+The main client for interacting with the Data Service API.
+
+#### Constructor
+
+```typescript
+new DataServiceClient(options?: DataServiceClientOptions)
+```
+
+**Options:**
+
+- `baseURL?: string` - Base URL for the API (default: `https://auth.seaverse.ai`)
+- `timeout?: number` - Request timeout in milliseconds (default: `10000`)
+- `headers?: Record<string, string>` - Custom request headers
+
+**Example:**
+
+```typescript
+const client = new DataServiceClient({
+  baseURL: 'https://auth.seaverse.ai',
+  timeout: 15000,
+  headers: {
+    'X-Custom-Header': 'value',
+  },
+});
+```
+
+### Methods
+
+#### generateFirestoreToken
+
+Generate a Firestore token for an authenticated user.
+
+```typescript
+generateFirestoreToken(
+  request: GenerateFirestoreTokenRequest,
+  options?: AxiosRequestConfig
+): Promise<FirestoreTokenResponse>
+```
+
+**Request:**
+
+```typescript
+interface GenerateFirestoreTokenRequest {
+  token: string;    // User's JWT token
+  app_id: string;   // Application ID
+}
+```
+
+**Response:**
+
+```typescript
+interface FirestoreTokenResponse {
+  id_token: string;         // Firebase ID Token
+  refresh_token?: string;   // Firebase Refresh Token (optional)
+  project_id: string;       // Firebase Project ID
+  database_id: string;      // Firestore Database ID
+  app_id?: string;          // Application ID
+  user_id: string;          // User ID
+  role?: string;            // User role
+  expires_in: number;       // Expiration time in seconds (typically 3600)
+}
+```
+
+**Example:**
+
+```typescript
+try {
+  const response = await client.generateFirestoreToken({
+    token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
+    app_id: 'my-app',
+  });
+
+  console.log('Firestore ID Token:', response.id_token);
+  console.log('User ID:', response.user_id);
+  console.log('Expires in:', response.expires_in, 'seconds');
+} catch (error) {
+  console.error('Failed to generate Firestore token:', error);
+}
+```
+
+#### generateGuestFirestoreToken
+
+Generate a Firestore token for a guest (unauthenticated) user.
+
+```typescript
+generateGuestFirestoreToken(
+  request: GenerateGuestFirestoreTokenRequest,
+  options?: AxiosRequestConfig
+): Promise<FirestoreTokenResponse>
+```
+
+**Request:**
+
+```typescript
+interface GenerateGuestFirestoreTokenRequest {
+  app_id: string;   // Application ID
+}
+```
+
+**Response:**
+
+Same as `FirestoreTokenResponse` above, with `role` typically set to `'guest'`.
+
+**Example:**
+
+```typescript
+try {
+  const response = await client.generateGuestFirestoreToken({
+    app_id: 'my-app',
+  });
+
+  console.log('Guest Firestore ID Token:', response.id_token);
+  console.log('Guest User ID:', response.user_id);
+  console.log('Role:', response.role); // 'guest'
+} catch (error) {
+  console.error('Failed to generate guest Firestore token:', error);
+}
+```
+
+## Usage Examples
+
+### Browser Environment
+
+```typescript
+import { DataServiceClient } from '@seaverse/data-service-sdk';
+
+const client = new DataServiceClient();
+
+// Get user token from your auth system
+const userToken = localStorage.getItem('authToken');
+
+// Generate Firestore token
+const firestoreToken = await client.generateFirestoreToken({
+  token: userToken,
+  app_id: 'my-app',
+});
+
+// Use the Firestore token to initialize Firebase
+import { initializeApp } from 'firebase/app';
+import { getFirestore } from 'firebase/firestore';
+import { signInWithCustomToken, getAuth } from 'firebase/auth';
+
+const firebaseApp = initializeApp({
+  projectId: firestoreToken.project_id,
+  // ... other Firebase config
+});
+
+const auth = getAuth(firebaseApp);
+await signInWithCustomToken(auth, firestoreToken.id_token);
+
+const db = getFirestore(firebaseApp);
+// Now you can use Firestore with the authenticated user
+```
+
+### Node.js Environment
+
+```typescript
+import { DataServiceClient } from '@seaverse/data-service-sdk';
+
+const client = new DataServiceClient();
+
+async function getFirestoreAccess(userToken: string, appId: string) {
+  try {
+    const response = await client.generateFirestoreToken({
+      token: userToken,
+      app_id: appId,
+    });
+
+    return {
+      token: response.id_token,
+      projectId: response.project_id,
+      databaseId: response.database_id,
+      userId: response.user_id,
+      expiresIn: response.expires_in,
+    };
+  } catch (error) {
+    console.error('Error getting Firestore access:', error);
+    throw error;
+  }
+}
+```
+
+### Guest User Example
+
+```typescript
+import { DataServiceClient } from '@seaverse/data-service-sdk';
+
+const client = new DataServiceClient();
+
+// For anonymous/guest users who don't have an account
+async function initializeGuestSession(appId: string) {
+  const guestToken = await client.generateGuestFirestoreToken({
+    app_id: appId,
+  });
+
+  // Initialize Firebase with guest token
+  const auth = getAuth(firebaseApp);
+  await signInWithCustomToken(auth, guestToken.id_token);
+
+  console.log('Guest session initialized:', guestToken.user_id);
+}
+```
+
+## Error Handling
+
+The SDK automatically handles API response errors and throws meaningful error messages:
+
+```typescript
+try {
+  const token = await client.generateFirestoreToken({
+    token: 'invalid-token',
+    app_id: 'my-app',
+  });
+} catch (error) {
+  if (error instanceof Error) {
+    console.error('Error:', error.message);
+    // Error messages come from the API response
+  }
+}
+```
+
+## TypeScript Support
+
+This SDK is written in TypeScript and provides full type definitions:
+
+```typescript
+import type {
+  DataServiceClient,
+  DataServiceClientOptions,
+  GenerateFirestoreTokenRequest,
+  GenerateGuestFirestoreTokenRequest,
+  FirestoreTokenResponse,
+  ApiResponse,
+  ApiError,
+} from '@seaverse/data-service-sdk';
+```
+
+## API Endpoints
+
+The SDK connects to the following endpoints by default:
+
+- **Base URL:** `https://auth.seaverse.ai`
+- **Firestore Token:** `POST /api/v1/firestore/token`
+- **Guest Token:** `POST /api/v1/firestore/guest-token`
+
+## License
+
+MIT
+
+## Support
+
+For issues and questions, please visit:
+- GitHub: https://github.com/seaverseai/sv-sdk
+- Email: support@seaverse.com

package/dist/index.cjs

@@ -0,0 +1,157 @@
+'use strict';
+
+var axios = require('axios');
+
+/**
+ * Data Service SDK configuration
+ */
+/**
+ * Default base URL for Data Service
+ */
+const DEFAULT_BASE_URL = 'https://auth.seaverse.ai';
+/**
+ * Default timeout in milliseconds
+ */
+const DEFAULT_TIMEOUT = 10000;
+/**
+ * API endpoints
+ */
+const ENDPOINTS = {
+    FIRESTORE_TOKEN: '/api/v1/firestore/token',
+    FIRESTORE_GUEST_TOKEN: '/api/v1/firestore/guest-token',
+};
+
+/**
+ * SeaVerse Data Service SDK Client
+ *
+ * Provides methods to manage Firestore tokens for authenticated users and guests.
+ *
+ * @example
+ * ```typescript
+ * // Create client instance
+ * const client = new DataServiceClient();
+ *
+ * // Generate Firestore token for authenticated user
+ * const token = await client.generateFirestoreToken({
+ *   token: 'user-jwt-token',
+ *   app_id: 'your-app-id',
+ * });
+ *
+ * // Generate Firestore token for guest
+ * const guestToken = await client.generateGuestFirestoreToken({
+ *   app_id: 'your-app-id',
+ * });
+ * ```
+ */
+class DataServiceClient {
+    constructor(options = {}) {
+        const { baseURL = DEFAULT_BASE_URL, timeout = DEFAULT_TIMEOUT, headers = {}, } = options;
+        this.axiosInstance = axios.create({
+            baseURL,
+            timeout,
+            headers: {
+                'Content-Type': 'application/json',
+                ...headers,
+            },
+        });
+        // Add response interceptor to handle API response format
+        this.axiosInstance.interceptors.response.use((response) => {
+            // Extract data from ApiResponse wrapper
+            if (response.data && typeof response.data === 'object') {
+                if ('code' in response.data && 'data' in response.data) {
+                    // Standard API response format
+                    const apiResponse = response.data;
+                    if (apiResponse.code === 0 && apiResponse.data) {
+                        response.data = apiResponse.data;
+                    }
+                    else if (apiResponse.code !== 0) {
+                        // Handle API-level errors
+                        const error = {
+                            code: apiResponse.code,
+                            message: apiResponse.message,
+                            request_id: apiResponse.request_id,
+                        };
+                        throw error;
+                    }
+                }
+            }
+            return response;
+        }, (error) => {
+            // Handle HTTP errors
+            if (error.response?.data) {
+                const apiError = error.response.data;
+                throw new Error(apiError.message || error.message);
+            }
+            throw error;
+        });
+    }
+    /**
+     * Generate Firestore token for authenticated user
+     *
+     * This method generates a Firestore custom token for an authenticated user.
+     * The user must provide a valid JWT token.
+     *
+     * @param request - The request containing user token and app ID
+     * @param options - Additional axios request configuration
+     * @returns Firestore token response with ID token and metadata
+     *
+     * @example
+     * ```typescript
+     * const response = await client.generateFirestoreToken({
+     *   token: 'user-jwt-token',
+     *   app_id: 'my-app',
+     * });
+     *
+     * console.log('Firestore ID Token:', response.id_token);
+     * console.log('User ID:', response.user_id);
+     * console.log('Expires in:', response.expires_in, 'seconds');
+     * ```
+     */
+    async generateFirestoreToken(request, options) {
+        const config = {
+            method: 'POST',
+            url: ENDPOINTS.FIRESTORE_TOKEN,
+            data: request,
+            ...options,
+        };
+        const response = await this.axiosInstance.request(config);
+        return response.data;
+    }
+    /**
+     * Generate Firestore token for guest user
+     *
+     * This method generates a Firestore custom token for a guest (unauthenticated) user.
+     * No user authentication token is required.
+     *
+     * @param request - The request containing app ID
+     * @param options - Additional axios request configuration
+     * @returns Firestore token response with ID token and metadata
+     *
+     * @example
+     * ```typescript
+     * const response = await client.generateGuestFirestoreToken({
+     *   app_id: 'my-app',
+     * });
+     *
+     * console.log('Guest Firestore ID Token:', response.id_token);
+     * console.log('Guest User ID:', response.user_id);
+     * console.log('Role:', response.role); // 'guest'
+     * ```
+     */
+    async generateGuestFirestoreToken(request, options) {
+        const config = {
+            method: 'POST',
+            url: ENDPOINTS.FIRESTORE_GUEST_TOKEN,
+            data: request,
+            ...options,
+        };
+        const response = await this.axiosInstance.request(config);
+        return response.data;
+    }
+}
+
+exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL;
+exports.DEFAULT_TIMEOUT = DEFAULT_TIMEOUT;
+exports.DataServiceClient = DataServiceClient;
+exports.ENDPOINTS = ENDPOINTS;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/config.ts","../src/client.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,207 @@
+import { AxiosRequestConfig } from 'axios';
+
+/**
+ * Type definitions for SeaVerse Data Service API
+ * Firestore token management
+ */
+/**
+ * Request to generate Firestore token for authenticated user
+ */
+interface GenerateFirestoreTokenRequest {
+    /**
+     * User account token (JWT)
+     */
+    token: string;
+    /**
+     * Application ID
+     */
+    app_id: string;
+}
+/**
+ * Request to generate Firestore token for guest user
+ */
+interface GenerateGuestFirestoreTokenRequest {
+    /**
+     * Application ID
+     */
+    app_id: string;
+}
+/**
+ * Firestore token response
+ */
+interface FirestoreTokenResponse {
+    /**
+     * Firebase ID Token (exchanged from Custom Token)
+     */
+    id_token: string;
+    /**
+     * Firebase Refresh Token (optional)
+     */
+    refresh_token?: string;
+    /**
+     * Firebase Project ID
+     */
+    project_id: string;
+    /**
+     * Firestore Database ID
+     */
+    database_id: string;
+    /**
+     * Application ID
+     */
+    app_id?: string;
+    /**
+     * User ID
+     */
+    user_id: string;
+    /**
+     * User role (guest, appadmin, superadmin)
+     */
+    role?: string;
+    /**
+     * Token expiration time in seconds (typically 3600 = 1 hour)
+     */
+    expires_in: number;
+}
+/**
+ * Standard API response wrapper
+ */
+interface ApiResponse<T> {
+    /**
+     * Response code (0 for success)
+     */
+    code: number;
+    /**
+     * Response message
+     */
+    message: string;
+    /**
+     * Request ID for tracking
+     */
+    request_id?: string;
+    /**
+     * Response data
+     */
+    data?: T;
+}
+/**
+ * API error response
+ */
+interface ApiError {
+    code: number;
+    message: string;
+    request_id?: string;
+}
+
+/**
+ * Data Service SDK Client configuration options
+ */
+interface DataServiceClientOptions {
+    /**
+     * Base URL for the Data Service API
+     * @default 'https://auth.seaverse.ai'
+     */
+    baseURL?: string;
+    /**
+     * Request timeout in milliseconds
+     * @default 10000
+     */
+    timeout?: number;
+    /**
+     * Custom request headers
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * SeaVerse Data Service SDK Client
+ *
+ * Provides methods to manage Firestore tokens for authenticated users and guests.
+ *
+ * @example
+ * ```typescript
+ * // Create client instance
+ * const client = new DataServiceClient();
+ *
+ * // Generate Firestore token for authenticated user
+ * const token = await client.generateFirestoreToken({
+ *   token: 'user-jwt-token',
+ *   app_id: 'your-app-id',
+ * });
+ *
+ * // Generate Firestore token for guest
+ * const guestToken = await client.generateGuestFirestoreToken({
+ *   app_id: 'your-app-id',
+ * });
+ * ```
+ */
+declare class DataServiceClient {
+    private axiosInstance;
+    constructor(options?: DataServiceClientOptions);
+    /**
+     * Generate Firestore token for authenticated user
+     *
+     * This method generates a Firestore custom token for an authenticated user.
+     * The user must provide a valid JWT token.
+     *
+     * @param request - The request containing user token and app ID
+     * @param options - Additional axios request configuration
+     * @returns Firestore token response with ID token and metadata
+     *
+     * @example
+     * ```typescript
+     * const response = await client.generateFirestoreToken({
+     *   token: 'user-jwt-token',
+     *   app_id: 'my-app',
+     * });
+     *
+     * console.log('Firestore ID Token:', response.id_token);
+     * console.log('User ID:', response.user_id);
+     * console.log('Expires in:', response.expires_in, 'seconds');
+     * ```
+     */
+    generateFirestoreToken(request: GenerateFirestoreTokenRequest, options?: AxiosRequestConfig): Promise<FirestoreTokenResponse>;
+    /**
+     * Generate Firestore token for guest user
+     *
+     * This method generates a Firestore custom token for a guest (unauthenticated) user.
+     * No user authentication token is required.
+     *
+     * @param request - The request containing app ID
+     * @param options - Additional axios request configuration
+     * @returns Firestore token response with ID token and metadata
+     *
+     * @example
+     * ```typescript
+     * const response = await client.generateGuestFirestoreToken({
+     *   app_id: 'my-app',
+     * });
+     *
+     * console.log('Guest Firestore ID Token:', response.id_token);
+     * console.log('Guest User ID:', response.user_id);
+     * console.log('Role:', response.role); // 'guest'
+     * ```
+     */
+    generateGuestFirestoreToken(request: GenerateGuestFirestoreTokenRequest, options?: AxiosRequestConfig): Promise<FirestoreTokenResponse>;
+}
+
+/**
+ * Data Service SDK configuration
+ */
+/**
+ * Default base URL for Data Service
+ */
+declare const DEFAULT_BASE_URL = "https://auth.seaverse.ai";
+/**
+ * Default timeout in milliseconds
+ */
+declare const DEFAULT_TIMEOUT = 10000;
+/**
+ * API endpoints
+ */
+declare const ENDPOINTS: {
+    readonly FIRESTORE_TOKEN: "/api/v1/firestore/token";
+    readonly FIRESTORE_GUEST_TOKEN: "/api/v1/firestore/guest-token";
+};
+
+export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT, DataServiceClient, ENDPOINTS };
+export type { ApiError, ApiResponse, DataServiceClientOptions, FirestoreTokenResponse, GenerateFirestoreTokenRequest, GenerateGuestFirestoreTokenRequest };

package/dist/index.js

@@ -0,0 +1,152 @@
+import axios from 'axios';
+
+/**
+ * Data Service SDK configuration
+ */
+/**
+ * Default base URL for Data Service
+ */
+const DEFAULT_BASE_URL = 'https://auth.seaverse.ai';
+/**
+ * Default timeout in milliseconds
+ */
+const DEFAULT_TIMEOUT = 10000;
+/**
+ * API endpoints
+ */
+const ENDPOINTS = {
+    FIRESTORE_TOKEN: '/api/v1/firestore/token',
+    FIRESTORE_GUEST_TOKEN: '/api/v1/firestore/guest-token',
+};
+
+/**
+ * SeaVerse Data Service SDK Client
+ *
+ * Provides methods to manage Firestore tokens for authenticated users and guests.
+ *
+ * @example
+ * ```typescript
+ * // Create client instance
+ * const client = new DataServiceClient();
+ *
+ * // Generate Firestore token for authenticated user
+ * const token = await client.generateFirestoreToken({
+ *   token: 'user-jwt-token',
+ *   app_id: 'your-app-id',
+ * });
+ *
+ * // Generate Firestore token for guest
+ * const guestToken = await client.generateGuestFirestoreToken({
+ *   app_id: 'your-app-id',
+ * });
+ * ```
+ */
+class DataServiceClient {
+    constructor(options = {}) {
+        const { baseURL = DEFAULT_BASE_URL, timeout = DEFAULT_TIMEOUT, headers = {}, } = options;
+        this.axiosInstance = axios.create({
+            baseURL,
+            timeout,
+            headers: {
+                'Content-Type': 'application/json',
+                ...headers,
+            },
+        });
+        // Add response interceptor to handle API response format
+        this.axiosInstance.interceptors.response.use((response) => {
+            // Extract data from ApiResponse wrapper
+            if (response.data && typeof response.data === 'object') {
+                if ('code' in response.data && 'data' in response.data) {
+                    // Standard API response format
+                    const apiResponse = response.data;
+                    if (apiResponse.code === 0 && apiResponse.data) {
+                        response.data = apiResponse.data;
+                    }
+                    else if (apiResponse.code !== 0) {
+                        // Handle API-level errors
+                        const error = {
+                            code: apiResponse.code,
+                            message: apiResponse.message,
+                            request_id: apiResponse.request_id,
+                        };
+                        throw error;
+                    }
+                }
+            }
+            return response;
+        }, (error) => {
+            // Handle HTTP errors
+            if (error.response?.data) {
+                const apiError = error.response.data;
+                throw new Error(apiError.message || error.message);
+            }
+            throw error;
+        });
+    }
+    /**
+     * Generate Firestore token for authenticated user
+     *
+     * This method generates a Firestore custom token for an authenticated user.
+     * The user must provide a valid JWT token.
+     *
+     * @param request - The request containing user token and app ID
+     * @param options - Additional axios request configuration
+     * @returns Firestore token response with ID token and metadata
+     *
+     * @example
+     * ```typescript
+     * const response = await client.generateFirestoreToken({
+     *   token: 'user-jwt-token',
+     *   app_id: 'my-app',
+     * });
+     *
+     * console.log('Firestore ID Token:', response.id_token);
+     * console.log('User ID:', response.user_id);
+     * console.log('Expires in:', response.expires_in, 'seconds');
+     * ```
+     */
+    async generateFirestoreToken(request, options) {
+        const config = {
+            method: 'POST',
+            url: ENDPOINTS.FIRESTORE_TOKEN,
+            data: request,
+            ...options,
+        };
+        const response = await this.axiosInstance.request(config);
+        return response.data;
+    }
+    /**
+     * Generate Firestore token for guest user
+     *
+     * This method generates a Firestore custom token for a guest (unauthenticated) user.
+     * No user authentication token is required.
+     *
+     * @param request - The request containing app ID
+     * @param options - Additional axios request configuration
+     * @returns Firestore token response with ID token and metadata
+     *
+     * @example
+     * ```typescript
+     * const response = await client.generateGuestFirestoreToken({
+     *   app_id: 'my-app',
+     * });
+     *
+     * console.log('Guest Firestore ID Token:', response.id_token);
+     * console.log('Guest User ID:', response.user_id);
+     * console.log('Role:', response.role); // 'guest'
+     * ```
+     */
+    async generateGuestFirestoreToken(request, options) {
+        const config = {
+            method: 'POST',
+            url: ENDPOINTS.FIRESTORE_GUEST_TOKEN,
+            data: request,
+            ...options,
+        };
+        const response = await this.axiosInstance.request(config);
+        return response.data;
+    }
+}
+
+export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT, DataServiceClient, ENDPOINTS };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/config.ts","../src/client.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@seaverse/data-service-sdk",
+  "version": "0.1.0",
+  "description": "SDK for SeaVerse Data Service - Firestore token management",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "build:tsc": "tsc",
+    "dev": "ROLLUP_WATCH=true rollup -c -w",
+    "clean": "rm -rf dist",
+    "test": "vitest",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "seaverse",
+    "sdk",
+    "firestore",
+    "data-service",
+    "token"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/seaverseai/sv-sdk.git",
+    "directory": "packages/data-service-sdk"
+  },
+  "author": "SeaVerse Team <support@seaverse.com>",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.2"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/node": "^20.10.0",
+    "rollup": "^4.54.0",
+    "rollup-plugin-dts": "^6.3.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.0.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}