gio-uniapp-sdk 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,176 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

package/README.md

@@ -1,3 +1,202 @@
-# Temporary Holding Version
+# gio-uniapp-sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+GrowingIO 传统 uni-app Vue 3 数据采集 SDK。一行初始化即可自动采集页面浏览、App 生命周期与用户交互，同时支持手动埋点上报自定义事件、用户身份与属性。
+
+> 当前版本面向 **HarmonyOS（鸿蒙）端** 的 `.vue` App 发布，提供开箱即用的无埋点与手动埋点能力。
+>
+> 自动交互采集（点击、输入完成、选择器、TabBar）当前仅在鸿蒙端默认开启；Android 与 iOS 需通过验证构建另行开启，尚未纳入本次发布范围。
+
+## 功能特性
+
+- **自动采集**包括 App 会话开始（`VISIT`）、页面浏览（`PAGE`），以及鸿蒙端的按钮点击、输入完成等交互。
+- **手动埋点**：通过 `gdp()` 上报自定义事件、用户身份（`setUserId`）、用户属性（`setUserAttributes`）与位置信息。
+- **无埋点插桩**：Vite 构建期自动为模板插桩，业务代码无需改动，原有事件 handler 完整保留。
+- **隐私保护**：内置敏感字段拦截，密码、安全密码等输入内容永不读取、永不上报。
+- **类型安全**：完整 TypeScript 类型定义，未知命令、参数错误在编译期即可发现。
+- **离线缓存**：App 端在存储容量允许时将事件落盘，最多保留 7 天，恢复联网后自动补发。
+
+## 安装
+
+选择以下任一方式，同一应用内不要同时加载两份 SDK。
+
+### npm
+
+```sh
+npm install gio-uniapp-sdk
+```
+
+### uni_modules
+
+从 GitHub Release 下载 `*-uni_modules.tgz`，解压后将 `uni_modules/gio-uniapp-autotracker` 放入项目根目录。运行时导入路径为 `@/uni_modules/gio-uniapp-autotracker/index.js`，Vite 配置导入路径为 `./uni_modules/gio-uniapp-autotracker/vite.js`。
+
+两种渠道均提供 ESM JavaScript 与 `.d.ts` 类型声明。
+
+## 快速开始
+
+在应用入口创建 App 后，注册插件并初始化 SDK：
+
+```ts
+import gdp from 'gio-uniapp-sdk'
+
+export function createApp() {
+  const app = createSSRApp(App)
+
+  // 注册自动采集插件
+  gdp('registerPlugins', [{ name: 'gioEventAutoTracking' }])
+
+  // 初始化：传入账户 ID、数据源 ID 与配置
+  gdp('init', 'account-id', 'data-source-id', {
+    uniVue: app,
+    serverUrl: 'https://collector.example.com',
+    dataCollect: true,
+  })
+
+  return { app }
+}
+```
+
+初始化完成后，SDK 会自动读取 `uni` 宿主，通过全局 Vue mixin 接管 App / Page 生命周期。业务侧的 `App.vue` 与页面**无需**再引入任何 lifecycle bridge，也无需手动埋页面事件。
+
+### 初始化配置
+
+| 配置项 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `uniVue` | `App` | 是 | 应用实例，SDK 据此接管生命周期 |
+| `accountId` | `string` | 是 | 账户 ID（`init` 第一个参数） |
+| `dataSourceId` | `string` | 是 | 数据源 ID（`init` 第二个参数） |
+| `serverUrl` | `string` | 否 | 数据上报地址 |
+| `dataCollect` | `boolean` | 否 | 是否开启采集，默认开启 |
+| `sessionExpires` | `number` | 否 | 会话过期时长（分钟），默认 0.5，最大 360 |
+| `appVersion` | `string` | 否 | 上报的应用版本，缺省时自动读取宿主版本 |
+| `idMapping` | `boolean` | 否 | 是否启用身份映射 |
+| `debug` | `boolean` | 否 | 是否在控制台输出调试信息 |
+
+非必填配置缺省、类型错误或超出范围时，SDK 会回退到默认值，不会阻断初始化。
+
+需要等待用户同意时，初始化传入 `dataCollect: false`。已有的离线事件会暂存在本地，在调用 `gdp('setOptions', { dataCollect: true })` 后才恢复上传。
+
+## 手动埋点
+
+业务代码统一通过 `gdp()` 调用 SDK，无需持有任何内部实例：
+
+```ts
+// 上报自定义事件
+gdp('track', 'purchase', { sku: 'sku-1', price: 99 })
+
+// 设置用户 ID
+gdp('setUserId', 'user-123')
+
+// 清除用户 ID
+gdp('clearUserId')
+
+// 设置用户属性
+gdp('setUserAttributes', { vip: true, level: 3 })
+
+// 设置位置信息
+gdp('setLocation', 31.23, 121.47)
+
+// 清除位置信息
+gdp('clearLocation')
+
+// 动态开关采集
+gdp('setOptions', { dataCollect: false })
+```
+
+### 支持的命令
+
+| 命令 | 说明 |
+| --- | --- |
+| `track` | 上报自定义事件及属性 |
+| `setUserId` | 设置当前用户 ID |
+| `clearUserId` | 清除用户 ID |
+| `setUserAttributes` | 设置用户属性 |
+| `identify` | 高级身份识别 |
+| `getGioInfo` | 获取 SDK 信息，返回 `string \| null` |
+| `setOptions({ dataCollect })` | 动态开关采集 |
+| `setLocation` / `clearLocation` | 设置 / 清除位置信息 |
+| `registerPlugins` / `init` | 入口命令（初始化时调用） |
+
+## 无埋点自动采集
+
+SDK 通过 Vite 插件在**构建期**为模板插桩，自动采集以下交互：
+
+- 内置组件的 `@click`、`@tap`、`@change` 事件
+- input / textarea 的输入完成（优先 `@blur`，其次 `@confirm`）
+- 列表项的 `data-index` 维度信息
+- picker 的选中项文案
+
+### 配置 Vite 插件
+
+无埋点插桩是构建期能力，需在 `vite.config.ts` 中注册插件，且**必须放在 `uni()` 之前**：
+
+```ts
+import { defineConfig } from 'vite'
+import uni from '@dcloudio/vite-plugin-uni'
+
+const uniPlugin = (uni as unknown as { default?: typeof uni }).default ?? uni
+
+export default defineConfig(async () => {
+  const { gioUniappAutoTrack } = await import('gio-uniapp-sdk/vite')
+  return {
+    plugins: [gioUniappAutoTrack(), uniPlugin()],
+  }
+})
+```
+
+> uni_modules 渠道将导入路径替换为 `./uni_modules/gio-uniapp-autotracker/vite.js`。
+
+### 自定义采集粒度
+
+- 不想采集的交互：给监听声明静态 `data-growing-ignore`。
+- 需要标记敏感内容的字段：声明 `data-growing-sensitive`。
+- 需要手动补充采集：在业务原有 handler 中调用 `gdp('track', ...)`。
+
+插桩始终以「业务行为不变」为前提。无法安全分析的复杂表达式、动态事件、自定义组件等会保持源码原样，不会擅自改写业务逻辑。
+
+## 隐私与敏感数据
+
+SDK 默认保护以下内容：
+
+- **密码字段**（含动态 `:password`）：保留 `VIEW_CHANGE` 事件，但**始终不读取、不上报**输入内容。
+- **敏感标记**：显式 `data-growing-sensitive` 的元素整条采集会被拒绝。
+- **忽略标记**：`data-growing-ignore` 的元素不会被自动采集。
+
+需要精确控制采集范围的场景，请结合 `data-growing-sensitive`、`data-growing-ignore` 与手动 `gdp('track', ...)` 使用。
+
+## TypeScript 类型
+
+SDK 在客户项目中自动声明全局 `gdp`，无需额外 `.d.ts` 文件。也可按需从根入口导入类型：
+
+```ts
+import gdp, {
+  type GioAttributes,
+  type GioGdpInitOptions,
+  type GioPlugin,
+  type GioPluginRuntime,
+} from 'gio-uniapp-sdk'
+
+const options = {
+  uniVue: app,
+  dataCollect: true,
+  idMapping: true,
+} satisfies GioGdpInitOptions
+
+const attributes = { sku: 'sku-1', price: 99, tags: ['new', 'sale'] } satisfies GioAttributes
+
+gdp('init', 'account-id', 'data-source-id', options)
+gdp('track', 'purchase_completed', attributes)
+```
+
+未知命令、错误参数个数、嵌套属性或非布尔 `dataCollect` 等错误用法会在 TypeScript 编译期直接报错。
+
+## 调试
+
+初始化时设置 `debug: true`，SDK 会在控制台输出 `[GrowingIO Debug]:` 前缀的操作标签与即将派发的协议事件数组，便于排查采集问题。该开关不影响隐私、重试或采集行为。
+
+## 示例
+
+项目内提供了可运行的 showcase demo，展示生命周期、页面上下文、自定义事件、用户身份/属性、无埋点交互与 `dataCollect` 动态开关等完整用法。可用 HBuilderX 打开 `demo/` 目录运行体验。
+
+## 许可证
+
+[Apache-2.0](./LICENSE)

