@objectstack/client 4.2.0 → 5.1.0

package/dist/index.d.mts

@@ -491,6 +491,32 @@ declare class ObjectStackClient {
             name: string;
             deleted: boolean;
         }>;
+        /**
+         * 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: (type: string, name: string, options?: {
+            sinceSeq?: number;
+            limit?: number;
+        }) => Promise<{
+            events: Array<{
+                seq: number;
+                op: string;
+                ref: {
+                    org?: string;
+                    type: string;
+                    name: string;
+                };
+                hash: string | null;
+                parentHash: string | null;
+                actor: string;
+                message?: string;
+                ts: string;
+                source: string;
+            }>;
+        }>;
         /**
          * Get object metadata with cache support
          * Supports ETag-based conditional requests for efficient caching
@@ -1933,6 +1959,10 @@ declare class ScopedProjectClient {
             name: string;
             deleted: boolean;
         }>;
+        getHistory: (type: string, name: string, options?: {
+            sinceSeq?: number;
+            limit?: number;
+        }) => Promise<unknown>;
     };
     /**
      * Data operations scoped to this project.

package/dist/index.d.ts

@@ -491,6 +491,32 @@ declare class ObjectStackClient {
             name: string;
             deleted: boolean;
         }>;
+        /**
+         * 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: (type: string, name: string, options?: {
+            sinceSeq?: number;
+            limit?: number;
+        }) => Promise<{
+            events: Array<{
+                seq: number;
+                op: string;
+                ref: {
+                    org?: string;
+                    type: string;
+                    name: string;
+                };
+                hash: string | null;
+                parentHash: string | null;
+                actor: string;
+                message?: string;
+                ts: string;
+                source: string;
+            }>;
+        }>;
         /**
          * Get object metadata with cache support
          * Supports ETag-based conditional requests for efficient caching
@@ -1933,6 +1959,10 @@ declare class ScopedProjectClient {
             name: string;
             deleted: boolean;
         }>;
+        getHistory: (type: string, name: string, options?: {
+            sinceSeq?: number;
+            limit?: number;
+        }) => Promise<unknown>;
     };
     /**
      * Data operations scoped to this project.

package/dist/index.js

@@ -506,6 +506,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
@@ -3000,6 +3016,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);
       }
     };
     /**