@mymehq/sdk 2.1.0 → 3.0.0

package/dist/index.d.ts

@@ -50,18 +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 for an `edge[parent-of]` existence
-     *  check. */
-    parent_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";
@@ -73,6 +69,8 @@ interface ListFilters {
 interface SearchFilters {
     type?: string;
     state?: ItemState;
+    /** Tri-value library filter, matching `ListFilters.library`. */
+    library?: boolean;
     filter?: string;
     limit?: number;
 }
@@ -211,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/package.json

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