@raisindb/functions-types 0.1.37 → 0.1.55

package/package.json

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

package/raisin.d.ts

@@ -162,14 +162,14 @@ interface RaisinNode {
   /**
    * True if this node carries the given mixin (type-declared, transitively).
    * Backed by the server-materialized effective-mixin set.
-   * @param mixinName - e.g., "studio:SEO"
+   * @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., "studio:Folder"
+   * @param typeName - e.g., "app:Folder"
    */
   isNodeType(typeName: string): boolean;
 }
@@ -180,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;
@@ -263,6 +279,7 @@ declare namespace raisin {
 
   namespace crypto {
     function uuid(): Promise<string>;
+    function verifyJwt(token: string, opts?: any | null): Promise<any>;
   }
 
   namespace date {
@@ -303,9 +320,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>;
@@ -313,7 +352,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