@gorilla-engine-sdk/ge-blob-manager 1.0.5

package/LICENSE.md

@@ -0,0 +1,64 @@
+**IMPORTANT NOTICE: PLEASE READ CAREFULLY BEFORE DOWNLOADING, INSTALLING OR USING THE GORILLA ENGINE SDK:**
+
+- BY SIGNING THIS AGREEMENT, OR CLICKING ON THE “ACCEPT” BUTTON BELOW (IF AVAILABLE), OR BY DOWNLOADING, INSTALLING, OR USING THE GORILLA ENGINE SDK, YOU AGREE TO THE TERMS OF THIS AGREEMENT, AND ALL INCORPORATED TERMS INCLUDING GORILLA ENGINE’S PRIVACY POLICY, AS APPLICABLE, WHICH WILL BIND YOU.
+
+- IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT, WE WILL NOT LICENSE THE GORILLA ENGINE SDK TO YOU AND YOU MUST DISCONTINUE THE INSTALLATION OR DOWNLOAD PROCESS OR CEASE USE OF THE UJAM GORILLA ENGINE SDK.
+
+**GORILLA ENGINE FREE TIER LICENSE**
+
+This Gorilla Engine Free Tier License ("Agreement") is entered between UJAM, Inc., a Delaware corporation (hereinafter "UJAM" or "we") and you (“Licensee” or “you”) and becomes effective once you download, install, or use the GORILLA ENGINE SDK.
+
+1. OBJECT OF AGREEMENT. This Agreement governs UJAM’s GORILLA ENGINE SDK (“SDK”) and all related software and documentation and any update, upgrades or bug fixes (collectively referred to as the "UJAM GORILLA ENGINE SDK SERVICE").
+
+2. GRANT OF LICENSE: Subject to your full compliance with all of the terms and conditions of this Agreement, we grant you a non-exclusive, revocable, nonsublicensable (except as specifically provided herein), non-transferable license to use the UJAM GORILLA ENGINE SDK SERVICE solely to: (i) download, install, and use the UJAM GORILLA ENGINE SDK SERVICE for the sole purpose of building audio plugins such as virtual instruments and effects ("Application") and using such Application for music productions and live performances. **HOWEVER, YOU MUST NOT SHARE OR OTHERWISE EXPLOIT YOUR GORILLA ENGINE BASED APPLICATION WITH ANY THIRD PARTY UNTIL YOU HAVE ACQUIRED ONE OF THE ADD-ON LICENSES AS FURTHER DESCRIBED IN SECTION 8 OF THIS AGREEMENT.** If you have any questions regarding this license and allowed uses of the SDK, please reach out to us via email at support@gorilla-engine.com.
+
+3. LICENSE RESTRICTIONS AND OBLIGATIONS: Except as expressly and unambiguously authorized under this Agreement, you must not
+   1. copy, rent, lease, sell, transfer, assign, sublicense, disassemble, reverse engineer or decompile (except to the limited extent expressly authorized by applicable statutory law), modify, create derivative works from, or alter any part of the UJAM GORILLA ENGINE SDK SERVICE;
+   2. sublicense your Application to end-users until you have acquired a license as further described in Section 8 of this Agreement.
+   3. use any automated means, including, without limitation, agents, robots, scripts or spiders, to access the UJAM GORILLA ENGINE SDK SERVICE or bypass the UJAM GORILLA ENGINE SDK SERVICE or to interfere or attempt to interfere with the proper working of the UJAM GORILLA ENGINE SDK SERVICE;
+   4. use the UJAM GORILLA ENGINE SDK SERVICE as a dynamic-link library (for clarity: the SDK shall solely be used as a statically linked library); (g) use the SDK or any part of the SDK in connection with building or distributing your own or a third-party SDK or framework; or (h) use the Licensed Software to train artificial intelligence, your own or a third-party algorithm, and/or any other kind of machine learning processes.
+   5. use the UJAM GORILLA ENGINE SDK SERVICE for the benefit of a third party, other than end users of your Applications as expressly authorized by this Agreement;
+   6. use the UJAM GORILLA ENGINE SDK SERVICE to implement or enhance a product or service that is competitive with the UJAM GORILLA ENGINE SDK SERVICE;
+   7. modify and/or rename the UJAM binary libraries; or
+   8. otherwise engage in activity that interrupts the proper working of the UJAM GORILLA ENGINE SDK SERVICE or is otherwise fraudulent or illegal.
+
+Furthermore, you agree
+
+9. display attribution on all embodiments and uses of the Gorilla Engine SDK by displaying the language “powered by Gorilla Engine” ; and  
+   10. to contact UJAM once you intend to Distribute (as defined in Section 8\) your Application to obtain the appropriate license to do so – which you agree is required for such a scenario (as further described in Section 8 below).
+
+   We reserve the right to discontinue, modify, cease support of, and alter the pricing structure of this Agreement (the Gorilla Engine Free Tier License) of the UJAM GORILLA ENGINE SDK SERVICE.
+
+10. LICENSE TO UJAM: You hereby grant to us the non-exclusive, perpetual, worldwide, royalty-free right and license to any and all content ("Content") provided by you or your end users in connection with your use or your end users' use of the SDK, including but not limited to feedback or other contributions made towards the UJAM GORILLA ENGINE SDK SERVICE (including so-called re-usable components, made available by UJAM via its repositories), in order for us to provide and improve the UJAM GORILLA ENGINE SDK SERVICE. You represent and warrant that all Content provided by you shall not violate any third party rights and shall be free of any and all claims.
+
+11. REPRESENTATIONS AND WARRANTIES: You represent and warrant that you: (i) are fully authorized to enter into this agreement; (ii) shall use the UJAM GORILLA ENGINE SDK SERVICE in compliance with all applicable local, state, national and foreign laws, treaties and regulations, including those related to data privacy, international communications, export laws and the transmission of technical or personal data laws; (iii) shall not (and shall not permit any third party, including a permitted sublicensee to), directly or indirectly, take any action or upload, download, post, submit or otherwise distribute or facilitate distribution of Content or any material on or through the UJAM GORILLA ENGINE SDK SERVICE, that: (a) infringes any patent, trademark, trade secret, copyright, right of publicity/privacy or other right of any third party or induces infringement thereof; (b) breaches any third party contract or obligation; (c) is unlawful, threatening, abusive, harassing, defamatory, deceptive, fraudulent, invasive of another's privacy, tortious, obscene, offensive, or profane.
+
+12. OWNERSHIP AND PROPRIETARY RIGHTS: As between UJAM and Licensee (and any permitted sublicensees), the SDK and all intellectual property rights in and to the UJAM GORILLA ENGINE SDK SERVICE, are and shall at all times remain the sole and exclusive property of UJAM and are protected by applicable intellectual property laws and treaties. You shall not obscure, remove or otherwise alter our copyright or trademark notices or other proprietary rights' notices affixed to or within the SDK or elsewhere.
+
+13. SUPPORT AND UPGRADES: This Agreement does not entitle you to any support for the SDK, unless you enter into a separate agreement with us in writing, either signed by both parties or agreed upon via click-through agreement. Any such support provided by us shall be subject to the terms and disclaimers of this Agreement.
+
+14. ADD-ON LICENSES FOR A PERMITTED DISTRIBUTION OF GORILLA ENGINE BASED APPLICATION:
+    1. **Add-On Licenses (Upgrade to Pro Tier):** You agree to contact UJAM to obtain one of our commercial license (including the so-called “Pro Tier” License, including available optional Add-On upgrades which can be ) (collectively referred to as “Add-On Licenses”), whichever deemed to be appropriate for your intended use of the SDK, to Distribute (as defined below in subsection ii.) your Gorilla Engine based Application to end-users. Such Add-On License shall supersede this Agreement, as agreed to by the parties.
+    2. **Failure to comply with Section 8:** If you fail to comply with Section 8(i) by Distributing the SDK as part of an Application beyond the allowed use under this Agreement, you shall immediately contact UJAM and pay to UJAM a royalty per each Distribution (as defined below) in an amount as solely determined by UJAM. A Distribution refers to either an embedded, pre-bundled, pre-installed platform application or software application that is downloaded, delivered, or served to a user or device by any means of distribution including directly from you or through any platform, including cloud based platforms. In avoidance of doubt, any subscription or rental shall be considered a Distribution.
+    3. **Audit Rights**: Should (i) you fail to obtain an Add-On License and distribute the SDK as part of an Application, or should (ii) UJAM believe that you distribute the Application without having obtained an Add-On License, then UJAM shall have the right, upon reasonable notice, to audit/inspect any premises, computer(s), and networks on or in which the SDK is installed or used to monitor compliance with the terms of this Agreement, including but not limited to confirming the number of Distributions of the Application. If an audit reveals any unauthorized use, in addition to all other remedies available to UJAM, you shall be responsible to UJAM for all reasonable expenses related to the audit.
+    4. **Third Party Libraries:** You acknowledge that certain third-party libraries, including JUCE 6 ([https://juce.com/legal/juce-6-license/](https://juce.com/legal/juce-6-license/)), may be used in connection with the SDK, subject to their respective license agreements as further disclosed by UJAM. It is your sole responsibility to abide to such third-party terms, which may include your obligations, amongst others, to provide certain disclosures accompanying your Gorilla Engine based Software and/or acquiring a JUCE license (if applicable).
+
+15. DATA PROTECTION AND PRIVACY: We may collect and process information about you and your use of the Gorilla Engine SDK, some of which may amount to personal data, subject to Gorilla Engine’s Privacy Policy.
+
+16. TRADE SECRETS AND CONFIDENTIAL INFORMATION: You acknowledges that the SDK contains valuable trade secrets of UJAM and, should you access any such trade secrets in violation of this Agreement, you agree to maintain the confidentiality of the trade secrets of the SDK using at least the same degree of care that you use with your own confidential information.
+
+17. WARRANTY DISCLAIMER: THE UJAM GORILLA ENGINE SDK SERVICE, INCLUDING THE SDK, IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, WE DISCLAIM ALL WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, REGARDING THE UJAM GORILLA ENGINE SDK SERVICE, INCLUDING WITHOUT LIMITATION ANY AND ALL IMPLIED WARRANTIES OF MERCHANTABILITY, ACCURACY, RESULTS OF USE, RELIABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AVAILABILITY, PERFORMANCE, BANDWIDTH, AND NON-INFRINGEMENT OF THIRD-PARTY RIGHTS. FURTHER, WE DISCLAIM ANY WARRANTY THAT LICENSEE'S USE OF THE UJAM GORILLA ENGINE SDK SERVICE WILL BE AVAILABLE, UNINTERRUPTED OR ERROR FREE.
+
+18. LIABILITY LIMITATION: REGARDLESS OF WHETHER ANY REMEDY SET FORTH HEREIN FAILS OF ITS ESSENTIAL PURPOSE OR OTHERWISE, AND EXCEPT FOR BODILY INJURY, IN NO EVENT WILL WE OR OUR CONTRACTORS, EMPLOYEES OR AFFILIATES BE LIABLE TO YOU OR TO ANY THIRD PARTY UNDER ANY TORT, CONTRACT, NEGLIGENCE, STRICT LIABILITY OR OTHER LEGAL OR EQUITABLE THEORY FOR ANY LOST PROFITS, LOST OR CORRUPTED DATA, COMPUTER FAILURE OR MALFUNCTION, INFRINGEMENT, INTERRUPTION OF BUSINESS, OR OTHER SPECIAL, INDIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY KIND ARISING OUT OF THE USE OR INABILITY TO USE THE UJAM GORILLA ENGINE SDK SERVICE, EVEN IF WE HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH LOSS OR DAMAGES AND WHETHER OR NOT SUCH LOSS OR DAMAGES ARE FORESEEABLE. IN NO EVENT SHALL OUR TOTAL LIABILITY TO YOU OR ANY THIRD PARTY EXCEED TEN USD DOLLARS. ANY CLAIM ARISING OUT OF OR RELATING TO THIS AGREEMENT MUST BE BROUGHT WITHIN ONE (1) YEAR AFTER THE OCCURRENCE OF THE EVENT GIVING RISE TO SUCH CLAIM.
+
+19. INDEMNITY: You agree that we shall have no liability whatsoever for your or your end users of the UJAM GORILLA ENGINE SDK SERVICE. You shall indemnify, defend and hold us harmless from any and all claims, damages, liabilities, costs, and fees (including reasonable attorneys' fees) arising from your or your end users' use of the UJAM GORILLA ENGINE SDK SERVICE or for any breach of this Agreement, including any breach of the representations and warranties you made herein.
+
+20. TERM AND TERMINATION: This Agreement shall continue until terminated as set forth in this Section. Either party may terminate this Agreement at any time, for any reason, or for no reason including, but not limited to, if you violate any provision of this Agreement. We reserve the right to cancel, amend, or modify the SDK at any time. Any termination of this Agreement shall also terminate the license granted hereunder. Upon termination of this Agreement for any reason, you shall immediately destroy and remove from all computers, hard drives, networks, and other storage media all copies of the SDK, and shall so certify to us that such actions have occurred (including all cached ephemeral copies). Sections 5 (“REPRESENTATIONS AND WARRANTIES”), 6 (“OWNERSHIP AND PROPRIETARY RIGHTS”), 10 (“TRADE SECRETS AND CONFIDENTIAL INFORMATION”), 11 (“WARRANTY DISCLAIMER”), 12 (“LIABILITY LIMITATION”), 13 (“INDEMNITY”), 16 (“GOVERNING LAW”), 18 (“GENERAL PROVISIONS”) shall survive termination of this Agreement.
+
+21. EXPORT CONTROLS: You shall comply with all applicable export laws and restrictions and regulations and you shall not export, or allow the export or re-export of the SDK in violation of any such restrictions, laws, or regulations.
+
+22. GOVERNING LAW: This Agreement shall be governed by New York law, excluding conflict of law provisions. The parties agree to and submit to the exclusive jurisdiction of courts located in New York City, New York. The application of the United Nations Convention of Contracts for the International Sale of Goods is expressly excluded.
+
+23. PREVAILING PARTY. Notwithstanding Section 12 (“LIABILITY LIMITATION”), in the event of any court action relating to enforcement of this Agreement, including injunctive relief, the non-prevailing party shall reimburse the prevailing party for all reasonable attorneys’ fees and costs, including expert witness fees, resulting therefrom.
+
+24. GENERAL PROVISIONS. If any part of this Agreement is found void or unenforceable, it will not affect the validity of the balance of the Agreement, which shall remain valid and enforceable according to its terms. This Agreement may only be modified by written agreement between the Parties. Updates to the UJAM GORILLA ENGINE SDK SERVICE may be licensed to you by UJAM with additional or different terms. UJAM further reserves rights, in its discretion, not to license updates. This is the entire Agreement between UJAM and you relating to the UJAM GORILLA ENGINE SDK SERVICE and it supersedes any prior representations, discussions, undertakings, communications, or advertising relating to the UJAM GORILLA ENGINE SDK SERVICE. This Agreement is not assignable by you.

package/README.md

@@ -0,0 +1,234 @@
+# @gorilla-engine-sdk/ge-blob-manager
+
+A utility library for locating and loading Gorilla Engine blob files in Gorilla Engine React based audio plugins, featuring:
+
+- Automatic blob file discovery across system locations
+- Cross-platform path handling (macOS & Windows)
+- User-guided file selection with native OS dialogs
+- Persistent settings for user-selected blob locations
+- React component and standalone function APIs
+
+## Install
+
+```bash
+npm install @gorilla-engine-sdk/ge-blob-manager
+```
+
+**Peer Dependencies:** Requires `@gorilla-engine-sdk/gorilla-engine-react` ^1.1.4
+
+## Quick Start
+
+This library is designed for Gorilla Engine React, a custom React reconciler that renders directly to native C++ UI components. It does **not** use a browser; instead, you build UIs with Gorilla Engine's native components like `<GELabel>`, `<GEKnob>`, `<GESlider>`, and `<GEButton>`.
+
+```tsx
+import { useState } from 'react';
+import { BlobManager } from '@gorilla-engine-sdk/ge-blob-manager';
+import {
+  GELabel,
+  GEKnob,
+  GESlider,
+  GEMidiKeyboard,
+} from '@gorilla-engine-sdk/gorilla-engine-react';
+
+function App() {
+  const [instrument, setInstrument] = useState<GorillaEngine.Instrument | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  return (
+    <GELabel width={800} height={600}>
+      <BlobManager
+        pluginName="MyPlugin"
+        manufacturerName="MyCompany"
+        blobName="SuperCoolInstrumentOrEffect"
+        onInstrumentLoaded={(inst, name, blobDir) => {
+          console.log(`Loaded "${name}" from ${blobDir}`);
+          setInstrument(inst);
+        }}
+        onErrorLoadingInstrument={(err) => {
+          console.error(err);
+          setError(err);
+        }}
+      />
+      {error && <GELabel x={10} y={10} text={error} color="#ff0000" />}
+      {instrument && <PluginControls instrument={instrument} />}
+    </GELabel>
+  );
+}
+
+function PluginControls({ instrument }: { instrument: GorillaEngine.Instrument }) {
+  return (
+    <GELabel x={0} y={50} width={800} height={550}>
+      <GEKnob x={100} y={100} width={80} height={80} parameterPath="/macro/volume" />
+      <GESlider x={200} y={100} width={40} height={200} parameterPath="/macro/filter" />
+      <GEMidiKeyboard x={50} y={350} width={700} height={120} />
+    </GELabel>
+  );
+}
+```
+
+## Blob File Structure
+
+Gorilla Engine blobs consist of two files that must be located in the same directory:
+
+| File                    | Contents                                                                                                                                                                             |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `<blobName>_part1.blob` | Initial instrument state and parameter values. Can optionally contain the preload portion of samples (useful when combining blob encryption with copy protection systems like PACE). |
+| `<blobName>_part2.blob` | All audio sample data. If part1 contains preload samples, this file contains the remainder of each sample.                                                                           |
+
+For example, if your `blobName` is `"SuperCoolInstrumentOrEffect"`, the library expects:
+
+- `SuperCoolInstrumentOrEffect_part1.blob`
+- `SuperCoolInstrumentOrEffect_part2.blob`
+
+## Search Order
+
+The library searches for blob files in the following order:
+
+1. **Default path** - `defaultBlobPath` prop or `GorillaEngine.getResourcePath()`
+2. **Path stored in "blobLocation" property in user-specific settings file** - `<UserAppSupport>/<ManufacturerName>/<PluginName>/<PluginName>.settings`
+3. **Path stored in "blobLocation" property in global settings file** - `<GlobalAppSupport>/<ManufacturerName>/<PluginName>/<PluginName>.settings`
+4. **Gorilla Engine resource path** - `GorillaEngine.getResourcePath()` (resolves to `<GlobalAppSupport>/<ManufacturerName>/<PluginName>`)
+5. **User file chooser** - Native OS file dialog (as a last resort)
+
+### Platform-Specific Paths
+
+| Platform | User App Support                                | Global App Support             |
+| -------- | ----------------------------------------------- | ------------------------------ |
+| macOS    | `~/Library/Application Support`                 | `/Library/Application Support` |
+| Windows  | `%APPDATA%` (`C:\Users\<user>\AppData\Roaming`) | `C:\ProgramData`               |
+
+## API Reference
+
+### BlobManager Component
+
+```tsx
+<BlobManager {...props: BlobProps} />
+```
+
+React component that automatically loads a blob file on mount. Renders nothing visually but triggers blob loading as a side effect.
+
+### BlobProps Interface
+
+```typescript
+interface BlobProps {
+  pluginName: string;
+  manufacturerName: string;
+  blobName: string;
+  defaultBlobPath?: string;
+  onInstrumentLoaded: (
+    instrument: GorillaEngine.Instrument,
+    instrumentName: string,
+    resolvedBlobPath?: string,
+  ) => void;
+  onErrorLoadingInstrument: (error: string) => void;
+}
+```
+
+**Properties:**
+
+- `pluginName` - Plugin name as configured in Gorilla Compiler (must match exactly)
+- `manufacturerName` - Manufacturer/company name for path construction as configured in Gorilla Compiler (must match exactly)
+- `blobName` - Base blob name without `_part1.blob`/`_part2.blob` suffix
+- `defaultBlobPath` - Optional custom default search path (defaults to `GorillaEngine.getResourcePath()`)
+- `onInstrumentLoaded` - Success callback with loaded instrument, name, and blob directory
+- `onErrorLoadingInstrument` - Error callback with human-readable error message
+
+### loadBlob Function
+
+```typescript
+async function loadBlob(props: BlobProps): Promise<void>;
+```
+
+Loads a blob file and initializes the Gorilla Engine instrument. Use this for programmatic control over when loading occurs.
+
+```typescript
+import { loadBlob } from '@gorilla-engine-sdk/ge-blob-manager';
+
+// Load blob programmatically (e.g., on user action)
+async function handleLoadClick() {
+  await loadBlob({
+    pluginName: 'MyPlugin',
+    manufacturerName: 'MyCompany',
+    blobName: 'SuperCoolInstrumentOrEffect',
+    onInstrumentLoaded: (instrument, name, blobDir) => {
+      console.log(`Loaded instrument "${name}" from ${blobDir}`);
+    },
+    onErrorLoadingInstrument: async (error) => {
+      // Use Gorilla Engine's native message box (not a browser dialog)
+      await GorillaEngine.showNativeMessageBox({
+        title: 'Loading Error',
+        message: error,
+        iconType: 'warning',
+      });
+    },
+  });
+}
+```
+
+### locateBlob Function
+
+```typescript
+async function locateBlob(props: BlobProps): Promise<string>;
+```
+
+Locates a blob file without loading it. Returns the full path or empty string if not found. Useful when you need the path before loading.
+
+```typescript
+import { locateBlob } from '@gorilla-engine-sdk/ge-blob-manager';
+
+const blobPath = await locateBlob({
+  pluginName: 'MyPlugin',
+  manufacturerName: 'MyCompany',
+  blobName: 'SuperCoolInstrumentOrEffect',
+  onInstrumentLoaded: () => {},
+  onErrorLoadingInstrument: () => {},
+});
+
+if (blobPath) {
+  console.log(`Blob found at: ${blobPath}`);
+} else {
+  console.log('Blob not found');
+}
+```
+
+## Settings File Format
+
+When users manually select a blob location, it's persisted to a JSON settings file:
+
+```json
+{
+  "blobLocation": "/path/to/blob/directory"
+}
+```
+
+**File location:** `<UserAppSupport>/<manufacturerName>/<pluginName>/<pluginName>.settings`
+
+## Error Handling
+
+The library handles errors gracefully:
+
+- **Blob not found**: Prompts user with native file chooser dialog
+- **Part2 missing**: Calls `onErrorLoadingInstrument` with descriptive message
+- **User cancels dialog**: Returns empty path, allowing retry logic
+- **Loading failure**: Creates empty instrument to prevent audio engine errors
+
+```tsx
+<BlobManager
+  pluginName="MyPlugin"
+  manufacturerName="MyCompany"
+  blobName="SuperCoolInstrumentOrEffect"
+  onInstrumentLoaded={(inst) => setInstrument(inst)}
+  onErrorLoadingInstrument={async (error) => {
+    // Show native OS message box (not a browser dialog)
+    await GorillaEngine.showNativeMessageBox({
+      title: 'Content Not Found',
+      message: error,
+      iconType: 'warning',
+    });
+  }}
+/>
+```
+
+## License
+
+[GORILLA ENGINE FREE TIER LICENSE](./LICENSE.md)

package/dist/BlobManager.d.ts

@@ -0,0 +1,195 @@
+import * as React from 'react';
+/**
+ * Configuration options for the BlobManager component and blob loading functions.
+ *
+ * @remarks
+ * The BlobManager uses these properties to locate and load blob files from various
+ * locations on the user's system, with fallback to user-guided file selection.
+ *
+ * @example
+ * ```tsx
+ * const blobProps: BlobProps = {
+ *   pluginName: "MyPlugin",
+ *   manufacturerName: "MyCompany",
+ *   blobName: "SuperCoolInstrumentOrEffect",
+ *   onInstrumentLoaded: (instrument, name, path) => {
+ *     console.log(`Loaded ${name} from ${path}`);
+ *   },
+ *   onErrorLoadingInstrument: (error) => {
+ *     console.error(error);
+ *   }
+ * };
+ * ```
+ */
+export interface BlobProps {
+    /**
+     * The name of the plugin as configured in Gorilla Compiler.
+     *
+     * @remarks
+     * Used to locate the settings file and construct paths.
+     * Must match exactly with your Gorilla Compiler configuration.
+     */
+    pluginName: string;
+    /**
+     * The manufacturer/company name as configured in Gorilla Compiler.
+     *
+     * @remarks
+     * Used to construct the Application Support path structure.
+     * Must match exactly with your Gorilla Compiler configuration.
+     */
+    manufacturerName: string;
+    /**
+     * The base name of the blob file (without `_part1.blob` or `_part2.blob` suffix).
+     *
+     * @remarks
+     * The BlobManager will automatically append `_part1.blob` and `_part2.blob`
+     * when searching for blob files.
+     *
+     * @example
+     * If your blob files are `SuperCoolInstrumentOrEffect_part1.blob` and `SuperCoolInstrumentOrEffect_part2.blob`,
+     * set this to `"SuperCoolInstrumentOrEffect"`.
+     */
+    blobName: string;
+    /**
+     * Optional default path where to look for the blob file first.
+     *
+     * @remarks
+     * If not provided, defaults to `GorillaEngine.getResourcePath()`.
+     * Use this when your blob files are installed in a custom location.
+     */
+    defaultBlobPath?: string;
+    /**
+     * Callback invoked when the instrument is successfully loaded from the blob.
+     *
+     * @param instrument - The loaded Gorilla Engine instrument instance
+     * @param instrumentName - The name of the instrument as defined in the blob
+     * @param resolvedBlobPath - The directory path where the blob was found
+     */
+    onInstrumentLoaded: (instrument: GorillaEngine.Instrument, instrumentName: string, resolvedBlobPath?: string) => void;
+    /**
+     * Callback invoked when an error occurs during blob loading.
+     *
+     * @param error - Human-readable error message describing what went wrong
+     */
+    onErrorLoadingInstrument: (error: string) => void;
+}
+/**
+ * Locates a blob file by searching multiple locations and prompts user if not found.
+ *
+ * This function searches for blob files in the following order:
+ * 1. Path stored in "blobLocation" property in user-specific settings file (`<UserAppSupport>/<ManufacturerName>/<PluginName>/<PluginName>.settings`)
+ * 2. Path stored in "blobLocation" property in global settings file (`<GlobalAppSupport>/<ManufacturerName>/<PluginName>/<PluginName>.settings`)
+ * 3. Gorilla Engine resource path (`GorillaEngine.getResourcePath()`, resolves to `<GlobalAppSupport>/<ManufacturerName>/<PluginName>`)
+ * 4. User file chooser - Native OS file dialog (as a last resort)
+ *
+ * When the user selects a blob file manually, the location is persisted to
+ * the user settings file for future lookups.
+ *
+ * @param props - Configuration options containing plugin, manufacturer, and blob names
+ * @returns Promise resolving to the full path of the located blob file, or empty string if not found
+ *
+ * @remarks
+ * The function handles cross-platform paths automatically:
+ * - **macOS**: `~/Library/Application Support` (user) and `/Library/Application Support` (global)
+ * - **Windows**: `%APPDATA%` (user) and `C:\ProgramData` (global)
+ *
+ * @example
+ * ```typescript
+ * const blobPath = await locateBlob({
+ *   pluginName: "MyPlugin",
+ *   manufacturerName: "MyCompany",
+ *   blobName: "SuperCoolInstrumentOrEffect",
+ *   onInstrumentLoaded: () => {},
+ *   onErrorLoadingInstrument: () => {}
+ * });
+ *
+ * if (blobPath) {
+ *   console.log(`Found blob at: ${blobPath}`);
+ * }
+ * ```
+ */
+export declare const locateBlob: (props: BlobProps) => Promise<string>;
+/**
+ * Loads a blob file and initializes the Gorilla Engine instrument.
+ *
+ * This function handles the complete blob loading workflow:
+ * 1. Checks the default path (or `GorillaEngine.getResourcePath()`)
+ * 2. Falls back to {@link locateBlob} if not found at default location
+ * 3. Verifies both part1 and part2 blob files exist
+ * 4. Loads the blob and sets the active instrument
+ *
+ * @param props - Configuration options for blob loading
+ *
+ * @remarks
+ * Gorilla Engine blobs consist of two files:
+ * - `<blobName>_part1.blob` - Contains instrument definitions
+ * - `<blobName>_part2.blob` - Contains sample data
+ *
+ * Both files must be present in the same directory for successful loading.
+ * On success, the first instrument in the blob is automatically set as the
+ * active instrument via `GorillaEngine.setActiveInstrument()`.
+ *
+ * On failure, an empty instrument is created to prevent audio engine errors.
+ *
+ * @example
+ * ```typescript
+ * await loadBlob({
+ *   pluginName: "MyPlugin",
+ *   manufacturerName: "MyCompany",
+ *   blobName: "SuperCoolInstrumentOrEffect",
+ *   onInstrumentLoaded: (instrument, name, blobDir) => {
+ *     console.log(`Loaded instrument "${name}" from ${blobDir}`);
+ *     // Initialize your plugin UI
+ *   },
+ *   onErrorLoadingInstrument: (error) => {
+ *     console.error(error);
+ *     // Show error dialog to user
+ *   }
+ * });
+ * ```
+ */
+export declare const loadBlob: (props: BlobProps) => Promise<void>;
+/**
+ * React component that automatically loads a blob file on mount.
+ *
+ * This component provides a declarative way to load Gorilla Engine blob files
+ * in your React-based audio plugin UI. It renders nothing visually (empty fragment)
+ * but triggers blob loading as a side effect when mounted.
+ *
+ * @param props - Configuration options for blob loading
+ *
+ * @remarks
+ * The component calls {@link loadBlob} once on mount. The loading result is
+ * communicated through the `onInstrumentLoaded` and `onErrorLoadingInstrument`
+ * callbacks provided in props.
+ *
+ * For more control over the loading process (e.g., loading at a specific time
+ * or showing loading progress), use the {@link loadBlob} function directly.
+ *
+ * @example
+ * ```tsx
+ * import { useState } from 'react';
+ * import { BlobManager } from "@gorilla-engine-sdk/ge-blob-manager";
+ * import { GELabel } from "@gorilla-engine-sdk/gorilla-engine-react";
+ *
+ * function App() {
+ *   const [instrument, setInstrument] = useState<GorillaEngine.Instrument | null>(null);
+ *   const [error, setError] = useState<string | null>(null);
+ *
+ *   return (
+ *     <GELabel width={800} height={600}>
+ *       <BlobManager
+ *         pluginName="MyPlugin"
+ *         manufacturerName="MyCompany"
+ *         blobName="SuperCoolInstrumentOrEffect"
+ *         onInstrumentLoaded={(inst, name) => setInstrument(inst)}
+ *         onErrorLoadingInstrument={(err) => setError(err)}
+ *       />
+ *       {error && <GELabel x={10} y={10} text={error} color="#ff0000" />}
+ *       {instrument && <PluginControls instrument={instrument} />}
+ *     </GELabel>
+ *   );
+ * }
+ * ```
+ */
+export declare function BlobManager(props: BlobProps): React.JSX.Element;

package/dist/BlobManager.js

@@ -0,0 +1,273 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadBlob = exports.locateBlob = void 0;
+exports.BlobManager = BlobManager;
+const React = __importStar(require("react"));
+const react_1 = require("react");
+const os = __importStar(require("node:os"));
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("node:path"));
+/**
+ * @internal
+ * Constructs the blob filename with part suffix.
+ *
+ * @param name - Base blob name
+ * @param part1 - If true, returns part1 filename; otherwise part2
+ * @returns The full blob filename
+ */
+const getBlobName = ({ name, part1 = true }) => part1 ? `${name}_part1.blob` : `${name}_part2.blob`;
+/**
+ * @internal
+ * Attempts to find a blob file at the specified location.
+ *
+ * @param location - Directory or file path to check
+ * @param blobName - The blob filename to look for
+ * @returns The full path to the blob file if found, undefined otherwise
+ */
+const findBlobAtPath = (location, blobName) => {
+    if (fs.existsSync(location) && fs.lstatSync(location).isDirectory()) {
+        location = path.join(location, blobName);
+    }
+    return fs.existsSync(location) && fs.lstatSync(location).isFile() ? location : undefined;
+};
+/**
+ * Locates a blob file by searching multiple locations and prompts user if not found.
+ *
+ * This function searches for blob files in the following order:
+ * 1. Path stored in "blobLocation" property in user-specific settings file (`<UserAppSupport>/<ManufacturerName>/<PluginName>/<PluginName>.settings`)
+ * 2. Path stored in "blobLocation" property in global settings file (`<GlobalAppSupport>/<ManufacturerName>/<PluginName>/<PluginName>.settings`)
+ * 3. Gorilla Engine resource path (`GorillaEngine.getResourcePath()`, resolves to `<GlobalAppSupport>/<ManufacturerName>/<PluginName>`)
+ * 4. User file chooser - Native OS file dialog (as a last resort)
+ *
+ * When the user selects a blob file manually, the location is persisted to
+ * the user settings file for future lookups.
+ *
+ * @param props - Configuration options containing plugin, manufacturer, and blob names
+ * @returns Promise resolving to the full path of the located blob file, or empty string if not found
+ *
+ * @remarks
+ * The function handles cross-platform paths automatically:
+ * - **macOS**: `~/Library/Application Support` (user) and `/Library/Application Support` (global)
+ * - **Windows**: `%APPDATA%` (user) and `C:\ProgramData` (global)
+ *
+ * @example
+ * ```typescript
+ * const blobPath = await locateBlob({
+ *   pluginName: "MyPlugin",
+ *   manufacturerName: "MyCompany",
+ *   blobName: "SuperCoolInstrumentOrEffect",
+ *   onInstrumentLoaded: () => {},
+ *   onErrorLoadingInstrument: () => {}
+ * });
+ *
+ * if (blobPath) {
+ *   console.log(`Found blob at: ${blobPath}`);
+ * }
+ * ```
+ */
+const locateBlob = async (props) => {
+    const { pluginName, manufacturerName, blobName } = props;
+    const blobFileName = getBlobName({ name: blobName });
+    const userAppSupportDir = os.platform() === 'darwin'
+        ? path.join(os.homedir(), 'Library/Application Support')
+        : path.join(os.homedir(), 'AppData\\Roaming');
+    const globalAppSupportDir = os.platform() === 'darwin' ? '/Library/Application Support' : 'C:\\ProgramData';
+    const userSettingsFilePath = path.join(userAppSupportDir, manufacturerName, pluginName, `${pluginName}.settings`);
+    const globalSettingsFilePath = path.join(globalAppSupportDir, manufacturerName, pluginName, `${pluginName}.settings`);
+    const geShellDefaultBlobFilePath = findBlobAtPath(GorillaEngine.getResourcePath(), blobFileName);
+    const readSettingsFile = (filePath) => {
+        if (fs.existsSync(filePath)) {
+            try {
+                return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+            }
+            catch (e) {
+                console.log(`Error reading settings file at ${filePath}:`, e);
+            }
+        }
+        return null;
+    };
+    const userSettings = readSettingsFile(userSettingsFilePath);
+    if (userSettings?.blobLocation) {
+        const blobLocation = findBlobAtPath(userSettings.blobLocation, blobFileName);
+        if (blobLocation)
+            return blobLocation;
+    }
+    const globalSettings = readSettingsFile(globalSettingsFilePath);
+    if (globalSettings?.blobLocation) {
+        const blobLocation = findBlobAtPath(globalSettings.blobLocation, blobFileName);
+        if (blobLocation)
+            return blobLocation;
+    }
+    if (geShellDefaultBlobFilePath)
+        return geShellDefaultBlobFilePath;
+    await GorillaEngine.showNativeMessageBox({
+        title: 'Plugin Content Not Found',
+        message: `A dialog will come up.\nPlease navigate to ${blobFileName}`,
+        iconType: 'info',
+    });
+    const files = await GorillaEngine.openFileChooser({
+        hint: `Please navigate to ${blobFileName}`,
+        allowedExtensions: '*.blob',
+        allowMultiple: false,
+    });
+    if (files.length !== 1 || path.basename(files[0]) !== blobFileName) {
+        await GorillaEngine.showNativeMessageBox({
+            title: 'Plugin Content Not Found',
+            message: `${blobFileName} couldn't be found.\nPlease consider reinstalling ${pluginName}`,
+            iconType: 'warning',
+        });
+        return '';
+    }
+    const result = files[0];
+    fs.ensureFileSync(userSettingsFilePath);
+    fs.writeFileSync(userSettingsFilePath, JSON.stringify({ blobLocation: path.dirname(result) }));
+    return result;
+};
+exports.locateBlob = locateBlob;
+/**
+ * Loads a blob file and initializes the Gorilla Engine instrument.
+ *
+ * This function handles the complete blob loading workflow:
+ * 1. Checks the default path (or `GorillaEngine.getResourcePath()`)
+ * 2. Falls back to {@link locateBlob} if not found at default location
+ * 3. Verifies both part1 and part2 blob files exist
+ * 4. Loads the blob and sets the active instrument
+ *
+ * @param props - Configuration options for blob loading
+ *
+ * @remarks
+ * Gorilla Engine blobs consist of two files:
+ * - `<blobName>_part1.blob` - Contains instrument definitions
+ * - `<blobName>_part2.blob` - Contains sample data
+ *
+ * Both files must be present in the same directory for successful loading.
+ * On success, the first instrument in the blob is automatically set as the
+ * active instrument via `GorillaEngine.setActiveInstrument()`.
+ *
+ * On failure, an empty instrument is created to prevent audio engine errors.
+ *
+ * @example
+ * ```typescript
+ * await loadBlob({
+ *   pluginName: "MyPlugin",
+ *   manufacturerName: "MyCompany",
+ *   blobName: "SuperCoolInstrumentOrEffect",
+ *   onInstrumentLoaded: (instrument, name, blobDir) => {
+ *     console.log(`Loaded instrument "${name}" from ${blobDir}`);
+ *     // Initialize your plugin UI
+ *   },
+ *   onErrorLoadingInstrument: (error) => {
+ *     console.error(error);
+ *     // Show error dialog to user
+ *   }
+ * });
+ * ```
+ */
+const loadBlob = async (props) => {
+    const { blobName, onInstrumentLoaded, onErrorLoadingInstrument } = props;
+    const defaultPath = props.defaultBlobPath
+        ? props.defaultBlobPath
+        : GorillaEngine.getResourcePath();
+    let resolvedBlobPath = path.join(defaultPath, getBlobName({ name: blobName })); //check default blob location
+    if (!fs.existsSync(resolvedBlobPath)) {
+        resolvedBlobPath = await (0, exports.locateBlob)(props);
+    }
+    //check if blob part2 exists in the same folder
+    const part2Exists = fs.existsSync(path.join(path.dirname(resolvedBlobPath), getBlobName({ name: blobName, part1: false })));
+    if (fs.existsSync(resolvedBlobPath) && part2Exists) {
+        const blob = GorillaEngine.loadBlob(resolvedBlobPath);
+        const instrumentName = blob.getInstrumentNames()[0];
+        const instrument = blob.loadInstrument(instrumentName);
+        GorillaEngine.setActiveInstrument(instrument);
+        onInstrumentLoaded(instrument, instrumentName, path.dirname(resolvedBlobPath));
+    }
+    else {
+        const instrument = GorillaEngine.createEmptyInstrument();
+        GorillaEngine.setActiveInstrument(instrument);
+        onErrorLoadingInstrument(`An error occurred while loading blob: ${resolvedBlobPath}. Please also make sure that part2 of the blob is located in the same folder.`);
+    }
+};
+exports.loadBlob = loadBlob;
+/**
+ * React component that automatically loads a blob file on mount.
+ *
+ * This component provides a declarative way to load Gorilla Engine blob files
+ * in your React-based audio plugin UI. It renders nothing visually (empty fragment)
+ * but triggers blob loading as a side effect when mounted.
+ *
+ * @param props - Configuration options for blob loading
+ *
+ * @remarks
+ * The component calls {@link loadBlob} once on mount. The loading result is
+ * communicated through the `onInstrumentLoaded` and `onErrorLoadingInstrument`
+ * callbacks provided in props.
+ *
+ * For more control over the loading process (e.g., loading at a specific time
+ * or showing loading progress), use the {@link loadBlob} function directly.
+ *
+ * @example
+ * ```tsx
+ * import { useState } from 'react';
+ * import { BlobManager } from "@gorilla-engine-sdk/ge-blob-manager";
+ * import { GELabel } from "@gorilla-engine-sdk/gorilla-engine-react";
+ *
+ * function App() {
+ *   const [instrument, setInstrument] = useState<GorillaEngine.Instrument | null>(null);
+ *   const [error, setError] = useState<string | null>(null);
+ *
+ *   return (
+ *     <GELabel width={800} height={600}>
+ *       <BlobManager
+ *         pluginName="MyPlugin"
+ *         manufacturerName="MyCompany"
+ *         blobName="SuperCoolInstrumentOrEffect"
+ *         onInstrumentLoaded={(inst, name) => setInstrument(inst)}
+ *         onErrorLoadingInstrument={(err) => setError(err)}
+ *       />
+ *       {error && <GELabel x={10} y={10} text={error} color="#ff0000" />}
+ *       {instrument && <PluginControls instrument={instrument} />}
+ *     </GELabel>
+ *   );
+ * }
+ * ```
+ */
+function BlobManager(props) {
+    (0, react_1.useEffect)(() => {
+        (0, exports.loadBlob)(props);
+    }, []);
+    return React.createElement(React.Fragment, null);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQmxvYk1hbmFnZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvQmxvYk1hbmFnZXIudHN4Il0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQW9WQSxrQ0FNQztBQTFWRCw2Q0FBK0I7QUFDL0IsaUNBQWtDO0FBQ2xDLDRDQUE4QjtBQUM5Qiw2Q0FBK0I7QUFDL0IsZ0RBQWtDO0FBc0ZsQzs7Ozs7OztHQU9HO0FBQ0gsTUFBTSxXQUFXLEdBQUcsQ0FBQyxFQUFFLElBQUksRUFBRSxLQUFLLEdBQUcsSUFBSSxFQUFxQyxFQUFFLEVBQUUsQ0FDaEYsS0FBSyxDQUFDLENBQUMsQ0FBQyxHQUFHLElBQUksYUFBYSxDQUFDLENBQUMsQ0FBQyxHQUFHLElBQUksYUFBYSxDQUFDO0FBRXREOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLGNBQWMsR0FBRyxDQUFDLFFBQWdCLEVBQUUsUUFBZ0IsRUFBc0IsRUFBRTtJQUNoRixJQUFJLEVBQUUsQ0FBQyxVQUFVLENBQUMsUUFBUSxDQUFDLElBQUksRUFBRSxDQUFDLFNBQVMsQ0FBQyxRQUFRLENBQUMsQ0FBQyxXQUFXLEVBQUUsRUFBRSxDQUFDO1FBQ3BFLFFBQVEsR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxRQUFRLENBQUMsQ0FBQztJQUMzQyxDQUFDO0lBQ0QsT0FBTyxFQUFFLENBQUMsVUFBVSxDQUFDLFFBQVEsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxTQUFTLENBQUMsUUFBUSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDO0FBQzNGLENBQUMsQ0FBQztBQUVGOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBa0NHO0FBQ0ksTUFBTSxVQUFVLEdBQUcsS0FBSyxFQUFFLEtBQWdCLEVBQW1CLEVBQUU7SUFDcEUsTUFBTSxFQUFFLFVBQVUsRUFB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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="gorilla-engine" preserve="true" />
+import { BlobManager, loadBlob, locateBlob, BlobProps } from './BlobManager';
+export { BlobManager, loadBlob, locateBlob };
+export type { BlobProps };

package/dist/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/// <reference types="gorilla-engine" preserve="true" />
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.locateBlob = exports.loadBlob = exports.BlobManager = void 0;
+const BlobManager_1 = require("./BlobManager");
+Object.defineProperty(exports, "BlobManager", { enumerable: true, get: function () { return BlobManager_1.BlobManager; } });
+Object.defineProperty(exports, "loadBlob", { enumerable: true, get: function () { return BlobManager_1.loadBlob; } });
+Object.defineProperty(exports, "locateBlob", { enumerable: true, get: function () { return BlobManager_1.locateBlob; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLHdEQUF3RDs7O0FBaUJ4RCwrQ0FBNkU7QUFFcEUsNEZBRkEseUJBQVcsT0FFQTtBQUFFLHlGQUZBLHNCQUFRLE9BRUE7QUFBRSwyRkFGQSx3QkFBVSxPQUVBIn0=

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@gorilla-engine-sdk/ge-blob-manager",
+  "version": "1.0.5",
+  "description": "This components helps to locate and load a blob file",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "scripts": {
+    "test": "echo \"No tests specified for ge-blob-manager\"",
+    "prepack": "npx tsc --declaration",
+    "ci:publish": "node ../../scripts/ci-publish.js"
+  },
+  "author": "UJAM Inc.",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "peerDependencies": {
+    "@gorilla-engine-sdk/gorilla-engine-react": "^1.6.1",
+    "react": "^19.0.0"
+  },
+  "devDependencies": {
+    "@gorilla-engine-sdk/gorilla-engine-react": "^1.6.1",
+    "@types/node": "^18.19.130",
+    "@types/react": "^19.2.16",
+    "@types/react-reconciler": "^0.33.0",
+    "react": "^19.0.0",
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "@types/gorilla-engine": "^1.1.31",
+    "fs-extra": "^11.3.3"
+  },
+  "homepage": "https://www.gorilla-engine.com/",
+  "keywords": [
+    "gorilla-engine",
+    "UJAM"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}