diff --git a/.github/workflows/higgs-shop-sample-app-pull-request.yml b/.github/workflows/higgs-shop-sample-app-pull-request.yml index 7b722d7c..96e67822 100644 --- a/.github/workflows/higgs-shop-sample-app-pull-request.yml +++ b/.github/workflows/higgs-shop-sample-app-pull-request.yml @@ -21,7 +21,7 @@ jobs: strategy: matrix: os: [windows-latest, ubuntu-latest, macos-latest] - node-version: [16.x, 17.x] + node-version: [16.x, 17.x, 18.x] steps: - name: Checkout uses: actions/checkout@v2 diff --git a/core-sdk-samples/core-snippet-sample-app/.nvmrc b/core-sdk-samples/core-snippet-sample-app/.nvmrc new file mode 100644 index 00000000..e048c8ca --- /dev/null +++ b/core-sdk-samples/core-snippet-sample-app/.nvmrc @@ -0,0 +1 @@ +v18.15.0 diff --git a/core-sdk-samples/core-snippet-sample-app/README.md b/core-sdk-samples/core-snippet-sample-app/README.md new file mode 100644 index 00000000..73e0f069 --- /dev/null +++ b/core-sdk-samples/core-snippet-sample-app/README.md @@ -0,0 +1,73 @@ +
+ +![ts](https://badgen.net/badge/Built%20With/TypeScript/blue) + +# The Core Snippet Sample App + +This sample Web application will provide you with a hands-on way to understand how mParticle collects and forwards data, so you can easily implement data collection in your own projects. Throughout this application, the mParticle Web has been set up to initialize mParticle via a "snippet", capture user events and identities and forward them to mParticle. + +By using this sample app, you will quickly learn how to: + +- Set up mParticle's Web Snippet + +- Collect and forward data with mParticle + +- View incoming data events and debugging information in real time + +- Implement data collection with mParticle's SDKs + +## Getting Started + +1. Open the root of this project in your IDE or Editor of choice + +2. Install package dependencies using `npm install` + +3. Locate `src/snippet.js` file and find the part of the code that says `REPLACE WITH API KEY`. + +4. Update `REPLACE WITH API KEY` environment variable with with your mParticle Web API Key. + +- If you do not have a Web API key, visit your [mParticle Workspace](https://app.mparticle.com/setup/inputs/apps), then navigate to **Setup > Inputs** in the left column to generate one. + +5. Run the project using `npm serve` + +This will spawn a development server which listens on port `8080` by default. Manually navigate your browser to the address that is displayed in your console. `http://127.0.0.1:8080/` by default. + +## Events used in this app + +To make things simple yet declarative, this application has been built in such a way to keep event tracking close to the components that might logically trigger them rather than a fully DRY implementation. We've opted to be more repetitive so examples are consise and documented as necessary. + +Please feel free to also visit our [Doc Site](https://docs.mparticle.com/) to gain more familiarity with some of the more advanced features of mParticle. + +## Debugging The Web SDK + +To use this application to debug or develop the Web SDK, please check out the [mParticle Web SDK Repository](https://github.com/mParticle/mparticle-web-sdk). + +You can run this project in conjunction with the Web SDK using `npm link` to simulate importing the Web SDK into this project. + +To do this: + +- It is recommended that you use [Node Version Manager (NVM)](https://github.com/nvm-sh/nvm) to make sure both your Web SDK and Sample app are on the EXACT same version of Node. + +1. Clone the [mParticle Web SDK Repository](https://github.com/mParticle/mparticle-web-sdk) in a seperate folder on your computer. + +2. Within your local copy of Web SDK directory: + +- run `npm install` to install any necessary dependencies. +- run `npm link` so that npm registers your current Web SDK directory. +- run `npm run watch` so that mParticle rebuilds your dev instance of the SDK whenever you make a code change. + +3. Within the `core-sample-apps/core-snippet-sample-app` directory + +- run `npm link @mparticle/web-sdk` to link this sample app with your local instance of the Web SDK. +- run `npm run serve` to activate your simple web server and navigate to the address in your console. Default should be `http://127.0.0.1:8080` +- run `npm install` to install any necessary dependencies. +- Modify `index.html` so that `src/snippet.js` is commented out and that the "Local Development" script tags are enabled. +- Update `REPLACE WITH API KEY` within index.html with with your mParticle Web API Key. + +## Support + + + +## License + +The mParticle Web SDK is available under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0). See the LICENSE file for more info. diff --git a/core-sdk-samples/core-snippet-sample-app/index.html b/core-sdk-samples/core-snippet-sample-app/index.html new file mode 100644 index 00000000..c70c2f3b --- /dev/null +++ b/core-sdk-samples/core-snippet-sample-app/index.html @@ -0,0 +1,62 @@ + + + + mParticle Core Web Snippet Sample App + + + + + +

mParticle Core Web Snippet Sample App

+ +

View the developer console for debug information

+ + + + + + + + + + diff --git a/core-sdk-samples/core-snippet-sample-app/package-lock.json b/core-sdk-samples/core-snippet-sample-app/package-lock.json new file mode 100644 index 00000000..9f6aa55e --- /dev/null +++ b/core-sdk-samples/core-snippet-sample-app/package-lock.json @@ -0,0 +1,491 @@ +{ + "name": "core-snippet-sample-app", + "version": "1.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "core-snippet-sample-app", + "version": "1.0.0", + "license": "ISC", + "dependencies": { + "@mparticle/web-sdk": "^2.22.0" + }, + "devDependencies": { + "http-server": "^14.1.1" + } + }, + "node_modules/@babel/runtime": { + "version": "7.22.5", + "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.22.5.tgz", + "integrity": "sha512-ecjvYlnAaZ/KVneE/OdKYBYfgXV3Ptu6zQWmgEF7vwKhQnvVS6bjMD2XYgj+SNvQ1GfK/pjgokfPkC/2CO8CuA==", + "dependencies": { + "regenerator-runtime": "^0.13.11" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@mparticle/web-sdk": { + "version": "2.22.1", + "resolved": "https://registry.npmjs.org/@mparticle/web-sdk/-/web-sdk-2.22.1.tgz", + "integrity": "sha512-A5+P7cJTu+ToiZK4Ru/LBbee7QFSj/B3ckmq91WxLHColXHajZF0ZiX0AvZg1NCazBHMCyvW2YAAOn0F2hu3JA==", + "dependencies": { + "@babel/runtime": "^7.6.0", + "slugify": "^1.3.6" + } + }, + "node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/async": { + "version": "2.6.4", + "resolved": "https://registry.npmjs.org/async/-/async-2.6.4.tgz", + "integrity": "sha512-mzo5dfJYwAn29PeiJ0zvwTo04zj8HDJj0Mn8TD7sno7q12prdbnasKJHhkm2c1LgrhlJ0teaea8860oxi51mGA==", + "dev": true, + "dependencies": { + "lodash": "^4.17.14" + } + }, + "node_modules/basic-auth": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/basic-auth/-/basic-auth-2.0.1.tgz", + "integrity": "sha512-NF+epuEdnUYVlGuhaxbbq+dvJttwLnGY+YixlXlME5KpQ5W3CnXA5cVTneY3SPbPDRkcjMbifrwmFYcClgOZeg==", + "dev": true, + "dependencies": { + "safe-buffer": "5.1.2" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/call-bind": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.2.tgz", + "integrity": "sha512-7O+FbCihrB5WGbFYesctwmTKae6rOiIzmz1icreWJ+0aA7LJfuqhEso2T9ncpcFtzMQtzXf2QGGueWJGTYsqrA==", + "dev": true, + "dependencies": { + "function-bind": "^1.1.1", + "get-intrinsic": "^1.0.2" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true + }, + "node_modules/corser": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/corser/-/corser-2.0.1.tgz", + "integrity": "sha512-utCYNzRSQIZNPIcGZdQc92UVJYAhtGAteCFg0yRaFm8f0P+CPtyGyHXJcGXnffjCybUCEx3FQ2G7U3/o9eIkVQ==", + "dev": true, + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/debug": { + "version": "3.2.7", + "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz", + "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==", + "dev": true, + "dependencies": { + "ms": "^2.1.1" + } + }, + "node_modules/eventemitter3": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-4.0.7.tgz", + "integrity": "sha512-8guHBZCwKnFhYdHr2ysuRWErTwhoN2X8XELRlrRwpmfeY2jjuUN4taQMsULKUVo1K4DvZl+0pgfyoysHxvmvEw==", + "dev": true + }, + "node_modules/follow-redirects": { + "version": "1.15.2", + "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.2.tgz", + "integrity": "sha512-VQLG33o04KaQ8uYi2tVNbdrWp1QWxNNea+nmIB4EVM28v0hmP17z7aG1+wAkNzVq4KeXTq3221ye5qTJP91JwA==", + "dev": true, + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/RubenVerborgh" + } + ], + "engines": { + "node": ">=4.0" + }, + "peerDependenciesMeta": { + "debug": { + "optional": true + } + } + }, + "node_modules/function-bind": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.1.tgz", + "integrity": "sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A==", + "dev": true + }, + "node_modules/get-intrinsic": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.2.1.tgz", + "integrity": "sha512-2DcsyfABl+gVHEfCOaTrWgyt+tb6MSEGmKq+kI5HwLbIYgjgmMcV8KQ41uaKz1xxUcn9tJtgFbQUEVcEbd0FYw==", + "dev": true, + "dependencies": { + "function-bind": "^1.1.1", + "has": "^1.0.3", + "has-proto": "^1.0.1", + "has-symbols": "^1.0.3" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/has/-/has-1.0.3.tgz", + "integrity": "sha512-f2dvO0VU6Oej7RkWJGrehjbzMAjFp5/VKPp5tTpWIV4JHHZK1/BxbFRtf/siA2SWTe09caDmVtYYzWEIbBS4zw==", + "dev": true, + "dependencies": { + "function-bind": "^1.1.1" + }, + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/has-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/has-proto/-/has-proto-1.0.1.tgz", + "integrity": "sha512-7qE+iP+O+bgF9clE5+UoBFzE65mlBiVj3tKCrlNQ0Ogwm0BjpT/gK4SlLYDMybDh5I3TCTKnPPa0oMG7JDYrhg==", + "dev": true, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-symbols": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.0.3.tgz", + "integrity": "sha512-l3LCuF6MgDNwTDKkdYGEihYjt5pRPbEg46rtlmnSPlUbgmB8LOIrKJbYYFBSbnPaJexMKtiPO8hmeRjRz2Td+A==", + "dev": true, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/he": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz", + "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==", + "dev": true, + "bin": { + "he": "bin/he" + } + }, + "node_modules/html-encoding-sniffer": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-3.0.0.tgz", + "integrity": "sha512-oWv4T4yJ52iKrufjnyZPkrN0CH3QnrUqdB6In1g5Fe1mia8GmF36gnfNySxoZtxD5+NmYw1EElVXiBk93UeskA==", + "dev": true, + "dependencies": { + "whatwg-encoding": "^2.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/http-proxy": { + "version": "1.18.1", + "resolved": "https://registry.npmjs.org/http-proxy/-/http-proxy-1.18.1.tgz", + "integrity": "sha512-7mz/721AbnJwIVbnaSv1Cz3Am0ZLT/UBwkC92VlxhXv/k/BBQfM2fXElQNC27BVGr0uwUpplYPQM9LnaBMR5NQ==", + "dev": true, + "dependencies": { + "eventemitter3": "^4.0.0", + "follow-redirects": "^1.0.0", + "requires-port": "^1.0.0" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/http-server": { + "version": "14.1.1", + "resolved": "https://registry.npmjs.org/http-server/-/http-server-14.1.1.tgz", + "integrity": "sha512-+cbxadF40UXd9T01zUHgA+rlo2Bg1Srer4+B4NwIHdaGxAGGv59nYRnGGDJ9LBk7alpS0US+J+bLLdQOOkJq4A==", + "dev": true, + "dependencies": { + "basic-auth": "^2.0.1", + "chalk": "^4.1.2", + "corser": "^2.0.1", + "he": "^1.2.0", + "html-encoding-sniffer": "^3.0.0", + "http-proxy": "^1.18.1", + "mime": "^1.6.0", + "minimist": "^1.2.6", + "opener": "^1.5.1", + "portfinder": "^1.0.28", + "secure-compare": "3.0.1", + "union": "~0.5.0", + "url-join": "^4.0.1" + }, + "bin": { + "http-server": "bin/http-server" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/iconv-lite": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz", + "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==", + "dev": true, + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/lodash": { + "version": "4.17.21", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", + "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==", + "dev": true + }, + "node_modules/mime": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz", + "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==", + "dev": true, + "bin": { + "mime": "cli.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/minimist": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", + "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", + "dev": true, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/mkdirp": { + "version": "0.5.6", + "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz", + "integrity": "sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw==", + "dev": true, + "dependencies": { + "minimist": "^1.2.6" + }, + "bin": { + "mkdirp": "bin/cmd.js" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true + }, + "node_modules/object-inspect": { + "version": "1.12.3", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.12.3.tgz", + "integrity": "sha512-geUvdk7c+eizMNUDkRpW1wJwgfOiOeHbxBR/hLXK1aT6zmVSO0jsQcs7fj6MGw89jC/cjGfLcNOrtMYtGqm81g==", + "dev": true, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/opener": { + "version": "1.5.2", + "resolved": "https://registry.npmjs.org/opener/-/opener-1.5.2.tgz", + "integrity": "sha512-ur5UIdyw5Y7yEj9wLzhqXiy6GZ3Mwx0yGI+5sMn2r0N0v3cKJvUmFH5yPP+WXh9e0xfyzyJX95D8l088DNFj7A==", + "dev": true, + "bin": { + "opener": "bin/opener-bin.js" + } + }, + "node_modules/portfinder": { + "version": "1.0.32", + "resolved": "https://registry.npmjs.org/portfinder/-/portfinder-1.0.32.tgz", + "integrity": "sha512-on2ZJVVDXRADWE6jnQaX0ioEylzgBpQk8r55NE4wjXW1ZxO+BgDlY6DXwj20i0V8eB4SenDQ00WEaxfiIQPcxg==", + "dev": true, + "dependencies": { + "async": "^2.6.4", + "debug": "^3.2.7", + "mkdirp": "^0.5.6" + }, + "engines": { + "node": ">= 0.12.0" + } + }, + "node_modules/qs": { + "version": "6.11.2", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.11.2.tgz", + "integrity": "sha512-tDNIz22aBzCDxLtVH++VnTfzxlfeK5CbqohpSqpJgj1Wg/cQbStNAz3NuqCs5vV+pjBsK4x4pN9HlVh7rcYRiA==", + "dev": true, + "dependencies": { + "side-channel": "^1.0.4" + }, + "engines": { + "node": ">=0.6" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/regenerator-runtime": { + "version": "0.13.11", + "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.13.11.tgz", + "integrity": "sha512-kY1AZVr2Ra+t+piVaJ4gxaFaReZVH40AKNo7UCX6W+dEwBo/2oZJzqfuN1qLq1oL45o56cPaTXELwrTh8Fpggg==" + }, + "node_modules/requires-port": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz", + "integrity": "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ==", + "dev": true + }, + "node_modules/safe-buffer": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", + "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", + "dev": true + }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", + "dev": true + }, + "node_modules/secure-compare": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/secure-compare/-/secure-compare-3.0.1.tgz", + "integrity": "sha512-AckIIV90rPDcBcglUwXPF3kg0P0qmPsPXAj6BBEENQE1p5yA1xfmDJzfi1Tappj37Pv2mVbKpL3Z1T+Nn7k1Qw==", + "dev": true + }, + "node_modules/side-channel": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.0.4.tgz", + "integrity": "sha512-q5XPytqFEIKHkGdiMIrY10mvLRvnQh42/+GoBlFW3b2LXLE2xxJpZFdm94we0BaoV3RwJyGqg5wS7epxTv0Zvw==", + "dev": true, + "dependencies": { + "call-bind": "^1.0.0", + "get-intrinsic": "^1.0.2", + "object-inspect": "^1.9.0" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/slugify": { + "version": "1.6.6", + "resolved": "https://registry.npmjs.org/slugify/-/slugify-1.6.6.tgz", + "integrity": "sha512-h+z7HKHYXj6wJU+AnS/+IH8Uh9fdcX1Lrhg1/VMdf9PwoBQXFcXiAdsy2tSK0P6gKwJLXp02r90ahUCqHk9rrw==", + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/union": { + "version": "0.5.0", + "resolved": "https://registry.npmjs.org/union/-/union-0.5.0.tgz", + "integrity": "sha512-N6uOhuW6zO95P3Mel2I2zMsbsanvvtgn6jVqJv4vbVcz/JN0OkL9suomjQGmWtxJQXOCqUJvquc1sMeNz/IwlA==", + "dev": true, + "dependencies": { + "qs": "^6.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/url-join": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/url-join/-/url-join-4.0.1.tgz", + "integrity": "sha512-jk1+QP6ZJqyOiuEI9AEWQfju/nB2Pw466kbA0LEZljHwKeMgd9WrAEgEGxjPDD2+TNbbb37rTyhEfrCXfuKXnA==", + "dev": true + }, + "node_modules/whatwg-encoding": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-2.0.0.tgz", + "integrity": "sha512-p41ogyeMUrw3jWclHWTQg1k05DSVXPLcVxRTYsXUk+ZooOCZLcoYgPZ/HL/D/N+uQPOtcp1me1WhBEaX02mhWg==", + "dev": true, + "dependencies": { + "iconv-lite": "0.6.3" + }, + "engines": { + "node": ">=12" + } + } + } +} diff --git a/core-sdk-samples/core-snippet-sample-app/package.json b/core-sdk-samples/core-snippet-sample-app/package.json new file mode 100644 index 00000000..ba01470c --- /dev/null +++ b/core-sdk-samples/core-snippet-sample-app/package.json @@ -0,0 +1,18 @@ +{ + "name": "core-snippet-sample-app", + "version": "1.0.0", + "description": "Sample app using mParticle Web Snippet", + "main": "index.js", + "scripts": { + "serve": "http-server . -c-1" + }, + "keywords": [], + "author": "", + "license": "ISC", + "dependencies": { + "@mparticle/web-sdk": "^2.22.0" + }, + "devDependencies": { + "http-server": "^14.1.1" + } +} diff --git a/core-sdk-samples/core-snippet-sample-app/src/events.fns.js b/core-sdk-samples/core-snippet-sample-app/src/events.fns.js new file mode 100644 index 00000000..56f9c90c --- /dev/null +++ b/core-sdk-samples/core-snippet-sample-app/src/events.fns.js @@ -0,0 +1,5 @@ +const logEventButton = document.getElementById('js-log-event'); +logEventButton.addEventListener('click', () => { + console.log('logging event'); + mParticle.logEvent('Test Event'); +}); diff --git a/core-sdk-samples/core-snippet-sample-app/src/sideloadedKits.js b/core-sdk-samples/core-snippet-sample-app/src/sideloadedKits.js new file mode 100644 index 00000000..bfe06625 --- /dev/null +++ b/core-sdk-samples/core-snippet-sample-app/src/sideloadedKits.js @@ -0,0 +1,44 @@ +console.log('Loading Sideloaded Kits'); + +window.mParticle = window.mParticle || {}; +window.mParticle.config = window.mParticle.config || {}; +window.mParticle.config.sideloadedKits = []; + +function sideLoadedKit(forwarderName, forwarderId) { + const register = (config) => { + if (!config.kits) { + config.kits = {}; + } + + config.kits[this.name] = { + constructor, + }; + }; + + const init = () => {}; + + const constructor = function () { + this.id = forwarderId || 0; + this.name = forwarderName || 'SideloadedKit'; + this.init = init; + + window[this.name + this.id] = { + instance: this, + }; + }; + + this.name = forwarderName || 'SideloadedKit'; + + return { + constructor, + name: this.name, + getId: () => this.id, + register, + }; +} + +const sidewinder = new sideLoadedKit('Sidewinder', 42); + +window.mParticle.config.sideloadedKits.push( + new window.mParticle.MPSideloadedKit(sidewinder) +); diff --git a/core-sdk-samples/core-snippet-sample-app/src/snippet.js b/core-sdk-samples/core-snippet-sample-app/src/snippet.js new file mode 100644 index 00000000..c02223c1 --- /dev/null +++ b/core-sdk-samples/core-snippet-sample-app/src/snippet.js @@ -0,0 +1,86 @@ +(function (t) { + window.mParticle = window.mParticle || {}; + window.mParticle.EventType = { + Unknown: 0, + Navigation: 1, + Location: 2, + Search: 3, + Transaction: 4, + UserContent: 5, + UserPreference: 6, + Social: 7, + Other: 8, + }; + window.mParticle.eCommerce = { Cart: {} }; + window.mParticle.Identity = {}; + window.mParticle.config = window.mParticle.config || {}; + window.mParticle.config.rq = []; + window.mParticle.config.snippetVersion = 2.3; + window.mParticle.ready = function (t) { + window.mParticle.config.rq.push(t); + }; + var e = [ + 'endSession', + 'logError', + 'logBaseEvent', + 'logEvent', + 'logForm', + 'logLink', + 'logPageView', + 'setSessionAttribute', + 'setAppName', + 'setAppVersion', + 'setOptOut', + 'setPosition', + 'startNewSession', + 'startTrackingLocation', + 'stopTrackingLocation', + ]; + var o = ['setCurrencyCode', 'logCheckout']; + var i = ['identify', 'login', 'logout', 'modify']; + e.forEach(function (t) { + window.mParticle[t] = n(t); + }); + o.forEach(function (t) { + window.mParticle.eCommerce[t] = n(t, 'eCommerce'); + }); + i.forEach(function (t) { + window.mParticle.Identity[t] = n(t, 'Identity'); + }); + function n(e, o) { + return function () { + if (o) { + e = o + '.' + e; + } + var t = Array.prototype.slice.call(arguments); + t.unshift(e); + window.mParticle.config.rq.push(t); + }; + } + var dpId, + dpV, + config = window.mParticle.config, + env = config.isDevelopmentMode ? 1 : 0, + dbUrl = '?env=' + env, + dataPlan = window.mParticle.config.dataPlan; + dataPlan && + ((dpId = dataPlan.planId), + (dpV = dataPlan.planVersion), + dpId && + (dpV && (dpV < 1 || dpV > 1e3) && (dpV = null), + (dbUrl += + '&plan_id=' + dpId + (dpV ? '&plan_version=' + dpV : '')))); + var mp = document.createElement('script'); + mp.type = 'text/javascript'; + mp.async = true; + mp.src = + ('https:' == document.location.protocol + ? 'https://jssdkcdns' + : 'http://jssdkcdn') + + '.mparticle.com/js/v2/' + + t + + '/mparticle.js' + + dbUrl; + var c = document.getElementsByTagName('script')[0]; + c.parentNode.insertBefore(mp, c); +})('REPLACE WITH API KEY');