@ansight/capacitor 1.0.2-preview.6

package/AnsightCapacitor.podspec

@@ -0,0 +1,14 @@
+Pod::Spec.new do |s|
+  s.name = 'AnsightCapacitor'
+  s.version = '1.0.2-preview.6'
+  s.summary = 'Capacitor bridge for the Ansight mobile observability SDK.'
+  s.license = { :type => 'Ansight SDK Source-Available License', :file => 'LICENSE' }
+  s.homepage = 'https://github.com/ansight-ai/ansight-sdk'
+  s.author = { 'Ansight' => 'hello@ansight.ai' }
+  s.source = { :git => 'https://github.com/ansight-ai/ansight-sdk.git', :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/AnsightCapacitorPlugin/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '15.0'
+  s.swift_version = '5.9'
+  s.dependency 'Capacitor'
+  s.dependency 'Ansight', s.version.to_s
+end

package/LICENSE

@@ -0,0 +1,200 @@
+Ansight SDK Source-Available License
+Version 1.0
+
+Copyright (c) 2026 Ansight, Inc. All rights reserved.
+
+This license governs the Ansight SDK and associated source code, documentation,
+examples, build files, binaries, and other materials made available with it
+(the "SDK").
+
+The SDK is source-available software. It is not open-source software.
+
+By downloading, installing, copying, modifying, distributing, or using the SDK,
+you accept this license. If you do not accept this license, you may not use the
+SDK.
+
+1. Purpose
+
+Ansight makes the SDK source available so developers, customers, researchers,
+and security reviewers can inspect how the SDK works, evaluate its security,
+debug integrations, report issues, and propose improvements.
+
+Except for the rights expressly granted below, Ansight reserves all rights.
+
+2. Definitions
+
+"Ansight Services" means services, APIs, systems, products, accounts,
+infrastructure, software, development tools, test endpoints, sandbox
+environments, local tools, or other components operated by, provided by,
+authorized by, or on behalf of Ansight, Inc. or its affiliates. This includes
+Ansight-hosted services, Ansight Studio, Ansight APIs, Ansight-issued accounts
+or API keys, and any service or component expressly authorized by Ansight in
+writing.
+
+"Non-Ansight Services" means any service, API, backend, product, infrastructure,
+system, software, or component that is not an Ansight Service.
+
+"Application" means software developed by you that incorporates, links to, or
+uses the SDK.
+
+3. Permitted Uses
+
+Subject to this license, you may:
+
+(a) read, inspect, and analyze the SDK source code;
+
+(b) copy and build the SDK for evaluation, testing, debugging, security review,
+and development of Applications that use Ansight Services;
+
+(c) modify the SDK for your own internal development, testing, debugging,
+security review, or use with Ansight Services;
+
+(d) use and distribute the SDK, including in source, compiled, or object-code
+form, only as part of an Application that connects to or interoperates with
+Ansight Services;
+
+(e) distribute Applications containing the SDK through app stores, package
+managers, enterprise distribution systems, mobile device management systems,
+continuous integration systems, TestFlight, Google Play testing tracks, or
+similar software distribution channels, provided the SDK is used only with
+Ansight Services;
+
+(f) share bug reports, vulnerability reports, patches, pull requests, and other
+proposed improvements with Ansight; and
+
+(g) make public forks or copies of the SDK solely for review, discussion,
+security research, issue reporting, or contribution back to Ansight, provided
+that this license and all copyright, trademark, attribution, and other notices
+remain intact.
+
+4. Restrictions
+
+You may not:
+
+(a) use the SDK with, connect the SDK to, or adapt the SDK for any Non-Ansight
+Services;
+
+(b) use the SDK to develop, operate, enable, or support any service or product
+that replaces, proxies, emulates, competes with, or avoids the need for Ansight
+Services;
+
+(c) sell, sublicense, rent, lease, host, or provide the SDK as a standalone
+product, SDK-as-a-service, managed service, hosted service, or competing SDK
+distribution;
+
+(d) remove, obscure, or alter any copyright, license, trademark, attribution,
+security, telemetry, pairing, provenance, or service-association notices in the
+SDK;
+
+(e) circumvent license checks, authentication, pairing, service association,
+security controls, or technical measures in the SDK or Ansight Services;
+
+(f) use Ansight names, logos, or trademarks except as necessary to accurately
+identify the SDK or Ansight Services;
+
+(g) use the SDK in violation of applicable law, regulation, sanctions,
+export-control rules, privacy rules, app-store policies, or third-party rights;
+or
+
+(h) grant any rights in the SDK to others beyond the rights expressly permitted
+by this license.
+
+5. Contributions
+
+If you submit a patch, pull request, issue comment, vulnerability report, code,
+documentation, suggestion, or other contribution to Ansight relating to the SDK,
+you grant Ansight a perpetual, worldwide, irrevocable, sublicensable,
+transferable, royalty-free license to use, reproduce, modify, distribute,
+perform, display, commercialize, and otherwise exploit that contribution for any
+purpose.
+
+You represent that you have the right to grant this license for your
+contribution.
+
+To the extent permitted by law, you waive and agree not to assert moral rights
+in your contribution against Ansight, its affiliates, its customers, or its
+users.
+
+6. Security Research
+
+Ansight welcomes good-faith security review of the SDK. You may inspect, test,
+and analyze the SDK for security issues and disclose suspected vulnerabilities
+to Ansight through the security reporting process published by Ansight.
+
+This license does not authorize access to systems, services, accounts, devices,
+networks, data, or infrastructure without permission. It does not authorize
+disruption, degradation, data exfiltration, privacy violations, or activity that
+would harm Ansight, its customers, or third parties.
+
+7. Separate Agreements
+
+If you have a separate written agreement with Ansight governing your use of the
+SDK, that agreement controls to the extent of any conflict with this license.
+
+8. Third-Party Software
+
+The SDK may include or depend on third-party software, libraries, tools, or
+materials. Those components are licensed under their own terms. This license
+applies only to the SDK materials provided by Ansight.
+
+9. No Support Obligation
+
+Ansight has no obligation under this license to provide support, maintenance,
+updates, hosted services, compatibility fixes, security fixes, or other
+assistance for the SDK.
+
+10. Trademarks
+
+No trademark rights are granted under this license. You may use Ansight names
+only as necessary to accurately identify the SDK or Ansight Services, and only
+in a way that does not imply endorsement, sponsorship, or affiliation except as
+expressly authorized by Ansight.
+
+11. Termination
+
+If you violate this license, your rights under it terminate automatically. Upon
+termination, you must stop using, copying, modifying, and distributing the SDK.
+
+Sections 4 through 18 survive termination.
+
+12. No Warranty
+
+The SDK is provided "as is" and "as available", without warranties or conditions
+of any kind, whether express, implied, statutory, or otherwise, including
+warranties of merchantability, fitness for a particular purpose, title,
+non-infringement, security, accuracy, availability, or error-free operation.
+
+13. Limitation of Liability
+
+To the maximum extent permitted by law, Ansight will not be liable for any
+indirect, incidental, special, consequential, exemplary, or punitive damages, or
+for lost profits, lost revenues, lost data, loss of goodwill, business
+interruption, security incidents, or service interruption, arising out of or
+relating to the SDK or this license.
+
+14. Assignment
+
+You may not assign or transfer this license without Ansight's prior written
+consent. Ansight may assign or transfer this license without restriction.
+
+15. Waiver
+
+Failure by Ansight to enforce any provision of this license does not waive its
+right to enforce that provision or any other provision later.
+
+16. Severability
+
+If any provision of this license is found unenforceable, the remaining
+provisions remain in effect, and the unenforceable provision will be interpreted
+to the maximum extent permitted by law.
+
+17. Entire Agreement
+
+This license is the entire agreement between you and Ansight regarding the SDK,
+except to the extent you have a separate written agreement with Ansight that
+controls under Section 7.
+
+18. No Other Rights
+
+No rights are granted except as expressly stated in this license. All rights not
+expressly granted are reserved by Ansight.

package/Package.swift

@@ -0,0 +1,38 @@
+// swift-tools-version: 5.9
+import PackageDescription
+import Foundation
+
+let useLocalAnsightSdk = ProcessInfo.processInfo.environment["ANSIGHT_USE_LOCAL_SDK"] == "1"
+let ansightSdkDependency: Package.Dependency = useLocalAnsightSdk
+    ? .package(name: "AnsightSDK", path: "../ios")
+    : .package(
+        url: "https://github.com/ansight-ai/ansight-sdk.git",
+        exact: "1.0.2-preview.6"
+    )
+let ansightTargetDependency: Target.Dependency = .product(
+    name: "Ansight",
+    package: useLocalAnsightSdk ? "AnsightSDK" : "ansight-sdk"
+)
+
+let package = Package(
+    name: "AnsightCapacitor",
+    platforms: [.iOS(.v15), .macOS(.v11)],
+    products: [
+        .library(name: "AnsightCapacitor", targets: ["AnsightCapacitorPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0"),
+        ansightSdkDependency
+    ],
+    targets: [
+        .target(
+            name: "AnsightCapacitorPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm"),
+                ansightTargetDependency
+            ],
+            path: "ios/Sources/AnsightCapacitorPlugin"
+        )
+    ]
+)

