@rendley/sdk 1.10.2 → 1.11.0

package/LICENSE

@@ -1,48 +1,48 @@
-Proprietary License Agreement
-
-1. Grant of License
-   Onix Technologies ("Licensor") hereby grants you ("Licensee") a non-exclusive, non-transferable, limited license to use the Rendley SDK ("Software") solely for the purpose of developing and integrating applications in accordance with the terms of this Agreement.
-
-2. Restrictions
-
-Licensee shall not:
-
-1. Modify, adapt, translate, or create derivative works of the Software without prior written consent from Licensor.
-2. Reverse engineer, decompile, disassemble, or otherwise attempt to discover the source code of the Software.
-3. Redistribute, sublicense, rent, lease, or lend the Software to any third party.
-4. Use the Software for any purpose that is illegal or prohibited by law.
-
-5. Intellectual Property Rights
-
-The Software is protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. All title, ownership rights, and intellectual property rights in and to the Software and all copies thereof are owned by Licensor.
-
-4. Fees and Payment
-   Licensee agrees to pay the license fees and any other charges incurred in connection with the use of the Software as specified in the order form or purchase agreement. All payments are non-refundable.
-
-5. Support and Updates
-   Licensor may, at its sole discretion, provide updates, enhancements, or modifications to the Software. Licensor is not obligated to provide any support services, updates, or enhancements unless a separate support agreement is entered into.
-
-6. Termination
-   This Agreement is effective until terminated. Licensee may terminate this Agreement at any time by destroying all copies of the Software in their possession. Licensor may terminate this Agreement if Licensee breaches any of the terms and conditions. Upon termination, Licensee must destroy all copies of the Software.
-
-7. Disclaimer of Warranties
-   THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. LICENSOR DOES NOT WARRANT THAT THE SOFTWARE WILL MEET LICENSEE'S REQUIREMENTS OR THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR-FREE.
-
-8. Limitation of Liability
-   IN NO EVENT SHALL LICENSOR BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES, OR DAMAGES FOR LOSS OF PROFITS, REVENUE, DATA, OR USE, INCURRED BY LICENSEE OR ANY THIRD PARTY, WHETHER IN AN ACTION IN CONTRACT OR TORT, ARISING FROM LICENSEE'S ACCESS TO, OR USE OF, THE SOFTWARE.
-
-9. Governing Law
-   This Agreement shall be governed by and construed in accordance with the laws of Moldova, without regard to its conflict of laws principles.
-
-10. Entire Agreement
-    This Agreement constitutes the entire agreement between the parties with respect to the use of the Software and supersedes all prior or contemporaneous understandings regarding such subject matter. Any modifications to this Agreement must be in writing and signed by both parties.
-
-11. Severability
-    If any provision of this Agreement is held to be invalid or unenforceable, the remaining provisions will continue in full force and effect.
-
-12. No Waiver
-    The failure of either party to enforce any right or provision of this Agreement will not be deemed a waiver of such right or provision.
-
-Onix Technologies
-Chisinau, MD-2072
-Moldova
+Proprietary License Agreement
+
+1. Grant of License
+   Onix Technologies ("Licensor") hereby grants you ("Licensee") a non-exclusive, non-transferable, limited license to use the Rendley SDK ("Software") solely for the purpose of developing and integrating applications in accordance with the terms of this Agreement.
+
+2. Restrictions
+
+Licensee shall not:
+
+1. Modify, adapt, translate, or create derivative works of the Software without prior written consent from Licensor.
+2. Reverse engineer, decompile, disassemble, or otherwise attempt to discover the source code of the Software.
+3. Redistribute, sublicense, rent, lease, or lend the Software to any third party.
+4. Use the Software for any purpose that is illegal or prohibited by law.
+
+5. Intellectual Property Rights
+
+The Software is protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. All title, ownership rights, and intellectual property rights in and to the Software and all copies thereof are owned by Licensor.
+
+4. Fees and Payment
+   Licensee agrees to pay the license fees and any other charges incurred in connection with the use of the Software as specified in the order form or purchase agreement. All payments are non-refundable.
+
+5. Support and Updates
+   Licensor may, at its sole discretion, provide updates, enhancements, or modifications to the Software. Licensor is not obligated to provide any support services, updates, or enhancements unless a separate support agreement is entered into.
+
+6. Termination
+   This Agreement is effective until terminated. Licensee may terminate this Agreement at any time by destroying all copies of the Software in their possession. Licensor may terminate this Agreement if Licensee breaches any of the terms and conditions. Upon termination, Licensee must destroy all copies of the Software.
+
+7. Disclaimer of Warranties
+   THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. LICENSOR DOES NOT WARRANT THAT THE SOFTWARE WILL MEET LICENSEE'S REQUIREMENTS OR THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR-FREE.
+
+8. Limitation of Liability
+   IN NO EVENT SHALL LICENSOR BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES, OR DAMAGES FOR LOSS OF PROFITS, REVENUE, DATA, OR USE, INCURRED BY LICENSEE OR ANY THIRD PARTY, WHETHER IN AN ACTION IN CONTRACT OR TORT, ARISING FROM LICENSEE'S ACCESS TO, OR USE OF, THE SOFTWARE.
+
+9. Governing Law
+   This Agreement shall be governed by and construed in accordance with the laws of Moldova, without regard to its conflict of laws principles.
+
+10. Entire Agreement
+    This Agreement constitutes the entire agreement between the parties with respect to the use of the Software and supersedes all prior or contemporaneous understandings regarding such subject matter. Any modifications to this Agreement must be in writing and signed by both parties.
+
+11. Severability
+    If any provision of this Agreement is held to be invalid or unenforceable, the remaining provisions will continue in full force and effect.
+
+12. No Waiver
+    The failure of either party to enforce any right or provision of this Agreement will not be deemed a waiver of such right or provision.
+
+Onix Technologies
+Chisinau, MD-2072
+Moldova

