obsidian-typings 1.1.6 → 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,118 @@
+# Changelog
+
+## 2.0.0
+
+-   Split up typings codebase into separate files
+-   Added `/implementations` submodule which provides additional code imports
+    -   `InternalPluginName`
+    -   `createTFile` and `createTFolder` functions
+    -   `CustomArrayDictImpl`
+-   Added typings for:
+    -   Missing `Platform` constants
+    -   `HotkeysSettingTab`
+    -   `LinkUpdaters`
+    -   `DragManager`
+-   Fixed typings for:
+    -   `enable` is async (`Plugin`)
+    -   Return type of `getEnabledPluginById` (`InternalPlugins`)
+    -   Return type of `saveAttachment` (`App`)
+    -   Return type of `importAttachments` (`App`)
+    -   Parameter order of `getAvailablePathForAttachments` (`Vault`)
+-   Improved compatibility with older and newer Node and TS configurations
+
+## 1.1.6
+
+-   Refactored `InternalPlugin` instance structure
+-   Fixed return type of `splitLeafOrActive`, returns `WorkspaceLeaf`
+
+## 1.1.5
+
+-   **DEPRECATED:** `app.isMobile` will be removed in a future version, prefer usage of `Platform.isMobile`
+-   **DEPRECATED:** `app.account` has been removed
+-   Fix `getFileInfo`, returns `undefined` if file does not exist
+
+## 1.1.4
+
+-   **NOTE:** the global `app` variable has been removed from the official Obsidian API as of 1.6.0, it will _not_ be re-added by `obsidian-typings`.
+-   **DEPRECATED:** `loadProgress` has been made inaccessible in version 1.6.0
+-   **DEPRECATED:** `collapsed`/`collapsible` properties of `TreeItem` have been removed in 1.6.0
+-   `showRibbon` setting was added
+-   `footnotes` were added to `MetadataCache`
+-   Added typings for `DomElementInfo` to allow for adding event listeners directly within `createEl`
+-   Added `instance` to `InternalPlugin` definitions
+-   New methods/variables added in 1.6.0/1.6.1 have gotten preliminary typings
+
+## 1.1.3
+
+-   Use obsidian as a peer dependency when installing the package
+
+## 1.1.2
+
+-   Renamed `Editor` to `BaseEditor` and `ExtendedEditor` to `Editor`, as most components and views directly make use of
+    the `Editor` class (and `BaseEditor` is never used directly)
+
+## 1.1.1
+
+-   Fix incorrect return type for `loadLocalStorage` function
+
+## 1.1.0
+
+-   Add typings for Live Preview Editor instances (`MarkdownView`, `MarkdownEditView`, `MarkdownScrollableEditView`, ...)
+-   Improved typings for `MetadataEditor` and `PropertyWidgetType`
+-   Add basic typings for Vim CM plugin to `@codemirror/view` module
+-   Moved all interfaces and classes under the `obsidian` module
+-   Removed commented trigger functions from `Events`-derived classes
+-   Removed duplicated definitions
+-   Sorted file interfaces alphabetically, applied dprint formatting
+
+## 1.0.8
+
+-   Add `aliases` widget type to `PropertyWidgetType`
+-   Allow arbitrary widgets for `PropertyWidgetType`
+
+## 1.0.7
+
+-   Fix `setType` and `unsetType` of `app.metadataTypeManager` not being marked as `async`
+
+## 1.0.6
+
+-   Fix unnecessary typings for overridden `trigger` functions on `Events`-derived classes
+-   Fix `revealInFolder` for file-explorer plugin not accepting `TFile` inputs
+
+## v1.0.5
+
+-   Fix some methods on `Menu` and `MenuItem` not being chainable
+
+## v1.0.4
+
+-   Added missing EventRef types
+    -   **View Registry:** `view-registered`, `view-unregistered`, `extensions-updated`
+    -   **Metadata Cache:** `initialized`, `finished`
+    -   **Workspace:** `hover-link`, `tab-group-menu`, `swipe`, `layout-ready`, `url-menu`, `search:results-menu`, `receive-text-menu`,
+        `receive-files-menu`, `canvas:selection-menu`, `canvas:node-menu`, `canvas:node-connection-drop-menu`, `canvas:edge-menu`
+    -   **Workspace Leaf:** `history-change`, `leaf-menu`
+-   Added missing typings for `Menu` and `MenuItem` classes
+-   Added missing typings for `Tree` and `TreeItem` classes (used in `Outline` and `FileExplorer` plugin views)
+-   Set vertical height for a split leaf item via `setDimension`
+-   Bumped `electron-types` version
+
+## v1.0.3
+
+-   Change `electron-types` types inclusion
+-   Added note in `README.md` on automatically including new types
+-   Fix lambda definitions and tsc compilation
+
+## v1.0.2
+
+-   Changed `any` type to `unknown` to enforcing explicit type casting
+-   Fixed `CONTRIBUTING.md` link in `README.md`
+-   Added badges to `README.md`
+
+## v1.0.1
+
+-   Automated npm publishing
+
+## v1.0.0 (initial npm release)
+
+-   Made package installable via npm
+-   Clarified README, added contribution guidelines

