@coreviz/sdk 1.1.2 → 1.1.3

package/README.md

@@ -217,6 +217,44 @@ The SDK also exposes namespaced methods for programmatically managing your CoreV
 
 ---
 
+## Account
+
+### `coreviz.me()`
+
+Return the current authenticated user and their default organization.
+
+**Returns:** `Promise<UserContext>` — `{ userId, email, name, organizationId, organizationName }`
+
+```typescript
+const { name, email, organizationId } = await coreviz.me();
+```
+
+---
+
+### `coreviz.baseUrl`
+
+The API base URL this instance is configured to use (read-only getter).
+
+```typescript
+console.log(coreviz.baseUrl); // 'https://lab.coreviz.io'
+```
+
+---
+
+## Organizations
+
+### `coreviz.organizations.list()`
+
+List all organizations the current user belongs to. Falls back to the user's default organization if the org-list endpoint is unavailable.
+
+**Returns:** `Promise<Organization[]>` — each `{ id, name, slug }`
+
+```typescript
+const orgs = await coreviz.organizations.list();
+```
+
+---
+
 ## Collections
 
 ### `coreviz.collections.list(organizationId?)`
@@ -245,14 +283,20 @@ const collection = await coreviz.collections.get('abc123');
 
 ---
 
-### `coreviz.collections.create(name, icon?)`
+### `coreviz.collections.create(name, icon?, organizationId?)`
 
 Create a new collection.
 
+- `organizationId` (string, optional): Target organization. Defaults to the current user's organization.
+
 **Returns:** `Promise<Collection>`
 
 ```typescript
+// Create in current user's org
 const collection = await coreviz.collections.create('Product Photos', '📦');
+
+// Create in a specific org
+const collection = await coreviz.collections.create('Product Photos', '📦', 'org_abc123');
 ```
 
 ---

package/dist/coreviz.d.ts

@@ -126,6 +126,18 @@ export interface UploadResult {
     url: string;
     message: string;
 }
+export interface Organization {
+    id: string;
+    name: string;
+    slug: string;
+}
+export interface OrganizationsNamespace {
+    /**
+     * List all organizations the current user belongs to.
+     * Returns at minimum the user's default organization from /api/me.
+     */
+    list(): Promise<Organization[]>;
+}
 export interface CollectionsNamespace {
     /**
      * List all collections in an organization.
@@ -134,8 +146,13 @@ export interface CollectionsNamespace {
     list(organizationId?: string): Promise<Collection[]>;
     /** Get a single collection by ID */
     get(collectionId: string): Promise<Collection>;
-    /** Create a new collection in the user's current organization */
-    create(name: string, icon?: string): Promise<Collection>;
+    /**
+     * Create a new collection.
+     * @param name - Display name for the collection.
+     * @param icon - Optional emoji or icon name.
+     * @param organizationId - Target organization. Defaults to the current user's organization.
+     */
+    create(name: string, icon?: string, organizationId?: string): Promise<Collection>;
     /** Update a collection's name or icon */
     update(collectionId: string, updates: CollectionUpdateOptions): Promise<Collection>;
 }