package/README.md

@@ -0,0 +1,139 @@
+# Ansight for Capacitor
+
+`@ansight/capacitor` brings the Ansight Android and iOS runtimes to Capacitor 8
+applications. It exposes native telemetry, pairing, screenshots, touch capture,
+session properties, logs, guarded remote tools, JavaScript custom tools,
+artifacts, DOM inspection, route tracking, lifecycle tracking, and JavaScript
+error capture through one TypeScript API.
+
+## Install
+
+```bash
+npm install @ansight/capacitor
+npx cap sync
+```
+
+Requirements are Node 22+, Capacitor 8, Android API 24+ with Java 21, and iOS
+15+. The npm package links `ai.ansight:ansight-android` on Android and the
+`Ansight` Swift package/CocoaPod on iOS.
+
+## Start Ansight
+
+```ts
+import Ansight from '@ansight/capacitor';
+
+await Ansight.initializeAndActivate(
+  Ansight.createOptionsBuilder()
+    .withAnsightDefaults()
+    .withReadOnlyToolAccess()
+    .withDomTools()
+    .withErrorCapture()
+    .registerCustomProperty('app', 'flavour', 'development')
+    .build(),
+);
+
+await Ansight.connect(null, { clientName: 'Capacitor app' });
+```
+
+Use `.withAnsightSdk()` or `.withAllToolAccess()` only in trusted development
+builds. Do not embed developer pairing material or unrestricted remote tools in
+store builds.
+
+Pair with an explicit JSON document when needed:
+
+```ts
+await Ansight.savePairingConfig(pairingJson);
+await Ansight.connect(pairingJson, {
+  expectedAppId: 'your-app-id',
+  clientName: 'Capacitor app',
+});
+```
+
+## Telemetry and capture
+
+```ts
+await Ansight.registerMetricChannel({
+  id: 42,
+  name: 'Queue depth',
+  unit: 'items',
+});
+await Ansight.metric(7, 42);
+await Ansight.event({
+  label: 'Sync completed',
+  type: 'App',
+  details: JSON.stringify({ records: 7 }),
+});
+await Ansight.screenViewed('Settings');
+await Ansight.sendClientLog('Settings loaded');
+await Ansight.captureScreenFrame({ quality: 70, maxWidth: 720 });
+```
+
+The facade also exposes `recordedMetrics`, `recordedEvents`, FPS and touch
+capture controls, lifecycle state, runtime snapshots, current options, host
+status/capabilities, and session custom-property mutations.
+
+The builder mirrors the portable React Native helpers for memory-channel
+exclusions, numeric JPEG capture configuration, bundled host configuration,
+discovery/retention settings, and visual-tree enable/disable. App-state
+tracking is available under both `startLifecycleTracking` /
+`stopLifecycleTracking` and `startAppStateTracking` / `stopAppStateTracking`.
+
+## JavaScript tools and artifacts
+
+```ts
+const tool = Ansight.registerTool(
+  {
+    id: 'app.get_state',
+    name: 'Get app state',
+    category: 'App',
+    scope: 'read',
+  },
+  async () => ({ success: true, result: { ready: true } }),
+);
+await tool.ready;
+
+const provider = Ansight.registerArtifactProvider({
+  descriptor: { id: 'app.exports', name: 'App exports' },
+  query: async () => [{ id: 'state', name: 'State JSON', contentType: 'application/json' }],
+  create: async () => ({
+    payload: { text: JSON.stringify({ ready: true }) },
+    metadata: { fileName: 'state.json', contentType: 'application/json' },
+  }),
+});
+await provider.ready;
+```
+
+Artifact payloads may be text, `Uint8Array`, `ArrayBuffer`, or byte arrays.
+Binary payloads use the native live-session transfer channel.
+
+## WebView DOM tools
+
+`.withDomTools()` registers `dom.get_document`, `dom.inspect_node`, and
+`dom.query_selector`. Pass `{ allowActions: true }` to add the write-scoped
+`dom.invoke_action` tool for click, focus, blur, and value-change operations.
+Native `ui.*` tools remain available for the Android/iOS view hierarchy.
+Call `uninstallDomTools()` to remove the adapter and its registrations.
+
+For no-bundler applications, `dist/standalone.js` is a self-contained script
+that initializes the developer defaults. Configure it before loading:
+
+```html
+<script>
+  globalThis.__ANSIGHT_CAPACITOR_STANDALONE_OPTIONS__ = {
+    toolGuard: 'readOnly',
+  };
+</script>
+<script src="./node_modules/@ansight/capacitor/dist/standalone.js"></script>
+```
+
+## Validation
+
+The complete interactive harness is in
+[`example-app`](./example-app/README.md). It contains 54 feature checks and
+buildable Android and iOS projects. The repository also provides a pinned
+25-application open-source compatibility corpus:
+
+```bash
+npm --prefix src/capacitor run verify
+node scripts/setup-capacitor-test-apps.mjs
+```

