@objectstack/client 5.0.0 → 5.2.0

package/dist/index.mjs

@@ -476,6 +476,22 @@ var ObjectStackClient = class {
         });
         return this.unwrapResponse(res);
       },
+      /**
+       * Get the durable change-log for a specific metadata item.
+       * Returns events recorded in `sys_metadata_history` for every
+       * overlay put/delete, ordered by `event_seq` ascending. Non-overlay
+       * metadata types return an empty list.
+       */
+      getHistory: async (type, name, options) => {
+        const route = this.getRoute("metadata");
+        const params = new URLSearchParams();
+        if (options?.sinceSeq !== void 0) params.set("sinceSeq", String(options.sinceSeq));
+        if (options?.limit !== void 0) params.set("limit", String(options.limit));
+        const qs = params.toString();
+        const url = `${this.baseUrl}${route}/${encodeURIComponent(type)}/${encodeURIComponent(name)}/history${qs ? `?${qs}` : ""}`;
+        const res = await this.fetch(url);
+        return this.unwrapResponse(res);
+      },
       /**
        * Get object metadata with cache support
        * Supports ETag-based conditional requests for efficient caching
@@ -2970,6 +2986,16 @@ var ScopedProjectClient = class {
           method: "DELETE"
         });
         return this.parent._unwrap(res);
+      },
+      getHistory: async (type, name, options) => {
+        const params = new URLSearchParams();
+        if (options?.sinceSeq !== void 0) params.set("sinceSeq", String(options.sinceSeq));
+        if (options?.limit !== void 0) params.set("limit", String(options.limit));
+        const qs = params.toString();
+        const res = await this.parent._fetch(
+          this.url(`/meta/${encodeURIComponent(type)}/${encodeURIComponent(name)}/history${qs ? `?${qs}` : ""}`)
+        );
+        return this.parent._unwrap(res);
       }
     };
     /**