package/README.md

@@ -1,31 +1,31 @@
-# Rendley SDK
-
-Rendley SDK takes the complexity out of video editing by providing a comprehensive set of APIs that handle composition, effects, filters, playback, rendering, splitting, trimming, and more.
-
-To achieve maximum performance, we leverage WebGL for rendering and WebCodecs API for hardware-accelerated encoding and decoding. For browsers that don't support [WebCodecs API](https://caniuse.com/?search=webcodecs), we seamlessly fallback to a browser-based version of FFmpeg.
-
-## Installation
-
-### Using the NPM Registry
-
-The installation process is straightforward. Simply run one of the followin
-
-```bash
-npm install @rendley/sdk
-```
-
-or
-
-```bash
-yarn add @rendley/sdk
-```
-
-The package includes type definitions, so you don't need to worry about setting those up separately.
-
-## Getting Started
-
-Check out the [documentation](https://docs.rendley.com) to learn more about how to get started creating compositions and building your own video editing software.
-
-## Templates
-
-To further simplify the process, we have [pre-built interfaces](https://docs.rendley.com/video-editor) that allow you to embed our video editing capabilities onto your website with just a few lines of code.
+# Rendley SDK
+
+Rendley SDK takes the complexity out of video editing by providing a comprehensive set of APIs that handle composition, effects, filters, playback, rendering, splitting, trimming, and more.
+
+To achieve maximum performance, we leverage WebGL for rendering and WebCodecs API for hardware-accelerated encoding and decoding. For browsers that don't support [WebCodecs API](https://caniuse.com/?search=webcodecs), we seamlessly fallback to a browser-based version of FFmpeg.
+
+## Installation
+
+### Using the NPM Registry
+
+The installation process is straightforward. Simply run one of the followin
+
+```bash
+npm install @rendley/sdk
+```
+
+or
+
+```bash
+yarn add @rendley/sdk
+```
+
+The package includes type definitions, so you don't need to worry about setting those up separately.
+
+## Getting Started
+
+Check out the [documentation](https://docs.rendley.com) to learn more about how to get started creating compositions and building your own video editing software.
+
+## Templates
+
+To further simplify the process, we have [pre-built interfaces](https://docs.rendley.com/video-editor) that allow you to embed our video editing capabilities onto your website with just a few lines of code.

package/dist/Engine.d.ts

@@ -4,7 +4,7 @@ import { CustomClip } from "./modules/clip/clips/custom/CustomClip";
 import { Display, DisplayOptions } from "./modules/display/Display";
 import { EventEmitter } from "./modules/event-emitter";
 import { FontRegistry } from "./modules/font-registry";
-import { Library } from "./modules/library";
+import { Library, LibrarySetupData } from "./modules/library";
 import { Settings, VideoCodec } from "./modules/settings";
 import { StorageProviderBase } from "./modules/storage";
 import { StorageController } from "./modules/storage/StorageController";
@@ -41,6 +41,7 @@ export interface EngineOptions {
     storages?: StorageProviderBase[];
     transcoder?: ITranscodeProvider;
     ffmpeg?: FFmpegOptions;
+    onSetupLibrary?: (data: LibrarySetupData) => Promise<void>;
 }
 type CustomClipConstructor<T extends CustomClip = CustomClip> = {
     new (...args: any[]): T;
@@ -68,6 +69,8 @@ export declare class Engine {
     private projectId;
     private isDestroying;
     private createdAt;
+    private onSetupLibrary?;
+    private initOptions;
     private readonly renderer;
     private readonly backgroundTimer;
     private constructor();
@@ -76,6 +79,7 @@ export declare class Engine {
     getFFmpeg(): import("./libs/ffmpeg").FFmpeg;
     private checkSafariAudioHack;
     init(options: EngineOptions): Promise<void>;
+    private getMissingLibraryAssets;
     private getLicenseCredentials;
     destroy(everything?: boolean): Promise<void>;
     getBackgroundTimer(): BackgroundTimer;
@@ -123,14 +127,14 @@ export declare class Engine {
             layers: {
                 id: string;
                 transitions: {
-                    type: "transition";
-                    name: string;
                     id: string;
+                    provider: string;
+                    properties: [string, any][];
                     startClipId: string;
                     endClipId: string;
                     inDuration: number;
                     outDuration: number;
-                    transitionSrc: string;
+                    transitionId: string;
                 }[];
                 clips: any[];
                 visible?: boolean | undefined;
@@ -150,6 +154,52 @@ export declare class Engine {
                     duration: number;
                 }[];
             }[];
+            filters: {
+                name: string;
+                id: string;
+                provider: string;
+                lutUrl: string;
+            }[];
+            effects: {
+                name: string;
+                id: string;
+                provider: string;
+                fragmentSrc: string;
+                properties: {
+                    type: import("./modules/library").PropertyDescriptionTypeEnum;
+                    name: string;
+                    defaultValue: Required<any>;
+                    label?: string | undefined;
+                    description?: string | undefined;
+                }[];
+                inputTextures?: {
+                    name: string;
+                    url: string;
+                    wrapMode?: import("./modules/library").InputTextureWrapMode | undefined;
+                    scaleMode?: import("./modules/library").InputTextureScaleMode | undefined;
+                    mipmap?: import("./modules/library").InputTextureMipmapMode | undefined;
+                }[] | undefined;
+            }[];
+            transitions: {
+                name: string;
+                id: string;
+                provider: string;
+                properties: {
+                    type: import("./modules/library").PropertyDescriptionTypeEnum;
+                    name: string;
+                    defaultValue: Required<any>;
+                    label?: string | undefined;
+                    description?: string | undefined;
+                }[];
+                transitionSrc: string;
+                inputTextures?: {
+                    name: string;
+                    url: string;
+                    wrapMode?: import("./modules/library").InputTextureWrapMode | undefined;
+                    scaleMode?: import("./modules/library").InputTextureScaleMode | undefined;
+                    mipmap?: import("./modules/library").InputTextureMipmapMode | undefined;
+                }[] | undefined;
+            }[];
             media: {
                 type: string;
                 id: string;