@raisindb/functions-types 0.2.4 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raisindb/functions-types",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "TypeScript type definitions for the RaisinDB server-side function runtime (QuickJS)",
   "license": "MIT",
   "types": "raisin.d.ts",

package/raisin.d.ts

@@ -158,6 +158,20 @@ interface RaisinNode {
    * @param data - Resource (from resize()), or { base64, mimeType, name }
    */
   addResource(propertyPath: string, data: Resource | ResourceUploadData | string): Promise<any>;
+
+  /**
+   * True if this node carries the given mixin (type-declared, transitively).
+   * Backed by the server-materialized effective-mixin set.
+   * @param mixinName - e.g., "app:SEO"
+   */
+  hasMixin(mixinName: string): boolean;
+
+  /**
+   * True if this node "is a" given type — its node_type, any `extends` ancestor,
+   * or any effective mixin.
+   * @param typeName - e.g., "app:Folder"
+   */
+  isNodeType(typeName: string): boolean;
 }
 
 interface ResourceUploadData {
@@ -166,6 +180,22 @@ interface ResourceUploadData {
   name?: string;
 }
 
+/**
+ * A single entry in a node's revision history (newest first), returned by
+ * raisin.nodes.history(). Use `revision` with an at-revision read to fetch the
+ * full snapshot of that historical version.
+ */
+interface RaisinRevisionEntry {
+  /** HLC revision string ("timestamp-counter"). */
+  revision: string;
+  /** When this revision was written (ISO 8601 string). */
+  updated_at?: string;
+  /** User ID who authored this revision. */
+  updated_by?: string;
+  /** True when the node was deleted at this revision (tombstone). */
+  deleted: boolean;
+}
+
 interface NodeCreateData {
   name?: string;
   path?: string;
@@ -247,8 +277,15 @@ declare namespace raisin {
     function embed(request: any): Promise<any>;
   }
 
+  namespace branches {
+    function diff(branch: string, baseBranch: string): Promise<any>;
+    function compare(branch: string, baseBranch: string): Promise<any>;
+    function copyNodes(sourceBranch: string, targetBranch: string, opts: any): Promise<any>;
+  }
+
   namespace crypto {
     function uuid(): Promise<string>;
+    function verifyJwt(token: string, opts?: any | null): Promise<any>;
   }
 
   namespace date {
@@ -265,6 +302,10 @@ declare namespace raisin {
     function emit(eventType: string, data: any): Promise<void>;
   }
 
+  namespace flows {
+    function run(flowPath: string, input: any): Promise<any>;
+  }
+
   namespace functions {
     function execute(functionPath: string, arguments: any, context: any): Promise<any>;
     function call(functionPath: string, arguments: any): Promise<any>;
@@ -285,9 +326,31 @@ declare namespace raisin {
     function delete(url: string, options?: HttpOptions): Promise<HttpResponse>;
   }
 
+  namespace imap {
+    function fetchSince(conn: any, sinceUid: number, opts?: any | null): Promise<any>;
+    function listMailboxes(conn: any): Promise<any>;
+    function fetchMessage(conn: any, uid: number, opts?: any | null): Promise<any>;
+  }
+
+  namespace integrations {
+    function syncNow(mountId: string, mode?: string | null): Promise<any>;
+  }
+
+  namespace inventory {
+    function claim(pool: string, n: number, capacity: number): Promise<any>;
+    function release(pool: string, n: number): Promise<number>;
+  }
+
+  namespace locks {
+    function acquire(key: string, ttlMs: number, owner?: string | null): Promise<any>;
+    function release(key: string, token: number): Promise<boolean>;
+    function renew(key: string, token: number, ttlMs: number): Promise<boolean>;
+  }
+
   namespace nodes {
     function get(workspace: string, path: string): Promise<RaisinNode | null>;
     function getById(workspace: string, id: string): Promise<RaisinNode | null>;
+    function history(workspace: string, id: string, limit?: number | null): Promise<RaisinRevisionEntry[]>;
     function create(workspace: string, parentPath: string, data: any): Promise<RaisinNode>;
     function update(workspace: string, path: string, data: any): Promise<RaisinNode>;
     function delete(workspace: string, path: string): Promise<void>;
@@ -295,7 +358,16 @@ declare namespace raisin {
     function move(workspace: string, nodePath: string, newParentPath: string): Promise<RaisinNode>;
     function query(workspace: string, query: any): Promise<RaisinNode[]>;
     function getChildren(workspace: string, parentPath: string, limit?: number | null): Promise<RaisinNode[]>;
+    function applyChildOrder(workspace: string, parentPath: string, sourceBranch: string, targetBranch: string): Promise<void>;
     function addResource(workspace: string, nodePath: string, propertyPath: string, uploadData: any): Promise<any>;
+    /**
+     * Create a node under parentPath, auto-creating any missing ancestor folders.
+     */
+    function createDeep(workspace: string, parentPath: string, data: any, parentNodeType?: string): Promise<RaisinNode>;
+    /**
+     * Upsert a node by path (create-or-update), auto-creating any missing ancestor folders.
+     */
+    function upsertDeep(workspace: string, data: any, parentNodeType?: string): Promise<void>;
     /**
      * Start a transaction for atomic multi-node operations.
      * @example
@@ -314,6 +386,13 @@ declare namespace raisin {
     function getBinary(storageKey: string): Promise<string>;
   }
 
+  namespace scheduler {
+    function schedule(request: any): Promise<any>;
+    function cancel(jobIdOrKey: string): Promise<any>;
+    function list(filter?: any | null): Promise<any>;
+    function get(jobIdOrKey: string): Promise<any>;
+  }
+
   namespace sql {
     function query(sql: string, params: any[]): Promise<any>;
     function execute(sql: string, params: any[]): Promise<number>;