package/THIRD_PARTY_LICENSES.txt

@@ -0,0 +1,192 @@
+@babel/parser@7.29.8
+MIT
+Copyright (C) 2012-2014 by various contributors (see AUTHORS)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+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 NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
+----------------
+
+@vue/compiler-core@3.4.21
+MIT
+The MIT License (MIT)
+
+Copyright (c) 2018-present, Yuxi (Evan) You
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+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 NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
+----------------
+
+@vue/compiler-dom@3.4.21
+MIT
+The MIT License (MIT)
+
+Copyright (c) 2018-present, Yuxi (Evan) You
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+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 NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
+----------------
+
+@vue/compiler-sfc@3.4.21
+MIT
+The MIT License (MIT)
+
+Copyright (c) 2018-present, Yuxi (Evan) You
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+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 NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
+----------------
+
+@vue/shared@3.4.21
+MIT
+The MIT License (MIT)
+
+Copyright (c) 2018-present, Yuxi (Evan) You
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+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 NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
+----------------
+
+entities@4.5.0
+BSD-2-Clause
+Copyright (c) Felix Böhm
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+THIS IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+----------------
+
+estree-walker@2.0.2
+MIT
+Copyright (c) 2015-20 [these people](https://github.com/Rich-Harris/estree-walker/graphs/contributors)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+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 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+----------------
+
+source-map-js@1.2.1
+BSD-3-Clause
+
+Copyright (c) 2009-2011, Mozilla Foundation and contributors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the names of the Mozilla Foundation nor the names of project
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/autotrack.d.ts

@@ -0,0 +1 @@
+export { dispatchAutoTrack } from './src/plugins/gioEventAutoTracking/index.js';

package/autotrack.js

@@ -0,0 +1,3 @@
+// 本入口仅供 Vite 插桩生成的代码调用，与面向客户的 SDK 根入口分开。
+// 业务侧运行时统一通过 gdp() 使用 SDK。
+export { dispatchAutoTrack } from './src/plugins/gioEventAutoTracking/index.js';

package/index.d.ts

@@ -0,0 +1,69 @@
+import { type GioInitOptions } from './src/constants/config.js';
+import { type GioBuiltinPlugin } from './src/core/lifecycle.js';
+import { type UniMPInitOptions } from './src/plugins/gioHybridAdapter/contract.js';
+import { TrackerRuntime } from './src/core/growingIO.js';
+import { type UniAppVueApp } from './src/adapters/uniapp.js';
+/** 生命周期安装器所需的最小 Vue 应用接口，createSSRApp(App) 的结果满足此约束。 */
+export type GioUniVueApp = UniAppVueApp;
+export type GioGdpInitOptions = (Omit<GioInitOptions, 'accountId' | 'dataSourceId'> & {
+    runtime?: 'app';
+} | Omit<UniMPInitOptions, 'accountId' | 'dataSourceId'>) & Readonly<{
+    /** 由 createSSRApp(App) 返回的 Vue 应用，SDK 通过它接管 App 和 Page 生命周期。 */
+    uniVue: GioUniVueApp;
+}>;
+/** 可归一化为 GrowingIO 事件属性或用户属性字符串的基础值。 */
+export type GioAttributeScalar = string | number | boolean | Date | null | undefined;
+export type GioAttributeValue = GioAttributeScalar | readonly GioAttributeScalar[];
+export type GioAttributes = Readonly<Record<string, GioAttributeValue>>;
+/** 初始化完成后，仅允许在运行时修改 dataCollect。 */
+export type GioMutableOptions = Readonly<{
+    dataCollect: boolean;
+}>;
+/** 内部实例仅通过显式注册的客户插件安装参数提供。 */
+export type GioPluginRuntime = TrackerRuntime;
+export type GioPlugin = Readonly<{
+    name: string;
+    /** 首次有效初始化后安装客户插件；单个插件失败不阻止其他插件安装。 */
+    install: (growingio: GioPluginRuntime) => void;
+}>;
+export type GioPluginRegistration = GioBuiltinPlugin | GioPlugin;
+/** 客户可调用的完整命令接口，不提供接受任意命令的兜底重载；未知命令或错误参数会先被 TypeScript 拒绝。 */
+export interface GdpCommand {
+    /** 首次 init 前声明内置或客户插件，重复名称使整批注册失败。 */
+    (command: 'registerPlugins', plugins: readonly GioPluginRegistration[]): boolean;
+    /** 校验配置并启动异步初始化；重复调用输出警告并返回 false，保留首次实例与配置。 */
+    (command: 'init', accountId: string, dataSourceId: string, options: GioGdpInitOptions): boolean;
+    /** 提交手动事件；true 表示本地接纳或暂存，不代表服务端接收成功。 */
+    (command: 'track', eventName: string, attributes?: GioAttributes): boolean;
+    /** 更新登录身份；userKey 仅在初始化启用 idMapping 时生效。 */
+    (command: 'setUserId', userId: string, userKey?: string | null): boolean;
+    /** 清除当前登录字段，保留设备身份与内部最近登录身份。 */
+    (command: 'clearUserId'): boolean;
+    /** forceLogin 模式下，为本次等待上传的事件分配设备身份；每个运行期仅一次。 */
+    (command: 'identify', deviceId: string | number): boolean;
+    /** 当前身份查询串，需拼入受信任的 H5 URL；未就绪或托管模式不提供身份快照。 */
+    (command: 'getGioInfo'): string | null;
+    /** 提交用户属性事件，使用与手动事件一致的属性归一化规则。 */
+    (command: 'setUserAttributes', attributes: GioAttributes): boolean;
+    /** 仅允许修改 dataCollect；恢复时按生命周期建立新会话，有当前页时补发 PAGE。 */
+    (command: 'setOptions', options: GioMutableOptions): boolean;
+    /** 设置后续事件使用的内存位置，不主动定位、不请求权限。 */
+    (command: 'setLocation', latitude: number, longitude: number): boolean;
+    /** 清除后续事件的位置字段，不修改宿主定位或持久记录。 */
+    (command: 'clearLocation'): boolean;
+}
+/**
+ * 与独立小程序 SDK 对齐的命令入口。业务在 main.ts 注册插件，再将 Vue 应用作为 uniVue 传给 init。
+ * SDK 读取全局 uni 并自行转发生命周期，业务页面统一调用 gdp()。
+ *
+ * @returns 命令是否被本地接纳；事件命令成功不代表采集服务已接收。
+ */
+export declare const gdp: GdpCommand;
+declare global {
+    /** main.ts 导入 SDK 根入口后，uni-app 页面可使用由 SDK 声明的全局命令。 */
+    const gdp: GdpCommand;
+}
+export default gdp;
+export type { GioBuiltinPlugin } from './src/core/lifecycle.js';
+export type { HybridOptions, HybridReady, HybridError, HybridErrorCode } from './src/plugins/gioHybridAdapter/contract.js';
+export type { NativeIdentifierField } from './src/plugins/gioNativeIdentifiers/index.js';