package/README.md

@@ -1,7 +1,7 @@
-
 <center>
 
 # Obsidian Extended Typings
+
 </center>
 
 ---
@@ -21,13 +21,14 @@
     </a>
 </div>
 
-
-
 ---
+
 <div align="center">
 <h4>
  <a href="https://github.com/Fevol/obsidian-typings/blob/main/CHANGELOG.md">CHANGELOG</a>
  <span>&nbsp;·&nbsp;</span>
+ <a href="https://github.com/Fevol/obsidian-typings/blob/main/MIGRATION.md">MIGRATION</a>
+ <span>&nbsp;·&nbsp;</span>
  <a href="https://www.npmjs.com/package/obsidian-typings">NPM</a>
  <span>&nbsp;·&nbsp;</span>
  <a href="https://github.com/Fevol/obsidian-typings/blob/main/CONTRIBUTING.md">CONTRIBUTING</a>
@@ -35,81 +36,159 @@
 </h4>
 </div>
 
-
 ---
 
+This repository contains TypeScript typings for undocumented [Obsidian API](https://github.com/obsidianmd/obsidian-api/blob/master/obsidian.d.ts) methods and variables, including additional descriptions and example uses.
 
-This repository contains TypeScript typings for undocumented [Obsidian](https://obsidian.md/) API functions and variables and additional descriptions, 
-essentially extending the official [Obsidian API](https://github.com/obsidianmd/obsidian-api/blob/master/obsidian.d.ts).
+Be aware that the typings currently only cover a subset of the full API: while most of the `App` interface and its sub-interfaces are covered, this package does not yet provide typings for views like `Graph`, `Canvas`, ... — contributions for these would be very welcome!
 
-Be aware that the typings currently only cover a subset of all methods: most of the `App` interface and its sub-interfaces
-are covered, but typings for views like `Graph`, `Canvas`, ... are still missing -- contributions for these would be very welcome!
+## Set-up
+1. **Installation**
 
-## Installation
+   _Install using_: `npm install --save-dev obsidian-typings`
 
-There are three options for installing this package:
-1. **Explicit type importing** <br> Each typing has to be imported explicitly from `obsidian-typings` instead of `obsidian`, e.g. `import {App, MarkdownView} from "obsidian-typings"`. <br> _Install via:_ `npm install --save-dev  obsidian-typings`
 
-2. **Automatic type extending** (recommended) <br> The typings are automatically added to the existing `obsidian` module, so you can use them without any changes to your code. <br> _Install via:_ `npm install --save-dev @types/obsidian-typings@npm:obsidian-typings`.
+2. **Add `obsidian-typings` to `types` in `tsconfig.json`** (_recommended_) <span id="add-types-setting-to-tsconfig-json"></span>
 
-3. **Add extended typings as submodule** <br> Your IDE will likely pick up the typings automatically when the project is added as a submodule for your plugin, this also makes it simpler to test and submit features to the repository. <br> _Install via:_ `git submodule add https://github.com/Fevol/obsidian-typings.git typings` (or any other folder)
+    If you want to have all overridden types of `obsidian-typings` available in your project without explicit imports, add the following to your `tsconfig.json`:
 
+    ```json
+    {
+        "compilerOptions": {
+            "...": "...",
+            "types": [
+                "obsidian-typings"
+            ]
+        }
+    }
+    ```
 
 > [!WARNING]
-> If your IDE or TS compiler is not able to pick up the types from `obsidian-typings` but they were installed properly, you will need to adapt your `tsconfig.json` as follows:
+>
+> If you added the `types` field to your `tsconfig.json`, and `@types/some-package-name` does not get recognized anymore, you may need to re-add it to `types`:
 > ```json
 > {
 >     "compilerOptions": {
->         ...
+>         "...": "...",
 >         "types": [
->             "obsidian-typings"
+>             "obsidian-typings",
+>             "some-package-name"
 >         ]
 >     }
 > }
-> ```
-> (Add `"obsidian-typings"` to the `types` array for `compilerOptions`)
+
+3. **Explicit type importing**
+
+   If you prefer not to add `obsidian-typings` to your `types`, you can also add `import "obsidian-typings";` to any project file.
+
+
+
+4. **Using `obsidian-typings/implementations`** <span id="using-obsidian-typings-implementations"></span>
+
+    Depending on how your project is set up, `import { X } from "obsidian-typings/implementations";` may not work straight out of the box, e.g., if you have `"moduleResolution": "node"` or `"node10"` in your `tsconfig.json`
+
+    To solve this, you can add the following to your `tsconfig.json`:
+
+    ```json
+    {
+        "compilerOptions": {
+            ...
+            "paths": {
+                "obsidian-typings/implementations": [
+                    "./node_modules/obsidian-typings/dist/implementations.d.ts",
+                    "./node_modules/obsidian-typings/dist/implementations.cjs"
+                ]
+            }
+        }
+    }
+    ```
+
+## Usage
+
+### `obsidian` module internals
+
+To access types from the `obsidian` module, the import syntax does not change:
+
+```ts
+import { App } from "obsidian";
+
+function printInternalPlugins(app: App): void {
+  console.log(app.internalPlugins);
+}
+```
+
+### `obsidian-typings` additional interfaces
+
+Additional interfaces added by this package (which do not exist in the official API), can be imported using:
+
+```ts
+import { InternalPlugins } from "obsidian-typings";
+
+const internalPlugins: InternalPlugins = this.app.internalPlugins;
+```
+
+### `obsidian-typings/implementations`
+
+Additional helper functions/types/... added by this package can be used by importing from `obsidian-typings/implementations`:
+
+```ts
+import { InternalPluginName } from "obsidian-typings/implementations";
+
+this.app.internalPlugins.getEnabledPluginById(InternalPluginName.FileExplorer);
+```
+
+(The list of all available implementations can be found in the [implementations](https://github.com/Fevol/obsidian-typings/tree/main/src/implementations) folder.)
+
+### Extend with your own typings
+
+If you need to extend the typings provided by this package, add the following to any `.d.ts` file in your project:
+
+```ts
+declare module "obsidian-typings" {
+  interface PluginsPluginsRecord {
+    myPlugin: MyPlugin;
+  }
+}
+```
 
 ## Disclaimer
 
 > [!WARNING]
+>
 > Make sure to read below section in detail before using these typings.
 
 Please be aware that there is a good reason why (some of) the functions and types defined here are not included with the official API definitions:
-- The methods are not fully defined, and will be changed or removed in the near-future
-- There is a high risk of the code behaving unexpectedly if used improperly
-- The function was never meant to be used
 
-Please use the functions and variables provided with caution. Be prepared to update your code if the API changes,
-and only use the functions if you are confident that you understand what they will do. Reference the [official API](https://github.com/obsidianmd/obsidian-api/blob/master/obsidian.d.ts) 
-first to see if your problem may be solved with a documented function, or search
-in the #plugin-dev channel of the Obsidian Discord server. Some functions will also contain `@remark` TSDoc tags that provide
-alternatives or better solutions.
+-   The methods are not fully defined, and will be changed or removed in the near-future
+-   There is a high risk of the code behaving unexpectedly if used improperly
+-   The function was never meant to be used
 
-Methods marked `@internal` are especially risky to use: these are either not fully typed yet, or are solely intended
-to be used internally by the Obsidian app.
+Please use the functions and variables provided with caution. Be prepared to update your code if the API changes, and only use the functions if you are confident that you understand what they will do. Reference the [official API](https://github.com/obsidianmd/obsidian-api/blob/master/obsidian.d.ts) first to see if your problem may be solved with a documented function, or search in the #plugin-dev channel of the Obsidian Discord server. Some functions will also contain `@remark` TSDoc tags that provide alternatives or better solutions.
 
-Furthermore, there is a very high chance that there are mistakes in the typings, despite best efforts.
-All types had to be deduced from either context, manually running the function, or from the minified app code. 
-You _**should**_ verify that the code behaves as expected, both with regard to the expected (input/output)types, as well as what 
-the function description promises.
+Methods marked `@internal` are especially risky to use: these are either not fully typed yet, or are solely intended to be used internally by the Obsidian app.
 
-With these scary disclaimers out of the way, hopefully these typings will help you in removing 90% of the `@ts-ignore`s
-you have in your codebase, or discover solutions that didn't seem possible before.
+Furthermore, there is a very high chance that there are mistakes in the typings, despite best efforts. All types had to be deduced from either context, manually running the function, or from the minified app code. You _**should**_ verify that the code behaves as expected, both with regard to the expected (input/output)types, as well as what the function description promises.
 
+With these scary disclaimers out of the way, hopefully these typings will help you in removing 90% of the `@ts-ignore`s you have in your codebase, or discover solutions that didn't seem possible before.
 
-> [!NOTE] 
+> [!NOTE]
+>
 > **TL;DR:** Use at your own risk, verify that the code behaves as expected, and be prepared to update your code if the API changes.
-> 
+>
 > `@internal` methods are especially risky to use.
-> 
+>
 > `@remark` tags give some warnings about the inputs/outputs of the function, or provide better alternatives.
-> 
+>
 > `@tutorial` gives additional information on how to use the function in your plugin.
 
 
+## Migration
+
+If you were using a `1.x.x` version of this package, you may need to follow the [Migration guide](MIGRATION.md) after updating to `2.0.0` or newer.
+
+
 ## Contributing
 
-Feel free to start typing any part of the Obsidian API that is not yet typed, or fixing/adding additional descriptions to existing typings.
-If you are unsure about anything, don't hesitate to open an issue.
+Feel free to start typing any part of the Obsidian API that is not yet typed, or fixing/adding additional descriptions to existing typings. If you are unsure about anything, don't hesitate to open an issue.
 
 A brief tutorial is available on how you can get started with adding new typings, or fixing existing ones, see: [CONTRIBUTING.md](CONTRIBUTING.md).

package/dist/implementations.cjs

@@ -0,0 +1,137 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+*/
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/implementations/index.ts
+var implementations_exports = {};
+__export(implementations_exports, {
+  CustomArrayDictImpl: () => CustomArrayDictImpl,
+  InternalPluginName: () => InternalPluginName,
+  createTFile: () => createTFile,
+  createTFolder: () => createTFolder
+});
+module.exports = __toCommonJS(implementations_exports);
+
+// src/implementations/createTFile.ts
+var import_obsidian = require("obsidian");
+function createTFile(vault, path) {
+  let file = vault.getFileByPath(path);
+  if (file) {
+    return file;
+  }
+  file = new import_obsidian.TFile(vault, path);
+  file.parent = createTFolder(vault, vault.adapter.path.dirname(path));
+  return file;
+}
+
+// src/implementations/createTFolder.ts
+var import_obsidian2 = require("obsidian");
+function createTFolder(vault, path) {
+  let folder = vault.getFolderByPath(path);
+  if (folder) {
+    return folder;
+  }
+  folder = new import_obsidian2.TFolder(vault, path);
+  folder.parent = createTFolder(vault, vault.adapter.path.dirname(path));
+  return folder;
+}
+
+// src/implementations/CustomArrayDictImpl.ts
+var CustomArrayDictImpl = class {
+  data = {};
+  add(key, value) {
+    if (!this.data.hasOwnProperty(key))
+      this.data[key] = [];
+    const values = this.data[key];
+    if (!values.includes(value))
+      values.push(value);
+  }
+  remove(key, value) {
+    const values = this.data[key];
+    if (!values)
+      return;
+    values.remove(value);
+    if (values.length === 0)
+      delete this.data[key];
+  }
+  removeKey(key) {
+    delete this.data[key];
+  }
+  get(key) {
+    return this.data.hasOwnProperty(key) ? this.data[key] : null;
+  }
+  keys() {
+    return Object.keys(this.data);
+  }
+  clear(key) {
+    delete this.data[key];
+  }
+  clearAll() {
+    this.data = {};
+  }
+  contains(key, value) {
+    const values = this.data[key];
+    return values && values.contains(value) || false;
+  }
+  count() {
+    let ans = 0;
+    for (const key in this.data) {
+      if (this.data.hasOwnProperty(key))
+        ans += this.data[key].length;
+    }
+    return ans;
+  }
+};
+
+// src/implementations/InternalPluginName.ts
+var InternalPluginName = {
+  AudioRecorder: "audio-recorder",
+  Backlink: "backlink",
+  Bookmarks: "bookmarks",
+  Canvas: "canvas",
+  CommandPalette: "command-palette",
+  DailyNotes: "daily-notes",
+  EditorStatus: "editor-status",
+  FileExplorer: "file-explorer",
+  FileRecovery: "file-recovery",
+  GlobalSearch: "global-search",
+  Graph: "graph",
+  MarkdownImporter: "markdown-importer",
+  NoteComposer: "note-composer",
+  OutgoingLink: "outgoing-link",
+  Outline: "outline",
+  PagePreview: "page-preview",
+  Properties: "properties",
+  Publish: "publish",
+  RandomNote: "random-note",
+  SlashCommand: "slash-command",
+  Slides: "slides",
+  Starred: "starred",
+  Switcher: "switcher",
+  Sync: "sync",
+  TagPane: "tag-pane",
+  Templates: "templates",
+  WordCount: "word-count",
+  Workspaces: "workspaces",
+  ZkPrefixer: "zk-prefixer"
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL2ltcGxlbWVudGF0aW9ucy9pbmRleC50cyIsICIuLi9zcmMvaW1wbGVtZW50YXRpb25zL2NyZWF0ZVRGaWxlLnRzIiwgIi4uL3NyYy9pbXBsZW1lbnRhdGlvbnMvY3JlYXRlVEZvbGRlci50cyIsICIuLi9zcmMvaW1wbGVtZW50YXRpb25zL0N1c3RvbUFycmF5RGljdEltcGwudHMiLCAiLi4vc3JjL2ltcGxlbWVudGF0aW9ucy9JbnRlcm5hbFBsdWdpbk5hbWUudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbImV4cG9ydCB7IGNyZWF0ZVRGaWxlIH0gZnJvbSBcIi4vY3JlYXRlVEZpbGUudHNcIjtcbmV4cG9ydCB7IGNyZWF0ZVRGb2xkZXIgfSBmcm9tIFwiLi9jcmVhdGVURm9sZGVyLnRzXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9DdXN0b21BcnJheURpY3RJbXBsLnRzXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9JbnRlcm5hbFBsdWdpbk5hbWUudHNcIjtcbiIsICJpbXBvcnQge1xuICAgIFRGaWxlLFxuICAgIHR5cGUgVmF1bHRcbn0gZnJvbSBcIm9ic2lkaWFuXCI7XG5pbXBvcnQgeyBjcmVhdGVURm9sZGVyIH0gZnJvbSBcIi4vaW5kZXgudHNcIjtcblxudHlwZSBURmlsZUNvbnN0cnVjdG9yID0geyBuZXcodmF1bHQ6IFZhdWx0LCBwYXRoOiBzdHJpbmcpOiBURmlsZSB9O1xuXG4vKipcbiAqIENyZWF0ZXMgYW5kIHByb3Blcmx5IGluaXRpYWxpemVzIHRoZSBpbnN0YW5jZSBvZiBURmlsZSBldmVuIHRoZSB1bmRlcmx5aW5nIGZpbGUgZG9lcyBub3QgZXhpc3QuXG4gKiBUaGlzIGRvZXNuJ3QgY3JlYXRlIHRoZSBtaXNzaW5nIGZpbGUgb24gdGhlIGZpbGUgc3lzdGVtLlxuICovXG5leHBvcnQgZnVuY3Rpb24gY3JlYXRlVEZpbGUodmF1bHQ6IFZhdWx0LCBwYXRoOiBzdHJpbmcpOiBURmlsZSB7XG4gICAgbGV0IGZpbGUgPSB2YXVsdC5nZXRGaWxlQnlQYXRoKHBhdGgpO1xuICAgIGlmIChmaWxlKSB7XG4gICAgICAgIHJldHVybiBmaWxlO1xuICAgIH1cblxuICAgIGZpbGUgPSBuZXcgKFRGaWxlIGFzIFRGaWxlQ29uc3RydWN0b3IpKHZhdWx0LCBwYXRoKTtcbiAgICBmaWxlLnBhcmVudCA9IGNyZWF0ZVRGb2xkZXIodmF1bHQsIHZhdWx0LmFkYXB0ZXIucGF0aC5kaXJuYW1lKHBhdGgpKTtcbiAgICByZXR1cm4gZmlsZTtcbn1cbiIsICJpbXBvcnQge1xuICAgIFRGb2xkZXIsXG4gICAgdHlwZSBWYXVsdFxufSBmcm9tIFwib2JzaWRpYW5cIjtcblxudHlwZSBURm9sZGVyQ29uc3RydWN0b3IgPSB7IG5ldyh2YXVsdDogVmF1bHQsIHBhdGg6IHN0cmluZyk6IFRGb2xkZXIgfTtcblxuLyoqXG4gKiBDcmVhdGVzIGFuZCBwcm9wZXJseSBpbml0aWFsaXplcyB0aGUgaW5zdGFuY2Ugb2YgVEZvbGRlciBldmVuIHRoZSB1bmRlcmx5aW5nIGZvbGRlciBkb2VzIG5vdCBleGlzdC5cbiAqIFRoaXMgZG9lc24ndCBjcmVhdGUgdGhlIG1pc3NpbmcgZm9sZGVyIG9uIHRoZSBmaWxlIHN5c3RlbS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNyZWF0ZVRGb2xkZXIodmF1bHQ6IFZhdWx0LCBwYXRoOiBzdHJpbmcpOiBURm9sZGVyIHtcbiAgICBsZXQgZm9sZGVyID0gdmF1bHQuZ2V0Rm9sZGVyQnlQYXRoKHBhdGgpO1xuICAgIGlmIChmb2xkZXIpIHtcbiAgICAgICAgcmV0dXJuIGZvbGRlcjtcbiAgICB9XG5cbiAgICBmb2xkZXIgPSBuZXcgKFRGb2xkZXIgYXMgVEZvbGRlckNvbnN0cnVjdG9yKSh2YXVsdCwgcGF0aCk7XG4gICAgZm9sZGVyLnBhcmVudCA9IGNyZWF0ZVRGb2xkZXIodmF1bHQsIHZhdWx0LmFkYXB0ZXIucGF0aC5kaXJuYW1lKHBhdGgpKTtcbiAgICByZXR1cm4gZm9sZGVyO1xufVxuIiwgImltcG9ydCB0eXBlIHtcbiAgICBDdXN0b21BcnJheURpY3QsXG4gICAgQ3VzdG9tQXJyYXlEaWN0RGF0YVJlY29yZFxufSBmcm9tIFwiLi4vb2JzaWRpYW4vdHlwZXMuZC50c1wiO1xuXG5leHBvcnQgY2xhc3MgQ3VzdG9tQXJyYXlEaWN0SW1wbDxUPiBpbXBsZW1lbnRzIEN1c3RvbUFycmF5RGljdDxUPiB7XG4gICAgcHVibGljIGRhdGE6IEN1c3RvbUFycmF5RGljdERhdGFSZWNvcmQ8VD4gPSB7fTtcblxuICAgIHB1YmxpYyBhZGQoa2V5OiBzdHJpbmcsIHZhbHVlOiBUKTogdm9pZCB7XG4gICAgICAgIGlmICghKHRoaXMuZGF0YS5oYXNPd25Qcm9wZXJ0eShrZXkpKSlcbiAgICAgICAgICAgIHRoaXMuZGF0YVtrZXldID0gW10gYXMgVFtdO1xuXG4gICAgICAgIGNvbnN0IHZhbHVlcyA9IHRoaXMuZGF0YVtrZXldITtcblxuICAgICAgICBpZiAoIXZhbHVlcy5pbmNsdWRlcyh2YWx1ZSkpXG4gICAgICAgICAgICB2YWx1ZXMucHVzaCh2YWx1ZSk7XG4gICAgfVxuXG4gICAgcHVibGljIHJlbW92ZShrZXk6IHN0cmluZywgdmFsdWU6IFQpOiB2b2lkIHtcbiAgICAgICAgY29uc3QgdmFsdWVzID0gdGhpcy5kYXRhW2tleV07XG4gICAgICAgIGlmICghdmFsdWVzKVxuICAgICAgICAgICAgcmV0dXJuO1xuICAgICAgICB2YWx1ZXMucmVtb3ZlKHZhbHVlKTtcblxuICAgICAgICBpZiAodmFsdWVzLmxlbmd0aCA9PT0gMClcbiAgICAgICAgICAgIGRlbGV0ZSB0aGlzLmRhdGFba2V5XTtcbiAgICB9XG5cbiAgICBwdWJsaWMgcmVtb3ZlS2V5KGtleTogc3RyaW5nKTogdm9pZCB7XG4gICAgICAgIGRlbGV0ZSB0aGlzLmRhdGFba2V5XTtcbiAgICB9XG5cbiAgICBwdWJsaWMgZ2V0KGtleTogc3RyaW5nKTogVFtdIHwgbnVsbCB7XG4gICAgICAgIHJldHVybiB0aGlzLmRhdGEuaGFzT3duUHJvcGVydHkoa2V5KSA/IHRoaXMuZGF0YVtrZXldISA6IG51bGw7XG4gICAgfVxuXG4gICAgcHVibGljIGtleXMoKTogc3RyaW5nW10ge1xuICAgICAgICByZXR1cm4gT2JqZWN0LmtleXModGhpcy5kYXRhKTtcbiAgICB9XG5cbiAgICBwdWJsaWMgY2xlYXIoa2V5OiBzdHJpbmcpOiB2b2lkIHtcbiAgICAgICAgZGVsZXRlIHRoaXMuZGF0YVtrZXldO1xuICAgIH1cblxuICAgIHB1YmxpYyBjbGVhckFsbCgpOiB2b2lkIHtcbiAgICAgICAgdGhpcy5kYXRhID0ge307XG4gICAgfVxuXG4gICAgcHVibGljIGNvbnRhaW5zKGtleTogc3RyaW5nLCB2YWx1ZTogVCk6IGJvb2xlYW4ge1xuICAgICAgICBjb25zdCB2YWx1ZXMgPSB0aGlzLmRhdGFba2V5XTtcbiAgICAgICAgcmV0dXJuIHZhbHVlcyAmJiB2YWx1ZXMuY29udGFpbnModmFsdWUpIHx8IGZhbHNlO1xuICAgIH1cblxuICAgIHB1YmxpYyBjb3VudCgpOiBudW1iZXIge1xuICAgICAgICBsZXQgYW5zID0gMDtcbiAgICAgICAgZm9yIChjb25zdCBrZXkgaW4gdGhpcy5kYXRhKSB7XG4gICAgICAgICAgICBpZiAodGhpcy5kYXRhLmhhc093blByb3BlcnR5KGtleSkpXG4gICAgICAgICAgICAgICAgYW5zICs9IHRoaXMuZGF0YVtrZXldIS5sZW5ndGg7XG4gICAgICAgIH1cblxuICAgICAgICByZXR1cm4gYW5zO1xuICAgIH1cbn1cbiIsICJleHBvcnQgY29uc3QgSW50ZXJuYWxQbHVnaW5OYW1lID0ge1xuICAgIEF1ZGlvUmVjb3JkZXI6IFwiYXVkaW8tcmVjb3JkZXJcIixcbiAgICBCYWNrbGluazogXCJiYWNrbGlua1wiLFxuICAgIEJvb2ttYXJrczogXCJib29rbWFya3NcIixcbiAgICBDYW52YXM6IFwiY2FudmFzXCIsXG4gICAgQ29tbWFuZFBhbGV0dGU6IFwiY29tbWFuZC1wYWxldHRlXCIsXG4gICAgRGFpbHlOb3RlczogXCJkYWlseS1ub3Rlc1wiLFxuICAgIEVkaXRvclN0YXR1czogXCJlZGl0b3Itc3RhdHVzXCIsXG4gICAgRmlsZUV4cGxvcmVyOiBcImZpbGUtZXhwbG9yZXJcIixcbiAgICBGaWxlUmVjb3Zlcnk6IFwiZmlsZS1yZWNvdmVyeVwiLFxuICAgIEdsb2JhbFNlYXJjaDogXCJnbG9iYWwtc2VhcmNoXCIsXG4gICAgR3JhcGg6IFwiZ3JhcGhcIixcbiAgICBNYXJrZG93bkltcG9ydGVyOiBcIm1hcmtkb3duLWltcG9ydGVyXCIsXG4gICAgTm90ZUNvbXBvc2VyOiBcIm5vdGUtY29tcG9zZXJcIixcbiAgICBPdXRnb2luZ0xpbms6IFwib3V0Z29pbmctbGlua1wiLFxuICAgIE91dGxpbmU6IFwib3V0bGluZVwiLFxuICAgIFBhZ2VQcmV2aWV3OiBcInBhZ2UtcHJldmlld1wiLFxuICAgIFByb3BlcnRpZXM6IFwicHJvcGVydGllc1wiLFxuICAgIFB1Ymxpc2g6IFwicHVibGlzaFwiLFxuICAgIFJhbmRvbU5vdGU6IFwicmFuZG9tLW5vdGVcIixcbiAgICBTbGFzaENvbW1hbmQ6IFwic2xhc2gtY29tbWFuZFwiLFxuICAgIFNsaWRlczogXCJzbGlkZXNcIixcbiAgICBTdGFycmVkOiBcInN0YXJyZWRcIixcbiAgICBTd2l0Y2hlcjogXCJzd2l0Y2hlclwiLFxuICAgIFN5bmM6IFwic3luY1wiLFxuICAgIFRhZ1BhbmU6IFwidGFnLXBhbmVcIixcbiAgICBUZW1wbGF0ZXM6IFwidGVtcGxhdGVzXCIsXG4gICAgV29yZENvdW50OiBcIndvcmQtY291bnRcIixcbiAgICBXb3Jrc3BhY2VzOiBcIndvcmtzcGFjZXNcIixcbiAgICBaa1ByZWZpeGVyOiBcInprLXByZWZpeGVyXCJcbn0gYXMgY29uc3Q7XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBOzs7QUNBQSxzQkFHTztBQVNBLFNBQVMsWUFBWSxPQUFjLE1BQXFCO0FBQzNELE1BQUksT0FBTyxNQUFNLGNBQWMsSUFBSTtBQUNuQyxNQUFJLE1BQU07QUFDTixXQUFPO0FBQUEsRUFDWDtBQUVBLFNBQU8sSUFBSyxzQkFBMkIsT0FBTyxJQUFJO0FBQ2xELE9BQUssU0FBUyxjQUFjLE9BQU8sTUFBTSxRQUFRLEtBQUssUUFBUSxJQUFJLENBQUM7QUFDbkUsU0FBTztBQUNYOzs7QUNyQkEsSUFBQUEsbUJBR087QUFRQSxTQUFTLGNBQWMsT0FBYyxNQUF1QjtBQUMvRCxNQUFJLFNBQVMsTUFBTSxnQkFBZ0IsSUFBSTtBQUN2QyxNQUFJLFFBQVE7QUFDUixXQUFPO0FBQUEsRUFDWDtBQUVBLFdBQVMsSUFBSyx5QkFBK0IsT0FBTyxJQUFJO0FBQ3hELFNBQU8sU0FBUyxjQUFjLE9BQU8sTUFBTSxRQUFRLEtBQUssUUFBUSxJQUFJLENBQUM7QUFDckUsU0FBTztBQUNYOzs7QUNmTyxJQUFNLHNCQUFOLE1BQTJEO0FBQUEsRUFDdkQsT0FBcUMsQ0FBQztBQUFBLEVBRXRDLElBQUksS0FBYSxPQUFnQjtBQUNwQyxRQUFJLENBQUUsS0FBSyxLQUFLLGVBQWUsR0FBRztBQUM5QixXQUFLLEtBQUssR0FBRyxJQUFJLENBQUM7QUFFdEIsVUFBTSxTQUFTLEtBQUssS0FBSyxHQUFHO0FBRTVCLFFBQUksQ0FBQyxPQUFPLFNBQVMsS0FBSztBQUN0QixhQUFPLEtBQUssS0FBSztBQUFBLEVBQ3pCO0FBQUEsRUFFTyxPQUFPLEtBQWEsT0FBZ0I7QUFDdkMsVUFBTSxTQUFTLEtBQUssS0FBSyxHQUFHO0FBQzVCLFFBQUksQ0FBQztBQUNEO0FBQ0osV0FBTyxPQUFPLEtBQUs7QUFFbkIsUUFBSSxPQUFPLFdBQVc7QUFDbEIsYUFBTyxLQUFLLEtBQUssR0FBRztBQUFBLEVBQzVCO0FBQUEsRUFFTyxVQUFVLEtBQW1CO0FBQ2hDLFdBQU8sS0FBSyxLQUFLLEdBQUc7QUFBQSxFQUN4QjtBQUFBLEVBRU8sSUFBSSxLQUF5QjtBQUNoQyxXQUFPLEtBQUssS0FBSyxlQUFlLEdBQUcsSUFBSSxLQUFLLEtBQUssR0FBRyxJQUFLO0FBQUEsRUFDN0Q7QUFBQSxFQUVPLE9BQWlCO0FBQ3BCLFdBQU8sT0FBTyxLQUFLLEtBQUssSUFBSTtBQUFBLEVBQ2hDO0FBQUEsRUFFTyxNQUFNLEtBQW1CO0FBQzVCLFdBQU8sS0FBSyxLQUFLLEdBQUc7QUFBQSxFQUN4QjtBQUFBLEVBRU8sV0FBaUI7QUFDcEIsU0FBSyxPQUFPLENBQUM7QUFBQSxFQUNqQjtBQUFBLEVBRU8sU0FBUyxLQUFhLE9BQW1CO0FBQzVDLFVBQU0sU0FBUyxLQUFLLEtBQUssR0FBRztBQUM1QixXQUFPLFVBQVUsT0FBTyxTQUFTLEtBQUssS0FBSztBQUFBLEVBQy9DO0FBQUEsRUFFTyxRQUFnQjtBQUNuQixRQUFJLE1BQU07QUFDVixlQUFXLE9BQU8sS0FBSyxNQUFNO0FBQ3pCLFVBQUksS0FBSyxLQUFLLGVBQWUsR0FBRztBQUM1QixlQUFPLEtBQUssS0FBSyxHQUFHLEVBQUc7QUFBQSxJQUMvQjtBQUVBLFdBQU87QUFBQSxFQUNYO0FBQ0o7OztBQzlETyxJQUFNLHFCQUFxQjtBQUFBLEVBQzlCLGVBQWU7QUFBQSxFQUNmLFVBQVU7QUFBQSxFQUNWLFdBQVc7QUFBQSxFQUNYLFFBQVE7QUFBQSxFQUNSLGdCQUFnQjtBQUFBLEVBQ2hCLFlBQVk7QUFBQSxFQUNaLGNBQWM7QUFBQSxFQUNkLGNBQWM7QUFBQSxFQUNkLGNBQWM7QUFBQSxFQUNkLGNBQWM7QUFBQSxFQUNkLE9BQU87QUFBQSxFQUNQLGtCQUFrQjtBQUFBLEVBQ2xCLGNBQWM7QUFBQSxFQUNkLGNBQWM7QUFBQSxFQUNkLFNBQVM7QUFBQSxFQUNULGFBQWE7QUFBQSxFQUNiLFlBQVk7QUFBQSxFQUNaLFNBQVM7QUFBQSxFQUNULFlBQVk7QUFBQSxFQUNaLGNBQWM7QUFBQSxFQUNkLFFBQVE7QUFBQSxFQUNSLFNBQVM7QUFBQSxFQUNULFVBQVU7QUFBQSxFQUNWLE1BQU07QUFBQSxFQUNOLFNBQVM7QUFBQSxFQUNULFdBQVc7QUFBQSxFQUNYLFdBQVc7QUFBQSxFQUNYLFlBQVk7QUFBQSxFQUNaLFlBQVk7QUFDaEI7IiwKICAibmFtZXMiOiBbImltcG9ydF9vYnNpZGlhbiJdCn0K