package/android/build.gradle

@@ -0,0 +1,52 @@
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+    }
+    dependencies {
+        classpath "com.android.tools.build:gradle:8.13.0"
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:2.2.20"
+    }
+}
+
+apply plugin: "com.android.library"
+apply plugin: "org.jetbrains.kotlin.android"
+
+android {
+    namespace = "ai.ansight.capacitor"
+    compileSdk = project.hasProperty("compileSdkVersion") ? rootProject.ext.compileSdkVersion : 36
+
+    defaultConfig {
+        minSdk = project.hasProperty("minSdkVersion") ? rootProject.ext.minSdkVersion : 24
+        targetSdk = project.hasProperty("targetSdkVersion") ? rootProject.ext.targetSdkVersion : 36
+        versionCode = 1
+        versionName = "1.0"
+    }
+
+    sourceSets {
+        main.java.srcDirs += "src/main/kotlin"
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+
+    kotlin {
+        jvmToolchain(21)
+    }
+
+    lint {
+        abortOnError = false
+    }
+
+    publishing {
+        singleVariant("release")
+    }
+}
+
+dependencies {
+    implementation project(":capacitor-android")
+    implementation "ai.ansight:ansight-android:1.0.2-preview.6"
+}

package/android/settings.gradle

@@ -0,0 +1,20 @@
+pluginManagement {
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+    }
+}
+
+dependencyResolutionManagement {
+    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
+    repositories {
+        mavenLocal()
+        google()
+        mavenCentral()
+    }
+}
+
+rootProject.name = "ansight-capacitor"
+include(":capacitor-android")
+project(":capacitor-android").projectDir = new File("../node_modules/@capacitor/android/capacitor")

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />