@digia-engage/core 2.3.0 → 2.3.2

package/DigiaEngageReactNative.podspec

@@ -8,7 +8,7 @@ Pod::Spec.new do |s|
     (Jetpack Compose) using the New Architecture (TurboModules / Fabric).
   DESC
 
-  s.license          = { :type => 'MIT', :file => '../LICENSE' }
+  s.license          = { :type => 'BUSL-1.1', :file => 'LICENSE' }
 
   s.authors          = { 'Digia Technology Private Limited' => 'https://digia.tech' }
   s.homepage         = 'https://github.com/Digia-Technology-Private-Limited/digia_engage'

package/LICENSE

@@ -0,0 +1,77 @@
+License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Parameters
+
+Licensor:             Tinkerbox Technology Private Limited
+Licensed Work:        Digia Engage Core SDK (React Native, including its Android
+                      and iOS bridges) and any associated components and libraries
+                      (c) 2025 Tinkerbox Technology Private Limited
+Additional Use Grant: You may make personal, commercial, and production use of the
+                      Licensed Work, provided Your use does not include offering the
+                      Licensed Work, or any derivative work thereof, as part of a
+                      competing low-code, no-code, or SDK-based platform or service.
+
+                      For the purposes of this license:
+
+                      A "competing platform" is any service, SDK, or developer tool
+                      that allows users to visually or programmatically build mobile
+                      applications or user interfaces and whose primary purpose
+                      significantly overlaps with Digia's paid platform offerings.
+
+                      A "Product" means any application, service, or tool that embeds,
+                      integrates, or builds upon the Licensed Work.
+
+                      "Embedded" means including the source code or executable code
+                      from the Licensed Work in a competing platform or Product, or
+                      requiring the Licensed Work to function as part of a competitive
+                      offering.
+
+                      Hosting, using, or embedding the Licensed Work in commercial or
+                      internal-use software that does not compete with Digia's core
+                      offerings is permitted.
+
+Change Date:          August 5, 2029
+Change License:       Apache License, Version 2.0
+
+For inquiries about commercial licensing or exceptions, contact:
+admin@digia.tech
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make personal or commercial use of the Licensed Work,
+including in production, subject to the Additional Use Grant above.
+
+Effective on the Change Date stated above, the Licensed Work will automatically
+be released under the Change License. On that date, all rights granted under this
+License terminate, and the Licensed Work becomes governed by the Change License.
+
+If your use of the Licensed Work does not comply with the Additional Use Grant,
+you must purchase a commercial license from the Licensor or refrain from using
+the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works of
+the Licensed Work, are subject to this License. This License applies separately
+for each version of the Licensed Work, and the Change Date may vary by version.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work from a third party,
+this License still applies.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other versions.
+
+This License does not grant you any right in any trademark or logo of Tinkerbox
+Technology Private Limited or its affiliates (provided that you may use a
+trademark or logo of the Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

package/README.md

@@ -266,6 +266,76 @@ react-native/ios/           iOS bridge
 
 ---
 
+## Build & publishing (hybrid model)
+
+This package is published using the **hybrid** React Native library layout (the
+[`react-native-builder-bob`](https://github.com/callstack/react-native-builder-bob)
+convention): the npm tarball ships **both** the compiled output (`lib/`) **and**
+the original TypeScript source (`src/`).
+
+### What the entry fields mean
+
+| `package.json` field | Points to | Used by |
+|---|---|---|
+| `main` | `lib/commonjs/index` | Node / CommonJS consumers, Jest |
+| `module` | `lib/module/index` | Bundlers that understand ESM |
+| `types` | `lib/typescript/index.d.ts` | TypeScript |
+| `react-native` / `source` | `src/index` | **Metro** — RN apps bundle straight from source |
+
+Because Metro resolves the `react-native`/`source` field, a React Native app that
+consumes this package bundles the **actual `.ts` source**. That gives our users
+the best developer experience:
+
+- **Stack traces** point at real `src/*.ts` lines, not transpiled output.
+- **Step-debugging** walks through the real source.
+- **Go-to-definition** lands on the real source — we ship `.d.ts` **and**
+  `.d.ts.map` (declaration maps) alongside `src/`, so an IDE jumps from the type
+  definition through to the `.ts` it came from.
+
+The compiled `lib/` is a robust fallback for any tool that does *not* honour the
+`react-native` field (Node, Jest, web bundlers, type resolvers), so the package
+never breaks outside Metro.
+
+### Why not ship raw `src/` only?
+
+Shipping only `src/*.ts` works in RN (Metro strips the types) but breaks
+everywhere else — bundlers skip `node_modules` transpilation by default, and a
+consumer's stricter `tsconfig` would re-type-check our source and surface errors
+they can't fix. The hybrid layout keeps the great RN DX *and* stays safe for
+every other consumer.
+
+### Build config that makes this work
+
+`tsconfig.build.json` (used only to generate type definitions):
+
+- `declaration: true` — emit `.d.ts`
+- `declarationMap: true` — emit `.d.ts.map` so go-to-definition reaches `src/`
+- `sourceMap: true` + `inlineSources: true` — map compiled JS back to source
+- `rootDir: "src"` — keeps `index.d.ts` at the top of `lib/typescript/`
+- **No** `declarationDir` / `noEmit` here — `bob` sets those via the CLI; leaving
+  them in the config produces conflict warnings
+
+`files` includes both `src` and `lib` so the maps resolve on the consumer's disk.
+
+### Publishing
+
+The `prepare` script runs `bob build` automatically on install and publish, so
+the build toolchain (`typescript`, `react-native-builder-bob`) must be installed
+first:
+
+```bash
+npm install         # installs devDeps AND runs prepare → bob build
+npm pack --dry-run  # verify lib/ + src/ + maps are in the tarball
+npm publish
+```
+
+> **Heads-up:** `package-lock.json` is **gitignored** for this library (a lib's
+> lockfile is ignored by consumers and only hides dependency-range drift). On a
+> fresh CI clone there is no lockfile, so use `npm install` — **not** `npm ci`,
+> which requires one.
+
+**Never hand-edit `lib/`** — it is generated. Edit `src/` and rebuild.
+
 ## License
 
-MIT © Digia Technology Private Limited
+Business Source License 1.1 (BUSL-1.1) © Digia Technology Private Limited — see [LICENSE](LICENSE)

package/lib/commonjs/Digia.js

@@ -74,7 +74,7 @@ class DigiaClass {
     try {
       await _NativeDigiaEngage.nativeDigiaModule.initialize(config.projectId, environment, logLevel, config.baseUrl, config.fontFamily);
     } catch (e) {
-      // TODO: TO BE PICKED LATER @aditya-digia — health event reporting being removed
+      // Health-event reporting is currently disabled.
       // digiaHealthReporter.report(HealthEventType.fetch_failed, { error_code: 0, platform: 'react_native' });
       throw e;
     }

package/lib/commonjs/DigiaHealthReporter.js

@@ -28,7 +28,7 @@ class DigiaHealthReporter {
   }
   report(eventType, detail) {
     if (!this._projectId) return;
-    // TODO: TO BE PICKED LATER @aditya-digia — health event backend endpoint being removed
+    // Health-event reporting is currently disabled.
     // fetch(`${this._baseUrl}/engage/sdk/recordHealthEvent`, {
     //     method: 'POST',
     //     headers: {

package/lib/module/Digia.js

@@ -67,7 +67,7 @@ class DigiaClass {
     try {
       await nativeDigiaModule.initialize(config.projectId, environment, logLevel, config.baseUrl, config.fontFamily);
     } catch (e) {
-      // TODO: TO BE PICKED LATER @aditya-digia — health event reporting being removed
+      // Health-event reporting is currently disabled.
       // digiaHealthReporter.report(HealthEventType.fetch_failed, { error_code: 0, platform: 'react_native' });
       throw e;
     }

package/lib/module/DigiaHealthReporter.js

@@ -22,7 +22,7 @@ export class DigiaHealthReporter {
   }
   report(eventType, detail) {
     if (!this._projectId) return;
-    // TODO: TO BE PICKED LATER @aditya-digia — health event backend endpoint being removed
+    // Health-event reporting is currently disabled.
     // fetch(`${this._baseUrl}/engage/sdk/recordHealthEvent`, {
     //     method: 'POST',
     //     headers: {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@digia-engage/core",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "description": "React Native bridge for Digia Engage – renders native Android Compose UI inside React Native apps",
-  "main": "src/index.ts",
-  "module": "src/index.ts",
-  "types": "src/index.ts",
-  "react-native": "src/index.ts",
-  "source": "src/index.ts",
+  "main": "lib/commonjs/index",
+  "module": "lib/module/index",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
   "files": [
     "src",
     "lib",
@@ -43,17 +43,13 @@
     "directory": "react-native"
   },
   "author": "Digia Technology Private Limited",
-  "license": "MIT",
+  "license": "BUSL-1.1",
   "dependencies": {
     "@react-native-async-storage/async-storage": "^2.1.2",
     "react-native-uuid": "^2.0.3",
     "@edwardloopez/react-native-coachmark": "^0.5.3",
     "@floating-ui/core": "^1.0.0"
   },
-  "peerDependencies": {
-    "react-native-reanimated": ">=3.0.0",
-    "react-native-svg": ">=13.0.0"
-  },
   "devDependencies": {
     "@react-native/eslint-config": "^0.73.0",
     "@types/react": "^18.2.0",
@@ -62,8 +58,6 @@
     "react": "18.2.0",
     "react-native": "0.73.0",
     "react-native-builder-bob": "^0.23.0",
-    "react-native-reanimated": "^3.19.3",
-    "react-native-svg": "^15.15.1",
     "typescript": "^5.2.0"
   },
   "react-native-builder-bob": {

package/src/Digia.ts

@@ -95,7 +95,7 @@ class DigiaClass implements DigiaDelegate {
         try {
             await nativeDigiaModule.initialize(config.projectId, environment, logLevel, config.baseUrl, config.fontFamily);
         } catch (e) {
-            // TODO: TO BE PICKED LATER @aditya-digia — health event reporting being removed
+            // Health-event reporting is currently disabled.
             // digiaHealthReporter.report(HealthEventType.fetch_failed, { error_code: 0, platform: 'react_native' });
             throw e;
         }

package/src/DigiaHealthReporter.ts

@@ -27,7 +27,7 @@ export class DigiaHealthReporter {
 
     report(eventType: HealthEventType, detail: Record<string, unknown>): void {
         if (!this._projectId) return;
-        // TODO: TO BE PICKED LATER @aditya-digia — health event backend endpoint being removed
+        // Health-event reporting is currently disabled.
         // fetch(`${this._baseUrl}/engage/sdk/recordHealthEvent`, {
         //     method: 'POST',
         //     headers: {