@@ -231,10 +248,15 @@ export declare class CoreViz {
     private _baseUrl;
     private _orgIdCache;
     collections: CollectionsNamespace;
+    organizations: OrganizationsNamespace;
     media: MediaNamespace;
     folders: FoldersNamespace;
     tags: TagsNamespace;
     constructor(config?: CoreVizConfig);
+    /** Return the current authenticated user and their default organization. */
+    me(): Promise<UserContext>;
+    /** The API base URL this instance is configured to use. */
+    get baseUrl(): string;
     private getHeaders;
     /** Resolve the current user's org ID (cached after first call) */
     private _me;

package/dist/coreviz.js

@@ -42,6 +42,21 @@ class CoreViz {
         this.token = config.token;
         this._baseUrl = config.baseUrl || 'https://lab.coreviz.io';
         // ── Management namespaces ────────────────────────────────────────────
+        this.organizations = {
+            list: async () => {
+                // Try the Better Auth organization list endpoint first
+                try {
+                    const data = await this._fetch('/api/auth/organization/list');
+                    const orgs = Array.isArray(data) ? data : data.organizations ?? [];
+                    if (orgs.length > 0)
+                        return orgs;
+                }
+                catch { /* endpoint may not exist on all deployments */ }
+                // Fall back to the single org returned by /api/me
+                const me = await this._me();
+                return [{ id: me.organizationId, name: me.organizationName ?? me.organizationId, slug: me.organizationId }];
+            },
+        };
         this.collections = {
             list: async (organizationId) => {
                 const orgId = organizationId || (await this._me()).organizationId;
@@ -52,9 +67,9 @@ class CoreViz {
                 const data = await this._fetch(`/api/dataset/${collectionId}`);
                 return data.dataset;
             },
-            create: async (name, icon) => {
-                const { organizationId } = await this._me();
-                const data = await this._fetchMethod('POST', `/api/organization/${organizationId}/datasets`, {
+            create: async (name, icon, organizationId) => {
+                const orgId = organizationId || (await this._me()).organizationId;
+                const data = await this._fetchMethod('POST', `/api/organization/${orgId}/datasets`, {
                     name,
                     ...(icon ? { icon } : {}),
                 });
@@ -237,6 +252,15 @@ class CoreViz {
             },
         };
     }
+    // ── Public helpers ───────────────────────────────────────────────────────
+    /** Return the current authenticated user and their default organization. */
+    async me() {
+        return this._me();
+    }
+    /** The API base URL this instance is configured to use. */
+    get baseUrl() {
+        return this._baseUrl;
+    }
     // ── Private helpers ──────────────────────────────────────────────────────
     getHeaders() {
         const headers = {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { CoreViz, CoreVizConfig, DescribeOptions, EditOptions, TagOptions, TagResponse, EmbedOptions, EmbedResponse, GenerateOptions, UserContext, Collection, Media, MediaObject, MediaFrame, Folder, BrowseOptions, BrowseResult, SearchResult, SearchOptions, SimilarityOptions, UploadOptions, UploadResult, CollectionsNamespace, MediaNamespace, FoldersNamespace, TagsNamespace, FolderUpdateOptions, CollectionUpdateOptions, DeleteVersionResult } from './coreviz';
+import { CoreViz, CoreVizConfig, DescribeOptions, EditOptions, TagOptions, TagResponse, EmbedOptions, EmbedResponse, GenerateOptions, UserContext, Organization, Collection, Media, MediaObject, MediaFrame, Folder, BrowseOptions, BrowseResult, SearchResult, SearchOptions, SimilarityOptions, UploadOptions, UploadResult, OrganizationsNamespace, CollectionsNamespace, MediaNamespace, FoldersNamespace, TagsNamespace, FolderUpdateOptions, CollectionUpdateOptions, DeleteVersionResult } from './coreviz';
 import { resize } from './resize';
 export { CoreViz, resize };
-export type { CoreVizConfig, DescribeOptions, EditOptions, TagOptions, TagResponse, EmbedOptions, EmbedResponse, GenerateOptions, UserContext, Collection, Media, MediaObject, MediaFrame, Folder, BrowseOptions, BrowseResult, SearchResult, SearchOptions, SimilarityOptions, UploadOptions, UploadResult, CollectionsNamespace, MediaNamespace, FoldersNamespace, TagsNamespace, FolderUpdateOptions, CollectionUpdateOptions, DeleteVersionResult };
+export type { CoreVizConfig, DescribeOptions, EditOptions, TagOptions, TagResponse, EmbedOptions, EmbedResponse, GenerateOptions, UserContext, Organization, Collection, Media, MediaObject, MediaFrame, Folder, BrowseOptions, BrowseResult, SearchResult, SearchOptions, SimilarityOptions, UploadOptions, UploadResult, OrganizationsNamespace, CollectionsNamespace, MediaNamespace, FoldersNamespace, TagsNamespace, FolderUpdateOptions, CollectionUpdateOptions, DeleteVersionResult };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coreviz/sdk",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "CoreViz SDK",
   "main": "dist/index.js",
   "react-native": "dist/index.native.js",