nodestack-client 2.1.0 → 2.3.0

package/dist/Client.d.ts

@@ -8,6 +8,8 @@ import { DemoService } from './services/DemoService';
 import { SnapshotService } from './services/SnapshotService';
 import { WebhookService } from './services/WebhookService';
 import { AppService } from './services/AppService';
+import { FunctionService } from './services/FunctionService';
+import { FlowService } from './services/FlowService';
 import type { ClientOptions, SendOptions, RecordModel, ChaosOptions } from './types';
 /**
  * Main NodeStack Client SDK entry point.
@@ -24,6 +26,8 @@ export declare class NodeStackClient<TCollections extends Record<string, any> =
     readonly demo: DemoService;
     readonly webhooks: WebhookService;
     readonly apps: AppService;
+    readonly functions: FunctionService;
+    readonly flows: FlowService;
     readonly appSlug?: string;
     private customFetch?;
     private defaultHeaders;

package/dist/Client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../src/Client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../src/Client.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -28,6 +28,8 @@ __export(index_exports, {
   CollectionService: () => CollectionService,
   DemoService: () => DemoService,
   FileService: () => FileService,
+  FlowService: () => FlowService,
+  FunctionService: () => FunctionService,
   LocalAuthStore: () => LocalAuthStore,
   MemoryAuthStore: () => MemoryAuthStore,
   NodeStackClient: () => NodeStackClient,
@@ -234,7 +236,6 @@ var BaseService = class {
   constructor(client) {
     this.client = client;
   }
-  client;
   send(path, options = {}) {
     return this.client.send(path, options);
   }
@@ -246,7 +247,6 @@ var RecordService = class extends BaseService {
     super(client);
     this.collectionName = collectionName;
   }
-  collectionName;
   get clientWithRealtime() {
     return this.client;
   }
@@ -1330,6 +1330,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;
@@ -1343,6 +1476,8 @@ var NodeStackClient = class _NodeStackClient {
   demo;
   webhooks;
   apps;
+  functions;
+  flows;
   appSlug;
   customFetch;
   defaultHeaders;
@@ -1366,6 +1501,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.