nodestack-client 1.2.0 → 2.0.0

package/dist/index.mjs

@@ -1,3 +1,10 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
 // src/auth/BaseAuthStore.ts
 function decodeJwtPayload(token) {
   if (!token || typeof token !== "string") return null;
@@ -424,7 +431,8 @@ var FileService = class extends BaseService {
     const cleanCol = encodeURIComponent(collectionName);
     const cleanId = encodeURIComponent(recordId);
     const cleanFile = encodeURIComponent(filename);
-    let url = `${cleanBase}/api/files/${cleanCol}/${cleanId}/${cleanFile}`;
+    const appSlug = options.app || this.client.appSlug;
+    let url = appSlug && appSlug !== "default" ? `${cleanBase}/api/apps/${encodeURIComponent(appSlug)}/files/${cleanCol}/${cleanId}/${cleanFile}` : `${cleanBase}/api/files/${cleanCol}/${cleanId}/${cleanFile}`;
     const queryParts = [];
     if (options.download) {
       queryParts.push("download=1");
@@ -497,8 +505,16 @@ var RealtimeService = class extends BaseService {
         const EventSourceClass = this.getEventSourceConstructor();
         const base = (this.client.baseUrl || "").replace(/\/+$/, "");
         let url = `${base}/api/realtime`;
+        const queryParams = new URLSearchParams();
         if (this.client.authStore.token) {
-          url += `?token=${encodeURIComponent(this.client.authStore.token)}`;
+          queryParams.append("token", this.client.authStore.token);
+        }
+        if (this.client.appSlug) {
+          queryParams.append("app", this.client.appSlug);
+        }
+        const qs = queryParams.toString();
+        if (qs) {
+          url += `?${qs}`;
         }
         this.eventSource = new EventSourceClass(url);
         const handleConnect = async (event) => {
@@ -730,6 +746,8 @@ var AdminService = class extends BaseService {
 
 // src/services/CollectionService.ts
 var CollectionService = class extends BaseService {
+  list = this.getList.bind(this);
+  get = this.getOne.bind(this);
   /**
    * Retrieves all collection schema models.
    */
@@ -836,15 +854,288 @@ var DemoService = class extends BaseService {
   }
 };
 
+// src/services/SnapshotService.ts
+var SnapshotService = class extends BaseService {
+  /**
+   * Retrieves all snapshots, active baseline, and live drift information.
+   */
+  async list() {
+    return this.send("/api/snapshots", {
+      method: "GET"
+    });
+  }
+  /**
+   * Alias for list() to retrieve status.
+   */
+  async getStatus() {
+    return this.list();
+  }
+  /**
+   * Creates a new application state snapshot.
+   * If snapshot limit (10) is reached, evictOldest: true can be passed to confirm eviction of the oldest.
+   */
+  async create(options) {
+    return this.send("/api/snapshots", {
+      method: "POST",
+      body: options || {}
+    });
+  }
+  /**
+   * Retrieves a specific snapshot by ID.
+   */
+  async get(id) {
+    return this.send(`/api/snapshots/${encodeURIComponent(id)}`, {
+      method: "GET"
+    });
+  }
+  /**
+   * Restores application state to a specific snapshot.
+   * Note: Future snapshots are NOT deleted; history remains intact.
+   */
+  async restore(id) {
+    return this.send(`/api/snapshots/${encodeURIComponent(id)}/restore`, {
+      method: "POST"
+    });
+  }
+  /**
+   * Deletes a specific snapshot by ID.
+   */
+  async delete(id) {
+    return this.send(`/api/snapshots/${encodeURIComponent(id)}`, {
+      method: "DELETE"
+    });
+  }
+  /**
+   * Clears all saved snapshots.
+   */
+  async clear() {
+    return this.send("/api/snapshots", {
+      method: "DELETE"
+    });
+  }
+};
+
+// src/services/WebhookService.ts
+function computeWebhookSignature(payload, secret) {
+  const str = typeof payload === "string" ? payload : JSON.stringify(payload);
+  try {
+    const nodeCrypto = typeof __require !== "undefined" ? __require("crypto") : typeof globalThis !== "undefined" ? globalThis.require?.("crypto") || globalThis.crypto : null;
+    if (nodeCrypto && typeof nodeCrypto.createHmac === "function") {
+      return nodeCrypto.createHmac("sha256", secret).update(str, "utf8").digest("hex");
+    }
+  } catch {
+  }
+  throw new Error("[NodeStackClient] HMAC-SHA256 computation requires crypto module.");
+}
+function verifyWebhookSignature(payload, signatureHeader, secret) {
+  if (!signatureHeader || !secret) return false;
+  let expected = "";
+  try {
+    expected = computeWebhookSignature(payload, secret);
+  } catch {
+    return false;
+  }
+  let cleanHeader = signatureHeader.trim();
+  if (cleanHeader.startsWith("sha256=")) {
+    cleanHeader = cleanHeader.substring(7);
+  } else if (cleanHeader.startsWith("sha256:")) {
+    cleanHeader = cleanHeader.substring(7);
+  }
+  if (cleanHeader.length !== expected.length) return false;
+  try {
+    const nodeCrypto = typeof __require !== "undefined" ? __require("crypto") : typeof globalThis !== "undefined" ? globalThis.require?.("crypto") : null;
+    const buf = typeof Buffer !== "undefined" ? Buffer : typeof globalThis !== "undefined" ? globalThis.Buffer : null;
+    if (nodeCrypto && typeof nodeCrypto.timingSafeEqual === "function" && buf) {
+      return nodeCrypto.timingSafeEqual(buf.from(cleanHeader, "hex"), buf.from(expected, "hex"));
+    }
+  } catch {
+  }
+  let diff = 0;
+  for (let i = 0; i < cleanHeader.length; i++) {
+    diff |= cleanHeader.charCodeAt(i) ^ expected.charCodeAt(i);
+  }
+  return diff === 0;
+}
+var WebhookService = class extends BaseService {
+  /**
+   * Retrieves all configured outbound webhooks.
+   */
+  async getList(options = {}) {
+    const res = await this.send("/api/webhooks", {
+      method: "GET",
+      query: options
+    });
+    return Array.isArray(res) ? res : [];
+  }
+  /**
+   * Retrieves a single webhook by ID.
+   */
+  async getOne(id) {
+    return this.send(`/api/webhooks/${encodeURIComponent(id)}`, {
+      method: "GET"
+    });
+  }
+  /**
+   * Creates a new outbound webhook configuration.
+   */
+  async create(data) {
+    return this.send("/api/webhooks", {
+      method: "POST",
+      body: data
+    });
+  }
+  /**
+   * Updates an existing webhook configuration.
+   */
+  async update(id, data) {
+    return this.send(`/api/webhooks/${encodeURIComponent(id)}`, {
+      method: "PATCH",
+      body: data
+    });
+  }
+  /**
+   * Deletes a configured webhook by ID.
+   */
+  async delete(id) {
+    await this.send(`/api/webhooks/${encodeURIComponent(id)}`, {
+      method: "DELETE"
+    });
+    return true;
+  }
+  /**
+   * Dispatches a live test event to the target webhook endpoint with an optional payload.
+   */
+  async test(id, payload) {
+    return this.send(`/api/webhooks/${encodeURIComponent(id)}/test`, {
+      method: "POST",
+      body: payload !== void 0 ? { payload } : {}
+    });
+  }
+  /**
+   * Retrieves overall webhook health and delivery statistics.
+   */
+  async getStats() {
+    return this.send("/api/webhooks/stats", {
+      method: "GET"
+    });
+  }
+  /**
+   * Queries paginated webhook delivery logs with optional filtering by webhook ID, collection, status, or search.
+   */
+  async getDeliveries(options = {}) {
+    return this.send("/api/webhooks/deliveries", {
+      method: "GET",
+      query: options
+    });
+  }
+  /**
+   * Retrieves complete delivery log details including headers and request/response payloads.
+   */
+  async getDelivery(id) {
+    return this.send(`/api/webhooks/deliveries/${encodeURIComponent(id)}`, {
+      method: "GET"
+    });
+  }
+  /**
+   * Manually retries a failed delivery attempt to its target endpoint.
+   */
+  async retryDelivery(id) {
+    return this.send(`/api/webhooks/deliveries/${encodeURIComponent(id)}/retry`, {
+      method: "POST"
+    });
+  }
+  /**
+   * Clears delivery history logs. If olderThanDays is specified, only deletes logs older than that many days.
+   */
+  async clearDeliveries(olderThanDays) {
+    const query = {};
+    if (olderThanDays !== void 0 && olderThanDays !== null) {
+      query.olderThanDays = olderThanDays;
+    }
+    return this.send("/api/webhooks/deliveries", {
+      method: "DELETE",
+      query
+    });
+  }
+  /**
+   * Verifies an incoming X-NodeStack-Signature header against the expected secret.
+   */
+  verifySignature(payload, signatureHeader, secret) {
+    return verifyWebhookSignature(payload, signatureHeader, secret);
+  }
+  /**
+   * Computes an HMAC-SHA256 signature for a payload and secret string.
+   */
+  computeSignature(payload, secret) {
+    return computeWebhookSignature(payload, secret);
+  }
+  static verifySignature = verifyWebhookSignature;
+  static computeSignature = computeWebhookSignature;
+};
+
+// src/services/AppService.ts
+var AppService = class extends BaseService {
+  list = this.getList.bind(this);
+  get = this.getOne.bind(this);
+  /**
+   * Retrieves all configured applications.
+   */
+  async getList() {
+    const res = await this.send("/api/apps", {
+      method: "GET"
+    });
+    return Array.isArray(res) ? res : res?.items || [];
+  }
+  /**
+   * Retrieves a single application by ID or slug.
+   */
+  async getOne(appId) {
+    return this.send(`/api/apps/${encodeURIComponent(appId)}`, {
+      method: "GET"
+    });
+  }
+  /**
+   * Creates a new application.
+   */
+  async create(data) {
+    return this.send("/api/apps", {
+      method: "POST",
+      body: data
+    });
+  }
+  /**
+   * Updates an existing application.
+   */
+  async update(appId, data) {
+    return this.send(`/api/apps/${encodeURIComponent(appId)}`, {
+      method: "PATCH",
+      body: data
+    });
+  }
+  /**
+   * Deletes an application by ID or slug.
+   */
+  async delete(appId) {
+    await this.send(`/api/apps/${encodeURIComponent(appId)}`, {
+      method: "DELETE"
+    });
+    return true;
+  }
+};
+
 // src/Client.ts
-var NodeStackClient = class {
+var NodeStackClient = class _NodeStackClient {
   baseUrl;
   authStore;
   files;
   realtime;
   admins;
   collections;
+  snapshots;
   demo;
+  webhooks;
+  apps;
+  appSlug;
   customFetch;
   defaultHeaders;
   defaultTimeout;
@@ -857,11 +1148,15 @@ var NodeStackClient = class {
     this.defaultHeaders = options.headers || {};
     this.defaultTimeout = options.timeout || 12e4;
     this.chaosOptions = options.chaos ? { ...options.chaos } : null;
+    this.appSlug = options.app;
     this.files = new FileService(this);
     this.realtime = new RealtimeService(this, options.EventSource);
     this.admins = new AdminService(this);
     this.collections = new CollectionService(this);
+    this.snapshots = new SnapshotService(this);
     this.demo = new DemoService(this);
+    this.webhooks = new WebhookService(this);
+    this.apps = new AppService(this);
   }
   /**
    * Dynamically configure latency & chaos simulation options for all future requests.
@@ -915,6 +1210,9 @@ var NodeStackClient = class {
     if (this.authStore.token && !headers["Authorization"] && !headers["authorization"]) {
       headers["Authorization"] = `Bearer ${this.authStore.token}`;
     }
+    if (this.appSlug && !headers["x-nodestack-app"] && !headers["X-NodeStack-App"]) {
+      headers["x-nodestack-app"] = this.appSlug;
+    }
     const effectiveChaos = {
       ...this.chaosOptions || {},
       ...options.chaos || {},
@@ -1031,6 +1329,21 @@ var NodeStackClient = class {
   async metrics() {
     return this.send("/api/metrics", { method: "GET" });
   }
+  /**
+   * Returns a new NodeStackClient instance scoped to a specific application/MVP.
+   * Inherits baseUrl, authStore, customFetch, defaultHeaders, and defaultTimeout.
+   */
+  app(slug, options = {}) {
+    return new _NodeStackClient(this.baseUrl, {
+      authStore: options.authStore || this.authStore,
+      fetch: options.fetch || this.customFetch,
+      headers: { ...this.defaultHeaders, ...options.headers || {} },
+      timeout: options.timeout !== void 0 ? options.timeout : this.defaultTimeout,
+      chaos: options.chaos !== void 0 ? options.chaos ? { ...options.chaos } : void 0 : this.chaosOptions ? { ...this.chaosOptions } : void 0,
+      app: slug,
+      EventSource: options.EventSource || this.realtime.customEventSource
+    });
+  }
 };
 
 // src/auth/MemoryAuthStore.ts
@@ -1039,6 +1352,7 @@ var MemoryAuthStore = class extends BaseAuthStore {
 };
 export {
   AdminService,
+  AppService,
   BaseAuthStore,
   BaseService,
   ClientResponseError,
@@ -1050,7 +1364,11 @@ export {
   NodeStackClient,
   RealtimeService,
   RecordService,
+  SnapshotService,
+  WebhookService,
+  computeWebhookSignature,
   decodeJwtPayload,
-  NodeStackClient as default
+  NodeStackClient as default,
+  verifyWebhookSignature
 };
 //# sourceMappingURL=index.mjs.map