@memvid/sdk 2.0.146 → 2.0.147

package/dist/index.d.ts

@@ -264,6 +264,113 @@ export declare function listMemories(options?: {
     apiKey?: string;
     dashboardUrl?: string;
 }): Promise<MemoryInfo[]>;
+/**
+ * Options for creating a project on the cloud.
+ */
+export interface CreateProjectOptions {
+    /** Name for the project */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** API key (uses global config or env var if not specified) */
+    apiKey?: string;
+    /** Dashboard URL (uses global config or env var if not specified) */
+    dashboardUrl?: string;
+}
+/**
+ * Result of creating a project on the cloud.
+ */
+export interface CreateProjectResult {
+    /** The project ID (24-char ObjectId format) */
+    id: string;
+    /** Organisation ID */
+    organisationId: string;
+    /** URL-friendly slug */
+    slug: string;
+    /** Project name */
+    name: string;
+    /** Description */
+    description: string | null;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+}
+/**
+ * Project info returned from listProjects.
+ */
+export interface ProjectInfo {
+    /** The project ID (24-char ObjectId format) */
+    id: string;
+    /** Organisation ID */
+    organisationId: string;
+    /** URL-friendly slug */
+    slug: string;
+    /** Project name */
+    name: string;
+    /** Description */
+    description: string | null;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+}
+/**
+ * Create a new project on the cloud dashboard.
+ *
+ * Projects are containers that organize multiple memories together.
+ * Use projects to group related memories (e.g., by environment, team, or use case).
+ *
+ * @param options - Project creation options
+ * @returns The created project details
+ *
+ * @example
+ * ```typescript
+ * import { configure, createProject, createMemory, create } from 'memvid';
+ *
+ * configure({
+ *   apiKey: 'mv2_your_api_key',
+ *   dashboardUrl: 'http://localhost:3001',
+ * });
+ *
+ * // Create a project
+ * const project = await createProject({
+ *   name: 'Production Environment',
+ *   description: 'All production memories',
+ * });
+ *
+ * console.log('Created project:', project.id);
+ *
+ * // Create a memory in this project
+ * const memory = await createMemory({
+ *   name: 'Customer Support KB',
+ *   projectId: project.id,
+ * });
+ * ```
+ */
+export declare function createProject(options: CreateProjectOptions): Promise<CreateProjectResult>;
+/**
+ * List all projects for the authenticated organisation.
+ *
+ * @param options - Optional API key and dashboard URL overrides
+ * @returns Array of project info objects
+ *
+ * @example
+ * ```typescript
+ * import { configure, listProjects } from 'memvid';
+ *
+ * configure({ apiKey: 'mv2_your_api_key' });
+ *
+ * const projects = await listProjects();
+ * for (const project of projects) {
+ *   console.log(`${project.name} (${project.id})`);
+ * }
+ * ```
+ */
+export declare function listProjects(options?: {
+    apiKey?: string;
+    dashboardUrl?: string;
+}): Promise<ProjectInfo[]>;
 type UseFunction = {
     (kind: Kind, filename: string, apiKeyOrOptions?: ApiKey | UseOptions, options?: UseOptions): Promise<Memvid>;
     verify(path: string, options?: UseVerifyOptions): Promise<unknown>;

package/dist/index.js

@@ -44,6 +44,8 @@ exports.validateConfig = validateConfig;
 exports.resolveMemory = resolveMemory;
 exports.createMemory = createMemory;
 exports.listMemories = listMemories;
+exports.createProject = createProject;
+exports.listProjects = listProjects;
 exports.lockWho = lockWho;
 exports.lockNudge = lockNudge;
 exports.lock = lock;
@@ -454,6 +456,136 @@ async function listMemories(options) {
         updatedAt: m.updated_at,
     }));
 }
