nodestack-client 2.2.0 → 2.3.0

package/dist/index.mjs

@@ -1290,6 +1290,139 @@ var AppService = class extends BaseService {
   }
 };
 
+// src/services/FunctionService.ts
+var FunctionService = class extends BaseService {
+  /**
+   * Invokes a serverless function by name or ID.
+   * Scoped to the client's configured application if specified.
+   */
+  async invoke(name, body, options = {}) {
+    const encodedName = encodeURIComponent(name);
+    const appPrefix = this.client.appSlug ? `/api/apps/${encodeURIComponent(this.client.appSlug)}` : "/api";
+    const path = `${appPrefix}/functions/${encodedName}/invoke`;
+    return this.send(path, {
+      method: options.method || "POST",
+      body,
+      ...options
+    });
+  }
+  /**
+   * Fetch all functions configured in the active application scope (requires admin auth).
+   */
+  async getList(options) {
+    const appPrefix = this.client.appSlug ? `/api/apps/${encodeURIComponent(this.client.appSlug)}` : "/api";
+    return this.send(`${appPrefix}/functions`, {
+      method: "GET",
+      query: options
+    });
+  }
+  /**
+   * Fetch a single function by ID or name (requires admin auth).
+   */
+  async getOne(idOrName) {
+    const appPrefix = this.client.appSlug ? `/api/apps/${encodeURIComponent(this.client.appSlug)}` : "/api";
+    return this.send(`${appPrefix}/functions/${encodeURIComponent(idOrName)}`, {
+      method: "GET"
+    });
+  }
+  /**
+   * Test execute a function in sandboxed runner (requires admin auth).
+   */
+  async test(id, testPayload = {}) {
+    const appPrefix = this.client.appSlug ? `/api/apps/${encodeURIComponent(this.client.appSlug)}` : "/api";
+    return this.send(`${appPrefix}/functions/${encodeURIComponent(id)}/test`, {
+      method: "POST",
+      body: testPayload
+    });
+  }
+};
+
+// src/services/FlowService.ts
+var FlowService = class extends BaseService {
+  /**
+   * Triggers or executes a Flow state machine by ID or name.
+   * If wait is true (default), returns the finished FlowExecution object.
+   */
+  async execute(flowIdOrName, input, options = {}) {
+    const encoded = encodeURIComponent(flowIdOrName);
+    const appPrefix = this.client.appSlug ? `/api/apps/${encodeURIComponent(this.client.appSlug)}` : "/api";
+    const path = `${appPrefix}/flows/${encoded}/execute`;
+    const wait = options.wait !== false;
+    return this.send(path, {
+      method: "POST",
+      body: input || {},
+      query: { wait: wait ? "true" : "false" },
+      ...options
+    });
+  }
+  /**
+   * Fetch all flows configured in the active application scope (requires admin auth).
+   */
+  async getList(options) {
+    const appPrefix = this.client.appSlug ? `/api/apps/${encodeURIComponent(this.client.appSlug)}` : "/api";
+    return this.send(`${appPrefix}/flows`, {
+      method: "GET",
+      query: options
+    });
+  }
+  /**
+   * Fetch a single flow by ID or name (requires admin auth).
+   */
+  async getOne(idOrName) {
+    const appPrefix = this.client.appSlug ? `/api/apps/${encodeURIComponent(this.client.appSlug)}` : "/api";
+    return this.send(`${appPrefix}/flows/${encodeURIComponent(idOrName)}`, {
+      method: "GET"
+    });
+  }
+  /**
+   * Fetch executions history for a specific flow or across all flows (requires admin auth).
+   */
+  async getExecutions(options) {
+    const appPrefix = this.client.appSlug ? `/api/apps/${encodeURIComponent(this.client.appSlug)}` : "/api";
+    const flowId = options?.flowId ? `/${encodeURIComponent(options.flowId)}/executions` : "/executions";
+    return this.send(
+      `${appPrefix}/flows${flowId}`,
+      {
+        method: "GET",
+        query: options
+      }
+    );
+  }
+  /**
+   * Fetch a single execution record by ID (requires admin auth).
+   */
+  async getExecution(executionId) {
+    const appPrefix = this.client.appSlug ? `/api/apps/${encodeURIComponent(this.client.appSlug)}` : "/api";
+    return this.send(
+      `${appPrefix}/flows/executions/${encodeURIComponent(executionId)}`,
+      { method: "GET" }
+    );
+  }
+  /**
+   * Resumes an orphaned or interrupted running flow from its last completed checkpoint.
+   */
+  async resumeExecution(executionId) {
+    const appPrefix = this.client.appSlug ? `/api/apps/${encodeURIComponent(this.client.appSlug)}` : "/api";
+    return this.send(
+      `${appPrefix}/flows/executions/${encodeURIComponent(executionId)}/resume`,
+      { method: "POST" }
+    );
+  }
+  /**
+   * Aborts an orphaned running flow gracefully with status: 'aborted'.
+   */
+  async abortExecution(executionId, reason) {
+    const appPrefix = this.client.appSlug ? `/api/apps/${encodeURIComponent(this.client.appSlug)}` : "/api";
+    return this.send(
+      `${appPrefix}/flows/executions/${encodeURIComponent(executionId)}/abort`,
+      {
+        method: "POST",
+        body: { reason }
+      }
+    );
+  }
+};
+
 // src/Client.ts
 var NodeStackClient = class _NodeStackClient {
   baseUrl;
@@ -1303,6 +1436,8 @@ var NodeStackClient = class _NodeStackClient {
   demo;
   webhooks;
   apps;
+  functions;
+  flows;
   appSlug;
   customFetch;
   defaultHeaders;
@@ -1326,6 +1461,8 @@ var NodeStackClient = class _NodeStackClient {
     this.demo = new DemoService(this);
     this.webhooks = new WebhookService(this);
     this.apps = new AppService(this);
+    this.functions = new FunctionService(this);
+    this.flows = new FlowService(this);
   }
   /**
    * Dynamically configure latency & chaos simulation options for all future requests.
@@ -1616,6 +1753,8 @@ export {
   CollectionService,
   DemoService,
   FileService,
+  FlowService,
+  FunctionService,
   LocalAuthStore,
   MemoryAuthStore,
   NodeStackClient,