@repobit/dex-launch 0.3.2 → 1.2.0

package/CHANGELOG.md

@@ -0,0 +1,106 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [1.2.0](https://github.com/bitdefender/dex-core/compare/@repobit/dex-launch@0.3.3...@repobit/dex-launch@1.2.0) (2025-04-02)
+
+
+### Features
+
+* **DEX-21820:** added target tests ([6436b75](https://github.com/bitdefender/dex-core/commit/6436b75ad1937da0f9bd932c86c3fe8ba0bf3d54))
+* **DEX-22137:** added documentation ([7aa536f](https://github.com/bitdefender/dex-core/commit/7aa536fbfb44290a30f03819d1e84315310f1303))
+
+
+
+## [1.1.0](https://github.com/bitdefender/dex-core/compare/@repobit/dex-launch@0.3.3...@repobit/dex-launch@1.1.0) (2025-04-02)
+
+
+### Features
+
+* **DEX-21820:** added target tests ([6436b75](https://github.com/bitdefender/dex-core/commit/6436b75ad1937da0f9bd932c86c3fe8ba0bf3d54))
+* **DEX-22137:** added documentation ([7aa536f](https://github.com/bitdefender/dex-core/commit/7aa536fbfb44290a30f03819d1e84315310f1303))
+
+
+
+## [0.3.3](https://github.com/bitdefender/dex-core/compare/@repobit/dex-launch@0.3.2...@repobit/dex-launch@0.3.3) (2025-03-26)
+
+
+### Bug Fixes
+
+* **DEX-21085:** add files to package json ([d1fa71f](https://github.com/bitdefender/dex-core/commit/d1fa71f4b89812fa306b7ec0104af52505e87491))
+
+
+
+## [0.3.2](https://github.com/bitdefender/dex-core/compare/@repobit/dex-launch@0.3.1...@repobit/dex-launch@0.3.2) (2025-03-26)
+
+**Note:** Version bump only for package @repobit/dex-launch
+
+
+
+
+
+## [0.3.1](https://github.com/bitdefender/dex-core/compare/@repobit/dex-launch@0.3.0...@repobit/dex-launch@0.3.1) (2025-03-25)
+
+**Note:** Version bump only for package @repobit/dex-launch
+
+
+
+
+
+## [0.3.0](https://github.com/bitdefender/dex-core/compare/@repobit/dex-launch@0.2.0...@repobit/dex-launch@0.3.0) (2025-03-25)
+
+
+### Features
+
+* **DEX-22225:** created the data layer and updated target class ([390f327](https://github.com/bitdefender/dex-core/commit/390f327af376e8c70e37d14c5ffd699f60a17275))
+
+
+
+## [0.2.0](https://github.com/bitdefender/dex-core/compare/@repobit/dex-launch@0.1.4...@repobit/dex-launch@0.2.0) (2025-03-25)
+
+
+### Features
+
+* **DEX-21805:** change jest to vitest ([8219cf8](https://github.com/bitdefender/dex-core/commit/8219cf88cef6c4290783bb80a8142be0195de13e))
+
+
+
+## [0.1.4](https://github.com/bitdefender/dex-core/compare/@repobit/dex-launch@0.1.3...@repobit/dex-launch@0.1.4) (2025-03-24)
+
+
+### Bug Fixes
+
+* **DEX-21805:** add jsdom to jest ([c2d1d0b](https://github.com/bitdefender/dex-core/commit/c2d1d0bb0350df4f09f88cf64d3fec59e6a2815d))
+* **DEX-21805:** move build dependecies to root ([e75bb59](https://github.com/bitdefender/dex-core/commit/e75bb59c6c215b6be8167ca136423e577ef10656))
+* **DEX-21805:** update tsconfig for all packages ([01abd44](https://github.com/bitdefender/dex-core/commit/01abd4449f7c950116c3b5b76c6989299ab99aea))
+
+
+
+## [0.1.3](https://github.com/bitdefender/dex-core/compare/@repobit/dex-launch@0.1.1...@repobit/dex-launch@0.1.3) (2025-03-21)
+
+
+### Bug Fixes
+
+* **DEX-21805:** fix package.json ([487e824](https://github.com/bitdefender/dex-core/commit/487e82449bd5a0e6cd959a509b4f9820952466b6))
+
+
+
+## [0.1.1](https://github.com/bitdefender/dex-core/compare/@repobit/dex-launch@0.1.0...@repobit/dex-launch@0.1.1) (2025-03-05)
+
+**Note:** Version bump only for package @repobit/dex-launch
+
+
+
+
+
+## 0.1.0 (2025-03-04)
+
+
+### ⚠ BREAKING CHANGES
+
+* **DEX-22137:** added launch package
+
+### Features
+
+* **DEX-22137:** added launch package ([620e29a](https://github.com/bitdefender/dex-core/commit/620e29a078bddd9acc14e7db094686763a9b9711))

package/README.md

@@ -0,0 +1,80 @@
+# `@repobit/dex-launch`
+
+# Adobe Launch Loader
+
+Adobe Launch Loader is a lightweight utility that simplifies the process of dynamically loading Adobe Launch scripts based on a specified environment. It leverages constants and script-loading functions from the dex-utils package to construct the correct URL for the Adobe Launch script and then load it asynchronously into your application.
+
+---
+
+## Overview
+
+The Adobe Launch Loader provides a single abstract class with a static method to load the Adobe Launch script. By specifying an environment (such as `'prod'`, `'stage'`, or `'dev'`), the loader builds the script URL using predefined constants and loads the script into the document. This enables seamless integration with Adobe Launch without hardcoding script URLs in your code.
+
+---
+
+## Key Features
+
+- **Dynamic Script Loading:**  
+  Automatically builds and loads the Adobe Launch script URL based on the given environment.
+
+- **Environment Flexibility:**  
+  Supports multiple environments through a mapping of environment keys to script paths.
+
+- **Asynchronous Operation:**  
+  Uses asynchronous loading, ensuring that your application can continue operating while the script is being loaded.
+
+- **Easy Integration:**  
+  Requires minimal configuration and integrates seamlessly with your existing project using the dex-utils package.
+
+---
+
+## Installation
+
+This package relies on external dependencies:
+- @repobit/dex-utils
+
+```bash
+npm install @repobit/dex-launch
+```
+
+# Launch Class
+## Type: Abstract Class
+
+## Static Methods:
+- ### load(environment: string): Promise<void>
+  - Description:
+    Constructs the Adobe Launch script URL based on the provided environment and asynchronously loads the script using the loadScript utility from dex-utils.
+  - Parameters:
+    environment: string – The current environment (e.g., 'prod', 'stage', or 'dev').
+  - Return Type:
+    Returns a `Promise<void>` which resolves when the script has been successfully loaded.
+
+## Use Case:
+Call this method during your application initialization to dynamically load the Adobe Launch script appropriate for your environment. This approach helps keep your configuration dynamic and decoupled from your codebase.
+
+# Usage Example
+Below is an example of how to use the Adobe Launch Loader in your application:
+
+```typescript
+import Launch from '@repobit/dex-launch';
+
+// Load the Adobe Launch script for the production environment
+await Launch.load('prod');
+
+// After loading, the Adobe Launch script is available for use in your application.
+```
+
+If one wishes to use both Launch and Target in the same project, I recommend using a structure similar to the one below:
+
+```typescript
+import Launch from '@repobit/dex-launch';
+import Target from '@repobit/dex-target';
+
+try {
+  await Launch.load('prod');
+} catch (e) {
+  Target.abort();
+}
+```
+
+Since Target is dependent on Launch, it is better to Abort all Target operations when we are sure that Launch will not load.

package/dist/src/index.d.ts

@@ -1,3 +1,3 @@
 export default abstract class Launch {
-    static load(environment: string): Promise<void>;
+    static load(environment: 'dev' | 'stage' | 'prod'): Promise<void>;
 }

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,CAAC,OAAO,OAAgB,MAAM;IAC3B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC1C,MAAM,oBAAoB,GAAG,GAAG,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,oBAAoB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAE1G,MAAM,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACzC,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,CAAC,OAAO,OAAgB,MAAM;IAC3B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAqC;QAC5D,MAAM,oBAAoB,GAAG,GAAG,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,oBAAoB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAE1G,MAAM,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACzC,CAAC;CACF"}

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@repobit/dex-launch",
-  "version": "0.3.2",
+  "version": "1.2.0",
   "description": "Client for Adobe Launch",
   "author": "Constantin Ioan Mihai <iconstantin@bitdefender.com>",
   "homepage": "https://github.com/bitdefender/dex-core#readme",
   "license": "ISC",
   "main": "dist/src/index.js",
   "files": [
-    "dist/src"
+    "dist/src",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"
@@ -27,10 +30,10 @@
   "type": "module",
   "types": "dist/src/index.d.ts",
   "dependencies": {
-    "@repobit/dex-utils": "0.6.0"
+    "@repobit/dex-utils": "0.6.1"
   },
   "volta": {
     "node": "22.14.0"
   },
-  "gitHead": "5391b27f1542572bf315961e3aecaa0b45b9b00d"
+  "gitHead": "023c3635baa1d3b93ca2fa5876de81e383d34799"
 }