From eab57d7627921fd8d67139e8357e1029c4c7539b Mon Sep 17 00:00:00 2001
From: "alonso.torres" <alonso.torres@kaleidos.net>
Date: Wed, 13 Nov 2024 16:31:05 +0100
Subject: [PATCH] feat(plugin-types): add support for file history versions

---
 libs/plugin-types/index.d.ts      | 59 +++++++++++++++++++++++++++++++
 libs/plugins-runtime/src/index.ts |  1 +
 2 files changed, 60 insertions(+)

diff --git a/libs/plugin-types/index.d.ts b/libs/plugin-types/index.d.ts
index b9d376f..5114a54 100644
--- a/libs/plugin-types/index.d.ts
+++ b/libs/plugin-types/index.d.ts
@@ -1450,6 +1450,65 @@ export interface File extends PluginData {
     exportType: 'penpot' | 'zip',
     libraryExportType?: 'all' | 'merge' | 'detach'
   ): Promise<Uint8Array>;
+
+  /**
+   * Retrieves the versions for the file.
+   * @param `criteria.createdBy` retrieves only the versions created by the user `createdBy`.
+   * Requires the `content:read` permission.
+   */
+  findVersions(criteria?: { createdBy: User }): Promise<FileVersion[]>;
+
+  /**
+   * Saves the current version into the versions history.
+   * Requires the `content:write` permission.
+   */
+  saveVersion(label: string): Promise<FileVersion>;
+}
+
+/**
+ * Type defining the file version properties.
+ */
+export interface FileVersion {
+  /**
+   * The current label to identify the version.
+   */
+  label: string;
+
+  /**
+   * The user that created the version. If not present the
+   * version is an autosave.
+   */
+  readonly createdBy?: User;
+
+  /**
+   * The date when the version was created.
+   */
+  readonly createdAt: Date;
+
+  /**
+   * If the current version has been generated automatically.
+   */
+  readonly isAutosave: boolean;
+
+  /*
+   * Restores the current version and replaces the content of the active file
+   * for the contents of this version.
+   * Requires the `content:write` permission.
+   * Warning: Calling this will close the plugin because the workspace will reload
+   */
+  restore(): void;
+
+  /**
+   * Remove the current version.
+   * Requires the `content:write` permission.
+   */
+  remove(): Promise<void>;
+
+  /**
+   * Converts an autosave version into a permanent version.
+   * Requires the `content:write` permission.
+   */
+  pin(): Promise<FileVersion>;
 }
 
 /**
diff --git a/libs/plugins-runtime/src/index.ts b/libs/plugins-runtime/src/index.ts
index 1e0cb8e..69182d1 100644
--- a/libs/plugins-runtime/src/index.ts
+++ b/libs/plugins-runtime/src/index.ts
@@ -18,6 +18,7 @@ repairIntrinsics({
   errorTaming: 'unsafe',
   consoleTaming: 'unsafe',
   errorTrapping: 'none',
+  unhandledRejectionTrapping: 'none'
 });
 
 const globalThisAny$ = globalThis as any;