@mymehq/sdk 2.0.1 → 3.0.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { ConflictSnapshot, ItemState, CreateItemInput, Item, PaginatedResult, ItemWithMetadata, Version, Edge, Metadata, SearchResult, Thread, CreateEdgeInput, EdgeTypeSchema, TypeSchema, CreateKeyInput, ApiKey, CreateWebhookInput, Webhook, UpdateWebhookInput, WebhookDelivery, TenantConfig } from '@mymehq/shared';
-export { ApiKey, ConflictSnapshot, CreateItemInput, CreateKeyInput, Item, ItemState, Metadata, PaginatedResult, SearchResult, Thread, TypeSchema, Version } from '@mymehq/shared';
+import { ConflictSnapshot, ItemState, CreateItemInput, Item, PaginatedResult, ItemWithMetadata, Version, Edge, Metadata, SearchResult, CreateEdgeInput, EdgeTypeSchema, TypeSchema, CreateKeyInput, ApiKey, CreateWebhookInput, Webhook, UpdateWebhookInput, WebhookDelivery, TenantConfig } from '@mymehq/shared';
+export { ApiKey, ConflictSnapshot, CreateItemInput, CreateKeyInput, Item, ItemState, Metadata, PaginatedResult, SearchResult, TypeSchema, Version } from '@mymehq/shared';
 
 /**
  * Conflict resolution strategy for item updates.
@@ -50,22 +50,14 @@ interface ListFilters {
     type?: string;
     state?: ItemState;
     source?: string;
-    /** Filter to items whose parent-of source is this id. Kept as a
-     *  server-side convenience alias after the parent_id column was
-     *  dropped in Wave 2 PR 4; the server translates it into an
-     *  `edge[parent-of]` existence check. */
-    parent_id?: string;
-    /** Filter to items in this thread. Server translates to
-     *  `edge[in-thread]` check after the thread_id column was dropped. */
-    thread_id?: string;
-    root_only?: boolean;
-    /** When set, restricts the result to library items (true) or ambient
-     * items (false). Per V0 spec, the default unrestricted view returns
-     * library items only on a fresh /items query — the explicit filter
-     * here lets callers opt into the ambient slice or be explicit about
-     * the library slice. */
+    /** Tri-value library filter. `true` restricts to library items; `false`
+     * restricts to ambient items; omitting the field returns both (the V0
+     * default). */
     library?: boolean;
     tags?: string[];
+    /** Filter-language expression, e.g. `edge[parent-of] eq "<id>"` or
+     *  `edge[parent-of] not_exists`. The filter language replaces the
+     *  previously-exposed `parent_id` and `root_only` convenience params. */
     filter?: string;
     sort?: "created_at" | "updated_at" | "timestamp";
     direction?: "asc" | "desc";
@@ -77,6 +69,8 @@ interface ListFilters {
 interface SearchFilters {
     type?: string;
     state?: ItemState;
+    /** Tri-value library filter, matching `ListFilters.library`. */
+    library?: boolean;
     filter?: string;
     limit?: number;
 }
@@ -92,8 +86,7 @@ declare class MymeClient {
     readonly items: {
         create: (input: CreateItemInput & {
             /** Atomic edges payload: for each edge type, listed ids become
-             *  targets with the new item as source. Replaces legacy parent_id
-             *  / thread_id / about which were dropped in Wave 2 PR 4. */
+             *  targets with the new item as source. */
             edges?: Record<string, string[]>;
         }) => Promise<Item>;
         get: (id: string) => Promise<Item>;
@@ -132,19 +125,6 @@ declare class MymeClient {
         deleteExtension: (itemId: string, namespace: string) => Promise<void>;
     };
     search(query: string, filters?: SearchFilters): Promise<SearchResult[]>;
-    readonly threads: {
-        create: () => Promise<Thread>;
-        list: (filters?: {
-            limit?: number;
-            cursor?: string;
-        }) => Promise<PaginatedResult<Thread>>;
-        get: (id: string) => Promise<{
-            thread: Thread;
-            items: Item[];
-        }>;
-        addItem: (threadId: string, itemId: string) => Promise<Item>;
-        removeItem: (threadId: string, itemId: string) => Promise<Item>;
-    };
     readonly edges: {
         /** Create a single edge. Server enforces cardinality / type
          *  constraints / cycle prevention; throws on violation. */
@@ -229,6 +209,20 @@ declare class MymeClient {
     private throwRawError;
 }
 
+/**
+ * Base error thrown from every SDK HTTP failure path. Consumers catch on
+ * this class or one of its typed subclasses (`NotFoundError`,
+ * `ValidationError`, `UnauthorizedError`, `ForbiddenError`, `ConflictError`).
+ *
+ * Deliberately distinct from the `MymeError` in `@mymehq/shared`. The
+ * shared version is constructed server-side from an `ErrorCode` enum and
+ * derives its HTTP status through an internal map; this SDK version is
+ * constructed from an error response on the wire, so `code` is an opaque
+ * string (forward-compatible with server codes the SDK hasn't been
+ * regenerated against yet) and `status` is the HTTP status the server
+ * actually returned. The two classes serve symmetrical but distinct
+ * roles; do not try to unify them.
+ */
 declare class MymeError extends Error {
     readonly code: string;
     readonly status: number;

package/dist/index.js

@@ -401,44 +401,6 @@ var MymeClient = class {
     );
     return res.results;
   }
-  // ---- Threads ----
-  threads = {
-    create: async () => {
-      const res = await this.transport.request(
-        "POST",
-        "/threads"
-      );
-      return res.thread;
-    },
-    list: async (filters) => {
-      return this.transport.request(
-        "GET",
-        "/threads",
-        { query: filters }
-      );
-    },
-    get: async (id) => {
-      return this.transport.request(
-        "GET",
-        `/threads/${id}`
-      );
-    },
-    addItem: async (threadId, itemId) => {
-      const res = await this.transport.request(
-        "POST",
-        `/threads/${threadId}/items`,
-        { body: { item_id: itemId } }
-      );
-      return res.item;
-    },
-    removeItem: async (threadId, itemId) => {
-      const res = await this.transport.request(
-        "DELETE",
-        `/threads/${threadId}/items/${itemId}`
-      );
-      return res.item;
-    }
-  };
   // ---- Edges ----
   edges = {
     /** Create a single edge. Server enforces cardinality / type

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mymehq/sdk",
-  "version": "2.0.1",
+  "version": "3.0.0",
   "type": "module",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -16,7 +16,7 @@
     "dist"
   ],
   "dependencies": {
-    "@mymehq/shared": "2.0.1"
+    "@mymehq/shared": "3.0.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",