+/**
+ * Create a new project on the cloud dashboard.
+ *
+ * Projects are containers that organize multiple memories together.
+ * Use projects to group related memories (e.g., by environment, team, or use case).
+ *
+ * @param options - Project creation options
+ * @returns The created project details
+ *
+ * @example
+ * ```typescript
+ * import { configure, createProject, createMemory, create } from 'memvid';
+ *
+ * configure({
+ *   apiKey: 'mv2_your_api_key',
+ *   dashboardUrl: 'http://localhost:3001',
+ * });
+ *
+ * // Create a project
+ * const project = await createProject({
+ *   name: 'Production Environment',
+ *   description: 'All production memories',
+ * });
+ *
+ * console.log('Created project:', project.id);
+ *
+ * // Create a memory in this project
+ * const memory = await createMemory({
+ *   name: 'Customer Support KB',
+ *   projectId: project.id,
+ * });
+ * ```
+ */
+async function createProject(options) {
+    const { name, description } = options;
+    // Resolve API key
+    const apiKey = options.apiKey || globalConfig.apiKey || process.env.MEMVID_API_KEY;
+    if (!apiKey) {
+        throw new error_1.ApiKeyRequiredError("API key required for createProject(). " +
+            "Set via configure({ apiKey: 'mv2_...' }), MEMVID_API_KEY env var, or options.apiKey. " +
+            "Get your API key at https://memvid.com/dashboard/api-keys");
+    }
+    // Resolve dashboard URL
+    const dashboardUrl = (options.dashboardUrl ||
+        globalConfig.dashboardUrl ||
+        process.env.MEMVID_DASHBOARD_URL ||
+        "https://memvid.com").replace(/\/$/, "");
+    const url = `${dashboardUrl}/api/projects`;
+    const body = { name };
+    if (description)
+        body.description = description;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": apiKey,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new error_1.MemvidError("MV022", `Failed to create project: ${response.status} ${response.statusText}. ${text}`);
+    }
+    const json = await response.json();
+    const data = json.data || json;
+    return {
+        id: data.id,
+        organisationId: data.organisation_id,
+        slug: data.slug,
+        name: data.name,
+        description: data.description,
+        createdAt: data.created_at,
+        updatedAt: data.updated_at,
+    };
+}
+/**
+ * List all projects for the authenticated organisation.
+ *
+ * @param options - Optional API key and dashboard URL overrides
+ * @returns Array of project info objects
+ *
+ * @example
+ * ```typescript
+ * import { configure, listProjects } from 'memvid';
+ *
+ * configure({ apiKey: 'mv2_your_api_key' });
+ *
+ * const projects = await listProjects();
+ * for (const project of projects) {
+ *   console.log(`${project.name} (${project.id})`);
+ * }
+ * ```
+ */
+async function listProjects(options) {
+    // Resolve API key
+    const apiKey = options?.apiKey || globalConfig.apiKey || process.env.MEMVID_API_KEY;
+    if (!apiKey) {
+        throw new error_1.ApiKeyRequiredError("API key required for listProjects(). " +
+            "Set via configure({ apiKey: 'mv2_...' }), MEMVID_API_KEY env var, or options.apiKey. " +
+            "Get your API key at https://memvid.com/dashboard/api-keys");
+    }
+    // Resolve dashboard URL
+    const dashboardUrl = (options?.dashboardUrl ||
+        globalConfig.dashboardUrl ||
+        process.env.MEMVID_DASHBOARD_URL ||
+        "https://memvid.com").replace(/\/$/, "");
+    const url = `${dashboardUrl}/api/projects`;
+    const response = await fetch(url, {
+        method: "GET",
+        headers: {
+            "x-api-key": apiKey,
+        },
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new error_1.MemvidError("MV023", `Failed to list projects: ${response.status} ${response.statusText}. ${text}`);
+    }
+    const json = await response.json();
+    const data = json.data || json;
+    const projects = data.projects || [];
+    return projects.map((p) => ({
+        id: p.id,
+        organisationId: p.organisation_id,
+        slug: p.slug,
+        name: p.name,
+        description: p.description,
+        createdAt: p.created_at,
+        updatedAt: p.updated_at,
+    }));
+}
 // ===========================================================================
 // Load platform-specific native binary
 function loadNativeAddon() {
@@ -944,6 +1076,23 @@ class MemvidImpl {
             return result;
         });
     }
+    /**
+     * Remove a frame by its ID.
+     *
+     * This performs a soft delete (tombstone) - the frame is marked as deleted
+     * and won't appear in search results or timeline, but the data remains
+     * in the file until compaction.
+     *
+     * @param frameId - The frame ID to remove (returned by put())
+     * @returns The WAL sequence number of the tombstone operation
+     */
+    async remove(frameId) {
+        return wrapAsync(async () => {
+            const result = await this.core.remove(frameId);
+            (0, analytics_1.trackCommand)(this.filename, "remove", true);
+            return result;
+        });
+    }
     async putMany(requests, options) {
         return wrapAsync(async () => {
             const embedder = options?.embedder;
@@ -1550,6 +1699,9 @@ class MemvidImpl {
     async applyTicket(ticket) {
         return wrapAsync(() => this.core.applyTicket(ticket));
     }
+    async applySignedTicket(ticket) {
+        return wrapAsync(() => this.core.applySignedTicket(ticket));
+    }
     async getMemoryBinding() {
         return wrapAsync(() => this.core.getMemoryBinding());
     }

package/dist/types.d.ts

@@ -351,6 +351,7 @@ export interface SessionReplayResult {
 }
 export interface NativeMemvid {
     put(args: NativePutArgs): Promise<string>;
+    remove(frameId: string): Promise<number>;
     putMany(requests: NativePutManyRequest[], options?: NativePutManyOptions): Promise<string[]>;
     find(query: string, options?: NativeFindOptions): Promise<unknown>;
     findWithEmbedding(query: string, embedding: number[], options?: NativeFindOptions): Promise<unknown>;
@@ -365,7 +366,10 @@ export interface NativeMemvid {
     seal(): Promise<void>;
     enableLex(): Promise<void>;
     setVectorCompression(enabled: boolean): Promise<void>;
+    /** @deprecated Use applySignedTicket() for cryptographically verified tickets */
     applyTicket(ticket: string): Promise<void>;
+    /** Apply a cryptographically signed ticket (verifies signature against Memvid public key) */
+    applySignedTicket(ticket: string): Promise<void>;
     getMemoryBinding(): Promise<MemoryBinding | null>;
     unbindMemory(): Promise<void>;
     getCapacity(): Promise<number>;
@@ -404,6 +408,8 @@ export interface TicketInfo {
     seq_no: number;
     expires_in_secs: number;
     capacity_bytes: number;
+    /** Whether the ticket was cryptographically verified against Memvid's public key */
+    verified: boolean;
 }
 export interface SyncTicketResult {
     already_bound: boolean;
@@ -411,6 +417,19 @@ export interface SyncTicketResult {
     issuer: string;
     seq_no: number;
     capacity_bytes: number;
+    /** Whether the ticket was cryptographically verified against Memvid's public key */
+    verified: boolean;
+}
+/** A cryptographically signed ticket from the Memvid control plane */
+export interface SignedTicket {
+    issuer: string;
+    seq_no: number;
+    expires_in_secs: number;
+    capacity_bytes?: number;
+    /** The memory ID this ticket is bound to */
+    memory_id: string;
+    /** Base64-encoded Ed25519 signature */
+    signature: string;
 }
 export interface HeatmapEntry {
     frame_id: number;
@@ -553,6 +572,17 @@ export interface Memvid {
     /** Absolute or relative path to the backing `.mv2` file. */
     path(): Promise<string>;
     put(data: PutInput): Promise<string>;
+    /**
+     * Remove a frame by its ID.
+     *
+     * This performs a soft delete (tombstone) - the frame is marked as deleted
+     * and won't appear in search results or timeline, but the data remains
+     * in the file until compaction.
+     *
+     * @param frameId - The frame ID to remove (returned by put())
+     * @returns The WAL sequence number of the tombstone operation
+     */
+    remove(frameId: string): Promise<number>;
     /**
      * Batch ingest multiple documents using parallel segment building.
      * Much more efficient than calling put() multiple times.
@@ -580,7 +610,10 @@ export interface Memvid {
     seal(): Promise<void>;
     enableLex(): Promise<void>;
     setVectorCompression(enabled: boolean): Promise<void>;
+    /** @deprecated Use applySignedTicket() for cryptographically verified tickets */
     applyTicket(ticket: string): Promise<void>;
+    /** Apply a cryptographically signed ticket (verifies signature against Memvid public key) */
+    applySignedTicket(ticket: string): Promise<void>;
     getMemoryBinding(): Promise<MemoryBinding | null>;
     unbindMemory(): Promise<void>;
     getCapacity(): Promise<number>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memvid/sdk",
-  "version": "2.0.146",
+  "version": "2.0.147",
   "description": "Single-file AI memory system for Node.js. Store, search, and query documents with built-in RAG.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -41,10 +41,10 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@memvid/sdk-darwin-arm64": "2.0.146",
-    "@memvid/sdk-darwin-x64": "2.0.146",
-    "@memvid/sdk-linux-x64-gnu": "2.0.146",
-    "@memvid/sdk-win32-x64-msvc": "2.0.146"
+    "@memvid/sdk-darwin-arm64": "2.0.147",
+    "@memvid/sdk-darwin-x64": "2.0.147",
+    "@memvid/sdk-linux-x64-gnu": "2.0.147",
+    "@memvid/sdk-win32-x64-msvc": "2.0.147"
   },
   "peerDependencies": {
     "@langchain/core": ">=0.3.0",